@arden-hq/loop 0.0.0-stage → 0.1.0

package/dist/agent/streaming-tools.js

@@ -0,0 +1,67 @@
+import { canRunInBackground, mayEndTurn } from "../contracts/tools.js";
+import { admitToolCalls, loadDeferredCalls } from "./tool-admission.js";
+import { hookCall } from "./guards.js";
+export const isBackgroundCall = (call, meta, mode) => call.argumentError === undefined &&
+    meta?.background === true &&
+    canRunInBackground(meta) &&
+    (mode === "message" || call.toolCall.async === true);
+export class StreamingTools {
+    options;
+    ids = new Set();
+    pending = [];
+    constructor(options) {
+        this.options = options;
+    }
+    async start(raw, checkpoint) {
+        const { run, view } = this.options;
+        const meta = view.metas.get(raw.function.name);
+        if (mayEndTurn(meta) || this.ids.has(raw.id) || !(await this.options.canStart()))
+            return;
+        const { calls, deferredNames } = admitToolCalls({
+            rawCalls: [raw],
+            view,
+            displayTitle: run.wiring.toolset.displayTitle
+        });
+        const call = calls[0];
+        if (call === undefined)
+            return;
+        if (!(await run.budget.reserveToolCalls(1, run.wiring.config.maxToolCalls)))
+            return;
+        await loadDeferredCalls({
+            calls,
+            deferredNames,
+            load: (names) => run.wiring.toolset.load(names)
+        });
+        await checkpoint();
+        this.ids.add(raw.id);
+        if (isBackgroundCall(call, meta, view.asyncMode)) {
+            const output = await run.background.launch({
+                calls: [call],
+                metas: view.metas,
+                mode: view.asyncMode
+            });
+            if (output.completions.length > 0 || output.paused.length > 0)
+                this.pending.push(Promise.resolve({ kind: "completed", output, messages: [] }));
+            return;
+        }
+        const isolated = [...run.messages];
+        const offset = isolated.length;
+        this.pending.push(this.options.execute(call, isolated).then((output) => ({ kind: "completed", output, messages: isolated.slice(offset) }), (cause) => ({ kind: "failed", cause })));
+    }
+    async settle() {
+        const completions = [];
+        const paused = [];
+        for (const pending of this.pending) {
+            const settled = await pending;
+            if (settled.kind === "failed")
+                throw settled.cause;
+            this.options.run.messages.push(...settled.messages);
+            completions.push(...settled.output.completions);
+            paused.push(...settled.output.paused);
+        }
+        if (this.pending.length > 0)
+            await this.options.run.history.checkpoint((messages, change) => hookCall("onCheckpoint", () => this.options.run.wiring.hooks.onCheckpoint?.(messages, change)));
+        return { ids: this.ids, output: { completions, paused } };
+    }
+}
+//# sourceMappingURL=streaming-tools.js.map

package/dist/agent/streaming-tools.js.map

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

package/dist/agent/structured-output.d.ts

@@ -0,0 +1,27 @@
+import type { StandardSchemaV1 } from "../contracts/messages.js";
+import type { JsonSchemaConverter } from "../tools/tool.js";
+/**
+ * Structured output for one invocation. The JSON-Schema response format is
+ * carried to the provider on every model request of the run (a format only
+ * constrains emitted text, so tool-calling turns are unaffected); validation
+ * applies to the FINAL text turn only. On validation failure the loop makes
+ * ONE correction retry — a user message quoting the issues, then a re-run of
+ * the final turn — before failing with `StructuredOutputError`.
+ */
+export interface AgentOutputOptions {
+    readonly schema: StandardSchemaV1;
+    /** Host-supplied Standard-Schema→JSON-Schema conversion (e.g. `z.toJSONSchema`). */
+    readonly toJsonSchema: JsonSchemaConverter;
+    /** Provider-facing schema name (default "output"). */
+    readonly name?: string;
+}
+export declare const formatIssues: (issues: ReadonlyArray<StandardSchemaV1.Issue>) => string;
+export declare const correctionContent: (issues: ReadonlyArray<StandardSchemaV1.Issue>) => string;
+type OutputValidation = {
+    readonly value: unknown;
+} | {
+    readonly issues: ReadonlyArray<StandardSchemaV1.Issue>;
+};
+export declare const validateOutputText: (schema: StandardSchemaV1, text: string) => Promise<OutputValidation>;
+export {};
+//# sourceMappingURL=structured-output.d.ts.map

