@backendkit-labs/agent-coding 0.14.0

package/dist/providers/AnthropicProvider.js

@@ -0,0 +1,185 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnthropicProvider = void 0;
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+// ── Fix #14: concatenate all system messages ──────────────────────────────────
+function toAnthropicMessages(messages) {
+    const systemParts = [];
+    const result = [];
+    let i = 0;
+    while (i < messages.length) {
+        const msg = messages[i];
+        if (msg.role === 'system') {
+            if (msg.content)
+                systemParts.push(msg.content);
+            i++;
+            continue;
+        }
+        if (msg.role === 'user') {
+            result.push({ role: 'user', content: msg.content ?? '' });
+            i++;
+            continue;
+        }
+        if (msg.role === 'assistant') {
+            const content = [];
+            if (msg.content)
+                content.push({ type: 'text', text: msg.content });
+            for (const tc of msg.tool_calls ?? []) {
+                content.push({
+                    type: 'tool_use',
+                    id: tc.id,
+                    name: tc.function.name,
+                    input: JSON.parse(tc.function.arguments || '{}'),
+                });
+            }
+            result.push({ role: 'assistant', content });
+            i++;
+            continue;
+        }
+        if (msg.role === 'tool') {
+            // Consecutive tool results → single user message with tool_result blocks
+            const toolResults = [];
+            while (i < messages.length && messages[i].role === 'tool') {
+                const t = messages[i];
+                toolResults.push({
+                    type: 'tool_result',
+                    tool_use_id: t.tool_call_id ?? '',
+                    content: t.content ?? '',
+                });
+                i++;
+            }
+            result.push({ role: 'user', content: toolResults });
+            continue;
+        }
+        i++;
+    }
+    return {
+        system: systemParts.length > 0 ? systemParts.join('\n\n') : undefined,
+        messages: result,
+    };
+}
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function isRetryable(err) {
+    if (err && typeof err === 'object' && 'status' in err) {
+        const status = err.status;
+        return status === 429 || status >= 500;
+    }
+    return false;
+}
+function backoffMs(attempt) {
+    return Math.min(1000 * Math.pow(2, attempt), 16_000);
+}
+const sleep = (ms) => new Promise(r => setTimeout(r, ms));
+// ── Provider ──────────────────────────────────────────────────────────────────
+class AnthropicProvider {
+    client;
+    model;
+    maxTokens;
+    temperature;
+    maxRetries;
+    constructor(opts) {
+        this.client = new sdk_1.default({ apiKey: opts.apiKey, maxRetries: 0 }); // we handle retries ourselves
+        this.model = opts.model ?? 'claude-sonnet-4-6';
+        this.maxTokens = opts.maxTokens ?? 8192;
+        this.temperature = opts.temperature ?? 0.0;
+        this.maxRetries = opts.maxRetries ?? 3;
+    }
+    async chat(messages, tools, callbacks) {
+        const { system, messages: anthropicMessages } = toAnthropicMessages(messages);
+        const anthropicTools = tools.map(t => ({
+            name: t.name,
+            description: t.description,
+            input_schema: t.parameters,
+        }));
+        let attempt = 0;
+        let contentEmitted = false;
+        while (attempt < this.maxRetries) {
+            attempt++;
+            try {
+                await this.stream({ system, anthropicMessages, anthropicTools }, {
+                    ...callbacks,
+                    onChunk: (delta) => {
+                        contentEmitted = true;
+                        callbacks.onChunk?.(delta);
+                    },
+                });
+                return;
+            }
+            catch (err) {
+                // Never retry mid-stream — content was already emitted to the caller
+                if (contentEmitted || !isRetryable(err) || attempt >= this.maxRetries) {
+                    callbacks.onError(err instanceof Error ? err : new Error(String(err)));
+                    return;
+                }
+                await sleep(backoffMs(attempt));
+            }
+        }
+    }
+    async stream(params, callbacks) {
+        const stream = this.client.messages.stream({
+            model: this.model,
+            max_tokens: this.maxTokens,
+            temperature: this.temperature,
+            ...(params.system ? { system: params.system } : {}),
+            messages: params.anthropicMessages,
+            ...(params.anthropicTools.length > 0 ? { tools: params.anthropicTools } : {}),
+        }, { signal: callbacks.signal });
+        let contentBuffer = '';
+        const toolCallBuffers = new Map();
+        let inputTokens = 0;
+        let outputTokens = 0;
+        for await (const event of stream) {
+            // ── Fix #16: token counting ───────────────────────────────────────
+            if (event.type === 'message_start') {
+                inputTokens = event.message.usage.input_tokens;
+            }
+            else if (event.type === 'message_delta') {
+                outputTokens = event.usage.output_tokens;
+            }
+            else if (event.type === 'content_block_start') {
+                if (event.content_block.type === 'tool_use') {
+                    toolCallBuffers.set(event.index, {
+                        id: event.content_block.id,
+                        name: event.content_block.name,
+                        args: '',
+                    });
+                }
+            }
+            else if (event.type === 'content_block_delta') {
+                if (event.delta.type === 'text_delta') {
+                    contentBuffer += event.delta.text;
+                    callbacks.onChunk?.(event.delta.text);
+                }
+                else if (event.delta.type === 'input_json_delta') {
+                    const buf = toolCallBuffers.get(event.index);
+                    if (buf)
+                        buf.args += event.delta.partial_json;
+                }
+            }
+        }
+        // Report token usage to observability
+        if (inputTokens > 0 || outputTokens > 0) {
+            callbacks.onMetrics?.(inputTokens, outputTokens);
+        }
+        const toolCalls = Array.from(toolCallBuffers.entries())
+            .sort(([a], [b]) => a - b)
+            .map(([, buf]) => ({
+            id: buf.id,
+            type: 'function',
+            function: { name: buf.name, arguments: buf.args },
+        }));
+        for (const tc of toolCalls) {
+            callbacks.onToolCall?.(tc.function.name, tc.function.arguments, tc.id);
+        }
+        callbacks.onDone({
+            role: 'assistant',
+            content: contentBuffer || null,
+            tool_calls: toolCalls.length > 0 ? toolCalls : undefined,
+        });
+    }
+}
+exports.AnthropicProvider = AnthropicProvider;
+//# sourceMappingURL=AnthropicProvider.js.map

