@nac3/forge-cli 0.2.0-alpha.8 → 0.2.1-alpha.60

package/dist/license/sync.d.ts

@@ -0,0 +1,59 @@
+/**
+ * License sync -- pulls the canonical license row from the
+ * HITO 4 server and updates the local Polar cache.
+ *
+ * Flow:
+ *   1. Read local cache (~/.yujin-forge/license.json).
+ *      Needs user_handle. If missing -> error pointing to
+ *      `yf license activate --user-handle <email>`.
+ *   2. Call fetchServerLicense via the HMAC-signed Hito4 client.
+ *   3. Map the server response to a LicenseCache patch.
+ *   4. Merge + write back. Bumps last_validated_at to now.
+ *   5. Return a SyncReport for the CLI to print.
+ *
+ * Why this exists: the Polar webhook updates the SERVER-side D1
+ * row. The local cache was never wired to pull. The "activate"
+ * copy advertised "license.json updated automatically" -- it was
+ * not. This fixes that gap.
+ *
+ * ASCII-only.
+ */
+import { type LicenseCache } from '../core/polar.js';
+import { type Hito4ClientDeps } from './hito4_client.js';
+export interface SyncReport {
+    ok: boolean;
+    /** Plan as known to the server. */
+    server_plan?: string;
+    /** Plan we had locally before sync. */
+    local_plan_before?: string;
+    /** Plan we now have locally. */
+    local_plan_after?: string;
+    /** HTTP status from the server call. */
+    http_status?: number;
+    /** Server validated_at timestamp. */
+    last_validated_at?: string;
+    /** Error string when ok=false. */
+    error?: string;
+    /** Verbose log lines (URLs called, headers redacted). Only
+     *  populated when verbose=true. */
+    log?: string[];
+}
+export interface SyncOptions extends Hito4ClientDeps {
+    verbose?: boolean;
+    /** Override the source of the local cache (for tests). */
+    readLocal?: () => Promise<LicenseCache>;
+    /** Override the persist path (for tests). */
+    writeLocal?: (next: LicenseCache) => Promise<void>;
+}
+/** Map a server response body to the LicenseCache plan + fields.
+ *  The server returns the row in one of two shapes depending on the
+ *  endpoint version:
+ *    - flat: {plan, expires_at, subscription_id, customer_id,
+ *      user_handle, cancel_grace_until, bills_first_on,
+ *      trial_started_at, payment_method_attached}
+ *    - nested (current /v1/license worker): {ok: true, license: {
+ *      version: 1, plan, ...same shape as flat}}
+ *  Accept both. alpha.59z.120 fix. */
+export declare function serverBodyToPatch(body: Record<string, unknown>): Partial<LicenseCache> | null;
+export declare function syncLicense(opts?: SyncOptions): Promise<SyncReport>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/license/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/license/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAGL,KAAK,YAAY,EAElB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE7E,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gCAAgC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;uCACmC;IACnC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;IACxC,6CAA6C;IAC7C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED;;;;;;;;sCAQsC;AACtC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CA6B7F;AAED,wBAAsB,WAAW,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAuF7E"}

package/dist/license/sync.js

