@metabob/minibob 0.1.2

package/dist/improviser.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Goal Improviser - Execute goals without templates
+ *
+ * Pure improvisation: LLM figures out what to do step by step,
+ * using available tools. Everything is recorded for template extraction.
+ */
+import type { ToolResult } from './types';
+export interface ImprovisationStep {
+    step: number;
+    thought: string;
+    action: string;
+    params: Record<string, unknown>;
+    result: ToolResult;
+    duration_ms: number;
+    timestamp: string;
+    cost_estimate: number;
+}
+export interface ImprovisationTrace {
+    execution_id: string;
+    goal: string;
+    improvisation: true;
+    context?: Record<string, unknown>;
+    started_at: string;
+    completed_at?: string;
+    steps: ImprovisationStep[];
+    outcome: {
+        status: 'success' | 'failure' | 'stuck';
+        goal_achieved: boolean;
+        total_duration_ms: number;
+        total_cost: number;
+        total_tokens: {
+            input: number;
+            output: number;
+        };
+        files_modified: string[];
+        files_created: string[];
+        files_deleted: string[];
+        error?: string;
+    };
+}
+export interface ImprovisationConfig {
+    maxSteps?: number;
+    temperature?: number;
+    stuckThreshold?: number;
+    saveTrace?: boolean;
+}
+export interface ImproviserConfig {
+    provider?: string;
+    apiKey?: string;
+    model?: string;
+    workingDirectory: string;
+}
+export declare class GoalImproviser {
+    private llm;
+    private tools;
+    private config;
+    constructor(config: ImproviserConfig);
+    /**
+     * Improvise solution to a goal without pre-defined template
+     */
+    improvise(goal: string, config?: ImprovisationConfig): Promise<ImprovisationTrace>;
+    private buildSystemPrompt;
+    private formatJSONParseError;
+    private parseDecision;
+    private formatToolResult;
+    private isStuck;
+    private extractFilesModified;
+    private extractFilesCreated;
+    private extractFilesDeleted;
+    private estimateCost;
+    private saveTrace;
+    private randomId;
+}
+//# sourceMappingURL=improviser.d.ts.map

package/dist/improviser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improviser.d.ts","sourceRoot":"","sources":["../src/improviser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAe,UAAU,EAA0C,MAAM,SAAS,CAAA;AAQ9F,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,MAAM,EAAE,UAAU,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,IAAI,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,iBAAiB,EAAE,CAAA;IAC1B,OAAO,EAAE;QACP,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;QACvC,aAAa,EAAE,OAAO,CAAA;QACtB,iBAAiB,EAAE,MAAM,CAAA;QACzB,UAAU,EAAE,MAAM,CAAA;QAClB,YAAY,EAAE;YACZ,KAAK,EAAE,MAAM,CAAA;YACb,MAAM,EAAE,MAAM,CAAA;SACf,CAAA;QACD,cAAc,EAAE,MAAM,EAAE,CAAA;QACxB,aAAa,EAAE,MAAM,EAAE,CAAA;QACvB,aAAa,EAAE,MAAM,EAAE,CAAA;QACvB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAMD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,EAAE,gBAAgB;IAUpC;;OAEG;IACG,SAAS,CACb,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,mBAAwB,GAC/B,OAAO,CAAC,kBAAkB,CAAC;IA0N9B,OAAO,CAAC,iBAAiB;IAgCzB,OAAO,CAAC,oBAAoB;IAiD5B,OAAO,CAAC,aAAa;IA0BrB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,YAAY;YAQN,SAAS;IAiHvB,OAAO,CAAC,QAAQ;CAGjB"}

