@agentxjs/core 1.9.9-dev → 2.0.0

package/dist/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/runtime/AgentXRuntime.ts"],"sourcesContent":["/**\n * AgentXRuntimeImpl - Runtime integration implementation\n *\n * Integrates all components to provide agent lifecycle management.\n * Uses Provider dependencies to coordinate Session, Image, Container, etc.\n *\n * New Design:\n * - Driver.receive() returns AsyncIterable<DriverStreamEvent>\n * - Runtime processes events and emits to EventBus\n * - No more EventBus-based communication with Driver\n */\n\nimport { createLogger } from \"commonxjs/logger\";\nimport type {\n  AgentXProvider,\n  AgentXRuntime,\n  RuntimeAgent,\n  CreateAgentOptions,\n  AgentEventHandler,\n  Subscription,\n  AgentLifecycle,\n} from \"./types\";\nimport type { UserContentPart, UserMessage } from \"../agent/types\";\nimport type { BusEvent } from \"../event/types\";\nimport type { Driver, DriverConfig, DriverStreamEvent } from \"../driver/types\";\n\nconst logger = createLogger(\"runtime/AgentXRuntime\");\n\n/**\n * Internal agent state\n */\ninterface AgentState {\n  agent: RuntimeAgent;\n  lifecycle: AgentLifecycle;\n  subscriptions: Set<() => void>;\n  driver: Driver;\n  /** Flag to track if a receive operation is in progress */\n  isReceiving: boolean;\n}\n\n/**\n * AgentXRuntimeImpl - Runtime implementation\n */\nexport class AgentXRuntimeImpl implements AgentXRuntime {\n  readonly provider: AgentXProvider;\n\n  private agents = new Map<string, AgentState>();\n  private globalSubscriptions = new Set<() => void>();\n  private isShutdown = false;\n\n  constructor(provider: AgentXProvider) {\n    this.provider = provider;\n    logger.info(\"AgentXRuntime initialized\");\n  }\n\n  // ==================== Agent Lifecycle ====================\n\n  async createAgent(options: CreateAgentOptions): Promise<RuntimeAgent> {\n    if (this.isShutdown) {\n      throw new Error(\"Runtime is shutdown\");\n    }\n\n    const { imageId } = options;\n\n    // Load image\n    const imageRecord = await this.provider.imageRepository.findImageById(imageId);\n    if (!imageRecord) {\n      throw new Error(`Image not found: ${imageId}`);\n    }\n\n    // Generate agent ID\n    const agentId = options.agentId ?? this.generateAgentId();\n\n    // Ensure container exists\n    const containerExists = await this.provider.containerRepository.containerExists(\n      imageRecord.containerId\n    );\n    if (!containerExists) {\n      throw new Error(`Container not found: ${imageRecord.containerId}`);\n    }\n\n    // Create workspace\n    const workspace = await this.provider.workspaceProvider.create({\n      containerId: imageRecord.containerId,\n      imageId,\n    });\n    await workspace.initialize();\n\n    // Create driver config\n    const driverConfig: DriverConfig = {\n      apiKey: process.env.ANTHROPIC_API_KEY ?? \"\",\n      baseUrl: process.env.ANTHROPIC_BASE_URL,\n      agentId,\n      systemPrompt: imageRecord.systemPrompt,\n      cwd: workspace.path,\n      mcpServers: imageRecord.mcpServers,\n      resumeSessionId: imageRecord.metadata?.claudeSdkSessionId as string | undefined,\n      onSessionIdCaptured: async (claudeSdkSessionId: string) => {\n        // Persist SDK session ID for resume\n        await this.provider.imageRepository.updateMetadata(imageId, { claudeSdkSessionId });\n      },\n    };\n\n    // Create driver using the new CreateDriver function\n    const driver = this.provider.createDriver(driverConfig);\n\n    // Initialize driver\n    await driver.initialize();\n\n    // Create runtime agent\n    const agent: RuntimeAgent = {\n      agentId,\n      imageId,\n      containerId: imageRecord.containerId,\n      sessionId: imageRecord.sessionId,\n      name: imageRecord.name,\n      lifecycle: \"running\",\n      createdAt: Date.now(),\n    };\n\n    // Store agent state with driver\n    const state: AgentState = {\n      agent,\n      lifecycle: \"running\",\n      subscriptions: new Set(),\n      driver,\n      isReceiving: false,\n    };\n    this.agents.set(agentId, state);\n\n    // Emit agent_created event\n    this.provider.eventBus.emit({\n      type: \"agent_created\",\n      timestamp: Date.now(),\n      source: \"runtime\",\n      category: \"lifecycle\",\n      intent: \"notification\",\n      data: {\n        agentId,\n        imageId,\n        containerId: imageRecord.containerId,\n      },\n      context: {\n        agentId,\n        imageId,\n        containerId: imageRecord.containerId,\n        sessionId: imageRecord.sessionId,\n      },\n    } as BusEvent);\n\n    logger.info(\"Agent created\", {\n      agentId,\n      imageId,\n      containerId: imageRecord.containerId,\n    });\n\n    return agent;\n  }\n\n  getAgent(agentId: string): RuntimeAgent | undefined {\n    const state = this.agents.get(agentId);\n    return state?.agent;\n  }\n\n  getAgents(): RuntimeAgent[] {\n    return Array.from(this.agents.values()).map((s) => s.agent);\n  }\n\n  getAgentsByContainer(containerId: string): RuntimeAgent[] {\n    return Array.from(this.agents.values())\n      .filter((s) => s.agent.containerId === containerId)\n      .map((s) => s.agent);\n  }\n\n  async stopAgent(agentId: string): Promise<void> {\n    const state = this.agents.get(agentId);\n    if (!state) {\n      throw new Error(`Agent not found: ${agentId}`);\n    }\n\n    if (state.lifecycle === \"destroyed\") {\n      throw new Error(`Agent already destroyed: ${agentId}`);\n    }\n\n    state.lifecycle = \"stopped\";\n\n    // Emit agent_stopped event\n    this.provider.eventBus.emit({\n      type: \"agent_stopped\",\n      timestamp: Date.now(),\n      source: \"runtime\",\n      category: \"lifecycle\",\n      intent: \"notification\",\n      data: { agentId },\n      context: {\n        agentId,\n        imageId: state.agent.imageId,\n        containerId: state.agent.containerId,\n        sessionId: state.agent.sessionId,\n      },\n    } as BusEvent);\n\n    logger.info(\"Agent stopped\", { agentId });\n  }\n\n  async resumeAgent(agentId: string): Promise<void> {\n    const state = this.agents.get(agentId);\n    if (!state) {\n      throw new Error(`Agent not found: ${agentId}`);\n    }\n\n    if (state.lifecycle === \"destroyed\") {\n      throw new Error(`Cannot resume destroyed agent: ${agentId}`);\n    }\n\n    state.lifecycle = \"running\";\n\n    // Emit agent_resumed event\n    this.provider.eventBus.emit({\n      type: \"agent_resumed\",\n      timestamp: Date.now(),\n      source: \"runtime\",\n      category: \"lifecycle\",\n      intent: \"notification\",\n      data: { agentId },\n      context: {\n        agentId,\n        imageId: state.agent.imageId,\n        containerId: state.agent.containerId,\n        sessionId: state.agent.sessionId,\n      },\n    } as BusEvent);\n\n    logger.info(\"Agent resumed\", { agentId });\n  }\n\n  async destroyAgent(agentId: string): Promise<void> {\n    const state = this.agents.get(agentId);\n    if (!state) {\n      throw new Error(`Agent not found: ${agentId}`);\n    }\n\n    // Dispose driver (new interface, no disconnect needed)\n    await state.driver.dispose();\n\n    // Cleanup subscriptions\n    for (const unsub of state.subscriptions) {\n      unsub();\n    }\n    state.subscriptions.clear();\n\n    state.lifecycle = \"destroyed\";\n\n    // Emit agent_destroyed event\n    this.provider.eventBus.emit({\n      type: \"agent_destroyed\",\n      timestamp: Date.now(),\n      source: \"runtime\",\n      category: \"lifecycle\",\n      intent: \"notification\",\n      data: { agentId },\n      context: {\n        agentId,\n        imageId: state.agent.imageId,\n        containerId: state.agent.containerId,\n        sessionId: state.agent.sessionId,\n      },\n    } as BusEvent);\n\n    // Remove from map\n    this.agents.delete(agentId);\n\n    logger.info(\"Agent destroyed\", { agentId });\n  }\n\n  // ==================== Message Handling ====================\n\n  async receive(\n    agentId: string,\n    content: string | UserContentPart[],\n    requestId?: string\n  ): Promise<void> {\n    const state = this.agents.get(agentId);\n    if (!state) {\n      throw new Error(`Agent not found: ${agentId}`);\n    }\n\n    if (state.lifecycle !== \"running\") {\n      throw new Error(`Cannot send message to ${state.lifecycle} agent: ${agentId}`);\n    }\n\n    if (state.isReceiving) {\n      throw new Error(`Agent ${agentId} is already processing a message`);\n    }\n\n    const actualRequestId = requestId ?? this.generateRequestId();\n\n    // Build user message\n    const userMessage: UserMessage = {\n      id: this.generateMessageId(),\n      role: \"user\",\n      subtype: \"user\",\n      content,\n      timestamp: Date.now(),\n    };\n\n    // Persist to session\n    await this.provider.sessionRepository.addMessage(state.agent.sessionId, userMessage);\n\n    // Emit user_message event (for external subscribers)\n    this.emitEvent(state, \"user_message\", userMessage, actualRequestId);\n\n    logger.debug(\"User message sent\", {\n      agentId,\n      requestId: actualRequestId,\n      contentPreview:\n        typeof content === \"string\" ? content.substring(0, 50) : `[${content.length} parts]`,\n    });\n\n    // Mark as receiving\n    state.isReceiving = true;\n\n    try {\n      // Call driver.receive() and process the AsyncIterable\n      for await (const event of state.driver.receive(userMessage)) {\n        // Convert DriverStreamEvent to BusEvent and emit\n        this.handleDriverEvent(state, event, actualRequestId);\n      }\n    } catch (error) {\n      // Emit error event\n      this.emitEvent(\n        state,\n        \"error_received\",\n        {\n          message: error instanceof Error ? error.message : String(error),\n          errorCode: \"runtime_error\",\n        },\n        actualRequestId\n      );\n      throw error;\n    } finally {\n      state.isReceiving = false;\n    }\n  }\n\n  interrupt(agentId: string, requestId?: string): void {\n    const state = this.agents.get(agentId);\n    if (!state) {\n      throw new Error(`Agent not found: ${agentId}`);\n    }\n\n    // Call driver.interrupt() directly\n    state.driver.interrupt();\n\n    // Emit interrupt event (for external subscribers)\n    this.emitEvent(\n      state,\n      \"interrupt\",\n      { agentId },\n      requestId ?? this.generateRequestId()\n    );\n\n    logger.debug(\"Interrupt sent\", { agentId, requestId });\n  }\n\n  // ==================== Event Subscription ====================\n\n  subscribe(agentId: string, handler: AgentEventHandler): Subscription {\n    const state = this.agents.get(agentId);\n    if (!state) {\n      throw new Error(`Agent not found: ${agentId}`);\n    }\n\n    const unsub = this.provider.eventBus.onAny((event) => {\n      const context = (event as BusEvent & { context?: { agentId?: string } }).context;\n      if (context?.agentId === agentId) {\n        handler(event);\n      }\n    });\n\n    state.subscriptions.add(unsub);\n\n    return {\n      unsubscribe: () => {\n        unsub();\n        state.subscriptions.delete(unsub);\n      },\n    };\n  }\n\n  subscribeAll(handler: AgentEventHandler): Subscription {\n    const unsub = this.provider.eventBus.onAny(handler);\n    this.globalSubscriptions.add(unsub);\n\n    return {\n      unsubscribe: () => {\n        unsub();\n        this.globalSubscriptions.delete(unsub);\n      },\n    };\n  }\n\n  // ==================== Cleanup ====================\n\n  async shutdown(): Promise<void> {\n    if (this.isShutdown) return;\n\n    logger.info(\"Shutting down AgentXRuntime...\");\n\n    // Destroy all agents\n    const agentIds = Array.from(this.agents.keys());\n    for (const agentId of agentIds) {\n      await this.destroyAgent(agentId);\n    }\n\n    // Cleanup global subscriptions\n    for (const unsub of this.globalSubscriptions) {\n      unsub();\n    }\n    this.globalSubscriptions.clear();\n\n    this.isShutdown = true;\n    logger.info(\"AgentXRuntime shutdown complete\");\n  }\n\n  // ==================== Private Helpers ====================\n\n  /**\n   * Handle a single DriverStreamEvent\n   */\n  private handleDriverEvent(\n    state: AgentState,\n    event: DriverStreamEvent,\n    requestId: string\n  ): void {\n    // Map DriverStreamEvent to BusEvent and emit\n    this.emitEvent(state, event.type, event.data, requestId);\n  }\n\n  /**\n   * Emit an event to the EventBus\n   */\n  private emitEvent(\n    state: AgentState,\n    type: string,\n    data: unknown,\n    requestId: string\n  ): void {\n    this.provider.eventBus.emit({\n      type,\n      timestamp: Date.now(),\n      source: \"runtime\",\n      category: this.categorizeEvent(type),\n      intent: \"notification\",\n      requestId,\n      data,\n      context: {\n        agentId: state.agent.agentId,\n        imageId: state.agent.imageId,\n        containerId: state.agent.containerId,\n        sessionId: state.agent.sessionId,\n      },\n    } as BusEvent);\n  }\n\n  /**\n   * Categorize event type\n   */\n  private categorizeEvent(type: string): string {\n    if (type.includes(\"message\")) return \"message\";\n    if (type.includes(\"tool\")) return \"tool\";\n    if (type.includes(\"error\") || type.includes(\"interrupted\")) return \"error\";\n    if (type.includes(\"delta\")) return \"stream\";\n    return \"stream\";\n  }\n\n  private generateAgentId(): string {\n    const timestamp = Date.now().toString(36);\n    const random = Math.random().toString(36).substring(2, 8);\n    return `agent_${timestamp}_${random}`;\n  }\n\n  private generateRequestId(): string {\n    const timestamp = Date.now().toString(36);\n    const random = Math.random().toString(36).substring(2, 8);\n    return `req_${timestamp}_${random}`;\n  }\n\n  private generateMessageId(): string {\n    const timestamp = Date.now().toString(36);\n    const random = Math.random().toString(36).substring(2, 8);\n    return `msg_${timestamp}_${random}`;\n  }\n}\n\n/**\n * Create an AgentXRuntime instance\n */\nexport function createAgentXRuntime(provider: AgentXProvider): AgentXRuntime {\n  return new AgentXRuntimeImpl(provider);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/runtime/AgentXRuntime.ts"],"sourcesContent":["/**\n * AgentXRuntimeImpl - Runtime integration implementation\n *\n * Integrates all components to provide agent lifecycle management.\n * Uses Platform dependencies to coordinate Session, Image, Container, etc.\n *\n * Architecture:\n * - Driver.receive() returns AsyncIterable<DriverStreamEvent>\n * - Runtime emits raw stream events to EventBus\n * - Runtime pushes events through AgentEngine (MealyMachine → Presenter)\n * - Presenter emits message/state/turn events and persists messages\n */\n\nimport { createLogger } from \"commonxjs/logger\";\nimport type {\n  AgentXPlatform,\n  AgentXRuntime,\n  RuntimeAgent,\n  CreateAgentOptions,\n  AgentEventHandler,\n  Subscription,\n  AgentLifecycle,\n} from \"./types\";\nimport type {\n  UserContentPart,\n  UserMessage,\n  AgentEngine,\n  StreamEvent,\n  AgentOutput,\n  AgentPresenter,\n  AgentSource,\n  Message,\n} from \"../agent/types\";\nimport type { BusEvent } from \"../event/types\";\nimport type {\n  CreateDriver,\n  Driver,\n  DriverConfig,\n  DriverStreamEvent,\n  ToolDefinition,\n} from \"../driver/types\";\nimport { createSession } from \"../session/Session\";\nimport { createBashTool } from \"../bash/tool\";\nimport { createAgent as createAgentEngine } from \"../agent/createAgent\";\n\nconst logger = createLogger(\"runtime/AgentXRuntime\");\n\n/**\n * Internal agent state\n */\ninterface AgentState {\n  agent: RuntimeAgent;\n  lifecycle: AgentLifecycle;\n  subscriptions: Set<() => void>;\n  driver: Driver;\n  engine: AgentEngine;\n  /** Flag to track if a receive operation is in progress */\n  isReceiving: boolean;\n}\n\n/**\n * AgentXRuntimeImpl - Runtime implementation\n */\nexport class AgentXRuntimeImpl implements AgentXRuntime {\n  readonly platform: AgentXPlatform;\n  private readonly createDriver: CreateDriver;\n\n  private agents = new Map<string, AgentState>();\n  private globalSubscriptions = new Set<() => void>();\n  private isShutdown = false;\n\n  constructor(platform: AgentXPlatform, createDriver: CreateDriver) {\n    this.platform = platform;\n    this.createDriver = createDriver;\n    logger.info(\"AgentXRuntime initialized\");\n  }\n\n  // ==================== Agent Lifecycle ====================\n\n  async createAgent(options: CreateAgentOptions): Promise<RuntimeAgent> {\n    if (this.isShutdown) {\n      throw new Error(\"Runtime is shutdown\");\n    }\n\n    const { imageId } = options;\n\n    // Load image\n    const imageRecord = await this.platform.imageRepository.findImageById(imageId);\n    if (!imageRecord) {\n      throw new Error(`Image not found: ${imageId}`);\n    }\n\n    // Generate agent ID\n    const agentId = options.agentId ?? this.generateAgentId();\n\n    // Ensure container exists\n    const containerExists = await this.platform.containerRepository.containerExists(\n      imageRecord.containerId\n    );\n    if (!containerExists) {\n      throw new Error(`Container not found: ${imageRecord.containerId}`);\n    }\n\n    // Create Session for driver (MonoDriver needs this to read history)\n    const session = createSession({\n      sessionId: imageRecord.sessionId,\n      imageId,\n      containerId: imageRecord.containerId,\n      repository: this.platform.sessionRepository,\n    });\n\n    // Assemble platform-provided default tools\n    const defaultTools: ToolDefinition[] = [];\n    if (this.platform.bashProvider) {\n      defaultTools.push(createBashTool(this.platform.bashProvider));\n    }\n\n    // Create driver config (apiKey/baseUrl are provided by the createDriver closure)\n    const driverConfig: DriverConfig = {\n      apiKey: \"\",\n      agentId,\n      systemPrompt: imageRecord.systemPrompt,\n      mcpServers: imageRecord.mcpServers,\n      tools: defaultTools.length > 0 ? defaultTools : undefined,\n      session, // Inject Session for stateless drivers\n      resumeSessionId: imageRecord.metadata?.driverSessionId as string | undefined,\n      onSessionIdCaptured: async (driverSessionId: string) => {\n        // Persist driver session ID for resume\n        await this.platform.imageRepository.updateMetadata(imageId, { driverSessionId });\n      },\n    };\n\n    // Create driver using the injected CreateDriver function\n    const driver = this.createDriver(driverConfig);\n\n    // Initialize driver\n    await driver.initialize();\n\n    // Create AgentEngine with custom Source and Presenter\n    // Source: no-op (Runtime pushes events directly via handleStreamEvent)\n    // Presenter: emits message/state/turn events to EventBus + persists messages\n    const noopSource: AgentSource = {\n      name: \"RuntimeSource\",\n      connect: () => {},\n      disconnect: () => {},\n    };\n\n    const sessionId = imageRecord.sessionId;\n    const sessionRepository = this.platform.sessionRepository;\n    const eventBus = this.platform.eventBus;\n\n    const runtimePresenter: AgentPresenter = {\n      name: \"RuntimePresenter\",\n      present: (_agentId: string, output: AgentOutput) => {\n        const category = categorizeAgentOutput(output.type);\n\n        // Skip stream events — already emitted by handleDriverEvent\n        if (category === \"stream\") return;\n\n        // Emit state/message/turn events to EventBus\n        eventBus.emit({\n          type: output.type,\n          timestamp: output.timestamp,\n          source: \"agent\",\n          category,\n          intent: \"notification\",\n          data: output.data,\n          context: {\n            agentId,\n            imageId,\n            containerId: imageRecord.containerId,\n            sessionId,\n          },\n        } as BusEvent);\n\n        // Persist message events to SessionRepository\n        if (category === \"message\" && output.type !== \"user_message\") {\n          const message = output.data as Message;\n          sessionRepository.addMessage(sessionId, message).catch((err) => {\n            logger.error(\"Failed to persist message\", { type: output.type, error: err });\n          });\n        }\n      },\n    };\n\n    const engine = createAgentEngine({\n      agentId,\n      bus: this.platform.eventBus,\n      source: noopSource,\n      presenter: runtimePresenter,\n    });\n\n    // Create runtime agent\n    const agent: RuntimeAgent = {\n      agentId,\n      imageId,\n      containerId: imageRecord.containerId,\n      sessionId: imageRecord.sessionId,\n      name: imageRecord.name,\n      lifecycle: \"running\",\n      createdAt: Date.now(),\n    };\n\n    // Store agent state with driver and engine\n    const state: AgentState = {\n      agent,\n      lifecycle: \"running\",\n      subscriptions: new Set(),\n      driver,\n      engine,\n      isReceiving: false,\n    };\n    this.agents.set(agentId, state);\n\n    // Emit agent_created event\n    this.platform.eventBus.emit({\n      type: \"agent_created\",\n      timestamp: Date.now(),\n      source: \"runtime\",\n      category: \"lifecycle\",\n      intent: \"notification\",\n      data: {\n        agentId,\n        imageId,\n        containerId: imageRecord.containerId,\n      },\n      context: {\n        agentId,\n        imageId,\n        containerId: imageRecord.containerId,\n        sessionId: imageRecord.sessionId,\n      },\n    } as BusEvent);\n\n    logger.info(\"Agent created\", {\n      agentId,\n      imageId,\n      containerId: imageRecord.containerId,\n    });\n\n    return agent;\n  }\n\n  getAgent(agentId: string): RuntimeAgent | undefined {\n    const state = this.agents.get(agentId);\n    return state?.agent;\n  }\n\n  getAgents(): RuntimeAgent[] {\n    return Array.from(this.agents.values()).map((s) => s.agent);\n  }\n\n  getAgentsByContainer(containerId: string): RuntimeAgent[] {\n    return Array.from(this.agents.values())\n      .filter((s) => s.agent.containerId === containerId)\n      .map((s) => s.agent);\n  }\n\n  async stopAgent(agentId: string): Promise<void> {\n    const state = this.agents.get(agentId);\n    if (!state) {\n      throw new Error(`Agent not found: ${agentId}`);\n    }\n\n    if (state.lifecycle === \"destroyed\") {\n      throw new Error(`Agent already destroyed: ${agentId}`);\n    }\n\n    state.lifecycle = \"stopped\";\n\n    // Emit agent_stopped event\n    this.platform.eventBus.emit({\n      type: \"agent_stopped\",\n      timestamp: Date.now(),\n      source: \"runtime\",\n      category: \"lifecycle\",\n      intent: \"notification\",\n      data: { agentId },\n      context: {\n        agentId,\n        imageId: state.agent.imageId,\n        containerId: state.agent.containerId,\n        sessionId: state.agent.sessionId,\n      },\n    } as BusEvent);\n\n    logger.info(\"Agent stopped\", { agentId });\n  }\n\n  async resumeAgent(agentId: string): Promise<void> {\n    const state = this.agents.get(agentId);\n    if (!state) {\n      throw new Error(`Agent not found: ${agentId}`);\n    }\n\n    if (state.lifecycle === \"destroyed\") {\n      throw new Error(`Cannot resume destroyed agent: ${agentId}`);\n    }\n\n    state.lifecycle = \"running\";\n\n    // Emit agent_resumed event\n    this.platform.eventBus.emit({\n      type: \"agent_resumed\",\n      timestamp: Date.now(),\n      source: \"runtime\",\n      category: \"lifecycle\",\n      intent: \"notification\",\n      data: { agentId },\n      context: {\n        agentId,\n        imageId: state.agent.imageId,\n        containerId: state.agent.containerId,\n        sessionId: state.agent.sessionId,\n      },\n    } as BusEvent);\n\n    logger.info(\"Agent resumed\", { agentId });\n  }\n\n  async destroyAgent(agentId: string): Promise<void> {\n    const state = this.agents.get(agentId);\n    if (!state) {\n      throw new Error(`Agent not found: ${agentId}`);\n    }\n\n    // Dispose driver and engine\n    await state.driver.dispose();\n    await state.engine.destroy();\n\n    // Cleanup subscriptions\n    for (const unsub of state.subscriptions) {\n      unsub();\n    }\n    state.subscriptions.clear();\n\n    state.lifecycle = \"destroyed\";\n\n    // Emit agent_destroyed event\n    this.platform.eventBus.emit({\n      type: \"agent_destroyed\",\n      timestamp: Date.now(),\n      source: \"runtime\",\n      category: \"lifecycle\",\n      intent: \"notification\",\n      data: { agentId },\n      context: {\n        agentId,\n        imageId: state.agent.imageId,\n        containerId: state.agent.containerId,\n        sessionId: state.agent.sessionId,\n      },\n    } as BusEvent);\n\n    // Remove from map\n    this.agents.delete(agentId);\n\n    logger.info(\"Agent destroyed\", { agentId });\n  }\n\n  // ==================== Message Handling ====================\n\n  async receive(\n    agentId: string,\n    content: string | UserContentPart[],\n    requestId?: string\n  ): Promise<void> {\n    const state = this.agents.get(agentId);\n    if (!state) {\n      throw new Error(`Agent not found: ${agentId}`);\n    }\n\n    if (state.lifecycle !== \"running\") {\n      throw new Error(`Cannot send message to ${state.lifecycle} agent: ${agentId}`);\n    }\n\n    if (state.isReceiving) {\n      throw new Error(`Agent ${agentId} is already processing a message`);\n    }\n\n    const actualRequestId = requestId ?? this.generateRequestId();\n\n    // Build user message\n    const userMessage: UserMessage = {\n      id: this.generateMessageId(),\n      role: \"user\",\n      subtype: \"user\",\n      content,\n      timestamp: Date.now(),\n    };\n\n    // Persist to session\n    await this.platform.sessionRepository.addMessage(state.agent.sessionId, userMessage);\n\n    // Emit user_message event (for external subscribers)\n    this.emitEvent(state, \"user_message\", userMessage, actualRequestId);\n\n    logger.debug(\"User message sent\", {\n      agentId,\n      requestId: actualRequestId,\n      contentPreview:\n        typeof content === \"string\"\n          ? content.substring(0, 50)\n          : Array.isArray(content)\n            ? `[${content.length} parts]`\n            : `[${typeof content}]`,\n    });\n\n    // Mark as receiving\n    state.isReceiving = true;\n\n    try {\n      // Call driver.receive() and process the AsyncIterable\n      for await (const event of state.driver.receive(userMessage)) {\n        // Convert DriverStreamEvent to BusEvent and emit\n        this.handleDriverEvent(state, event, actualRequestId);\n      }\n    } catch (error) {\n      // Emit error event\n      this.emitEvent(\n        state,\n        \"error_received\",\n        {\n          message: error instanceof Error ? error.message : String(error),\n          errorCode: \"runtime_error\",\n        },\n        actualRequestId\n      );\n      throw error;\n    } finally {\n      state.isReceiving = false;\n    }\n  }\n\n  interrupt(agentId: string, requestId?: string): void {\n    const state = this.agents.get(agentId);\n    if (!state) {\n      throw new Error(`Agent not found: ${agentId}`);\n    }\n\n    // Call driver.interrupt() directly\n    state.driver.interrupt();\n\n    // Emit interrupt event (for external subscribers)\n    this.emitEvent(state, \"interrupt\", { agentId }, requestId ?? this.generateRequestId());\n\n    logger.debug(\"Interrupt sent\", { agentId, requestId });\n  }\n\n  // ==================== Event Subscription ====================\n\n  subscribe(agentId: string, handler: AgentEventHandler): Subscription {\n    const state = this.agents.get(agentId);\n    if (!state) {\n      throw new Error(`Agent not found: ${agentId}`);\n    }\n\n    const unsub = this.platform.eventBus.onAny((event) => {\n      const context = (event as BusEvent & { context?: { agentId?: string } }).context;\n      if (context?.agentId === agentId) {\n        handler(event);\n      }\n    });\n\n    state.subscriptions.add(unsub);\n\n    return {\n      unsubscribe: () => {\n        unsub();\n        state.subscriptions.delete(unsub);\n      },\n    };\n  }\n\n  subscribeAll(handler: AgentEventHandler): Subscription {\n    const unsub = this.platform.eventBus.onAny(handler);\n    this.globalSubscriptions.add(unsub);\n\n    return {\n      unsubscribe: () => {\n        unsub();\n        this.globalSubscriptions.delete(unsub);\n      },\n    };\n  }\n\n  // ==================== Cleanup ====================\n\n  async shutdown(): Promise<void> {\n    if (this.isShutdown) return;\n\n    logger.info(\"Shutting down AgentXRuntime...\");\n\n    // Destroy all agents\n    const agentIds = Array.from(this.agents.keys());\n    for (const agentId of agentIds) {\n      await this.destroyAgent(agentId);\n    }\n\n    // Cleanup global subscriptions\n    for (const unsub of this.globalSubscriptions) {\n      unsub();\n    }\n    this.globalSubscriptions.clear();\n\n    this.isShutdown = true;\n    logger.info(\"AgentXRuntime shutdown complete\");\n  }\n\n  // ==================== Private Helpers ====================\n\n  /**\n   * Handle a single DriverStreamEvent\n   */\n  private handleDriverEvent(state: AgentState, event: DriverStreamEvent, requestId: string): void {\n    // 1. Emit raw stream event to EventBus (for Presentation and other subscribers)\n    this.emitEvent(state, event.type, event.data, requestId);\n\n    // 2. Push to AgentEngine for MealyMachine processing\n    //    Engine produces message/state/turn events via Presenter\n    const streamEvent = toStreamEvent(event);\n    state.engine.handleStreamEvent(streamEvent);\n  }\n\n  /**\n   * Emit an event to the EventBus\n   */\n  private emitEvent(state: AgentState, type: string, data: unknown, requestId: string): void {\n    this.platform.eventBus.emit({\n      type,\n      timestamp: Date.now(),\n      source: \"runtime\",\n      category: this.categorizeEvent(type),\n      intent: \"notification\",\n      requestId,\n      data,\n      context: {\n        agentId: state.agent.agentId,\n        imageId: state.agent.imageId,\n        containerId: state.agent.containerId,\n        sessionId: state.agent.sessionId,\n      },\n    } as BusEvent);\n  }\n\n  /**\n   * Categorize event type\n   */\n  private categorizeEvent(type: string): string {\n    if (type.includes(\"message\")) return \"message\";\n    if (type.includes(\"tool\")) return \"tool\";\n    if (type.includes(\"error\") || type.includes(\"interrupted\")) return \"error\";\n    if (type.includes(\"delta\")) return \"stream\";\n    return \"stream\";\n  }\n\n  private generateAgentId(): string {\n    const timestamp = Date.now().toString(36);\n    const random = Math.random().toString(36).substring(2, 8);\n    return `agent_${timestamp}_${random}`;\n  }\n\n  private generateRequestId(): string {\n    const timestamp = Date.now().toString(36);\n    const random = Math.random().toString(36).substring(2, 8);\n    return `req_${timestamp}_${random}`;\n  }\n\n  private generateMessageId(): string {\n    const timestamp = Date.now().toString(36);\n    const random = Math.random().toString(36).substring(2, 8);\n    return `msg_${timestamp}_${random}`;\n  }\n}\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\n/**\n * Convert DriverStreamEvent to agent-layer StreamEvent.\n * Data structures are identical; only \"error\" type needs renaming.\n */\nfunction toStreamEvent(event: DriverStreamEvent): StreamEvent {\n  const type = event.type === \"error\" ? \"error_received\" : event.type;\n  return { type, data: event.data, timestamp: Date.now() } as StreamEvent;\n}\n\n/**\n * Categorize AgentOutput type for EventBus emission.\n */\nfunction categorizeAgentOutput(type: string): string {\n  // Stream layer — already emitted by handleDriverEvent\n  const streamTypes = [\n    \"message_start\",\n    \"message_delta\",\n    \"message_stop\",\n    \"text_delta\",\n    \"tool_use_start\",\n    \"input_json_delta\",\n    \"tool_use_stop\",\n    \"tool_result\",\n    \"error_received\",\n  ];\n  if (streamTypes.includes(type)) return \"stream\";\n\n  // Message layer\n  if (type.endsWith(\"_message\")) return \"message\";\n\n  // Turn layer\n  if (type.startsWith(\"turn_\")) return \"turn\";\n\n  // State layer (default)\n  return \"state\";\n}\n\n/**\n * Create an AgentXRuntime instance\n *\n * @param platform - AgentXPlatform with repositories and event bus\n * @param createDriver - Factory function for creating Driver instances per Agent\n */\nexport function createAgentXRuntime(\n  platform: AgentXPlatform,\n  createDriver: CreateDriver\n): AgentXRuntime {\n  return new AgentXRuntimeImpl(platform, createDriver);\n}\n"],"mappings":"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","names":[]}