package/dist/agent/structured-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output.d.ts","sourceRoot":"","sources":["../../src/agent/structured-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAG3D;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,oFAAoF;IACpF,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAA;IAC1C,sDAAsD;IACtD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,eAAO,MAAM,YAAY,WAAY,aAAa,CAAC,gBAAgB,CAAC,KAAK,CAAC,KAAG,MAU9D,CAAA;AAEf,eAAO,MAAM,iBAAiB,WAAY,aAAa,CAAC,gBAAgB,CAAC,KAAK,CAAC,KAAG,MAG9B,CAAA;AAEpD,KAAK,gBAAgB,GACjB;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAA;CAAE,CAAA;AAE9D,eAAO,MAAM,kBAAkB,WACrB,gBAAgB,QAClB,MAAM,KACX,OAAO,CAAC,gBAAgB,CAU1B,CAAA"}

package/dist/agent/structured-output.js

@@ -0,0 +1,26 @@
+import { errorMessage } from "@arden-hq/std/errors";
+export const formatIssues = (issues) => issues
+    .map((issue) => {
+    const path = (issue.path ?? [])
+        .map((segment) => String(typeof segment === "object" && segment !== null ? segment.key : segment))
+        .join(".");
+    return path.length > 0 ? `${path}: ${issue.message}` : issue.message;
+})
+    .join("; ");
+export const correctionContent = (issues) => "Your final answer must be a single JSON object matching the required output schema. " +
+    `It failed validation: ${formatIssues(issues) || "the value does not match the schema"}. ` +
+    "Reply again with only the corrected JSON object.";
+export const validateOutputText = async (schema, text) => {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (cause) {
+        return { issues: [{ message: `the final text is not valid JSON: ${errorMessage(cause)}` }] };
+    }
+    let validated = schema["~standard"].validate(parsed);
+    if (validated instanceof Promise)
+        validated = await validated;
+    return validated.issues === undefined ? { value: validated.value } : { issues: validated.issues };
+};
+//# sourceMappingURL=structured-output.js.map

package/dist/agent/structured-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output.js","sourceRoot":"","sources":["../../src/agent/structured-output.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAkBnD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAA6C,EAAU,EAAE,CACpF,MAAM;KACH,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;IACb,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;SAC5B,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACf,MAAM,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAChF;SACA,IAAI,CAAC,GAAG,CAAC,CAAA;IACZ,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAA;AACtE,CAAC,CAAC;KACD,IAAI,CAAC,IAAI,CAAC,CAAA;AAEf,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAA6C,EAAU,EAAE,CACzF,sFAAsF;IACtF,yBAAyB,YAAY,CAAC,MAAM,CAAC,IAAI,qCAAqC,IAAI;IAC1F,kDAAkD,CAAA;AAMpD,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EACrC,MAAwB,EACxB,IAAY,EACe,EAAE;IAC7B,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,qCAAqC,YAAY,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,EAAE,CAAA;IAC9F,CAAC;IACD,IAAI,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IACpD,IAAI,SAAS,YAAY,OAAO;QAAE,SAAS,GAAG,MAAM,SAAS,CAAA;IAC7D,OAAO,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,CAAA;AACnG,CAAC,CAAA"}

package/dist/agent/tool-admission.d.ts

