@ironflow/node 0.19.3 → 0.20.0

package/dist/agent/mcp.js

@@ -0,0 +1,155 @@
+/**
+ * exposeMcp() — register agent tools with Ironflow's AgentToolsService
+ * and serve dispatched invocations over the existing serve() mount.
+ *
+ * Boot-time flow:
+ *
+ *	1. Convert each McpToolDef.input (Zod) → JSON Schema (Draft 2020-12)
+ *	   via z.toJSONSchema().
+ *	2. POST `/ironflow.v1.AgentToolsService/RegisterTool` with
+ *	   {agentName, callbackUrl, tools[]}.
+ *	3. Stash the returned HMAC secret + def closures in the local
+ *	   registry so serve()'s dispatch route can validate inbound calls.
+ *
+ * Callback flow lives in `dispatch.ts` (HMAC verify + Zod parse + handler).
+ *
+ * Authoritative authorization stays server-side: scopes on McpToolDef
+ * are advisory hints to MCP clients. The server enforces api_key.tool_scopes
+ * superset against ToolDef.required_scopes. RegisterTool requires the
+ * `agent:tools:register` action on the calling key.
+ */
+import { IronflowError } from "@ironflow/core";
+import { z } from "zod";
+import { registerLocal, unregisterLocal, } from "./internal-registry.js";
+const REGISTER_PATH = "/ironflow.v1.AgentToolsService/RegisterTool";
+const UNREGISTER_PATH = "/ironflow.v1.AgentToolsService/UnregisterTool";
+/**
+ * Register the supplied MCP tool definitions with the Ironflow server.
+ *
+ * Returns an active handle once RegisterTool succeeds. Throws on
+ * empty tool lists, missing config (server URL / API key / callback URL),
+ * or transport failure.
+ */
+export async function exposeMcp(config) {
+    if (!config.tools.length) {
+        throw new IronflowError("exposeMcp() requires at least one tool", {
+            code: "AGENT_MCP_NO_TOOLS",
+            retryable: false,
+        });
+    }
+    if (!config.callbackUrl) {
+        throw new IronflowError("exposeMcp() requires callbackUrl pointing at your serve() mount", { code: "AGENT_MCP_MISSING_CALLBACK_URL", retryable: false });
+    }
+    const serverUrl = config.serverUrl ??
+        process.env.IRONFLOW_URL ??
+        process.env.IRONFLOW_SERVER_URL;
+    if (!serverUrl) {
+        throw new IronflowError("exposeMcp() requires serverUrl (or IRONFLOW_URL / IRONFLOW_SERVER_URL env)", { code: "AGENT_MCP_MISSING_SERVER_URL", retryable: false });
+    }
+    const apiKey = config.apiKey ?? process.env.IRONFLOW_API_KEY;
+    if (!apiKey) {
+        throw new IronflowError("exposeMcp() requires apiKey (or IRONFLOW_API_KEY env) with the agent:tools:register action", { code: "AGENT_MCP_MISSING_API_KEY", retryable: false });
+    }
+    const seen = new Set();
+    const toolPayload = config.tools.map((def) => {
+        if (seen.has(def.name)) {
+            throw new IronflowError(`exposeMcp() received duplicate tool name "${def.name}"`, { code: "AGENT_MCP_DUPLICATE_TOOL", retryable: false });
+        }
+        seen.add(def.name);
+        return toToolDefJSON(def);
+    });
+    const requestBody = {
+        agentName: config.name,
+        callbackUrl: config.callbackUrl,
+        tools: toolPayload,
+    };
+    const resp = await postJSON(serverUrl, REGISTER_PATH, apiKey, requestBody);
+    const decoded = (await readJSON(resp));
+    if (!decoded.hmacSecret || !decoded.registeredToolNames?.length) {
+        throw new IronflowError("RegisterTool response missing hmacSecret or registeredToolNames", { code: "AGENT_MCP_INVALID_RESPONSE", retryable: false });
+    }
+    const qualifiedNames = decoded.registeredToolNames;
+    for (const def of config.tools) {
+        const qualifiedName = `${config.name}.${def.name}`;
+        const entry = {
+            agentName: config.name,
+            qualifiedName,
+            hmacSecret: decoded.hmacSecret,
+            def,
+        };
+        registerLocal(entry);
+    }
+    let unregistered = false;
+    return {
+        name: config.name,
+        toolCount: qualifiedNames.length,
+        status: "active",
+        toolNames: qualifiedNames,
+        async unregister() {
+            if (unregistered) {
+                return;
+            }
+            unregistered = true;
+            // Always clear local entries so handler closures stop receiving
+            // dispatches even when the server-side call fails.
+            unregisterLocal(config.name);
+            try {
+                const r = await postJSON(serverUrl, UNREGISTER_PATH, apiKey, {
+                    agentName: config.name,
+                });
+                await readJSON(r);
+            }
+            catch (err) {
+                throw new IronflowError(`unregister failed: ${err instanceof Error ? err.message : String(err)}`, { code: "AGENT_MCP_UNREGISTER_FAILED", retryable: false });
+            }
+        },
+    };
+}
+function toToolDefJSON(def) {
+    let schemaObj;
+    try {
+        schemaObj = z.toJSONSchema(def.input);
+    }
+    catch (err) {
+        throw new IronflowError(`exposeMcp() failed to convert input schema for "${def.name}": ${err instanceof Error ? err.message : String(err)}`, { code: "AGENT_MCP_SCHEMA_CONVERSION_FAILED", retryable: false });
+    }
+    return {
+        name: def.name,
+        description: def.description,
+        inputSchemaJson: JSON.stringify(schemaObj),
+        requiredScopes: def.scopes ? [...def.scopes] : [],
+        timeoutMs: 0,
+    };
+}
+async function postJSON(serverUrl, path, apiKey, body) {
+    const url = `${serverUrl.replace(/\/+$/, "")}${path}`;
+    const resp = await fetch(url, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify(body),
+    });
+    if (!resp.ok) {
+        const text = await resp.text().catch(() => "");
+        throw new IronflowError(`POST ${path} failed: HTTP ${resp.status}${text ? ` — ${text}` : ""}`, { code: "AGENT_MCP_TRANSPORT_ERROR", retryable: false });
+    }
+    return resp;
+}
+async function readJSON(resp) {
+    const text = await resp.text();
+    if (!text) {
+        return {};
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new IronflowError(`response body is not valid JSON: ${text.slice(0, 256)}`, {
+            code: "AGENT_MCP_INVALID_RESPONSE",
+            retryable: false,
+        });
+    }
+}
+//# sourceMappingURL=mcp.js.map

