@kernel.chat/kbot 1.3.1 → 2.3.1

package/dist/tools/tasks.js

@@ -0,0 +1,210 @@
+// K:BOT Task/TODO Tracking — Structured progress tracking during complex work
+//
+// Mirrors Claude Code's TaskCreate/TaskUpdate/TaskList/TaskGet pattern.
+// Tasks persist in memory during the session. The AI uses these to:
+//   1. Break down complex work into trackable steps
+//   2. Show the user progress on multi-step tasks
+//   3. Track dependencies between tasks
+//   4. Remember what's done and what's pending
+import { registerTool } from './index.js';
+const tasks = new Map();
+let nextId = 1;
+function formatTask(task) {
+    const statusIcon = {
+        pending: '○',
+        in_progress: '◉',
+        completed: '✓',
+        blocked: '⊘',
+    }[task.status];
+    const blocked = task.blockedBy.length > 0 ? ` (blocked by: ${task.blockedBy.join(', ')})` : '';
+    return `${statusIcon} #${task.id} [${task.status}] ${task.subject}${blocked}`;
+}
+export function registerTaskTools() {
+    registerTool({
+        name: 'task_create',
+        description: 'Create a task for tracking progress on complex work. Returns the task ID.',
+        parameters: {
+            subject: { type: 'string', description: 'Brief task title in imperative form (e.g., "Fix auth bug")', required: true },
+            description: { type: 'string', description: 'Detailed description of what needs to be done' },
+            activeForm: { type: 'string', description: 'Present continuous form for spinner display (e.g., "Fixing auth bug")' },
+            blockedBy: { type: 'array', description: 'Task IDs that must complete before this one can start' },
+        },
+        tier: 'free',
+        async execute(args) {
+            const id = String(nextId++);
+            const now = new Date().toISOString();
+            const task = {
+                id,
+                subject: String(args.subject),
+                description: args.description ? String(args.description) : '',
+                status: 'pending',
+                activeForm: args.activeForm ? String(args.activeForm) : undefined,
+                blockedBy: Array.isArray(args.blockedBy) ? args.blockedBy.map(String) : [],
+                blocks: [],
+                created: now,
+                updated: now,
+            };
+            // Update blocks references on blocker tasks
+            for (const blockerId of task.blockedBy) {
+                const blocker = tasks.get(blockerId);
+                if (blocker && !blocker.blocks.includes(id)) {
+                    blocker.blocks.push(id);
+                }
+            }
+            tasks.set(id, task);
+            return `Task #${id} created: ${task.subject}`;
+        },
+    });
+    registerTool({
+        name: 'task_update',
+        description: 'Update a task status, subject, or dependencies.',
+        parameters: {
+            id: { type: 'string', description: 'Task ID to update', required: true },
+            status: { type: 'string', description: 'New status: pending, in_progress, completed, blocked' },
+            subject: { type: 'string', description: 'Updated subject' },
+            description: { type: 'string', description: 'Updated description' },
+            addBlockedBy: { type: 'array', description: 'Task IDs to add as blockers' },
+        },
+        tier: 'free',
+        async execute(args) {
+            const id = String(args.id);
+            const task = tasks.get(id);
+            if (!task)
+                return `Error: Task #${id} not found`;
+            if (args.status) {
+                const status = String(args.status);
+                if (!['pending', 'in_progress', 'completed', 'blocked'].includes(status)) {
+                    return `Error: Invalid status "${status}". Use: pending, in_progress, completed, blocked`;
+                }
+                task.status = status;
+                // If completing, auto-unblock dependent tasks
+                if (status === 'completed') {
+                    for (const blockedId of task.blocks) {
+                        const blocked = tasks.get(blockedId);
+                        if (blocked) {
+                            blocked.blockedBy = blocked.blockedBy.filter(b => b !== id);
+                            if (blocked.blockedBy.length === 0 && blocked.status === 'blocked') {
+                                blocked.status = 'pending';
+                            }
+                        }
+                    }
+                }
+            }
+            if (args.subject)
+                task.subject = String(args.subject);
+            if (args.description)
+                task.description = String(args.description);
+            if (Array.isArray(args.addBlockedBy)) {
+                for (const blockerId of args.addBlockedBy) {
+                    const bid = String(blockerId);
+                    if (!task.blockedBy.includes(bid)) {
+                        task.blockedBy.push(bid);
+                        const blocker = tasks.get(bid);
+                        if (blocker && !blocker.blocks.includes(id)) {
+                            blocker.blocks.push(id);
+                        }
+                    }
+                }
+            }
+            task.updated = new Date().toISOString();
+            return formatTask(task);
+        },
+    });
+    registerTool({
+        name: 'task_list',
+        description: 'List all tasks with their status. Shows pending, in-progress, completed, and blocked tasks.',
+        parameters: {
+            status: { type: 'string', description: 'Filter by status (pending, in_progress, completed, blocked). Omit to show all.' },
+        },
+        tier: 'free',
+        async execute(args) {
+            if (tasks.size === 0)
+                return 'No tasks.';
+            let filtered = Array.from(tasks.values());
+            if (args.status) {
+                filtered = filtered.filter(t => t.status === String(args.status));
+            }
+            if (filtered.length === 0)
+                return `No ${args.status || ''} tasks.`;
+            // Group by status
+            const groups = {};
+            for (const t of filtered) {
+                if (!groups[t.status])
+                    groups[t.status] = [];
+                groups[t.status].push(t);
+            }
+            const lines = [];
+            const order = ['in_progress', 'pending', 'blocked', 'completed'];
+            for (const status of order) {
+                if (groups[status]) {
+                    for (const task of groups[status]) {
+                        lines.push(formatTask(task));
+                    }
+                }
+            }
+            const completed = filtered.filter(t => t.status === 'completed').length;
+            const total = filtered.length;
+            lines.push('');
+            lines.push(`${completed}/${total} completed`);
+            return lines.join('\n');
+        },
+    });
+    registerTool({
+        name: 'task_get',
+        description: 'Get full details of a specific task including description and dependencies.',
+        parameters: {
+            id: { type: 'string', description: 'Task ID', required: true },
+        },
+        tier: 'free',
+        async execute(args) {
+            const id = String(args.id);
+            const task = tasks.get(id);
+            if (!task)
+                return `Error: Task #${id} not found`;
+            const lines = [
+                `Task #${task.id}: ${task.subject}`,
+                `Status: ${task.status}`,
+                `Description: ${task.description || '(none)'}`,
+            ];
+            if (task.activeForm)
+                lines.push(`Active form: ${task.activeForm}`);
+            if (task.blockedBy.length > 0)
+                lines.push(`Blocked by: ${task.blockedBy.join(', ')}`);
+            if (task.blocks.length > 0)
+                lines.push(`Blocks: ${task.blocks.join(', ')}`);
+            lines.push(`Created: ${task.created}`);
+            lines.push(`Updated: ${task.updated}`);
+            return lines.join('\n');
+        },
+    });
+    registerTool({
+        name: 'task_delete',
+        description: 'Delete a task by ID.',
+        parameters: {
+            id: { type: 'string', description: 'Task ID to delete', required: true },
+        },
+        tier: 'free',
+        async execute(args) {
+            const id = String(args.id);
+            const task = tasks.get(id);
+            if (!task)
+                return `Error: Task #${id} not found`;
+            // Clean up dependency references
+            for (const blockerId of task.blockedBy) {
+                const blocker = tasks.get(blockerId);
+                if (blocker) {
+                    blocker.blocks = blocker.blocks.filter(b => b !== id);
+                }
+            }
+            for (const blockedId of task.blocks) {
+                const blocked = tasks.get(blockedId);
+                if (blocked) {
+                    blocked.blockedBy = blocked.blockedBy.filter(b => b !== id);
+                }
+            }
+            tasks.delete(id);
+            return `Task #${id} deleted: ${task.subject}`;
+        },
+    });
+}
+//# sourceMappingURL=tasks.js.map

