@metabob/minibob 0.1.2

package/src/lib.ts

@@ -0,0 +1,147 @@
+/**
+ * @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"
+ */
+
+// =============================================================================
+// ACTIVITY EXECUTION
+// =============================================================================
+
+export { ActivityExecutor, loadTemplate, loadTemplateFromMCPOrLocal } from "./activity"
+export type { ExecutorConfig, ExecuteOptions } from "./activity"
+
+// =============================================================================
+// IMPULSE SYSTEM
+// =============================================================================
+
+export {
+  createImpulse,
+  loadImpulses,
+  formatImpulsesForContext,
+  storeActivityOutput,
+  getImpulseStore,
+} from "./impulse"
+
+// =============================================================================
+// SESSION TRACKING
+// =============================================================================
+
+export {
+  createSession,
+  getSession,
+  recordExecution,
+  completeSession,
+  getActiveSessions,
+  clearSessions,
+} from "./session"
+export type { SessionTracker, SessionExecutionItem } from "./session"
+
+// =============================================================================
+// MCP CLIENT
+// =============================================================================
+
+export { initializeMCP, getMCPClient, isMCPEnabled, MCPClient } from "./mcp"
+export type { MCPConfig } from "./mcp"
+
+// =============================================================================
+// TOOLS
+// =============================================================================
+
+export { createToolHandlers, getAllToolDefinitions } from "./tools"
+export type { ToolHandlerOptions, ToolDefinition } from "./tools"
+
+// =============================================================================
+// TYPES
+// =============================================================================
+
+export type {
+  ActivityTemplate,
+  ActivityExecution,
+  ActivityTask,
+  TaskResult,
+  Impulse,
+  ImpulsePointer,
+  Message,
+  ToolHandler,
+  ToolResult,
+} from "./types"
+
+// =============================================================================
+// ACP PROTOCOL (for vessel-to-vessel communication)
+// =============================================================================
+
+export { handleACPRequest } from "./acp"
+export type { ACPServerConfig } from "./acp"
+
+// =============================================================================
+// BOREDOM SYSTEM (background task execution)
+// =============================================================================
+
+export {
+  initializeBoredom,
+  startBoredom,
+  markBoredomActivity,
+  type BoredomExecutorConfig,
+  type BoredomTask,
+  type BoredomTaskResult,
+} from "./boredom"
+
+// =============================================================================
+// SEARCH-FIRST EXECUTION (goal decomposition with activity reuse)
+// =============================================================================
+// Temporarily disabled due to TypeScript strict mode issues
+// TODO: Fix type errors in search-first-executor module
+// export {
+//   SearchFirstExecutor,
+//   type SearchFirstConfig,
+//   type GoalStep,
+//   type StepResult,
+// } from "./search-first-executor"
+
+// =============================================================================
+// SESSION MEMORY AGENT
+// =============================================================================
+
+export { SessionMemoryAgent } from "./memory-agent"
+
+// =============================================================================
+// LIFECYCLE HOOKS
+// =============================================================================
+
+export { LifecycleHooks } from "./lifecycle-hooks"
+
+// =============================================================================
+// GOAL PROCESSOR (goal-driven execution)
+// =============================================================================
+
+export { GoalProcessor } from "./goal-processor"
+export type { Goal, ActivityRecommendation, GoalResult } from "./goal-processor"
+
+// =============================================================================
+// CONFIGURATION
+// =============================================================================
+
+export { loadConfig, generateManifest, configSummary } from "./config"
+export type { RuntimeContext } from "./config"
+
+// =============================================================================
+// UNDERSTANDING (application analysis and comprehension)
+// =============================================================================
+// Temporarily disabled due to TypeScript strict mode issues
+// TODO: Fix type errors in understanding module
+// export { CodeExplorer, ApplicationAnalyzer } from "./understanding"
+// export type {
+//   CodeStructure,
+//   DirectoryNode,
+//   Dependencies,
+//   FileAnalysis,
+//   AnalyzeOptions,
+//   Analysis,
+//   Diagnosis,
+//   Pattern
+// } from "./understanding"

package/src/lifecycle-hooks.ts

