@metabob/minibob 0.1.2

package/dist/mcp.js

@@ -0,0 +1,292 @@
+/**
+ * minibob MCP Client
+ *
+ * Integrates with Metabob backend for:
+ * - Activity template fetching
+ * - Execution metrics reporting
+ * - Impulse storage/retrieval
+ * - Learning and optimization
+ */
+// =============================================================================
+// MCP CLIENT
+// =============================================================================
+export class MCPClient {
+    endpoint;
+    apiKey;
+    timeout;
+    constructor(config) {
+        this.endpoint = config.endpoint.replace(/\/$/, ""); // Remove trailing slash
+        this.apiKey = config.apiKey;
+        this.timeout = config.timeout ?? 30000;
+    }
+    /**
+     * Fetch activity template by ID
+     */
+    async getActivityTemplate(templateId) {
+        try {
+            const response = await this.request("GET", `/activity-templates/${templateId}`);
+            if (!response.ok) {
+                if (response.status === 404)
+                    return null;
+                throw new Error(`Failed to fetch template: ${response.status} ${response.statusText}`);
+            }
+            const data = await response.json();
+            return data.template ?? null;
+        }
+        catch (error) {
+            console.error(`[MCP] Error fetching template ${templateId}:`, error);
+            return null;
+        }
+    }
+    /**
+     * Search activity templates
+     */
+    async searchActivityTemplates(query) {
+        try {
+            const params = new URLSearchParams();
+            if (query?.category)
+                params.set("category", query.category);
+            if (query?.limit)
+                params.set("limit", String(query.limit));
+            const url = `/activity-templates?${params.toString()}`;
+            const response = await this.request("GET", url);
+            if (!response.ok) {
+                throw new Error(`Failed to search templates: ${response.status}`);
+            }
+            const data = await response.json();
+            return data.templates ?? [];
+        }
+        catch (error) {
+            console.error("[MCP] Error searching templates:", error);
+            return [];
+        }
+    }
+    /**
+     * Register activity template variant
+     * Called when executing a template loaded from local JSON file
+     */
+    async registerTemplate(template) {
+        try {
+            const payload = {
+                variant_id: template.id,
+                activity_id: template.id, // For now, variant_id === activity_id
+                variant_name: template.name,
+                description: template.description,
+                category: template.category,
+                task_steps: template.tasks,
+                scope: "global",
+            };
+            // Omit null/undefined fields (SurrealDB doesn't accept null, needs NONE or omitted)
+            Object.keys(payload).forEach(key => {
+                if (payload[key] === null || payload[key] === undefined) {
+                    delete payload[key];
+                }
+            });
+            const response = await this.request("POST", "/templates", payload);
+            if (!response.ok) {
+                // 409 Conflict means template already exists - that's fine
+                if (response.status === 409) {
+                    console.log(`[MCP] Template ${template.id} already registered`);
+                    return true;
+                }
+                const errorText = await response.text();
+                console.warn(`[MCP] Failed to register template: ${response.status} - ${errorText}`);
+                return false;
+            }
+            console.log(`[MCP] ✓ Template ${template.id} registered successfully`);
+            return true;
+        }
+        catch (error) {
+            console.error("[MCP] Error registering template:", error);
+            return false;
+        }
+    }
+    /**
+     * Report activity execution results
+     */
+    async reportExecution(execution) {
+        try {
+            // Determine first failed task if execution failed
+            const failedTask = execution.taskResults.find((t) => t.status === "failed");
+            const payload = {
+                variant_id: execution.templateId,
+                success: execution.status === "completed",
+                duration_ms: execution.metrics?.duration || 0,
+                cost: execution.metrics?.cost || 0,
+                tokens: {
+                    input: execution.metrics?.totalTokens?.input || 0,
+                    output: execution.metrics?.totalTokens?.output || 0,
+                    cache: 0, // MiniBob doesn't track cache tokens yet
+                },
+            };
+            // Only include optional fields if they have values (SurrealDB doesn't accept null)
+            if (failedTask?.error) {
+                payload.error_message = failedTask.error;
+            }
+            if (failedTask) {
+                payload.error_type = "task_execution_error";
+                payload.failed_task_id = failedTask.taskId;
+            }
+            // Omit empty arrays - SurrealDB will use default [] if field allows it
+            if (execution.impulses && execution.impulses.length > 0) {
+                payload.impulses_used = execution.impulses.map(imp => imp.id);
+            }
+            const response = await this.request("POST", "/executions", payload);
+            if (!response.ok) {
+                const errorText = await response.text();
+                console.warn(`[MCP] Failed to report execution: ${response.status} - ${errorText}`);
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            console.error("[MCP] Error reporting execution:", error);
+            return false;
+        }
+    }
+    /**
+     * Store impulse in backend
+     */
+    async storeImpulse(impulse) {
+        try {
+            const payload = {
+                id: impulse.id,
+                pointer: impulse.pointer,
+                budget: impulse.budget,
+                priority: impulse.priority,
+                tags: impulse.tags,
+                content: impulse.content, // May be omitted if unloaded
+            };
+            const response = await this.request("POST", "/impulses", payload);
+            if (!response.ok) {
+                console.warn(`[MCP] Failed to store impulse: ${response.status}`);
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            console.error("[MCP] Error storing impulse:", error);
+            return false;
+        }
+    }
+    /**
+     * Retrieve impulse from backend
+     */
+    async retrieveImpulse(impulseId) {
+        try {
+            const response = await this.request("GET", `/impulses/${impulseId}`);
+            if (!response.ok) {
+                if (response.status === 404)
+                    return null;
+                throw new Error(`Failed to retrieve impulse: ${response.status}`);
+            }
+            const data = await response.json();
+            return data.impulse ?? null;
+        }
+        catch (error) {
+            console.error(`[MCP] Error retrieving impulse ${impulseId}:`, error);
+            return null;
+        }
+    }
+    /**
+     * Track impulse usage for learning
+     */
+    async trackImpulseUsage(impulseId, context) {
+        try {
+            const response = await this.request("POST", `/impulses/${impulseId}/usage`, context);
+            if (!response.ok) {
+                console.warn(`[MCP] Failed to track impulse usage: ${response.status}`);
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            console.error("[MCP] Error tracking impulse usage:", error);
+            return false;
+        }
+    }
+    /**
+     * Register minibob vessel with backend
+     */
+    async registerVessel(manifest) {
+        try {
+            const response = await this.request("POST", "/vessels", manifest);
+            if (!response.ok) {
+                console.warn(`[MCP] Failed to register vessel: ${response.status}`);
+                return false;
+            }
+            console.log("[MCP] Vessel registered successfully");
+            return true;
+        }
+        catch (error) {
+            console.error("[MCP] Error registering vessel:", error);
+            return false;
+        }
+    }
+    /**
+     * Make HTTP request to MCP backend
+     */
+    async request(method, path, body) {
+        const url = `${this.endpoint}${path}`;
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (this.apiKey) {
+            headers["Authorization"] = `Bearer ${this.apiKey}`;
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                method,
+                headers,
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            return response;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+}
+// =============================================================================
+// SINGLETON MCP CLIENT
+// =============================================================================
+let mcpClient = null;
+/**
+ * Initialize MCP client with backend health check (singleton)
+ *
+ * Checks backend availability before initialization.
+ * Returns null if backend is unreachable, allowing graceful fallback to local mode.
+ *
+ * @param config MCP configuration
+ * @param skipHealthCheck Skip health check (for testing)
+ * @returns MCPClient instance or null if backend unavailable
+ */
+export async function initializeMCP(config, skipHealthCheck = false) {
+    if (!skipHealthCheck) {
+        const { checkBackendHealth } = await import("./environment");
+        const healthy = await checkBackendHealth(config.endpoint);
+        if (!healthy) {
+            console.warn("[MCP] Backend unavailable, using local mode");
+            return null;
+        }
+    }
+    mcpClient = new MCPClient(config);
+    console.log("[MCP] ✓ Client initialized");
+    return mcpClient;
+}
+/**
+ * Get MCP client instance
+ */
+export function getMCPClient() {
+    return mcpClient;
+}
+/**
+ * Check if MCP is enabled
+ */
+export function isMCPEnabled() {
+    return mcpClient !== null;
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/dist/memory-agent.d.ts

@@ -0,0 +1,92 @@
+/**
+ * SessionMemoryAgent - Automatic context preparation for activity execution
+ *
+ * Moved from metabob-opencode to minibob as part of library integration.
+ * This version is simplified to work with minibob's minimal dependencies.
+ *
+ * Design goals:
+ * - Fast analysis (<2s with Claude Haiku)
+ * - Automatic impulse creation based on intent
+ * - Self-contained (no opencode dependencies)
+ */
+import z from "zod";
+export declare namespace SessionMemoryAgent {
+    /**
+     * User intent classification schema
+     */
+    const IntentSchema: z.ZodObject<{
+        type: z.ZodEnum<{
+            refactor: "refactor";
+            other: "other";
+            exploration: "exploration";
+            code_fix: "code_fix";
+            feature_request: "feature_request";
+            question: "question";
+        }>;
+        confidence: z.ZodNumber;
+        reasoning: z.ZodString;
+        suggestedImpulses: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodEnum<{
+                memo: "memo";
+                file: "file";
+                metabobIssue: "metabobIssue";
+                history: "history";
+                bashOutput: "bashOutput";
+            }>;
+            description: z.ZodString;
+            priority: z.ZodEnum<{
+                critical: "critical";
+                high: "high";
+                medium: "medium";
+                low: "low";
+            }>;
+            budget: z.ZodNumber;
+            pointer: z.ZodUnion<readonly [z.ZodObject<{
+                type: z.ZodLiteral<"file">;
+                path: z.ZodString;
+                offset: z.ZodOptional<z.ZodNumber>;
+                limit: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"memo">;
+                content: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"custom">;
+                resolver: z.ZodString;
+                data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strip>]>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    export type Intent = z.infer<typeof IntentSchema>;
+    /**
+     * Configuration for session memory agent
+     */
+    export interface Config {
+        enabled: boolean;
+        timeout: number;
+        model: string;
+        defaultBudget: number;
+        maxImpulses: number;
+    }
+    /**
+     * Analyze user intent from prompt text
+     * Returns intent classification with suggested impulses
+     */
+    export function analyzeIntent(input: {
+        promptText: string;
+        workingDirectory?: string;
+        config?: Partial<Config>;
+    }): Promise<Intent>;
+    /**
+     * Prepare impulses based on intent analysis
+     * Creates impulses in the impulse store
+     */
+    export function prepare(input: {
+        intent: Intent;
+    }): Promise<{
+        impulsesCreated: number;
+        impulseIds: string[];
+    }>;
+    export {};
+}
+//# sourceMappingURL=memory-agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-agent.d.ts","sourceRoot":"","sources":["../src/memory-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,CAAC,MAAM,KAAK,CAAA;AAEnB,yBAAiB,kBAAkB,CAAC;IAClC;;OAEG;IACH,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA8BhB,CAAA;IAEF,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;IAEjD;;OAEG;IACH,MAAM,WAAW,MAAM;QACrB,OAAO,EAAE,OAAO,CAAA;QAChB,OAAO,EAAE,MAAM,CAAA;QACf,KAAK,EAAE,MAAM,CAAA;QACb,aAAa,EAAE,MAAM,CAAA;QACrB,WAAW,EAAE,MAAM,CAAA;KACpB;IAUD;;;OAGG;IACH,gBAAsB,aAAa,CAAC,KAAK,EAAE;QACzC,UAAU,EAAE,MAAM,CAAA;QAClB,gBAAgB,CAAC,EAAE,MAAM,CAAA;QACzB,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;KACzB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsKlB;IAED;;;OAGG;IACH,gBAAsB,OAAO,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAChE,eAAe,EAAE,MAAM,CAAA;QACvB,UAAU,EAAE,MAAM,EAAE,CAAA;KACrB,CAAC,CAyDD;;CACF"}

package/dist/memory-agent.js

@@ -0,0 +1,277 @@
+/**
+ * SessionMemoryAgent - Automatic context preparation for activity execution
+ *
+ * Moved from metabob-opencode to minibob as part of library integration.
+ * This version is simplified to work with minibob's minimal dependencies.
+ *
+ * Design goals:
+ * - Fast analysis (<2s with Claude Haiku)
+ * - Automatic impulse creation based on intent
+ * - Self-contained (no opencode dependencies)
+ */
+import { createAnthropicClient } from "./llm";
+import { createImpulse, getImpulseStore } from "./impulse";
+import z from "zod";
+export var SessionMemoryAgent;
+(function (SessionMemoryAgent) {
+    /**
+     * User intent classification schema
+     */
+    const IntentSchema = z.object({
+        type: z.enum(["code_fix", "feature_request", "question", "refactor", "exploration", "other"]),
+        confidence: z.number().min(0).max(1),
+        reasoning: z.string(),
+        suggestedImpulses: z.array(z.object({
+            id: z.string(),
+            type: z.enum(["file", "metabobIssue", "history", "memo", "bashOutput"]),
+            description: z.string(),
+            priority: z.enum(["critical", "high", "medium", "low"]),
+            budget: z.number().positive(),
+            pointer: z.union([
+                z.object({
+                    type: z.literal("file"),
+                    path: z.string(),
+                    offset: z.number().optional(),
+                    limit: z.number().optional(),
+                }),
+                z.object({
+                    type: z.literal("memo"),
+                    content: z.string(),
+                }),
+                z.object({
+                    type: z.literal("custom"),
+                    resolver: z.string(),
+                    data: z.record(z.string(), z.unknown()),
+                }),
+            ]),
+        })),
+    });
+    const DEFAULT_CONFIG = {
+        enabled: true,
+        timeout: 3000,
+        model: "claude-3-5-haiku-20241022",
+        defaultBudget: 2000,
+        maxImpulses: 5,
+    };
+    /**
+     * Analyze user intent from prompt text
+     * Returns intent classification with suggested impulses
+     */
+    async function analyzeIntent(input) {
+        const cfg = { ...DEFAULT_CONFIG, ...input.config };
+        const start = Date.now();
+        try {
+            console.log("[MemoryAgent] Analyzing intent", {
+                promptLength: input.promptText.length,
+                model: cfg.model,
+                timeout: cfg.timeout,
+            });
+            if (!process.env.ANTHROPIC_API_KEY) {
+                throw new Error("ANTHROPIC_API_KEY environment variable not set");
+            }
+            // Create LLM client
+            const llmClient = createAnthropicClient(process.env.ANTHROPIC_API_KEY);
+            // Build system prompt
+            const systemPrompt = `You are the Session Memory Agent - an intent analyzer for conversational coding assistance.
+
+## Your Role
+
+Analyze user messages to understand their intent and recommend context (impulses) to load.
+You DO NOT execute tasks. You ONLY analyze intent and suggest what context might be helpful.
+
+For trivial messages (greetings, acknowledgments), classify as type="other" with empty suggestedImpulses array.
+
+## Intent Types
+
+- **code_fix**: User reports a bug, error, or unexpected behavior
+- **feature_request**: User wants to add/modify functionality
+- **question**: User asks about code, architecture, or how things work
+- **refactor**: User wants to improve existing code structure
+- **exploration**: User is exploring codebase or investigating
+- **other**: Greetings, acknowledgments, or messages that don't need coding context
+
+## Impulse Types
+
+1. **file**: Specific source files
+   - For code_fix: error file, related tests
+   - For feature_request: files to modify, similar features
+   - For question: files being asked about
+   
+2. **memo**: Inline context notes
+   - For important constraints, requirements, or decisions
+   - Short-term memory across turns
+
+3. **custom**: Custom pointer types for specialized resolvers
+
+## Budget Guidelines
+
+- file: 1500-3000 tokens (depends on file size)
+- memo: 200-500 tokens
+- custom: Varies by resolver
+
+## Priority Guidelines
+
+- **critical**: Must-have for understanding request
+- **high**: Very important for request
+- **medium**: Helpful but not essential
+- **low**: Background context
+
+## Output Format
+
+Return JSON with:
+- type: Intent classification
+- confidence: 0-1 (how confident you are)
+- reasoning: Why you classified this way (1 sentence)
+- suggestedImpulses: Array of recommended impulses (0-${cfg.maxImpulses})
+
+## Examples
+
+**Input**: "Fix the TypeError in calculator.ts"
+**Output**:
+{
+  "type": "code_fix",
+  "confidence": 0.95,
+  "reasoning": "User reports specific error with file reference",
+  "suggestedImpulses": [
+    {
+      "id": "errorFile",
+      "type": "file",
+      "description": "File containing the error",
+      "priority": "high",
+      "budget": 2000,
+      "pointer": { "type": "file", "path": "calculator.ts" }
+    }
+  ]
+}
+
+**Input**: "hi"
+**Output**:
+{
+  "type": "other",
+  "confidence": 1.0,
+  "reasoning": "Simple greeting, no coding context needed",
+  "suggestedImpulses": []
+}
+
+Be conservative with impulses. Quality over quantity. Only suggest what's clearly needed.`;
+            // Call LLM
+            const result = await llmClient.complete({
+                model: cfg.model,
+                messages: [
+                    {
+                        role: "system",
+                        content: systemPrompt + "\n\nIMPORTANT: Return ONLY valid JSON matching this schema. No markdown, no explanations.",
+                    },
+                    {
+                        role: "user",
+                        content: `Analyze this user message and suggest context impulses:\n\n"${input.promptText}"\n\nReturn JSON only.`,
+                    },
+                ],
+                maxTokens: 2000,
+                temperature: 0.2,
+            });
+            // Parse JSON response
+            let intent;
+            try {
+                // Remove markdown code blocks if present
+                let jsonStr = result.content.trim();
+                if (jsonStr.startsWith("```json")) {
+                    jsonStr = jsonStr.slice(7);
+                }
+                if (jsonStr.startsWith("```")) {
+                    jsonStr = jsonStr.slice(3);
+                }
+                if (jsonStr.endsWith("```")) {
+                    jsonStr = jsonStr.slice(0, -3);
+                }
+                const parsed = JSON.parse(jsonStr.trim());
+                intent = IntentSchema.parse(parsed);
+            }
+            catch (parseError) {
+                console.warn("[MemoryAgent] Failed to parse LLM response as JSON", {
+                    error: parseError instanceof Error ? parseError.message : String(parseError),
+                    response: result.content.slice(0, 200),
+                });
+                throw new Error("Failed to parse intent analysis response");
+            }
+            console.log("[MemoryAgent] Analysis complete", {
+                type: intent.type,
+                confidence: intent.confidence,
+                impulseCount: intent.suggestedImpulses.length,
+                elapsed: Date.now() - start,
+            });
+            return intent;
+        }
+        catch (error) {
+            console.warn("[MemoryAgent] Analysis failed, returning fallback", {
+                error: error instanceof Error ? error.message : String(error),
+                elapsed: Date.now() - start,
+            });
+            // Fallback: return "other" with no impulses
+            return {
+                type: "other",
+                confidence: 0,
+                reasoning: "Analysis failed, proceeding without context",
+                suggestedImpulses: [],
+            };
+        }
+    }
+    SessionMemoryAgent.analyzeIntent = analyzeIntent;
+    /**
+     * Prepare impulses based on intent analysis
+     * Creates impulses in the impulse store
+     */
+    async function prepare(input) {
+        const start = Date.now();
+        try {
+            const store = getImpulseStore();
+            let created = 0;
+            const impulseIds = [];
+            // Create impulses from suggestions
+            for (const suggestion of input.intent.suggestedImpulses) {
+                // Check if impulse already exists
+                const existing = store.get(suggestion.id);
+                if (existing) {
+                    console.log("[MemoryAgent] Impulse already exists, skipping", { impulseId: suggestion.id });
+                    continue;
+                }
+                // Create impulse (match Impulse type minus loaded/createdAt)
+                const impulse = createImpulse({
+                    id: suggestion.id,
+                    pointer: suggestion.pointer,
+                    budget: suggestion.budget,
+                    priority: suggestion.priority,
+                    tags: ["memory-agent", `type:${suggestion.type}`],
+                });
+                created++;
+                impulseIds.push(impulse.id);
+                console.log("[MemoryAgent] Impulse created", {
+                    impulseId: impulse.id,
+                    type: suggestion.type,
+                    priority: suggestion.priority,
+                    budget: suggestion.budget,
+                });
+            }
+            console.log("[MemoryAgent] Preparation complete", {
+                created,
+                elapsed: Date.now() - start,
+            });
+            return {
+                impulsesCreated: created,
+                impulseIds,
+            };
+        }
+        catch (error) {
+            console.error("[MemoryAgent] Preparation failed", {
+                error: error instanceof Error ? error.message : String(error),
+                elapsed: Date.now() - start,
+            });
+            return {
+                impulsesCreated: 0,
+                impulseIds: [],
+            };
+        }
+    }
+    SessionMemoryAgent.prepare = prepare;
+})(SessionMemoryAgent || (SessionMemoryAgent = {}));
+//# sourceMappingURL=memory-agent.js.map