package/dist/tools/tasks.js.map

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

package/dist/tools/worktree.d.ts

@@ -0,0 +1,2 @@
+export declare function registerWorktreeTools(): void;
+//# sourceMappingURL=worktree.d.ts.map

package/dist/tools/worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../src/tools/worktree.ts"],"names":[],"mappings":"AA8CA,wBAAgB,qBAAqB,IAAI,IAAI,CA0M5C"}

package/dist/tools/worktree.js

@@ -0,0 +1,223 @@
+// K:BOT Worktree — Git worktree isolation for safe experimentation
+//
+// Like Claude Code's EnterWorktree. Creates an isolated copy of the repo
+// so the agent can experiment without affecting the main working tree.
+//
+// Flow:
+//   worktree_create  — create a new worktree with a fresh branch
+//   worktree_switch  — switch the session into a worktree
+//   worktree_merge   — merge worktree changes back to main
+//   worktree_remove  — clean up a worktree
+//   worktree_list    — list active worktrees
+import { execSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { registerTool } from './index.js';
+const worktrees = new Map();
+let nextWorktreeId = 1;
+/** Get the git repo root */
+function getRepoRoot() {
+    try {
+        return execSync('git rev-parse --show-toplevel', { encoding: 'utf-8', timeout: 5000 }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/** Get current branch name */
+function getCurrentBranch() {
+    try {
+        return execSync('git branch --show-current', { encoding: 'utf-8', timeout: 5000 }).trim();
+    }
+    catch {
+        return 'main';
+    }
+}
+export function registerWorktreeTools() {
+    registerTool({
+        name: 'worktree_create',
+        description: 'Create an isolated git worktree for safe experimentation. Changes in the worktree do not affect the main working tree until merged.',
+        parameters: {
+            name: { type: 'string', description: 'Name for the worktree/branch (auto-generated if omitted)' },
+            base: { type: 'string', description: 'Base branch to create from (defaults to current branch)' },
+        },
+        tier: 'free',
+        async execute(args) {
+            const repoRoot = getRepoRoot();
+            if (!repoRoot)
+                return 'Error: Not in a git repository.';
+            const id = String(nextWorktreeId++);
+            const name = args.name
+                ? String(args.name)
+                : `kbot-wt-${Date.now().toString(36)}`;
+            const baseBranch = args.base ? String(args.base) : getCurrentBranch();
+            const branchName = `kbot/${name}`;
+            const worktreePath = join(repoRoot, '.kbot', 'worktrees', name);
+            try {
+                // Create the worktree with a new branch
+                execSync(`git worktree add -b "${branchName}" "${worktreePath}" "${baseBranch}"`, { encoding: 'utf-8', cwd: repoRoot, timeout: 30000 });
+                const wt = {
+                    id,
+                    branch: branchName,
+                    path: worktreePath,
+                    baseBranch,
+                    createdAt: new Date().toISOString(),
+                };
+                worktrees.set(id, wt);
+                return [
+                    `Worktree #${id} created`,
+                    `  Branch: ${branchName} (from ${baseBranch})`,
+                    `  Path:   ${worktreePath}`,
+                    '',
+                    `Use \`worktree_switch\` with id="${id}" to work in this isolated copy.`,
+                    'Changes here won\'t affect your main working tree.',
+                ].join('\n');
+            }
+            catch (err) {
+                const e = err;
+                return `Error creating worktree: ${e.stderr?.trim() || e.message}`;
+            }
+        },
+    });
+    registerTool({
+        name: 'worktree_switch',
+        description: 'Switch the current session into a worktree directory. All subsequent file operations happen in the isolated copy.',
+        parameters: {
+            id: { type: 'string', description: 'Worktree ID', required: true },
+        },
+        tier: 'free',
+        async execute(args) {
+            const id = String(args.id);
+            const wt = worktrees.get(id);
+            if (!wt)
+                return `Error: Worktree #${id} not found. Use \`worktree_list\` to see available worktrees.`;
+            if (!existsSync(wt.path)) {
+                return `Error: Worktree path no longer exists: ${wt.path}`;
+            }
+            try {
+                process.chdir(wt.path);
+                return `Switched to worktree #${id}\n  Branch: ${wt.branch}\n  Path: ${wt.path}\n\nAll file operations now happen in this isolated copy.`;
+            }
+            catch (err) {
+                return `Error switching to worktree: ${err instanceof Error ? err.message : String(err)}`;
+            }
+        },
+    });
+    registerTool({
+        name: 'worktree_merge',
+        description: 'Merge worktree changes back into the base branch. Switches back to the main working tree after merging.',
+        parameters: {
+            id: { type: 'string', description: 'Worktree ID', required: true },
+            message: { type: 'string', description: 'Merge commit message (auto-generated if omitted)' },
+        },
+        tier: 'free',
+        async execute(args) {
+            const id = String(args.id);
+            const wt = worktrees.get(id);
+            if (!wt)
+                return `Error: Worktree #${id} not found.`;
+            const repoRoot = getRepoRoot() || wt.path.replace(/\/.kbot\/worktrees\/.*$/, '');
+            try {
+                // Commit any uncommitted changes in the worktree
+                try {
+                    execSync('git add -A && git diff --staged --quiet || git commit -m "kbot: worktree changes"', {
+                        encoding: 'utf-8', cwd: wt.path, timeout: 15000,
+                        stdio: ['pipe', 'pipe', 'pipe'],
+                    });
+                }
+                catch { /* no changes to commit */ }
+                // Switch to main repo and merge
+                const commitMsg = args.message
+                    ? String(args.message)
+                    : `Merge kbot worktree: ${wt.branch}`;
+                execSync(`git merge "${wt.branch}" -m "${commitMsg}"`, {
+                    encoding: 'utf-8', cwd: repoRoot, timeout: 30000,
+                });
+                // Switch back to main repo
+                process.chdir(repoRoot);
+                return [
+                    `Worktree #${id} merged into ${wt.baseBranch}`,
+                    `  Message: ${commitMsg}`,
+                    `  Switched back to: ${repoRoot}`,
+                    '',
+                    `Use \`worktree_remove\` to clean up, or keep it for future work.`,
+                ].join('\n');
+            }
+            catch (err) {
+                const e = err;
+                return `Error merging worktree: ${e.stderr?.trim() || e.message}\n\nYou may need to resolve merge conflicts manually.`;
+            }
+        },
+    });
+    registerTool({
+        name: 'worktree_remove',
+        description: 'Remove a worktree and its branch. Cleans up the isolated copy.',
+        parameters: {
+            id: { type: 'string', description: 'Worktree ID', required: true },
+            force: { type: 'boolean', description: 'Force removal even with uncommitted changes' },
+        },
+        tier: 'free',
+        async execute(args) {
+            const id = String(args.id);
+            const wt = worktrees.get(id);
+            if (!wt)
+                return `Error: Worktree #${id} not found.`;
+            const repoRoot = getRepoRoot() || wt.path.replace(/\/.kbot\/worktrees\/.*$/, '');
+            const force = args.force === true ? ' --force' : '';
+            // If we're currently in the worktree, switch back
+            if (process.cwd().startsWith(wt.path)) {
+                process.chdir(repoRoot);
+            }
+            try {
+                execSync(`git worktree remove "${wt.path}"${force}`, {
+                    encoding: 'utf-8', cwd: repoRoot, timeout: 15000,
+                });
+                // Delete the branch too
+                try {
+                    execSync(`git branch -d "${wt.branch}"`, {
+                        encoding: 'utf-8', cwd: repoRoot, timeout: 5000,
+                        stdio: ['pipe', 'pipe', 'pipe'],
+                    });
+                }
+                catch { /* branch may already be gone */ }
+                worktrees.delete(id);
+                return `Worktree #${id} removed (branch: ${wt.branch})`;
+            }
+            catch (err) {
+                const e = err;
+                return `Error removing worktree: ${e.stderr?.trim() || e.message}\nTry with force=true to override.`;
+            }
+        },
+    });
+    registerTool({
+        name: 'worktree_list',
+        description: 'List all K:BOT worktrees and git worktrees.',
+        parameters: {},
+        tier: 'free',
+        async execute() {
+            const lines = [];
+            // K:BOT managed worktrees
+            if (worktrees.size > 0) {
+                lines.push('K:BOT worktrees:');
+                for (const [id, wt] of worktrees) {
+                    const exists = existsSync(wt.path) ? '✓' : '✗';
+                    lines.push(`  ${exists} #${id}  ${wt.branch.padEnd(30)} ${wt.path}`);
+                }
+                lines.push('');
+            }
+            // All git worktrees
+            try {
+                const gitWorktrees = execSync('git worktree list', {
+                    encoding: 'utf-8', timeout: 5000,
+                }).trim();
+                lines.push('Git worktrees:');
+                lines.push(gitWorktrees.split('\n').map(l => `  ${l}`).join('\n'));
+            }
+            catch {
+                lines.push('Not in a git repository.');
+            }
+            return lines.join('\n') || 'No worktrees.';
+        },
+    });
+}
+//# sourceMappingURL=worktree.js.map

package/dist/tools/worktree.js.map

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

package/dist/tui.d.ts

@@ -0,0 +1,73 @@
+export declare function getTermSize(): {
+    cols: number;
+    rows: number;
+};
+export declare function clearScreen(): void;
+export declare function hideCursor(): void;
+export declare function showCursor(): void;
+/** Draw a bordered panel with title */
+export declare function panel(title: string, content: string, opts?: {
+    width?: number;
+    color?: (text: string) => string;
+    padding?: number;
+}): string;
+/** Horizontal divider with optional label */
+export declare function dividerLine(label?: string, width?: number): string;
+export declare function progressBar(current: number, total: number, opts?: {
+    width?: number;
+    label?: string;
+    color?: (text: string) => string;
+    showPercent?: boolean;
+    showCount?: boolean;
+}): string;
+export interface StepProgress {
+    steps: Array<{
+        label: string;
+        status: 'pending' | 'running' | 'done' | 'failed';
+    }>;
+    currentStep: number;
+}
+export declare function renderStepProgress(progress: StepProgress): string;
+export declare function splitPane(left: {
+    title: string;
+    content: string;
+    color?: (text: string) => string;
+}, right: {
+    title: string;
+    content: string;
+    color?: (text: string) => string;
+}): string;
+export declare function table(headers: string[], rows: string[][], opts?: {
+    color?: (text: string) => string;
+    padding?: number;
+}): string;
+export interface DashboardState {
+    agent: string;
+    model: string;
+    provider: string;
+    toolsUsed: number;
+    tokensUsed: number;
+    cost: number;
+    sessionTurns: number;
+    activeSubagents: Array<{
+        id: string;
+        agent: string;
+        status: string;
+    }>;
+    recentTools: Array<{
+        name: string;
+        duration: number;
+        success: boolean;
+    }>;
+}
+export declare function renderDashboard(state: DashboardState): string;
+export declare function sparkline(data: number[], opts?: {
+    color?: (text: string) => string;
+    label?: string;
+}): string;
+export declare function toast(message: string, type?: 'info' | 'success' | 'warn' | 'error'): void;
+/** Truncate string with ellipsis */
+export declare function truncate(str: string, maxWidth: number): string;
+/** Word-wrap text to width */
+export declare function wordWrap(text: string, width: number): string[];
+//# sourceMappingURL=tui.d.ts.map

package/dist/tui.d.ts.map

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