@nac3/forge-cli 0.2.0-alpha.5 → 0.2.0-alpha.59z.119

package/dist/llm/gemini_client.js

@@ -0,0 +1,189 @@
+const GEMINI_BASE = 'https://generativelanguage.googleapis.com/v1beta/models/';
+const DEFAULT_GEMINI_MODEL = 'gemini-2.5-flash-lite';
+export class GeminiApiError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.name = 'GeminiApiError';
+        this.status = status;
+    }
+}
+export class GeminiClient {
+    apiKey;
+    fetchImpl;
+    defaultModel;
+    constructor(opts) {
+        if (!opts.apiKey || opts.apiKey.trim() === '') {
+            throw new Error('GeminiClient: apiKey required');
+        }
+        this.apiKey = opts.apiKey.trim();
+        this.fetchImpl = opts.fetchImpl ?? fetch;
+        this.defaultModel = opts.defaultModel ?? DEFAULT_GEMINI_MODEL;
+    }
+    async chat(req) {
+        if (req.tools && !req.runTool) {
+            throw new Error('GeminiChatRequest.tools requires a runTool callback');
+        }
+        const model = req.model ?? this.defaultModel;
+        const maxTokens = req.maxTokens ?? 1024;
+        /* alpha.59c -- config-driven cap + family resolver. */
+        const { readLimitsConfig, classifyVerbFamily, getMaxToolRoundsForFamily } = await import('../core/limits_config.js');
+        const limits = await readLimitsConfig();
+        const callerSpecifiedCap = req.maxToolRounds !== undefined;
+        const autonomousMode = limits.danger_zone && limits.danger_zone.auto_approve_all === true;
+        const baseCap = autonomousMode
+            ? limits.max_tool_rounds.autonomous
+            : limits.max_tool_rounds.default;
+        let maxRounds = req.maxToolRounds ?? baseCap;
+        let familyResolved = null;
+        /* Translate the caller's ChatMessage[] into Gemini contents.
+         * ChatMessage has {role: 'user'|'assistant', content: string}
+         * and is text-only. assistant -> model. */
+        const contents = req.messages.map((m) => ({
+            role: m.role === 'assistant' ? 'model' : 'user',
+            parts: [{ text: m.content }],
+        }));
+        /* Translate Anthropic-shaped ToolSpec[] into Gemini
+         * functionDeclarations. The input_schema is JSON Schema in
+         * both, so the shape is compatible. */
+        const functionDeclarations = (req.tools ?? []).map((t) => ({
+            name: t.name,
+            description: t.description,
+            parameters: t.input_schema,
+        }));
+        const systemInstruction = req.system
+            ? { parts: [{ text: req.system }] }
+            : undefined;
+        let totalIn = 0;
+        let totalOut = 0;
+        const toolRounds = [];
+        for (let round = 0; round < maxRounds; round++) {
+            const body = {
+                contents,
+                generationConfig: { maxOutputTokens: maxTokens, temperature: 0.7 },
+            };
+            if (systemInstruction)
+                body.systemInstruction = systemInstruction;
+            if (functionDeclarations.length > 0) {
+                body.tools = [{ functionDeclarations }];
+                body.toolConfig = { functionCallingConfig: { mode: 'AUTO' } };
+            }
+            const url = GEMINI_BASE + encodeURIComponent(model) + ':generateContent?key=' + encodeURIComponent(this.apiKey);
+            const res = await this.fetchImpl(url, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify(body),
+            });
+            const json = await res.json();
+            if (!res.ok || json.error) {
+                const msg = json.error?.message || ('HTTP ' + res.status);
+                throw new GeminiApiError('Gemini API error: ' + msg, res.status);
+            }
+            /* Accumulate token usage. */
+            const usage = json.usageMetadata ?? {};
+            totalIn += usage.promptTokenCount ?? 0;
+            totalOut += usage.candidatesTokenCount ?? 0;
+            const candidate = (json.candidates ?? [])[0];
+            const content = candidate?.content;
+            if (!content || !Array.isArray(content.parts)) {
+                /* Empty response -- return whatever text we have so far. */
+                break;
+            }
+            /* Walk the parts. Collect text + function calls. If there
+             * are function calls, dispatch them via runTool, append the
+             * model turn + the function response turn to contents, and
+             * loop. Otherwise return. */
+            const textParts = [];
+            const functionCalls = [];
+            for (const p of content.parts) {
+                if (typeof p.text === 'string')
+                    textParts.push(p.text);
+                if (p.functionCall) {
+                    functionCalls.push({
+                        name: p.functionCall.name,
+                        args: p.functionCall.args ?? {},
+                    });
+                }
+            }
+            if (functionCalls.length === 0) {
+                /* Pure text reply -- terminal. */
+                return {
+                    text: textParts.join('\n').trim(),
+                    tokensIn: totalIn,
+                    tokensOut: totalOut,
+                    model,
+                    toolRounds,
+                };
+            }
+            /* alpha.59c -- family detection on first verb. */
+            if (familyResolved === null && functionCalls.length > 0) {
+                const first = functionCalls[0];
+                if (first) {
+                    const firstVerb = first.args.verb_id || first.name || '';
+                    const fam = classifyVerbFamily(firstVerb);
+                    familyResolved = fam;
+                    if (!callerSpecifiedCap) {
+                        const famCap = getMaxToolRoundsForFamily(limits.max_tool_rounds, fam);
+                        if (famCap > maxRounds)
+                            maxRounds = famCap;
+                    }
+                }
+            }
+            /* Tool round. Append the model turn (with all its parts) to
+             * contents, then for each functionCall invoke runTool +
+             * append a function response turn. Loop. */
+            contents.push({
+                role: 'model',
+                parts: content.parts,
+            });
+            for (const fc of functionCalls) {
+                let toolResult;
+                try {
+                    toolResult = await req.runTool(fc.name, fc.args);
+                }
+                catch (err) {
+                    toolResult = {
+                        result: { error: err instanceof Error ? err.message : String(err) },
+                        is_error: true,
+                    };
+                }
+                /* Gemini expects functionResponse.response to be a JSON
+                 * object. If runTool returned a primitive, wrap. */
+                const responsePayload = (toolResult.result && typeof toolResult.result === 'object' && !Array.isArray(toolResult.result))
+                    ? toolResult.result
+                    : { value: toolResult.result };
+                contents.push({
+                    role: 'function',
+                    parts: [{
+                            functionResponse: {
+                                name: fc.name,
+                                response: responsePayload,
+                            },
+                        }],
+                });
+                toolRounds.push({
+                    tool: fc.name,
+                    input: fc.args,
+                    result: toolResult.result,
+                    is_error: Boolean(toolResult.is_error),
+                    tool_use_id: 'gem_' + Date.now().toString(36) + '_' + Math.random().toString(36).slice(2, 6),
+                });
+            }
+            /* Continue the loop -- Gemini will return text in the next
+             * call once it has seen the function responses. */
+        }
+        /* alpha.59c -- graceful exhaustion. Return what we have +
+         * helpful summary instead of a generic "loop reached" line. */
+        return {
+            text: '[Alcance el limite de rondas (' + maxRounds + '/' + maxRounds +
+                ') en esta tarea (familia=' + (familyResolved ?? 'default') +
+                '). Decime "continua" y sigo desde aca, o sube el cap en ' +
+                '`yf limits set max_tool_rounds.' + (familyResolved ?? 'default') + ' <N>`.]',
+            tokensIn: totalIn,
+            tokensOut: totalOut,
+            model,
+            toolRounds,
+        };
+    }
+}
+//# sourceMappingURL=gemini_client.js.map

