@bnbagent/studio-cli 0.0.13 → 0.0.14-alpha.1

package/recipes/agent/code/{{PKG}}/deliveryPolicy.ts.tmpl

@@ -0,0 +1,43 @@
+/** Shared delivery ceilings for asynchronous A2A and synchronous MCP paths. */
+export function envSeconds(name: string, dflt: number): number {
+  const value = Number(process.env[name] || dflt);
+  return Number.isFinite(value) && value > 0 ? value : dflt;
+}
+
+export const deliveryTimeoutSeconds = () =>
+  envSeconds("NOTIFY_DELIVERY_TIMEOUT_SECONDS", 600);
+
+/**
+ * Smallest remaining submit window a funded job must still have before we
+ * accept it. NOTIFY_DELIVERY_TIMEOUT_SECONDS is a ceiling, not a typical
+ * duration, so it is capped by NOTIFY_MIN_SUBMIT_WINDOW_SECONDS (default 300s):
+ * otherwise a long timeout would permanently reject every job whose buyer
+ * chose a short but valid deadline (e.g. `--deadline-min 10`).
+ */
+export const minimumDeliveryWindowSeconds = () =>
+  Math.min(
+    deliveryTimeoutSeconds() + 60,
+    envSeconds("NOTIFY_MIN_SUBMIT_WINDOW_SECONDS", 300),
+  );
+
+export class DeliveryTimeoutError extends Error {}
+
+/** Bound an entire delivery attempt and abort cancellable work on timeout. */
+export async function withTimeout<T>(
+  work: Promise<T>,
+  seconds: number,
+  controller?: AbortController,
+): Promise<T> {
+  let timer: ReturnType<typeof setTimeout> | undefined;
+  const deadline = new Promise<never>((_, reject) => {
+    timer = setTimeout(() => {
+      controller?.abort();
+      reject(new DeliveryTimeoutError(`timed out after ${seconds}s`));
+    }, seconds * 1000);
+  });
+  try {
+    return await Promise.race([work, deadline]);
+  } finally {
+    clearTimeout(timer);
+  }
+}

package/recipes/agent/code/{{PKG}}/readToolCatalog.ts.tmpl

@@ -0,0 +1,102 @@
+/** Shared descriptions and Zod input shapes for AI SDK and MCP read tools. */
+import { z } from "zod";
+
+const network = z
+  .string()
+  .optional()
+  .describe("studio network name (defaults to the project's [network].default)");
+const optionalAddress = z
+  .string()
+  .optional()
+  .describe("0x address; omit for own wallet");
+
+export const READ_TOOL_CATALOG = {
+  wallet_info: {
+    description:
+      "Describe the agent's active wallet (address, kind, key location).",
+    inputSchema: {},
+  },
+  wallet_list: {
+    description: "List all local wallet addresses.",
+    inputSchema: {},
+  },
+  wallet_address: {
+    description: "Read the active wallet address.",
+    inputSchema: {},
+  },
+  balance_native: {
+    description:
+      "Native BNB balance of an address (defaults to the agent's own wallet).",
+    inputSchema: { address: optionalAddress, network },
+  },
+  balance_u: {
+    description:
+      "$U payment-token balance of an address (defaults to the agent's own wallet).",
+    inputSchema: { address: optionalAddress, network },
+  },
+  network_info: {
+    description: "Chain id, RPC, and token information for a Studio network.",
+    inputSchema: { network },
+  },
+  tx_status: {
+    description: "Status and receipt summary of a transaction hash.",
+    inputSchema: {
+      tx_hash: z.string().describe("0x transaction hash"),
+      network,
+    },
+  },
+  block_info: {
+    description: "Read a block header summary.",
+    inputSchema: { block: z.string().optional(), network },
+  },
+  contract_call_view: {
+    description: "Call a read-only contract function by signature.",
+    inputSchema: {
+      address: z.string(),
+      function_signature: z.string(),
+      args: z.array(z.unknown()).optional(),
+      output_types: z.array(z.string()).optional(),
+      network,
+    },
+  },
+  pieverse_usage: {
+    description: "Pieverse LLM usage and credit summary for the last N days.",
+    inputSchema: { days: z.number().int().optional() },
+  },
+  agent_info: {
+    description: "ERC-8004 identity record for an agent id.",
+    inputSchema: {
+      agent_id: z.number().int().describe("ERC-8004 agent id"),
+      network,
+    },
+  },
+  agent_by_address: {
+    description: "Look up an ERC-8004 registration by wallet address.",
+    inputSchema: {
+      address: z.string().describe("0x wallet address"),
+      network,
+    },
+  },
+  job_status: {
+    description:
+      "Read-only ERC-8183 job detail including the event-resolved deliverable URL.",
+    inputSchema: {
+      job_id: z.number().int().describe("on-chain job id"),
+      network,
+    },
+  },
+  job_list: {
+    description: "List recent ERC-8183 jobs, optionally only this agent's.",
+    inputSchema: {
+      limit: z.number().int().optional(),
+      mine: z.boolean().optional().describe("only jobs assigned to this agent"),
+      network,
+    },
+  },
+  job_count: {
+    description: "Read the network-wide in-flight ERC-8183 job count.",
+    inputSchema: { network },
+  },
+} as const;
+
+export type ReadToolName = keyof typeof READ_TOOL_CATALOG;

