@kernel.chat/kbot 2.27.0 → 3.0.0

package/dist/sdk.d.ts

@@ -0,0 +1,165 @@
+import type { UIAdapter } from './ui-adapter.js';
+export interface KBotConfig {
+    /** AI provider: 'anthropic' | 'openai' | 'ollama' | etc */
+    provider?: string;
+    /** Model name (e.g. 'claude-sonnet-4-20250514', 'gpt-4o', 'llama3.1') */
+    model?: string;
+    /** API key (or uses env vars / ~/.kbot/config.json) */
+    apiKey?: string;
+    /** Custom endpoint URL */
+    baseUrl?: string;
+    /** Custom UI adapter (default: SilentUIAdapter for SDK usage) */
+    ui?: UIAdapter;
+    /** Tool permission mode */
+    permissionMode?: 'permissive' | 'normal' | 'strict';
+}
+export interface RunOptions {
+    /** Specialist agent ID (e.g. 'coder', 'researcher', 'writer') */
+    agent?: string;
+    /** Enable streaming output */
+    stream?: boolean;
+    /** Max tool loop iterations */
+    maxIterations?: number;
+    /** Whitelist of tool names to make available */
+    tools?: string[];
+    /** Override system prompt */
+    systemPrompt?: string;
+    /** Previous messages for context */
+    context?: any[];
+    /** AbortSignal for cancellation */
+    signal?: AbortSignal;
+    /** Enable extended thinking */
+    thinking?: boolean;
+    /** Thinking budget in tokens */
+    thinkingBudget?: number;
+    /** Tier for tool gating */
+    tier?: string;
+}
+export interface RunResult {
+    /** Final text content from the agent */
+    content: string;
+    /** Tool calls made during execution */
+    toolCalls: Array<{
+        name: string;
+        args: any;
+        result?: string;
+        error?: string;
+        durationMs?: number;
+    }>;
+    /** Agent that handled the request */
+    agent: string;
+    /** Model used */
+    model: string;
+    /** Token usage */
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    /** Total execution time in ms */
+    durationMs: number;
+}
+export type StreamEvent = {
+    type: 'thinking_start';
+} | {
+    type: 'thinking_delta';
+    text: string;
+} | {
+    type: 'thinking_end';
+} | {
+    type: 'content_delta';
+    text: string;
+} | {
+    type: 'content_end';
+} | {
+    type: 'tool_call_start';
+    name: string;
+    args: any;
+} | {
+    type: 'tool_call_end';
+    name: string;
+    result: string;
+    error?: string;
+} | {
+    type: 'agent_route';
+    agentId: string;
+    method: string;
+    confidence: number;
+} | {
+    type: 'usage';
+    inputTokens: number;
+    outputTokens: number;
+} | {
+    type: 'done';
+    content: string;
+};
+export declare const agent: {
+    /**
+     * Run the agent with a message and get a structured result.
+     *
+     * @example
+     * const result = await agent.run('fix the bug in login.ts')
+     * console.log(result.content)
+     */
+    run(message: string, options?: RunOptions & KBotConfig): Promise<RunResult>;
+    /**
+     * Stream agent events as an async generator.
+     *
+     * @example
+     * for await (const event of agent.stream('explain this code')) {
+     *   if (event.type === 'content_delta') process.stdout.write(event.text)
+     * }
+     */
+    stream(message: string, options?: RunOptions & KBotConfig): AsyncGenerator<StreamEvent>;
+};
+export declare const tools: {
+    /**
+     * List all registered tools with their descriptions and parameters.
+     *
+     * @example
+     * const allTools = tools.list()
+     * console.log(allTools.map(t => t.name))
+     */
+    list(): Array<{
+        name: string;
+        description: string;
+        parameters: any;
+    }>;
+    /**
+     * Execute a single tool by name.
+     *
+     * @example
+     * const result = await tools.execute('read_file', { path: 'README.md' })
+     * console.log(result.result)
+     */
+    execute(name: string, args: Record<string, any>): Promise<{
+        result: string;
+        error?: string;
+        durationMs: number;
+    }>;
+    /**
+     * Get a single tool definition by name.
+     *
+     * @example
+     * const readFile = tools.get('read_file')
+     * if (readFile) console.log(readFile.description)
+     */
+    get(name: string): import("./tools/index.js").ToolDefinition | undefined;
+};
+export declare const providers: {
+    /**
+     * Auto-detect available providers based on environment variables and config.
+     */
+    detect(): Promise<Array<{
+        name: string;
+        models: string[];
+    }>>;
+    /**
+     * List all supported provider names.
+     */
+    list(): Promise<string[]>;
+};
+export type { UIAdapter };
+export { SilentUIAdapter, CallbackUIAdapter, TerminalUIAdapter } from './ui-adapter.js';
+export { ResponseStream } from './streaming.js';
+export type { ResponseStreamEvent, ResponseStreamListener } from './streaming.js';
+//# sourceMappingURL=sdk.d.ts.map

