@kernel.chat/kbot 3.36.0 → 3.38.0

package/dist/meta-agent.js

@@ -0,0 +1,288 @@
+// kbot Meta-Agent — Self-Referential Self-Improvement
+//
+// Inspired by Meta's HyperAgents (arXiv 2603.19461, 2026).
+// Two-agent loop: Task agents solve problems. The Meta-Agent watches,
+// analyzes performance, and rewrites the task agents to be better.
+//
+// Unlike HyperAgents (CC BY-NC-SA, non-commercial), kbot is MIT — the only
+// self-improving agent framework companies can actually use.
+//
+// Architecture:
+//   Meta-Agent (this file)
+//       ↓ observes task agent performance
+//       ↓ identifies improvement opportunities
+//       ↓ generates improved prompts/routing/tools
+//       ↓ applies improvements
+//       ↓ measures impact
+//       ↓ loop forever
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const KBOT_DIR = join(homedir(), '.kbot');
+const META_DIR = join(KBOT_DIR, 'meta-agent');
+const HISTORY_PATH = join(META_DIR, 'improvement-history.json');
+const OBSERVATIONS_PATH = join(META_DIR, 'observations.json');
+// ── Helpers ─────────────────────────────────────────────────────────────────
+function ensureMetaDir() {
+    if (!existsSync(META_DIR))
+        mkdirSync(META_DIR, { recursive: true });
+}
+function loadJson(path, fallback) {
+    try {
+        if (existsSync(path))
+            return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch { /* ignore */ }
+    return fallback;
+}
+function saveJson(path, data) {
+    ensureMetaDir();
+    writeFileSync(path, JSON.stringify(data, null, 2));
+}
+function generateId() {
+    return `imp_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 6)}`;
+}
+// ── Core: Observe ───────────────────────────────────────────────────────────
+export function recordObservation(obs) {
+    ensureMetaDir();
+    const observations = loadJson(OBSERVATIONS_PATH, []);
+    observations.push(obs);
+    // Keep last 1000 observations
+    if (observations.length > 1000)
+        observations.splice(0, observations.length - 1000);
+    saveJson(OBSERVATIONS_PATH, observations);
+}
+// ── Core: Analyze ───────────────────────────────────────────────────────────
+export function analyzePerformance() {
+    const observations = loadJson(OBSERVATIONS_PATH, []);
+    if (observations.length === 0)
+        return [];
+    // Group by agent
+    const byAgent = new Map();
+    for (const obs of observations) {
+        const list = byAgent.get(obs.agent) || [];
+        list.push(obs);
+        byAgent.set(obs.agent, list);
+    }
+    const profiles = [];
+    for (const [agent, tasks] of byAgent) {
+        const successes = tasks.filter(t => t.success);
+        const failures = tasks.filter(t => !t.success);
+        // Tool frequency
+        const toolCounts = new Map();
+        for (const t of tasks) {
+            for (const tool of t.tools_used) {
+                toolCounts.set(tool, (toolCounts.get(tool) || 0) + 1);
+            }
+        }
+        const commonTools = Array.from(toolCounts.entries())
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 5)
+            .map(([name, count]) => ({ name, frequency: count / tasks.length }));
+        // Failure patterns
+        const errorCounts = new Map();
+        for (const f of failures) {
+            const pattern = f.error?.slice(0, 100) || 'unknown';
+            errorCounts.set(pattern, (errorCounts.get(pattern) || 0) + 1);
+        }
+        const failurePatterns = Array.from(errorCounts.entries())
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 3)
+            .map(([pattern]) => pattern);
+        const successRate = tasks.length > 0 ? successes.length / tasks.length : 0;
+        const avgDuration = tasks.length > 0 ? tasks.reduce((s, t) => s + t.duration_ms, 0) / tasks.length : 0;
+        const avgCost = tasks.length > 0 ? tasks.reduce((s, t) => s + t.cost, 0) / tasks.length : 0;
+        profiles.push({
+            agent,
+            total_tasks: tasks.length,
+            success_rate: Math.round(successRate * 100) / 100,
+            avg_duration_ms: Math.round(avgDuration),
+            avg_cost: Math.round(avgCost * 10000) / 10000,
+            common_tools: commonTools,
+            failure_patterns: failurePatterns,
+            improvement_potential: successRate < 0.7 ? 'high' : successRate < 0.9 ? 'medium' : 'low',
+        });
+    }
+    return profiles.sort((a, b) => a.success_rate - b.success_rate);
+}
+// ── Core: Improve ───────────────────────────────────────────────────────────
+export function proposeImprovements(profiles) {
+    const improvements = [];
+    for (const profile of profiles) {
+        // High failure rate → improve prompt
+        if (profile.success_rate < 0.7 && profile.total_tasks >= 5) {
+            improvements.push({
+                id: generateId(),
+                timestamp: new Date().toISOString(),
+                target: 'prompt',
+                agent: profile.agent,
+                description: `Agent "${profile.agent}" has ${Math.round(profile.success_rate * 100)}% success rate across ${profile.total_tasks} tasks. Top failure patterns: ${profile.failure_patterns.join(', ') || 'unknown'}. Propose refined system prompt with explicit instructions for handling these failure cases.`,
+                before: `Current ${profile.agent} agent prompt`,
+                after: `Enhanced prompt with: failure pattern guards, tool selection hints for common tasks, fallback instructions`,
+                expected_impact: `Success rate from ${Math.round(profile.success_rate * 100)}% → ${Math.min(95, Math.round(profile.success_rate * 100) + 20)}%`,
+                status: 'proposed',
+            });
+        }
+        // Slow agent → optimize tool selection
+        if (profile.avg_duration_ms > 10000 && profile.total_tasks >= 3) {
+            improvements.push({
+                id: generateId(),
+                timestamp: new Date().toISOString(),
+                target: 'tool_selection',
+                agent: profile.agent,
+                description: `Agent "${profile.agent}" averages ${Math.round(profile.avg_duration_ms / 1000)}s per task. Most used tools: ${profile.common_tools.map(t => t.name).join(', ')}. Propose tool pre-selection to skip discovery phase.`,
+                before: `Dynamic tool discovery on every invocation`,
+                after: `Pre-loaded tool set for ${profile.agent}: [${profile.common_tools.map(t => t.name).join(', ')}]`,
+                expected_impact: `Duration from ${Math.round(profile.avg_duration_ms / 1000)}s → ${Math.round(profile.avg_duration_ms / 1000 * 0.6)}s`,
+                status: 'proposed',
+            });
+        }
+        // Expensive agent → route to cheaper model for simple tasks
+        if (profile.avg_cost > 0.01 && profile.total_tasks >= 5) {
+            improvements.push({
+                id: generateId(),
+                timestamp: new Date().toISOString(),
+                target: 'routing',
+                agent: profile.agent,
+                description: `Agent "${profile.agent}" costs $${profile.avg_cost.toFixed(4)}/task avg. For simple tasks (< 500 tokens), route to local model to reduce cost by ~100%.`,
+                before: `All tasks use cloud model`,
+                after: `Simple tasks (< 500 tokens) → local model. Complex tasks → cloud.`,
+                expected_impact: `Cost from $${profile.avg_cost.toFixed(4)} → $${(profile.avg_cost * 0.4).toFixed(4)} per task`,
+                status: 'proposed',
+            });
+        }
+    }
+    return improvements;
+}
+// ── Core: Apply ─────────────────────────────────────────────────────────────
+export function applyImprovement(improvement) {
+    ensureMetaDir();
+    // Save the improvement to routing hints file
+    const hintsPath = join(KBOT_DIR, 'meta-agent', 'active-improvements.json');
+    const active = loadJson(hintsPath, []);
+    improvement.status = 'applied';
+    active.push(improvement);
+    saveJson(hintsPath, active);
+    // Log to history
+    const history = loadJson(HISTORY_PATH, []);
+    history.push(improvement);
+    if (history.length > 500)
+        history.splice(0, history.length - 500);
+    saveJson(HISTORY_PATH, history);
+    return true;
+}
+// ── Core: Measure ───────────────────────────────────────────────────────────
+export function measureImpact(improvementId) {
+    const history = loadJson(HISTORY_PATH, []);
+    const imp = history.find(i => i.id === improvementId);
+    if (!imp)
+        return `Improvement ${improvementId} not found.`;
+    const observations = loadJson(OBSERVATIONS_PATH, []);
+    const appliedAt = new Date(imp.timestamp).getTime();
+    const before = observations.filter(o => new Date(o.timestamp).getTime() < appliedAt && o.agent === imp.agent);
+    const after = observations.filter(o => new Date(o.timestamp).getTime() >= appliedAt && o.agent === imp.agent);
+    if (after.length < 3)
+        return `Not enough data yet. ${after.length}/3 observations since improvement applied.`;
+    const beforeRate = before.length > 0 ? before.filter(o => o.success).length / before.length : 0;
+    const afterRate = after.length > 0 ? after.filter(o => o.success).length / after.length : 0;
+    const beforeDuration = before.length > 0 ? before.reduce((s, o) => s + o.duration_ms, 0) / before.length : 0;
+    const afterDuration = after.length > 0 ? after.reduce((s, o) => s + o.duration_ms, 0) / after.length : 0;
+    imp.measured_impact = `Success: ${Math.round(beforeRate * 100)}% → ${Math.round(afterRate * 100)}%. Duration: ${Math.round(beforeDuration)}ms → ${Math.round(afterDuration)}ms.`;
+    imp.status = 'measured';
+    saveJson(HISTORY_PATH, history);
+    return imp.measured_impact;
+}
+// ── Main Loop ───────────────────────────────────────────────────────────────
+export async function runMetaAgent() {
+    ensureMetaDir();
+    const cycleCountPath = join(META_DIR, 'cycle-count.json');
+    const cycleCount = (loadJson(cycleCountPath, { count: 0 })).count + 1;
+    saveJson(cycleCountPath, { count: cycleCount });
+    console.log(`\n🧠 Meta-Agent — Cycle #${cycleCount}`);
+    console.log('─'.repeat(50));
+    // 1. Analyze
+    console.log('\n📊 Analyzing task agent performance...');
+    const profiles = analyzePerformance();
+    if (profiles.length === 0) {
+        console.log('   No observations yet. Use kbot to generate data.');
+        return {
+            timestamp: new Date().toISOString(),
+            observations_analyzed: 0,
+            profiles: [],
+            improvements_proposed: [],
+            improvements_applied: [],
+            cycle_number: cycleCount,
+        };
+    }
+    for (const p of profiles) {
+        const bar = p.success_rate >= 0.9 ? '🟢' : p.success_rate >= 0.7 ? '🟡' : '🔴';
+        console.log(`   ${bar} ${p.agent}: ${Math.round(p.success_rate * 100)}% success, ${p.total_tasks} tasks, ${Math.round(p.avg_duration_ms)}ms avg`);
+    }
+    // 2. Propose improvements
+    console.log('\n💡 Proposing improvements...');
+    const proposed = proposeImprovements(profiles);
+    if (proposed.length === 0) {
+        console.log('   All agents performing well. No improvements needed.');
+    }
+    for (const imp of proposed) {
+        console.log(`   → [${imp.target}] ${imp.agent}: ${imp.description.slice(0, 100)}...`);
+        console.log(`     Expected: ${imp.expected_impact}`);
+    }
+    // 3. Apply improvements (auto-apply low-risk ones)
+    const applied = [];
+    for (const imp of proposed) {
+        if (imp.target === 'routing' || imp.target === 'tool_selection') {
+            // Low risk — auto-apply
+            applyImprovement(imp);
+            applied.push(imp);
+            console.log(`   ✓ Applied: ${imp.description.slice(0, 80)}`);
+        }
+        else {
+            // Higher risk — propose only
+            console.log(`   ⏸ Proposed (needs review): ${imp.description.slice(0, 80)}`);
+        }
+    }
+    // 4. Measure previous improvements
+    console.log('\n📏 Measuring previous improvements...');
+    const history = loadJson(HISTORY_PATH, []);
+    const unmeasured = history.filter(i => i.status === 'applied');
+    for (const imp of unmeasured.slice(0, 5)) {
+        const result = measureImpact(imp.id);
+        console.log(`   ${imp.agent} [${imp.target}]: ${result}`);
+    }
+    const observations = loadJson(OBSERVATIONS_PATH, []);
+    const report = {
+        timestamp: new Date().toISOString(),
+        observations_analyzed: observations.length,
+        profiles,
+        improvements_proposed: proposed,
+        improvements_applied: applied,
+        cycle_number: cycleCount,
+    };
+    // Save report
+    const reportPath = join(META_DIR, `report-${cycleCount}.json`);
+    saveJson(reportPath, report);
+    console.log(`\n✅ Meta-Agent cycle #${cycleCount} complete.`);
+    console.log(`   ${observations.length} observations analyzed`);
+    console.log(`   ${proposed.length} improvements proposed`);
+    console.log(`   ${applied.length} improvements auto-applied`);
+    console.log(`   Report: ${reportPath}\n`);
+    return report;
+}
+// ── Get improvement history ─────────────────────────────────────────────────
+export function getImprovementHistory() {
+    return loadJson(HISTORY_PATH, []);
+}
+export function getActiveImprovements() {
+    const hintsPath = join(META_DIR, 'active-improvements.json');
+    return loadJson(hintsPath, []);
+}
+export function getMetaStats() {
+    const cycleCountPath = join(META_DIR, 'cycle-count.json');
+    const cycles = (loadJson(cycleCountPath, { count: 0 })).count;
+    const observations = loadJson(OBSERVATIONS_PATH, []).length;
+    const improvements = loadJson(HISTORY_PATH, []).length;
+    const active = getActiveImprovements().length;
+    return { cycles, observations, improvements, active };
+}
+//# sourceMappingURL=meta-agent.js.map