package/recipes/agent/code/{{PKG}}/signing.ts.tmpl

@@ -250,8 +250,13 @@ export async function signQuote(
  * distinguishes a job to skip-forever (record + tell the client) from a
  * transient retry.
  */
-export async function verifySignedJob(jobId: number): Promise<Verdict> {
-  return verifySignedJobCore(jobId, getWallet().address);
+export async function verifySignedJob(
+  jobId: number,
+  minimumRemainingSeconds = 0,
+): Promise<Verdict> {
+  return verifySignedJobCore(jobId, getWallet().address, {
+    minimumRemainingSeconds,
+  });
 }
 
 /**

package/recipes/agent/recipe.toml

@@ -1,17 +1,18 @@
 [recipe]
 name = "agent"
-description = "Agent — protocol-neutral signing entrypoints (signQuote / submitResult / settle). The Agent is the SOLE key-holder/signer; this recipe emits the fixed signing.ts glue that the LLM never calls. Runtime choice (AgentCore / Azure Foundry) lives in `runtimes/<runtime>/` (which also carries the chain tools + model factory — decision D9: no separate frameworks recipe in the TS line)."
-status = "signing-only"  # only signing.ts here; runtime/provider code lives in their own recipes
+description = "Agent — protocol-neutral signing entrypoints, shared delivery policy, and read-tool catalog. The Agent is the SOLE key-holder/signer; signing glue remains fixed code that the LLM never calls. Runtime choice (AgentCore / Azure Foundry) lives in `runtimes/<runtime>/` (decision D9: no separate frameworks recipe in the TS line)."
+status = "protocol-shared"
 
 [dependencies]
 node = [
-    # signing.ts imports only from @bnbagent/studio-runtime (erc8183 + wallet +
+    # Shared templates import @bnbagent/studio-runtime (erc8183 + wallet +
     # config + networks subpaths) and the @bnbagent/sdk protocol layer
     # (NegotiationHandler / JobDescription) — protocol-level glue, framework-
     # neutral. The agent project's serving deps (@a2a-js/sdk / MCP SDK / ai)
     # come from the runtimes/<R>/ recipe selected at `bag init` time.
     "@bnbagent/studio-runtime",
     "@bnbagent/sdk@0.5.5",
+    "zod@^3.25.0",
 ]
 
 [env]

package/recipes/runtimes/agentcore/code/{{PKG}}/dualMain.ts.tmpl

@@ -209,7 +209,8 @@ export function buildRunWork(): RunWork {
 
 function hasErc8183Rail(cfg: TomlTable): boolean {
   const payments = asTable(cfg.payments);
-  return asTable(payments?.erc8183) !== null;
+  const rail = asTable(payments?.erc8183);
+  return rail !== null && rail.enabled !== false;
 }
 
 function asTable(value: unknown): TomlTable | null {
@@ -364,7 +365,10 @@ export async function buildDualApp(): Promise<{
           delete transports[t.sessionId];
         }
       };
-      await buildMcpServer({ commerceSkills: rails.erc8183 }).connect(t);
+      await buildMcpServer({
+        commerceSkills: rails.erc8183,
+        runWork,
+      }).connect(t);
       transport = t;
     }
     await transport.handleRequest(req, res, req.body);