package/dist/llm/gemini_client.js.map

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

package/dist/llm/managed_client.d.ts

@@ -0,0 +1,70 @@
+/**
+ * ManagedBrainClient -- talks to the HITO 4 worker's
+ * /v1/llm/chat endpoint instead of pegging the provider
+ * directly (alpha.59).
+ *
+ * Why: for managed plans (free / starter / pro / pro+), the
+ * client should NOT carry Yujin's provider API keys. The keys
+ * live in worker secrets. The client only sends license_handle
+ * + HMAC bearer + the conversation, and the worker proxies the
+ * call.
+ *
+ * Tool roundtrip stays client-driven: each POST is one LLM
+ * round-trip. When the LLM emits tool_calls, the client gets
+ * them in the response + executes them locally + re-POSTs with
+ * the tool_result blocks appended to messages. Loop bounded by
+ * `maxToolRounds`.
+ *
+ * Interface matches ClaudeClient / GeminiClient / OpenAIClient
+ * so `makeUnifiedClient` can route to it transparently.
+ *
+ * ASCII-only.
+ */
+import type { ChatMessage, ToolRound } from '../chat/claude.js';
+import type { ToolSpec } from '../chat/tools.js';
+export interface ManagedChatRequest {
+    messages: ChatMessage[];
+    system?: string;
+    maxTokens?: number;
+    /** Optional model override. Server has a default per plan+tier. */
+    model?: string;
+    tools?: ToolSpec[];
+    runTool?: (name: string, input: Record<string, unknown>) => Promise<{
+        result: unknown;
+        is_error?: boolean;
+    }>;
+    maxToolRounds?: number;
+}
+export interface ManagedChatResponse {
+    text: string;
+    tokensIn: number;
+    tokensOut: number;
+    model: string;
+    toolRounds: ToolRound[];
+}
+export interface ManagedClientOptions {
+    /** Server-resolved tier the router picked. The proxy uses
+     *  this to choose provider+model server-side. */
+    tier: 'eco' | 'frontier';
+    /** Override the proxy base URL (tests / dev). */
+    baseUrl?: string;
+    fetchImpl?: typeof fetch;
+    /** Override the bearer signing pieces -- tests can inject
+     *  ad-hoc secret + handle without touching the vault. */
+    secret?: string;
+    handle?: string;
+}
+export declare class ManagedBrainError extends Error {
+    status: number;
+    upstream_error?: string;
+    constructor(message: string, status: number, upstream_error?: string);
+}
+export declare class ManagedBrainClient {
+    private tier;
+    private baseUrl;
+    private fetchImpl;
+    private opts;
+    constructor(opts: ManagedClientOptions);
+    chat(req: ManagedChatRequest): Promise<ManagedChatResponse>;
+}
+//# sourceMappingURL=managed_client.d.ts.map

