@kernel.chat/kbot 2.21.0 → 2.22.1

package/dist/autopoiesis.d.ts

@@ -0,0 +1,93 @@
+export interface SystemComponent {
+    id: string;
+    name: string;
+    type: 'provider' | 'tool' | 'memory' | 'model' | 'connection';
+    status: 'healthy' | 'degraded' | 'failed' | 'unknown';
+    lastChecked: number;
+    failureCount: number;
+    /** How critical is this component? 0-1 */
+    criticality: number;
+    /** Can the system compensate if this fails? */
+    compensable: boolean;
+    /** What compensates for this component */
+    fallback?: string;
+}
+export interface HealthReport {
+    /** Overall system viability (0-1) */
+    viability: number;
+    /** Components by status */
+    healthy: string[];
+    degraded: string[];
+    failed: string[];
+    /** Self-healing actions taken */
+    healingActions: string[];
+    /** Is the system in a viable state? */
+    isViable: boolean;
+    /** Boundary integrity: are internal/external correctly distinguished? */
+    boundaryIntact: boolean;
+}
+export interface AdaptiveResponse {
+    /** Action taken to maintain viability */
+    action: string;
+    /** Component affected */
+    component: string;
+    /** Was the action successful? */
+    success: boolean;
+    /** New state after action */
+    newStatus: SystemComponent['status'];
+}
+/**
+ * Autopoietic System — self-maintaining operational integrity.
+ *
+ * The system continuously:
+ * 1. Monitors its own components (providers, tools, memory, models)
+ * 2. Detects degradation before failure
+ * 3. Self-heals by activating fallbacks
+ * 4. Maintains its operational boundary
+ *
+ * If viability drops below threshold, it signals for external help
+ * rather than continuing in a degraded state.
+ */
+export declare class AutopoieticSystem {
+    private components;
+    private healingLog;
+    private readonly viabilityThreshold;
+    constructor();
+    /** Register the core components that constitute kbot */
+    private initializeComponents;
+    /**
+     * Report a component's health status.
+     * Called by the agent loop after each operation.
+     */
+    reportHealth(componentId: string, healthy: boolean): void;
+    /**
+     * Attempt self-healing for a degraded or failed component.
+     * Returns the adaptive response taken.
+     */
+    selfHeal(componentId: string): AdaptiveResponse | null;
+    /**
+     * Compute overall system viability.
+     * Weighted average of component health, weighted by criticality.
+     */
+    computeViability(): number;
+    /**
+     * Full health check — assess all components, self-heal if needed.
+     */
+    healthCheck(): HealthReport;
+    /**
+     * Should the agent continue operating, or signal for help?
+     */
+    shouldContinue(): {
+        continue: boolean;
+        reason?: string;
+    };
+    /** Get the healing log */
+    getHealingLog(): AdaptiveResponse[];
+    /** Get a specific component's status */
+    getComponent(id: string): SystemComponent | undefined;
+    /** Register a new component (e.g., when an MCP server connects) */
+    registerComponent(component: Omit<SystemComponent, 'status' | 'lastChecked' | 'failureCount'>): void;
+    /** Reset for new session */
+    reset(): void;
+}
+//# sourceMappingURL=autopoiesis.d.ts.map

package/dist/autopoiesis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autopoiesis.d.ts","sourceRoot":"","sources":["../src/autopoiesis.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,CAAA;IAC7D,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAA;IACrD,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,WAAW,EAAE,OAAO,CAAA;IACpB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAA;IACjB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,iCAAiC;IACjC,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,uCAAuC;IACvC,QAAQ,EAAE,OAAO,CAAA;IACjB,yEAAyE;IACzE,cAAc,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAA;IACd,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAA;IAChB,6BAA6B;IAC7B,SAAS,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAA;CACrC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,UAAU,CAAqC;IACvD,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAM;;IAMzC,wDAAwD;IACxD,OAAO,CAAC,oBAAoB;IAgC5B;;;OAGG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAgBzD;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IA+BtD;;;OAGG;IACH,gBAAgB,IAAI,MAAM;IAiB1B;;OAEG;IACH,WAAW,IAAI,YAAY;IA6C3B;;OAEG;IACH,cAAc,IAAI;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAmBxD,0BAA0B;IAC1B,aAAa,IAAI,gBAAgB,EAAE;IAInC,wCAAwC;IACxC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIrD,mEAAmE;IACnE,iBAAiB,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,aAAa,GAAG,cAAc,CAAC,GAAG,IAAI;IASpG,4BAA4B;IAC5B,KAAK,IAAI,IAAI;CAQd"}

