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

package/src/tui/interactions/__tests__/CommandConfirm.test.tsx

@@ -1,124 +0,0 @@
-import React from 'react';
-import { render } from 'ink-testing-library';
-import { describe, it, expect } from 'vitest';
-
-import CommandConfirm from '../CommandConfirm.js';
-
-import type { ITuiConfirmInteraction } from '../../command-interaction.js';
-
-const delay = (ms: number): Promise<void> => new Promise((r) => setTimeout(r, ms));
-
-function makeInteraction(message: string): ITuiConfirmInteraction {
-  return { onMissingArgs: 'confirm', message };
-}
-
-describe('CommandConfirm', () => {
-  it('renders the message text', () => {
-    const { lastFrame } = render(
-      <CommandConfirm
-        commandName="exit"
-        interaction={makeInteraction('Exit the session?')}
-        onConfirm={() => {}}
-        onCancel={() => {}}
-      />,
-    );
-    expect(lastFrame()).toContain('Exit the session?');
-  });
-
-  it('calls onConfirm when y is pressed', () => {
-    let confirmed = false;
-    const { stdin } = render(
-      <CommandConfirm
-        commandName="exit"
-        interaction={makeInteraction('Exit?')}
-        onConfirm={() => {
-          confirmed = true;
-        }}
-        onCancel={() => {}}
-      />,
-    );
-    stdin.write('y');
-    expect(confirmed).toBe(true);
-  });
-
-  it('calls onConfirm when Y is pressed', () => {
-    let confirmed = false;
-    const { stdin } = render(
-      <CommandConfirm
-        commandName="exit"
-        interaction={makeInteraction('Exit?')}
-        onConfirm={() => {
-          confirmed = true;
-        }}
-        onCancel={() => {}}
-      />,
-    );
-    stdin.write('Y');
-    expect(confirmed).toBe(true);
-  });
-
-  it('calls onConfirm on Enter', () => {
-    let confirmed = false;
-    const { stdin } = render(
-      <CommandConfirm
-        commandName="exit"
-        interaction={makeInteraction('Exit?')}
-        onConfirm={() => {
-          confirmed = true;
-        }}
-        onCancel={() => {}}
-      />,
-    );
-    stdin.write('\r');
-    expect(confirmed).toBe(true);
-  });
-
-  it('calls onCancel when n is pressed', () => {
-    let cancelled = false;
-    const { stdin } = render(
-      <CommandConfirm
-        commandName="exit"
-        interaction={makeInteraction('Exit?')}
-        onConfirm={() => {}}
-        onCancel={() => {
-          cancelled = true;
-        }}
-      />,
-    );
-    stdin.write('n');
-    expect(cancelled).toBe(true);
-  });
-
-  it('calls onCancel when N is pressed', () => {
-    let cancelled = false;
-    const { stdin } = render(
-      <CommandConfirm
-        commandName="exit"
-        interaction={makeInteraction('Exit?')}
-        onConfirm={() => {}}
-        onCancel={() => {
-          cancelled = true;
-        }}
-      />,
-    );
-    stdin.write('N');
-    expect(cancelled).toBe(true);
-  });
-
-  it('calls onCancel on Escape', async () => {
-    let cancelled = false;
-    const { stdin } = render(
-      <CommandConfirm
-        commandName="exit"
-        interaction={makeInteraction('Exit?')}
-        onConfirm={() => {}}
-        onCancel={() => {
-          cancelled = true;
-        }}
-      />,
-    );
-    stdin.write('\x1b');
-    await delay(50);
-    expect(cancelled).toBe(true);
-  });
-});

package/src/tui/interactions/__tests__/CommandPicker.test.tsx

