@nifrajs/agent 2.12.0

package/dist/index.js

@@ -0,0 +1,409 @@
+/**
+ * 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 { canAttempt } from "@nifrajs/core/budget";
+import { validateStandard } from "@nifrajs/core/schema";
+import { toCatalogEntry } from "@nifrajs/core/tool-catalog";
+import { executeTool, } from "@nifrajs/core/tool-contract";
+export { createLocalProcessAdapter, LOCAL_PROCESS_LIMITATION, LocalProcessPolicyError, } from "./execution-policy.js";
+export class MemoryAgentStateStore {
+    states = new Map();
+    load(turnId) {
+        return this.states.get(turnId);
+    }
+    save(state) {
+        this.states.set(state.turnId, freezeState(state));
+    }
+}
+export function createAgentState(turnId) {
+    if (!/^[a-zA-Z0-9._:-]{1,128}$/.test(turnId))
+        throw new TypeError("agent: turnId must be a bounded token");
+    return Object.freeze({
+        version: 1,
+        turnId,
+        step: 0,
+        status: "ready",
+        evidence: Object.freeze([]),
+    });
+}
+const AGENT_SETTLE_RESERVE_MS = 5;
+function costMilliseconds(cost) {
+    const value = cost?.ms;
+    return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : 0;
+}
+export async function turn(definition, state, input, ports) {
+    const signal = ports.signal ?? new AbortController().signal;
+    const clock = ports.clock ?? (() => performance.now());
+    const newId = ports.idFactory ?? (() => crypto.randomUUID());
+    const evidence = [...state.evidence];
+    const responses = [];
+    const add = async (kind, outcome, fields = {}) => {
+        const at = clock();
+        if (!Number.isFinite(at) || at < 0)
+            throw new TypeError("agent: clock must return a finite non-negative number");
+        const item = Object.freeze({ seq: evidence.length, at, kind, outcome, ...fields });
+        evidence.push(item);
+        await ports.telemetry?.step(item);
+        return item;
+    };
+    const save = async (next) => {
+        await ports.state?.save(next);
+    };
+    const suspended = async (next, pending, reason) => {
+        await add("state", "suspended", { effectId: pending.effectId, code: reason });
+        const saved = freezeState({
+            ...next,
+            status: "suspended",
+            pending: {
+                kind: pending.kind,
+                ...(pending.tool === undefined ? {} : { tool: pending.tool }),
+                effectId: pending.effectId,
+            },
+            evidence,
+        });
+        await save(saved);
+        return {
+            status: "suspended",
+            state: saved,
+            pending,
+            reason,
+            evidence: saved.evidence,
+            transcript: {
+                version: 1,
+                turnId: state.turnId,
+                responses: Object.freeze([...responses]),
+                evidence: saved.evidence,
+            },
+        };
+    };
+    const inputResult = await validateStandard(definition.input, input.value);
+    if (!inputResult.ok) {
+        await add("model", "failed", { code: "input_invalid" });
+        const saved = freezeState({ ...state, status: "completed", step: state.step + 1, evidence });
+        await save(saved);
+        return completedError(saved, responses, evidence, "input_invalid", inputResult.issues);
+    }
+    if (signal.aborted)
+        return suspended(state, { kind: "cancelled", effectId: newId() }, "cancelled");
+    if (state.status === "suspended") {
+        if (input.resume !== undefined) {
+            return resumeTool(definition, state, ports, input.resume, evidence, responses, add, save, suspended);
+        }
+        // Model failures and budget suspensions have no persisted payload to replay. Once the
+        // caller supplies a live signal/budget again, retry the model step from the token-only state.
+        // Tool suspensions retain no tool input in state, so they still require an explicit continuation.
+        if (state.pending?.tool === undefined)
+            state = readyState(state);
+        else
+            return suspended(state, {
+                kind: state.pending?.kind ?? "cancelled",
+                ...(state.pending?.tool === undefined ? {} : { tool: state.pending.tool }),
+                effectId: state.pending?.effectId ?? newId(),
+            }, state.pending?.kind ?? "cancelled");
+    }
+    const modelMs = costMilliseconds(definition.modelCost);
+    if (ports.deadline !== undefined &&
+        !canAttempt(ports.deadline, modelMs, AGENT_SETTLE_RESERVE_MS)) {
+        await add("budget", "denied", { code: "deadline_exceeded" });
+        return suspended(state, { kind: "budget", effectId: newId() }, "budget");
+    }
+    if (ports.budget !== undefined && !ports.budget.consume(definition.modelCost)) {
+        await add("budget", "denied", { code: "budget_exceeded" });
+        return suspended(state, { kind: "budget", effectId: newId() }, "budget");
+    }
+    await add("model", "started");
+    let response;
+    try {
+        const rawResponse = await ports.model.complete({
+            agent: definition.name,
+            instruction: definition.instruction,
+            input: inputResult.value,
+            state,
+            tools: definition.tools.map((tool) => toCatalogEntry(tool)),
+            ...(input.toolResult === undefined ? {} : { toolResult: input.toolResult }),
+            ...(input.previousOutput === undefined ? {} : { previousOutput: input.previousOutput }),
+            signal,
+            ...(ports.deadline === undefined
+                ? {}
+                : { deadline: ports.deadline.child(AGENT_SETTLE_RESERVE_MS) }),
+        });
+        response = parseModelResponse(rawResponse);
+    }
+    catch {
+        await add("model", "failed", { code: signal.aborted ? "cancelled" : "model_failed" });
+        return suspended(state, { kind: signal.aborted ? "cancelled" : "model", effectId: newId() }, signal.aborted ? "cancelled" : "model");
+    }
+    if (ports.deadline !== undefined && !canAttempt(ports.deadline, 0, AGENT_SETTLE_RESERVE_MS)) {
+        await add("budget", "denied", { code: "deadline_exceeded" });
+        return suspended(state, { kind: "budget", effectId: newId() }, "budget");
+    }
+    if (response === undefined) {
+        await add("model", "failed", { code: "invalid_model_response" });
+        return continueWithToolError(state, evidence, responses, { name: "model", ok: false, error: { code: "invalid_model_response", stage: "execution" } }, save);
+    }
+    responses.push(response);
+    if (response.kind === "output") {
+        const outputResult = await validateStandard(definition.output, response.value);
+        if (!outputResult.ok) {
+            await add("model", "failed", { code: "output_invalid" });
+            const saved = freezeState({ ...state, status: "completed", step: state.step + 1, evidence });
+            await save(saved);
+            return completedError(saved, responses, evidence, "output_invalid", outputResult.issues);
+        }
+        await add("model", "passed");
+        const saved = freezeState({ ...state, status: "completed", step: state.step + 1, evidence });
+        await save(saved);
+        return {
+            status: "completed",
+            output: outputResult.value,
+            state: saved,
+            evidence: saved.evidence,
+            transcript: {
+                version: 1,
+                turnId: state.turnId,
+                responses: Object.freeze([...responses]),
+                evidence: saved.evidence,
+            },
+        };
+    }
+    const tool = definition.tools.find((candidate) => candidate.name === response.name);
+    if (tool === undefined) {
+        await add("tool", "denied", { name: response.name, code: "unknown_tool" });
+        return continueWithToolError(state, evidence, responses, { name: response.name, ok: false, error: { code: "unknown_tool", stage: "execution" } }, save);
+    }
+    return executeToolStep(state, tool, response.input, ports, evidence, responses, add, save, suspended);
+}
+export async function runAgent(definition, input, ports, options) {
+    const maxTurns = options.maxTurns ?? 8;
+    if (!Number.isSafeInteger(maxTurns) || maxTurns < 1)
+        throw new RangeError("agent: maxTurns must be a positive safe integer");
+    let state = options.state;
+    let nextInput = input;
+    let last;
+    const recordedResponses = [];
+    for (let count = 0; count < maxTurns; count++) {
+        last = await turn(definition, state, nextInput, ports);
+        recordedResponses.push(...last.transcript.responses);
+        if (last.status === "completed") {
+            if (last.error !== undefined || options.goal === undefined || options.goal(last.output)) {
+                return withTranscript(last, recordedResponses);
+            }
+            state = readyState(last.state);
+            nextInput = { value: input.value, previousOutput: last.output };
+            continue;
+        }
+        if (last.status === "suspended")
+            return withTranscript(last, recordedResponses);
+        state = last.state;
+        nextInput = { value: input.value, toolResult: last.toolResult };
+    }
+    const fallback = last;
+    if (fallback === undefined)
+        throw new Error("agent: no turn was executed");
+    return {
+        status: "suspended",
+        reason: "max_turns",
+        pending: { kind: "cancelled", effectId: (ports.idFactory ?? (() => crypto.randomUUID()))() },
+        state: fallback.state,
+        evidence: fallback.evidence,
+        transcript: {
+            version: 1,
+            turnId: fallback.state.turnId,
+            responses: Object.freeze([...recordedResponses]),
+            evidence: fallback.evidence,
+        },
+    };
+}
+/** Load a saved token-only state record and continue a bounded run. */
+export async function resumeAgent(definition, turnId, input, ports, options = {}) {
+    if (ports.state === undefined)
+        throw new Error("agent: resume requires a state store");
+    const state = await ports.state.load(turnId);
+    if (state === undefined)
+        throw new Error("agent: no saved state for turn");
+    return runAgent(definition, input, ports, { ...options, state });
+}
+export async function replayAgent(definition, input, ports, transcript, options) {
+    let index = 0;
+    const model = {
+        complete: () => {
+            const response = transcript.responses[index++];
+            if (response === undefined)
+                throw new Error("agent replay: transcript ended before the model response");
+            return response;
+        },
+    };
+    return runAgent(definition, input, { ...ports, model, dryRun: true }, options);
+}
+async function executeToolStep(state, tool, input, ports, evidence, responses, add, save, suspended, effectIdOverride) {
+    const effectId = effectIdOverride ?? (ports.idFactory ?? (() => crypto.randomUUID()))();
+    const toolMs = costMilliseconds(tool.cost);
+    if (ports.deadline !== undefined &&
+        !canAttempt(ports.deadline, toolMs, AGENT_SETTLE_RESERVE_MS)) {
+        await add("budget", "denied", {
+            name: tool.name,
+            effectId,
+            code: "deadline_exceeded",
+        });
+        return suspended(state, { kind: "budget", tool: tool.name, input, effectId }, "budget");
+    }
+    let approval;
+    if (tool.approval.kind !== "none") {
+        if (ports.approval === undefined)
+            return suspended(state, { kind: "approval", tool: tool.name, input, effectId }, "approval");
+        const result = await ports.approval.request({
+            turnId: state.turnId,
+            effectId,
+            tool: tool.name,
+            capability: tool.capability,
+            signal: ports.signal ?? new AbortController().signal,
+            ...(ports.deadline === undefined
+                ? {}
+                : {
+                    deadline: ports.deadline.child(toolMs + AGENT_SETTLE_RESERVE_MS),
+                }),
+        });
+        if (result.status === "pending")
+            return suspended(state, { kind: "approval", tool: tool.name, input, effectId: result.effectId }, "approval");
+        if (result.status === "denied")
+            approval = {
+                granted: false,
+                ...(result.reason === undefined ? {} : { reason: result.reason }),
+            };
+        else
+            approval = result.approval;
+        await add("approval", result.status === "approved" ? "passed" : "denied", {
+            name: tool.name,
+            effectId,
+            ...(result.status === "denied" ? { code: "approval_denied" } : {}),
+        });
+    }
+    if (ports.deadline !== undefined &&
+        !canAttempt(ports.deadline, toolMs, AGENT_SETTLE_RESERVE_MS)) {
+        await add("budget", "denied", {
+            name: tool.name,
+            effectId,
+            code: "deadline_exceeded",
+        });
+        return suspended(state, { kind: "budget", tool: tool.name, input, effectId }, "budget");
+    }
+    const result = await executeTool(tool, input, {
+        effectId,
+        capabilities: ports.capabilities,
+        ...(approval === undefined ? {} : { approval }),
+        ...(ports.budget === undefined ? {} : { budget: ports.budget }),
+        ...(ports.idempotency === undefined ? {} : { idempotency: ports.idempotency }),
+        ...(ports.executionPolicy === undefined ? {} : { executionPolicy: ports.executionPolicy }),
+        ...(ports.signal === undefined ? {} : { signal: ports.signal }),
+        ...(ports.deadline === undefined
+            ? {}
+            : { deadline: ports.deadline.child(AGENT_SETTLE_RESERVE_MS) }),
+        ...(ports.dryRun === undefined ? {} : { dryRun: ports.dryRun }),
+        ...(ports.clock === undefined ? {} : { clock: ports.clock }),
+    });
+    const toolResult = toolResultOf(tool.name, result);
+    await add("tool", result.ok ? "committed" : "failed", {
+        name: tool.name,
+        effectId,
+        ...(result.ok ? {} : { code: result.error.code }),
+        ...(result.ledger.chain?.head === undefined ? {} : { ledgerHead: result.ledger.chain.head }),
+    });
+    if (!result.ok && result.error.code === "budget_exceeded") {
+        await add("budget", "denied", { name: tool.name, effectId, code: "budget_exceeded" });
+        return suspended(state, { kind: "budget", tool: tool.name, input, effectId }, "budget");
+    }
+    return continueWithToolError(state, evidence, responses, toolResult, save);
+}
+async function resumeTool(definition, state, ports, resume, evidence, responses, add, save, suspended) {
+    const tool = resume.continuation.tool === undefined
+        ? undefined
+        : definition.tools.find((candidate) => candidate.name === resume.continuation.tool);
+    if (tool === undefined || !Object.hasOwn(resume.continuation, "input"))
+        return continueWithToolError(state, evidence, responses, {
+            name: resume.continuation.tool ?? "unknown",
+            ok: false,
+            error: { code: "unknown_tool", stage: "execution" },
+        }, save);
+    const approvalPorts = resume.approval === undefined
+        ? ports
+        : {
+            ...ports,
+            approval: { request: () => ({ status: "approved", approval: resume.approval }) },
+        };
+    return executeToolStep({ ...state, status: "ready" }, tool, resume.continuation.input, approvalPorts, evidence, responses, add, save, suspended, resume.continuation.effectId);
+}
+async function continueWithToolError(state, evidence, responses, toolResult, save) {
+    const { pending: _pending, ...withoutPending } = state;
+    const next = freezeState({ ...withoutPending, status: "ready", step: state.step + 1, evidence });
+    await save(next);
+    return {
+        status: "continue",
+        state: next,
+        toolResult,
+        evidence: next.evidence,
+        transcript: {
+            version: 1,
+            turnId: state.turnId,
+            responses: Object.freeze([...responses]),
+            evidence: next.evidence,
+        },
+    };
+}
+function toolResultOf(name, result) {
+    return result.ok
+        ? { name, ok: true, ...(result.output === undefined ? {} : { output: result.output }) }
+        : { name, ok: false, error: result.error };
+}
+function completedError(state, responses, evidence, code, issues) {
+    return {
+        status: "completed",
+        error: { code, issues },
+        state,
+        evidence,
+        transcript: {
+            version: 1,
+            turnId: state.turnId,
+            responses: Object.freeze([...responses]),
+            evidence,
+        },
+    };
+}
+function parseModelResponse(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    const record = Object.fromEntries(Object.entries(value));
+    if (record.kind === "output" && Object.hasOwn(record, "value")) {
+        return Object.freeze({ kind: "output", value: record.value });
+    }
+    if (record.kind === "tool" && typeof record.name === "string" && Object.hasOwn(record, "input")) {
+        return Object.freeze({ kind: "tool", name: record.name, input: record.input });
+    }
+    return undefined;
+}
+function readyState(state) {
+    const { pending: _pending, ...withoutPending } = state;
+    return freezeState({ ...withoutPending, status: "ready" });
+}
+function withTranscript(result, responses) {
+    return {
+        ...result,
+        transcript: {
+            version: 1,
+            turnId: result.state.turnId,
+            responses: Object.freeze([...responses]),
+            evidence: result.evidence,
+        },
+    };
+}
+function freezeState(state) {
+    return Object.freeze({
+        ...state,
+        evidence: Object.freeze([...state.evidence]),
+        ...(state.pending === undefined ? {} : { pending: Object.freeze({ ...state.pending }) }),
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@nifrajs/agent",
+  "version": "2.12.0",
+  "description": "Provider-neutral, typed, resumable agent turns built on Nifra tool contracts.",
+  "keywords": [
+    "bun",
+    "typescript",
+    "nifra",
+    "ai-agent",
+    "agents",
+    "tools",
+    "replay"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./events": {
+      "bun": "./src/events.ts",
+      "types": "./dist/events.d.ts",
+      "default": "./dist/events.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && bun run ../../scripts/fix-dts.ts dist"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@nifrajs/core": "2.12.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nifrajs/nifra.git",
+    "directory": "packages/agent"
+  },
+  "bugs": {
+    "url": "https://github.com/nifrajs/nifra/issues"
+  },
+  "homepage": "https://github.com/nifrajs/nifra#readme"
+}

package/src/events.ts

@@ -0,0 +1,85 @@
+import type { AgentStepEvidence, AgentTelemetryPort } from "./index.ts"
+
+/** 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 function createAgentEvidenceStream(
+  options: AgentEvidenceStreamOptions = {},
+): AgentEvidenceStream {
+  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: AgentStepEvidence[] = []
+  const waiters: Array<(result: IteratorResult<AgentStepEvidence>) => void> = []
+  let completed = false
+  let dropped = 0
+
+  const finishWaiters = (): void => {
+    if (!completed || queue.length > 0) return
+    while (waiters.length > 0) waiters.shift()?.({ done: true, value: undefined })
+  }
+
+  const stream: AgentEvidenceStream = {
+    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<IteratorResult<AgentStepEvidence>>((resolve) => waiters.push(resolve))
+    },
+    return() {
+      queue.length = 0
+      completed = true
+      finishWaiters()
+      return Promise.resolve({ done: true, value: undefined })
+    },
+    [Symbol.asyncIterator]() {
+      return this
+    },
+  }
+  return stream
+}