@chatcops/core 0.3.2 → 0.5.0

package/dist/agent/chat.d.ts

@@ -0,0 +1,13 @@
+import type { AIProvider } from '../providers/types.js';
+import type { ProviderChatParams } from '../types.js';
+type SteppingProvider = AIProvider & Required<Pick<AIProvider, 'step'>>;
+/**
+ * `chat()` for providers that have `step()`: runs a turn and yields its text.
+ * Errors throw, as they did before turns existed: a refusal, the tool round
+ * limit, a provider error, and an abort.
+ */
+export declare function chatViaTurn(provider: SteppingProvider, params: ProviderChatParams): AsyncGenerator<string>;
+/** `chatSync()` on top of `chat()`: the whole reply as one string. */
+export declare function chatSyncViaTurn(provider: SteppingProvider, params: ProviderChatParams): Promise<string>;
+export {};
+//# sourceMappingURL=chat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/agent/chat.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAItD,KAAK,gBAAgB,GAAG,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAExE;;;;GAIG;AACH,wBAAuB,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC,CAyBjH;AAED,sEAAsE;AACtE,wBAAsB,eAAe,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAI7G"}

package/dist/agent/chat.js

@@ -0,0 +1,42 @@
+import { MAX_TOOL_ROUNDS } from '../providers/tool-execution.js';
+import { runTurn } from './run-turn.js';
+import { executorRegistry } from './tool-registry.js';
+/**
+ * `chat()` for providers that have `step()`: runs a turn and yields its text.
+ * Errors throw, as they did before turns existed: a refusal, the tool round
+ * limit, a provider error, and an abort.
+ */
+export async function* chatViaTurn(provider, params) {
+    const turn = runTurn({
+        provider,
+        messages: params.messages,
+        systemPrompt: params.systemPrompt,
+        tools: executorRegistry(params.tools, params.toolExecutor),
+        conversationId: '',
+        maxSteps: MAX_TOOL_ROUNDS + 1,
+        toolTimeoutMs: params.toolTimeoutMs,
+        maxTokens: params.maxTokens,
+        temperature: params.temperature,
+        signal: params.signal,
+    });
+    let next = await turn.next();
+    while (!next.done) {
+        if (next.value.type === 'text-delta')
+            yield next.value.delta;
+        next = await turn.next();
+    }
+    const result = next.value;
+    if (result.status === 'aborted') {
+        throw params.signal?.reason ?? new DOMException('The operation was aborted.', 'AbortError');
+    }
+    if (result.error !== undefined)
+        throw result.error;
+}
+/** `chatSync()` on top of `chat()`: the whole reply as one string. */
+export async function chatSyncViaTurn(provider, params) {
+    let text = '';
+    for await (const chunk of chatViaTurn(provider, params))
+        text += chunk;
+    return text;
+}
+//# sourceMappingURL=chat.js.map

package/dist/agent/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../src/agent/chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAItD;;;;GAIG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,WAAW,CAAC,QAA0B,EAAE,MAA0B;IACvF,MAAM,IAAI,GAAG,OAAO,CAAC;QACnB,QAAQ;QACR,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,KAAK,EAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC;QAC1D,cAAc,EAAE,EAAE;QAClB,QAAQ,EAAE,eAAe,GAAG,CAAC;QAC7B,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;IAEH,IAAI,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY;YAAE,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;QAC7D,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1B,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,IAAI,YAAY,CAAC,4BAA4B,EAAE,YAAY,CAAC,CAAC;IAC9F,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,MAAM,MAAM,CAAC,KAAK,CAAC;AACrD,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAA0B,EAAE,MAA0B;IAC1F,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAE,IAAI,IAAI,KAAK,CAAC;IACvE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/agent/errors.d.ts

