@agentxjs/types 0.0.6 → 0.2.0

package/dist/event.js

@@ -0,0 +1,134 @@
+// src/event/base/SystemEvent.ts
+function isFromSource(event, source) {
+  return event.source === source;
+}
+function hasIntent(event, intent) {
+  return event.intent === intent;
+}
+function isRequest(event) {
+  return event.intent === "request";
+}
+function isResult(event) {
+  return event.intent === "result";
+}
+function isNotification(event) {
+  return event.intent === "notification";
+}
+
+// src/event/environment/DriveableEvent.ts
+function isDriveableEvent(event) {
+  return event.source === "environment" && event.category === "stream";
+}
+
+// src/event/environment/ConnectionEvent.ts
+function isConnectionEvent(event) {
+  return event.source === "environment" && event.category === "connection";
+}
+
+// src/event/container/lifecycle/index.ts
+function isContainerLifecycleEvent(event) {
+  return event.source === "container" && event.category === "lifecycle";
+}
+
+// src/event/container/sandbox/workdir/index.ts
+function isWorkdirEvent(event) {
+  return event.source === "sandbox" && event.category === "workdir";
+}
+
+// src/event/container/sandbox/mcp/index.ts
+function isMCPEvent(event) {
+  return event.source === "sandbox" && event.category === "mcp";
+}
+
+// src/event/container/sandbox/index.ts
+function isSandboxEvent(event) {
+  return event.source === "sandbox";
+}
+
+// src/event/container/index.ts
+function isContainerEvent(event) {
+  return event.source === "container" || event.source === "sandbox";
+}
+
+// src/event/session/lifecycle/index.ts
+function isSessionLifecycleEvent(event) {
+  return event.source === "session" && event.category === "lifecycle";
+}
+
+// src/event/session/persist/index.ts
+function isSessionPersistEvent(event) {
+  return event.source === "session" && event.category === "persist";
+}
+
+// src/event/session/action/index.ts
+function isSessionActionEvent(event) {
+  return event.source === "session" && event.category === "action";
+}
+
+// src/event/session/index.ts
+function isSessionEvent(event) {
+  return event.source === "session";
+}
+
+// src/event/command/CommandEvent.ts
+function isCommandEvent(event) {
+  return event.source === "command";
+}
+function isCommandRequest(event) {
+  return event.source === "command" && event.category === "request";
+}
+function isCommandResponse(event) {
+  return event.source === "command" && event.category === "response";
+}
+
+// src/event/agent/stream/index.ts
+function isAgentStreamEvent(event) {
+  return event.source === "agent" && event.category === "stream";
+}
+
+// src/event/agent/state/index.ts
+function isAgentStateEvent(event) {
+  return event.source === "agent" && event.category === "state";
+}
+
+// src/event/agent/message/index.ts
+function isAgentMessageEvent(event) {
+  return event.source === "agent" && event.category === "message";
+}
+
+// src/event/agent/turn/index.ts
+function isAgentTurnEvent(event) {
+  return event.source === "agent" && event.category === "turn";
+}
+
+// src/event/agent/index.ts
+function isAgentEvent(event) {
+  return event.source === "agent";
+}
+export {
+  hasIntent,
+  isAgentEvent,
+  isAgentMessageEvent,
+  isAgentStateEvent,
+  isAgentStreamEvent,
+  isAgentTurnEvent,
+  isCommandEvent,
+  isCommandRequest,
+  isCommandResponse,
+  isConnectionEvent,
+  isContainerEvent,
+  isContainerLifecycleEvent,
+  isDriveableEvent,
+  isFromSource,
+  isMCPEvent,
+  isNotification,
+  isRequest,
+  isResult,
+  isSandboxEvent,
+  isSessionActionEvent,
+  isSessionEvent,
+  isSessionLifecycleEvent,
+  isSessionPersistEvent,
+  isWorkdirEvent
+};
+//# sourceMappingURL=event.js.map