package/dist/autopoiesis.js

@@ -0,0 +1,222 @@
+// K:BOT Autopoiesis — Self-Maintaining System
+//
+// Based on Maturana & Varela's Autopoiesis theory (1972):
+// Living systems are "self-making" — they continuously produce and
+// maintain the components that constitute them. An autopoietic system
+// is organizationally closed but structurally coupled to its environment.
+//
+// For kbot: the agent monitors its own health, detects degradation,
+// self-heals broken components, and maintains its operational boundary.
+// kbot doesn't just run — it actively maintains its ability to run.
+//
+// References:
+//   - Maturana, H.R. & Varela, F.J. (1980). Autopoiesis and Cognition.
+//   - Varela, F.J. (1979). Principles of Biological Autonomy.
+//   - Thompson, E. (2007). Mind in Life: Biology, Phenomenology, and the Sciences of Mind.
+//   - Di Paolo, E.A. (2005). Autopoiesis, adaptivity, teleology, agency.
+/**
+ * Autopoietic System — self-maintaining operational integrity.
+ *
+ * The system continuously:
+ * 1. Monitors its own components (providers, tools, memory, models)
+ * 2. Detects degradation before failure
+ * 3. Self-heals by activating fallbacks
+ * 4. Maintains its operational boundary
+ *
+ * If viability drops below threshold, it signals for external help
+ * rather than continuing in a degraded state.
+ */
+export class AutopoieticSystem {
+    components = new Map();
+    healingLog = [];
+    viabilityThreshold = 0.4;
+    constructor() {
+        this.initializeComponents();
+    }
+    /** Register the core components that constitute kbot */
+    initializeComponents() {
+        const defaults = [
+            // Providers
+            { id: 'anthropic', name: 'Anthropic API', type: 'provider', criticality: 0.9, compensable: true, fallback: 'openai' },
+            { id: 'openai', name: 'OpenAI API', type: 'provider', criticality: 0.7, compensable: true, fallback: 'ollama' },
+            { id: 'ollama', name: 'Ollama (local)', type: 'provider', criticality: 0.5, compensable: true, fallback: 'embedded' },
+            { id: 'embedded', name: 'Embedded llama.cpp', type: 'model', criticality: 0.4, compensable: false },
+            // Core tools
+            { id: 'filesystem', name: 'File System Access', type: 'tool', criticality: 1.0, compensable: false },
+            { id: 'bash', name: 'Shell Execution', type: 'tool', criticality: 0.9, compensable: false },
+            { id: 'git', name: 'Git Operations', type: 'tool', criticality: 0.7, compensable: false },
+            // Memory
+            { id: 'local-memory', name: 'Local Memory (~/.kbot/memory/)', type: 'memory', criticality: 0.6, compensable: true, fallback: 'session-context' },
+            { id: 'session-context', name: 'Session Context', type: 'memory', criticality: 0.8, compensable: false },
+            // External connections
+            { id: 'internet', name: 'Internet Connectivity', type: 'connection', criticality: 0.5, compensable: true, fallback: 'ollama' },
+            { id: 'mcp-servers', name: 'MCP Server Connections', type: 'connection', criticality: 0.3, compensable: true },
+        ];
+        for (const d of defaults) {
+            this.components.set(d.id, {
+                ...d,
+                status: 'unknown',
+                lastChecked: 0,
+                failureCount: 0,
+            });
+        }
+    }
+    /**
+     * Report a component's health status.
+     * Called by the agent loop after each operation.
+     */
+    reportHealth(componentId, healthy) {
+        const comp = this.components.get(componentId);
+        if (!comp)
+            return;
+        comp.lastChecked = Date.now();
+        if (healthy) {
+            comp.status = 'healthy';
+            // Gradually reduce failure count on success
+            comp.failureCount = Math.max(0, comp.failureCount - 1);
+        }
+        else {
+            comp.failureCount++;
+            comp.status = comp.failureCount >= 3 ? 'failed' : 'degraded';
+        }
+    }
+    /**
+     * Attempt self-healing for a degraded or failed component.
+     * Returns the adaptive response taken.
+     */
+    selfHeal(componentId) {
+        const comp = this.components.get(componentId);
+        if (!comp || comp.status === 'healthy')
+            return null;
+        // If compensable, activate fallback
+        if (comp.compensable && comp.fallback) {
+            const fallback = this.components.get(comp.fallback);
+            if (fallback && fallback.status !== 'failed') {
+                const response = {
+                    action: `Activated fallback: ${comp.name} → ${fallback.name}`,
+                    component: componentId,
+                    success: true,
+                    newStatus: 'degraded',
+                };
+                comp.status = 'degraded';
+                this.healingLog.push(response);
+                return response;
+            }
+        }
+        // If not compensable, report inability to self-heal
+        const response = {
+            action: `Cannot self-heal: ${comp.name} has no viable fallback`,
+            component: componentId,
+            success: false,
+            newStatus: comp.status,
+        };
+        this.healingLog.push(response);
+        return response;
+    }
+    /**
+     * Compute overall system viability.
+     * Weighted average of component health, weighted by criticality.
+     */
+    computeViability() {
+        let weightedHealth = 0;
+        let totalWeight = 0;
+        for (const comp of this.components.values()) {
+            const healthScore = comp.status === 'healthy' ? 1.0 :
+                comp.status === 'degraded' ? 0.5 :
+                    comp.status === 'failed' ? 0.0 : 0.3; // unknown
+            weightedHealth += healthScore * comp.criticality;
+            totalWeight += comp.criticality;
+        }
+        return totalWeight > 0 ? weightedHealth / totalWeight : 0;
+    }
+    /**
+     * Full health check — assess all components, self-heal if needed.
+     */
+    healthCheck() {
+        const healthy = [];
+        const degraded = [];
+        const failed = [];
+        const healingActions = [];
+        for (const [id, comp] of this.components) {
+            switch (comp.status) {
+                case 'healthy':
+                    healthy.push(comp.name);
+                    break;
+                case 'degraded':
+                    degraded.push(comp.name);
+                    // Attempt self-healing for degraded components
+                    const healResult = this.selfHeal(id);
+                    if (healResult)
+                        healingActions.push(healResult.action);
+                    break;
+                case 'failed':
+                    failed.push(comp.name);
+                    // Attempt self-healing for failed components
+                    const failHeal = this.selfHeal(id);
+                    if (failHeal)
+                        healingActions.push(failHeal.action);
+                    break;
+            }
+        }
+        const viability = this.computeViability();
+        // Boundary check: are we correctly distinguishing internal from external?
+        const internalOk = ['filesystem', 'session-context'].every(id => {
+            const c = this.components.get(id);
+            return c && c.status !== 'failed';
+        });
+        return {
+            viability,
+            healthy,
+            degraded,
+            failed,
+            healingActions,
+            isViable: viability >= this.viabilityThreshold,
+            boundaryIntact: internalOk,
+        };
+    }
+    /**
+     * Should the agent continue operating, or signal for help?
+     */
+    shouldContinue() {
+        const viability = this.computeViability();
+        if (viability < this.viabilityThreshold) {
+            return {
+                continue: false,
+                reason: `System viability critically low (${(viability * 100).toFixed(0)}%). Core components degraded.`,
+            };
+        }
+        // Check if filesystem is available (absolute requirement)
+        const fs = this.components.get('filesystem');
+        if (fs && fs.status === 'failed') {
+            return { continue: false, reason: 'File system access lost — cannot operate.' };
+        }
+        return { continue: true };
+    }
+    /** Get the healing log */
+    getHealingLog() {
+        return [...this.healingLog];
+    }
+    /** Get a specific component's status */
+    getComponent(id) {
+        return this.components.get(id);
+    }
+    /** Register a new component (e.g., when an MCP server connects) */
+    registerComponent(component) {
+        this.components.set(component.id, {
+            ...component,
+            status: 'unknown',
+            lastChecked: 0,
+            failureCount: 0,
+        });
+    }
+    /** Reset for new session */
+    reset() {
+        for (const comp of this.components.values()) {
+            comp.status = 'unknown';
+            comp.failureCount = 0;
+            comp.lastChecked = 0;
+        }
+        this.healingLog = [];
+    }
+}
+//# sourceMappingURL=autopoiesis.js.map

