zk-agent-cli 0.1.0-rc.0 → 0.1.0-rc.1

package/README.md

@@ -1,37 +1,11 @@
 # zk-agent-cli
 
-`zk-agent-cli` is the packaged `zk-agent-cli` command surface for zkSync Era
-and zkSync Sepolia.
+`zk-agent-cli` is the packaged terminal CLI for the zk-agent operator path on
+zkSync Era and zkSync Sepolia.
 
-This README is the canonical operator manual for the packaged CLI. If you want
-repo architecture, contributor state, or project planning context, use the root
-repository docs instead of this package manual.
+This file is the canonical operator manual for CLI users.
 
-Current strengths:
-
-- local-first wallet/session storage
-- `next`-first operator guidance
-- relay-backed approval and reapproval
-- workflow orchestration for send, swap, bridge, deposit, and withdraw
-- machine-readable JSON output for agent callers
-
-## Public Entry Points
-
-Choose the entrypoint that matches the environment.
-
-If you are installing this repository into a compatible agent harness instead
-of using the CLI directly, prefer the repo skill surface:
-
-```bash
-npx skills add https://github.com/AgiWeb3/zk-agent-cli
-```
-
-This repo currently ships a repository skill bundle for compatible harnesses.
-The repository root now also ships a native ChatGPT/Codex plugin manifest at
-`.codex-plugin/plugin.json`, but that plugin source belongs to the repository
-surface rather than this published npm tarball.
-
-For direct terminal use, install the packaged CLI:
+## Install
 
 One-shot execution:
 
@@ -46,24 +20,22 @@ npm install -g zk-agent-cli
 zk-agent --help
 ```
 
-The package also ships the secondary binary name:
+The package also ships the alias:
 
 ```bash
 zksync-agent --help
 ```
 
-## Prerequisites
+## Defaults and prerequisites
 
-- Node.js `>=24` for either `npx zk-agent-cli ...` or global install.
-  Older Node versions may still start the CLI, but the current package is not
-  supported there and npm will emit `EBADENGINE` warnings.
-- The default local approval path expects the connector UI to be reachable at
-  `http://localhost:4444`. Override it with
-  `zk-agent setup --connector-url <url>` when needed.
-- The CLI auto-loads `.env` from the current working directory.
+- Node.js `>=24`
+- the default chain is `zksync-sepolia`
+- the default local approval callback is `http://localhost:4444`
+- the CLI auto-loads `.env` from the current working directory
 
-You do not need a custom `.env` just to run `setup`, `next`, or create a local
-wallet request. You usually do need one for live chain reads or broadcasts.
+You do not need a custom `.env` just to run `setup`, `next`, `doctor`, or
+create a wallet request. You usually do need RPC values for live reads or
+broadcasts.
 
 Most relevant environment variables:
 
@@ -74,25 +46,9 @@ ZK_AGENT_TOKEN_DIRECTORY_ROOT=
 ZK_AGENT_STORAGE_DIR=
 ```
 
-Use:
-
-- `ZKSYNC_SEPOLIA_RPC_URL` for explicit zkSync Sepolia reads/broadcasts
-- `ETHEREUM_SEPOLIA_RPC_URL` for L1 deposit/bridge follow-up flows on Sepolia
-- `ZK_AGENT_TOKEN_DIRECTORY_ROOT` when you want local token-directory symbol
-  resolution
-- `ZK_AGENT_STORAGE_DIR` only when you need to override the default local
-  storage path
-
-## Shortest Path
-
-Current validated first-run baseline:
+## Fastest verified path
 
-- `setup` defaults to `zksync-sepolia`
-- the local approval path expects the connector UI at `http://localhost:4444`
-- override `--default-chain` or `--connector-url` only when you intentionally
-  target another chain or connector deployment
-
-Fresh setup:
+Use this path unless the task explicitly needs a lower-level command:
 
 ```bash
 zk-agent setup
@@ -102,227 +58,205 @@ zk-agent next
 zk-agent workflow pay --wallet main --to <address> --amount <amount>
 ```
 
-If the browser is not colocated with the terminal, keep the same flow but
-replace the wallet-creation step with:
+Interpretation:
+
+- `setup` writes local defaults
+- `next` gives the shortest valid follow-up step
+- `wallet create --await-local` is the preferred local approval path
+- `workflow pay` is the flagship zkSync-native AA native-send path
+
+If readiness is unclear before you choose a fix, use:
 
 ```bash
-zk-agent relay inspect --relay-url <relay-url>
-zk-agent wallet create --relay-url <relay-url> --wait-relay --prompt-code
-zk-agent next
+zk-agent doctor
 ```
 
-If local setup or wallet readiness is unclear, start with `zk-agent doctor`.
-It inspects saved config, wallet approval metadata, and local signer state
-without live RPC reads, and `--relay-url` only makes the remote fallback
-commands concrete.
+## Existing wallet recovery
 
-If a wallet already exists, inspect the blocker first. Use `wallet reapprove`
-when approval is missing or expired, then return to `zk-agent next`. Use
-`wallet signer attach` when approval is still present but the local execution
-signer is missing:
+If the wallet already exists and approval is missing or expired:
 
 ```bash
 zk-agent wallet reapprove --name main --await-local
 zk-agent next
-zk-agent wallet signer attach --name main --private-key <hex>
-zk-agent next
 ```
 
-Only fund when the CLI says funding is actually required:
+If approval is still present but the local execution signer is missing:
 
 ```bash
-zk-agent workflow fund --wallet main --amount <amount> --execute
+zk-agent wallet signer attach --name main --private-key <hex>
+zk-agent next
 ```
 
-Current flagship AA native-pay path:
+Use these inspection commands when the blocker is wallet-specific:
 
 ```bash
-zk-agent workflow pay --wallet main --to <address> --amount <amount>
-zk-agent workflow pay --wallet main --to <address> --amount <amount> --paymaster-mode sponsored
+zk-agent wallet status --name main
+zk-agent wallet next --name main
 ```
 
-Use a `sed-lite` wallet for the default AA acceptance path. Keep
-`daily-spend-limit` for profile-specific policy experiments, not as the main
-operator baseline.
+## Remote approval
 
-`workflow pay` fixes the workflow intent to `send-native`, persists a
-checkpoint, executes immediately when ready, reopens a missing writable session
-through the intent-scoped approval path, and defaults to the validated
-approval-based paymaster mode unless you override it.
-When that approval-based path still needs a fee-token candidate, recover with
-`zk-agent tokens --chain zksync-sepolia --role paymaster-fee-token` and
-`zk-agent resolve-token --chain zksync-sepolia --symbol <symbol> --role paymaster-fee-token`.
+Use the relay-backed path only when the browser is not colocated with the
+terminal:
 