package/dist/impulse-filter.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Impulse Filtering Logic (Phase 1.8)
+ *
+ * Filters impulses based on learned relevance scores to reduce token usage.
+ *
+ * Key concepts:
+ * - relevance_score: P(success | impulse loaded)
+ * - irrelevance_score: P(success | impulse NOT loaded)
+ *
+ * Decision rules:
+ * 1. Always load if relevance_score > 0.8 (strong positive signal)
+ * 2. Load if relevance_score > threshold (default: 0.5)
+ * 3. Skip if irrelevance_score > relevance_score (better without it)
+ * 4. Limit to maxImpulses (default: 10)
+ */
+import type { ImpulseRelevanceMetric } from "./mcp";
+export interface FilterConfig {
+    relevanceThreshold: number;
+    alwaysLoadThreshold: number;
+    maxImpulses: number;
+    fallbackBehavior: 'load-all' | 'load-none' | 'load-top-n';
+}
+/**
+ * Get filter configuration from environment variables
+ */
+export declare function getFilterConfig(): FilterConfig;
+export declare const DEFAULT_FILTER_CONFIG: FilterConfig;
+export interface FilterResult {
+    toLoad: string[];
+    toSkip: string[];
+    reasoning: Record<string, string>;
+}
+/**
+ * Filter impulses based on relevance scores
+ */
+export declare function filterImpulsesByRelevance(impulseIds: string[], metrics: ImpulseRelevanceMetric[], config?: Partial<FilterConfig>): FilterResult;
+export interface TokenSavings {
+    tokensSaved: number;
+    costSaved: number;
+    percentSaved: number;
+    totalTokens: number;
+    loadedTokens: number;
+}
+/**
+ * Calculate token savings from skipped impulses
+ */
+export declare function calculateSavings(skippedImpulses: string[], impulseTokenSizes: Map<string, number>): TokenSavings;
+/**
+ * Estimate token size for an impulse based on pointer type
+ */
+export declare function estimateImpulseTokens(impulse: {
+    id: string;
+    pointer: {
+        type: string;
+        [key: string]: any;
+    };
+}): number;
+export interface FilteringSummary {
+    totalImpulses: number;
+    loadedImpulses: number;
+    skippedImpulses: number;
+    tokensSaved: number;
+    costSaved: number;
+    percentSaved: number;
+    topReasons: Array<{
+        reason: string;
+        count: number;
+    }>;
+}
+/**
+ * Generate filtering summary for logging/reporting
+ */
+export declare function generateFilteringSummary(filterResult: FilterResult, savings: TokenSavings): FilteringSummary;
+//# sourceMappingURL=impulse-filter.d.ts.map

package/dist/impulse-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impulse-filter.d.ts","sourceRoot":"","sources":["../src/impulse-filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,OAAO,CAAA;AAMnD,MAAM,WAAW,YAAY;IAE3B,kBAAkB,EAAE,MAAM,CAAA;IAG1B,mBAAmB,EAAE,MAAM,CAAA;IAG3B,WAAW,EAAE,MAAM,CAAA;IAGnB,gBAAgB,EAAE,UAAU,GAAG,WAAW,GAAG,YAAY,CAAA;CAC1D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAc9C;AAED,eAAO,MAAM,qBAAqB,EAAE,YAKnC,CAAA;AAMD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,EAAE,sBAAsB,EAAE,EACjC,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM,GACjC,YAAY,CAgFd;AAMD,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,eAAe,EAAE,MAAM,EAAE,EACzB,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,YAAY,CAmBd;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAA;QACZ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KACnB,CAAA;CACF,GAAG,MAAM,CAkBT;AAMD,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACrD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,YAAY,GACpB,gBAAgB,CAuBlB"}

package/dist/impulse.d.ts

