agim-cli 1.2.45 → 1.2.49

package/dist/core/llm/anthropic-provider.js

@@ -0,0 +1,339 @@
+// Anthropic native Messages API provider (Stage 2 D+ — 2026-05-23).
+//
+// Why a separate adapter (vs piping Anthropic through OpenAICompatProvider):
+//   - Anthropic's wire format is genuinely different. Messages use a
+//     content-blocks array; system prompt is a top-level field; tool
+//     calls are `tool_use` blocks embedded in assistant content; tool
+//     results are `tool_result` blocks inside a USER message. None of
+//     this maps cleanly to OpenAI's flat schema.
+//   - Anthropic-specific knobs (`cache_control`, `thinking`, etc.) are
+//     wire-level fields we want to use eventually, and wedging them
+//     into the generic provider via `providerOptions` quickly gets
+//     ugly. Better to own the dialect.
+//
+// What's in this initial cut:
+//   - POST /v1/messages with role/content + system + temperature + max_tokens
+//   - Tools (input_schema in the Anthropic shape; we accept the same
+//     `ToolDef.parameters` JSON Schema that OpenAI takes — Anthropic
+//     happens to accept JSON Schema directly under input_schema).
+//   - Multi-turn tool calls: serialize assistant tool_use blocks + user
+//     tool_result blocks faithfully so multi-iteration agent loops work.
+//   - Standard transient-error retry (429, 5xx)
+//   - Usage extraction (input_tokens / output_tokens)
+//
+// Out of scope for this PR (Stage 2 sub-PR #1):
+//   - Streaming (the buffered path is enough for the agent loop's first
+//     iteration; streaming lands when we wire it to the IM "show
+//     thinking" feature)
+//   - Prompt caching (`cache_control: {type:'ephemeral'}`) — easy
+//     follow-up once we have a place to decide which blocks deserve it
+//   - Extended thinking blocks — orthogonal feature
+//   - Bedrock / Vertex (different transports; future provider class)
+import { LlmProvider, LlmProviderError, } from './provider-base.js';
+const DEFAULT_BASE_URL = 'https://api.anthropic.com';
+const DEFAULT_API_VERSION = '2023-06-01';
+const DEFAULT_RETRY = 1;
+/**
+ * Native Anthropic Messages API provider.
+ *
+ * The constructor takes the same shape as OpenAICompatProvider (caller
+ * code stays uniform); the differences live entirely in the wire-format
+ * helpers below.
+ */
+export class AnthropicProvider extends LlmProvider {
+    baseUrl;
+    apiVersion;
+    extraHeaders;
+    retryOnTransient;
+    constructor(cfg) {
+        super({
+            ...cfg,
+            providerType: cfg.providerLabel || 'anthropic',
+        });
+        this.baseUrl = (cfg.baseUrl || DEFAULT_BASE_URL).replace(/\/+$/, '');
+        this.apiVersion = cfg.apiVersion || DEFAULT_API_VERSION;
+        this.extraHeaders = cfg.extraHeaders || {};
+        this.retryOnTransient = Math.max(0, cfg.retryOnTransient ?? DEFAULT_RETRY);
+    }
+    async _callApi(messages, opts, signal) {
+        const body = this._buildBody(messages, opts);
+        const json = await this._postJson(body, signal);
+        const text = extractTextFromBlocks(json?.content);
+        const toolCalls = extractToolUseFromBlocks(json?.content);
+        const finishReason = mapStopReason(json?.stop_reason);
+        const usage = extractUsage(json);
+        return {
+            text,
+            toolCalls: toolCalls.length > 0 ? toolCalls : undefined,
+            usage,
+            finishReason,
+            modelUsed: typeof json?.model === 'string' ? json.model : opts.model,
+        };
+    }
+    // Streaming not implemented in this PR; LlmProvider's base
+    // _callApiStream falls back to buffered + single chunk yield, which
+    // is correct for callers that don't need incremental delivery.
+    async *_callApiStream(messages, opts, signal) {
+        const result = await this._callApi(messages, opts, signal);
+        yield {
+            textDelta: result.text,
+            finishReason: result.finishReason,
+            usage: result.usage,
+        };
+    }
+    /**
+     * Compose the Anthropic Messages body. Differences vs OpenAI:
+     *   - `system` is a top-level field, NOT a message
+     *   - `messages[*].content` may be a string OR a content-block array
+     *   - tool calls live inside assistant content as `{type:'tool_use',...}`
+     *   - tool results live inside user content as `{type:'tool_result',...}`
+     *   - `tools` use `input_schema` (we pass our ToolDef.parameters JSON
+     *     Schema directly — Anthropic accepts the same dialect)
+     */
+    _buildBody(messages, opts) {
+        const { system, msgs } = splitSystemPrompt(messages);
+        const body = {
+            model: opts.model,
+            max_tokens: opts.maxTokens,
+            temperature: opts.temperature,
+            messages: msgs.map(serializeMessage),
+        };
+        if (system)
+            body.system = system;
+        if (opts.tools && opts.tools.length > 0) {
+            body.tools = opts.tools.map(serializeToolDef);
+            const tc = serializeToolChoice(opts.toolChoice);
+            if (tc !== undefined)
+                body.tool_choice = tc;
+        }
+        for (const [k, v] of Object.entries(opts.providerOptions)) {
+            if (v !== undefined)
+                body[k] = v;
+        }
+        return body;
+    }
+    async _postJson(body, signal) {
+        const url = `${this.baseUrl}/v1/messages`;
+        const resp = await this._fetchWithRetry(url, body, signal);
+        try {
+            return (await resp.json());
+        }
+        catch (err) {
+            throw new LlmProviderError(this.name, 'failed to parse JSON response', {
+                httpStatus: resp.status,
+                cause: err,
+            });
+        }
+    }
+    /**
+     * fetch + transient retry. Mirrors OpenAICompatProvider's logic on
+     * purpose so the two providers feel the same to operators reading
+     * logs.
+     */
+    async _fetchWithRetry(url, body, signal) {
+        let lastErr;
+        let attempts = 0;
+        const maxAttempts = this.retryOnTransient + 1;
+        while (attempts < maxAttempts) {
+            attempts++;
+            try {
+                const headers = {
+                    'content-type': 'application/json',
+                    'anthropic-version': this.apiVersion,
+                    'user-agent': 'agim-cli/llm-client',
+                    ...this.extraHeaders,
+                };
+                if (this.apiKey)
+                    headers['x-api-key'] = this.apiKey;
+                const resp = await fetch(url, {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(body),
+                    signal,
+                });
+                if (resp.ok)
+                    return resp;
+                const transient = resp.status === 429 || resp.status === 408 ||
+                    (resp.status >= 500 && resp.status < 600);
+                let bodyText = '';
+                try {
+                    bodyText = (await resp.text()).slice(0, 500);
+                }
+                catch { /* ignore */ }
+                if (!transient || attempts >= maxAttempts) {
+                    throw new LlmProviderError(this.name, `HTTP ${resp.status} from ${this.providerType}: ${bodyText || '(no body)'}`, { httpStatus: resp.status, transient });
+                }
+                await sleep(250 * attempts, signal);
+            }
+            catch (err) {
+                if (isAbortError(err))
+                    throw err;
+                lastErr = err;
+                if (attempts < maxAttempts) {
+                    await sleep(250 * attempts, signal);
+                }
+            }
+        }
+        if (lastErr instanceof LlmProviderError)
+            throw lastErr;
+        throw new LlmProviderError(this.name, `transport error: ${lastErr?.message ?? String(lastErr)}`, { transient: true, cause: lastErr });
+    }
+}
+// ─── Serializers (LlmMessage → Anthropic wire) ──────────────────────
+function splitSystemPrompt(messages) {
+    // Anthropic wants system as a top-level field. We pull every leading
+    // system message out, join them with double newlines, and emit the
+    // rest as-is. Mid-list system messages are RARE but valid in our
+    // generic schema; we coalesce them too rather than reject the batch.
+    const systemParts = [];
+    const rest = [];
+    for (const m of messages) {
+        if (m.role === 'system') {
+            if (m.content)
+                systemParts.push(m.content);
+        }
+        else {
+            rest.push(m);
+        }
+    }
+    return { system: systemParts.join('\n\n'), msgs: rest };
+}
+function serializeMessage(m) {
+    // ── tool result → user message with tool_result block ────────────
+    if (m.role === 'tool') {
+        return {
+            role: 'user',
+            content: [{
+                    type: 'tool_result',
+                    tool_use_id: m.toolCallId ?? '',
+                    content: m.content,
+                }],
+        };
+    }
+    // ── assistant with tool_use calls → content blocks ───────────────
+    if (m.role === 'assistant' && m.toolCalls && m.toolCalls.length > 0) {
+        const blocks = [];
+        if (m.content)
+            blocks.push({ type: 'text', text: m.content });
+        for (const tc of m.toolCalls) {
+            blocks.push({ type: 'tool_use', id: tc.id, name: tc.name, input: tc.arguments });
+        }
+        return { role: 'assistant', content: blocks };
+    }
+    // ── plain user/assistant turn → string content (cheap path) ──────
+    return { role: m.role, content: m.content };
+}
+function serializeToolDef(t) {
+    return {
+        name: t.name,
+        description: t.description,
+        input_schema: t.parameters,
+    };
+}
+function serializeToolChoice(choice) {
+    if (!choice)
+        return undefined;
+    if (choice === 'auto')
+        return { type: 'auto' };
+    if (choice === 'required')
+        return { type: 'any' };
+    if (choice === 'none') {
+        // Anthropic doesn't have a first-class "none"; the standard trick
+        // is to pass `tool_choice: {type:'auto', disable_parallel_tool_use:true}`
+        // plus drop the tools list. Since `tools` is a separate body field,
+        // the caller wanting `none` should pass tools=[] instead. We surface
+        // undefined here so the request omits tool_choice — same as not
+        // specifying tools at all. If the caller insisted on both, log a
+        // warning and let the API decide.
+        return undefined;
+    }
+    if (typeof choice === 'object' && choice.type === 'tool') {
+        return { type: 'tool', name: choice.name };
+    }
+    return undefined;
+}
+// ─── Deserializers (Anthropic wire → ChatResult) ────────────────────
+function extractTextFromBlocks(content) {
+    if (!Array.isArray(content))
+        return '';
+    const out = [];
+    for (const block of content) {
+        if (block?.type === 'text' && typeof block.text === 'string') {
+            out.push(block.text);
+        }
+    }
+    return out.join('');
+}
+function extractToolUseFromBlocks(content) {
+    if (!Array.isArray(content))
+        return [];
+    const out = [];
+    for (const block of content) {
+        if (block?.type !== 'tool_use')
+            continue;
+        const tu = block;
+        if (!tu.id || !tu.name)
+            continue;
+        const args = tu.input && typeof tu.input === 'object' && !Array.isArray(tu.input)
+            ? tu.input
+            : {};
+        out.push({ id: tu.id, name: tu.name, arguments: args });
+    }
+    return out;
+}
+function extractUsage(json) {
+    const u = json?.usage;
+    if (!u)
+        return {};
+    const input = typeof u.input_tokens === 'number' ? u.input_tokens : undefined;
+    const output = typeof u.output_tokens === 'number' ? u.output_tokens : undefined;
+    const total = input !== undefined && output !== undefined ? input + output : undefined;
+    return {
+        promptTokens: input,
+        completionTokens: output,
+        totalTokens: total,
+    };
+}
+function mapStopReason(raw) {
+    switch (raw) {
+        case 'end_turn': return 'stop';
+        case 'stop_sequence': return 'stop';
+        case 'tool_use': return 'tool_use';
+        case 'max_tokens': return 'length';
+        case 'refusal':
+        case 'content_filtered': return 'content_filter';
+        case null:
+        case undefined:
+        case '': return 'unknown';
+        default: return 'unknown';
+    }
+}
+// ─── Tiny utility duplicates (kept inline to avoid an internal helper
+//      module; the alternative is moving these into provider-base.ts
+//      which would expand its API surface for one file's benefit). ─
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal.aborted) {
+            reject(signal.reason ?? new Error('aborted'));
+            return;
+        }
+        const t = setTimeout(() => {
+            signal.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(t);
+            reject(signal.reason ?? new Error('aborted'));
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+    });
+}
+function isAbortError(err) {
+    if (!err)
+        return false;
+    if (typeof err !== 'object')
+        return false;
+    const name = err.name;
+    return name === 'AbortError';
+}
+//# sourceMappingURL=anthropic-provider.js.map

