@ironflow/node 0.20.0 → 0.20.2

package/dist/agent/llm.js

@@ -1,59 +0,0 @@
-/**
- * llm() — memoized completion sugar with classified error surface.
- *
- * The wrapper does not own a provider router. Callers pass a closure
- * (request.call) that talks to their provider of choice and returns a
- * normalized LLMCompleteResult. The wrapper:
- *
- *   1. Increments the agent turn counter and gates against maxTurns.
- *   2. Wraps the closure in step.run so the assistant response is
- *      memoized for crash-resume.
- *   3. Inspects result.finishReason to raise classified errors:
- *        "refusal"             → LLMRefusalError
- *        "max_tokens"/"length" → LLMMaxTokensError
- *      JSON-parse failures must be raised by the caller, by detecting
- *      invalid JSON in their closure and throwing LLMInvalidJSONError.
- *
- * Anti-scope: provider routing, prompt templating, and streaming all
- * stay out of this module. See module README.
- */
-import { LLMMaxTokensError, LLMRefusalError, MaxTurnsExceededError, } from "./errors.js";
-/** Construct a fresh turn counter. */
-export function createTurnCounter() {
-    return { value: 0 };
-}
-/**
- * Build an LLMClient bound to the given step + counter.
- *
- * Exported for use by agent.ts; not part of the public API surface.
- */
-export function makeLlm(step, counter, maxTurns) {
-    return {
-        async complete(request) {
-            counter.value += 1;
-            if (counter.value > maxTurns) {
-                throw new MaxTurnsExceededError(maxTurns);
-            }
-            const result = await step.run(`llm.turn`, () => request.call());
-            classifyResult(result);
-            return result;
-        },
-    };
-}
-function classifyResult(result) {
-    const reason = result.finishReason;
-    if (!reason)
-        return;
-    const normalized = reason.toLowerCase();
-    if (normalized === "refusal" || normalized === "safety" || normalized === "content_filter") {
-        throw new LLMRefusalError(`provider refused: ${reason}`, {
-            details: { finishReason: reason, metadata: result.metadata },
-        });
-    }
-    if (normalized === "max_tokens" || normalized === "length") {
-        throw new LLMMaxTokensError(`provider hit max_tokens (${reason})`, {
-            details: { finishReason: reason, metadata: result.metadata },
-        });
-    }
-}
-//# sourceMappingURL=llm.js.map

