@ifc-lite/ids-agent 0.0.0-stage → 0.2.1

package/dist/providers/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAGV,WAAW,EACX,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACd,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAqC,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,KAAK,eAAe,EAA2B,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAE1K,MAAM,WAAW,uBAAuB;IACtC,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6GAA6G;IAC7G,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,uFAAuF;IACvF,eAAe,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CAC5C;AAED,mDAAmD;AACnD,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAoB9D,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,EAAE,CAczH;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,aAAa,EAAE,CASnG;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,GAAE,uBAA4B,GAAG,uBAAuB,CAqBvH;AAaD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,QAAQ,CAWnE;AAED,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,uBAAuB,EAAE,OAAO,GAAE,uBAA4B,GAAG,iBAAiB,CAO5H"}

package/dist/providers/anthropic.js

@@ -0,0 +1,107 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { anthropicUsage } from '@ifc-lite/ai';
+const PROVIDER = 'anthropic';
+const TASK_BUDGET_MIN = 20_000;
+function assistantBlocks(content) {
+    const out = [];
+    for (const block of content) {
+        if (block.type === 'text') {
+            if (block.text)
+                out.push({ type: 'text', text: block.text });
+        }
+        else if (block.type === 'tool_call') {
+            out.push({ type: 'tool_use', id: block.id, name: block.name, input: block.input ?? {} });
+        }
+        else if (block.provider === PROVIDER) {
+            // Sent back exactly as the API returned it (thinking signatures must not change).
+            out.push(block.value);
+        }
+    }
+    return out;
+}
+export function toAnthropicMessages(messages, context) {
+    return messages.map((m, i) => {
+        if (m.role === 'user') {
+            const text = [];
+            if (i === 0 && context)
+                text.push({ type: 'text', text: context });
+            text.push({ type: 'text', text: m.content });
+            return { role: 'user', content: text };
+        }
+        if (m.role === 'assistant')
+            return { role: 'assistant', content: assistantBlocks(m.content) };
+        return {
+            role: 'user',
+            content: m.results.map((r) => ({ type: 'tool_result', tool_use_id: r.callId, content: r.content, is_error: r.isError })),
+        };
+    });
+}
+export function toAnthropicTools(call, eager) {
+    return call.tools.map((t) => ({
+        name: t.name,
+        description: t.description,
+        // `inputSchema` is a JSON Schema object with `type: 'object'` (the registry builds it).
+        input_schema: { type: 'object', ...t.inputSchema },
+        ...(t.strict ? { strict: true } : {}),
+        ...(eager ? { eager_input_streaming: true } : {}),
+    }));
+}
+export function buildAnthropicParams(call, options = {}) {
+    const betas = [];
+    const taskBudget = options.taskBudgets !== false && call.taskBudget !== undefined ? Math.max(TASK_BUDGET_MIN, call.taskBudget) : undefined;
+    if (taskBudget !== undefined)
+        betas.push('task-budgets-2026-03-13');
+    if (options.fallbacks !== false)
+        betas.push('server-side-fallback-2026-07-01');
+    return {
+        model: call.model,
+        max_tokens: call.maxOutputTokens,
+        system: [{ type: 'text', text: call.system, cache_control: { type: 'ephemeral' } }],
+        messages: toAnthropicMessages(call.messages, call.context),
+        tools: toAnthropicTools(call, options.eagerInputStreaming !== false),
+        tool_choice: { type: 'auto' },
+        thinking: { type: 'adaptive', display: options.thinkingDisplay ?? 'summarized' },
+        cache_control: { type: 'ephemeral' },
+        output_config: {
+            ...(call.effort ? { effort: call.effort } : {}),
+            ...(taskBudget !== undefined ? { task_budget: { type: 'tokens', total: taskBudget } } : {}),
+        },
+        ...(options.fallbacks !== false ? { fallbacks: 'default' } : {}),
+        ...(betas.length ? { betas } : {}),
+    };
+}
+const STOP = {
+    end_turn: 'end_turn', stop_sequence: 'end_turn', tool_use: 'tool_use', max_tokens: 'max_tokens',
+    model_context_window_exceeded: 'max_tokens', pause_turn: 'pause_turn', refusal: 'refusal',
+};
+function fromBlock(block) {
+    if (block.type === 'text')
+        return { type: 'text', text: block.text };
+    if (block.type === 'tool_use')
+        return { type: 'tool_call', id: block.id, name: block.name, input: block.input };
+    return { type: 'opaque', provider: PROVIDER, value: block };
+}
+export function fromAnthropicMessage(message) {
+    const details = message.stop_details;
+    return {
+        content: message.content.map(fromBlock),
+        stopReason: (message.stop_reason && STOP[message.stop_reason]) || 'other',
+        usage: anthropicUsage(message.usage),
+        servedModel: message.model,
+        ...(message.stop_reason === 'refusal' && details
+            ? { refusal: { category: details.category ?? null, explanation: details.explanation ?? null } }
+            : {}),
+    };
+}
+/** A tool-turn transport over an Anthropic SDK client. */
+export function anthropicTransport(client, options = {}) {
+    return async (call) => {
+        const stream = client.beta.messages.stream(buildAnthropicParams(call, options), { signal: call.signal });
+        stream.on('text', (delta) => call.onText(delta));
+        stream.on('thinking', (delta) => call.onThinking(delta));
+        return fromAnthropicMessage(await stream.finalMessage());
+    };
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/providers/anthropic.js.map

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

package/dist/providers/openai.d.ts

@@ -0,0 +1,60 @@
+/**
+ * OpenAI-compatible Chat Completions adapter for the tool-turn contract
+ * (provider two, `06-ai-agent.md` §3: offered for a mode only where it
+ * passes that mode's eval gate). One non-streaming request per turn through
+ * the host's `fetch`; the host supplies the key and base URL.
+ *
+ * Tool inputs arrive as JSON text; one that does not parse is passed on as
+ * `rawInput` so the registry answers `INVALID_JSON` instead of running it.
+ * `strict` is not sent: OpenAI strict mode requires every property to be
+ * required, which optional tool fields are not. The registry validates.
+ */
+import { type ToolTurn, type ToolTurnCall, type ToolTurnTransport } from '@ifc-lite/ai';
+export interface OpenAiAdapterConfig {
+    readonly apiKey: string;
+    /** Default `https://api.openai.com/v1`. */
+    readonly baseUrl?: string;
+    /** Send `reasoning_effort` (reasoning models only). Default false. */
+    readonly reasoningEffort?: boolean;
+}
+type ChatMessage = {
+    role: 'system' | 'user';
+    content: string;
+} | {
+    role: 'assistant';
+    content: string | null;
+    tool_calls?: {
+        id: string;
+        type: 'function';
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }[];
+} | {
+    role: 'tool';
+    tool_call_id: string;
+    content: string;
+};
+export declare function toChatMessages(call: Pick<ToolTurnCall, 'system' | 'context' | 'messages'>): ChatMessage[];
+interface ChatResponse {
+    model?: string;
+    choices?: {
+        finish_reason?: string | null;
+        message?: {
+            content?: string | null;
+            refusal?: string | null;
+            tool_calls?: {
+                id?: string;
+                function?: {
+                    name?: string;
+                    arguments?: string;
+                };
+            }[];
+        };
+    }[];
+}
+export declare function fromChatResponse(body: ChatResponse): ToolTurn;
+export declare function openAiTransport(config: OpenAiAdapterConfig, fetchImpl?: typeof fetch): ToolTurnTransport;
+export {};
+//# sourceMappingURL=openai.d.ts.map

package/dist/providers/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AAEH,OAAO,EAA2C,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAiD,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEhL,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,KAAK,WAAW,GACZ;IAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,EAAE,CAAA;CAAE,GAC7I;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC,GAAG,WAAW,EAAE,CAgBzG;AAMD,UAAU,YAAY;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,OAAO,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,UAAU,CAAC,EAAE;gBAAE,EAAE,CAAC,EAAE,MAAM,CAAC;gBAAC,QAAQ,CAAC,EAAE;oBAAE,IAAI,CAAC,EAAE,MAAM,CAAC;oBAAC,SAAS,CAAC,EAAE,MAAM,CAAA;iBAAE,CAAA;aAAE,EAAE,CAAA;SAAE,CAAC;KAClJ,EAAE,CAAC;CACL;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CAyB7D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,mBAAmB,EAAE,SAAS,GAAE,OAAO,KAAa,GAAG,iBAAiB,CAqB/G"}

package/dist/providers/openai.js

@@ -0,0 +1,92 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * OpenAI-compatible Chat Completions adapter for the tool-turn contract
+ * (provider two, `06-ai-agent.md` §3: offered for a mode only where it
+ * passes that mode's eval gate). One non-streaming request per turn through
+ * the host's `fetch`; the host supplies the key and base URL.
+ *
+ * Tool inputs arrive as JSON text; one that does not parse is passed on as
+ * `rawInput` so the registry answers `INVALID_JSON` instead of running it.
+ * `strict` is not sent: OpenAI strict mode requires every property to be
+ * required, which optional tool fields are not. The registry validates.
+ */
+import { chatCompletionsUsage } from '@ifc-lite/ai';
+export function toChatMessages(call) {
+    const out = [{ role: 'system', content: call.system }];
+    call.messages.forEach((m, i) => {
+        if (m.role === 'user') {
+            out.push({ role: 'user', content: i === 0 && call.context ? `${call.context}\n\n${m.content}` : m.content });
+        }
+        else if (m.role === 'assistant') {
+            const text = m.content.filter((b) => b.type === 'text').map((b) => (b.type === 'text' ? b.text : '')).join('');
+            const calls = m.content.flatMap((b) => (b.type === 'tool_call'
+                ? [{ id: b.id, type: 'function', function: { name: b.name, arguments: b.rawInput ?? JSON.stringify(b.input ?? {}) } }]
+                : []));
+            out.push({ role: 'assistant', content: text || null, ...(calls.length ? { tool_calls: calls } : {}) });
+        }
+        else {
+            for (const r of m.results)
+                out.push({ role: 'tool', tool_call_id: r.callId, content: r.content });
+        }
+    });
+    return out;
+}
+const STOP = {
+    stop: 'end_turn', tool_calls: 'tool_use', function_call: 'tool_use', length: 'max_tokens', content_filter: 'refusal',
+};
+export function fromChatResponse(body) {
+    const choice = body.choices?.[0];
+    const content = [];
+    const text = choice?.message?.content;
+    if (typeof text === 'string' && text)
+        content.push({ type: 'text', text });
+    for (const [i, tc] of (choice?.message?.tool_calls ?? []).entries()) {
+        const raw = tc.function?.arguments ?? '';
+        let input;
+        let parsed = true;
+        try {
+            input = raw ? JSON.parse(raw) : {};
+        }
+        catch {
+            parsed = false; // reported to the model as INVALID_JSON by the registry
+        }
+        content.push({ type: 'tool_call', id: tc.id ?? `call-${i}`, name: tc.function?.name ?? '', input, ...(parsed ? {} : { rawInput: raw }) });
+    }
+    const refusal = choice?.message?.refusal;
+    const finish = choice?.finish_reason ?? '';
+    return {
+        content,
+        stopReason: refusal ? 'refusal' : STOP[finish] ?? 'other',
+        usage: chatCompletionsUsage(body),
+        ...(body.model ? { servedModel: body.model } : {}),
+        ...(refusal ? { refusal: { category: null, explanation: refusal } } : {}),
+    };
+}
+export function openAiTransport(config, fetchImpl = fetch) {
+    const baseUrl = (config.baseUrl ?? 'https://api.openai.com/v1').replace(/\/+$/, '');
+    return async (call) => {
+        const response = await fetchImpl(`${baseUrl}/chat/completions`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${config.apiKey}` },
+            body: JSON.stringify({
+                model: call.model,
+                max_completion_tokens: call.maxOutputTokens,
+                messages: toChatMessages(call),
+                tools: call.tools.map((t) => ({ type: 'function', function: { name: t.name, description: t.description, parameters: t.inputSchema } })),
+                tool_choice: 'auto',
+                ...(config.reasoningEffort && call.effort ? { reasoning_effort: call.effort === 'xhigh' || call.effort === 'max' ? 'high' : call.effort } : {}),
+            }),
+            signal: call.signal,
+        });
+        if (!response.ok)
+            throw new Error(`the AI provider answered HTTP ${response.status}`);
+        const turn = fromChatResponse(await response.json());
+        for (const b of turn.content)
+            if (b.type === 'text')
+                call.onText(b.text);
+        return turn;
+    };
+}
+//# sourceMappingURL=openai.js.map

package/dist/providers/openai.js.map

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

package/dist/runner/context.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The volatile context block of a run: the document summary and the user's
+ * attachments. It is built ONCE at the start of a run and sent unchanged
+ * with every request, after the cached prefix (tools, system prompt), so
+ * the conversation stays append-only. The model reads later document state
+ * through `ids_read`.
+ *
+ * Attachment text is untrusted: it is fenced and labelled as data so the
+ * model treats instructions inside it as content (prompt-injection guard,
+ * `06-ai-agent.md` §6.7).
+ */
+import type { StudioDocument } from '@ifc-lite/ids-authoring';
+import type { ContextPart } from './privacy.js';
+export interface Attachment {
+    /** Shown to the model as a label; never a file path. */
+    label: string;
+    text: string;
+}
+export declare function buildContext(doc: StudioDocument, attachments: readonly Attachment[]): ContextPart[];
+export declare function joinContext(parts: readonly ContextPart[]): string;
+//# sourceMappingURL=context.d.ts.map

package/dist/runner/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/runner/context.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,UAAU;IACzB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAOD,wBAAgB,YAAY,CAAC,GAAG,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,UAAU,EAAE,GAAG,WAAW,EAAE,CAYnG;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAEjE"}

package/dist/runner/context.js

@@ -0,0 +1,25 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { summarizeDocument } from '../tools/ids-read.js';
+/** Strip anything that could close the data fence early. */
+function fenced(text) {
+    return text.replace(/<\/?untrusted_data[^>]*>/gi, '[tag removed]');
+}
+export function buildContext(doc, attachments) {
+    const parts = [{
+            source: 'document',
+            label: 'Document summary',
+            text: `Current IDS document (node ids for ops; read details with ids_read):\n${JSON.stringify(summarizeDocument(doc))}`,
+        }];
+    attachments.forEach((a, i) => parts.push({
+        source: 'attachments',
+        label: a.label || `Attachment ${i + 1}`,
+        text: `<untrusted_data source="attachment ${i + 1}" label="${a.label.replace(/["<>]/g, '')}">\n${fenced(a.text)}\n</untrusted_data>`,
+    }));
+    return parts;
+}
+export function joinContext(parts) {
+    return parts.map((p) => p.text).join('\n\n');
+}
+//# sourceMappingURL=context.js.map