@@ -0,0 +1,148 @@
+/**
+ * License sync -- pulls the canonical license row from the
+ * HITO 4 server and updates the local Polar cache.
+ *
+ * Flow:
+ *   1. Read local cache (~/.yujin-forge/license.json).
+ *      Needs user_handle. If missing -> error pointing to
+ *      `yf license activate --user-handle <email>`.
+ *   2. Call fetchServerLicense via the HMAC-signed Hito4 client.
+ *   3. Map the server response to a LicenseCache patch.
+ *   4. Merge + write back. Bumps last_validated_at to now.
+ *   5. Return a SyncReport for the CLI to print.
+ *
+ * Why this exists: the Polar webhook updates the SERVER-side D1
+ * row. The local cache was never wired to pull. The "activate"
+ * copy advertised "license.json updated automatically" -- it was
+ * not. This fixes that gap.
+ *
+ * ASCII-only.
+ */
+import { readLicense as readPolarLicense, writeLicense as writePolarLicense, } from '../core/polar.js';
+import { fetchServerLicense } from './hito4_client.js';
+/** Map a server response body to the LicenseCache plan + fields.
+ *  The server returns the row in one of two shapes depending on the
+ *  endpoint version:
+ *    - flat: {plan, expires_at, subscription_id, customer_id,
+ *      user_handle, cancel_grace_until, bills_first_on,
+ *      trial_started_at, payment_method_attached}
+ *    - nested (current /v1/license worker): {ok: true, license: {
+ *      version: 1, plan, ...same shape as flat}}
+ *  Accept both. alpha.59z.120 fix. */
+export function serverBodyToPatch(body) {
+    if (!body || typeof body !== 'object')
+        return null;
+    /* Prefer body.license.* when present (nested shape); fall back
+     * to body.* (flat shape). */
+    const src = (body.license && typeof body.license === 'object')
+        ? body.license
+        : body;
+    const planRaw = src.plan;
+    const validPlans = [
+        'none', 'trial', 'paid', 'cancelled', 'free-public', 'institutional', 'gifted',
+    ];
+    if (typeof planRaw !== 'string' || !validPlans.includes(planRaw)) {
+        return null;
+    }
+    const patch = { plan: planRaw };
+    if (typeof src.subscription_id === 'string')
+        patch.subscription_id = src.subscription_id;
+    if (typeof src.user_handle === 'string')
+        patch.user_handle = src.user_handle.toLowerCase();
+    if (typeof src.cancel_grace_until === 'string')
+        patch.cancel_grace_until = src.cancel_grace_until;
+    if (typeof src.bills_first_on === 'string')
+        patch.bills_first_on = src.bills_first_on;
+    if (typeof src.trial_started_at === 'string')
+        patch.trial_started_at = src.trial_started_at;
+    if (src.expires_at === null || typeof src.expires_at === 'string') {
+        patch.expires_at = src.expires_at;
+    }
+    if (typeof src.payment_method_attached === 'boolean'
+        || typeof src.payment_method_attached === 'number') {
+        patch.payment_method_attached = Boolean(src.payment_method_attached);
+    }
+    return patch;
+}
+export async function syncLicense(opts = {}) {
+    const log = [];
+    const verbose = Boolean(opts.verbose);
+    const readLocal = opts.readLocal ?? readPolarLicense;
+    const writeLocal = opts.writeLocal ?? writePolarLicense;
+    const local = await readLocal();
+    if (verbose) {
+        log.push('[license-sync] local cache loaded plan=' + local.plan
+            + ' user_handle=' + (local.user_handle ?? '(none)'));
+    }
+    if (!local.user_handle) {
+        return {
+            ok: false,
+            error: 'no user_handle on local license cache. Run `yf license activate --user-handle <you@example.com>` first.',
+            local_plan_before: local.plan,
+            log: verbose ? log : undefined,
+        };
+    }
+    if (verbose)
+        log.push('[license-sync] calling Hito4 fetchServerLicense for ' + local.user_handle);
+    let resp;
+    try {
+        resp = await fetchServerLicense(opts);
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: err instanceof Error ? err.message : String(err),
+            local_plan_before: local.plan,
+            log: verbose ? log : undefined,
+        };
+    }
+    if (verbose) {
+        log.push('[license-sync] server HTTP ' + resp.status + ' ok=' + resp.ok);
+    }
+    if (!resp.ok) {
+        return {
+            ok: false,
+            error: typeof resp.body?.error === 'string' ? resp.body.error : 'server returned HTTP ' + resp.status,
+            http_status: resp.status,
+            server_plan: typeof resp.body?.plan === 'string' ? resp.body.plan : undefined,
+            local_plan_before: local.plan,
+            log: verbose ? log : undefined,
+        };
+    }
+    const patch = serverBodyToPatch(resp.body);
+    if (!patch) {
+        /* alpha.59z.116 -- include a short preview of the server body
+         * so the user can see WHY it did not match. Common causes:
+         *   - server returned {error:"not_found"} because the
+         *     user_handle has no D1 row yet (Polar webhook still pending).
+         *   - server returned the row in a nested {license:{...}} shape.
+         *   - server returned plan with an unknown enum value. */
+        const preview = JSON.stringify(resp.body).slice(0, 280);
+        return {
+            ok: false,
+            error: 'server response body did not contain a valid plan field. body preview: ' + preview,
+            http_status: resp.status,
+            local_plan_before: local.plan,
+            log: verbose ? log : undefined,
+        };
+    }
+    const merged = {
+        ...local,
+        ...patch,
+        last_validated_at: new Date().toISOString(),
+    };
+    await writeLocal(merged);
+    if (verbose) {
+        log.push('[license-sync] local cache updated plan=' + local.plan + ' -> ' + merged.plan);
+    }
+    return {
+        ok: true,
+        server_plan: patch.plan,
+        local_plan_before: local.plan,
+        local_plan_after: merged.plan,
+        http_status: resp.status,
+        last_validated_at: merged.last_validated_at,
+        log: verbose ? log : undefined,
+    };
+}
+//# sourceMappingURL=sync.js.map

