@kernel.chat/kbot 1.3.1 → 2.3.0

package/dist/memory.js

@@ -69,7 +69,59 @@ export function clearHistory() {
 }
 /** Get the previous_messages array for the API */
 export function getPreviousMessages() {
-    // Send last 6 turns to keep token usage efficient
-    return sessionHistory.slice(-6).map(t => ({ role: t.role, content: t.content }));
+    // Send last 16 turns (8 exchanges) — enough context to maintain coherent conversation
+    return sessionHistory.slice(-16).map(t => ({ role: t.role, content: t.content }));
+}
+/** Compact/compress conversation history into a summary.
+ *  Keeps the last 4 turns verbatim, summarizes everything before.
+ *  This extends session length without losing context.
+ */
+export function compactHistory() {
+    const before = sessionHistory.length;
+    if (before <= 4) {
+        return { before, after: before, summary: 'History too short to compact.' };
+    }
+    // Keep last 4 turns verbatim
+    const keepVerbatim = sessionHistory.slice(-4);
+    const toSummarize = sessionHistory.slice(0, -4);
+    // Build a summary of the older turns
+    const summaryParts = ['Conversation summary (compacted):'];
+    const userMessages = [];
+    const assistantTopics = [];
+    for (const turn of toSummarize) {
+        if (turn.role === 'user') {
+            userMessages.push(turn.content.slice(0, 100));
+        }
+        else {
+            // Extract first line or first 100 chars as topic
+            const firstLine = turn.content.split('\n')[0].slice(0, 100);
+            assistantTopics.push(firstLine);
+        }
+    }
+    if (userMessages.length > 0) {
+        summaryParts.push(`User asked about: ${userMessages.join('; ')}`);
+    }
+    if (assistantTopics.length > 0) {
+        summaryParts.push(`Topics covered: ${assistantTopics.join('; ')}`);
+    }
+    const summaryText = summaryParts.join('\n');
+    // Replace history with summary + recent turns
+    sessionHistory = [
+        { role: 'assistant', content: summaryText },
+        ...keepVerbatim,
+    ];
+    return {
+        before,
+        after: sessionHistory.length,
+        summary: `Compacted ${before} turns → ${sessionHistory.length} (${before - sessionHistory.length} turns summarized)`,
+    };
+}
+/** Restore session history from a saved session */
+export function restoreHistory(turns) {
+    sessionHistory = [...turns];
+    // Keep manageable size
+    if (sessionHistory.length > 20) {
+        sessionHistory = sessionHistory.slice(-20);
+    }
 }
 //# sourceMappingURL=memory.js.map

package/dist/memory.js.map

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

package/dist/multimodal.d.ts

@@ -0,0 +1,57 @@
+/** Content block types for multimodal messages */
+export interface TextBlock {
+    type: 'text';
+    text: string;
+}
+export interface ImageBlock {
+    type: 'image';
+    source: {
+        type: 'base64';
+        media_type: string;
+        data: string;
+    };
+}
+export type ContentBlock = TextBlock | ImageBlock;
+/** Result of parsing a message for multimodal content */
+export interface ParsedMessage {
+    /** Clean text message with image paths removed */
+    text: string;
+    /** Content blocks for the API (text + images interleaved) */
+    blocks: ContentBlock[];
+    /** Number of images found */
+    imageCount: number;
+    /** Whether the message has multimodal content */
+    isMultimodal: boolean;
+}
+/** Check if a file path looks like an image */
+export declare function isImagePath(path: string): boolean;
+/** Encode an image file to a base64 content block */
+export declare function encodeImage(filePath: string): ImageBlock | null;
+/**
+ * Parse a user message for embedded image paths.
+ *
+ * Detects patterns like:
+ *   "what's in ./screenshot.png"
+ *   "describe /path/to/img.jpg and compare with other.png"
+ *   "analyze these: img1.png img2.webp"
+ */
+export declare function parseMultimodalMessage(message: string): ParsedMessage;
+/**
+ * Read image data from stdin pipe.
+ * Used for: cat image.png | kbot -p "what's this?"
+ */
+export declare function readStdinImage(): Promise<ImageBlock | null>;
+/**
+ * Convert ParsedMessage blocks to Anthropic Messages API format.
+ * Returns the content array for the user message.
+ */
+export declare function toAnthropicContent(parsed: ParsedMessage): Array<Record<string, unknown>>;
+/**
+ * Convert ParsedMessage to OpenAI Vision API format.
+ */
+export declare function toOpenAIContent(parsed: ParsedMessage): Array<Record<string, unknown>>;
+/**
+ * Convert ParsedMessage to Google Gemini API format.
+ */
+export declare function toGeminiParts(parsed: ParsedMessage): Array<Record<string, unknown>>;
+//# sourceMappingURL=multimodal.d.ts.map