-## Discovery Path
+```bash
+zk-agent relay inspect --relay-url <relay-url>
+zk-agent wallet create --relay-url <relay-url> --wait-relay --prompt-code
+zk-agent next
+```
 
-Use the discovery surfaces in this order when a workflow or direct command
-needs token context:
+For an existing wallet:
 
-- `zk-agent assets --wallet main` for the preferred single-chain asset view
-- `zk-agent tokens --wallet main --owned` for the narrower owned ERC-20 subset
-- `zk-agent tokens --chain zksync-sepolia` and
-  `zk-agent resolve-token --chain zksync-sepolia --symbol USDC` for
-  symbol-first discovery before choosing an explicit token address
-- `zk-agent tokens --chain zksync-sepolia --role paymaster-fee-token` and
-  `zk-agent resolve-token --chain zksync-sepolia --symbol <symbol> --role paymaster-fee-token`
-  for approval-based paymaster fee-token discovery on the flagship pay path
-- `zk-agent defaults` for the machine-readable registry/defaults catalog:
-  tracked token roles, paymaster metadata, source order, and validated/fallback
-  route metadata
+```bash
+zk-agent wallet reapprove --name main --relay-url <relay-url> --wait-relay --prompt-code
+zk-agent next
+```
 
-## Direct Command Escape Hatches
+If the relay is self-hosted through the built-in server:
 
-Use the guided workflow layer first, but the lower-level direct commands now
-keep the same symbol/discovery contract:
+```bash
+zk-agent relay serve --public-origin https://relay.example.com
+```
 
-- `zk-agent send-token --wallet main --symbol USDC --to <address> --amount <amount>`
-- `zk-agent swap --wallet main --token-in-symbol USDC --token-out-symbol ETH --amount-in <amount>`
-- `zk-agent fund --wallet main --symbol USDC --amount <amount>`
-- `zk-agent deposit --wallet main --symbol USDC --amount <amount>`
-- `zk-agent withdraw --wallet main --symbol USDC --amount <amount>`
+Use `relay inspect` before sending users to a share link. It exposes hosted
+readiness, URL shape, persistence mode, and the exact create/reapprove follow-up
+path.
 
-Current direct-command behavior:
+For the supported hosted operating contract, use
+[`docs/16-hosted-approval-operated-baseline.md`](../../docs/16-hosted-approval-operated-baseline.md).
 
-- `send-token`, `fund`, `deposit`, and `withdraw` accept symbol-first token
-  resolution when the local registry can resolve the active chain token
-- `swap` follows the current registry-backed validated route by default when
-  `--protocol` is omitted
-- `bridge` can reuse the tracked default destination route when one is already
-  known for the current wallet chain
+## Funding and execution
 
-## Local Agent Identity
+Only fund when the CLI tells you funding is required:
 
-The local operator profile is optional. It helps agent harnesses and operators
-persist stable metadata, but wallet approval and workflow execution do not
-depend on it.
+```bash
+zk-agent workflow fund --wallet main
+zk-agent workflow fund --wallet main --amount <amount> --execute
+```
 
-Use:
+Flagship pay path:
 
-- `zk-agent agent status`
-- `zk-agent agent set --name "<operator-name>" --wallet main`
-- `zk-agent agent show`
+```bash
+zk-agent workflow pay --wallet main --to <address> --amount <amount>
+zk-agent workflow pay --wallet main --to <address> --amount <amount> --broadcast
+```
+
+Keep `sed-lite` as the default AA baseline. Use `daily-spend-limit` only when
+you intentionally need that narrower policy profile.
 
-## Remote Approval
+## Operator suite
 
-Shortest relay-backed path in one terminal process:
+Use:
 
 ```bash
-zk-agent relay inspect --relay-url <relay-url>
-zk-agent wallet create --relay-url <relay-url> --wait-relay --prompt-code
+zk-agent suite
 ```
 
-If the wallet already exists and approval metadata needs to be refreshed, use:
+when you want the flagship path plus the current post-flagship surfaces in one
+place.
 
-```bash
-zk-agent wallet reapprove --name main --relay-url <relay-url> --wait-relay --prompt-code
-```
+Current suite shape:
 
-Treat that hosted path as the fallback when the browser is not colocated with
-the terminal; keep the local `--await-local` path as the default baseline.
+- flagship pay:
+  `zk-agent workflow pay --wallet main --to <address> --amount <amount>`
+- discovery/defaults:
+  `zk-agent assets --wallet main`
+  `zk-agent defaults`
+  `zk-agent resolve-token --chain zksync-sepolia --symbol USDC`
+- funding readiness:
+  `zk-agent workflow fund --wallet main`
+- paymaster readiness:
+  `zk-agent workflow pay --wallet main --to <address> --amount <amount> --paymaster-mode approval-based`
+  `zk-agent tokens --chain zksync-sepolia --role paymaster-fee-token`
 
-If approval is still present and only the local execution signer is missing,
-repair that locally instead of forcing a new approval round-trip:
+## Discovery and direct commands
 
-```bash
-zk-agent wallet signer attach --name main --private-key <hex>
-zk-agent next
-```
+Preferred discovery order:
 
-Local relay prototype path:
+- `zk-agent assets --wallet main`
+- `zk-agent tokens --wallet main --owned`
+- `zk-agent defaults`
+- `zk-agent resolve-token --chain zksync-sepolia --symbol <symbol>`
 
-```bash
-zk-agent relay serve --public-origin https://relay.example.com
-zk-agent wallet create --relay-url <relay-url>
-zk-agent wallet request approve --request-id <id> --relay-url <relay-url> --code <code> --wait
-```
+Use the direct commands when you intentionally want to bypass the workflow
+layer:
 
