@robota-sdk/agent-transport 3.0.0-beta.64 → 3.0.0-beta.66

package/src/tui/command-interaction.ts

@@ -0,0 +1,9 @@
+export type {
+  TOnMissingArgsAction,
+  ITuiPickerItem,
+  ITuiCommandInteraction,
+  ITuiPickerInteraction,
+  ITuiConfirmInteraction,
+  TAnyTuiCommandInteraction,
+} from '@robota-sdk/agent-interface-tui';
+export { isPickerInteraction, isConfirmInteraction } from '@robota-sdk/agent-interface-tui';

package/src/tui/create-default-tui-cli-adapter.ts

@@ -0,0 +1,42 @@
+import { findProviderDefinition } from '@robota-sdk/agent-core';
+import {
+  applyActiveModelChange,
+  applyStatusLineSettings,
+  deleteSettings,
+  getUserSettingsPath,
+  readSettings,
+  resolveGitBranch,
+  writeSettings,
+} from '@robota-sdk/agent-framework';
+
+import type { ITuiCliAdapter } from './tui-cli-adapter.js';
+import type { IProviderDefinition } from '@robota-sdk/agent-core';
+import type { CommandRegistry } from '@robota-sdk/agent-framework';
+
+export interface IDefaultTuiCliAdapterOptions {
+  providerDefinitions: readonly IProviderDefinition[];
+  reloadPluginCommandSource: (registry: CommandRegistry) => void;
+}
+
+export function createDefaultTuiCliAdapter({
+  providerDefinitions,
+  reloadPluginCommandSource,
+}: IDefaultTuiCliAdapterOptions): ITuiCliAdapter {
+  return {
+    getUserSettingsPath: () => getUserSettingsPath(),
+    readSettings: (path) => readSettings(path),
+    writeSettings: (path, settings) => writeSettings(path, settings),
+    deleteSettings: (path) => deleteSettings(path),
+    applyStatusLineSettings: (path, patch) => applyStatusLineSettings(path, patch),
+    reloadPluginCommandSource: (registry) => {
+      reloadPluginCommandSource(registry);
+    },
+    applyActiveModelChange: (cwd, modelId, options) => {
+      applyActiveModelChange(cwd, modelId, options);
+      return { applied: true };
+    },
+    getGitBranch: (cwd) => resolveGitBranch(cwd),
+    getProviderDisplayName: (type) =>
+      findProviderDefinition(providerDefinitions, type)?.displayName ?? type,
+  };
+}

package/src/tui/flows/input-area-flow.ts

@@ -1,6 +1,8 @@
+import { parseSlashInput } from '../hooks/useAutocomplete.js';
+
+import type { ITuiCommandInteraction } from '../command-interaction.js';
 import type { IHistoryEntry, TUniversalValue } from '@robota-sdk/agent-core';
 import type { ICommand } from '@robota-sdk/agent-framework';