package/dist/multimodal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multimodal.d.ts","sourceRoot":"","sources":["../src/multimodal.ts"],"names":[],"mappings":"AA2BA,kDAAkD;AAClD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ,CAAA;QACd,UAAU,EAAE,MAAM,CAAA;QAClB,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;CACF;AAED,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,CAAA;AAEjD,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAA;IACZ,6DAA6D;IAC7D,MAAM,EAAE,YAAY,EAAE,CAAA;IACtB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,iDAAiD;IACjD,YAAY,EAAE,OAAO,CAAA;CACtB;AAED,+CAA+C;AAC/C,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGjD;AAED,qDAAqD;AACrD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAqB/D;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAgDrE;AAED;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAsBjE;AA+BD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAUxF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAYrF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAYnF"}

package/dist/multimodal.js

@@ -0,0 +1,206 @@
+// K:BOT Multimodal Input — Accept images, PDFs, and binary files in CLI
+//
+// Detects image paths in user messages, encodes them to base64,
+// and builds content blocks for vision-capable providers.
+//
+// Supported:
+//   kbot "what's in this image?" ./screenshot.png
+//   kbot "describe this" /path/to/photo.jpg
+//   cat image.png | kbot -p "what's this?"
+//   kbot "compare these" img1.png img2.png
+import { readFileSync, existsSync, statSync } from 'node:fs';
+import { extname, resolve } from 'node:path';
+/** MIME types for supported image formats */
+const IMAGE_MIMES = {
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.bmp': 'image/bmp',
+    '.svg': 'image/svg+xml',
+};
+const MAX_IMAGE_SIZE = 20 * 1024 * 1024; // 20MB per image
+/** Check if a file path looks like an image */
+export function isImagePath(path) {
+    const ext = extname(path).toLowerCase();
+    return ext in IMAGE_MIMES;
+}
+/** Encode an image file to a base64 content block */
+export function encodeImage(filePath) {
+    const absPath = resolve(filePath);
+    if (!existsSync(absPath))
+        return null;
+    const stat = statSync(absPath);
+    if (stat.size > MAX_IMAGE_SIZE)
+        return null;
+    if (stat.isDirectory())
+        return null;
+    const ext = extname(absPath).toLowerCase();
+    const mime = IMAGE_MIMES[ext];
+    if (!mime)
+        return null;
+    const data = readFileSync(absPath).toString('base64');
+    return {
+        type: 'image',
+        source: {
+            type: 'base64',
+            media_type: mime,
+            data,
+        },
+    };
+}
+/**
+ * Parse a user message for embedded image paths.
+ *
+ * Detects patterns like:
+ *   "what's in ./screenshot.png"
+ *   "describe /path/to/img.jpg and compare with other.png"
+ *   "analyze these: img1.png img2.webp"
+ */
+export function parseMultimodalMessage(message) {
+    // Match file paths that look like images
+    // Patterns: ./file.png, /abs/path.jpg, relative/path.webp, ~/path.gif
+    const pathRegex = /(?:^|\s)((?:\.{0,2}\/|~\/|[a-zA-Z0-9_-]+\/)*[a-zA-Z0-9_.-]+\.(?:png|jpg|jpeg|gif|webp|bmp|svg))(?:\s|$)/gi;
+    const images = [];
+    const foundPaths = [];
+    let match;
+    while ((match = pathRegex.exec(message)) !== null) {
+        const filePath = match[1].trim();
+        const encoded = encodeImage(filePath);
+        if (encoded) {
+            images.push(encoded);
+            foundPaths.push(filePath);
+        }
+    }
+    if (images.length === 0) {
+        return {
+            text: message,
+            blocks: [{ type: 'text', text: message }],
+            imageCount: 0,
+            isMultimodal: false,
+        };
+    }
+    // Remove image paths from the text message
+    let cleanText = message;
+    for (const p of foundPaths) {
+        cleanText = cleanText.replace(p, '').trim();
+    }
+    // Clean up double spaces
+    cleanText = cleanText.replace(/\s{2,}/g, ' ').trim();
+    if (!cleanText)
+        cleanText = 'Describe this image.';
+    // Build interleaved content blocks: text first, then images
+    const blocks = [
+        { type: 'text', text: cleanText },
+        ...images,
+    ];
+    return {
+        text: cleanText,
+        blocks,
+        imageCount: images.length,
+        isMultimodal: true,
+    };
+}
+/**
+ * Read image data from stdin pipe.
+ * Used for: cat image.png | kbot -p "what's this?"
+ */
+export async function readStdinImage() {
+    if (process.stdin.isTTY)
+        return null;
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+    }
+    const data = Buffer.concat(chunks);
+    if (data.length === 0)
+        return null;
+    // Detect image type from magic bytes
+    const mime = detectMimeFromBytes(data);
+    if (!mime)
+        return null;
+    return {
+        type: 'image',
+        source: {
+            type: 'base64',
+            media_type: mime,
+            data: data.toString('base64'),
+        },
+    };
+}
+/** Detect image MIME type from file magic bytes */
+function detectMimeFromBytes(data) {
+    if (data.length < 4)
+        return null;
+    // PNG: 89 50 4E 47
+    if (data[0] === 0x89 && data[1] === 0x50 && data[2] === 0x4E && data[3] === 0x47) {
+        return 'image/png';
+    }
+    // JPEG: FF D8 FF
+    if (data[0] === 0xFF && data[1] === 0xD8 && data[2] === 0xFF) {
+        return 'image/jpeg';
+    }
+    // GIF: 47 49 46
+    if (data[0] === 0x47 && data[1] === 0x49 && data[2] === 0x46) {
+        return 'image/gif';
+    }
+    // WebP: 52 49 46 46 ... 57 45 42 50
+    if (data[0] === 0x52 && data[1] === 0x49 && data[2] === 0x46 && data[3] === 0x46 &&
+        data.length > 11 && data[8] === 0x57 && data[9] === 0x45 && data[10] === 0x42 && data[11] === 0x50) {
+        return 'image/webp';
+    }
+    // BMP: 42 4D
+    if (data[0] === 0x42 && data[1] === 0x4D) {
+        return 'image/bmp';
+    }
+    return null;
+}
+/**
+ * Convert ParsedMessage blocks to Anthropic Messages API format.
+ * Returns the content array for the user message.
+ */
+export function toAnthropicContent(parsed) {
+    return parsed.blocks.map(block => {
+        if (block.type === 'text') {
+            return { type: 'text', text: block.text };
+        }
+        return {
+            type: 'image',
+            source: block.source,
+        };
+    });
+}
+/**
+ * Convert ParsedMessage to OpenAI Vision API format.
+ */
+export function toOpenAIContent(parsed) {
+    return parsed.blocks.map(block => {
+        if (block.type === 'text') {
+            return { type: 'text', text: block.text };
+        }
+        return {
+            type: 'image_url',
+            image_url: {
+                url: `data:${block.source.media_type};base64,${block.source.data}`,
+            },
+        };
+    });
+}
+/**
+ * Convert ParsedMessage to Google Gemini API format.
+ */
+export function toGeminiParts(parsed) {
+    return parsed.blocks.map(block => {
+        if (block.type === 'text') {
+            return { text: block.text };
+        }
+        return {
+            inline_data: {
+                mime_type: block.source.media_type,
+                data: block.source.data,
+            },
+        };
+    });
+}
+//# sourceMappingURL=multimodal.js.map

