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

package/src/tui/session-naming.ts

@@ -1,33 +0,0 @@
-import { createSystemMessage, createUserMessage } from '@robota-sdk/agent-core';
-
-import type { IAIProvider } from '@robota-sdk/agent-core';
-
-const SYSTEM_PROMPT =
-  'You generate short session titles. Respond with ONLY a 3-5 word lowercase-hyphenated title (e.g. refactor-auth-middleware). No explanation, no punctuation, no quotes.';
-
-const MAX_FIRST_MESSAGE_CHARS = 200;
-
-function sanitizeName(raw: string): string {
-  return raw
-    .toLowerCase()
-    .replace(/[^a-z0-9\s-]/g, '')
-    .trim()
-    .replace(/\s+/g, '-')
-    .replace(/-+/g, '-')
-    .slice(0, 60);
-}
-
-export async function generateSessionName(
-  provider: IAIProvider,
-  firstMessage: string,
-): Promise<string> {
-  const truncated = firstMessage.slice(0, MAX_FIRST_MESSAGE_CHARS);
-  const response = await provider.chat(
-    [createSystemMessage(SYSTEM_PROMPT), createUserMessage(truncated)],
-    { maxTokens: 20 },
-  );
-  const raw = typeof response.content === 'string' ? response.content : '';
-  const name = sanitizeName(raw);
-  if (!name || name.length < 3) return sanitizeName(firstMessage);
-  return name;
-}

package/src/tui/status-activity.ts

@@ -1,63 +0,0 @@
-export type TStatusActivityKind = 'tools' | 'thinking' | 'background' | 'queued' | 'idle';
-
-export interface IStatusActivityInput {
-  isThinking: boolean;
-  activeToolCount: number;
-  activeBackgroundTaskCount: number;
-  hasPendingPrompt: boolean;
-}
-
-export interface IStatusActivity {
-  kind: TStatusActivityKind;
-  label: string;
-  color: string;
-  segments: string[];
-  text: string;
-}
-
-const NO_ACTIVE_ITEMS = 0;
-
-export function formatStatusActivity(input: IStatusActivityInput): IStatusActivity {
-  const base = getPrimaryActivity(input);
-  const segments = input.hasPendingPrompt && base.kind !== 'queued' ? ['queued'] : [];
-  const text = [base.label, ...segments].join(' · ');
-  return { ...base, segments, text };
-}
-
-function getPrimaryActivity(
-  input: IStatusActivityInput,
-): Omit<IStatusActivity, 'segments' | 'text'> {
-  if (input.activeToolCount > NO_ACTIVE_ITEMS) {
-    return {
-      kind: 'tools',
-      label: `Tools (${input.activeToolCount})`,
-      color: 'cyan',
-    };
-  }
-  if (input.isThinking) {
-    return {
-      kind: 'thinking',
-      label: 'Thinking',
-      color: 'yellow',
-    };
-  }
-  if (input.activeBackgroundTaskCount > NO_ACTIVE_ITEMS) {
-    return {
-      kind: 'background',
-      label: `Background (${input.activeBackgroundTaskCount})`,
-      color: 'cyan',
-    };
-  }
-  if (input.hasPendingPrompt) {
-    return {
-      kind: 'queued',
-      label: 'Queued',
-      color: 'yellow',
-    };
-  }
-  return {
-    kind: 'idle',
-    label: 'Idle',
-    color: 'gray',
-  };
-}

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

@@ -1,13 +0,0 @@
-import { createContext, useContext } from 'react';
-
-import type { ITuiCliAdapter } from './tui-cli-adapter.js';
-
-const TuiCliAdapterContext = createContext<ITuiCliAdapter | null>(null);
-
-export const TuiCliAdapterProvider = TuiCliAdapterContext.Provider;
-
-export function useTuiCliAdapter(): ITuiCliAdapter {
-  const adapter = useContext(TuiCliAdapterContext);
-  if (!adapter) throw new Error('TuiCliAdapterContext not provided');
-  return adapter;
-}

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

@@ -1,25 +0,0 @@
-import type { TUniversalValue } from '@robota-sdk/agent-core';
-import type { CommandRegistry } from '@robota-sdk/agent-framework';
-import type {
-  IStatusLineCommandSettings,
-  TStatusLineCommandSettingsPatch,
-} from '@robota-sdk/agent-interface-transport';
-
-export interface ITuiCliAdapter {
-  getUserSettingsPath(): string;
-  readSettings(path: string): Record<string, TUniversalValue>;
-  writeSettings(path: string, settings: Record<string, TUniversalValue>): void;
-  deleteSettings(path: string): boolean;
-  applyStatusLineSettings(
-    path: string,
-    patch: TStatusLineCommandSettingsPatch,
-  ): IStatusLineCommandSettings;
-  reloadPluginCommandSource(registry: CommandRegistry): void;
-  applyActiveModelChange(
-    cwd: string,
-    modelId: string,
-    options?: { providerOverride?: string },
-  ): { applied: boolean };
-  getGitBranch(cwd: string): string | undefined;
-  getProviderDisplayName(type: string): string;
-}

