@kernel.chat/kbot 3.37.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":"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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