package/dist/multimodal.js.map

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

package/dist/permissions.d.ts

@@ -0,0 +1,21 @@
+export type PermissionMode = 'permissive' | 'normal' | 'strict';
+/** Set the permission mode */
+export declare function setPermissionMode(mode: PermissionMode): void;
+/** Get the current permission mode */
+export declare function getPermissionMode(): PermissionMode;
+/**
+ * Check if a tool call requires user confirmation.
+ * Returns the reason if confirmation is needed, null otherwise.
+ */
+export declare function needsConfirmation(toolName: string, args: Record<string, unknown>): string | null;
+/**
+ * Ask the user to confirm a tool call.
+ * Returns true if approved, false if denied.
+ */
+export declare function confirmToolCall(toolName: string, args: Record<string, unknown>, reason: string): Promise<boolean>;
+/**
+ * Check and confirm a tool call. Returns true to proceed, false to skip.
+ * Used as middleware in the tool execution pipeline.
+ */
+export declare function checkPermission(toolName: string, args: Record<string, unknown>): Promise<boolean>;
+//# sourceMappingURL=permissions.d.ts.map

package/dist/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAuB/D,8BAA8B;AAC9B,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAE5D;AAED,sCAAsC;AACtC,wBAAgB,iBAAiB,IAAI,cAAc,CAElD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,GAAG,IAAI,CA+Bf;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC,CAmClB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAIlB"}

