@arden-hq/loop 0.0.0-stage → 0.1.0

package/dist/agent/background-tools.js

@@ -0,0 +1,257 @@
+import { AgentInvariantError } from "../errors.js";
+import { raceAbort } from "../abort.js";
+import { launchReceipt, parseToolCalls } from "../tools/dispatch.js";
+import { normalizeToolResult } from "../internal/validate.js";
+const capacityRejection = {
+    content: "Background tool capacity is full. This call was not started. Wait for a pending tool result before retrying.",
+    preview: "Background capacity reached",
+    is_error: true,
+    retryable: true
+};
+export class BackgroundTools {
+    options;
+    jobs = new Map();
+    replay;
+    constructor(options) {
+        this.options = options;
+    }
+    get pending() {
+        return this.jobs.size > 0 || this.replay !== undefined;
+    }
+    running() {
+        return [...this.jobs.values()].flatMap((job) => job.state.kind === "running" ? [job.held] : []);
+    }
+    async launch(input) {
+        if (input.recovered !== undefined) {
+            this.replay = { input, next: 0 };
+            await this.fillReplay();
+            return { completions: [], paused: [] };
+        }
+        const available = Math.max(0, this.options.capacity - this.jobs.size);
+        const calls = input.calls.filter((call) => !this.jobs.has(call.toolCall.id));
+        await this.start({ ...input, calls: calls.slice(0, available) });
+        const completions = [];
+        const paused = [];
+        for (const call of calls.slice(available)) {
+            const output = await this.options.execute({
+                call,
+                messages: this.options.messages,
+                metas: input.metas,
+                rejection: capacityRejection
+            });
+            completions.push(...output.completions);
+            paused.push(...output.paused);
+        }
+        if (completions.length > 0)
+            await this.options.checkpoint();
+        return { completions, paused };
+    }
+    async fillReplay() {
+        while (this.replay !== undefined && this.jobs.size < this.options.capacity) {
+            const replay = this.replay;
+            const end = Math.min(replay.input.calls.length, replay.next + this.options.capacity - this.jobs.size);
+            await this.start({ ...replay.input, calls: replay.input.calls.slice(replay.next, end) });
+            replay.next = end;
+            if (end === replay.input.calls.length)
+                this.replay = undefined;
+        }
+    }
+    async start(input) {
+        if (input.calls.length === 0)
+            return;
+        for (const call of input.calls) {
+            if (this.jobs.has(call.toolCall.id))
+                continue;
+            const id = call.toolCall.id;
+            if (this.options.messages.some((message) => message.message_id === `async-launch:${id}`)) {
+                if (input.recovered === undefined)
+                    throw new AgentInvariantError(`Background tool call id was reused: ${id}`);
+                continue;
+            }
+            this.options.messages.push(input.mode === "native"
+                ? {
+                    role: "user",
+                    message_id: `async-launch:${id}`,
+                    is_meta: true,
+                    async_tool_launch: { call_id: id, delivery: "native" },
+                    content: []
+                }
+                : launchReceipt(id));
+        }
+        await this.options.checkpoint();
+        for (const call of input.calls) {
+            const id = call.toolCall.id;
+            if (this.jobs.has(id))
+                continue;
+            const isolated = [...this.options.messages];
+            const offset = isolated.length;
+            const claimed = input.claimed?.get(id);
+            const recovered = claimed === undefined
+                ? Promise.resolve(input.recovered?.get(id))
+                : claimed.result.then((result) => result === undefined ? undefined : normalizeToolResult(result));
+            this.track(call, backgroundDelivery(this.options.messages, id) ?? input.mode, this.options.clock() + this.options.graceMs, recovered
+                .then((result) => this.options.execute({
+                call,
+                messages: isolated,
+                metas: input.metas,
+                ...(result === undefined ? {} : { recovered: result })
+            }))
+                .then((output) => ({ output, messages: isolated.slice(offset) })), claimed?.stop ?? this.options.stop);
+        }
+    }
+    adopt(backgrounded) {
+        this.track(backgrounded.call, "message", 0, backgrounded.settled, this.options.stop);
+    }
+    track(call, delivery, graceUntil, settled, stop) {
+        const id = call.toolCall.id;
+        const job = {
+            graceUntil,
+            held: {
+                toolCallId: id,
+                result: settled.then((outcome) => outcomeResult(outcome, id), () => undefined),
+                stop
+            },
+            state: { kind: "running" },
+            settled: settled.then((outcome) => {
+                job.state = {
+                    kind: "settled",
+                    outcome: {
+                        output: outcome.output,
+                        messages: outcome.messages.map((message) => {
+                            if (delivery === "native" || message.role !== "tool")
+                                return message;
+                            return {
+                                role: "user",
+                                message_id: `async-result:${id}`,
+                                client_id: `async-result:${id}`,
+                                is_meta: true,
+                                content: [
+                                    {
+                                        type: "context",
+                                        content_type: "async_tool_result",
+                                        content: message.content,
+                                        metadata: { tool_call_id: id, tool_name: call.name }
+                                    }
+                                ]
+                            };
+                        })
+                    }
+                };
+            }, (cause) => {
+                job.state = { kind: "failed", cause };
+            })
+        };
+        this.jobs.set(id, job);
+    }
+    async drain(options = {}) {
+        if (options.grace === true)
+            await this.awaitGrace();
+        if (options.wait === true &&
+            this.jobs.size > 0 &&
+            ![...this.jobs.values()].some((job) => job.state.kind !== "running")) {
+            const completion = Promise.race([
+                ...[...this.jobs.values()].map((job) => job.settled),
+                ...(options.wake === undefined ? [] : [options.wake])
+            ]);
+            let timeout;
+            try {
+                const maxWaitMs = options.maxWaitMs;
+                const waiting = maxWaitMs === undefined
+                    ? completion
+                    : Promise.race([
+                        completion,
+                        new Promise((resolve) => {
+                            timeout = setTimeout(resolve, Math.max(0, maxWaitMs));
+                        })
+                    ]);
+                await raceAbort(waiting, this.options.signal);
+            }
+            finally {
+                clearTimeout(timeout);
+            }
+        }
+        let changed = false;
+        const completions = [];
+        const paused = [];
+        for (const [id, job] of this.jobs) {
+            if (job.state.kind === "failed")
+                throw job.state.cause;
+            if (job.state.kind === "running")
+                continue;
+            changed = true;
+            this.options.messages.push(...job.state.outcome.messages);
+            completions.push(...job.state.outcome.output.completions);
+            paused.push(...job.state.outcome.output.paused);
+            this.jobs.delete(id);
+        }
+        if (changed)
+            await this.options.checkpoint();
+        await this.fillReplay();
+        return { completions, paused };
+    }
+    async awaitGrace() {
+        const now = this.options.clock();
+        const fresh = [...this.jobs.values()].filter((job) => job.state.kind === "running" && job.graceUntil > now);
+        if (fresh.length === 0)
+            return;
+        const closesInMs = Math.max(...fresh.map((job) => job.graceUntil)) - now;
+        let timeout;
+        try {
+            await raceAbort(Promise.race([
+                Promise.all(fresh.map((job) => job.settled)),
+                new Promise((resolve) => {
+                    timeout = setTimeout(resolve, closesInMs);
+                })
+            ]), this.options.signal);
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+const outcomeResult = (outcome, id) => {
+    const event = outcome.output.completions.find((completion) => completion.tool_id === id);
+    if (event === undefined)
+        return undefined;
+    return {
+        content: event.result,
+        preview: event.preview,
+        is_error: event.is_error,
+        retryable: event.retryable,
+        data: event.data,
+        message_extras: event.message_extras,
+        host: event.host,
+        model_content: event.model_content
+    };
+};
+const backgroundDelivery = (messages, id) => {
+    for (const message of messages) {
+        const launch = message.async_tool_launch;
+        if (typeof launch !== "object" ||
+            launch === null ||
+            !("call_id" in launch) ||
+            launch.call_id !== id ||
+            !("delivery" in launch))
+            continue;
+        if (launch.delivery === "native" || launch.delivery === "message")
+            return launch.delivery;
+    }
+    return undefined;
+};
+/** Receipts close portable wire calls but do not settle the underlying execution. */
+export const pendingBackgroundCalls = (messages, options = {}) => {
+    const outputs = new Set(messages.flatMap((message) => message.role === "tool" && message.async_tool_launch === undefined
+        ? [message.tool_call_id]
+        : []));
+    const delivered = new Set(messages.flatMap((message) => typeof message.client_id === "string" ? [message.client_id] : []));
+    return parseToolCalls(messages.flatMap((message) => message.role === "assistant"
+        ? (message.tool_calls ?? []).filter((call) => {
+            const delivery = backgroundDelivery(messages, call.id);
+            return (delivery !== undefined &&
+                (delivery === "native"
+                    ? !outputs.has(call.id)
+                    : !delivered.has(`async-result:${call.id}`)));
+        })
+        : []), options.displayTitle);
+};
+//# sourceMappingURL=background-tools.js.map

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

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

package/dist/agent/budget.d.ts

@@ -0,0 +1,5 @@
+import type { RunBudget, RunBudgetOptions, RunBudgetSnapshot } from "../contracts/events.js";
+/** Create a small synchronous budget that can be shared between agent runs. */
+export declare const makeRunBudget: (options?: RunBudgetOptions) => RunBudget;
+export declare const validateBudgetSnapshot: (value: RunBudgetSnapshot) => RunBudgetSnapshot;
+//# sourceMappingURL=budget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/agent/budget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAI5F,+EAA+E;AAC/E,eAAO,MAAM,aAAa,aAAa,gBAAgB,KAAQ,SAgC9D,CAAA;AAED,eAAO,MAAM,sBAAsB,UAAW,iBAAiB,KAAG,iBAcjE,CAAA"}

package/dist/agent/budget.js

@@ -0,0 +1,48 @@
+const validCount = (value) => Number.isSafeInteger(value) && value >= 0;
+/** Create a small synchronous budget that can be shared between agent runs. */
+export const makeRunBudget = (options = {}) => {
+    let current = {
+        toolCalls: options.toolCalls ?? 0,
+        outputTokens: options.outputTokens ?? 0,
+        ...(options.totalOutputTokens === undefined
+            ? {}
+            : { totalOutputTokens: options.totalOutputTokens })
+    };
+    if (!validCount(current.toolCalls) ||
+        !validCount(current.outputTokens) ||
+        (current.totalOutputTokens !== undefined && !validCount(current.totalOutputTokens))) {
+        throw new RangeError("run budget counts must be non-negative safe integers");
+    }
+    return Object.freeze({
+        snapshot: () => ({ ...current }),
+        reserveToolCalls: (count, limit) => {
+            if (!validCount(count) || (limit !== undefined && !validCount(limit))) {
+                throw new RangeError("tool budget counts must be non-negative safe integers");
+            }
+            if (limit !== undefined && current.toolCalls + count > limit)
+                return false;
+            current = { ...current, toolCalls: current.toolCalls + count };
+            return true;
+        },
+        addOutputTokens: (count) => {
+            if (!validCount(count))
+                throw new RangeError("output token count must be a non-negative safe integer");
+            current = { ...current, outputTokens: current.outputTokens + count };
+            return { ...current };
+        }
+    });
+};
+export const validateBudgetSnapshot = (value) => {
+    if (typeof value !== "object" ||
+        value === null ||
+        !Number.isSafeInteger(value.toolCalls) ||
+        value.toolCalls < 0 ||
+        !Number.isSafeInteger(value.outputTokens) ||
+        value.outputTokens < 0 ||
+        (value.totalOutputTokens !== undefined &&
+            (!Number.isSafeInteger(value.totalOutputTokens) || value.totalOutputTokens < 0))) {
+        throw new TypeError("budget snapshot must contain non-negative safe integer counts");
+    }
+    return value;
+};
+//# sourceMappingURL=budget.js.map

package/dist/agent/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/agent/budget.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG,CAAC,KAAa,EAAW,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;AAExF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAO,GAAqB,EAAE,EAAa,EAAE;IACzE,IAAI,OAAO,GAAsB;QAC/B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC;QACjC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,CAAC;QACvC,GAAG,CAAC,OAAO,CAAC,iBAAiB,KAAK,SAAS;YACzC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC;KACtD,CAAA;IACD,IACE,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC;QAC9B,CAAC,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC;QACjC,CAAC,OAAO,CAAC,iBAAiB,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,EACnF,CAAC;QACD,MAAM,IAAI,UAAU,CAAC,sDAAsD,CAAC,CAAA;IAC9E,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC;QAChC,gBAAgB,EAAE,CAAC,KAAa,EAAE,KAAc,EAAW,EAAE;YAC3D,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBACtE,MAAM,IAAI,UAAU,CAAC,uDAAuD,CAAC,CAAA;YAC/E,CAAC;YACD,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,GAAG,KAAK,GAAG,KAAK;gBAAE,OAAO,KAAK,CAAA;YAC1E,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,GAAG,KAAK,EAAE,CAAA;YAC9D,OAAO,IAAI,CAAA;QACb,CAAC;QACD,eAAe,EAAE,CAAC,KAAa,EAAqB,EAAE;YACpD,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;gBACpB,MAAM,IAAI,UAAU,CAAC,wDAAwD,CAAC,CAAA;YAChF,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,GAAG,KAAK,EAAE,CAAA;YACpE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAA;QACvB,CAAC;KACF,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAwB,EAAqB,EAAE;IACpF,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC;QACtC,KAAK,CAAC,SAAS,GAAG,CAAC;QACnB,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC;QACzC,KAAK,CAAC,YAAY,GAAG,CAAC;QACtB,CAAC,KAAK,CAAC,iBAAiB,KAAK,SAAS;YACpC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC,EAClF,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,+DAA+D,CAAC,CAAA;IACtF,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA"}

package/dist/agent/config.d.ts

@@ -0,0 +1,61 @@
+import type { MessageIdMinter } from "../contracts/messages.js";
+import type { ToolCallMiddleware } from "../contracts/tools.js";
+import { ToolChoice, type ModelRequestMiddleware } from "../contracts/provider.js";
+import type { RunPolicy } from "../contracts/events.js";
+interface AgentLimits {
+    readonly maxIterations?: number;
+    readonly maxToolCalls?: number;
+    readonly maxWallTimeMs?: number;
+    readonly maxCost?: number;
+    /** Consecutive all-error steps before stopping. Zero disables this limit. */
+    readonly maxNoProgressSteps: number;
+}
+/** Input accepted by `validateAgentConfig`; limit fields are flattened for Agent callers. */
+export interface AgentConfigInput extends Partial<AgentLimits> {
+    readonly model: string;
+    readonly maxOutputTokens?: number;
+    readonly toolChoice?: ToolChoice;
+    readonly reasoningEffort?: string;
+    /**
+     * Stable identity of the conversation a request extends — one value for a
+     * whole agent tree. Each provider maps it to its own prompt-cache mechanism
+     * (OpenAI: `prompt_cache_key`); the host never deals in cache details.
+     */
+    readonly cacheScope?: string;
+    readonly maxToolConcurrency?: number;
+    /**
+     * How long the next model request waits for background calls just launched,
+     * so a quick one delivers its result in that request instead of a running
+     * receipt and one more request. Zero disables the wait. Defaults to 1000.
+     */
+    readonly backgroundGraceMs?: number;
+    /**
+     * Execution time after which a call still running moves to the background:
+     * the model gets a receipt and the result arrives later. Counted from when
+     * the call's effect begins. Defaults to 10000; Infinity keeps every call in
+     * the foreground.
+     */
+    readonly foregroundBudgetMs?: number;
+    readonly modelRequestMiddlewares?: ReadonlyArray<ModelRequestMiddleware>;
+    readonly toolCallMiddlewares?: ReadonlyArray<ToolCallMiddleware>;
+    readonly policy?: RunPolicy;
+    readonly mintMessageId?: MessageIdMinter;
+}
+/** Immutable, validated configuration consumed by the Agent state machine. */
+export interface AgentConfig extends AgentLimits {
+    readonly model: string;
+    readonly maxOutputTokens?: number;
+    readonly toolChoice: ToolChoice;
+    readonly maxToolConcurrency: number;
+    readonly backgroundGraceMs: number;
+    readonly foregroundBudgetMs: number;
+    readonly modelRequestMiddlewares: ReadonlyArray<ModelRequestMiddleware>;
+    readonly toolCallMiddlewares: ReadonlyArray<ToolCallMiddleware>;
+    readonly policy: RunPolicy;
+    readonly reasoningEffort?: string;
+    readonly cacheScope?: string;
+    readonly mintMessageId?: MessageIdMinter;
+}
+export declare const validateAgentConfig: (input: AgentConfigInput) => AgentConfig;
+export {};
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/agent/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,OAAO,EAAE,UAAU,EAAE,KAAK,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AAClF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAMvD,UAAU,WAAW;IACnB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,6EAA6E;IAC7E,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;CACpC;AAMD,6FAA6F;AAC7F,MAAM,WAAW,gBAAiB,SAAQ,OAAO,CAAC,WAAW,CAAC;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAA;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;IACpC;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAA;IACxE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAA;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAA;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,eAAe,CAAA;CACzC;AAED,8EAA8E;AAC9E,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,uBAAuB,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAA;IACvE,QAAQ,CAAC,mBAAmB,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAA;IAC/D,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;IAC1B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,eAAe,CAAA;CACzC;AAwDD,eAAO,MAAM,mBAAmB,UAAW,gBAAgB,KAAG,WAkD7D,CAAA"}

package/dist/agent/config.js

@@ -0,0 +1,99 @@
+import { InvalidAgentConfigError } from "../errors.js";
+import { ToolChoice } from "../contracts/provider.js";
+const defaultMaxToolConcurrency = 6;
+const defaultBackgroundGraceMs = 1_000;
+const defaultForegroundBudgetMs = 10_000;
+const defaultAgentLimits = {
+    maxNoProgressSteps: 0
+};
+const invalidField = (field) => new InvalidAgentConfigError(`invalid agent config field: ${field}`);
+const optionalNonNegative = (value) => value === undefined || (Number.isFinite(value) && value >= 0);
+const optionalNonNegativeInteger = (value) => value === undefined || (Number.isSafeInteger(value) && value >= 0);
+const positiveInteger = (value) => Number.isSafeInteger(value) && value >= 1;
+const validateAgentLimits = (input = {}) => {
+    const limits = { ...defaultAgentLimits, ...input };
+    if (!optionalNonNegativeInteger(limits.maxIterations) ||
+        !optionalNonNegativeInteger(limits.maxToolCalls) ||
+        !optionalNonNegative(limits.maxWallTimeMs) ||
+        !optionalNonNegative(limits.maxCost) ||
+        !optionalNonNegativeInteger(limits.maxNoProgressSteps)) {
+        throw new InvalidAgentConfigError("iteration, tool-call, and no-progress limits must be non-negative integers; wall-time and cost limits must be finite non-negative values");
+    }
+    return limits;
+};
+const copyPolicy = (policy) => {
+    const source = policy ?? {};
+    return Object.freeze({
+        ...(source.finalizeInstruction === undefined
+            ? {}
+            : { finalizeInstruction: source.finalizeInstruction }),
+        ...(source.fallbackResultText === undefined
+            ? {}
+            : { fallbackResultText: source.fallbackResultText }),
+        ...(source.budgetDenialContent === undefined
+            ? {}
+            : { budgetDenialContent: source.budgetDenialContent })
+    });
+};
+const toolChoices = new Set(Object.values(ToolChoice));
+const limitInput = (input) => ({
+    ...(input.maxIterations === undefined ? {} : { maxIterations: input.maxIterations }),
+    ...(input.maxToolCalls === undefined ? {} : { maxToolCalls: input.maxToolCalls }),
+    ...(input.maxWallTimeMs === undefined ? {} : { maxWallTimeMs: input.maxWallTimeMs }),
+    ...(input.maxCost === undefined ? {} : { maxCost: input.maxCost }),
+    ...(input.maxNoProgressSteps === undefined
+        ? {}
+        : { maxNoProgressSteps: input.maxNoProgressSteps })
+});
+export const validateAgentConfig = (input) => {
+    if (typeof input.model !== "string" || input.model.length === 0)
+        throw invalidField("model");
+    if (input.maxOutputTokens !== undefined && !positiveInteger(input.maxOutputTokens)) {
+        throw invalidField("maxOutputTokens");
+    }
+    const limits = validateAgentLimits(limitInput(input));
+    const toolChoice = input.toolChoice === undefined ? ToolChoice.AUTO : input.toolChoice;
+    if (!toolChoices.has(toolChoice))
+        throw invalidField("toolChoice");
+    const maxToolConcurrency = input.maxToolConcurrency === undefined ? defaultMaxToolConcurrency : input.maxToolConcurrency;
+    if (!positiveInteger(maxToolConcurrency))
+        throw invalidField("maxToolConcurrency");
+    const backgroundGraceMs = input.backgroundGraceMs ?? defaultBackgroundGraceMs;
+    if (!optionalNonNegative(backgroundGraceMs))
+        throw invalidField("backgroundGraceMs");
+    const foregroundBudgetMs = input.foregroundBudgetMs ?? defaultForegroundBudgetMs;
+    if (Number.isNaN(foregroundBudgetMs) || foregroundBudgetMs < 0)
+        throw invalidField("foregroundBudgetMs");
+    if (input.reasoningEffort !== undefined && typeof input.reasoningEffort !== "string") {
+        throw invalidField("reasoningEffort");
+    }
+    if (input.cacheScope !== undefined && typeof input.cacheScope !== "string") {
+        throw invalidField("cacheScope");
+    }
+    if (input.modelRequestMiddlewares !== undefined &&
+        !Array.isArray(input.modelRequestMiddlewares)) {
+        throw invalidField("modelRequestMiddlewares");
+    }
+    if (input.toolCallMiddlewares !== undefined && !Array.isArray(input.toolCallMiddlewares)) {
+        throw invalidField("toolCallMiddlewares");
+    }
+    if (input.mintMessageId !== undefined && typeof input.mintMessageId !== "function") {
+        throw invalidField("mintMessageId");
+    }
+    return Object.freeze({
+        model: input.model,
+        ...(input.maxOutputTokens === undefined ? {} : { maxOutputTokens: input.maxOutputTokens }),
+        ...limits,
+        toolChoice,
+        maxToolConcurrency,
+        backgroundGraceMs,
+        foregroundBudgetMs,
+        modelRequestMiddlewares: Object.freeze([...(input.modelRequestMiddlewares ?? [])]),
+        toolCallMiddlewares: Object.freeze([...(input.toolCallMiddlewares ?? [])]),
+        policy: copyPolicy(input.policy),
+        ...(input.reasoningEffort === undefined ? {} : { reasoningEffort: input.reasoningEffort }),
+        ...(input.cacheScope === undefined ? {} : { cacheScope: input.cacheScope }),
+        ...(input.mintMessageId === undefined ? {} : { mintMessageId: input.mintMessageId })
+    });
+};
+//# sourceMappingURL=config.js.map

package/dist/agent/config.js.map

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

package/dist/agent/guards.d.ts

@@ -0,0 +1,10 @@
+import type { MaybePromise } from "../contracts/messages.js";
+import type { Toolset } from "../contracts/tools.js";
+import type { RunBudget } from "../contracts/events.js";
+import { AgentCallbackError } from "../errors.js";
+export declare const callbackFailure: (operation: string, cause: unknown) => AgentCallbackError;
+export declare const invoke: <A>(operation: string, body: () => A) => A;
+export declare const hookCall: <A>(hook: string, body: () => MaybePromise<A>) => Promise<A>;
+export declare const guardToolset: (toolset: Toolset) => Toolset;
+export declare const guardBudget: (budget: RunBudget) => RunBudget;
+//# sourceMappingURL=guards.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/agent/guards.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAuB,OAAO,EAAE,MAAM,uBAAuB,CAAA;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAA2B,MAAM,cAAc,CAAA;AAG1E,eAAO,MAAM,eAAe,cAAe,MAAM,SAAS,OAAO,KAAG,kBACqB,CAAA;AAEzF,eAAO,MAAM,MAAM,GAAI,CAAC,aAAa,MAAM,QAAQ,MAAM,CAAC,KAAG,CAM5D,CAAA;AAED,eAAO,MAAM,QAAQ,GAAU,CAAC,QAAQ,MAAM,QAAQ,MAAM,YAAY,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAMtF,CAAA;AAKD,eAAO,MAAM,YAAY,YAAa,OAAO,KAAG,OAkF/C,CAAA;AAED,eAAO,MAAM,WAAW,WAAY,SAAS,KAAG,SAyB9C,CAAA"}