@nifrajs/agent 2.12.0

package/README.md

@@ -0,0 +1,26 @@
+# @nifrajs/agent
+
+Provider-neutral, typed, resumable agent turns over Nifra tool contracts.
+
+The package owns one bounded turn at a time. Model providers, state, approvals, budgets, idempotency,
+and telemetry are ports. The package never imports a model vendor and its state adapter stores only
+token-only turn evidence.
+
+```ts
+import { createAgentState, runAgent } from "@nifrajs/agent"
+
+const result = await runAgent(definition, { value: input }, ports, {
+  state: createAgentState("support-1"),
+  maxTurns: 8,
+})
+```
+
+The public in-memory adapters are for local development and tests. Durable state, provider
+credentials, and operated policy remain adapter concerns.
+
+Execution policies can be required by a tool contract. `createLocalProcessAdapter` applies cwd and
+environment filtering, timeouts, and cancellation to child processes. The local adapter is NOT a
+security boundary. Without OS-level sandboxing it contains crashes and accidents, not hostile code.
+
+For the compact agent contract, see [`LLM.md`](./LLM.md). The full machine-readable corpus is
+[`../../llms-full.txt`](../../llms-full.txt).

package/dist/events.d.ts

@@ -0,0 +1,23 @@
+import type { AgentStepEvidence, AgentTelemetryPort } from "./index.js";
+/** Options for the lifecycle evidence stream. */
+export interface AgentEvidenceStreamOptions {
+    /** Maximum number of produced evidence items waiting for a consumer. Default 1024. */
+    readonly maxQueueSize?: number;
+}
+/**
+ * The existing step evidence as an async iterable. No second event vocabulary is introduced.
+ *
+ * Pass the stream as `ports.telemetry`, consume it with `for await`, and call `complete()` when the
+ * runner finishes. The stream keeps queued evidence until it has been consumed, then terminates.
+ */
+export interface AgentEvidenceStream extends AgentTelemetryPort, AsyncIterableIterator<AgentStepEvidence> {
+    complete(): void;
+    /**
+     * How many evidence items the queue discarded because the consumer fell behind. Non-zero means the
+     * `seq` sequence has gaps; the turn result still carries the complete, authoritative evidence array.
+     */
+    readonly dropped: number;
+}
+/** Create an async iterable that yields the exact evidence values received by `step`. */
+export declare function createAgentEvidenceStream(options?: AgentEvidenceStreamOptions): AgentEvidenceStream;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEvE,iDAAiD;AACjD,MAAM,WAAW,0BAA0B;IACzC,sFAAsF;IACtF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBACf,SAAQ,kBAAkB,EACxB,qBAAqB,CAAC,iBAAiB,CAAC;IAC1C,QAAQ,IAAI,IAAI,CAAA;IAChB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,yFAAyF;AACzF,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,0BAA+B,GACvC,mBAAmB,CAwDrB"}

package/dist/events.js