@@ -0,0 +1,18 @@
+import type { ProviderToolCall, ToolCall } from "../contracts/messages.js";
+import type { PendingToolCall, ToolDisplayTitle, Toolset } from "../contracts/tools.js";
+import type { StepView } from "./run-state.js";
+export declare const admitToolCalls: ({ rawCalls, view, displayTitle }: {
+    readonly rawCalls: ReadonlyArray<ToolCall>;
+    readonly view: Pick<StepView, "tools" | "deferredTools">;
+    readonly displayTitle: ToolDisplayTitle | undefined;
+}) => {
+    readonly calls: ReadonlyArray<PendingToolCall>;
+    readonly deferredNames: ReadonlySet<string>;
+};
+export declare const loadDeferredCalls: ({ calls, deferredNames, load, providerCalls }: {
+    readonly calls: ReadonlyArray<PendingToolCall>;
+    readonly deferredNames: ReadonlySet<string>;
+    readonly load: Toolset["load"];
+    readonly providerCalls?: ReadonlyArray<ProviderToolCall>;
+}) => Promise<ReadonlySet<string>>;
+//# sourceMappingURL=tool-admission.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-admission.d.ts","sourceRoot":"","sources":["../../src/agent/tool-admission.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAEvF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE9C,eAAO,MAAM,cAAc,qCAIxB;IACD,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAA;IAC1C,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,eAAe,CAAC,CAAA;IACxD,QAAQ,CAAC,YAAY,EAAE,gBAAgB,GAAG,SAAS,CAAA;CACpD,KAAG;IACF,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,CAAA;IAC9C,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAY5C,CAAA;AAED,eAAO,MAAM,iBAAiB,kDAK3B;IACD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,CAAA;IAC9C,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC3C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAA;CACzD,KAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAW9B,CAAA"}

package/dist/agent/tool-admission.js

@@ -0,0 +1,22 @@
+import { gateUnavailableCalls, parseToolCalls } from "../tools/dispatch.js";
+export const admitToolCalls = ({ rawCalls, view, displayTitle }) => {
+    const visible = view.tools.map((tool) => tool.name).sort();
+    const deferredNames = new Set(view.deferredTools.map((tool) => tool.name));
+    return {
+        calls: gateUnavailableCalls(parseToolCalls(rawCalls, displayTitle), new Set([...visible, ...deferredNames]), visible),
+        deferredNames
+    };
+};
+export const loadDeferredCalls = async ({ calls, deferredNames, load, providerCalls = [] }) => {
+    const loaded = new Set(calls.filter((call) => deferredNames.has(call.name)).map((call) => call.name));
+    for (const call of providerCalls) {
+        for (const name of call.loaded_tool_names ?? []) {
+            if (deferredNames.has(name))
+                loaded.add(name);
+        }
+    }
+    if (loaded.size > 0)
+        await load(loaded);
+    return loaded;
+};
+//# sourceMappingURL=tool-admission.js.map

package/dist/agent/tool-admission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-admission.js","sourceRoot":"","sources":["../../src/agent/tool-admission.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAG3E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAC7B,QAAQ,EACR,IAAI,EACJ,YAAY,EAKb,EAGC,EAAE;IACF,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAA;IAC1D,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IAC1E,OAAO;QACL,KAAK,EAAE,oBAAoB,CACzB,cAAc,CAAC,QAAQ,EAAE,YAAY,CAAC,EACtC,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,aAAa,CAAC,CAAC,EACvC,OAAO,CACR;QACD,aAAa;KACd,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EAAE,EACtC,KAAK,EACL,aAAa,EACb,IAAI,EACJ,aAAa,GAAG,EAAE,EAMnB,EAAgC,EAAE;IACjC,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAC9E,CAAA;IACD,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,iBAAiB,IAAI,EAAE,EAAE,CAAC;YAChD,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC/C,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC;QAAE,MAAM,IAAI,CAAC,MAAM,CAAC,CAAA;IACvC,OAAO,MAAM,CAAA;AACf,CAAC,CAAA"}

package/dist/contracts/events.d.ts