package/dist/permissions.js

@@ -0,0 +1,122 @@
+// K:BOT Permission System — Confirmation before destructive operations
+//
+// Like Claude Code's permission modes. K:BOT asks before:
+//   - git push, git reset --hard, git checkout -- files
+//   - rm -rf (non-trivial deletes)
+//   - Docker operations that affect running containers
+//   - Network requests to unknown endpoints
+//   - Any tool call that could lose data
+//
+// Modes:
+//   'permissive'  — auto-approve everything (for scripts/CI)
+//   'normal'      — confirm destructive ops (default)
+//   'strict'      — confirm all file writes and tool calls
+import { createInterface } from 'node:readline';
+import chalk from 'chalk';
+let currentMode = 'normal';
+/** Patterns that always require confirmation in normal mode */
+const DESTRUCTIVE_PATTERNS = [
+    { pattern: /^git\s+push/, reason: 'Pushes code to remote — visible to others' },
+    { pattern: /^git\s+reset\s+--hard/, reason: 'Discards all uncommitted changes' },
+    { pattern: /^git\s+checkout\s+--\s/, reason: 'Discards file changes' },
+    { pattern: /^git\s+branch\s+-[dD]\s/, reason: 'Deletes a git branch' },
+    { pattern: /^git\s+push\s+.*--force/, reason: 'Force push — can overwrite remote history' },
+    { pattern: /^rm\s+-rf?\s+[^.]/, reason: 'Recursive delete' },
+    { pattern: /^docker\s+rm\s+-f/, reason: 'Force removes Docker containers' },
+    { pattern: /^docker\s+system\s+prune/, reason: 'Removes unused Docker data' },
+    { pattern: /^kubectl\s+delete/, reason: 'Deletes Kubernetes resources' },
+    { pattern: /^npm\s+publish/, reason: 'Publishes package to npm' },
+    { pattern: /^npx\s+supabase\s+functions\s+deploy/, reason: 'Deploys edge function to production' },
+    { pattern: /^npx\s+supabase\s+db\s+push/, reason: 'Pushes database migrations to production' },
+    { pattern: /DROP\s+TABLE/i, reason: 'Drops a database table' },
+    { pattern: /TRUNCATE/i, reason: 'Truncates a database table' },
+    { pattern: /DELETE\s+FROM/i, reason: 'Deletes database rows' },
+];
+/** Set the permission mode */
+export function setPermissionMode(mode) {
+    currentMode = mode;
+}
+/** Get the current permission mode */
+export function getPermissionMode() {
+    return currentMode;
+}
+/**
+ * Check if a tool call requires user confirmation.
+ * Returns the reason if confirmation is needed, null otherwise.
+ */
+export function needsConfirmation(toolName, args) {
+    if (currentMode === 'permissive')
+        return null;
+    // Strict mode: confirm everything except reads
+    if (currentMode === 'strict') {
+        const readOnlyTools = ['read_file', 'glob', 'grep', 'list_directory', 'git_status', 'git_diff', 'git_log',
+            'web_search', 'task_list', 'task_get', 'build_detect', 'build_targets', 'build_check',
+            'mcp_list_tools', 'mcp_list_resources', 'mcp_servers', 'agent_list', 'agent_result',
+            'background_list', 'sandbox_list', 'notebook_read'];
+        if (!readOnlyTools.includes(toolName)) {
+            return `${toolName} modifies state (strict mode)`;
+        }
+        return null;
+    }
+    // Normal mode: only confirm destructive operations
+    if (toolName === 'bash') {
+        const command = String(args.command || '');
+        for (const { pattern, reason } of DESTRUCTIVE_PATTERNS) {
+            if (pattern.test(command.trim())) {
+                return reason;
+            }
+        }
+    }
+    // git_push always needs confirmation
+    if (toolName === 'git_push') {
+        return 'Pushes code to remote repository';
+    }
+    return null;
+}
+/**
+ * Ask the user to confirm a tool call.
+ * Returns true if approved, false if denied.
+ */
+export async function confirmToolCall(toolName, args, reason) {
+    const AMETHYST = chalk.hex('#6B5B95');
+    console.log();
+    console.log(`  ${chalk.yellow('⚠')} ${chalk.bold('Confirmation required')}`);
+    console.log(`  ${chalk.dim(reason)}`);
+    console.log();
+    console.log(`  ${AMETHYST('Tool:')} ${toolName}`);
+    // Show relevant args
+    for (const [key, value] of Object.entries(args)) {
+        const display = typeof value === 'string' && value.length > 80
+            ? value.slice(0, 80) + '...'
+            : String(value);
+        console.log(`  ${chalk.dim(key + ':')} ${display}`);
+    }
+    console.log();
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await new Promise((resolve) => {
+        rl.question(`  ${chalk.bold('Approve?')} ${chalk.dim('[y/N]')} `, (a) => {
+            resolve(a.trim().toLowerCase());
+            rl.close();
+        });
+    });
+    const approved = answer === 'y' || answer === 'yes';
+    if (approved) {
+        console.log(`  ${chalk.green('✓')} Approved`);
+    }
+    else {
+        console.log(`  ${chalk.red('✗')} Denied`);
+    }
+    console.log();
+    return approved;
+}
+/**
+ * Check and confirm a tool call. Returns true to proceed, false to skip.
+ * Used as middleware in the tool execution pipeline.
+ */
+export async function checkPermission(toolName, args) {
+    const reason = needsConfirmation(toolName, args);
+    if (!reason)
+        return true;
+    return confirmToolCall(toolName, args, reason);
+}
+//# sourceMappingURL=permissions.js.map