package/dist/providers/AnthropicProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnthropicProvider.js","sourceRoot":"","sources":["../../src/providers/AnthropicProvider.ts"],"names":[],"mappings":";;;;;;AAAA,4DAA0C;AAe1C,iFAAiF;AACjF,SAAS,mBAAmB,CAAC,QAAsB;IAC/C,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,MAAM,GAAuB,EAAE,CAAC;IAEtC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAExB,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACxB,IAAI,GAAG,CAAC,OAAO;gBAAE,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC/C,CAAC,EAAE,CAAC;YACJ,SAAS;QACb,CAAC;QAED,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1D,CAAC,EAAE,CAAC;YACJ,SAAS;QACb,CAAC;QAED,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAuB,EAAE,CAAC;YACvC,IAAI,GAAG,CAAC,OAAO;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACnE,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;gBACpC,OAAO,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,UAAU;oBAChB,EAAE,EAAE,EAAE,CAAC,EAAE;oBACT,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI;oBACtB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,IAAI,IAAI,CAAC;iBACnD,CAAC,CAAC;YACP,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;YAC5C,CAAC,EAAE,CAAC;YACJ,SAAS;QACb,CAAC;QAED,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACtB,yEAAyE;YACzE,MAAM,WAAW,GAAqC,EAAE,CAAC;YACzD,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACxD,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;gBACtB,WAAW,CAAC,IAAI,CAAC;oBACb,IAAI,EAAE,aAAa;oBACnB,WAAW,EAAE,CAAC,CAAC,YAAY,IAAI,EAAE;oBACjC,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE;iBAC3B,CAAC,CAAC;gBACH,CAAC,EAAE,CAAC;YACR,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YACpD,SAAS;QACb,CAAC;QAED,CAAC,EAAE,CAAC;IACR,CAAC;IAED,OAAO;QACH,MAAM,EAAE,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;QACrE,QAAQ,EAAE,MAAM;KACnB,CAAC;AACN,CAAC;AAED,iFAAiF;AAEjF,SAAS,WAAW,CAAC,GAAY;IAC7B,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,QAAQ,IAAI,GAAG,EAAE,CAAC;QACpD,MAAM,MAAM,GAAI,GAA0B,CAAC,MAAM,CAAC;QAClD,OAAO,MAAM,KAAK,GAAG,IAAI,MAAM,IAAI,GAAG,CAAC;IAC3C,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,SAAS,SAAS,CAAC,OAAe;IAC9B,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAExE,iFAAiF;AAEjF,MAAa,iBAAiB;IACT,MAAM,CAAY;IAClB,KAAK,CAAS;IACd,SAAS,CAAS;IAClB,WAAW,CAAS;IACpB,UAAU,CAAS;IAEpC,YAAY,IAA8B;QACtC,IAAI,CAAC,MAAM,GAAG,IAAI,aAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,8BAA8B;QACnG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,mBAAmB,CAAC;QAC/C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,GAAG,CAAC;QAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAsB,EAAE,KAAuB,EAAE,SAA6B;QACrF,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAC9E,MAAM,cAAc,GAAqB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACrD,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,YAAY,EAAE,CAAC,CAAC,UAA4C;SAC/D,CAAC,CAAC,CAAC;QAEJ,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,cAAc,GAAG,KAAK,CAAC;QAE3B,OAAO,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC/B,OAAO,EAAE,CAAC;YACV,IAAI,CAAC;gBACD,MAAM,IAAI,CAAC,MAAM,CACb,EAAE,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,EAC7C;oBACI,GAAG,SAAS;oBACZ,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;wBACf,cAAc,GAAG,IAAI,CAAC;wBACtB,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;oBAC/B,CAAC;iBACJ,CACJ,CAAC;gBACF,OAAO;YACX,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,qEAAqE;gBACrE,IAAI,cAAc,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;oBACpE,SAAS,CAAC,OAAO,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;oBACvE,OAAO;gBACX,CAAC;gBACD,MAAM,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YACpC,CAAC;QACL,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,MAAM,CAChB,MAIC,EACD,SAA6B;QAE7B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YACvC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,IAAI,CAAC,SAAS;YAC1B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,QAAQ,EAAE,MAAM,CAAC,iBAAiB;YAClC,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChF,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QAEjC,IAAI,aAAa,GAAG,EAAE,CAAC;QACvB,MAAM,eAAe,GAAG,IAAI,GAAG,EAAsD,CAAC;QACtF,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC/B,qEAAqE;YACrE,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBACjC,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC;YACnD,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBACxC,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC;YAC7C,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;gBAC9C,IAAI,KAAK,CAAC,aAAa,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;oBAC1C,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE;wBAC7B,EAAE,EAAE,KAAK,CAAC,aAAa,CAAC,EAAE;wBAC1B,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC,IAAI;wBAC9B,IAAI,EAAE,EAAE;qBACX,CAAC,CAAC;gBACP,CAAC;YACL,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;gBAC9C,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;oBACpC,aAAa,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;oBAClC,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC1C,CAAC;qBAAM,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;oBACjD,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBAC7C,IAAI,GAAG;wBAAE,GAAG,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC;gBAClD,CAAC;YACL,CAAC;QACL,CAAC;QAED,sCAAsC;QACtC,IAAI,WAAW,GAAG,CAAC,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACtC,SAAS,CAAC,SAAS,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;aAClD,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;aACzB,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;YACf,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,IAAI,EAAE,UAAmB;YACzB,QAAQ,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE;SACpD,CAAC,CAAC,CAAC;QAER,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;YACzB,SAAS,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3E,CAAC;QAED,SAAS,CAAC,MAAM,CAAC;YACb,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,aAAa,IAAI,IAAI;YAC9B,UAAU,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;SAC3D,CAAC,CAAC;IACP,CAAC;CACJ;AAzHD,8CAyHC"}