@@ -0,0 +1,92 @@
+/**
+ * minibob Impulse System
+ *
+ * Minimal impulse implementation for context management.
+ * Supports: memo, file, activityOutput, custom pointer types.
+ */
+import type { Impulse } from "./types";
+/**
+ * In-memory impulse store (can be backed by MCP in production)
+ */
+declare class ImpulseStore {
+    private impulses;
+    private customResolvers;
+    private activityOutputs;
+    /**
+     * Create a new impulse
+     */
+    create(impulse: Omit<Impulse, "loaded" | "createdAt">): Impulse;
+    /**
+     * Get an impulse by ID
+     */
+    get(id: string): Impulse | undefined;
+    /**
+     * Load an impulse (resolve its pointer and populate content)
+     */
+    load(id: string): Promise<Impulse>;
+    /**
+     * Unload an impulse (free memory)
+     */
+    unload(id: string): void;
+    /**
+     * Delete an impulse
+     */
+    delete(id: string): boolean;
+    /**
+     * List all impulses
+     */
+    list(): Impulse[];
+    /**
+     * Register a custom resolver
+     */
+    registerResolver(name: string, resolver: (data: Record<string, unknown>) => Promise<string>): void;
+    /**
+     * Store activity output for activityOutput pointer resolution
+     */
+    storeActivityOutput(activityId: string, taskId: string, output: string): void;
+    /**
+     * Get activity output
+     */
+    getActivityOutput(activityId: string, taskId?: string): string | undefined;
+    /**
+     * Resolve a pointer to content
+     *
+     * Architecture: MiniBob handles LOCAL types (memo, file) directly.
+     * All other types are delegated to backend via MCP.
+     */
+    private resolvePointer;
+    /**
+     * Estimate token count (rough approximation: 4 chars per token)
+     */
+    private estimateTokens;
+}
+/**
+ * Get the impulse store (singleton)
+ */
+export declare function getImpulseStore(): ImpulseStore;
+/**
+ * Create a new impulse
+ */
+export declare function createImpulse(impulse: Omit<Impulse, "loaded" | "createdAt">): Impulse;
+/**
+ * Load an impulse
+ */
+export declare function loadImpulse(id: string): Promise<Impulse>;
+/**
+ * Load multiple impulses
+ */
+export declare function loadImpulses(ids: string[]): Promise<Impulse[]>;
+/**
+ * Format impulses for context injection
+ */
+export declare function formatImpulsesForContext(impulses: Impulse[]): string;
+/**
+ * Register a custom resolver
+ */
+export declare function registerResolver(name: string, resolver: (data: Record<string, unknown>) => Promise<string>): void;
+/**
+ * Store activity output
+ */
+export declare function storeActivityOutput(activityId: string, taskId: string, output: string): void;
+export {};
+//# sourceMappingURL=impulse.d.ts.map

package/dist/impulse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impulse.d.ts","sourceRoot":"","sources":["../src/impulse.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAkB,MAAM,SAAS,CAAA;AAOtD;;GAEG;AACH,cAAM,YAAY;IAChB,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,eAAe,CAAwE;IAC/F,OAAO,CAAC,eAAe,CAAyC;IAEhE;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,WAAW,CAAC,GAAG,OAAO;IAuB/D;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIpC;;OAEG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgCxC;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAYxB;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B;;OAEG;IACH,IAAI,IAAI,OAAO,EAAE;IAIjB;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI;IAIlG;;OAEG;IACH,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAO7E;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAY1E;;;;;OAKG;YACW,cAAc;IA4E5B;;OAEG;IACH,OAAO,CAAC,cAAc;CAGvB;AAQD;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAK9C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,WAAW,CAAC,GAAG,OAAO,CAErF;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE9D;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAEpE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAepE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAEjH;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE5F"}

package/dist/impulse.js

