agentxjs 2.6.1 → 2.8.0

package/dist/index.d.ts

@@ -1,12 +1,11 @@
 import { CreateDriver } from '@agentxjs/core/driver';
-import { AgentXRuntime, AgentXPlatform } from '@agentxjs/core/runtime';
+import { 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 { PrototypeRecord, LLMProtocol, LLMProviderRecord } from '@agentxjs/core/persistence';
-import * as _agentxjs_core_network from '@agentxjs/core/network';
-import { RpcMethod } from '@agentxjs/core/network';
+import { LLMProtocol, LLMProviderRecord } from '@agentxjs/core/persistence';
+export { Capability, Context, ContextProvider } from '@agentxjs/core/context';
 
 /**
  * Presentation Types
@@ -134,12 +133,12 @@ interface PresentationOptions {
  */
 declare class Presentation {
     private agentx;
-    private agentId;
+    private instanceId;
     private state;
     private updateHandlers;
     private errorHandlers;
     private eventUnsubscribe;
-    constructor(agentx: AgentX, agentId: string, options?: PresentationOptions, initialConversations?: Conversation[]);
+    constructor(agentx: AgentX, instanceId: string, options?: PresentationOptions, initialConversations?: Conversation[]);
     /**
      * Get current state
      */
@@ -222,23 +221,35 @@ type MaybeAsync<T> = T | (() => T) | (() => Promise<T>);
 /**
  * Agent info returned from server
  */
-interface AgentInfo {
-    agentId: string;
+interface InstanceInfo {
+    instanceId: string;
     imageId: string;
     containerId: string;
     sessionId: string;
     lifecycle?: string;
 }
 /**
- * Embodiment — runtime configuration for an agent's "body".
+ * AgentConfig — flat runtime configuration for creating an agent.
+ * AgentConfig IS the body — no wrapper needed.
  */
-interface Embodiment {
+interface AgentConfig {
+    /** LLM model identifier */
     model?: string;
+    /** System prompt for the agent */
     systemPrompt?: string;
+    /** MCP server configurations for tool access */
     mcpServers?: Record<string, unknown>;
+    /** Context provider ID (e.g. RoleX individual) */
+    contextId?: string;
+    /** Display name */
+    name?: string;
+    /** Description */
+    description?: string;
+    /** Arbitrary custom data */
+    customData?: Record<string, unknown>;
 }
 /**
- * Image record from server
+ * Image record from server (internal persistence)
  */
 interface ImageRecord {
     imageId: string;
@@ -247,21 +258,13 @@ interface ImageRecord {
     name?: string;
     description?: string;
     contextId?: string;
-    embody?: Embodiment;
-    /** @deprecated Use `embody.systemPrompt` instead. */
+    model?: string;
     systemPrompt?: string;
-    /** @deprecated Use `embody.mcpServers` instead. */
     mcpServers?: Record<string, unknown>;
     customData?: Record<string, unknown>;
     createdAt: number;
     updatedAt: number;
 }
-/**
- * Container info
- */
-interface ContainerInfo {
-    containerId: string;
-}
 /**
  * Base response with requestId
  */
@@ -272,8 +275,8 @@ interface BaseResponse {
 /**
  * Agent create response
  */
-interface AgentCreateResponse extends BaseResponse {
-    agentId: string;
+interface InstanceCreateResponse extends BaseResponse {
+    instanceId: string;
     imageId: string;
     containerId: string;
     sessionId: string;
@@ -281,15 +284,15 @@ interface AgentCreateResponse extends BaseResponse {
 /**
  * Agent get response
  */
-interface AgentGetResponse extends BaseResponse {
-    agent: AgentInfo | null;
+interface InstanceGetResponse extends BaseResponse {
+    agent: InstanceInfo | null;
     exists: boolean;
 }
 /**
  * Agent list response
  */
-interface AgentListResponse extends BaseResponse {
-    agents: AgentInfo[];
+interface InstanceListResponse extends BaseResponse {
+    agents: InstanceInfo[];
 }
 /**
  * Image create response
@@ -318,30 +321,11 @@ interface ImageListResponse extends BaseResponse {
 interface ImageUpdateResponse extends BaseResponse {
     record: ImageRecord;
 }
-/**
- * Container create response
- */
-interface ContainerCreateResponse extends BaseResponse {
-    containerId: string;
-}
-/**
- * Container get response
- */
-interface ContainerGetResponse extends BaseResponse {
-    containerId: string;
-    exists: boolean;
-}
-/**
- * Container list response
- */
-interface ContainerListResponse extends BaseResponse {
-    containerIds: string[];
-}
 /**
  * Message send response
  */
 interface MessageSendResponse extends BaseResponse {
-    agentId: string;
+    instanceId: string;
 }
 /**
  * LLM provider create response
@@ -373,47 +357,6 @@ interface LLMProviderUpdateResponse extends BaseResponse {
 interface LLMProviderDefaultResponse extends BaseResponse {
     record: LLMProviderRecord | null;
 }
-/**
- * Prototype create response
- */
-interface PrototypeCreateResponse extends BaseResponse {
-    record: PrototypeRecord;
-}
-/**
- * Prototype get response
- */
-interface PrototypeGetResponse extends BaseResponse {
-    record: PrototypeRecord | null;
-}
-/**
- * Prototype list response
- */
-interface PrototypeListResponse extends BaseResponse {
-    records: PrototypeRecord[];
-}
-/**
- * Prototype update response
- */
-interface PrototypeUpdateResponse extends BaseResponse {
-    record: PrototypeRecord;
-}
-/**
- * Container operations namespace
- */
-interface ContainerNamespace {
-    /**
-     * Create or get container
-     */
-    create(containerId: string): Promise<ContainerCreateResponse>;
-    /**
-     * Get container
-     */
-    get(containerId: string): Promise<ContainerGetResponse>;
-    /**
-     * List containers
-     */
-    list(): Promise<ContainerListResponse>;
-}
 /**
  * Image operations namespace
  */
@@ -421,14 +364,7 @@ interface ImageNamespace {
     /**
      * Create a new image from an Agent blueprint
      */
-    create(params: {
-        containerId: string;
-        name?: string;
-        description?: string;
-        contextId?: string;
-        embody?: Embodiment;
-        customData?: Record<string, unknown>;
-    }): Promise<ImageCreateResponse>;
+    create(params: AgentConfig): Promise<ImageCreateResponse>;
     /**
      * Get image by ID
      */
@@ -436,16 +372,11 @@ interface ImageNamespace {
     /**
      * List images
      */
-    list(containerId?: string): Promise<ImageListResponse>;
+    list(): Promise<ImageListResponse>;
     /**
      * Update image
      */
-    update(imageId: string, updates: {
-        name?: string;
-        description?: string;
-        embody?: Embodiment;
-        customData?: Record<string, unknown>;
-    }): Promise<ImageUpdateResponse>;
+    update(imageId: string, updates: Partial<Pick<AgentConfig, "name" | "description" | "model" | "systemPrompt" | "mcpServers" | "customData">>): Promise<ImageUpdateResponse>;
     /**
      * Delete image
      */
@@ -458,26 +389,26 @@ interface ImageNamespace {
 /**
  * Agent operations namespace
  */
-interface AgentNamespace {
+interface InstanceNamespace {
     /**
      * Create a new agent
      */
     create(params: {
         imageId: string;
-        agentId?: string;
-    }): Promise<AgentCreateResponse>;
+        instanceId?: string;
+    }): Promise<InstanceCreateResponse>;
     /**
      * Get agent by ID
      */
-    get(agentId: string): Promise<AgentGetResponse>;
+    get(instanceId: string): Promise<InstanceGetResponse>;
     /**
      * List agents
      */
-    list(containerId?: string): Promise<AgentListResponse>;
+    list(): Promise<InstanceListResponse>;
     /**
      * Destroy an agent
      */
-    destroy(agentId: string): Promise<BaseResponse>;
+    destroy(instanceId: string): Promise<BaseResponse>;
 }
 /**
  * Session operations namespace (messaging)
@@ -486,15 +417,15 @@ interface SessionNamespace {
     /**
      * Send message to agent
      */
-    send(agentId: string, content: string | unknown[]): Promise<MessageSendResponse>;
+    send(instanceId: string, content: string | unknown[]): Promise<MessageSendResponse>;
     /**
      * Interrupt agent
      */
-    interrupt(agentId: string): Promise<BaseResponse>;
+    interrupt(instanceId: string): Promise<BaseResponse>;
     /**
      * Get message history for an agent's session
      */
-    getMessages(agentId: string): Promise<Message[]>;
+    getMessages(instanceId: string): Promise<Message[]>;
 }
 /**
  * LLM provider operations namespace
@@ -504,7 +435,6 @@ interface LLMNamespace {
      * Create a new LLM provider configuration
      */
     create(params: {
-        containerId: string;
         name: string;
         vendor: string;
         protocol: LLMProtocol;
@@ -517,9 +447,9 @@ interface LLMNamespace {
      */
     get(id: string): Promise<LLMProviderGetResponse>;
     /**
-     * List LLM providers for a container
+     * List LLM providers
      */
-    list(containerId: string): Promise<LLMProviderListResponse>;
+    list(): Promise<LLMProviderListResponse>;
     /**
      * Update LLM provider
      */
@@ -536,51 +466,13 @@ interface LLMNamespace {
      */
     delete(id: string): Promise<BaseResponse>;
     /**
-     * Set default LLM provider for a container
+     * Set default LLM provider
      */
     setDefault(id: string): Promise<BaseResponse>;
     /**
-     * Get default LLM provider for a container
+     * Get default LLM provider
      */
-    getDefault(containerId: string): Promise<LLMProviderDefaultResponse>;
-}
-/**
- * Prototype operations namespace — manage reusable agent templates
- */
-interface PrototypeNamespace {
-    /**
-     * Register a new prototype
-     */
-    create(params: {
-        containerId: string;
-        name: string;
-        description?: string;
-        contextId?: string;
-        embody?: Embodiment;
-        customData?: Record<string, unknown>;
-    }): Promise<PrototypeCreateResponse>;
-    /**
-     * Get prototype by ID
-     */
-    get(prototypeId: string): Promise<PrototypeGetResponse>;
-    /**
-     * List prototypes
-     */
-    list(containerId?: string): Promise<PrototypeListResponse>;
-    /**
-     * Update prototype
-     */
-    update(prototypeId: string, updates: {
-        name?: string;
-        description?: string;
-        contextId?: string;
-        embody?: Embodiment;
-        customData?: Record<string, unknown>;
-    }): Promise<PrototypeUpdateResponse>;
-    /**
-     * Delete prototype
-     */
-    delete(prototypeId: string): Promise<BaseResponse>;
+    getDefault(): Promise<LLMProviderDefaultResponse>;
 }
 /**
  * Presentation operations namespace
@@ -591,7 +483,7 @@ interface PresentationNamespace {
      *
      * @example
      * ```typescript
-     * const pres = ax.present(agentId, {
+     * const pres = ax.present(instanceId, {
      *   onUpdate: (state) => renderUI(state),
      *   onError: (error) => console.error(error),
      * });
@@ -600,23 +492,21 @@ interface PresentationNamespace {
      * pres.dispose();
      * ```
      */
-    create(agentId: string, options?: PresentationOptions): Promise<Presentation>;
+    create(instanceId: string, options?: PresentationOptions): Promise<Presentation>;
 }
 /**
  * Instance — low-level access to internal subsystems.
  *
  * Most users should use the top-level Agent API (ax.create, ax.send, etc.).
- * Instance exposes the underlying image, agent, session, container, llm,
+ * Instance exposes the underlying image, agent, session, llm,
  * and presentation subsystems for advanced use cases.
  */
 interface RuntimeNamespace {
-    readonly container: ContainerNamespace;
     readonly image: ImageNamespace;
-    readonly agent: AgentNamespace;
+    readonly instance: InstanceNamespace;
     readonly session: SessionNamespace;
     readonly present: PresentationNamespace;
     readonly llm: LLMNamespace;
-    readonly prototype: PrototypeNamespace;
 }
 /**
  * AgentHandle — a live reference to a created agent.
@@ -626,13 +516,13 @@ interface RuntimeNamespace {
  *
  * @example
  * ```typescript
- * const agent = await ax.chat.create({ name: "Aristotle", embody: { model: "claude-sonnet-4-6" } });
+ * const agent = await ax.chat.create({ name: "Aristotle", model: "claude-sonnet-4-6" });
  * await agent.send("Hello!");
  * const messages = await agent.history();
  * ```
  */
 interface AgentHandle {
-    readonly agentId: string;
+    readonly instanceId: string;
     readonly imageId: string;
     readonly containerId: string;
     readonly sessionId: string;
@@ -655,12 +545,7 @@ interface AgentHandle {
     /**
      * Update this agent's metadata
      */
-    update(updates: {
-        name?: string;
-        description?: string;
-        embody?: Embodiment;
-        customData?: Record<string, unknown>;
-    }): Promise<void>;
+    update(updates: Partial<Pick<AgentConfig, "name" | "description" | "model" | "systemPrompt" | "mcpServers" | "customData">>): Promise<void>;
     /**
      * Delete this agent
      */
@@ -675,18 +560,8 @@ interface AgentHandle {
 interface ChatNamespace {
     /**
      * Create a new conversation
-     *
-     * When `prototypeId` is provided, the conversation inherits the prototype's
-     * configuration (contextId, embody, etc.). Inline params override prototype values.
      */
-    create(params: {
-        prototypeId?: string;
-        name?: string;
-        description?: string;
-        contextId?: string;
-        embody?: Embodiment;
-        customData?: Record<string, unknown>;
-    }): Promise<AgentHandle>;
+    create(params: AgentConfig): Promise<AgentHandle>;
     /**
      * List all conversations
      */
@@ -702,7 +577,7 @@ interface ChatNamespace {
  * @example
  * ```typescript
  * const ax = createAgentX(config);
- * const agent = await ax.chat.create({ name: "Aristotle", embody: { model: "claude-sonnet-4-6" } });
+ * const agent = await ax.chat.create({ name: "Aristotle", model: "claude-sonnet-4-6" });
  * await agent.send("Hello!");
  * ```
  *
@@ -722,11 +597,7 @@ interface AgentX {
      */
     readonly chat: ChatNamespace;
     /**
-     * Prototype management — register and manage reusable agent templates.
-     */
-    readonly prototype: PrototypeNamespace;
-    /**
-     * Low-level access to internal subsystems (image, agent, session, container, llm).
+     * Low-level access to internal subsystems (image, agent, session, llm).
      */
     readonly runtime: RuntimeNamespace;
     /**
@@ -813,107 +684,6 @@ interface AgentXBuilder extends AgentX {
     serve(config?: ServeConfig): Promise<AgentXServer>;
 }
 
-/**
- * CommandHandler - Handles JSON-RPC requests directly
- *
- * No longer uses EventBus for request/response. Instead:
- * - Receives RPC requests directly
- * - Returns RPC responses directly
- * - EventBus is only used for stream events (notifications)
- */
-
-/**
- * RPC Result type
- */
-interface RpcResult<T = unknown> {
-    success: true;
-    data: T;
-}
-interface RpcError {
-    success: false;
-    code: number;
-    message: string;
-}
-type RpcResponse<T = unknown> = RpcResult<T> | RpcError;
-/**
- * CommandHandler - Processes RPC requests directly
- */
-declare class CommandHandler {
-    private readonly runtime;
-    constructor(runtime: AgentXRuntime);
-    /**
-     * Handle an RPC request and return response
-     */
-    handle(method: RpcMethod, params: unknown): Promise<RpcResponse>;
-    private handleContainerCreate;
-    private handleContainerGet;
-    private handleContainerList;
-    private handleImageCreate;
-    private handleImageGet;
-    private handleImageList;
-    private handleImageDelete;
-    private handleImageRun;
-    private handleImageStop;
-    private handleImageUpdate;
-    private handleImageMessages;
-    private handleAgentGet;
-    private handleAgentList;
-    private handleAgentDestroy;
-    private handleAgentDestroyAll;
-    private handleAgentInterrupt;
-    private handleMessageSend;
-    private handlePrototypeCreate;
-    private handlePrototypeGet;
-    private handlePrototypeList;
-    private handlePrototypeUpdate;
-    private handlePrototypeDelete;
-    private handleLLMCreate;
-    private handleLLMGet;
-    private handleLLMList;
-    private handleLLMUpdate;
-    private handleLLMDelete;
-    private handleLLMDefault;
-    dispose(): void;
-}
-
-/**
- * Server configuration (supports both immediate and deferred platforms)
- */
-interface ServerConfig {
-    /**
-     * AgentX Platform — must provide `channelServer` for accepting WebSocket connections.
-     */
-    platform: AgentXPlatform;
-    /**
-     * LLM Driver factory function - creates Driver per Agent
-     */
-    createDriver: CreateDriver;
-    /**
-     * Port to listen on (standalone mode)
-     */
-    port?: number;
-    /**
-     * Host to bind to (default: "0.0.0.0")
-     */
-    host?: string;
-    /**
-     * Existing HTTP server to attach to (attached mode)
-     */
-    server?: _agentxjs_core_network.MinimalHTTPServer;
-    /**
-     * WebSocket path when attached (default: "/ws")
-     */
-    wsPath?: string;
-    /**
-     * Enable debug logging
-     */
-    debug?: boolean;
-}
-/**
- * Create an AgentX server
- */
-declare function createServer(config: ServerConfig): Promise<AgentXServer>;
-
 /**
  * agentxjs - AgentX Client SDK
  *
@@ -925,7 +695,7 @@ declare function createServer(config: ServerConfig): Promise<AgentXServer>;
  * import { nodePlatform } from "@agentxjs/node-platform";
  *
  * const ax = createAgentX(nodePlatform({ createDriver }));
- * const agent = await ax.chat.create({ name: "Aristotle", embody: { model: "claude-sonnet-4-6" } });
+ * const agent = await ax.chat.create({ name: "Aristotle", model: "claude-sonnet-4-6" });
  * await agent.send("Hello!");
  * ```
  *
@@ -957,4 +727,4 @@ interface PlatformConfig {
  */
 declare function createAgentX(config?: PlatformConfig): AgentXBuilder;
 
-export { type AgentCreateResponse, type AgentGetResponse, type AgentHandle, type AgentInfo, type AgentListResponse, type AgentNamespace, type AgentX, type AgentXBuilder, type AgentXServer, type AssistantConversation, type BaseResponse, type Block, type ChatNamespace, CommandHandler, type ConnectOptions, type ContainerCreateResponse, type ContainerGetResponse, type ContainerInfo, type ContainerListResponse, type ContainerNamespace, type Conversation, type Embodiment, 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 PrototypeCreateResponse, type PrototypeGetResponse, type PrototypeListResponse, type PrototypeNamespace, type PrototypeUpdateResponse, type RuntimeNamespace, type ServeConfig, type ServerConfig, type SessionNamespace, type TextBlock, type ToolBlock, type UserConversation, addUserConversation, createAgentX, createInitialState, createServer, initialPresentationState, messagesToConversations, presentationReducer };
+export { type AgentConfig, type AgentHandle, type AgentX, type AgentXBuilder, type AgentXServer, type AssistantConversation, type BaseResponse, type Block, type ChatNamespace, type ConnectOptions, type Conversation, type ErrorConversation, type ImageBlock, type ImageCreateResponse, type ImageGetResponse, type ImageListResponse, type ImageNamespace, type ImageRecord, type ImageUpdateResponse, type InstanceCreateResponse, type InstanceGetResponse, type InstanceInfo, type InstanceListResponse, type InstanceNamespace, 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 RuntimeNamespace, type ServeConfig, type SessionNamespace, type TextBlock, type ToolBlock, type UserConversation, addUserConversation, createAgentX, createInitialState, initialPresentationState, messagesToConversations, presentationReducer };