@kernel.chat/kbot 3.11.0 → 3.13.0

package/dist/integrations/openclaw/plugin.d.ts

@@ -0,0 +1,22 @@
+interface PluginApi {
+    registerTool(tool: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+        execute: (id: string, params: Record<string, unknown>) => Promise<{
+            content: Array<{
+                type: string;
+                text: string;
+            }>;
+        }>;
+    }): void;
+}
+interface KbotConfig {
+    port?: number;
+    host?: string;
+    agent?: string;
+    token?: string;
+}
+export declare function register(api: PluginApi, config?: KbotConfig): void;
+export {};
+//# sourceMappingURL=plugin.d.ts.map

package/dist/integrations/openclaw/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/integrations/openclaw/plugin.ts"],"names":[],"mappings":"AAQA,UAAU,SAAS;IACjB,YAAY,CAAC,IAAI,EAAE;QACjB,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,EAAE,MAAM,CAAA;QACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACnC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;YAAE,OAAO,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC,CAAA;KACtH,GAAG,IAAI,CAAA;CACT;AAED,UAAU,UAAU;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAoCD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,GAAE,UAAe,GAAG,IAAI,CA6GtE"}

package/dist/integrations/openclaw/plugin.js

@@ -0,0 +1,132 @@
+// kbot OpenClaw Plugin
+//
+// Registers kbot's cognitive stack as native OpenClaw tools.
+// Requires kbot serve running on the configured port.
+//
+// Install: openclaw plugins install @kernel.chat/kbot
+// Or copy this directory to ~/.openclaw/extensions/kbot/
+function getBaseUrl(config) {
+    const host = config.host || 'http://localhost';
+    const port = config.port || 7437;
+    return `${host}:${port}`;
+}
+async function kbotFetch(config, path, options) {
+    const url = `${getBaseUrl(config)}${path}`;
+    const headers = { 'Content-Type': 'application/json' };
+    if (config.token) {
+        headers['Authorization'] = `Bearer ${config.token}`;
+    }
+    const response = await fetch(url, {
+        method: options?.method || 'GET',
+        headers,
+        body: options?.body ? JSON.stringify(options.body) : undefined,
+    });
+    if (!response.ok) {
+        throw new Error(`kbot error: ${response.status} ${response.statusText}`);
+    }
+    return response.json();
+}
+function textResult(text) {
+    return { content: [{ type: 'text', text }] };
+}
+export function register(api, config = {}) {
+    // ── kbot_chat: Full agent loop ──
+    api.registerTool({
+        name: 'kbot_chat',
+        description: 'Send a message to kbot\'s cognitive engine. Routes to the best specialist agent (coder, researcher, writer, analyst, guardian, etc.). Learns from every interaction. Use for complex tasks that need multi-step reasoning and tool use.',
+        parameters: {
+            type: 'object',
+            properties: {
+                message: { type: 'string', description: 'The message or task to send to kbot' },
+                agent: {
+                    type: 'string',
+                    description: 'Specialist agent to use. Default: auto (kbot picks the best one)',
+                    enum: [
+                        'auto', 'kernel', 'coder', 'researcher', 'writer', 'analyst',
+                        'aesthete', 'guardian', 'curator', 'strategist', 'infrastructure',
+                        'quant', 'investigator', 'oracle', 'chronist', 'sage',
+                        'communicator', 'adapter', 'replit',
+                    ],
+                },
+            },
+            required: ['message'],
+        },
+        execute: async (_id, params) => {
+            const result = await kbotFetch(config, '/stream', {
+                method: 'POST',
+                body: {
+                    message: params.message,
+                    agent: params.agent || config.agent || 'auto',
+                },
+            });
+            return textResult(result.content || result.error || 'No response');
+        },
+    });
+    // ── kbot_tool: Execute a specific tool ──
+    api.registerTool({
+        name: 'kbot_tool',
+        description: 'Execute one of kbot\'s 290 built-in tools directly. Use for specific operations like web search, file read/write, git operations, etc. Use kbot_tools_list to see available tools.',
+        parameters: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Tool name (e.g., web_search, read_file, bash)' },
+                args: { type: 'object', description: 'Tool arguments as key-value pairs' },
+            },
+            required: ['name'],
+        },
+        execute: async (_id, params) => {
+            const result = await kbotFetch(config, '/execute', {
+                method: 'POST',
+                body: { name: params.name, args: params.args || {} },
+            });
+            return textResult(result.result || result.error || 'No result');
+        },
+    });
+    // ── kbot_tools_list: Discover available tools ──
+    api.registerTool({
+        name: 'kbot_tools_list',
+        description: 'List all tools available in kbot. Returns tool names and descriptions. Use to discover what kbot can do before calling kbot_tool.',
+        parameters: {
+            type: 'object',
+            properties: {
+                filter: { type: 'string', description: 'Optional keyword to filter tools by name or description' },
+            },
+        },
+        execute: async (_id, params) => {
+            const tools = await kbotFetch(config, '/tools');
+            let filtered = tools;
+            if (params.filter) {
+                const query = params.filter.toLowerCase();
+                filtered = tools.filter((t) => t.name.toLowerCase().includes(query) || t.description.toLowerCase().includes(query));
+            }
+            const list = filtered.map((t) => `${t.name} — ${t.description}`).join('\n');
+            return textResult(list || 'No tools found');
+        },
+    });
+    // ── kbot_health: Check kbot status ──
+    api.registerTool({
+        name: 'kbot_health',
+        description: 'Check if kbot\'s cognitive engine is running and healthy. Returns version, tool count, and uptime.',
+        parameters: { type: 'object', properties: {} },
+        execute: async () => {
+            try {
+                const health = await kbotFetch(config, '/health');
+                return textResult(JSON.stringify(health, null, 2));
+            }
+            catch (err) {
+                return textResult(`kbot is not running. Start it with: kbot serve --port ${config.port || 7437}\n\nError: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        },
+    });
+    // ── kbot_metrics: Tool execution metrics ──
+    api.registerTool({
+        name: 'kbot_metrics',
+        description: 'Get execution metrics for kbot\'s tools — call counts, error rates, average duration. Useful for understanding which tools are being used and how they perform.',
+        parameters: { type: 'object', properties: {} },
+        execute: async () => {
+            const metrics = await kbotFetch(config, '/metrics');
+            return textResult(JSON.stringify(metrics, null, 2));
+        },
+    });
+}
+//# sourceMappingURL=plugin.js.map

package/dist/integrations/openclaw/plugin.js.map

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

package/dist/interference.d.ts

@@ -0,0 +1,208 @@
+/** All 11 cognitive modules in the kbot cognitive architecture */
+export type CognitiveModule = 'free-energy' | 'predictive-processing' | 'strange-loops' | 'integrated-information' | 'autopoiesis' | 'quality-diversity' | 'skill-rating' | 'tree-planner' | 'prompt-evolution' | 'memory-synthesis' | 'reflection';
+/** How two module signals combine */
+export type InterferenceType = 'CONSTRUCTIVE' | 'DESTRUCTIVE' | 'NEUTRAL';
+/** Outcome of the interference resolution */
+export type InterferenceOutcome = 'success' | 'failure' | 'pending';
+/** A single interference event between two cognitive modules */
+export interface InterferenceEvent {
+    /** Unique event identifier */
+    id: string;
+    /** ISO timestamp of the event */
+    timestamp: string;
+    /** First module involved */
+    moduleA: CognitiveModule;
+    /** Second module involved */
+    moduleB: CognitiveModule;
+    /** How the signals combined */
+    type: InterferenceType;
+    /** Free-form description of what triggered the interference */
+    context: string;
+    /** Which module's signal was ultimately followed */
+    resolution: CognitiveModule;
+    /** Whether following that module led to a good outcome */
+    outcome: InterferenceOutcome;
+}
+/** A known tension or synergy between two modules */
+export interface KnownInteraction {
+    moduleA: CognitiveModule;
+    moduleB: CognitiveModule;
+    description: string;
+}
+/** Aggregate statistics for a module pair */
+export interface PairStats {
+    moduleA: CognitiveModule;
+    moduleB: CognitiveModule;
+    total: number;
+    constructive: number;
+    destructive: number;
+    neutral: number;
+    /** How often moduleA was the resolution winner */
+    aWins: number;
+    /** How often moduleB was the resolution winner */
+    bWins: number;
+    /** Success rate when moduleA wins */
+    aWinSuccessRate: number;
+    /** Success rate when moduleB wins */
+    bWinSuccessRate: number;
+    /** Overall conflict rate (destructive / total) */
+    conflictRate: number;
+}
+/** Full interference state persisted to disk */
+export interface InterferenceState {
+    events: InterferenceEvent[];
+    /** ISO timestamp of last event */
+    lastUpdated: string;
+}
+/** All cognitive module identifiers for validation */
+export declare const ALL_MODULES: CognitiveModule[];
+export declare const KNOWN_TENSIONS: KnownInteraction[];
+export declare const KNOWN_SYNERGIES: KnownInteraction[];
+/**
+ * Classify how two module signals interfere based on their output values.
+ *
+ * - Same sign (both positive or both negative) = CONSTRUCTIVE
+ *   (both modules agree on direction)
+ * - Opposite signs = DESTRUCTIVE
+ *   (modules disagree — one says go, the other says stop)
+ * - Either signal near zero = NEUTRAL
+ *   (one module is inactive or indifferent)
+ *
+ * @param signalA - Numeric output from module A (positive = activate, negative = inhibit)
+ * @param signalB - Numeric output from module B
+ * @returns The interference type
+ */
+export declare function classifyInterference(signalA: number, signalB: number): InterferenceType;
+/**
+ * Validate that a string is a valid CognitiveModule.
+ */
+export declare function isValidModule(id: string): id is CognitiveModule;
+/**
+ * Record an interference event between two cognitive modules.
+ *
+ * @param moduleA - First module in the interference
+ * @param moduleB - Second module (order doesn't matter for stats)
+ * @param type - CONSTRUCTIVE, DESTRUCTIVE, or NEUTRAL
+ * @param context - Free-form description of what triggered this
+ * @param resolution - Which module was ultimately followed
+ * @param outcome - Whether following that module led to success
+ * @returns The recorded event
+ */
+export declare function recordInterference(moduleA: CognitiveModule, moduleB: CognitiveModule, type: InterferenceType, context: string, resolution: CognitiveModule, outcome?: InterferenceOutcome): InterferenceEvent;
+/**
+ * Record an interference by classifying signals automatically.
+ * Convenience wrapper around classifyInterference + recordInterference.
+ */
+export declare function recordSignalInterference(moduleA: CognitiveModule, signalA: number, moduleB: CognitiveModule, signalB: number, context: string, resolution: CognitiveModule, outcome?: InterferenceOutcome): InterferenceEvent;
+/**
+ * Update the outcome of a pending interference event.
+ * Called after the resolution's result is known.
+ *
+ * @param eventId - The event to update
+ * @param outcome - The actual outcome
+ * @returns true if the event was found and updated, false otherwise
+ */
+export declare function resolveInterference(eventId: string, outcome: InterferenceOutcome): boolean;
+/**
+ * Check if two modules have a known tension.
+ * Returns the tension description or null.
+ */
+export declare function getKnownTension(moduleA: CognitiveModule, moduleB: CognitiveModule): string | null;
+/**
+ * Check if two modules have a known synergy.
+ * Returns the synergy description or null.
+ */
+export declare function getKnownSynergy(moduleA: CognitiveModule, moduleB: CognitiveModule): string | null;
+/**
+ * Get all known tensions for a specific module.
+ */
+export declare function getTensionsFor(module: CognitiveModule): KnownInteraction[];
+/**
+ * Get all known synergies for a specific module.
+ */
+export declare function getSynergiesFor(module: CognitiveModule): KnownInteraction[];
+/**
+ * Get the conflict rate (destructive / total) for a specific module pair.
+ * Returns 0 if no events exist for the pair.
+ */
+export declare function getConflictRate(moduleA: CognitiveModule, moduleB: CognitiveModule): number;
+/**
+ * Get interference statistics for all module pairs that have events.
+ * Returns an array of PairStats, sorted by total events descending.
+ */
+export declare function getInterferenceStats(): PairStats[];
+/**
+ * Get statistics for a single module — how often it is involved
+ * in interference, and its win/success rates.
+ */
+export declare function getModuleStats(module: CognitiveModule): {
+    totalEvents: number;
+    asModuleA: number;
+    asModuleB: number;
+    timesWon: number;
+    winSuccessRate: number;
+    topPartner: CognitiveModule | null;
+    dominantType: InterferenceType;
+};
+/**
+ * Generate a formatted interference report string for the daemon.
+ * Includes:
+ *   - Total event count and time range
+ *   - Top conflicting pairs
+ *   - Top synergistic pairs
+ *   - Known tensions with observed conflict rates
+ *   - Recommendations based on resolution success rates
+ */
+export declare function getInterferenceReport(): string;
+/**
+ * Get all interference events, optionally filtered.
+ */
+export declare function getEvents(filter?: {
+    module?: CognitiveModule;
+    type?: InterferenceType;
+    outcome?: InterferenceOutcome;
+    since?: string;
+    limit?: number;
+}): InterferenceEvent[];
+/**
+ * Get the most recent interference events (for dashboard display).
+ */
+export declare function getRecentEvents(count?: number): InterferenceEvent[];
+/**
+ * Count total recorded interference events.
+ */
+export declare function getEventCount(): number;
+/**
+ * Clear all interference events. Use with caution — this is destructive.
+ * Returns the number of events that were cleared.
+ */
+export declare function clearEvents(): number;
+/**
+ * Predict the likely interference type for a module pair based on
+ * historical data and known interactions.
+ *
+ * Returns a prediction with confidence, or null if insufficient data.
+ */
+export declare function predictInterference(moduleA: CognitiveModule, moduleB: CognitiveModule): {
+    predicted: InterferenceType;
+    confidence: number;
+    basis: string;
+} | null;
+/**
+ * Suggest which module to follow when two modules conflict,
+ * based on historical win/success rates.
+ *
+ * Returns the recommended module and the basis for the recommendation,
+ * or null if insufficient data.
+ */
+export declare function suggestResolution(moduleA: CognitiveModule, moduleB: CognitiveModule): {
+    recommended: CognitiveModule;
+    confidence: number;
+    reason: string;
+} | null;
+/**
+ * Generate a compact interference summary suitable for system prompt injection.
+ * Returns empty string if no meaningful patterns exist.
+ */
+export declare function getInterferenceSummary(): string;
+//# sourceMappingURL=interference.d.ts.map

package/dist/interference.d.ts.map

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