@@ -0,0 +1,236 @@
+import type { AssistantTextPhase, ChatMessage, ContentBlock, JsonObject, MaybePromise, Metadata } from "./messages.js";
+import type { CompletionResponse, Usage } from "./provider.js";
+import type { HistoryChange } from "../agent/history-journal.js";
+import type { HeldToolCall, PendingToolCall, ToolResult } from "./tools.js";
+export declare const StopReason: {
+    readonly END_TURN: "end_turn";
+    readonly MAX_ITERATIONS: "max_iterations";
+    readonly MAX_TOOL_CALLS: "max_tool_calls";
+    readonly NO_PROGRESS: "no_progress";
+    readonly MAX_WALL_TIME: "max_wall_time";
+    readonly MAX_COST: "max_cost";
+    readonly MAX_TOKEN_BUDGET: "max_token_budget";
+    readonly MAX_OUTPUT_LENGTH: "max_output_length";
+    readonly CANCELLED: "cancelled";
+    readonly PAUSED: "paused";
+};
+export type StopReason = (typeof StopReason)[keyof typeof StopReason];
+export interface EventBase {
+    readonly depth?: number;
+    readonly parent_id?: string | null;
+    readonly timestamp?: number;
+}
+export interface TextStarted extends EventBase {
+    readonly _tag: "TextStarted";
+    readonly message_id: string;
+}
+export interface TextEnded extends EventBase {
+    readonly _tag: "TextEnded";
+    readonly message_id: string;
+    readonly content: string;
+}
+export interface TextPhaseResolved extends EventBase {
+    readonly _tag: "TextPhaseResolved";
+    readonly message_id: string;
+    readonly phase: AssistantTextPhase;
+}
+export interface TextDelta extends EventBase {
+    readonly _tag: "TextDelta";
+    readonly content: string;
+    readonly message_id: string | null;
+}
+export interface ReasoningStarted extends EventBase {
+    readonly _tag: "ReasoningStarted";
+    readonly message_id: string;
+}
+export interface ReasoningDelta extends EventBase {
+    readonly _tag: "ReasoningDelta";
+    readonly message_id: string;
+    readonly content: string;
+}
+export interface ReasoningEnded extends EventBase {
+    readonly _tag: "ReasoningEnded";
+    readonly message_id: string;
+}
+export interface ModelStreamRetry extends EventBase {
+    readonly _tag: "ModelStreamRetry";
+    /** 1-based transport attempt that just failed. */
+    readonly attempt: number;
+    /** Total attempts before the failure stands and the run fails. */
+    readonly max_attempts: number;
+}
+/**
+ * The run took an owner message into its history: its first step started on
+ * one, or a step boundary drained a new one. Live status only, never persisted.
+ * Whatever the model does next (a tool call, answer text) is the reply.
+ */
+export interface InputTaken extends EventBase {
+    readonly _tag: "InputTaken";
+}
+export interface ModelResponseReset extends EventBase {
+    readonly _tag: "ModelResponseReset";
+    readonly message_ids: ReadonlyArray<string>;
+    readonly tool_call_ids: ReadonlyArray<string>;
+}
+/**
+ * The final-text check (`hooks.checkFinalText`) rejected the run's answer:
+ * Loop appended the correction and the model writes the answer again. The
+ * rejected answer's records stay in this run's history, so the model sees
+ * what it fixes; a host may drop them, and the correction, once the new
+ * answer stands.
+ */
+export interface FinalTextSuperseded extends EventBase {
+    readonly _tag: "FinalTextSuperseded";
+    /** The assistant records of the model call that wrote the rejected answer. */
+    readonly message_ids: ReadonlyArray<string>;
+    /** The meta user message that carries the correction. */
+    readonly correction_message_id: string;
+}
+export interface ToolInputStarted extends EventBase {
+    readonly _tag: "ToolInputStarted";
+    readonly tool_id: string;
+    readonly name: string;
+    readonly host: Metadata;
+}
+export interface ToolInputDelta extends EventBase {
+    readonly _tag: "ToolInputDelta";
+    readonly tool_id: string;
+    readonly delta: string;
+}
+export interface ToolInputEnded extends EventBase {
+    readonly _tag: "ToolInputEnded";
+    readonly tool_id: string;
+}
+export interface ToolStarted extends EventBase {
+    readonly _tag: "ToolStarted";
+    readonly tool_id: string;
+    readonly name: string;
+    readonly args: Readonly<Record<string, unknown>>;
+    readonly host: Metadata;
+    readonly execution?: "runtime" | "provider";
+}
+export interface ToolPaused extends EventBase {
+    readonly _tag: "ToolPaused";
+    readonly tool_id: string;
+    readonly name: string;
+    readonly args: Readonly<Record<string, unknown>>;
+    readonly reason: string;
+    readonly detail: string;
+}
+/**
+ * A live progress update emitted by a running tool via `ToolContext.emit`.
+ * Streamed between ToolStarted and ToolCompleted in emission order and never
+ * persisted to history. Parallel tools interleave their progress events.
+ */
+export interface ToolProgress extends EventBase {
+    readonly _tag: "ToolProgress";
+    readonly tool_call_id: string;
+    readonly name: string;
+    readonly message: string;
+    readonly data?: Readonly<Record<string, unknown>>;
+}
+export interface ToolCompleted extends EventBase {
+    readonly _tag: "ToolCompleted";
+    readonly tool_id: string;
+    readonly name: string;
+    readonly result: string;
+    readonly preview: string;
+    readonly duration_ms: number;
+    readonly is_error: boolean;
+    readonly data: JsonObject | null;
+    readonly retryable: boolean | null;
+    readonly message_extras: Metadata;
+    readonly host: Metadata;
+    readonly execution?: "runtime" | "provider";
+    readonly model_content: ReadonlyArray<ContentBlock>;
+    readonly ends_turn: boolean;
+}
+export type AgentEvent = TextStarted | TextEnded | TextPhaseResolved | TextDelta | ReasoningStarted | ReasoningDelta | ReasoningEnded | ModelStreamRetry | InputTaken | ModelResponseReset | FinalTextSuperseded | ToolInputStarted | ToolInputDelta | ToolInputEnded | ToolStarted | ToolProgress | ToolPaused | ToolCompleted;
+export interface PendingToolRequest {
+    readonly tool_call_id: string;
+    readonly name: string;
+    readonly args: Readonly<Record<string, unknown>>;
+    readonly reason: string;
+    readonly detail: string;
+}
+/** The terminal stream value. Deliberately tag-less: hosts discriminate via `"_tag" in event`. */
+export interface Result {
+    readonly text: string;
+    /** Parsed structured output; present only when the run validated an `output` schema. */
+    readonly object?: unknown;
+    readonly stop_reason: StopReason;
+    readonly steps: number;
+    readonly usage: Usage;
+    readonly last_input_tokens: number | null;
+    readonly cost: number;
+    readonly duration_ms: number;
+    readonly tool_time_ms: number;
+    readonly paused_tools: ReadonlyArray<PendingToolRequest>;
+    readonly messages: ReadonlyArray<ChatMessage>;
+}
+export type AgentStreamEvent = AgentEvent | Result;
+export interface AgentHooks {
+    /** Persist pending-call identity before background execution starts. */
+    readonly onCheckpoint?: (messages: ReadonlyArray<ChatMessage>, change: HistoryChange) => MaybePromise<void>;
+    readonly onResponse?: (response: CompletionResponse, messages: ReadonlyArray<ChatMessage>, change: HistoryChange) => MaybePromise<void>;
+    readonly onStepFinish?: (step: number, response: CompletionResponse | null, messages: ReadonlyArray<ChatMessage>, change: HistoryChange) => MaybePromise<void>;
+    readonly onError?: (cause: unknown) => MaybePromise<void>;
+    readonly onFinish?: (text: string, steps: number, messages: ReadonlyArray<ChatMessage>) => MaybePromise<void>;
+    /** Non-consuming input admission check. Excludes background completion notifications. */
+    readonly hasPendingInput?: () => MaybePromise<boolean>;
+    /**
+     * Which user messages a person wrote, for `InputTaken`. Defaults to
+     * `isHumanMessage` (no harness or agent interaction, not meta). A host that
+     * also feeds plain user messages that no person typed (a headless client)
+     * narrows it.
+     */
+    readonly isOwnerMessage?: (message: ChatMessage) => boolean;
+    readonly getPendingMessages?: () => MaybePromise<ReadonlyArray<ChatMessage>>;
+    /**
+     * Resolves when input may be waiting for `getPendingMessages`. Loop races it
+     * against background calls it waits on, so a message steers the run while a
+     * long call keeps running. Stop listening when `signal` aborts.
+     */
+    readonly waitForPendingMessages?: (signal: AbortSignal) => Promise<void>;
+    readonly recoverToolCalls?: (calls: ReadonlyArray<PendingToolCall>) => MaybePromise<ReadonlyMap<string, ToolResult>>;
+    /**
+     * A pause leaves the run's background calls running. The host keeps them,
+     * keyed by call id, so a resumed run can claim them and a stop of the run
+     * (cancel, delete) can still abort them through `stop`.
+     */
+    readonly holdBackgroundCalls?: (calls: ReadonlyArray<HeldToolCall>) => MaybePromise<void>;
+    /**
+     * The resumed run's pending background calls still alive in this process,
+     * from what `holdBackgroundCalls` kept. A claimed call is waited on and
+     * delivered, never recovered as uncertain; the rest go to `recoverToolCalls`.
+     */
+    readonly claimBackgroundCalls?: (toolCallIds: ReadonlyArray<string>) => MaybePromise<ReadonlyMap<string, HeldToolCall>>;
+    /**
+     * Checks the run's final text before the run ends. A returned string is a
+     * correction: Loop appends it as a meta user message and the model writes
+     * its final answer again. Called at most once per run; the second answer
+     * stands whatever it holds.
+     */
+    readonly checkFinalText?: (text: string) => MaybePromise<string | undefined>;
+}
+export interface RunBudgetSnapshot {
+    readonly toolCalls: number;
+    readonly outputTokens: number;
+    readonly totalOutputTokens?: number;
+}
+export interface RunBudget {
+    readonly snapshot: () => MaybePromise<RunBudgetSnapshot>;
+    readonly reserveToolCalls: (count: number, limit?: number) => MaybePromise<boolean>;
+    readonly addOutputTokens: (count: number) => MaybePromise<RunBudgetSnapshot>;
+}
+export interface RunBudgetOptions {
+    readonly toolCalls?: number;
+    readonly outputTokens?: number;
+    readonly totalOutputTokens?: number;
+}
+export interface RunPolicy {
+    readonly finalizeInstruction?: string;
+    readonly fallbackResultText?: (messages: ReadonlyArray<ChatMessage>, reason: StopReason) => string;
+    readonly budgetDenialContent?: (reason: StopReason) => string;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/contracts/events.d.ts.map

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

package/dist/contracts/events.js

@@ -0,0 +1,13 @@
+export const StopReason = {
+    END_TURN: "end_turn",
+    MAX_ITERATIONS: "max_iterations",
+    MAX_TOOL_CALLS: "max_tool_calls",
+    NO_PROGRESS: "no_progress",
+    MAX_WALL_TIME: "max_wall_time",
+    MAX_COST: "max_cost",
+    MAX_TOKEN_BUDGET: "max_token_budget",
+    MAX_OUTPUT_LENGTH: "max_output_length",
+    CANCELLED: "cancelled",
+    PAUSED: "paused"
+};
+//# sourceMappingURL=events.js.map

package/dist/contracts/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/contracts/events.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,QAAQ,EAAE,UAAU;IACpB,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,aAAa;IAC1B,aAAa,EAAE,eAAe;IAC9B,QAAQ,EAAE,UAAU;IACpB,gBAAgB,EAAE,kBAAkB;IACpC,iBAAiB,EAAE,mBAAmB;IACtC,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;CACR,CAAA"}