@robota-sdk/agent-transport-ws 3.0.0-beta.63 → 3.0.0-beta.76

package/dist/node/index.d.cts

@@ -1,231 +0,0 @@
-import { IToolState, IExecutionResult, ICommandResult, InteractiveSession, IExecutionWorkspaceSnapshot, TBackgroundTaskEvent, TBackgroundJobGroupEvent, IBackgroundTaskState, IBackgroundJobGroupState, IBackgroundTaskLogPage, IBackgroundTaskListFilter, IBackgroundTaskInput, IBackgroundTaskLogCursor } from '@robota-sdk/agent-sdk';
-export { IExecutionWorkspaceEntry, IExecutionWorkspaceSnapshot, TExecutionAttention, TExecutionWorkspaceStatus } from '@robota-sdk/agent-sdk';
-import { ITransportAdapter, IConfigurableTransport } from '@robota-sdk/agent-interface-transport';
-import { ISession, TUniversalValue } from '@robota-sdk/agent-core';
-
-type TBackgroundControlAction = 'cancel' | 'close' | 'send';
-/** Inbound message from client to server. */
-type TClientMessage = {
-    type: 'submit';
-    prompt: string;
-} | {
-    type: 'command';
-    name: string;
-    args?: string;
-} | {
-    type: 'abort';
-} | {
-    type: 'cancel-queue';
-} | {
-    type: 'get-messages';
-} | {
-    type: 'get-context';
-} | {
-    type: 'get-executing';
-} | {
-    type: 'get-pending';
-} | {
-    type: 'get-execution-workspace';
-} | {
-    type: 'get-background-tasks';
-    filter?: IBackgroundTaskListFilter;
-} | {
-    type: 'get-background-task';
-    taskId: string;
-} | {
-    type: 'get-background-job-groups';
-} | {
-    type: 'get-background-job-group';
-    groupId: string;
-} | {
-    type: 'wait-background-job-group';
-    groupId: string;
-} | {
-    type: 'cancel-background-task';
-    taskId: string;
-    reason?: string;
-} | {
-    type: 'close-background-task';
-    taskId: string;
-} | {
-    type: 'send-background-task';
-    taskId: string;
-    input: IBackgroundTaskInput;
-} | {
-    type: 'read-background-task-log';
-    taskId: string;
-    cursor?: IBackgroundTaskLogCursor;
-};
-/** Outbound message from server to client. */
-type TServerMessage = {
-    type: 'text_delta';
-    delta: string;
-} | {
-    type: 'user_message';
-    content: string;
-} | {
-    type: 'tool_start';
-    state: IToolState;
-} | {
-    type: 'tool_end';
-    state: IToolState;
-} | {
-    type: 'thinking';
-    isThinking: boolean;
-} | {
-    type: 'complete';
-    result: IExecutionResult;
-} | {
-    type: 'interrupted';
-    result: IExecutionResult;
-} | {
-    type: 'error';
-    message: string;
-} | {
-    type: 'command_result';
-    name: string;
-    message: string;
-    success: boolean;
-    data?: ICommandResult['data'];
-} | {
-    type: 'messages';
-    messages: ReturnType<InteractiveSession['getMessages']>;
-} | {
-    type: 'context';
-    state: ReturnType<InteractiveSession['getContextState']>;
-} | {
-    type: 'executing';
-    executing: boolean;
-} | {
-    type: 'pending';
-    pending: string | null;
-} | {
-    type: 'execution_workspace_event';
-    snapshot: IExecutionWorkspaceSnapshot;
-} | {
-    type: 'background_task_event';
-    event: TBackgroundTaskEvent;
-} | {
-    type: 'background_job_group_event';
-    event: TBackgroundJobGroupEvent;
-} | {
-    type: 'background_tasks';
-    tasks: IBackgroundTaskState[];
-} | {
-    type: 'background_task';
-    taskId: string;
-    task: IBackgroundTaskState | null;
-} | {
-    type: 'background_job_groups';
-    groups: IBackgroundJobGroupState[];
-} | {
-    type: 'background_job_group';
-    groupId: string;
-    group: IBackgroundJobGroupState | null;
-} | {
-    type: 'background_task_log';
-    taskId: string;
-    page: IBackgroundTaskLogPage;
-} | {
-    type: 'background_task_control_result';
-    action: TBackgroundControlAction;
-    taskId: string;
-    success: boolean;
-    message?: string;
-} | {
-    type: 'protocol_error';
-    message: string;
-};
-
-/**
- * WebSocket transport adapter — exposes InteractiveSession over WebSocket.
- *
- * Framework-agnostic: works with any WebSocket implementation via
- * send/onMessage callbacks. No dependency on ws, uWebSockets, etc.
- *
- * Protocol: JSON messages with { type, ...payload } structure.
- * Server pushes InteractiveSession events to client in real-time.
- */
-
-interface IWsHandlerOptions {
-    /** InteractiveSession to expose. */
-    session: InteractiveSession;
-    /** Send a JSON message to the client. */
-    send: (message: TServerMessage) => void;
-}
-/**
- * Create a WebSocket message handler for an InteractiveSession.
- *
- * Returns:
- * - `onMessage(data)`: call this when the WebSocket receives a message
- * - `cleanup()`: call this when the WebSocket disconnects
- *
- * Usage:
- * ```typescript
- * const { onMessage, cleanup } = createWsHandler({
- *   session: interactiveSession,
- *   send: (msg) => ws.send(JSON.stringify(msg)),
- * });
- *
- * ws.on('message', (data) => onMessage(String(data)));
- * ws.on('close', cleanup);
- * ```
- */
-declare function createWsHandler(options: IWsHandlerOptions): {
-    onMessage: (data: string) => void;
-    cleanup: () => void;
-};
-
-/**
- * ITransportAdapter implementation for WebSocket transport.
- *
- * Wraps createWsHandler into the unified ITransportAdapter interface.
- * After start(), the consumer must wire onMessage to their WebSocket.
- */
-
-interface IWsTransportOptions {
-    /** Send a JSON message to the connected WebSocket client. */
-    send: (message: TServerMessage) => void;
-}
-declare function createWsTransport(options: IWsTransportOptions): ITransportAdapter & {
-    onMessage: ((data: string) => void) | null;
-};
-
-/**
- * Self-contained WS transport implementing IConfigurableTransport.
- * Owns the WebSocket server lifecycle (ws package), started/stopped via the transport registry.
- */
-
-interface IWsTransportConfig {
-    port?: number;
-    maxRetries?: number;
-}
-declare class WsTransport implements IConfigurableTransport {
-    readonly name = "ws";
-    readonly defaultEnabled = true;
-    readonly optionsSchema: {
-        port: {
-            type: string;
-            description: string;
-            default: number;
-        };
-        maxRetries: {
-            type: string;
-            description: string;
-            default: number;
-        };
-    };
-    private session;
-    private stopFn;
-    private readonly port;
-    private readonly maxRetries;
-    constructor(config?: IWsTransportConfig);
-    attach(session: ISession): void;
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    validateOptions(options: Record<string, TUniversalValue>): boolean;
-    private bindWithRetry;
-    private tryBind;
-}
-
-export { type IWsHandlerOptions, type IWsTransportConfig, type IWsTransportOptions, type TClientMessage, type TServerMessage, WsTransport, createWsHandler, createWsTransport };