package/dist/autopoiesis.js.map

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

package/dist/cli.js

@@ -34,7 +34,7 @@ async function main() {
         .name('kbot')
         .description('K:BOT — Open-source terminal AI agent. Bring your own key, pick your model, run locally.')
         .version(VERSION)
-        .option('-a, --agent <agent>', 'Force a specific agent (kernel, researcher, coder, writer, analyst, creative, developer, hacker, operator, dreamer)')
+        .option('-a, --agent <agent>', 'Force a specific agent (run kbot agents to see all 22)')
         .option('-m, --model <model>', 'Override AI model (auto, sonnet, haiku)')
         .option('-s, --stream', 'Stream the response')
         .option('-p, --pipe', 'Pipe mode — raw text output for scripting')
@@ -100,7 +100,7 @@ async function main() {
     });
     program
         .command('byok')
-        .description('Bring Your Own Key — configure your LLM API key (19 providers)')
+        .description('Bring Your Own Key — configure your LLM API key (20 providers)')
         .option('--off', 'Disable BYOK mode')
         .action(async (opts) => {
         if (opts.off) {
@@ -422,7 +422,7 @@ async function main() {
     });
     program
         .command('serve')
-        .description('Start HTTP server — expose all 214 tools for kernel.chat or any client')
+        .description('Start HTTP server — expose all 223 tools for kernel.chat or any client')
         .option('-p, --port <port>', 'Port to listen on', '7437')
         .option('--token <token>', 'Require auth token for all requests')
         .option('--computer-use', 'Enable computer use tools')
@@ -1037,12 +1037,13 @@ async function byokFlow() {
     printInfo('Use your own LLM API key. You pay the provider directly for tokens.');
     printInfo('Kernel routing + tools + collective intelligence are free.');
     console.log();
-    printInfo('Supported providers (14):');
+    printInfo('Supported providers (20):');
     printInfo('  Anthropic (Claude)    OpenAI (GPT)       Google (Gemini)');
     printInfo('  Mistral AI            xAI (Grok)         DeepSeek');
     printInfo('  Groq                  Together AI        Fireworks AI');
     printInfo('  Perplexity            Cohere             NVIDIA NIM');
-    printInfo('  Ollama (local, free)  K:BOT Local (local gateway)');
+    printInfo('  SambaNova             Cerebras           OpenRouter');
+    printInfo('  Ollama (local, free)  LM Studio (local)  Embedded llama.cpp');
     console.log();
     printInfo('Paste your API key (auto-detected by prefix):');
     console.log();
@@ -1097,7 +1098,7 @@ async function byokFlow() {
     console.log();
     printSuccess(`BYOK mode enabled — ${providerConfig.name}`);
     printInfo('You pay the provider directly. No message limits. No restrictions.');
-    printInfo('All 81 tools + 17 agents + learning system = yours.');
+    printInfo('All 223 tools + 22 agents + learning system = yours.');
     console.log();
     printSuccess('Ready. Run `kbot` to start.');
 }
@@ -1342,7 +1343,7 @@ async function startRepl(agentOpts, context, tier, byokActive = false, localActi
         const suggestions = await detectProjectSuggestions();
         console.log();
         console.log(chalk.dim('  ┌─────────────────────────────────────────────────┐'));
-        console.log(chalk.dim('  │') + chalk.bold('  11 agents. 214 tools. Just say what you need.  ') + chalk.dim(' │'));
+        console.log(chalk.dim('  │') + chalk.bold('  22 agents. 223 tools. Just say what you need.  ') + chalk.dim(' │'));
         console.log(chalk.dim('  │                                                 │'));
         if (suggestions.length > 0) {
             for (const s of suggestions.slice(0, 4)) {