-The built-in relay is a local file-backed prototype. It is useful for operator
-testing, not a production hosted relay service. When it sits behind a tunnel or
-reverse proxy, pass `--public-origin` so the emitted share/status URLs point at
-the externally reachable hosted URL instead of the local bind address. The
-published package now also ships the bundled connector UI build used by
-`relay serve`, so hosted share-link approval no longer depends on a separate
-source checkout just to serve the UI. `relay inspect` now also reports
-`stateBackend`, `deploymentScope`, and `sameHostRestartPersists` so the
-single-host local-filesystem constraint is explicit before you rely on a hosted
-URL. For the current supported hosted operating contract and the remaining
-`beta -> rc` blocker on this path, see
-[`docs/16-hosted-approval-operated-baseline.md`](../../docs/16-hosted-approval-operated-baseline.md).
+- `zk-agent send-token --wallet main --symbol USDC --to <address> --amount <amount>`
+- `zk-agent swap --wallet main --token-in-symbol USDC --token-out-symbol ETH --amount-in <amount>`
+- `zk-agent fund --wallet main --symbol USDC --amount <amount>`
+- `zk-agent deposit --wallet main --symbol USDC --amount <amount>`
+- `zk-agent withdraw --wallet main --symbol USDC --amount <amount>`
 
-## Local Storage
+## Local storage
 
-By default the CLI stores config, wallets, requests, and workflow checkpoints
-under:
+By default the CLI stores local state under:
 
 ```text
 ~/.zk-agent/
 ```
 
-Common files created by the default path:
+Common files:
 
 - `config.json`
 - `wallets/*.json`
 - `requests/*.json`
 - `workflows/*.json`
 
-## Smart-Account Profiles
+## Smart-account profiles
+
+The packaged CLI includes built-in profile artifacts for:
 
-The published package ships built-in profile artifacts for the first-party
-smart-account presets:
+- `sed-lite`
+- `daily-spend-limit`
+
+Inspect them with:
 
 ```bash
 zk-agent wallet smart-account profiles --json
 ```
 
-That means the packaged CLI can use:
-
-- `zk-agent wallet smart-account predict --profile sed-lite`
-- `zk-agent wallet smart-account deploy --profile sed-lite`
-- the same built-in path for `daily-spend-limit`
+Use the packaged path for:
 
-Current boundary:
-
-- built-in profiles work from the packaged CLI
-- custom profile artifacts still use `--artifact <json|@file>`
-- `ZK_AGENT_ACCOUNT_PROFILES_ROOT` is now only a source-checkout override for
-  development or custom runtime layouts
+```bash
+zk-agent wallet smart-account predict --profile sed-lite
+zk-agent wallet smart-account deploy --profile sed-lite
+```
 
-## Common Failures
+## Common failures
 
 Connector callback never arrives:
 
 - verify the connector URL saved by `zk-agent setup`
-- if local callback is not possible in your environment, switch to the relay
-  path with `zk-agent relay serve` plus `wallet create|reapprove --relay-url`
+- if local callback is impossible in the current environment, switch to the
+  relay-backed path
 
 CLI says the wallet is missing a writable session:
 
-- if the blocker is unclear, run `zk-agent doctor --wallet <wallet>` first
+- run `zk-agent doctor --wallet <wallet>`
 - inspect `zk-agent wallet status --name <wallet>`
-- if approval is missing, run `zk-agent wallet reapprove --name <wallet> --await-local`
-- if approval is present but the local signer is missing, run
-  `zk-agent wallet signer attach --name <wallet> --private-key <hex>`
-- then rerun `zk-agent next` or the blocked workflow command
+- reapprove when approval is missing
+- attach the signer when approval is present but local write readiness is not
 
 Workflow stops on funding:
 
 - do not guess the route
 - run the exact `workflow fund` command suggested by the CLI
 
-Relay / `--await-local` flows fail in a locked-down environment:
+Locked-down environment blocks local callback or relay binding:
 
-- those flows need a process that can bind `127.0.0.1`
-- rerun from a normal host shell or use the relay/manual approval path
+- rerun from a normal host shell
+- or use a relay/manual approval path that matches the environment
 
-## Command Help
+## Command help
 
-For the canonical command surfaces:
+Use:
 
 ```bash
 zk-agent --help
 zk-agent doctor --help
 zk-agent wallet --help
 zk-agent workflow --help
+zk-agent suite --help
 ```
 
 ## License

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { Command as Command12, CommanderError } from "commander";
+import { Command as Command13, CommanderError } from "commander";
 import { config as loadEnv } from "dotenv";
 
 // src/commands/operations.ts
@@ -7824,8 +7824,8 @@ function buildTopLevelNextRecommendedCommand(requestId, paymasterMode) {
   const command = requestId ? `zk-agent next --request-id ${requestId}` : "zk-agent next";
   return appendPaymasterMode(command, paymasterMode);
 }
