zk-agent-cli 0.1.0-beta.8 → 0.1.0-beta.9

package/README.md

@@ -23,8 +23,9 @@ npx skills add https://github.com/AgiWeb3/zk-agent-cli
 ```
 
 This repo currently ships a repository skill bundle for compatible harnesses.
-It does not yet ship a native ChatGPT/Codex plugin bundle such as
-`.codex-plugin/plugin.json`.
+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:
 

package/dist/index.js

@@ -7745,6 +7745,71 @@ function formatHumanErrorMessage(error) {
   return lines.join("\n");
 }
 
+// src/lib/discovery-summary.ts
+function createEmptyDiscoverySourceCounts() {
+  return {
+    localDeployments: 0,
+    tokenDirectory: 0,
+    unknown: 0
+  };
+}
+function createEmptyDiscoveryRoleCounts() {
+  return Object.fromEntries(
+    REGISTRY_TOKEN_ROLES.map((role) => [role, 0])
+  );
+}
+function summarizeDiscoveryEntrySources(entries) {
+  const counts = createEmptyDiscoverySourceCounts();
+  for (const entry of entries) {
+    if (entry.source === "local-deployments") {
+      counts.localDeployments += 1;
+      continue;
+    }
+    if (entry.source === "token-directory") {
+      counts.tokenDirectory += 1;
+      continue;
+    }
+    counts.unknown += 1;
+  }
+  return counts;
+}
+function summarizeDiscoveryRoleMatches(entries) {
+  const counts = createEmptyDiscoveryRoleCounts();
+  for (const entry of entries) {
+    for (const match of entry.defaultsRegistryMatches || []) {
+      counts[match.role] += 1;
+    }
+  }
+  return counts;
+}
+function countCurrentValidatedDefaultEntries(entries) {
+  return entries.filter(
+    (entry) => (entry.defaultsRegistryMatches || []).some((match) => match.isCurrentValidatedDefault)
+  ).length;
+}
+function listUniqueDiscoveryChains(entries) {
+  return [...new Set(
+    entries.map((entry) => entry.chainKey?.trim()).filter((value) => Boolean(value))
+  )];
+}
+function firstDiscoverySymbol(entries) {
+  return entries.find((entry) => entry.symbol?.trim())?.symbol?.trim() || null;
+}
+function firstDiscoverySource(entries) {
+  if (entries.length === 0) return null;
+  return entries[0]?.source || "unknown";
+}
+function summarizeTokenRegistrySources(sources) {
+  return sources.map((source) => ({
+    id: source.id,
+    enabled: source.enabled,
+    exists: source.exists
+  }));
+}
+function findNativeBalance(balances) {
+  return balances.find((balance) => balance.type === "native") || null;
+}
+
 // src/lib/recommended-commands.ts
 function appendPaymasterMode(command, paymasterMode) {
   if (!paymasterMode || paymasterMode === "none") {
@@ -9181,6 +9246,27 @@ function linesForMultiBalances(result) {
   }
   return lines;
 }
+function buildAssetsDiscoverySummary(result) {
+  const nativeBalance = findNativeBalance(result.balances);
+  const ownedTokenSymbols = (result.ownedTokenRegistry?.entries || []).map((entry) => entry.symbol?.trim()).filter((value) => Boolean(value));
+  return {
+    walletName: result.walletName,
+    chain: result.chain,
+    chainId: result.chainId,
+    assetCount: result.balances.length,
+    nativeAssetSymbol: nativeBalance?.symbol || null,
+    nativeAssetBalance: nativeBalance?.balance || null,
+    ownedTokenCount: result.ownedTokenRegistry?.entryCount || 0,
+    primaryOwnedTokenSymbol: firstDiscoverySymbol(result.ownedTokenRegistry?.entries || []),
+    ownedTokenSymbols,
+    ownedTokenSourceCounts: result.ownedTokenRegistry?.summary.sourceCounts || null,
+    ownedBridgeMappingCounts: result.ownedTokenRegistry?.summary.bridgeMappingCounts || null,
+    ownedRegistryRoleCounts: result.ownedTokenRegistry?.summary.registryRoleCounts || null
+  };
+}
+function buildBalancesDiscoverySummary(result) {
+  return buildAssetsDiscoverySummary(result);
+}
 function withPaymasterOptions(command) {
   return command.option("--paymaster-mode <mode>", "none, sponsored, or approval-based").option("--paymaster-address <address>", "Explicit paymaster contract address override").option("--paymaster-token <address>", "ERC-20 token address for approval-based paymaster mode");
 }
@@ -9240,7 +9326,23 @@ function createBalancesCommand(deps) {
       provider: resolvedDeps.provider,
       ownedTokens: options.ownedTokens
     });
-    printResult(linesForSingleBalances(payload), { ok: true, ...payload });
+    const discoverySummary = options.ownedTokens && "ownedTokenRegistry" in payload ? buildBalancesDiscoverySummary(payload) : void 0;
+    const recommendedCommands = options.ownedTokens ? buildDiscoveryRecommendedCommands({
+      walletName,
+      chain: payload.chain
+    }) : void 0;
+    printResult(
+      [
+        ...linesForSingleBalances(payload),
+        ...recommendedCommands ? workflowFollowupLines(recommendedCommands) : []
+      ],
+      {
+        ok: true,
+        ...discoverySummary ? { discoverySummary } : {},
+        ...recommendedCommands ? { recommendedCommands } : {},
+        ...payload
+      }
+    );
   });
 }
 function createAssetsCommand(deps) {
@@ -9279,9 +9381,12 @@ function createAssetsCommand(deps) {
       chain: payload.chain,
       includeAssets: false
     });
+    const discoverySummary = buildAssetsDiscoverySummary(
+      payload
+    );
     printResult(
       [...linesForSingleBalances(payload), ...workflowFollowupLines(recommendedCommands)],
-      { ok: true, recommendedCommands, ...payload }
+      { ok: true, discoverySummary, recommendedCommands, ...payload }
     );
   });
 }
@@ -10409,6 +10514,36 @@ function buildWalletNextRecommendedCommands(walletName, summary) {
     ...summary.recommendedCommand ? { nextAction: summary.recommendedCommand } : {}
   };
 }
+function workflowIntentSupportsTokenDiscovery(intent) {
+  return intent === "send-token" || intent === "swap" || intent === "bridge" || intent === "deposit" || intent === "withdraw";
+}
+function buildWalletTokenDiscoverySummary(input) {
+  if (!input.recommendedCommands) {
+    return void 0;
+  }
+  const hasTokenDiscovery = Boolean(input.recommendedCommands.discoverAssets) || Boolean(input.recommendedCommands.discoverOwnedTokens) || Boolean(input.recommendedCommands.discoverTokens) || Boolean(input.recommendedCommands.inspectToken) || Boolean(input.recommendedCommands.discoverPaymasterTokens) || Boolean(input.recommendedCommands.inspectPaymasterToken);
+  if (!hasTokenDiscovery) {
+    return void 0;
+  }
+  return {
+    walletName: input.walletName,
+    chain: input.chain,
+    intent: input.intent || null,
+    nextAction: input.nextAction || null,
+    paymasterMode: input.paymasterMode || null,
+    tokenizedIntent: workflowIntentSupportsTokenDiscovery(input.intent),
+    includesAssetDiscovery: Boolean(input.recommendedCommands.discoverAssets),
+    includesOwnedTokenDiscovery: Boolean(input.recommendedCommands.discoverOwnedTokens),
+    includesChainTokenDiscovery: Boolean(input.recommendedCommands.discoverTokens),
+    includesDirectTokenInspection: Boolean(input.recommendedCommands.inspectToken),
+    includesPaymasterTokenDiscovery: Boolean(
+      input.recommendedCommands.discoverPaymasterTokens
+    ),
+    includesPaymasterTokenInspection: Boolean(
+      input.recommendedCommands.inspectPaymasterToken
+    )
+  };
+}
 function walletNextLines(summary) {
   const lines = [
     ["wallet", summary.walletName],
@@ -10443,7 +10578,7 @@ var defaultProvider = new ZkSyncWalletProvider();
 var defaultDefiProvider = new ZkSyncDefiProvider({
   walletWriter: defaultProvider
 });
-function workflowIntentSupportsTokenDiscovery(intent) {
+function workflowIntentSupportsTokenDiscovery2(intent) {
   return intent === "send-token" || intent === "swap" || intent === "bridge" || intent === "deposit" || intent === "withdraw";
 }
 function buildTopLevelWorkflowRecommendedCommands(input) {
@@ -10457,7 +10592,7 @@ function buildTopLevelWorkflowRecommendedCommands(input) {
     delete: buildWorkflowDeleteRecommendedCommand(input.requestId),
     walletStatus: buildWalletStatusRecommendedCommand(input.walletName),
     ...input.nextAction ? { nextAction: input.nextAction } : {},
-    ...workflowIntentSupportsTokenDiscovery(input.intent) ? {
+    ...workflowIntentSupportsTokenDiscovery2(input.intent) ? {
       discoverAssets: buildAssetsRecommendedCommand(input.walletName),
       discoverOwnedTokens: buildOwnedTokensRecommendedCommand(input.walletName),
       discoverTokens: buildTokensRecommendedCommand(input.chain),
@@ -10565,6 +10700,14 @@ function createNextCommand(deps) {
         intent: result.intent,
         paymasterMode: extractCheckpointPaymasterMode(updatedCheckpoint)
       });
+      const tokenDiscoverySummary2 = buildWalletTokenDiscoverySummary({
+        walletName: wallet2.walletName,
+        chain: result.plan.chain,
+        intent: result.intent,
+        nextAction: nextCommand2,
+        paymasterMode: extractCheckpointPaymasterMode(updatedCheckpoint),
+        recommendedCommands: recommendedCommands2
+      });
       const workflowAgentProfile = await loadAgentIdentitySummary(wallet2.walletName);
       const agentFollowup2 = buildAgentFollowup(workflowAgentProfile, {
         walletName: wallet2.walletName,
@@ -10599,6 +10742,7 @@ function createNextCommand(deps) {
           agentFollowup: agentFollowup2,
           result,
           checkpoint: updatedCheckpoint,
+          tokenDiscoverySummary: tokenDiscoverySummary2,
           recommendedCommands: recommendedCommands2
         }
       );
@@ -10721,6 +10865,13 @@ function createNextCommand(deps) {
       nextAction: nextCommand,
       inspectDefaults: buildDefaultsRecommendedCommand()
     };
+    const tokenDiscoverySummary = buildWalletTokenDiscoverySummary({
+      walletName: wallet.walletName,
+      chain: wallet.chain,
+      nextAction: nextCommand,
+      paymasterMode,
+      recommendedCommands
+    });
     printResult(
       topLevelNextLines("wallet", [
         ...walletNextLines(summary),
@@ -10744,6 +10895,7 @@ function createNextCommand(deps) {
         inspection,
         summary,
         nextCommand,
+        tokenDiscoverySummary,
         recommendedCommands
       }
     );
@@ -11036,6 +11188,80 @@ function createAgentCommand() {
 
 // src/commands/defaults.ts
 import { Command as Command5 } from "commander";
+function inferPrimaryDiscoveryChain(defaults) {
+  return defaults.defaultSelections.paymaster.validatedDefault?.chain || defaults.defaultSelections.swap.validatedDefault?.chain || defaults.defaultSelections.bridge.validatedWithdraw?.fromChain || defaults.defaultSelections.bridge.validatedDeposit?.toChain || defaults.validated.feeTokenEraVm?.chain || defaults.builtinChains.find((chain) => chain.key === "zksync-sepolia")?.key || defaults.builtinChains[0]?.key || "zksync-sepolia";
+}
+function inferExampleTokenSymbol(defaults) {
+  return defaults.defaultSelections.swap.validatedDefault?.trackedTokenA.symbol || defaults.defaultSelections.paymaster.validatedApprovalBased?.feeTokenSymbol || defaults.validated.feeTokenEraVm?.symbol || defaults.registry.tokens.find((entry) => entry.symbol?.trim())?.symbol || "USDC";
+}
+function inferPaymasterFeeTokenSymbol(defaults) {
+  return defaults.defaultSelections.paymaster.validatedApprovalBased?.feeTokenSymbol || defaults.validated.feeTokenEraVm?.symbol || null;
+}
+function buildDefaultsRecommendedCommands(defaults) {
+  const primaryChain = inferPrimaryDiscoveryChain(defaults);
+  const exampleSymbol = inferExampleTokenSymbol(defaults);
+  const paymasterFeeTokenSymbol = inferPaymasterFeeTokenSymbol(defaults) || exampleSymbol;
+  return {
+    inspectDefaults: buildDefaultsRecommendedCommand(),
+    discoverTokens: buildTokensRecommendedCommand(primaryChain),
+    inspectToken: buildResolveTokenRecommendedCommand(primaryChain, exampleSymbol),
+    discoverPaymasterTokens: buildPaymasterFeeTokensRecommendedCommand(primaryChain),
+    inspectPaymasterToken: buildPaymasterFeeTokenResolveRecommendedCommand(
+      primaryChain,
+      paymasterFeeTokenSymbol
+    )
+  };
+}
+function buildDefaultsSummary(input) {
+  const { defaults, localTokenRegistry, tokenRegistrySources, tokenDirectoryChains } = input;
+  const primaryChain = inferPrimaryDiscoveryChain(defaults);
+  const exampleTokenSymbol = inferExampleTokenSymbol(defaults);
+  const paymasterFeeTokenSymbol = inferPaymasterFeeTokenSymbol(defaults);
+  return {
+    primaryDiscoveryChain: primaryChain,
+    exampleTokenSymbol,
+    paymasterFeeTokenSymbol,
+    localTokenCount: localTokenRegistry.length,
+    tokenDirectoryChainCount: tokenDirectoryChains.length,
+    tokenRegistrySources: tokenRegistrySources.map((source) => ({
+      id: source.id,
+      enabled: source.enabled,
+      exists: source.exists
+    })),
+    resolvedDefaults: {
+      swap: defaults.defaultSelections.swap.validatedDefault ? {
+        entryId: defaults.defaultSelections.swap.validatedDefault.entryId,
+        chain: defaults.defaultSelections.swap.validatedDefault.chain,
+        protocol: defaults.defaultSelections.swap.validatedDefault.protocol,
+        status: defaults.defaultSelections.swap.validatedDefault.status
+      } : null,
+      bridgeDeposit: defaults.defaultSelections.bridge.validatedDeposit ? {
+        entryId: defaults.defaultSelections.bridge.validatedDeposit.entryId,
+        fromChain: defaults.defaultSelections.bridge.validatedDeposit.fromChain,
+        toChain: defaults.defaultSelections.bridge.validatedDeposit.toChain,
+        status: defaults.defaultSelections.bridge.validatedDeposit.status
+      } : null,
+      bridgeWithdraw: defaults.defaultSelections.bridge.validatedWithdraw ? {
+        entryId: defaults.defaultSelections.bridge.validatedWithdraw.entryId,
+        fromChain: defaults.defaultSelections.bridge.validatedWithdraw.fromChain,
+        toChain: defaults.defaultSelections.bridge.validatedWithdraw.toChain,
+        status: defaults.defaultSelections.bridge.validatedWithdraw.status,
+        requiresFinalize: defaults.defaultSelections.bridge.validatedWithdraw.requiresFinalize
+      } : null,
+      paymasterDefault: defaults.defaultSelections.paymaster.validatedDefault ? {
+        entryId: defaults.defaultSelections.paymaster.validatedDefault.entryId,
+        chain: defaults.defaultSelections.paymaster.validatedDefault.chain,
+        mode: defaults.defaultSelections.paymaster.validatedDefault.mode,
+        status: defaults.defaultSelections.paymaster.validatedDefault.status
+      } : null,
+      paymasterByMode: {
+        none: defaults.defaultSelections.paymaster.validatedNone?.entryId || null,
+        sponsored: defaults.defaultSelections.paymaster.validatedSponsored?.entryId || null,
+        approvalBased: defaults.defaultSelections.paymaster.validatedApprovalBased?.entryId || null
+      }
+    }
+  };
+}
 function formatTrackedTokenSummary(token) {
   if (!token.address) return null;
   const label = token.symbol || token.address;
@@ -11531,14 +11757,34 @@ function createDefaultsCommand() {
     const localTokenRegistry = listLocalTokenRegistryEntries();
     const tokenRegistrySources = describeDefaultTokenRegistrySources();
     const tokenDirectoryChains = await listTokenDirectoryIndexedChains();
+    const recommendedCommands = buildDefaultsRecommendedCommands(defaults);
+    const summary = buildDefaultsSummary({
+      defaults,
+      localTokenRegistry,
+      tokenRegistrySources,
+      tokenDirectoryChains
+    });
     const lines = buildDefaultsLines({
       defaults,
       localTokenRegistry,
       tokenRegistrySources,
       tokenDirectoryChains
     });
+    lines.push([
+      "next discovery chain",
+      summary.primaryDiscoveryChain
+    ]);
+    lines.push([
+      "example token",
+      summary.exampleTokenSymbol
+    ]);
+    if (summary.paymasterFeeTokenSymbol) {
+      lines.push(["paymaster fee token symbol", summary.paymasterFeeTokenSymbol]);
+    }
     printResult(lines, {
       ok: true,
+      summary,
+      recommendedCommands,
       defaults,
       localTokenRegistry,
       tokenRegistrySources,
@@ -11584,6 +11830,26 @@ async function resolveActiveChain(options, deps) {
     }
   );
 }
+function buildResolveTokenDiscoverySummary(result) {
+  return {
+    chain: result.chainKey,
+    chainId: result.chainId,
+    queryType: result.queryType,
+    query: result.queryType === "symbol" ? result.symbol || null : result.address || null,
+    roleFilter: result.role || null,
+    sourceFilter: result.source || null,
+    matchCount: result.matchCount,
+    ambiguous: result.ambiguous,
+    primarySymbol: result.primaryMatch?.symbol || null,
+    primaryAddress: result.primaryMatch?.address || null,
+    primaryDecimals: result.primaryMatch?.decimals ?? null,
+    primarySource: result.primaryMatch?.source || (result.primaryMatch ? "unknown" : null),
+    sourceCounts: summarizeDiscoveryEntrySources(result.matches),
+    roleMatchCounts: summarizeDiscoveryRoleMatches(result.matches),
+    currentDefaultEntryCount: countCurrentValidatedDefaultEntries(result.matches),
+    tokenRegistrySources: summarizeTokenRegistrySources(result.tokenRegistrySources)
+  };
+}
 function createResolveTokenCommand(deps) {
   const resolvedDeps = resolveResolveTokenCommandDeps(deps);
   return new Command6("resolve-token").description("Resolve a token symbol or address against the configured local-first token registry").addHelpText(
@@ -11688,6 +11954,7 @@ function createResolveTokenCommand(deps) {
     lines.push(...workflowFollowupLines(recommendedCommands));
     printResult(lines, {
       ok: true,
+      discoverySummary: buildResolveTokenDiscoverySummary(result),
       recommendedCommands,
       ...result
     });
@@ -11807,6 +12074,46 @@ function ownedTokenSummaryLines2(summary) {
   }
   return lines;
 }
+function buildOwnedTokensDiscoverySummary(result) {
+  return {
+    mode: "owned-registry-erc20",
+    walletName: result.walletName,
+    chainScope: result.chainFilter.chainKey,
+    chainCount: 1,
+    entryCount: result.entryCount,
+    symbolFilter: result.symbol || null,
+    roleFilter: result.role || null,
+    sourceFilter: result.source || null,
+    primarySymbol: firstDiscoverySymbol(result.entries),
+    primarySource: firstDiscoverySource(result.entries),
+    sourceCounts: result.summary.sourceCounts,
+    roleMatchCounts: result.summary.registryRoleCounts,
+    currentDefaultEntryCount: countCurrentValidatedDefaultEntries(result.entries),
+    probeFailureCount: result.probeFailureCount,
+    bridgeMappingCounts: result.summary.bridgeMappingCounts,
+    tokenRegistrySources: summarizeTokenRegistrySources(result.tokenRegistrySources)
+  };
+}
+function buildTokenDiscoverySummary(result) {
+  return {
+    mode: "discoverable",
+    walletName: null,
+    chainScope: result.chainFilter?.chainKey || "all-built-in-chains",
+    chainCount: result.chainFilter ? 1 : listUniqueDiscoveryChains(result.entries).length,
+    entryCount: result.entryCount,
+    symbolFilter: result.symbol || null,
+    roleFilter: result.role || null,
+    sourceFilter: result.source || null,
+    primarySymbol: firstDiscoverySymbol(result.entries),
+    primarySource: firstDiscoverySource(result.entries),
+    sourceCounts: summarizeDiscoveryEntrySources(result.entries),
+    roleMatchCounts: summarizeDiscoveryRoleMatches(result.entries),
+    currentDefaultEntryCount: countCurrentValidatedDefaultEntries(result.entries),
+    probeFailureCount: null,
+    bridgeMappingCounts: null,
+    tokenRegistrySources: summarizeTokenRegistrySources(result.tokenRegistrySources)
+  };
+}
 function createTokensCommand(deps) {
   const resolvedDeps = resolveTokensCommandDeps(deps);
   return new Command7("tokens").description("List discoverable tokens from the configured local-first token registry, or inspect the owned ERC-20 registry subset for one wallet").addHelpText(
@@ -11940,6 +12247,7 @@ function createTokensCommand(deps) {
       lines2.push(...workflowFollowupLines(recommendedCommands2));
       printResult(lines2, {
         ok: true,
+        discoverySummary: buildOwnedTokensDiscoverySummary(result2),
         recommendedCommands: recommendedCommands2,
         ...result2
       });
@@ -11995,6 +12303,7 @@ function createTokensCommand(deps) {
     lines.push(...workflowFollowupLines(recommendedCommands));
     printResult(lines, {
       ok: true,
+      discoverySummary: buildTokenDiscoverySummary(result),
       recommendedCommands,
       ...result
     });
@@ -12672,6 +12981,20 @@ function relayOriginRelationshipNotes(options) {
   }
   return notes;
 }
+function buildRelayDeploymentSummary(options) {
+  return {
+    origin: options.origin,
+    publicOrigin: options.publicOrigin,
+    publicOriginSource: options.publicOriginSource,
+    shareLinkBaseUrl: options.shareLinkBaseUrl,
+    statusApiBaseUrl: options.statusApiBaseUrl,
+    publicOriginConfigured: options.publicOriginSource === "configured",
+    publicOriginLooksLocal: options.publicOriginLooksLocal,
+    connectorUiAvailable: options.connectorUiAvailable,
+    hostedShareRedirectReady: options.hostedShareRedirectReady,
+    singleHostFileState: options.stateBackend === "local-filesystem" && options.deploymentScope === "single-host" && options.sameHostRestartPersists === true
+  };
+}
 function buildRelayInspectPayload(relayUrl, rawHealth) {
   const health = asRelayHealthResponse(rawHealth);
   const fallbackPublicOrigin = isRecord3(rawHealth) && typeof rawHealth.public_origin === "string" ? rawHealth.public_origin : relayUrl;
@@ -12690,6 +13013,19 @@ function buildRelayInspectPayload(relayUrl, rawHealth) {
   const publicOriginLooksLocal = relayPublicOriginLooksLocal(publicOrigin);
   const hostedShareRedirectReady = compatible && connectorUiAvailable === true && !publicOriginLooksLocal;
   const { shareLinkBaseUrl, statusApiBaseUrl } = buildAdvertisedRelayBases(publicOrigin);
+  const deploymentSummary = buildRelayDeploymentSummary({
+    origin: health?.origin || null,
+    publicOrigin,
+    publicOriginSource,
+    shareLinkBaseUrl,
+    statusApiBaseUrl,
+    publicOriginLooksLocal,
+    connectorUiAvailable,
+    hostedShareRedirectReady,
+    stateBackend,
+    deploymentScope,
+    sameHostRestartPersists
+  });
   const notes = [
     ...relayHostedReadinessNotes({
       compatible,
@@ -12731,6 +13067,7 @@ function buildRelayInspectPayload(relayUrl, rawHealth) {
     publicOriginLooksLocal,
     connectorUiAvailable,
     hostedShareRedirectReady,
+    deploymentSummary,
     capabilities: health?.capabilities || [],
     recommendedCommands: compatible ? buildRelayServeRecommendedCommands(publicOrigin) : {},
     notes
@@ -12776,6 +13113,19 @@ function createRelayCommand() {
     const hostedShareRedirectReady = connectorUiAvailable && !publicOriginLooksLocal;
     const { shareLinkBaseUrl, statusApiBaseUrl } = buildAdvertisedRelayBases(publicOrigin);
     const recommendedCommands = buildRelayServeRecommendedCommands(publicOrigin);
+    const deploymentSummary = buildRelayDeploymentSummary({
+      origin: server.origin,
+      publicOrigin,
+      publicOriginSource,
+      shareLinkBaseUrl,
+      statusApiBaseUrl,
+      publicOriginLooksLocal,
+      connectorUiAvailable,
+      hostedShareRedirectReady,
+      stateBackend: "local-filesystem",
+      deploymentScope: "single-host",
+      sameHostRestartPersists: true
+    });
     const notes = relayHostedReadinessNotes({
       compatible: true,
       publicOrigin,
@@ -12794,6 +13144,7 @@ function createRelayCommand() {
       shareLinkBaseUrl,
       statusApiBaseUrl,
       publicOriginLooksLocal,
+      deploymentSummary,
       port: server.port,
       healthUrl: `${server.origin}/health`,
       publicHealthUrl: `${publicOrigin}/health`,
@@ -13536,6 +13887,39 @@ function relayOutputAliases(relay) {
     relayStatusApiBaseUrl: statusApiBaseUrl
   };
 }
+function determineRelayRecoveryMode(options) {
+  if (options.recommendedCommands.reissueRemoteApproval && options.nextAction === options.recommendedCommands.reissueRemoteApproval) {
+    return "reissue-remote-approval";
+  }
+  if (options.recommendedCommands.relayInspect && options.nextAction === options.recommendedCommands.relayInspect) {
+    return "inspect-relay";
+  }
+  if (options.recommendedCommands.approve && options.nextAction === options.recommendedCommands.approve) {
+    return "approve";
+  }
+  return "status-poll";
+}
+function buildRelayRecoverySummary(options) {
+  const aliases = relayOutputAliases(options.relay);
+  return {
+    requestId: options.requestId,
+    walletName: options.walletName || null,
+    relayUrl: options.relayUrl,
+    relayStatus: options.relayStatus ?? options.relay?.status ?? null,
+    approvalReady: typeof options.approvalReady === "boolean" ? options.approvalReady : options.relay && "approval_ready" in options.relay ? options.relay.approval_ready : null,
+    nextAction: options.nextAction,
+    shareLinkBaseUrl: aliases.relayShareLinkBaseUrl || null,
+    statusApiBaseUrl: aliases.relayStatusApiBaseUrl || null,
+    recoveryMode: determineRelayRecoveryMode({
+      nextAction: options.nextAction,
+      recommendedCommands: options.recommendedCommands
+    }),
+    includesStatusPoll: Boolean(options.recommendedCommands.status),
+    includesApprove: Boolean(options.recommendedCommands.approve),
+    includesRelayInspect: Boolean(options.recommendedCommands.relayInspect),
+    includesRemoteReissue: Boolean(options.recommendedCommands.reissueRemoteApproval)
+  };
+}
 function sanitizeWalletRequestRecord(request) {
   const { sessionSecretKey: _sessionSecretKey, ...rest } = request;
   return rest;
@@ -14913,6 +15297,18 @@ function buildRelayApprovalTimeoutError(options) {
       retryable: true,
       statusCommand,
       approveCommand,
+      relayRecoverySummary: buildRelayRecoverySummary({
+        requestId: options.requestId,
+        walletName: options.walletName,
+        relayUrl: options.relayUrl,
+        relayStatus: null,
+        approvalReady: null,
+        nextAction: statusCommand,
+        recommendedCommands: {
+          status: statusCommand,
+          approve: approveCommand
+        }
+      }),
       suggestedAction: "Check the current relay status, then finalize the wallet approval once approval_ready=true."
     }
   );
@@ -14934,6 +15330,15 @@ async function buildRelayApprovalExpiredError(options) {
       note: recovery.note,
       relayInspectCommand: recovery.recommendedCommands.relayInspect,
       reissueRemoteApprovalCommand: recovery.recommendedCommands.reissueRemoteApproval,
+      relayRecoverySummary: buildRelayRecoverySummary({
+        requestId: options.requestId,
+        walletName: options.walletName,
+        relayUrl: options.relayUrl,
+        relayStatus: "expired",
+        approvalReady: false,
+        nextAction: recovery.nextAction,
+        recommendedCommands: recovery.recommendedCommands
+      }),
       suggestedAction: "Inspect the hosted relay, then reissue the remote approval request."
     }
   );
@@ -14958,6 +15363,17 @@ function buildRelayApprovalNotReadyError(options) {
       retryable: true,
       statusCommand,
       approveCommand,
+      relayRecoverySummary: buildRelayRecoverySummary({
+        requestId: options.requestId,
+        relayUrl: options.relayUrl,
+        relayStatus: options.status,
+        approvalReady: options.approvalReady,
+        nextAction: statusCommand,
+        recommendedCommands: {
+          status: statusCommand,
+          approve: approveCommand
+        }
+      }),
       suggestedAction: "Check the current relay status, then retry approval once approval_ready=true."
     }
   );
@@ -15137,6 +15553,7 @@ async function finalizePublishedRelayWalletRequest(options) {
     if (error instanceof Error && error.message.startsWith("Timed out waiting for relay approval after ")) {
       throw buildRelayApprovalTimeoutError({
         requestId: options.walletRequest.requestId,
+        walletName: options.walletRequest.walletName,
         relayUrl: options.relayUrl,
         timeoutMs: options.timeoutMs,
         intervalMs: options.intervalMs
@@ -15737,6 +16154,20 @@ function createWalletCommand(deps) {
         options.relayUrl,
         request2.requestedPaymasterMode
       );
+      const nextAction = buildPendingRequestNextAction(recommendedCommands);
+      const relayRecoverySummary = relay && recommendedCommands.relayStatus && recommendedCommands.relayApprove ? buildRelayRecoverySummary({
+        requestId: request2.requestId,
+        walletName: request2.walletName,
+        relayUrl: options.relayUrl,
+        relayStatus: relay.status,
+        approvalReady: null,
+        nextAction,
+        recommendedCommands: {
+          status: recommendedCommands.relayStatus,
+          approve: recommendedCommands.relayApprove
+        },
+        relay
+      }) : void 0;
       printResult(
         [
           ["wallet", request2.walletName],
@@ -15779,6 +16210,7 @@ function createWalletCommand(deps) {
           approvalUrl: request2.approvalUrl,
           relay,
           ...relayOutputAliases(relay),
+          relayRecoverySummary,
           expiresAt: request2.expiresAt,
           chain: request2.chain,
           chainId: request2.chainId,
@@ -15786,7 +16218,7 @@ function createWalletCommand(deps) {
           paymasterMode: request2.requestedPaymasterMode,
           capabilities: request2.requestedCapabilities,
           sessionScope: request2.requestedSessionScope,
-          nextAction: buildPendingRequestNextAction(recommendedCommands),
+          nextAction,
           recommendedCommands
         }
       );
@@ -15902,6 +16334,20 @@ function createWalletCommand(deps) {
         options.relayUrl,
         request2.requestedPaymasterMode
       );
+      const nextAction = buildPendingRequestNextAction(recommendedCommands);
+      const relayRecoverySummary = relay && recommendedCommands.relayStatus && recommendedCommands.relayApprove ? buildRelayRecoverySummary({
+        requestId: request2.requestId,
+        walletName: request2.walletName,
+        relayUrl: options.relayUrl,
+        relayStatus: relay.status,
+        approvalReady: null,
+        nextAction,
+        recommendedCommands: {
+          status: recommendedCommands.relayStatus,
+          approve: recommendedCommands.relayApprove
+        },
+        relay
+      }) : void 0;
       printResult(
         [
           ["wallet", request2.walletName],
@@ -15944,7 +16390,8 @@ function createWalletCommand(deps) {
           request: sanitizeWalletRequestRecord(request2),
           relay,
           ...relayOutputAliases(relay),
-          nextAction: buildPendingRequestNextAction(recommendedCommands),
+          relayRecoverySummary,
+          nextAction,
           recommendedCommands
         }
       );
@@ -16088,6 +16535,13 @@ function createWalletCommand(deps) {
       walletRecord.walletName,
       summary
     );
+    const tokenDiscoverySummary = buildWalletTokenDiscoverySummary({
+      walletName: walletRecord.walletName,
+      chain: summary.chain,
+      nextAction: summary.recommendedCommand,
+      paymasterMode: resolveEffectivePaymasterSelection(walletRecord)?.mode,
+      recommendedCommands
+    });
     printResult(
       [
         ...walletNextLines(summary),
@@ -16101,6 +16555,7 @@ function createWalletCommand(deps) {
         ok: true,
         inspection,
         summary,
+        tokenDiscoverySummary,
         recommendedCommands
       }
     );
@@ -16264,6 +16719,30 @@ function createWalletCommand(deps) {
   request.command("relay-publish").description("Publish a stored wallet request to a relay server and get a shareable approval URL").requiredOption("--request-id <id>", "Wallet request id").requiredOption("--relay-url <url>", "Relay server base URL").action(async (options) => {
     const walletRequest = await requireActiveWalletRequest(options.requestId);
     const relay = await publishWalletRequestToRelay(walletRequest, options.relayUrl);
+    const nextAction = buildWalletRequestRelayStatusRecommendedCommand(
+      relay.request_id,
+      options.relayUrl
+    );
+    const recommendedCommands = {
+      status: buildWalletRequestRelayStatusRecommendedCommand(
+        relay.request_id,
+        options.relayUrl
+      ),
+      approve: buildWalletRequestRelayApproveRecommendedCommand(
+        relay.request_id,
+        options.relayUrl
+      )
+    };
+    const relayRecoverySummary = buildRelayRecoverySummary({
+      requestId: relay.request_id,
+      walletName: walletRequest.walletName,
+      relayUrl: options.relayUrl,
+      relayStatus: relay.status,
+      approvalReady: null,
+      nextAction,
+      recommendedCommands,
+      relay
+    });
     printResult(
       [
         ["status", relay.status],
@@ -16272,26 +16751,25 @@ function createWalletCommand(deps) {
         ["status url", relay.status_url],
         ["share-link base", relay.share_url.replace(/\/[^/]+$/, "")],
         ["status api base", relay.status_url.replace(/\/[^/]+$/, "")],
-        ["next status", buildWalletRequestRelayStatusRecommendedCommand(relay.request_id, options.relayUrl)],
-        ["next approve", buildWalletRequestRelayApproveRecommendedCommand(relay.request_id, options.relayUrl)]
+        ["next status", recommendedCommands.status],
+        ["next approve", recommendedCommands.approve]
       ],
       {
         ok: true,
         walletRequestId: walletRequest.requestId,
         relay,
         ...relayOutputAliases(relay),
+        relayRecoverySummary,
         request: sanitizeWalletRequestRecord(walletRequest),
-        nextAction: buildWalletRequestRelayStatusRecommendedCommand(relay.request_id, options.relayUrl),
-        recommendedCommands: {
-          status: buildWalletRequestRelayStatusRecommendedCommand(relay.request_id, options.relayUrl),
-          approve: buildWalletRequestRelayApproveRecommendedCommand(relay.request_id, options.relayUrl)
-        }
+        nextAction,
+        recommendedCommands
       }
     );
   });
   request.command("relay-status").description("Inspect the relay status of a published wallet request, optionally waiting until approval is ready").requiredOption("--request-id <id>", "Wallet request id").requiredOption("--relay-url <url>", "Relay server base URL").option("--wait", "Poll until the encrypted relay approval is ready or the request expires").option("--timeout-seconds <seconds>", "How long to wait while polling relay status", "600").option("--interval-ms <milliseconds>", "How often to poll relay status while waiting", "2000").action(async (options) => {
     const timeoutMs = parsePositiveIntegerOption(options.timeoutSeconds, "--timeout-seconds", 600) * 1e3;
     const intervalMs = parsePositiveIntegerOption(options.intervalMs, "--interval-ms", 2e3);
+    const walletRequest = await loadWalletRequest(options.requestId);
     let relay;
     try {
       relay = options.wait ? await waitForRelayApprovalReady(options.relayUrl, options.requestId, {
@@ -16302,6 +16780,7 @@ function createWalletCommand(deps) {
       if (options.wait && error instanceof Error && error.message.startsWith("Timed out waiting for relay approval after ")) {
         throw buildRelayApprovalTimeoutError({
           requestId: options.requestId,
+          walletName: walletRequest?.walletName,
           relayUrl: options.relayUrl,
           timeoutMs,
           intervalMs
@@ -16313,6 +16792,16 @@ function createWalletCommand(deps) {
       relay,
       relayUrl: options.relayUrl
     });
+    const relayRecoverySummary = buildRelayRecoverySummary({
+      requestId: relay.request_id,
+      walletName: relay.request?.walletName || walletRequest?.walletName,
+      relayUrl: options.relayUrl,
+      relayStatus: relay.status,
+      approvalReady: relay.approval_ready,
+      nextAction: followUp.nextAction,
+      recommendedCommands: followUp.recommendedCommands,
+      relay
+    });
     printResult(
       [
         ["status", relay.status],
@@ -16334,6 +16823,7 @@ function createWalletCommand(deps) {
         walletRequestId: relay.request_id,
         relay,
         ...relayOutputAliases(relay),
+        relayRecoverySummary,
         nextAction: followUp.nextAction,
         recommendedCommands: followUp.recommendedCommands,
         ...followUp.note ? { note: followUp.note } : {}
@@ -18677,6 +19167,14 @@ async function printWorkflowRunCommandResult(execution) {
       intent: execution.result.intent,
       paymasterMode: execution.walletApproval?.request.requestedPaymasterMode ?? extractWorkflowGoalPaymasterMode(execution.goal)
     });
+    const tokenDiscoverySummary2 = buildWorkflowTokenDiscoverySummary({
+      walletName: execution.result.walletName,
+      chain: execution.result.plan.chain,
+      intent: execution.result.intent,
+      nextAction: execution.result.nextCommand,
+      paymasterMode: execution.walletApproval?.request.requestedPaymasterMode ?? extractWorkflowGoalPaymasterMode(execution.goal),
+      recommendedCommands: recommendedCommands2
+    });
     printResult(
       prependWorkflowRequestId(
         execution.requestId,
@@ -18701,6 +19199,7 @@ async function printWorkflowRunCommandResult(execution) {
         ...workflowWalletApprovalRelayAliases(execution.walletApproval?.relay),
         walletApprovalRecommendedCommands: execution.walletApproval?.recommendedCommands,
         walletApproval: serializeWalletApproval(execution.walletApproval),
+        tokenDiscoverySummary: tokenDiscoverySummary2,
         recommendedCommands: recommendedCommands2
       }
     );
@@ -18719,6 +19218,14 @@ async function printWorkflowRunCommandResult(execution) {
     intent: execution.status.intent,
     paymasterMode: execution.walletApproval?.request.requestedPaymasterMode ?? extractWorkflowGoalPaymasterMode(execution.checkpoint?.goal)
   });
+  const tokenDiscoverySummary = buildWorkflowTokenDiscoverySummary({
+    walletName: execution.status.walletName,
+    chain: execution.status.plan.chain,
+    intent: execution.status.intent,
+    nextAction: execution.status.recommendedCommand,
+    paymasterMode: execution.walletApproval?.request.requestedPaymasterMode ?? extractWorkflowGoalPaymasterMode(execution.checkpoint?.goal),
+    recommendedCommands
+  });
   printResult(
     prependWorkflowRequestId(
       execution.requestId,
@@ -18744,6 +19251,7 @@ async function printWorkflowRunCommandResult(execution) {
       ...workflowWalletApprovalRelayAliases(execution.walletApproval?.relay),
       walletApprovalRecommendedCommands: execution.walletApproval?.recommendedCommands,
       walletApproval: serializeWalletApproval(execution.walletApproval),
+      tokenDiscoverySummary,
       recommendedCommands
     }
   );
@@ -19011,6 +19519,14 @@ async function printWorkflowAutoCommandResult(execution) {
     intent: execution.status.intent,
     paymasterMode: execution.walletApproval?.request.requestedPaymasterMode ?? extractWorkflowGoalPaymasterMode(execution.goal) ?? extractWorkflowGoalPaymasterMode(execution.checkpoint?.goal)
   });
+  const tokenDiscoverySummary = buildWorkflowTokenDiscoverySummary({
+    walletName: execution.status.walletName,
+    chain: execution.status.plan.chain,
+    intent: execution.status.intent,
+    nextAction,
+    paymasterMode: execution.walletApproval?.request.requestedPaymasterMode ?? extractWorkflowGoalPaymasterMode(execution.goal) ?? extractWorkflowGoalPaymasterMode(execution.checkpoint?.goal),
+    recommendedCommands
+  });
   const summaryLines = [
     ["source", execution.source],
     ["action", execution.action],
@@ -19047,6 +19563,7 @@ async function printWorkflowAutoCommandResult(execution) {
       ...workflowWalletApprovalRelayAliases(execution.walletApproval?.relay),
       walletApprovalRecommendedCommands: execution.walletApproval?.recommendedCommands,
       walletApproval: serializeWalletApproval(execution.walletApproval),
+      tokenDiscoverySummary,
       recommendedCommands
     }
   );
@@ -19102,7 +19619,7 @@ function buildWorkflowRuntimeRecommendedCommands(input) {
     ...input.nextAction ? {
       nextAction: input.nextAction
     } : {},
-    ...input.chain && input.intent && workflowIntentSupportsTokenDiscovery2(input.intent) ? {
+    ...input.chain && input.intent && workflowIntentSupportsTokenDiscovery3(input.intent) ? {
       ...input.walletName ? {
         discoverAssets: `zk-agent assets --wallet ${input.walletName}`,
         discoverOwnedTokens: `zk-agent tokens --wallet ${input.walletName} --owned`
@@ -19116,16 +19633,54 @@ function buildWorkflowRuntimeRecommendedCommands(input) {
     } : {}
   };
 }
-function workflowIntentSupportsTokenDiscovery2(intent) {
+function workflowIntentSupportsTokenDiscovery3(intent) {
   return intent === "send-token" || intent === "swap" || intent === "bridge" || intent === "deposit" || intent === "withdraw";
 }
+function buildWorkflowTokenDiscoverySummary(input) {
+  if (!input.recommendedCommands) {
+    return void 0;
+  }
+  const hasTokenDiscovery = Boolean(input.recommendedCommands.discoverAssets) || Boolean(input.recommendedCommands.discoverOwnedTokens) || Boolean(input.recommendedCommands.discoverTokens) || Boolean(input.recommendedCommands.inspectToken) || Boolean(input.recommendedCommands.discoverPaymasterTokens) || Boolean(input.recommendedCommands.inspectPaymasterToken);
+  if (!hasTokenDiscovery) {
+    return void 0;
+  }
+  return {
+    walletName: input.walletName || null,
+    chain: input.chain || null,
+    intent: input.intent || null,
+    nextAction: input.nextAction || null,
+    paymasterMode: input.paymasterMode || null,
+    tokenizedIntent: input.intent ? workflowIntentSupportsTokenDiscovery3(input.intent) : false,
+    includesAssetDiscovery: Boolean(input.recommendedCommands.discoverAssets),
+    includesOwnedTokenDiscovery: Boolean(input.recommendedCommands.discoverOwnedTokens),
+    includesChainTokenDiscovery: Boolean(input.recommendedCommands.discoverTokens),
+    includesDirectTokenInspection: Boolean(input.recommendedCommands.inspectToken),
+    includesPaymasterTokenDiscovery: Boolean(
+      input.recommendedCommands.discoverPaymasterTokens
+    ),
+    includesPaymasterTokenInspection: Boolean(
+      input.recommendedCommands.inspectPaymasterToken
+    )
+  };
+}
+function buildWorkflowTokenInputErrorSummary(input) {
+  return {
+    chain: input.chain || null,
+    queryType: input.tokenAddress ? "address" : input.symbol ? "symbol" : null,
+    query: input.tokenAddress || input.symbol || null,
+    roleFilter: input.role || null,
+    includesChainTokenDiscovery: Boolean(input.recommendedCommands.discoverTokens),
+    includesDirectTokenInspection: Boolean(input.recommendedCommands.inspectToken),
+    workflowHelp: input.recommendedCommands.workflowHelp
+  };
+}
 function buildWorkflowPlanRecommendedCommands(plan) {
   return {
     inspectDefaults: "zk-agent defaults",
     next: plan.recommendedCommand,
     goal: plan.goalCommand,
     workflowHelp: "zk-agent workflow --help",
-    ...workflowIntentSupportsTokenDiscovery2(plan.intent) ? {
+    ...workflowIntentSupportsTokenDiscovery3(plan.intent) ? {
       discoverAssets: buildAssetsRecommendedCommand(plan.walletName),
       discoverOwnedTokens: buildOwnedTokensRecommendedCommand(plan.walletName),
       discoverTokens: buildTokensRecommendedCommand(plan.chain),
@@ -19169,6 +19724,13 @@ function buildWorkflowTokenErrorRecommendedCommands(error) {
 }
 function printWorkflowTokenInputError(error) {
   const recommendedCommands = buildWorkflowTokenErrorRecommendedCommands(error);
+  const tokenDiscoverySummary = buildWorkflowTokenInputErrorSummary({
+    chain: typeof error.details?.chain === "string" ? error.details.chain : void 0,
+    symbol: typeof error.details?.symbol === "string" ? error.details.symbol : void 0,
+    tokenAddress: typeof error.details?.tokenAddress === "string" ? error.details.tokenAddress : void 0,
+    role: typeof error.details?.role === "string" ? error.details.role : void 0,
+    recommendedCommands
+  });
   const lines = [["error", error.message], ["code", error.code]];
   if (typeof error.details?.suggestedAction === "string" && error.details.suggestedAction.length > 0) {
     lines.push(["suggested action", error.details.suggestedAction]);
@@ -19176,6 +19738,7 @@ function printWorkflowTokenInputError(error) {
   lines.push(...workflowFollowupLines(recommendedCommands));
   printResult(lines, {
     ...formatErrorPayload(error),
+    tokenDiscoverySummary,
     recommendedCommands
   });
   process.exitCode = 1;
@@ -19583,6 +20146,14 @@ function createWorkflowCommand(deps) {
         ...plan,
         paymasterMode: paymasterInput?.mode
       });
+      const tokenDiscoverySummary = buildWorkflowTokenDiscoverySummary({
+        walletName: plan.walletName,
+        chain: plan.chain,
+        intent: plan.intent,
+        paymasterMode: paymasterInput?.mode,
+        nextAction: plan.recommendedCommand,
+        recommendedCommands
+      });
       const agentProfile = await loadWorkflowAgentProfile(plan.walletName);
       const agentFollowup = buildAgentFollowup(agentProfile, {
         walletName: plan.walletName,
@@ -19600,6 +20171,7 @@ function createWorkflowCommand(deps) {
           agentFollowup,
           inspection,
           plan,
+          tokenDiscoverySummary,
           recommendedCommands
         }
       );
@@ -19803,6 +20375,14 @@ function createWorkflowCommand(deps) {
       intent: inspection.result.intent,
       paymasterMode: inspection.walletApproval?.request.requestedPaymasterMode ?? extractWorkflowGoalPaymasterMode(inspection.checkpoint?.goal)
     });
+    const tokenDiscoverySummary = buildWorkflowTokenDiscoverySummary({
+      walletName: inspection.result.walletName,
+      chain: inspection.result.plan.chain,
+      intent: inspection.result.intent,
+      nextAction: inspection.result.recommendedCommand,
+      paymasterMode: inspection.walletApproval?.request.requestedPaymasterMode ?? extractWorkflowGoalPaymasterMode(inspection.checkpoint?.goal),
+      recommendedCommands
+    });
     const agentProfile = await loadWorkflowAgentProfile(inspection.result.walletName);
     const agentFollowup = buildAgentFollowup(agentProfile, {
       walletName: inspection.result.walletName,
@@ -19833,6 +20413,7 @@ function createWorkflowCommand(deps) {
         ...workflowWalletApprovalRelayAliases(inspection.walletApproval?.relay),
         walletApprovalRecommendedCommands: inspection.walletApproval?.recommendedCommands,
         walletApproval: serializeWalletApproval(inspection.walletApproval),
+        tokenDiscoverySummary,
         recommendedCommands
       }
     );
@@ -19855,6 +20436,14 @@ function createWorkflowCommand(deps) {
       intent: inspection.result.intent,
       paymasterMode: inspection.walletApproval?.request.requestedPaymasterMode ?? extractWorkflowGoalPaymasterMode(inspection.checkpoint?.goal)
     });
+    const tokenDiscoverySummary = buildWorkflowTokenDiscoverySummary({
+      walletName: inspection.result.walletName,
+      chain: inspection.result.plan.chain,
+      intent: inspection.result.intent,
+      nextAction: nextCommand,
+      paymasterMode: inspection.walletApproval?.request.requestedPaymasterMode ?? extractWorkflowGoalPaymasterMode(inspection.checkpoint?.goal),
+      recommendedCommands
+    });
     const agentProfile = await loadWorkflowAgentProfile(inspection.result.walletName);
     const agentFollowup = buildAgentFollowup(agentProfile, {
       walletName: inspection.result.walletName,
@@ -19898,6 +20487,7 @@ function createWorkflowCommand(deps) {
         ...workflowWalletApprovalRelayAliases(inspection.walletApproval?.relay),
         walletApprovalRecommendedCommands: inspection.walletApproval?.recommendedCommands,
         walletApproval: serializeWalletApproval(inspection.walletApproval),
+        tokenDiscoverySummary,
         recommendedCommands
       }
     );
@@ -19921,6 +20511,14 @@ function createWorkflowCommand(deps) {
         intent: inspection.result.intent,
         paymasterMode: inspection.walletApproval.request.requestedPaymasterMode
       });
+      const tokenDiscoverySummary2 = buildWorkflowTokenDiscoverySummary({
+        walletName: inspection.result.walletName,
+        chain: inspection.result.plan.chain,
+        intent: inspection.result.intent,
+        nextAction: inspection.result.recommendedCommand,
+        paymasterMode: inspection.walletApproval.request.requestedPaymasterMode,
+        recommendedCommands: recommendedCommands2
+      });
       const agentProfile2 = await loadWorkflowAgentProfile(inspection.result.walletName);
       const agentFollowup2 = buildAgentFollowup(agentProfile2, {
         walletName: inspection.result.walletName,
@@ -19951,6 +20549,7 @@ function createWorkflowCommand(deps) {
           ...workflowWalletApprovalRelayAliases(inspection.walletApproval.relay),
           walletApprovalRecommendedCommands: inspection.walletApproval.recommendedCommands,
           walletApproval: serializeWalletApproval(inspection.walletApproval),
+          tokenDiscoverySummary: tokenDiscoverySummary2,
           recommendedCommands: recommendedCommands2
         }
       );
@@ -19973,6 +20572,14 @@ function createWorkflowCommand(deps) {
         intent: execution.status.intent,
         paymasterMode: execution.walletApproval?.request.requestedPaymasterMode ?? extractWorkflowGoalPaymasterMode(execution.checkpoint?.goal)
       });
+      const tokenDiscoverySummary2 = buildWorkflowTokenDiscoverySummary({
+        walletName: execution.status.walletName,
+        chain: execution.status.plan.chain,
+        intent: execution.status.intent,
+        nextAction: execution.status.recommendedCommand,
+        paymasterMode: execution.walletApproval?.request.requestedPaymasterMode ?? extractWorkflowGoalPaymasterMode(execution.checkpoint?.goal),
+        recommendedCommands: recommendedCommands2
+      });
       const agentProfile2 = await loadWorkflowAgentProfile(execution.status.walletName);
       const agentFollowup2 = buildAgentFollowup(agentProfile2, {
         walletName: execution.status.walletName,
@@ -20003,6 +20610,7 @@ function createWorkflowCommand(deps) {
           ...workflowWalletApprovalRelayAliases(execution.walletApproval?.relay),
           walletApprovalRecommendedCommands: execution.walletApproval?.recommendedCommands,
           walletApproval: serializeWalletApproval(execution.walletApproval),
+          tokenDiscoverySummary: tokenDiscoverySummary2,
           recommendedCommands: recommendedCommands2
         }
       );
@@ -20016,6 +20624,14 @@ function createWorkflowCommand(deps) {
       intent: execution.result.intent,
       paymasterMode: execution.walletApproval?.request.requestedPaymasterMode ?? extractWorkflowGoalPaymasterMode(execution.goal)
     });
+    const tokenDiscoverySummary = buildWorkflowTokenDiscoverySummary({
+      walletName: execution.result.walletName,
+      chain: execution.result.plan.chain,
+      intent: execution.result.intent,
+      nextAction: execution.result.nextCommand,
+      paymasterMode: execution.walletApproval?.request.requestedPaymasterMode ?? extractWorkflowGoalPaymasterMode(execution.goal),
+      recommendedCommands
+    });
     const agentProfile = await loadWorkflowAgentProfile(execution.result.walletName);
     const agentFollowup = buildAgentFollowup(agentProfile, {
       walletName: execution.result.walletName,
@@ -20046,6 +20662,7 @@ function createWorkflowCommand(deps) {
         ...workflowWalletApprovalRelayAliases(inspection.walletApproval?.relay),
         walletApprovalRecommendedCommands: inspection.walletApproval?.recommendedCommands,
         walletApproval: serializeWalletApproval(inspection.walletApproval),
+        tokenDiscoverySummary,
         recommendedCommands
       }
     );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zk-agent-cli",
-  "version": "0.1.0-beta.8",
+  "version": "0.1.0-beta.9",
   "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",