@metabob/minibob 0.1.2

package/dist/memory-agent.js.map

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

package/dist/runtime-mapping.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Runtime Mapping
+ *
+ * Maps runtime behavior (traces) to source code (instructions) to intent (purpose).
+ *
+ * The Three Ideograms:
+ * - VESSEL (Instructional State): Source code, activity templates
+ * - BECOMING (Transient State): Execution traces, function calls
+ * - INSTANCE (Functional State): Running process, outcomes
+ *
+ * This module bridges these states by:
+ * 1. Capturing runtime traces (what happens)
+ * 2. Locating source code (what the code says)
+ * 3. Inferring intent (why the code exists)
+ */
+import type { SourceLocation, InferredIntent } from './vessel-registry';
+export interface TraceToSourceMapping {
+    /** The trace activity ID */
+    traceId: string;
+    /** Function/method that was called */
+    functionName: string;
+    /** Source location if found */
+    sourceLocation?: SourceLocation;
+    /** Inferred intent */
+    intent?: InferredIntent;
+    /** Confidence in the mapping */
+    confidence: number;
+}
+export interface CodebaseAnalysis {
+    /** Root path of the codebase */
+    rootPath: string;
+    /** All functions/methods found */
+    functions: FunctionInfo[];
+    /** All classes found */
+    classes: ClassInfo[];
+    /** Module structure */
+    modules: ModuleInfo[];
+    /** Entry points */
+    entryPoints: string[];
+    /** Comments and docstrings */
+    documentation: DocumentationInfo[];
+}
+export interface FunctionInfo {
+    name: string;
+    file: string;
+    line: number;
+    params: string[];
+    returnType?: string;
+    isAsync: boolean;
+    isExported: boolean;
+    docstring?: string;
+    comments?: string[];
+}
+export interface ClassInfo {
+    name: string;
+    file: string;
+    line: number;
+    methods: FunctionInfo[];
+    properties: string[];
+    extends?: string;
+    implements?: string[];
+    docstring?: string;
+}
+export interface ModuleInfo {
+    name: string;
+    file: string;
+    exports: string[];
+    imports: {
+        from: string;
+        items: string[];
+    }[];
+}
+export interface DocumentationInfo {
+    file: string;
+    line: number;
+    type: 'comment' | 'docstring' | 'jsdoc' | 'inline';
+    content: string;
+    associatedWith?: string;
+}
+/**
+ * Analyze a codebase to extract function/class/module information
+ */
+export declare function analyzeCodebase(rootPath: string): Promise<CodebaseAnalysis>;
+/**
+ * Infer the intent of a function from its name, params, and context
+ */
+export declare function inferIntent(func: FunctionInfo, classes: ClassInfo[], documentation: DocumentationInfo[]): InferredIntent;
+/**
+ * Map a trace's function call to source code location
+ */
+export declare function mapTraceToSource(functionName: string, analysis: CodebaseAnalysis): TraceToSourceMapping;
+export declare const runtimeMapping: {
+    analyzeCodebase: typeof analyzeCodebase;
+    mapTraceToSource: typeof mapTraceToSource;
+    inferIntent: typeof inferIntent;
+};
+//# sourceMappingURL=runtime-mapping.d.ts.map

package/dist/runtime-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-mapping.d.ts","sourceRoot":"","sources":["../src/runtime-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAMvE,MAAM,WAAW,oBAAoB;IACnC,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAA;IACpB,+BAA+B;IAC/B,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,sBAAsB;IACtB,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,kCAAkC;IAClC,SAAS,EAAE,YAAY,EAAE,CAAA;IACzB,wBAAwB;IACxB,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,uBAAuB;IACvB,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,mBAAmB;IACnB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,8BAA8B;IAC9B,aAAa,EAAE,iBAAiB,EAAE,CAAA;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAA;CAC7C;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAA;IAClD,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAMD;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAuEjF;AAuND;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,SAAS,EAAE,EACpB,aAAa,EAAE,iBAAiB,EAAE,GACjC,cAAc,CA4DhB;AAaD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,gBAAgB,GACzB,oBAAoB,CA+CtB;AAMD,eAAO,MAAM,cAAc;;;;CAI1B,CAAA"}