package/dist/sdk.d.ts.map

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

package/dist/sdk.js

@@ -0,0 +1,230 @@
+// K:BOT Programmatic SDK
+// Clean public API for using K:BOT as a library.
+//
+// Usage:
+//   import { agent, tools } from '@kernel.chat/kbot'
+//
+//   const result = await agent.run('fix the bug in login.ts')
+//   console.log(result.content)
+//   console.log(result.toolCalls)
+//
+//   const allTools = tools.list()
+//   const execResult = await tools.execute('read_file', { path: 'README.md' })
+//
+//   for await (const event of agent.stream('explain this code')) {
+//     if (event.type === 'content_delta') process.stdout.write(event.text)
+//   }
+import { runAgent } from './agent.js';
+import { registerAllTools, getAllTools, executeTool, getTool, } from './tools/index.js';
+import { SilentUIAdapter, CallbackUIAdapter } from './ui-adapter.js';
+// ── Initialization guard ──
+let initialized = false;
+async function ensureInitialized() {
+    if (initialized)
+        return;
+    await registerAllTools();
+    initialized = true;
+}
+// ── Agent API ──
+export const agent = {
+    /**
+     * Run the agent with a message and get a structured result.
+     *
+     * @example
+     * const result = await agent.run('fix the bug in login.ts')
+     * console.log(result.content)
+     */
+    async run(message, options) {
+        await ensureInitialized();
+        const ui = options?.ui ?? new SilentUIAdapter();
+        const start = Date.now();
+        const agentOpts = {
+            agent: options?.agent,
+            model: options?.model,
+            stream: options?.stream ?? false,
+            thinking: options?.thinking,
+            thinkingBudget: options?.thinkingBudget,
+            tier: options?.tier ?? 'free',
+            ui,
+        };
+        const result = await runAgent(message, agentOpts);
+        const durationMs = Date.now() - start;
+        return {
+            content: result.content ?? (ui instanceof SilentUIAdapter ? ui.content : ''),
+            toolCalls: ui instanceof SilentUIAdapter ? ui.toolCalls : [],
+            agent: result.agent ?? options?.agent ?? 'kernel',
+            model: result.model ?? options?.model ?? '',
+            usage: {
+                inputTokens: result.usage?.input_tokens ?? 0,
+                outputTokens: result.usage?.output_tokens ?? 0,
+            },
+            durationMs,
+        };
+    },
+    /**
+     * Stream agent events as an async generator.
+     *
+     * @example
+     * for await (const event of agent.stream('explain this code')) {
+     *   if (event.type === 'content_delta') process.stdout.write(event.text)
+     * }
+     */
+    async *stream(message, options) {
+        await ensureInitialized();
+        // Channel for pushing events from the callback adapter
+        const queue = [];
+        let resolve = null;
+        let done = false;
+        function push(event) {
+            queue.push(event);
+            if (resolve) {
+                const r = resolve;
+                resolve = null;
+                r();
+            }
+        }
+        const ui = new CallbackUIAdapter({
+            onToolCallStart(name, args) {
+                push({ type: 'tool_call_start', name, args });
+            },
+            onToolCallEnd(name, result, error) {
+                push({ type: 'tool_call_end', name, result, error });
+            },
+            onThinking(text) {
+                push({ type: 'thinking_delta', text });
+            },
+            onContent(text) {
+                push({ type: 'content_delta', text });
+            },
+            onContentEnd() {
+                push({ type: 'content_end' });
+            },
+            onAgentRoute(agentId, method, confidence) {
+                push({ type: 'agent_route', agentId, method, confidence });
+            },
+        });
+        // Run the agent in the background, pushing events via callbacks
+        const agentOpts = {
+            agent: options?.agent,
+            model: options?.model,
+            stream: true,
+            thinking: options?.thinking,
+            thinkingBudget: options?.thinkingBudget,
+            tier: options?.tier ?? 'free',
+            ui,
+        };
+        const agentPromise = runAgent(message, agentOpts).then(result => {
+            push({
+                type: 'usage',
+                inputTokens: result.usage?.input_tokens ?? 0,
+                outputTokens: result.usage?.output_tokens ?? 0,
+            });
+            push({ type: 'done', content: result.content });
+            done = true;
+            queue.push(null); // sentinel
+            if (resolve) {
+                const r = resolve;
+                resolve = null;
+                r();
+            }
+        }).catch(err => {
+            done = true;
+            queue.push(null);
+            if (resolve) {
+                const r = resolve;
+                resolve = null;
+                r();
+            }
+            throw err;
+        });
+        // Yield events as they arrive
+        while (true) {
+            if (queue.length > 0) {
+                const event = queue.shift();
+                if (event === null)
+                    break; // sentinel — agent finished
+                yield event;
+            }
+            else if (done) {
+                break;
+            }
+            else {
+                await new Promise(r => { resolve = r; });
+            }
+        }
+        // Ensure the agent promise is settled (propagates errors)
+        await agentPromise;
+    },
+};
+// ── Tools API ──
+export const tools = {
+    /**
+     * List all registered tools with their descriptions and parameters.
+     *
+     * @example
+     * const allTools = tools.list()
+     * console.log(allTools.map(t => t.name))
+     */
+    list() {
+        return getAllTools().map(t => ({
+            name: t.name,
+            description: t.description,
+            parameters: t.parameters,
+        }));
+    },
+    /**
+     * Execute a single tool by name.
+     *
+     * @example
+     * const result = await tools.execute('read_file', { path: 'README.md' })
+     * console.log(result.result)
+     */
+    async execute(name, args) {
+        await ensureInitialized();
+        const start = Date.now();
+        const call = { id: name, name, arguments: args };
+        const toolResult = await executeTool(call);
+        return {
+            result: toolResult.result,
+            error: toolResult.error ? toolResult.result : undefined,
+            durationMs: Date.now() - start,
+        };
+    },
+    /**
+     * Get a single tool definition by name.
+     *
+     * @example
+     * const readFile = tools.get('read_file')
+     * if (readFile) console.log(readFile.description)
+     */
+    get(name) {
+        return getTool(name);
+    },
+};
+// ── Providers API ──
+export const providers = {
+    /**
+     * Auto-detect available providers based on environment variables and config.
+     */
+    async detect() {
+        const { getProvider, getByokProvider } = await import('./auth.js');
+        const current = getByokProvider();
+        if (!current)
+            return [];
+        const p = getProvider(current);
+        return [{
+                name: p.name,
+                models: p.models || [],
+            }];
+    },
+    /**
+     * List all supported provider names.
+     */
+    async list() {
+        const { PROVIDERS } = await import('./auth.js');
+        return Object.keys(PROVIDERS);
+    },
+};
+export { SilentUIAdapter, CallbackUIAdapter, TerminalUIAdapter } from './ui-adapter.js';
+export { ResponseStream } from './streaming.js';
+//# sourceMappingURL=sdk.js.map

