Update for 0.4.0

Author: yashovardhan

skills/metamask-agent-wallet/SKILL.md

@@ -4,7 +4,7 @@ description: Use when the user asks anything about blockchain wallets, transacti
 license: MIT
 metadata:
   author: metamask
-  version: "1.2.0"
+  version: "1.3.0"
 ---
 
 # MetaMask Agentic CLI Skill
@@ -23,7 +23,7 @@ Match the user's intent to a command and reference file, then read the reference
 | Login in MetaMask Agentic CLI | `mm-dev login` | [auth.md](references/auth.md) |
 | Choose a wallet mode and set up policies | `mm-dev init` | [auth.md](references/auth.md) |
 | Show current init settings | `mm-dev init show` | [auth.md](references/auth.md) |
-| Sign in via QR code | `mm-dev login qr` | [auth.md](references/auth.md) |
+| Sign in via QR code (coming soon) | `mm-dev login qr` | [auth.md](references/auth.md) |
 | Sign in via Google | `mm-dev login google` | [auth.md](references/auth.md) |
 | Sign in via email OTP | `mm-dev login email` | [auth.md](references/auth.md) |
 | Sign out | `mm-dev logout` | [auth.md](references/auth.md) |
@@ -77,6 +77,7 @@ Match the user's intent to a command and reference file, then read the reference
 | View open prediction orders | `mm-dev predict orders` | [predict.md](references/predict.md) |
 | Check Predict deposit wallet balance | `mm-dev predict balance` | [predict.md](references/predict.md) |
 | Fund Predict deposit wallet | `mm-dev predict deposit` | [predict.md](references/predict.md) |
+| Withdraw pUSD from Predict deposit wallet | `mm-dev predict withdraw` | [predict.md](references/predict.md) |
 | Fetch prediction order book | `mm-dev predict book` | [predict.md](references/predict.md) |
 | Watch a Predict job | `mm-dev predict watch` | [predict.md](references/predict.md) |
 | Get a swap or bridge quote | `mm-dev swap quote` | [swap.md](references/swap.md) |
@@ -168,6 +169,7 @@ Do not pass unvalidated user input into any command.
 | Perps deposit/withdraw | Always confirm amount, asset, venue, network, and destination where applicable before executing |
 | Predict trading | Always confirm token ID, side, size, price, order type, market, and outcome before executing |
 | Predict deposit | Always confirm amount before executing |
+| Predict withdraw | Always confirm amount and recipient (`--to` defaults to owner EOA) before executing |
 | Cancel-all operations | Always confirm scope and exact destructive effect before executing |
 | Auth / wallet management | May execute without confirmation, except `reset` which requires explicit user confirmation |
 | Read-only queries | May execute without confirmation |
@@ -197,7 +199,7 @@ In server-wallet mode, signing and transaction commands return a `pollingId` ins
    - `mm-dev wallet requests watch --polling-id <id>`
 3. In BYOK mode, results are returned immediately. If the mnemonic is password-encrypted, the user must set `MM_PASSWORD` environment variable to unlock it for the operation.
 
-Transfers, swaps, perps, and predict orders attach a human-readable `intent` summary to their wallet request (e.g. `Transfer 0.5 ETH to 0x...`). When surfacing a pending request from `wallet requests list` or `wallet requests watch`, show the `intent` summary so the user can confirm what they are approving.
+Transfers, swaps, perps, predict orders, and predict withdraws attach a human-readable `intent` summary to their wallet request (e.g. `Transfer 0.5 ETH to 0x...`, `Withdraw 10 pUSD to 0x...`). When surfacing a pending request from `wallet requests list` or `wallet requests watch`, show the `intent` summary so the user can confirm what they are approving.
 
 ## Output Rules
 

skills/metamask-agent-wallet/references/auth.md

