agentxjs 1.9.4-dev → 1.9.6-dev

package/dist/index.d.ts

@@ -1,3 +1,437 @@
+import { BusEvent, Unsubscribe, EventBus, BusEventHandler } from '@agentxjs/core/event';
+
+/**
+ * Presentation Types
+ *
+ * UI-friendly data model aggregated from stream events.
+ * This implements the Presentation Model pattern.
+ */
+/**
+ * Text block
+ */
+interface TextBlock {
+    type: "text";
+    content: string;
+}
+/**
+ * Tool block - represents a tool call and its result
+ */
+interface ToolBlock {
+    type: "tool";
+    toolUseId: string;
+    toolName: string;
+    toolInput: Record<string, unknown>;
+    toolResult?: string;
+    status: "pending" | "running" | "completed" | "error";
+}
+/**
+ * Image block
+ */
+interface ImageBlock {
+    type: "image";
+    url: string;
+    alt?: string;
+}
+/**
+ * All block types
+ */
+type Block = TextBlock | ToolBlock | ImageBlock;
+/**
+ * User conversation
+ */
+interface UserConversation {
+    role: "user";
+    blocks: Block[];
+}
+/**
+ * Assistant conversation
+ */
+interface AssistantConversation {
+    role: "assistant";
+    blocks: Block[];
+    isStreaming: boolean;
+}
+/**
+ * Error conversation
+ */
+interface ErrorConversation {
+    role: "error";
+    message: string;
+}
+/**
+ * All conversation types
+ */
+type Conversation = UserConversation | AssistantConversation | ErrorConversation;
+/**
+ * Presentation state - the complete UI state
+ */
+interface PresentationState {
+    /**
+     * All completed conversations
+     */
+    conversations: Conversation[];
+    /**
+     * Current streaming conversation (null if not streaming)
+     */
+    streaming: AssistantConversation | null;
+    /**
+     * Current status
+     */
+    status: "idle" | "thinking" | "responding" | "executing";
+}
+/**
+ * Initial presentation state
+ */
+declare const initialPresentationState: PresentationState;
+
+/**
+ * Presentation Reducer
+ *
+ * Aggregates stream events into PresentationState.
+ * Pure function: (state, event) => newState
+ */
+
+/**
+ * Reduce a stream event into presentation state
+ */
+declare function presentationReducer(state: PresentationState, event: BusEvent): PresentationState;
+/**
+ * Add a user conversation to state
+ */
+declare function addUserConversation(state: PresentationState, content: string): PresentationState;
+/**
+ * Create initial state
+ */
+declare function createInitialState(): PresentationState;
+
+/**
+ * Presentation Class
+ *
+ * High-level API for UI integration.
+ * Wraps AgentX client and provides presentation state management.
+ */
+
+/**
+ * Presentation update handler
+ */
+type PresentationUpdateHandler = (state: PresentationState) => void;
+/**
+ * Presentation error handler
+ */
+type PresentationErrorHandler = (error: Error) => void;
+/**
+ * Presentation options
+ */
+interface PresentationOptions {
+    /**
+     * Called on every state update
+     */
+    onUpdate?: PresentationUpdateHandler;
+    /**
+     * Called on errors
+     */
+    onError?: PresentationErrorHandler;
+}
+/**
+ * Presentation - UI-friendly wrapper for AgentX
+ */
+declare class Presentation {
+    private agentx;
+    private agentId;
+    private state;
+    private updateHandlers;
+    private errorHandlers;
+    private eventUnsubscribe;
+    constructor(agentx: AgentX, agentId: string, options?: PresentationOptions);
+    /**
+     * Get current state
+     */
+    getState(): PresentationState;
+    /**
+     * Subscribe to state updates
+     */
+    onUpdate(handler: PresentationUpdateHandler): Unsubscribe;
+    /**
+     * Subscribe to errors
+     */
+    onError(handler: PresentationErrorHandler): Unsubscribe;
+    /**
+     * Send a message
+     */
+    send(content: string): Promise<void>;
+    /**
+     * Interrupt current response
+     */
+    interrupt(): Promise<void>;
+    /**
+     * Reset state
+     */
+    reset(): void;
+    /**
+     * Dispose and cleanup
+     */
+    dispose(): void;
+    private subscribeToEvents;
+    private notify;
+    private notifyError;
+}
+
+/**
+ * AgentX Client SDK Types
+ */
+
+/**
+ * Static or dynamic value
+ */
+type MaybeAsync<T> = T | (() => T) | (() => Promise<T>);
+/**
+ * AgentX client configuration
+ */
+interface AgentXConfig {
+    /**
+     * WebSocket server URL
+     */
+    serverUrl: string;
+    /**
+     * Headers for authentication (static or dynamic)
+     * In Node.js: sent during WebSocket handshake
+     * In browsers: sent as first auth message (WebSocket API limitation)
+     */
+    headers?: MaybeAsync<Record<string, string>>;
+    /**
+     * Business context injected into all requests
+     * Useful for passing userId, tenantId, permissions, etc.
+     */
+    context?: MaybeAsync<Record<string, unknown>>;
+    /**
+     * Request timeout in milliseconds (default: 30000)
+     */
+    timeout?: number;
+    /**
+     * Enable debug logging
+     */
+    debug?: boolean;
+    /**
+     * Auto reconnect on connection loss (default: true)
+     */
+    autoReconnect?: boolean;
+}
+/**
+ * Agent info returned from server
+ */
+interface AgentInfo {
+    agentId: string;
+    imageId: string;
+    containerId: string;
+    sessionId: string;
+    lifecycle?: string;
+}
+/**
+ * Image record from server
+ */
+interface ImageRecord {
+    imageId: string;
+    containerId: string;
+    sessionId: string;
+    name?: string;
+    description?: string;
+    systemPrompt?: string;
+    createdAt: number;
+    updatedAt: number;
+}
+/**
+ * Container info
+ */
+interface ContainerInfo {
+    containerId: string;
+}
+/**
+ * Base response with requestId
+ */
+interface BaseResponse {
+    requestId: string;
+    error?: string;
+}
+/**
+ * Agent create response
+ */
+interface AgentCreateResponse extends BaseResponse {
+    agentId: string;
+    imageId: string;
+    containerId: string;
+    sessionId: string;
+}
+/**
+ * Agent get response
+ */
+interface AgentGetResponse extends BaseResponse {
+    agent: AgentInfo | null;
+    exists: boolean;
+}
+/**
+ * Agent list response
+ */
+interface AgentListResponse extends BaseResponse {
+    agents: AgentInfo[];
+}
+/**
+ * Image create response
+ */
+interface ImageCreateResponse extends BaseResponse {
+    record: ImageRecord;
+    __subscriptions?: string[];
+}
+/**
+ * Image get response
+ */
+interface ImageGetResponse extends BaseResponse {
+    record: ImageRecord | null;
+    __subscriptions?: string[];
+}
+/**
+ * Image list response
+ */
+interface ImageListResponse extends BaseResponse {
+    records: ImageRecord[];
+    __subscriptions?: string[];
+}
+/**
+ * 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;
+}
+/**
+ * AgentX Client SDK
+ */
+interface AgentX {
+    /**
+     * Check if connected to server
+     */
+    readonly connected: boolean;
+    /**
+     * Event bus for subscribing to events
+     */
+    readonly events: EventBus;
+    /**
+     * Create a new agent
+     */
+    createAgent(params: {
+        imageId: string;
+        agentId?: string;
+    }): Promise<AgentCreateResponse>;
+    /**
+     * Get agent by ID
+     */
+    getAgent(agentId: string): Promise<AgentGetResponse>;
+    /**
+     * List agents
+     */
+    listAgents(containerId?: string): Promise<AgentListResponse>;
+    /**
+     * Destroy an agent
+     */
+    destroyAgent(agentId: string): Promise<BaseResponse>;
+    /**
+     * Send message to agent
+     */
+    sendMessage(agentId: string, content: string | unknown[]): Promise<MessageSendResponse>;
+    /**
+     * Interrupt agent
+     */
+    interrupt(agentId: string): Promise<BaseResponse>;
+    /**
+     * Create a new image
+     */
+    createImage(params: {
+        containerId: string;
+        name?: string;
+        description?: string;
+        systemPrompt?: string;
+        mcpServers?: Record<string, unknown>;
+    }): Promise<ImageCreateResponse>;
+    /**
+     * Get image by ID
+     */
+    getImage(imageId: string): Promise<ImageGetResponse>;
+    /**
+     * List images
+     */
+    listImages(containerId?: string): Promise<ImageListResponse>;
+    /**
+     * Delete image
+     */
+    deleteImage(imageId: string): Promise<BaseResponse>;
+    /**
+     * Create or get container
+     */
+    createContainer(containerId: string): Promise<ContainerCreateResponse>;
+    /**
+     * Get container
+     */
+    getContainer(containerId: string): Promise<ContainerGetResponse>;
+    /**
+     * List containers
+     */
+    listContainers(): Promise<ContainerListResponse>;
+    /**
+     * Subscribe to specific event type
+     */
+    on<T extends string>(type: T, handler: BusEventHandler<BusEvent & {
+        type: T;
+    }>): Unsubscribe;
+    /**
+     * Subscribe to all events
+     */
+    onAny(handler: BusEventHandler): Unsubscribe;
+    /**
+     * Subscribe to session events
+     */
+    subscribe(sessionId: string): void;
+    /**
+     * Create a presentation for UI integration
+     *
+     * @example
+     * ```typescript
+     * const presentation = agentx.presentation(agentId);
+     *
+     * presentation.onUpdate((state) => {
+     *   render(state.conversations);
+     * });
+     *
+     * await presentation.send("Hello!");
+     * ```
+     */
+    presentation(agentId: string, options?: PresentationOptions): Presentation;
+    /**
+     * Disconnect from server
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Dispose and cleanup
+     */
+    dispose(): Promise<void>;
+}
+
 /**
  * agentxjs - AgentX Client SDK
  *
@@ -53,14 +487,13 @@
  * });
  * ```
  */
