@agentxjs/types 0.0.9 → 0.2.0

package/dist/agent.d.cts

@@ -0,0 +1,229 @@
+import { h as StreamEvent, a as AgentOutput, i as AgentEngine, E as EngineEvent } from './Agent-BXUYGlWZ.cjs';
+export { J as AgentErrorOccurredEvent, g as AgentEventHandler, X as AgentMessageEvent, f as AgentOutputCallback, A as AgentState, K as AgentStateEvent, a0 as AgentTurnEvent, P as AssistantMessageEvent, y as ConversationEndEvent, z as ConversationInterruptedEvent, C as ConversationQueuedEvent, x as ConversationRespondingEvent, v as ConversationStartEvent, w as ConversationThinkingEvent, W as ErrorMessageEvent, H as ErrorOccurredEvent, k as EventHandlerMap, I as InputJsonDeltaEvent, n as MessageDeltaEvent, N as MessageEvent, M as MessageQueue, m as MessageStartEvent, o as MessageStopEvent, R as ReactHandlerMap, j as StateChange, S as StateChangeHandler, u as StateEvent, t as StreamEventType, p as TextDeltaEvent, T as ToEngineEvent, l as ToEngineEventUnion, Q as ToolCallMessageEvent, F as ToolCompletedEvent, D as ToolExecutingEvent, G as ToolFailedEvent, B as ToolPlannedEvent, s as ToolResultEvent, V as ToolResultMessageEvent, q as ToolUseStartEvent, r as ToolUseStopEvent, Z as TurnEvent, _ as TurnRequestEvent, $ as TurnResponseEvent, U as Unsubscribe, O as UserMessageEvent, Y as isMessageEvent, L as isStateEvent, a1 as isTurnEvent } from './Agent-BXUYGlWZ.cjs';
+import { U as UserMessage } from './ToolResultMessage-CRKMSf5d.cjs';
+export { A as AssistantMessage, F as FilePart, I as ImagePart, b as TextPart, c as ThinkingPart, g as TokenUsage, T as ToolCallMessage, d as ToolCallPart, a as ToolResultMessage, f as ToolResultOutput, e as ToolResultPart } from './ToolResultMessage-CRKMSf5d.cjs';
+export { M as Message, a as MessageSubtype } from './Message-Crh81uLL.cjs';
+export { E as ErrorMessage } from './ErrorMessage-BoIh3MIO.cjs';
+export { C as ContentPart, M as MessageRole } from './ContentPart-DEFnYXCU.cjs';
+export { S as StopReason } from './index-CjFNcCxR.cjs';
+import './SystemEvent-CPvvxdMQ.cjs';
+
+/**
+ * AgentError - Error types for Agent layer
+ *
+ * Standardized error structure for agent operations.
+ */
+/**
+ * Error category
+ */
+type AgentErrorCategory = "network" | "validation" | "system" | "business";
+/**
+ * AgentError - Standardized error structure
+ */
+interface AgentError {
+    /**
+     * Error category
+     */
+    category: AgentErrorCategory;
+    /**
+     * Error code (e.g., "NETWORK_TIMEOUT", "INVALID_INPUT")
+     */
+    code: string;
+    /**
+     * Human-readable error message
+     */
+    message: string;
+    /**
+     * Whether the error is recoverable
+     */
+    recoverable: boolean;
+    /**
+     * Original error (if any)
+     */
+    cause?: Error;
+    /**
+     * Additional context
+     */
+    context?: Record<string, unknown>;
+}
+
+/**
+ * AgentDriver - Message Processing Interface
+ *
+ * AgentDriver is a pure message processor.
+ * It receives user messages and yields StreamEvents.
+ *
+ * Key Design:
+ * - One Agent = One Driver instance
+ * - Driver only handles message processing
+ * - Lifecycle management is Container's responsibility
+ * - Resume/history is Container's responsibility
+ *
+ * @example
+ * ```typescript
+ * class ClaudeDriver implements AgentDriver {
+ *   readonly name = "ClaudeDriver";
+ *
+ *   async *receive(message: UserMessage) {
+ *     const stream = this.client.messages.stream({
+ *       model: "claude-sonnet-4-20250514",
+ *       messages: [{ role: "user", content: message.content }],
+ *     });
+ *
+ *     for await (const chunk of stream) {
+ *       yield transformToStreamEvent(chunk);
+ *     }
+ *   }
+ *
+ *   interrupt() {
+ *     this.abortController.abort();
+ *   }
+ * }
+ * ```
+ */
+
+/**
+ * AgentDriver interface
+ *
+ * A message processor that receives user messages and yields StreamEvents.
+ * Lifecycle (creation, resume, destruction) is managed by Container.
+ */
+interface AgentDriver {
+    /**
+     * Driver name (for identification and logging)
+     */
+    readonly name: string;
+    /**
+     * Optional description
+     */
+    readonly description?: string;
+    /**
+     * Receive a user message and yield stream events
+     *
+     * @param message - User message to process
+     * @returns AsyncIterable of StreamEvent
+     */
+    receive(message: UserMessage): AsyncIterable<StreamEvent>;
+    /**
+     * Interrupt the current operation
+     *
+     * Stops the current receive() operation gracefully.
+     * Driver should abort any ongoing requests.
+     */
+    interrupt(): void;
+}
+
+/**
+ * AgentPresenter - Output adapter interface
+ *
+ * AgentPresenter receives agent outputs and presents them to external systems.
+ * Examples: SSE streaming, WebSocket, logging, persistence.
+ *
+ * @example
+ * ```typescript
+ * const ssePresenter: AgentPresenter = {
+ *   name: "SSEPresenter",
+ *   description: "Forwards stream events via Server-Sent Events",
+ *
+ *   present(agentId, output) {
+ *     if (output.type === "text_delta") {
+ *       sseConnection.send(agentId, output);
+ *     }
+ *   },
+ * };
+ * ```
+ */
+
+/**
+ * AgentPresenter interface
+ *
+ * A named, self-describing presenter that receives agent outputs
+ * and presents them to external systems.
+ */
+interface AgentPresenter {
+    /**
+     * Presenter name (for identification and logging)
+     */
+    readonly name: string;
+    /**
+     * Optional description
+     */
+    readonly description?: string;
+    /**
+     * Present an agent output
+     *
+     * @param agentId - The agent ID
+     * @param output - The output to present
+     */
+    present(agentId: string, output: AgentOutput): void | Promise<void>;
+}
+
+/**
+ * CreateAgentOptions - Factory options for creating an AgentEngine
+ */
+
+/**
+ * Options for creating an AgentEngine
+ */
+interface CreateAgentOptions {
+    /**
+     * Driver - Event producer (LLM interaction)
+     */
+    driver: AgentDriver;
+    /**
+     * Presenter - Event consumer (side effects)
+     */
+    presenter: AgentPresenter;
+}
+/**
+ * Factory function to create an AgentEngine
+ *
+ * AgentEngine is a logical processing unit that coordinates:
+ * - Driver: produces stream events from LLM
+ * - MealyMachine: assembles events (internal, created automatically)
+ * - Presenter: consumes processed events
+ *
+ * @example
+ * ```typescript
+ * const engine = createAgent({
+ *   driver: new ClaudeDriver(config),
+ *   presenter: new SSEPresenter(connection),
+ * });
+ *
+ * engine.on("text_delta", (e) => console.log(e.data.text));
+ * await engine.receive("Hello!");
+ * ```
+ */
+declare function createAgent(options: CreateAgentOptions): AgentEngine;
+
+/**
+ * Engine Event Types (Lightweight)
+ *
+ * Lightweight event types for AgentEngine internal use.
+ * These only contain: type, timestamp, data
+ *
+ * Full events (with source, category, intent, context) are in:
+ * @agentxjs/types/event/agent
+ *
+ * ## Relationship
+ *
+ * ```
+ * @agentxjs/types/event/agent     @agentxjs/types/agent/event
+ * (Runtime domain - Full)          (Engine domain - Lightweight)
+ * ────────────────────────────────────────────────────────────────
+ * AgentEvent (SystemEvent)         EngineEvent
+ *   type, timestamp, data            type, timestamp, data
+ *   source, category, intent
+ *   context
+ *
+ * TextDeltaEvent                   TextDeltaEvent
+ *   (full SystemEvent)               = ToEngineEvent<Full>
+ * ```
+ */
+
+/**
+ * @deprecated Use EngineEvent instead
+ */
+type AgentEvent<T extends string = string, D = unknown> = EngineEvent<T, D>;
+
+export { type AgentDriver, AgentEngine, type AgentError, type AgentErrorCategory, type AgentEvent, AgentOutput, type AgentPresenter, type CreateAgentOptions, EngineEvent, StreamEvent, UserMessage, createAgent };