package/dist/providers/DeepSeekProvider.d.ts

@@ -0,0 +1,11 @@
+import { OpenAICompatibleProvider } from './OpenAICompatibleProvider';
+import type { OpenAICompatibleProviderOptions } from './OpenAICompatibleProvider';
+export type DeepSeekProviderOptions = Omit<OpenAICompatibleProviderOptions, 'baseUrl' | 'model'> & {
+    model?: string;
+    baseUrl?: string;
+};
+/** Thin alias for OpenAICompatibleProvider pre-configured for DeepSeek */
+export declare class DeepSeekProvider extends OpenAICompatibleProvider {
+    constructor(opts: DeepSeekProviderOptions);
+}
+//# sourceMappingURL=DeepSeekProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DeepSeekProvider.d.ts","sourceRoot":"","sources":["../../src/providers/DeepSeekProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AAElF,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,+BAA+B,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG;IAC/F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,0EAA0E;AAC1E,qBAAa,gBAAiB,SAAQ,wBAAwB;gBAC9C,IAAI,EAAE,uBAAuB;CAS5C"}

package/dist/providers/DeepSeekProvider.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeepSeekProvider = void 0;
+const OpenAICompatibleProvider_1 = require("./OpenAICompatibleProvider");
+/** Thin alias for OpenAICompatibleProvider pre-configured for DeepSeek */
+class DeepSeekProvider extends OpenAICompatibleProvider_1.OpenAICompatibleProvider {
+    constructor(opts) {
+        super({
+            apiKey: opts.apiKey,
+            baseUrl: opts.baseUrl ?? 'https://api.deepseek.com/v1',
+            model: opts.model ?? 'deepseek-chat',
+            maxTokens: opts.maxTokens,
+            temperature: opts.temperature,
+        });
+    }
+}
+exports.DeepSeekProvider = DeepSeekProvider;
+//# sourceMappingURL=DeepSeekProvider.js.map