package/dist/core/llm/anthropic-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-provider.js","sourceRoot":"","sources":["../../../src/core/llm/anthropic-provider.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,EAAE;AACF,6EAA6E;AAC7E,qEAAqE;AACrE,qEAAqE;AACrE,sEAAsE;AACtE,sEAAsE;AACtE,iDAAiD;AACjD,uEAAuE;AACvE,oEAAoE;AACpE,mEAAmE;AACnE,uCAAuC;AACvC,EAAE;AACF,8BAA8B;AAC9B,8EAA8E;AAC9E,qEAAqE;AACrE,qEAAqE;AACrE,kEAAkE;AAClE,wEAAwE;AACxE,yEAAyE;AACzE,gDAAgD;AAChD,sDAAsD;AACtD,EAAE;AACF,gDAAgD;AAChD,wEAAwE;AACxE,iEAAiE;AACjE,yBAAyB;AACzB,kEAAkE;AAClE,uEAAuE;AACvE,oDAAoD;AACpD,qEAAqE;AAErE,OAAO,EACL,WAAW,EACX,gBAAgB,GAWjB,MAAM,oBAAoB,CAAA;AAqB3B,MAAM,gBAAgB,GAAG,2BAA2B,CAAA;AACpD,MAAM,mBAAmB,GAAG,YAAY,CAAA;AACxC,MAAM,aAAa,GAAG,CAAC,CAAA;AAEvB;;;;;;GAMG;AACH,MAAM,OAAO,iBAAkB,SAAQ,WAAW;IAC/B,OAAO,CAAQ;IACf,UAAU,CAAQ;IAClB,YAAY,CAAwB;IACpC,gBAAgB,CAAQ;IAEzC,YAAY,GAA4B;QACtC,KAAK,CAAC;YACJ,GAAG,GAAG;YACN,YAAY,EAAE,GAAG,CAAC,aAAa,IAAI,WAAW;SAC/C,CAAC,CAAA;QACF,IAAI,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;QACpE,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,IAAI,mBAAmB,CAAA;QACvD,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC,YAAY,IAAI,EAAE,CAAA;QAC1C,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,gBAAgB,IAAI,aAAa,CAAC,CAAA;IAC5E,CAAC;IAES,KAAK,CAAC,QAAQ,CACtB,QAAsB,EACtB,IAAuB,EACvB,MAAmB;QAEnB,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;QAC5C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAC/C,MAAM,IAAI,GAAG,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QACjD,MAAM,SAAS,GAAG,wBAAwB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QACzD,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;QACrD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;QAChC,OAAO;YACL,IAAI;YACJ,SAAS,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;YACvD,KAAK;YACL,YAAY;YACZ,SAAS,EAAE,OAAO,IAAI,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK;SACrE,CAAA;IACH,CAAC;IAED,2DAA2D;IAC3D,oEAAoE;IACpE,+DAA+D;IAC5C,KAAK,CAAC,CAAC,cAAc,CACtC,QAAsB,EACtB,IAAuB,EACvB,MAAmB;QAEnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;QAC1D,MAAM;YACJ,SAAS,EAAE,MAAM,CAAC,IAAI;YACtB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAA;IACH,CAAC;IAED;;;;;;;;OAQG;IACK,UAAU,CAAC,QAAsB,EAAE,IAAuB;QAChE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAA;QACpD,MAAM,IAAI,GAA4B;YACpC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,IAAI,CAAC,SAAS;YAC1B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC;SACrC,CAAA;QACD,IAAI,MAAM;YAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QAChC,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;YAC7C,MAAM,EAAE,GAAG,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;YAC/C,IAAI,EAAE,KAAK,SAAS;gBAAE,IAAI,CAAC,WAAW,GAAG,EAAE,CAAA;QAC7C,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;YAC1D,IAAI,CAAC,KAAK,SAAS;gBAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QAClC,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,IAAa,EAAE,MAAmB;QACxD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,cAAc,CAAA;QACzC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;QAC1D,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAqB,CAAA;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,+BAA+B,EAAE;gBACrE,UAAU,EAAE,IAAI,CAAC,MAAM;gBACvB,KAAK,EAAE,GAAG;aACX,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,eAAe,CAAC,GAAW,EAAE,IAAa,EAAE,MAAmB;QAC3E,IAAI,OAAgB,CAAA;QACpB,IAAI,QAAQ,GAAG,CAAC,CAAA;QAChB,MAAM,WAAW,GAAG,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAA;QAC7C,OAAO,QAAQ,GAAG,WAAW,EAAE,CAAC;YAC9B,QAAQ,EAAE,CAAA;YACV,IAAI,CAAC;gBACH,MAAM,OAAO,GAA2B;oBACtC,cAAc,EAAE,kBAAkB;oBAClC,mBAAmB,EAAE,IAAI,CAAC,UAAU;oBACpC,YAAY,EAAE,qBAAqB;oBACnC,GAAG,IAAI,CAAC,YAAY;iBACrB,CAAA;gBACD,IAAI,IAAI,CAAC,MAAM;oBAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,MAAM,CAAA;gBACnD,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;oBAC5B,MAAM,EAAE,MAAM;oBACd,OAAO;oBACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;oBAC1B,MAAM;iBACP,CAAC,CAAA;gBACF,IAAI,IAAI,CAAC,EAAE;oBAAE,OAAO,IAAI,CAAA;gBACxB,MAAM,SAAS,GACb,IAAI,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG;oBAC1C,CAAC,IAAI,CAAC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAA;gBAC3C,IAAI,QAAQ,GAAG,EAAE,CAAA;gBACjB,IAAI,CAAC;oBAAC,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;gBAC3E,IAAI,CAAC,SAAS,IAAI,QAAQ,IAAI,WAAW,EAAE,CAAC;oBAC1C,MAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAClC,QAAQ,IAAI,CAAC,MAAM,SAAS,IAAI,CAAC,YAAY,KAAK,QAAQ,IAAI,WAAW,EAAE,EAC3E,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAA;gBAC3C,CAAC;gBACD,MAAM,KAAK,CAAC,GAAG,GAAG,QAAQ,EAAE,MAAM,CAAC,CAAA;YACrC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,YAAY,CAAC,GAAG,CAAC;oBAAE,MAAM,GAAG,CAAA;gBAChC,OAAO,GAAG,GAAG,CAAA;gBACb,IAAI,QAAQ,GAAG,WAAW,EAAE,CAAC;oBAC3B,MAAM,KAAK,CAAC,GAAG,GAAG,QAAQ,EAAE,MAAM,CAAC,CAAA;gBACrC,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,OAAO,YAAY,gBAAgB;YAAE,MAAM,OAAO,CAAA;QACtD,MAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAClC,oBAAqB,OAAiB,EAAE,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,EACpE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;IACxC,CAAC;CACF;AAgBD,uEAAuE;AAEvE,SAAS,iBAAiB,CAAC,QAAsB;IAC/C,qEAAqE;IACrE,mEAAmE;IACnE,iEAAiE;IACjE,qEAAqE;IACrE,MAAM,WAAW,GAAa,EAAE,CAAA;IAChC,MAAM,IAAI,GAAiB,EAAE,CAAA;IAC7B,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACxB,IAAI,CAAC,CAAC,OAAO;gBAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QAC5C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACd,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AACzD,CAAC;AAED,SAAS,gBAAgB,CAAC,CAAa;IACrC,oEAAoE;IACpE,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,aAAa;oBACnB,WAAW,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE;oBAC/B,OAAO,EAAE,CAAC,CAAC,OAAO;iBACnB,CAAC;SACH,CAAA;IACH,CAAC;IACD,oEAAoE;IACpE,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpE,MAAM,MAAM,GAAmB,EAAE,CAAA;QACjC,IAAI,CAAC,CAAC,OAAO;YAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;QAC7D,KAAK,MAAM,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC,CAAA;QAClF,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,CAAA;IAC/C,CAAC;IACD,oEAAoE;IACpE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAA;AAC7C,CAAC;AAED,SAAS,gBAAgB,CAAC,CAAU;IAClC,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,YAAY,EAAE,CAAC,CAAC,UAAU;KAC3B,CAAA;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,MAA8B;IACzD,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAA;IAC7B,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IAC9C,IAAI,MAAM,KAAK,UAAU;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;IACjD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,kEAAkE;QAClE,0EAA0E;QAC1E,oEAAoE;QACpE,qEAAqE;QACrE,gEAAgE;QAChE,iEAAiE;QACjE,kCAAkC;QAClC,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACzD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAA;IAC5C,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,uEAAuE;AAEvE,SAAS,qBAAqB,CAAC,OAAmC;IAChE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAA;IACtC,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,EAAE,IAAI,KAAK,MAAM,IAAI,OAAQ,KAAmB,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5E,GAAG,CAAC,IAAI,CAAE,KAAmB,CAAC,IAAI,CAAC,CAAA;QACrC,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AACrB,CAAC;AAED,SAAS,wBAAwB,CAAC,OAAmC;IACnE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAA;IACtC,MAAM,GAAG,GAAsB,EAAE,CAAA;IACjC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,EAAE,IAAI,KAAK,UAAU;YAAE,SAAQ;QACxC,MAAM,EAAE,GAAG,KAAqB,CAAA;QAChC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI;YAAE,SAAQ;QAChC,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,IAAI,OAAO,EAAE,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC;YAC/E,CAAC,CAAE,EAAE,CAAC,KAAiC;YACvC,CAAC,CAAC,EAAE,CAAA;QACN,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACzD,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,SAAS,YAAY,CAAC,IAA6B;IACjD,MAAM,CAAC,GAAG,IAAI,EAAE,KAAK,CAAA;IACrB,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAA;IACjB,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAA;IAC7E,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAA;IAChF,MAAM,KAAK,GAAG,KAAK,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;IACtF,OAAO;QACL,YAAY,EAAE,KAAK;QACnB,gBAAgB,EAAE,MAAM;QACxB,WAAW,EAAE,KAAK;KACnB,CAAA;AACH,CAAC;AAED,SAAS,aAAa,CAAC,GAA8B;IACnD,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,UAAU,CAAC,CAAC,OAAO,MAAM,CAAA;QAC9B,KAAK,eAAe,CAAC,CAAC,OAAO,MAAM,CAAA;QACnC,KAAK,UAAU,CAAC,CAAC,OAAO,UAAU,CAAA;QAClC,KAAK,YAAY,CAAC,CAAC,OAAO,QAAQ,CAAA;QAClC,KAAK,SAAS,CAAC;QACf,KAAK,kBAAkB,CAAC,CAAC,OAAO,gBAAgB,CAAA;QAChD,KAAK,IAAI,CAAC;QACV,KAAK,SAAS,CAAC;QACf,KAAK,EAAE,CAAC,CAAC,OAAO,SAAS,CAAA;QACzB,OAAO,CAAC,CAAC,OAAO,SAAS,CAAA;IAC3B,CAAC;AACH,CAAC;AAED,uEAAuE;AACvE,qEAAqE;AACrE,qEAAqE;AAErE,SAAS,KAAK,CAAC,EAAU,EAAE,MAAmB;IAC5C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAA;YAC7C,OAAM;QACR,CAAC;QACD,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE;YACxB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAC5C,OAAO,EAAE,CAAA;QACX,CAAC,EAAE,EAAE,CAAC,CAAA;QACN,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,YAAY,CAAC,CAAC,CAAC,CAAA;YACf,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAA;QAC/C,CAAC,CAAA;QACD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IAC3D,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,GAAY;IAChC,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAA;IACtB,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACzC,MAAM,IAAI,GAAI,GAA0B,CAAC,IAAI,CAAA;IAC7C,OAAO,IAAI,KAAK,YAAY,CAAA;AAC9B,CAAC"}