package/dist/agent/llm.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"llm.js","sourceRoot":"","sources":["../../src/agent/llm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAiBrB,sCAAsC;AACtC,MAAM,UAAU,iBAAiB;IAC/B,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CACrB,IAAgB,EAChB,OAAoB,EACpB,QAAgB;IAEhB,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,OAA2B;YACxC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;YACnB,IAAI,OAAO,CAAC,KAAK,GAAG,QAAQ,EAAE,CAAC;gBAC7B,MAAM,IAAI,qBAAqB,CAAC,QAAQ,CAAC,CAAC;YAC5C,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAChE,cAAc,CAAC,MAAM,CAAC,CAAC;YACvB,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,MAAyB;IAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC;IACnC,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACxC,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,gBAAgB,EAAE,CAAC;QAC3F,MAAM,IAAI,eAAe,CAAC,qBAAqB,MAAM,EAAE,EAAE;YACvD,OAAO,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;SAC7D,CAAC,CAAC;IACL,CAAC;IACD,IAAI,UAAU,KAAK,YAAY,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC3D,MAAM,IAAI,iBAAiB,CAAC,4BAA4B,MAAM,GAAG,EAAE;YACjE,OAAO,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;SAC7D,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/agent/mcp.d.ts

@@ -1,51 +0,0 @@
-/**
- * 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 type { ExposeMcpConfig } from "./types.js";
-/**
- * Handle returned from exposeMcp(). `unregister()` removes the tools
- * from both the Ironflow server's registry and the local SDK mirror.
- */
-export interface ExposeMcpHandle {
-    /** Server name (== agent namespace) reported to MCP clients. */
-    readonly name: string;
-    /** Number of tools registered with the server. */
-    readonly toolCount: number;
-    /** Status indicator. "active" once RegisterTool succeeds. */
-    readonly status: "active";
-    /** Qualified names registered (`{agentName}.{toolName}`). */
-    readonly toolNames: ReadonlyArray<string>;
-    /**
-     * Remove all tools registered under this agent name. Idempotent —
-     * server returns 200 with removed_count=0 if the agent was already
-     * gone. Local registry entries are cleared even if the server call
-     * fails so handler closures don't leak.
-     */
-    unregister(): Promise<void>;
-}
-/**
- * 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 declare function exposeMcp(config: ExposeMcpConfig): Promise<ExposeMcpHandle>;
-//# sourceMappingURL=mcp.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/agent/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AASH,OAAO,KAAK,EAAiB,eAAe,EAAE,MAAM,YAAY,CAAC;AAKjE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C;;;;;OAKG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAOD;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAmGjF"}

package/dist/agent/mcp.js

@@ -1,155 +0,0 @@
-/**
- * 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

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

package/dist/agent/memory.d.ts

@@ -1,74 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,130 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/agent/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAQ5D;;;;;;GAMG;AACH,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAErC;;;;GAIG;AACH,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAEpC,MAAM,mBAAoB,SAAQ,aAAa;IAC7C,YAAY,MAAc;QACxB,KAAK,CACH,UAAU,MAAM,0GAA0G,EAC1H;YACE,IAAI,EAAE,8BAA8B;YACpC,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,EAAE,MAAM,EAAE;SACpB,CACF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AA4CD,MAAM,UAAU,wBAAwB;IACtC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC1C,CAAC;AAaD,MAAM,UAAU,2BAA2B;IACzC,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CACxB,IAAgB,EAChB,MAAgC,EAChC,KAAa,EACb,KAAyB,EACzB,OAAkC,EAClC,WAAkC,2BAA2B,EAAE;IAE/D,OAAO;QACL,KAAK,CAAC,GAAG,CAAc,OAA0B;YAC/C,gBAAgB,CAAC,MAAM,CAAC,CAAC;YACzB,IAAI,CAAC,OAAO,EAAE,WAAW,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;gBACvC,OAAO,KAAK,CAAC,KAAsB,CAAC;YACtC,CAAC;YACD,aAAa,CAAC,OAAO,CAAC,CAAC;YACvB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,EAAE,CAC/C,OAAO,CAAC,aAAa,CAAI,MAAM,CAAC,UAAU,CAAC,CAC5C,CAAC;YACF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,SAAS,CAAC;YACxC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC;YACjB,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;YACpB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,CAAC,MAAM,CACV,SAAiB,EACjB,IAAO,EACP,OAA6B;YAE7B,gBAAgB,CAAC,MAAM,CAAC,CAAC;YACzB,aAAa,CAAC,OAAO,CAAC,CAAC;YAEvB,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;YACxC,MAAM,YAAY,GAAG,QAAQ,CAAC,WAAW,CAAC;YAC1C,QAAQ,CAAC,WAAW,IAAI,CAAC,CAAC;YAC1B,MAAM,cAAc,GAAG,GAAG,KAAK,kBAAkB,YAAY,EAAE,CAAC;YAEhE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,GAAG,EAAE,CACpD,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE;gBACnC,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,UAAU;gBAChB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,mBAAmB;gBACpD,cAAc;gBACd,QAAQ,EAAE,OAAO,EAAE,QAAQ;aAC5B,CAAC,CACH,CAAC;YAEF,IAAI,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;gBAC/C,MAAM,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,GAAG,EAAE,CACxC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,UAAU,EAAE;oBACxC,MAAM,EAAE,QAAQ,CAAC,QAAS;oBAC1B,SAAS,EAAE,uBAAuB;iBACnC,CAAC,CACH,CAAC;YACJ,CAAC;YAED,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC;YAClB,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC;QAC1B,CAAC;QAED,KAAK,CAAC,YAAY,CAChB,QAAgB,EAChB,cAAsB;YAEtB,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,MAAM,IAAI,6BAA6B,CAAC,QAAQ,CAAC,CAAC;YACpD,CAAC;YACD,MAAM,IAAI,mBAAmB,CAAC,cAAc,CAAC,CAAC;QAChD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAgC;IACxD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,aAAa,CACrB,2EAA2E,EAC3E,EAAE,IAAI,EAAE,2BAA2B,EAAE,SAAS,EAAE,KAAK,EAAE,CACxD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,OAAkC;IACvD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,aAAa,CACrB,oKAAoK,EACpK,EAAE,IAAI,EAAE,yBAAyB,EAAE,SAAS,EAAE,KAAK,EAAE,CACtD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,cAAc,CAAC,IAAa;IACnC,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,aAAa,CACrB,qJAAqJ,EACrJ;YACE,IAAI,EAAE,2BAA2B;YACjC,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,EAAE,YAAY,EAAE,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE;SAChG,CACF,CAAC;IACJ,CAAC;IACD,OAAO,IAA+B,CAAC;AACzC,CAAC"}

package/dist/agent/spawn.d.ts

@@ -1,20 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,29 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,39 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}