-import { parseSlashInput } from '../hooks/useAutocomplete.js';
 
 export interface IAutocompleteInputKey {
   upArrow?: boolean;
@@ -17,7 +19,8 @@ export type TPromptHistoryInputAction = 'previous' | 'next';
 
 export type TCommandSelectionResult =
   | { type: 'insert'; value: string; selectedIndex?: number }
-  | { type: 'submit'; value: string };
+  | { type: 'submit'; value: string }
+  | { type: 'open-interaction'; commandName: string };
 
 export interface IPasteLabelChange {
   value: string;
@@ -154,11 +157,16 @@ export function resolveTabCompletion(value: string, command: ICommand): TCommand
 export function resolveEnterCommandSelection(
   value: string,
   command: ICommand,
+  interaction?: ITuiCommandInteraction,
 ): TCommandSelectionResult {
   const parsed = parseSlashInput(value);
   if (parsed.parentCommand) {
     return { type: 'submit', value: `/${parsed.parentCommand} ${command.name}` };
   }
+  // parentCommand is empty → no args provided beyond the command name itself
+  if (interaction?.onMissingArgs) {
+    return { type: 'open-interaction', commandName: command.name };
+  }
   if (command.subcommands && command.subcommands.length > 0) {
     return { type: 'insert', value: `/${command.name} `, selectedIndex: 0 };
   }

package/src/tui/hooks/command-effect-handler.ts

@@ -1,8 +1,9 @@
-import type { TCommandEffect, TStatusLineCommandSettingsPatch } from '@robota-sdk/agent-framework';
-import { isStatusLineCommandSettingsPatch } from '@robota-sdk/agent-framework';
 import { createSystemMessage, messageToHistoryEntry } from '@robota-sdk/agent-core';
-import type { IHistoryEntry, TSessionEndReason } from '@robota-sdk/agent-core';
+import { isStatusLineCommandSettingsPatch } from '@robota-sdk/agent-framework';
+
 import type { ITuiCliAdapter } from '../tui-cli-adapter.js';
+import type { IHistoryEntry, TSessionEndReason } from '@robota-sdk/agent-core';
+import type { TCommandEffect, TStatusLineCommandSettingsPatch } from '@robota-sdk/agent-framework';
 
 export interface ICommandEffectHandlerDeps {
   addEntry: (entry: IHistoryEntry) => void;

package/src/tui/hooks/side-effects-types.ts

@@ -1,10 +1,10 @@
+import type { ICommandEffectQueue } from './command-effect-queue.js';
 import type { IHistoryEntry } from '@robota-sdk/agent-core';
 import type { InteractiveSession } from '@robota-sdk/agent-framework';
 import type {
   TCommandInteractionPrompt as TInteractivePrompt,
   IStatusLineCommandSettings as TStatusLineSettings,
 } from '@robota-sdk/agent-framework';
-import type { ICommandEffectQueue } from './command-effect-queue.js';
 
 export type { TInteractivePrompt, TStatusLineSettings };
 

package/src/tui/hooks/use-interactive-session-init.ts

@@ -1,9 +1,11 @@
 import { InteractiveSession, CommandRegistry } from '@robota-sdk/agent-framework';
-import type { TToolArgs } from '@robota-sdk/agent-core';
-import type { TPermissionResultValue } from '@robota-sdk/agent-framework';
+
 import { TuiStateManager } from '../tui-state-manager.js';
 import { CommandEffectQueue, type ICommandEffectQueue } from './command-effect-queue.js';
+
 import type { IInteractiveSessionProps } from './useInteractiveSession.js';
+import type { TToolArgs } from '@robota-sdk/agent-core';
+import type { TPermissionResultValue } from '@robota-sdk/agent-framework';
 
 export interface IInitState {
   interactiveSession: InteractiveSession;

package/src/tui/hooks/useAutocomplete.ts

@@ -4,6 +4,7 @@
  */
 
 import React, { useState, useMemo } from 'react';
+
 import type { CommandRegistry, ICommand } from '@robota-sdk/agent-framework';
 
 /** Parse input to determine autocomplete state */

package/src/tui/hooks/useInteractiveSession.ts

@@ -1,30 +1,34 @@
+import { createSystemMessage, messageToHistoryEntry } from '@robota-sdk/agent-core';
 import { useState, useCallback, useEffect } from 'react';
-import { InteractiveSession, CommandRegistry } from '@robota-sdk/agent-framework';
-import type { ITransportRegistryView } from '@robota-sdk/agent-interface-transport';
+
+import { CommandEffectQueue, type ICommandEffectQueue } from './command-effect-queue.js';
+import { initializeSession, type IInitState } from './use-interactive-session-init.js';
+import { usePermissionQueue } from './usePermissionQueue.js';
+import { useSlashRouting } from './useSlashRouting.js';
+
+import type { TuiStateManager } from '../tui-state-manager.js';
+import type { IPermissionRequest } from '../types.js';
+import type {
+  IAIProvider,
+  TPermissionMode,
+  IHistoryEntry,
+  TSessionEndReason,
+} from '@robota-sdk/agent-core';
+import type { InteractiveSession, CommandRegistry } from '@robota-sdk/agent-framework';
 import type {
   IBackgroundTaskRunner,
   ICommandHostAdapters,
   ICommandModule,
   IInteractiveSession,
   IInteractiveSessionStore,
+  IExecutionWorkspaceEvent,
   TSubagentRunnerFactory,
   IExecutionDetailPage,
   IExecutionWorkspaceSnapshot,
+  IToolState,
   TShellExecFn,
 } from '@robota-sdk/agent-framework';
-import type {
-  IAIProvider,
-  TPermissionMode,
-  IHistoryEntry,
-  TSessionEndReason,
-} from '@robota-sdk/agent-core';
-import { createSystemMessage, messageToHistoryEntry } from '@robota-sdk/agent-core';
-import type { IPermissionRequest } from '../types.js';
-import { TuiStateManager } from '../tui-state-manager.js';
-import { useSlashRouting } from './useSlashRouting.js';
-import { CommandEffectQueue, type ICommandEffectQueue } from './command-effect-queue.js';
-import { usePermissionQueue } from './usePermissionQueue.js';
-import { initializeSession, type IInitState } from './use-interactive-session-init.js';
+import type { ITransportRegistryView } from '@robota-sdk/agent-interface-transport';
 
 const SESSION_INIT_POLL_MS = 200;
 
@@ -55,7 +59,7 @@ export interface IInteractiveSessionState {
   history: IHistoryEntry[];
   addEntry: (entry: IHistoryEntry) => void;
   streamingText: string;
-  activeTools: import('@robota-sdk/agent-framework').IToolState[];
+  activeTools: IToolState[];
   isThinking: boolean;
   isAborting: boolean;
   isShuttingDown: boolean;
@@ -144,9 +148,8 @@ export function useInteractiveSession(props: IInteractiveSessionProps): IInterac
     const onCompact = (): void => applyCompactEventToManager(interactiveSession, manager);
     const onSkillActivation = (): void =>
       applySkillActivationEventToManager(interactiveSession, manager);
-    const onExecutionWorkspaceEvent = (
-      event: import('@robota-sdk/agent-framework').IExecutionWorkspaceEvent,
-    ): void => manager.syncExecutionWorkspaceSnapshot(event.snapshot);
+    const onExecutionWorkspaceEvent = (event: IExecutionWorkspaceEvent): void =>
+      manager.syncExecutionWorkspaceSnapshot(event.snapshot);
 
     interactiveSession.on('text_delta', manager.onTextDelta);
     interactiveSession.on('tool_start', manager.onToolStart);

package/src/tui/hooks/usePermissionQueue.ts

@@ -1,7 +1,8 @@
 import { useState, useRef, useCallback } from 'react';
+
+import type { IPermissionRequest } from '../types.js';
 import type { TToolArgs } from '@robota-sdk/agent-core';
 import type { TPermissionResultValue } from '@robota-sdk/agent-framework';
-import type { IPermissionRequest } from '../types.js';
 
 export function usePermissionQueue(): {
   permissionHandler: (toolName: string, toolArgs: TToolArgs) => Promise<TPermissionResultValue>;

package/src/tui/hooks/usePluginCallbacks.ts

@@ -7,6 +7,7 @@
  */
 
 import { useMemo } from 'react';
+
 import type { ICommandPluginAdapter } from '@robota-sdk/agent-framework';
 
 function createNoOpPluginAdapter(): ICommandPluginAdapter {

package/src/tui/hooks/usePluginScreenData.ts

@@ -4,8 +4,9 @@
  */
 
 import { useState, useEffect } from 'react';
-import type { ICommandPluginAdapter } from '@robota-sdk/agent-framework';
+
 import type { IMenuSelectItem } from '../MenuSelect.js';
+import type { ICommandPluginAdapter } from '@robota-sdk/agent-framework';
 
 export function usePluginScreenData(
   screen: string,

package/src/tui/hooks/useSideEffects.ts

@@ -1,10 +1,7 @@
-import { useState, useRef, useCallback } from 'react';
-import { useApp } from 'ink';
-import type { ICommandInteraction, ICommandResult } from '@robota-sdk/agent-framework';
 import { createSystemMessage, messageToHistoryEntry } from '@robota-sdk/agent-core';
-import type { TSessionEndReason } from '@robota-sdk/agent-core';
-import type { TInteractivePrompt } from './side-effects-types.js';
-import type { IUseSideEffectsOptions, IUseSideEffectsResult } from './side-effects-types.js';
+import { useApp } from 'ink';
+import { useState, useRef, useCallback } from 'react';
+
 import { applyCommandEffects } from './command-effect-handler.js';
 import { useTuiCliAdapter } from '../tui-cli-adapter-context.js';
 import {
@@ -12,6 +9,11 @@ import {
   applyConfirmedModelChange,
 } from './model-change-side-effect.js';
 
+import type { IUseSideEffectsOptions, IUseSideEffectsResult } from './side-effects-types.js';
+import type { TInteractivePrompt } from './side-effects-types.js';
+import type { TSessionEndReason } from '@robota-sdk/agent-core';
+import type { ICommandInteraction, ICommandResult } from '@robota-sdk/agent-framework';
+
 const EXIT_DELAY_MS = 500;
 
 export function useSideEffects({

package/src/tui/hooks/useSlashRouting.ts

@@ -3,16 +3,17 @@
  * Extracted from useInteractiveSession for single-responsibility.
  */
 
+import { createSystemMessage, messageToHistoryEntry } from '@robota-sdk/agent-core';
 import { useCallback } from 'react';
+
+import type { TuiStateManager } from '../tui-state-manager.js';
+import type { ICommandEffectQueue } from './command-effect-queue.js';
 import type {
   IInteractiveSession,
   CommandRegistry,
   ICommandResult,
   TCommandEffect,
 } from '@robota-sdk/agent-framework';
-import { createSystemMessage, messageToHistoryEntry } from '@robota-sdk/agent-core';
-import type { TuiStateManager } from '../tui-state-manager.js';
-import type { ICommandEffectQueue } from './command-effect-queue.js';
 
 export function useSlashRouting(
   interactiveSession: IInteractiveSession,

package/src/tui/hooks/useStatusLineSettings.ts

@@ -1,8 +1,10 @@
-import { useState } from 'react';
-import type { IStatusLineCommandSettings } from '@robota-sdk/agent-framework';
 import { DEFAULT_STATUS_LINE_COMMAND_SETTINGS } from '@robota-sdk/agent-framework';
+import { useState } from 'react';
+
 import { useTuiCliAdapter } from '../tui-cli-adapter-context.js';
+
 import type { TUniversalValue } from '@robota-sdk/agent-core';
+import type { IStatusLineCommandSettings } from '@robota-sdk/agent-framework';
 
 function readStatusLineSettings(
   settings: Record<string, TUniversalValue>,

package/src/tui/index.ts

@@ -1,3 +1,13 @@
 export { TuiTransport } from './tui-transport.js';
 export type { ITuiCliAdapter } from './tui-cli-adapter.js';
-export type { IRenderOptions } from './render.js';
+export type { IDefaultTuiCliAdapterOptions } from './create-default-tui-cli-adapter.js';
+export { createDefaultTuiCliAdapter } from './create-default-tui-cli-adapter.js';
+export type { ITuiRenderOptions } from './render.js';
+export type {
+  TOnMissingArgsAction,
+  ITuiPickerItem,
+  ITuiCommandInteraction,
+  ITuiPickerInteraction,
+  ITuiConfirmInteraction,
+  TAnyTuiCommandInteraction,
+} from './command-interaction.js';

package/src/tui/interactions/CommandConfirm.tsx

@@ -0,0 +1,36 @@
+import { Box, Text, useInput } from 'ink';
+import React from 'react';
+
+import type { ITuiConfirmInteraction } from '../command-interaction.js';
+
+interface IProps {
+  commandName: string;
+  interaction: ITuiConfirmInteraction;
+  onConfirm: () => void;
+  onCancel: () => void;
+}
+
+export default function CommandConfirm({
+  commandName,
+  interaction,
+  onConfirm,
+  onCancel,
+}: IProps): React.ReactElement {
+  useInput((input, key) => {
+    if (key.return || input === 'y' || input === 'Y') {
+      onConfirm();
+    } else if (key.escape || input === 'n' || input === 'N') {
+      onCancel();
+    }
+  });
+
+  return (
+    <Box paddingX={1}>
+      <Text bold color="yellow">
+        /{commandName}:{' '}
+      </Text>
+      <Text>{interaction.message} </Text>
+      <Text dimColor>[y/n]</Text>
+    </Box>
+  );
+}

package/src/tui/interactions/CommandPicker.tsx

@@ -0,0 +1,77 @@
+import { Box, Text, useInput, useStdout } from 'ink';
+import React, { useState } from 'react';
+
+import type { ITuiPickerInteraction, ITuiPickerItem } from '../command-interaction.js';
+
+interface IProps {
+  commandName: string;
+  interaction: ITuiPickerInteraction;
+  onSelect: (item: ITuiPickerItem) => void;
+  onCancel: () => void;
+}
+
+const MAX_VISIBLE = 8;
+const OUTER_CHROME = 4;
+const MIN_ROW_WIDTH = 40;
+
+function useRowWidth(): number {
+  const { stdout } = useStdout();
+  return Math.max(MIN_ROW_WIDTH, (stdout.columns ?? 80) - OUTER_CHROME);
+}
+
+export default function CommandPicker({
+  commandName,
+  interaction,
+  onSelect,
+  onCancel,
+}: IProps): React.ReactElement {
+  const items = interaction.getItems();
+  const [selectedIndex, setSelectedIndex] = useState(0);
+  const rowWidth = useRowWidth();
+
+  useInput((input, key) => {
+    if (key.upArrow) {
+      setSelectedIndex((i) => (i > 0 ? i - 1 : items.length - 1));
+    } else if (key.downArrow) {
+      setSelectedIndex((i) => (i < items.length - 1 ? i + 1 : 0));
+    } else if (key.return) {
+      const item = items[selectedIndex];
+      if (item) onSelect(item);
+    } else if (key.escape || input === 'q') {
+      onCancel();
+    }
+  });
+
+  const scrollOffset = (() => {
+    if (items.length <= MAX_VISIBLE) return 0;
+    if (selectedIndex < MAX_VISIBLE) return 0;
+    return Math.min(selectedIndex - MAX_VISIBLE + 1, items.length - MAX_VISIBLE);
+  })();
+  const visibleItems = items.slice(scrollOffset, scrollOffset + MAX_VISIBLE);
+
+  return (
+    <Box flexDirection="column" borderStyle="round" borderColor="cyan" paddingX={1}>
+      <Text bold color="cyan">
+        /{commandName}
+      </Text>
+      {visibleItems.map((item, i) => {
+        const isSelected = scrollOffset + i === selectedIndex;
+        const indicator = isSelected ? '▸ ' : '  ';
+        return (
+          <Box key={item.value} width={rowWidth}>
+            <Text
+              color={isSelected ? 'cyan' : undefined}
+              dimColor={!isSelected}
+              wrap="truncate-end"
+            >
+              {indicator}
+              {item.label}
+              {item.description != null ? `  ${item.description}` : ''}
+            </Text>
+          </Box>
+        );
+      })}
+      <Text dimColor>↑↓ navigate · Enter select · Esc cancel</Text>
+    </Box>
+  );
+}

package/src/tui/render-markdown.ts

@@ -1,8 +1,9 @@
 import { marked } from 'marked';
-import type { Renderer } from 'marked';
 // @ts-expect-error — marked-terminal has no type declarations
 import TerminalRenderer from 'marked-terminal';
 
+import type { Renderer } from 'marked';
+
 const ANSI_LIGHT_RED = '\u001b[38;5;210m';
 const ANSI_LIGHT_GREEN = '\u001b[38;5;120m';
 const ANSI_CYAN = '\u001b[36m';

package/src/tui/render.tsx

@@ -2,27 +2,19 @@
  * Ink render entry point.
  */
 
-import React from 'react';
 import { render } from 'ink';
+import React from 'react';
+
 import App from './App.js';
-import type { IAIProvider } from '@robota-sdk/agent-core';
-import type { TPermissionMode } from '@robota-sdk/agent-core';
-import type {
-  IBackgroundTaskRunner,
-  ICommandHostAdapters,
-  ICommandModule,
-  IInteractiveSession,
-  IInteractiveSessionStore,
-  TSubagentRunnerFactory,
-  TShellExecFn,
-  CommandRegistry,
-} from '@robota-sdk/agent-framework';
-import type { ITransportRegistryView } from '@robota-sdk/agent-interface-transport';
+
 import type { ITuiCliAdapter } from './tui-cli-adapter.js';
+import type { TPermissionMode } from '@robota-sdk/agent-core';
+import type { IAgentRuntime } from '@robota-sdk/agent-framework';
+import type { TShellExecFn } from '@robota-sdk/agent-framework';
+
+export interface ITuiRenderOptions {
+  runtime: IAgentRuntime;
 
-export interface IRenderOptions {
-  cwd: string;
-  provider: IAIProvider;
   providerOverride?: string | undefined;
   providerType?: string | undefined;
   modelId?: string;
@@ -30,24 +22,17 @@ export interface IRenderOptions {
   permissionMode?: TPermissionMode;
   maxTurns?: number;
   version?: string;
-  sessionStore?: IInteractiveSessionStore;
   resumeSessionId?: string;
   showSessionPickerOnStart?: boolean;
   forkSession?: boolean;
   sessionName?: string;
-  backgroundTaskRunners?: IBackgroundTaskRunner[];
-  subagentRunnerFactory?: TSubagentRunnerFactory;
-  commandModules?: readonly ICommandModule[];
-  commandHostAdapters?: ICommandHostAdapters;
   shellExec?: TShellExecFn;
   startupUpdateNotice?: Promise<string | undefined>;
-  transportRegistry?: ITransportRegistryView<IInteractiveSession>;
   cliAdapter: ITuiCliAdapter;
-  reloadPluginCommandSource?: (registry: CommandRegistry) => void;
   agentName?: string;
 }
 
-export async function renderApp(options: IRenderOptions): Promise<void> {
+export async function renderApp(options: ITuiRenderOptions): Promise<void> {
   process.on('unhandledRejection', (reason) => {
     process.stderr.write(`\n[UNHANDLED REJECTION] ${reason}\n`);
     if (reason instanceof Error) {
@@ -55,6 +40,7 @@ export async function renderApp(options: IRenderOptions): Promise<void> {
     }
   });
 
-  const instance = render(<App {...options} />, { exitOnCtrlC: false });
+  const { runtime, ...tuiOptions } = options;
+  const instance = render(<App {...runtime} {...tuiOptions} />, { exitOnCtrlC: false });
   await instance.waitUntilExit();
 }

package/src/tui/tui-cli-adapter-context.tsx

@@ -1,4 +1,5 @@
 import { createContext, useContext } from 'react';
+
 import type { ITuiCliAdapter } from './tui-cli-adapter.js';
 
 const TuiCliAdapterContext = createContext<ITuiCliAdapter | null>(null);

package/src/tui/tui-cli-adapter.ts

@@ -1,9 +1,9 @@
+import type { TUniversalValue } from '@robota-sdk/agent-core';
 import type {
   TStatusLineCommandSettingsPatch,
   IStatusLineCommandSettings,
   CommandRegistry,
 } from '@robota-sdk/agent-framework';
-import type { TUniversalValue } from '@robota-sdk/agent-core';
 
 export interface ITuiCliAdapter {
   getUserSettingsPath(): string;

package/src/tui/tui-transport.ts

@@ -1,16 +1,17 @@
+import { renderApp, type ITuiRenderOptions } from './render.js';
+
+import type { TUniversalValue } from '@robota-sdk/agent-core';
 import type { IInteractiveSession } from '@robota-sdk/agent-framework';
 import type { IConfigurableTransport } from '@robota-sdk/agent-interface-transport';
-import type { TUniversalValue } from '@robota-sdk/agent-core';
-import { renderApp, type IRenderOptions } from './render.js';
 
 export class TuiTransport implements IConfigurableTransport<IInteractiveSession> {
   readonly name = 'tui';
   readonly defaultEnabled = true;
   readonly optionsSchema = {};
 
-  private readonly options: IRenderOptions;
+  private readonly options: ITuiRenderOptions;
 
-  constructor(options: IRenderOptions) {
+  constructor(options: ITuiRenderOptions) {
     this.options = options;
   }
 

package/src/tui/utils/edit-diff.ts

@@ -4,6 +4,7 @@
  */
 
 import { readFileSync } from 'node:fs';
+
 import type { TUniversalValue } from '@robota-sdk/agent-core';
 
 export interface IDiffLine {

package/src/tui/utils/tool-call-extractor.ts

@@ -4,6 +4,7 @@
  */
 
 import { extractEditDiff } from './edit-diff.js';
+
 import type { IDiffLine } from './edit-diff.js';
 import type { TUniversalValue } from '@robota-sdk/agent-core';
 

package/src/ws/ws-background-messages.ts

@@ -1,5 +1,5 @@
-import type { IInteractiveSession } from '@robota-sdk/agent-framework';
 import type { TBackgroundControlAction, TClientMessage, TServerMessage } from './ws-protocol.js';
+import type { IInteractiveSession } from '@robota-sdk/agent-framework';
 
 export function handleBackgroundQueryMessage(
   session: IInteractiveSession,

package/src/ws/ws-handler.ts

@@ -8,6 +8,12 @@
  * Server pushes IInteractiveSession events to client in real-time.
  */
 
+import {
+  handleBackgroundControlMessage,
+  handleBackgroundQueryMessage,
+} from './ws-background-messages.js';
+
+import type { TClientMessage, TServerMessage } from './ws-protocol.js';
 import type {
   IInteractiveSession,
   IExecutionResult,
@@ -16,11 +22,6 @@ import type {
   TBackgroundTaskEvent,
   IToolState,
 } from '@robota-sdk/agent-framework';
-import type { TClientMessage, TServerMessage } from './ws-protocol.js';
-import {
-  handleBackgroundControlMessage,
-  handleBackgroundQueryMessage,
-} from './ws-background-messages.js';
 
 export interface IWsHandlerOptions {
   /** IInteractiveSession to expose. */

package/src/ws/ws-transport-configurable.ts

@@ -4,12 +4,15 @@
  */
 
 import { createServer, type Server } from 'node:http';
+
 import { WebSocketServer, WebSocket } from 'ws';
-import type { IInteractiveSession } from '@robota-sdk/agent-framework';
-import type { TUniversalValue } from '@robota-sdk/agent-core';
-import type { IConfigurableTransport } from '@robota-sdk/agent-interface-transport';
+
 import { createWsHandler } from './ws-handler.js';
+
 import type { TServerMessage } from './ws-protocol.js';
+import type { TUniversalValue } from '@robota-sdk/agent-core';
+import type { IInteractiveSession } from '@robota-sdk/agent-framework';
+import type { IConfigurableTransport } from '@robota-sdk/agent-interface-transport';
 
 const DEFAULT_PORT = 7070;
 const DEFAULT_MAX_RETRIES = 20;

package/src/ws/ws-transport.ts

@@ -5,10 +5,11 @@
  * After start(), the consumer must wire onMessage to their WebSocket.
  */
 
-import type { IInteractiveSession } from '@robota-sdk/agent-framework';
-import type { ITransportAdapter } from '@robota-sdk/agent-interface-transport';
 import { createWsHandler } from './ws-handler.js';
+
 import type { TServerMessage } from './ws-protocol.js';
+import type { IInteractiveSession } from '@robota-sdk/agent-framework';
+import type { ITransportAdapter } from '@robota-sdk/agent-interface-transport';
 
 export interface IWsTransportOptions {
   /** Send a JSON message to the connected WebSocket client. */