package/dist/event.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/event/base/SystemEvent.ts","../src/event/environment/DriveableEvent.ts","../src/event/environment/ConnectionEvent.ts","../src/event/container/lifecycle/index.ts","../src/event/container/sandbox/workdir/index.ts","../src/event/container/sandbox/mcp/index.ts","../src/event/container/sandbox/index.ts","../src/event/container/index.ts","../src/event/session/lifecycle/index.ts","../src/event/session/persist/index.ts","../src/event/session/action/index.ts","../src/event/session/index.ts","../src/event/command/CommandEvent.ts","../src/event/agent/stream/index.ts","../src/event/agent/state/index.ts","../src/event/agent/message/index.ts","../src/event/agent/turn/index.ts","../src/event/agent/index.ts"],"sourcesContent":["/**\n * SystemEvent - Base interface for all events in the system\n *\n * Unified Event Structure:\n * ```\n * SystemEvent\n * │\n * │  All events have: type, timestamp, data, source, category, intent\n * │\n * ├── source: \"command\"       ← API operations (request/response)\n * │   ├── category: \"request\"   → container_create_request, agent_run_request...\n * │   └── category: \"response\"  → container_create_response, agent_run_response...\n * │\n * ├── source: \"environment\"   ← External world (Claude API, Network)\n * │   ├── category: \"stream\"    → message_start, text_delta, message_stop, tool_call...\n * │   └── category: \"connection\"→ connected, disconnected, reconnecting\n * │\n * ├── source: \"container\"     ← Container operations\n * │   └── category: \"lifecycle\" → container_created, container_destroyed, agent_registered...\n * │\n * ├── source: \"session\"       ← Session operations\n * │   ├── category: \"lifecycle\" → session_created, session_destroyed\n * │   ├── category: \"persist\"   → session_saved, message_persisted\n * │   └── category: \"action\"    → session_resumed, session_forked\n * │\n * ├── source: \"sandbox\"       ← Sandbox resources\n * │   ├── category: \"workdir\"   → file_read, file_written\n * │   └── category: \"mcp\"       → tool_execute, mcp_server_connected\n * │\n * └── source: \"agent\"         ← Agent internal\n *     ├── category: \"stream\"    → (forwarded from environment)\n *     ├── category: \"state\"     → state transitions\n *     ├── category: \"message\"   → complete messages\n *     └── category: \"turn\"      → conversation turns\n * ```\n *\n * Design Principles:\n * - Unified: All events share the same base structure\n * - Self-describing: source/category/intent tell you everything\n * - Filterable: Easy to subscribe by source, category, or type\n */\n\n// ============================================================================\n// Event Classification Types\n// ============================================================================\n\n/**\n * Event source - where the event originated\n */\nexport type EventSource =\n  | \"environment\" // External world (Claude API, Network)\n  | \"agent\" // Agent internal\n  | \"session\" // Session operations\n  | \"container\" // Container operations\n  | \"sandbox\" // Sandbox resources (Workspace, MCP)\n  | \"command\"; // Command request/response (API operations)\n\n/**\n * Event intent - what the event represents\n */\nexport type EventIntent =\n  | \"request\" // Request to perform action (may be forwarded or executed)\n  | \"result\" // Result of completed action\n  | \"notification\"; // State change notification (no action needed)\n\n/**\n * Event category - fine-grained classification within source\n */\nexport type EventCategory =\n  // Environment categories\n  | \"stream\" // Streaming output from LLM\n  | \"connection\" // Network connection status\n  // Agent categories\n  | \"state\" // State transitions\n  | \"message\" // Complete messages\n  | \"turn\" // Conversation turns\n  | \"error\" // Errors\n  // Session categories\n  | \"lifecycle\" // Creation/destruction\n  | \"persist\" // Persistence operations\n  | \"action\" // User actions (resume, fork)\n  // Sandbox categories\n  | \"workdir\" // File operations\n  | \"mcp\" // MCP tool operations\n  // Command categories (API request/response)\n  | \"request\" // Request to perform action\n  | \"response\"; // Response with result\n\n// ============================================================================\n// Event Context\n// ============================================================================\n\n/**\n * EventContext - Scope information attached to events\n */\nexport interface EventContext {\n  /**\n   * Container ID (isolation boundary)\n   */\n  containerId?: string;\n\n  /**\n   * Image ID (persistent conversation identity)\n   */\n  imageId?: string;\n\n  /**\n   * Agent ID (if event is agent-scoped)\n   */\n  agentId?: string;\n\n  /**\n   * Session ID (if event is session-scoped)\n   */\n  sessionId?: string;\n\n  /**\n   * Turn ID (for correlating events within a single turn)\n   * A turn = one user message + assistant response cycle\n   */\n  turnId?: string;\n\n  /**\n   * Correlation ID (for request-response tracking)\n   */\n  correlationId?: string;\n}\n\n// ============================================================================\n// SystemEvent - The One Event Type\n// ============================================================================\n\n/**\n * SystemEvent - Base interface for ALL events in the system\n *\n * Every event has:\n * - type: What happened (e.g., \"text_delta\", \"session_saved\")\n * - timestamp: When it happened\n * - data: Event payload\n * - source: Where it came from\n * - category: What kind of event\n * - intent: What it means (notification/request/result)\n * - context: Optional scope information\n * - broadcastable: Whether to broadcast to external clients (default: true)\n */\nexport interface SystemEvent<\n  T extends string = string,\n  D = unknown,\n  S extends EventSource = EventSource,\n  C extends EventCategory = EventCategory,\n  I extends EventIntent = EventIntent,\n> {\n  /**\n   * Event type identifier (e.g., \"text_delta\", \"session_saved\")\n   */\n  readonly type: T;\n\n  /**\n   * Event timestamp (Unix milliseconds)\n   */\n  readonly timestamp: number;\n\n  /**\n   * Event payload data\n   */\n  readonly data: D;\n\n  /**\n   * Event source - where the event originated\n   */\n  readonly source: S;\n\n  /**\n   * Event category - fine-grained classification\n   */\n  readonly category: C;\n\n  /**\n   * Event intent - what the event represents\n   */\n  readonly intent: I;\n\n  /**\n   * Event context - scope information (optional)\n   */\n  readonly context?: EventContext;\n\n  /**\n   * Whether to broadcast this event to external clients (SSE/WebSocket)\n   *\n   * - true or undefined: Broadcast to all external clients\n   * - false: Only consumed internally, not broadcast\n   *\n   * Used for internal events like DriveableEvent that should be\n   * processed by the engine but not sent directly to clients.\n   * @default true\n   */\n  readonly broadcastable?: boolean;\n}\n\n// ============================================================================\n// Type Guards\n// ============================================================================\n\n/**\n * Check if event is from a specific source\n */\nexport function isFromSource<S extends EventSource>(\n  event: SystemEvent,\n  source: S\n): event is SystemEvent<string, unknown, S> {\n  return event.source === source;\n}\n\n/**\n * Check if event has a specific intent\n */\nexport function hasIntent<I extends EventIntent>(\n  event: SystemEvent,\n  intent: I\n): event is SystemEvent<string, unknown, EventSource, EventCategory, I> {\n  return event.intent === intent;\n}\n\n/**\n * Check if event is a request\n */\nexport function isRequest(event: SystemEvent): boolean {\n  return event.intent === \"request\";\n}\n\n/**\n * Check if event is a result\n */\nexport function isResult(event: SystemEvent): boolean {\n  return event.intent === \"result\";\n}\n\n/**\n * Check if event is a notification\n */\nexport function isNotification(event: SystemEvent): boolean {\n  return event.intent === \"notification\";\n}\n","/**\n * DriveableEvent - Events from LLM that can drive Agent\n *\n * These are environment events with:\n * - source: \"environment\"\n * - category: \"stream\"\n * - intent: \"notification\"\n *\n * Flow:\n * 1. Receptor receives from Claude SDK\n * 2. Receptor emits DriveableEvent to SystemBus\n * 3. BusDriver listens and forwards to Agent\n * 4. Agent Engine processes the event\n */\n\nimport type { SystemEvent } from \"../base\";\nimport type { StopReason } from \"~/runtime/internal/container/llm/StopReason\";\n\n// ============================================================================\n// Base Type for Stream Events\n// ============================================================================\n\n/**\n * Base interface for all LLM stream events\n *\n * All DriveableEvents have:\n * - source: \"environment\" (from external LLM)\n * - category: \"stream\" (streaming output)\n * - intent: \"notification\" (informational, no action needed)\n * - requestId: correlation with the original request\n * - context: agent/image/session scope (inherited from SystemEvent)\n */\ninterface BaseStreamEvent<T extends string, D = unknown>\n  extends SystemEvent<T, D, \"environment\", \"stream\", \"notification\"> {\n  /**\n   * Content block index (for multi-block responses)\n   */\n  index?: number;\n\n  /**\n   * Request ID for correlating events with the original message_send_request\n   */\n  requestId?: string;\n}\n\n// ============================================================================\n// Message Lifecycle Events\n// ============================================================================\n\n/**\n * MessageStartEvent - Emitted when streaming message begins\n */\nexport interface MessageStartEvent\n  extends BaseStreamEvent<\n    \"message_start\",\n    {\n      message: {\n        id: string;\n        model: string;\n      };\n    }\n  > {}\n\n/**\n * MessageDeltaEvent - Emitted with message-level updates\n */\nexport interface MessageDeltaEvent\n  extends BaseStreamEvent<\n    \"message_delta\",\n    {\n      usage?: {\n        inputTokens: number;\n        outputTokens: number;\n      };\n    }\n  > {}\n\n/**\n * MessageStopEvent - Emitted when streaming message completes\n */\nexport interface MessageStopEvent\n  extends BaseStreamEvent<\n    \"message_stop\",\n    {\n      stopReason?: StopReason;\n      stopSequence?: string;\n    }\n  > {}\n\n// ============================================================================\n// Text Content Block Events\n// ============================================================================\n\n/**\n * TextContentBlockStartEvent - Text block started\n */\nexport interface TextContentBlockStartEvent\n  extends BaseStreamEvent<\"text_content_block_start\", Record<string, never>> {\n  index: number;\n}\n\n/**\n * TextDeltaEvent - Incremental text output\n */\nexport interface TextDeltaEvent\n  extends BaseStreamEvent<\n    \"text_delta\",\n    {\n      text: string;\n    }\n  > {}\n\n/**\n * TextContentBlockStopEvent - Text block completed\n */\nexport interface TextContentBlockStopEvent\n  extends BaseStreamEvent<\"text_content_block_stop\", Record<string, never>> {\n  index: number;\n}\n\n// ============================================================================\n// Tool Use Content Block Events\n// ============================================================================\n\n/**\n * ToolUseContentBlockStartEvent - Tool use block started\n */\nexport interface ToolUseContentBlockStartEvent\n  extends BaseStreamEvent<\n    \"tool_use_content_block_start\",\n    {\n      id: string;\n      name: string;\n    }\n  > {\n  index: number;\n}\n\n/**\n * InputJsonDeltaEvent - Incremental tool input JSON\n */\nexport interface InputJsonDeltaEvent\n  extends BaseStreamEvent<\n    \"input_json_delta\",\n    {\n      partialJson: string;\n    }\n  > {\n  index: number;\n}\n\n/**\n * ToolUseContentBlockStopEvent - Tool use block completed\n */\nexport interface ToolUseContentBlockStopEvent\n  extends BaseStreamEvent<\"tool_use_content_block_stop\", Record<string, never>> {\n  index: number;\n}\n\n// ============================================================================\n// Tool Execution Events\n// ============================================================================\n\n/**\n * ToolCallEvent - Tool call ready for execution\n */\nexport interface ToolCallEvent\n  extends BaseStreamEvent<\n    \"tool_call\",\n    {\n      id: string;\n      name: string;\n      input: Record<string, unknown>;\n    }\n  > {}\n\n/**\n * ToolResultEvent - Tool execution result\n */\nexport interface ToolResultEvent\n  extends BaseStreamEvent<\n    \"tool_result\",\n    {\n      toolUseId: string;\n      result: unknown;\n      isError?: boolean;\n    }\n  > {}\n\n// ============================================================================\n// Interrupt Event\n// ============================================================================\n\n/**\n * InterruptedEvent - Stream interrupted\n */\nexport interface InterruptedEvent\n  extends BaseStreamEvent<\n    \"interrupted\",\n    {\n      reason: \"user_interrupt\" | \"timeout\" | \"error\" | \"system\";\n    }\n  > {}\n\n// ============================================================================\n// Error Event\n// ============================================================================\n\n/**\n * ErrorReceivedEvent - Error received from environment (e.g., Claude API error)\n *\n * This event drives the MealyMachine to produce:\n * - error_occurred (StateEvent) → state transitions to \"error\"\n * - error_message (MessageEvent) → displayed in chat\n */\nexport interface ErrorReceivedEvent\n  extends BaseStreamEvent<\n    \"error_received\",\n    {\n      /** Error message (human-readable) */\n      message: string;\n      /** Error code (e.g., \"rate_limit_error\", \"api_error\", \"overloaded_error\") */\n      errorCode?: string;\n    }\n  > {}\n\n// ============================================================================\n// Union Type\n// ============================================================================\n\n/**\n * DriveableEvent - All events that can drive Agent\n */\nexport type DriveableEvent =\n  // Message lifecycle\n  | MessageStartEvent\n  | MessageDeltaEvent\n  | MessageStopEvent\n  // Text content block\n  | TextContentBlockStartEvent\n  | TextDeltaEvent\n  | TextContentBlockStopEvent\n  // Tool use content block\n  | ToolUseContentBlockStartEvent\n  | InputJsonDeltaEvent\n  | ToolUseContentBlockStopEvent\n  // Tool execution\n  | ToolCallEvent\n  | ToolResultEvent\n  // Interrupt\n  | InterruptedEvent\n  // Error\n  | ErrorReceivedEvent;\n\n/**\n * DriveableEventType - String literal union of all driveable event types\n */\nexport type DriveableEventType = DriveableEvent[\"type\"];\n\n/**\n * Type guard: is this a DriveableEvent?\n */\nexport function isDriveableEvent(event: SystemEvent): event is DriveableEvent {\n  return event.source === \"environment\" && event.category === \"stream\";\n}\n","/**\n * ConnectionEvent - Network connection status events\n *\n * These events notify about network connection status.\n * They do NOT drive the Agent (not processed by AgentEngine).\n *\n * All ConnectionEvents have:\n * - source: \"environment\"\n * - category: \"connection\"\n * - intent: \"notification\"\n */\n\nimport type { SystemEvent } from \"../base\";\n\n// ============================================================================\n// Base Type for Connection Events\n// ============================================================================\n\n/**\n * Base interface for all connection events\n */\ninterface BaseConnectionEvent<T extends string, D = unknown>\n  extends SystemEvent<T, D, \"environment\", \"connection\", \"notification\"> {}\n\n// ============================================================================\n// Connection Events\n// ============================================================================\n\n/**\n * ConnectedEvent - Connection established\n */\nexport interface ConnectedEvent\n  extends BaseConnectionEvent<\n    \"connected\",\n    {\n      url?: string;\n      reconnectAttempt?: number;\n    }\n  > {}\n\n/**\n * DisconnectedEvent - Connection lost\n */\nexport interface DisconnectedEvent\n  extends BaseConnectionEvent<\n    \"disconnected\",\n    {\n      reason?: string;\n      code?: number;\n      willReconnect?: boolean;\n    }\n  > {}\n\n/**\n * ReconnectingEvent - Attempting to reconnect\n */\nexport interface ReconnectingEvent\n  extends BaseConnectionEvent<\n    \"reconnecting\",\n    {\n      attempt: number;\n      maxAttempts?: number;\n      delayMs: number;\n    }\n  > {}\n\n// ============================================================================\n// Union Type\n// ============================================================================\n\n/**\n * ConnectionEvent - All network status events\n */\nexport type ConnectionEvent = ConnectedEvent | DisconnectedEvent | ReconnectingEvent;\n\n/**\n * ConnectionEventType - String literal union\n */\nexport type ConnectionEventType = ConnectionEvent[\"type\"];\n\n/**\n * Type guard: is this a ConnectionEvent?\n */\nexport function isConnectionEvent(event: SystemEvent): event is ConnectionEvent {\n  return event.source === \"environment\" && event.category === \"connection\";\n}\n","/**\n * Container Lifecycle Events\n *\n * Events for container creation, destruction, and agent management.\n *\n * All ContainerLifecycleEvents have:\n * - source: \"container\"\n * - category: \"lifecycle\"\n * - intent: \"notification\"\n */\n\nimport type { SystemEvent } from \"../../base\";\n\n// ============================================================================\n// Base Type\n// ============================================================================\n\n/**\n * Base ContainerLifecycleEvent\n */\ninterface BaseContainerLifecycleEvent<T extends string, D = unknown>\n  extends SystemEvent<T, D, \"container\", \"lifecycle\", \"notification\"> {}\n\n// ============================================================================\n// Container Lifecycle Events\n// ============================================================================\n\n/**\n * ContainerCreatedEvent - Container was created\n */\nexport interface ContainerCreatedEvent\n  extends BaseContainerLifecycleEvent<\n    \"container_created\",\n    {\n      containerId: string;\n      name?: string;\n      createdAt: number;\n    }\n  > {}\n\n/**\n * ContainerDestroyedEvent - Container was destroyed\n */\nexport interface ContainerDestroyedEvent\n  extends BaseContainerLifecycleEvent<\n    \"container_destroyed\",\n    {\n      containerId: string;\n      reason?: string;\n      agentCount: number;\n    }\n  > {}\n\n// ============================================================================\n// Agent Registration Events\n// ============================================================================\n\n/**\n * AgentRegisteredEvent - Agent was registered to container\n */\nexport interface AgentRegisteredEvent\n  extends BaseContainerLifecycleEvent<\n    \"agent_registered\",\n    {\n      containerId: string;\n      agentId: string;\n      definitionName: string;\n      registeredAt: number;\n    }\n  > {}\n\n/**\n * AgentUnregisteredEvent - Agent was unregistered from container\n */\nexport interface AgentUnregisteredEvent\n  extends BaseContainerLifecycleEvent<\n    \"agent_unregistered\",\n    {\n      containerId: string;\n      agentId: string;\n      reason?: string;\n    }\n  > {}\n\n// ============================================================================\n// Union Type\n// ============================================================================\n\n/**\n * ContainerLifecycleEvent - All container lifecycle events\n */\nexport type ContainerLifecycleEvent =\n  | ContainerCreatedEvent\n  | ContainerDestroyedEvent\n  | AgentRegisteredEvent\n  | AgentUnregisteredEvent;\n\n/**\n * Type guard: is this a ContainerLifecycleEvent?\n */\nexport function isContainerLifecycleEvent(event: SystemEvent): event is ContainerLifecycleEvent {\n  return event.source === \"container\" && event.category === \"lifecycle\";\n}\n","/**\n * Sandbox Workdir Events\n *\n * Events for file system operations in the agent's working directory.\n *\n * All WorkdirEvents have:\n * - source: \"sandbox\"\n * - category: \"workdir\"\n * - intent: \"request\" | \"result\" | \"notification\"\n */\n\nimport type { SystemEvent } from \"~/event/base\";\n\n// ============================================================================\n// Base Types\n// ============================================================================\n\n/**\n * Base WorkdirRequest\n */\ninterface BaseWorkdirRequest<T extends string, D = unknown>\n  extends SystemEvent<T, D, \"sandbox\", \"workdir\", \"request\"> {}\n\n/**\n * Base WorkdirResult\n */\ninterface BaseWorkdirResult<T extends string, D = unknown>\n  extends SystemEvent<T, D, \"sandbox\", \"workdir\", \"result\"> {}\n\n/**\n * Base WorkdirNotification\n */\ninterface BaseWorkdirNotification<T extends string, D = unknown>\n  extends SystemEvent<T, D, \"sandbox\", \"workdir\", \"notification\"> {}\n\n// ============================================================================\n// File Read Events\n// ============================================================================\n\n/**\n * FileReadRequest - Request to read a file\n */\nexport interface FileReadRequest\n  extends BaseWorkdirRequest<\n    \"file_read_request\",\n    {\n      path: string;\n      encoding?: string;\n    }\n  > {}\n\n/**\n * FileReadResult - File read result\n */\nexport interface FileReadResult\n  extends BaseWorkdirResult<\n    \"file_read_result\",\n    {\n      path: string;\n      content: string;\n      size: number;\n      encoding: string;\n    }\n  > {}\n\n// ============================================================================\n// File Write Events\n// ============================================================================\n\n/**\n * FileWriteRequest - Request to write a file\n */\nexport interface FileWriteRequest\n  extends BaseWorkdirRequest<\n    \"file_write_request\",\n    {\n      path: string;\n      content: string;\n      encoding?: string;\n      createDirectories?: boolean;\n    }\n  > {}\n\n/**\n * FileWrittenEvent - File was written\n */\nexport interface FileWrittenEvent\n  extends BaseWorkdirResult<\n    \"file_written\",\n    {\n      path: string;\n      size: number;\n      timestamp: number;\n    }\n  > {}\n\n// ============================================================================\n// File Delete Events\n// ============================================================================\n\n/**\n * FileDeleteRequest - Request to delete a file\n */\nexport interface FileDeleteRequest\n  extends BaseWorkdirRequest<\n    \"file_delete_request\",\n    {\n      path: string;\n      recursive?: boolean;\n    }\n  > {}\n\n/**\n * FileDeletedEvent - File was deleted\n */\nexport interface FileDeletedEvent\n  extends BaseWorkdirResult<\n    \"file_deleted\",\n    {\n      path: string;\n      timestamp: number;\n    }\n  > {}\n\n// ============================================================================\n// Directory Events\n// ============================================================================\n\n/**\n * DirectoryListRequest - Request to list directory\n */\nexport interface DirectoryListRequest\n  extends BaseWorkdirRequest<\n    \"directory_list_request\",\n    {\n      path: string;\n      recursive?: boolean;\n      pattern?: string;\n    }\n  > {}\n\n/**\n * DirectoryListResult - Directory listing result\n */\nexport interface DirectoryListResult\n  extends BaseWorkdirResult<\n    \"directory_list_result\",\n    {\n      path: string;\n      entries: Array<{\n        name: string;\n        type: \"file\" | \"directory\";\n        size?: number;\n        modifiedAt?: number;\n      }>;\n    }\n  > {}\n\n// ============================================================================\n// Error Event\n// ============================================================================\n\n/**\n * WorkdirErrorEvent - Workdir operation error\n */\nexport interface WorkdirErrorEvent\n  extends BaseWorkdirNotification<\n    \"workdir_error\",\n    {\n      operation: string;\n      path: string;\n      code: string;\n      message: string;\n    }\n  > {}\n\n// ============================================================================\n// Union Type\n// ============================================================================\n\n/**\n * WorkdirEvent - All workdir events\n */\nexport type WorkdirEvent =\n  | FileReadRequest\n  | FileReadResult\n  | FileWriteRequest\n  | FileWrittenEvent\n  | FileDeleteRequest\n  | FileDeletedEvent\n  | DirectoryListRequest\n  | DirectoryListResult\n  | WorkdirErrorEvent;\n\n/**\n * Workdir request events\n */\nexport type WorkdirRequestEvent =\n  | FileReadRequest\n  | FileWriteRequest\n  | FileDeleteRequest\n  | DirectoryListRequest;\n\n/**\n * Workdir result events\n */\nexport type WorkdirResultEvent =\n  | FileReadResult\n  | FileWrittenEvent\n  | FileDeletedEvent\n  | DirectoryListResult;\n\n/**\n * Type guard: is this a WorkdirEvent?\n */\nexport function isWorkdirEvent(event: SystemEvent): event is WorkdirEvent {\n  return event.source === \"sandbox\" && event.category === \"workdir\";\n}\n","/**\n * Sandbox MCP Events\n *\n * Events for MCP (Model Context Protocol) tool operations.\n *\n * All MCPEvents have:\n * - source: \"sandbox\"\n * - category: \"mcp\"\n * - intent: \"request\" | \"result\" | \"notification\"\n */\n\nimport type { SystemEvent } from \"~/event/base\";\n\n// ============================================================================\n// Base Types\n// ============================================================================\n\n/**\n * Base MCPRequest\n */\ninterface BaseMCPRequest<T extends string, D = unknown>\n  extends SystemEvent<T, D, \"sandbox\", \"mcp\", \"request\"> {}\n\n/**\n * Base MCPResult\n */\ninterface BaseMCPResult<T extends string, D = unknown>\n  extends SystemEvent<T, D, \"sandbox\", \"mcp\", \"result\"> {}\n\n/**\n * Base MCPNotification\n */\ninterface BaseMCPNotification<T extends string, D = unknown>\n  extends SystemEvent<T, D, \"sandbox\", \"mcp\", \"notification\"> {}\n\n// ============================================================================\n// Tool Execution Events\n// ============================================================================\n\n/**\n * ToolExecuteRequest - Request to execute a tool\n */\nexport interface ToolExecuteRequest\n  extends BaseMCPRequest<\n    \"tool_execute_request\",\n    {\n      toolId: string;\n      toolName: string;\n      serverName: string;\n      input: Record<string, unknown>;\n      timestamp: number;\n    }\n  > {}\n\n/**\n * ToolExecutedEvent - Tool execution completed\n */\nexport interface ToolExecutedEvent\n  extends BaseMCPResult<\n    \"tool_executed\",\n    {\n      toolId: string;\n      toolName: string;\n      result: unknown;\n      duration: number;\n      timestamp: number;\n    }\n  > {}\n\n/**\n * ToolExecutionErrorEvent - Tool execution failed\n */\nexport interface ToolExecutionErrorEvent\n  extends BaseMCPNotification<\n    \"tool_execution_error\",\n    {\n      toolId: string;\n      toolName: string;\n      code: string;\n      message: string;\n      timestamp: number;\n    }\n  > {}\n\n// ============================================================================\n// MCP Server Events\n// ============================================================================\n\n/**\n * MCPServerConnectedEvent - MCP server connected\n */\nexport interface MCPServerConnectedEvent\n  extends BaseMCPNotification<\n    \"mcp_server_connected\",\n    {\n      serverName: string;\n      version?: string;\n      toolCount: number;\n      resourceCount: number;\n      timestamp: number;\n    }\n  > {}\n\n/**\n * MCPServerDisconnectedEvent - MCP server disconnected\n */\nexport interface MCPServerDisconnectedEvent\n  extends BaseMCPNotification<\n    \"mcp_server_disconnected\",\n    {\n      serverName: string;\n      reason?: string;\n      timestamp: number;\n    }\n  > {}\n\n// ============================================================================\n// Resource Events\n// ============================================================================\n\n/**\n * ResourceReadRequest - Request to read an MCP resource\n */\nexport interface ResourceReadRequest\n  extends BaseMCPRequest<\n    \"resource_read_request\",\n    {\n      serverName: string;\n      uri: string;\n    }\n  > {}\n\n/**\n * ResourceReadResult - Resource read result\n */\nexport interface ResourceReadResult\n  extends BaseMCPResult<\n    \"resource_read_result\",\n    {\n      serverName: string;\n      uri: string;\n      content: unknown;\n      mimeType?: string;\n    }\n  > {}\n\n// ============================================================================\n// Union Type\n// ============================================================================\n\n/**\n * MCPEvent - All MCP events\n */\nexport type MCPEvent =\n  | ToolExecuteRequest\n  | ToolExecutedEvent\n  | ToolExecutionErrorEvent\n  | MCPServerConnectedEvent\n  | MCPServerDisconnectedEvent\n  | ResourceReadRequest\n  | ResourceReadResult;\n\n/**\n * MCP request events\n */\nexport type MCPRequestEvent = ToolExecuteRequest | ResourceReadRequest;\n\n/**\n * MCP result events\n */\nexport type MCPResultEvent = ToolExecutedEvent | ResourceReadResult;\n\n/**\n * Type guard: is this a MCPEvent?\n */\nexport function isMCPEvent(event: SystemEvent): event is MCPEvent {\n  return event.source === \"sandbox\" && event.category === \"mcp\";\n}\n","/**\n * Sandbox Events\n *\n * All events related to Sandbox resource operations:\n * - Workdir: File system operations\n * - MCP: Model Context Protocol tools\n *\n * Note: LLM events are NOT part of Sandbox.\n * Agent system doesn't need to observe LLM-level events.\n */\n\n// Workdir Events\nexport type {\n  WorkdirEvent,\n  WorkdirRequestEvent,\n  WorkdirResultEvent,\n  FileReadRequest,\n  FileReadResult,\n  FileWriteRequest,\n  FileWrittenEvent,\n  FileDeleteRequest,\n  FileDeletedEvent,\n  DirectoryListRequest,\n  DirectoryListResult,\n  WorkdirErrorEvent,\n} from \"./workdir\";\nexport { isWorkdirEvent } from \"./workdir\";\n\n// MCP Events\nexport type {\n  MCPEvent,\n  MCPRequestEvent,\n  MCPResultEvent,\n  ToolExecuteRequest,\n  ToolExecutedEvent,\n  ToolExecutionErrorEvent,\n  MCPServerConnectedEvent,\n  MCPServerDisconnectedEvent,\n  ResourceReadRequest,\n  ResourceReadResult,\n} from \"./mcp\";\nexport { isMCPEvent } from \"./mcp\";\n\n// ============================================================================\n// Combined Union\n// ============================================================================\n\nimport type { WorkdirEvent } from \"./workdir\";\nimport type { MCPEvent } from \"./mcp\";\n\n/**\n * SandboxEvent - All sandbox events\n */\nexport type SandboxEvent = WorkdirEvent | MCPEvent;\n\n/**\n * Type guard: is this a sandbox event?\n */\nexport function isSandboxEvent(event: { source?: string }): event is SandboxEvent {\n  return event.source === \"sandbox\";\n}\n","/**\n * Container Events\n *\n * All events related to Container operations:\n * - Lifecycle: creation, destruction, agent registration\n * - Sandbox: workspace and MCP tool operations\n */\n\n// Lifecycle Events\nexport type {\n  ContainerLifecycleEvent,\n  ContainerCreatedEvent,\n  ContainerDestroyedEvent,\n  AgentRegisteredEvent,\n  AgentUnregisteredEvent,\n} from \"./lifecycle\";\nexport { isContainerLifecycleEvent } from \"./lifecycle\";\n\n// Sandbox Events\nexport * from \"./sandbox\";\n\n// ============================================================================\n// Combined Union\n// ============================================================================\n\nimport type { ContainerLifecycleEvent } from \"./lifecycle\";\nimport type { SandboxEvent } from \"./sandbox\";\n\n/**\n * ContainerEvent - All container events\n */\nexport type ContainerEvent = ContainerLifecycleEvent | SandboxEvent;\n\n/**\n * Type guard: is this a container event?\n */\nexport function isContainerEvent(event: { source?: string }): event is ContainerEvent {\n  return event.source === \"container\" || event.source === \"sandbox\";\n}\n","/**\n * Session Lifecycle Events\n *\n * Events for session creation and destruction.\n *\n * All SessionLifecycleEvents have:\n * - source: \"session\"\n * - category: \"lifecycle\"\n * - intent: \"notification\"\n */\n\nimport type { SystemEvent } from \"../../base\";\n\n// ============================================================================\n// Base Type\n// ============================================================================\n\n/**\n * Base SessionLifecycleEvent\n */\ninterface BaseSessionLifecycleEvent<T extends string, D = unknown>\n  extends SystemEvent<T, D, \"session\", \"lifecycle\", \"notification\"> {}\n\n// ============================================================================\n// Lifecycle Events\n// ============================================================================\n\n/**\n * SessionCreatedEvent - Session was created\n */\nexport interface SessionCreatedEvent\n  extends BaseSessionLifecycleEvent<\n    \"session_created\",\n    {\n      sessionId: string;\n      imageId: string;\n      containerId: string;\n      title?: string;\n      createdAt: number;\n    }\n  > {}\n\n/**\n * SessionDestroyedEvent - Session was destroyed\n */\nexport interface SessionDestroyedEvent\n  extends BaseSessionLifecycleEvent<\n    \"session_destroyed\",\n    {\n      sessionId: string;\n      reason?: string;\n    }\n  > {}\n\n// ============================================================================\n// Union Type\n// ============================================================================\n\n/**\n * SessionLifecycleEvent - All session lifecycle events\n */\nexport type SessionLifecycleEvent = SessionCreatedEvent | SessionDestroyedEvent;\n\n/**\n * Type guard: is this a SessionLifecycleEvent?\n */\nexport function isSessionLifecycleEvent(event: SystemEvent): event is SessionLifecycleEvent {\n  return event.source === \"session\" && event.category === \"lifecycle\";\n}\n","/**\n * Session Persist Events\n *\n * Events for session persistence operations.\n *\n * Isomorphic Design:\n * - Request events may be forwarded (RemoteEcosystem) or executed (NodeEcosystem)\n * - Result events confirm completion\n *\n * All SessionPersistEvents have:\n * - source: \"session\"\n * - category: \"persist\"\n * - intent: \"request\" | \"result\"\n */\n\nimport type { SystemEvent } from \"../../base\";\n\n// ============================================================================\n// Base Types\n// ============================================================================\n\n/**\n * Base SessionPersistRequest\n */\ninterface BaseSessionPersistRequest<T extends string, D = unknown>\n  extends SystemEvent<T, D, \"session\", \"persist\", \"request\"> {}\n\n/**\n * Base SessionPersistResult\n */\ninterface BaseSessionPersistResult<T extends string, D = unknown>\n  extends SystemEvent<T, D, \"session\", \"persist\", \"result\"> {}\n\n// ============================================================================\n// Save Events\n// ============================================================================\n\n/**\n * SessionSaveRequest - Request to save session\n */\nexport interface SessionSaveRequest\n  extends BaseSessionPersistRequest<\n    \"session_save_request\",\n    {\n      sessionId: string;\n      title?: string;\n      metadata?: Record<string, unknown>;\n    }\n  > {}\n\n/**\n * SessionSavedEvent - Session was saved\n */\nexport interface SessionSavedEvent\n  extends BaseSessionPersistResult<\n    \"session_saved\",\n    {\n      sessionId: string;\n      savedAt: number;\n    }\n  > {}\n\n// ============================================================================\n// Message Persist Events\n// ============================================================================\n\n/**\n * MessagePersistRequest - Request to persist a message\n */\nexport interface MessagePersistRequest\n  extends BaseSessionPersistRequest<\n    \"message_persist_request\",\n    {\n      sessionId: string;\n      messageId: string;\n      role: \"user\" | \"assistant\" | \"tool_call\" | \"tool_result\";\n      content: unknown;\n    }\n  > {}\n\n/**\n * MessagePersistedEvent - Message was persisted\n */\nexport interface MessagePersistedEvent\n  extends BaseSessionPersistResult<\n    \"message_persisted\",\n    {\n      sessionId: string;\n      messageId: string;\n      savedAt: number;\n    }\n  > {}\n\n// ============================================================================\n// Union Types\n// ============================================================================\n\n/**\n * SessionPersistEvent - All session persist events\n */\nexport type SessionPersistEvent =\n  | SessionSaveRequest\n  | SessionSavedEvent\n  | MessagePersistRequest\n  | MessagePersistedEvent;\n\n/**\n * Session persist request events\n */\nexport type SessionPersistRequestEvent = SessionSaveRequest | MessagePersistRequest;\n\n/**\n * Session persist result events\n */\nexport type SessionPersistResultEvent = SessionSavedEvent | MessagePersistedEvent;\n\n/**\n * Type guard: is this a SessionPersistEvent?\n */\nexport function isSessionPersistEvent(event: SystemEvent): event is SessionPersistEvent {\n  return event.source === \"session\" && event.category === \"persist\";\n}\n","/**\n * Session Action Events\n *\n * Events for user-initiated session actions (resume, fork, etc.)\n *\n * All SessionActionEvents have:\n * - source: \"session\"\n * - category: \"action\"\n * - intent: \"request\" | \"result\"\n */\n\nimport type { SystemEvent } from \"../../base\";\n\n// ============================================================================\n// Base Types\n// ============================================================================\n\n/**\n * Base SessionActionRequest\n */\ninterface BaseSessionActionRequest<T extends string, D = unknown>\n  extends SystemEvent<T, D, \"session\", \"action\", \"request\"> {}\n\n/**\n * Base SessionActionResult\n */\ninterface BaseSessionActionResult<T extends string, D = unknown>\n  extends SystemEvent<T, D, \"session\", \"action\", \"result\"> {}\n\n// ============================================================================\n// Resume Events\n// ============================================================================\n\n/**\n * SessionResumeRequest - Request to resume a session\n */\nexport interface SessionResumeRequest\n  extends BaseSessionActionRequest<\n    \"session_resume_request\",\n    {\n      sessionId: string;\n      containerId?: string;\n    }\n  > {}\n\n/**\n * SessionResumedEvent - Session was resumed\n */\nexport interface SessionResumedEvent\n  extends BaseSessionActionResult<\n    \"session_resumed\",\n    {\n      sessionId: string;\n      agentId: string;\n      resumedAt: number;\n    }\n  > {}\n\n// ============================================================================\n// Fork Events\n// ============================================================================\n\n/**\n * SessionForkRequest - Request to fork a session\n */\nexport interface SessionForkRequest\n  extends BaseSessionActionRequest<\n    \"session_fork_request\",\n    {\n      sessionId: string;\n      newTitle?: string;\n    }\n  > {}\n\n/**\n * SessionForkedEvent - Session was forked\n */\nexport interface SessionForkedEvent\n  extends BaseSessionActionResult<\n    \"session_forked\",\n    {\n      originalSessionId: string;\n      newSessionId: string;\n      newImageId: string;\n      forkedAt: number;\n    }\n  > {}\n\n// ============================================================================\n// Title Update Events\n// ============================================================================\n\n/**\n * SessionTitleUpdateRequest - Request to update session title\n */\nexport interface SessionTitleUpdateRequest\n  extends BaseSessionActionRequest<\n    \"session_title_update_request\",\n    {\n      sessionId: string;\n      title: string;\n    }\n  > {}\n\n/**\n * SessionTitleUpdatedEvent - Session title was updated\n */\nexport interface SessionTitleUpdatedEvent\n  extends BaseSessionActionResult<\n    \"session_title_updated\",\n    {\n      sessionId: string;\n      title: string;\n      updatedAt: number;\n    }\n  > {}\n\n// ============================================================================\n// Union Types\n// ============================================================================\n\n/**\n * SessionActionEvent - All session action events\n */\nexport type SessionActionEvent =\n  | SessionResumeRequest\n  | SessionResumedEvent\n  | SessionForkRequest\n  | SessionForkedEvent\n  | SessionTitleUpdateRequest\n  | SessionTitleUpdatedEvent;\n\n/**\n * Session action request events\n */\nexport type SessionActionRequestEvent =\n  | SessionResumeRequest\n  | SessionForkRequest\n  | SessionTitleUpdateRequest;\n\n/**\n * Session action result events\n */\nexport type SessionActionResultEvent =\n  | SessionResumedEvent\n  | SessionForkedEvent\n  | SessionTitleUpdatedEvent;\n\n/**\n * Type guard: is this a SessionActionEvent?\n */\nexport function isSessionActionEvent(event: SystemEvent): event is SessionActionEvent {\n  return event.source === \"session\" && event.category === \"action\";\n}\n","/**\n * Session Events\n *\n * All events related to Session operations:\n * - Lifecycle: creation, destruction\n * - Persist: save, message persistence\n * - Action: resume, fork, title update\n */\n\n// Lifecycle Events\nexport type {\n  SessionLifecycleEvent,\n  SessionCreatedEvent,\n  SessionDestroyedEvent,\n} from \"./lifecycle\";\nexport { isSessionLifecycleEvent } from \"./lifecycle\";\n\n// Persist Events\nexport type {\n  SessionPersistEvent,\n  SessionPersistRequestEvent,\n  SessionPersistResultEvent,\n  SessionSaveRequest,\n  SessionSavedEvent,\n  MessagePersistRequest,\n  MessagePersistedEvent,\n} from \"./persist\";\nexport { isSessionPersistEvent } from \"./persist\";\n\n// Action Events\nexport type {\n  SessionActionEvent,\n  SessionActionRequestEvent,\n  SessionActionResultEvent,\n  SessionResumeRequest,\n  SessionResumedEvent,\n  SessionForkRequest,\n  SessionForkedEvent,\n  SessionTitleUpdateRequest,\n  SessionTitleUpdatedEvent,\n} from \"./action\";\nexport { isSessionActionEvent } from \"./action\";\n\n// ============================================================================\n// Combined Union\n// ============================================================================\n\nimport type { SessionLifecycleEvent } from \"./lifecycle\";\nimport type { SessionPersistEvent } from \"./persist\";\nimport type { SessionActionEvent } from \"./action\";\n\n/**\n * SessionEvent - All session events\n */\nexport type SessionEvent = SessionLifecycleEvent | SessionPersistEvent | SessionActionEvent;\n\n/**\n * Type guard: is this a session event?\n */\nexport function isSessionEvent(event: { source?: string }): event is SessionEvent {\n  return event.source === \"session\";\n}\n","/**\n * CommandEvent - Request/Response events for Runtime operations\n *\n * These events enable unified operation API for both local and remote modes:\n * - Local mode: RuntimeImpl listens to requests, emits responses\n * - Remote mode: WebSocket/SSE forwards requests/responses\n *\n * Pattern:\n * ```\n * Caller                              Handler (Runtime)\n * ─────────────────────────────────────────────────────────\n * container_create_request  ────────►  handle & execute\n *                          ◄────────  container_create_response\n *\n * agent_run_request        ────────►  handle & execute\n *                          ◄────────  agent_run_response\n * ```\n *\n * All CommandEvents have:\n * - source: \"command\"\n * - category: \"request\" | \"response\"\n * - intent: \"request\" | \"result\"\n */\n\nimport type { SystemEvent } from \"../base\";\nimport type { ImageRecord } from \"~/runtime/internal/persistence\";\n\n// ============================================================================\n// Base Types\n// ============================================================================\n\n/**\n * Base interface for Command request events\n */\ninterface BaseCommandRequest<T extends string, D = unknown>\n  extends SystemEvent<T, D, \"command\", \"request\", \"request\"> {}\n\n/**\n * Base interface for Command response events\n */\ninterface BaseCommandResponse<T extends string, D = unknown>\n  extends SystemEvent<T, D, \"command\", \"response\", \"result\"> {}\n\n// ============================================================================\n// Container Commands\n// ============================================================================\n\n/**\n * Request to create a container\n */\nexport interface ContainerCreateRequest\n  extends BaseCommandRequest<\n    \"container_create_request\",\n    {\n      requestId: string;\n      containerId: string;\n    }\n  > {}\n\n/**\n * Response to container creation\n */\nexport interface ContainerCreateResponse\n  extends BaseCommandResponse<\n    \"container_create_response\",\n    {\n      requestId: string;\n      containerId: string;\n      error?: string;\n    }\n  > {}\n\n/**\n * Request to get a container\n */\nexport interface ContainerGetRequest\n  extends BaseCommandRequest<\n    \"container_get_request\",\n    {\n      requestId: string;\n      containerId: string;\n    }\n  > {}\n\n/**\n * Response to container get\n */\nexport interface ContainerGetResponse\n  extends BaseCommandResponse<\n    \"container_get_response\",\n    {\n      requestId: string;\n      containerId?: string;\n      exists: boolean;\n      error?: string;\n    }\n  > {}\n\n/**\n * Request to list containers\n */\nexport interface ContainerListRequest\n  extends BaseCommandRequest<\n    \"container_list_request\",\n    {\n      requestId: string;\n    }\n  > {}\n\n/**\n * Response to container list\n */\nexport interface ContainerListResponse\n  extends BaseCommandResponse<\n    \"container_list_response\",\n    {\n      requestId: string;\n      containerIds: string[];\n      error?: string;\n    }\n  > {}\n\n// ============================================================================\n// Agent Commands\n// ============================================================================\n\n/**\n * Request to get an agent\n */\nexport interface AgentGetRequest\n  extends BaseCommandRequest<\n    \"agent_get_request\",\n    {\n      requestId: string;\n      agentId: string;\n    }\n  > {}\n\n/**\n * Response to agent get\n */\nexport interface AgentGetResponse\n  extends BaseCommandResponse<\n    \"agent_get_response\",\n    {\n      requestId: string;\n      agentId?: string;\n      containerId?: string;\n      exists: boolean;\n      error?: string;\n    }\n  > {}\n\n/**\n * Request to list agents\n */\nexport interface AgentListRequest\n  extends BaseCommandRequest<\n    \"agent_list_request\",\n    {\n      requestId: string;\n      containerId: string;\n    }\n  > {}\n\n/**\n * Response to agent list\n */\nexport interface AgentListResponse\n  extends BaseCommandResponse<\n    \"agent_list_response\",\n    {\n      requestId: string;\n      agents: Array<{ agentId: string; containerId: string; imageId: string }>;\n      error?: string;\n    }\n  > {}\n\n/**\n * Request to destroy an agent\n */\nexport interface AgentDestroyRequest\n  extends BaseCommandRequest<\n    \"agent_destroy_request\",\n    {\n      requestId: string;\n      agentId: string;\n    }\n  > {}\n\n/**\n * Response to agent destroy\n */\nexport interface AgentDestroyResponse\n  extends BaseCommandResponse<\n    \"agent_destroy_response\",\n    {\n      requestId: string;\n      agentId: string;\n      success: boolean;\n      error?: string;\n    }\n  > {}\n\n/**\n * Request to destroy all agents in a container\n */\nexport interface AgentDestroyAllRequest\n  extends BaseCommandRequest<\n    \"agent_destroy_all_request\",\n    {\n      requestId: string;\n      containerId: string;\n    }\n  > {}\n\n/**\n * Response to destroy all agents\n */\nexport interface AgentDestroyAllResponse\n  extends BaseCommandResponse<\n    \"agent_destroy_all_response\",\n    {\n      requestId: string;\n      containerId: string;\n      error?: string;\n    }\n  > {}\n\n/**\n * Request to send a message\n * Can use either imageId (preferred) or agentId\n * If using imageId and agent is not running, it will be auto-activated\n */\nexport interface MessageSendRequest\n  extends BaseCommandRequest<\n    \"message_send_request\",\n    {\n      requestId: string;\n      /** Image ID (preferred) - will auto-activate if offline */\n      imageId?: string;\n      /** Agent ID (legacy) - must be already running */\n      agentId?: string;\n      content: string;\n    }\n  > {}\n\n/**\n * Response to message send (acknowledges message received, not completion)\n */\nexport interface MessageSendResponse\n  extends BaseCommandResponse<\n    \"message_send_response\",\n    {\n      requestId: string;\n      imageId?: string;\n      agentId: string;\n      error?: string;\n    }\n  > {}\n\n/**\n * Request to interrupt an agent\n * Can use either imageId or agentId\n */\nexport interface AgentInterruptRequest\n  extends BaseCommandRequest<\n    \"agent_interrupt_request\",\n    {\n      requestId: string;\n      /** Image ID (preferred) */\n      imageId?: string;\n      /** Agent ID (legacy) */\n      agentId?: string;\n    }\n  > {}\n\n/**\n * Response to agent interrupt\n */\nexport interface AgentInterruptResponse\n  extends BaseCommandResponse<\n    \"agent_interrupt_response\",\n    {\n      requestId: string;\n      imageId?: string;\n      agentId?: string;\n      error?: string;\n    }\n  > {}\n\n// ============================================================================\n// Image Commands\n// ============================================================================\n\n/**\n * Request to create a new image (conversation)\n */\nexport interface ImageCreateRequest\n  extends BaseCommandRequest<\n    \"image_create_request\",\n    {\n      requestId: string;\n      containerId: string;\n      config: {\n        name?: string;\n        description?: string;\n        systemPrompt?: string;\n      };\n    }\n  > {}\n\n/**\n * Response to image creation\n */\nexport interface ImageCreateResponse\n  extends BaseCommandResponse<\n    \"image_create_response\",\n    {\n      requestId: string;\n      record: ImageRecord;\n      error?: string;\n    }\n  > {}\n\n/**\n * Request to run an image (create or reuse agent)\n */\nexport interface ImageRunRequest\n  extends BaseCommandRequest<\n    \"image_run_request\",\n    {\n      requestId: string;\n      imageId: string;\n    }\n  > {}\n\n/**\n * Response to image run\n */\nexport interface ImageRunResponse\n  extends BaseCommandResponse<\n    \"image_run_response\",\n    {\n      requestId: string;\n      imageId: string;\n      agentId: string;\n      /** true if reusing existing agent, false if newly created */\n      reused: boolean;\n      error?: string;\n    }\n  > {}\n\n/**\n * Request to stop an image (destroy agent, keep image)\n */\nexport interface ImageStopRequest\n  extends BaseCommandRequest<\n    \"image_stop_request\",\n    {\n      requestId: string;\n      imageId: string;\n    }\n  > {}\n\n/**\n * Response to image stop\n */\nexport interface ImageStopResponse\n  extends BaseCommandResponse<\n    \"image_stop_response\",\n    {\n      requestId: string;\n      imageId: string;\n      error?: string;\n    }\n  > {}\n\n/**\n * Request to update an image (name, description, etc.)\n */\nexport interface ImageUpdateRequest\n  extends BaseCommandRequest<\n    \"image_update_request\",\n    {\n      requestId: string;\n      imageId: string;\n      updates: {\n        name?: string;\n        description?: string;\n      };\n    }\n  > {}\n\n/**\n * Response to image update\n */\nexport interface ImageUpdateResponse\n  extends BaseCommandResponse<\n    \"image_update_response\",\n    {\n      requestId: string;\n      record: ImageRecord;\n      error?: string;\n    }\n  > {}\n\n/**\n * Request to list all images\n */\nexport interface ImageListRequest\n  extends BaseCommandRequest<\n    \"image_list_request\",\n    {\n      requestId: string;\n      containerId?: string;\n    }\n  > {}\n\n/**\n * Image list item with online status\n */\nexport interface ImageListItem extends ImageRecord {\n  /** Whether an agent is currently running for this image */\n  online: boolean;\n  /** Current agent ID if online */\n  agentId?: string;\n}\n\n/**\n * Response to image list\n */\nexport interface ImageListResponse\n  extends BaseCommandResponse<\n    \"image_list_response\",\n    {\n      requestId: string;\n      records: ImageListItem[];\n      error?: string;\n    }\n  > {}\n\n/**\n * Request to get an image by ID\n */\nexport interface ImageGetRequest\n  extends BaseCommandRequest<\n    \"image_get_request\",\n    {\n      requestId: string;\n      imageId: string;\n    }\n  > {}\n\n/**\n * Response to image get\n */\nexport interface ImageGetResponse\n  extends BaseCommandResponse<\n    \"image_get_response\",\n    {\n      requestId: string;\n      record?: ImageListItem | null;\n      error?: string;\n    }\n  > {}\n\n/**\n * Request to delete an image\n */\nexport interface ImageDeleteRequest\n  extends BaseCommandRequest<\n    \"image_delete_request\",\n    {\n      requestId: string;\n      imageId: string;\n    }\n  > {}\n\n/**\n * Response to image delete\n */\nexport interface ImageDeleteResponse\n  extends BaseCommandResponse<\n    \"image_delete_response\",\n    {\n      requestId: string;\n      imageId: string;\n      error?: string;\n    }\n  > {}\n\n/**\n * Request to get messages for an image\n */\nexport interface ImageMessagesRequest\n  extends BaseCommandRequest<\n    \"image_messages_request\",\n    {\n      requestId: string;\n      imageId: string;\n    }\n  > {}\n\n/**\n * Response to image messages request\n */\nexport interface ImageMessagesResponse\n  extends BaseCommandResponse<\n    \"image_messages_response\",\n    {\n      requestId: string;\n      imageId: string;\n      messages: Array<{\n        id: string;\n        role: \"user\" | \"assistant\" | \"tool_call\" | \"tool_result\";\n        content: unknown;\n        timestamp: number;\n      }>;\n      error?: string;\n    }\n  > {}\n\n// ============================================================================\n// Union Types\n// ============================================================================\n\n/**\n * All Command request events\n */\nexport type CommandRequest =\n  // Container\n  | ContainerCreateRequest\n  | ContainerGetRequest\n  | ContainerListRequest\n  // Agent\n  | AgentGetRequest\n  | AgentListRequest\n  | AgentDestroyRequest\n  | AgentDestroyAllRequest\n  | MessageSendRequest\n  | AgentInterruptRequest\n  // Image\n  | ImageCreateRequest\n  | ImageRunRequest\n  | ImageStopRequest\n  | ImageUpdateRequest\n  | ImageListRequest\n  | ImageGetRequest\n  | ImageDeleteRequest\n  | ImageMessagesRequest;\n\n/**\n * All Command response events\n */\nexport type CommandResponse =\n  // Container\n  | ContainerCreateResponse\n  | ContainerGetResponse\n  | ContainerListResponse\n  // Agent\n  | AgentGetResponse\n  | AgentListResponse\n  | AgentDestroyResponse\n  | AgentDestroyAllResponse\n  | MessageSendResponse\n  | AgentInterruptResponse\n  // Image\n  | ImageCreateResponse\n  | ImageRunResponse\n  | ImageStopResponse\n  | ImageUpdateResponse\n  | ImageListResponse\n  | ImageGetResponse\n  | ImageDeleteResponse\n  | ImageMessagesResponse;\n\n/**\n * All Command events (requests + responses)\n */\nexport type CommandEvent = CommandRequest | CommandResponse;\n\n/**\n * Command event type strings\n */\nexport type CommandEventType = CommandEvent[\"type\"];\n\n/**\n * Type guard: is this a CommandEvent?\n */\nexport function isCommandEvent(event: { source?: string }): event is CommandEvent {\n  return event.source === \"command\";\n}\n\n/**\n * Type guard: is this a Command request event?\n */\nexport function isCommandRequest(event: {\n  source?: string;\n  category?: string;\n}): event is CommandRequest {\n  return event.source === \"command\" && event.category === \"request\";\n}\n\n/**\n * Type guard: is this a Command response event?\n */\nexport function isCommandResponse(event: {\n  source?: string;\n  category?: string;\n}): event is CommandResponse {\n  return event.source === \"command\" && event.category === \"response\";\n}\n\n// ============================================================================\n// Event Map - Type-safe event type to event mapping\n// ============================================================================\n\n/**\n * CommandEventMap - Maps event type string to event interface\n *\n * Enables type-safe event handling:\n * ```typescript\n * bus.onCommand(\"container_create_request\", (event) => {\n *   event.data.requestId;    // ✓ string\n *   event.data.containerId;  // ✓ string\n * });\n * ```\n */\nexport interface CommandEventMap {\n  // Container\n  container_create_request: ContainerCreateRequest;\n  container_create_response: ContainerCreateResponse;\n  container_get_request: ContainerGetRequest;\n  container_get_response: ContainerGetResponse;\n  container_list_request: ContainerListRequest;\n  container_list_response: ContainerListResponse;\n  // Agent\n  agent_get_request: AgentGetRequest;\n  agent_get_response: AgentGetResponse;\n  agent_list_request: AgentListRequest;\n  agent_list_response: AgentListResponse;\n  agent_destroy_request: AgentDestroyRequest;\n  agent_destroy_response: AgentDestroyResponse;\n  agent_destroy_all_request: AgentDestroyAllRequest;\n  agent_destroy_all_response: AgentDestroyAllResponse;\n  message_send_request: MessageSendRequest;\n  message_send_response: MessageSendResponse;\n  agent_interrupt_request: AgentInterruptRequest;\n  agent_interrupt_response: AgentInterruptResponse;\n  // Image\n  image_create_request: ImageCreateRequest;\n  image_create_response: ImageCreateResponse;\n  image_run_request: ImageRunRequest;\n  image_run_response: ImageRunResponse;\n  image_stop_request: ImageStopRequest;\n  image_stop_response: ImageStopResponse;\n  image_update_request: ImageUpdateRequest;\n  image_update_response: ImageUpdateResponse;\n  image_list_request: ImageListRequest;\n  image_list_response: ImageListResponse;\n  image_get_request: ImageGetRequest;\n  image_get_response: ImageGetResponse;\n  image_delete_request: ImageDeleteRequest;\n  image_delete_response: ImageDeleteResponse;\n  image_messages_request: ImageMessagesRequest;\n  image_messages_response: ImageMessagesResponse;\n}\n\n/**\n * Maps request event type to its corresponding response event type\n */\nexport interface CommandRequestResponseMap {\n  container_create_request: \"container_create_response\";\n  container_get_request: \"container_get_response\";\n  container_list_request: \"container_list_response\";\n  agent_get_request: \"agent_get_response\";\n  agent_list_request: \"agent_list_response\";\n  agent_destroy_request: \"agent_destroy_response\";\n  agent_destroy_all_request: \"agent_destroy_all_response\";\n  message_send_request: \"message_send_response\";\n  agent_interrupt_request: \"agent_interrupt_response\";\n  image_create_request: \"image_create_response\";\n  image_run_request: \"image_run_response\";\n  image_stop_request: \"image_stop_response\";\n  image_update_request: \"image_update_response\";\n  image_list_request: \"image_list_response\";\n  image_get_request: \"image_get_response\";\n  image_delete_request: \"image_delete_response\";\n  image_messages_request: \"image_messages_response\";\n}\n\n/**\n * All command request types\n */\nexport type CommandRequestType = keyof CommandRequestResponseMap;\n\n/**\n * Get response type for a request type\n */\nexport type ResponseTypeFor<T extends CommandRequestType> = CommandRequestResponseMap[T];\n\n/**\n * Get response event for a request type\n */\nexport type ResponseEventFor<T extends CommandRequestType> = CommandEventMap[ResponseTypeFor<T>];\n\n/**\n * Get request data type (without requestId, as it's auto-generated)\n */\nexport type RequestDataFor<T extends CommandRequestType> = Omit<\n  CommandEventMap[T][\"data\"],\n  \"requestId\"\n>;\n","/**\n * Agent Stream Events\n *\n * Real-time streaming events from LLM.\n * - source: \"agent\"\n * - category: \"stream\"\n * - intent: \"notification\"\n *\n * Note: These have same event types as DriveableEvent (environment/stream),\n * but with full SystemEvent structure (source, category, intent, context).\n */\n\nimport type { BaseAgentEvent } from \"../BaseAgentEvent\";\n\n/**\n * Base type for stream events\n */\nexport interface AgentStreamEventBase<T extends string, D> extends BaseAgentEvent<T, D, \"stream\"> {}\n\n// ============================================================================\n// Stop Reason\n// ============================================================================\n\n/**\n * Stop reason for message completion\n */\nexport type StopReason = \"end_turn\" | \"max_tokens\" | \"stop_sequence\" | \"tool_use\";\n\n// ============================================================================\n// Message Lifecycle Events\n// ============================================================================\n\n/**\n * AgentMessageStartEvent - Streaming message begins\n */\nexport interface AgentMessageStartEvent\n  extends AgentStreamEventBase<\n    \"message_start\",\n    {\n      messageId: string;\n      model: string;\n    }\n  > {}\n\n/**\n * AgentMessageDeltaEvent - Message-level updates (usage info)\n */\nexport interface AgentMessageDeltaEvent\n  extends AgentStreamEventBase<\n    \"message_delta\",\n    {\n      usage?: {\n        inputTokens: number;\n        outputTokens: number;\n      };\n    }\n  > {}\n\n/**\n * AgentMessageStopEvent - Streaming message completes\n */\nexport interface AgentMessageStopEvent\n  extends AgentStreamEventBase<\n    \"message_stop\",\n    {\n      stopReason?: StopReason;\n    }\n  > {}\n\n// ============================================================================\n// Text Content Events\n// ============================================================================\n\n/**\n * AgentTextDeltaEvent - Incremental text output\n */\nexport interface AgentTextDeltaEvent\n  extends AgentStreamEventBase<\n    \"text_delta\",\n    {\n      text: string;\n    }\n  > {}\n\n// ============================================================================\n// Tool Use Events\n// ============================================================================\n\n/**\n * AgentToolUseStartEvent - Tool use block started\n */\nexport interface AgentToolUseStartEvent\n  extends AgentStreamEventBase<\n    \"tool_use_start\",\n    {\n      toolCallId: string;\n      toolName: string;\n    }\n  > {}\n\n/**\n * AgentInputJsonDeltaEvent - Incremental tool input JSON\n */\nexport interface AgentInputJsonDeltaEvent\n  extends AgentStreamEventBase<\n    \"input_json_delta\",\n    {\n      partialJson: string;\n    }\n  > {}\n\n/**\n * AgentToolUseStopEvent - Tool use block completed\n */\nexport interface AgentToolUseStopEvent\n  extends AgentStreamEventBase<\n    \"tool_use_stop\",\n    {\n      toolCallId: string;\n      toolName: string;\n      input: Record<string, unknown>;\n    }\n  > {}\n\n/**\n * AgentToolResultEvent - Tool execution result\n */\nexport interface AgentToolResultEvent\n  extends AgentStreamEventBase<\n    \"tool_result\",\n    {\n      toolCallId: string;\n      result: unknown;\n      isError?: boolean;\n    }\n  > {}\n\n// ============================================================================\n// Error Events\n// ============================================================================\n\n/**\n * AgentErrorReceivedEvent - Error received from environment\n *\n * Processed by MealyMachine to produce:\n * - error_occurred (StateEvent)\n * - error_message (MessageEvent)\n */\nexport interface AgentErrorReceivedEvent\n  extends AgentStreamEventBase<\n    \"error_received\",\n    {\n      /** Error message (human-readable) */\n      message: string;\n      /** Error code (e.g., \"rate_limit_error\", \"api_error\") */\n      errorCode?: string;\n    }\n  > {}\n\n// ============================================================================\n// Union Type\n// ============================================================================\n\n/**\n * AgentStreamEvent - All stream events\n */\nexport type AgentStreamEvent =\n  | AgentMessageStartEvent\n  | AgentMessageDeltaEvent\n  | AgentMessageStopEvent\n  | AgentTextDeltaEvent\n  | AgentToolUseStartEvent\n  | AgentInputJsonDeltaEvent\n  | AgentToolUseStopEvent\n  | AgentToolResultEvent\n  | AgentErrorReceivedEvent;\n\n/**\n * AgentStreamEventType - String literal union\n */\nexport type AgentStreamEventType = AgentStreamEvent[\"type\"];\n\n/**\n * Type guard: is this a stream event?\n */\nexport function isAgentStreamEvent(event: {\n  source?: string;\n  category?: string;\n}): event is AgentStreamEvent {\n  return event.source === \"agent\" && event.category === \"stream\";\n}\n","/**\n * Agent State Events\n *\n * Events that trigger AgentState transitions.\n * - source: \"agent\"\n * - category: \"state\"\n * - intent: \"notification\"\n *\n * Note: These are events that AFFECT state, not \"state\" themselves.\n */\n\nimport type { BaseAgentEvent } from \"../BaseAgentEvent\";\n\n/**\n * Base type for state events\n */\nexport interface AgentStateEventBase<T extends string, D> extends BaseAgentEvent<T, D, \"state\"> {}\n\n// ============================================================================\n// Conversation Events\n// ============================================================================\n\n/**\n * ConversationQueuedEvent - Message queued for processing\n */\nexport interface ConversationQueuedEvent\n  extends AgentStateEventBase<\n    \"conversation_queued\",\n    {\n      messageId: string;\n    }\n  > {}\n\n/**\n * ConversationStartEvent - Conversation started\n */\nexport interface ConversationStartEvent\n  extends AgentStateEventBase<\n    \"conversation_start\",\n    {\n      messageId: string;\n    }\n  > {}\n\n/**\n * ConversationThinkingEvent - Agent is thinking\n */\nexport interface ConversationThinkingEvent\n  extends AgentStateEventBase<\"conversation_thinking\", Record<string, never>> {}\n\n/**\n * ConversationRespondingEvent - Agent is responding\n */\nexport interface ConversationRespondingEvent\n  extends AgentStateEventBase<\"conversation_responding\", Record<string, never>> {}\n\n/**\n * ConversationEndEvent - Conversation ended\n */\nexport interface ConversationEndEvent\n  extends AgentStateEventBase<\n    \"conversation_end\",\n    {\n      reason: \"completed\" | \"interrupted\" | \"error\";\n    }\n  > {}\n\n/**\n * ConversationInterruptedEvent - Conversation interrupted\n */\nexport interface ConversationInterruptedEvent\n  extends AgentStateEventBase<\n    \"conversation_interrupted\",\n    {\n      reason: string;\n    }\n  > {}\n\n// ============================================================================\n// Tool Events\n// ============================================================================\n\n/**\n * ToolPlannedEvent - Tool use planned\n */\nexport interface ToolPlannedEvent\n  extends AgentStateEventBase<\n    \"tool_planned\",\n    {\n      toolId: string;\n      toolName: string;\n    }\n  > {}\n\n/**\n * ToolExecutingEvent - Tool is executing\n */\nexport interface ToolExecutingEvent\n  extends AgentStateEventBase<\n    \"tool_executing\",\n    {\n      toolId: string;\n      toolName: string;\n      input: Record<string, unknown>;\n    }\n  > {}\n\n/**\n * ToolCompletedEvent - Tool execution completed\n */\nexport interface ToolCompletedEvent\n  extends AgentStateEventBase<\n    \"tool_completed\",\n    {\n      toolId: string;\n      toolName: string;\n      result: unknown;\n    }\n  > {}\n\n/**\n * ToolFailedEvent - Tool execution failed\n */\nexport interface ToolFailedEvent\n  extends AgentStateEventBase<\n    \"tool_failed\",\n    {\n      toolId: string;\n      toolName: string;\n      error: string;\n    }\n  > {}\n\n// ============================================================================\n// Error Events\n// ============================================================================\n\n/**\n * ErrorOccurredEvent - Error occurred during processing\n */\nexport interface ErrorOccurredEvent\n  extends AgentStateEventBase<\n    \"error_occurred\",\n    {\n      code: string;\n      message: string;\n      recoverable: boolean;\n      category?: string;\n    }\n  > {}\n\n// ============================================================================\n// Union Type\n// ============================================================================\n\n/**\n * AgentStateEvent - All state events\n */\nexport type AgentStateEvent =\n  // Conversation\n  | ConversationQueuedEvent\n  | ConversationStartEvent\n  | ConversationThinkingEvent\n  | ConversationRespondingEvent\n  | ConversationEndEvent\n  | ConversationInterruptedEvent\n  // Tool\n  | ToolPlannedEvent\n  | ToolExecutingEvent\n  | ToolCompletedEvent\n  | ToolFailedEvent\n  // Error\n  | ErrorOccurredEvent;\n\n/**\n * AgentStateEventType - String literal union\n */\nexport type AgentStateEventType = AgentStateEvent[\"type\"];\n\n/**\n * Type guard: is this a state event?\n */\nexport function isAgentStateEvent(event: {\n  source?: string;\n  category?: string;\n}): event is AgentStateEvent {\n  return event.source === \"agent\" && event.category === \"state\";\n}\n","/**\n * Agent Message Events\n *\n * Complete message events assembled from stream events.\n * Events directly wrap Message objects - no transformation needed.\n * - source: \"agent\"\n * - category: \"message\"\n * - intent: \"notification\"\n */\n\nimport type { BaseAgentEvent } from \"../BaseAgentEvent\";\nimport type {\n  UserMessage,\n  AssistantMessage,\n  ToolCallMessage,\n  ToolResultMessage,\n  ErrorMessage,\n} from \"~/agent/message\";\n\n/**\n * Base type for message events\n */\nexport interface AgentMessageEventBase<T extends string, D>\n  extends BaseAgentEvent<T, D, \"message\"> {}\n\n// ============================================================================\n// Message Events\n// ============================================================================\n\n/**\n * UserMessageEvent - User sent a message\n * Data: Complete UserMessage object\n */\nexport interface UserMessageEvent extends AgentMessageEventBase<\"user_message\", UserMessage> {}\n\n/**\n * AssistantMessageEvent - Assistant response message\n * Data: Complete AssistantMessage object\n */\nexport interface AssistantMessageEvent\n  extends AgentMessageEventBase<\"assistant_message\", AssistantMessage> {}\n\n/**\n * ToolCallMessageEvent - Tool call message (part of assistant turn)\n * Data: Complete ToolCallMessage object\n */\nexport interface ToolCallMessageEvent\n  extends AgentMessageEventBase<\"tool_call_message\", ToolCallMessage> {}\n\n/**\n * ToolResultMessageEvent - Tool result message\n * Data: Complete ToolResultMessage object\n */\nexport interface ToolResultMessageEvent\n  extends AgentMessageEventBase<\"tool_result_message\", ToolResultMessage> {}\n\n/**\n * ErrorMessageEvent - Error message displayed in chat\n * Data: Complete ErrorMessage object\n *\n * Generated when error_received StreamEvent is processed by MealyMachine.\n * Displayed in the chat history so users can see what went wrong.\n */\nexport interface ErrorMessageEvent extends AgentMessageEventBase<\"error_message\", ErrorMessage> {}\n\n// ============================================================================\n// Union Type\n// ============================================================================\n\n/**\n * AgentMessageEvent - All message events\n */\nexport type AgentMessageEvent =\n  | UserMessageEvent\n  | AssistantMessageEvent\n  | ToolCallMessageEvent\n  | ToolResultMessageEvent\n  | ErrorMessageEvent;\n\n/**\n * AgentMessageEventType - String literal union\n */\nexport type AgentMessageEventType = AgentMessageEvent[\"type\"];\n\n/**\n * Type guard: is this a message event?\n */\nexport function isAgentMessageEvent(event: {\n  source?: string;\n  category?: string;\n}): event is AgentMessageEvent {\n  return event.source === \"agent\" && event.category === \"message\";\n}\n","/**\n * Agent Turn Events\n *\n * Turn-level events for analytics and billing.\n * A turn = one user message + assistant response cycle.\n * - source: \"agent\"\n * - category: \"turn\"\n * - intent: \"notification\"\n */\n\nimport type { BaseAgentEvent } from \"../BaseAgentEvent\";\n\n/**\n * Base type for turn events\n */\nexport interface AgentTurnEventBase<T extends string, D> extends BaseAgentEvent<T, D, \"turn\"> {}\n\n/**\n * Token usage information\n */\nexport interface TokenUsage {\n  inputTokens: number;\n  outputTokens: number;\n  totalTokens?: number;\n}\n\n// ============================================================================\n// Turn Events\n// ============================================================================\n\n/**\n * TurnRequestEvent - Turn started (user message received)\n */\nexport interface TurnRequestEvent\n  extends AgentTurnEventBase<\n    \"turn_request\",\n    {\n      turnId: string;\n      messageId: string;\n      content: string;\n      timestamp: number;\n    }\n  > {}\n\n/**\n * TurnResponseEvent - Turn completed (assistant response finished)\n */\nexport interface TurnResponseEvent\n  extends AgentTurnEventBase<\n    \"turn_response\",\n    {\n      turnId: string;\n      messageId: string;\n      duration: number;\n      usage?: TokenUsage;\n      model?: string;\n      stopReason?: string;\n      timestamp: number;\n    }\n  > {}\n\n// ============================================================================\n// Union Type\n// ============================================================================\n\n/**\n * AgentTurnEvent - All turn events\n */\nexport type AgentTurnEvent = TurnRequestEvent | TurnResponseEvent;\n\n/**\n * AgentTurnEventType - String literal union\n */\nexport type AgentTurnEventType = AgentTurnEvent[\"type\"];\n\n/**\n * Type guard: is this a turn event?\n */\nexport function isAgentTurnEvent(event: {\n  source?: string;\n  category?: string;\n}): event is AgentTurnEvent {\n  return event.source === \"agent\" && event.category === \"turn\";\n}\n","/**\n * Agent Events - SystemEvent for Agent domain\n *\n * Complete event definitions for Agent, extending SystemEvent with:\n * - source: \"agent\"\n * - category: \"stream\" | \"state\" | \"message\" | \"turn\"\n * - intent: \"notification\"\n *\n * ## Event Categories\n *\n * ```\n * AgentEvent (source: \"agent\")\n * │\n * ├── category: \"stream\"   ← Real-time streaming from LLM\n * │   └── TextDeltaEvent, MessageStartEvent, ToolUseStartEvent...\n * │\n * ├── category: \"state\"    ← State transitions\n * │   └── ConversationStartEvent, ConversationEndEvent, ToolExecutingEvent...\n * │\n * ├── category: \"message\"  ← Assembled complete messages\n * │   └── UserMessageEvent, AssistantMessageEvent, ToolCallMessageEvent...\n * │\n * └── category: \"turn\"     ← Turn analytics\n *     └── TurnStartEvent, TurnEndEvent\n * ```\n *\n * ## Relationship with Engine Events\n *\n * Engine uses lightweight events (type, timestamp, data only).\n * Use `ToEngineEvent<T>` to convert AgentEvent to EngineEvent.\n *\n * @packageDocumentation\n */\n\n// Base types\nexport type { AgentEventCategory, BaseAgentEvent } from \"./BaseAgentEvent\";\n\n// Stream events\nexport * from \"./stream\";\n\n// State events\nexport * from \"./state\";\n\n// Message events\nexport * from \"./message\";\n\n// Turn events\nexport * from \"./turn\";\n\n// Union type\nimport type { AgentStreamEvent } from \"./stream\";\nimport type { AgentStateEvent } from \"./state\";\nimport type { AgentMessageEvent } from \"./message\";\nimport type { AgentTurnEvent } from \"./turn\";\n\n/**\n * AgentEvent - All events from Agent domain\n */\nexport type AgentEvent = AgentStreamEvent | AgentStateEvent | AgentMessageEvent | AgentTurnEvent;\n\n/**\n * Type guard: is this an agent event?\n */\nexport function isAgentEvent(event: { source?: string }): event is AgentEvent {\n  return event.source === \"agent\";\n}\n"],"mappings":";AA+MO,SAAS,aACd,OACA,QAC0C;AAC1C,SAAO,MAAM,WAAW;AAC1B;AAKO,SAAS,UACd,OACA,QACsE;AACtE,SAAO,MAAM,WAAW;AAC1B;AAKO,SAAS,UAAU,OAA6B;AACrD,SAAO,MAAM,WAAW;AAC1B;AAKO,SAAS,SAAS,OAA6B;AACpD,SAAO,MAAM,WAAW;AAC1B;AAKO,SAAS,eAAe,OAA6B;AAC1D,SAAO,MAAM,WAAW;AAC1B;;;ACmBO,SAAS,iBAAiB,OAA6C;AAC5E,SAAO,MAAM,WAAW,iBAAiB,MAAM,aAAa;AAC9D;;;ACrLO,SAAS,kBAAkB,OAA8C;AAC9E,SAAO,MAAM,WAAW,iBAAiB,MAAM,aAAa;AAC9D;;;ACeO,SAAS,0BAA0B,OAAsD;AAC9F,SAAO,MAAM,WAAW,eAAe,MAAM,aAAa;AAC5D;;;ACiHO,SAAS,eAAe,OAA2C;AACxE,SAAO,MAAM,WAAW,aAAa,MAAM,aAAa;AAC1D;;;AC1CO,SAAS,WAAW,OAAuC;AAChE,SAAO,MAAM,WAAW,aAAa,MAAM,aAAa;AAC1D;;;ACvHO,SAAS,eAAe,OAAmD;AAChF,SAAO,MAAM,WAAW;AAC1B;;;ACxBO,SAAS,iBAAiB,OAAqD;AACpF,SAAO,MAAM,WAAW,eAAe,MAAM,WAAW;AAC1D;;;AC4BO,SAAS,wBAAwB,OAAoD;AAC1F,SAAO,MAAM,WAAW,aAAa,MAAM,aAAa;AAC1D;;;ACmDO,SAAS,sBAAsB,OAAkD;AACtF,SAAO,MAAM,WAAW,aAAa,MAAM,aAAa;AAC1D;;;AC8BO,SAAS,qBAAqB,OAAiD;AACpF,SAAO,MAAM,WAAW,aAAa,MAAM,aAAa;AAC1D;;;AC9FO,SAAS,eAAe,OAAmD;AAChF,SAAO,MAAM,WAAW;AAC1B;;;ACihBO,SAAS,eAAe,OAAmD;AAChF,SAAO,MAAM,WAAW;AAC1B;AAKO,SAAS,iBAAiB,OAGL;AAC1B,SAAO,MAAM,WAAW,aAAa,MAAM,aAAa;AAC1D;AAKO,SAAS,kBAAkB,OAGL;AAC3B,SAAO,MAAM,WAAW,aAAa,MAAM,aAAa;AAC1D;;;AC3aO,SAAS,mBAAmB,OAGL;AAC5B,SAAO,MAAM,WAAW,WAAW,MAAM,aAAa;AACxD;;;ACRO,SAAS,kBAAkB,OAGL;AAC3B,SAAO,MAAM,WAAW,WAAW,MAAM,aAAa;AACxD;;;ACpGO,SAAS,oBAAoB,OAGL;AAC7B,SAAO,MAAM,WAAW,WAAW,MAAM,aAAa;AACxD;;;ACdO,SAAS,iBAAiB,OAGL;AAC1B,SAAO,MAAM,WAAW,WAAW,MAAM,aAAa;AACxD;;;ACpBO,SAAS,aAAa,OAAiD;AAC5E,SAAO,MAAM,WAAW;AAC1B;","names":[]}