package/dist/providers/DeepSeekProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeepSeekProvider.js","sourceRoot":"","sources":["../../src/providers/DeepSeekProvider.ts"],"names":[],"mappings":";;;AAAA,yEAAsE;AAQtE,0EAA0E;AAC1E,MAAa,gBAAiB,SAAQ,mDAAwB;IAC1D,YAAY,IAA6B;QACrC,KAAK,CAAC;YACF,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,6BAA6B;YACtD,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,eAAe;YACpC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;SAChC,CAAC,CAAC;IACP,CAAC;CACJ;AAVD,4CAUC"}

package/dist/providers/OpenAICompatibleProvider.d.ts

@@ -0,0 +1,22 @@
+import type { LLMProvider, LLMMessage, LLMStreamCallbacks, ToolDefinition } from '@backendkit-labs/agent-core';
+export interface OpenAICompatibleProviderOptions {
+    apiKey: string;
+    baseUrl: string;
+    model: string;
+    maxTokens?: number;
+    temperature?: number;
+    /** Max retry attempts on transient errors (429, 5xx). Default: 3. */
+    maxRetries?: number;
+}
+export declare class OpenAICompatibleProvider implements LLMProvider {
+    private readonly client;
+    private readonly model;
+    private readonly maxTokens;
+    private readonly temperature;
+    private readonly maxRetries;
+    constructor(opts: OpenAICompatibleProviderOptions);
+    chat(messages: LLMMessage[], tools: ToolDefinition[], callbacks: LLMStreamCallbacks): Promise<void>;
+    private stream;
+    private buildTools;
+}
+//# sourceMappingURL=OpenAICompatibleProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAICompatibleProvider.d.ts","sourceRoot":"","sources":["../../src/providers/OpenAICompatibleProvider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE/G,MAAM,WAAW,+BAA+B;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAgBD,qBAAa,wBAAyB,YAAW,WAAW;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,IAAI,EAAE,+BAA+B;IAQ3C,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,SAAS,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;YA8B3F,MAAM;IAiEpB,OAAO,CAAC,UAAU;CAMrB"}