@@ -0,0 +1,234 @@
+/**
+ * minibob Impulse System
+ *
+ * Minimal impulse implementation for context management.
+ * Supports: memo, file, activityOutput, custom pointer types.
+ */
+import { getMCPClient, isMCPEnabled } from "./mcp";
+// =============================================================================
+// IMPULSE STORAGE
+// =============================================================================
+/**
+ * In-memory impulse store (can be backed by MCP in production)
+ */
+class ImpulseStore {
+    impulses = new Map();
+    customResolvers = new Map();
+    activityOutputs = new Map(); // activityId -> taskId -> output
+    /**
+     * Create a new impulse
+     */
+    create(impulse) {
+        const fullImpulse = {
+            ...impulse,
+            loaded: false,
+            createdAt: Date.now(),
+        };
+        this.impulses.set(impulse.id, fullImpulse);
+        // Store in backend if MCP enabled
+        // This enables cross-execution impulse tracking and learning
+        // Data flow: impulse.ts:create() → mcp.ts:storeImpulse() → POST /impulses → backend storage
+        if (isMCPEnabled()) {
+            const mcp = getMCPClient();
+            if (mcp) {
+                mcp.storeImpulse(fullImpulse).catch((err) => {
+                    console.warn(`[Impulse] Failed to store in backend: ${err.message}`);
+                });
+            }
+        }
+        return fullImpulse;
+    }
+    /**
+     * Get an impulse by ID
+     */
+    get(id) {
+        return this.impulses.get(id);
+    }
+    /**
+     * Load an impulse (resolve its pointer and populate content)
+     */
+    async load(id) {
+        const impulse = this.impulses.get(id);
+        if (!impulse) {
+            throw new Error(`Impulse not found: ${id}`);
+        }
+        if (impulse.loaded && impulse.content) {
+            return impulse;
+        }
+        const content = await this.resolvePointer(impulse.pointer);
+        const tokenCount = this.estimateTokens(content);
+        // Truncate if over budget
+        let finalContent = content;
+        if (tokenCount > impulse.budget) {
+            const ratio = impulse.budget / tokenCount;
+            const targetChars = Math.floor(content.length * ratio * 0.9); // 10% safety margin
+            finalContent = content.substring(0, targetChars) + "\n... (truncated to fit budget)";
+        }
+        const loadedImpulse = {
+            ...impulse,
+            loaded: true,
+            content: finalContent,
+            tokenCount: Math.min(tokenCount, impulse.budget),
+        };
+        this.impulses.set(id, loadedImpulse);
+        return loadedImpulse;
+    }
+    /**
+     * Unload an impulse (free memory)
+     */
+    unload(id) {
+        const impulse = this.impulses.get(id);
+        if (impulse) {
+            this.impulses.set(id, {
+                ...impulse,
+                loaded: false,
+                content: undefined,
+                tokenCount: undefined,
+            });
+        }
+    }
+    /**
+     * Delete an impulse
+     */
+    delete(id) {
+        return this.impulses.delete(id);
+    }
+    /**
+     * List all impulses
+     */
+    list() {
+        return Array.from(this.impulses.values());
+    }
+    /**
+     * Register a custom resolver
+     */
+    registerResolver(name, resolver) {
+        this.customResolvers.set(name, resolver);
+    }
+    /**
+     * Store activity output for activityOutput pointer resolution
+     */
+    storeActivityOutput(activityId, taskId, output) {
+        if (!this.activityOutputs.has(activityId)) {
+            this.activityOutputs.set(activityId, new Map());
+        }
+        this.activityOutputs.get(activityId).set(taskId, output);
+    }
+    /**
+     * Get activity output
+     */
+    getActivityOutput(activityId, taskId) {
+        const outputs = this.activityOutputs.get(activityId);
+        if (!outputs)
+            return undefined;
+        if (taskId) {
+            return outputs.get(taskId);
+        }
+        // Return all outputs concatenated
+        return Array.from(outputs.values()).join("\n\n---\n\n");
+    }
+    /**
+     * Resolve a pointer to content
+     */
+    async resolvePointer(pointer) {
+        switch (pointer.type) {
+            case "memo":
+                return pointer.content;
+            case "file": {
+                const file = Bun.file(pointer.path);
+                if (!(await file.exists())) {
+                    throw new Error(`File not found: ${pointer.path}`);
+                }
+                const content = await file.text();
+                const lines = content.split("\n");
+                const offset = pointer.offset ?? 0;
+                const limit = pointer.limit ?? lines.length;
+                return lines.slice(offset, offset + limit).join("\n");
+            }
+            case "activityOutput": {
+                const output = this.getActivityOutput(pointer.activityId, pointer.taskId);
+                if (!output) {
+                    throw new Error(`Activity output not found: ${pointer.activityId}${pointer.taskId ? `/${pointer.taskId}` : ""}`);
+                }
+                return output;
+            }
+            case "custom": {
+                const resolver = this.customResolvers.get(pointer.resolver);
+                if (!resolver) {
+                    throw new Error(`Custom resolver not found: ${pointer.resolver}`);
+                }
+                return await resolver(pointer.data);
+            }
+            default:
+                throw new Error(`Unknown pointer type: ${pointer.type}`);
+        }
+    }
+    /**
+     * Estimate token count (rough approximation: 4 chars per token)
+     */
+    estimateTokens(content) {
+        return Math.ceil(content.length / 4);
+    }
+}
+// =============================================================================
+// IMPULSE MANAGER (Singleton)
+// =============================================================================
+let store = null;
+/**
+ * Get the impulse store (singleton)
+ */
+export function getImpulseStore() {
+    if (!store) {
+        store = new ImpulseStore();
+    }
+    return store;
+}
+/**
+ * Create a new impulse
+ */
+export function createImpulse(impulse) {
+    return getImpulseStore().create(impulse);
+}
+/**
+ * Load an impulse
+ */
+export async function loadImpulse(id) {
+    return getImpulseStore().load(id);
+}
+/**
+ * Load multiple impulses
+ */
+export async function loadImpulses(ids) {
+    return Promise.all(ids.map((id) => loadImpulse(id)));
+}
+/**
+ * Format impulses for context injection
+ */
+export function formatImpulsesForContext(impulses) {
+    if (impulses.length === 0)
+        return "";
+    const formatted = impulses
+        .filter((imp) => imp.loaded && imp.content)
+        .map((imp) => {
+        return `<impulse id="${imp.id}" type="${imp.pointer.type}" tokens="${imp.tokenCount ?? 0}/${imp.budget}">
+${imp.content}
+</impulse>`;
+    })
+        .join("\n\n");
+    return `<impulse_context>
+${formatted}
+</impulse_context>`;
+}
+/**
+ * Register a custom resolver
+ */
+export function registerResolver(name, resolver) {
+    getImpulseStore().registerResolver(name, resolver);
+}
+/**
+ * Store activity output
+ */
+export function storeActivityOutput(activityId, taskId, output) {
+    getImpulseStore().storeActivityOutput(activityId, taskId, output);
+}
+//# sourceMappingURL=impulse.js.map

