@ebowwa/coder 0.7.64 → 0.7.66

package/packages/src/interfaces/ui/terminal/cli/interactive/message-store.ts

@@ -0,0 +1,299 @@
+/**
+ * Message Store - Non-React Implementation
+ *
+ * Centralized message state management extracted from v1 TUI patterns.
+ * This is a pure TypeScript class without React dependency.
+ *
+ * Features:
+ * - Single source of truth for messages
+ * - Separate UI and API message tracking
+ * - Token count management
+ * - Change notification system
+ */
+
+import type { Message as ApiMessage } from "../../../../../types/index.js";
+import type { MessageStore, UIMessage, MessageSubType } from "./types.js";
+
+// ============================================
+// UTILITIES
+// ============================================
+
+let globalMessageId = 0;
+
+function generateId(): string {
+  globalMessageId += 1;
+  return `msg-${globalMessageId}-${Date.now()}`;
+}
+
+/**
+ * Extract text content from API message content blocks
+ */
+function extractTextContent(content: ApiMessage["content"]): string {
+  if (typeof content === "string") {
+    return content;
+  }
+
+  return content.map((block) => {
+    switch (block.type) {
+      case "text":
+        return block.text;
+      case "tool_use":
+        return `[Tool: ${block.name}]\n${JSON.stringify(block.input, null, 2)}`;
+      case "tool_result": {
+        const resultContent = typeof block.content === "string"
+          ? block.content
+          : extractTextContent(block.content);
+        const prefix = block.is_error ? "[Tool Error]" : "[Tool Result]";
+        const truncated = resultContent.length > 500
+          ? resultContent.slice(0, 500) + "..."
+          : resultContent;
+        return `${prefix}\n${truncated}`;
+      }
+      case "thinking":
+        return `[Thinking]\n${block.thinking}`;
+      case "redacted_thinking":
+        return "[Redacted Thinking]";
+      case "image":
+        return "[Image]";
+      default:
+        return "";
+    }
+  }).join("\n\n");
+}
+
+/**
+ * Convert API message to UI message
+ */
+function apiToUi(msg: ApiMessage): UIMessage | null {
+  const content = extractTextContent(msg.content);
+  if (!content) return null;
+
+  return {
+    id: generateId(),
+    role: msg.role,
+    content,
+    timestamp: Date.now(),
+  };
+}
+
+/**
+ * Estimate token count from text (rough: ~4 chars per token)
+ */
+function estimateTokens(text: string): number {
+  if (!text) return 0;
+  return Math.ceil(text.length / 4);
+}
+
+/**
+ * Estimate total tokens from messages
+ */
+function estimateMessagesTokens(messages: ApiMessage[]): number {
+  let total = 0;
+  for (const msg of messages) {
+    if (typeof msg.content === "string") {
+      total += estimateTokens(msg.content);
+    } else if (Array.isArray(msg.content)) {
+      for (const block of msg.content) {
+        if (block.type === "text") {
+          total += estimateTokens(block.text);
+        } else if (block.type === "tool_use") {
+          total += estimateTokens(JSON.stringify(block.input));
+        } else if (block.type === "tool_result") {
+          if (typeof block.content === "string") {
+            total += estimateTokens(block.content);
+          }
+        }
+      }
+    }
+  }
+  return total;
+}
+
+// ============================================
+// MESSAGE STORE CLASS
+// ============================================
+
+/**
+ * Non-React message store implementation
+ *
+ * Usage:
+ * ```ts
+ * const store = new MessageStoreImpl();
+ * store.addMessage({ role: "user", content: "Hello" });
+ * console.log(store.messages);
+ * ```
+ */
+export class MessageStoreImpl implements MessageStore {
+  private _messages: UIMessage[] = [];
+  private _apiMessages: ApiMessage[] = [];
+  private _tokenCount = 0;
+  private _listeners: Set<() => void> = new Set();
+  private _pendingUserMessages: Set<string> = new Set();
+
+  /** UI messages for display */
+  get messages(): UIMessage[] {
+    return [...this._messages];
+  }
+
+  /** API messages for context */
+  get apiMessages(): ApiMessage[] {
+    return [...this._apiMessages];
+  }
+
+  /** Current token count */
+  get tokenCount(): number {
+    return this._tokenCount;
+  }
+
+  /** Update token count */
+  setTokenCount(count: number): void {
+    this._tokenCount = count;
+    this._notify();
+  }
+
+  /**
+   * Add a UI message
+   * Returns the message ID
+   */
+  addMessage(msg: Omit<UIMessage, "id" | "timestamp">): string {
+    const id = generateId();
+    const fullMsg: UIMessage = {
+      ...msg,
+      id,
+      timestamp: Date.now(),
+    };
+    this._messages = [...this._messages, fullMsg];
+
+    // Track user messages added manually (to skip in addApiMessages)
+    if (msg.role === "user") {
+      this._pendingUserMessages.add(msg.content);
+    }
+
+    this._notify();
+    return id;
+  }
+
+  /**
+   * Add multiple messages from API response
+   */
+  addApiMessages(msgs: ApiMessage[]): void {
+    if (msgs.length === 0) return;
+
+    // Update API messages
+    this._apiMessages = [...this._apiMessages, ...msgs];
+
+    // Convert to UI messages, skipping user messages already added manually
+    const newUiMsgs = msgs
+      .map(apiToUi)
+      .filter((m): m is UIMessage => m !== null)
+      .filter((m) => {
+        if (m.role === "user" && this._pendingUserMessages.has(m.content)) {
+          this._pendingUserMessages.delete(m.content);
+          return false;
+        }
+        return true;
+      });
+
+    if (newUiMsgs.length > 0) {
+      this._messages = [...this._messages, ...newUiMsgs];
+    }
+
+    // Update token estimate
+    this._tokenCount = estimateMessagesTokens(this._apiMessages);
+
+    this._notify();
+  }
+
+  /**
+   * Add system message (convenience method)
+   */
+  addSystem(
+    content: string,
+    subType?: MessageSubType,
+    toolName?: string,
+    isError?: boolean
+  ): string {
+    return this.addMessage({
+      role: "system",
+      content,
+      subType,
+      toolName,
+      isError,
+    });
+  }
+
+  /**
+   * Clear all messages
+   */
+  clear(): void {
+    this._messages = [];
+    this._apiMessages = [];
+    this._pendingUserMessages.clear();
+    this._tokenCount = 0;
+    this._notify();
+  }
+
+  /**
+   * Replace all messages (for undo/redo)
+   */
+  replace(ui: UIMessage[], api: ApiMessage[]): void {
+    this._messages = [...ui];
+    this._apiMessages = [...api];
+    this._pendingUserMessages.clear();
+    this._tokenCount = estimateMessagesTokens(this._apiMessages);
+    this._notify();
+  }
+
+  /**
+   * Subscribe to store changes
+   * Returns unsubscribe function
+   */
+  subscribe(listener: () => void): () => void {
+    this._listeners.add(listener);
+    return () => {
+      this._listeners.delete(listener);
+    };
+  }
+
+  /**
+   * Notify all listeners of a change
+   */
+  private _notify(): void {
+    for (const listener of this._listeners) {
+      try {
+        listener();
+      } catch (err) {
+        console.error("MessageStore listener error:", err);
+      }
+    }
+  }
+}
+
+// ============================================
+// SINGLETON (optional convenience)
+// ============================================
+
+let globalStore: MessageStoreImpl | null = null;
+
+/**
+ * Get or create the global message store
+ */
+export function getMessageStore(): MessageStoreImpl {
+  if (!globalStore) {
+    globalStore = new MessageStoreImpl();
+  }
+  return globalStore;
+}
+
+/**
+ * Reset the global message store (for testing)
+ */
+export function resetMessageStore(): void {
+  globalStore = null;
+}
+
+// ============================================
+// EXPORTS
+// ============================================
+
+export type { MessageStore, UIMessage, MessageSubType } from "./types.js";