package/dist/providers/OpenAICompatibleProvider.js

@@ -0,0 +1,124 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAICompatibleProvider = void 0;
+const openai_1 = __importDefault(require("openai"));
+function isRetryable(err) {
+    if (err && typeof err === 'object' && 'status' in err) {
+        const status = err.status;
+        return status === 429 || status >= 500;
+    }
+    return false;
+}
+function backoffMs(attempt) {
+    return Math.min(1000 * Math.pow(2, attempt), 16_000);
+}
+const sleep = (ms) => new Promise(r => setTimeout(r, ms));
+class OpenAICompatibleProvider {
+    client;
+    model;
+    maxTokens;
+    temperature;
+    maxRetries;
+    constructor(opts) {
+        this.client = new openai_1.default({ apiKey: opts.apiKey, baseURL: opts.baseUrl, maxRetries: 0 });
+        this.model = opts.model;
+        this.maxTokens = opts.maxTokens ?? 16384;
+        this.temperature = opts.temperature ?? 0.0;
+        this.maxRetries = opts.maxRetries ?? 3;
+    }
+    async chat(messages, tools, callbacks) {
+        const openaiTools = tools.map(t => ({
+            type: 'function',
+            function: { name: t.name, description: t.description, parameters: t.parameters },
+        }));
+        let attempt = 0;
+        let contentEmitted = false;
+        while (attempt < this.maxRetries) {
+            attempt++;
+            try {
+                await this.stream(messages, openaiTools, {
+                    ...callbacks,
+                    onChunk: (delta) => {
+                        contentEmitted = true;
+                        callbacks.onChunk?.(delta);
+                    },
+                });
+                return;
+            }
+            catch (err) {
+                if (contentEmitted || !isRetryable(err) || attempt >= this.maxRetries) {
+                    callbacks.onError(err instanceof Error ? err : new Error(String(err)));
+                    return;
+                }
+                await sleep(backoffMs(attempt));
+            }
+        }
+    }
+    async stream(messages, openaiTools, callbacks) {
+        const stream = await this.client.chat.completions.create({
+            model: this.model,
+            messages: messages,
+            tools: openaiTools.length > 0 ? openaiTools : undefined,
+            tool_choice: openaiTools.length > 0 ? 'auto' : undefined,
+            max_tokens: this.maxTokens,
+            temperature: this.temperature,
+            stream: true,
+            stream_options: { include_usage: true }, // Fix #16: enables usage in final chunk
+        }, { signal: callbacks.signal });
+        let contentBuffer = '';
+        const toolCallBuffers = new Map();
+        for await (const chunk of stream) {
+            // Fix #16: usage is in the final chunk when include_usage: true
+            if (chunk.usage) {
+                callbacks.onMetrics?.(chunk.usage.prompt_tokens, chunk.usage.completion_tokens);
+            }
+            const delta = chunk.choices[0]?.delta;
+            if (!delta)
+                continue;
+            if (delta.content) {
+                contentBuffer += delta.content;
+                callbacks.onChunk?.(delta.content);
+            }
+            if (delta.tool_calls) {
+                for (const tc of delta.tool_calls) {
+                    if (!toolCallBuffers.has(tc.index)) {
+                        toolCallBuffers.set(tc.index, { id: tc.id ?? '', name: '', args: '' });
+                    }
+                    const buf = toolCallBuffers.get(tc.index);
+                    if (tc.id)
+                        buf.id = tc.id;
+                    if (tc.function?.name)
+                        buf.name += tc.function.name;
+                    if (tc.function?.arguments)
+                        buf.args += tc.function.arguments;
+                }
+            }
+        }
+        const toolCalls = Array.from(toolCallBuffers.entries())
+            .sort(([a], [b]) => a - b)
+            .map(([, buf]) => ({
+            id: buf.id,
+            type: 'function',
+            function: { name: buf.name, arguments: buf.args },
+        }));
+        for (const tc of toolCalls) {
+            callbacks.onToolCall?.(tc.function.name, tc.function.arguments, tc.id);
+        }
+        callbacks.onDone({
+            role: 'assistant',
+            content: contentBuffer || null,
+            tool_calls: toolCalls.length > 0 ? toolCalls : undefined,
+        });
+    }
+    buildTools(tools) {
+        return tools.map(t => ({
+            type: 'function',
+            function: { name: t.name, description: t.description, parameters: t.parameters },
+        }));
+    }
+}
+exports.OpenAICompatibleProvider = OpenAICompatibleProvider;
+//# sourceMappingURL=OpenAICompatibleProvider.js.map

