agentxjs 0.0.9 → 0.1.1

package/dist/index.d.cts

@@ -1,88 +1,46 @@
-import { DefineAgentInput, AgentDefinition, Runtime, AgentX } from '@agentxjs/types';
-export { Agent, AgentContainer, AgentContext, AgentDefinition, AgentDriver, AgentError, AgentEventHandler, AgentEventType, AgentInfo, AgentLifecycle, AgentManager, AgentOutput, AgentPresenter, AgentX, AgentXLocal, AgentXRemote, ContainerConfig, ContainerManager, ContainerRecord, CreateAgentEndpoint, CreateAgentRequest, CreateAgentResponse, CreateSessionEndpoint, DefineAgentInput, DestroyAgentEndpoint, DestroySessionEndpoint, ErrorHandler, ErrorManager, ErrorSeverity, GetAgentEndpoint, GetHealthEndpoint, GetInfoEndpoint, GetSessionEndpoint, HealthStatus, ListAgentsEndpoint, ListAgentsResponse, ListSessionsEndpoint, ListSessionsResponse, PlatformInfo, PlatformManager, Runtime, RuntimeDriver, Sandbox, Session, SessionManager, Unsubscribe } from '@agentxjs/types';
-export { C as ConnectionState, S as SSERuntimeConfig, c as createSSERuntime, s as sseRuntime } from './types-OVKV6qpE.cjs';
+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 { ConsoleLogger, ConsoleLoggerOptions, LogContext, LogLevel, Logger, LoggerFactory, LoggerFactoryConfig, LoggerFactoryImpl, createLogger, setLoggerFactory } from '@agentxjs/common';
 
 /**
- * defineAgent implementation
+ * createAgentX - Factory function for creating AgentX instances
  *
- * "Define Once, Run Anywhere"
+ * Supports two modes:
+ * - Local mode: Uses Runtime directly (Claude API) - Node.js only
+ * - Remote mode: Connects to AgentX server via WebSocket - Browser & Node.js
  *
- * Creates an AgentDefinition with business-level config.
- *
- * @example
- * ```typescript
- * import { defineAgent, createAgentX } from "agentxjs";
- * import { runtime } from "agentxjs-runtime";
- *
- * const MyAgent = defineAgent({
- *   name: "Translator",
- *   systemPrompt: "You are a translator",
- * });
- *
- * const agentx = createAgentX(runtime);
- * const agent = agentx.agents.create(MyAgent);
- * ```
+ * Local mode implementation is dynamically imported to enable tree-shaking
+ * in browser builds.
  */
 
 /**
- * defineAgent - Create an agent definition
+ * Create AgentX instance
  *
- * @param input - Agent definition input
- * @returns Agent definition
- */
-declare function defineAgent(input: DefineAgentInput): AgentDefinition;
-
-/**
- * AgentX - Platform API Implementation
- *
- * The central entry point for all agent operations.
- * Runtime determines the execution environment (Node.js, Browser, etc.)
+ * @param config - Configuration (LocalConfig or RemoteConfig)
+ * @returns AgentX instance
  *
  * @example
  * ```typescript
- * import { createAgentX } from "agentxjs";
- * import { nodeRuntime } from "agentxjs-runtime";
- *
- * const agentx = createAgentX(nodeRuntime());
+ * // Remote mode (browser & Node.js)
+ * const agentx = await createAgentX({ serverUrl: "ws://localhost:5200" });
  *
- * // Simple usage (auto-created default container)
- * const agent = await agentx.images.run(imageId);
- *
- * // Multi-tenant usage (explicit container)
- * const container = await agentx.containers.create();
- * const agent = await agentx.images.run(imageId, { containerId: container.containerId });
+ * // Local mode (Node.js only)
+ * const agentx = await createAgentX({ llm: { apiKey: "sk-..." } });
  * ```
  */
-
-/**
- * AgentX creation options
- */
-interface CreateAgentXOptions {
-    /**
-     * Default container ID to use for operations
-     * If not provided, a default container will be auto-created
-     */
-    containerId?: string;
-}
+declare function createAgentX(config?: AgentXConfig): Promise<AgentX>;
 /**
- * Create AgentX instance with Runtime
+ * Create AgentX instance in remote mode
  *
- * @param runtime - Runtime provides infrastructure (createSandbox, createDriver, repository)
- * @param options - Optional configuration
- * @returns AgentX instance
+ * Connects to an AgentX server via WebSocket.
+ * Works in both browser and Node.js environments.
  *
- * @example
- * ```typescript
- * import { createAgentX } from "agentxjs";
- * import { nodeRuntime } from "agentxjs-runtime";
- *
- * // Simple usage - auto-creates default container
- * const agentx = createAgentX(nodeRuntime());
- *
- * // Multi-tenant - specify container
- * const agentx = createAgentX(nodeRuntime(), { containerId: "tenant_123" });
- * ```
+ * @param serverUrl - WebSocket server URL
+ * @returns AgentX instance
  */
-declare function createAgentX(runtime: Runtime, options?: CreateAgentXOptions): AgentX;
+declare function createRemoteAgentX(serverUrl: string): Promise<AgentX>;
 
-export { createAgentX, defineAgent };
+export { createAgentX, createRemoteAgentX };

