@agentxjs/core 1.9.10-dev → 2.0.1

package/dist/driver/index.d.ts

@@ -1,310 +1,2 @@
-import { U as UserMessage } from '../message-BMrMm1pq.js';
-
-/**
- * Driver Types - LLM Communication Layer
- *
- * Driver is the bridge between AgentX and external LLM (Claude, OpenAI, etc.)
- *
- * ```
- *                    AgentX
- *                      │
- *         receive()    │    AsyncIterable<StreamEvent>
- *         ─────────►   │   ◄─────────────────────────
- *                      │
- *              ┌───────────────┐
- *              │    Driver     │
- *              │               │
- *              │  UserMessage  │
- *              │      ↓        │
- *              │   [SDK call]  │
- *              │      ↓        │
- *              │  StreamEvent  │
- *              └───────────────┘
- *                      │
- *                      ▼
- *               External LLM
- *               (Claude SDK)
- * ```
- *
- * Key Design:
- * - Driver = single session communication (like Kimi SDK's Session)
- * - Clear input/output boundary (for recording/playback)
- * - Configuration defined by us (capability boundary)
- */
-
-/**
- * MCP Server configuration
- *
- * Defines how to launch an MCP server process.
- */
-interface McpServerConfig {
-    /**
-     * Command to run the MCP server
-     */
-    command: string;
-    /**
-     * Command arguments
-     */
-    args?: string[];
-    /**
-     * Environment variables for the process
-     */
-    env?: Record<string, string>;
-}
-/**
- * StopReason - Why the LLM stopped generating
- */
-type StopReason = "end_turn" | "max_tokens" | "tool_use" | "stop_sequence" | "content_filter" | "error" | "other";
-/**
- * StreamEvent - Lightweight event from Driver
- *
- * Only contains essential fields: type, timestamp, data
- * No source, category, intent, context (those are added by upper layers)
- */
-interface StreamEvent<T extends string = string, D = unknown> {
-    readonly type: T;
-    readonly timestamp: number;
-    readonly data: D;
-}
-interface MessageStartEvent extends StreamEvent<"message_start", {
-    messageId: string;
-    model: string;
-}> {
-}
-interface MessageStopEvent extends StreamEvent<"message_stop", {
-    stopReason: StopReason;
-}> {
-}
-interface TextDeltaEvent extends StreamEvent<"text_delta", {
-    text: string;
-}> {
-}
-interface ToolUseStartEvent extends StreamEvent<"tool_use_start", {
-    toolCallId: string;
-    toolName: string;
-}> {
-}
-interface InputJsonDeltaEvent extends StreamEvent<"input_json_delta", {
-    partialJson: string;
-}> {
-}
-interface ToolUseStopEvent extends StreamEvent<"tool_use_stop", {
-    toolCallId: string;
-    toolName: string;
-    input: Record<string, unknown>;
-}> {
-}
-interface ToolResultEvent extends StreamEvent<"tool_result", {
-    toolCallId: string;
-    result: unknown;
-    isError?: boolean;
-}> {
-}
-interface ErrorEvent extends StreamEvent<"error", {
-    message: string;
-    errorCode?: string;
-}> {
-}
-interface InterruptedEvent extends StreamEvent<"interrupted", {
-    reason: "user" | "timeout" | "error";
-}> {
-}
-/**
- * DriverStreamEvent - Union of all stream events from Driver
- */
-type DriverStreamEvent = MessageStartEvent | MessageStopEvent | TextDeltaEvent | ToolUseStartEvent | InputJsonDeltaEvent | ToolUseStopEvent | ToolResultEvent | ErrorEvent | InterruptedEvent;
-/**
- * DriverStreamEventType - String literal union of event types
- */
-type DriverStreamEventType = DriverStreamEvent["type"];
-/**
- * DriverConfig - All configuration for creating a Driver
- *
- * This is our capability boundary - we define what we support.
- * Specific implementations (Claude, OpenAI) must work within this.
- *
- * @typeParam TOptions - Driver-specific options type. Each driver implementation
- * can define its own options interface and pass it as a type parameter.
- *
- * @example
- * ```typescript
- * // Define driver-specific options
- * interface ClaudeDriverOptions {
- *   claudeCodePath?: string;
- *   maxTurns?: number;
- * }
- *
- * // Use with type parameter
- * const config: DriverConfig<ClaudeDriverOptions> = {
- *   apiKey: "...",
- *   agentId: "my-agent",
- *   options: {
- *     claudeCodePath: "/usr/local/bin/claude"
- *   }
- * };
- * ```
- */
-interface DriverConfig<TOptions = Record<string, unknown>> {
-    /**
-     * API key for authentication
-     */
-    apiKey: string;
-    /**
-     * Base URL for API endpoint (optional, for custom deployments)
-     */
-    baseUrl?: string;
-    /**
-     * Model identifier (e.g., "claude-sonnet-4-20250514")
-     */
-    model?: string;
-    /**
-     * Request timeout in milliseconds (default: 600000 = 10 minutes)
-     */
-    timeout?: number;
-    /**
-     * Agent ID (for identification and logging)
-     */
-    agentId: string;
-    /**
-     * System prompt for the agent
-     */
-    systemPrompt?: string;
-    /**
-     * Current working directory for tool execution
-     */
-    cwd?: string;
-    /**
-     * MCP servers configuration
-     */
-    mcpServers?: Record<string, McpServerConfig>;
-    /**
-     * Session ID to resume (for conversation continuity)
-     *
-     * If provided, Driver will attempt to resume this session.
-     * If not provided, a new session is created.
-     */
-    resumeSessionId?: string;
-    /**
-     * Callback when SDK session ID is captured
-     *
-     * Called once when the session ID becomes available.
-     * Save this ID to enable session resume later.
-     */
-    onSessionIdCaptured?: (sessionId: string) => void;
-    /**
-     * Driver-specific options
-     *
-     * Each driver implementation can define its own options type.
-     * This allows drivers to have custom configuration without
-     * polluting the base DriverConfig interface.
-     *
-     * @example
-     * ```typescript
-     * // ClaudeDriver options
-     * interface ClaudeDriverOptions {
-     *   claudeCodePath?: string;
-     * }
-     *
-     * const config: DriverConfig<ClaudeDriverOptions> = {
-     *   apiKey: "...",
-     *   options: { claudeCodePath: "/usr/bin/claude" }
-     * };
-     * ```
-     */
-    options?: TOptions;
-}
-/**
- * DriverState - Current state of the Driver
- *
- * - idle: Ready to receive messages
- * - active: Currently processing a message
- * - disposed: Driver has been disposed, cannot be used
- */
-type DriverState = "idle" | "active" | "disposed";
-/**
- * Driver - LLM Communication Interface
- *
- * Responsible for a single session's communication with LLM.
- * Similar to Kimi SDK's Session concept.
- *
- * Lifecycle:
- * 1. createDriver(config) → Driver instance
- * 2. driver.initialize() → Start SDK, MCP servers
- * 3. driver.receive(message) → Send message, get events
- * 4. driver.dispose() → Cleanup
- *
- * @example
- * ```typescript
- * const driver = createDriver(config);
- * await driver.initialize();
- *
- * const events = driver.receive(message);
- * for await (const event of events) {
- *   if (event.type === "text_delta") {
- *     console.log(event.data.text);
- *   }
- * }
- *
- * await driver.dispose();
- * ```
- */
-interface Driver {
-    /**
-     * Driver name (for identification and logging)
-     */
-    readonly name: string;
-    /**
-     * SDK Session ID (available after first message)
-     */
-    readonly sessionId: string | null;
-    /**
-     * Current state
-     */
-    readonly state: DriverState;
-    /**
-     * Receive a user message and return stream of events
-     *
-     * @param message - User message to send
-     * @returns AsyncIterable of stream events
-     */
-    receive(message: UserMessage): AsyncIterable<DriverStreamEvent>;
-    /**
-     * Interrupt current operation
-     *
-     * Stops the current receive() operation gracefully.
-     * The AsyncIterable will emit an "interrupted" event and complete.
-     */
-    interrupt(): void;
-    /**
-     * Initialize the Driver
-     *
-     * Starts SDK subprocess, MCP servers, etc.
-     * Must be called before receive().
-     */
-    initialize(): Promise<void>;
-    /**
-     * Dispose and cleanup resources
-     *
-     * Stops SDK subprocess, MCP servers, etc.
-     * Driver cannot be used after dispose().
-     */
-    dispose(): Promise<void>;
-}
-/**
- * CreateDriver - Factory function type for creating Driver instances
- *
- * Each implementation package exports a function of this type.
- *
- * @typeParam TOptions - Driver-specific options type
- *
- * @example
- * ```typescript
- * // @agentxjs/claude-driver
- * export const createClaudeDriver: CreateDriver<ClaudeDriverOptions> = (config) => {
- *   return new ClaudeDriver(config);
- * };
- * ```
- */
-type CreateDriver<TOptions = Record<string, unknown>> = (config: DriverConfig<TOptions>) => Driver;
-
-export type { CreateDriver, Driver, DriverConfig, DriverState, DriverStreamEvent, DriverStreamEventType, ErrorEvent, InputJsonDeltaEvent, InterruptedEvent, McpServerConfig, MessageStartEvent, MessageStopEvent, StopReason, StreamEvent, TextDeltaEvent, ToolResultEvent, ToolUseStartEvent, ToolUseStopEvent };
+export { h as CreateDriver, D as Driver, i as DriverConfig, j as DriverState, k as DriverStreamEvent, l as DriverStreamEventType, E as ErrorEvent, m as InputJsonDeltaEvent, n as InterruptedEvent, M as McpServerConfig, o as MessageStartEvent, p as MessageStopEvent, q as StopReason, r as StreamEvent, s as TextDeltaEvent, T as ToolDefinition, t as ToolResultEvent, u as ToolUseStartEvent, v as ToolUseStopEvent } from '../index--gxNpY5W.js';
+import '../message-Dn-I2vr0.js';