@@ -0,0 +1,181 @@
+/**
+ * LifecycleHooks - Execution lifecycle management for activities
+ * 
+ * Moved from metabob-opencode to minibob as part of library integration.
+ * Simplified version for minibob's use case.
+ * 
+ * Provides hooks for:
+ * - Pre-prompt: Run before each task (e.g., SessionMemoryAgent)
+ * - Post-prompt: Run after each task (e.g., cleanup, logging)
+ * - Activity complete: Run when activity finishes
+ */
+
+import type { ActivityExecution, TaskResult } from "./types"
+
+export namespace LifecycleHooks {
+  /**
+   * Hook execution context
+   */
+  export interface ActivityContext {
+    activityId: string
+    templateId: string
+    variables: Record<string, unknown>
+    reason?: string
+  }
+
+  export interface TaskContext extends ActivityContext {
+    taskId: string
+    taskDescription: string
+    prompt: string
+  }
+
+  /**
+   * Hook definitions
+   */
+  export interface Hooks {
+    /**
+     * Run before each task prompt is sent to LLM
+     * Use case: Prepare context, load impulses, analyze intent
+     */
+    onBeforePrompt?: (context: TaskContext) => Promise<void>
+
+    /**
+     * Run after each task completes
+     * Use case: Cleanup, logging, metrics
+     */
+    onAfterPrompt?: (context: TaskContext, result: TaskResult) => Promise<void>
+
+    /**
+     * Run when activity execution completes
+     * Use case: Final cleanup, reporting, notifications
+     */
+    onActivityComplete?: (execution: ActivityExecution) => Promise<void>
+
+    /**
+     * Run when activity execution fails
+     * Use case: Error handling, rollback, notifications
+     */
+    onActivityFailed?: (execution: ActivityExecution, error: Error) => Promise<void>
+  }
+
+  /**
+   * Registered hooks
+   */
+  let registeredHooks: Hooks = {}
+
+  /**
+   * Register lifecycle hooks
+   * 
+   * Example:
+   * ```ts
+   * LifecycleHooks.register({
+   *   onBeforePrompt: async (context) => {
+   *     // Prepare context with SessionMemoryAgent
+   *     const intent = await SessionMemoryAgent.analyzeIntent({
+   *       promptText: context.prompt,
+   *     })
+   *     await SessionMemoryAgent.prepare({ intent })
+   *   },
+   *   onActivityComplete: async (execution) => {
+   *     console.log(`Activity ${execution.id} completed in ${execution.metrics?.duration}ms`)
+   *   }
+   * })
+   * ```
+   */
+  export function register(hooks: Hooks): void {
+    registeredHooks = { ...registeredHooks, ...hooks }
+    console.log("[LifecycleHooks] Registered hooks:", Object.keys(hooks))
+  }
+
+  /**
+   * Clear all registered hooks
+   * Useful for testing
+   */
+  export function clear(): void {
+    registeredHooks = {}
+    console.log("[LifecycleHooks] All hooks cleared")
+  }
+
+  /**
+   * Execute onBeforePrompt hook
+   */
+  export async function executeBeforePrompt(context: TaskContext): Promise<void> {
+    if (!registeredHooks.onBeforePrompt) {
+      return
+    }
+
+    try {
+      await registeredHooks.onBeforePrompt(context)
+    } catch (error) {
+      console.warn("[LifecycleHooks] onBeforePrompt hook failed (non-blocking):", {
+        error: error instanceof Error ? error.message : String(error),
+        taskId: context.taskId,
+      })
+      // Non-blocking: Continue execution even if hook fails
+    }
+  }
+
+  /**
+   * Execute onAfterPrompt hook
+   */
+  export async function executeAfterPrompt(context: TaskContext, result: TaskResult): Promise<void> {
+    if (!registeredHooks.onAfterPrompt) {
+      return
+    }
+
+    try {
+      await registeredHooks.onAfterPrompt(context, result)
+    } catch (error) {
+      console.warn("[LifecycleHooks] onAfterPrompt hook failed (non-blocking):", {
+        error: error instanceof Error ? error.message : String(error),
+        taskId: context.taskId,
+      })
+      // Non-blocking: Continue execution even if hook fails
+    }
+  }
+
+  /**
+   * Execute onActivityComplete hook
+   */
+  export async function executeActivityComplete(execution: ActivityExecution): Promise<void> {
+    if (!registeredHooks.onActivityComplete) {
+      return
+    }
+
+    try {
+      await registeredHooks.onActivityComplete(execution)
+    } catch (error) {
+      console.warn("[LifecycleHooks] onActivityComplete hook failed (non-blocking):", {
+        error: error instanceof Error ? error.message : String(error),
+        activityId: execution.id,
+      })
+      // Non-blocking
+    }
+  }
+
+  /**
+   * Execute onActivityFailed hook
+   */
+  export async function executeActivityFailed(execution: ActivityExecution, activityError: Error): Promise<void> {
+    if (!registeredHooks.onActivityFailed) {
+      return
+    }
+
+    try {
+      await registeredHooks.onActivityFailed(execution, activityError)
+    } catch (error) {
+      console.warn("[LifecycleHooks] onActivityFailed hook failed (non-blocking):", {
+        error: error instanceof Error ? error.message : String(error),
+        activityId: execution.id,
+      })
+      // Non-blocking
+    }
+  }
+
+  /**
+   * Get currently registered hooks (for inspection/testing)
+   */
+  export function getRegistered(): Readonly<Hooks> {
+    return registeredHooks
+  }
+}