@@ -0,0 +1,14 @@
+/** The model declined to answer. */
+export declare class RefusalError extends Error {
+    constructor();
+}
+/** The provider's safety filter stopped the reply. */
+export declare class ContentFilterError extends Error {
+    constructor();
+}
+/** The model kept asking for tools after the last allowed round. */
+export declare class MaxStepsError extends Error {
+    readonly toolRounds: number;
+    constructor(toolRounds: number);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/agent/errors.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,qBAAa,YAAa,SAAQ,KAAK;;CAKtC;AAED,sDAAsD;AACtD,qBAAa,kBAAmB,SAAQ,KAAK;;CAK5C;AAED,oEAAoE;AACpE,qBAAa,aAAc,SAAQ,KAAK;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM;gBAAlB,UAAU,EAAE,MAAM;CAIxC"}

package/dist/agent/errors.js

@@ -0,0 +1,24 @@
+/** The model declined to answer. */
+export class RefusalError extends Error {
+    constructor() {
+        super('The model declined to answer this request (refusal).');
+        this.name = 'RefusalError';
+    }
+}
+/** The provider's safety filter stopped the reply. */
+export class ContentFilterError extends Error {
+    constructor() {
+        super("The provider's content filter stopped the reply.");
+        this.name = 'ContentFilterError';
+    }
+}
+/** The model kept asking for tools after the last allowed round. */
+export class MaxStepsError extends Error {
+    toolRounds;
+    constructor(toolRounds) {
+        super(`Exceeded maximum tool rounds (${toolRounds}).`);
+        this.toolRounds = toolRounds;
+        this.name = 'MaxStepsError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/agent/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/agent/errors.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC;QACE,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,sDAAsD;AACtD,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C;QACE,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,oEAAoE;AACpE,MAAM,OAAO,aAAc,SAAQ,KAAK;IACjB;IAArB,YAAqB,UAAkB;QACrC,KAAK,CAAC,iCAAiC,UAAU,IAAI,CAAC,CAAC;QADpC,eAAU,GAAV,UAAU,CAAQ;QAErC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/agent/index.d.ts

@@ -0,0 +1,5 @@
+export { runTurn, DEFAULT_MAX_STEPS, type RunTurnOptions, type TurnResult } from './run-turn.js';
+export { toolRegistry, executorRegistry, toolOutput, MAX_TOOL_OUTPUT_CHARS, type ToolRegistry, type ToolRunContext, } from './tool-registry.js';
+export { RefusalError, ContentFilterError, MaxStepsError } from './errors.js';
+export { chatViaTurn, chatSyncViaTurn } from './chat.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AACjG,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}

package/dist/agent/index.js

@@ -0,0 +1,5 @@
+export { runTurn, DEFAULT_MAX_STEPS } from './run-turn.js';
+export { toolRegistry, executorRegistry, toolOutput, MAX_TOOL_OUTPUT_CHARS, } from './tool-registry.js';
+export { RefusalError, ContentFilterError, MaxStepsError } from './errors.js';
+export { chatViaTurn, chatSyncViaTurn } from './chat.js';
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAwC,MAAM,eAAe,CAAC;AACjG,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,qBAAqB,GAGtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}

package/dist/agent/run-turn.d.ts

@@ -0,0 +1,68 @@
+import { type WireFinishReason, type WirePart } from '../protocol/v1.js';
+import type { AIProvider } from '../providers/types.js';
+import type { ChatMessage, MessagePart, TokenUsage } from '../types.js';
+import { type BudgetContext, type BudgetGuard } from '../limits/budget.js';
+import { type ToolRegistry } from './tool-registry.js';
+/** Model requests per turn: five tool rounds and the answer after them, as in 0.5. */
+export declare const DEFAULT_MAX_STEPS = 6;
+export interface RunTurnOptions {
+    provider: AIProvider;
+    /** The history to send, oldest first, ending with the visitor's message. */
+    messages: ChatMessage[];
+    systemPrompt: string;
+    /** Per-request instructions, sent after the system prompt and outside the cached prefix. */
+    systemContext?: string;
+    tools?: ToolRegistry;
+    conversationId: string;
+    /** The id to save the reply under. A new one by default. */
+    messageId?: string;
+    /** Model requests in this turn, counting the final answer. Default 6. */
+    maxSteps?: number;
+    toolTimeoutMs?: number;
+    maxTokens?: number;
+    temperature?: number;
+    /** Aborts the turn, for example when the visitor disconnects. */
+    signal?: AbortSignal;
+    /** Adds token usage to the `finish` part. */
+    exposeUsage?: boolean;
+    /**
+     * Checked before each model request and charged after it. A used-up
+     * budget ends the reply with `budget_exceeded`, and the reply length is
+     * capped to the tokens left.
+     */
+    budget?: {
+        guard: BudgetGuard;
+        context: BudgetContext;
+    };
+    /**
+     * Saves the reply. Called after each tool round with `final: false`, and
+     * once at the end with `final: true` and the reply's final status.
+     */
+    onPersist?(message: ChatMessage, info: {
+        final: boolean;
+    }): Promise<void> | void;
+    /** Called as each tool call, tool result and emitted part (a captured lead) is added. */
+    onPart?(part: MessagePart): void;
+}
+export interface TurnResult {
+    /** `complete`, or `incomplete` (an error, the token limit, the step limit), or `aborted`. */
+    status: NonNullable<ChatMessage['status']>;
+    message: ChatMessage;
+    usage: TokenUsage;
+    finishReason: WireFinishReason;
+    /** What went wrong, for `incomplete` turns that ended in an error. */
+    error?: unknown;
+}
+/** One system prompt, for providers that take only one. */
+export declare function joinSystem(systemPrompt: string, systemContext?: string): string;
+/**
+ * Runs one reply: model steps, tool calls between them, and saving the reply
+ * as it grows. Yields protocol v1 parts, starting with `start` and always
+ * ending with `finish`, and returns what happened.
+ *
+ * Provider errors don't throw: they become an `error` part, a `finish` with
+ * reason `error`, and `result.error`. An abort ends with reason `aborted`.
+ * Only a failing `onPersist` throws.
+ */
+export declare function runTurn(options: RunTurnOptions): AsyncGenerator<WirePart, TurnResult>;
+//# sourceMappingURL=run-turn.d.ts.map

package/dist/agent/run-turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-turn.d.ts","sourceRoot":"","sources":["../../src/agent/run-turn.ts"],"names":[],"mappings":"AACA,OAAO,EAAwC,KAAK,gBAAgB,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC/G,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EAGX,UAAU,EAIX,MAAM,aAAa,CAAC;AACrB,OAAO,EAAuB,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGhG,OAAO,EAAoB,KAAK,YAAY,EAAc,MAAM,oBAAoB,CAAC;AAErF,sFAAsF;AACtF,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,UAAU,CAAC;IACrB,4EAA4E;IAC5E,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,4FAA4F;IAC5F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,aAAa,CAAA;KAAE,CAAC;IACxD;;;OAGG;IACH,SAAS,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACjF,yFAAyF;IACzF,MAAM,CAAC,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,6FAA6F;IAC7F,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3C,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,UAAU,CAAC;IAClB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,sEAAsE;IACtE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAID,2DAA2D;AAC3D,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/E;AA8DD;;;;;;;;GAQG;AACH,wBAAuB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,CAAC,QAAQ,EAAE,UAAU,CAAC,CA6Q5F"}

package/dist/agent/run-turn.js

@@ -0,0 +1,344 @@
+import { messageText } from '../parts.js';
+import { PROTOCOL_VERSION } from '../protocol/v1.js';
+import { BudgetExceededError } from '../limits/budget.js';
+import { DEFAULT_MAX_TOKENS } from '../providers/base.js';
+import { ContentFilterError, MaxStepsError, RefusalError } from './errors.js';
+import { executorRegistry, toolOutput } from './tool-registry.js';
+/** Model requests per turn: five tool rounds and the answer after them, as in 0.5. */
+export const DEFAULT_MAX_STEPS = 6;
+const NO_TOOLS = executorRegistry([]);
+/** One system prompt, for providers that take only one. */
+export function joinSystem(systemPrompt, systemContext) {
+    return systemContext ? `${systemPrompt}\n\n${systemContext}` : systemPrompt;
+}
+/** Never ask for fewer output tokens than this, even with little budget left. */
+const MIN_STEP_TOKENS = 256;
+function addUsage(total, step) {
+    total.inputTokens += step.inputTokens;
+    total.outputTokens += step.outputTokens;
+    if (step.cacheReadTokens)
+        total.cacheReadTokens = (total.cacheReadTokens ?? 0) + step.cacheReadTokens;
+    if (step.cacheWriteTokens)
+        total.cacheWriteTokens = (total.cacheWriteTokens ?? 0) + step.cacheWriteTokens;
+}
+/**
+ * Signatures only matter within the turn that produced them. Dropping them
+ * once the turn is over keeps stored conversations small, and providers
+ * accept history without them.
+ */
+function withoutReplayData(parts) {
+    const out = [];
+    for (const part of parts) {
+        if (!('providerMetadata' in part) || !part.providerMetadata) {
+            out.push(part);
+            continue;
+        }
+        const { claude: _claude, gemini, ...others } = part.providerMetadata;
+        const keptGemini = gemini?.syntheticId ? { gemini: { syntheticId: true } } : {};
+        const providerMetadata = { ...others, ...keptGemini };
+        const { providerMetadata: _, ...rest } = part;
+        if (part.type === 'reasoning' && part.text === '')
+            continue;
+        if (part.type === 'text' && part.text === '')
+            continue;
+        out.push(Object.keys(providerMetadata).length ? { ...rest, providerMetadata } : rest);
+    }
+    return out;
+}
+function resultPart(call, result) {
+    return {
+        type: 'tool-result',
+        toolCallId: call.id,
+        toolName: call.name,
+        output: toolOutput(result),
+        ...(result.success ? {} : { error: result.message ?? 'The tool failed.' }),
+    };
+}
+function toWire(part) {
+    switch (part.type) {
+        case 'tool-call':
+            return { type: 'tool-call', toolCallId: part.toolCallId, toolName: part.toolName, input: part.input, executor: part.executor };
+        case 'tool-result':
+            return { type: 'tool-result', toolCallId: part.toolCallId, output: part.output, ...(part.error ? { error: part.error } : {}) };
+        case 'lead-captured':
+            return { type: 'lead-captured', lead: part.lead };
+        case 'source':
+            return { type: 'source', sourceId: part.sourceId, url: part.url, ...(part.title ? { title: part.title } : {}), ...(part.snippet ? { snippet: part.snippet } : {}) };
+        default:
+            return null;
+    }
+}
+/**
+ * Runs one reply: model steps, tool calls between them, and saving the reply
+ * as it grows. Yields protocol v1 parts, starting with `start` and always
+ * ending with `finish`, and returns what happened.
+ *
+ * Provider errors don't throw: they become an `error` part, a `finish` with
+ * reason `error`, and `result.error`. An abort ends with reason `aborted`.
+ * Only a failing `onPersist` throws.
+ */
+export async function* runTurn(options) {
+    const { provider, signal } = options;
+    const tools = options.tools ?? NO_TOOLS;
+    const maxSteps = Math.max(1, options.maxSteps ?? DEFAULT_MAX_STEPS);
+    const toolSignal = signal ?? new AbortController().signal;
+    const usage = { inputTokens: 0, outputTokens: 0 };
+    const message = {
+        id: options.messageId ?? crypto.randomUUID(),
+        role: 'assistant',
+        content: '',
+        parts: [],
+        timestamp: Date.now(),
+        aiGenerated: true,
+    };
+    const parts = message.parts;
+    let textCount = 0;
+    const add = (part) => {
+        parts.push(part);
+        if (part.type !== 'text' && part.type !== 'reasoning')
+            options.onPart?.(part);
+        return toWire(part);
+    };
+    const persist = async (final) => {
+        message.content = messageText(parts);
+        message.usage = { ...usage };
+        if (!final)
+            message.status = 'incomplete';
+        await options.onPersist?.(message, { final });
+    };
+    async function* end(status, detail = {}) {
+        message.status = status;
+        message.parts = withoutReplayData(parts);
+        if (detail.errorPart)
+            yield { type: 'error', ...detail.errorPart };
+        const reason = status === 'aborted' ? 'aborted' : detail.errorPart ? 'error' : (detail.reason ?? 'stop');
+        message.content = messageText(message.parts);
+        message.usage = { ...usage };
+        await options.onPersist?.(message, { final: true });
+        yield {
+            type: 'finish',
+            reason,
+            ...(options.exposeUsage ? { usage: { inputTokens: usage.inputTokens, outputTokens: usage.outputTokens } } : {}),
+        };
+        return { status, message, usage, finishReason: reason, ...(detail.error !== undefined ? { error: detail.error } : {}) };
+    }
+    const failed = (error) => signal?.aborted
+        ? end('aborted')
+        : end('incomplete', {
+            error,
+            errorPart: { code: 'provider_error', retryable: true },
+        });
+    /**
+     * Checks the budget before a model request. Ends the turn when one is used
+     * up; otherwise resolves the reply length, capped to the tokens left.
+     */
+    async function* checkBudget(stepNumber) {
+        if (!options.budget)
+            return { maxTokens: options.maxTokens };
+        try {
+            const { tokensLeft } = await options.budget.guard.before(options.budget.context, stepNumber);
+            if (tokensLeft === undefined)
+                return { maxTokens: options.maxTokens };
+            const wanted = options.maxTokens ?? DEFAULT_MAX_TOKENS;
+            return { maxTokens: Math.min(wanted, Math.max(MIN_STEP_TOKENS, tokensLeft)) };
+        }
+        catch (error) {
+            if (!(error instanceof BudgetExceededError))
+                throw error;
+            return {
+                ended: yield* end('incomplete', {
+                    error,
+                    errorPart: { code: 'budget_exceeded', retryable: false, scope: error.scope },
+                }),
+            };
+        }
+    }
+    yield { type: 'start', protocol: PROTOCOL_VERSION, conversationId: options.conversationId, messageId: message.id };
+    if (!provider.step) {
+        return yield* legacyTurn();
+    }
+    const step = provider.step.bind(provider);
+    for (let stepNumber = 1;; stepNumber++) {
+        let textId = null;
+        let finish;
+        const calls = [];
+        const budget = yield* checkBudget(stepNumber);
+        if (budget.ended)
+            return budget.ended;
+        try {
+            signal?.throwIfAborted();
+            for await (const event of step({
+                messages: [...options.messages, message],
+                systemPrompt: options.systemPrompt,
+                ...(options.systemContext ? { systemContext: options.systemContext } : {}),
+                ...(tools.definitions.length ? { tools: tools.definitions } : {}),
+                maxTokens: budget.maxTokens,
+                temperature: options.temperature,
+                signal,
+            })) {
+                if (event.type === 'text-delta') {
+                    if (!event.delta)
+                        continue;
+                    if (!textId) {
+                        textId = `${message.id}-${++textCount}`;
+                        yield { type: 'text-start', id: textId };
+                    }
+                    yield { type: 'text-delta', id: textId, delta: event.delta };
+                }
+                else if (event.type === 'tool-call') {
+                    calls.push(event);
+                }
+                else if (event.type === 'finish') {
+                    finish = event;
+                }
+                // Reasoning is kept in the stored parts but never streamed (F01-D5).
+            }
+            if (!finish)
+                throw new Error(`The ${provider.name} step ended without finishing.`);
+        }
+        catch (error) {
+            if (textId)
+                yield { type: 'text-end', id: textId };
+            return yield* failed(error);
+        }
+        if (textId)
+            yield { type: 'text-end', id: textId };
+        addUsage(usage, finish.usage);
+        await options.budget?.guard.after(options.budget.context, finish.usage);
+        // A refused or filtered step isn't kept: there's nothing in it to send back.
+        if (finish.reason === 'refusal' || finish.reason === 'content-filter') {
+            return yield* end('incomplete', {
+                error: finish.reason === 'refusal' ? new RefusalError() : new ContentFilterError(),
+                errorPart: { code: 'content_filtered', retryable: false },
+            });
+        }
+        for (const part of finish.parts) {
+            const wire = add(part);
+            if (wire)
+                yield wire;
+        }
+        if (finish.reason === 'error') {
+            return yield* end('incomplete', {
+                error: new Error(`The ${provider.name} step stopped with an error.`),
+                errorPart: { code: 'provider_error', retryable: true },
+            });
+        }
+        if (finish.reason === 'length') {
+            console.warn('[chatcops] The reply was cut off at the token limit. Raise `maxTokens` if this keeps happening.');
+            return yield* end('incomplete', { reason: 'length' });
+        }
+        if (finish.reason !== 'tool-calls' || calls.length === 0) {
+            return yield* end('complete');
+        }
+        const callParts = new Map(parts.filter((part) => part.type === 'tool-call').map((part) => [part.toolCallId, part]));
+        if (stepNumber >= maxSteps) {
+            for (const { call } of calls) {
+                const wire = add(resultPart(call, { success: false, message: 'Not run: the reply reached its tool round limit.' }));
+                if (wire)
+                    yield wire;
+            }
+            return yield* end('incomplete', {
+                error: new MaxStepsError(maxSteps - 1),
+                errorPart: { code: 'tool_error', retryable: false },
+            });
+        }
+        // Every call of the step runs at once; results are kept in call order.
+        const results = await Promise.all(calls.map(({ call, inputError }) => inputError
+            ? Promise.resolve({ success: false, message: inputError })
+            : tools.run(call, { conversationId: options.conversationId, signal: toolSignal, timeoutMs: options.toolTimeoutMs })));
+        for (const [i, { call }] of calls.entries()) {
+            const result = results[i];
+            const callPart = callParts.get(call.id);
+            if (callPart)
+                callPart.state = result.success ? 'done' : 'error';
+            for (const part of [resultPart(call, result), ...(result.success ? tools.emits(call, result) : [])]) {
+                const wire = add(part);
+                if (wire)
+                    yield wire;
+            }
+        }
+        if (signal?.aborted)
+            return yield* end('aborted');
+        await persist(false);
+    }
+    /**
+     * A provider written for 0.4 has `chat()` and runs tools itself. Its tool
+     * calls are recorded through the executor it's given, and their parts are
+     * streamed before the next text, the way the 0.5 server sent them.
+     */
+    async function* legacyTurn() {
+        // A 0.4 provider reports no usage, so its replies can only be checked, not charged.
+        const budget = yield* checkBudget(1);
+        if (budget.ended)
+            return budget.ended;
+        const queued = [];
+        let textId = null;
+        let text = null;
+        const toolExecutor = async (call) => {
+            text = null;
+            const callPart = {
+                type: 'tool-call', toolCallId: call.id, toolName: call.name, input: call.input, executor: 'server', state: 'pending',
+            };
+            const callWire = add(callPart);
+            if (callWire)
+                queued.push(callWire);
+            const result = await tools.run(call, { conversationId: options.conversationId, signal: toolSignal, timeoutMs: options.toolTimeoutMs });
+            callPart.state = result.success ? 'done' : 'error';
+            for (const part of [resultPart(call, result), ...(result.success ? tools.emits(call, result) : [])]) {
+                const wire = add(part);
+                if (wire)
+                    queued.push(wire);
+            }
+            return result;
+        };
+        try {
+            for await (const chunk of provider.chat({
+                // Providers written for 0.4 read `content` only, so a reply the
+                // visitor walked away from would look finished. Leave it out.
+                messages: options.messages.filter((m) => m.status !== 'aborted'),
+                systemPrompt: joinSystem(options.systemPrompt, options.systemContext),
+                ...(tools.definitions.length ? { tools: tools.definitions } : {}),
+                toolExecutor,
+                toolTimeoutMs: options.toolTimeoutMs,
+                maxTokens: budget.maxTokens,
+                temperature: options.temperature,
+                signal,
+            })) {
+                if (signal?.aborted)
+                    break;
+                if (!chunk)
+                    continue;
+                if (queued.length) {
+                    if (textId) {
+                        yield { type: 'text-end', id: textId };
+                        textId = null;
+                    }
+                    yield* queued.splice(0);
+                }
+                if (!textId) {
+                    textId = `${message.id}-${++textCount}`;
+                    yield { type: 'text-start', id: textId };
+                }
+                if (!text) {
+                    text = { type: 'text', text: '' };
+                    parts.push(text);
+                }
+                text.text += chunk;
+                yield { type: 'text-delta', id: textId, delta: chunk };
+            }
+        }
+        catch (error) {
+            if (textId)
+                yield { type: 'text-end', id: textId };
+            // Tool parts recorded so far are saved but not streamed, as in 0.5.
+            return yield* failed(error);
+        }
+        if (textId)
+            yield { type: 'text-end', id: textId };
+        if (signal?.aborted)
+            return yield* end('aborted');
+        yield* queued.splice(0);
+        return yield* end('complete');
+    }
+}
+//# sourceMappingURL=run-turn.js.map

package/dist/agent/run-turn.js.map

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

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

@@ -0,0 +1,28 @@
+import { type ChatTool } from '../tools/base.js';
+import type { MessagePart, ProviderToolCall, ProviderToolExecutor, ToolDefinition, ToolResult } from '../types.js';
+export interface ToolRunContext {
+    conversationId: string;
+    signal: AbortSignal;
+    timeoutMs?: number;
+}
+/** The tools a turn can call, and how to run them. */
+export interface ToolRegistry {
+    /** What the model is told about. */
+    definitions: ToolDefinition[];
+    /** Runs a call. Never throws: failures come back as `{ success: false }`. */
+    run(call: ProviderToolCall, context: ToolRunContext): Promise<ToolResult>;
+    /** Parts to add after a call, like a captured lead. */
+    emits(call: ProviderToolCall, result: ToolResult): MessagePart[];
+}
+/** A registry over `ChatTool` objects, as the server configures them. */
+export declare function toolRegistry(tools?: ChatTool[]): ToolRegistry;
+/**
+ * A registry over tool definitions and one executor function, the 0.4
+ * `toolExecutor` shape. The executor gets the call and nothing else.
+ */
+export declare function executorRegistry(definitions?: ToolDefinition[], executor?: ProviderToolExecutor): ToolRegistry;
+/** Tool output is stored with the conversation, so it's kept to JSON and a size. */
+export declare const MAX_TOOL_OUTPUT_CHARS = 64000;
+/** The stored output of a call: what the model saw, as plain JSON. */
+export declare function toolOutput(result: ToolResult): unknown;
+//# sourceMappingURL=tool-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/agent/tool-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,UAAU,EACX,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,6EAA6E;IAC7E,GAAG,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1E,uDAAuD;IACvD,KAAK,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,UAAU,GAAG,WAAW,EAAE,CAAC;CAClE;AAYD,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,KAAK,GAAE,QAAQ,EAAO,GAAG,YAAY,CAiBjE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,GAAE,cAAc,EAAO,EAAE,QAAQ,CAAC,EAAE,oBAAoB,GAAG,YAAY,CAWlH;AAED,oFAAoF;AACpF,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CActD"}