package/packages/src/interfaces/ui/terminal/cli/interactive/types.ts

@@ -0,0 +1,274 @@
+/**
+ * CLI Interactive Types
+ * Type definitions for the non-React interactive mode
+ *
+ * Extracted from v1 TUI patterns without Ink dependency
+ */
+
+import type { PermissionMode, ClaudeModel, Message as ApiMessage, ToolDefinition } from "../../../../../types/index.js";
+import type { HookManager } from "../../../../../ecosystem/hooks/index.js";
+import type { LoadedSession, SessionSummary } from "../../../../../core/sessions/types.js";
+import type { TeammateModeRunner } from "../../../../../teammates/runner.js";
+
+// ============================================
+// MESSAGE TYPES
+// ============================================
+
+/**
+ * Message sub-type for granular categorization
+ */
+export type MessageSubType =
+  | "tool_call"
+  | "tool_result"
+  | "hook"
+  | "info"
+  | "error"
+  | "thinking";
+
+/**
+ * UI-specific message representation
+ */
+export interface UIMessage {
+  id: string;
+  role: "user" | "assistant" | "system";
+  content: string;
+  timestamp: number;
+  subType?: MessageSubType;
+  toolName?: string;
+  isError?: boolean;
+}
+
+// ============================================
+// MESSAGE STORE TYPES
+// ============================================
+
+/**
+ * Message store interface for non-React usage
+ */
+export interface MessageStore {
+  /** UI messages for display */
+  messages: UIMessage[];
+  /** API messages for context */
+  apiMessages: ApiMessage[];
+  /** Add a UI message */
+  addMessage(msg: Omit<UIMessage, "id" | "timestamp">): string;
+  /** Add multiple messages from API response */
+  addApiMessages(msgs: ApiMessage[]): void;
+  /** Add system message (convenience) */
+  addSystem(content: string, subType?: MessageSubType, toolName?: string, isError?: boolean): string;
+  /** Clear all messages */
+  clear(): void;
+  /** Replace messages (for undo/redo) */
+  replace(ui: UIMessage[], api: ApiMessage[]): void;
+  /** Total token count */
+  tokenCount: number;
+  /** Update token count */
+  setTokenCount(count: number): void;
+  /** Subscribe to store changes */
+  subscribe(listener: () => void): () => void;
+}
+
+// ============================================
+// INPUT HANDLER TYPES
+// ============================================
+
+/**
+ * Native key event representation for input handling
+ *
+ * This is the TypeScript interface used by input handlers.
+ * It's converted from the native module's InputEvent format.
+ */
+export interface NativeKeyEvent {
+  /** Key code or character */
+  code: string;
+  /** Whether this is a special/control key */
+  is_special: boolean;
+  /** Ctrl modifier state */
+  ctrl: boolean;
+  /** Alt modifier state */
+  alt: boolean;
+  /** Shift modifier state */
+  shift: boolean;
+  /** Key event kind */
+  kind: "press" | "release" | "repeat";
+}
+
+/**
+ * Input handler function type
+ */
+export type InputHandler = (event: NativeKeyEvent) => boolean;
+
+/**
+ * Input handler registration options
+ */
+export interface InputHandlerOptions {
+  /** Unique ID for this handler */
+  id: string;
+  /** Priority (higher = receives input first) */
+  priority?: number;
+  /** Handler function - return true to consume, false to pass through */
+  handler: InputHandler;
+  /** Whether this handler is currently active */
+  isActive?: boolean;
+}
+
+/**
+ * Input manager interface for non-React usage
+ */
+export interface InputManager {
+  /** Register an input handler */
+  register(options: InputHandlerOptions): () => void;
+  /** Set focus to a specific handler */
+  focus(handlerId: string): void;
+  /** Get currently focused handler ID */
+  focusedId: string | null;
+  /** Dispatch a key event to handlers */
+  dispatch(event: NativeKeyEvent): boolean;
+  /** Whether input is currently blocked */
+  isBlocked: boolean;
+  /** Block/unblock input (for loading states) */
+  setBlocked(blocked: boolean): void;
+}
+
+// ============================================
+// INTERACTIVE RUNNER TYPES
+// ============================================
+
+/**
+ * Props for the interactive runner
+ */
+export interface InteractiveRunnerProps {
+  apiKey: string;
+  model: ClaudeModel;
+  permissionMode: PermissionMode;
+  maxTokens: number;
+  systemPrompt: string;
+  tools: ToolDefinition[];
+  hookManager: HookManager;
+  sessionStore: SessionStore;
+  sessionId: string;
+  setSessionId: (id: string) => void;
+  initialMessages: ApiMessage[];
+  workingDirectory: string;
+  teammateRunner?: TeammateModeRunner | null;
+  onExit?: () => Promise<void> | void;
+}
+
+/**
+ * Session store interface (subset used by interactive mode)
+ */
+export interface SessionStore {
+  saveMessage(message: ApiMessage): Promise<void>;
+  saveMetrics(metrics: unknown): Promise<void>;
+  exportSession(sessionId: string, format: "jsonl" | "json" | "markdown"): Promise<string>;
+  listSessions(limit?: number): Promise<SessionSummary[]>;
+  resumeSession(sessionId: string): Promise<LoadedSession | null>;
+  createSession(options: {
+    model: string;
+    workingDirectory: string;
+    agentName?: string;
+    agentColor?: string;
+    teamName?: string;
+  }): Promise<string>;
+}
+
+/**
+ * Session info for listing
+ */
+export interface SessionInfo {
+  id: string;
+  messageCount: number;
+  lastActivity?: number;
+  metadata?: Record<string, unknown>;
+}
+
+/**
+ * Interactive runner state
+ */
+export interface InteractiveState {
+  isLoading: boolean;
+  inputValue: string;
+  cursorPos: number;
+  scrollOffset: number;
+  totalCost: number;
+  spinnerFrame: string;
+  streamingText: string;
+  inputHistory: string[];
+  historyIndex: number;
+  sessionSelectMode: boolean;
+  selectableSessions: SessionInfo[];
+  helpMode: boolean;
+  helpSection: number;
+}
+
+// ============================================
+// COMMAND TYPES
+// ============================================
+
+/**
+ * Command handler context
+ */
+export interface CommandContext {
+  sessionId: string;
+  setSessionId: (id: string) => void;
+  model: ClaudeModel;
+  setModel: (model: ClaudeModel) => void;
+  messageStore: MessageStore;
+  totalCost: number;
+  setTotalCost: (cost: number) => void;
+  permissionMode: PermissionMode;
+  tools: ToolDefinition[];
+  workingDirectory: string;
+  sessionStore: SessionStore;
+  messagesLength: number;
+  onExit: () => void;
+  exit: () => void;
+  state: InteractiveState;
+  setState: (state: Partial<InteractiveState>) => void;
+}
+
+// ============================================
+// CONTEXT INFO TYPES
+// ============================================
+
+/**
+ * Context info from status-line calculations
+ */
+export interface ContextInfo {
+  percentRemaining: number;
+  isLow: boolean;
+  isCritical: boolean;
+}
+
+// ============================================
+// PRIORITY CONSTANTS
+// ============================================
+
+/**
+ * Input priority levels
+ */
+export const InputPriority = {
+  /** Normal components */
+  DEFAULT: 0,
+  /** Focused input fields */
+  INPUT: 10,
+  /** Selectable lists */
+  LIST: 20,
+  /** Modal dialogs */
+  MODAL: 100,
+  /** System-level (Ctrl+C, etc.) */
+  SYSTEM: 1000,
+} as const;
+
+// ============================================
+// RE-EXPORTS
+// ============================================
+
+export type {
+  PermissionMode,
+  ClaudeModel,
+  Message as ApiMessage,
+  ToolDefinition,
+} from "../../../../../types/index.js";
+export type { HookManager } from "../../../../../ecosystem/hooks/index.js";
+export type { SkillManager } from "../../../../../ecosystem/skills/index.js";