package/dist/session/index.d.ts

@@ -1,54 +1,6 @@
-import { SessionRepository } from '../persistence/index.js';
-export { SessionRecord } from '../persistence/index.js';
-import { M as Message } from '../message-BMrMm1pq.js';
-import '../driver/index.js';
-
-/**
- * Session - Manages conversation messages
- */
-interface Session {
-    /**
-     * Unique session identifier
-     */
-    readonly sessionId: string;
-    /**
-     * Associated image ID
-     */
-    readonly imageId: string;
-    /**
-     * Container this session belongs to
-     */
-    readonly containerId: string;
-    /**
-     * Creation timestamp
-     */
-    readonly createdAt: number;
-    /**
-     * Initialize session in storage
-     */
-    initialize(): Promise<void>;
-    /**
-     * Add a message to the session
-     */
-    addMessage(message: Message): Promise<void>;
-    /**
-     * Get all messages in the session
-     */
-    getMessages(): Promise<Message[]>;
-    /**
-     * Clear all messages in the session
-     */
-    clear(): Promise<void>;
-}
-/**
- * Configuration for creating a Session
- */
-interface SessionConfig {
-    sessionId: string;
-    imageId: string;
-    containerId: string;
-    repository: SessionRepository;
-}
+import { S as Session, a as SessionConfig } from '../index-CuS1i5V-.js';
+export { b as SessionRecord, c as SessionRepository } from '../index-CuS1i5V-.js';
+import { M as Message } from '../message-03TJzvIX.js';
 
 /**
  * Session - Manages conversation messages
@@ -89,4 +41,4 @@ declare class SessionImpl implements Session {
  */
 declare function createSession(config: SessionConfig): Session;
 