package/dist/runner/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/runner/context.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAgB/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAQzD,4DAA4D;AAC5D,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,4BAA4B,EAAE,eAAe,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAmB,EAAE,WAAkC;IAClF,MAAM,KAAK,GAAkB,CAAC;YAC5B,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,kBAAkB;YACzB,IAAI,EAAE,yEAAyE,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE;SACxH,CAAC,CAAC;IACH,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;QACvC,MAAM,EAAE,aAAa;QACrB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE;QACvC,IAAI,EAAE,sCAAsC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,qBAAqB;KACrI,CAAC,CAAC,CAAC;IACJ,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAA6B;IACvD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC"}

package/dist/runner/loop.d.ts

@@ -0,0 +1,96 @@
+/**
+ * The agent loop (`06-ai-agent.md` §4, ADR-008).
+ *
+ * request → model turn → tool calls → results → next turn, until one of:
+ * the model ends its turn, the root budget is exhausted, the same failure
+ * signature comes back twice in a row (no progress), the caller cancels, a
+ * request times out, the wall-clock cap passes, the model refuses, or it is
+ * cut off without a usable answer.
+ *
+ * Every turn goes through `runToolTurn` from `@ifc-lite/ai` (budget,
+ * deadline, cancel, receipt). Tools run one at a time, in the order the model
+ * called them, against the sandbox; their results go back in one message.
+ * Whatever the stop reason, the run returns the proposal built so far.
+ */
+import { type RootBudget, type ToolTurnMessage, type ToolTurnTransport, type UsageReceipt } from '@ifc-lite/ai';
+import { type GateContext, type LintContext, type StudioDocument, type Uuid } from '@ifc-lite/ids-authoring';
+import { type AskUserHandler, type BsddClient, type ModelBridge } from '../bridges.js';
+import { type AgentMode } from '../prompts/system-v1.js';
+import type { AgentRunStatus, Proposal } from '../proposal/proposal.js';
+import { type Attachment } from './context.js';
+import type { SentRequest } from './privacy.js';
+import { type ModelPricing } from './receipt.js';
+/** The model the agent uses unless the host chooses another (D3: the viewer assistant's default). */
+export declare const DEFAULT_AGENT_MODEL = "claude-opus-5-5";
+export type AgentEvent = {
+    type: 'text';
+    delta: string;
+} | {
+    type: 'thinking';
+    delta: string;
+} | {
+    type: 'request';
+    index: number;
+} | {
+    type: 'receipt';
+    receipt: UsageReceipt;
+} | {
+    type: 'tool-call';
+    callId: string;
+    name: string;
+} | {
+    type: 'tool-result';
+    callId: string;
+    name: string;
+    ok: boolean;
+    summary: string;
+} | {
+    type: 'stopped';
+    status: AgentRunStatus;
+    message?: string;
+};
+export interface AgentRunOptions {
+    transport: ToolTurnTransport;
+    /** Default `DEFAULT_AGENT_MODEL`. */
+    model?: string;
+    /** Recorded on receipts, e.g. `anthropic`, `openai`, `replay`. */
+    route?: string;
+    mode: AgentMode;
+    request: string;
+    attachments?: readonly Attachment[];
+    doc: StudioDocument;
+    gate: GateContext;
+    lint: LintContext;
+    modelBridge?: ModelBridge;
+    bsdd?: BsddClient;
+    /** Default: the first choice (headless, non-interactive). */
+    askUser?: AskUserHandler;
+    /** Default: the mode's root budget. Pass a restored budget to resume spending from it. */
+    budget?: RootBudget;
+    limits?: {
+        /** Whole-run cap. Default 10 minutes. */
+        wallClockMs?: number;
+        /** Per-request deadline. Default 5 minutes. */
+        requestTimeoutMs?: number;
+        /** The route's hard output ceiling. Default 64k. */
+        routeCeiling?: number;
+        /** Tool results longer than this are cut (with a note). Default 16k characters. */
+        maxResultChars?: number;
+    };
+    pricing?: ModelPricing;
+    signal?: AbortSignal;
+    runId?: Uuid;
+    onEvent?: (event: AgentEvent) => void;
+}
+export interface AgentRun {
+    runId: Uuid;
+    status: AgentRunStatus;
+    message?: string;
+    proposal: Proposal;
+    /** Every message of the conversation, in order (requests sent prefixes of it). */
+    transcript: ToolTurnMessage[];
+    /** What each request carried, for the privacy view. */
+    sent: SentRequest[];
+}
+export declare function runAgent(options: AgentRunOptions): Promise<AgentRun>;
+//# sourceMappingURL=loop.d.ts.map