package/dist/providers/OpenAICompatibleProvider.js.map

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

package/dist/skills/builtins/global.d.ts

@@ -0,0 +1,7 @@
+import type { Skill } from '@backendkit-labs/agent-core';
+/**
+ * Language-agnostic skills built into the framework.
+ * These are always available regardless of project stack.
+ */
+export declare const GLOBAL_BUILTIN_SKILLS: Skill[];
+//# sourceMappingURL=global.d.ts.map

package/dist/skills/builtins/global.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.d.ts","sourceRoot":"","sources":["../../../src/skills/builtins/global.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,KAAK,EAuMxC,CAAC"}

package/dist/skills/builtins/global.js

@@ -0,0 +1,208 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GLOBAL_BUILTIN_SKILLS = void 0;
+/**
+ * Language-agnostic skills built into the framework.
+ * These are always available regardless of project stack.
+ */
+exports.GLOBAL_BUILTIN_SKILLS = [
+    {
+        name: 'conventional-commits',
+        version: '1.0.0',
+        description: 'Conventional Commits specification for any language or stack',
+        scope: 'global',
+        triggers: [
+            'commit', 'conventional commit', 'commit message', 'mensaje de commit',
+            'changelog', 'semantic versioning', 'semver', 'release notes',
+        ],
+        systemPromptAddition: `## Conventional Commits
+
+Formato obligatorio para todos los commits:
+\`<type>(<scope>): <description>\`
+
+### Tipos
+| Tipo | Cuando usarlo |
+|---|---|
+| feat | Nueva funcionalidad |
+| fix | Correccion de bug |
+| refactor | Refactor sin cambio de comportamiento |
+| test | Tests nuevos o modificados |
+| docs | Solo documentacion |
+| chore | Mantenimiento, dependencias, config |
+| perf | Mejora de rendimiento |
+| ci | Cambios en CI/CD |
+
+### Reglas
+- Descripcion en imperativo: "add", "fix", "update" — no "added", "fixed"
+- Sin punto al final
+- Breaking change: agrega "!" antes de ":" o pie de pagina "BREAKING CHANGE:"
+- Scope opcional: nombre del modulo o dominio afectado`,
+    },
+    {
+        name: 'code-review',
+        version: '1.0.0',
+        description: 'Code review checklist and best practices for any language',
+        scope: 'global',
+        triggers: [
+            'code review', 'revisar codigo', 'revisión de codigo', 'pull request',
+            'pr review', 'review checklist', 'revisión', 'code quality',
+        ],
+        systemPromptAddition: `## Code Review
+
+Al revisar codigo, evalua en este orden:
+
+### 1. Correctitud
+- El codigo hace lo que dice que hace?
+- Maneja edge cases y errores?
+- Hay race conditions o problemas de concurrencia?
+
+### 2. Legibilidad
+- Los nombres son descriptivos y consistentes?
+- La logica es facil de seguir sin comentarios?
+- Las funciones hacen una sola cosa?
+
+### 3. Mantenibilidad
+- Hay duplicacion que deberia extraerse?
+- Las abstracciones son las correctas (ni muy pocas ni demasiadas)?
+- Los tests cubren el comportamiento, no la implementacion?
+
+### 4. Seguridad
+- Hay inputs del usuario sin validar?
+- Se expone informacion sensible en logs o errores?
+- Las dependencias tienen vulnerabilidades conocidas?
+
+### 5. Rendimiento
+- Hay N+1 queries o loops innecesarios?
+- Se cachea lo que deberia cachearse?
+- El impacto en memoria y CPU es razonable?
+
+Formato de feedback: especifica archivo, linea y razon. Separa bloqueantes de sugerencias.`,
+    },
+    {
+        name: 'tdd',
+        version: '1.0.0',
+        description: 'Test-Driven Development discipline for any language',
+        scope: 'global',
+        triggers: [
+            'tdd', 'test driven', 'test-driven development', 'red green refactor',
+            'escribir tests primero', 'tests antes', 'coverage', 'cobertura',
+        ],
+        systemPromptAddition: `## Test-Driven Development
+
+### Ciclo obligatorio: Red → Green → Refactor
+1. **Red** — escribe el test que falla primero. El test define el comportamiento esperado.
+2. **Green** — escribe el minimo codigo para que el test pase. No sobredisenes.
+3. **Refactor** — mejora el codigo sin cambiar el comportamiento. Los tests deben seguir pasando.
+
+### Que testear
+- Comportamiento observable, no implementacion interna
+- Edge cases: nulo, vacio, maximo, minimo
+- Casos de error: que pasa cuando algo falla
+
+### Que NO testear
+- Detalles de implementacion que pueden cambiar
+- Librerias de terceros (confiar en sus propios tests)
+- Codigo trivial sin logica de negocio
+
+### Estructura de un buen test (AAA)
+\`\`\`
+// Arrange — preparar el estado inicial
+// Act     — ejecutar la accion bajo prueba
+// Assert  — verificar el resultado esperado
+\`\`\`
+
+### Reglas
+- Un test = una assertion logica (puede tener varias lineas de expect)
+- Nombre del test: describe QUE hace, no COMO lo hace
+- Tests deben ser deterministicos: mismo input = mismo output siempre`,
+    },
+    {
+        name: 'adr',
+        version: '1.0.0',
+        description: 'Architecture Decision Records — document significant design choices',
+        scope: 'global',
+        triggers: [
+            'adr', 'architecture decision', 'decision de arquitectura', 'architectural record',
+            'decision record', 'doc arquitectura', 'documentar decision',
+        ],
+        systemPromptAddition: `## Architecture Decision Records (ADR)
+
+Usa este formato para documentar decisiones de arquitectura significativas.
+
+### Cuando crear un ADR
+- Cambias una tecnologia o framework
+- Adoptas un patron arquitectonico
+- Rechazas una alternativa que alguien podria proponer en el futuro
+- La decision tiene consecuencias a largo plazo o es dificil de revertir
+
+### Formato
+\`\`\`markdown
+# ADR-{numero}: {titulo breve}
+
+**Fecha:** YYYY-MM-DD
+**Estado:** Propuesto | Aceptado | Rechazado | Deprecado | Supersedido por ADR-{n}
+
+## Contexto
+Por que necesitamos tomar esta decision? Cual es el problema o necesidad?
+
+## Decision
+Que decidimos hacer?
+
+## Consecuencias
+### Positivas
+- ...
+
+### Negativas / Trade-offs
+- ...
+
+## Alternativas consideradas
+- **{Alternativa A}** — por que fue descartada
+- **{Alternativa B}** — por que fue descartada
+\`\`\`
+
+Guarda los ADRs en \`docs/adr/\` o \`architecture/decisions/\`.`,
+    },
+    {
+        name: 'security-checklist',
+        version: '1.0.0',
+        description: 'OWASP-based security checklist for any stack',
+        scope: 'global',
+        triggers: [
+            'seguridad', 'security', 'owasp', 'vulnerabilidad', 'vulnerability',
+            'pentest', 'auditoria de seguridad', 'security audit', 'hardening',
+            'sql injection', 'xss', 'csrf', 'autenticacion', 'autorizacion',
+        ],
+        systemPromptAddition: `## Security Checklist (OWASP Top 10)
+
+Al revisar o implementar codigo, verifica:
+
+### Inputs y validacion
+- Todo input del usuario se valida y sanitiza antes de usarse
+- Nunca se construyen queries con concatenacion de strings (usar parametrized queries)
+- Los archivos subidos se validan en tipo, tamanio y contenido
+
+### Autenticacion y sesiones
+- Passwords hasheados con bcrypt/argon2/scrypt (nunca MD5/SHA1)
+- Tokens JWT validados en firma, expiracion y claims
+- Sesiones invalidadas al logout
+
+### Autorizacion
+- Cada endpoint verifica permisos, no solo autenticacion
+- IDOR: no se puede acceder a recursos de otro usuario cambiando el ID
+
+### Datos sensibles
+- Secretos en variables de entorno, nunca en codigo o logs
+- HTTPS obligatorio en produccion
+- Datos sensibles no se logean (tokens, passwords, PII)
+
+### Headers y configuracion
+- CORS configurado restrictivamente (no "*" en produccion)
+- CSP, X-Frame-Options, HSTS configurados
+- Dependencias sin vulnerabilidades conocidas (npm audit, pip audit)
+
+### Errores
+- Mensajes de error genericos al cliente (no exponer stack traces)
+- Errores detallados solo en logs internos`,
+    },
+];
+//# sourceMappingURL=global.js.map