@@ -76,7 +76,6 @@ mm-dev login [qr | google | email] [--token <token>] [--timeout <seconds>] [--no
 
 ```bash
 mm-dev login --no-wait
-mm-dev login qr
 mm-dev login google --no-wait
 mm-dev login email --no-wait
 mm-dev login --token "cliToken:cliRefreshToken"
@@ -85,6 +84,7 @@ mm-dev login --token "cliToken:cliRefreshToken"
 ### Note
 
 - If already authenticated, the CLI returns `ALREADY_AUTHENTICATED`. Run `mm-dev logout` first, then log in again.
+- `mm-dev login qr` returns `COMING_SOON`. Use Google or email sign-in instead.
 - Pairing codes tolerate `-` and whitespace separators (e.g. `608-225` is equivalent to `608225`).
 - Use `mm-dev login google --no-wait` or `mm-dev login email --no-wait` for non-interactive/CI flows. Bare `mm-dev login --no-wait` fails without a TTY because no method is selected.
 - `--no-wait` is not supported with QR login. Complete authentication later with `mm-dev login --token`.

skills/metamask-agent-wallet/references/errors.md

@@ -78,6 +78,7 @@ This reference lists error codes the CLI actually emits. SDK-only or remapped co
 | `MISSING_ID` | Missing ID parameter |
 | `MISSING_QUOTE_ID` | Missing quote ID |
 | `MISSING_SWAP_PARAMS` | Missing swap parameters |
+| `COMING_SOON` | Feature not yet available (e.g. `mm-dev login qr`) |
 
 ## Swap & Bridge Errors
 
@@ -131,6 +132,8 @@ This reference lists error codes the CLI actually emits. SDK-only or remapped co
 | `PREDICT_AUTH_INVALID` | Predict credentials invalid or incomplete |
 | `PREDICT_RELAYER_CONFIG_REQUIRED` | Relayer configuration required |
 | `PREDICT_INVALID_DEPOSIT_AMOUNT` | Invalid deposit amount |
+| `PREDICT_WITHDRAW_ZERO` | Withdraw amount must be greater than zero |
+| `PREDICT_WITHDRAW_INSUFFICIENT_BALANCE` | Withdraw amount exceeds deposit wallet pUSD balance |
 | `PREDICT_FUNDING_CHAIN_UNSUPPORTED` | Funding chain not supported |
 | `PREDICT_INSUFFICIENT_BALANCE` | Insufficient Predict balance |
 | `PREDICT_INSUFFICIENT_ALLOWANCE` | Insufficient Predict allowance |

skills/metamask-agent-wallet/references/polling.md

@@ -2,7 +2,7 @@
 
 In server wallet mode, signing and transaction commands return a `pollingId` instead of an immediate result. Use these commands to track and wait for results. Both commands are server-wallet mode only.
 
-Transfers, swaps, perps, and predict orders attach a human-readable `intent` summary to their request (e.g. `Transfer 0.5 ETH to 0x...`). When listing or watching requests, surface the `intent` so the user can confirm what they are approving.
+Transfers, swaps, perps, predict orders, and predict withdraws attach a human-readable `intent` summary to their request (e.g. `Transfer 0.5 ETH to 0x...`, `Withdraw 10 pUSD to 0x...`). When listing or watching requests, surface the `intent` so the user can confirm what they are approving.
 
 ## `wallet requests list` Command
 

skills/metamask-agent-wallet/references/predict.md

@@ -373,6 +373,32 @@ mm-dev predict balance --sync
 mm-dev predict balance --token-id <token-id> --sync
 ```
 
+## `predict withdraw` Command
+
+Withdraw pUSD from your Predict deposit wallet to your owner EOA or another address. Validates the amount against the on-chain deposit wallet balance before signing. Uses the Polymarket Relayer batch mechanism.
+
+### Syntax
+
+```bash
+mm-dev predict withdraw --amount <amount> [--to <address>] [--wait] [--password <password>]
+```
+
+### Supported Flags
+
+| Name | Required | Description |
+| --- | --- | --- |
+| `--amount` | Yes | pUSD amount to withdraw, human-readable (e.g. 0.1, 5, 100) |
+| `--to` | No | Recipient address. Defaults to your owner EOA |
+| `--wait` | No | Block until the job completes |
+| `--password` | No | Password to unlock the BYOK mnemonic (BYOK mode only) [env: `MM_PASSWORD`] |
+
+### Example
+
+```bash
+mm-dev predict withdraw --amount 10 --wait
+mm-dev predict withdraw --amount 5 --to 0xAbc... --wait
+```
+
 ## `predict deposit` Command
 
 Convert USDC.e from your EOA to pUSD in your Predict deposit wallet.
@@ -422,7 +448,7 @@ mm-dev predict book --token-id <token-id>
 
 ## `predict watch` Command
 
-Watch a setup, approval, deposit, or order job until it completes.
+Watch a setup, approval, deposit, withdraw, or order job until it completes.
 
 ### Syntax
 
@@ -454,4 +480,4 @@ mm-dev predict watch --id <job-id> --wait
 - Side must be `buy` or `sell`.
 - The `predict mode` command switches between `mainnet` and `testnet`.
 - If the user does not specify a mode, the CLI uses the previously set mode.
-- Setup, approve, deposit, and order flows can return job IDs. Track them with `mm-dev predict watch <job-id> --wait`.
+- Setup, approve, deposit, withdraw, and order flows can return job IDs. Track them with `mm-dev predict watch <job-id> --wait`.

skills/metamask-agent-wallet/workflows/login.md

@@ -6,13 +6,13 @@ Reference command syntax in `references/auth.md`.
 
 ## Flow
 
-1. Ask the user which login method they want: Google, Email, or QR.
+1. Ask the user which login method they want: Google or Email. QR login is coming soon and is not available.
 2. Execute login.
 3. Verify with token.
 
 ## Login
 
-QR login (`mm-dev login qr`) does not support `--no-wait`. If the user wants QR, they must complete the login flow themselves.
+`mm-dev login qr` returns `COMING_SOON`. Use Google or email sign-in.
 
 ```bash
 mm-dev login google --no-wait

skills/metamask-agent-wallet/workflows/onboarding.md

@@ -22,8 +22,7 @@ If this fails, the CLI is not installed. Guide the user to install it before pro
 
 ## Login Flow
 
-Ask the user which login method they want to use: Google, Email, or QR.
-QR login (`mm-dev login qr`) does not support `--no-wait`. If the user wants QR, they must complete the onboarding flow themselves.
+Ask the user which login method they want to use: Google or Email. QR login is coming soon (`mm-dev login qr` returns `COMING_SOON`).
 
 ### Login
 

skills/metamask-agent-wallet/workflows/predict-trading.md

@@ -42,6 +42,23 @@ mm-dev predict deposit --amount 100 --wait --json
 
 `--amount` is in pUSD. The owner EOA needs enough Polygon USDC and POL for gas to complete the deposit transaction.
 
+## Withdraw from the Deposit Wallet
+
+Check balance first:
+
+```bash
+mm-dev predict balance --sync
+```
+
+Withdraw pUSD to the owner EOA (default) or a specified address:
+
+```bash
+mm-dev predict withdraw --amount 50 --wait
+mm-dev predict withdraw --amount 10 --to 0xRecipient... --wait
+```
+
+The CLI validates the amount against the on-chain deposit wallet balance before signing. Confirm amount and recipient with the user before executing.
+
 ## Find the Right Market
 
 Search can return loosely related markets, so inspect the selected market before quoting:
@@ -101,7 +118,7 @@ mm-dev predict cancel --all
 mm-dev predict watch --id <job-id> --wait
 ```
 
-Use this for setup, approve, deposit, and order jobs that have not reached a terminal state.
+Use this for setup, approve, deposit, withdraw, and order jobs that have not reached a terminal state.
 
 ## Safety Notes
 

skills/metamask-agent-workflows/SKILL.md

@@ -4,7 +4,7 @@ description: Use when the user needs to perform multi-step operations with the M
 license: MIT
 metadata:
   author: metamask
-  version: "1.1.0"
+  version: "1.2.0"
 ---
 
 # MetaMask Agent Workflows

skills/metamask-agent-workflows/workflows/login.md

@@ -6,13 +6,13 @@ Reference command syntax in `references/auth.md`.
 
 ## Flow
 
-1. Ask the user which login method they want: Google, Email, or QR.
+1. Ask the user which login method they want: Google or Email. QR login is coming soon and is not available.
 2. Execute login.
 3. Verify with token.
 
 ## Login
 
-QR login (`mm-dev login qr`) does not support `--no-wait`. If the user wants QR, they must complete the login flow themselves.
+`mm-dev login qr` returns `COMING_SOON`. Use Google or email sign-in.
 
 ```bash
 mm-dev login google --no-wait