package/dist/llm/managed_client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed_client.d.ts","sourceRoot":"","sources":["../../src/llm/managed_client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAajD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;QAClE,MAAM,EAAE,OAAO,CAAC;QAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC;qDACiD;IACjD,IAAI,EAAE,KAAK,GAAG,UAAU,CAAC;IACzB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB;6DACyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;gBACZ,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM;CAMrE;AAyCD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,IAAI,CAAuB;gBAEvB,IAAI,EAAE,oBAAoB;IAOhC,IAAI,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA2LlE"}

package/dist/llm/managed_client.js

@@ -0,0 +1,251 @@
+/**
+ * ManagedBrainClient -- talks to the HITO 4 worker's
+ * /v1/llm/chat endpoint instead of pegging the provider
+ * directly (alpha.59).
+ *
+ * Why: for managed plans (free / starter / pro / pro+), the
+ * client should NOT carry Yujin's provider API keys. The keys
+ * live in worker secrets. The client only sends license_handle
+ * + HMAC bearer + the conversation, and the worker proxies the
+ * call.
+ *
+ * Tool roundtrip stays client-driven: each POST is one LLM
+ * round-trip. When the LLM emits tool_calls, the client gets
+ * them in the response + executes them locally + re-POSTs with
+ * the tool_result blocks appended to messages. Loop bounded by
+ * `maxToolRounds`.
+ *
+ * Interface matches ClaudeClient / GeminiClient / OpenAIClient
+ * so `makeUnifiedClient` can route to it transparently.
+ *
+ * ASCII-only.
+ */
+import { HITO4_BASE_URL, signBearer, } from '../license/hito4_client.js';
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { Vault } from '../vault/store.js';
+import { configDir } from '../license/index.js';
+const SECRET_SLOT = 'yf_server_api_key';
+export class ManagedBrainError extends Error {
+    status;
+    upstream_error;
+    constructor(message, status, upstream_error) {
+        super(message);
+        this.name = 'ManagedBrainError';
+        this.status = status;
+        this.upstream_error = upstream_error;
+    }
+}
+/** Resolve server_api_key from vault + license user_handle from
+ *  license.json. Returns null/null when either is missing so
+ *  the caller can fall back to BYOK. */
+async function resolveAuth(opts) {
+    if (opts.secret && opts.handle)
+        return { secret: opts.secret, handle: opts.handle };
+    let secret = null;
+    try {
+        const vault = await Vault.open({ configDir: configDir() });
+        if (vault.has(SECRET_SLOT))
+            secret = vault.get(SECRET_SLOT);
+    }
+    catch {
+        secret = null;
+    }
+    let handle = null;
+    try {
+        const home = process.env.HOME || process.env.USERPROFILE || os.homedir();
+        const base = process.env.YF_CONFIG_DIR || path.join(home, '.yujin-forge');
+        const raw = await fs.readFile(path.join(base, 'license.json'), 'utf-8');
+        const j = JSON.parse(raw);
+        if (typeof j.user_handle === 'string' && j.user_handle.length > 0) {
+            handle = j.user_handle;
+        }
+    }
+    catch {
+        handle = null;
+    }
+    return { secret, handle };
+}
+export class ManagedBrainClient {
+    tier;
+    baseUrl;
+    fetchImpl;
+    opts;
+    constructor(opts) {
+        this.tier = opts.tier;
+        this.baseUrl = (opts.baseUrl ?? HITO4_BASE_URL).replace(/\/+$/, '');
+        this.fetchImpl = opts.fetchImpl ?? fetch;
+        this.opts = opts;
+    }
+    async chat(req) {
+        if (req.tools && !req.runTool) {
+            throw new Error('ManagedChatRequest.tools requires a runTool callback');
+        }
+        /* alpha.59c -- config-driven cap + family resolver. */
+        const { readLimitsConfig, classifyVerbFamily, getMaxToolRoundsForFamily } = await import('../core/limits_config.js');
+        const limits = await readLimitsConfig();
+        const callerSpecifiedCap = req.maxToolRounds !== undefined;
+        const autonomousMode = limits.danger_zone && limits.danger_zone.auto_approve_all === true;
+        const baseCap = autonomousMode
+            ? limits.max_tool_rounds.autonomous
+            : limits.max_tool_rounds.default;
+        let maxRounds = req.maxToolRounds ?? baseCap;
+        let familyResolved = null;
+        const maxTokens = req.maxTokens ?? 1024;
+        const { secret, handle } = await resolveAuth(this.opts);
+        if (!secret) {
+            throw new ManagedBrainError('managed proxy requires yf_server_api_key in vault. Run `yf vault set ' + SECRET_SLOT + '`.', 400);
+        }
+        if (!handle) {
+            throw new ManagedBrainError('managed proxy requires user_handle in license cache. Run `yf license activate --user-handle <email>`.', 400);
+        }
+        const messages = req.messages.map((m) => ({
+            role: m.role,
+            content: m.content,
+        }));
+        /* Convert ToolSpec[] to Anthropic-shape input_schema is
+         *  already there). */
+        const tools = (req.tools ?? []).map((t) => ({
+            name: t.name,
+            description: t.description,
+            input_schema: t.input_schema,
+        }));
+        let totalIn = 0;
+        let totalOut = 0;
+        let serverModel = '';
+        const toolRounds = [];
+        for (let round = 0; round < maxRounds; round++) {
+            const bearer = signBearer(secret, handle);
+            const body = {
+                messages,
+                tier: this.tier,
+                max_tokens: maxTokens,
+            };
+            if (req.system)
+                body.system = req.system;
+            if (req.model)
+                body.model = req.model;
+            if (tools.length > 0)
+                body.tools = tools;
+            const r = await this.fetchImpl(this.baseUrl + '/v1/llm/chat', {
+                method: 'POST',
+                headers: {
+                    'authorization': 'Bearer ' + bearer,
+                    'x-yf-user-handle': handle,
+                    'content-type': 'application/json',
+                },
+                body: JSON.stringify(body),
+            });
+            let json;
+            try {
+                json = await r.json();
+            }
+            catch {
+                throw new ManagedBrainError('managed proxy returned invalid JSON', r.status);
+            }
+            if (!r.ok || !json.ok) {
+                throw new ManagedBrainError(json.message || json.error || ('managed proxy HTTP ' + r.status), r.status, json.error);
+            }
+            totalIn += json.tokens_in ?? 0;
+            totalOut += json.tokens_out ?? 0;
+            serverModel = json.model ?? serverModel;
+            const stop = json.stop_reason ?? 'unknown';
+            const callsThisRound = json.tool_calls ?? [];
+            /* No tool calls -> we're done. Return the text. */
+            if (callsThisRound.length === 0 || stop !== 'tool_use') {
+                return {
+                    text: json.text ?? '',
+                    tokensIn: totalIn,
+                    tokensOut: totalOut,
+                    model: serverModel,
+                    toolRounds,
+                };
+            }
+            /* alpha.59c -- family detection on first verb. */
+            if (familyResolved === null && callsThisRound.length > 0) {
+                const first = callsThisRound[0];
+                if (first) {
+                    const firstVerb = first.input.verb_id || first.name || '';
+                    const fam = classifyVerbFamily(firstVerb);
+                    familyResolved = fam;
+                    if (!callerSpecifiedCap) {
+                        const famCap = getMaxToolRoundsForFamily(limits.max_tool_rounds, fam);
+                        if (famCap > maxRounds)
+                            maxRounds = famCap;
+                    }
+                }
+            }
+            /* Append the assistant message with tool_use blocks for
+             *  the proxy to see in the next round. */
+            const assistantContent = [];
+            if (json.text && json.text.length > 0)
+                assistantContent.push({ type: 'text', text: json.text });
+            for (const tc of callsThisRound) {
+                assistantContent.push({
+                    type: 'tool_use',
+                    id: tc.id,
+                    name: tc.name,
+                    input: tc.input,
+                });
+            }
+            messages.push({ role: 'assistant', content: assistantContent });
+            /* Execute each tool locally + collect results. */
+            const userContent = [];
+            for (const tc of callsThisRound) {
+                let result;
+                let isError = false;
+                try {
+                    const r2 = await req.runTool(tc.name, tc.input);
+                    result = r2.result;
+                    isError = r2.is_error === true;
+                }
+                catch (err) {
+                    result = { error: err instanceof Error ? err.message : String(err) };
+                    isError = true;
+                }
+                let resultStr;
+                try {
+                    resultStr = typeof result === 'string' ? result : JSON.stringify(result);
+                }
+                catch {
+                    resultStr = String(result);
+                }
+                if (resultStr.length > 200_000) {
+                    resultStr = JSON.stringify({ _truncated: true, _bytes: resultStr.length });
+                }
+                const display = typeof result === 'object' && result !== null && 'display' in result
+                    ? String(result.display)
+                    : undefined;
+                toolRounds.push({
+                    tool: tc.name,
+                    tool_use_id: tc.id,
+                    input: tc.input,
+                    ...(display ? { display } : {}),
+                    ...(isError ? { is_error: true } : {}),
+                    result,
+                });
+                userContent.push({
+                    type: 'tool_result',
+                    tool_use_id: tc.id,
+                    content: resultStr,
+                    ...(isError ? { is_error: true } : {}),
+                });
+            }
+            messages.push({ role: 'user', content: userContent });
+            /* Loop -- next POST will see the tool results. */
+        }
+        /* alpha.59c -- graceful exhaustion with helpful summary. */
+        return {
+            text: '[Alcance el limite de rondas (' + maxRounds + '/' + maxRounds +
+                ') en esta tarea (familia=' + (familyResolved ?? 'default') +
+                '). Decime "continua" y sigo desde aca, o sube el cap en ' +
+                '`yf limits set max_tool_rounds.' + (familyResolved ?? 'default') + ' <N>`.]',
+            tokensIn: totalIn,
+            tokensOut: totalOut,
+            model: serverModel,
+            toolRounds,
+        };
+    }
+}
+//# sourceMappingURL=managed_client.js.map