package/dist/search-first-executor.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Search-First Goal Executor
+ *
+ * Implements dynamic step-by-step goal execution:
+ * 1. Decompose goal into steps using LLM
+ * 2. For each step:
+ *    - Search for existing activities that match
+ *    - If match: delegate to existing activity (minimal context)
+ *    - If no match: execute step directly
+ *    - Summarize result
+ *    - Pass summary to next step
+ *
+ * This prevents token accumulation by:
+ * - Using summaries instead of full traces between steps
+ * - Delegating to existing activities with minimal context
+ * - Breaking large goals into focused steps
+ */
+export interface StepValidation {
+    /** Commands to run for validation (exit code 0 = pass) */
+    commands?: string[];
+    /** Files that must exist after execution */
+    requiredFiles?: string[];
+    /** Patterns that must exist in specific files */
+    requiredPatterns?: Array<{
+        file: string;
+        pattern: string;
+    }>;
+    /** Description of what success looks like (for LLM self-validation) */
+    successCriteria?: string;
+}
+export interface GoalStep {
+    id: string;
+    description: string;
+    intent: string;
+    category: "feature" | "bugfix" | "refactor" | "tool" | "infrastructure" | "other";
+    dependencies: string[];
+    /** Validation criteria for this step */
+    validation?: StepValidation;
+}
+export interface StepResult {
+    stepId: string;
+    status: "completed" | "failed" | "skipped";
+    method: "existing_activity" | "direct_execution" | "skipped";
+    activityId?: string;
+    summary: string;
+    error?: string;
+}
+export interface SearchFirstConfig {
+    provider: "anthropic" | "openai";
+    apiKey: string;
+    model: string;
+    workingDirectory: string;
+    maxSteps?: number;
+    maxTokensPerStep?: number;
+}
+export declare class SearchFirstExecutor {
+    private config;
+    private llm;
+    constructor(config: SearchFirstConfig);
+    /**
+     * Decompose a goal into discrete steps using LLM
+     */
+    decomposeGoal(goal: string, context?: Record<string, unknown>): Promise<GoalStep[]>;
+    /**
+     * Search for existing activities that can accomplish a step
+     */
+    searchForActivity(step: GoalStep): Promise<{
+        found: boolean;
+        templateId?: string;
+        score?: number;
+    }>;
+    /**
+     * Execute a step using an existing activity
+     */
+    executeViaActivity(step: GoalStep, templateId: string, previousResults: StepResult[]): Promise<StepResult>;
+    /**
+     * Execute a step directly (no existing activity found)
+     */
+    executeDirect(step: GoalStep, previousResults: StepResult[]): Promise<StepResult>;
+    /**
+     * Summarize a step result to compress context for next step
+     */
+    summarizeResult(step: GoalStep, fullResult: string): Promise<string>;
+    /**
+     * Validate a step's execution result
+     *
+     * Returns { passed: true } if validation passes or no validation specified
+     * Returns { passed: false, reason: string } if validation fails
+     */
+    validateStep(step: GoalStep): Promise<{
+        passed: boolean;
+        reason?: string;
+    }>;
+    /**
+     * Report validation failure to backend to correct metrics
+     *
+     * When an activity reports "completed" but our validation fails,
+     * we need to notify the backend so it can update Thompson Sampling
+     * parameters (increment beta to reduce the activity's score).
+     */
+    private reportValidationFailure;
+    /**
+     * Execute goal using search-first approach
+     */
+    execute(goal: string, context?: Record<string, unknown>): Promise<{
+        goal: string;
+        steps: GoalStep[];
+        results: StepResult[];
+        completed: boolean;
+        summary: string;
+    }>;
+}
+//# sourceMappingURL=search-first-executor.d.ts.map

package/dist/search-first-executor.d.ts.map

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

package/dist/session.d.ts

@@ -0,0 +1,48 @@
+/**
+ * minibob Session Tracker
+ *
+ * Tracks execution sequences across multiple activity executions in a session.
+ * Enables learning of successful activity sequences for goals.
+ */
+import type { ActivityExecution } from "./types";
+export interface SessionExecutionItem {
+    activityId: string;
+    executionId: string;
+    order: number;
+    triggerType: 'goal' | 'nested' | 'boredom' | 'manual';
+    parentExecutionId?: string;
+    success: boolean;
+    durationMs: number;
+    costUsd: number;
+}
+export interface SessionTracker {
+    sessionId: string;
+    goalContext?: string;
+    executions: SessionExecutionItem[];
+    startedAt: number;
+}
+/**
+ * Create a new session for tracking execution sequences
+ */
+export declare function createSession(goalContext?: string): SessionTracker;
+/**
+ * Get existing session by ID
+ */
+export declare function getSession(sessionId: string): SessionTracker | undefined;
+/**
+ * Record an execution in the session
+ */
+export declare function recordExecution(sessionId: string, execution: ActivityExecution, triggerType?: 'goal' | 'nested' | 'boredom' | 'manual', parentExecutionId?: string): void;
+/**
+ * Complete session and report to backend
+ */
+export declare function completeSession(sessionId: string, outcome?: 'success' | 'partial' | 'failure'): Promise<boolean>;
+/**
+ * Get all active sessions
+ */
+export declare function getActiveSessions(): SessionTracker[];
+/**
+ * Clear all sessions (for testing)
+ */
+export declare function clearSessions(): void;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAGhD,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAA;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,oBAAoB,EAAE,CAAA;IAClC,SAAS,EAAE,MAAM,CAAA;CAClB;AAKD;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,cAAc,CAclE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAExE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,iBAAiB,EAC5B,WAAW,GAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAmB,EAChE,iBAAiB,CAAC,EAAE,MAAM,GACzB,IAAI,CAqBN;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,SAAS,GAAG,SAAS,GAAG,SAAqB,GACrD,OAAO,CAAC,OAAO,CAAC,CAgClB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,EAAE,CAEpD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAEpC"}