package/dist/index-CjFNcCxR.d.cts

@@ -0,0 +1,299 @@
+import { B as BaseAgentEvent, U as UserMessage, A as AssistantMessage, T as ToolCallMessage, a as ToolResultMessage } from './ToolResultMessage-CRKMSf5d.cjs';
+import { E as ErrorMessage } from './ErrorMessage-BoIh3MIO.cjs';
+
+/**
+ * Agent Stream Events
+ *
+ * Real-time streaming events from LLM.
+ * - source: "agent"
+ * - category: "stream"
+ * - intent: "notification"
+ *
+ * Note: These have same event types as DriveableEvent (environment/stream),
+ * but with full SystemEvent structure (source, category, intent, context).
+ */
+
+/**
+ * Base type for stream events
+ */
+interface AgentStreamEventBase<T extends string, D> extends BaseAgentEvent<T, D, "stream"> {
+}
+/**
+ * Stop reason for message completion
+ */
+type StopReason = "end_turn" | "max_tokens" | "stop_sequence" | "tool_use";
+/**
+ * AgentMessageStartEvent - Streaming message begins
+ */
+interface AgentMessageStartEvent extends AgentStreamEventBase<"message_start", {
+    messageId: string;
+    model: string;
+}> {
+}
+/**
+ * AgentMessageDeltaEvent - Message-level updates (usage info)
+ */
+interface AgentMessageDeltaEvent extends AgentStreamEventBase<"message_delta", {
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}> {
+}
+/**
+ * AgentMessageStopEvent - Streaming message completes
+ */
+interface AgentMessageStopEvent extends AgentStreamEventBase<"message_stop", {
+    stopReason?: StopReason;
+}> {
+}
+/**
+ * AgentTextDeltaEvent - Incremental text output
+ */
+interface AgentTextDeltaEvent extends AgentStreamEventBase<"text_delta", {
+    text: string;
+}> {
+}
+/**
+ * AgentToolUseStartEvent - Tool use block started
+ */
+interface AgentToolUseStartEvent extends AgentStreamEventBase<"tool_use_start", {
+    toolCallId: string;
+    toolName: string;
+}> {
+}
+/**
+ * AgentInputJsonDeltaEvent - Incremental tool input JSON
+ */
+interface AgentInputJsonDeltaEvent extends AgentStreamEventBase<"input_json_delta", {
+    partialJson: string;
+}> {
+}
+/**
+ * AgentToolUseStopEvent - Tool use block completed
+ */
+interface AgentToolUseStopEvent extends AgentStreamEventBase<"tool_use_stop", {
+    toolCallId: string;
+    toolName: string;
+    input: Record<string, unknown>;
+}> {
+}
+/**
+ * AgentToolResultEvent - Tool execution result
+ */
+interface AgentToolResultEvent extends AgentStreamEventBase<"tool_result", {
+    toolCallId: string;
+    result: unknown;
+    isError?: boolean;
+}> {
+}
+/**
+ * AgentErrorReceivedEvent - Error received from environment
+ *
+ * Processed by MealyMachine to produce:
+ * - error_occurred (StateEvent)
+ * - error_message (MessageEvent)
+ */
+interface AgentErrorReceivedEvent extends AgentStreamEventBase<"error_received", {
+    /** Error message (human-readable) */
+    message: string;
+    /** Error code (e.g., "rate_limit_error", "api_error") */
+    errorCode?: string;
+}> {
+}
+/**
+ * AgentStreamEvent - All stream events
+ */
+type AgentStreamEvent = AgentMessageStartEvent | AgentMessageDeltaEvent | AgentMessageStopEvent | AgentTextDeltaEvent | AgentToolUseStartEvent | AgentInputJsonDeltaEvent | AgentToolUseStopEvent | AgentToolResultEvent | AgentErrorReceivedEvent;
+/**
+ * AgentStreamEventType - String literal union
+ */
+type AgentStreamEventType = AgentStreamEvent["type"];
+/**
+ * Type guard: is this a stream event?
+ */
+declare function isAgentStreamEvent(event: {
+    source?: string;
+    category?: string;
+}): event is AgentStreamEvent;
+
+/**
+ * Agent State Events
+ *
+ * Events that trigger AgentState transitions.
+ * - source: "agent"
+ * - category: "state"
+ * - intent: "notification"
+ *
+ * Note: These are events that AFFECT state, not "state" themselves.
+ */
+
+/**
+ * Base type for state events
+ */
+interface AgentStateEventBase<T extends string, D> extends BaseAgentEvent<T, D, "state"> {
+}
+/**
+ * ConversationQueuedEvent - Message queued for processing
+ */
+interface ConversationQueuedEvent extends AgentStateEventBase<"conversation_queued", {
+    messageId: string;
+}> {
+}
+/**
+ * ConversationStartEvent - Conversation started
+ */
+interface ConversationStartEvent extends AgentStateEventBase<"conversation_start", {
+    messageId: string;
+}> {
+}
+/**
+ * ConversationThinkingEvent - Agent is thinking
+ */
+interface ConversationThinkingEvent extends AgentStateEventBase<"conversation_thinking", Record<string, never>> {
+}
+/**
+ * ConversationRespondingEvent - Agent is responding
+ */
+interface ConversationRespondingEvent extends AgentStateEventBase<"conversation_responding", Record<string, never>> {
+}
+/**
+ * ConversationEndEvent - Conversation ended
+ */
+interface ConversationEndEvent extends AgentStateEventBase<"conversation_end", {
+    reason: "completed" | "interrupted" | "error";
+}> {
+}
+/**
+ * ConversationInterruptedEvent - Conversation interrupted
+ */
+interface ConversationInterruptedEvent extends AgentStateEventBase<"conversation_interrupted", {
+    reason: string;
+}> {
+}
+/**
+ * ToolPlannedEvent - Tool use planned
+ */
+interface ToolPlannedEvent extends AgentStateEventBase<"tool_planned", {
+    toolId: string;
+    toolName: string;
+}> {
+}
+/**
+ * ToolExecutingEvent - Tool is executing
+ */
+interface ToolExecutingEvent extends AgentStateEventBase<"tool_executing", {
+    toolId: string;
+    toolName: string;
+    input: Record<string, unknown>;
+}> {
+}
+/**
+ * ToolCompletedEvent - Tool execution completed
+ */
+interface ToolCompletedEvent extends AgentStateEventBase<"tool_completed", {
+    toolId: string;
+    toolName: string;
+    result: unknown;
+}> {
+}
+/**
+ * ToolFailedEvent - Tool execution failed
+ */
+interface ToolFailedEvent extends AgentStateEventBase<"tool_failed", {
+    toolId: string;
+    toolName: string;
+    error: string;
+}> {
+}
+/**
+ * ErrorOccurredEvent - Error occurred during processing
+ */
+interface ErrorOccurredEvent extends AgentStateEventBase<"error_occurred", {
+    code: string;
+    message: string;
+    recoverable: boolean;
+    category?: string;
+}> {
+}
+/**
+ * AgentStateEvent - All state events
+ */
+type AgentStateEvent = ConversationQueuedEvent | ConversationStartEvent | ConversationThinkingEvent | ConversationRespondingEvent | ConversationEndEvent | ConversationInterruptedEvent | ToolPlannedEvent | ToolExecutingEvent | ToolCompletedEvent | ToolFailedEvent | ErrorOccurredEvent;
+/**
+ * AgentStateEventType - String literal union
+ */
+type AgentStateEventType = AgentStateEvent["type"];
+/**
+ * Type guard: is this a state event?
+ */
+declare function isAgentStateEvent(event: {
+    source?: string;
+    category?: string;
+}): event is AgentStateEvent;
+
+/**
+ * Agent Message Events
+ *
+ * Complete message events assembled from stream events.
+ * Events directly wrap Message objects - no transformation needed.
+ * - source: "agent"
+ * - category: "message"
+ * - intent: "notification"
+ */
+
+/**
+ * Base type for message events
+ */
+interface AgentMessageEventBase<T extends string, D> extends BaseAgentEvent<T, D, "message"> {
+}
+/**
+ * UserMessageEvent - User sent a message
+ * Data: Complete UserMessage object
+ */
+interface UserMessageEvent extends AgentMessageEventBase<"user_message", UserMessage> {
+}
+/**
+ * AssistantMessageEvent - Assistant response message
+ * Data: Complete AssistantMessage object
+ */
+interface AssistantMessageEvent extends AgentMessageEventBase<"assistant_message", AssistantMessage> {
+}
+/**
+ * ToolCallMessageEvent - Tool call message (part of assistant turn)
+ * Data: Complete ToolCallMessage object
+ */
+interface ToolCallMessageEvent extends AgentMessageEventBase<"tool_call_message", ToolCallMessage> {
+}
+/**
+ * ToolResultMessageEvent - Tool result message
+ * Data: Complete ToolResultMessage object
+ */
+interface ToolResultMessageEvent extends AgentMessageEventBase<"tool_result_message", ToolResultMessage> {
+}
+/**
+ * ErrorMessageEvent - Error message displayed in chat
+ * Data: Complete ErrorMessage object
+ *
+ * Generated when error_received StreamEvent is processed by MealyMachine.
+ * Displayed in the chat history so users can see what went wrong.
+ */
+interface ErrorMessageEvent extends AgentMessageEventBase<"error_message", ErrorMessage> {
+}
+/**
+ * AgentMessageEvent - All message events
+ */
+type AgentMessageEvent = UserMessageEvent | AssistantMessageEvent | ToolCallMessageEvent | ToolResultMessageEvent | ErrorMessageEvent;
+/**
+ * AgentMessageEventType - String literal union
+ */
+type AgentMessageEventType = AgentMessageEvent["type"];
+/**
+ * Type guard: is this a message event?
+ */
+declare function isAgentMessageEvent(event: {
+    source?: string;
+    category?: string;
+}): event is AgentMessageEvent;
+
+export { type AgentStreamEvent as A, type AgentStateEventBase as B, type ConversationQueuedEvent as C, type AgentStateEventType as D, type ErrorOccurredEvent as E, isAgentStateEvent as F, type AgentMessageEventBase as G, type AgentMessageEventType as H, isAgentMessageEvent as I, type StopReason as S, type ToolPlannedEvent as T, type UserMessageEvent as U, type AgentMessageStartEvent as a, type AgentMessageDeltaEvent as b, type AgentMessageStopEvent as c, type AgentTextDeltaEvent as d, type AgentToolUseStartEvent as e, type AgentInputJsonDeltaEvent as f, type AgentToolUseStopEvent as g, type AgentToolResultEvent as h, type AgentStateEvent as i, type ConversationStartEvent as j, type ConversationThinkingEvent as k, type ConversationRespondingEvent as l, type ConversationEndEvent as m, type ConversationInterruptedEvent as n, type ToolExecutingEvent as o, type ToolCompletedEvent as p, type ToolFailedEvent as q, type AgentMessageEvent as r, type AssistantMessageEvent as s, type ToolCallMessageEvent as t, type ToolResultMessageEvent as u, type ErrorMessageEvent as v, type AgentStreamEventBase as w, type AgentErrorReceivedEvent as x, type AgentStreamEventType as y, isAgentStreamEvent as z };