package/dist/permissions.js.map

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

package/dist/planner.d.ts

@@ -0,0 +1,54 @@
+import { type AgentOptions } from './agent.js';
+export interface PlanStep {
+    id: number;
+    description: string;
+    tool?: string;
+    args?: Record<string, unknown>;
+    /** Files this step reads */
+    reads?: string[];
+    /** Files this step modifies */
+    writes?: string[];
+    status: 'pending' | 'running' | 'done' | 'failed' | 'skipped';
+    result?: string;
+    error?: string;
+    /** Step IDs this depends on */
+    dependsOn?: number[];
+}
+export interface Plan {
+    task: string;
+    summary: string;
+    steps: PlanStep[];
+    filesInScope: string[];
+    estimatedToolCalls: number;
+    status: 'planning' | 'awaiting_approval' | 'executing' | 'completed' | 'failed';
+    createdAt: string;
+}
+/**
+ * Generate a plan for a complex task.
+ * Uses the AI to analyze the task and produce structured steps.
+ */
+export declare function generatePlan(task: string, agentOpts: AgentOptions): Promise<Plan>;
+/**
+ * Display a plan to the user for approval.
+ */
+export declare function displayPlan(plan: Plan): void;
+/**
+ * Execute a plan step by step.
+ * Supports parallel execution for independent steps.
+ */
+export declare function executePlan(plan: Plan, agentOpts: AgentOptions, onStepComplete?: (step: PlanStep) => void): Promise<Plan>;
+/**
+ * Full autonomous flow: Plan → Confirm → Execute → Verify
+ * This is the top-level entry point for complex tasks.
+ */
+export declare function autonomousExecute(task: string, agentOpts: AgentOptions, options?: {
+    /** Skip approval — execute immediately */
+    autoApprove?: boolean;
+    /** Callback for user approval (return true to proceed) */
+    onApproval?: (plan: Plan) => Promise<boolean>;
+}): Promise<Plan>;
+/**
+ * Format a plan summary for display after completion
+ */
+export declare function formatPlanSummary(plan: Plan): string;
+//# sourceMappingURL=planner.d.ts.map

package/dist/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../src/planner.ts"],"names":[],"mappings":"AAaA,OAAO,EAAY,KAAK,YAAY,EAAsB,MAAM,YAAY,CAAA;AAW5E,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAA;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,MAAM,EAAE,UAAU,GAAG,mBAAmB,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAA;IAC/E,SAAS,EAAE,MAAM,CAAA;CAClB;AAkCD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,YAAY,GACtB,OAAO,CAAC,IAAI,CAAC,CAuDf;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAqB5C;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,YAAY,EACvB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,GACxC,OAAO,CAAC,IAAI,CAAC,CA0Gf;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,YAAY,EACvB,OAAO,CAAC,EAAE;IACR,0CAA0C;IAC1C,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC9C,GACA,OAAO,CAAC,IAAI,CAAC,CA4Cf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAmBpD"}