@kernel.chat/kbot 1.3.1 → 2.3.0

package/dist/planner.js

@@ -0,0 +1,298 @@
+// K:BOT Autonomous Planner — Plan-then-Execute for complex tasks
+//
+// This is the core missing piece vs Claude Code. When given a complex task,
+// K:BOT should:
+//   1. EXPLORE — read files, understand the codebase
+//   2. PLAN — decompose into steps, identify files to change
+//   3. CONFIRM — show the plan to the user for approval
+//   4. EXECUTE — run each step, verify, self-correct
+//   5. VERIFY — type-check, test, confirm everything works
+//
+// The planner uses the AI to generate a structured plan, then drives
+// execution through the existing tool registry.
+import { runAgent } from './agent.js';
+import { executeTool, getTool } from './tools/index.js';
+import { gatherContext, formatContextForPrompt } from './context.js';
+import { createSpinner, printInfo, printSuccess, printError, printWarn } from './ui.js';
+import chalk from 'chalk';
+const AMETHYST = chalk.hex('#6B5B95');
+// ── Plan Generation ──
+const PLAN_SYSTEM_PROMPT = `You are an autonomous coding agent planning a task. You must output a structured JSON plan.
+
+Given the user's task and project context, produce a plan with this exact JSON structure:
+{
+  "summary": "One-sentence summary of what will be done",
+  "steps": [
+    {
+      "id": 1,
+      "description": "Human-readable description of this step",
+      "tool": "tool_name",
+      "args": { "key": "value" },
+      "reads": ["file1.ts"],
+      "writes": ["file2.ts"],
+      "dependsOn": []
+    }
+  ],
+  "filesInScope": ["list of all files that need to be read or modified"]
+}
+
+Available tools: read_file, write_file, edit_file, multi_file_write, bash, glob, grep, git_status, git_diff, git_commit, git_push, web_search, research, url_fetch, parallel_execute, sandbox_run, build_run, notebook_edit
+
+Rules:
+- Start with read_file/glob/grep steps to understand the codebase BEFORE making changes
+- Group independent operations that can run in parallel
+- Always verify changes with a type-check or test step at the end
+- For file edits, use edit_file with old_string/new_string (not full rewrites unless creating new files)
+- Include error recovery — if a step might fail, note what to do
+- Keep plans concise — 5-20 steps for most tasks
+- Output ONLY valid JSON, no markdown wrapping`;
+/**
+ * Generate a plan for a complex task.
+ * Uses the AI to analyze the task and produce structured steps.
+ */
+export async function generatePlan(task, agentOpts) {
+    const context = gatherContext();
+    const contextStr = formatContextForPrompt(context);
+    const planPrompt = `${PLAN_SYSTEM_PROMPT}
+
+Project context:
+${contextStr}
+
+Task: ${task}
+
+Output your plan as JSON:`;
+    // Use the agent to generate the plan (it has access to tools for exploration)
+    const response = await runAgent(planPrompt, {
+        ...agentOpts,
+        agent: 'coder', // Use coder agent for planning
+    });
+    // Parse the JSON plan from the response
+    let planData;
+    try {
+        // Extract JSON from response (might be wrapped in markdown)
+        const jsonMatch = response.content.match(/\{[\s\S]*\}/);
+        if (!jsonMatch)
+            throw new Error('No JSON found in plan response');
+        planData = JSON.parse(jsonMatch[0]);
+    }
+    catch {
+        // If AI didn't return valid JSON, create a simple single-step plan
+        planData = {
+            summary: `Execute: ${task}`,
+            steps: [{
+                    id: 1,
+                    description: task,
+                    reads: [],
+                    writes: [],
+                    dependsOn: [],
+                }],
+            filesInScope: [],
+        };
+    }
+    return {
+        task,
+        summary: planData.summary,
+        steps: planData.steps.map((s, i) => ({
+            ...s,
+            id: s.id || i + 1,
+            status: 'pending',
+        })),
+        filesInScope: planData.filesInScope || [],
+        estimatedToolCalls: planData.steps.length,
+        status: 'awaiting_approval',
+        createdAt: new Date().toISOString(),
+    };
+}
+/**
+ * Display a plan to the user for approval.
+ */
+export function displayPlan(plan) {
+    console.log();
+    console.log(`  ${AMETHYST('◆ Plan')}: ${plan.summary}`);
+    console.log(`  ${chalk.dim('─'.repeat(50))}`);
+    console.log();
+    for (const step of plan.steps) {
+        const deps = step.dependsOn && step.dependsOn.length > 0
+            ? chalk.dim(` (after #${step.dependsOn.join(', #')})`)
+            : '';
+        const tool = step.tool ? chalk.cyan(` [${step.tool}]`) : '';
+        console.log(`  ${chalk.dim(`${step.id}.`)} ${step.description}${tool}${deps}`);
+        if (step.writes && step.writes.length > 0) {
+            console.log(`     ${chalk.dim('writes:')} ${step.writes.join(', ')}`);
+        }
+    }
+    console.log();
+    console.log(`  ${chalk.dim(`${plan.steps.length} steps · ${plan.filesInScope.length} files in scope`)}`);
+    console.log();
+}
+/**
+ * Execute a plan step by step.
+ * Supports parallel execution for independent steps.
+ */
+export async function executePlan(plan, agentOpts, onStepComplete) {
+    plan.status = 'executing';
+    // Group steps by dependency layers for parallel execution
+    const executed = new Set();
+    while (executed.size < plan.steps.length) {
+        // Find all steps whose dependencies are met
+        const ready = plan.steps.filter(step => {
+            if (executed.has(step.id))
+                return false;
+            if (step.status === 'skipped') {
+                executed.add(step.id);
+                return false;
+            }
+            const deps = step.dependsOn || [];
+            return deps.every(depId => {
+                const dep = plan.steps.find(s => s.id === depId);
+                return dep && (dep.status === 'done' || executed.has(depId));
+            });
+        });
+        if (ready.length === 0) {
+            // Remaining steps have unmet deps
+            for (const step of plan.steps) {
+                if (!executed.has(step.id) && step.status === 'pending') {
+                    step.status = 'skipped';
+                    step.error = 'Unmet dependencies (earlier steps failed)';
+                    executed.add(step.id);
+                }
+            }
+            break;
+        }
+        if (ready.length > 1) {
+            printInfo(`Running ${ready.length} steps in parallel...`);
+        }
+        // Execute ready steps in parallel
+        await Promise.all(ready.map(async (step) => {
+            step.status = 'running';
+            const spinner = createSpinner(`Step ${step.id}: ${step.description}`);
+            spinner.start();
+            try {
+                if (step.tool && step.args) {
+                    const call = {
+                        id: `plan_${plan.createdAt}_step_${step.id}`,
+                        name: step.tool,
+                        arguments: step.args,
+                    };
+                    const result = await executeTool(call);
+                    step.result = result.result;
+                    step.status = result.error ? 'failed' : 'done';
+                    if (result.error)
+                        step.error = result.result;
+                }
+                else {
+                    const response = await runAgent(`You are executing step ${step.id} of a plan. The step is: "${step.description}"\n\nExecute this step now using your tools. Be precise and verify your work.`, agentOpts);
+                    step.result = response.content;
+                    step.status = 'done';
+                }
+                spinner.stop();
+                if (step.status === 'done') {
+                    printSuccess(`Step ${step.id}: ${step.description}`);
+                }
+                else {
+                    printError(`Step ${step.id} failed: ${step.error}`);
+                }
+            }
+            catch (err) {
+                spinner.stop();
+                step.status = 'failed';
+                step.error = err instanceof Error ? err.message : String(err);
+                printError(`Step ${step.id} failed: ${step.error}`);
+                // Self-correction
+                printWarn('Attempting self-correction...');
+                try {
+                    const fixResponse = await runAgent(`Step ${step.id} ("${step.description}") failed with error:\n${step.error}\n\nAnalyze the error and try a different approach.`, agentOpts);
+                    step.result = fixResponse.content;
+                    step.status = 'done';
+                    step.error = undefined;
+                    printSuccess(`Step ${step.id}: recovered via self-correction`);
+                }
+                catch {
+                    printError(`Self-correction also failed. Continuing.`);
+                }
+            }
+            executed.add(step.id);
+            onStepComplete?.(step);
+        }));
+    }
+    // Final status
+    const failed = plan.steps.filter(s => s.status === 'failed');
+    const done = plan.steps.filter(s => s.status === 'done');
+    plan.status = failed.length === 0 ? 'completed' : 'failed';
+    console.log();
+    if (plan.status === 'completed') {
+        printSuccess(`Plan complete: ${done.length}/${plan.steps.length} steps succeeded`);
+    }
+    else {
+        printWarn(`Plan finished with errors: ${done.length} done, ${failed.length} failed`);
+    }
+    return plan;
+}
+/**
+ * Full autonomous flow: Plan → Confirm → Execute → Verify
+ * This is the top-level entry point for complex tasks.
+ */
+export async function autonomousExecute(task, agentOpts, options) {
+    // Phase 1: Generate plan
+    printInfo('Analyzing task and generating plan...');
+    const plan = await generatePlan(task, agentOpts);
+    // Phase 2: Show plan and get approval
+    displayPlan(plan);
+    if (!options?.autoApprove) {
+        if (options?.onApproval) {
+            const approved = await options.onApproval(plan);
+            if (!approved) {
+                plan.status = 'failed';
+                printInfo('Plan rejected by user.');
+                return plan;
+            }
+        }
+        // If no approval callback, proceed (interactive mode handles this in CLI)
+    }
+    // Phase 3: Execute
+    const result = await executePlan(plan, agentOpts);
+    // Phase 4: Verify (type-check if applicable)
+    if (result.status === 'completed') {
+        const context = gatherContext();
+        if (context.language === 'TypeScript' || context.language === 'JavaScript') {
+            printInfo('Running verification...');
+            const verifyTool = getTool('bash');
+            if (verifyTool) {
+                try {
+                    const verifyResult = await verifyTool.execute({ command: 'npx tsc --noEmit 2>&1 | head -20' });
+                    if (verifyResult.includes('error TS')) {
+                        printWarn('Type errors detected after plan execution:');
+                        printInfo(verifyResult.split('\n').slice(0, 5).join('\n'));
+                    }
+                    else {
+                        printSuccess('Verification passed — no type errors');
+                    }
+                }
+                catch { /* non-fatal */ }
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Format a plan summary for display after completion
+ */
+export function formatPlanSummary(plan) {
+    const done = plan.steps.filter(s => s.status === 'done').length;
+    const failed = plan.steps.filter(s => s.status === 'failed').length;
+    const skipped = plan.steps.filter(s => s.status === 'skipped').length;
+    const lines = [
+        `Plan: ${plan.summary}`,
+        `Status: ${plan.status}`,
+        `Steps: ${done} done, ${failed} failed, ${skipped} skipped (${plan.steps.length} total)`,
+        '',
+    ];
+    for (const step of plan.steps) {
+        const icon = { done: '✓', failed: '✗', skipped: '○', pending: '·', running: '●' }[step.status];
+        lines.push(`  ${icon} ${step.id}. ${step.description} [${step.status}]`);
+        if (step.error)
+            lines.push(`     Error: ${step.error}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=planner.js.map

package/dist/planner.js.map

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

package/dist/plugins.d.ts

@@ -0,0 +1,30 @@
+export interface PluginDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, {
+        type: string;
+        description: string;
+        required?: boolean;
+        default?: unknown;
+    }>;
+    execute: (args: Record<string, unknown>) => Promise<string>;
+    tier?: 'free' | 'pro' | 'growth' | 'enterprise';
+}
+export interface PluginManifest {
+    name: string;
+    file: string;
+    toolCount: number;
+    loadedAt: string;
+    error?: string;
+}
+/** Ensure the plugins directory exists */
+export declare function ensurePluginsDir(): string;
+/** Load all plugins from ~/.kbot/plugins/ */
+export declare function loadPlugins(verbose?: boolean): Promise<PluginManifest[]>;
+/** List loaded plugins */
+export declare function getLoadedPlugins(): PluginManifest[];
+/** Format plugin list for display */
+export declare function formatPluginList(): string;
+/** Create a scaffold plugin file */
+export declare function scaffoldPlugin(name: string): string;
+//# sourceMappingURL=plugins.d.ts.map

package/dist/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QACzB,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,OAAO,CAAC,EAAE,OAAO,CAAA;KAClB,CAAC,CAAA;IACF,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3D,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,YAAY,CAAA;CAChD;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAID,0CAA0C;AAC1C,wBAAgB,gBAAgB,IAAI,MAAM,CAKzC;AAED,6CAA6C;AAC7C,wBAAsB,WAAW,CAAC,OAAO,UAAQ,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CA0D5E;AAED,0BAA0B;AAC1B,wBAAgB,gBAAgB,IAAI,cAAc,EAAE,CAEnD;AAED,qCAAqC;AACrC,wBAAgB,gBAAgB,IAAI,MAAM,CAyBzC;AAED,oCAAoC;AACpC,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA8BnD"}

package/dist/plugins.js

@@ -0,0 +1,135 @@
+// K:BOT Plugin System — Drop-in tool extensions
+//
+// Users place .ts/.js files in ~/.kbot/plugins/ and they auto-register as tools.
+// Each plugin exports a default PluginDefinition or an array of them.
+//
+// Example plugin (~/.kbot/plugins/hello.js):
+//   export default {
+//     name: 'hello',
+//     description: 'Say hello',
+//     parameters: { name: { type: 'string', description: 'Who to greet', required: true } },
+//     execute: async (args) => `Hello, ${args.name}!`,
+//   }
+import { existsSync, readdirSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { pathToFileURL } from 'node:url';
+import { registerTool } from './tools/index.js';
+const PLUGINS_DIR = join(homedir(), '.kbot', 'plugins');
+const PLUGIN_EXTENSIONS = ['.js', '.mjs'];
+const loadedPlugins = [];
+/** Ensure the plugins directory exists */
+export function ensurePluginsDir() {
+    if (!existsSync(PLUGINS_DIR)) {
+        mkdirSync(PLUGINS_DIR, { recursive: true });
+    }
+    return PLUGINS_DIR;
+}
+/** Load all plugins from ~/.kbot/plugins/ */
+export async function loadPlugins(verbose = false) {
+    ensurePluginsDir();
+    const files = readdirSync(PLUGINS_DIR).filter(f => PLUGIN_EXTENSIONS.some(ext => f.endsWith(ext)));
+    if (files.length === 0)
+        return [];
+    for (const file of files) {
+        const filePath = join(PLUGINS_DIR, file);
+        const manifest = {
+            name: file.replace(/\.[^.]+$/, ''),
+            file,
+            toolCount: 0,
+            loadedAt: new Date().toISOString(),
+        };
+        try {
+            const fileUrl = pathToFileURL(filePath).href;
+            const mod = await import(fileUrl);
+            const definitions = [];
+            if (mod.default) {
+                if (Array.isArray(mod.default)) {
+                    definitions.push(...mod.default);
+                }
+                else {
+                    definitions.push(mod.default);
+                }
+            }
+            if (mod.tools && Array.isArray(mod.tools)) {
+                definitions.push(...mod.tools);
+            }
+            for (const def of definitions) {
+                if (!def.name || !def.execute)
+                    continue;
+                const tool = {
+                    name: `plugin_${def.name}`,
+                    description: `[Plugin] ${def.description || def.name}`,
+                    parameters: def.parameters || {},
+                    tier: def.tier || 'free',
+                    execute: def.execute,
+                };
+                registerTool(tool);
+                manifest.toolCount++;
+            }
+        }
+        catch (err) {
+            manifest.error = err instanceof Error ? err.message : String(err);
+        }
+        loadedPlugins.push(manifest);
+    }
+    return loadedPlugins;
+}
+/** List loaded plugins */
+export function getLoadedPlugins() {
+    return loadedPlugins;
+}
+/** Format plugin list for display */
+export function formatPluginList() {
+    if (loadedPlugins.length === 0) {
+        return [
+            'No plugins loaded.',
+            '',
+            `Plugin directory: ${PLUGINS_DIR}`,
+            '',
+            'Create a plugin:',
+            `  kbot /plugins create my-tool`,
+            '',
+            'Or manually create a .js file in the plugins directory.',
+        ].join('\n');
+    }
+    const lines = [
+        `${loadedPlugins.length} plugin(s) loaded from ${PLUGINS_DIR}`,
+        '',
+    ];
+    for (const p of loadedPlugins) {
+        const status = p.error ? `  ✗ ${p.name} — ${p.error}` : `  ✓ ${p.name} (${p.toolCount} tools)`;
+        lines.push(status);
+    }
+    return lines.join('\n');
+}
+/** Create a scaffold plugin file */
+export function scaffoldPlugin(name) {
+    ensurePluginsDir();
+    const filePath = join(PLUGINS_DIR, `${name}.js`);
+    if (existsSync(filePath)) {
+        return `Plugin already exists: ${filePath}`;
+    }
+    const content = `// K:BOT Plugin: ${name}
+// This file is auto-loaded when kbot starts.
+
+export default {
+  name: '${name}',
+  description: 'Description of what this tool does',
+  parameters: {
+    input: {
+      type: 'string',
+      description: 'The input to process',
+      required: true,
+    },
+  },
+  async execute(args) {
+    const input = String(args.input)
+    return \`Processed: \${input}\`
+  },
+}
+`;
+    writeFileSync(filePath, content, 'utf-8');
+    return `Plugin created: ${filePath}`;
+}
+//# sourceMappingURL=plugins.js.map

package/dist/plugins.js.map

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

package/dist/sessions.d.ts

@@ -0,0 +1,38 @@
+import { type ConversationTurn } from './memory.js';
+export interface Session {
+    /** Unique session ID */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** When the session was created */
+    created: string;
+    /** When it was last updated */
+    updated: string;
+    /** Working directory when session was created */
+    cwd: string;
+    /** Number of turns in the conversation */
+    turnCount: number;
+    /** First user message (for preview) */
+    preview: string;
+    /** The conversation history */
+    history: ConversationTurn[];
+    /** Agent that was active */
+    agent?: string;
+    /** Any context notes */
+    notes?: string;
+}
+/** Save the current conversation as a session */
+export declare function saveSession(name?: string, agent?: string): Session;
+/** Load a session by ID or name */
+export declare function loadSession(idOrName: string): Session | null;
+/** List all saved sessions, newest first */
+export declare function listSessions(): Session[];
+/** Delete a session */
+export declare function deleteSession(idOrName: string): boolean;
+/** Update an existing session with current history */
+export declare function updateSession(id: string, agent?: string): Session | null;
+/** Get the most recent session for auto-resume */
+export declare function getLastSession(): Session | null;
+/** Format session list for display */
+export declare function formatSessionList(sessions: Session[]): string;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../src/sessions.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAK/D,MAAM,WAAW,OAAO;IACtB,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAA;IACX,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAA;IACjB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAA;IACf,+BAA+B;IAC/B,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAwBD,iDAAiD;AACjD,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CA6BlE;AAED,mCAAmC;AACnC,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAkC5D;AAED,4CAA4C;AAC5C,wBAAgB,YAAY,IAAI,OAAO,EAAE,CAexC;AAED,uBAAuB;AACvB,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CASvD;AAED,sDAAsD;AACtD,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAYxE;AAcD,kDAAkD;AAClD,wBAAgB,cAAc,IAAI,OAAO,GAAG,IAAI,CAG/C;AAED,sCAAsC;AACtC,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAgB7D"}