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

package/dist/node/index.d.ts

@@ -1,160 +1,150 @@
-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';
+import { IBackgroundJobGroupState, IBackgroundTaskInput, IBackgroundTaskListFilter, IBackgroundTaskLogCursor, IBackgroundTaskLogPage, IBackgroundTaskState, ICommandResult, IConfigurableTransport, IExecutionResult, IExecutionWorkspaceSnapshot, IInteractiveSession, IToolState, ITransportAdapter, TBackgroundJobGroupEvent, TBackgroundTaskEvent } from "@robota-sdk/agent-interface-transport";
+import { TUniversalValue } from "@robota-sdk/agent-core";
 
+//#region src/ws-protocol.d.ts
 type TBackgroundControlAction = 'cancel' | 'close' | 'send';
 /** Inbound message from client to server. */
 type TClientMessage = {
-    type: 'submit';
-    prompt: string;
+  type: 'submit';
+  prompt: string;
 } | {
-    type: 'command';
-    name: string;
-    args?: string;
+  type: 'command';
+  name: string;
+  args?: string;
 } | {
-    type: 'abort';
+  type: 'abort';
 } | {
-    type: 'cancel-queue';
+  type: 'cancel-queue';
 } | {
-    type: 'get-messages';
+  type: 'get-messages';
 } | {
-    type: 'get-context';
+  type: 'get-context';
 } | {
-    type: 'get-executing';
+  type: 'get-executing';
 } | {
-    type: 'get-pending';
+  type: 'get-pending';
 } | {
-    type: 'get-execution-workspace';
+  type: 'get-execution-workspace';
 } | {
-    type: 'get-background-tasks';
-    filter?: IBackgroundTaskListFilter;
+  type: 'get-background-tasks';
+  filter?: IBackgroundTaskListFilter;
 } | {
-    type: 'get-background-task';
-    taskId: string;
+  type: 'get-background-task';
+  taskId: string;
 } | {
-    type: 'get-background-job-groups';
+  type: 'get-background-job-groups';
 } | {
-    type: 'get-background-job-group';
-    groupId: string;
+  type: 'get-background-job-group';
+  groupId: string;
 } | {
-    type: 'wait-background-job-group';
-    groupId: string;
+  type: 'wait-background-job-group';
+  groupId: string;
 } | {
-    type: 'cancel-background-task';
-    taskId: string;
-    reason?: string;
+  type: 'cancel-background-task';
+  taskId: string;
+  reason?: string;
 } | {
-    type: 'close-background-task';
-    taskId: string;
+  type: 'close-background-task';
+  taskId: string;
 } | {
-    type: 'send-background-task';
-    taskId: string;
-    input: IBackgroundTaskInput;
+  type: 'send-background-task';
+  taskId: string;
+  input: IBackgroundTaskInput;
 } | {
-    type: 'read-background-task-log';
-    taskId: string;
-    cursor?: IBackgroundTaskLogCursor;
+  type: 'read-background-task-log';
+  taskId: string;
+  cursor?: IBackgroundTaskLogCursor;
 };
 /** Outbound message from server to client. */
 type TServerMessage = {
-    type: 'text_delta';
-    delta: string;
+  type: 'text_delta';
+  delta: string;
 } | {
-    type: 'user_message';
-    content: string;
+  type: 'user_message';
+  content: string;
 } | {
-    type: 'tool_start';
-    state: IToolState;
+  type: 'tool_start';
+  state: IToolState;
 } | {
-    type: 'tool_end';
-    state: IToolState;
+  type: 'tool_end';
+  state: IToolState;
 } | {
-    type: 'thinking';
-    isThinking: boolean;
+  type: 'thinking';
+  isThinking: boolean;
 } | {
-    type: 'complete';
-    result: IExecutionResult;
+  type: 'complete';
+  result: IExecutionResult;
 } | {
-    type: 'interrupted';
-    result: IExecutionResult;
+  type: 'interrupted';
+  result: IExecutionResult;
 } | {
-    type: 'error';
-    message: string;
+  type: 'error';
+  message: string;
 } | {
-    type: 'command_result';
-    name: string;
-    message: string;
-    success: boolean;
-    data?: ICommandResult['data'];
+  type: 'command_result';
+  name: string;
+  message: string;
+  success: boolean;
+  data?: ICommandResult['data'];
 } | {
-    type: 'messages';
-    messages: ReturnType<InteractiveSession['getMessages']>;
+  type: 'messages';
+  messages: ReturnType<IInteractiveSession['getMessages']>;
 } | {
-    type: 'context';
-    state: ReturnType<InteractiveSession['getContextState']>;
+  type: 'context';
+  state: ReturnType<IInteractiveSession['getContextState']>;
 } | {
-    type: 'executing';
-    executing: boolean;
+  type: 'executing';
+  executing: boolean;
 } | {
-    type: 'pending';
-    pending: string | null;
+  type: 'pending';
+  pending: string | null;
 } | {
-    type: 'execution_workspace_event';
-    snapshot: IExecutionWorkspaceSnapshot;
+  type: 'execution_workspace_event';
+  snapshot: IExecutionWorkspaceSnapshot;
 } | {
-    type: 'background_task_event';
-    event: TBackgroundTaskEvent;
+  type: 'background_task_event';
+  event: TBackgroundTaskEvent;
 } | {
-    type: 'background_job_group_event';
-    event: TBackgroundJobGroupEvent;
+  type: 'background_job_group_event';
+  event: TBackgroundJobGroupEvent;
 } | {
-    type: 'background_tasks';
-    tasks: IBackgroundTaskState[];
+  type: 'background_tasks';
+  tasks: IBackgroundTaskState[];
 } | {
-    type: 'background_task';
-    taskId: string;
-    task: IBackgroundTaskState | null;
+  type: 'background_task';
+  taskId: string;
+  task: IBackgroundTaskState | null;
 } | {
-    type: 'background_job_groups';
-    groups: IBackgroundJobGroupState[];
+  type: 'background_job_groups';
+  groups: IBackgroundJobGroupState[];
 } | {
-    type: 'background_job_group';
-    groupId: string;
-    group: IBackgroundJobGroupState | null;
+  type: 'background_job_group';
+  groupId: string;
+  group: IBackgroundJobGroupState | null;
 } | {
-    type: 'background_task_log';
-    taskId: string;
-    page: IBackgroundTaskLogPage;
+  type: 'background_task_log';
+  taskId: string;
+  page: IBackgroundTaskLogPage;
 } | {
-    type: 'background_task_control_result';
-    action: TBackgroundControlAction;
-    taskId: string;
-    success: boolean;
-    message?: string;
+  type: 'background_task_control_result';
+  action: TBackgroundControlAction;
+  taskId: string;
+  success: boolean;
+  message?: string;
 } | {
-    type: 'protocol_error';
-    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.
- */
-
+//#endregion
+//#region src/ws-handler.d.ts
 interface IWsHandlerOptions {
-    /** InteractiveSession to expose. */
-    session: InteractiveSession;
-    /** Send a JSON message to the client. */
-    send: (message: TServerMessage) => void;
+  /** IInteractiveSession to expose. */
+  session: IInteractiveSession;
+  /** Send a JSON message to the client. */
+  send: (message: TServerMessage) => void;
 }
 /**
- * Create a WebSocket message handler for an InteractiveSession.
+ * Create a WebSocket message handler for an IInteractiveSession.
  *
  * Returns:
  * - `onMessage(data)`: call this when the WebSocket receives a message
@@ -172,60 +162,51 @@ interface IWsHandlerOptions {
  * ```
  */
 declare function createWsHandler(options: IWsHandlerOptions): {
-    onMessage: (data: string) => void;
-    cleanup: () => void;
+  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.
- */
-
+//#endregion
+//#region src/ws-transport.d.ts
 interface IWsTransportOptions {
-    /** Send a JSON message to the connected WebSocket client. */
-    send: (message: TServerMessage) => void;
+  /** Send a JSON message to the connected WebSocket client. */
+  send: (message: TServerMessage) => void;
 }
-declare function createWsTransport(options: IWsTransportOptions): ITransportAdapter & {
-    onMessage: ((data: string) => void) | null;
+declare function createWsTransport(options: IWsTransportOptions): ITransportAdapter<IInteractiveSession> & {
+  onMessage: ((data: string) => void) | null;
 };
-
-/**
- * Self-contained WS transport implementing IConfigurableTransport.
- * Owns the WebSocket server lifecycle (ws package), started/stopped via the transport registry.
- */
-
+//#endregion
+//#region src/ws-transport-configurable.d.ts
 interface IWsTransportConfig {
-    port?: number;
-    maxRetries?: number;
+  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;
-        };
+declare class WsTransport implements IConfigurableTransport<IInteractiveSession> {
+  readonly name = "ws";
+  readonly defaultEnabled = true;
+  readonly optionsSchema: {
+    port: {
+      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;
+    maxRetries: {
+      type: string;
+      description: string;
+      default: number;
+    };
+  };
+  private session;
+  private stopFn;
+  private readonly port;
+  private readonly maxRetries;
+  constructor(config?: IWsTransportConfig);
+  attach(session: IInteractiveSession): void;
+  start(): Promise<void>;
+  stop(): Promise<void>;
+  validateOptions(options: Record<string, TUniversalValue>): boolean;
+  private bindWithRetry;
+  private tryBind;
 }
-
+//#endregion
 export { type IWsHandlerOptions, type IWsTransportConfig, type IWsTransportOptions, type TClientMessage, type TServerMessage, WsTransport, createWsHandler, createWsTransport };
+//# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/ws-protocol.ts","../../src/ws-handler.ts","../../src/ws-transport.ts","../../src/ws-transport-configurable.ts"],"mappings":"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"}