agentxjs 2.1.1 → 2.3.0

package/dist/index.d.ts

@@ -1,7 +1,10 @@
 import { CreateDriver } from '@agentxjs/core/driver';
 import { AgentXRuntime, AgentXPlatform } from '@agentxjs/core/runtime';
 import { Message } from '@agentxjs/core/agent';
+import { AgentXError } from '@agentxjs/core/error';
+export { AgentXError, AgentXErrorCategory, AgentXErrorCode, AgentXErrorContext } from '@agentxjs/core/error';
 import { Unsubscribe, BusEvent, EventBus, BusEventHandler } from '@agentxjs/core/event';
+import { LLMProtocol, LLMProviderRecord } from '@agentxjs/core/persistence';
 import * as _agentxjs_core_network from '@agentxjs/core/network';
 import { RpcMethod } from '@agentxjs/core/network';
 
@@ -327,6 +330,36 @@ interface ContainerListResponse extends BaseResponse {
 interface MessageSendResponse extends BaseResponse {
     agentId: string;
 }
+/**
+ * LLM provider create response
+ */
+interface LLMProviderCreateResponse extends BaseResponse {
+    record: LLMProviderRecord;
+}
+/**
+ * LLM provider get response
+ */
+interface LLMProviderGetResponse extends BaseResponse {
+    record: LLMProviderRecord | null;
+}
+/**
+ * LLM provider list response
+ */
+interface LLMProviderListResponse extends BaseResponse {
+    records: LLMProviderRecord[];
+}
+/**
+ * LLM provider update response
+ */
+interface LLMProviderUpdateResponse extends BaseResponse {
+    record: LLMProviderRecord;
+}
+/**
+ * LLM provider default response
+ */
+interface LLMProviderDefaultResponse extends BaseResponse {
+    record: LLMProviderRecord | null;
+}
 /**
  * Container operations namespace
  */
@@ -425,6 +458,54 @@ interface SessionNamespace {
      */
     getMessages(agentId: string): Promise<Message[]>;
 }
+/**
+ * LLM provider operations namespace
+ */
+interface LLMNamespace {
+    /**
+     * Create a new LLM provider configuration
+     */
+    create(params: {
+        containerId: string;
+        name: string;
+        vendor: string;
+        protocol: LLMProtocol;
+        apiKey: string;
+        baseUrl?: string;
+        model?: string;
+    }): Promise<LLMProviderCreateResponse>;
+    /**
+     * Get LLM provider by ID
+     */
+    get(id: string): Promise<LLMProviderGetResponse>;
+    /**
+     * List LLM providers for a container
+     */
+    list(containerId: string): Promise<LLMProviderListResponse>;
+    /**
+     * Update LLM provider
+     */
+    update(id: string, updates: {
+        name?: string;
+        vendor?: string;
+        protocol?: LLMProtocol;
+        apiKey?: string;
+        baseUrl?: string;
+        model?: string;
+    }): Promise<LLMProviderUpdateResponse>;
+    /**
+     * Delete LLM provider
+     */
+    delete(id: string): Promise<BaseResponse>;
+    /**
+     * Set default LLM provider for a container
+     */
+    setDefault(id: string): Promise<BaseResponse>;
+    /**
+     * Get default LLM provider for a container
+     */
+    getDefault(containerId: string): Promise<LLMProviderDefaultResponse>;
+}
 /**
  * Presentation operations namespace
  */
@@ -462,11 +543,28 @@ interface AgentX {
     readonly agent: AgentNamespace;
     readonly session: SessionNamespace;
     readonly presentation: PresentationNamespace;
+    readonly llm: LLMNamespace;
     on<T extends string>(type: T, handler: BusEventHandler<BusEvent & {
         type: T;
     }>): Unsubscribe;
     onAny(handler: BusEventHandler): Unsubscribe;
     subscribe(sessionId: string): void;
+    /**
+     * Top-level error handler — receives all AgentXError instances from any layer.
+     *
+     * Independent of `on("error", ...)` (stream events) and `presentation.onError` (UI errors).
+     *
+     * @example
+     * ```typescript
+     * ax.onError((error) => {
+     *   console.error(`[${error.category}] ${error.code}: ${error.message}`);
+     *   if (!error.recoverable) {
+     *     // Circuit is open, stop sending requests
+     *   }
+     * });
+     * ```
+     */
+    onError(handler: (error: AgentXError) => void): Unsubscribe;
     /**
      * Universal JSON-RPC entry point — works in all modes:
      * - Local: dispatches to CommandHandler directly
@@ -597,6 +695,12 @@ declare class CommandHandler {
     private handleAgentDestroyAll;
     private handleAgentInterrupt;
     private handleMessageSend;
+    private handleLLMCreate;
+    private handleLLMGet;
+    private handleLLMList;
+    private handleLLMUpdate;
+    private handleLLMDelete;
+    private handleLLMDefault;
     dispose(): void;
 }
 
@@ -646,9 +750,9 @@ declare function createServer(config: ServerConfig): Promise<AgentXServer>;
  * @example Local mode
  * ```typescript
  * import { createAgentX } from "agentxjs";
- * import { node } from "@agentxjs/node-platform";
+ * import { nodePlatform } from "@agentxjs/node-platform";
  *
- * const ax = createAgentX(node({ createDriver }));
+ * const ax = createAgentX(nodePlatform({ createDriver }));
  * await ax.agent.create({ imageId: "..." });
  * ```
  *
@@ -660,7 +764,7 @@ declare function createServer(config: ServerConfig): Promise<AgentXServer>;
  *
  * @example Server mode
  * ```typescript
- * const ax = createAgentX(node({ createDriver }));
+ * const ax = createAgentX(nodePlatform({ createDriver }));
  * const server = await ax.serve({ port: 5200 });
  * ```
  */
@@ -680,4 +784,4 @@ interface PlatformConfig {
  */
 declare function createAgentX(config?: PlatformConfig): AgentXBuilder;
 
-export { type AgentCreateResponse, type AgentGetResponse, type AgentInfo, type AgentListResponse, type AgentNamespace, type AgentX, type AgentXBuilder, type AgentXServer, type AssistantConversation, type BaseResponse, type Block, CommandHandler, type ConnectOptions, type ContainerCreateResponse, type ContainerGetResponse, type ContainerInfo, type ContainerListResponse, type ContainerNamespace, type Conversation, type ErrorConversation, type ImageBlock, type ImageCreateResponse, type ImageGetResponse, type ImageListResponse, type ImageNamespace, type ImageRecord, type MaybeAsync, type MessageSendResponse, type PlatformConfig, Presentation, type PresentationErrorHandler, type PresentationNamespace, type PresentationOptions, type PresentationState, type PresentationUpdateHandler, type ServeConfig, type ServerConfig, type SessionNamespace, type TextBlock, type ToolBlock, type UserConversation, addUserConversation, createAgentX, createInitialState, createServer, initialPresentationState, messagesToConversations, presentationReducer };
+export { type AgentCreateResponse, type AgentGetResponse, type AgentInfo, type AgentListResponse, type AgentNamespace, type AgentX, type AgentXBuilder, type AgentXServer, type AssistantConversation, type BaseResponse, type Block, CommandHandler, type ConnectOptions, type ContainerCreateResponse, type ContainerGetResponse, type ContainerInfo, type ContainerListResponse, type ContainerNamespace, type Conversation, type ErrorConversation, type ImageBlock, type ImageCreateResponse, type ImageGetResponse, type ImageListResponse, type ImageNamespace, type ImageRecord, type LLMNamespace, type LLMProviderCreateResponse, type LLMProviderDefaultResponse, type LLMProviderGetResponse, type LLMProviderListResponse, type LLMProviderUpdateResponse, type MaybeAsync, type MessageSendResponse, type PlatformConfig, Presentation, type PresentationErrorHandler, type PresentationNamespace, type PresentationOptions, type PresentationState, type PresentationUpdateHandler, type ServeConfig, type ServerConfig, type SessionNamespace, type TextBlock, type ToolBlock, type UserConversation, addUserConversation, createAgentX, createInitialState, createServer, initialPresentationState, messagesToConversations, presentationReducer };

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   CommandHandler,
   createServer
-} from "./chunk-ZFL27HK7.js";
+} from "./chunk-X44CQZPK.js";
 
 // src/index.ts
 import { createAgentXRuntime } from "@agentxjs/core/runtime";
@@ -251,6 +251,108 @@ function createRemoteImages(rpcClient, subscribeFn) {
   };
 }
 
