@agentxjs/types 0.0.9 → 0.2.0

package/dist/agentx.d.cts

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

package/dist/agentx.d.ts

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

package/dist/agentx.js

@@ -0,0 +1,12 @@
+// src/agentx/index.ts
+function isRemoteConfig(config) {
+  return "serverUrl" in config && typeof config.serverUrl === "string";
+}
+function isLocalConfig(config) {
+  return !isRemoteConfig(config);
+}
+export {
+  isLocalConfig,
+  isRemoteConfig
+};
+//# sourceMappingURL=agentx.js.map

package/dist/agentx.js.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":";AA8PO,SAAS,eAAe,QAA8C;AAC3E,SAAO,eAAe,UAAU,OAAO,OAAO,cAAc;AAC9D;AAKO,SAAS,cAAc,QAA6C;AACzE,SAAO,CAAC,eAAe,MAAM;AAC/B;","names":[]}

package/dist/chunk-2QHAIM3V.js

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-2QHAIM3V.js.map

package/dist/chunk-2QHAIM3V.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/common.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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/common/index.ts
+var common_exports = {};
+module.exports = __toCommonJS(common_exports);
+//# sourceMappingURL=common.cjs.map

package/dist/common.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/common/index.ts"],"sourcesContent":["/**\n * Common Module - Shared Infrastructure Types\n *\n * Infrastructure types shared across all AgentX packages.\n *\n * ## Why Types Here, Implementation in @agentxjs/common?\n *\n * - @agentxjs/types has zero dependencies (pure types)\n * - @agentxjs/common has runtime dependencies (pino, etc.)\n * - All packages depend on types, not all need common's implementation\n *\n * ## Module Structure\n *\n * | Module   | Purpose                           |\n * |----------|-----------------------------------|\n * | logger/  | Logger interface (SLF4J-style)    |\n *\n * @packageDocumentation\n */\n\nexport * from \"./logger\";\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}