package/src/tui/tui-state-manager.ts

@@ -1,226 +0,0 @@
-/**
- * TuiStateManager — pure TypeScript rendering state manager.
- *
- * Converts InteractiveSession events into rendering state.
- * No React dependency. Fully unit-testable.
- *
- * React hook (useTuiChannel) subscribes to onChange
- * and reads state for rendering.
- */
-
-import type { IContextWindowState, IHistoryEntry } from '@robota-sdk/agent-core';
-import type {
-  IExecutionResult,
-  IExecutionWorkspaceSnapshot,
-  IToolState,
-} from '@robota-sdk/agent-interface-transport';
-
-/** Max messages kept in rendering state */
-const MAX_RENDERED_MESSAGES = 100;
-
-/** Debounce interval for streaming text notify (limits renderMarkdown frequency) */
-const STREAMING_DEBOUNCE_MS = 300;
-export interface IContextState {
-  percentage: number;
-  usedTokens: number;
-  maxTokens: number;
-}
-
-/** Create a debounced notify — schedules at most one call per interval. */
-function createDebouncedNotify(
-  notify: () => void,
-  ms: number,
-): { schedule: () => void; flush: () => void } {
-  let timer: ReturnType<typeof setTimeout> | null = null;
-  return {
-    schedule() {
-      if (!timer) {
-        timer = setTimeout(() => {
-          timer = null;
-          notify();
-        }, ms);
-      }
-    },
-    flush() {
-      if (timer) {
-        clearTimeout(timer);
-        timer = null;
-      }
-    },
-  };
-}
-
-export class TuiStateManager {
-  // ── Rendering state ───────────────────────────────────────────
-  history: IHistoryEntry[] = [];
-  streamingText = '';
-  activeTools: IToolState[] = [];
-  isThinking = false;
-  isAborting = false;
-  pendingPrompt: string | null = null;
-  contextState: IContextState = { percentage: 0, usedTokens: 0, maxTokens: 0 };
-  executionWorkspaceSnapshot: IExecutionWorkspaceSnapshot | null = null;
-  selectedExecutionEntryId: string | undefined;
-
-  /** Called after any state change. React hook sets this to trigger re-render. */
-  onChange: (() => void) | null = null;
-
-  // ── Internal ──────────────────────────────────────────────────
-  private streamBuf = '';
-  private debouncedStreamNotify = createDebouncedNotify(() => this.notify(), STREAMING_DEBOUNCE_MS);
-
-  private notify(): void {
-    this.onChange?.();
-  }
-
-  // ── Event handlers (InteractiveSession → state) ───────────────
-
-  onTextDelta = (delta: string): void => {
-    this.streamBuf += delta;
-    this.streamingText = this.streamBuf;
-    this.debouncedStreamNotify.schedule();
-  };
-
-  onToolStart = (state: IToolState): void => {
-    this.activeTools = [...this.activeTools, state];
-    this.notify();
-  };
-
-  onToolEnd = (state: IToolState): void => {
-    // findLastIndex: when same tool runs concurrently, match the most recently started instance
-    const idx = this.activeTools.findLastIndex((t) => t.toolName === state.toolName && t.isRunning);
-    if (idx !== -1) {
-      const updated = [...this.activeTools];
-      updated[idx] = state;
-      this.activeTools = updated;
-    }
-    this.notify();
-  };
-
-  onThinking = (thinking: boolean): void => {
-    this.isThinking = thinking;
-    if (thinking) {
-      // Clear at START of new execution (preserves previous result until next)
-      this.debouncedStreamNotify.flush();
-      this.streamBuf = '';
-      this.streamingText = '';
-      this.activeTools = [];
-    } else {
-      this.isAborting = false;
-      this.activeTools = [];
-    }
-    this.notify();
-  };
-
-  onComplete = (result: IExecutionResult): void => {
-    // Tool summary is now in messages (pushed by InteractiveSession)
-    // Clear streaming display
-    this.debouncedStreamNotify.flush();
-    this.streamBuf = '';
-    this.streamingText = '';
-    this.activeTools = [];
-    this.contextState = {
-      percentage: result.contextState.usedPercentage,
-      usedTokens: result.contextState.usedTokens,
-      maxTokens: result.contextState.maxTokens,
-    };
-    this.notify();
-  };
-
-  onInterrupted = (): void => {
-    // Tool summary is now in messages
-    this.debouncedStreamNotify.flush();
-    this.streamBuf = '';
-    this.streamingText = '';
-    this.activeTools = [];
-    this.notify();
-  };
-
-  onError = (): void => {
-    // Tool summary is now in messages
-    this.debouncedStreamNotify.flush();
-    this.streamBuf = '';
-    this.streamingText = '';
-    this.activeTools = [];
-    this.notify();
-  };
-
-  onContextUpdate = (state: IContextWindowState): void => {
-    this.setContextState({
-      percentage: state.usedPercentage,
-      usedTokens: state.usedTokens,
-      maxTokens: state.maxTokens,
-    });
-  };
-
-  // ── State updates from external sources ───────────────────────
-
-  /** Sync history from InteractiveSession */
-  syncHistory(entries: IHistoryEntry[]): void {
-    if (entries.length === 0) return;
-    this.history =
-      entries.length > MAX_RENDERED_MESSAGES ? entries.slice(-MAX_RENDERED_MESSAGES) : [...entries];
-    this.notify();
-  }
-
-  /** Add a single history entry */
-  addEntry(entry: IHistoryEntry): void {
-    const updated = [...this.history, entry];
-    this.history =
-      updated.length > MAX_RENDERED_MESSAGES ? updated.slice(-MAX_RENDERED_MESSAGES) : updated;
-    this.notify();
-  }
-
-  clearHistory(): void {
-    this.history = [];
-    this.debouncedStreamNotify.flush();
-    this.streamBuf = '';
-    this.streamingText = '';
-    this.activeTools = [];
-    this.notify();
-  }
-
-  /** Update pending prompt state */
-  setPendingPrompt(prompt: string | null): void {
-    this.pendingPrompt = prompt;
-    this.notify();
-  }
-
-  /** Set aborting flag */
-  setAborting(aborting: boolean): void {
-    this.isAborting = aborting;
-    this.notify();
-  }
-
-  /** Update context state */
-  setContextState(state: IContextState): void {
-    this.contextState = state;
-    this.notify();
-  }
-
-  syncExecutionWorkspaceSnapshot(snapshot: IExecutionWorkspaceSnapshot): void {
-    const currentSelection = this.selectedExecutionEntryId;
-    const hasCurrentSelection =
-      currentSelection !== undefined &&
-      snapshot.entries.some((entry) => entry.id === currentSelection);
-    const selectedExecutionEntryId = hasCurrentSelection
-      ? currentSelection
-      : (snapshot.selectedEntryId ?? snapshot.entries[0]?.id);
-    this.executionWorkspaceSnapshot = {
-      ...snapshot,
-      ...(selectedExecutionEntryId ? { selectedEntryId: selectedExecutionEntryId } : {}),
-    };
-    this.selectedExecutionEntryId = selectedExecutionEntryId;
-    this.notify();
-  }
-
-  selectExecutionWorkspaceEntry(entryId: string): void {
-    if (!this.executionWorkspaceSnapshot?.entries.some((entry) => entry.id === entryId)) return;
-    this.selectedExecutionEntryId = entryId;
-    this.executionWorkspaceSnapshot = {
-      ...this.executionWorkspaceSnapshot,
-      selectedEntryId: entryId,
-    };
-    this.notify();
-  }
-}