package/dist/license/sync.js.map

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

package/dist/llm/cohere_client.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Cohere brain client (alpha.59h).
+ *
+ * Cohere v2 Chat API differs from OpenAI shape -- they migrated to
+ * a structured-message format that supports tool_calls + tool_results
+ * but keeps content as either a string or a typed content-block array.
+ *
+ * Endpoint: POST https://api.cohere.com/v2/chat
+ * Auth: Authorization: Bearer <key>
+ *
+ * Request shape:
+ *   {
+ *     model: "command-r-plus-08-2024" | "command-r-08-2024" | ...,
+ *     messages: [
+ *       { role: "system", content: "..." },
+ *       { role: "user", content: "..." },
+ *       { role: "assistant", content: "...", tool_calls: [...]? },
+ *       { role: "tool", tool_call_id: "...", content: "..." }
+ *     ],
+ *     tools: [{
+ *       type: "function",
+ *       function: { name, description, parameters }
+ *     }],
+ *     max_tokens: 1024
+ *   }
+ *
+ * Response shape:
+ *   {
+ *     id: "...",
+ *     message: {
+ *       role: "assistant",
+ *       content: [{ type: "text", text: "..." }] | "...",
+ *       tool_calls?: [{ id, type, function: { name, arguments } }]
+ *     },
+ *     finish_reason: "complete" | "tool_call" | "max_tokens" | ...,
+ *     usage: { tokens: { input_tokens, output_tokens } }
+ *   }
+ *
+ * Default model: command-r-plus-08-2024. Alternative: command-r-08-2024
+ * (cheaper, smaller), command-a-03-2025 (top-of-line).
+ *
+ * ASCII-only.
+ */
+import type { ToolRound, ChatMessage } from '../chat/claude.js';
+import type { ToolSpec } from '../chat/tools.js';
+export interface CohereChatRequest {
+    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 CohereChatResponse {
+    text: string;
+    tokensIn: number;
+    tokensOut: number;
+    model: string;
+    toolRounds: ToolRound[];
+}
+export interface CohereClientOptions {
+    apiKey: string;
+    defaultModel?: string;
+    fetchImpl?: typeof fetch;
+}
+export declare class CohereApiError extends Error {
+    status: number;
+    constructor(message: string, status: number);
+}
+export declare class CohereClient {
+    private apiKey;
+    private fetchImpl;
+    private defaultModel;
+    constructor(opts: CohereClientOptions);
+    chat(req: CohereChatRequest): Promise<CohereChatResponse>;
+}
+//# sourceMappingURL=cohere_client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cohere_client.d.ts","sourceRoot":"","sources":["../../src/llm/cohere_client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAKjD,MAAM,WAAW,iBAAiB;IAChC,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,kBAAkB;IACjC,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,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AA6BD,qBAAa,cAAe,SAAQ,KAAK;IACvC,MAAM,EAAE,MAAM,CAAC;gBACH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAK5C;AAaD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,YAAY,CAAS;gBAEjB,IAAI,EAAE,mBAAmB;IAS/B,IAAI,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CA+JhE"}

package/dist/llm/cohere_client.js

@@ -0,0 +1,195 @@
+const COHERE_BASE = 'https://api.cohere.com/v2/chat';
+const DEFAULT_COHERE_MODEL = 'command-r-plus-08-2024';
+export class CohereApiError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.name = 'CohereApiError';
+        this.status = status;
+    }
+}
+function extractText(content) {
+    if (typeof content === 'string')
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .filter((b) => b && b.type === 'text' && typeof b.text === 'string')
+            .map((b) => b.text)
+            .join('');
+    }
+    return '';
+}
+export class CohereClient {
+    apiKey;
+    fetchImpl;
+    defaultModel;
+    constructor(opts) {
+        if (!opts.apiKey || opts.apiKey.trim() === '') {
+            throw new Error('CohereClient: apiKey required');
+        }
+        this.apiKey = opts.apiKey.trim();
+        this.fetchImpl = opts.fetchImpl ?? fetch;
+        this.defaultModel = opts.defaultModel ?? DEFAULT_COHERE_MODEL;
+    }
+    async chat(req) {
+        if (req.tools && !req.runTool) {
+            throw new Error('CohereChatRequest.tools requires a runTool callback');
+        }
+        const model = req.model ?? this.defaultModel;
+        const maxTokens = req.maxTokens ?? 1024;
+        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 messages = [];
+        if (req.system && req.system.trim() !== '') {
+            messages.push({ role: 'system', content: req.system });
+        }
+        for (const m of req.messages) {
+            messages.push({ role: m.role, content: m.content });
+        }
+        const tools = (req.tools ?? []).map((t) => ({
+            type: 'function',
+            function: {
+                name: t.name,
+                description: t.description,
+                parameters: t.input_schema,
+            },
+        }));
+        let totalIn = 0;
+        let totalOut = 0;
+        let serverModel = model;
+        const toolRounds = [];
+        for (let round = 0; round < maxRounds; round++) {
+            void round;
+            const body = {
+                model,
+                messages,
+                max_tokens: maxTokens,
+            };
+            if (tools.length > 0) {
+                body.tools = tools;
+            }
+            const res = await this.fetchImpl(COHERE_BASE, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json',
+                    'authorization': 'Bearer ' + this.apiKey,
+                    'accept': 'application/json',
+                },
+                body: JSON.stringify(body),
+            });
+            let json;
+            try {
+                json = await res.json();
+            }
+            catch {
+                throw new CohereApiError('Cohere returned non-JSON body', res.status);
+            }
+            if (!res.ok) {
+                const maybeErr = json;
+                const detail = (maybeErr && typeof maybeErr.message === 'string')
+                    ? maybeErr.message
+                    : 'HTTP ' + res.status;
+                throw new CohereApiError('Cohere API error: ' + detail, res.status);
+            }
+            const aMessage = json.message;
+            if (!aMessage) {
+                throw new CohereApiError('Cohere returned no message', 502);
+            }
+            const finishReason = json.finish_reason;
+            totalIn += json.usage?.tokens?.input_tokens ?? 0;
+            totalOut += json.usage?.tokens?.output_tokens ?? 0;
+            /* Cohere does not echo model id in v2 response yet; keep server
+             *  model = requested. */
+            const text = extractText(aMessage.content);
+            const calls = aMessage.tool_calls || [];
+            if (calls.length === 0 || finishReason !== 'tool_call') {
+                return {
+                    text,
+                    tokensIn: totalIn,
+                    tokensOut: totalOut,
+                    model: serverModel,
+                    toolRounds,
+                };
+            }
+            if (familyResolved === null) {
+                const firstTc = calls[0];
+                if (firstTc) {
+                    let firstArgs = {};
+                    try {
+                        firstArgs = JSON.parse(firstTc.function.arguments || '{}');
+                    }
+                    catch { /* */ }
+                    const firstVerb = firstArgs.verb_id || firstTc.function.name || '';
+                    const fam = classifyVerbFamily(firstVerb);
+                    familyResolved = fam;
+                    if (!callerSpecifiedCap) {
+                        const famCap = getMaxToolRoundsForFamily(limits.max_tool_rounds, fam);
+                        if (famCap > maxRounds)
+                            maxRounds = famCap;
+                    }
+                }
+            }
+            messages.push({
+                role: 'assistant',
+                content: aMessage.content ?? null,
+                tool_calls: calls,
+            });
+            for (const tc of calls) {
+                let parsedArgs = {};
+                try {
+                    parsedArgs = JSON.parse(tc.function.arguments || '{}');
+                }
+                catch { /* */ }
+                let result;
+                let isError = false;
+                try {
+                    const r = await req.runTool(tc.function.name, parsedArgs);
+                    result = r.result;
+                    isError = r.is_error === true;
+                }
+                catch (err) {
+                    result = { error: err instanceof Error ? err.message : String(err) };
+                    isError = true;
+                }
+                const display = typeof result === 'object' && result !== null && 'display' in result
+                    ? String(result.display)
+                    : undefined;
+                toolRounds.push({
+                    tool: tc.function.name,
+                    tool_use_id: tc.id,
+                    input: parsedArgs,
+                    ...(display ? { display } : {}),
+                    ...(isError ? { is_error: true } : {}),
+                    result,
+                });
+                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 });
+                }
+                messages.push({ role: 'tool', tool_call_id: tc.id, content: resultStr });
+            }
+        }
+        return {
+            text: '[Alcance el limite de rondas (' + maxRounds + '/' + maxRounds +
+                ') en esta tarea (familia=' + (familyResolved ?? 'default') + ').]',
+            tokensIn: totalIn,
+            tokensOut: totalOut,
+            model: serverModel,
+            toolRounds,
+        };
+    }
+}
+//# sourceMappingURL=cohere_client.js.map

