@metabob/minibob 0.1.2

package/dist/acp.d.ts

@@ -0,0 +1,62 @@
+/**
+ * minibob ACP Protocol Handler
+ *
+ * Agent Client Protocol support for vessel-to-vessel communication.
+ * Supports both receiving delegated tasks and delegating to other vessels.
+ */
+import type { ACPMessage, ACPDelegateRequest, ACPDelegateResponse } from "./types";
+export interface ACPServerConfig {
+    provider: "anthropic" | "openai";
+    apiKey: string;
+    model: string;
+    workingDirectory: string;
+    systemPrompt?: string;
+}
+/**
+ * ACP session handler for streaming connections
+ */
+export declare class ACPSession {
+    private llm;
+    private toolHandlers;
+    private config;
+    private sessionId;
+    private messages;
+    private toolsUsed;
+    constructor(config: ACPServerConfig, sessionId: string);
+    /**
+     * Handle an incoming ACP message
+     */
+    handleMessage(message: ACPMessage): Promise<ACPMessage[]>;
+    /**
+     * Get tools used in this session
+     */
+    getToolsUsed(): string[];
+    private getDefaultSystemPrompt;
+}
+/**
+ * Handle WebSocket upgrade for ACP streaming
+ */
+export declare function createACPWebSocketHandler(config: ACPServerConfig): {
+    upgrade(request: Request): Response | undefined;
+    websocket: {
+        message(ws: WebSocket & {
+            data: {
+                sessionId?: string;
+            };
+        }, message: string | Buffer): Promise<void>;
+        close(ws: WebSocket & {
+            data: {
+                sessionId?: string;
+            };
+        }): void;
+    };
+};
+/**
+ * Delegate a task to another vessel via ACP
+ */
+export declare function delegateTask(request: ACPDelegateRequest): Promise<ACPDelegateResponse>;
+/**
+ * Handle ACP HTTP POST requests (non-streaming)
+ */
+export declare function handleACPRequest(config: ACPServerConfig, request: Request): Promise<Response>;
+//# sourceMappingURL=acp.d.ts.map

package/dist/acp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp.d.ts","sourceRoot":"","sources":["../src/acp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EAGpB,MAAM,SAAS,CAAA;AAQhB,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,WAAW,GAAG,QAAQ,CAAA;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,gBAAgB,EAAE,MAAM,CAAA;IACxB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,YAAY,CAAuC;IAC3D,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,SAAS,CAAe;gBAEpB,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM;IAOtD;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAqG/D;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB,OAAO,CAAC,sBAAsB;CAK/B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,eAAe;qBAI5C,OAAO,GAAG,QAAQ,GAAG,SAAS;;oBAc3B,SAAS,GAAG;YAAE,IAAI,EAAE;gBAAE,SAAS,CAAC,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,WAAW,MAAM,GAAG,MAAM;kBA8B9E,SAAS,GAAG;YAAE,IAAI,EAAE;gBAAE,SAAS,CAAC,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE;;EAO3D;AAMD;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA8D5F;AA6BD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,QAAQ,CAAC,CAgCnB"}

package/dist/acp.js