package/dist/core/llm/auto-compact.d.ts

@@ -0,0 +1,35 @@
+import type { LlmProvider, LlmMessage } from './provider-base.js';
+export interface CompactOptions {
+    /** Total char budget that triggers compaction. Default 60_000
+     *  (~15k tokens for mixed EN/CN). Set via env IMHUB_NATIVE_COMPACT_TRIGGER_CHARS. */
+    triggerChars?: number;
+    /** Number of recent user+assistant pairs preserved verbatim.
+     *  Default 6 (= 12 messages, plus any tool messages between them).
+     *  Set via env IMHUB_NATIVE_COMPACT_KEEP_TURNS. */
+    keepTurns?: number;
+    /** Provider to ask for the summary. If omitted, tries evaluator →
+     *  cheap → native-chat in that order; the first registered wins. */
+    summarizer?: LlmProvider;
+    /** Hard cap on the summary length (chars) the summarizer is asked
+     *  to produce. Default 1_500. */
+    summaryCharCap?: number;
+}
+export interface CompactResult {
+    messages: LlmMessage[];
+    compacted: boolean;
+    /** When compacted=true, how many of the original messages were
+     *  collapsed into the synthetic summary entry. */
+    collapsedCount: number;
+    /** When compacted=true, char count of the summary block (so the
+     *  caller can log "compacted X chars to Y chars"). */
+    summaryChars: number;
+    /** Char count of the original message array (sum of content). */
+    originalChars: number;
+}
+/**
+ * Compact if needed. Returns the (possibly new) message array plus a
+ * summary metadata record. Never throws; on failure returns the input
+ * unchanged with compacted=false.
+ */
+export declare function maybeCompactHistory(messages: LlmMessage[], opts?: CompactOptions): Promise<CompactResult>;
+//# sourceMappingURL=auto-compact.d.ts.map