package/packages/src/interfaces/ui/terminal/shared/index.ts

@@ -69,3 +69,16 @@ export {
   type StatusLineOptions,
   type ContextInfo,
 } from "./status-line.js";
+
+// Spinner Frames
+export {
+  spinnerFrames,
+  dotSpinnerFrames,
+  asciiSpinnerFrames,
+  arrowSpinnerFrames,
+  simpleDotFrames,
+  toolSpinnerFrames,
+  nextFrame,
+  createSpinnerIterator,
+  getFrame,
+} from "./spinner-frames.js";

package/packages/src/interfaces/ui/terminal/shared/query.ts

@@ -30,6 +30,8 @@ export interface QueryOptions {
   hookManager: HookManager;
   workingDirectory: string;
   gitStatus?: GitStatus | null;
+  /** Resolved permission mode (from config, may differ from args.permissionMode) */
+  permissionMode?: import("../../../../types/index.js").PermissionMode;
 }
 
 // ============================================
@@ -48,11 +50,15 @@ export async function runSingleQuery(options: QueryOptions): Promise<void> {
     hookManager,
     workingDirectory,
     gitStatus,
+    permissionMode: resolvedPermissionMode,
   } = options;
 
+  // Use resolved permission mode from config if provided, otherwise fall back to args
+  const permissionMode = resolvedPermissionMode ?? args.permissionMode;
+
   // Show initial status line
   const initialStatusOptions: StatusLineOptions = {
-    permissionMode: args.permissionMode,
+    permissionMode,
     tokensUsed: 0,
     maxTokens: getContextWindow(args.model),
     model: args.model,
@@ -92,7 +98,7 @@ export async function runSingleQuery(options: QueryOptions): Promise<void> {
       maxTokens: args.maxTokens,
       systemPrompt,
       tools,
-      permissionMode: args.permissionMode,
+      permissionMode,  // Use resolved permission mode
       workingDirectory,
       gitStatus: gitStatus ?? undefined,
       extendedThinking: extendedThinkingConfig,
@@ -129,7 +135,7 @@ export async function runSingleQuery(options: QueryOptions): Promise<void> {
 
     // Show final status line
     const finalStatusOptions: StatusLineOptions = {
-      permissionMode: args.permissionMode,
+      permissionMode,
       tokensUsed: totalTokens,
       maxTokens: getContextWindow(args.model),
       model: args.model,

package/packages/src/interfaces/ui/terminal/shared/setup.ts

@@ -45,6 +45,8 @@ export interface SetupOptions {
   apiKey: string;
   workingDirectory: string;
   onProgress?: (message: string) => void;
+  /** When true, disable console logging for security hooks (prevents TUI corruption) */
+  isTuiMode?: boolean;
 }
 
 // ============================================
@@ -196,14 +198,16 @@ export async function setupSession(options: SetupOptions): Promise<SessionSetup>
 
   // Register cognitive security hooks (in-process handlers)
   // When bypassPermissions is set, disable all security checks
+  // In TUI mode, disable console logging to prevent corrupting the display
   const isBypassMode = permissionMode === "bypassPermissions";
+  const isTuiMode = options.isTuiMode ?? false;
   const securityHandlers = createSecurityHookHandlers({
     enabled: !isBypassMode, // Disable entirely in bypass mode
     checkIntentAlignment: !isBypassMode,
     enforceFlowPolicies: !isBypassMode,
     preventLeaks: !isBypassMode,
     trackTaints: !isBypassMode,
-    logEvents: true, // Always log for audit trail
+    logEvents: !isTuiMode, // Disable console logging in TUI mode to prevent display corruption
     blockOnViolation: false, // Never block - log only
     minAlignmentScore: 0.3,
     approvalRequiredSensitivities: ["secret", "top_secret"],