@@ -0,0 +1,292 @@
+/**
+ * minibob ACP Protocol Handler
+ *
+ * Agent Client Protocol support for vessel-to-vessel communication.
+ * Supports both receiving delegated tasks and delegating to other vessels.
+ */
+import { createLLMClient } from "./llm";
+import { createToolHandlers, getAllToolDefinitions } from "./tools";
+/**
+ * ACP session handler for streaming connections
+ */
+export class ACPSession {
+    llm;
+    toolHandlers;
+    config;
+    sessionId;
+    messages = [];
+    toolsUsed = [];
+    constructor(config, sessionId) {
+        this.config = config;
+        this.sessionId = sessionId;
+        this.llm = createLLMClient(config.provider, config.apiKey);
+        this.toolHandlers = createToolHandlers(config.workingDirectory);
+    }
+    /**
+     * Handle an incoming ACP message
+     */
+    async handleMessage(message) {
+        const responses = [];
+        switch (message.type) {
+            case "hello":
+                // Respond with our capabilities
+                responses.push({
+                    type: "hello",
+                    version: "1.0",
+                    capabilities: ["prompt", "tool_call"],
+                });
+                break;
+            case "prompt":
+                // Execute the prompt with tools
+                try {
+                    this.messages = message.messages;
+                    // Add system prompt if not present
+                    if (!this.messages.find((m) => m.role === "system")) {
+                        this.messages.unshift({
+                            role: "system",
+                            content: this.config.systemPrompt ?? this.getDefaultSystemPrompt(),
+                        });
+                    }
+                    const result = await this.llm.completeWithTools({
+                        model: this.config.model,
+                        messages: this.messages,
+                        tools: message.tools ?? getAllToolDefinitions(),
+                        maxTokens: 4096,
+                    }, this.toolHandlers);
+                    this.toolsUsed = result.toolsUsed;
+                    responses.push({
+                        type: "response",
+                        sessionId: this.sessionId,
+                        content: result.content,
+                        finishReason: "stop",
+                    });
+                    responses.push({
+                        type: "complete",
+                        sessionId: this.sessionId,
+                        metrics: {
+                            duration: 0, // Would need timing
+                            tokens: { input: result.usage.inputTokens, output: result.usage.outputTokens },
+                        },
+                    });
+                }
+                catch (error) {
+                    responses.push({
+                        type: "error",
+                        sessionId: this.sessionId,
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                }
+                break;
+            case "tool_call":
+                // Execute a tool call
+                try {
+                    const handler = this.toolHandlers[message.name];
+                    let result;
+                    if (!handler) {
+                        result = {
+                            success: false,
+                            error: `Unknown tool: ${message.name}`,
+                        };
+                    }
+                    else {
+                        result = await handler(message.arguments);
+                        this.toolsUsed.push(message.name);
+                    }
+                    responses.push({
+                        type: "tool_result",
+                        sessionId: this.sessionId,
+                        toolCallId: message.toolCallId,
+                        result,
+                    });
+                }
+                catch (error) {
+                    responses.push({
+                        type: "tool_result",
+                        sessionId: this.sessionId,
+                        toolCallId: message.toolCallId,
+                        result: {
+                            success: false,
+                            error: error instanceof Error ? error.message : String(error),
+                        },
+                    });
+                }
+                break;
+        }
+        return responses;
+    }
+    /**
+     * Get tools used in this session
+     */
+    getToolsUsed() {
+        return [...new Set(this.toolsUsed)];
+    }
+    getDefaultSystemPrompt() {
+        return `You are minibob, a minimal vessel for executing delegated tasks.
+You have access to tools for file operations, shell commands, and git.
+Execute the requested task efficiently and report the results.`;
+    }
+}
+/**
+ * Handle WebSocket upgrade for ACP streaming
+ */
+export function createACPWebSocketHandler(config) {
+    const sessions = new Map();
+    return {
+        upgrade(request) {
+            const url = new URL(request.url);
+            if (url.pathname !== "/acp/stream") {
+                return undefined;
+            }
+            const sessionId = `acp_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+            const session = new ACPSession(config, sessionId);
+            sessions.set(sessionId, session);
+            return undefined; // Let Bun handle the upgrade
+        },
+        websocket: {
+            async message(ws, message) {
+                try {
+                    const data = JSON.parse(typeof message === "string" ? message : message.toString());
+                    // Get or create session
+                    let sessionId = ws.data?.sessionId;
+                    if (!sessionId) {
+                        sessionId = `acp_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+                        ws.data = { sessionId };
+                        sessions.set(sessionId, new ACPSession(config, sessionId));
+                    }
+                    const session = sessions.get(sessionId);
+                    if (!session) {
+                        ws.send(JSON.stringify({ type: "error", error: "Session not found" }));
+                        return;
+                    }
+                    const responses = await session.handleMessage(data);
+                    for (const response of responses) {
+                        ws.send(JSON.stringify(response));
+                    }
+                }
+                catch (error) {
+                    ws.send(JSON.stringify({
+                        type: "error",
+                        error: error instanceof Error ? error.message : String(error),
+                    }));
+                }
+            },
+            close(ws) {
+                if (ws.data?.sessionId) {
+                    sessions.delete(ws.data.sessionId);
+                }
+            },
+        },
+    };
+}
+// =============================================================================
+// ACP CLIENT (Delegate to other vessels)
+// =============================================================================
+/**
+ * Delegate a task to another vessel via ACP
+ */
+export async function delegateTask(request) {
+    const startTime = Date.now();
+    const sessionId = `delegate_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+    try {
+        // Parse target URL
+        const targetUrl = parseTargetUrl(request.target);
+        // Connect via HTTP streaming or WebSocket
+        const response = await fetch(targetUrl, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                type: "prompt",
+                sessionId,
+                messages: [
+                    {
+                        role: "user",
+                        content: request.prompt,
+                    },
+                ],
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`ACP request failed: ${response.status}`);
+        }
+        const result = (await response.json());
+        return {
+            success: !result.error,
+            sessionId,
+            response: result.content,
+            toolsUsed: result.toolsUsed,
+            error: result.error,
+            metrics: {
+                duration: Date.now() - startTime,
+                tokens: result.metrics?.tokens ?? { input: 0, output: 0 },
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            sessionId,
+            error: error instanceof Error ? error.message : String(error),
+            metrics: {
+                duration: Date.now() - startTime,
+                tokens: { input: 0, output: 0 },
+            },
+        };
+    }
+}
+/**
+ * Parse ACP target URL
+ */
+function parseTargetUrl(target) {
+    if (target.startsWith("http://") || target.startsWith("https://")) {
+        return target;
+    }
+    if (target.startsWith("docker://")) {
+        const container = target.replace("docker://", "");
+        // For Docker, we'd need to resolve the container IP
+        // For now, assume localhost with a port mapping
+        return `http://${container}:8080/acp`;
+    }
+    if (target.startsWith("tcp://")) {
+        const hostPort = target.replace("tcp://", "");
+        return `http://${hostPort}/acp`;
+    }
+    throw new Error(`Unsupported ACP target: ${target}`);
+}
+// =============================================================================
+// HTTP ENDPOINT HANDLER
+// =============================================================================
+/**
+ * Handle ACP HTTP POST requests (non-streaming)
+ */
+export async function handleACPRequest(config, request) {
+    const sessionId = `http_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+    const session = new ACPSession(config, sessionId);
+    try {
+        const message = (await request.json());
+        const responses = await session.handleMessage(message);
+        // For HTTP, we return the last meaningful response
+        const lastResponse = responses.find((r) => r.type === "response" || r.type === "error");
+        return new Response(JSON.stringify({
+            success: lastResponse?.type === "response",
+            content: lastResponse?.type === "response" ? lastResponse.content : undefined,
+            error: lastResponse?.type === "error" ? lastResponse.error : undefined,
+            toolsUsed: session.getToolsUsed(),
+            sessionId,
+        }), {
+            headers: { "Content-Type": "application/json" },
+        });
+    }
+    catch (error) {
+        return new Response(JSON.stringify({
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+            sessionId,
+        }), {
+            status: 500,
+            headers: { "Content-Type": "application/json" },
+        });
+    }
+}
+//# sourceMappingURL=acp.js.map

package/dist/acp.js.map

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

package/dist/activity.d.ts

@@ -0,0 +1,157 @@
+/**
+ * minibob Activity Executor
+ *
+ * Executes activity templates with impulse injection and tool calling.
+ */
+import type { ActivityTemplate, ActivityExecution, TaskResult, Impulse, ToolResult } from "./types";
+import { type LLMClient } from "./llm";
+import { type ToolHandlerOptions } from "./tools";
+export interface ExecutorConfig {
+    provider: "anthropic" | "openai";
+    apiKey: string;
+    model: string;
+    workingDirectory: string;
+    systemPrompt?: string;
+    onSearchActivities?: (category?: string, verbose?: boolean) => Promise<{
+        count: number;
+        activities: unknown[];
+    }>;
+    onCreateActivity?: (params: {
+        goalDescription: string;
+        templateName: string;
+        category: string;
+        variables: Record<string, unknown>;
+    }) => Promise<{
+        templateId: string;
+    }>;
+    /**
+     * Callback when an activity is executed (for composition tracking)
+     */
+    onActivityExecute?: (templateId: string, variables: Record<string, unknown>, reason?: string) => Promise<ActivityExecution>;
+    /**
+     * Custom domain-specific tools to expose to the LLM in addition to built-in tools.
+     * The host application (e.g. PerspectiveMinibobAdapter) injects these so that
+     * activity templates can call Perspective-specific database / API operations.
+     */
+    customTools?: ToolHandlerOptions["customTools"];
+    /**
+     * Maximum nesting depth for nested activity execution.
+     * Prevents runaway recursion when activities call other activities.
+     * Default: 3
+     */
+    maxNestingDepth?: number;
+    /**
+     * Activity call stack for cycle detection.
+     * Tracks the chain of activity IDs from root to current execution.
+     * Used to detect and prevent circular activity calls (A → B → A).
+     *
+     * Example: ["process-goal", "explore-codebase", "read-file"]
+     *
+     * Internal use only - populated automatically during composition.
+     */
+    activityCallStack?: string[];
+}
+export interface ExecuteOptions {
+    template: ActivityTemplate;
+    variables: Record<string, unknown>;
+    reason?: string;
+    impulses?: Impulse[];
+    onTaskStart?: (taskId: string) => void;
+    onTaskComplete?: (taskId: string, result: TaskResult) => void;
+    parentActivityId?: string;
+    parentExecutionId?: string;
+    goalContext?: string;
+}
+/**
+ * Activity executor for running activity templates
+ */
+export declare class ActivityExecutor {
+    private llm;
+    private toolHandlers;
+    private config;
+    private customToolDefinitions;
+    private currentActivityId?;
+    private currentExecutionId?;
+    private currentGoalContext?;
+    private toolCallRecords;
+    /** Public accessor for LLM client (needed by GoalProcessor for improvisation fallback) */
+    get llmClient(): LLMClient;
+    constructor(config: ExecutorConfig);
+    /**
+     * Execute an activity template
+     */
+    execute(options: ExecuteOptions): Promise<ActivityExecution>;
+    /**
+     * Get current executor state for TUI display
+     * Returns real-time information about what MiniBob is doing
+     */
+    getState(): {
+        currentActivityId: string | undefined;
+        currentExecutionId: string | undefined;
+        currentGoalContext: string | undefined;
+        toolCallRecords: Array<{
+            toolName: string;
+            params: any;
+            result: ToolResult;
+            timestamp: number;
+        }>;
+        workingDirectory: string;
+    };
+    /**
+     * Create impulses from template context requirements
+     */
+    private createImpulsesFromRequirements;
+    /**
+     * Execute a single task
+     */
+    private executeTask;
+    /**
+     * Phase 1.8: Record impulse relevance metrics to backend
+     */
+    private recordImpulseRelevance;
+    /**
+     * Run validation checks
+     */
+    private runValidation;
+    /**
+     * Topological sort for task dependencies
+     */
+    private topologicalSort;
+    /**
+     * Interpolate variables into template string
+     */
+    private interpolate;
+    /**
+     * Estimate cost based on token usage
+     */
+    private estimateCost;
+    /**
+     * Get default system prompt
+     *
+     * ARCHITECTURE: Enforces activity-first constraint per corrected trailblazing architecture.
+     * MiniBob must search for existing activities and create new ones for non-trivial tasks.
+     */
+    private getDefaultSystemPrompt;
+}
+/**
+ * Load an activity template from a JSON file
+ */
+export declare function loadTemplate(path: string): Promise<ActivityTemplate>;
+/**
+ * Load activity template from MCP backend or local file
+ *
+ * If templateIdOrPath looks like a file path (contains / or .json), load from file.
+ * Otherwise, try to load from MCP backend first, then fall back to local templates/ directory.
+ */
+export declare function loadTemplateFromMCPOrLocal(templateIdOrPath: string): Promise<ActivityTemplate>;
+/**
+ * Create executor and run activity
+ */
+export declare function runActivity(config: ExecutorConfig, templatePath: string, variables: Record<string, unknown>, reason?: string): Promise<ActivityExecution>;
+/**
+ * Format execution duration in human-readable format
+ * @param ms - Duration in milliseconds
+ * @returns Formatted string (e.g., "1.2s" or "345ms")
+ */
+export declare function formatDuration(ms: number): string;
+//# sourceMappingURL=activity.d.ts.map

package/dist/activity.d.ts.map

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