package/dist/agent/mcp.js.map

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

package/dist/agent/memory.d.ts

@@ -0,0 +1,74 @@
+/**
+ * memory() — durable agent memory backed by an entity stream + projection.
+ *
+ * Composition:
+ *   - memory.append(eventName, data) → step.run wraps backend.appendEvent +
+ *     auto-waitForCatchup so memory.get() inside the same run sees the write.
+ *   - memory.get() → step.run wraps backend.getProjection. In-run cache
+ *     short-circuits repeated reads. Cache invalidates on append.
+ *   - memory.entityStream() — kept as NotImplementedError stub. Lands when a
+ *     concrete cross-agent peer-memory use case surfaces.
+ *
+ * Cross-run retry safety: append generates a deterministic idempotencyKey
+ * (`${runId}:memory.append:${counter}`) so a replayed handler appends the
+ * same logical event and the server dedupes server-side.
+ *
+ * Anti-scope: raw event replay is not exposed. Consumers must register a
+ * projection — see MemoryProjectionRequiredError.
+ */
+import type { AppendResult, ProjectionStateResult, StepClient } from "@ironflow/core";
+import type { MemoryClient, MemoryConfig } from "./types.js";
+/**
+ * Minimal backend the memory client needs. Wraps the IronflowClient surface
+ * so tests can substitute a fake without constructing a real client.
+ *
+ * Method shapes mirror the underlying client methods:
+ *   - appendEvent  → client.streams.append
+ *   - getProjection → client.projections.get
+ *   - waitForCatchup → client.projections.waitForCatchup
+ */
+export interface MemoryBackend {
+    appendEvent(streamId: string, input: {
+        name: string;
+        data: Record<string, unknown>;
+        entityType: string;
+        idempotencyKey: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<AppendResult>;
+    getProjection<TState = unknown>(name: string): Promise<ProjectionStateResult<TState>>;
+    waitForCatchup(name: string, opts: {
+        minSeq: number;
+        partition?: string;
+        timeoutMs?: number;
+    }): Promise<void>;
+}
+/**
+ * Per-run in-memory cache for memory.get() reads.
+ *
+ * Default cache-on; invalidates on memory.append() within the same run.
+ * Lives across step boundaries within a run, replaced fresh on replay.
+ */
+export interface MemoryRuntimeCache {
+    has: boolean;
+    value: unknown;
+}
+export declare function createMemoryRuntimeCache(): MemoryRuntimeCache;
+/**
+ * Tracks per-run append counter used for idempotency-key generation.
+ *
+ * Resets per run; replay on the same run reuses the counter value from
+ * the call ordering — same sequence of memory.append calls produces the
+ * same sequence of keys, so the server dedupes deterministically.
+ */
+export interface MemoryRuntimeCounters {
+    appendCount: number;
+}
+export declare function createMemoryRuntimeCounters(): MemoryRuntimeCounters;
+/**
+ * Build a MemoryClient backed by the supplied backend.
+ *
+ * The backend is required when `config` is set. Tests pass a fake backend;
+ * agent.ts constructs the default backend from a runtime IronflowClient.
+ */
+export declare function makeMemory(step: StepClient, config: MemoryConfig | undefined, runId: string, cache: MemoryRuntimeCache, backend: MemoryBackend | undefined, counters?: MemoryRuntimeCounters): MemoryClient;
+//# sourceMappingURL=memory.d.ts.map

package/dist/agent/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/agent/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,qBAAqB,EACrB,UAAU,EACX,MAAM,gBAAgB,CAAC;AAGxB,OAAO,KAAK,EAEV,YAAY,EACZ,YAAY,EAEb,MAAM,YAAY,CAAC;AAgCpB;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,CACT,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GACA,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB,aAAa,CAAC,MAAM,GAAG,OAAO,EAC5B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;IAE1C,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/D,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,2BAA2B,IAAI,qBAAqB,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,YAAY,GAAG,SAAS,EAChC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,aAAa,GAAG,SAAS,EAClC,QAAQ,GAAE,qBAAqD,GAC9D,YAAY,CA+Dd"}

package/dist/agent/memory.js

@@ -0,0 +1,130 @@
+/**
+ * memory() — durable agent memory backed by an entity stream + projection.
+ *
+ * Composition:
+ *   - memory.append(eventName, data) → step.run wraps backend.appendEvent +
+ *     auto-waitForCatchup so memory.get() inside the same run sees the write.
+ *   - memory.get() → step.run wraps backend.getProjection. In-run cache
+ *     short-circuits repeated reads. Cache invalidates on append.
+ *   - memory.entityStream() — kept as NotImplementedError stub. Lands when a
+ *     concrete cross-agent peer-memory use case surfaces.
+ *
+ * Cross-run retry safety: append generates a deterministic idempotencyKey
+ * (`${runId}:memory.append:${counter}`) so a replayed handler appends the
+ * same logical event and the server dedupes server-side.
+ *
+ * Anti-scope: raw event replay is not exposed. Consumers must register a
+ * projection — see MemoryProjectionRequiredError.
+ */
+import { IronflowError } from "@ironflow/core";
+import { MemoryProjectionRequiredError } from "./errors.js";
+/**
+ * Wait timeout for the auto-catchup after append. Stream-level minSeq is
+ * sufficient for read-your-writes — partition param is intentionally not
+ * passed. External projections (cursor at stream level only) reject
+ * partition with 400; managed projections accept it but it adds nothing
+ * for the typical single-stream agent memory pattern.
+ */
+const DEFAULT_WAIT_TIMEOUT_MS = 5000;
+/**
+ * Default entity type when MemoryConfig.entityType is omitted. Server-side
+ * the field is informational; "agent" matches the typical streamId convention
+ * and avoids surprising users who don't know about it.
+ */
+const DEFAULT_ENTITY_TYPE = "agent";
+class NotImplementedError extends IronflowError {
+    constructor(method) {
+        super(`memory.${method}() is not yet implemented — entityStream lands when a concrete cross-agent peer-memory use case surfaces`, {
+            code: "AGENT_MEMORY_NOT_IMPLEMENTED",
+            retryable: false,
+            details: { method },
+        });
+        this.name = "NotImplementedError";
+    }
+}
+export function createMemoryRuntimeCache() {
+    return { has: false, value: undefined };
+}
+export function createMemoryRuntimeCounters() {
+    return { appendCount: 0 };
+}
+/**
+ * Build a MemoryClient backed by the supplied backend.
+ *
+ * The backend is required when `config` is set. Tests pass a fake backend;
+ * agent.ts constructs the default backend from a runtime IronflowClient.
+ */
+export function makeMemory(step, config, runId, cache, backend, counters = createMemoryRuntimeCounters()) {
+    return {
+        async get(options) {
+            assertConfigured(config);
+            if (!options?.bypassCache && cache.has) {
+                return cache.value;
+            }
+            assertBackend(backend);
+            const result = await step.run("memory.get", () => backend.getProjection(config.projection));
+            const state = result.state ?? undefined;
+            cache.has = true;
+            cache.value = state;
+            return state;
+        },
+        async append(eventName, data, options) {
+            assertConfigured(config);
+            assertBackend(backend);
+            const dataRecord = toAppendRecord(data);
+            const counterIndex = counters.appendCount;
+            counters.appendCount += 1;
+            const idempotencyKey = `${runId}:memory.append:${counterIndex}`;
+            const appended = await step.run("memory.append", () => backend.appendEvent(config.streamId, {
+                name: eventName,
+                data: dataRecord,
+                entityType: config.entityType ?? DEFAULT_ENTITY_TYPE,
+                idempotencyKey,
+                metadata: options?.metadata,
+            }));
+            if (appended.sequence && appended.sequence > 0) {
+                await step.run("memory.append.wait", () => backend.waitForCatchup(config.projection, {
+                    minSeq: appended.sequence,
+                    timeoutMs: DEFAULT_WAIT_TIMEOUT_MS,
+                }));
+            }
+            cache.has = false;
+            cache.value = undefined;
+        },
+        async entityStream(streamId, projectionName) {
+            if (!projectionName) {
+                throw new MemoryProjectionRequiredError(streamId);
+            }
+            throw new NotImplementedError("entityStream");
+        },
+    };
+}
+function assertConfigured(config) {
+    if (!config) {
+        throw new IronflowError("memory() requires AgentConfig.memory ({ streamId, projection }) to be set", { code: "AGENT_MEMORY_UNCONFIGURED", retryable: false });
+    }
+}
+function assertBackend(backend) {
+    if (!backend) {
+        throw new IronflowError("memory() requires a runtime backend — set IRONFLOW_URL (or IRONFLOW_SERVER_URL) so the agent can construct an IronflowClient, or inject a backend via test harness", { code: "AGENT_MEMORY_NO_BACKEND", retryable: false });
+    }
+}
+/**
+ * Convert the user's data argument into the object shape AppendEvent expects.
+ *
+ * Rejects primitives, arrays, and null with a typed error rather than
+ * silently wrapping them in `{ value }`. The wrap-on-write would round-trip
+ * cleanly only if every projection reducer knows to unwrap it; rejecting
+ * up-front avoids the silent shape mismatch.
+ */
+function toAppendRecord(data) {
+    if (data === null || typeof data !== "object" || Array.isArray(data)) {
+        throw new IronflowError("memory.append() requires data to be a plain object — primitives and arrays must be wrapped explicitly so the projection reducer sees a stable shape", {
+            code: "AGENT_MEMORY_INVALID_DATA",
+            retryable: false,
+            details: { receivedType: data === null ? "null" : Array.isArray(data) ? "array" : typeof data },
+        });
+    }
+    return data;
+}
+//# sourceMappingURL=memory.js.map

package/dist/agent/memory.js.map

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

package/dist/agent/spawn.d.ts

@@ -0,0 +1,20 @@
+/**
+ * spawn() — durable sub-agent invocation.
+ *
+ * Wraps step.invoke (or step.invokeAsync for fire-and-forget) so the
+ * sub-agent run is part of the parent's durable plan. Crash-resume
+ * applies: re-running the parent after a crash replays the cached
+ * sub-agent output without re-invoking.
+ *
+ * Parent ↔ child run linkage is recorded server-side by the existing
+ * invoke implementation. spawn() doesn't add new linkage state.
+ */
+import type { StepClient } from "@ironflow/core";
+import type { SpawnFn } from "./types.js";
+/**
+ * Build a SpawnFn bound to the given step client.
+ *
+ * Exported for use by agent.ts; not part of the public API surface.
+ */
+export declare function makeSpawn(step: StepClient): SpawnFn;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/agent/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../src/agent/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAA6B,MAAM,YAAY,CAAC;AAErE;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAkBnD"}

package/dist/agent/spawn.js

@@ -0,0 +1,29 @@
+/**
+ * spawn() — durable sub-agent invocation.
+ *
+ * Wraps step.invoke (or step.invokeAsync for fire-and-forget) so the
+ * sub-agent run is part of the parent's durable plan. Crash-resume
+ * applies: re-running the parent after a crash replays the cached
+ * sub-agent output without re-invoking.
+ *
+ * Parent ↔ child run linkage is recorded server-side by the existing
+ * invoke implementation. spawn() doesn't add new linkage state.
+ */
+/**
+ * Build a SpawnFn bound to the given step client.
+ *
+ * Exported for use by agent.ts; not part of the public API surface.
+ */
+export function makeSpawn(step) {
+    return async function spawn(name, options) {
+        const stepName = `spawn.${name}`;
+        const shouldAwait = options.await !== false;
+        if (shouldAwait) {
+            const output = await step.invoke(options.functionId, options.input);
+            return { output };
+        }
+        const handle = await step.run(stepName, () => step.invokeAsync(options.functionId, options.input));
+        return { runId: handle.runId };
+    };
+}
+//# sourceMappingURL=spawn.js.map

package/dist/agent/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../../src/agent/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAgB;IACxC,OAAO,KAAK,UAAU,KAAK,CACzB,IAAY,EACZ,OAA6B;QAE7B,MAAM,QAAQ,GAAG,SAAS,IAAI,EAAE,CAAC;QACjC,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC;QAE5C,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAU,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YAC7E,OAAO,EAAE,MAAM,EAAE,CAAC;QACpB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,EAAE,CAC3C,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,CACpD,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IACjC,CAAC,CAAC;AACJ,CAAC"}

package/dist/agent/tool.d.ts

@@ -0,0 +1,39 @@
+/**
+ * tool() — durable, validated, idempotent tool invocation.
+ *
+ * Wraps step.run with:
+ *   - Required Zod input validation (per CEO plan, JS-only)
+ *   - Idempotency strategy: "byCall" (default) or "byArgs"
+ *   - Per-tool timeout (default 60s)
+ *
+ * defineTool() is a pass-through factory that preserves the input/output
+ * generic types for callers. The runtime call helper is constructed by
+ * makeTool() and bound onto AgentContext.tool.
+ */
+import type { StepClient } from "@ironflow/core";
+import type { AnyToolDefinition, ToolDefinition, ToolFn } from "./types.js";
+/**
+ * Per-run state shared by tool() invocations.
+ *
+ * byArgs idempotency reuses a single in-flight or resolved promise per
+ * (tool name, args hash) pair, so concurrent or repeat calls with the
+ * same args fold into one durable step.
+ */
+export interface ToolRuntime {
+    readonly byArgsCache: Map<string, Promise<unknown>>;
+}
+/**
+ * Define a tool. Pass-through factory that preserves the input/output
+ * generic types. Tools are typically registered via AgentConfig.tools so
+ * the agent can dispatch LLM-requested calls by name.
+ */
+export declare function defineTool<TInput, TOutput>(spec: ToolDefinition<TInput, TOutput>): ToolDefinition<TInput, TOutput>;
+/**
+ * Build a ToolFn closure bound to the given step client and tool registry.
+ *
+ * Exported for use by agent.ts; not part of the public API surface.
+ */
+export declare function makeTool(step: StepClient, registry: ReadonlyMap<string, AnyToolDefinition>, runtime: ToolRuntime): ToolFn;
+/** Construct an empty ToolRuntime. Used by agent() per run. */
+export declare function createToolRuntime(): ToolRuntime;
+//# sourceMappingURL=tool.d.ts.map

package/dist/agent/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/agent/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAK5E;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;CACrD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EACxC,IAAI,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAEjC;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAChD,OAAO,EAAE,WAAW,GACnB,MAAM,CASR;AAoFD,+DAA+D;AAC/D,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C"}

package/dist/agent/tool.js

@@ -0,0 +1,103 @@
+/**
+ * tool() — durable, validated, idempotent tool invocation.
+ *
+ * Wraps step.run with:
+ *   - Required Zod input validation (per CEO plan, JS-only)
+ *   - Idempotency strategy: "byCall" (default) or "byArgs"
+ *   - Per-tool timeout (default 60s)
+ *
+ * defineTool() is a pass-through factory that preserves the input/output
+ * generic types for callers. The runtime call helper is constructed by
+ * makeTool() and bound onto AgentContext.tool.
+ */
+import { createHash } from "node:crypto";
+import { ToolNotFoundError, ToolValidationError } from "./errors.js";
+import { normalizeDuration } from "./internal.js";
+/** Default per-tool timeout when the definition does not specify one. */
+const DEFAULT_TOOL_TIMEOUT = "60s";
+/**
+ * Define a tool. Pass-through factory that preserves the input/output
+ * generic types. Tools are typically registered via AgentConfig.tools so
+ * the agent can dispatch LLM-requested calls by name.
+ */
+export function defineTool(spec) {
+    return spec;
+}
+/**
+ * Build a ToolFn closure bound to the given step client and tool registry.
+ *
+ * Exported for use by agent.ts; not part of the public API surface.
+ */
+export function makeTool(step, registry, runtime) {
+    const tool = (async (defOrName, args) => {
+        const def = resolveDefinition(defOrName, registry);
+        return invokeTool(step, def, args, runtime);
+    });
+    return tool;
+}
+function resolveDefinition(defOrName, registry) {
+    if (typeof defOrName === "string") {
+        const found = registry.get(defOrName);
+        if (!found) {
+            throw new ToolNotFoundError(defOrName);
+        }
+        return found;
+    }
+    return defOrName;
+}
+async function invokeTool(step, def, args, runtime) {
+    const validated = validateInput(def, args);
+    const timeout = normalizeDuration(def.timeout) ?? DEFAULT_TOOL_TIMEOUT;
+    const idempotent = def.idempotent ?? "byCall";
+    if (idempotent === "byArgs") {
+        const hash = hashArgs(validated);
+        const cacheKey = `${def.name}:${hash}`;
+        const cached = runtime.byArgsCache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        const promise = step.run(`tool.${def.name}.${hash}`, () => def.handler(validated), { timeout });
+        runtime.byArgsCache.set(cacheKey, promise);
+        return promise;
+    }
+    return step.run(`tool.${def.name}`, () => def.handler(validated), { timeout });
+}
+function validateInput(def, args) {
+    const result = def.input.safeParse(args);
+    if (!result.success) {
+        throw new ToolValidationError(def.name, result.error.issues);
+    }
+    return result.data;
+}
+function hashArgs(args) {
+    const serialized = stableStringify(args);
+    return createHash("sha256").update(serialized).digest("hex").slice(0, 16);
+}
+/**
+ * Stable-key JSON stringify so { a: 1, b: 2 } and { b: 2, a: 1 } hash to
+ * the same value. Required for byArgs idempotency to behave intuitively
+ * across calls that build args from object spreads in different orders.
+ *
+ * Objects exposing toJSON() (Date, custom serializers) defer to the host
+ * JSON.stringify so different Dates do not collapse to the same hash.
+ */
+function stableStringify(value) {
+    if (value === null || typeof value !== "object") {
+        return JSON.stringify(value);
+    }
+    if (typeof value.toJSON === "function") {
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map(stableStringify).join(",")}]`;
+    }
+    const entries = Object.entries(value).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+    return `{${entries
+        .map(([k, v]) => `${JSON.stringify(k)}:${stableStringify(v)}`)
+        .join(",")}}`;
+}
+/** Construct an empty ToolRuntime. Used by agent() per run. */
+export function createToolRuntime() {
+    return { byArgsCache: new Map() };
+}
+//# sourceMappingURL=tool.js.map

package/dist/agent/tool.js.map

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