@chatcops/core 0.3.2 → 0.5.0

package/dist/providers/gemini.js

@@ -1,122 +1,265 @@
-import { GoogleGenerativeAI } from '@google/generative-ai';
-import { toProviderMessages, toGeminiTools } from './base.js';
-import { MAX_TOOL_ROUNDS, executeToolCall, serializeToolResult, } from './tool-execution.js';
-const DEFAULT_MODEL = 'gemini-2.0-flash';
-let toolCallSequence = 0;
+import { FinishReason as GeminiFinishReason, GoogleGenAI, ThinkingLevel, } from '@google/genai';
+import { chatSyncViaTurn, chatViaTurn } from '../agent/chat.js';
+import { joinSystem } from '../agent/run-turn.js';
+import { DEFAULT_MAX_TOKENS, toGeminiTools } from './base.js';
+import { normalizeTurns } from './history.js';
+const DEFAULT_MODEL = 'gemini-3.5-flash-lite';
+const DEFAULT_EFFORT = 'low';
 function createToolCallId() {
-    toolCallSequence += 1;
-    return `gemini_tool_call_${toolCallSequence}`;
+    return `gemini_call_${crypto.randomUUID()}`;
 }
-function toGeminiHistory(params) {
-    return toProviderMessages(params.messages)
-        .slice(0, -1)
-        .map((message) => ({
-        role: message.role === 'assistant' ? 'model' : 'user',
-        parts: [{ text: message.content }],
-    }));
+const THINKING_LEVELS = {
+    low: ThinkingLevel.LOW,
+    medium: ThinkingLevel.MEDIUM,
+    high: ThinkingLevel.HIGH,
+    xhigh: ThinkingLevel.HIGH,
+    max: ThinkingLevel.HIGH,
+};
+/** `thinkingLevel` is a Gemini 3 setting; older models use a token budget instead. */
+export function geminiSupportsThinkingLevel(model) {
+    const major = Number(model.match(/gemini-(\d+)/)?.[1] ?? 0);
+    return major >= 3;
 }
-function getLastMessage(params) {
-    const lastMessage = toProviderMessages(params.messages).at(-1)?.content ?? '';
-    if (!lastMessage) {
-        throw new Error('Cannot send empty message');
+function geminiMetadata(part) {
+    return 'providerMetadata' in part ? part.providerMetadata?.gemini : undefined;
+}
+/**
+ * Gemini 3 wants a thought signature on the first function call of each
+ * step. Calls that came from another provider have none, and Google
+ * documents this value for that case.
+ */
+const PLACEHOLDER_SIGNATURE = 'skip_thought_signature_validator';
+/**
+ * Stored history as Gemini contents. An assistant message with tool calls
+ * becomes a model turn with its `functionCall` parts, then a user turn with
+ * the `functionResponse` parts, for each step. Thought signatures go back on
+ * the parts they came with.
+ */
+export function toGeminiStepContents(messages, model = DEFAULT_MODEL) {
+    const contents = [];
+    const needsSignature = geminiSupportsThinkingLevel(model);
+    const synthetic = new Set();
+    const push = (role, parts) => {
+        if (parts.length === 0)
+            return;
+        const last = contents.at(-1);
+        if (last?.role === role)
+            last.parts = [...(last.parts ?? []), ...parts];
+        else
+            contents.push({ role, parts });
+    };
+    for (const turn of normalizeTurns(messages)) {
+        let role = turn.role === 'assistant' ? 'model' : 'user';
+        let run = [];
+        let signedCall = false;
+        for (const part of turn.parts) {
+            const partRole = part.type === 'tool-result' ? 'user' : turn.role === 'assistant' ? 'model' : 'user';
+            if (partRole !== role) {
+                push(role, run);
+                run = [];
+                role = partRole;
+                signedCall = false;
+            }
+            const meta = geminiMetadata(part);
+            const signature = meta?.thoughtSignature ? { thoughtSignature: meta.thoughtSignature } : {};
+            switch (part.type) {
+                case 'text':
+                    run.push({ text: part.text, ...signature });
+                    break;
+                case 'reasoning':
+                    // Thoughts from another provider mean nothing to Gemini.
+                    if (meta)
+                        run.push({ text: part.text, thought: true, ...signature });
+                    break;
+                case 'tool-call': {
+                    if (meta?.syntheticId)
+                        synthetic.add(part.toolCallId);
+                    const args = typeof part.input === 'object' && part.input !== null && !Array.isArray(part.input)
+                        ? part.input
+                        : {};
+                    const placeholder = needsSignature && !signedCall && !meta?.thoughtSignature
+                        ? { thoughtSignature: PLACEHOLDER_SIGNATURE }
+                        : {};
+                    signedCall = true;
+                    run.push({
+                        functionCall: { ...(meta?.syntheticId ? {} : { id: part.toolCallId }), name: part.toolName, args },
+                        ...signature,
+                        ...placeholder,
+                    });
+                    break;
+                }
+                case 'tool-result':
+                    run.push({
+                        functionResponse: {
+                            ...(synthetic.has(part.toolCallId) ? {} : { id: part.toolCallId }),
+                            name: part.toolName,
+                            response: part.output ?? { success: false, message: part.error },
+                        },
+                    });
+                    break;
+            }
+        }
+        push(role, run);
+    }
+    if (contents.length === 0) {
+        throw new Error('Cannot send a request with no user message.');
     }
-    return lastMessage;
+    return contents;
+}
+const CONTENT_FILTERED = new Set([
+    GeminiFinishReason.SAFETY,
+    GeminiFinishReason.RECITATION,
+    GeminiFinishReason.BLOCKLIST,
+    GeminiFinishReason.PROHIBITED_CONTENT,
+    GeminiFinishReason.SPII,
+    GeminiFinishReason.IMAGE_SAFETY,
+    GeminiFinishReason.IMAGE_PROHIBITED_CONTENT,
+]);
+function finishReason(reason, blocked, hasToolCalls) {
+    if (blocked || (reason && CONTENT_FILTERED.has(reason)))
+        return 'content-filter';
+    if (reason === GeminiFinishReason.MAX_TOKENS)
+        return 'length';
+    if (reason === GeminiFinishReason.MALFORMED_FUNCTION_CALL || reason === GeminiFinishReason.UNEXPECTED_TOOL_CALL)
+        return 'error';
+    if (hasToolCalls)
+        return 'tool-calls';
+    return 'stop';
+}
+/** Thinking tokens are billed as output, so they count as output here. */
+function toUsage(usage) {
+    const cached = usage?.cachedContentTokenCount ?? 0;
+    return {
+        inputTokens: usage?.promptTokenCount ?? 0,
+        outputTokens: (usage?.candidatesTokenCount ?? 0) + (usage?.thoughtsTokenCount ?? 0),
+        ...(cached ? { cacheReadTokens: cached } : {}),
+    };
 }
 export class GeminiProvider {
     name = 'gemini';
-    genAI;
+    ai;
     model;
+    effort;
     constructor(config) {
-        this.genAI = new GoogleGenerativeAI(config.apiKey);
+        if (!config.apiKey?.trim())
+            throw new Error('gemini requires apiKey');
+        this.ai = new GoogleGenAI({
+            apiKey: config.apiKey,
+            ...(config.baseURL || config.fetch
+                ? {
+                    httpOptions: {
+                        ...(config.baseURL ? { baseUrl: config.baseURL } : {}),
+                        ...(config.fetch ? { fetch: config.fetch } : {}),
+                    },
+                }
+                : {}),
+        });
         this.model = config.model ?? DEFAULT_MODEL;
+        this.effort = config.effort ?? DEFAULT_EFFORT;
     }
-    async *chat(params) {
-        const model = this.genAI.getGenerativeModel({
-            model: this.model,
-            systemInstruction: params.systemPrompt,
+    config(params) {
+        return {
+            systemInstruction: joinSystem(params.systemPrompt, params.systemContext),
+            maxOutputTokens: params.maxTokens ?? DEFAULT_MAX_TOKENS,
+            ...(params.temperature != null ? { temperature: params.temperature } : {}),
             ...(params.tools?.length ? { tools: toGeminiTools(params.tools) } : {}),
-        });
-        const chat = model.startChat({
-            history: toGeminiHistory(params),
-            generationConfig: {
-                maxOutputTokens: params.maxTokens ?? 1024,
-                ...(params.temperature != null ? { temperature: params.temperature } : {}),
-            },
-        });
-        let toolRounds = 0;
-        let request = getLastMessage(params);
-        while (true) {
-            const result = await chat.sendMessageStream(request);
-            for await (const chunk of result.stream) {
-                const text = chunk.text();
-                if (text) {
-                    yield text;
-                }
-            }
-            const response = await result.response;
-            const functionCalls = response.functionCalls() ?? [];
-            if (functionCalls.length === 0) {
-                return;
-            }
-            if (toolRounds >= MAX_TOOL_ROUNDS) {
-                throw new Error(`Exceeded maximum tool rounds (${MAX_TOOL_ROUNDS}).`);
-            }
-            toolRounds += 1;
-            request = await Promise.all(functionCalls.map(async (call) => {
-                const result = await executeToolCall(params, {
-                    id: createToolCallId(),
-                    name: call.name,
-                    input: call.args,
-                });
-                return {
-                    functionResponse: {
-                        name: call.name,
-                        response: serializeToolResult(result),
-                    },
-                };
-            }));
-        }
+            ...(geminiSupportsThinkingLevel(this.model)
+                ? { thinkingConfig: { thinkingLevel: THINKING_LEVELS[this.effort] } }
+                : {}),
+            ...(params.signal ? { abortSignal: params.signal } : {}),
+        };
     }
-    async chatSync(params) {
-        const model = this.genAI.getGenerativeModel({
+    /** One model request: streams text and thoughts, then reports tool calls, usage and why it stopped. */
+    async *step(params) {
+        params.signal?.throwIfAborted();
+        const stream = await this.ai.models.generateContentStream({
             model: this.model,
-            systemInstruction: params.systemPrompt,
-            ...(params.tools?.length ? { tools: toGeminiTools(params.tools) } : {}),
+            contents: toGeminiStepContents(params.messages, this.model),
+            config: this.config(params),
         });
-        const chat = model.startChat({
-            history: toGeminiHistory(params),
-            generationConfig: {
-                maxOutputTokens: params.maxTokens ?? 1024,
-                ...(params.temperature != null ? { temperature: params.temperature } : {}),
-            },
-        });
-        let toolRounds = 0;
-        let request = getLastMessage(params);
-        while (true) {
-            const result = await chat.sendMessage(request);
-            const response = result.response;
-            const functionCalls = response.functionCalls() ?? [];
-            if (functionCalls.length === 0) {
-                return response.text();
-            }
-            if (toolRounds >= MAX_TOOL_ROUNDS) {
-                throw new Error(`Exceeded maximum tool rounds (${MAX_TOOL_ROUNDS}).`);
+        const parts = [];
+        const calls = [];
+        // Text and thoughts arrive in pieces. A signature ends the part it's on.
+        let current = null;
+        let reason;
+        let blocked = false;
+        let usage;
+        for await (const chunk of stream) {
+            if (chunk.usageMetadata)
+                usage = chunk.usageMetadata;
+            if (chunk.promptFeedback?.blockReason)
+                blocked = true;
+            const candidate = chunk.candidates?.[0];
+            if (candidate?.finishReason)
+                reason = candidate.finishReason;
+            for (const part of candidate?.content?.parts ?? []) {
+                const signature = part.thoughtSignature;
+                if (part.functionCall) {
+                    current = null;
+                    const call = part.functionCall;
+                    const syntheticId = !call.id;
+                    const meta = {
+                        ...(signature ? { thoughtSignature: signature } : {}),
+                        ...(syntheticId ? { syntheticId: true } : {}),
+                    };
+                    const toolCall = {
+                        type: 'tool-call',
+                        toolCallId: call.id ?? createToolCallId(),
+                        toolName: call.name ?? '',
+                        input: call.args ?? {},
+                        executor: 'server',
+                        state: 'pending',
+                        ...(Object.keys(meta).length ? { providerMetadata: { gemini: { ...meta } } } : {}),
+                    };
+                    parts.push(toolCall);
+                    calls.push(toolCall);
+                    continue;
+                }
+                if (typeof part.text === 'string') {
+                    const kind = part.thought ? 'reasoning' : 'text';
+                    if (!current || current.type !== kind) {
+                        const next = kind === 'text' ? { type: 'text', text: '' } : { type: 'reasoning', text: '' };
+                        parts.push(next);
+                        current = next;
+                    }
+                    current.text += part.text;
+                    if (part.text)
+                        yield { type: kind === 'text' ? 'text-delta' : 'reasoning-delta', delta: part.text };
+                }
+                if (signature) {
+                    const target = current ?? parts.at(-1);
+                    if (target && (target.type === 'text' || target.type === 'reasoning')) {
+                        target.providerMetadata = { gemini: { thoughtSignature: signature } };
+                    }
+                    current = null;
+                }
             }
-            toolRounds += 1;
-            request = await Promise.all(functionCalls.map(async (call) => {
-                const toolResult = await executeToolCall(params, {
-                    id: createToolCallId(),
-                    name: call.name,
-                    input: call.args,
-                });
-                return {
-                    functionResponse: {
-                        name: call.name,
-                        response: serializeToolResult(toolResult),
-                    },
-                };
-            }));
         }
+        params.signal?.throwIfAborted();
+        for (const call of calls) {
+            yield {
+                type: 'tool-call',
+                call: { id: call.toolCallId, name: call.toolName, input: call.input },
+                ...(call.toolName ? {} : { inputError: 'The model sent a function call without a name.' }),
+            };
+        }
+        yield {
+            type: 'finish',
+            reason: finishReason(reason, blocked, calls.length > 0),
+            usage: toUsage(usage),
+            parts: parts.filter((part) => part.type !== 'text' || part.text !== '' || part.providerMetadata),
+        };
+    }
+    /**
+     * A turn with tools run through `params.toolExecutor`, as text.
+     * @deprecated Use `runTurn()`, which also returns the reply's parts, status and usage.
+     */
+    chat(params) {
+        return chatViaTurn(this, params);
+    }
+    /** @deprecated Use `runTurn()`. */
+    chatSync(params) {
+        return chatSyncViaTurn(this, params);
     }
 }
 //# sourceMappingURL=gemini.js.map

package/dist/providers/gemini.js.map

@@ -1 +1 @@
-{"version":3,"file":"gemini.js","sourceRoot":"","sources":["../../src/providers/gemini.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAA2B,MAAM,uBAAuB,CAAC;AAGpF,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EACL,eAAe,EACf,eAAe,EACf,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,aAAa,GAAG,kBAAkB,CAAC;AACzC,IAAI,gBAAgB,GAAG,CAAC,CAAC;AAEzB,SAAS,gBAAgB;IACvB,gBAAgB,IAAI,CAAC,CAAC;IACtB,OAAO,oBAAoB,gBAAgB,EAAE,CAAC;AAChD,CAAC;AAED,SAAS,eAAe,CAAC,MAA0B;IACjD,OAAO,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC;SACvC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;SACZ,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACjB,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;QACrD,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;KACnC,CAAC,CAAC,CAAC;AACR,CAAC;AAED,SAAS,cAAc,CAAC,MAA0B;IAChD,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,EAAE,CAAC;IAC9E,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,OAAO,cAAc;IACzB,IAAI,GAAG,QAAQ,CAAC;IACR,KAAK,CAAqB;IAC1B,KAAK,CAAS;IAEtB,YAAY,MAAsB;QAChC,IAAI,CAAC,KAAK,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,aAAa,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,CAAC,IAAI,CAAC,MAA0B;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC;YAC1C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,iBAAiB,EAAE,MAAM,CAAC,YAAY;YACtC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxE,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC;YAC3B,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC;YAChC,gBAAgB,EAAE;gBAChB,eAAe,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI;gBACzC,GAAG,CAAC,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC3E;SACF,CAAC,CAAC;QAEH,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,OAAO,GAAoB,cAAc,CAAC,MAAM,CAAC,CAAC;QAEtD,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAErD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBACxC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC1B,IAAI,IAAI,EAAE,CAAC;oBACT,MAAM,IAAI,CAAC;gBACb,CAAC;YACH,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC;YACvC,MAAM,aAAa,GAAG,QAAQ,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC;YACrD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC/B,OAAO;YACT,CAAC;YAED,IAAI,UAAU,IAAI,eAAe,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CAAC,iCAAiC,eAAe,IAAI,CAAC,CAAC;YACxE,CAAC;YACD,UAAU,IAAI,CAAC,CAAC;YAEhB,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;gBAC3D,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE;oBAC3C,EAAE,EAAE,gBAAgB,EAAE;oBACtB,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,KAAK,EAAE,IAAI,CAAC,IAA+B;iBAC5C,CAAC,CAAC;gBAEH,OAAO;oBACL,gBAAgB,EAAE;wBAChB,IAAI,EAAE,IAAI,CAAC,IAAI;wBACf,QAAQ,EAAE,mBAAmB,CAAC,MAAM,CAAC;qBACtC;iBACF,CAAC;YACJ,CAAC,CAAC,CAAC,CAAC;QACN,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAA0B;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC;YAC1C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,iBAAiB,EAAE,MAAM,CAAC,YAAY;YACtC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxE,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC;YAC3B,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC;YAChC,gBAAgB,EAAE;gBAChB,eAAe,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI;gBACzC,GAAG,CAAC,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC3E;SACF,CAAC,CAAC;QAEH,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,OAAO,GAAoB,cAAc,CAAC,MAAM,CAAC,CAAC;QAEtD,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC/C,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;YACjC,MAAM,aAAa,GAAG,QAAQ,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC;YAErD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC/B,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;YACzB,CAAC;YAED,IAAI,UAAU,IAAI,eAAe,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CAAC,iCAAiC,eAAe,IAAI,CAAC,CAAC;YACxE,CAAC;YACD,UAAU,IAAI,CAAC,CAAC;YAEhB,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;gBAC3D,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE;oBAC/C,EAAE,EAAE,gBAAgB,EAAE;oBACtB,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,KAAK,EAAE,IAAI,CAAC,IAA+B;iBAC5C,CAAC,CAAC;gBAEH,OAAO;oBACL,gBAAgB,EAAE;wBAChB,IAAI,EAAE,IAAI,CAAC,IAAI;wBACf,QAAQ,EAAE,mBAAmB,CAAC,UAAU,CAAC;qBAC1C;iBACF,CAAC;YACJ,CAAC,CAAC,CAAC,CAAC;QACN,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"gemini.js","sourceRoot":"","sources":["../../src/providers/gemini.ts"],"names":[],"mappings":"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"}

package/dist/providers/history.d.ts

@@ -0,0 +1,52 @@
+import type { ChatMessage, ReasoningPart, TextPart, ToolCallPart, ToolResultPart } from '../types.js';
+export interface NormalizedMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+/**
+ * Turns stored messages into a history every provider accepts: it starts with
+ * a user turn and alternates between user and assistant.
+ *
+ * - System messages and empty messages are dropped.
+ * - Leading assistant turns are dropped (history trimming can leave one first).
+ * - Consecutive turns with the same role are merged with a blank line, for
+ *   example a user message saved before a provider call that then failed.
+ */
+export declare function normalizeHistory(messages: ChatMessage[]): NormalizedMessage[];
+/** The parts a model sees again on the next request. */
+export type TurnPart = TextPart | ReasoningPart | ToolCallPart | ToolResultPart;
+export interface NormalizedTurn {
+    role: 'user' | 'assistant';
+    parts: TurnPart[];
+}
+/**
+ * Like `normalizeHistory`, but keeps message parts, so tool calls, their
+ * results and reasoning signatures from earlier steps go back to the model.
+ *
+ * - System messages, empty messages and leading assistant turns are dropped.
+ * - Sources, captured leads and handoff notes are dropped; they're for people.
+ * - Turns with the same role in a row are merged, and text that meets across
+ *   the join is combined with a blank line, as `normalizeHistory` does.
+ */
+export declare function normalizeTurns(messages: ChatMessage[]): NormalizedTurn[];
+/**
+ * A rough token count for budgeting, on the high side: about 3.5 characters
+ * per token for English, plus a few tokens of per-message overhead. Real
+ * counts differ by model; this only has to keep a long conversation from
+ * growing without bound. Messages with parts are counted by their parts, so
+ * tool inputs and results count too.
+ */
+export declare function estimateTokens(message: Pick<ChatMessage, 'content' | 'parts'>): number;
+/** History budget used when nothing else is configured. */
+export declare const DEFAULT_MAX_HISTORY_TOKENS = 32000;
+/**
+ * Keeps a conversation within a token budget before it goes to the model.
+ * The first user message stays (it usually says what the visitor came for),
+ * then as many of the newest messages as fit. The result never starts with
+ * an assistant turn. System messages are left out, since the system prompt
+ * is sent separately.
+ *
+ * Nothing stored changes; this only shapes what the model sees.
+ */
+export declare function trimHistory(messages: ChatMessage[], maxTokens?: number): ChatMessage[];
+//# sourceMappingURL=history.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/providers/history.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EAEX,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,iBAAiB,EAAE,CAiB7E;AAED,wDAAwD;AACxD,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,aAAa,GAAG,YAAY,GAAG,cAAc,CAAC;AAEhF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AA6ED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,cAAc,EAAE,CA0BxE;AAyBD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG,MAAM,CAKtF;AAED,2DAA2D;AAC3D,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,WAAW,EAAE,EACvB,SAAS,GAAE,MAAmC,GAC7C,WAAW,EAAE,CA2Bf"}