package/dist/runner/loop.d.ts.map

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

package/dist/runner/loop.js

@@ -0,0 +1,194 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * The agent loop (`06-ai-agent.md` §4, ADR-008).
+ *
+ * request → model turn → tool calls → results → next turn, until one of:
+ * the model ends its turn, the root budget is exhausted, the same failure
+ * signature comes back twice in a row (no progress), the caller cancels, a
+ * request times out, the wall-clock cap passes, the model refuses, or it is
+ * cut off without a usable answer.
+ *
+ * Every turn goes through `runToolTurn` from `@ifc-lite/ai` (budget,
+ * deadline, cancel, receipt). Tools run one at a time, in the order the model
+ * called them, against the sandbox; their results go back in one message.
+ * Whatever the stop reason, the run returns the proposal built so far.
+ */
+import { createRootBudget, runToolTurn } from '@ifc-lite/ai';
+import { uuidv7 } from '@ifc-lite/ids-authoring';
+import { firstChoice } from '../bridges.js';
+import { MODES } from '../modes.js';
+import { SYSTEM_PROMPT_VERSION, systemPrompt } from '../prompts/system-v1.js';
+import { brief, createSandbox } from '../sandbox/sandbox.js';
+import { registryFor } from '../tools/index.js';
+import { buildContext, joinContext } from './context.js';
+import { costOf, sha256Hex, totalsOf } from './receipt.js';
+/** The model the agent uses unless the host chooses another (D3: the viewer assistant's default). */
+export const DEFAULT_AGENT_MODEL = 'claude-opus-5-5';
+function serialise(data, max) {
+    const text = JSON.stringify(data);
+    return text.length <= max ? text : `${text.slice(0, max)}… [truncated: ${text.length - max} more characters; narrow the request]`;
+}
+async function previewsFor(sandbox, bridge, signal) {
+    const previews = {};
+    if (!bridge || signal.aborted)
+        return previews;
+    const touched = [...new Set(sandbox.batches.flatMap((b) => b.specIds))].slice(0, 20);
+    for (const specId of touched) {
+        const index = sandbox.doc.nodes.specs.findIndex((s) => s.id === specId);
+        if (index < 0)
+            continue;
+        const spec = sandbox.doc.ids.specifications[index];
+        previews[specId] = await bridge.count({
+            applicability: spec.applicability.facets, requirements: spec.requirements.map((r) => r.facet), ifcVersions: spec.ifcVersions,
+        }, signal);
+    }
+    return previews;
+}
+export async function runAgent(options) {
+    const mode = MODES[options.mode];
+    const model = options.model ?? DEFAULT_AGENT_MODEL;
+    const route = options.route ?? 'agent';
+    const runId = options.runId ?? uuidv7();
+    const limits = { wallClockMs: 600_000, requestTimeoutMs: 300_000, routeCeiling: 64_000, maxResultChars: 16_000, ...options.limits };
+    const emit = options.onEvent ?? (() => undefined);
+    const controller = new AbortController();
+    const abort = () => controller.abort(options.signal?.reason);
+    if (options.signal?.aborted)
+        abort();
+    options.signal?.addEventListener('abort', abort, { once: true });
+    const sandbox = createSandbox({ doc: options.doc, gate: options.gate, lint: options.lint, runId, model, ...(mode.opGuard ? { opGuard: mode.opGuard } : {}) });
+    const registry = registryFor(mode, { model: Boolean(options.modelBridge), bsdd: Boolean(options.bsdd) });
+    const tools = registry.specs();
+    const system = systemPrompt(options.mode);
+    const contextParts = buildContext(options.doc, options.attachments ?? []);
+    const context = joinContext(contextParts);
+    const budget = options.budget ?? createRootBudget(mode.budget);
+    const questions = [];
+    const askUser = options.askUser ?? firstChoice;
+    const recordingAskUser = async (question, signal) => {
+        const picked = await askUser(question, signal);
+        questions.push({ id: question.id, question: question.question, choices: question.choices.map((c) => c.label), picked });
+        return picked;
+    };
+    const transcript = [{ role: 'user', content: options.request }];
+    const sent = [];
+    const receipts = [];
+    const toolCalls = [];
+    const startedAt = Date.now();
+    let status = 'completed';
+    let message;
+    let finalText = '';
+    let lastSignature = '';
+    try {
+        if (mode.needsModel && !options.modelBridge) {
+            status = 'error';
+            message = `${options.mode} mode needs a loaded model.`;
+        }
+        while (status === 'completed') {
+            if (controller.signal.aborted) {
+                status = 'cancelled';
+                break;
+            }
+            const elapsed = Date.now() - startedAt;
+            if (elapsed >= limits.wallClockMs) {
+                status = 'wall-clock';
+                break;
+            }
+            const index = sent.length;
+            sent.push({ index, at: Date.now(), model, route, promptVersion: SYSTEM_PROMPT_VERSION, system, context: contextParts,
+                messageCount: transcript.length, toolNames: tools.map((t) => t.name) });
+            emit({ type: 'request', index });
+            const outcome = await runToolTurn({
+                model, route, transport: options.transport, system, context, messages: [...transcript], tools,
+                effort: mode.effort, taskBudget: mode.taskBudget, maxOutputTokens: mode.maxOutputTokens, routeCeiling: limits.routeCeiling,
+                budget, signal: controller.signal, timeoutMs: Math.min(limits.requestTimeoutMs, limits.wallClockMs - elapsed),
+                onText: (delta) => emit({ type: 'text', delta }), onThinking: (delta) => emit({ type: 'thinking', delta }),
+            }, { onReceipt: (receipt) => { receipts.push(receipt); emit({ type: 'receipt', receipt }); } });
+            if (outcome.kind === 'refused') {
+                sent.pop();
+                status = 'budget-exhausted';
+                break;
+            }
+            if (outcome.kind === 'cancelled') {
+                status = 'cancelled';
+                break;
+            }
+            if (outcome.kind === 'timeout') {
+                status = 'timeout';
+                break;
+            }
+            if (outcome.kind === 'error') {
+                status = 'error';
+                message = outcome.message;
+                break;
+            }
+            const { turn } = outcome;
+            transcript.push({ role: 'assistant', content: turn.content });
+            const text = turn.content.filter((b) => b.type === 'text').map((b) => b.text).join('');
+            if (text.trim())
+                finalText = text;
+            if (turn.stopReason === 'refusal') {
+                status = 'refused';
+                message = turn.refusal?.explanation ?? turn.refusal?.category ?? undefined;
+                break;
+            }
+            if (turn.stopReason === 'pause_turn')
+                continue;
+            const calls = turn.content.filter((b) => b.type === 'tool_call');
+            if (calls.length === 0) {
+                if (turn.stopReason === 'max_tokens')
+                    status = 'truncated';
+                break;
+            }
+            const results = [];
+            const signature = [];
+            for (const call of calls) {
+                emit({ type: 'tool-call', callId: call.id, name: call.name });
+                const started = Date.now();
+                // A call cut off at the output ceiling may parse as a silently shortened object: never run it.
+                const result = turn.stopReason === 'max_tokens'
+                    ? { ok: false, summary: `${call.name}: cut off`, data: { ok: false, error: 'Your output was cut off before this call was complete; it was not run. Send a smaller batch.' }, signature: [`TRUNCATED:${call.name}`] }
+                    : await registry.call(call.name, call.input, call.rawInput, {
+                        sandbox, gate: options.gate, askUser: recordingAskUser, signal: controller.signal, callId: call.id,
+                        ...(options.modelBridge ? { model: options.modelBridge } : {}), ...(options.bsdd ? { bsdd: options.bsdd } : {}),
+                    });
+                toolCalls.push({ turn: index, name: call.name, ok: result.ok, summary: result.summary, ms: Date.now() - started });
+                emit({ type: 'tool-result', callId: call.id, name: call.name, ok: result.ok, summary: result.summary });
+                results.push({ callId: call.id, content: serialise(result.data, limits.maxResultChars), isError: !result.ok });
+                signature.push(...(result.signature ?? []));
+            }
+            transcript.push({ role: 'tool', results });
+            const key = [...new Set(signature)].sort().join('|');
+            if (key && key === lastSignature) {
+                status = 'no-progress';
+                message = `The same problems came back twice: ${[...new Set(signature)].slice(0, 5).join(', ')}`;
+                break;
+            }
+            lastSignature = key;
+        }
+    }
+    finally {
+        options.signal?.removeEventListener('abort', abort);
+    }
+    const previews = status === 'completed' ? await previewsFor(sandbox, options.modelBridge, controller.signal) : {};
+    const totals = totalsOf(receipts);
+    const receipt = {
+        runId, mode: options.mode, model, promptVersion: SYSTEM_PROMPT_VERSION, requests: receipts, toolCalls, totals,
+        ...(options.pricing ? { costUsd: costOf(totals, options.pricing) } : {}),
+        payloadDigest: await sha256Hex(JSON.stringify(sent.map((s) => ({ ...s, messages: transcript.slice(0, s.messageCount) })))),
+    };
+    emit({ type: 'stopped', status, ...(message ? { message } : {}) });
+    return {
+        runId, status, ...(message ? { message } : {}), transcript, sent,
+        proposal: {
+            runId, mode: options.mode, model, promptVersion: SYSTEM_PROMPT_VERSION, status, summary: finalText,
+            base: { docId: options.doc.docId, specs: options.doc.nodes.specs.map((s, i) => ({ specId: s.id, name: options.doc.ids.specifications[i].name })) },
+            batches: [...sandbox.batches], unresolved: [...sandbox.unresolved], questions,
+            diagnostics: sandbox.diagnostics().filter((d) => d.severity !== 'info').map(brief),
+            draft: sandbox.doc, previews, receipt,
+        },
+    };
+}
+//# sourceMappingURL=loop.js.map