package/dist/event/index.d.ts

@@ -1,9 +1,9 @@
 import { B as BusEvent } from '../base-m40r3Qgu.js';
 export { b as EventCategory, c as EventContext, a as EventIntent, E as EventSource, S as SystemEvent, h as hasIntent, i as isFromSource, f as isNotification, d as isRequest, e as isResult } from '../base-m40r3Qgu.js';
-import { E as EventBus, B as BusEventHandler, S as SubscribeOptions, U as Unsubscribe, C as CommandEventMap, a as CommandRequestType, R as RequestDataFor, b as ResponseEventFor, c as EventConsumer, d as EventProducer } from '../bus-uF1DM2ox.js';
-export { u as AgentDestroyAllRequest, v as AgentDestroyAllResponse, s as AgentDestroyRequest, t as AgentDestroyResponse, o as AgentGetRequest, p as AgentGetResponse, y as AgentInterruptRequest, z as AgentInterruptResponse, q as AgentListRequest, r as AgentListResponse, A as AgentXResponse, a1 as CommandEvent, a2 as CommandEventType, $ as CommandRequest, a6 as CommandRequestResponseMap, a0 as CommandResponse, i as ContainerCreateRequest, j as ContainerCreateResponse, k as ContainerGetRequest, l as ContainerGetResponse, m as ContainerListRequest, n as ContainerListResponse, F as FilePart, D as ImageCreateRequest, G as ImageCreateResponse, X as ImageDeleteRequest, Y as ImageDeleteResponse, V as ImageGetRequest, W as ImageGetResponse, h as ImageListItem, P as ImageListRequest, Q as ImageListResponse, Z as ImageMessagesRequest, _ as ImageMessagesResponse, f as ImageMetadata, I as ImagePart, g as ImageRecord, H as ImageRunRequest, J as ImageRunResponse, K as ImageStopRequest, L as ImageStopResponse, N as ImageUpdateRequest, O as ImageUpdateResponse, M as McpServerConfig, w as MessageSendRequest, x as MessageSendResponse, a7 as ResponseTypeFor, T as TextPart, e as UserContentPart, a3 as isCommandEvent, a4 as isCommandRequest, a5 as isCommandResponse } from '../bus-uF1DM2ox.js';
-export { AgentErrorReceivedEvent, AgentEvent, AgentEventCategory, AgentInputJsonDeltaEvent, AgentMessageDeltaEvent, AgentMessageEvent, AgentMessageEventBase, AgentMessageEventType, AgentMessageStartEvent, AgentMessageStopEvent, AgentRegisteredEvent, AgentStateEvent, AgentStateEventBase, AgentStateEventType, AgentStopReason, AgentStreamEvent, AgentStreamEventBase, AgentStreamEventType, AgentTextDeltaEvent, AgentToolResultEvent, AgentToolUseStartEvent, AgentToolUseStopEvent, AgentTurnEvent, AgentTurnEventBase, AgentTurnEventType, AgentUnregisteredEvent, AssistantMessageEvent, BaseAgentEvent, ConnectedEvent, ConnectionEvent, ConnectionEventType, ContainerCreatedEvent, ContainerDestroyedEvent, ContainerEvent, ContainerLifecycleEvent, ConversationEndEvent, ConversationInterruptedEvent, ConversationQueuedEvent, ConversationRespondingEvent, ConversationStartEvent, ConversationThinkingEvent, DirectoryListRequest, DirectoryListResult, DisconnectedEvent, DriveableEvent, DriveableEventType, EnvironmentEvent, ErrorEvent, ErrorEventMap, ErrorEventType, ErrorMessageEvent, ErrorOccurredEvent, ErrorReceivedEvent, FileDeleteRequest, FileDeletedEvent, FileReadRequest, FileReadResult, FileWriteRequest, FileWrittenEvent, InputJsonDeltaEvent, InterruptedEvent, MCPEvent, MCPRequestEvent, MCPResultEvent, MCPServerConnectedEvent, MCPServerDisconnectedEvent, MessageDeltaEvent, MessagePersistRequest, MessagePersistedEvent, MessageStartEvent, MessageStopEvent, ReconnectingEvent, ResourceReadRequest, ResourceReadResult, SandboxEvent, SessionActionEvent, SessionActionRequestEvent, SessionActionResultEvent, SessionCreatedEvent, SessionDestroyedEvent, SessionEvent, SessionForkRequest, SessionForkedEvent, SessionLifecycleEvent, SessionPersistEvent, SessionPersistRequestEvent, SessionPersistResultEvent, SessionResumeRequest, SessionResumedEvent, SessionSaveRequest, SessionSavedEvent, SessionTitleUpdateRequest, SessionTitleUpdatedEvent, StopReason, SystemError, TextContentBlockStartEvent, TextContentBlockStopEvent, TextDeltaEvent, TokenUsage, ToolCallEvent, ToolCallMessageEvent, ToolCompletedEvent, ToolExecuteRequest, ToolExecutedEvent, ToolExecutingEvent, ToolExecutionErrorEvent, ToolFailedEvent, ToolPlannedEvent, ToolResultEvent, ToolResultMessageEvent, ToolUseContentBlockStartEvent, ToolUseContentBlockStopEvent, TurnRequestEvent, TurnResponseEvent, UserMessageEvent, WorkdirErrorEvent, WorkdirEvent, WorkdirRequestEvent, WorkdirResultEvent, isAgentEvent, isAgentMessageEvent, isAgentStateEvent, isAgentStreamEvent, isAgentTurnEvent, isConnectionEvent, isContainerEvent, isContainerLifecycleEvent, isDriveableEvent, isMCPEvent, isSandboxEvent, isSessionActionEvent, isSessionEvent, isSessionLifecycleEvent, isSessionPersistEvent, isStopReason, isWorkdirEvent } from './types/index.js';
-import '../message-BMrMm1pq.js';
+import { E as EventBus, B as BusEventHandler, S as SubscribeOptions, U as Unsubscribe, C as CommandEventMap, a as CommandRequestType, R as RequestDataFor, b as ResponseEventFor, c as EventConsumer, d as EventProducer } from '../bus-C9FLWIu8.js';
+export { u as AgentDestroyAllRequest, v as AgentDestroyAllResponse, s as AgentDestroyRequest, t as AgentDestroyResponse, o as AgentGetRequest, p as AgentGetResponse, y as AgentInterruptRequest, z as AgentInterruptResponse, q as AgentListRequest, r as AgentListResponse, A as AgentXResponse, a1 as CommandEvent, a2 as CommandEventType, $ as CommandRequest, a6 as CommandRequestResponseMap, a0 as CommandResponse, i as ContainerCreateRequest, j as ContainerCreateResponse, k as ContainerGetRequest, l as ContainerGetResponse, m as ContainerListRequest, n as ContainerListResponse, F as FilePart, D as ImageCreateRequest, G as ImageCreateResponse, X as ImageDeleteRequest, Y as ImageDeleteResponse, V as ImageGetRequest, W as ImageGetResponse, h as ImageListItem, P as ImageListRequest, Q as ImageListResponse, Z as ImageMessagesRequest, _ as ImageMessagesResponse, f as ImageMetadata, I as ImagePart, g as ImageRecord, H as ImageRunRequest, J as ImageRunResponse, K as ImageStopRequest, L as ImageStopResponse, N as ImageUpdateRequest, O as ImageUpdateResponse, M as McpServerConfig, w as MessageSendRequest, x as MessageSendResponse, a7 as ResponseTypeFor, T as TextPart, e as UserContentPart, a3 as isCommandEvent, a4 as isCommandRequest, a5 as isCommandResponse } from '../bus-C9FLWIu8.js';
+export { AgentErrorReceivedEvent, AgentEvent, AgentEventCategory, AgentInputJsonDeltaEvent, AgentMessageDeltaEvent, AgentMessageEvent, AgentMessageEventBase, AgentMessageEventType, AgentMessageStartEvent, AgentMessageStopEvent, AgentRegisteredEvent, AgentStateEvent, AgentStateEventBase, AgentStateEventType, AgentStopReason, AgentStreamEvent, AgentStreamEventBase, AgentStreamEventType, AgentTextDeltaEvent, AgentToolResultEvent, AgentToolUseStartEvent, AgentToolUseStopEvent, AgentTurnEvent, AgentTurnEventBase, AgentTurnEventType, AgentUnregisteredEvent, AssistantMessageEvent, BaseAgentEvent, ConnectedEvent, ConnectionEvent, ConnectionEventType, ContainerCreatedEvent, ContainerDestroyedEvent, ContainerEvent, ContainerLifecycleEvent, ConversationEndEvent, ConversationInterruptedEvent, ConversationQueuedEvent, ConversationRespondingEvent, ConversationStartEvent, ConversationThinkingEvent, DirectoryListRequest, DirectoryListResult, DisconnectedEvent, DriveableEvent, DriveableEventType, EnvironmentEvent, ErrorEvent, ErrorEventMap, ErrorEventType, ErrorMessageEvent, ErrorOccurredEvent, ErrorReceivedEvent, FileDeleteRequest, FileDeletedEvent, FileReadRequest, FileReadResult, FileWriteRequest, FileWrittenEvent, InputJsonDeltaEvent, InterruptedEvent, MCPEvent, MCPRequestEvent, MCPResultEvent, MCPServerConnectedEvent, MCPServerDisconnectedEvent, MessageDeltaEvent, MessagePersistRequest, MessagePersistedEvent, MessageStartEvent, MessageStopEvent, ReconnectingEvent, ResourceReadRequest, ResourceReadResult, SandboxEvent, SessionActionEvent, SessionActionRequestEvent, SessionActionResultEvent, SessionCreatedEvent, SessionDestroyedEvent, SessionEvent, SessionForkRequest, SessionForkedEvent, SessionLifecycleEvent, SessionPersistEvent, SessionPersistRequestEvent, SessionPersistResultEvent, SessionResumeRequest, SessionResumedEvent, SessionSaveRequest, SessionSavedEvent, SessionTitleUpdateRequest, SessionTitleUpdatedEvent, StopReason, SystemError, TextContentBlockStartEvent, TextContentBlockStopEvent, TextDeltaEvent, TokenUsage, ToolCallEvent, ToolCompletedEvent, ToolExecuteRequest, ToolExecutedEvent, ToolExecutingEvent, ToolExecutionErrorEvent, ToolFailedEvent, ToolPlannedEvent, ToolResultEvent, ToolResultMessageEvent, ToolUseContentBlockStartEvent, ToolUseContentBlockStopEvent, TurnRequestEvent, TurnResponseEvent, UserMessageEvent, WorkdirErrorEvent, WorkdirEvent, WorkdirRequestEvent, WorkdirResultEvent, isAgentEvent, isAgentMessageEvent, isAgentStateEvent, isAgentStreamEvent, isAgentTurnEvent, isConnectionEvent, isContainerEvent, isContainerLifecycleEvent, isDriveableEvent, isMCPEvent, isSandboxEvent, isSessionActionEvent, isSessionEvent, isSessionLifecycleEvent, isSessionPersistEvent, isStopReason, isWorkdirEvent } from './types/index.js';
+import '../message-Dn-I2vr0.js';
 
 /**
  * EventBus - Central event bus implementation

package/dist/event/index.js

@@ -1,6 +1,6 @@
 import {
   EventBusImpl
-} from "../chunk-7ZDX3O6I.js";
+} from "../chunk-AAFPAF67.js";
 import {
   hasIntent,
   isAgentEvent,
@@ -27,8 +27,7 @@ import {
   isSessionPersistEvent,
   isStopReason,
   isWorkdirEvent
-} from "../chunk-E5FPOAPO.js";
-import "../chunk-7D4SUZUM.js";
+} from "../chunk-22NTRYNO.js";
 export {
   EventBusImpl,
   hasIntent,