package/dist/template-extractor.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Template Extractor - Extract activity templates from improvisation traces
+ *
+ * The ribosome pattern: successful improvisation → reusable template
+ */
+import type { ImprovisationTrace } from './improviser';
+import type { ActivityTemplate } from './types';
+export declare function extractTemplateFromImprovisation(trace: ImprovisationTrace): Promise<ActivityTemplate>;
+//# sourceMappingURL=template-extractor.d.ts.map

package/dist/template-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-extractor.d.ts","sourceRoot":"","sources":["../src/template-extractor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAqB,MAAM,cAAc,CAAA;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAgB,MAAM,SAAS,CAAA;AAE7D,wBAAsB,gCAAgC,CACpD,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,gBAAgB,CAAC,CA+C3B"}

package/dist/template-generator.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Template Generator - Create activity templates from execution traces
+ *
+ * This module enables self-development: successful goal executions
+ * are automatically converted into reusable activity templates.
+ */
+import type { ActivityExecution, ActivityTemplate } from "./types";
+/**
+ * Generate activity template from successful execution
+ */
+export declare function assembleTemplateFromExecution(execution: ActivityExecution, templateName: string, category: "feature" | "bugfix" | "refactor" | "tool" | "infrastructure"): ActivityTemplate;
+//# sourceMappingURL=template-generator.d.ts.map

package/dist/template-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-generator.d.ts","sourceRoot":"","sources":["../src/template-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAA8C,MAAM,SAAS,CAAA;AAE9G;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,iBAAiB,EAC5B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,gBAAgB,GACtE,gBAAgB,CAsDlB"}

package/dist/tools.d.ts

@@ -0,0 +1,58 @@
+/**
+ * minibob Built-in Tools
+ *
+ * Minimal set of tools for activity execution and self-development.
+ *
+ * SECURITY: Path validation, command whitelisting, and input sanitization
+ * enforced to prevent command injection and path traversal attacks.
+ */
+import type { ToolDefinition, ToolHandler } from "./types";
+export type { ToolDefinition } from "./types";
+export declare const toolDefinitions: Record<string, ToolDefinition>;
+/**
+ * Options for creating tool handlers
+ */
+export interface ToolHandlerOptions {
+    workingDirectory: string;
+    onActivityExecute?: (templateId: string, variables: Record<string, unknown>, reason?: string) => Promise<unknown>;
+    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;
+    }>;
+    onImpulseCreate?: (impulse: {
+        id: string;
+        type: string;
+        content?: string;
+        budget: number;
+        priority: string;
+    }) => void;
+    /**
+     * Custom domain-specific tools injected by the host application.
+     * Each entry provides a tool definition (for LLM function calling) and a handler.
+     * Custom tools are merged with built-in tools; custom names must not collide with
+     * built-in names (bash, read, write, edit, glob, grep, list, git, activity,
+     * search_activities, create_activity_goal_seeking, impulse_create).
+     */
+    customTools?: Record<string, {
+        definition: ToolDefinition;
+        handler: ToolHandler;
+    }>;
+}
+/**
+ * Create tool handlers with working directory context
+ */
+export declare function createToolHandlers(options: string | ToolHandlerOptions): Record<string, ToolHandler>;
+/**
+ * Get all tool definitions as an array.
+ * @param extraDefinitions Additional tool definitions from custom tools (e.g. Perspective domain tools).
+ */
+export declare function getAllToolDefinitions(extraDefinitions?: ToolDefinition[]): ToolDefinition[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAc,MAAM,SAAS,CAAA;AAGtE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AA0G7C,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAqR1D,CAAA;AAMD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,EAAE,MAAM,CAAA;IACxB,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACjH,kBAAkB,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAA;IAChH,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE;QAC1B,eAAe,EAAE,MAAM,CAAA;QACvB,YAAY,EAAE,MAAM,CAAA;QACpB,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACnC,KAAK,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACrC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IACrH;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,CAAC,CAAA;CACnF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAmepG;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,gBAAgB,CAAC,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAM3F"}