package/dist/agent.d.ts

@@ -0,0 +1,229 @@
+import { h as StreamEvent, a as AgentOutput, i as AgentEngine, E as EngineEvent } from './Agent-CaSxMF_E.js';
+export { J as AgentErrorOccurredEvent, g as AgentEventHandler, X as AgentMessageEvent, f as AgentOutputCallback, A as AgentState, K as AgentStateEvent, a0 as AgentTurnEvent, P as AssistantMessageEvent, y as ConversationEndEvent, z as ConversationInterruptedEvent, C as ConversationQueuedEvent, x as ConversationRespondingEvent, v as ConversationStartEvent, w as ConversationThinkingEvent, W as ErrorMessageEvent, H as ErrorOccurredEvent, k as EventHandlerMap, I as InputJsonDeltaEvent, n as MessageDeltaEvent, N as MessageEvent, M as MessageQueue, m as MessageStartEvent, o as MessageStopEvent, R as ReactHandlerMap, j as StateChange, S as StateChangeHandler, u as StateEvent, t as StreamEventType, p as TextDeltaEvent, T as ToEngineEvent, l as ToEngineEventUnion, Q as ToolCallMessageEvent, F as ToolCompletedEvent, D as ToolExecutingEvent, G as ToolFailedEvent, B as ToolPlannedEvent, s as ToolResultEvent, V as ToolResultMessageEvent, q as ToolUseStartEvent, r as ToolUseStopEvent, Z as TurnEvent, _ as TurnRequestEvent, $ as TurnResponseEvent, U as Unsubscribe, O as UserMessageEvent, Y as isMessageEvent, L as isStateEvent, a1 as isTurnEvent } from './Agent-CaSxMF_E.js';
+import { U as UserMessage } from './ToolResultMessage-CDG2L7Zv.js';
+export { A as AssistantMessage, F as FilePart, I as ImagePart, b as TextPart, c as ThinkingPart, g as TokenUsage, T as ToolCallMessage, d as ToolCallPart, a as ToolResultMessage, f as ToolResultOutput, e as ToolResultPart } from './ToolResultMessage-CDG2L7Zv.js';
+export { M as Message, a as MessageSubtype } from './Message-DWQUt647.js';
+export { E as ErrorMessage } from './ErrorMessage-BoIh3MIO.js';
+export { C as ContentPart, M as MessageRole } from './ContentPart-CqOh-rI1.js';
+export { S as StopReason } from './index-usKuk41S.js';
+import './SystemEvent-CPvvxdMQ.js';
+
+/**
+ * AgentError - Error types for Agent layer
+ *
+ * Standardized error structure for agent operations.
+ */
+/**
+ * Error category
+ */
+type AgentErrorCategory = "network" | "validation" | "system" | "business";
+/**
+ * AgentError - Standardized error structure
+ */
+interface AgentError {
+    /**
+     * Error category
+     */
+    category: AgentErrorCategory;
+    /**
+     * Error code (e.g., "NETWORK_TIMEOUT", "INVALID_INPUT")
+     */
+    code: string;
+    /**
+     * Human-readable error message
+     */
+    message: string;
+    /**
+     * Whether the error is recoverable
+     */
+    recoverable: boolean;
+    /**
+     * Original error (if any)
+     */
+    cause?: Error;
+    /**
+     * Additional context
+     */
+    context?: Record<string, unknown>;
+}
+
+/**
+ * AgentDriver - Message Processing Interface
+ *
+ * AgentDriver is a pure message processor.
+ * It receives user messages and yields StreamEvents.
+ *
+ * Key Design:
+ * - One Agent = One Driver instance
+ * - Driver only handles message processing
+ * - Lifecycle management is Container's responsibility
+ * - Resume/history is Container's responsibility
+ *
+ * @example
+ * ```typescript
+ * class ClaudeDriver implements AgentDriver {
+ *   readonly name = "ClaudeDriver";
+ *
+ *   async *receive(message: UserMessage) {
+ *     const stream = this.client.messages.stream({
+ *       model: "claude-sonnet-4-20250514",
+ *       messages: [{ role: "user", content: message.content }],
+ *     });
+ *
+ *     for await (const chunk of stream) {
+ *       yield transformToStreamEvent(chunk);
+ *     }
+ *   }
+ *
+ *   interrupt() {
+ *     this.abortController.abort();
+ *   }
+ * }
+ * ```
+ */
+
+/**
+ * AgentDriver interface
+ *
+ * A message processor that receives user messages and yields StreamEvents.
+ * Lifecycle (creation, resume, destruction) is managed by Container.
+ */
+interface AgentDriver {
+    /**
+     * Driver name (for identification and logging)
+     */
+    readonly name: string;
+    /**
+     * Optional description
+     */
+    readonly description?: string;
+    /**
+     * Receive a user message and yield stream events
+     *
+     * @param message - User message to process
+     * @returns AsyncIterable of StreamEvent
+     */
+    receive(message: UserMessage): AsyncIterable<StreamEvent>;
+    /**
+     * Interrupt the current operation
+     *
+     * Stops the current receive() operation gracefully.
+     * Driver should abort any ongoing requests.
+     */
+    interrupt(): void;
+}
+
+/**
+ * AgentPresenter - Output adapter interface
+ *
+ * AgentPresenter receives agent outputs and presents them to external systems.
+ * Examples: SSE streaming, WebSocket, logging, persistence.
+ *
+ * @example
+ * ```typescript
+ * const ssePresenter: AgentPresenter = {
+ *   name: "SSEPresenter",
+ *   description: "Forwards stream events via Server-Sent Events",
+ *
+ *   present(agentId, output) {
+ *     if (output.type === "text_delta") {
+ *       sseConnection.send(agentId, output);
+ *     }
+ *   },
+ * };
+ * ```
+ */
+
+/**
+ * AgentPresenter interface
+ *
+ * A named, self-describing presenter that receives agent outputs
+ * and presents them to external systems.
+ */
+interface AgentPresenter {
+    /**
+     * Presenter name (for identification and logging)
+     */
+    readonly name: string;
+    /**
+     * Optional description
+     */
+    readonly description?: string;
+    /**
+     * Present an agent output
+     *
+     * @param agentId - The agent ID
+     * @param output - The output to present
+     */
+    present(agentId: string, output: AgentOutput): void | Promise<void>;
+}
+
+/**
+ * CreateAgentOptions - Factory options for creating an AgentEngine
+ */
+
+/**
+ * Options for creating an AgentEngine
+ */
+interface CreateAgentOptions {
+    /**
+     * Driver - Event producer (LLM interaction)
+     */
+    driver: AgentDriver;
+    /**
+     * Presenter - Event consumer (side effects)
+     */
+    presenter: AgentPresenter;
+}
+/**
+ * Factory function to create an AgentEngine
+ *
+ * AgentEngine is a logical processing unit that coordinates:
+ * - Driver: produces stream events from LLM
+ * - MealyMachine: assembles events (internal, created automatically)
+ * - Presenter: consumes processed events
+ *
+ * @example
+ * ```typescript
+ * const engine = createAgent({
+ *   driver: new ClaudeDriver(config),
+ *   presenter: new SSEPresenter(connection),
+ * });
+ *
+ * engine.on("text_delta", (e) => console.log(e.data.text));
+ * await engine.receive("Hello!");
+ * ```
+ */
+declare function createAgent(options: CreateAgentOptions): AgentEngine;
+
+/**
+ * Engine Event Types (Lightweight)
+ *
+ * Lightweight event types for AgentEngine internal use.
+ * These only contain: type, timestamp, data
+ *
+ * Full events (with source, category, intent, context) are in:
+ * @agentxjs/types/event/agent
+ *
+ * ## Relationship
+ *
+ * ```
+ * @agentxjs/types/event/agent     @agentxjs/types/agent/event
+ * (Runtime domain - Full)          (Engine domain - Lightweight)
+ * ────────────────────────────────────────────────────────────────
+ * AgentEvent (SystemEvent)         EngineEvent
+ *   type, timestamp, data            type, timestamp, data
+ *   source, category, intent
+ *   context
+ *
+ * TextDeltaEvent                   TextDeltaEvent
+ *   (full SystemEvent)               = ToEngineEvent<Full>
+ * ```
+ */
+
+/**
+ * @deprecated Use EngineEvent instead
+ */
+type AgentEvent<T extends string = string, D = unknown> = EngineEvent<T, D>;
+
+export { type AgentDriver, AgentEngine, type AgentError, type AgentErrorCategory, type AgentEvent, AgentOutput, type AgentPresenter, type CreateAgentOptions, EngineEvent, StreamEvent, UserMessage, createAgent };