-import type { AgentX, AgentXConfig } from "./types";
+
 /**
  * Create an AgentX client
  *
  * @param config - Client configuration
  * @returns Connected AgentX client
  */
-export declare function createAgentX(config: AgentXConfig): Promise<AgentX>;
-export type { AgentX, AgentXConfig, MaybeAsync, AgentInfo, ImageRecord, ContainerInfo, AgentCreateResponse, AgentGetResponse, AgentListResponse, ImageCreateResponse, ImageGetResponse, ImageListResponse, ContainerCreateResponse, ContainerGetResponse, ContainerListResponse, MessageSendResponse, BaseResponse, } from "./types";
-export type { Block, TextBlock, ToolBlock, ImageBlock, Conversation, UserConversation, AssistantConversation, ErrorConversation, PresentationState, PresentationOptions, PresentationUpdateHandler, PresentationErrorHandler, } from "./presentation";
-export { Presentation, presentationReducer, addUserConversation, createInitialState, initialPresentationState, } from "./presentation";
+declare function createAgentX(config: AgentXConfig): Promise<AgentX>;
+
+export { type AgentCreateResponse, type AgentGetResponse, type AgentInfo, type AgentListResponse, type AgentX, type AgentXConfig, type AssistantConversation, type BaseResponse, type Block, type ContainerCreateResponse, type ContainerGetResponse, type ContainerInfo, type ContainerListResponse, type Conversation, type ErrorConversation, type ImageBlock, type ImageCreateResponse, type ImageGetResponse, type ImageListResponse, type ImageRecord, type MaybeAsync, type MessageSendResponse, Presentation, type PresentationErrorHandler, type PresentationOptions, type PresentationState, type PresentationUpdateHandler, type TextBlock, type ToolBlock, type UserConversation, addUserConversation, createAgentX, createInitialState, initialPresentationState, presentationReducer };