package/dist/index.d.ts

@@ -1,88 +1,46 @@
-import { DefineAgentInput, AgentDefinition, Runtime, AgentX } from '@agentxjs/types';
-export { Agent, AgentContainer, AgentContext, AgentDefinition, AgentDriver, AgentError, AgentEventHandler, AgentEventType, AgentInfo, AgentLifecycle, AgentManager, AgentOutput, AgentPresenter, AgentX, AgentXLocal, AgentXRemote, ContainerConfig, ContainerManager, ContainerRecord, CreateAgentEndpoint, CreateAgentRequest, CreateAgentResponse, CreateSessionEndpoint, DefineAgentInput, DestroyAgentEndpoint, DestroySessionEndpoint, ErrorHandler, ErrorManager, ErrorSeverity, GetAgentEndpoint, GetHealthEndpoint, GetInfoEndpoint, GetSessionEndpoint, HealthStatus, ListAgentsEndpoint, ListAgentsResponse, ListSessionsEndpoint, ListSessionsResponse, PlatformInfo, PlatformManager, Runtime, RuntimeDriver, Sandbox, Session, SessionManager, Unsubscribe } from '@agentxjs/types';
-export { C as ConnectionState, S as SSERuntimeConfig, c as createSSERuntime, s as sseRuntime } from './types-OVKV6qpE.js';
+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 { ConsoleLogger, ConsoleLoggerOptions, LogContext, LogLevel, Logger, LoggerFactory, LoggerFactoryConfig, LoggerFactoryImpl, createLogger, setLoggerFactory } from '@agentxjs/common';
 
 /**
- * defineAgent implementation
+ * createAgentX - Factory function for creating AgentX instances
  *
- * "Define Once, Run Anywhere"
+ * Supports two modes:
+ * - Local mode: Uses Runtime directly (Claude API) - Node.js only
+ * - Remote mode: Connects to AgentX server via WebSocket - Browser & Node.js
  *
- * Creates an AgentDefinition with business-level config.
- *
- * @example
- * ```typescript
- * import { defineAgent, createAgentX } from "agentxjs";
- * import { runtime } from "agentxjs-runtime";
- *
- * const MyAgent = defineAgent({
- *   name: "Translator",
- *   systemPrompt: "You are a translator",
- * });
- *
- * const agentx = createAgentX(runtime);
- * const agent = agentx.agents.create(MyAgent);
- * ```
+ * Local mode implementation is dynamically imported to enable tree-shaking
+ * in browser builds.
  */
 
 /**
- * defineAgent - Create an agent definition
+ * Create AgentX instance
  *
- * @param input - Agent definition input
- * @returns Agent definition
- */
-declare function defineAgent(input: DefineAgentInput): AgentDefinition;
-
-/**
- * AgentX - Platform API Implementation
- *
- * The central entry point for all agent operations.
- * Runtime determines the execution environment (Node.js, Browser, etc.)
+ * @param config - Configuration (LocalConfig or RemoteConfig)
+ * @returns AgentX instance
  *
  * @example
  * ```typescript
- * import { createAgentX } from "agentxjs";
- * import { nodeRuntime } from "agentxjs-runtime";
- *
- * const agentx = createAgentX(nodeRuntime());
+ * // Remote mode (browser & Node.js)
+ * const agentx = await createAgentX({ serverUrl: "ws://localhost:5200" });
  *
- * // Simple usage (auto-created default container)
- * const agent = await agentx.images.run(imageId);
- *
- * // Multi-tenant usage (explicit container)
- * const container = await agentx.containers.create();
- * const agent = await agentx.images.run(imageId, { containerId: container.containerId });
+ * // Local mode (Node.js only)
+ * const agentx = await createAgentX({ llm: { apiKey: "sk-..." } });
  * ```
  */
-
-/**
- * AgentX creation options
- */
-interface CreateAgentXOptions {
-    /**
-     * Default container ID to use for operations
-     * If not provided, a default container will be auto-created
-     */
-    containerId?: string;
-}
+declare function createAgentX(config?: AgentXConfig): Promise<AgentX>;
 /**
- * Create AgentX instance with Runtime
+ * Create AgentX instance in remote mode
  *
- * @param runtime - Runtime provides infrastructure (createSandbox, createDriver, repository)
- * @param options - Optional configuration
- * @returns AgentX instance
+ * Connects to an AgentX server via WebSocket.
+ * Works in both browser and Node.js environments.
  *
- * @example
- * ```typescript
- * import { createAgentX } from "agentxjs";
- * import { nodeRuntime } from "agentxjs-runtime";
- *
- * // Simple usage - auto-creates default container
- * const agentx = createAgentX(nodeRuntime());
- *
- * // Multi-tenant - specify container
- * const agentx = createAgentX(nodeRuntime(), { containerId: "tenant_123" });
- * ```
+ * @param serverUrl - WebSocket server URL
+ * @returns AgentX instance
  */
-declare function createAgentX(runtime: Runtime, options?: CreateAgentXOptions): AgentX;
+declare function createRemoteAgentX(serverUrl: string): Promise<AgentX>;
 
-export { createAgentX, defineAgent };
+export { createAgentX, createRemoteAgentX };