@lucid-agents/taskmarket 1.22.0 → 1.24.0

package/dist/index.js

@@ -14,7 +14,7 @@ import {
   signReadAuth,
   submitTaskFiles,
   taskAccessGrantHeaders
-} from "./chunk-7MXTPGES.js";
+} from "./chunk-4WQPXCKL.js";
 import {
   ComputeCreditError,
   applyComputeCreditSetup,
@@ -36,7 +36,7 @@ import {
   refusedPaidWrite,
   releasePendingComputePurchase,
   resolvePendingComputePurchases
-} from "./chunk-RSSJD6JU.js";
+} from "./chunk-MLFKB6XH.js";
 import {
   MPP_TEMPO_DEFAULT_VALIDITY_SECONDS,
   X402PayError,
@@ -53,16 +53,18 @@ import {
   loadX402Policy,
   removeX402PolicyRule,
   resolveX402PaymentManually,
+  selectTaskmarketFeeRequirement,
   setX402PolicyRuleEnabled,
   signMessage,
   signSponsoredTempoTransfer,
   signTaskmarketFeePayment,
   signTypedData
-} from "./chunk-BO3XPXQ6.js";
+} from "./chunk-D6ODOHET.js";
 import {
   ActivityFeedInputSchema,
   ActivityHeatmapInputSchema,
   ActorType,
+  AgentChainsResponseSchema,
   AgentMessageEnvelopeSchema,
   AgentTimeSeriesInputSchema,
   ApiError,
@@ -73,6 +75,7 @@ import {
   CrossChainFundingConfigOutputSchema,
   DEFAULT_EVALUATION_WINDOW_HOURS,
   DEFAULT_TERMS_BOUNDS,
+  EthAddressSchema,
   HookGetInputSchema,
   HookIndexInputSchema,
   IntentStatusResponseSchema,
@@ -83,6 +86,7 @@ import {
   LegalStatusResponseSchema,
   NETWORKS,
   NETWORK_NAMES,
+  NetworkInfoSchema,
   NetworkRequiredError,
   PUBLIC_BUG_REPORT_SORTS,
   PenaltyTo,
@@ -95,6 +99,7 @@ import {
   RejectOutcome,
   RelayBridgeFundingConfigOutputSchema,
   RelayBridgeRouteIdSchema,
+  STANDARD_X402_ACTION_AMOUNT,
   SponsoredTaskRewardStateSchema,
   SponsoredTaskWorkerRewardClaimStatusSchema,
   SubmissionReviewAssessmentInputSchema,
@@ -192,7 +197,7 @@ import {
   withChainId,
   withErrorContext,
   withIdempotentWrite
-} from "./chunk-H2HOWIJ6.js";
+} from "./chunk-H554XEEE.js";
 import {
   channelLines
 } from "./chunk-XJOB4NMV.js";
@@ -277,10 +282,19 @@ function readLastError() {
 }
 
 // src/lib/output.ts
+function cliWarning(code, message, details) {
+  return { ...details, code, message };
+}
 function printResult(data, options) {
   const idempotencyKey = options?.idempotencyKey;
+  const warnings = options?.warnings ?? [];
   console.log(
-    JSON.stringify({ ok: true, data, ...idempotencyKey !== void 0 ? { idempotencyKey } : {} })
+    JSON.stringify({
+      ok: true,
+      data,
+      ...idempotencyKey !== void 0 ? { idempotencyKey } : {},
+      ...warnings.length > 0 ? { warnings } : {}
+    })
   );
 }
 function x402FailureFields(error) {
@@ -329,9 +343,6 @@ function renderFailure(error, options) {
 function printError(message, options) {
   return renderFailure(new Error(message), options);
 }
-function printWarning(message) {
-  process.stderr.write(JSON.stringify({ ok: false, error: message }) + "\n");
-}
 
 // src/lib/agent.ts
 function legacyAgentIdChain(keystore) {
@@ -646,7 +657,7 @@ function sanitizeEmailUsername(agentId, suffix) {
   const candidate = `${base}-${suffix}`;
   return /^[a-z0-9][a-z0-9-]{1,28}[a-z0-9]$/.test(candidate) ? candidate : null;
 }
-async function tryRegisterEmail(deviceId, apiToken, username, explicit) {
+async function tryRegisterEmail(deviceId, apiToken, username, explicit, warnings) {
   try {
     const { data: reg } = await apiPost("/api/emails/register", {
       deviceId,
@@ -657,8 +668,12 @@ async function tryRegisterEmail(deviceId, apiToken, username, explicit) {
   } catch (err) {
     if (explicit) {
       const msg = err instanceof Error ? err.message : String(err);
-      printWarning(
-        `Email registration failed: ${msg}. Run: taskmarket email register --username ${username}`
+      warnings.push(
+        cliWarning(
+          "email_registration_failed",
+          `Email registration failed: ${msg}. Run: taskmarket email register --username ${username}`,
+          { username, retryCommand: `taskmarket email register --username ${username}` }
+        )
       );
     }
     return null;
@@ -776,7 +791,8 @@ var initCommand = new Command2("init").description(
   } catch {
   }
   const username = opts.email ?? (agentId && networkInfo ? sanitizeEmailUsername(agentId, String(selectedNetwork().chainId)) : null);
-  const emailAddress = username ? await tryRegisterEmail(deviceId, apiToken, username, !!opts.email) : null;
+  const warnings = [];
+  const emailAddress = username ? await tryRegisterEmail(deviceId, apiToken, username, !!opts.email, warnings) : null;
   let chain;
   try {
     chain = chainInfoFor(networkInfo, selectedNetwork().chainId);
@@ -784,15 +800,18 @@ var initCommand = new Command2("init").description(
     renderFailure(err);
     return;
   }
-  printResult({
-    address,
-    agentId,
-    network: chain?.networkName ?? networkInfo?.networkName,
-    chainId: chain?.chainId ?? networkInfo?.chainId,
-    paymentMethod: chain?.paymentMethod,
-    feeModel: chain?.feeModel,
-    emailAddress
-  });
+  printResult(
+    {
+      address,
+      agentId,
+      network: chain?.networkName ?? networkInfo?.networkName,
+      chainId: chain?.chainId ?? networkInfo?.chainId,
+      paymentMethod: chain?.paymentMethod,
+      feeModel: chain?.feeModel,
+      emailAddress
+    },
+    { warnings }
+  );
 });
 
 // src/commands/address.ts
@@ -1469,6 +1488,9 @@ var reviewCmd = createReviewCommand();
 import { Command as Command8 } from "commander";
 import { parseUnits } from "viem";
 
+// src/lib/fee-ceiling.ts
+var TASKMARKET_FEE_DEFAULT_CEILING = (BigInt(STANDARD_X402_ACTION_AMOUNT) * 2n).toString();
+
 // src/lib/x402.ts
 var FACILITATOR_RETRIES = 2;
 var MAX_RETRY_AFTER_SECONDS = 60;
@@ -1500,10 +1522,12 @@ async function x402Post(path3, body, options) {
       throw refusedPaidWrite(path3, r1.status, await readFailureBody(r1), idempotencyKey);
     }
     const requirements = await r1.json();
-    if (!requirements.accepts || requirements.accepts.length === 0) {
-      throw new Error("No payment methods accepted by server");
-    }
-    const accept = requirements.accepts[0];
+    const chain = taskmarketChain(selectedNetwork().chainId);
+    const accept = selectTaskmarketFeeRequirement(requirements.accepts, {
+      network: chain.caip2,
+      asset: chain.payment.token,
+      maxAmount: options?.maxAmount ?? TASKMARKET_FEE_DEFAULT_CEILING
+    });
     const { header } = await signTaskmarketFeePayment({
       resource: requirements.resource,
       requirement: accept,
@@ -1529,6 +1553,42 @@ async function x402Post(path3, body, options) {
   });
 }
 
+// src/lib/hook-registry.ts
+async function fetchHookRegistry(address) {
+  const query3 = address ? `?address=${address}` : "";
+  return await apiGet(withChainId(`/api/hooks/registry${query3}`));
+}
+async function describeHookListings(hooks, alwaysListed = []) {
+  if (hooks.length === 0) return { hooks: [], warnings: [] };
+  let registry;
+  try {
+    registry = await fetchHookRegistry();
+    if (!registry || !Array.isArray(registry.listed)) return null;
+  } catch {
+    return null;
+  }
+  const listed = new Map(registry.listed.map((entry) => [entry.address.toLowerCase(), entry]));
+  const implicit = new Set(alwaysListed.map((address) => address.toLowerCase()));
+  const listings = [];
+  const warnings = [];
+  for (const raw of hooks) {
+    const address = raw.toLowerCase();
+    const entry = listed.get(address);
+    const isListed = entry !== void 0 || implicit.has(address);
+    listings.push({ address, listed: isListed, name: entry?.name ?? null });
+    if (!isListed) {
+      warnings.push(
+        cliWarning(
+          "hook_unlisted",
+          `Hook ${address} is not listed in the hook registry for chain ${registry.chainId}. It was attached as given; run \`taskmarket hooks list\` for listed hooks.`,
+          { address, chainId: registry.chainId }
+        )
+      );
+    }
+  }
+  return { hooks: listings, warnings };
+}
+
 // src/lib/settlement-terms.ts
 var TERM_FLAGS = {
   stakeRequired: "--stake-required",
@@ -1682,6 +1742,51 @@ function parseStakeOptions(opts) {
   }
   return { stakeRequired: true, stakeBps };
 }
+var METRIC_DESCRIPTION_MAX = 500;
+var METRIC_TARGET_MAX = 200;
+var TASK_DROP_NAME_MAX = 80;
+var TASK_DROP_DESCRIPTION_MAX = 500;
+function parseMetricAndDropOptions(opts) {
+  const fields = {};
+  for (const [flag, value, max, key] of [
+    ["--metric-description", opts.metricDescription, METRIC_DESCRIPTION_MAX, "metricDescription"],
+    ["--metric-target", opts.metricTarget, METRIC_TARGET_MAX, "metricTarget"]
+  ]) {
+    if (value === void 0) continue;
+    if (opts.mode !== "benchmark") {
+      return { error: `${flag} is only valid with --mode benchmark` };
+    }
+    if (!value.trim()) return { error: `${flag} must not be empty` };
+    if (value.length > max) return { error: `${flag} must be at most ${max} characters` };
+    fields[key] = value;
+  }
+  if (opts.taskDrop !== void 0 && opts.newTaskDrop !== void 0) {
+    return { error: "--task-drop and --new-task-drop cannot be combined" };
+  }
+  if (opts.newTaskDropDescription !== void 0 && opts.newTaskDrop === void 0) {
+    return { error: "--new-task-drop-description requires --new-task-drop" };
+  }
+  if (opts.taskDrop !== void 0) {
+    const taskDropId = opts.taskDrop.trim();
+    if (!taskDropId) return { error: "--task-drop must not be empty" };
+    fields.taskDropId = taskDropId;
+  }
+  if (opts.newTaskDrop !== void 0) {
+    const name = opts.newTaskDrop.trim();
+    if (!name) return { error: "--new-task-drop must not be empty" };
+    if (name.length > TASK_DROP_NAME_MAX) {
+      return { error: `--new-task-drop must be at most ${TASK_DROP_NAME_MAX} characters` };
+    }
+    const description = opts.newTaskDropDescription?.trim();
+    if (description && description.length > TASK_DROP_DESCRIPTION_MAX) {
+      return {
+        error: `--new-task-drop-description must be at most ${TASK_DROP_DESCRIPTION_MAX} characters`
+      };
+    }
+    fields.taskDropCreate = description ? { name, description } : { name };
+  }
+  return { fields };
+}
 var createCmd = new Command8("create").description("Create a new task (costs the reward, in the payment token)").requiredOption("--description <text>", "Task description").requiredOption("--reward <amount>", "Reward in the payment token (e.g. 5)").requiredOption("--duration <hours>", "Task duration in hours").option("--mode <mode>", "Task mode: bounty, claim, pitch, benchmark, auction", "bounty").option(
   "--task-visibility <mode>",
   "Task visibility: public (default), unlisted, or private. Unlisted only hides a task from Taskmarket's own listings/search/SEO -- it stays permanently visible on the public blockchain to anyone with the link, reading the contract directly, or running their own indexer. private is genuinely access-controlled: only the requester and invited/assigned workers can view it via listings, get, or the gated reads -- see --allowed-viewers and --access-password. Even private, the on-chain existence, reward, and participation stay publicly observable regardless.",
@@ -1696,7 +1801,22 @@ var createCmd = new Command8("create").description("Create a new task (costs the
   "--submission-visibility <mode>",
   "Submission visibility: public (default), reveal_all, winner_only, or never. Controls who can see what workers submit while the task is live and after it ends. public matches today's behavior exactly. The other three modes hide submissions from everyone but the requester and each submitting worker while the task is active; once it ends, reveal_all shows everything, winner_only shows only the winning submission(s), and never keeps every submission hidden indefinitely. Chosen once here and locked in permanently -- there is no command to change it later.",
   "public"
-).option("--tags <tags>", "Comma-separated tags").option("--pitch-deadline <hours>", "Pitch deadline in hours from now (pitch mode only)").option("--bid-deadline <hours>", "Bid deadline in hours from now (auction mode only)").option(
+).option("--tags <tags>", "Comma-separated tags").option(
+  "--metric-description <text>",
+  'Benchmark metric workers are ranked on, e.g. "Test suite pass rate" (benchmark mode only, max 500 characters)'
+).option(
+  "--metric-target <value>",
+  "Target value for the benchmark metric, e.g. 98 (benchmark mode only, max 200 characters)"
+).option(
+  "--task-drop <dropId>",
+  "Add the task to a Task Drop you own; its subscribers are emailed when the task is published. See `taskmarket drops`."
+).option(
+  "--new-task-drop <name>",
+  "Create a new Task Drop with this name (max 80 characters) and add the task to it. Cannot be combined with --task-drop."
+).option(
+  "--new-task-drop-description <text>",
+  "Description for the --new-task-drop drop (optional, max 500 characters)"
+).option("--pitch-deadline <hours>", "Pitch deadline in hours from now (pitch mode only)").option("--bid-deadline <hours>", "Bid deadline in hours from now (auction mode only)").option(
   "--max-price <amount>",
   "Maximum bid price in the payment token (required for auction mode)"
 ).option(
@@ -1710,7 +1830,7 @@ var createCmd = new Command8("create").description("Create a new task (costs the
   "Floor price in the payment token for dutch clock (required for dutch)"
 ).option(
   "--hook <address>",
-  "Custom ITMPHook contract address (repeat in execution order; protocol defaults run first)",
+  "Custom ITMPHook contract address (repeat in execution order; protocol defaults run first). Run `taskmarket hooks list` for hooks listed (verified) in the hook registry; an unlisted address is still attached, with a hook_unlisted warning",
   (value, previous = []) => [...previous, value],
   []
 ).option(
@@ -1860,6 +1980,10 @@ var createCmd = new Command8("create").description("Create a new task (costs the
         );
       }
     }
+    const metricAndDrop = parseMetricAndDropOptions(opts);
+    if ("error" in metricAndDrop) {
+      return void printError(metricAndDrop.error);
+    }
     const stakeFlags = parseStakeOptions(opts);
     if ("error" in stakeFlags) {
       return void printError(stakeFlags.error);
@@ -1885,6 +2009,7 @@ var createCmd = new Command8("create").description("Create a new task (costs the
     if (opts.accessPassword) {
       body.accessPassword = opts.accessPassword;
     }
+    Object.assign(body, metricAndDrop.fields);
     if (opts.pitchDeadline) {
       body.pitchDeadline = parseInt(opts.pitchDeadline, 10) * 3600;
     }
@@ -2082,6 +2207,10 @@ var createCmd = new Command8("create").description("Create a new task (costs the
       } catch {
       }
     }
+    const hookListings = await describeHookListings(
+      hooks,
+      sponsoredTaskHookAddress ? [sponsoredTaskHookAddress] : []
+    );
     let feeBps;
     if (opts.evaluator) {
       if (!ethAddrRe.test(opts.evaluator)) {
@@ -2113,22 +2242,53 @@ var createCmd = new Command8("create").description("Create a new task (costs the
       if (opts.appealWindow) body.appealWindowHours = parseFloat(opts.appealWindow);
       if (opts.disputeResolver) body.disputeResolver = opts.disputeResolver;
     }
-    const { data: result, idempotencyKey } = await x402Post("/api/tasks", body);
+    const { data: result, idempotencyKey } = await x402Post("/api/tasks", body, {
+      // Creating a task pays the reward plus any evaluator stake, exactly; never more.
+      maxAmount: (BigInt(String(body.reward)) + BigInt(String(body.evaluatorStake ?? "0"))).toString()
+    });
     const terms = result.terms ?? resolvedTerms;
     printResult(
       {
         taskId: result.taskId,
         terms,
         termsPreset: termsPresetLabel(terms),
-        ...evaluatorStaked ? { evaluatorStake: evaluatorStakeBaseUnits } : {}
+        ...result.taskDropId ? { taskDropId: result.taskDropId } : {},
+        ...evaluatorStaked ? { evaluatorStake: evaluatorStakeBaseUnits } : {},
+        ...hookListings && hookListings.hooks.length > 0 ? { hooks: hookListings.hooks } : {}
       },
-      { idempotencyKey }
+      {
+        idempotencyKey,
+        ...hookListings && hookListings.warnings.length > 0 ? { warnings: hookListings.warnings } : {}
+      }
     );
   }
 );
 
 // src/commands/task/search.ts
 import { Command as Command9 } from "commander";
+
+// src/lib/chain-name.ts
+function chainDisplayName(chainId) {
+  return isTaskmarketChainId(chainId) ? taskmarketChain(chainId).name : `Chain ${chainId}`;
+}
+function withChainNames(value) {
+  if (Array.isArray(value)) return value.map((item) => withChainNames(item));
+  if (value === null || typeof value !== "object") return value;
+  const proto = Object.getPrototypeOf(value);
+  if (proto !== Object.prototype && proto !== null) return value;
+  const record = value;
+  const chainId = record.chainId;
+  const named = typeof chainId === "number" && Number.isInteger(chainId);
+  const out = {};
+  for (const [key, field] of Object.entries(record)) {
+    if (key === "chainName" && named) continue;
+    out[key] = withChainNames(field);
+    if (key === "chainId" && named) out.chainName = chainDisplayName(chainId);
+  }
+  return out;
+}
+
+// src/commands/task/search.ts
 var listCmd = new Command9("list").alias("search").description("List available tasks").option("--status <status>", "Filter by status (e.g. open)", "open").option(
   "--phase <phase>",
   "Filter by derived lifecycle phase (active, in_review, awaiting_settlement, resolved) -- independent of --status, e.g. --phase awaiting_settlement finds tasks whose deadline has passed but are still open/claimed/worker_selected"
@@ -2150,7 +2310,11 @@ var listCmd = new Command9("list").alias("search").description("List available t
       limit: opts.limit,
       cursor: opts.cursor
     });
-    printResult({ tasks: result.tasks, hasMore: result.hasMore, nextCursor: result.nextCursor });
+    printResult({
+      tasks: withChainNames(result.tasks),
+      hasMore: result.hasMore,
+      nextCursor: result.nextCursor
+    });
   }
 );
 
@@ -2164,7 +2328,7 @@ var getCmd = new Command10("get").description("Get task details").argument("<tas
     );
     return;
   }
-  printResult({ ...task, ...await termsAmountsAndDeadlines(taskId) });
+  printResult(withChainNames({ ...task, ...await termsAmountsAndDeadlines(taskId) }));
 });
 async function termsAmountsAndDeadlines(taskId) {
   try {
@@ -2567,7 +2731,7 @@ var submissionsCmd = new Command23("submissions").description("List submissions
     renderFailure(err, { fallback: "Failed to fetch submissions." });
     return;
   }
-  printResult(subs);
+  printResult(withChainNames(subs));
 });
 
 // src/commands/task/select-winner.ts
@@ -2854,7 +3018,7 @@ import { Command as Command31 } from "commander";
 var mySubmissionsCmd = new Command31("my-submissions").description("List all submissions made by your wallet across all tasks.").option("--address <address>", "Wallet address to query (defaults to own wallet from keystore)").action(async (opts) => {
   try {
     const result = await listWorkerSubmissions(cliTaskReadContext(), { address: opts.address });
-    printResult(result);
+    printResult(withChainNames(result));
   } catch (err) {
     renderFailure(
       err instanceof TaskOperationError && err.code === "no_address" ? new Error("No address provided and no keystore found -- pass --address <address>.") : err
@@ -2945,7 +3109,12 @@ var updateCmd = new Command32("update").description("Update an open task (costs
     }
     const { data: result, idempotencyKey } = await x402Post(
       `/api/tasks/${taskId}/update`,
-      body
+      body,
+      ...body.reward === void 0 ? [] : [
+        {
+          maxAmount: (BigInt(TASKMARKET_FEE_DEFAULT_CEILING) + BigInt(String(body.reward))).toString()
+        }
+      ]
     );
     printResult(result, { idempotencyKey });
   }
@@ -3041,7 +3210,11 @@ var assignEvaluatorCmd = new Command34("assign-evaluator").description(
     }
     const { data: result, idempotencyKey } = await x402Post(
       `/api/tasks/${taskId}/evaluator`,
-      body
+      body,
+      // The action fee plus the stake this command just confirmed.
+      {
+        maxAmount: (BigInt(TASKMARKET_FEE_DEFAULT_CEILING) + BigInt(evaluatorStake)).toString()
+      }
     );
     printResult(
       { ...result, ...await settleRecording(result, idempotencyKey) },
@@ -3644,7 +3817,7 @@ async function runAgentCommand(options) {
   try {
     const { assertAgentCompatibility } = await import("./compatibility-636WJOEX.js");
     const pi = assertAgentCompatibility();
-    const { runAgent } = await import("./launch-UUW34PHS.js");
+    const { runAgent } = await import("./launch-LJPPWU53.js");
     result = await runAgent({
       model: options.model,
       pi,
@@ -3703,13 +3876,13 @@ function agentManagementCommands() {
   const status = new Command48("status").description(
     "Show the agent channels (locked, charged, refundable), purchases with an unknown outcome, the sandbox and compute credit. Reads only."
   ).option("--json", "Print the versioned JSON envelope").action(async (options) => {
-    const { collectAgentStatus, statusLines } = await import("./status-5AVXIFQJ.js");
+    const { collectAgentStatus, statusLines } = await import("./status-I2JO7G7X.js");
     await run(options, () => collectAgentStatus(), statusLines);
   });
   const doctor = new Command48("doctor").description(
     "Check that the agent can start: Node and the bundled runtime, wallet and policy, channels, API, sandbox broker, host keys, xgate and RPC. Reads only."
   ).option("--json", "Print the versioned JSON envelope").action(async (options) => {
-    const { runDoctor, doctorLines } = await import("./doctor-MZUDBF4B.js");
+    const { runDoctor, doctorLines } = await import("./doctor-VD2X6DWP.js");
     const report = await run(options, () => runDoctor(), doctorLines);
     if (report && !report.ok) process.exitCode = 1;
   });
@@ -3720,7 +3893,7 @@ function agentManagementCommands() {
     "Reconcile the open purchases of this channel, as status lists it; also reaches retired channels"
   ).option("--json", "Print the versioned JSON envelope").action(
     async (invocationId, options) => {
-      const { reconcileChannelPurchases, reconcileInvocation } = await import("./reconcile-NDPFPJEB.js");
+      const { reconcileChannelPurchases, reconcileInvocation } = await import("./reconcile-MW5A3PCQ.js");
       const choice = { rail: options.rail, channel: options.channel };
       if (invocationId !== void 0) {
         await run(
@@ -3778,7 +3951,7 @@ function agentManagementCommands() {
             `Not a USDC amount: ${options.amount} (digits, at most 6 decimals)`
           );
         }
-        const { openAgentChannels, requestTopUp, selectRail, withdrawalHatch } = await import("./channels-NUZWFG26.js");
+        const { openAgentChannels, requestTopUp, selectRail, withdrawalHatch } = await import("./channels-2CFKY3AB.js");
         const { rails } = await openAgentChannels();
         const result = await requestTopUp(selectRail(rails, options.rail), amount);
         return {
@@ -3802,8 +3975,8 @@ function agentManagementCommands() {
       async () => {
         await requireExperimental();
         const { AGENT_VIEW_VERSION } = await import("./budget-view-J6L7X6EY.js");
-        const { closeChannel, openAgentChannels, selectChannel } = await import("./channels-NUZWFG26.js");
-        const { reconcileLeasedPurchase } = await import("./reconcile-NDPFPJEB.js");
+        const { closeChannel, openAgentChannels, selectChannel } = await import("./channels-2CFKY3AB.js");
+        const { reconcileLeasedPurchase } = await import("./reconcile-MW5A3PCQ.js");
         const opened = await openAgentChannels();
         const { rail, retired } = selectChannel(opened, options);
         const result = await closeChannel(
@@ -3874,7 +4047,7 @@ function agentManagementCommands() {
         options,
         async () => {
           await requireExperimental();
-          const { runPull } = await import("./sync-pull-FHKF7A44.js");
+          const { runPull } = await import("./sync-pull-OEIMF2XX.js");
           const { terminalPrompter } = await import("./prompter-LSICEYSQ.js");
           return runPull(options, {
             interactive: Boolean(process.stdin.isTTY && process.stdout.isTTY) && !options.json,
@@ -3967,6 +4140,36 @@ var agentsCommand = new Command50("agents").description("Browse the agent direct
     );
   }
 );
+agentsCommand.command("get").description("Show an agent's record on the selected --network, or on every chain").argument("<address>", "Wallet address of the agent").option("--all-chains", "List the agent's records on every served chain").action(async (address, opts) => {
+  let wallet;
+  try {
+    wallet = parseInput(EthAddressSchema, address);
+  } catch (err) {
+    renderFailure(err);
+    return;
+  }
+  if (opts.allChains) {
+    const result = await apiGet(
+      `/api/agents/chains?${new URLSearchParams({ address: wallet }).toString()}`
+    );
+    const parsed = AgentChainsResponseSchema.safeParse(result);
+    if (!parsed.success) {
+      printResult(result);
+      return;
+    }
+    printResult({
+      ...parsed.data,
+      chains: parsed.data.chains.map((entry) => ({
+        ...entry,
+        earningsToken: paymentTokenSymbol(entry.chainId)
+      }))
+    });
+    return;
+  }
+  const { chainId } = selectedNetwork();
+  const params = new URLSearchParams({ address: wallet, chainId: String(chainId) });
+  printResult(await apiGet(`/api/agents/stats?${params.toString()}`));
+});
 
 // src/commands/inbox.ts
 import { Command as Command51 } from "commander";
@@ -3987,7 +4190,7 @@ var inboxCommand = new Command51("inbox").description("Show tasks you created an
       () => []
     ) : Promise.resolve([])
   ]);
-  printResult({ ...taskResult, pendingBids });
+  printResult(withChainNames({ ...taskResult, pendingBids }));
 });
 
 // src/commands/actions.ts
@@ -4183,14 +4386,58 @@ import { Command as Command64 } from "commander";
 
 // src/commands/wallet/balance.ts
 import { Command as Command54 } from "commander";
-var walletBalanceCommand = new Command54("balance").description("Show the wallet's payment-token balance on the selected network").option("--address <addr>", "Address to check (defaults to own wallet)").action(async (opts) => {
+function balancePath(address, chainId) {
+  return `/api/wallet/balance?address=${address}&chainId=${chainId}`;
+}
+async function allChainBalances(address) {
+  const raw = await apiGet("/trpc/network.info");
+  const info = NetworkInfoSchema.safeParse(raw?.result?.data);
+  if (!info.success) {
+    throw new Error(
+      "The API returned network info this CLI cannot read; upgrade the CLI or the API."
+    );
+  }
+  const chains = await Promise.all(
+    info.data.chains.map(async (chain) => {
+      const base = {
+        chainId: chain.chainId,
+        networkName: chain.networkName,
+        tokenSymbol: chain.tokenSymbol
+      };
+      try {
+        const result = await apiGet(balancePath(address, chain.chainId));
+        return {
+          ...base,
+          tokenSymbol: result.tokenSymbol ?? chain.tokenSymbol,
+          balanceBaseUnits: result.balanceBaseUnits,
+          balanceUsdc: result.balanceUsdc
+        };
+      } catch (err) {
+        return { ...base, error: err instanceof Error ? err.message : String(err) };
+      }
+    })
+  );
+  return { address, chains };
+}
+var walletBalanceCommand = new Command54("balance").description("Show the wallet's payment-token balance on the selected network").option("--address <addr>", "Address to check (defaults to own wallet)").option(
+  "--all-chains",
+  "Show the balance on every chain the selected deployment serves, one entry per chain"
+).action(async (opts) => {
   let address = opts.address;
   if (!address) {
     const keystore = await loadKeystore();
     address = keystore.walletAddress;
   }
+  if (opts.allChains) {
+    try {
+      printResult(await allChainBalances(address));
+    } catch (err) {
+      renderFailure(err, { fallback: "Failed to fetch network info from backend." });
+    }
+    return;
+  }
   const result = await apiGet(
-    `/api/wallet/balance?address=${address}&chainId=${selectedNetwork().chainId}`
+    balancePath(address, selectedNetwork().chainId)
   );
   printResult(result);
 });
@@ -4307,14 +4554,17 @@ var walletImportCommand = new Command55("import").description("Import an existin
       );
     }
   }
-  if (keySource === "flag") {
-    process.stderr.write(
-      JSON.stringify({
-        warning: "Private key was passed via --key flag and may be visible in shell history and ps aux."
-      }) + "\n"
-    );
-  }
-  printResult({ address, agentId });
+  printResult(
+    { address, agentId },
+    {
+      warnings: keySource === "flag" ? [
+        cliWarning(
+          "private_key_in_argv",
+          "Private key was passed via --key flag and may be visible in shell history and ps aux."
+        )
+      ] : []
+    }
+  );
 });
 
 // src/commands/wallet/set-withdrawal-address.ts
@@ -4357,12 +4607,16 @@ async function fetchWithdrawalAddress(address, chainId) {
 function noWithdrawalAddressMessage(chainId) {
   return `No withdrawal address set on chain ${chainId}. The withdrawal address is per chain; run: ${taskmarketCommandFor(chainId)} wallet set-withdrawal-address <address>`;
 }
-async function verifyWithdrawalAddress(keystore, chainId, serverAddress, log = (line) => process.stderr.write(line + "\n")) {
+async function verifyWithdrawalAddress(keystore, chainId, serverAddress, warnings) {
   const pinned = pinnedWithdrawalAddress(keystore, chainId);
   if (!pinned) {
     await pinWithdrawalAddress(keystore, chainId, serverAddress);
-    log(
-      `Note: pinned withdrawal address ${serverAddress} for chain ${chainId} in the local keystore.`
+    warnings.push(
+      cliWarning(
+        "withdrawal_address_pinned",
+        `Pinned withdrawal address ${serverAddress} for chain ${chainId} in the local keystore.`,
+        { chainId, withdrawalAddress: serverAddress }
+      )
     );
     return serverAddress;
   }
@@ -4437,10 +4691,18 @@ var setWithdrawalAddressCommand = new Command56("set-withdrawal-address").descri
     {
       chainId: actedOn,
       withdrawalAddress: result.withdrawalAddress,
-      accountRecoveryCode: result.accountRecoveryCode,
-      warning: `SAVE THIS ACCOUNT RECOVERY CODE NOW. It is the recovery code for chain ${actedOn} only, will never be shown again, and there is no way to recover it if lost -- this chain's withdrawal address could then never be changed again. Save it in more than one independent place (e.g. a password manager entry AND a printed copy).`
+      accountRecoveryCode: result.accountRecoveryCode
     },
-    { idempotencyKey }
+    {
+      idempotencyKey,
+      warnings: [
+        cliWarning(
+          "recovery_code_shown_once",
+          `SAVE THIS ACCOUNT RECOVERY CODE NOW. It is the recovery code for chain ${actedOn} only, will never be shown again, and there is no way to recover it if lost -- this chain's withdrawal address could then never be changed again. Save it in more than one independent place (e.g. a password manager entry AND a printed copy).`,
+          { chainId: actedOn }
+        )
+      ]
+    }
   );
 });
 
@@ -4505,10 +4767,18 @@ var changeWithdrawalAddressCommand = new Command58("change-withdrawal-address").
     {
       chainId: actedOn,
       withdrawalAddress: result.withdrawalAddress,
-      accountRecoveryCode: result.accountRecoveryCode,
-      warning: `SAVE THIS NEW ACCOUNT RECOVERY CODE NOW. It is the recovery code for chain ${actedOn} only. The code you just used is no longer valid on this chain. This new one will never be shown again, and there is no way to recover it if lost. Save it in more than one independent place (e.g. a password manager entry AND a printed copy).`
+      accountRecoveryCode: result.accountRecoveryCode
     },
-    { idempotencyKey }
+    {
+      idempotencyKey,
+      warnings: [
+        cliWarning(
+          "recovery_code_shown_once",
+          `SAVE THIS NEW ACCOUNT RECOVERY CODE NOW. It is the recovery code for chain ${actedOn} only. The code you just used is no longer valid on this chain. This new one will never be shown again, and there is no way to recover it if lost. Save it in more than one independent place (e.g. a password manager entry AND a printed copy).`,
+          { chainId: actedOn }
+        )
+      ]
+    }
   );
 });
 
@@ -4571,10 +4841,18 @@ var revealRecoveryCodeCommand = new Command60("reveal-recovery-code").descriptio
   printResult(
     {
       chainId: actedOn,
-      accountRecoveryCode: result.accountRecoveryCode,
-      warning: `SAVE THIS ACCOUNT RECOVERY CODE NOW. It is the recovery code for chain ${actedOn} only, will never be shown again, and there is no way to recover it if lost -- this chain's withdrawal address could then never be changed again. Save it in more than one independent place (e.g. a password manager entry AND a printed copy).`
+      accountRecoveryCode: result.accountRecoveryCode
     },
-    { idempotencyKey }
+    {
+      idempotencyKey,
+      warnings: [
+        cliWarning(
+          "recovery_code_shown_once",
+          `SAVE THIS ACCOUNT RECOVERY CODE NOW. It is the recovery code for chain ${actedOn} only, will never be shown again, and there is no way to recover it if lost -- this chain's withdrawal address could then never be changed again. Save it in more than one independent place (e.g. a password manager entry AND a printed copy).`,
+          { chainId: actedOn }
+        )
+      ]
+    }
   );
 });
 
@@ -4637,6 +4915,7 @@ var withdrawDreamsCommand = new Command62("withdraw-dreams").description("Withdr
     );
     return;
   }
+  const warnings = [];
   if (!destination) {
     let addressResponse;
     try {
@@ -4653,7 +4932,8 @@ var withdrawDreamsCommand = new Command62("withdraw-dreams").description("Withdr
       destination = await verifyWithdrawalAddress(
         keystore,
         balance.chainId,
-        addressResponse.withdrawalAddress
+        addressResponse.withdrawalAddress,
+        warnings
       );
     } catch (err) {
       renderFailure(err);
@@ -4691,7 +4971,7 @@ var withdrawDreamsCommand = new Command62("withdraw-dreams").description("Withdr
       dreamsPerUsdc: result.dreamsPerUsdc,
       usdEquivalent: result.usdEquivalent
     },
-    { idempotencyKey }
+    { idempotencyKey, warnings }
   );
 });
 
@@ -4963,11 +5243,13 @@ var withdrawCommand = new Command65("withdraw").description(
     return;
   }
   let withdrawalAddress;
+  const warnings = [];
   try {
     withdrawalAddress = await verifyWithdrawalAddress(
       keystore,
       chainId,
-      addressResponse.withdrawalAddress
+      addressResponse.withdrawalAddress,
+      warnings
     );
   } catch (err) {
     renderFailure(err);
@@ -4980,7 +5262,7 @@ var withdrawCommand = new Command65("withdraw").description(
       withdrawalAddress,
       amountBaseUnits
     });
-    printResult(withdrawOutput(result2, chainId), { idempotencyKey: idempotencyKey2 });
+    printResult(withdrawOutput(result2, chainId), { idempotencyKey: idempotencyKey2, warnings });
     return;
   }
   let domain;
@@ -5018,7 +5300,7 @@ var withdrawCommand = new Command65("withdraw").description(
       signature
     }
   );
-  printResult(withdrawOutput(result, chainId), { idempotencyKey });
+  printResult(withdrawOutput(result, chainId), { idempotencyKey, warnings });
 });
 
 // src/commands/encrypt.ts
@@ -10908,7 +11190,7 @@ var sponsoredTaskSettlementsCommand = new Command102("settlements").description(
   const result = await apiGet(
     `/api/sponsored-task-vaults/${vaultId}/settlements?${params.toString()}`
   );
-  printResult(result);
+  printResult(withChainNames(result));
 });
 
 // src/commands/sponsored-task/show.ts
@@ -11120,11 +11402,13 @@ var sponsoredTaskClaimCommand = new Command108("claim").description("Claim your
     return;
   }
   let destination;
+  const warnings = [];
   try {
     destination = await verifyWithdrawalAddress(
       keystore,
       vault.chainId,
-      addressResponse.withdrawalAddress
+      addressResponse.withdrawalAddress,
+      warnings
     );
   } catch (err) {
     renderFailure(err);
@@ -11183,7 +11467,7 @@ var sponsoredTaskClaimCommand = new Command108("claim").description("Claim your
       proof: entitlement.proof
     }
   );
-  printResult(result, { idempotencyKey });
+  printResult(result, { idempotencyKey, warnings });
 });
 
 // src/commands/sponsored-task/rewards.ts
@@ -11225,7 +11509,7 @@ var sponsoredTaskRewardsCommand = new Command109("rewards").description("List Sp
     const result = await apiGet(
       `/api/sponsored-task-rewards/workers/${address.toLowerCase()}?${params.toString()}`
     );
-    printResult(result);
+    printResult(withChainNames(result));
   }
 );
 
@@ -11324,20 +11608,35 @@ var dropsCommand = new Command111("drops").description("Browse Task Drops and ma
 
 // src/commands/hooks.ts
 import { Command as Command112 } from "commander";
-var listCommand5 = new Command112("list").description("List observed hooks and their active-phase task counts on the selected --network").option("--limit <n>", "Maximum hooks to return (1-100)", "50").action(async (opts) => {
+var listCommand5 = new Command112("list").description(
+  "List hooks listed (verified) in the hook registry on the selected --network, then observed hooks that are not listed"
+).option("--limit <n>", "Maximum unlisted observed hooks to return (1-100)", "50").option("--observed", "Return the raw onchain observation index instead of the registry view").action(async (opts) => {
   try {
     const input = parseInput(HookIndexInputSchema, { limit: optionalInt(opts.limit) });
-    printResult(await apiGet(withChainId(`/api/hooks?limit=${input.limit}`)));
+    if (opts.observed) {
+      printResult(await apiGet(withChainId(`/api/hooks?limit=${input.limit}`)));
+      return;
+    }
+    const registry = await fetchHookRegistry();
+    printResult({ ...registry, unlisted: registry.unlisted.slice(0, input.limit) });
   } catch (err) {
     renderFailure(err);
   }
 });
-var showCommand3 = new Command112("show").description("Show one observed hook by address on the selected --network").argument("<address>", "Hook contract address").action(async (address) => {
+var showCommand3 = new Command112("show").description(
+  "Show one hook on the selected --network: its registry listing, or its onchain observation marked unlisted"
+).argument("<address>", "Hook contract address").action(async (address) => {
   try {
     const input = parseInput(HookGetInputSchema, { address });
-    const result = await apiGet(withChainId(`/api/hooks/${input.address}`));
-    if (result === null || result === void 0) {
-      throw new Error(`Hook ${input.address} has not been observed on this network`);
+    const registry = await fetchHookRegistry(input.address.toLowerCase());
+    const wanted = input.address.toLowerCase();
+    const listed = registry.listed.find((hook) => hook.address.toLowerCase() === wanted);
+    const unlisted = registry.unlisted.find((hook) => hook.address.toLowerCase() === wanted);
+    const result = listed ?? unlisted;
+    if (!result) {
+      throw new Error(
+        `Hook ${input.address} is not listed in the hook registry and has not been observed on this network`
+      );
     }
     printResult(result);
   } catch (err) {