package/dist/sdk.js.map

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

package/dist/serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"AAsBA,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAuBD,wBAAsB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAyIrE"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"AAyBA,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAuBD,wBAAsB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAmLrE"}

package/dist/serve.js

@@ -10,11 +10,14 @@
 //   GET  /tools           — List all registered tools (schemas only)
 //   POST /tools/:name     — Execute a tool by name
 //   POST /execute         — Execute a tool { name, args }
+//   POST /stream          — SSE streaming agent execution
 //   GET  /metrics         — Tool execution metrics
 import { createServer } from 'node:http';
 import { createRequire } from 'node:module';
 import { registerAllTools, getAllTools, executeTool, getToolDefinitionsForApi, getToolMetrics } from './tools/index.js';
 import { printInfo, printSuccess } from './ui.js';
+import { ResponseStream } from './streaming.js';
+import { runAgent } from './agent.js';
 const __require = createRequire(import.meta.url);
 const VERSION = __require('../package.json').version;
 function cors(res) {
@@ -84,6 +87,40 @@ export async function startServe(options) {
                 json(res, 200, { metrics: getToolMetrics() });
                 return;
             }
+            // POST /stream — SSE streaming agent execution
+            if (path === '/stream' && req.method === 'POST') {
+                const body = JSON.parse(await readBody(req));
+                const { message, agent, model, thinking } = body;
+                if (!message) {
+                    json(res, 400, { error: 'Missing "message" field' });
+                    return;
+                }
+                cors(res);
+                res.writeHead(200, {
+                    'Content-Type': 'text/event-stream',
+                    'Cache-Control': 'no-cache',
+                    'Connection': 'keep-alive',
+                });
+                const stream = new ResponseStream();
+                stream.on(ResponseStream.createSSEListener(res));
+                try {
+                    await runAgent(message, {
+                        responseStream: stream,
+                        stream: true,
+                        agent,
+                        model,
+                        thinking,
+                    });
+                }
+                catch (err) {
+                    stream.emit({
+                        type: 'error',
+                        message: err instanceof Error ? err.message : String(err),
+                    });
+                }
+                res.end();
+                return;
+            }
             // POST /execute — execute a tool
             if (path === '/execute' && req.method === 'POST') {
                 const body = JSON.parse(await readBody(req));
@@ -139,6 +176,7 @@ export async function startServe(options) {
         printInfo(`  GET  /health       — Health check`);
         printInfo(`  GET  /tools        — List ${tools.length} tools`);
         printInfo(`  POST /execute      — Execute a tool`);
+        printInfo(`  POST /stream       — SSE streaming agent`);
         printInfo(`  POST /tools/:name  — Execute by name`);
         printInfo(`  GET  /metrics      — Execution metrics`);
         if (options.token) {

package/dist/serve.js.map

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

package/dist/skill-rating.d.ts

@@ -0,0 +1,92 @@
+export interface Rating {
+    /** Mean skill estimate */
+    mu: number;
+    /** Uncertainty (standard deviation) */
+    sigma: number;
+}
+export interface AgentCategoryRatings {
+    [category: string]: Rating;
+    /** Overall rating across all categories */
+    _overall: Rating;
+}
+export interface AgentRatings {
+    [agentId: string]: AgentCategoryRatings;
+}
+export type TaskCategory = 'coding' | 'debugging' | 'refactoring' | 'research' | 'analysis' | 'writing' | 'devops' | 'security' | 'design' | 'general' | 'data' | 'communication';
+export type Outcome = 'win' | 'loss' | 'draw';
+export declare class SkillRatingSystem {
+    private ratings;
+    private dirty;
+    constructor();
+    private loadSync;
+    save(): Promise<void>;
+    load(): Promise<void>;
+    /**
+     * Classify a message into a task category using keyword matching.
+     * Fast, no LLM call needed.
+     */
+    categorizeMessage(message: string): TaskCategory;
+    /**
+     * Get a rating for a specific agent and category.
+     * Returns the category-specific rating if it exists, otherwise the overall rating.
+     */
+    private getRating;
+    /**
+     * Conservative rating estimate: mu - 2*sigma
+     * This is the lower bound of the ~95% confidence interval.
+     * Agents need to both be good AND have enough data to rank highly.
+     */
+    private conservativeEstimate;
+    /**
+     * Get agents ranked by conservative estimate for a given category.
+     */
+    getRankedAgents(category: TaskCategory): Array<{
+        agent: string;
+        rating: Rating;
+        confidence: number;
+    }>;
+    /**
+     * Update an agent's rating based on an outcome.
+     *
+     * Uses a simplified Bradley-Terry model:
+     *   beta = sigma / 2  (dynamics factor)
+     *   c = sqrt(2 * beta^2 + sigma^2)  (normalization factor)
+     *   K = sigma^2 / c  (update magnitude — bigger when uncertain)
+     *   mu_new = mu + K * outcome_factor
+     *   sigma_new = sigma * sqrt(max(1 - sigma^2/c^2, epsilon))
+     *
+     * outcome_factor: win = +1, loss = -1, draw = 0
+     */
+    recordOutcome(agent: string, category: TaskCategory, outcome: Outcome): void;
+    /**
+     * Core Bradley-Terry update step.
+     * @param rating The rating to mutate in place
+     * @param outcome The match outcome
+     * @param dampen Dampen the update (0-1), 1 = full update
+     */
+    private updateRating;
+    /**
+     * Get the best agent for a task based on Bayesian skill ratings.
+     *
+     * Returns null if all agents still have high uncertainty (not enough data).
+     * The confidence threshold ensures we only route when we have meaningful signal.
+     */
+    getAgentForTask(message: string): {
+        agent: string;
+        confidence: number;
+        category: TaskCategory;
+    } | null;
+    /**
+     * Get summary stats for each agent: their top category and confidence level.
+     */
+    getStats(): Record<string, {
+        topCategory: string;
+        confidence: number;
+    }>;
+    /**
+     * Get raw ratings for an agent (for debugging/display).
+     */
+    getAgentRatings(agent: string): AgentCategoryRatings | null;
+}
+export declare function getSkillRatingSystem(): SkillRatingSystem;
+//# sourceMappingURL=skill-rating.d.ts.map

package/dist/skill-rating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-rating.d.ts","sourceRoot":"","sources":["../src/skill-rating.ts"],"names":[],"mappings":"AAiCA,MAAM,WAAW,MAAM;IACrB,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAAA;CACxC;AAED,MAAM,MAAM,YAAY,GACpB,QAAQ,GAAG,WAAW,GAAG,aAAa,GACtC,UAAU,GAAG,UAAU,GAAG,SAAS,GACnC,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAChC,SAAS,GAAG,MAAM,GAAG,eAAe,CAAA;AAExC,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;AAoG7C,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,KAAK,CAAQ;;IAQrB,OAAO,CAAC,QAAQ;IAiBV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IASrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;;OAGG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;IA6BhD;;;OAGG;IACH,OAAO,CAAC,SAAS;IAMjB;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAmBrG;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAuB5E;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IA2BpB;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,GAAG,IAAI;IA6BtG;;OAEG;IACH,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IA+BvE;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;CAG5D;AAMD,wBAAgB,oBAAoB,IAAI,iBAAiB,CAKxD"}