@agent-native/core 0.7.82 → 0.8.0

package/dist/action.js

@@ -41,7 +41,7 @@ export function defineAction(options) {
     // without a declared `toolCallable` flag is invoked from a tool, so the
     // ecosystem can migrate over time. The bridge treats `undefined` as
     // "implicit allow with a deprecation warning"; only an explicit `false`
-    // refuses the call. See `tools/routes.ts` and audit H5.
+    // refuses the call. See `extensions/routes.ts` and audit H5.
     const toolCallable = typeof options.toolCallable === "boolean"
         ? options.toolCallable
         : undefined;

package/dist/action.js.map

@@ -1 +1 @@
-{"version":3,"file":"action.js","sourceRoot":"","sources":["../src/action.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ActionTool } from \"./agent/types.js\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\n/** HTTP exposure config for an action. */\nexport interface ActionHttpConfig {\n  /** HTTP method. Default: \"POST\". Use \"GET\" for read-only actions. */\n  method?: \"GET\" | \"POST\" | \"PUT\" | \"DELETE\";\n  /** Override route path under /_agent-native/actions/. Default: action filename. */\n  path?: string;\n}\n\n/** Schema definition for a single action parameter (legacy JSON schema style). */\nexport interface ParameterSchema {\n  type: string;\n  description?: string;\n  enum?: string[];\n}\n\n/** Infer runtime parameter types from a legacy parameter schema map. */\ntype InferParams<T extends Record<string, ParameterSchema> | undefined> =\n  T extends Record<string, ParameterSchema>\n    ? { [K in keyof T]?: string }\n    : Record<string, string>;\n\n// ---------------------------------------------------------------------------\n// Schema-based action options (new: Zod / Valibot / ArkType via Standard Schema)\n// ---------------------------------------------------------------------------\n\ninterface DefineActionWithSchema<\n  TSchema extends StandardSchemaV1,\n  TReturn = any,\n> {\n  description: string;\n  /** Standard Schema-compatible schema (Zod, Valibot, ArkType). Provides runtime\n   *  validation and full TypeScript type inference for `run()` args. The schema is\n   *  also converted to JSON Schema for the Claude API tool definition. */\n  schema: TSchema;\n  /** Legacy parameters — ignored when `schema` is provided. */\n  parameters?: never;\n  run: (\n    args: StandardSchemaV1.InferOutput<TSchema>,\n  ) => Promise<TReturn> | TReturn;\n  http?: ActionHttpConfig | false;\n  /** If true, the framework will NOT emit a screen-refresh poll event after a\n   *  successful call. Auto-inferred as `true` when `http.method === \"GET\"`.\n   *  Only set this manually when you need to override the inference — e.g. a\n   *  POST action that only reads data but can't use GET for a protocol reason. */\n  readOnly?: boolean;\n  /** If true, the agent may execute this action concurrently with other\n   *  read-only or parallel-safe tool calls emitted in the same model turn.\n   *  Only set this for mutating actions that are internally concurrency-safe\n   *  and order-independent for same-turn execution. */\n  parallelSafe?: boolean;\n  /** Whether this action may be invoked from the tools (Alpine iframe) bridge\n   *  via `appAction(name, params)` — see `packages/core/docs/content/actions.md`\n   *  (\"Tools Callability\"). **Default-allow opt-out**: undefined / `true` both\n   *  allow tool-iframe calls; only an explicit `false` returns 403. Set to\n   *  `false` for high-blast-radius admin operations (account deletion, org\n   *  membership changes, anything that modifies auth state) — used by the\n   *  framework's `share-resource`, `unshare-resource`, and\n   *  `set-resource-visibility` for defense-in-depth. Regular UI/agent/CLI/MCP/A2A\n   *  calls are unaffected. Enforced by the action HTTP route layer — see\n   *  `packages/core/src/server/action-routes.ts`. Audit reference: H5 in\n   *  `security-audit/05-tools-sandbox.md`. */\n  toolCallable?: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Legacy parameter-based action options\n// ---------------------------------------------------------------------------\n\ninterface DefineActionWithParams<\n  TParams extends Record<string, ParameterSchema> | undefined =\n    | Record<string, ParameterSchema>\n    | undefined,\n  TReturn = any,\n> {\n  description: string;\n  /** Flat map of parameter names to their schema. Automatically wrapped in\n   *  `{ type: \"object\", properties: ... }` for the Claude API. */\n  parameters?: TParams;\n  /** Standard Schema — not used in this overload. */\n  schema?: never;\n  run: (args: InferParams<TParams>) => Promise<TReturn> | TReturn;\n  http?: ActionHttpConfig | false;\n  /** If true, the framework will NOT emit a screen-refresh poll event after a\n   *  successful call. Auto-inferred as `true` when `http.method === \"GET\"`. */\n  readOnly?: boolean;\n  /** If true, the agent may execute this action concurrently with other\n   *  read-only or parallel-safe tool calls emitted in the same model turn. */\n  parallelSafe?: boolean;\n  /** Whether this action may be invoked from the tools (Alpine iframe) bridge\n   *  via `appAction(name, params)`. See the schema overload above for details\n   *  and the `toolCallable` section in actions.md. */\n  toolCallable?: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Define an agent action. Place in `actions/` directory — auto-discovered by the framework.\n *\n * Supports two modes:\n *\n * **Schema mode (recommended)** — pass a Standard Schema-compatible schema (Zod, Valibot,\n * ArkType) for runtime validation and full type inference:\n *\n * ```ts\n * import { defineAction } from \"@agent-native/core\";\n * import { z } from \"zod\";\n *\n * export default defineAction({\n *   description: \"Create a form\",\n *   schema: z.object({\n *     title: z.string().describe(\"Form title\"),\n *     status: z.enum([\"draft\", \"published\", \"closed\"]).default(\"draft\"),\n *   }),\n *   run: async (args) => {\n *     // args is { title: string; status: \"draft\" | \"published\" | \"closed\" }\n *     // Already validated — invalid inputs never reach here\n *   },\n * });\n * ```\n *\n * **Parameters mode (legacy)** — pass raw JSON schema-like parameter definitions:\n *\n * ```ts\n * export default defineAction({\n *   description: \"List events\",\n *   parameters: {\n *     from: { type: \"string\", description: \"Start date\" },\n *   },\n *   run: async (args) => { ... },\n * });\n * ```\n */\nexport function defineAction<TSchema extends StandardSchemaV1, TReturn>(\n  options: DefineActionWithSchema<TSchema, TReturn>,\n): any;\nexport function defineAction<\n  TParams extends Record<string, ParameterSchema> | undefined,\n  TReturn,\n>(options: DefineActionWithParams<TParams, TReturn>): any;\nexport function defineAction(options: any) {\n  const hasSchema = options.schema && \"~standard\" in options.schema;\n\n  // Build tool definition for the Claude API\n  let toolParameters: ActionTool[\"parameters\"];\n  if (hasSchema) {\n    // Convert Standard Schema to JSON Schema for Claude\n    toolParameters = schemaToJsonSchema(options.schema, options.description);\n  } else if (options.parameters) {\n    toolParameters = {\n      type: \"object\" as const,\n      properties: options.parameters,\n    };\n  }\n\n  // Wrap run() with validation when schema is provided.\n  // Pass toolParameters so the validation error can echo the expected signature\n  // (required vs optional fields) and help the caller self-correct.\n  const run = hasSchema\n    ? wrapWithValidation(options.schema, options.run, toolParameters)\n    : options.run;\n\n  // Auto-infer readOnly from http.method === \"GET\" unless explicitly set.\n  // GET actions are idempotent reads; their completion should NOT trigger a\n  // screen refresh. Everything else is assumed to mutate — the dispatcher\n  // emits a poll event on success so the UI auto-refetches its queries.\n  const httpConfig = options.http as ActionHttpConfig | false | undefined;\n  const inferredReadOnly =\n    httpConfig !== false &&\n    httpConfig !== undefined &&\n    httpConfig.method === \"GET\";\n  // Explicit `readOnly` (true OR false) wins. Otherwise infer from http.method.\n  // We store the resolved boolean so downstream checks can trust entry.readOnly\n  // without re-running method inference — including when a caller explicitly\n  // passes readOnly:false to override a GET (rare but valid).\n  const readOnly: boolean | undefined =\n    typeof options.readOnly === \"boolean\"\n      ? options.readOnly\n      : inferredReadOnly\n        ? true\n        : undefined;\n\n  // toolCallable: thread through whatever the caller declared. We DO NOT\n  // default to `true` here — the absence of an explicit field is meaningful\n  // to the tools bridge: it lets us emit a one-shot warning when an action\n  // without a declared `toolCallable` flag is invoked from a tool, so the\n  // ecosystem can migrate over time. The bridge treats `undefined` as\n  // \"implicit allow with a deprecation warning\"; only an explicit `false`\n  // refuses the call. See `tools/routes.ts` and audit H5.\n  const toolCallable: boolean | undefined =\n    typeof options.toolCallable === \"boolean\"\n      ? options.toolCallable\n      : undefined;\n  const parallelSafe: boolean | undefined =\n    typeof options.parallelSafe === \"boolean\"\n      ? options.parallelSafe\n      : undefined;\n\n  return {\n    tool: {\n      description: options.description,\n      parameters: toolParameters,\n    },\n    run,\n    ...(hasSchema ? { schema: options.schema } : {}),\n    ...(options.http !== undefined ? { http: options.http } : {}),\n    ...(typeof readOnly === \"boolean\" ? { readOnly } : {}),\n    ...(typeof parallelSafe === \"boolean\" ? { parallelSafe } : {}),\n    ...(typeof toolCallable === \"boolean\" ? { toolCallable } : {}),\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Schema → JSON Schema conversion\n// ---------------------------------------------------------------------------\n\n/**\n * Convert a Standard Schema to JSON Schema for the Claude API.\n * Tries vendor-specific toJSONSchema first (Zod v4), then falls back\n * to a basic introspection of the schema shape.\n */\nfunction schemaToJsonSchema(\n  schema: StandardSchemaV1,\n  _description?: string,\n): ActionTool[\"parameters\"] {\n  const s = schema as any;\n\n  // Prefer Zod's own JSON Schema output — it handles descriptions,\n  // enums, coerce, and all type wrappers correctly.\n  if (s[\"~standard\"]?.jsonSchema?.input) {\n    try {\n      const result = s[\"~standard\"].jsonSchema.input({\n        target: \"draft-07\",\n      }) as any;\n      // Strip $schema — the Claude API validates against draft 2020-12\n      // and a mismatched $schema declaration can cause rejections.\n      if (result && typeof result === \"object\") {\n        delete result.$schema;\n      }\n      return result as ActionTool[\"parameters\"];\n    } catch {\n      // Fall through to manual converter\n    }\n  }\n\n  // Fallback: manual conversion from Zod v4 internal defs\n  if (s._zod?.def) {\n    return zodDefToJsonSchema(s._zod.def);\n  }\n\n  // Last resort: empty object schema\n  return { type: \"object\" as const, properties: {} };\n}\n\n/**\n * Convert a Zod v4 internal def to JSON Schema.\n * Handles the common types used in action parameters.\n */\nfunction zodDefToJsonSchema(def: any): any {\n  const type = def.type;\n\n  if (type === \"object\") {\n    const properties: Record<string, any> = {};\n    const required: string[] = [];\n    const shape = def.shape;\n    if (shape) {\n      for (const [key, fieldSchema] of Object.entries(shape) as any[]) {\n        const fieldDef = fieldSchema?._zod?.def;\n        if (fieldDef) {\n          const prop = zodDefToJsonSchema(fieldDef);\n          // Zod v4 stores .describe() on the schema object, not in the def\n          const desc = fieldSchema?.description;\n          if (desc && !prop.description) prop.description = desc;\n          properties[key] = prop;\n          if (fieldDef.type !== \"optional\" && fieldDef.type !== \"default\") {\n            required.push(key);\n          }\n        }\n      }\n    }\n    const result: any = { type: \"object\", properties };\n    if (required.length > 0) result.required = required;\n    return result;\n  }\n\n  if (type === \"string\") {\n    const result: any = { type: \"string\" };\n    if (def.description) result.description = def.description;\n    return result;\n  }\n\n  if (type === \"number\" || type === \"float\" || type === \"int\") {\n    const result: any = { type: type === \"int\" ? \"integer\" : \"number\" };\n    if (def.description) result.description = def.description;\n    return result;\n  }\n\n  if (type === \"boolean\") {\n    const result: any = { type: \"boolean\" };\n    if (def.description) result.description = def.description;\n    return result;\n  }\n\n  if (type === \"enum\") {\n    // Zod v4 stores enum entries as an object {a: \"a\", b: \"b\"};\n    // JSON Schema requires an array.\n    const entries = def.entries;\n    const enumValues = Array.isArray(entries)\n      ? entries\n      : typeof entries === \"object\" && entries !== null\n        ? Object.values(entries)\n        : entries;\n    const result: any = { type: \"string\", enum: enumValues };\n    if (def.description) result.description = def.description;\n    return result;\n  }\n\n  if (type === \"literal\") {\n    return { type: typeof def.value, enum: [def.value] };\n  }\n\n  if (type === \"array\") {\n    const result: any = { type: \"array\" };\n    if (def.element?._zod?.def) {\n      result.items = zodDefToJsonSchema(def.element._zod.def);\n    }\n    if (def.description) result.description = def.description;\n    return result;\n  }\n\n  if (type === \"optional\") {\n    if (def.innerType?._zod?.def) {\n      return zodDefToJsonSchema(def.innerType._zod.def);\n    }\n  }\n\n  if (type === \"default\") {\n    if (def.innerType?._zod?.def) {\n      const inner = zodDefToJsonSchema(def.innerType._zod.def);\n      inner.default =\n        typeof def.defaultValue === \"function\"\n          ? def.defaultValue()\n          : def.defaultValue;\n      return inner;\n    }\n  }\n\n  if (type === \"nullable\") {\n    if (def.innerType?._zod?.def) {\n      return zodDefToJsonSchema(def.innerType._zod.def);\n    }\n  }\n\n  if (type === \"union\") {\n    if (def.options?.length) {\n      // Check if it's a simple enum-like union of literals\n      const allLiterals = def.options.every(\n        (o: any) => o?._zod?.def?.type === \"literal\",\n      );\n      if (allLiterals) {\n        return {\n          type: \"string\",\n          enum: def.options.map((o: any) => o._zod.def.value),\n        };\n      }\n      return {\n        anyOf: def.options.map((o: any) =>\n          zodDefToJsonSchema(o._zod?.def ?? {}),\n        ),\n      };\n    }\n  }\n\n  // Fallback\n  return { type: \"string\" };\n}\n\n// ---------------------------------------------------------------------------\n// Runtime validation wrapper\n// ---------------------------------------------------------------------------\n\n/**\n * Wrap an action's run function with schema validation.\n * Invalid inputs get a clear error message (including what was actually passed)\n * so the agent can see its own mistake and correct it on the next turn.\n */\nfunction wrapWithValidation(\n  schema: StandardSchemaV1,\n  run: Function,\n  toolParameters?: ActionTool[\"parameters\"],\n): (args: any) => any {\n  return async (args: any) => {\n    const result = await schema[\"~standard\"].validate(args);\n    if (result.issues) {\n      // Split issues into \"missing required field\" vs other validation errors\n      // so the error message reads naturally rather than as \"fieldName: Required\".\n      const missing: string[] = [];\n      const other: string[] = [];\n      for (const issue of result.issues) {\n        const pathStr = issue.path\n          ? issue.path.map((p) => (typeof p === \"object\" ? p.key : p)).join(\".\")\n          : \"\";\n        const msg = String(issue.message ?? \"\");\n        // Zod emits \"Required\" for missing fields; other libraries may use\n        // similar wording. Treat any variant as \"missing\".\n        if (\n          pathStr &&\n          (msg === \"Required\" ||\n            /invalid.*undefined/i.test(msg) ||\n            /expected.*received undefined/i.test(msg))\n        ) {\n          missing.push(pathStr);\n        } else {\n          other.push(pathStr ? `${pathStr}: ${msg}` : msg);\n        }\n      }\n\n      const parts: string[] = [];\n      if (missing.length > 0) {\n        parts.push(\n          `Missing required parameter${missing.length === 1 ? \"\" : \"s\"}: ${missing.join(\", \")}`,\n        );\n      }\n      if (other.length > 0) {\n        parts.push(other.join(\"; \"));\n      }\n\n      // Echo the args that were actually passed so the caller (usually an\n      // agent) can see exactly what it sent and fix its next call.\n      let received: string;\n      try {\n        received = JSON.stringify(args);\n        if (received.length > 500) received = received.slice(0, 500) + \"…\";\n      } catch {\n        received = String(args);\n      }\n\n      // Also show the EXPECTED signature so the agent doesn't have to guess.\n      // Format: `{ deckId*: string, content*: string, slideId?: string, ... }`\n      // where `*` = required, `?` = optional.\n      let expected = \"\";\n      if (toolParameters?.properties) {\n        const required = new Set(toolParameters.required ?? []);\n        const sig = Object.entries(toolParameters.properties)\n          .map(([k, v]) => {\n            const mark = required.has(k) ? \"*\" : \"?\";\n            const type = (v as { type?: string }).type ?? \"any\";\n            return `${k}${mark}: ${type}`;\n          })\n          .join(\", \");\n        if (sig)\n          expected = ` Expected: { ${sig} } (where * = required, ? = optional).`;\n      }\n\n      throw new Error(\n        `Invalid action parameters — ${parts.join(\". \")}. Received: ${received}.${expected}`,\n      );\n    }\n    return run((result as StandardSchemaV1.SuccessResult<any>).value);\n  };\n}\n"]}
+{"version":3,"file":"action.js","sourceRoot":"","sources":["../src/action.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ActionTool } from \"./agent/types.js\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\n/** HTTP exposure config for an action. */\nexport interface ActionHttpConfig {\n  /** HTTP method. Default: \"POST\". Use \"GET\" for read-only actions. */\n  method?: \"GET\" | \"POST\" | \"PUT\" | \"DELETE\";\n  /** Override route path under /_agent-native/actions/. Default: action filename. */\n  path?: string;\n}\n\n/** Schema definition for a single action parameter (legacy JSON schema style). */\nexport interface ParameterSchema {\n  type: string;\n  description?: string;\n  enum?: string[];\n}\n\n/** Infer runtime parameter types from a legacy parameter schema map. */\ntype InferParams<T extends Record<string, ParameterSchema> | undefined> =\n  T extends Record<string, ParameterSchema>\n    ? { [K in keyof T]?: string }\n    : Record<string, string>;\n\n// ---------------------------------------------------------------------------\n// Schema-based action options (new: Zod / Valibot / ArkType via Standard Schema)\n// ---------------------------------------------------------------------------\n\ninterface DefineActionWithSchema<\n  TSchema extends StandardSchemaV1,\n  TReturn = any,\n> {\n  description: string;\n  /** Standard Schema-compatible schema (Zod, Valibot, ArkType). Provides runtime\n   *  validation and full TypeScript type inference for `run()` args. The schema is\n   *  also converted to JSON Schema for the Claude API tool definition. */\n  schema: TSchema;\n  /** Legacy parameters — ignored when `schema` is provided. */\n  parameters?: never;\n  run: (\n    args: StandardSchemaV1.InferOutput<TSchema>,\n  ) => Promise<TReturn> | TReturn;\n  http?: ActionHttpConfig | false;\n  /** If true, the framework will NOT emit a screen-refresh poll event after a\n   *  successful call. Auto-inferred as `true` when `http.method === \"GET\"`.\n   *  Only set this manually when you need to override the inference — e.g. a\n   *  POST action that only reads data but can't use GET for a protocol reason. */\n  readOnly?: boolean;\n  /** If true, the agent may execute this action concurrently with other\n   *  read-only or parallel-safe tool calls emitted in the same model turn.\n   *  Only set this for mutating actions that are internally concurrency-safe\n   *  and order-independent for same-turn execution. */\n  parallelSafe?: boolean;\n  /** Whether this action may be invoked from the tools (Alpine iframe) bridge\n   *  via `appAction(name, params)` — see `packages/core/docs/content/actions.md`\n   *  (\"Tools Callability\"). **Default-allow opt-out**: undefined / `true` both\n   *  allow tool-iframe calls; only an explicit `false` returns 403. Set to\n   *  `false` for high-blast-radius admin operations (account deletion, org\n   *  membership changes, anything that modifies auth state) — used by the\n   *  framework's `share-resource`, `unshare-resource`, and\n   *  `set-resource-visibility` for defense-in-depth. Regular UI/agent/CLI/MCP/A2A\n   *  calls are unaffected. Enforced by the action HTTP route layer — see\n   *  `packages/core/src/server/action-routes.ts`. Audit reference: H5 in\n   *  `security-audit/05-tools-sandbox.md`. */\n  toolCallable?: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Legacy parameter-based action options\n// ---------------------------------------------------------------------------\n\ninterface DefineActionWithParams<\n  TParams extends Record<string, ParameterSchema> | undefined =\n    | Record<string, ParameterSchema>\n    | undefined,\n  TReturn = any,\n> {\n  description: string;\n  /** Flat map of parameter names to their schema. Automatically wrapped in\n   *  `{ type: \"object\", properties: ... }` for the Claude API. */\n  parameters?: TParams;\n  /** Standard Schema — not used in this overload. */\n  schema?: never;\n  run: (args: InferParams<TParams>) => Promise<TReturn> | TReturn;\n  http?: ActionHttpConfig | false;\n  /** If true, the framework will NOT emit a screen-refresh poll event after a\n   *  successful call. Auto-inferred as `true` when `http.method === \"GET\"`. */\n  readOnly?: boolean;\n  /** If true, the agent may execute this action concurrently with other\n   *  read-only or parallel-safe tool calls emitted in the same model turn. */\n  parallelSafe?: boolean;\n  /** Whether this action may be invoked from the tools (Alpine iframe) bridge\n   *  via `appAction(name, params)`. See the schema overload above for details\n   *  and the `toolCallable` section in actions.md. */\n  toolCallable?: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Define an agent action. Place in `actions/` directory — auto-discovered by the framework.\n *\n * Supports two modes:\n *\n * **Schema mode (recommended)** — pass a Standard Schema-compatible schema (Zod, Valibot,\n * ArkType) for runtime validation and full type inference:\n *\n * ```ts\n * import { defineAction } from \"@agent-native/core\";\n * import { z } from \"zod\";\n *\n * export default defineAction({\n *   description: \"Create a form\",\n *   schema: z.object({\n *     title: z.string().describe(\"Form title\"),\n *     status: z.enum([\"draft\", \"published\", \"closed\"]).default(\"draft\"),\n *   }),\n *   run: async (args) => {\n *     // args is { title: string; status: \"draft\" | \"published\" | \"closed\" }\n *     // Already validated — invalid inputs never reach here\n *   },\n * });\n * ```\n *\n * **Parameters mode (legacy)** — pass raw JSON schema-like parameter definitions:\n *\n * ```ts\n * export default defineAction({\n *   description: \"List events\",\n *   parameters: {\n *     from: { type: \"string\", description: \"Start date\" },\n *   },\n *   run: async (args) => { ... },\n * });\n * ```\n */\nexport function defineAction<TSchema extends StandardSchemaV1, TReturn>(\n  options: DefineActionWithSchema<TSchema, TReturn>,\n): any;\nexport function defineAction<\n  TParams extends Record<string, ParameterSchema> | undefined,\n  TReturn,\n>(options: DefineActionWithParams<TParams, TReturn>): any;\nexport function defineAction(options: any) {\n  const hasSchema = options.schema && \"~standard\" in options.schema;\n\n  // Build tool definition for the Claude API\n  let toolParameters: ActionTool[\"parameters\"];\n  if (hasSchema) {\n    // Convert Standard Schema to JSON Schema for Claude\n    toolParameters = schemaToJsonSchema(options.schema, options.description);\n  } else if (options.parameters) {\n    toolParameters = {\n      type: \"object\" as const,\n      properties: options.parameters,\n    };\n  }\n\n  // Wrap run() with validation when schema is provided.\n  // Pass toolParameters so the validation error can echo the expected signature\n  // (required vs optional fields) and help the caller self-correct.\n  const run = hasSchema\n    ? wrapWithValidation(options.schema, options.run, toolParameters)\n    : options.run;\n\n  // Auto-infer readOnly from http.method === \"GET\" unless explicitly set.\n  // GET actions are idempotent reads; their completion should NOT trigger a\n  // screen refresh. Everything else is assumed to mutate — the dispatcher\n  // emits a poll event on success so the UI auto-refetches its queries.\n  const httpConfig = options.http as ActionHttpConfig | false | undefined;\n  const inferredReadOnly =\n    httpConfig !== false &&\n    httpConfig !== undefined &&\n    httpConfig.method === \"GET\";\n  // Explicit `readOnly` (true OR false) wins. Otherwise infer from http.method.\n  // We store the resolved boolean so downstream checks can trust entry.readOnly\n  // without re-running method inference — including when a caller explicitly\n  // passes readOnly:false to override a GET (rare but valid).\n  const readOnly: boolean | undefined =\n    typeof options.readOnly === \"boolean\"\n      ? options.readOnly\n      : inferredReadOnly\n        ? true\n        : undefined;\n\n  // toolCallable: thread through whatever the caller declared. We DO NOT\n  // default to `true` here — the absence of an explicit field is meaningful\n  // to the tools bridge: it lets us emit a one-shot warning when an action\n  // without a declared `toolCallable` flag is invoked from a tool, so the\n  // ecosystem can migrate over time. The bridge treats `undefined` as\n  // \"implicit allow with a deprecation warning\"; only an explicit `false`\n  // refuses the call. See `extensions/routes.ts` and audit H5.\n  const toolCallable: boolean | undefined =\n    typeof options.toolCallable === \"boolean\"\n      ? options.toolCallable\n      : undefined;\n  const parallelSafe: boolean | undefined =\n    typeof options.parallelSafe === \"boolean\"\n      ? options.parallelSafe\n      : undefined;\n\n  return {\n    tool: {\n      description: options.description,\n      parameters: toolParameters,\n    },\n    run,\n    ...(hasSchema ? { schema: options.schema } : {}),\n    ...(options.http !== undefined ? { http: options.http } : {}),\n    ...(typeof readOnly === \"boolean\" ? { readOnly } : {}),\n    ...(typeof parallelSafe === \"boolean\" ? { parallelSafe } : {}),\n    ...(typeof toolCallable === \"boolean\" ? { toolCallable } : {}),\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Schema → JSON Schema conversion\n// ---------------------------------------------------------------------------\n\n/**\n * Convert a Standard Schema to JSON Schema for the Claude API.\n * Tries vendor-specific toJSONSchema first (Zod v4), then falls back\n * to a basic introspection of the schema shape.\n */\nfunction schemaToJsonSchema(\n  schema: StandardSchemaV1,\n  _description?: string,\n): ActionTool[\"parameters\"] {\n  const s = schema as any;\n\n  // Prefer Zod's own JSON Schema output — it handles descriptions,\n  // enums, coerce, and all type wrappers correctly.\n  if (s[\"~standard\"]?.jsonSchema?.input) {\n    try {\n      const result = s[\"~standard\"].jsonSchema.input({\n        target: \"draft-07\",\n      }) as any;\n      // Strip $schema — the Claude API validates against draft 2020-12\n      // and a mismatched $schema declaration can cause rejections.\n      if (result && typeof result === \"object\") {\n        delete result.$schema;\n      }\n      return result as ActionTool[\"parameters\"];\n    } catch {\n      // Fall through to manual converter\n    }\n  }\n\n  // Fallback: manual conversion from Zod v4 internal defs\n  if (s._zod?.def) {\n    return zodDefToJsonSchema(s._zod.def);\n  }\n\n  // Last resort: empty object schema\n  return { type: \"object\" as const, properties: {} };\n}\n\n/**\n * Convert a Zod v4 internal def to JSON Schema.\n * Handles the common types used in action parameters.\n */\nfunction zodDefToJsonSchema(def: any): any {\n  const type = def.type;\n\n  if (type === \"object\") {\n    const properties: Record<string, any> = {};\n    const required: string[] = [];\n    const shape = def.shape;\n    if (shape) {\n      for (const [key, fieldSchema] of Object.entries(shape) as any[]) {\n        const fieldDef = fieldSchema?._zod?.def;\n        if (fieldDef) {\n          const prop = zodDefToJsonSchema(fieldDef);\n          // Zod v4 stores .describe() on the schema object, not in the def\n          const desc = fieldSchema?.description;\n          if (desc && !prop.description) prop.description = desc;\n          properties[key] = prop;\n          if (fieldDef.type !== \"optional\" && fieldDef.type !== \"default\") {\n            required.push(key);\n          }\n        }\n      }\n    }\n    const result: any = { type: \"object\", properties };\n    if (required.length > 0) result.required = required;\n    return result;\n  }\n\n  if (type === \"string\") {\n    const result: any = { type: \"string\" };\n    if (def.description) result.description = def.description;\n    return result;\n  }\n\n  if (type === \"number\" || type === \"float\" || type === \"int\") {\n    const result: any = { type: type === \"int\" ? \"integer\" : \"number\" };\n    if (def.description) result.description = def.description;\n    return result;\n  }\n\n  if (type === \"boolean\") {\n    const result: any = { type: \"boolean\" };\n    if (def.description) result.description = def.description;\n    return result;\n  }\n\n  if (type === \"enum\") {\n    // Zod v4 stores enum entries as an object {a: \"a\", b: \"b\"};\n    // JSON Schema requires an array.\n    const entries = def.entries;\n    const enumValues = Array.isArray(entries)\n      ? entries\n      : typeof entries === \"object\" && entries !== null\n        ? Object.values(entries)\n        : entries;\n    const result: any = { type: \"string\", enum: enumValues };\n    if (def.description) result.description = def.description;\n    return result;\n  }\n\n  if (type === \"literal\") {\n    return { type: typeof def.value, enum: [def.value] };\n  }\n\n  if (type === \"array\") {\n    const result: any = { type: \"array\" };\n    if (def.element?._zod?.def) {\n      result.items = zodDefToJsonSchema(def.element._zod.def);\n    }\n    if (def.description) result.description = def.description;\n    return result;\n  }\n\n  if (type === \"optional\") {\n    if (def.innerType?._zod?.def) {\n      return zodDefToJsonSchema(def.innerType._zod.def);\n    }\n  }\n\n  if (type === \"default\") {\n    if (def.innerType?._zod?.def) {\n      const inner = zodDefToJsonSchema(def.innerType._zod.def);\n      inner.default =\n        typeof def.defaultValue === \"function\"\n          ? def.defaultValue()\n          : def.defaultValue;\n      return inner;\n    }\n  }\n\n  if (type === \"nullable\") {\n    if (def.innerType?._zod?.def) {\n      return zodDefToJsonSchema(def.innerType._zod.def);\n    }\n  }\n\n  if (type === \"union\") {\n    if (def.options?.length) {\n      // Check if it's a simple enum-like union of literals\n      const allLiterals = def.options.every(\n        (o: any) => o?._zod?.def?.type === \"literal\",\n      );\n      if (allLiterals) {\n        return {\n          type: \"string\",\n          enum: def.options.map((o: any) => o._zod.def.value),\n        };\n      }\n      return {\n        anyOf: def.options.map((o: any) =>\n          zodDefToJsonSchema(o._zod?.def ?? {}),\n        ),\n      };\n    }\n  }\n\n  // Fallback\n  return { type: \"string\" };\n}\n\n// ---------------------------------------------------------------------------\n// Runtime validation wrapper\n// ---------------------------------------------------------------------------\n\n/**\n * Wrap an action's run function with schema validation.\n * Invalid inputs get a clear error message (including what was actually passed)\n * so the agent can see its own mistake and correct it on the next turn.\n */\nfunction wrapWithValidation(\n  schema: StandardSchemaV1,\n  run: Function,\n  toolParameters?: ActionTool[\"parameters\"],\n): (args: any) => any {\n  return async (args: any) => {\n    const result = await schema[\"~standard\"].validate(args);\n    if (result.issues) {\n      // Split issues into \"missing required field\" vs other validation errors\n      // so the error message reads naturally rather than as \"fieldName: Required\".\n      const missing: string[] = [];\n      const other: string[] = [];\n      for (const issue of result.issues) {\n        const pathStr = issue.path\n          ? issue.path.map((p) => (typeof p === \"object\" ? p.key : p)).join(\".\")\n          : \"\";\n        const msg = String(issue.message ?? \"\");\n        // Zod emits \"Required\" for missing fields; other libraries may use\n        // similar wording. Treat any variant as \"missing\".\n        if (\n          pathStr &&\n          (msg === \"Required\" ||\n            /invalid.*undefined/i.test(msg) ||\n            /expected.*received undefined/i.test(msg))\n        ) {\n          missing.push(pathStr);\n        } else {\n          other.push(pathStr ? `${pathStr}: ${msg}` : msg);\n        }\n      }\n\n      const parts: string[] = [];\n      if (missing.length > 0) {\n        parts.push(\n          `Missing required parameter${missing.length === 1 ? \"\" : \"s\"}: ${missing.join(\", \")}`,\n        );\n      }\n      if (other.length > 0) {\n        parts.push(other.join(\"; \"));\n      }\n\n      // Echo the args that were actually passed so the caller (usually an\n      // agent) can see exactly what it sent and fix its next call.\n      let received: string;\n      try {\n        received = JSON.stringify(args);\n        if (received.length > 500) received = received.slice(0, 500) + \"…\";\n      } catch {\n        received = String(args);\n      }\n\n      // Also show the EXPECTED signature so the agent doesn't have to guess.\n      // Format: `{ deckId*: string, content*: string, slideId?: string, ... }`\n      // where `*` = required, `?` = optional.\n      let expected = \"\";\n      if (toolParameters?.properties) {\n        const required = new Set(toolParameters.required ?? []);\n        const sig = Object.entries(toolParameters.properties)\n          .map(([k, v]) => {\n            const mark = required.has(k) ? \"*\" : \"?\";\n            const type = (v as { type?: string }).type ?? \"any\";\n            return `${k}${mark}: ${type}`;\n          })\n          .join(\", \");\n        if (sig)\n          expected = ` Expected: { ${sig} } (where * = required, ? = optional).`;\n      }\n\n      throw new Error(\n        `Invalid action parameters — ${parts.join(\". \")}. Received: ${received}.${expected}`,\n      );\n    }\n    return run((result as StandardSchemaV1.SuccessResult<any>).value);\n  };\n}\n"]}

package/dist/agent/production-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"production-agent.d.ts","sourceRoot":"","sources":["../../src/agent/production-agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"production-agent.d.ts","sourceRoot":"","sources":["../../src/agent/production-agent.ts"],"names":[],"mappings":"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"}

package/dist/agent/production-agent.js

@@ -332,7 +332,9 @@ function isRetryableError(err) {
 }
 /** Wait with exponential backoff, respecting abort signal */
 function retryDelay(attempt, signal) {
-    const ms = RETRY_BASE_DELAY_MS * Math.pow(2, attempt);
+    const baseMs = RETRY_BASE_DELAY_MS * Math.pow(2, attempt);
+    const jitter = baseMs * 0.1;
+    const ms = Math.max(0, baseMs + (Math.random() * 2 - 1) * jitter);
     return new Promise((resolve, reject) => {
         if (signal.aborted)
             return reject(new Error("aborted"));
@@ -607,12 +609,10 @@ export async function runAgentLoop(opts) {
                 }
                 if (retry < MAX_RETRIES && isRetryableError(err)) {
                     // Clear partial text from the failed attempt so the retry
-                    // doesn't produce garbled duplicate output
+                    // doesn't produce garbled duplicate output. Keep the retry itself
+                    // silent so transient provider/backend failures do not leak into
+                    // the assistant's final answer.
                     send({ type: "clear" });
-                    send({
-                        type: "text",
-                        text: `*Retrying in ${(RETRY_BASE_DELAY_MS * Math.pow(2, retry)) / 1000}s...*\n\n`,
-                    });
                     await retryDelay(retry, signal);
                     continue;
                 }
@@ -1135,8 +1135,8 @@ export function createProductionAgentHandler(options) {
         // If there's already an active run for this thread, reject with 409 so
         // the client can queue or wait rather than silently aborting the existing run.
         if (threadId) {
-            const existingRun = getActiveRunForThread(threadId);
-            if (existingRun && existingRun.status === "running") {
+            const existingRun = await getActiveRunForThreadAsync(threadId);
+            if (existingRun?.status === "running") {
                 setResponseStatus(event, 409);
                 return {
                     error: "Run already in progress for this thread",