@@ -1,138 +0,0 @@
-import React from 'react';
-import { render } from 'ink-testing-library';
-import { describe, it, expect, vi } from 'vitest';
-
-import CommandPicker from '../CommandPicker.js';
-
-import type { ITuiPickerInteraction, ITuiPickerItem } from '../../command-interaction.js';
-
-const delay = (ms: number): Promise<void> => new Promise((r) => setTimeout(r, ms));
-
-function makeInteraction(items: ITuiPickerItem[]): ITuiPickerInteraction {
-  return {
-    onMissingArgs: 'picker',
-    getItems: () => items,
-  };
-}
-
-const ITEMS: ITuiPickerItem[] = [
-  { label: 'plan', value: 'plan', description: 'Plan mode' },
-  { label: 'default', value: 'default', description: 'Default mode' },
-  { label: 'auto', value: 'auto' },
-];
-
-describe('CommandPicker', () => {
-  it('renders all item labels', () => {
-    const { lastFrame } = render(
-      <CommandPicker
-        commandName="mode"
-        interaction={makeInteraction(ITEMS)}
-        onSelect={() => {}}
-        onCancel={() => {}}
-      />,
-    );
-    const frame = lastFrame()!;
-    expect(frame).toContain('plan');
-    expect(frame).toContain('default');
-    expect(frame).toContain('auto');
-  });
-
-  it('highlights first item by default', () => {
-    const { lastFrame } = render(
-      <CommandPicker
-        commandName="mode"
-        interaction={makeInteraction(ITEMS)}
-        onSelect={() => {}}
-        onCancel={() => {}}
-      />,
-    );
-    const frame = lastFrame()!;
-    expect(frame).toContain('▸ plan');
-  });
-
-  it('calls onSelect with first item on Enter', () => {
-    const onSelect = vi.fn();
-    const { stdin } = render(
-      <CommandPicker
-        commandName="mode"
-        interaction={makeInteraction(ITEMS)}
-        onSelect={onSelect}
-        onCancel={() => {}}
-      />,
-    );
-    stdin.write('\r');
-    expect(onSelect).toHaveBeenCalledWith(ITEMS[0]);
-  });
-
-  it('moves highlight down on arrow-down then selects on Enter', async () => {
-    let selected: ITuiPickerItem | undefined;
-    const { stdin } = render(
-      <CommandPicker
-        commandName="mode"
-        interaction={makeInteraction(ITEMS)}
-        onSelect={(item) => {
-          selected = item;
-        }}
-        onCancel={() => {}}
-      />,
-    );
-    stdin.write('\x1B[B'); // ↓
-    await delay(50);
-    stdin.write('\r');
-    expect(selected).toEqual(ITEMS[1]);
-  });
-
-  it('calls onCancel on Escape', async () => {
-    let cancelled = false;
-    const { stdin } = render(
-      <CommandPicker
-        commandName="mode"
-        interaction={makeInteraction(ITEMS)}
-        onSelect={() => {}}
-        onCancel={() => {
-          cancelled = true;
-        }}
-      />,
-    );
-    stdin.write('\x1b');
-    await delay(50);
-    expect(cancelled).toBe(true);
-  });
-
-  it('calls onCancel on q', () => {
-    const onCancel = vi.fn();
-    const { stdin } = render(
-      <CommandPicker
-        commandName="mode"
-        interaction={makeInteraction(ITEMS)}
-        onSelect={() => {}}
-        onCancel={onCancel}
-      />,
-    );
-    stdin.write('q');
-    expect(onCancel).toHaveBeenCalled();
-  });
-
-  it('wraps highlight from last to first on arrow-down at bottom', async () => {
-    let selected: ITuiPickerItem | undefined;
-    const { stdin } = render(
-      <CommandPicker
-        commandName="mode"
-        interaction={makeInteraction(ITEMS)}
-        onSelect={(item) => {
-          selected = item;
-        }}
-        onCancel={() => {}}
-      />,
-    );
-    // Navigate to last item (index 2)
-    stdin.write('\x1B[B'); // ↓ to index 1
-    await delay(50);
-    stdin.write('\x1B[B'); // ↓ to index 2
-    await delay(50);
-    stdin.write('\x1B[B'); // ↓ wraps to index 0
-    await delay(50);
-    stdin.write('\r');
-    expect(selected).toEqual(ITEMS[0]);
-  });
-});

package/src/tui/plugin-tui-handlers.ts