-function buildWalletCreateRecommendedCommand() {
-  return "zk-agent wallet create --await-local";
+function buildWalletCreateRecommendedCommand(paymasterMode) {
+  return appendPaymasterMode("zk-agent wallet create --await-local", paymasterMode);
 }
 function buildRelayInspectRecommendedCommand(relayUrl = "<url>") {
   return `zk-agent relay inspect --relay-url ${relayUrl}`;
@@ -7983,6 +7983,12 @@ function buildWorkflowPayRecommendedCommand(walletName, paymasterMode) {
   const command = `zk-agent workflow pay --wallet ${walletName} --to <address> --amount <amount>`;
   return appendPaymasterMode(command, paymasterMode);
 }
+function buildWorkflowFundRecommendedCommand(walletName) {
+  return `zk-agent workflow fund --wallet ${walletName}`;
+}
+function buildWorkflowFundRunRecommendedCommand(walletName) {
+  return `zk-agent workflow fund --wallet ${walletName} --amount <amount> --execute`;
+}
 function buildWorkflowShowRecommendedCommand(requestId) {
   return `zk-agent workflow show --request-id ${requestId}`;
 }
@@ -10145,6 +10151,66 @@ function onboardingSummaryLines(summary) {
   ];
 }
 
+// src/lib/onboarding-paths.ts
+function formatRecommendedPath(commands) {
+  return commands.join(" -> ");
+}
+function recommendedPathLines(paths) {
+  if (!paths) return [];
+  return [
+    ["path (local)", formatRecommendedPath(paths.local)],
+    ...paths.remoteBrowser?.length ? [["path (remote-browser)", formatRecommendedPath(paths.remoteBrowser)]] : []
+  ];
+}
+function buildSetupRecommendedPaths(relayUrl = "<url>", paymasterMode) {
+  const next = buildTopLevelNextRecommendedCommand(void 0, paymasterMode);
+  return {
+    local: [
+      "zk-agent setup",
+      next,
+      buildWalletCreateRecommendedCommand(paymasterMode),
+      next
+    ],
+    remoteBrowser: [
+      "zk-agent setup",
+      next,
+      buildRelayInspectRecommendedCommand(relayUrl),
+      buildWalletCreateRemoteRecommendedCommand(relayUrl, paymasterMode),
+      next
+    ]
+  };
+}
+function buildWalletBootstrapRecommendedPaths(relayUrl = "<url>", paymasterMode, walletName = "main") {
+  const next = buildTopLevelNextRecommendedCommand(void 0, paymasterMode);
+  return {
+    local: [buildWalletCreateRecommendedCommand(paymasterMode), next],
+    remoteBrowser: [
+      buildRelayInspectRecommendedCommand(relayUrl),
+      buildWalletCreateRemoteRecommendedCommand(relayUrl, paymasterMode, walletName),
+      next
+    ]
+  };
+}
+function buildWalletReapprovalRecommendedPaths(walletName, relayUrl = "<url>", paymasterMode) {
+  const next = buildTopLevelNextRecommendedCommand(void 0, paymasterMode);
+  return {
+    local: [buildWalletReapproveRecommendedCommand(walletName), next],
+    remoteBrowser: [
+      buildRelayInspectRecommendedCommand(relayUrl),
+      buildWalletReapproveRemoteRecommendedCommand(walletName, relayUrl),
+      next
+    ]
+  };
+}
+function buildSignerRecoveryRecommendedPaths(walletName, paymasterMode) {
+  return {
+    local: [
+      buildWalletSignerAttachRecommendedCommand(walletName),
+      buildTopLevelNextRecommendedCommand(void 0, paymasterMode)
+    ]
+  };
+}
+
 // src/commands/setup.ts
 function buildSetupHelpText() {
   return [
@@ -10162,7 +10228,7 @@ function buildSetupHelpText() {
     "  zk-agent wallet create --await-local",
     "  zk-agent next",
     "",
-    "If the browser is not colocated with this terminal, switch at the wallet step:",
+    "Remote-browser variant of the same path:",
     "  zk-agent relay inspect --relay-url <url>",
     "  zk-agent wallet create --relay-url <url> --wait-relay --prompt-code",
     "  zk-agent next",
@@ -10182,6 +10248,7 @@ function createInitCommand() {
       createWalletRemote: buildWalletCreateRemoteRecommendedCommand(),
       afterWalletApproval: buildTopLevelNextRecommendedCommand()
     };
+    const recommendedPaths = buildSetupRecommendedPaths();
     const existing = await loadProjectConfig();
     if (existing && !options.force) {
       const onboardingSummary2 = buildOnboardingSummary({
@@ -10202,6 +10269,7 @@ function createInitCommand() {
           ...onboardingSummaryLines(onboardingSummary2),
           ["default chain", existing.defaultChain],
           ["connector", existing.connectorUrl],
+          ...recommendedPathLines(recommendedPaths),
           ["next", recommendedCommands.next],
           ["inspect defaults", recommendedCommands.inspectDefaults],
           ["create wallet (local)", recommendedCommands.createWallet],
@@ -10214,6 +10282,7 @@ function createInitCommand() {
           message: "Config already exists. Re-run with --force to overwrite.",
           config: existing,
           onboardingSummary: onboardingSummary2,
+          recommendedPaths,
           recommendedCommands
         }
       );
@@ -10245,6 +10314,7 @@ function createInitCommand() {
         ...onboardingSummaryLines(onboardingSummary),
         ["default chain", config.defaultChain],
         ["connector", config.connectorUrl],
+        ...recommendedPathLines(recommendedPaths),
         ["next", recommendedCommands.next],
         ["inspect defaults", recommendedCommands.inspectDefaults],
         ["create wallet (local)", recommendedCommands.createWallet],
@@ -10252,7 +10322,7 @@ function createInitCommand() {
         ["create wallet (remote)", recommendedCommands.createWalletRemote],
         ["after approval", recommendedCommands.afterWalletApproval]
       ],
-      { ok: true, config, onboardingSummary, recommendedCommands }
+      { ok: true, config, onboardingSummary, recommendedPaths, recommendedCommands }
     );
   });
 }
@@ -10774,7 +10844,7 @@ function buildNextHelpText() {
     "    zk-agent wallet create --await-local",
     "    zk-agent next",
     "",
-    "  If the browser is remote, switch at the wallet step instead of waiting for a local callback:",
+    "  Remote-browser variant of the same path:",
     "    zk-agent relay inspect --relay-url <url>",
     "    zk-agent wallet create --relay-url <url> --wait-relay --prompt-code",
     "    zk-agent next",
@@ -10788,10 +10858,12 @@ function buildNextHelpText() {
     "    zk-agent wallet next --name main",
     "",
     "  Switch to the hosted remote-approval path only when the browser is not colocated:",
-    "    zk-agent wallet --help",
+    "    zk-agent relay inspect --relay-url <url>",
+    "    zk-agent wallet create|reapprove --relay-url <url> --wait-relay --prompt-code",
     "",
-    "  Use `wallet --help` when you already know the blocker is wallet-specific:",
+    "  Use wallet-layer commands when you already know the blocker is wallet-specific:",
     "    zk-agent wallet next --name main",
+    "    zk-agent wallet status --name main",
     "",
     "  Stay on the workflow layer only when you already have an explicit workflow or checkpoint:",
     "    zk-agent workflow next --request-id <id>"
@@ -10898,6 +10970,7 @@ function createNextCommand(deps) {
         afterSetup: buildTopLevelNextRecommendedCommand2(),
         inspectDefaults: buildDefaultsRecommendedCommand()
       };
+      const recommendedPaths2 = buildSetupRecommendedPaths("<url>", paymasterMode);
       const onboardingSummary2 = buildOnboardingSummary({
         stage: "setup",
         localOnly: true,
@@ -10914,6 +10987,7 @@ function createNextCommand(deps) {
           ["status", "No local config found"],
           ...agentProfileLines(agentProfile),
           ...agentFollowupLines(defaultAgentFollowup),
+          ...recommendedPathLines(recommendedPaths2),
           ["next", recommendedCommands2.setup],
           ["after setup", recommendedCommands2.afterSetup],
           ["inspect defaults", recommendedCommands2.inspectDefaults]
@@ -10924,6 +10998,7 @@ function createNextCommand(deps) {
           status: "action-required",
           nextCommand: recommendedCommands2.setup,
           onboardingSummary: onboardingSummary2,
+          recommendedPaths: recommendedPaths2,
           agentProfile,
           agentFollowup: defaultAgentFollowup,
           recommendedCommands: recommendedCommands2
@@ -10946,6 +11021,11 @@ function createNextCommand(deps) {
         afterApproval: appendPaymasterMode2(buildTopLevelNextRecommendedCommand2(), paymasterMode),
         inspectDefaults: buildDefaultsRecommendedCommand()
       };
+      const recommendedPaths2 = buildWalletBootstrapRecommendedPaths(
+        "<url>",
+        paymasterMode,
+        walletName
+      );
       const onboardingSummary2 = buildOnboardingSummary({
         stage: "wallet-bootstrap",
         localOnly: true,
@@ -10966,6 +11046,7 @@ function createNextCommand(deps) {
           ["connector", config.connectorUrl],
           ...agentProfileLines(agentProfile),
           ...agentFollowupLines(defaultAgentFollowup),
+          ...recommendedPathLines(recommendedPaths2),
           ["next", recommendedCommands2.createWallet],
           ["relay inspect", recommendedCommands2.relayInspect],
           ["remote fallback", recommendedCommands2.createWalletRemote],
@@ -10979,6 +11060,7 @@ function createNextCommand(deps) {
           config,
           nextCommand: recommendedCommands2.createWallet,
           onboardingSummary: onboardingSummary2,
+          recommendedPaths: recommendedPaths2,
           agentProfile,
           agentFollowup: defaultAgentFollowup,
           recommendedCommands: recommendedCommands2
@@ -11055,39 +11137,64 @@ function createNextCommand(deps) {
       nextAction: nextCommand,
       inspectDefaults: buildDefaultsRecommendedCommand()
     };
+    const recoveryRecommendedCommands = !inspection.approvalReady ? {
+      reapprove: buildWalletReapproveRecommendedCommand(wallet.walletName),
+      relayInspect: buildRelayInspectRecommendedCommand(),
+      reapproveRemote: buildWalletReapproveRemoteRecommendedCommand(wallet.walletName),
+      afterRecovery: appendPaymasterMode2(buildTopLevelNextRecommendedCommand2(), paymasterMode)
+    } : !inspection.localExecutionKeyStored ? {
+      attachSigner: buildWalletSignerAttachRecommendedCommand(wallet.walletName),
+      afterRecovery: appendPaymasterMode2(
+        buildTopLevelNextRecommendedCommand2(),
+        paymasterMode
+      )
+    } : {};
+    const recommendedPaths = !inspection.approvalReady ? buildWalletReapprovalRecommendedPaths(wallet.walletName, "<url>", paymasterMode) : !inspection.localExecutionKeyStored ? buildSignerRecoveryRecommendedPaths(wallet.walletName, paymasterMode) : {
+      local: [nextCommand]
+    };
+    const mergedRecommendedCommands = {
+      ...recommendedCommands,
+      ...recoveryRecommendedCommands
+    };
     const tokenDiscoverySummary = buildWalletTokenDiscoverySummary({
       walletName: wallet.walletName,
       chain: wallet.chain,
       nextAction: nextCommand,
       paymasterMode,
-      recommendedCommands
+      recommendedCommands: mergedRecommendedCommands
     });
     printResult(
       topLevelNextLines("wallet", [
         ...walletNextLines(summary),
         ...agentProfileLines(agentProfile),
         ...agentFollowupLines(agentFollowup),
+        ...recommendedPathLines(recommendedPaths),
         ...summary.recommendedCommand ? [] : [["next", workflowPay]],
-        ["discover assets", recommendedCommands.discoverAssets],
-        ["discover owned tokens", recommendedCommands.discoverOwnedTokens],
-        ...recommendedCommands.discoverPaymasterTokens ? [["discover paymaster tokens", recommendedCommands.discoverPaymasterTokens]] : [],
-        ["discover tokens", recommendedCommands.discoverTokens],
-        ...recommendedCommands.inspectPaymasterToken ? [["inspect paymaster token", recommendedCommands.inspectPaymasterToken]] : [],
-        ["inspect token", recommendedCommands.inspectToken],
-        ["inspect defaults", recommendedCommands.inspectDefaults]
+        ...mergedRecommendedCommands.reapprove ? [["reapprove", mergedRecommendedCommands.reapprove]] : [],
+        ...mergedRecommendedCommands.attachSigner ? [["attach signer", mergedRecommendedCommands.attachSigner]] : [],
+        ...mergedRecommendedCommands.relayInspect ? [["relay inspect", mergedRecommendedCommands.relayInspect]] : [],
+        ...mergedRecommendedCommands.reapproveRemote ? [["remote fallback", mergedRecommendedCommands.reapproveRemote]] : [],
+        ["discover assets", mergedRecommendedCommands.discoverAssets],
+        ["discover owned tokens", mergedRecommendedCommands.discoverOwnedTokens],
+        ...mergedRecommendedCommands.discoverPaymasterTokens ? [["discover paymaster tokens", mergedRecommendedCommands.discoverPaymasterTokens]] : [],
+        ["discover tokens", mergedRecommendedCommands.discoverTokens],
+        ...mergedRecommendedCommands.inspectPaymasterToken ? [["inspect paymaster token", mergedRecommendedCommands.inspectPaymasterToken]] : [],
+        ["inspect token", mergedRecommendedCommands.inspectToken],
+        ["inspect defaults", mergedRecommendedCommands.inspectDefaults]
       ], onboardingSummary),
       {
         ok: true,
         scope: "wallet",
         walletName: wallet.walletName,
         onboardingSummary,
+        recommendedPaths,
         agentProfile,
         agentFollowup,
         inspection,
         summary,
         nextCommand,
         tokenDiscoverySummary,
-        recommendedCommands
+        recommendedCommands: mergedRecommendedCommands
       }
     );
   });
@@ -11114,7 +11221,7 @@ function buildDoctorHelpText() {
     "  and the shortest next command without requiring live RPC reads.",
     "  Run this before guessing whether the blocker is setup, wallet approval, or local signer state.",
     "",
-    "Remote-browser recovery path:",
+    "Remote-browser variant:",
     "  Pass --relay-url when you want the remote approval fallback commands",
     "  to use a concrete relay URL instead of a placeholder."
   ].join("\n");
@@ -11204,6 +11311,7 @@ function buildDoctorResult(options) {
     return {
       scope: "setup",
       nextAction: recommendedCommands2.setup,
+      recommendedPaths: buildSetupRecommendedPaths(options.relayUrl),
       onboardingSummary: onboardingSummary2,
       summary: {
         stage: "setup",
@@ -11244,6 +11352,7 @@ function buildDoctorResult(options) {
     return {
       scope: "wallet-bootstrap",
       nextAction: recommendedCommands2.createWallet,
+      recommendedPaths: buildWalletBootstrapRecommendedPaths(options.relayUrl, void 0, options.walletName),
       onboardingSummary: onboardingSummary2,
       summary: {
         stage: "wallet-bootstrap",
@@ -11286,6 +11395,10 @@ function buildDoctorResult(options) {
     return {
       scope: "wallet-recovery",
       nextAction: recommendedCommands2.reapprove,
+      recommendedPaths: buildWalletReapprovalRecommendedPaths(
+        options.wallet.walletName,
+        options.relayUrl
+      ),
       onboardingSummary: onboardingSummary2,
       summary: {
         stage: "wallet-recovery",
@@ -11329,6 +11442,7 @@ function buildDoctorResult(options) {
     return {
       scope: "wallet-recovery",
       nextAction: attachSigner,
+      recommendedPaths: buildSignerRecoveryRecommendedPaths(options.wallet.walletName),
       onboardingSummary: onboardingSummary2,
       summary: {
         stage: "wallet-recovery",
@@ -11367,6 +11481,9 @@ function buildDoctorResult(options) {
   return {
     scope: "wallet-ready",
     nextAction: recommendedCommands.next,
+    recommendedPaths: {
+      local: [recommendedCommands.next]
+    },
     onboardingSummary,
     summary: {
       stage: "wallet-ready",
@@ -11424,6 +11541,7 @@ function buildDoctorLines(input) {
     }
   }
   lines.push(["next", input.nextAction]);
+  lines.push(...recommendedPathLines(input.recommendedPaths));
   if (input.recommendedCommands.createWallet) {
     lines.push(["create wallet (local)", input.recommendedCommands.createWallet]);
   }
@@ -11479,6 +11597,7 @@ function createDoctorCommand() {
           wallet,
           onboardingSummary: result.onboardingSummary,
           summary: result.summary,
+          recommendedPaths: result.recommendedPaths,
           recommendedCommands: result.recommendedCommands,
           nextAction: result.nextAction
         }),
@@ -11503,6 +11622,7 @@ function createDoctorCommand() {
         agentProfile,
         agentFollowup,
         nextAction: result.nextAction,
+        recommendedPaths: result.recommendedPaths,
         recommendedCommands: result.recommendedCommands
       }
     );
@@ -12586,8 +12706,135 @@ function normalizeSource(value) {
   );
 }
 
-// src/commands/tokens.ts
+// src/commands/suite.ts
 import { Command as Command8 } from "commander";
+
+// src/lib/operator-suite.ts
+function buildOperatorSuitePayload(options = {}) {
+  const walletName = options.walletName?.trim() || "main";
+  const chain = options.chain?.trim() || "zksync-sepolia";
+  const flagshipCommand = buildWorkflowPayRecommendedCommand(walletName);
+  const inspectDefaults = buildDefaultsRecommendedCommand();
+  const discoveryCommand = buildAssetsRecommendedCommand(walletName);
+  const paymasterCommand = buildWorkflowPayRecommendedCommand(walletName, "approval-based");
+  const fundingCommand = buildWorkflowFundRecommendedCommand(walletName);
+  const flagship = {
+    id: "flagship-pay",
+    title: "Flagship Pay",
+    goal: "Run the default zkSync-native native-send path through the workflow layer.",
+    primaryCommand: flagshipCommand,
+    supportingCommands: [
+      "zk-agent next",
+      "zk-agent wallet status --name main",
+      inspectDefaults
+    ],
+    skillPath: "skills/zk-aa/SKILL.md"
+  };
+  const slices = [
+    {
+      id: "discovery-defaults",
+      title: "Discovery / Defaults",
+      goal: "Discover owned assets, tracked defaults, and symbol-first token resolution before acting.",
+      primaryCommand: discoveryCommand,
+      supportingCommands: [
+        inspectDefaults,
+        `zk-agent tokens --chain ${chain}`,
+        buildResolveTokenRecommendedCommand(chain, "USDC")
+      ],
+      skillPath: "skills/zk-discovery/SKILL.md",
+      smokeCommand: `pnpm smoke:discovery -- --wallet ${walletName}`
+    },
+    {
+      id: "paymaster-readiness",
+      title: "Paymaster Readiness",
+      goal: "Stay on the approval-based flagship path and recover the exact fee-token/default metadata when needed.",
+      primaryCommand: paymasterCommand,
+      supportingCommands: [
+        inspectDefaults,
+        buildPaymasterFeeTokensRecommendedCommand(chain),
+        buildPaymasterFeeTokenResolveRecommendedCommand(chain)
+      ],
+      skillPath: "skills/zk-paymaster/SKILL.md",
+      smokeCommand: `pnpm smoke:paymaster-success -- --wallet ${walletName}`
+    },
+    {
+      id: "funding-readiness",
+      title: "Funding Readiness",
+      goal: "Ask the workflow layer for the exact funding route before executing bridge/deposit follow-up.",
+      primaryCommand: fundingCommand,
+      supportingCommands: [
+        buildWorkflowFundRunRecommendedCommand(walletName),
+        `zk-agent fund --wallet ${walletName} --amount <amount>`,
+        buildWorkflowStatusRecommendedCommand("<request-id>")
+      ],
+      skillPath: "skills/zk-funding/SKILL.md",
+      smokeCommand: `pnpm smoke:funding-readiness -- --wallet ${walletName}`
+    }
+  ];
+  return {
+    ok: true,
+    summary: {
+      suiteId: "zk-agent-operator-suite",
+      walletName,
+      chain,
+      flagshipId: flagship.id,
+      postFlagshipSliceIds: slices.map((entry) => entry.id),
+      nextAction: flagship.primaryCommand
+    },
+    flagship,
+    slices,
+    recommendedCommands: {
+      suite: "zk-agent suite",
+      flagship: flagshipCommand,
+      discovery: discoveryCommand,
+      paymaster: paymasterCommand,
+      funding: fundingCommand,
+      inspectDefaults
+    }
+  };
+}
+function operatorSuiteLines(payload) {
+  const sliceLines = payload.slices.flatMap((entry) => [
+    [entry.id, formatRecommendedPath([entry.primaryCommand, ...entry.supportingCommands])],
+    [`${entry.id} skill`, entry.skillPath],
+    ...entry.smokeCommand ? [[`${entry.id} smoke`, entry.smokeCommand]] : []
+  ]);
+  return [
+    ["suite", payload.summary.suiteId],
+    ["wallet", payload.summary.walletName],
+    ["chain", payload.summary.chain],
+    ["flagship", formatRecommendedPath([payload.flagship.primaryCommand, "zk-agent next"])],
+    ...sliceLines,
+    ["next action", payload.summary.nextAction]
+  ];
+}
+
+// src/commands/suite.ts
+function createSuiteCommand() {
+  return new Command8("suite").description("Show the flagship and post-flagship zkSync-native operator suite").option("--wallet <name>", "Wallet name used in example commands", "main").option("--chain <chain>", "Chain key used in example commands", "zksync-sepolia").addHelpText(
+    "after",
+    [
+      "",
+      "  Current operator suite:",
+      "    zk-agent workflow pay --wallet main --to <address> --amount <amount>",
+      "    zk-agent assets --wallet main",
+      "    zk-agent workflow fund --wallet main",
+      "    zk-agent workflow pay --wallet main --to <address> --amount <amount> --paymaster-mode approval-based",
+      "",
+      "  Use `suite` when you want the flagship path plus the current",
+      "  post-flagship discovery/defaults, funding, and paymaster surfaces in one place."
+    ].join("\n")
+  ).action((options) => {
+    const payload = buildOperatorSuitePayload({
+      walletName: options.wallet,
+      chain: options.chain
+    });
+    printResult(operatorSuiteLines(payload), payload);
+  });
+}
+
+// src/commands/tokens.ts
+import { Command as Command9 } from "commander";
 var provider2 = new ZkSyncWalletProvider();
 function resolveTokensCommandDeps(deps) {
   return {
@@ -12717,7 +12964,7 @@ function buildTokenDiscoverySummary(result) {
 }
 function createTokensCommand(deps) {
   const resolvedDeps = resolveTokensCommandDeps(deps);
-  return new Command8("tokens").description("List discoverable tokens from the configured local-first token registry, or inspect the owned ERC-20 registry subset for one wallet").addHelpText(
+  return new Command9("tokens").description("List discoverable tokens from the configured local-first token registry, or inspect the owned ERC-20 registry subset for one wallet").addHelpText(
     "after",
     [
       "",
@@ -12922,7 +13169,7 @@ function normalizeRole2(value) {
 }
 
 // src/commands/relay.ts
-import { Command as Command9 } from "commander";
+import { Command as Command10 } from "commander";
 
 // src/lib/relay.ts
 import { createServer } from "node:http";
@@ -13432,9 +13679,9 @@ async function startRelayServer(options) {
 // src/commands/relay.ts
 function buildRelayServeRecommendedCommands(options) {
   const commands = {
-    inspectRelay: `zk-agent relay inspect --relay-url ${options.relayUrl}`,
-    createWallet: `zk-agent wallet create --relay-url ${options.relayUrl} --wait-relay --prompt-code`,
-    reapproveWallet: `zk-agent wallet reapprove --name main --relay-url ${options.relayUrl} --wait-relay --prompt-code`
+    inspectRelay: buildRelayInspectRecommendedCommand(options.relayUrl),
+    createWallet: buildWalletCreateRemoteRecommendedCommand(options.relayUrl),
+    reapproveWallet: buildWalletReapproveRemoteRecommendedCommand("main", options.relayUrl)
   };
   if (options.publicOriginLooksLocal) {
     return {
@@ -13447,14 +13694,41 @@ function buildRelayServeRecommendedCommands(options) {
 function buildRelayInspectRecommendedCommands(options) {
   const commands = {};
   if (options.compatible) {
-    commands.createWallet = `zk-agent wallet create --relay-url ${options.publicOrigin} --wait-relay --prompt-code`;
-    commands.reapproveWallet = `zk-agent wallet reapprove --name main --relay-url ${options.publicOrigin} --wait-relay --prompt-code`;
+    commands.createWallet = buildWalletCreateRemoteRecommendedCommand(options.publicOrigin);
+    commands.reapproveWallet = buildWalletReapproveRemoteRecommendedCommand(
+      "main",
+      options.publicOrigin
+    );
   }
   if (options.publicOriginLooksLocal) {
     commands.restartWithPublicOrigin = "zk-agent relay serve --public-origin https://relay.example.com";
   }
   return commands;
 }
+function buildRelayApprovalPaths(options) {
+  const inspectRelay = buildRelayInspectRecommendedCommand(options.relayUrl);
+  const next = buildTopLevelNextRecommendedCommand();
+  const maybeInspectRelay = options.includeInspectRelay ? [inspectRelay] : [];
+  return {
+    createWallet: [
+      ...maybeInspectRelay,
+      buildWalletCreateRemoteRecommendedCommand(options.relayUrl),
+      next
+    ],
+    reapproveWallet: [
+      ...maybeInspectRelay,
+      buildWalletReapproveRemoteRecommendedCommand("main", options.relayUrl),
+      next
+    ]
+  };
+}
+function relayApprovalPathLines(paths) {
+  if (!paths) return [];
+  return [
+    ["path create wallet", formatRecommendedPath(paths.createWallet)],
+    ["path reapprove wallet", formatRecommendedPath(paths.reapproveWallet)]
+  ];
+}
 function buildRelayHostedReadinessSummary(options) {
   let status;
   if (!options.compatible) {
@@ -13752,11 +14026,15 @@ function buildRelayInspectPayload(relayUrl, rawHealth) {
       compatible,
       publicOriginLooksLocal
     }),
+    relayApprovalPaths: compatible ? buildRelayApprovalPaths({
+      relayUrl: publicOrigin,
+      includeInspectRelay: false
+    }) : void 0,
     notes
   };
 }
 function createRelayCommand() {
-  const relay = new Command9("relay").description("Run the local connector relay prototype server");
+  const relay = new Command10("relay").description("Run the local connector relay prototype server");
   relay.addHelpText(
     "after",
     [
@@ -13798,6 +14076,10 @@ function createRelayCommand() {
       relayUrl: publicOrigin,
       publicOriginLooksLocal
     });
+    const relayApprovalPaths = buildRelayApprovalPaths({
+      relayUrl: publicOrigin,
+      includeInspectRelay: true
+    });
     const deploymentSummary = buildRelayDeploymentSummary({
       origin: server.origin,
       publicOrigin,
@@ -13862,6 +14144,7 @@ function createRelayCommand() {
         ...connectorUiAvailable ? ["connector-ui"] : []
       ],
       recommendedCommands,
+      relayApprovalPaths,
       notes
     };
     if (shouldJsonOutput()) {
@@ -13891,6 +14174,9 @@ function createRelayCommand() {
       humanLine("inspect relay", recommendedCommands.inspectRelay);
       humanLine("create wallet", recommendedCommands.createWallet);
       humanLine("reapprove wallet", recommendedCommands.reapproveWallet);
+      for (const [label, value] of relayApprovalPathLines(relayApprovalPaths)) {
+        humanLine(label, value);
+      }
       if (recommendedCommands.restartWithPublicOrigin) {
         humanLine("restart with public origin", recommendedCommands.restartWithPublicOrigin);
       }
@@ -13981,6 +14267,9 @@ function createRelayCommand() {
       if (payload.recommendedCommands.reapproveWallet) {
         humanLine("reapprove wallet", payload.recommendedCommands.reapproveWallet);
       }
+      for (const [label, value] of relayApprovalPathLines(payload.relayApprovalPaths)) {
+        humanLine(label, value);
+      }
     }
     if (payload.recommendedCommands.restartWithPublicOrigin) {
       humanLine(
@@ -13998,7 +14287,7 @@ function createRelayCommand() {
 // src/commands/wallet.ts
 import { createServer as createServer2 } from "node:http";
 import { createInterface } from "node:readline/promises";
-import { Command as Command10 } from "commander";
+import { Command as Command11 } from "commander";
 
 // ../account-profiles/src/profiles.ts
 import fs8 from "node:fs";
@@ -16665,32 +16954,32 @@ async function printBuiltinSmartAccountProfiles() {
 }
 function createWalletCommand(deps) {
   const resolvedDeps = resolveWalletCommandDeps(deps);
-  const wallet = new Command10("wallet").description(
+  const wallet = new Command11("wallet").description(
     "Create, inspect, and recover local-first wallet sessions"
   );
-  const request = new Command10("request").description("Inspect and finalize pending wallet requests");
-  const signer = new Command10("signer").description(
+  const request = new Command11("request").description("Inspect and finalize pending wallet requests");
+  const signer = new Command11("signer").description(
     "Inspect and manage the stored local execution signer for a wallet"
   );
-  const smartAccount = new Command10("smart-account").description(
+  const smartAccount = new Command11("smart-account").description(
     "Predict and deploy zkSync smart-account contracts from a supplied artifact or built-in profile"
   );
-  const sedLite = new Command10("sed-lite").description(
+  const sedLite = new Command11("sed-lite").description(
     "Inspect and manage the SED modular smart-account profile"
   );
-  const nativeCapHook = new Command10("native-cap-hook").description(
+  const nativeCapHook = new Command11("native-cap-hook").description(
     "Inspect and manage the first SED Lite validation-hook policy: native per-transaction spend caps"
   );
-  const targetAllowlistHook = new Command10("target-allowlist-hook").description(
+  const targetAllowlistHook = new Command11("target-allowlist-hook").description(
     "Inspect and manage the SED Lite validation-hook policy that restricts transactions to an allowlisted target set"
   );
-  const selectorAllowlistHook = new Command10("selector-allowlist-hook").description(
+  const selectorAllowlistHook = new Command11("selector-allowlist-hook").description(
     "Inspect and manage the SED Lite validation-hook policy that restricts contract calls to allowlisted target and selector pairs"
   );
-  const dailySpendLimit = new Command10("daily-spend-limit").description(
+  const dailySpendLimit = new Command11("daily-spend-limit").description(
     "Read and update the native-token daily spend limit used by the built-in daily-spend-limit smart-account profile"
   );
-  const paymaster = new Command10("paymaster").description(
+  const paymaster = new Command11("paymaster").description(
     "Manage saved paymaster defaults for stored wallets"
   );
   wallet.addHelpText(
@@ -19319,7 +19608,7 @@ function createWalletCommand(deps) {
 
 // src/commands/workflow.ts
 import { randomBytes as randomBytes4 } from "node:crypto";
-import { Command as Command11 } from "commander";
+import { Command as Command12 } from "commander";
 var defaultProvider2 = new ZkSyncWalletProvider();
 var defaultDefiProvider2 = new ZkSyncDefiProvider({
   walletWriter: defaultProvider2
@@ -21059,7 +21348,7 @@ function applyWorkflowHelpCommandOrder(workflow) {
 }
 function createWorkflowCommand(deps) {
   const resolvedDeps = resolveWorkflowCommandDeps(deps);
-  const workflow = new Command11("workflow").description(
+  const workflow = new Command12("workflow").description(
     "Plan, persist, and execute higher-level wallet workflows"
   );
   workflow.addHelpText("after", buildWorkflowHelpText());
@@ -21713,6 +22002,9 @@ function buildDefaultOperatorPathHelpText() {
     "  zk-agent next",
     `  ${buildWorkflowPayRecommendedCommand("main")}`,
     "",
+    "Operator suite beyond flagship pay:",
+    "  zk-agent suite",
+    "",
     "Validated first-run baseline:",
     "  setup defaults to zksync-sepolia and the local connector at http://localhost:4444",
     "  Override those only when you intentionally target a different chain or connector deployment.",
@@ -21734,6 +22026,7 @@ var ROOT_HELP_COMMAND_ORDER = [
   "init",
   "wallet",
   "workflow",
+  "suite",
   "assets",
   "balances",
   "fund",
@@ -21767,7 +22060,7 @@ function applyRootHelpCommandOrder(program) {
   program.commands = sortedCommands;
 }
 function createProgram() {
-  const program = new Command12().name("zk-agent").description(
+  const program = new Command13().name("zk-agent").description(
     "Local-first zkSync Era CLI for wallet approval, workflow execution, and hosted relay recovery"
   ).showHelpAfterError().option("--json", "Force JSON output for agent harnesses", false).hook("preAction", (thisCommand) => {
     if (thisCommand.optsWithGlobals().json) process.env.ZK_AGENT_OUTPUT = "json";
@@ -21777,6 +22070,7 @@ function createProgram() {
   program.addCommand(createDoctorCommand());
   program.addCommand(createAgentCommand());
   program.addCommand(createDefaultsCommand());
+  program.addCommand(createSuiteCommand());
   program.addCommand(createTokensCommand());
   program.addCommand(createResolveTokenCommand());
   program.addCommand(createRelayCommand());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zk-agent-cli",
-  "version": "0.1.0-rc.0",
+  "version": "0.1.0-rc.1",
   "description": "Local-first zkSync Era and ZK Stack agent CLI with wallet session recovery, workflow orchestration, relay-backed approval, and SED smart-account support.",
   "license": "MIT",
   "type": "module",