package/dist/agent.js

@@ -0,0 +1,41 @@
+// src/agent/event/state/index.ts
+function isStateEvent(event) {
+  const stateTypes = [
+    "conversation_queued",
+    "conversation_start",
+    "conversation_thinking",
+    "conversation_responding",
+    "conversation_end",
+    "conversation_interrupted",
+    "tool_planned",
+    "tool_executing",
+    "tool_completed",
+    "tool_failed",
+    "error_occurred"
+  ];
+  return stateTypes.includes(event.type);
+}
+
+// src/agent/event/message/index.ts
+function isMessageEvent(event) {
+  const messageTypes = [
+    "user_message",
+    "assistant_message",
+    "tool_call_message",
+    "tool_result_message",
+    "error_message"
+  ];
+  return messageTypes.includes(event.type);
+}
+
+// src/agent/event/turn/index.ts
+function isTurnEvent(event) {
+  const turnTypes = ["turn_request", "turn_response"];
+  return turnTypes.includes(event.type);
+}
+export {
+  isMessageEvent,
+  isStateEvent,
+  isTurnEvent
+};
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent/event/state/index.ts","../src/agent/event/message/index.ts","../src/agent/event/turn/index.ts"],"sourcesContent":["/**\n * Engine State Events (Lightweight)\n *\n * Lightweight state events for AgentEngine internal use.\n * Derived from full AgentStateEvent in @agentxjs/types/event/agent.\n */\n\nimport type {\n  AgentStateEvent as FullAgentStateEvent,\n  ConversationQueuedEvent as FullConversationQueuedEvent,\n  ConversationStartEvent as FullConversationStartEvent,\n  ConversationThinkingEvent as FullConversationThinkingEvent,\n  ConversationRespondingEvent as FullConversationRespondingEvent,\n  ConversationEndEvent as FullConversationEndEvent,\n  ConversationInterruptedEvent as FullConversationInterruptedEvent,\n  ToolPlannedEvent as FullToolPlannedEvent,\n  ToolExecutingEvent as FullToolExecutingEvent,\n  ToolCompletedEvent as FullToolCompletedEvent,\n  ToolFailedEvent as FullToolFailedEvent,\n  ErrorOccurredEvent as FullErrorOccurredEvent,\n} from \"~/event/agent/state\";\nimport type { EngineEvent, ToEngineEvent, ToEngineEventUnion } from \"../EngineEvent\";\n\n// ============================================================================\n// Base Type (for backward compatibility)\n// ============================================================================\n\n/**\n * StateEvent - Base type for state events\n * @deprecated Use specific event types instead\n */\nexport interface StateEvent<T extends string = string, D = unknown> extends EngineEvent<T, D> {}\n\n// ============================================================================\n// Lightweight Event Types\n// ============================================================================\n\nexport type ConversationQueuedEvent = ToEngineEvent<FullConversationQueuedEvent>;\nexport type ConversationStartEvent = ToEngineEvent<FullConversationStartEvent>;\nexport type ConversationThinkingEvent = ToEngineEvent<FullConversationThinkingEvent>;\nexport type ConversationRespondingEvent = ToEngineEvent<FullConversationRespondingEvent>;\nexport type ConversationEndEvent = ToEngineEvent<FullConversationEndEvent>;\nexport type ConversationInterruptedEvent = ToEngineEvent<FullConversationInterruptedEvent>;\nexport type ToolPlannedEvent = ToEngineEvent<FullToolPlannedEvent>;\nexport type ToolExecutingEvent = ToEngineEvent<FullToolExecutingEvent>;\nexport type ToolCompletedEvent = ToEngineEvent<FullToolCompletedEvent>;\nexport type ToolFailedEvent = ToEngineEvent<FullToolFailedEvent>;\nexport type ErrorOccurredEvent = ToEngineEvent<FullErrorOccurredEvent>;\n\n/**\n * Alias for ErrorOccurredEvent (legacy compatibility)\n */\nexport type AgentErrorOccurredEvent = ErrorOccurredEvent;\n\n/**\n * AgentStateEvent - All lightweight state events\n */\nexport type AgentStateEvent = ToEngineEventUnion<FullAgentStateEvent>;\n\n/**\n * Type guard: is this a state event?\n */\nexport function isStateEvent(event: EngineEvent): event is AgentStateEvent {\n  const stateTypes = [\n    \"conversation_queued\",\n    \"conversation_start\",\n    \"conversation_thinking\",\n    \"conversation_responding\",\n    \"conversation_end\",\n    \"conversation_interrupted\",\n    \"tool_planned\",\n    \"tool_executing\",\n    \"tool_completed\",\n    \"tool_failed\",\n    \"error_occurred\",\n  ];\n  return stateTypes.includes(event.type);\n}\n","/**\n * Engine Message Events (Lightweight)\n *\n * Lightweight message events for AgentEngine internal use.\n * Derived from full AgentMessageEvent in @agentxjs/types/event/agent.\n */\n\nimport type {\n  AgentMessageEvent as FullAgentMessageEvent,\n  UserMessageEvent as FullUserMessageEvent,\n  AssistantMessageEvent as FullAssistantMessageEvent,\n  ToolCallMessageEvent as FullToolCallMessageEvent,\n  ToolResultMessageEvent as FullToolResultMessageEvent,\n  ErrorMessageEvent as FullErrorMessageEvent,\n} from \"~/event/agent/message\";\nimport type { EngineEvent, ToEngineEvent, ToEngineEventUnion } from \"../EngineEvent\";\n\n// Re-export parts (they're not events, just types)\nexport type { ContentPart, ToolCallPart, ToolResultPart } from \"../../message/parts\";\n\n// ============================================================================\n// Base Type (for backward compatibility)\n// ============================================================================\n\n/**\n * MessageEvent - Base type for message events\n * @deprecated Use specific event types instead\n */\nexport interface MessageEvent<T extends string = string, D = unknown> extends EngineEvent<T, D> {}\n\n// ============================================================================\n// Lightweight Event Types\n// ============================================================================\n\nexport type UserMessageEvent = ToEngineEvent<FullUserMessageEvent>;\nexport type AssistantMessageEvent = ToEngineEvent<FullAssistantMessageEvent>;\nexport type ToolCallMessageEvent = ToEngineEvent<FullToolCallMessageEvent>;\nexport type ToolResultMessageEvent = ToEngineEvent<FullToolResultMessageEvent>;\nexport type ErrorMessageEvent = ToEngineEvent<FullErrorMessageEvent>;\n\n/**\n * AgentMessageEvent - All lightweight message events\n */\nexport type AgentMessageEvent = ToEngineEventUnion<FullAgentMessageEvent>;\n\n/**\n * Type guard: is this a message event?\n */\nexport function isMessageEvent(event: EngineEvent): event is AgentMessageEvent {\n  const messageTypes = [\n    \"user_message\",\n    \"assistant_message\",\n    \"tool_call_message\",\n    \"tool_result_message\",\n    \"error_message\",\n  ];\n  return messageTypes.includes(event.type);\n}\n","/**\n * Engine Turn Events (Lightweight)\n *\n * Lightweight turn events for AgentEngine internal use.\n * Derived from full AgentTurnEvent in @agentxjs/types/event/agent.\n */\n\nimport type {\n  AgentTurnEvent as FullAgentTurnEvent,\n  TurnRequestEvent as FullTurnRequestEvent,\n  TurnResponseEvent as FullTurnResponseEvent,\n  TokenUsage,\n} from \"~/event/agent/turn\";\nimport type { EngineEvent, ToEngineEvent, ToEngineEventUnion } from \"../EngineEvent\";\n\n// Re-export TokenUsage (it's not an event, just a type)\nexport type { TokenUsage };\n\n// ============================================================================\n// Base Type (for backward compatibility)\n// ============================================================================\n\n/**\n * TurnEvent - Base type for turn events\n * @deprecated Use specific event types instead\n */\nexport interface TurnEvent<T extends string = string, D = unknown> extends EngineEvent<T, D> {}\n\n// ============================================================================\n// Lightweight Event Types\n// ============================================================================\n\nexport type TurnRequestEvent = ToEngineEvent<FullTurnRequestEvent>;\nexport type TurnResponseEvent = ToEngineEvent<FullTurnResponseEvent>;\n\n/**\n * AgentTurnEvent - All lightweight turn events\n */\nexport type AgentTurnEvent = ToEngineEventUnion<FullAgentTurnEvent>;\n\n/**\n * Type guard: is this a turn event?\n */\nexport function isTurnEvent(event: EngineEvent): event is AgentTurnEvent {\n  const turnTypes = [\"turn_request\", \"turn_response\"];\n  return turnTypes.includes(event.type);\n}\n"],"mappings":";AA8DO,SAAS,aAAa,OAA8C;AACzE,QAAM,aAAa;AAAA,IACjB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACA,SAAO,WAAW,SAAS,MAAM,IAAI;AACvC;;;AC7BO,SAAS,eAAe,OAAgD;AAC7E,QAAM,eAAe;AAAA,IACnB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACA,SAAO,aAAa,SAAS,MAAM,IAAI;AACzC;;;ACdO,SAAS,YAAY,OAA6C;AACvE,QAAM,YAAY,CAAC,gBAAgB,eAAe;AAClD,SAAO,UAAU,SAAS,MAAM,IAAI;AACtC;","names":[]}

