@agentxjs/core 2.0.0 → 3.0.0

package/dist/platform/index.d.ts

@@ -1,8 +1,8 @@
-import { d as ContainerRepository, I as ImageRepository, c as SessionRepository } from '../index-CuS1i5V-.js';
+import { B as BashProvider } from '../types-Cb8tKM6Y.js';
+import { d as ContainerRepository, I as ImageRepository, c as SessionRepository } from '../index--gxNpY5W.js';
 import { E as EventBus } from '../bus-C9FLWIu8.js';
-import { B as BashProvider } from '../types-aE74Eo6G.js';
-import { W as WebSocketFactory } from '../RpcClient-BcJ_zAGu.js';
-import '../message-03TJzvIX.js';
+import { F as ChannelServer, w as ChannelClientFactory } from '../types-CTV8Z9PI.js';
+import '../message-Dn-I2vr0.js';
 import '../base-m40r3Qgu.js';
 import 'jsonrpc-lite';
 
@@ -65,12 +65,20 @@ interface AgentXPlatform {
      */
     readonly bashProvider?: BashProvider;
     /**
-     * WebSocket factory for creating client connections
+     * Channel server for accepting client connections (server-side)
+     *
+     * Optional — only needed for server scenarios.
+     * Node.js platform provides ws-based implementation.
+     * Cloudflare platform provides DO Hibernation API implementation.
+     */
+    readonly channelServer?: ChannelServer;
+    /**
+     * Channel client factory for creating connections (client-side)
      *
      * Optional — browser uses native WebSocket by default.
      * Node.js platform provides ws-based implementation.
      */
-    readonly webSocketFactory?: WebSocketFactory;
+    readonly channelClient?: ChannelClientFactory;
 }
 
 export type { AgentXPlatform };

package/dist/runtime/index.d.ts

@@ -1,10 +1,10 @@
-import { AgentXPlatform } from '../platform/index.js';
-import { b as UserContentPart } from '../message-03TJzvIX.js';
+import { b as UserContentPart } from '../message-Dn-I2vr0.js';
+import { h as CreateDriver } from '../index--gxNpY5W.js';
 import { B as BusEvent } from '../base-m40r3Qgu.js';
-import { h as CreateDriver } from '../index-CuS1i5V-.js';
+import { AgentXPlatform } from '../platform/index.js';
+import '../types-Cb8tKM6Y.js';
 import '../bus-C9FLWIu8.js';