package/dist/meta-agent.js.map

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

package/dist/plugin/index.d.ts

@@ -0,0 +1,71 @@
+import { type BridgeStatus } from '../ide/bridge.js';
+export interface PluginContext {
+    /** Working directory for kbot to operate in */
+    cwd?: string;
+    /** Default agent to use */
+    agent?: string;
+    /** API tier override */
+    tier?: string;
+    /** Skip starting the MCP server (e.g., if already running) */
+    skipMcp?: boolean;
+}
+export interface SkillDefinition {
+    /** Skill name (matches manifest) */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Path to the skill markdown file */
+    file: string;
+    /** The kbot CLI command this skill maps to */
+    command: string;
+}
+export interface PluginManifest {
+    name: string;
+    version: string;
+    description: string;
+    homepage: string;
+    repository: string;
+    license: string;
+    mcpServers: Record<string, {
+        command: string;
+        args: string[];
+        env: Record<string, string>;
+    }>;
+    channels: Record<string, {
+        command: string;
+        args: string[];
+    }>;
+    skills: Array<{
+        name: string;
+        description: string;
+        file: string;
+    }>;
+}
+/**
+ * Load and return the plugin manifest.
+ */
+export declare function getManifest(): PluginManifest;
+/**
+ * Skill definitions mapping Claude Code slash commands to kbot CLI commands.
+ */
+export declare const skills: SkillDefinition[];
+/**
+ * Load the markdown content of a skill file.
+ */
+export declare function loadSkillContent(skillName: string): string | null;
+/**
+ * Activate the kbot plugin.
+ *
+ * Initializes the IDE bridge (registers tools, gathers project context)
+ * and optionally starts the MCP server for tool communication.
+ */
+export declare function activate(context?: PluginContext): Promise<BridgeStatus>;
+/**
+ * Deactivate the kbot plugin. Cleans up resources.
+ */
+export declare function deactivate(): void;
+/**
+ * Check if the plugin is currently activated.
+ */
+export declare function isActivated(): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EAA4C,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAI9F,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC,CAAA;IAC5F,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;IAC7D,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACnE;AAUD;;GAEG;AACH,wBAAgB,WAAW,IAAI,cAAc,CAW5C;AAID;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,eAAe,EA+BnC,CAAA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgBjE;AAID;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CA0BjF;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAErC"}