@@ -1,163 +0,0 @@
-/**
- * Screen-specific selection handlers for PluginTUI.
- * Extracted to keep PluginTUI.tsx under 300 lines.
- */
-
-import type { IMenuSelectItem } from './MenuSelect.js';
-import type { ICommandPluginAdapter } from '@robota-sdk/agent-interface-transport';
-
-interface IConfirmState {
-  message: string;
-  onConfirm: () => void;
-  onCancel: () => void;
-}
-
-interface IMenuContext {
-  marketplace?: string;
-  pluginId?: string;
-}
-
-interface INavActions {
-  push: (state: { screen: string; context?: IMenuContext }) => void;
-  pop: () => void;
-  popN: (n: number) => void;
-  notify: (content: string) => void;
-  setConfirm: (state: IConfirmState | undefined) => void;
-  refresh: () => void;
-}
-
-export function handleMainSelect(value: string, nav: Pick<INavActions, 'push'>): void {
-  if (value === 'marketplace') {
-    nav.push({ screen: 'marketplace-list' });
-  } else if (value === 'installed') {
-    nav.push({ screen: 'installed-list' });
-  }
-}
-
-export function handleMarketplaceListSelect(value: string, nav: Pick<INavActions, 'push'>): void {
-  if (value === '__add__') {
-    nav.push({ screen: 'marketplace-add' });
-  } else {
-    nav.push({ screen: 'marketplace-action', context: { marketplace: value } });
-  }
-}
-
-export function handleMarketplaceActionSelect(
-  value: string,
-  marketplace: string,
-  callbacks: ICommandPluginAdapter,
-  nav: Pick<INavActions, 'push' | 'pop' | 'popN' | 'notify' | 'setConfirm'>,
-): void {
-  if (value === 'browse') {
-    nav.push({ screen: 'marketplace-browse', context: { marketplace } });
-  } else if (value === 'update') {
-    callbacks
-      .marketplaceUpdate(marketplace)
-      .then(() => {
-        nav.notify(`Updated marketplace "${marketplace}".`);
-        nav.pop();
-      })
-      .catch((err) => {
-        nav.notify(`Error: ${err instanceof Error ? err.message : String(err)}`);
-      });
-  } else if (value === 'remove') {
-    nav.setConfirm({
-      message: `Remove marketplace "${marketplace}" and all its plugins?`,
-      onConfirm: () => {
-        nav.setConfirm(undefined);
-        callbacks
-          .marketplaceRemove(marketplace)
-          .then(() => {
-            nav.notify(`Removed marketplace "${marketplace}".`);
-            nav.popN(2);
-          })
-          .catch((err) => {
-            nav.notify(`Error: ${err instanceof Error ? err.message : String(err)}`);
-          });
-      },
-      onCancel: () => nav.setConfirm(undefined),
-    });
-  }
-}
-
-export function handleMarketplaceBrowseSelect(
-  value: string,
-  marketplace: string,
-  items: IMenuSelectItem[],
-  nav: Pick<INavActions, 'push'>,
-): void {
-  const fullId = `${value}@${marketplace}`;
-  const item = items.find((i) => i.value === value);
-  if (item?.hint === 'installed') {
-    nav.push({ screen: 'installed-action', context: { pluginId: fullId } });
-  } else {
-    nav.push({ screen: 'marketplace-install-scope', context: { marketplace, pluginId: fullId } });
-  }
-}
-
-export function handleInstallScopeSelect(
-  value: string,
-  pluginId: string,
-  callbacks: ICommandPluginAdapter,
-  nav: Pick<INavActions, 'popN' | 'notify'>,
-): void {
-  const scope = value as 'user' | 'project';
-  callbacks
-    .install(pluginId, scope)
-    .then(() => {
-      nav.notify(`Installed plugin "${pluginId}" (${scope} scope).`);
-      nav.popN(2);
-    })
-    .catch((err) => {
-      nav.notify(`Error: ${err instanceof Error ? err.message : String(err)}`);
-    });
-}
-
-export function handleInstalledListSelect(
-  value: string,
-  callbacks: ICommandPluginAdapter,
-  nav: Pick<INavActions, 'notify' | 'setConfirm' | 'refresh'>,
-): void {
-  nav.setConfirm({
-    message: `Uninstall plugin "${value}"?`,
-    onConfirm: () => {
-      nav.setConfirm(undefined);
-      callbacks
-        .uninstall(value)
-        .then(() => {
-          nav.notify(`Uninstalled plugin "${value}".`);
-          nav.refresh();
-        })
-        .catch((err) => {
-          nav.notify(`Error: ${err instanceof Error ? err.message : String(err)}`);
-        });
-    },
-    onCancel: () => nav.setConfirm(undefined),
-  });
-}
-
-export function handleInstalledActionSelect(
-  value: string,
-  pluginId: string,
-  callbacks: ICommandPluginAdapter,
-  nav: Pick<INavActions, 'popN' | 'notify' | 'setConfirm'>,
-): void {
-  if (value === 'uninstall') {
-    nav.setConfirm({
-      message: `Uninstall plugin "${pluginId}"?`,
-      onConfirm: () => {
-        nav.setConfirm(undefined);
-        callbacks
-          .uninstall(pluginId)
-          .then(() => {
-            nav.notify(`Uninstalled plugin "${pluginId}".`);
-            nav.popN(2);
-          })
-          .catch((err) => {
-            nav.notify(`Error: ${err instanceof Error ? err.message : String(err)}`);
-          });
-      },
-      onCancel: () => nav.setConfirm(undefined),
-    });
-  }
-}

package/src/tui/render-markdown.ts