-export { type Session, type SessionConfig, SessionImpl, SessionRepository, createSession };
+export { Session, SessionConfig, SessionImpl, createSession };

package/dist/session/index.js

@@ -1,54 +1,7 @@
-import "../chunk-7D4SUZUM.js";
-
-// src/session/Session.ts
-var SessionImpl = class {
-  sessionId;
-  imageId;
-  containerId;
-  createdAt;
-  repository;
-  constructor(config) {
-    this.sessionId = config.sessionId;
-    this.imageId = config.imageId;
-    this.containerId = config.containerId;
-    this.createdAt = Date.now();
-    this.repository = config.repository;
-  }
-  /**
-   * Initialize session in storage
-   */
-  async initialize() {
-    const record = {
-      sessionId: this.sessionId,
-      imageId: this.imageId,
-      containerId: this.containerId,
-      createdAt: this.createdAt,
-      updatedAt: this.createdAt
-    };
-    await this.repository.saveSession(record);
-  }
-  /**
-   * Add a message to the session
-   */
-  async addMessage(message) {
-    await this.repository.addMessage(this.sessionId, message);
-  }
-  /**
-   * Get all messages in the session
-   */
-  async getMessages() {
-    return this.repository.getMessages(this.sessionId);
-  }
-  /**
-   * Clear all messages in the session
-   */
-  async clear() {
-    await this.repository.clearMessages(this.sessionId);
-  }
-};
-function createSession(config) {
-  return new SessionImpl(config);
-}
+import {
+  SessionImpl,
+  createSession
+} from "../chunk-BHOD5PKR.js";
 export {
   SessionImpl,
   createSession

package/dist/session/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/session/Session.ts"],"sourcesContent":["/**\n * Session - Manages conversation messages\n *\n * Collects messages and persists to storage via SessionRepository.\n * Pure implementation without EventBus dependency.\n */\n\nimport type { Message } from \"../agent/types\";\nimport type { Session, SessionConfig, SessionRecord, SessionRepository } from \"./types\";\n\n/**\n * SessionImpl - Session implementation\n */\nexport class SessionImpl implements Session {\n  readonly sessionId: string;\n  readonly imageId: string;\n  readonly containerId: string;\n  readonly createdAt: number;\n\n  private readonly repository: SessionRepository;\n\n  constructor(config: SessionConfig) {\n    this.sessionId = config.sessionId;\n    this.imageId = config.imageId;\n    this.containerId = config.containerId;\n    this.createdAt = Date.now();\n    this.repository = config.repository;\n  }\n\n  /**\n   * Initialize session in storage\n   */\n  async initialize(): Promise<void> {\n    const record: SessionRecord = {\n      sessionId: this.sessionId,\n      imageId: this.imageId,\n      containerId: this.containerId,\n      createdAt: this.createdAt,\n      updatedAt: this.createdAt,\n    };\n    await this.repository.saveSession(record);\n  }\n\n  /**\n   * Add a message to the session\n   */\n  async addMessage(message: Message): Promise<void> {\n    await this.repository.addMessage(this.sessionId, message);\n  }\n\n  /**\n   * Get all messages in the session\n   */\n  async getMessages(): Promise<Message[]> {\n    return this.repository.getMessages(this.sessionId);\n  }\n\n  /**\n   * Clear all messages in the session\n   */\n  async clear(): Promise<void> {\n    await this.repository.clearMessages(this.sessionId);\n  }\n}\n\n/**\n * Create a new Session instance\n */\nexport function createSession(config: SessionConfig): Session {\n  return new SessionImpl(config);\n}\n"],"mappings":";;;AAaO,IAAM,cAAN,MAAqC;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEQ;AAAA,EAEjB,YAAY,QAAuB;AACjC,SAAK,YAAY,OAAO;AACxB,SAAK,UAAU,OAAO;AACtB,SAAK,cAAc,OAAO;AAC1B,SAAK,YAAY,KAAK,IAAI;AAC1B,SAAK,aAAa,OAAO;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,aAA4B;AAChC,UAAM,SAAwB;AAAA,MAC5B,WAAW,KAAK;AAAA,MAChB,SAAS,KAAK;AAAA,MACd,aAAa,KAAK;AAAA,MAClB,WAAW,KAAK;AAAA,MAChB,WAAW,KAAK;AAAA,IAClB;AACA,UAAM,KAAK,WAAW,YAAY,MAAM;AAAA,EAC1C;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,WAAW,SAAiC;AAChD,UAAM,KAAK,WAAW,WAAW,KAAK,WAAW,OAAO;AAAA,EAC1D;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,cAAkC;AACtC,WAAO,KAAK,WAAW,YAAY,KAAK,SAAS;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,QAAuB;AAC3B,UAAM,KAAK,WAAW,cAAc,KAAK,SAAS;AAAA,EACpD;AACF;AAKO,SAAS,cAAc,QAAgC;AAC5D,SAAO,IAAI,YAAY,MAAM;AAC/B;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types-aE74Eo6G.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Bash Types
+ *
+ * Abstraction for command execution capability.
+ * Different platforms provide different implementations:
+ * - Node.js: child_process based
+ * - Docker: Container exec
+ * - Sandbox: Isolated environment
+ *
+ * ```
+ * ┌─────────────────────────────────────────────────────┐
+ * │                     core/bash                        │
+ * │  ┌─────────────────────────────────────────────────┐│
+ * │  │  BashProvider (interface)                       ││
+ * │  │  BashResult   (interface)                       ││
+ * │  │  BashOptions  (interface)                       ││
+ * │  └─────────────────────────────────────────────────┘│
+ * └─────────────────────────────────────────────────────┘
+ *                           │
+ *          ┌────────────────┼────────────────┐
+ *          ▼                ▼                ▼
+ *   ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
+ *   │ platform-node│ │platform-docker│ │platform-sandbox│
+ *   │ ChildProcess │ │ ContainerExec│ │ SandboxExec  │
+ *   └──────────────┘ └──────────────┘ └──────────────┘
+ * ```
+ */
+/**
+ * BashResult - Output from a command execution
+ */
+interface BashResult {
+    /**
+     * Standard output
+     */
+    stdout: string;
+    /**
+     * Standard error
+     */
+    stderr: string;
+    /**
+     * Process exit code (0 = success)
+     */
+    exitCode: number;
+}
+/**
+ * BashOptions - Configuration for a single command execution
+ */
+interface BashOptions {
+    /**
+     * Working directory for the command
+     */
+    cwd?: string;
+    /**
+     * Timeout in milliseconds
+     */
+    timeout?: number;
+    /**
+     * Environment variables
+     */
+    env?: Record<string, string>;
+}
+/**
+ * BashProvider - Abstraction for command execution
+ *
+ * Platform implementations provide this interface.
+ * The provider is stateless — each execute() call is independent.
+ *
+ * @example
+ * ```typescript
+ * const result = await provider.execute("ls -la", { cwd: "/tmp" });
+ * console.log(result.stdout);
+ * console.log(result.exitCode); // 0
+ * ```
+ */
+interface BashProvider {
+    /**
+     * Provider type (e.g., "child-process", "docker", "sandbox")
+     */
+    readonly type: string;
+    /**
+     * Execute a shell command
+     *
+     * @param command - Shell command to execute
+     * @param options - Execution options
+     * @returns Command output and exit code
+     */
+    execute(command: string, options?: BashOptions): Promise<BashResult>;
+}
+
+export type { BashProvider as B, BashResult as a, BashOptions as b };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentxjs/core",
-  "version": "1.9.9-dev",
+  "version": "2.0.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -45,10 +45,15 @@
       "import": "./dist/container/index.js",
       "default": "./dist/container/index.js"
     },
-    "./workspace": {
-      "types": "./dist/workspace/index.d.ts",
-      "import": "./dist/workspace/index.js",
-      "default": "./dist/workspace/index.js"
+    "./bash": {
+      "types": "./dist/bash/index.d.ts",
+      "import": "./dist/bash/index.js",
+      "default": "./dist/bash/index.js"
+    },
+    "./platform": {
+      "types": "./dist/platform/index.d.ts",
+      "import": "./dist/platform/index.js",
+      "default": "./dist/platform/index.js"
     },
     "./runtime": {
       "types": "./dist/runtime/index.d.ts",