agentxjs 0.0.9 → 0.1.1

package/dist/browser.cjs

@@ -0,0 +1,215 @@
+'use strict';
+
+var agentx = require('@agentxjs/types/agentx');
+var event = require('@agentxjs/types/event');
+var common = require('@agentxjs/common');
+
+// src/browser.ts
+var remoteLogger = common.createLogger("agentx/RemoteClient");
+var isBrowser = typeof window !== "undefined" && typeof window.WebSocket !== "undefined";
+async function createRemoteAgentX(serverUrl) {
+  const WebSocketImpl = isBrowser ? window.WebSocket : (await import('ws')).WebSocket;
+  const ws = new WebSocketImpl(serverUrl);
+  const handlers = /* @__PURE__ */ new Map();
+  const pendingRequests = /* @__PURE__ */ new Map();
+  await new Promise((resolve, reject) => {
+    if (isBrowser) {
+      ws.onopen = () => resolve();
+      ws.onerror = () => reject(new Error("WebSocket connection failed"));
+    } else {
+      ws.on("open", () => resolve());
+      ws.on("error", (err) => reject(err));
+    }
+  });
+  const handleMessage = (data) => {
+    try {
+      const text = isBrowser ? data.data : data.toString();
+      const event = JSON.parse(text);
+      remoteLogger.info("Received event", {
+        type: event.type,
+        category: event.category,
+        requestId: event.data?.requestId
+      });
+      if (event.type === "system_error") {
+        const errorData = event.data;
+        remoteLogger.error(errorData.message, {
+          severity: errorData.severity,
+          requestId: event.data?.requestId,
+          details: errorData.details
+        });
+      }
+      const requestId = event.data?.requestId;
+      if (event.category === "response" && requestId && pendingRequests.has(requestId)) {
+        remoteLogger.info("Resolving pending request", { requestId, eventType: event.type });
+        const pending = pendingRequests.get(requestId);
+        clearTimeout(pending.timer);
+        pendingRequests.delete(requestId);
+        pending.resolve(event);
+        return;
+      }
+      remoteLogger.info("Dispatching to handlers", { type: event.type });
+      const typeHandlers = handlers.get(event.type);
+      if (typeHandlers) {
+        for (const handler of typeHandlers) {
+          handler(event);
+        }
+      }
+      const allHandlers = handlers.get("*");
+      if (allHandlers) {
+        for (const handler of allHandlers) {
+          handler(event);
+        }
+      }
+    } catch {
+    }
+  };
+  if (isBrowser) {
+    ws.onmessage = handleMessage;
+  } else {
+    ws.on("message", handleMessage);
+  }
+  function subscribe(type, handler) {
+    if (!handlers.has(type)) {
+      handlers.set(type, /* @__PURE__ */ new Set());
+    }
+    handlers.get(type).add(handler);
+    return () => {
+      handlers.get(type)?.delete(handler);
+    };
+  }
+  return {
+    request(type, data, timeout = 3e4) {
+      return new Promise((resolve, reject) => {
+        const requestId = `req_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
+        const timer = setTimeout(() => {
+          pendingRequests.delete(requestId);
+          reject(new Error(`Request timeout: ${type}`));
+        }, timeout);
+        pendingRequests.set(requestId, {
+          resolve,
+          reject,
+          timer
+        });
+        const event = {
+          type,
+          timestamp: Date.now(),
+          data: { ...data, requestId },
+          source: "command",
+          category: "request",
+          intent: "request"
+        };
+        ws.send(JSON.stringify(event));
+      });
+    },
+    on(type, handler) {
+      return subscribe(type, handler);
+    },
+    onCommand(type, handler) {
+      return subscribe(type, handler);
+    },
+    emitCommand(type, data) {
+      const event = {
+        type,
+        timestamp: Date.now(),
+        data,
+        source: "command",
+        category: type.toString().endsWith("_response") ? "response" : "request",
+        intent: type.toString().endsWith("_response") ? "result" : "request"
+      };
+      ws.send(JSON.stringify(event));
+    },
+    async listen() {
+      throw new Error("Cannot listen in remote mode");
+    },
+    async close() {
+    },
+    async dispose() {
+      for (const pending of pendingRequests.values()) {
+        clearTimeout(pending.timer);
+        pending.reject(new Error("AgentX disposed"));
+      }
+      pendingRequests.clear();
+      handlers.clear();
+      if (isBrowser) {
+        ws.close();
+      } else {
+        ws.close();
+      }
+    }
+  };
+}
+
+// src/browser.ts
+async function createAgentX(config) {
+  if (!config || !agentx.isRemoteConfig(config)) {
+    throw new Error(
+      'Browser environment only supports remote mode. Please provide { serverUrl: "ws://..." } configuration.'
+    );
+  }
+  return createRemoteAgentX(config.serverUrl);
+}
+
+Object.defineProperty(exports, "isLocalConfig", {
+  enumerable: true,
+  get: function () { return agentx.isLocalConfig; }
+});
+Object.defineProperty(exports, "isRemoteConfig", {
+  enumerable: true,
+  get: function () { return agentx.isRemoteConfig; }
+});
+Object.defineProperty(exports, "hasIntent", {
+  enumerable: true,
+  get: function () { return event.hasIntent; }
+});
+Object.defineProperty(exports, "isAgentEvent", {
+  enumerable: true,
+  get: function () { return event.isAgentEvent; }
+});
+Object.defineProperty(exports, "isAgentMessageEvent", {
+  enumerable: true,
+  get: function () { return event.isAgentMessageEvent; }
+});
+Object.defineProperty(exports, "isAgentStateEvent", {
+  enumerable: true,
+  get: function () { return event.isAgentStateEvent; }
+});
+Object.defineProperty(exports, "isAgentStreamEvent", {
+  enumerable: true,
+  get: function () { return event.isAgentStreamEvent; }
+});
+Object.defineProperty(exports, "isAgentTurnEvent", {
+  enumerable: true,
+  get: function () { return event.isAgentTurnEvent; }
+});
+Object.defineProperty(exports, "isCommandEvent", {
+  enumerable: true,
+  get: function () { return event.isCommandEvent; }
+});
+Object.defineProperty(exports, "isCommandRequest", {
+  enumerable: true,
+  get: function () { return event.isCommandRequest; }
+});
+Object.defineProperty(exports, "isCommandResponse", {
+  enumerable: true,
+  get: function () { return event.isCommandResponse; }
+});
+Object.defineProperty(exports, "isFromSource", {
+  enumerable: true,
+  get: function () { return event.isFromSource; }
+});
+Object.defineProperty(exports, "isNotification", {
+  enumerable: true,
+  get: function () { return event.isNotification; }
+});
+Object.defineProperty(exports, "isRequest", {
+  enumerable: true,
+  get: function () { return event.isRequest; }
+});
+Object.defineProperty(exports, "isResult", {
+  enumerable: true,
+  get: function () { return event.isResult; }
+});
+exports.createAgentX = createAgentX;
+exports.createRemoteAgentX = createRemoteAgentX;
+//# sourceMappingURL=browser.cjs.map
+//# sourceMappingURL=browser.cjs.map

package/dist/browser.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/createAgentX.ts","../src/browser.ts"],"names":["createLogger","isRemoteConfig"],"mappings":"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","file":"browser.cjs","sourcesContent":["/**\n * createAgentX - Factory function for creating AgentX instances\n *\n * Supports two modes:\n * - Local mode: Uses Runtime directly (Claude API) - Node.js only\n * - Remote mode: Connects to AgentX server via WebSocket - Browser & Node.js\n *\n * Local mode implementation is dynamically imported to enable tree-shaking\n * in browser builds.\n */\n\nimport type { AgentX, AgentXConfig, Unsubscribe } from \"@agentxjs/types/agentx\";\nimport { isRemoteConfig } from \"@agentxjs/types/agentx\";\nimport type {\n  CommandEventMap,\n  CommandRequestType,\n  ResponseEventFor,\n  RequestDataFor,\n  SystemEvent,\n} from \"@agentxjs/types/event\";\nimport { createLogger } from \"@agentxjs/common\";\n\nconst remoteLogger = createLogger(\"agentx/RemoteClient\");\n\n/**\n * Create AgentX instance\n *\n * @param config - Configuration (LocalConfig or RemoteConfig)\n * @returns AgentX instance\n *\n * @example\n * ```typescript\n * // Remote mode (browser & Node.js)\n * const agentx = await createAgentX({ serverUrl: \"ws://localhost:5200\" });\n *\n * // Local mode (Node.js only)\n * const agentx = await createAgentX({ llm: { apiKey: \"sk-...\" } });\n * ```\n */\nexport async function createAgentX(config?: AgentXConfig): Promise<AgentX> {\n  if (config && isRemoteConfig(config)) {\n    return createRemoteAgentX(config.serverUrl);\n  }\n\n  // Dynamic import for tree-shaking in browser builds\n  const { createLocalAgentX } = await import(\"./createLocalAgentX\");\n  return createLocalAgentX(config ?? {});\n}\n\n// ============================================================================\n// Remote Mode Implementation (Browser & Node.js compatible)\n// ============================================================================\n\n// Declare window for TypeScript (available in browser)\ndeclare const window: { WebSocket: typeof WebSocket } | undefined;\n\n// Detect browser environment\nconst isBrowser = typeof window !== \"undefined\" && typeof window.WebSocket !== \"undefined\";\n\n/**\n * Create AgentX instance in remote mode\n *\n * Connects to an AgentX server via WebSocket.\n * Works in both browser and Node.js environments.\n *\n * @param serverUrl - WebSocket server URL\n * @returns AgentX instance\n */\nexport async function createRemoteAgentX(serverUrl: string): Promise<AgentX> {\n  // Use native WebSocket in browser, ws library in Node.js\n  const WebSocketImpl = isBrowser ? window.WebSocket : (await import(\"ws\")).WebSocket;\n\n  const ws = new WebSocketImpl(serverUrl);\n  const handlers = new Map<string, Set<(event: SystemEvent) => void>>();\n  const pendingRequests = new Map<\n    string,\n    {\n      resolve: (event: SystemEvent) => void;\n      reject: (err: Error) => void;\n      timer: ReturnType<typeof setTimeout>;\n    }\n  >();\n\n  // Wait for connection\n  await new Promise<void>((resolve, reject) => {\n    if (isBrowser) {\n      // Browser WebSocket uses event properties\n      ws.onopen = () => resolve();\n      ws.onerror = () => reject(new Error(\"WebSocket connection failed\"));\n    } else {\n      // Node.js ws uses EventEmitter\n      (ws as any).on(\"open\", () => resolve());\n      (ws as any).on(\"error\", (err: Error) => reject(err));\n    }\n  });\n\n  // Handle incoming messages\n  const handleMessage = (data: unknown) => {\n    try {\n      // Browser: data is MessageEvent, Node.js: data is Buffer\n      const text = isBrowser ? (data as { data: string }).data : (data as Buffer).toString();\n      const event = JSON.parse(text) as SystemEvent;\n\n      remoteLogger.info(\"Received event\", {\n        type: event.type,\n        category: event.category,\n        requestId: (event.data as any)?.requestId,\n      });\n\n      // Handle error events - log as error (but still dispatch to handlers)\n      if (event.type === \"system_error\") {\n        const errorData = event.data as { message: string; severity?: string; details?: unknown };\n        remoteLogger.error(errorData.message, {\n          severity: errorData.severity,\n          requestId: (event.data as any)?.requestId,\n          details: errorData.details,\n        });\n        // Continue to dispatch to handlers (don't return here)\n      }\n\n      // Check if it's a response to a pending request\n      // Only response events (category === \"response\") should resolve pending requests\n      const requestId = (event.data as { requestId?: string })?.requestId;\n      if (event.category === \"response\" && requestId && pendingRequests.has(requestId)) {\n        remoteLogger.info(\"Resolving pending request\", { requestId, eventType: event.type });\n        const pending = pendingRequests.get(requestId)!;\n        clearTimeout(pending.timer);\n        pendingRequests.delete(requestId);\n        pending.resolve(event);\n        return;\n      }\n      remoteLogger.info(\"Dispatching to handlers\", { type: event.type });\n\n      // Dispatch to handlers\n      const typeHandlers = handlers.get(event.type);\n      if (typeHandlers) {\n        for (const handler of typeHandlers) {\n          handler(event);\n        }\n      }\n\n      // Dispatch to \"*\" handlers\n      const allHandlers = handlers.get(\"*\");\n      if (allHandlers) {\n        for (const handler of allHandlers) {\n          handler(event);\n        }\n      }\n    } catch {\n      // Ignore parse errors\n    }\n  };\n\n  // Register message handler\n  if (isBrowser) {\n    ws.onmessage = handleMessage;\n  } else {\n    (ws as any).on(\"message\", handleMessage);\n  }\n\n  function subscribe(type: string, handler: (event: SystemEvent) => void): Unsubscribe {\n    if (!handlers.has(type)) {\n      handlers.set(type, new Set());\n    }\n    handlers.get(type)!.add(handler);\n    return () => {\n      handlers.get(type)?.delete(handler);\n    };\n  }\n\n  return {\n    request<T extends CommandRequestType>(\n      type: T,\n      data: RequestDataFor<T>,\n      timeout: number = 30000\n    ): Promise<ResponseEventFor<T>> {\n      return new Promise((resolve, reject) => {\n        const requestId = `req_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;\n\n        const timer = setTimeout(() => {\n          pendingRequests.delete(requestId);\n          reject(new Error(`Request timeout: ${type}`));\n        }, timeout);\n\n        pendingRequests.set(requestId, {\n          resolve: resolve as (event: SystemEvent) => void,\n          reject,\n          timer,\n        });\n\n        const event: SystemEvent = {\n          type,\n          timestamp: Date.now(),\n          data: { ...data, requestId },\n          source: \"command\",\n          category: \"request\",\n          intent: \"request\",\n        };\n\n        ws.send(JSON.stringify(event));\n      });\n    },\n\n    on<T extends string>(\n      type: T,\n      handler: (event: SystemEvent & { type: T }) => void\n    ): Unsubscribe {\n      return subscribe(type, handler as (event: SystemEvent) => void);\n    },\n\n    onCommand<T extends keyof CommandEventMap>(\n      type: T,\n      handler: (event: CommandEventMap[T]) => void\n    ): Unsubscribe {\n      return subscribe(type, handler as (event: SystemEvent) => void);\n    },\n\n    emitCommand<T extends keyof CommandEventMap>(type: T, data: CommandEventMap[T][\"data\"]): void {\n      const event: SystemEvent = {\n        type,\n        timestamp: Date.now(),\n        data,\n        source: \"command\",\n        category: type.toString().endsWith(\"_response\") ? \"response\" : \"request\",\n        intent: type.toString().endsWith(\"_response\") ? \"result\" : \"request\",\n      };\n      ws.send(JSON.stringify(event));\n    },\n\n    async listen() {\n      throw new Error(\"Cannot listen in remote mode\");\n    },\n\n    async close() {\n      // No-op in remote mode\n    },\n\n    async dispose() {\n      for (const pending of pendingRequests.values()) {\n        clearTimeout(pending.timer);\n        pending.reject(new Error(\"AgentX disposed\"));\n      }\n      pendingRequests.clear();\n      handlers.clear();\n\n      if (isBrowser) {\n        ws.close();\n      } else {\n        (ws as any).close();\n      }\n    },\n  };\n}\n","/**\n * agentxjs - Browser Entry Point\n *\n * This entry is automatically selected by bundlers (Vite, Webpack, etc.)\n * when building for browser environments.\n *\n * Only includes remote mode (WebSocket client).\n * Does not include Node.js specific code (runtime, fs, sqlite, etc.)\n */\n\n// Re-export everything from index except createAgentX\nexport type {\n  AgentX,\n  AgentXConfig,\n  LocalConfig,\n  RemoteConfig,\n  LLMConfig,\n  StorageConfig,\n  StorageDriver,\n  Unsubscribe,\n} from \"@agentxjs/types/agentx\";\n\nexport { isLocalConfig, isRemoteConfig } from \"@agentxjs/types/agentx\";\n\n// Event types\nexport type {\n  SystemEvent,\n  EventSource,\n  EventCategory,\n  EventIntent,\n  EventContext,\n} from \"@agentxjs/types/event\";\n\nexport {\n  isFromSource,\n  hasIntent,\n  isRequest,\n  isResult,\n  isNotification,\n} from \"@agentxjs/types/event\";\n\n// Command events\nexport type {\n  CommandEvent,\n  CommandRequest,\n  CommandResponse,\n  CommandEventType,\n  CommandRequestType,\n  CommandEventMap,\n  ContainerCreateRequest,\n  ContainerCreateResponse,\n  ContainerGetRequest,\n  ContainerGetResponse,\n  ContainerListRequest,\n  ContainerListResponse,\n  AgentGetRequest,\n  AgentGetResponse,\n  AgentListRequest,\n  AgentListResponse,\n  AgentDestroyRequest,\n  AgentDestroyResponse,\n  MessageSendRequest,\n  MessageSendResponse,\n  AgentInterruptRequest,\n  AgentInterruptResponse,\n  ImageCreateRequest,\n  ImageCreateResponse,\n  ImageRunRequest,\n  ImageRunResponse,\n  ImageStopRequest,\n  ImageStopResponse,\n  ImageUpdateRequest,\n  ImageUpdateResponse,\n  ImageListRequest,\n  ImageListResponse,\n  ImageListItem,\n  ImageGetRequest,\n  ImageGetResponse,\n  ImageDeleteRequest,\n  ImageDeleteResponse,\n} from \"@agentxjs/types/event\";\n\nexport { isCommandEvent, isCommandRequest, isCommandResponse } from \"@agentxjs/types/event\";\n\n// Agent events\nexport type {\n  AgentEvent,\n  AgentEventCategory,\n  AgentStreamEvent,\n  AgentTextDeltaEvent,\n  AgentMessageStartEvent,\n  AgentMessageStopEvent,\n  AgentToolUseStartEvent,\n  AgentToolUseStopEvent,\n  AgentToolResultEvent,\n  AgentStateEvent,\n  ConversationStartEvent,\n  ConversationEndEvent,\n  ConversationThinkingEvent,\n  ConversationRespondingEvent,\n  ToolExecutingEvent,\n  ToolCompletedEvent,\n  ErrorOccurredEvent,\n  AgentMessageEvent,\n  UserMessageEvent,\n  AssistantMessageEvent,\n  ToolCallMessageEvent,\n  ToolResultMessageEvent,\n  AgentTurnEvent,\n  TurnRequestEvent,\n  TurnResponseEvent,\n  TokenUsage,\n} from \"@agentxjs/types/event\";\n\nexport {\n  isAgentEvent,\n  isAgentStreamEvent,\n  isAgentStateEvent,\n  isAgentMessageEvent,\n  isAgentTurnEvent,\n} from \"@agentxjs/types/event\";\n\n// Data types\nexport type { ImageRecord } from \"@agentxjs/types\";\n\nexport type {\n  Message,\n  UserMessage,\n  AssistantMessage,\n  ToolCallMessage,\n  ToolResultMessage,\n  AgentError,\n  ContentPart,\n  TextPart,\n  ToolCallPart,\n  ToolResultPart,\n  ToolResultOutput,\n} from \"@agentxjs/types/agent\";\n\n// Browser-only createAgentX (remote mode only)\nimport type { AgentX, AgentXConfig } from \"@agentxjs/types/agentx\";\nimport { isRemoteConfig } from \"@agentxjs/types/agentx\";\nimport { createRemoteAgentX } from \"./createAgentX\";\n\n/**\n * Create AgentX instance (Browser version - remote mode only)\n *\n * @param config - Must be RemoteConfig with server URL\n * @returns AgentX instance\n *\n * @example\n * ```typescript\n * const agentx = await createAgentX({ server: \"ws://localhost:5200\" });\n * ```\n */\nexport async function createAgentX(config: AgentXConfig): Promise<AgentX> {\n  if (!config || !isRemoteConfig(config)) {\n    throw new Error(\n      \"Browser environment only supports remote mode. \" +\n        'Please provide { serverUrl: \"ws://...\" } configuration.'\n    );\n  }\n  return createRemoteAgentX(config.serverUrl);\n}\n\n// Also export createRemoteAgentX for explicit usage\nexport { createRemoteAgentX } from \"./createAgentX\";\n"]}

package/dist/browser.d.cts

@@ -0,0 +1,32 @@
+import { AgentXConfig, AgentX } from '@agentxjs/types/agentx';
+export { AgentX, AgentXConfig, LLMConfig, LocalConfig, RemoteConfig, StorageConfig, StorageDriver, Unsubscribe, isLocalConfig, isRemoteConfig } from '@agentxjs/types/agentx';
+export { AgentDestroyRequest, AgentDestroyResponse, AgentEvent, AgentEventCategory, AgentGetRequest, AgentGetResponse, AgentInterruptRequest, AgentInterruptResponse, AgentListRequest, AgentListResponse, AgentMessageEvent, AgentMessageStartEvent, AgentMessageStopEvent, AgentStateEvent, AgentStreamEvent, AgentTextDeltaEvent, AgentToolResultEvent, AgentToolUseStartEvent, AgentToolUseStopEvent, AgentTurnEvent, AssistantMessageEvent, CommandEvent, CommandEventMap, CommandEventType, CommandRequest, CommandRequestType, CommandResponse, ContainerCreateRequest, ContainerCreateResponse, ContainerGetRequest, ContainerGetResponse, ContainerListRequest, ContainerListResponse, ConversationEndEvent, ConversationRespondingEvent, ConversationStartEvent, ConversationThinkingEvent, ErrorOccurredEvent, EventCategory, EventContext, EventIntent, EventSource, ImageCreateRequest, ImageCreateResponse, ImageDeleteRequest, ImageDeleteResponse, ImageGetRequest, ImageGetResponse, ImageListItem, ImageListRequest, ImageListResponse, ImageRunRequest, ImageRunResponse, ImageStopRequest, ImageStopResponse, ImageUpdateRequest, ImageUpdateResponse, MessageSendRequest, MessageSendResponse, SystemEvent, TokenUsage, ToolCallMessageEvent, ToolCompletedEvent, ToolExecutingEvent, ToolResultMessageEvent, TurnRequestEvent, TurnResponseEvent, UserMessageEvent, hasIntent, isAgentEvent, isAgentMessageEvent, isAgentStateEvent, isAgentStreamEvent, isAgentTurnEvent, isCommandEvent, isCommandRequest, isCommandResponse, isFromSource, isNotification, isRequest, isResult } from '@agentxjs/types/event';
+export { ImageRecord } from '@agentxjs/types';
+export { AgentError, AssistantMessage, ContentPart, Message, TextPart, ToolCallMessage, ToolCallPart, ToolResultMessage, ToolResultOutput, ToolResultPart, UserMessage } from '@agentxjs/types/agent';
+export { createRemoteAgentX } from './index.cjs';
+import '@agentxjs/common';
+
+/**
+ * agentxjs - Browser Entry Point
+ *
+ * This entry is automatically selected by bundlers (Vite, Webpack, etc.)
+ * when building for browser environments.
+ *
+ * Only includes remote mode (WebSocket client).
+ * Does not include Node.js specific code (runtime, fs, sqlite, etc.)
+ */
+
+/**
+ * Create AgentX instance (Browser version - remote mode only)
+ *
+ * @param config - Must be RemoteConfig with server URL
+ * @returns AgentX instance
+ *
+ * @example
+ * ```typescript
+ * const agentx = await createAgentX({ server: "ws://localhost:5200" });
+ * ```
+ */
+declare function createAgentX(config: AgentXConfig): Promise<AgentX>;
+
+export { createAgentX };

package/dist/browser.d.ts

@@ -0,0 +1,32 @@
+import { AgentXConfig, AgentX } from '@agentxjs/types/agentx';
+export { AgentX, AgentXConfig, LLMConfig, LocalConfig, RemoteConfig, StorageConfig, StorageDriver, Unsubscribe, isLocalConfig, isRemoteConfig } from '@agentxjs/types/agentx';
+export { AgentDestroyRequest, AgentDestroyResponse, AgentEvent, AgentEventCategory, AgentGetRequest, AgentGetResponse, AgentInterruptRequest, AgentInterruptResponse, AgentListRequest, AgentListResponse, AgentMessageEvent, AgentMessageStartEvent, AgentMessageStopEvent, AgentStateEvent, AgentStreamEvent, AgentTextDeltaEvent, AgentToolResultEvent, AgentToolUseStartEvent, AgentToolUseStopEvent, AgentTurnEvent, AssistantMessageEvent, CommandEvent, CommandEventMap, CommandEventType, CommandRequest, CommandRequestType, CommandResponse, ContainerCreateRequest, ContainerCreateResponse, ContainerGetRequest, ContainerGetResponse, ContainerListRequest, ContainerListResponse, ConversationEndEvent, ConversationRespondingEvent, ConversationStartEvent, ConversationThinkingEvent, ErrorOccurredEvent, EventCategory, EventContext, EventIntent, EventSource, ImageCreateRequest, ImageCreateResponse, ImageDeleteRequest, ImageDeleteResponse, ImageGetRequest, ImageGetResponse, ImageListItem, ImageListRequest, ImageListResponse, ImageRunRequest, ImageRunResponse, ImageStopRequest, ImageStopResponse, ImageUpdateRequest, ImageUpdateResponse, MessageSendRequest, MessageSendResponse, SystemEvent, TokenUsage, ToolCallMessageEvent, ToolCompletedEvent, ToolExecutingEvent, ToolResultMessageEvent, TurnRequestEvent, TurnResponseEvent, UserMessageEvent, hasIntent, isAgentEvent, isAgentMessageEvent, isAgentStateEvent, isAgentStreamEvent, isAgentTurnEvent, isCommandEvent, isCommandRequest, isCommandResponse, isFromSource, isNotification, isRequest, isResult } from '@agentxjs/types/event';
+export { ImageRecord } from '@agentxjs/types';
+export { AgentError, AssistantMessage, ContentPart, Message, TextPart, ToolCallMessage, ToolCallPart, ToolResultMessage, ToolResultOutput, ToolResultPart, UserMessage } from '@agentxjs/types/agent';
+export { createRemoteAgentX } from './index.js';
+import '@agentxjs/common';
+
+/**
+ * agentxjs - Browser Entry Point
+ *
+ * This entry is automatically selected by bundlers (Vite, Webpack, etc.)
+ * when building for browser environments.
+ *
+ * Only includes remote mode (WebSocket client).
+ * Does not include Node.js specific code (runtime, fs, sqlite, etc.)
+ */
+
+/**
+ * Create AgentX instance (Browser version - remote mode only)
+ *
+ * @param config - Must be RemoteConfig with server URL
+ * @returns AgentX instance
+ *
+ * @example
+ * ```typescript
+ * const agentx = await createAgentX({ server: "ws://localhost:5200" });
+ * ```
+ */
+declare function createAgentX(config: AgentXConfig): Promise<AgentX>;
+
+export { createAgentX };

package/dist/browser.js

@@ -0,0 +1,153 @@
+import { isRemoteConfig } from '@agentxjs/types/agentx';
+export { isLocalConfig, isRemoteConfig } from '@agentxjs/types/agentx';
+export { hasIntent, isAgentEvent, isAgentMessageEvent, isAgentStateEvent, isAgentStreamEvent, isAgentTurnEvent, isCommandEvent, isCommandRequest, isCommandResponse, isFromSource, isNotification, isRequest, isResult } from '@agentxjs/types/event';
+import { createLogger } from '@agentxjs/common';
+
+// src/browser.ts
+var remoteLogger = createLogger("agentx/RemoteClient");
+var isBrowser = typeof window !== "undefined" && typeof window.WebSocket !== "undefined";
+async function createRemoteAgentX(serverUrl) {
+  const WebSocketImpl = isBrowser ? window.WebSocket : (await import('ws')).WebSocket;
+  const ws = new WebSocketImpl(serverUrl);
+  const handlers = /* @__PURE__ */ new Map();
+  const pendingRequests = /* @__PURE__ */ new Map();
+  await new Promise((resolve, reject) => {
+    if (isBrowser) {
+      ws.onopen = () => resolve();
+      ws.onerror = () => reject(new Error("WebSocket connection failed"));
+    } else {
+      ws.on("open", () => resolve());
+      ws.on("error", (err) => reject(err));
+    }
+  });
+  const handleMessage = (data) => {
+    try {
+      const text = isBrowser ? data.data : data.toString();
+      const event = JSON.parse(text);
+      remoteLogger.info("Received event", {
+        type: event.type,
+        category: event.category,
+        requestId: event.data?.requestId
+      });
+      if (event.type === "system_error") {
+        const errorData = event.data;
+        remoteLogger.error(errorData.message, {
+          severity: errorData.severity,
+          requestId: event.data?.requestId,
+          details: errorData.details
+        });
+      }
+      const requestId = event.data?.requestId;
+      if (event.category === "response" && requestId && pendingRequests.has(requestId)) {
+        remoteLogger.info("Resolving pending request", { requestId, eventType: event.type });
+        const pending = pendingRequests.get(requestId);
+        clearTimeout(pending.timer);
+        pendingRequests.delete(requestId);
+        pending.resolve(event);
+        return;
+      }
+      remoteLogger.info("Dispatching to handlers", { type: event.type });
+      const typeHandlers = handlers.get(event.type);
+      if (typeHandlers) {
+        for (const handler of typeHandlers) {
+          handler(event);
+        }
+      }
+      const allHandlers = handlers.get("*");
+      if (allHandlers) {
+        for (const handler of allHandlers) {
+          handler(event);
+        }
+      }
+    } catch {
+    }
+  };
+  if (isBrowser) {
+    ws.onmessage = handleMessage;
+  } else {
+    ws.on("message", handleMessage);
+  }
+  function subscribe(type, handler) {
+    if (!handlers.has(type)) {
+      handlers.set(type, /* @__PURE__ */ new Set());
+    }
+    handlers.get(type).add(handler);
+    return () => {
+      handlers.get(type)?.delete(handler);
+    };
+  }
+  return {
+    request(type, data, timeout = 3e4) {
+      return new Promise((resolve, reject) => {
+        const requestId = `req_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
+        const timer = setTimeout(() => {
+          pendingRequests.delete(requestId);
+          reject(new Error(`Request timeout: ${type}`));
+        }, timeout);
+        pendingRequests.set(requestId, {
+          resolve,
+          reject,
+          timer
+        });
+        const event = {
+          type,
+          timestamp: Date.now(),
+          data: { ...data, requestId },
+          source: "command",
+          category: "request",
+          intent: "request"
+        };
+        ws.send(JSON.stringify(event));
+      });
+    },
+    on(type, handler) {
+      return subscribe(type, handler);
+    },
+    onCommand(type, handler) {
+      return subscribe(type, handler);
+    },
+    emitCommand(type, data) {
+      const event = {
+        type,
+        timestamp: Date.now(),
+        data,
+        source: "command",
+        category: type.toString().endsWith("_response") ? "response" : "request",
+        intent: type.toString().endsWith("_response") ? "result" : "request"
+      };
+      ws.send(JSON.stringify(event));
+    },
+    async listen() {
+      throw new Error("Cannot listen in remote mode");
+    },
+    async close() {
+    },
+    async dispose() {
+      for (const pending of pendingRequests.values()) {
+        clearTimeout(pending.timer);
+        pending.reject(new Error("AgentX disposed"));
+      }
+      pendingRequests.clear();
+      handlers.clear();
+      if (isBrowser) {
+        ws.close();
+      } else {
+        ws.close();
+      }
+    }
+  };
+}
+
+// src/browser.ts
+async function createAgentX(config) {
+  if (!config || !isRemoteConfig(config)) {
+    throw new Error(
+      'Browser environment only supports remote mode. Please provide { serverUrl: "ws://..." } configuration.'
+    );
+  }
+  return createRemoteAgentX(config.serverUrl);
+}
+
+export { createAgentX, createRemoteAgentX };
+//# sourceMappingURL=browser.js.map
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/createAgentX.ts","../src/browser.ts"],"names":["isRemoteConfig"],"mappings":"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","file":"browser.js","sourcesContent":["/**\n * createAgentX - Factory function for creating AgentX instances\n *\n * Supports two modes:\n * - Local mode: Uses Runtime directly (Claude API) - Node.js only\n * - Remote mode: Connects to AgentX server via WebSocket - Browser & Node.js\n *\n * Local mode implementation is dynamically imported to enable tree-shaking\n * in browser builds.\n */\n\nimport type { AgentX, AgentXConfig, Unsubscribe } from \"@agentxjs/types/agentx\";\nimport { isRemoteConfig } from \"@agentxjs/types/agentx\";\nimport type {\n  CommandEventMap,\n  CommandRequestType,\n  ResponseEventFor,\n  RequestDataFor,\n  SystemEvent,\n} from \"@agentxjs/types/event\";\nimport { createLogger } from \"@agentxjs/common\";\n\nconst remoteLogger = createLogger(\"agentx/RemoteClient\");\n\n/**\n * Create AgentX instance\n *\n * @param config - Configuration (LocalConfig or RemoteConfig)\n * @returns AgentX instance\n *\n * @example\n * ```typescript\n * // Remote mode (browser & Node.js)\n * const agentx = await createAgentX({ serverUrl: \"ws://localhost:5200\" });\n *\n * // Local mode (Node.js only)\n * const agentx = await createAgentX({ llm: { apiKey: \"sk-...\" } });\n * ```\n */\nexport async function createAgentX(config?: AgentXConfig): Promise<AgentX> {\n  if (config && isRemoteConfig(config)) {\n    return createRemoteAgentX(config.serverUrl);\n  }\n\n  // Dynamic import for tree-shaking in browser builds\n  const { createLocalAgentX } = await import(\"./createLocalAgentX\");\n  return createLocalAgentX(config ?? {});\n}\n\n// ============================================================================\n// Remote Mode Implementation (Browser & Node.js compatible)\n// ============================================================================\n\n// Declare window for TypeScript (available in browser)\ndeclare const window: { WebSocket: typeof WebSocket } | undefined;\n\n// Detect browser environment\nconst isBrowser = typeof window !== \"undefined\" && typeof window.WebSocket !== \"undefined\";\n\n/**\n * Create AgentX instance in remote mode\n *\n * Connects to an AgentX server via WebSocket.\n * Works in both browser and Node.js environments.\n *\n * @param serverUrl - WebSocket server URL\n * @returns AgentX instance\n */\nexport async function createRemoteAgentX(serverUrl: string): Promise<AgentX> {\n  // Use native WebSocket in browser, ws library in Node.js\n  const WebSocketImpl = isBrowser ? window.WebSocket : (await import(\"ws\")).WebSocket;\n\n  const ws = new WebSocketImpl(serverUrl);\n  const handlers = new Map<string, Set<(event: SystemEvent) => void>>();\n  const pendingRequests = new Map<\n    string,\n    {\n      resolve: (event: SystemEvent) => void;\n      reject: (err: Error) => void;\n      timer: ReturnType<typeof setTimeout>;\n    }\n  >();\n\n  // Wait for connection\n  await new Promise<void>((resolve, reject) => {\n    if (isBrowser) {\n      // Browser WebSocket uses event properties\n      ws.onopen = () => resolve();\n      ws.onerror = () => reject(new Error(\"WebSocket connection failed\"));\n    } else {\n      // Node.js ws uses EventEmitter\n      (ws as any).on(\"open\", () => resolve());\n      (ws as any).on(\"error\", (err: Error) => reject(err));\n    }\n  });\n\n  // Handle incoming messages\n  const handleMessage = (data: unknown) => {\n    try {\n      // Browser: data is MessageEvent, Node.js: data is Buffer\n      const text = isBrowser ? (data as { data: string }).data : (data as Buffer).toString();\n      const event = JSON.parse(text) as SystemEvent;\n\n      remoteLogger.info(\"Received event\", {\n        type: event.type,\n        category: event.category,\n        requestId: (event.data as any)?.requestId,\n      });\n\n      // Handle error events - log as error (but still dispatch to handlers)\n      if (event.type === \"system_error\") {\n        const errorData = event.data as { message: string; severity?: string; details?: unknown };\n        remoteLogger.error(errorData.message, {\n          severity: errorData.severity,\n          requestId: (event.data as any)?.requestId,\n          details: errorData.details,\n        });\n        // Continue to dispatch to handlers (don't return here)\n      }\n\n      // Check if it's a response to a pending request\n      // Only response events (category === \"response\") should resolve pending requests\n      const requestId = (event.data as { requestId?: string })?.requestId;\n      if (event.category === \"response\" && requestId && pendingRequests.has(requestId)) {\n        remoteLogger.info(\"Resolving pending request\", { requestId, eventType: event.type });\n        const pending = pendingRequests.get(requestId)!;\n        clearTimeout(pending.timer);\n        pendingRequests.delete(requestId);\n        pending.resolve(event);\n        return;\n      }\n      remoteLogger.info(\"Dispatching to handlers\", { type: event.type });\n\n      // Dispatch to handlers\n      const typeHandlers = handlers.get(event.type);\n      if (typeHandlers) {\n        for (const handler of typeHandlers) {\n          handler(event);\n        }\n      }\n\n      // Dispatch to \"*\" handlers\n      const allHandlers = handlers.get(\"*\");\n      if (allHandlers) {\n        for (const handler of allHandlers) {\n          handler(event);\n        }\n      }\n    } catch {\n      // Ignore parse errors\n    }\n  };\n\n  // Register message handler\n  if (isBrowser) {\n    ws.onmessage = handleMessage;\n  } else {\n    (ws as any).on(\"message\", handleMessage);\n  }\n\n  function subscribe(type: string, handler: (event: SystemEvent) => void): Unsubscribe {\n    if (!handlers.has(type)) {\n      handlers.set(type, new Set());\n    }\n    handlers.get(type)!.add(handler);\n    return () => {\n      handlers.get(type)?.delete(handler);\n    };\n  }\n\n  return {\n    request<T extends CommandRequestType>(\n      type: T,\n      data: RequestDataFor<T>,\n      timeout: number = 30000\n    ): Promise<ResponseEventFor<T>> {\n      return new Promise((resolve, reject) => {\n        const requestId = `req_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;\n\n        const timer = setTimeout(() => {\n          pendingRequests.delete(requestId);\n          reject(new Error(`Request timeout: ${type}`));\n        }, timeout);\n\n        pendingRequests.set(requestId, {\n          resolve: resolve as (event: SystemEvent) => void,\n          reject,\n          timer,\n        });\n\n        const event: SystemEvent = {\n          type,\n          timestamp: Date.now(),\n          data: { ...data, requestId },\n          source: \"command\",\n          category: \"request\",\n          intent: \"request\",\n        };\n\n        ws.send(JSON.stringify(event));\n      });\n    },\n\n    on<T extends string>(\n      type: T,\n      handler: (event: SystemEvent & { type: T }) => void\n    ): Unsubscribe {\n      return subscribe(type, handler as (event: SystemEvent) => void);\n    },\n\n    onCommand<T extends keyof CommandEventMap>(\n      type: T,\n      handler: (event: CommandEventMap[T]) => void\n    ): Unsubscribe {\n      return subscribe(type, handler as (event: SystemEvent) => void);\n    },\n\n    emitCommand<T extends keyof CommandEventMap>(type: T, data: CommandEventMap[T][\"data\"]): void {\n      const event: SystemEvent = {\n        type,\n        timestamp: Date.now(),\n        data,\n        source: \"command\",\n        category: type.toString().endsWith(\"_response\") ? \"response\" : \"request\",\n        intent: type.toString().endsWith(\"_response\") ? \"result\" : \"request\",\n      };\n      ws.send(JSON.stringify(event));\n    },\n\n    async listen() {\n      throw new Error(\"Cannot listen in remote mode\");\n    },\n\n    async close() {\n      // No-op in remote mode\n    },\n\n    async dispose() {\n      for (const pending of pendingRequests.values()) {\n        clearTimeout(pending.timer);\n        pending.reject(new Error(\"AgentX disposed\"));\n      }\n      pendingRequests.clear();\n      handlers.clear();\n\n      if (isBrowser) {\n        ws.close();\n      } else {\n        (ws as any).close();\n      }\n    },\n  };\n}\n","/**\n * agentxjs - Browser Entry Point\n *\n * This entry is automatically selected by bundlers (Vite, Webpack, etc.)\n * when building for browser environments.\n *\n * Only includes remote mode (WebSocket client).\n * Does not include Node.js specific code (runtime, fs, sqlite, etc.)\n */\n\n// Re-export everything from index except createAgentX\nexport type {\n  AgentX,\n  AgentXConfig,\n  LocalConfig,\n  RemoteConfig,\n  LLMConfig,\n  StorageConfig,\n  StorageDriver,\n  Unsubscribe,\n} from \"@agentxjs/types/agentx\";\n\nexport { isLocalConfig, isRemoteConfig } from \"@agentxjs/types/agentx\";\n\n// Event types\nexport type {\n  SystemEvent,\n  EventSource,\n  EventCategory,\n  EventIntent,\n  EventContext,\n} from \"@agentxjs/types/event\";\n\nexport {\n  isFromSource,\n  hasIntent,\n  isRequest,\n  isResult,\n  isNotification,\n} from \"@agentxjs/types/event\";\n\n// Command events\nexport type {\n  CommandEvent,\n  CommandRequest,\n  CommandResponse,\n  CommandEventType,\n  CommandRequestType,\n  CommandEventMap,\n  ContainerCreateRequest,\n  ContainerCreateResponse,\n  ContainerGetRequest,\n  ContainerGetResponse,\n  ContainerListRequest,\n  ContainerListResponse,\n  AgentGetRequest,\n  AgentGetResponse,\n  AgentListRequest,\n  AgentListResponse,\n  AgentDestroyRequest,\n  AgentDestroyResponse,\n  MessageSendRequest,\n  MessageSendResponse,\n  AgentInterruptRequest,\n  AgentInterruptResponse,\n  ImageCreateRequest,\n  ImageCreateResponse,\n  ImageRunRequest,\n  ImageRunResponse,\n  ImageStopRequest,\n  ImageStopResponse,\n  ImageUpdateRequest,\n  ImageUpdateResponse,\n  ImageListRequest,\n  ImageListResponse,\n  ImageListItem,\n  ImageGetRequest,\n  ImageGetResponse,\n  ImageDeleteRequest,\n  ImageDeleteResponse,\n} from \"@agentxjs/types/event\";\n\nexport { isCommandEvent, isCommandRequest, isCommandResponse } from \"@agentxjs/types/event\";\n\n// Agent events\nexport type {\n  AgentEvent,\n  AgentEventCategory,\n  AgentStreamEvent,\n  AgentTextDeltaEvent,\n  AgentMessageStartEvent,\n  AgentMessageStopEvent,\n  AgentToolUseStartEvent,\n  AgentToolUseStopEvent,\n  AgentToolResultEvent,\n  AgentStateEvent,\n  ConversationStartEvent,\n  ConversationEndEvent,\n  ConversationThinkingEvent,\n  ConversationRespondingEvent,\n  ToolExecutingEvent,\n  ToolCompletedEvent,\n  ErrorOccurredEvent,\n  AgentMessageEvent,\n  UserMessageEvent,\n  AssistantMessageEvent,\n  ToolCallMessageEvent,\n  ToolResultMessageEvent,\n  AgentTurnEvent,\n  TurnRequestEvent,\n  TurnResponseEvent,\n  TokenUsage,\n} from \"@agentxjs/types/event\";\n\nexport {\n  isAgentEvent,\n  isAgentStreamEvent,\n  isAgentStateEvent,\n  isAgentMessageEvent,\n  isAgentTurnEvent,\n} from \"@agentxjs/types/event\";\n\n// Data types\nexport type { ImageRecord } from \"@agentxjs/types\";\n\nexport type {\n  Message,\n  UserMessage,\n  AssistantMessage,\n  ToolCallMessage,\n  ToolResultMessage,\n  AgentError,\n  ContentPart,\n  TextPart,\n  ToolCallPart,\n  ToolResultPart,\n  ToolResultOutput,\n} from \"@agentxjs/types/agent\";\n\n// Browser-only createAgentX (remote mode only)\nimport type { AgentX, AgentXConfig } from \"@agentxjs/types/agentx\";\nimport { isRemoteConfig } from \"@agentxjs/types/agentx\";\nimport { createRemoteAgentX } from \"./createAgentX\";\n\n/**\n * Create AgentX instance (Browser version - remote mode only)\n *\n * @param config - Must be RemoteConfig with server URL\n * @returns AgentX instance\n *\n * @example\n * ```typescript\n * const agentx = await createAgentX({ server: \"ws://localhost:5200\" });\n * ```\n */\nexport async function createAgentX(config: AgentXConfig): Promise<AgentX> {\n  if (!config || !isRemoteConfig(config)) {\n    throw new Error(\n      \"Browser environment only supports remote mode. \" +\n        'Please provide { serverUrl: \"ws://...\" } configuration.'\n    );\n  }\n  return createRemoteAgentX(config.serverUrl);\n}\n\n// Also export createRemoteAgentX for explicit usage\nexport { createRemoteAgentX } from \"./createAgentX\";\n"]}