package/dist/impulse.js.map

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

package/dist/lib.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @metabob/minibob - Library Entry Point
+ *
+ * Public API for using minibob as a library (not CLI).
+ * Import this when using minibob from other applications like metabob-opencode.
+ *
+ * Example:
+ *   import { ActivityExecutor, ImpulseStore } from "@metabob/minibob"
+ */
+export { ActivityExecutor, loadTemplate, loadTemplateFromMCPOrLocal } from "./activity";
+export type { ExecutorConfig, ExecuteOptions } from "./activity";
+export { createImpulse, loadImpulses, formatImpulsesForContext, storeActivityOutput, getImpulseStore, } from "./impulse";
+export { createSession, getSession, recordExecution, completeSession, getActiveSessions, clearSessions, } from "./session";
+export type { SessionTracker, SessionExecutionItem } from "./session";
+export { initializeMCP, getMCPClient, isMCPEnabled, MCPClient } from "./mcp";
+export type { MCPConfig } from "./mcp";
+export { createToolHandlers, getAllToolDefinitions } from "./tools";
+export type { ToolHandlerOptions, ToolDefinition } from "./tools";
+export type { ActivityTemplate, ActivityExecution, ActivityTask, TaskResult, Impulse, ImpulsePointer, Message, ToolHandler, ToolResult, } from "./types";
+export { handleACPRequest } from "./acp";
+export type { ACPServerConfig } from "./acp";
+export { initializeBoredom, startBoredom, markBoredomActivity, type BoredomExecutorConfig, type BoredomTask, type BoredomTaskResult, } from "./boredom";
+export { SessionMemoryAgent } from "./memory-agent";
+export { LifecycleHooks } from "./lifecycle-hooks";
+export { GoalProcessor } from "./goal-processor";
+export type { Goal, ActivityRecommendation, GoalResult } from "./goal-processor";
+export { loadConfig, generateManifest, configSummary } from "./config";
+export type { RuntimeContext } from "./config";
+//# sourceMappingURL=lib.d.ts.map

package/dist/lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAA;AACvF,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAMhE,OAAO,EACL,aAAa,EACb,YAAY,EACZ,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,GAChB,MAAM,WAAW,CAAA;AAMlB,OAAO,EACL,aAAa,EACb,UAAU,EACV,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,aAAa,GACd,MAAM,WAAW,CAAA;AAClB,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAMrE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAC5E,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAMtC,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AACnE,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAMjE,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,OAAO,EACP,cAAc,EACd,OAAO,EACP,WAAW,EACX,UAAU,GACX,MAAM,SAAS,CAAA;AAMhB,OAAO,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAA;AACxC,YAAY,EAAE,eAAe,EAAE,MAAM,OAAO,CAAA;AAM5C,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,WAAW,CAAA;AAkBlB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAMnD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAMlD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,YAAY,EAAE,IAAI,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAMhF,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACtE,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA"}