package/src/tui/tui-transport.ts

@@ -1,35 +0,0 @@
-import { renderApp, type IRenderOptions } from './render.js';
-
-import type { TUniversalValue } from '@robota-sdk/agent-core';
-import type {
-  IConfigurableTransport,
-  IInteractiveSession,
-} from '@robota-sdk/agent-interface-transport';
-
-export class TuiTransport implements IConfigurableTransport<IInteractiveSession> {
-  readonly name = 'tui';
-  readonly defaultEnabled = true;
-  readonly optionsSchema = {};
-
-  private readonly options: IRenderOptions;
-
-  constructor(options: IRenderOptions) {
-    this.options = options;
-  }
-
-  attach(_session: IInteractiveSession): void {
-    // TuiTransport creates its own InteractiveSession internally via TuiInteractionChannel.
-  }
-
-  async start(): Promise<void> {
-    await renderApp(this.options);
-  }
-
-  async stop(): Promise<void> {
-    // Ink exits when the user triggers shutdown from within the TUI.
-  }
-
-  validateOptions(_options: Record<string, TUniversalValue>): boolean {
-    return true;
-  }
-}

package/src/tui/types.ts

@@ -1,15 +0,0 @@
-/** UI-layer permission types for the Ink TUI */
-
-import type { TToolArgs } from '@robota-sdk/agent-core';
-
-/**
- * Permission result: true (allow once), false (deny), 'allow-session' (remember for session),
- * or 'allow-project' (persist to .robota/settings.local.json).
- */
-export type TPermissionResult = boolean | 'allow-session' | 'allow-project';
-
-export interface IPermissionRequest {
-  toolName: string;
-  toolArgs: TToolArgs;
-  resolve: (result: TPermissionResult) => void;
-}