package/dist/llm/managed_client.js.map

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

package/dist/llm/mistral_client.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Mistral brain client (alpha.59h).
+ *
+ * Same unified shape as ClaudeClient / GeminiClient / OpenAIClient.
+ * Mistral exposes a near-OpenAI-compatible Chat Completions API at
+ * https://api.mistral.ai/v1/chat/completions -- auth Bearer, body
+ * matches OpenAI including function calling. Some differences:
+ *   - Response uses 'choices' wrapper like OpenAI.
+ *   - Streaming optional via 'stream: true' (we don't use it here).
+ *   - 'tool_choice' accepts 'any' instead of 'required' (we use 'auto').
+ *
+ * Default model: mistral-large-latest. Alternatives: mistral-medium-latest,
+ * mistral-small-latest, codestral-latest, ministral-3b-latest, ministral-8b-latest.
+ *
+ * ASCII-only.
+ */
+import type { ToolRound, ChatMessage } from '../chat/claude.js';
+import type { ToolSpec } from '../chat/tools.js';
+export interface MistralChatRequest {
+    messages: ChatMessage[];
+    system?: string;
+    maxTokens?: number;
+    model?: string;
+    tools?: ToolSpec[];
+    runTool?: (name: string, input: Record<string, unknown>) => Promise<{
+        result: unknown;
+        is_error?: boolean;
+    }>;
+    maxToolRounds?: number;
+}
+export interface MistralChatResponse {
+    text: string;
+    tokensIn: number;
+    tokensOut: number;
+    model: string;
+    toolRounds: ToolRound[];
+}
+export interface MistralClientOptions {
+    apiKey: string;
+    defaultModel?: string;
+    fetchImpl?: typeof fetch;
+}
+export declare class MistralApiError extends Error {
+    status: number;
+    constructor(message: string, status: number);
+}
+export declare class MistralClient {
+    private apiKey;
+    private fetchImpl;
+    private defaultModel;
+    constructor(opts: MistralClientOptions);
+    chat(req: MistralChatRequest): Promise<MistralChatResponse>;
+}
+//# sourceMappingURL=mistral_client.d.ts.map

package/dist/llm/mistral_client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mistral_client.d.ts","sourceRoot":"","sources":["../../src/llm/mistral_client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAKjD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;QAClE,MAAM,EAAE,OAAO,CAAC;QAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AA6BD,qBAAa,eAAgB,SAAQ,KAAK;IACxC,MAAM,EAAE,MAAM,CAAC;gBACH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAK5C;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,YAAY,CAAS;gBAEjB,IAAI,EAAE,oBAAoB;IAShC,IAAI,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAmJlE"}