package/dist/agentx.cjs

@@ -0,0 +1,38 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/agentx/index.ts
+var agentx_exports = {};
+__export(agentx_exports, {
+  isLocalConfig: () => isLocalConfig,
+  isRemoteConfig: () => isRemoteConfig
+});
+module.exports = __toCommonJS(agentx_exports);
+function isRemoteConfig(config) {
+  return "serverUrl" in config && typeof config.serverUrl === "string";
+}
+function isLocalConfig(config) {
+  return !isRemoteConfig(config);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isLocalConfig,
+  isRemoteConfig
+});
+//# sourceMappingURL=agentx.cjs.map

package/dist/agentx.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agentx/index.ts"],"sourcesContent":["/**\n * AgentX - Unified High-Level API for AI Agents\n *\n * AgentX provides a simple, consistent API for both local and remote modes.\n * It wraps Runtime and provides the same interface regardless of deployment.\n *\n * ## Two Modes\n *\n * ```\n * Local Mode                          Remote Mode\n * ─────────────────────────────────────────────────────────\n * AgentX                              AgentX\n *   │                                   │\n *   └── Runtime (embedded)              └── WebSocket ──→ Server\n *         │                                                │\n *         └── LLM, Storage                                 └── Runtime\n * ```\n *\n * ## API Design\n *\n * All operations use CommandEvent pattern:\n * - `request(type, data)` - Send request, wait for response\n * - `on(type, handler)` - Subscribe to events\n * - `onCommand(type, handler)` - Type-safe command subscription\n *\n * ## Usage\n *\n * ```typescript\n * // Local mode (default)\n * const agentx = await createAgentX();\n *\n * // Local mode with custom LLM and storage\n * const agentx = await createAgentX({\n *   llm: { apiKey: \"sk-...\", model: \"claude-opus-4-20250514\" },\n *   storage: { driver: \"postgresql\", url: \"postgres://...\" },\n * });\n *\n * // Remote mode\n * const agentx = await createAgentX({ server: \"ws://localhost:5200\" });\n *\n * // Same API for both modes!\n * const res = await agentx.request(\"container_create_request\", {\n *   containerId: \"my-container\"\n * });\n *\n * agentx.on(\"text_delta\", (e) => console.log(e.data.text));\n *\n * await agentx.dispose();\n * ```\n *\n * @packageDocumentation\n */\n\nimport type { SystemEvent } from \"~/event/base\";\nimport type {\n  CommandEventMap,\n  CommandRequestType,\n  ResponseEventFor,\n  RequestDataFor,\n} from \"~/event/command\";\nimport type { LogLevel, LoggerFactory } from \"~/common/logger\";\n\n// ============================================================================\n// Configuration - Local Mode\n// ============================================================================\n\n/**\n * LLM configuration\n */\nexport interface LLMConfig {\n  /**\n   * Anthropic API key (required)\n   */\n  apiKey: string;\n\n  /**\n   * API base URL\n   * @default \"https://api.anthropic.com\"\n   */\n  baseUrl?: string;\n\n  /**\n   * Model name\n   * @default \"claude-sonnet-4-20250514\"\n   */\n  model?: string;\n}\n\n/**\n * Storage driver type\n */\nexport type StorageDriver =\n  | \"memory\"\n  | \"fs\"\n  | \"redis\"\n  | \"mongodb\"\n  | \"sqlite\"\n  | \"mysql\"\n  | \"postgresql\";\n\n/**\n * Storage configuration\n */\nexport interface StorageConfig {\n  /**\n   * Storage driver\n   * @default \"memory\"\n   */\n  driver?: StorageDriver;\n\n  /**\n   * File path (for sqlite, fs drivers)\n   * @example \"./data.db\" for sqlite\n   * @example \"./data\" for fs\n   */\n  path?: string;\n\n  /**\n   * Connection URL (for redis, mongodb, mysql, postgresql)\n   * @example \"redis://localhost:6379\"\n   * @example \"mongodb://localhost:27017/agentx\"\n   * @example \"mysql://user:pass@localhost:3306/agentx\"\n   * @example \"postgres://user:pass@localhost:5432/agentx\"\n   */\n  url?: string;\n}\n\n/**\n * Logger configuration\n */\nexport interface LoggerConfig {\n  /**\n   * Log level\n   * @default LogLevel.INFO\n   */\n  level?: LogLevel;\n\n  /**\n   * Custom logger factory implementation\n   * If provided, this factory will be used to create all logger instances.\n   * If not provided, uses ConsoleLogger with console options.\n   */\n  factory?: LoggerFactory;\n\n  /**\n   * Console logger options (only used when factory is not provided)\n   */\n  console?: {\n    /**\n     * Enable colored output\n     * @default true (Node.js), false (browser)\n     */\n    colors?: boolean;\n\n    /**\n     * Include timestamps in log output\n     * @default true\n     */\n    timestamps?: boolean;\n  };\n}\n\n/**\n * Local mode configuration\n *\n * Runs AgentX with local runtime, connecting directly to LLM API.\n */\nexport interface LocalConfig {\n  /**\n   * LLM configuration\n   */\n  llm?: LLMConfig;\n\n  /**\n   * Logger configuration\n   */\n  logger?: LoggerConfig;\n\n  /**\n   * AgentX base directory for runtime data (containers, workdirs, storage, logs)\n   * @default \"~/.agentx\" (user's home directory)\n   * @example \"/var/lib/agentx\"\n   * @example \"/Users/john/.agentx\"\n   *\n   * Directory structure:\n   * - {agentxDir}/data/agentx.db - SQLite database (auto-configured)\n   * - {agentxDir}/logs/ - Log files (if configured)\n   * - {agentxDir}/containers/ - Agent workdirs\n   */\n  agentxDir?: string;\n\n  /**\n   * HTTP server to attach WebSocket to.\n   * If provided, WebSocket upgrade will be handled on the same port.\n   * The server should handle authentication before upgrading.\n   *\n   * @example\n   * ```typescript\n   * import { createServer } from \"http\";\n   * import { Hono } from \"hono\";\n   *\n   * const app = new Hono();\n   * // ... add auth middleware\n   *\n   * const server = createServer(app.fetch);\n   * const agentx = await createAgentX({ server });\n   *\n   * server.listen(5200);\n   * ```\n   */\n  server?: {\n    on(\n      event: \"upgrade\",\n      listener: (\n        request: { url?: string; headers: { host?: string } },\n        socket: unknown,\n        head: unknown\n      ) => void\n    ): void;\n  };\n}\n\n// ============================================================================\n// Configuration - Remote Mode\n// ============================================================================\n\n/**\n * Remote mode configuration\n *\n * Connects to a remote AgentX server via WebSocket.\n */\nexport interface RemoteConfig {\n  /**\n   * Remote server URL (WebSocket)\n   * @example \"ws://localhost:5200\"\n   */\n  serverUrl: string;\n}\n\n// ============================================================================\n// Union Type\n// ============================================================================\n\n/**\n * AgentX configuration\n *\n * - LocalConfig: Run with local runtime (default)\n * - RemoteConfig: Connect to remote server\n */\nexport type AgentXConfig = LocalConfig | RemoteConfig;\n\n/**\n * Type guard: is this a remote config?\n */\nexport function isRemoteConfig(config: AgentXConfig): config is RemoteConfig {\n  return \"serverUrl\" in config && typeof config.serverUrl === \"string\";\n}\n\n/**\n * Type guard: is this a local config?\n */\nexport function isLocalConfig(config: AgentXConfig): config is LocalConfig {\n  return !isRemoteConfig(config);\n}\n\n// ============================================================================\n// Unsubscribe\n// ============================================================================\n\n/**\n * Unsubscribe function\n */\nexport type Unsubscribe = () => void;\n\n// ============================================================================\n// AgentX Interface\n// ============================================================================\n\n/**\n * AgentX - Main API interface\n *\n * Unified API for both local and remote modes.\n */\nexport interface AgentX {\n  // ==================== Core API ====================\n\n  /**\n   * Send a command request and wait for response.\n   *\n   * @example\n   * ```typescript\n   * const res = await agentx.request(\"container_create_request\", {\n   *   containerId: \"my-container\"\n   * });\n   * console.log(res.data.containerId);\n   * ```\n   */\n  request<T extends CommandRequestType>(\n    type: T,\n    data: RequestDataFor<T>,\n    timeout?: number\n  ): Promise<ResponseEventFor<T>>;\n\n  /**\n   * Subscribe to events.\n   *\n   * @example\n   * ```typescript\n   * agentx.on(\"text_delta\", (e) => {\n   *   process.stdout.write(e.data.text);\n   * });\n   * ```\n   */\n  on<T extends string>(type: T, handler: (event: SystemEvent & { type: T }) => void): Unsubscribe;\n\n  /**\n   * Subscribe to command events with full type safety.\n   *\n   * @example\n   * ```typescript\n   * agentx.onCommand(\"container_create_response\", (e) => {\n   *   console.log(e.data.containerId);\n   * });\n   * ```\n   */\n  onCommand<T extends keyof CommandEventMap>(\n    type: T,\n    handler: (event: CommandEventMap[T]) => void\n  ): Unsubscribe;\n\n  /**\n   * Emit a command event.\n   *\n   * For fine-grained control. Usually prefer `request()`.\n   */\n  emitCommand<T extends keyof CommandEventMap>(type: T, data: CommandEventMap[T][\"data\"]): void;\n\n  // ==================== Server API (local mode only) ====================\n\n  /**\n   * Start listening for remote connections.\n   *\n   * Only available in local mode.\n   *\n   * @example\n   * ```typescript\n   * await agentx.listen(5200);\n   * console.log(\"Server running on ws://localhost:5200\");\n   * ```\n   */\n  listen(port: number, host?: string): Promise<void>;\n\n  /**\n   * Stop listening for remote connections.\n   */\n  close(): Promise<void>;\n\n  // ==================== Lifecycle ====================\n\n  /**\n   * Dispose AgentX and release all resources.\n   */\n  dispose(): Promise<void>;\n}\n\n// ============================================================================\n// Factory Function\n// ============================================================================\n\n/**\n * Create AgentX instance\n *\n * @example\n * ```typescript\n * // Local mode (default)\n * const agentx = await createAgentX();\n *\n * // Local mode with config\n * const agentx = await createAgentX({\n *   llm: { apiKey: \"sk-...\" },\n *   storage: { driver: \"sqlite\", path: \"./data.db\" },\n * });\n *\n * // Remote mode\n * const agentx = await createAgentX({ server: \"ws://localhost:5200\" });\n * ```\n */\nexport declare function createAgentX(config?: AgentXConfig): Promise<AgentX>;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA8PO,SAAS,eAAe,QAA8C;AAC3E,SAAO,eAAe,UAAU,OAAO,OAAO,cAAc;AAC9D;AAKO,SAAS,cAAc,QAA6C;AACzE,SAAO,CAAC,eAAe,MAAM;AAC/B;","names":[]}