@kernel.chat/kbot 3.36.0 → 3.38.0

package/dist/hooks-integration.js

@@ -0,0 +1,457 @@
+// kbot Hooks Integration — Wire kbot into Claude Code's hook system
+//
+// Claude Code hooks fire at key lifecycle moments. This module generates
+// the hooks configuration for settings.json and dispatches hook events
+// to the right kbot subsystem:
+//
+//   FileChanged    → kbot pair mode analysis
+//   TaskCompleted  → meta-agent observation recording
+//   SessionStart   → load kbot learning context
+//   SessionEnd     → run dream mode consolidation
+//   StopFailure    → log to self-defense incident system
+//
+// Usage:
+//   import { generateHooksConfig, handleHookEvent } from './hooks-integration.js'
+//   const config = generateHooksConfig()       // → JSON for settings.json
+//   await handleHookEvent('FileChanged', { file: 'src/app.ts' })
+import { existsSync, readFileSync } from 'node:fs';
+import { join, extname } from 'node:path';
+import { homedir } from 'node:os';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const KBOT_DIR = join(homedir(), '.kbot');
+/** File extensions that trigger pair mode analysis */
+const ANALYZABLE_EXTENSIONS = new Set([
+    '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
+    '.py', '.rs', '.go', '.java', '.kt', '.swift',
+    '.c', '.cpp', '.h', '.hpp', '.cs',
+    '.rb', '.php', '.vue', '.svelte',
+    '.css', '.scss', '.less',
+    '.json', '.yaml', '.yml', '.toml',
+    '.sql', '.graphql', '.gql',
+    '.sh', '.bash', '.zsh',
+    '.md', '.mdx',
+]);
+/** Paths to ignore for file change analysis */
+const IGNORE_PATTERNS = [
+    'node_modules',
+    'dist',
+    'build',
+    '.git',
+    'coverage',
+    '.next',
+    '.nuxt',
+    '__pycache__',
+    '.cache',
+    'target',
+    'vendor',
+];
+// ---------------------------------------------------------------------------
+// 1. generateHooksConfig
+// ---------------------------------------------------------------------------
+/**
+ * Generate the hooks configuration JSON for Claude Code's settings.json.
+ *
+ * This produces the `hooks` array that should be merged into
+ * `.claude/settings.json` or `~/.claude/settings.json`.
+ *
+ * Each hook calls `kbot hook-dispatch <event>` with context passed via
+ * environment variables.
+ *
+ * @param options.kbotPath - Path to kbot binary (default: 'kbot')
+ * @param options.timeout  - Default timeout in ms (default: 30000)
+ * @returns The hooks section for settings.json
+ */
+export function generateHooksConfig(options) {
+    const kbot = options?.kbotPath ?? 'kbot';
+    const defaultTimeout = options?.timeout ?? 30000;
+    const hooks = [
+        {
+            event: 'FileChanged',
+            command: `${kbot} hook-dispatch FileChanged`,
+            timeout: defaultTimeout,
+            matcher: '**/*.{ts,tsx,js,jsx,py,rs,go,java,rb,swift,c,cpp,css,json,yaml,sh}',
+        },
+        {
+            event: 'TaskCompleted',
+            command: `${kbot} hook-dispatch TaskCompleted`,
+            timeout: 15000,
+        },
+        {
+            event: 'SessionStart',
+            command: `${kbot} hook-dispatch SessionStart`,
+            timeout: 10000,
+        },
+        {
+            event: 'SessionEnd',
+            command: `${kbot} hook-dispatch SessionEnd`,
+            timeout: 60000, // Dream mode can take a while
+        },
+        {
+            event: 'StopFailure',
+            command: `${kbot} hook-dispatch StopFailure`,
+            timeout: 5000,
+        },
+    ];
+    return { hooks };
+}
+// ---------------------------------------------------------------------------
+// 2. handleHookEvent — dispatcher
+// ---------------------------------------------------------------------------
+/**
+ * Dispatch a Claude Code hook event to the appropriate kbot subsystem.
+ *
+ * @param event - The hook event type
+ * @param data  - Event-specific payload
+ * @returns Result of handling the event
+ */
+export async function handleHookEvent(event, data) {
+    const start = Date.now();
+    try {
+        switch (event) {
+            case 'FileChanged':
+                return await handleFileChanged(data, start);
+            case 'TaskCompleted':
+                return await handleTaskCompleted(data, start);
+            case 'SessionStart':
+                return await handleSessionStart(data, start);
+            case 'SessionEnd':
+                return await handleSessionEnd(data, start);
+            case 'StopFailure':
+                return await handleStopFailure(data, start);
+            default: {
+                // Exhaustiveness check
+                const _exhaustive = event;
+                return {
+                    event: _exhaustive,
+                    handled: false,
+                    subsystem: 'unknown',
+                    error: `Unknown hook event: ${String(event)}`,
+                    duration_ms: Date.now() - start,
+                };
+            }
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            event,
+            handled: false,
+            subsystem: 'error',
+            error: message,
+            duration_ms: Date.now() - start,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Event handlers
+// ---------------------------------------------------------------------------
+/**
+ * FileChanged → Trigger kbot pair mode analysis.
+ *
+ * Analyzes the changed file for bugs, type errors, security issues,
+ * and refactoring opportunities using the pair programming module.
+ */
+async function handleFileChanged(data, startTime) {
+    const { file, changeType } = data;
+    // Skip non-analyzable files
+    const ext = extname(file).toLowerCase();
+    if (!ANALYZABLE_EXTENSIONS.has(ext)) {
+        return {
+            event: 'FileChanged',
+            handled: false,
+            subsystem: 'pair',
+            output: `Skipped: ${ext} not in analyzable extensions`,
+            duration_ms: Date.now() - startTime,
+        };
+    }
+    // Skip ignored paths
+    if (IGNORE_PATTERNS.some(p => file.includes(p))) {
+        return {
+            event: 'FileChanged',
+            handled: false,
+            subsystem: 'pair',
+            output: `Skipped: file in ignored path`,
+            duration_ms: Date.now() - startTime,
+        };
+    }
+    // Skip deletions — nothing to analyze
+    if (changeType === 'delete') {
+        return {
+            event: 'FileChanged',
+            handled: false,
+            subsystem: 'pair',
+            output: 'Skipped: file deleted',
+            duration_ms: Date.now() - startTime,
+        };
+    }
+    // Verify file exists
+    if (!existsSync(file)) {
+        return {
+            event: 'FileChanged',
+            handled: false,
+            subsystem: 'pair',
+            output: `Skipped: file does not exist`,
+            duration_ms: Date.now() - startTime,
+        };
+    }
+    // Dynamic import to avoid loading the entire pair module at startup
+    try {
+        const { analyzeWithAgent } = await import('./pair.js');
+        const analysis = await analyzeWithAgent(file, { agent: 'coder' });
+        return {
+            event: 'FileChanged',
+            handled: true,
+            subsystem: 'pair',
+            output: analysis,
+            duration_ms: Date.now() - startTime,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            event: 'FileChanged',
+            handled: false,
+            subsystem: 'pair',
+            error: `Pair analysis failed: ${message}`,
+            duration_ms: Date.now() - startTime,
+        };
+    }
+}
+/**
+ * TaskCompleted → Record observation for meta-agent.
+ *
+ * Every completed task feeds into the meta-agent's observation log,
+ * enabling self-improvement through performance analysis.
+ */
+async function handleTaskCompleted(data, startTime) {
+    try {
+        const { recordObservation } = await import('./meta-agent.js');
+        recordObservation({
+            timestamp: new Date().toISOString(),
+            agent: data.agent || 'unknown',
+            task: data.task || 'unspecified',
+            tools_used: data.tools_used ?? [],
+            success: data.success,
+            duration_ms: data.duration_ms,
+            tokens_in: data.tokens_in ?? 0,
+            tokens_out: data.tokens_out ?? 0,
+            cost: data.cost ?? 0,
+            user_satisfaction: data.success ? 'positive' : 'negative',
+            error: data.error,
+        });
+        return {
+            event: 'TaskCompleted',
+            handled: true,
+            subsystem: 'meta-agent',
+            output: `Recorded observation: ${data.agent}/${data.task} (${data.success ? 'success' : 'failure'})`,
+            duration_ms: Date.now() - startTime,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            event: 'TaskCompleted',
+            handled: false,
+            subsystem: 'meta-agent',
+            error: `Failed to record observation: ${message}`,
+            duration_ms: Date.now() - startTime,
+        };
+    }
+}
+/**
+ * SessionStart → Load kbot learning context.
+ *
+ * Hydrates the learning engine with patterns, solutions, user profile,
+ * and project memory so the session starts with full context.
+ */
+async function handleSessionStart(data, startTime) {
+    try {
+        const { buildFullLearningContext } = await import('./learning.js');
+        // Build learning context for the session's working directory
+        const context = buildFullLearningContext('session-start', // seed message for context retrieval
+        data.cwd);
+        // Also run the kbot session-start lifecycle hook if it exists
+        try {
+            const { runLifecycleHook } = await import('./hooks.js');
+            runLifecycleHook('session-start', data.agent ?? 'auto');
+        }
+        catch {
+            // Non-critical: kbot hooks may not be set up
+        }
+        const contextSize = context.length;
+        const summary = contextSize > 0
+            ? `Loaded learning context (${contextSize} chars)`
+            : 'No learning context available (new project?)';
+        return {
+            event: 'SessionStart',
+            handled: true,
+            subsystem: 'learning',
+            output: summary,
+            duration_ms: Date.now() - startTime,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            event: 'SessionStart',
+            handled: false,
+            subsystem: 'learning',
+            error: `Failed to load learning context: ${message}`,
+            duration_ms: Date.now() - startTime,
+        };
+    }
+}
+/**
+ * SessionEnd → Run dream mode consolidation.
+ *
+ * Triggers kbot's dream mode which:
+ *   - Consolidates short-term memory into long-term patterns
+ *   - Runs meta-agent cycle (analyze performance, propose improvements)
+ *   - Speculatively pre-builds tools for tomorrow's tasks
+ *   - Self-benchmarks against yesterday's performance
+ */
+async function handleSessionEnd(data, startTime) {
+    try {
+        const { runDreamMode } = await import('./dream-mode.js');
+        // Run dream mode with verbose=false (we're in a hook, not interactive)
+        const report = await runDreamMode(false);
+        // Also run the kbot session-end lifecycle hook
+        try {
+            const { runLifecycleHook } = await import('./hooks.js');
+            runLifecycleHook('session-end', data.agent ?? 'auto');
+        }
+        catch {
+            // Non-critical
+        }
+        // Also flush any pending learning writes
+        try {
+            const { flushPendingWrites } = await import('./learning.js');
+            flushPendingWrites();
+        }
+        catch {
+            // Non-critical
+        }
+        const summary = [
+            `Dream mode completed in ${report.duration_ms}ms`,
+            `Phases: ${report.phases_completed}`,
+            `Findings: ${report.total_findings}`,
+            `Actions: ${report.total_actions}`,
+            `Improvements: ${report.total_improvements}`,
+        ].join(', ');
+        return {
+            event: 'SessionEnd',
+            handled: true,
+            subsystem: 'dream-mode',
+            output: summary,
+            duration_ms: Date.now() - startTime,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            event: 'SessionEnd',
+            handled: false,
+            subsystem: 'dream-mode',
+            error: `Dream mode failed: ${message}`,
+            duration_ms: Date.now() - startTime,
+        };
+    }
+}
+/**
+ * StopFailure → Log to self-defense incident system.
+ *
+ * When Claude Code encounters a stop failure (tool rejection, permission
+ * denial, safety filter), kbot logs it as a security incident for
+ * anomaly detection and pattern analysis.
+ */
+async function handleStopFailure(data, startTime) {
+    try {
+        const { logIncident } = await import('./self-defense.js');
+        // Determine severity based on context
+        const severity = determineSeverity(data);
+        logIncident('stop_failure', severity, buildIncidentDescription(data), 'logged');
+        return {
+            event: 'StopFailure',
+            handled: true,
+            subsystem: 'self-defense',
+            output: `Incident logged: ${severity} — ${data.reason.slice(0, 100)}`,
+            duration_ms: Date.now() - startTime,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            event: 'StopFailure',
+            handled: false,
+            subsystem: 'self-defense',
+            error: `Failed to log incident: ${message}`,
+            duration_ms: Date.now() - startTime,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Determine incident severity from stop failure data */
+function determineSeverity(data) {
+    const reason = data.reason.toLowerCase();
+    // High severity: potential security issues
+    if (reason.includes('injection') || reason.includes('malicious') || reason.includes('exploit')) {
+        return 'high';
+    }
+    // Medium severity: permission or safety issues
+    if (reason.includes('permission') || reason.includes('denied') || reason.includes('blocked')) {
+        return 'medium';
+    }
+    // Medium severity: command failures that might indicate attacks
+    if (data.exitCode && data.exitCode > 128) {
+        return 'medium';
+    }
+    // Low severity: general failures
+    return 'low';
+}
+/** Build a descriptive string for the incident log */
+function buildIncidentDescription(data) {
+    const parts = [
+        `Stop failure: ${data.reason}`,
+    ];
+    if (data.command) {
+        parts.push(`Command: ${data.command.slice(0, 200)}`);
+    }
+    if (data.exitCode !== undefined) {
+        parts.push(`Exit code: ${data.exitCode}`);
+    }
+    if (data.stderr) {
+        parts.push(`Stderr: ${data.stderr.slice(0, 300)}`);
+    }
+    return parts.join(' | ');
+}
+// ---------------------------------------------------------------------------
+// Convenience: merge into existing settings.json
+// ---------------------------------------------------------------------------
+/**
+ * Read existing Claude Code settings.json and merge kbot hooks into it.
+ * Returns the merged JSON object. Does not write to disk.
+ *
+ * @param settingsPath - Path to settings.json (default: .claude/settings.json)
+ */
+export function mergeHooksIntoSettings(settingsPath, kbotPath) {
+    const defaultPath = join(process.cwd(), '.claude', 'settings.json');
+    const filePath = settingsPath ?? defaultPath;
+    let existing = {};
+    if (existsSync(filePath)) {
+        try {
+            existing = JSON.parse(readFileSync(filePath, 'utf-8'));
+        }
+        catch {
+            // Start fresh if parse fails
+        }
+    }
+    const hooksConfig = generateHooksConfig({ kbotPath });
+    // Merge: replace any existing hooks array
+    existing['hooks'] = hooksConfig.hooks;
+    return existing;
+}
+//# sourceMappingURL=hooks-integration.js.map

package/dist/hooks-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-integration.js","sourceRoot":"","sources":["../src/hooks-integration.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,EAAE;AACF,yEAAyE;AACzE,uEAAuE;AACvE,+BAA+B;AAC/B,EAAE;AACF,6CAA6C;AAC7C,sDAAsD;AACtD,gDAAgD;AAChD,kDAAkD;AAClD,yDAAyD;AACzD,EAAE;AACF,SAAS;AACT,kFAAkF;AAClF,2EAA2E;AAC3E,iEAAiE;AAEjE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAkFjC,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAA;AAEzC,sDAAsD;AACtD,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC5C,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ;IAC7C,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK;IACjC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS;IAChC,MAAM,EAAE,OAAO,EAAE,OAAO;IACxB,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO;IACjC,MAAM,EAAE,UAAU,EAAE,MAAM;IAC1B,KAAK,EAAE,OAAO,EAAE,MAAM;IACtB,KAAK,EAAE,MAAM;CACd,CAAC,CAAA;AAEF,+CAA+C;AAC/C,MAAM,eAAe,GAAG;IACtB,cAAc;IACd,MAAM;IACN,OAAO;IACP,MAAM;IACN,UAAU;IACV,OAAO;IACP,OAAO;IACP,aAAa;IACb,QAAQ;IACR,QAAQ;IACR,QAAQ;CACT,CAAA;AAED,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAGnC;IACC,MAAM,IAAI,GAAG,OAAO,EAAE,QAAQ,IAAI,MAAM,CAAA;IACxC,MAAM,cAAc,GAAG,OAAO,EAAE,OAAO,IAAI,KAAK,CAAA;IAEhD,MAAM,KAAK,GAAuB;QAChC;YACE,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE,GAAG,IAAI,4BAA4B;YAC5C,OAAO,EAAE,cAAc;YACvB,OAAO,EAAE,oEAAoE;SAC9E;QACD;YACE,KAAK,EAAE,eAAe;YACtB,OAAO,EAAE,GAAG,IAAI,8BAA8B;YAC9C,OAAO,EAAE,KAAK;SACf;QACD;YACE,KAAK,EAAE,cAAc;YACrB,OAAO,EAAE,GAAG,IAAI,6BAA6B;YAC7C,OAAO,EAAE,KAAK;SACf;QACD;YACE,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,GAAG,IAAI,2BAA2B;YAC3C,OAAO,EAAE,KAAK,EAAE,8BAA8B;SAC/C;QACD;YACE,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE,GAAG,IAAI,4BAA4B;YAC5C,OAAO,EAAE,IAAI;SACd;KACF,CAAA;IAED,OAAO,EAAE,KAAK,EAAE,CAAA;AAClB,CAAC;AAED,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAoB,EACpB,IAAmB;IAEnB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAExB,IAAI,CAAC;QACH,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,aAAa;gBAChB,OAAO,MAAM,iBAAiB,CAAC,IAAuB,EAAE,KAAK,CAAC,CAAA;YAEhE,KAAK,eAAe;gBAClB,OAAO,MAAM,mBAAmB,CAAC,IAAyB,EAAE,KAAK,CAAC,CAAA;YAEpE,KAAK,cAAc;gBACjB,OAAO,MAAM,kBAAkB,CAAC,IAAwB,EAAE,KAAK,CAAC,CAAA;YAElE,KAAK,YAAY;gBACf,OAAO,MAAM,gBAAgB,CAAC,IAAsB,EAAE,KAAK,CAAC,CAAA;YAE9D,KAAK,aAAa;gBAChB,OAAO,MAAM,iBAAiB,CAAC,IAAuB,EAAE,KAAK,CAAC,CAAA;YAEhE,OAAO,CAAC,CAAC,CAAC;gBACR,uBAAuB;gBACvB,MAAM,WAAW,GAAU,KAAK,CAAA;gBAChC,OAAO;oBACL,KAAK,EAAE,WAAW;oBAClB,OAAO,EAAE,KAAK;oBACd,SAAS,EAAE,SAAS;oBACpB,KAAK,EAAE,uBAAuB,MAAM,CAAC,KAAK,CAAC,EAAE;oBAC7C,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;iBAChC,CAAA;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAChE,OAAO;YACL,KAAK;YACL,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,OAAO;YAClB,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAChC,CAAA;IACH,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;GAKG;AACH,KAAK,UAAU,iBAAiB,CAC9B,IAAqB,EACrB,SAAiB;IAEjB,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,CAAA;IAEjC,4BAA4B;IAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAA;IACvC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,OAAO;YACL,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,YAAY,GAAG,+BAA+B;YACtD,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACpC,CAAA;IACH,CAAC;IAED,qBAAqB;IACrB,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,OAAO;YACL,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,+BAA+B;YACvC,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACpC,CAAA;IACH,CAAC;IAED,sCAAsC;IACtC,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO;YACL,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,uBAAuB;YAC/B,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACpC,CAAA;IACH,CAAC;IAED,qBAAqB;IACrB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,8BAA8B;YACtC,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACpC,CAAA;IACH,CAAC;IAED,oEAAoE;IACpE,IAAI,CAAC;QACH,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAA;QACtD,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;QAEjE,OAAO;YACL,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACpC,CAAA;IACH,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAChE,OAAO;YACL,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,MAAM;YACjB,KAAK,EAAE,yBAAyB,OAAO,EAAE;YACzC,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACpC,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,mBAAmB,CAChC,IAAuB,EACvB,SAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAA;QAE7D,iBAAiB,CAAC;YAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,SAAS;YAC9B,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,aAAa;YAChC,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE;YACjC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,CAAC;YAC9B,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,CAAC;YAChC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC;YACpB,iBAAiB,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU;YACzD,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAA;QAEF,OAAO;YACL,KAAK,EAAE,eAAe;YACtB,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,YAAY;YACvB,MAAM,EAAE,yBAAyB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,GAAG;YACpG,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACpC,CAAA;IACH,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAChE,OAAO;YACL,KAAK,EAAE,eAAe;YACtB,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,YAAY;YACvB,KAAK,EAAE,iCAAiC,OAAO,EAAE;YACjD,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACpC,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,kBAAkB,CAC/B,IAAsB,EACtB,SAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,EAAE,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAA;QAElE,6DAA6D;QAC7D,MAAM,OAAO,GAAG,wBAAwB,CACtC,eAAe,EAAE,qCAAqC;QACtD,IAAI,CAAC,GAAG,CACT,CAAA;QAED,8DAA8D;QAC9D,IAAI,CAAC;YACH,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAA;YACvD,gBAAgB,CAAC,eAAe,EAAE,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,CAAA;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,6CAA6C;QAC/C,CAAC;QAED,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAA;QAClC,MAAM,OAAO,GAAG,WAAW,GAAG,CAAC;YAC7B,CAAC,CAAC,4BAA4B,WAAW,SAAS;YAClD,CAAC,CAAC,8CAA8C,CAAA;QAElD,OAAO;YACL,KAAK,EAAE,cAAc;YACrB,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,UAAU;YACrB,MAAM,EAAE,OAAO;YACf,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACpC,CAAA;IACH,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAChE,OAAO;YACL,KAAK,EAAE,cAAc;YACrB,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,UAAU;YACrB,KAAK,EAAE,oCAAoC,OAAO,EAAE;YACpD,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACpC,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,UAAU,gBAAgB,CAC7B,IAAoB,EACpB,SAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAA;QAExD,uEAAuE;QACvE,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAA;QAExC,+CAA+C;QAC/C,IAAI,CAAC;YACH,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAA;YACvD,gBAAgB,CAAC,aAAa,EAAE,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,CAAA;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;QAED,yCAAyC;QACzC,IAAI,CAAC;YACH,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAA;YAC5D,kBAAkB,EAAE,CAAA;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;QAED,MAAM,OAAO,GAAG;YACd,2BAA2B,MAAM,CAAC,WAAW,IAAI;YACjD,WAAW,MAAM,CAAC,gBAAgB,EAAE;YACpC,aAAa,MAAM,CAAC,cAAc,EAAE;YACpC,YAAY,MAAM,CAAC,aAAa,EAAE;YAClC,iBAAiB,MAAM,CAAC,kBAAkB,EAAE;SAC7C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEZ,OAAO;YACL,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,YAAY;YACvB,MAAM,EAAE,OAAO;YACf,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACpC,CAAA;IACH,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAChE,OAAO;YACL,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,YAAY;YACvB,KAAK,EAAE,sBAAsB,OAAO,EAAE;YACtC,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACpC,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,iBAAiB,CAC9B,IAAqB,EACrB,SAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAA;QAEzD,sCAAsC;QACtC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;QAExC,WAAW,CACT,cAAc,EACd,QAAQ,EACR,wBAAwB,CAAC,IAAI,CAAC,EAC9B,QAAQ,CACT,CAAA;QAED,OAAO;YACL,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,cAAc;YACzB,MAAM,EAAE,oBAAoB,QAAQ,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;YACrE,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACpC,CAAA;IACH,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAChE,OAAO;YACL,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,cAAc;YACzB,KAAK,EAAE,2BAA2B,OAAO,EAAE;YAC3C,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACpC,CAAA;IACH,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,yDAAyD;AACzD,SAAS,iBAAiB,CAAC,IAAqB;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAA;IAExC,2CAA2C;IAC3C,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/F,OAAO,MAAM,CAAA;IACf,CAAC;IAED,+CAA+C;IAC/C,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7F,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,gEAAgE;IAChE,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,GAAG,GAAG,EAAE,CAAC;QACzC,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,iCAAiC;IACjC,OAAO,KAAK,CAAA;AACd,CAAC;AAED,sDAAsD;AACtD,SAAS,wBAAwB,CAAC,IAAqB;IACrD,MAAM,KAAK,GAAa;QACtB,iBAAiB,IAAI,CAAC,MAAM,EAAE;KAC/B,CAAA;IAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAA;IACtD,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC3C,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAA;IACpD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AAC1B,CAAC;AAED,8EAA8E;AAC9E,iDAAiD;AACjD,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,YAAqB,EACrB,QAAiB;IAEjB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,eAAe,CAAC,CAAA;IACnE,MAAM,QAAQ,GAAG,YAAY,IAAI,WAAW,CAAA;IAE5C,IAAI,QAAQ,GAA4B,EAAE,CAAA;IAE1C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAA4B,CAAA;QACnF,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;QAC/B,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,mBAAmB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;IAErD,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC,KAAK,CAAA;IAErC,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/meta-agent.d.ts

@@ -0,0 +1,62 @@
+interface TaskObservation {
+    timestamp: string;
+    agent: string;
+    task: string;
+    tools_used: string[];
+    success: boolean;
+    duration_ms: number;
+    tokens_in: number;
+    tokens_out: number;
+    cost: number;
+    user_satisfaction?: 'positive' | 'negative' | 'neutral';
+    error?: string;
+}
+interface PerformanceProfile {
+    agent: string;
+    total_tasks: number;
+    success_rate: number;
+    avg_duration_ms: number;
+    avg_cost: number;
+    common_tools: Array<{
+        name: string;
+        frequency: number;
+    }>;
+    failure_patterns: string[];
+    improvement_potential: 'low' | 'medium' | 'high';
+}
+interface Improvement {
+    id: string;
+    timestamp: string;
+    target: 'routing' | 'prompt' | 'tool_selection' | 'fallback' | 'agent_config';
+    agent: string;
+    description: string;
+    before: string;
+    after: string;
+    expected_impact: string;
+    measured_impact?: string;
+    status: 'proposed' | 'applied' | 'measured' | 'reverted';
+}
+interface MetaReport {
+    timestamp: string;
+    observations_analyzed: number;
+    profiles: PerformanceProfile[];
+    improvements_proposed: Improvement[];
+    improvements_applied: Improvement[];
+    cycle_number: number;
+}
+export declare function recordObservation(obs: TaskObservation): void;
+export declare function analyzePerformance(): PerformanceProfile[];
+export declare function proposeImprovements(profiles: PerformanceProfile[]): Improvement[];
+export declare function applyImprovement(improvement: Improvement): boolean;
+export declare function measureImpact(improvementId: string): string;
+export declare function runMetaAgent(): Promise<MetaReport>;
+export declare function getImprovementHistory(): Improvement[];
+export declare function getActiveImprovements(): Improvement[];
+export declare function getMetaStats(): {
+    cycles: number;
+    observations: number;
+    improvements: number;
+    active: number;
+};
+export {};
+//# sourceMappingURL=meta-agent.d.ts.map

package/dist/meta-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-agent.d.ts","sourceRoot":"","sources":["../src/meta-agent.ts"],"names":[],"mappings":"AA6BA,UAAU,eAAe;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,iBAAiB,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAA;IACvD,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,UAAU,kBAAkB;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACxD,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,qBAAqB,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;CACjD;AAED,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,gBAAgB,GAAG,UAAU,GAAG,cAAc,CAAA;IAC7E,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAA;CACzD;AAED,UAAU,UAAU;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,QAAQ,EAAE,kBAAkB,EAAE,CAAA;IAC9B,qBAAqB,EAAE,WAAW,EAAE,CAAA;IACpC,oBAAoB,EAAE,WAAW,EAAE,CAAA;IACnC,YAAY,EAAE,MAAM,CAAA;CACrB;AA0BD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,CAO5D;AAID,wBAAgB,kBAAkB,IAAI,kBAAkB,EAAE,CA0DzD;AAID,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,WAAW,EAAE,CAmDjF;AAID,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAiBlE;AAID,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAwB3D;AAID,wBAAsB,YAAY,IAAI,OAAO,CAAC,UAAU,CAAC,CAyFxD;AAID,wBAAgB,qBAAqB,IAAI,WAAW,EAAE,CAErD;AAED,wBAAgB,qBAAqB,IAAI,WAAW,EAAE,CAGrD;AAED,wBAAgB,YAAY,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAO7G"}