@@ -0,0 +1,61 @@
+/** Create an async iterable that yields the exact evidence values received by `step`. */
+export function createAgentEvidenceStream(options = {}) {
+    const maxQueueSize = options.maxQueueSize ?? 1024;
+    if (!Number.isSafeInteger(maxQueueSize) || maxQueueSize < 1)
+        throw new RangeError("agent evidence stream: maxQueueSize must be a positive safe integer");
+    const queue = [];
+    const waiters = [];
+    let completed = false;
+    let dropped = 0;
+    const finishWaiters = () => {
+        if (!completed || queue.length > 0)
+            return;
+        while (waiters.length > 0)
+            waiters.shift()?.({ done: true, value: undefined });
+    };
+    const stream = {
+        get dropped() {
+            return dropped;
+        },
+        step(evidence) {
+            if (completed)
+                return;
+            const waiter = waiters.shift();
+            if (waiter !== undefined) {
+                waiter({ done: false, value: evidence });
+                return;
+            }
+            // A consumer that stopped reading (a closed SSE connection is the common one) must never fail
+            // the turn it is observing. The queue is a live view; the authoritative evidence is returned by
+            // the runner either way, so the oldest item is discarded and counted instead of thrown.
+            if (queue.length >= maxQueueSize) {
+                queue.shift();
+                dropped += 1;
+            }
+            queue.push(evidence);
+        },
+        complete() {
+            completed = true;
+            finishWaiters();
+        },
+        next() {
+            const evidence = queue.shift();
+            if (evidence !== undefined)
+                return Promise.resolve({ done: false, value: evidence });
+            if (completed)
+                return Promise.resolve({ done: true, value: undefined });
+            return new Promise((resolve) => waiters.push(resolve));
+        },
+        return() {
+            queue.length = 0;
+            completed = true;
+            finishWaiters();
+            return Promise.resolve({ done: true, value: undefined });
+        },
+        [Symbol.asyncIterator]() {
+            return this;
+        },
+    };
+    return stream;
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAyBA,yFAAyF;AACzF,MAAM,UAAU,yBAAyB,CACvC,UAAsC,EAAE;IAExC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,IAAI,CAAA;IACjD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,IAAI,YAAY,GAAG,CAAC;QACzD,MAAM,IAAI,UAAU,CAAC,qEAAqE,CAAC,CAAA;IAE7F,MAAM,KAAK,GAAwB,EAAE,CAAA;IACrC,MAAM,OAAO,GAA+D,EAAE,CAAA;IAC9E,IAAI,SAAS,GAAG,KAAK,CAAA;IACrB,IAAI,OAAO,GAAG,CAAC,CAAA;IAEf,MAAM,aAAa,GAAG,GAAS,EAAE;QAC/B,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAM;QAC1C,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;IAChF,CAAC,CAAA;IAED,MAAM,MAAM,GAAwB;QAClC,IAAI,OAAO;YACT,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,IAAI,CAAC,QAAQ;YACX,IAAI,SAAS;gBAAE,OAAM;YACrB,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAA;YAC9B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;gBACxC,OAAM;YACR,CAAC;YACD,8FAA8F;YAC9F,gGAAgG;YAChG,wFAAwF;YACxF,IAAI,KAAK,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC;gBACjC,KAAK,CAAC,KAAK,EAAE,CAAA;gBACb,OAAO,IAAI,CAAC,CAAA;YACd,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACtB,CAAC;QACD,QAAQ;YACN,SAAS,GAAG,IAAI,CAAA;YAChB,aAAa,EAAE,CAAA;QACjB,CAAC;QACD,IAAI;YACF,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,EAAE,CAAA;YAC9B,IAAI,QAAQ,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;YACpF,IAAI,SAAS;gBAAE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;YACvE,OAAO,IAAI,OAAO,CAAoC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;QAC3F,CAAC;QACD,MAAM;YACJ,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;YAChB,SAAS,GAAG,IAAI,CAAA;YAChB,aAAa,EAAE,CAAA;YACf,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;QAC1D,CAAC;QACD,CAAC,MAAM,CAAC,aAAa,CAAC;YACpB,OAAO,IAAI,CAAA;QACb,CAAC;KACF,CAAA;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/execution-policy.d.ts

@@ -0,0 +1,43 @@
+import { defineExecutionPolicy, type ExecutionPolicy, type ExecutionPolicyAdapter } from "@nifrajs/core/execution-policy";
+/** This statement is intentionally repeated in the API and runtime result. */
+export declare const LOCAL_PROCESS_LIMITATION = "The local adapter is NOT a security boundary.";
+export interface LocalProcessAdapterOptions {
+    readonly cwd?: string;
+    /** Only these inherited environment names are copied. Default: PATH, LANG, and LC_ALL. */
+    readonly envAllowlist?: readonly string[];
+    readonly maxOutputBytes?: number;
+}
+export interface LocalProcessRequest {
+    readonly command: string;
+    readonly args?: readonly string[];
+    readonly cwd?: string;
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    readonly capability?: string;
+    readonly policy: ExecutionPolicy;
+    readonly signal?: AbortSignal;
+}
+export interface LocalProcessResult {
+    readonly ok: boolean;
+    readonly exitCode: number | null;
+    readonly signal?: string;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly timedOut: boolean;
+    readonly cancelled: boolean;
+    readonly limitations: readonly string[];
+}
+export declare class LocalProcessPolicyError extends Error {
+    readonly code: "policy_unsatisfied" | "invalid_request" | "cancelled";
+    constructor(code: "policy_unsatisfied" | "invalid_request" | "cancelled");
+}
+export interface LocalProcessAdapter extends ExecutionPolicyAdapter {
+    run(request: LocalProcessRequest): Promise<LocalProcessResult>;
+}
+/**
+ * Run a command with the host controls available to a normal child process. The local adapter is NOT
+ * a security boundary. Without OS-level sandboxing it contains crashes and accidents, not hostile code.
+ */
+export declare function createLocalProcessAdapter(options?: LocalProcessAdapterOptions): LocalProcessAdapter;
+export type { ExecutionPolicy, ExecutionPolicyAdapter };
+export { defineExecutionPolicy };
+//# sourceMappingURL=execution-policy.d.ts.map

package/dist/execution-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-policy.d.ts","sourceRoot":"","sources":["../src/execution-policy.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC5B,MAAM,gCAAgC,CAAA;AAEvC,8EAA8E;AAC9E,eAAO,MAAM,wBAAwB,kDAAkD,CAAA;AAIvF,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,0FAA0F;IAC1F,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACzC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAA;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;CACxC;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,GAAG,iBAAiB,GAAG,WAAW;gBAA5D,IAAI,EAAE,oBAAoB,GAAG,iBAAiB,GAAG,WAAW;CAIlF;AAED,MAAM,WAAW,mBAAoB,SAAQ,sBAAsB;IACjE,GAAG,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;CAC/D;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,0BAA+B,GACvC,mBAAmB,CAuErB;AA8GD,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,CAAA;AACvD,OAAO,EAAE,qBAAqB,EAAE,CAAA"}

package/dist/execution-policy.js

@@ -0,0 +1,185 @@
+import { spawn } from "node:child_process";
+import { isAbsolute, relative, resolve, sep } from "node:path";
+import { defineExecutionPolicy, } from "@nifrajs/core/execution-policy";
+/** This statement is intentionally repeated in the API and runtime result. */
+export const LOCAL_PROCESS_LIMITATION = "The local adapter is NOT a security boundary.";
+const SIGKILL_GRACE_MS = 2000;
+export class LocalProcessPolicyError extends Error {
+    code;
+    constructor(code) {
+        super(`local process: ${code}. ${LOCAL_PROCESS_LIMITATION}`);
+        this.code = code;
+        this.name = "LocalProcessPolicyError";
+    }
+}
+/**
+ * Run a command with the host controls available to a normal child process. The local adapter is NOT
+ * a security boundary. Without OS-level sandboxing it contains crashes and accidents, not hostile code.
+ */
+export function createLocalProcessAdapter(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const allowlist = new Set(options.envAllowlist ?? ["PATH", "LANG", "LC_ALL"]);
+    const maxOutputBytes = options.maxOutputBytes ?? 1024 * 1024;
+    if (!Number.isSafeInteger(maxOutputBytes) || maxOutputBytes < 1) {
+        throw new RangeError("local process: maxOutputBytes must be a positive safe integer");
+    }
+    const adapter = {
+        name: "local-process",
+        canSatisfy(policyInput) {
+            const policy = defineExecutionPolicy(policyInput);
+            return (policy.filesystem === "cwd" &&
+                policy.network === "allow" &&
+                policy.capabilityCeiling.length > 0);
+        },
+        limitations(policyInput) {
+            const policy = defineExecutionPolicy(policyInput);
+            const limitations = [LOCAL_PROCESS_LIMITATION];
+            if (policy.filesystem !== "cwd")
+                limitations.push("filesystem-scope-not-enforced");
+            if (policy.network === "deny")
+                limitations.push("network-denial-not-enforced");
+            limitations.push("capability-ceiling-is-admission-only");
+            return Object.freeze(limitations);
+        },
+        async run(request) {
+            const policy = defineExecutionPolicy(request.policy);
+            if (typeof request.command !== "string" ||
+                request.command.trim() === "" ||
+                request.args?.some((arg) => typeof arg !== "string")) {
+                throw new LocalProcessPolicyError("invalid_request");
+            }
+            if (!(await adapter.canSatisfy(policy)))
+                throw new LocalProcessPolicyError("policy_unsatisfied");
+            if (request.capability !== undefined &&
+                !policy.capabilityCeiling.includes(request.capability)) {
+                throw new LocalProcessPolicyError("policy_unsatisfied");
+            }
+            if (request.signal?.aborted === true)
+                throw new LocalProcessPolicyError("cancelled");
+            const processCwd = resolve(cwd, request.cwd ?? ".");
+            if (policy.filesystem === "cwd" && !isWithin(processCwd, cwd))
+                throw new LocalProcessPolicyError("policy_unsatisfied");
+            const env = filteredEnv(request.env ?? {});
+            return spawnProcess({
+                command: request.command,
+                args: request.args ?? [],
+                cwd: processCwd,
+                env,
+                policy,
+                ...(request.signal === undefined ? {} : { signal: request.signal }),
+                maxOutputBytes,
+                limitations: adapter.limitations(policy),
+            });
+        },
+    };
+    return Object.freeze(adapter);
+    function filteredEnv(values) {
+        const result = {};
+        for (const name of allowlist) {
+            const value = values[name] ?? process.env[name];
+            if (value !== undefined)
+                result[name] = value;
+        }
+        return result;
+    }
+}
+function isWithin(path, root) {
+    const resolvedPath = resolve(path);
+    const resolvedRoot = resolve(root);
+    const distance = relative(resolvedRoot, resolvedPath);
+    return (distance === "" ||
+        (distance !== ".." && !distance.startsWith(`..${sep}`) && !isAbsolute(distance)));
+}
+function spawnProcess(input) {
+    return new Promise((resolve, reject) => {
+        let child;
+        try {
+            child = spawn(input.command, [...input.args], {
+                cwd: input.cwd,
+                env: input.env,
+                shell: false,
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+        }
+        catch {
+            reject(new LocalProcessPolicyError("invalid_request"));
+            return;
+        }
+        const stdout = [];
+        const stderr = [];
+        let timedOut = false;
+        let cancelled = false;
+        let settled = false;
+        const outputUsed = { value: 0 };
+        const append = (target, chunk) => {
+            const remaining = input.maxOutputBytes - outputUsed.value;
+            if (remaining <= 0)
+                return;
+            const selected = chunk.byteLength <= remaining ? chunk : chunk.slice(0, remaining);
+            target.push(selected);
+            outputUsed.value += selected.byteLength;
+        };
+        if (child.stdout === null || child.stderr === null) {
+            child.kill();
+            reject(new LocalProcessPolicyError("invalid_request"));
+            return;
+        }
+        child.stdout.on("data", (chunk) => append(stdout, chunk));
+        child.stderr.on("data", (chunk) => append(stderr, chunk));
+        let killTimer;
+        const terminate = () => {
+            child.kill("SIGTERM");
+            // A child that ignores SIGTERM would otherwise leave this promise pending forever,
+            // making policy.timeMs advisory instead of a bound.
+            killTimer ??= setTimeout(() => child.kill("SIGKILL"), SIGKILL_GRACE_MS);
+        };
+        const timer = setTimeout(() => {
+            timedOut = true;
+            terminate();
+        }, input.policy.timeMs);
+        const cancel = () => {
+            cancelled = true;
+            terminate();
+        };
+        input.signal?.addEventListener("abort", cancel, { once: true });
+        child.once("error", () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            if (killTimer !== undefined)
+                clearTimeout(killTimer);
+            reject(new LocalProcessPolicyError("invalid_request"));
+        });
+        child.once("close", (exitCode, signal) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            if (killTimer !== undefined)
+                clearTimeout(killTimer);
+            resolve({
+                ok: !timedOut && !cancelled && exitCode === 0,
+                exitCode,
+                ...(signal === null ? {} : { signal }),
+                stdout: new TextDecoder().decode(concat(stdout)),
+                stderr: new TextDecoder().decode(concat(stderr)),
+                timedOut,
+                cancelled,
+                limitations: input.limitations,
+            });
+        });
+    });
+}
+function concat(chunks) {
+    const size = chunks.reduce((total, chunk) => total + chunk.byteLength, 0);
+    const result = new Uint8Array(size);
+    let offset = 0;
+    for (const chunk of chunks) {
+        result.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return result;
+}
+export { defineExecutionPolicy };
+//# sourceMappingURL=execution-policy.js.map

package/dist/execution-policy.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,199 @@
+/**
+ * Provider-neutral agent turns.
+ *
+ * One turn makes one model decision and may execute one {@link ToolContract}. The multi-turn runner
+ * is intentionally bounded. The state adapter stores token-only evidence and cursor metadata; model
+ * input, tool input, and tool output remain transient caller data.
+ */
+import { type RequestBudget } from "@nifrajs/core/budget";
+import type { ExecutionPolicyAdapter } from "@nifrajs/core/execution-policy";
+import type { EffectCost } from "@nifrajs/core/ledger";
+import { type StandardIssue, type StandardSchemaV1 } from "@nifrajs/core/schema";
+import { type ToolCatalogEntry } from "@nifrajs/core/tool-catalog";
+import { type ToolApproval, type ToolBudget, type ToolContract, type ToolError, type ToolIdempotencyStore } from "@nifrajs/core/tool-contract";
+export { createLocalProcessAdapter, type ExecutionPolicy, type ExecutionPolicyAdapter, LOCAL_PROCESS_LIMITATION, type LocalProcessAdapter, type LocalProcessAdapterOptions, LocalProcessPolicyError, type LocalProcessRequest, type LocalProcessResult, } from "./execution-policy.js";
+export type AgentStatus = "continue" | "completed" | "suspended";
+export type AgentPendingKind = "approval" | "budget" | "model" | "cancelled";
+export interface AgentDefinition<InputSchema extends StandardSchemaV1, OutputSchema extends StandardSchemaV1> {
+    readonly name: string;
+    readonly instruction: string;
+    readonly input: InputSchema;
+    readonly output: OutputSchema;
+    readonly tools: readonly AgentToolContract[];
+    /** Dimensionless counters charged once per model decision. */
+    readonly modelCost?: EffectCost;
+}
+/** Heterogeneous tool collection used by an agent definition. Runtime schemas remain authoritative. */
+export type AgentToolContract = ToolContract<any, any>;
+/** The model-facing descriptor is the complete descriptive catalog entry. */
+export type AgentToolDescriptor = ToolCatalogEntry;
+export interface AgentTurnState {
+    readonly version: 1;
+    readonly turnId: string;
+    readonly step: number;
+    readonly status: "ready" | "suspended" | "completed";
+    readonly evidence: readonly AgentStepEvidence[];
+    readonly pending?: {
+        readonly kind: AgentPendingKind;
+        readonly tool?: string;
+        readonly effectId: string;
+    };
+}
+export interface AgentStepEvidence {
+    readonly seq: number;
+    readonly at: number;
+    readonly kind: "model" | "tool" | "approval" | "budget" | "state";
+    readonly outcome: "started" | "passed" | "failed" | "denied" | "suspended" | "committed";
+    readonly name?: string;
+    readonly effectId?: string;
+    readonly code?: string;
+    readonly ledgerHead?: string;
+}
+export interface AgentModelRequest {
+    readonly agent: string;
+    readonly instruction: string;
+    readonly input: unknown;
+    readonly state: AgentTurnState;
+    readonly tools: readonly AgentToolDescriptor[];
+    readonly toolResult?: AgentToolResult;
+    readonly previousOutput?: unknown;
+    readonly signal: AbortSignal;
+    /** Wall-clock budget shared with the parent request. Use withDeadlineHeader for outbound requests. */
+    readonly deadline?: RequestBudget;
+}
+export type AgentModelResponse = {
+    readonly kind: "output";
+    readonly value: unknown;
+} | {
+    readonly kind: "tool";
+    readonly name: string;
+    readonly input: unknown;
+};
+export interface AgentModelPort {
+    /** Provider output is unknown until the response parser accepts it. */
+    complete(request: AgentModelRequest): unknown | PromiseLike<unknown>;
+}
+export interface AgentToolResult {
+    readonly name: string;
+    readonly ok: boolean;
+    readonly output?: unknown;
+    readonly error?: ToolError | {
+        readonly code: "unknown_tool" | "invalid_model_response";
+        readonly stage: "execution";
+    };
+}
+export interface AgentPendingContinuation {
+    readonly kind: AgentPendingKind;
+    readonly tool?: string;
+    readonly input?: unknown;
+    readonly effectId: string;
+}
+export type AgentApprovalResult = {
+    readonly status: "approved";
+    readonly approval: ToolApproval;
+} | {
+    readonly status: "denied";
+    readonly reason?: string;
+} | {
+    readonly status: "pending";
+    readonly effectId: string;
+};
+export interface AgentApprovalPort {
+    request(input: {
+        readonly turnId: string;
+        readonly effectId: string;
+        readonly tool: string;
+        readonly capability: string;
+        readonly signal: AbortSignal;
+        /** Wall-clock budget reserved for this approval hop and the following tool execution. */
+        readonly deadline?: RequestBudget;
+    }): AgentApprovalResult | PromiseLike<AgentApprovalResult>;
+}
+export interface AgentStateStore {
+    load(turnId: string): AgentTurnState | undefined | PromiseLike<AgentTurnState | undefined>;
+    save(state: AgentTurnState): void | PromiseLike<void>;
+}
+export declare class MemoryAgentStateStore implements AgentStateStore {
+    private readonly states;
+    load(turnId: string): AgentTurnState | undefined;
+    save(state: AgentTurnState): void;
+}
+export interface AgentTelemetryPort {
+    step(evidence: AgentStepEvidence): void | PromiseLike<void>;
+}
+export interface AgentPorts {
+    readonly model: AgentModelPort;
+    readonly capabilities: readonly string[];
+    readonly budget?: ToolBudget;
+    /** Wall-clock budget shared with the parent request. Distinct from `budget`, which is cost. */
+    readonly deadline?: RequestBudget;
+    readonly idempotency?: ToolIdempotencyStore;
+    readonly state?: AgentStateStore;
+    readonly approval?: AgentApprovalPort;
+    readonly telemetry?: AgentTelemetryPort;
+    readonly clock?: () => number;
+    /** Adapter used to satisfy execution policies declared by tool contracts. */
+    readonly executionPolicy?: ExecutionPolicyAdapter;
+    /** Injectable token generator for deterministic replay and tests. */
+    readonly idFactory?: () => string;
+    readonly signal?: AbortSignal;
+    /** Replay mode skips every tool executor and marks the call dry-run. */
+    readonly dryRun?: boolean;
+}
+export interface AgentTurnInput {
+    readonly value: unknown;
+    readonly toolResult?: AgentToolResult;
+    readonly previousOutput?: unknown;
+    readonly resume?: {
+        readonly continuation: AgentPendingContinuation;
+        readonly approval?: ToolApproval;
+    };
+}
+export interface AgentTurnBaseResult {
+    readonly state: AgentTurnState;
+    readonly evidence: readonly AgentStepEvidence[];
+    readonly transcript: AgentTranscript;
+}
+export interface AgentTurnError {
+    readonly code: "input_invalid" | "output_invalid" | "model_failed";
+    readonly issues?: readonly StandardIssue[];
+}
+export type AgentTurnResult<Output> = (AgentTurnBaseResult & {
+    readonly status: "completed";
+    readonly output: Output;
+    readonly error?: never;
+}) | (AgentTurnBaseResult & {
+    readonly status: "completed";
+    readonly error: AgentTurnError;
+    readonly output?: never;
+}) | (AgentTurnBaseResult & {
+    readonly status: "continue";
+    readonly toolResult: AgentToolResult;
+}) | (AgentTurnBaseResult & {
+    readonly status: "suspended";
+    readonly pending: AgentPendingContinuation;
+    readonly reason: "approval" | "budget" | "model" | "cancelled";
+});
+export interface AgentTranscript {
+    readonly version: 1;
+    readonly turnId: string;
+    readonly responses: readonly AgentModelResponse[];
+    readonly evidence: readonly AgentStepEvidence[];
+}
+export interface RunAgentOptions {
+    readonly state: AgentTurnState;
+    readonly maxTurns?: number;
+    readonly goal?: (output: unknown) => boolean;
+}
+export type AgentRunResult<Output> = AgentTurnResult<Output> | (AgentTurnBaseResult & {
+    readonly status: "suspended";
+    readonly pending: AgentPendingContinuation;
+    readonly reason: "max_turns";
+});
+export declare function createAgentState(turnId: string): AgentTurnState;
+export declare function turn<InputSchema extends StandardSchemaV1, OutputSchema extends StandardSchemaV1>(definition: AgentDefinition<InputSchema, OutputSchema>, state: AgentTurnState, input: AgentTurnInput, ports: AgentPorts): Promise<AgentTurnResult<NonNullable<OutputSchema["~standard"]["types"]>["output"]>>;
+export declare function runAgent<InputSchema extends StandardSchemaV1, OutputSchema extends StandardSchemaV1>(definition: AgentDefinition<InputSchema, OutputSchema>, input: AgentTurnInput, ports: AgentPorts, options: RunAgentOptions): Promise<AgentRunResult<NonNullable<OutputSchema["~standard"]["types"]>["output"]>>;
+/** Load a saved token-only state record and continue a bounded run. */
+export declare function resumeAgent<InputSchema extends StandardSchemaV1, OutputSchema extends StandardSchemaV1>(definition: AgentDefinition<InputSchema, OutputSchema>, turnId: string, input: AgentTurnInput, ports: AgentPorts, options?: Omit<RunAgentOptions, "state">): Promise<AgentRunResult<NonNullable<OutputSchema["~standard"]["types"]>["output"]>>;
+export declare function replayAgent<InputSchema extends StandardSchemaV1, OutputSchema extends StandardSchemaV1>(definition: AgentDefinition<InputSchema, OutputSchema>, input: AgentTurnInput, ports: Omit<AgentPorts, "model">, transcript: AgentTranscript, options: RunAgentOptions): Promise<AgentRunResult<NonNullable<OutputSchema["~standard"]["types"]>["output"]>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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