@@ -1,130 +0,0 @@
-import { marked } 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';
-const ANSI_DIM = '\u001b[2m';
-const ANSI_DARK_RED_BACKGROUND = '\u001b[48;5;52m';
-const ANSI_DARK_GREEN_BACKGROUND = '\u001b[48;5;22m';
-const ANSI_RESET = '\u001b[0m';
-const CODE_BLOCK_INDENT = '    ';
-const ZERO_COLOR = '0';
-
-interface IRenderMarkdownOptions {
-  color?: boolean;
-  codeBlockWidth?: number;
-}
-
-interface ITerminalRendererOptions {
-  code?: (text: string) => string;
-}
-
-interface IHighlightOptions {
-  ignoreIllegals?: boolean;
-}
-
-type TTerminalRendererConstructor = new (
-  options?: ITerminalRendererOptions,
-  highlightOptions?: IHighlightOptions,
-) => Renderer;
-
-const TerminalRendererConstructor = TerminalRenderer as TTerminalRendererConstructor;
-
-function shouldUseColor(option: boolean | undefined): boolean {
-  if (option !== undefined) {
-    return option;
-  }
-  if (process.env.NO_COLOR || process.env.FORCE_COLOR === ZERO_COLOR) {
-    return false;
-  }
-  if (process.env.FORCE_COLOR) {
-    return true;
-  }
-  return Boolean(process.stdout.isTTY);
-}
-
-function isDiffLanguage(language: string | undefined): boolean {
-  return language?.trim().toLowerCase() === 'diff';
-}
-
-function styleAddedOrRemovedDiffRow(line: string, rowWidth: number, color: boolean): string {
-  const row = `${CODE_BLOCK_INDENT}${line}`.padEnd(rowWidth);
-  if (!color) {
-    return row.trimEnd();
-  }
-  if (line.startsWith('+')) {
-    return `${ANSI_DARK_GREEN_BACKGROUND}${ANSI_LIGHT_GREEN}${row}${ANSI_RESET}`;
-  }
-  if (line.startsWith('-')) {
-    return `${ANSI_DARK_RED_BACKGROUND}${ANSI_LIGHT_RED}${row}${ANSI_RESET}`;
-  }
-  return row.trimEnd();
-}
-
-function colorizeDiffLine(line: string, color: boolean, rowWidth: number): string {
-  if (line.startsWith('+') || line.startsWith('-')) {
-    return styleAddedOrRemovedDiffRow(line, rowWidth, color);
-  }
-  const row = `${CODE_BLOCK_INDENT}${line}`;
-  if (!color) {
-    return row;
-  }
-  if (line.startsWith('@@')) {
-    return `${ANSI_CYAN}${row}${ANSI_RESET}`;
-  }
-  if (line.startsWith('diff ') || line.startsWith('index ')) {
-    return `${ANSI_DIM}${row}${ANSI_RESET}`;
-  }
-  return row;
-}
-
-function resolveDiffRowWidth(lines: readonly string[], requestedWidth: number | undefined): number {
-  const minimumWidth = lines.reduce(
-    (maxWidth, line) => Math.max(maxWidth, CODE_BLOCK_INDENT.length + line.length),
-    0,
-  );
-  if (requestedWidth === undefined) {
-    return minimumWidth;
-  }
-  return Math.max(minimumWidth, requestedWidth);
-}
-
-function renderDiffCodeBlock(
-  code: string,
-  color: boolean,
-  codeBlockWidth: number | undefined,
-): string {
-  const lines = code.split('\n');
-  const rowWidth = resolveDiffRowWidth(lines, codeBlockWidth);
-  const body = lines.map((line) => colorizeDiffLine(line, color, rowWidth)).join('\n');
-  return `${body}\n\n`;
-}
-
-function createTerminalRenderer(color: boolean, codeBlockWidth: number | undefined): Renderer {
-  const renderer = new TerminalRendererConstructor(undefined, { ignoreIllegals: true });
-  const renderCode = renderer.code.bind(renderer);
-
-  renderer.code = (code: string, language: string | undefined, escaped: boolean): string => {
-    if (isDiffLanguage(language)) {
-      return renderDiffCodeBlock(code, color, codeBlockWidth);
-    }
-    return renderCode(code, language, escaped);
-  };
-
-  return renderer;
-}
-
-/**
- * Render markdown to a terminal-formatted string with colors, bold, etc.
- * Returns the rendered string (may include ANSI escape codes).
- */
-export function renderMarkdown(md: string, options: IRenderMarkdownOptions = {}): string {
-  const result = marked.parse(md, {
-    renderer: createTerminalRenderer(shouldUseColor(options.color), options.codeBlockWidth),
-  });
-  return typeof result === 'string' ? result.trimEnd() : md;
-}