package/dist/core/llm/auto-compact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-compact.d.ts","sourceRoot":"","sources":["../../../src/core/llm/auto-compact.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAMjE,MAAM,WAAW,cAAc;IAC7B;yFACqF;IACrF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;uDAEmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;wEACoE;IACpE,UAAU,CAAC,EAAE,WAAW,CAAA;IACxB;qCACiC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,UAAU,EAAE,CAAA;IACtB,SAAS,EAAE,OAAO,CAAA;IAClB;sDACkD;IAClD,cAAc,EAAE,MAAM,CAAA;IACtB;0DACsD;IACtD,YAAY,EAAE,MAAM,CAAA;IACpB,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAA;CACtB;AA+CD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,UAAU,EAAE,EACtB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,aAAa,CAAC,CA4ExB"}

package/dist/core/llm/auto-compact.js

@@ -0,0 +1,149 @@
+// auto-compact — shrink long native chat histories before they hit the
+// provider call.
+//
+// Why: native uses single-shot 30-minute IM turns. A user who chats
+// back and forth for hours accumulates many user/assistant pairs (plus
+// any tool messages from earlier mcp__imhub__* calls). Past ~15k
+// tokens the provider call cost climbs linearly and we get closer to
+// the model's context window. Most older content is "settled" — the
+// agent's earlier conclusions, not the live problem — so a 1-2 paragraph
+// summary preserves continuity at a fraction of the tokens.
+//
+// Strategy (intentionally simple):
+//   1. Cheap char-count proxy for tokens (chars ≈ 4 tokens for mixed
+//      EN/CN). When total < TRIGGER chars, do nothing.
+//   2. Always keep the original system prompt (caller handles), the
+//      last KEEP_TURNS user/assistant pairs verbatim, plus any tool
+//      messages that immediately precede them (so tool round-trips
+//      stay valid for the provider).
+//   3. Send the older slice to a cheap/evaluator role with a fixed
+//      "summarize the prior conversation" instruction. Inject the
+//      summary as a synthetic user message at index 0:
+//         "[earlier conversation summary]\n<summary>\n[/earlier]"
+//   4. On any failure, log + return the original array. Better a
+//      slower turn than a broken one.
+import { getProvider } from './registry.js';
+import { logger as rootLogger } from '../logger.js';
+const log = rootLogger.child({ component: 'auto-compact' });
+function envInt(key, fallback) {
+    const raw = process.env[key];
+    if (!raw)
+        return fallback;
+    const n = parseInt(raw, 10);
+    return Number.isFinite(n) && n > 0 ? n : fallback;
+}
+function totalChars(messages) {
+    let sum = 0;
+    for (const m of messages)
+        sum += (m.content || '').length;
+    return sum;
+}
+function resolveSummarizer() {
+    for (const role of ['evaluator', 'cheap', 'native-chat']) {
+        const p = getProvider(role);
+        if (p)
+            return p;
+    }
+    return null;
+}
+/**
+ * Pick the slice index such that messages[idx..] are the "recent" turns
+ * we preserve verbatim. The slice MUST start on `role:'user'` so the
+ * provider doesn't see an orphan `role:'tool'` whose matching
+ * `assistant.toolCalls` was just compacted away (OpenAI / DeepSeek
+ * reject the request with HTTP 400 in that case).
+ *
+ * Strategy: walk backwards counting user messages until we've covered
+ * `keepTurns` user turns, then return the index of that user message.
+ * If we couldn't find any user message, return 0 (no compaction).
+ */
+function pickKeepSliceIndex(messages, keepTurns) {
+    let pairs = 0;
+    let lastUserIdx = -1;
+    for (let i = messages.length - 1; i >= 0; i--) {
+        if (messages[i].role === 'user') {
+            pairs += 1;
+            lastUserIdx = i;
+            if (pairs >= keepTurns)
+                return i;
+        }
+    }
+    return Math.max(0, lastUserIdx);
+}
+/**
+ * Compact if needed. Returns the (possibly new) message array plus a
+ * summary metadata record. Never throws; on failure returns the input
+ * unchanged with compacted=false.
+ */
+export async function maybeCompactHistory(messages, opts = {}) {
+    const triggerChars = opts.triggerChars ?? envInt('IMHUB_NATIVE_COMPACT_TRIGGER_CHARS', 60_000);
+    const keepTurns = opts.keepTurns ?? envInt('IMHUB_NATIVE_COMPACT_KEEP_TURNS', 6);
+    const summaryCharCap = opts.summaryCharCap ?? envInt('IMHUB_NATIVE_COMPACT_SUMMARY_CHARS', 1_500);
+    const originalChars = totalChars(messages);
+    // Disabled when trigger=0 (operator opt-out).
+    if (triggerChars === 0)
+        return { messages, compacted: false, collapsedCount: 0, summaryChars: 0, originalChars };
+    if (originalChars < triggerChars)
+        return { messages, compacted: false, collapsedCount: 0, summaryChars: 0, originalChars };
+    const sliceIdx = pickKeepSliceIndex(messages, keepTurns);
+    if (sliceIdx === 0) {
+        // Nothing to summarise — the recent slice covers everything.
+        return { messages, compacted: false, collapsedCount: 0, summaryChars: 0, originalChars };
+    }
+    const older = messages.slice(0, sliceIdx);
+    const recent = messages.slice(sliceIdx);
+    const summarizer = opts.summarizer ?? resolveSummarizer();
+    if (!summarizer) {
+        log.warn({ event: 'auto-compact.no_summarizer', originalChars, sliceIdx });
+        return { messages, compacted: false, collapsedCount: 0, summaryChars: 0, originalChars };
+    }
+    // Render the older slice as a transcript the summarizer can read.
+    const transcript = older.map((m) => {
+        const tag = m.role === 'tool' ? `tool[${m.toolCallId ?? '?'}]` : m.role;
+        return `${tag}: ${m.content}`;
+    }).join('\n---\n');
+    const summaryPrompt = [
+        `You are summarising the earlier part of a chat conversation so it can be dropped from the active context window without losing continuity.`,
+        `Keep ${summaryCharCap} characters or fewer. Preserve: user's stated goals, key facts the agent established, important tool results (e.g. lookups, IDs, file paths), and any open questions. Drop: small-talk, retries, intermediate reasoning.`,
+        `Output a single paragraph (or short bulleted list) in the user's language — do not address the user directly.`,
+        ``,
+        `Conversation to summarise:`,
+        transcript,
+    ].join('\n');
+    try {
+        const r = await summarizer.chat([{ role: 'user', content: summaryPrompt }], { temperature: 0, maxTokens: Math.max(256, Math.floor(summaryCharCap / 3)) });
+        const summary = (r.text || '').trim();
+        if (!summary) {
+            log.warn({ event: 'auto-compact.empty_summary', backend: summarizer.name });
+            return { messages, compacted: false, collapsedCount: 0, summaryChars: 0, originalChars };
+        }
+        const synthetic = {
+            role: 'user',
+            content: `[earlier conversation summary — ${older.length} messages compacted]\n${summary}\n[/earlier conversation summary]`,
+        };
+        log.info({
+            event: 'auto-compact.applied',
+            backend: summarizer.name,
+            originalChars,
+            collapsedCount: older.length,
+            keptCount: recent.length,
+            summaryChars: synthetic.content.length,
+        });
+        return {
+            messages: [synthetic, ...recent],
+            compacted: true,
+            collapsedCount: older.length,
+            summaryChars: synthetic.content.length,
+            originalChars,
+        };
+    }
+    catch (err) {
+        log.warn({
+            event: 'auto-compact.summarizer_failed',
+            backend: summarizer.name,
+            err: err instanceof Error ? err.message : String(err),
+        });
+        return { messages, compacted: false, collapsedCount: 0, summaryChars: 0, originalChars };
+    }
+}
+//# sourceMappingURL=auto-compact.js.map