package/dist/llm/cohere_client.js.map

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

package/dist/llm/deepseek_client.d.ts

@@ -0,0 +1,63 @@
+/**
+ * DeepSeek brain client (alpha.59g).
+ *
+ * Same shape as ClaudeClient / GeminiClient / OpenAIClient.
+ * Implements the same unified chat() interface so multi-provider
+ * routing can swap providers transparently.
+ *
+ * DeepSeek exposes an OpenAI-compatible Chat Completions API at
+ * https://api.deepseek.com/chat/completions. Auth is a Bearer
+ * token + the request/response shape matches OpenAI exactly,
+ * including function calling (tools / tool_calls). We delegate
+ * to the same loop logic OpenAIClient uses; the only difference
+ * is the base URL.
+ *
+ * Pricing leverage: DeepSeek pricing per million tokens is
+ * roughly 1/4 of GPT-4o + 1/2 of Gemini Flash. Good fit for the
+ * eco tier when budgets matter; reasoner variant decent for
+ * frontier-like work in non-coding contexts.
+ *
+ * Default models:
+ *   deepseek-chat       -- general purpose (V3.1)
+ *   deepseek-reasoner   -- R1 series, slower, deeper reasoning
+ *
+ * ASCII-only.
+ */
+import type { ToolRound, ChatMessage } from '../chat/claude.js';
+import type { ToolSpec } from '../chat/tools.js';
+export interface DeepSeekChatRequest {
+    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 DeepSeekChatResponse {
+    text: string;
+    tokensIn: number;
+    tokensOut: number;
+    model: string;
+    toolRounds: ToolRound[];
+}
+export interface DeepSeekClientOptions {
+    apiKey: string;
+    defaultModel?: string;
+    fetchImpl?: typeof fetch;
+}
+export declare class DeepSeekApiError extends Error {
+    status: number;
+    constructor(message: string, status: number);
+}
+export declare class DeepSeekClient {
+    private apiKey;
+    private fetchImpl;
+    private defaultModel;
+    constructor(opts: DeepSeekClientOptions);
+    chat(req: DeepSeekChatRequest): Promise<DeepSeekChatResponse>;
+}
+//# sourceMappingURL=deepseek_client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deepseek_client.d.ts","sourceRoot":"","sources":["../../src/llm/deepseek_client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAMjD,MAAM,WAAW,mBAAmB;IAClC,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,oBAAoB;IACnC,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,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AA6BD,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,MAAM,EAAE,MAAM,CAAC;gBACH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAK5C;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,YAAY,CAAS;gBAEjB,IAAI,EAAE,qBAAqB;IASjC,IAAI,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAqKpE"}