package/dist/skills/builtins/global.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.js","sourceRoot":"","sources":["../../../src/skills/builtins/global.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACU,QAAA,qBAAqB,GAAY;IAC1C;QACI,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,8DAA8D;QAC3E,KAAK,EAAE,QAAQ;QACf,QAAQ,EAAE;YACN,QAAQ,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,mBAAmB;YACtE,WAAW,EAAE,qBAAqB,EAAE,QAAQ,EAAE,eAAe;SAChE;QACD,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;uDAqByB;KAClD;IACD;QACI,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,2DAA2D;QACxE,KAAK,EAAE,QAAQ;QACf,QAAQ,EAAE;YACN,aAAa,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,cAAc;YACtE,WAAW,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc;SAC/D;QACD,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2FA6B6D;KACtF;IACD;QACI,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,qDAAqD;QAClE,KAAK,EAAE,QAAQ;QACf,QAAQ,EAAE;YACN,KAAK,EAAE,aAAa,EAAE,yBAAyB,EAAE,oBAAoB;YACrE,wBAAwB,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW;SACnE;QACD,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;sEA2BwC;KACjE;IACD;QACI,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,uEAAuE;QACpF,KAAK,EAAE,QAAQ;QACf,QAAQ,EAAE;YACN,KAAK,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,sBAAsB;YAClF,iBAAiB,EAAE,kBAAkB,EAAE,qBAAqB;SAC/D;QACD,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gEAmCkC;KAC3D;IACD;QACI,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,8CAA8C;QAC3D,KAAK,EAAE,QAAQ;QACf,QAAQ,EAAE;YACN,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,EAAE,eAAe;YACnE,SAAS,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,WAAW;YAClE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc;SAClE;QACD,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CA8Ba;KACtC;CACJ,CAAC"}

package/dist/skills/builtins/go-pack.d.ts

@@ -0,0 +1,7 @@
+import type { Skill } from '@backendkit-labs/agent-core';
+/**
+ * Go skill pack (@bk-go).
+ * Activated for projects with go.mod.
+ */
+export declare const GO_PACK_SKILLS: Skill[];
+//# sourceMappingURL=go-pack.d.ts.map

package/dist/skills/builtins/go-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"go-pack.d.ts","sourceRoot":"","sources":["../../../src/skills/builtins/go-pack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,EA8PjC,CAAC"}