+// src/namespaces/llm.ts
+import { generateId } from "@deepracticex/id";
+function createLocalLLM(platform) {
+  const repo = platform.llmProviderRepository;
+  if (!repo) {
+    throw new Error("LLM provider repository not available on this platform");
+  }
+  return {
+    async create(params) {
+      const now = Date.now();
+      const record = {
+        id: generateId("llm"),
+        containerId: params.containerId,
+        name: params.name,
+        vendor: params.vendor,
+        protocol: params.protocol,
+        apiKey: params.apiKey,
+        baseUrl: params.baseUrl,
+        model: params.model,
+        isDefault: false,
+        createdAt: now,
+        updatedAt: now
+      };
+      await repo.saveLLMProvider(record);
+      return { record, requestId: "" };
+    },
+    async get(id) {
+      const record = await repo.findLLMProviderById(id);
+      return { record, requestId: "" };
+    },
+    async list(containerId) {
+      const records = await repo.findLLMProvidersByContainerId(containerId);
+      return { records, requestId: "" };
+    },
+    async update(id, updates) {
+      const existing = await repo.findLLMProviderById(id);
+      if (!existing) {
+        throw new Error(`LLM provider not found: ${id}`);
+      }
+      const updated = {
+        ...existing,
+        ...updates,
+        id: existing.id,
+        containerId: existing.containerId,
+        createdAt: existing.createdAt,
+        updatedAt: Date.now()
+      };
+      await repo.saveLLMProvider(updated);
+      return { record: updated, requestId: "" };
+    },
+    async delete(id) {
+      await repo.deleteLLMProvider(id);
+      return { requestId: "" };
+    },
+    async setDefault(id) {
+      await repo.setDefaultLLMProvider(id);
+      return { requestId: "" };
+    },
+    async getDefault(containerId) {
+      const record = await repo.findDefaultLLMProvider(containerId);
+      return { record, requestId: "" };
+    }
+  };
+}
+function createRemoteLLM(rpcClient) {
+  return {
+    async create(params) {
+      const result = await rpcClient.call("llm.create", params);
+      return { ...result, requestId: "" };
+    },
+    async get(id) {
+      const result = await rpcClient.call("llm.get", { id });
+      return { ...result, requestId: "" };
+    },
+    async list(containerId) {
+      const result = await rpcClient.call("llm.list", { containerId });
+      return { ...result, requestId: "" };
+    },
+    async update(id, updates) {
+      const result = await rpcClient.call("llm.update", {
+        id,
+        updates
+      });
+      return { ...result, requestId: "" };
+    },
+    async delete(id) {
+      const result = await rpcClient.call("llm.delete", { id });
+      return { ...result, requestId: "" };
+    },
+    async setDefault(id) {
+      const result = await rpcClient.call("llm.default", { id });
+      return { ...result, requestId: "" };
+    },
+    async getDefault(containerId) {
+      const result = await rpcClient.call("llm.default", {
+        containerId
+      });
+      return { ...result, requestId: "" };
+    }
+  };
+}
+
 // src/presentation/types.ts
 var initialPresentationState = {
   conversations: [],
@@ -735,6 +837,7 @@ var LocalClient = class {
   agent;
   session;
   presentation;
+  llm;
   constructor(runtime) {
     this.runtime = runtime;
     const platform = runtime.platform;
@@ -743,6 +846,7 @@ var LocalClient = class {
     this.agent = createLocalAgents(runtime);
     this.session = createLocalSessions(runtime);
     this.presentation = createPresentations(this);
+    this.llm = createLocalLLM(platform);
     logger.info("LocalClient initialized");
   }
   // ==================== Properties ====================
@@ -761,6 +865,12 @@ var LocalClient = class {
   }
   subscribe(_sessionId) {
   }
+  // ==================== Error Handling ====================
+  onError(handler) {
+    return this.runtime.platform.eventBus.on("agentx_error", (event) => {
+      handler(event.data);
+    });
+  }
   // ==================== RPC ====================
   async rpc(method, params) {
     if (!this.commandHandler) {
@@ -797,6 +907,7 @@ var RemoteClient = class {
   agent;
   session;
   presentation;
+  llm;
   constructor(config) {
     this.config = config;
     this.eventBus = new EventBusImpl();
@@ -817,6 +928,7 @@ var RemoteClient = class {
     this.agent = createRemoteAgents(this.rpcClient);
     this.session = createRemoteSessions(this.rpcClient);
     this.presentation = createPresentations(this);
+    this.llm = createRemoteLLM(this.rpcClient);
   }
   // ==================== Properties ====================
   get connected() {
@@ -850,6 +962,12 @@ var RemoteClient = class {
     this.rpcClient.subscribe(sessionId);
     logger2.debug("Subscribed to session", { sessionId });
   }
+  // ==================== Error Handling ====================
+  onError(handler) {
+    return this.eventBus.on("agentx_error", (event) => {
+      handler(event.data);
+    });
+  }
   // ==================== RPC ====================
   async rpc(method, params) {
     return this.rpcClient.call(method, params);
@@ -857,6 +975,7 @@ var RemoteClient = class {
 };
 
 // src/index.ts
+import { AgentXError, AgentXErrorCode } from "@agentxjs/core/error";
 function createAgentX(config) {
   let localClient = null;
   function getLocalClient() {
@@ -895,6 +1014,9 @@ function createAgentX(config) {
     get presentation() {
       return getLocalClient().presentation;
     },
+    get llm() {
+      return getLocalClient().llm;
+    },
     on(type, handler) {
       return getLocalClient().on(type, handler);
     },
@@ -904,6 +1026,9 @@ function createAgentX(config) {
     subscribe(sessionId) {
       getLocalClient().subscribe(sessionId);
     },
+    onError(handler) {
+      return getLocalClient().onError(handler);
+    },
     async disconnect() {
       await localClient?.disconnect();
     },
@@ -932,7 +1057,7 @@ function createAgentX(config) {
           "serve() requires platform.channelServer. Ensure your platform supports server mode."
         );
       }
-      const { createServer: createServer2 } = await import("./server-IFVYHIJF.js");
+      const { createServer: createServer2 } = await import("./server-BWI5JE4B.js");
       return createServer2({
         platform: config.platform,
         createDriver: config.createDriver,
@@ -948,6 +1073,8 @@ function createAgentX(config) {
   };
 }
 export {
+  AgentXError,
+  AgentXErrorCode,
   CommandHandler,
   Presentation,
   addUserConversation,