-import '../types-aE74Eo6G.js';
-import '../RpcClient-BcJ_zAGu.js';
+import '../types-CTV8Z9PI.js';
 import 'jsonrpc-lite';
 
 /**

package/dist/runtime/index.js

@@ -3,15 +3,15 @@ import {
 } from "../chunk-BHOD5PKR.js";
 import {
   createAgent
-} from "../chunk-JTKCV7IS.js";
-import "../chunk-DEAR6N3O.js";
-import "../chunk-EKHT54KN.js";
-import "../chunk-23UUBQXR.js";
+} from "../chunk-RWIYC65R.js";
+import "../chunk-TUFZ2YH6.js";
+import "../chunk-APCBNCOW.js";
+import "../chunk-YSZG6XIM.js";
 import {
   createBashTool
 } from "../chunk-FI7WQFGV.js";
-import "../chunk-7ZDX3O6I.js";
-import "../chunk-LTVNPHST.js";
+import "../chunk-AAFPAF67.js";
+import "../chunk-22NTRYNO.js";
 
 // src/runtime/AgentXRuntime.ts
 import { createLogger } from "commonxjs/logger";

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 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":[]}
+{"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 { createAgent as createAgentEngine } from \"../agent/createAgent\";\nimport type {\n  AgentEngine,\n  AgentOutput,\n  AgentPresenter,\n  AgentSource,\n  Message,\n  StreamEvent,\n  UserContentPart,\n  UserMessage,\n} from \"../agent/types\";\nimport { createBashTool } from \"../bash/tool\";\nimport type {\n  CreateDriver,\n  Driver,\n  DriverConfig,\n  DriverStreamEvent,\n  ToolDefinition,\n} from \"../driver/types\";\nimport type { BusEvent } from \"../event/types\";\nimport { createSession } from \"../session/Session\";\nimport type {\n  AgentEventHandler,\n  AgentLifecycle,\n  AgentXPlatform,\n  AgentXRuntime,\n  CreateAgentOptions,\n  RuntimeAgent,\n  Subscription,\n} from \"./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  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,6 +1,6 @@
-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';
+import { M as Message } from '../message-Dn-I2vr0.js';
+import { S as SessionConfig, a as Session } from '../index--gxNpY5W.js';
+export { b as SessionRecord, c as SessionRepository } from '../index--gxNpY5W.js';
 
 /**
  * Session - Manages conversation messages

package/dist/{RpcClient-BcJ_zAGu.d.ts → types-CTV8Z9PI.d.ts}

@@ -1,5 +1,5 @@
-import { JsonRpc, IParsedObject } from 'jsonrpc-lite';
 import { S as SystemEvent } from './base-m40r3Qgu.js';
+import { JsonRpc, IParsedObject } from 'jsonrpc-lite';
 
 /**
  * JSON-RPC 2.0 Protocol for AgentX Network Communication
@@ -185,12 +185,12 @@ declare const rpcMethodToResponseType: Record<RpcMethod, string>;
  */
 
 /**
- * Factory function for creating WebSocket instances.
- * Platform layer provides the implementation:
- * - Browser: native WebSocket (default)
+ * Factory for creating client-side WebSocket connections.
+ * Injected via Platform:
+ * - Browser: native WebSocket (default fallback)
  * - Node.js: ws library (via @agentxjs/node-platform)
  */
-type WebSocketFactory = (url: string) => WebSocket;
+type ChannelClientFactory = (url: string) => WebSocket;
 /**
  * RpcClient configuration
  */