package/src/tui/render.tsx

@@ -1,129 +0,0 @@
-/**
- * Ink render entry point.
- */
-
-import { render } from 'ink';
-import React from 'react';
-
-import App from './App.js';
-import { TuiInteractionChannel } from './TuiInteractionChannel.js';
-
-import type { ITuiCliAdapter } from './tui-cli-adapter.js';
-import type { IAIProvider } from '@robota-sdk/agent-core';
-import type { TPermissionMode } from '@robota-sdk/agent-core';
-import type {
-  IBackgroundTaskRunner,
-  ICommandHostAdapters,
-  ICommandModule,
-  TSubagentRunnerFactory,
-  TShellExecFn,
-  CommandRegistry,
-} from '@robota-sdk/agent-framework';
-import type {
-  IInteractiveSession,
-  IInteractiveSessionStore,
-  ITransportRegistryView,
-} from '@robota-sdk/agent-interface-transport';
-
-export interface IRenderOptions {
-  cwd: string;
-  provider: IAIProvider;
-  providerOverride?: string | undefined;
-  providerType?: string | undefined;
-  modelId?: string;
-  language?: string;
-  permissionMode?: TPermissionMode;
-  maxTurns?: number;
-  allowedTools?: string[];
-  deniedTools?: string[];
-  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;
-  /** Active preset id selected at startup (PRESET-011 runtime state). Defaults to 'default'. */
-  activePresetId?: string;
-  /** Preset persona block composed as a `source: 'persona'` system-prompt section (priority 5). */
-  persona?: string;
-  /** Preset execution capability: activate agent runtime + subagent/background dispatch. */
-  enableParallelSubagents?: boolean;
-  /** Preset execution capability: run a post-task self-verification step. */
-  selfVerification?: boolean;
-}
-
-/** Map render options to TuiInteractionChannel constructor options. */
-export function toChannelOptions(
-  options: IRenderOptions,
-  resumeSessionId?: string,
-): ConstructorParameters<typeof TuiInteractionChannel>[0] {
-  return {
-    cwd: options.cwd,
-    provider: options.provider,
-    permissionMode: options.permissionMode,
-    maxTurns: options.maxTurns,
-    allowedTools: options.allowedTools,
-    deniedTools: options.deniedTools,
-    sessionStore: options.sessionStore,
-    resumeSessionId,
-    forkSession: options.forkSession,
-    sessionName: options.sessionName,
-    backgroundTaskRunners: options.backgroundTaskRunners,
-    subagentRunnerFactory: options.subagentRunnerFactory,
-    commandModules: options.commandModules,
-    commandHostAdapters: options.commandHostAdapters,
-    shellExec: options.shellExec,
-    transportRegistry: options.transportRegistry,
-    language: options.language,
-    reloadPluginCommandSource: options.reloadPluginCommandSource,
-    agentName: options.agentName,
-    activePresetId: options.activePresetId,
-    persona: options.persona,
-    enableParallelSubagents: options.enableParallelSubagents,
-    selfVerification: options.selfVerification,
-  };
-}
-
-export async function renderApp(options: IRenderOptions): Promise<void> {
-  process.on('unhandledRejection', (reason) => {
-    process.stderr.write(`\n[UNHANDLED REJECTION] ${reason}\n`);
-    if (reason instanceof Error) {
-      process.stderr.write(`${reason.stack}\n`);
-    }
-  });
-
-  // Single-owner lifecycle (CLI-B12): render.tsx supplies only the factory;
-  // App creates, replaces, and stops channels exclusively through React state.
-  const createChannel = (resumeSessionId?: string): TuiInteractionChannel =>
-    new TuiInteractionChannel(toChannelOptions(options, resumeSessionId));
-
-  const instance = render(
-    <App
-      cwd={options.cwd}
-      createChannel={createChannel}
-      providerOverride={options.providerOverride}
-      providerType={options.providerType}
-      modelId={options.modelId}
-      permissionMode={options.permissionMode}
-      version={options.version}
-      sessionStore={options.sessionStore}
-      resumeSessionId={options.resumeSessionId}
-      showSessionPickerOnStart={options.showSessionPickerOnStart}
-      startupUpdateNotice={options.startupUpdateNotice}
-      transportRegistry={options.transportRegistry}
-      cliAdapter={options.cliAdapter}
-    />,
-    { exitOnCtrlC: false },
-  );
-  await instance.waitUntilExit();
-}