package/dist/plugin/index.js

@@ -0,0 +1,133 @@
+// kbot Claude Code Plugin — Entry point
+//
+// Bridges kbot's full cognitive engine into Claude Code as a plugin.
+// Starts the MCP server, registers tools, sets up the Channel for
+// two-way communication, and exports skills that map to kbot commands.
+//
+// Usage:
+//   As a Claude Code plugin, this module is loaded automatically when
+//   the plugin manifest is registered. It can also be imported directly:
+//
+//     import { activate, deactivate, skills } from './plugin/index.js'
+//     await activate({ cwd: process.cwd() })
+import { readFileSync, existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { startMcpServer } from '../ide/mcp-server.js';
+import { initBridge, getStatus } from '../ide/bridge.js';
+// ── State ───────────────────────────────────────────────────────────────────
+let activated = false;
+// ── Manifest ────────────────────────────────────────────────────────────────
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+ * Load and return the plugin manifest.
+ */
+export function getManifest() {
+    const manifestPath = join(__dirname, 'manifest.json');
+    if (!existsSync(manifestPath)) {
+        // Fallback for compiled output where manifest.json may be at a different relative path
+        const altPath = join(__dirname, '..', 'plugin', 'manifest.json');
+        if (existsSync(altPath)) {
+            return JSON.parse(readFileSync(altPath, 'utf-8'));
+        }
+        throw new Error(`kbot plugin manifest not found at ${manifestPath}`);
+    }
+    return JSON.parse(readFileSync(manifestPath, 'utf-8'));
+}
+// ── Skills ──────────────────────────────────────────────────────────────────
+/**
+ * Skill definitions mapping Claude Code slash commands to kbot CLI commands.
+ */
+export const skills = [
+    {
+        name: 'dream',
+        description: 'Run kbot dream mode — memory consolidation, meta-agent cycle, forge speculation, and self-benchmarking',
+        file: 'skills/dream.md',
+        command: 'kbot dream',
+    },
+    {
+        name: 'dashboard',
+        description: "Show kbot's live learning dashboard — tool usage, agent routing, growth metrics",
+        file: 'skills/dashboard.md',
+        command: 'kbot dashboard',
+    },
+    {
+        name: 'pair',
+        description: 'Start pair programming mode — file watcher with real-time AI suggestions and auto-fix',
+        file: 'skills/pair.md',
+        command: 'kbot pair',
+    },
+    {
+        name: 'guardian',
+        description: 'Run codebase guardian — detect duplicates, co-change patterns, and complexity hotspots',
+        file: 'skills/guardian.md',
+        command: 'kbot guardian',
+    },
+    {
+        name: 'meta',
+        description: 'Run meta-agent cycle — analyze task agent performance, propose and apply improvements',
+        file: 'skills/meta.md',
+        command: 'kbot meta',
+    },
+];
+/**
+ * Load the markdown content of a skill file.
+ */
+export function loadSkillContent(skillName) {
+    const skill = skills.find(s => s.name === skillName);
+    if (!skill)
+        return null;
+    const skillPath = join(__dirname, skill.file);
+    if (existsSync(skillPath)) {
+        return readFileSync(skillPath, 'utf-8');
+    }
+    // Fallback for compiled output
+    const altPath = join(__dirname, '..', 'plugin', skill.file);
+    if (existsSync(altPath)) {
+        return readFileSync(altPath, 'utf-8');
+    }
+    return null;
+}
+// ── Lifecycle ───────────────────────────────────────────────────────────────
+/**
+ * Activate the kbot plugin.
+ *
+ * Initializes the IDE bridge (registers tools, gathers project context)
+ * and optionally starts the MCP server for tool communication.
+ */
+export async function activate(context = {}) {
+    if (activated) {
+        return getStatus();
+    }
+    const bridgeConfig = {
+        cwd: context.cwd,
+        agent: context.agent,
+        tier: context.tier,
+    };
+    // Initialize the bridge — registers all tools and gathers project context
+    await initBridge(bridgeConfig);
+    // Start MCP server unless explicitly skipped
+    if (!context.skipMcp) {
+        // Start in background — the MCP server runs on stdio and blocks,
+        // so we only start it if this is the main plugin entry point
+        startMcpServer(bridgeConfig).catch((err) => {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(`[kbot plugin] MCP server error: ${message}`);
+        });
+    }
+    activated = true;
+    return getStatus();
+}
+/**
+ * Deactivate the kbot plugin. Cleans up resources.
+ */
+export function deactivate() {
+    activated = false;
+}
+/**
+ * Check if the plugin is currently activated.
+ */
+export function isActivated() {
+    return activated;
+}
+//# sourceMappingURL=index.js.map

package/dist/plugin/index.js.map

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

package/dist/voice-loop.d.ts

@@ -0,0 +1,59 @@
+export interface VoiceLoopOptions {
+    /** macOS TTS voice name (default: 'Samantha') */
+    voice?: string;
+    /** Whisper model size: 'tiny' | 'base' | 'small' | 'medium' | 'large' (default: 'base') */
+    model?: WhisperModel;
+    /** kbot agent to route to: 'auto' uses agent routing, or specify a specialist (default: 'auto') */
+    agent?: string;
+    /** Language code for Whisper transcription (default: 'en') */
+    language?: string;
+    /** TTS speech rate in words per minute (default: 190) */
+    rate?: number;
+    /** Maximum recording duration in seconds (default: 15) */
+    maxRecordSeconds?: number;
+    /** Silence threshold for recording stop — sox silence detection (default: '1.5') */
+    silenceThreshold?: string;
+    /** Ollama host URL (default: from OLLAMA_HOST env or 'http://localhost:11434') */
+    ollamaHost?: string;
+    /** Ollama model for chat (default: 'gemma3:12b') */
+    ollamaModel?: string;
+    /** OpenAI API key for Whisper fallback (reads from config if not provided) */
+    openaiApiKey?: string;
+}
+export type WhisperModel = 'tiny' | 'base' | 'small' | 'medium' | 'large';
+export interface VoiceLoopState {
+    running: boolean;
+    voice: string;
+    model: WhisperModel;
+    agent: string;
+    language: string;
+    rate: number;
+    maxRecordSeconds: number;
+    silenceThreshold: string;
+    ollamaHost: string;
+    ollamaModel: string;
+    whisperBackend: 'local' | 'api' | 'none';
+    recorder: 'rec' | 'arecord' | 'none';
+    ttsAvailable: boolean;
+    turnCount: number;
+    conversationHistory: Array<{
+        role: 'user' | 'assistant';
+        content: string;
+    }>;
+}
+/**
+ * Run the kbot voice conversation loop.
+ *
+ * 1. Print status banner
+ * 2. Record audio until silence detected (or accept text input)
+ * 3. Transcribe with Whisper (local or API)
+ * 4. Route to Ollama for agent inference
+ * 5. Speak the response with macOS `say`
+ * 6. Loop back to step 2
+ */
+export declare function runVoiceLoop(options?: VoiceLoopOptions): Promise<void>;
+/** Get the current voice loop state description (for diagnostics) */
+export declare function describeVoiceCapabilities(): string;
+/** List available macOS voices */
+export declare function listMacVoices(): string[];
+//# sourceMappingURL=voice-loop.d.ts.map

package/dist/voice-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-loop.d.ts","sourceRoot":"","sources":["../src/voice-loop.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2FAA2F;IAC3F,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,mGAAmG;IACnG,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEzE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,YAAY,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,gBAAgB,EAAE,MAAM,CAAA;IACxB,gBAAgB,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAA;IACxC,QAAQ,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAA;IACpC,YAAY,EAAE,OAAO,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,mBAAmB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC5E;AA2aD;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4I5E;AAMD,qEAAqE;AACrE,wBAAgB,yBAAyB,IAAI,MAAM,CASlD;AAED,kCAAkC;AAClC,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAexC"}