@@ -203,7 +203,7 @@ interface RpcClientConfig {
      * Factory for creating WebSocket instances.
      * If not provided, falls back to the global WebSocket constructor.
      */
-    createWebSocket?: WebSocketFactory;
+    createWebSocket?: ChannelClientFactory;
     /**
      * Request timeout in milliseconds (default: 30000)
      */
@@ -301,4 +301,222 @@ declare class RpcClient {
     private handleParsedMessage;
 }
 
-export { type ControlAckParams as C, type NotificationMethod as N, type RpcMethod as R, type StreamEventParams as S, type WebSocketFactory as W, type RpcRequest as a, type RpcSuccessResponse as b, type RpcErrorResponse as c, type RpcNotification as d, RpcErrorCodes as e, createRequest as f, createNotification as g, createStreamEvent as h, createAckNotification as i, createSuccessResponse as j, createErrorResponse as k, parseMessageObject as l, isRequest as m, isNotification as n, isSuccessResponse as o, parseMessage as p, isErrorResponse as q, isInvalid as r, isStreamEvent as s, isControlAck as t, eventTypeToRpcMethod as u, rpcMethodToResponseType as v, type RpcClientConfig as w, type RpcClientState as x, RpcClient as y };
+/**
+ * Network Types - Channel interfaces for client-server communication
+ *
+ * Provides transport-agnostic interfaces that can be implemented with:
+ * - WebSocket (Node.js, Browser)
+ * - Durable Objects WebSocket (Cloudflare Workers)
+ * - HTTP/2, gRPC, etc.
+ */
+/**
+ * Unsubscribe function type
+ */
+type Unsubscribe = () => void;
+/**
+ * Minimal HTTP server interface for attaching WebSocket
+ * Avoids Node.js dependency in types package
+ */
+interface MinimalHTTPServer {
+    on(event: "upgrade", listener: (request: unknown, socket: unknown, head: unknown) => void): void;
+}
+/**
+ * Options for reliable message sending
+ */
+interface SendReliableOptions {
+    /**
+     * Callback when client acknowledges receipt
+     */
+    onAck?: () => void;
+    /**
+     * Timeout in milliseconds (default: 5000)
+     */
+    timeout?: number;
+    /**
+     * Callback when ACK times out
+     */
+    onTimeout?: () => void;
+}
+/**
+ * ChannelConnection - Server-side representation of a client connection
+ */
+interface ChannelConnection {
+    /**
+     * Unique connection ID
+     */
+    readonly id: string;
+    /**
+     * Send message to this client (fire-and-forget)
+     */
+    send(message: string): void;
+    /**
+     * Send message with acknowledgment
+     *
+     * The message is wrapped with a unique ID. Client automatically sends ACK
+     * when received. Server triggers onAck callback upon receiving ACK.
+     *
+     * This is handled transparently by the Network layer.
+     */
+    sendReliable(message: string, options?: SendReliableOptions): void;
+    /**
+     * Register message handler
+     */
+    onMessage(handler: (message: string) => void): Unsubscribe;
+    /**
+     * Register close handler
+     */
+    onClose(handler: () => void): Unsubscribe;
+    /**
+     * Register error handler
+     */
+    onError(handler: (error: Error) => void): Unsubscribe;
+    /**
+     * Close this connection
+     */
+    close(): void;
+}
+/**
+ * ChannelServer - Accepts client connections
+ */
+interface ChannelServer {
+    /**
+     * Start listening on a port (standalone mode)
+     */
+    listen(port: number, host?: string): Promise<void>;
+    /**
+     * Attach to an existing HTTP server
+     */
+    attach(server: MinimalHTTPServer, path?: string): void;
+    /**
+     * Register connection handler
+     */
+    onConnection(handler: (connection: ChannelConnection) => void): Unsubscribe;
+    /**
+     * Broadcast message to all connected clients
+     */
+    broadcast(message: string): void;
+    /**
+     * Close server and all connections
+     */
+    close(): Promise<void>;
+    /**
+     * Dispose resources
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * ChannelServerOptions - Server configuration
+ */
+interface ChannelServerOptions {
+    /**
+     * Enable heartbeat/ping-pong (default: true)
+     */
+    heartbeat?: boolean;
+    /**
+     * Heartbeat interval in ms (default: 30000)
+     */
+    heartbeatInterval?: number;
+    /**
+     * Enable debug logging (default: false)
+     */
+    debug?: boolean;
+}
+/**
+ * Connection state
+ */
+type ConnectionState = "connecting" | "open" | "closing" | "closed";
+/**
+ * ChannelClient - Connects to server
+ */
+interface ChannelClient {
+    /**
+     * Connection state
+     */
+    readonly readyState: ConnectionState;
+    /**
+     * Connect to server
+     */
+    connect(): Promise<void>;
+    /**
+     * Send message to server
+     */
+    send(message: string): void;
+    /**
+     * Register message handler
+     */
+    onMessage(handler: (message: string) => void): Unsubscribe;
+    /**
+     * Register open handler
+     */
+    onOpen(handler: () => void): Unsubscribe;
+    /**
+     * Register close handler
+     */
+    onClose(handler: () => void): Unsubscribe;
+    /**
+     * Register error handler
+     */
+    onError(handler: (error: Error) => void): Unsubscribe;
+    /**
+     * Close connection
+     */
+    close(): void;
+    /**
+     * Dispose resources
+     */
+    dispose(): void;
+}
+/**
+ * ChannelClientOptions - Client configuration
+ */
+interface ChannelClientOptions {
+    /**
+     * Server URL
+     */
+    serverUrl: string;
+    /**
+     * Enable auto-reconnect (default: true in browser, false in Node.js)
+     */
+    autoReconnect?: boolean;
+    /**
+     * Min reconnection delay in ms (default: 1000)
+     */
+    minReconnectionDelay?: number;
+    /**
+     * Max reconnection delay in ms (default: 10000)
+     */
+    maxReconnectionDelay?: number;
+    /**
+     * Max retry attempts (default: Infinity)
+     */
+    maxRetries?: number;
+    /**
+     * Connection timeout in ms (default: 4000)
+     */
+    connectionTimeout?: number;
+    /**
+     * Enable debug logging (default: false)
+     */
+    debug?: boolean;
+    /**
+     * Custom headers for WebSocket connection
+     *
+     * - Node.js: Headers are sent during WebSocket handshake
+     * - Browser: Headers are sent in first authentication message
+     */
+    headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
+}
+/**
+ * ChannelServerProvider - Factory for creating ChannelServer instances
+ */
+interface ChannelServerProvider {
+    createServer(options?: ChannelServerOptions): ChannelServer;
+}
+/**
+ * ChannelClientProvider - Factory for creating ChannelClient instances
+ */
+interface ChannelClientProvider {
+    createClient(options: ChannelClientOptions): ChannelClient;
+}
+
+export { type ChannelClient as A, type ChannelClientOptions as B, type ControlAckParams as C, type ChannelClientProvider as D, type ChannelConnection as E, type ChannelServer as F, type ChannelServerOptions as G, type ChannelServerProvider as H, type ConnectionState as I, type SendReliableOptions as J, type MinimalHTTPServer as M, type NotificationMethod as N, type RpcErrorResponse as R, type StreamEventParams as S, type Unsubscribe as U, type RpcMethod as a, type RpcNotification as b, type RpcRequest as c, type RpcSuccessResponse as d, createAckNotification as e, createErrorResponse as f, createNotification as g, createRequest as h, createStreamEvent as i, createSuccessResponse as j, eventTypeToRpcMethod as k, isControlAck as l, isErrorResponse as m, isInvalid as n, isNotification as o, isRequest as p, isStreamEvent as q, isSuccessResponse as r, parseMessage as s, parseMessageObject as t, RpcErrorCodes as u, rpcMethodToResponseType as v, type ChannelClientFactory as w, type RpcClientConfig as x, type RpcClientState as y, RpcClient as z };

package/dist/{types-aE74Eo6G.d.ts → types-Cb8tKM6Y.d.ts}

@@ -87,4 +87,4 @@ interface BashProvider {
     execute(command: string, options?: BashOptions): Promise<BashResult>;
 }
 
-export type { BashProvider as B, BashResult as a, BashOptions as b };
+export type { BashProvider as B, BashOptions as a, BashResult as b };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentxjs/core",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/agent/AgentStateMachine.ts

@@ -13,15 +13,15 @@
  * - Notify state change subscribers
  */
 
+import { createLogger } from "commonxjs/logger";
 import type {
+  AgentOutput,
   AgentState,
   StateChange,
   StateChangeHandler,
-  AgentOutput,
   Unsubscribe,
 } from "./types";
 import { isStateEvent } from "./types";
-import { createLogger } from "commonxjs/logger";
 
 const logger = createLogger("agent/AgentStateMachine");
 

package/src/agent/__tests__/AgentStateMachine.test.ts

@@ -5,9 +5,9 @@
  * driven by StateEvents from the MealyMachine.
  */
 
-import { describe, it, expect, beforeEach } from "bun:test";
+import { beforeEach, describe, expect, it } from "bun:test";
 import { AgentStateMachine } from "../AgentStateMachine";
-import type { AgentState, StateChange, AgentOutput } from "../types";
+import type { AgentOutput, AgentState, StateChange } from "../types";
 
 // Helper to create test events
 function createStateEvent(type: string, data: unknown = {}): AgentOutput {

package/src/agent/__tests__/createAgent.test.ts

@@ -5,14 +5,14 @@
  * Uses MockEventBus to simulate Driver behavior.
  */
 
-import { describe, it, expect, beforeEach } from "bun:test";
+import { beforeEach, describe, expect, it } from "bun:test";
 import { createAgent } from "../createAgent";
 import type {
   AgentEventBus,
-  UserMessage,
-  StreamEvent,
   AgentOutput,
   CreateAgentOptions,
+  StreamEvent,
+  UserMessage,
 } from "../types";
 
 /**
@@ -484,7 +484,7 @@ describe("createAgent", () => {
       agent.use(async (message, next) => {
         const modified: UserMessage = {
           ...message,
-          content: message.content + " MODIFIED",
+          content: `${message.content} MODIFIED`,
         };
         await next(modified);
       });

package/src/agent/__tests__/engine/internal/messageAssemblerProcessor.test.ts

@@ -5,13 +5,13 @@
  * from Stream Layer events.
  */
 
-import { describe, it, expect, beforeEach } from "bun:test";
+import { beforeEach, describe, expect, it } from "bun:test";
 import {
-  messageAssemblerProcessor,
   createInitialMessageAssemblerState,
-  type MessageAssemblerState,
   type MessageAssemblerInput,
   type MessageAssemblerOutput,
+  type MessageAssemblerState,
+  messageAssemblerProcessor,
 } from "../../../engine/internal/messageAssemblerProcessor";
 
 // Helper to create test events
@@ -251,7 +251,7 @@ describe("messageAssemblerProcessor", () => {
       expect(newState.pendingContents[0].parsedInput).toEqual({ x: 10, y: 20 });
 
       // Should add to pending tool calls
-      expect(newState.pendingToolCalls["tool_123"]).toEqual({
+      expect(newState.pendingToolCalls.tool_123).toEqual({
         id: "tool_123",
         name: "calculate",
       });
@@ -289,7 +289,7 @@ describe("messageAssemblerProcessor", () => {
   describe("tool_result event", () => {
     it("should emit tool_result_message event", () => {
       // Setup: pending tool call
-      state.pendingToolCalls["tool_123"] = {
+      state.pendingToolCalls.tool_123 = {
         id: "tool_123",
         name: "calculate",
       };
@@ -315,11 +315,11 @@ describe("messageAssemblerProcessor", () => {
       expect(toolResultMessage.toolResult.output.value).toBe("42");
 
       // Should remove from pending tool calls
-      expect(newState.pendingToolCalls["tool_123"]).toBeUndefined();
+      expect(newState.pendingToolCalls.tool_123).toBeUndefined();
     });
 
     it("should handle error results", () => {
-      state.pendingToolCalls["tool_123"] = {
+      state.pendingToolCalls.tool_123 = {
         id: "tool_123",
         name: "test",
       };
@@ -410,7 +410,7 @@ describe("messageAssemblerProcessor", () => {
 
     it("should preserve pending tool calls when stopReason is tool_use", () => {
       state.currentMessageId = "msg_123";
-      state.pendingToolCalls["tool_123"] = { id: "tool_123", name: "test" };
+      state.pendingToolCalls.tool_123 = { id: "tool_123", name: "test" };
       state.pendingContents = [
         {
           type: "tool_use",
@@ -434,12 +434,12 @@ describe("messageAssemblerProcessor", () => {
       expect(content[0].type).toBe("tool-call");
       expect(content[0].id).toBe("tool_123");
 
-      expect(newState.pendingToolCalls["tool_123"]).toBeDefined();
+      expect(newState.pendingToolCalls.tool_123).toBeDefined();
     });
 
     it("should clear pending tool calls for non-tool_use stop reason", () => {
       state.currentMessageId = "msg_123";
-      state.pendingToolCalls["tool_123"] = { id: "tool_123", name: "test" };
+      state.pendingToolCalls.tool_123 = { id: "tool_123", name: "test" };
       state.pendingContents = [
         {
           type: "text",