package/dist/core/llm/auto-compact.js.map

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

package/dist/core/llm/builtin-dispatcher.d.ts

@@ -0,0 +1,21 @@
+import type { ToolDef } from './provider-base.js';
+import type { ToolDispatcher } from './tool-dispatcher.js';
+/** Definitions advertised to the LLM. Returned by `getBuiltinTools()`
+ *  so callers can concat with MCP tools and pass the union to runAgentLoop. */
+export declare function getBuiltinTools(): ToolDef[];
+/** True iff `name` is one of the builtin tool names. Cheap O(1) check
+ *  the dispatcher uses to decide whether to handle vs pass through. */
+export declare function isBuiltinToolName(name: string): boolean;
+/**
+ * Build the built-in dispatcher. Returns a ToolDispatcher compatible
+ * with combineDispatchers — i.e. an unknown tool name yields a
+ * `{source:'unknown'}` result so the next dispatcher in the chain gets
+ * a turn. Combine like this:
+ *
+ *     const dispatch = combineDispatchers(
+ *       buildBuiltinDispatcher(),
+ *       buildMcpDispatcher(),
+ *     )
+ */
+export declare function buildBuiltinDispatcher(): ToolDispatcher;
+//# sourceMappingURL=builtin-dispatcher.d.ts.map

package/dist/core/llm/builtin-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-dispatcher.d.ts","sourceRoot":"","sources":["../../../src/core/llm/builtin-dispatcher.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,KAAK,EAAoB,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAM5E;+EAC+E;AAC/E,wBAAgB,eAAe,IAAI,OAAO,EAAE,CA6C3C;AAED;uEACuE;AACvE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUvD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,IAAI,cAAc,CAmBvD"}