nastech-tui 0.0.1

package/src/types/nastech-ink.d.ts

@@ -0,0 +1,176 @@
+import type * as React from 'react'
+
+declare module '@nastechai/ink' {
+  export type Key = {
+    readonly ctrl: boolean
+    readonly meta: boolean
+    readonly super: boolean
+    readonly shift: boolean
+    readonly alt: boolean
+    readonly upArrow: boolean
+    readonly downArrow: boolean
+    readonly leftArrow: boolean
+    readonly rightArrow: boolean
+    readonly return: boolean
+    readonly backspace: boolean
+    readonly delete: boolean
+    readonly escape: boolean
+    readonly tab: boolean
+    readonly pageUp: boolean
+    readonly pageDown: boolean
+    readonly wheelUp: boolean
+    readonly wheelDown: boolean
+    readonly home: boolean
+    readonly end: boolean
+    readonly [key: string]: boolean
+  }
+
+  export type InputEvent = {
+    readonly input: string
+    readonly key: Key
+    readonly keypress: { readonly isPasted?: boolean; readonly raw?: string }
+  }
+
+  export type InputHandler = (input: string, key: Key, event: InputEvent) => void
+
+  export type FrameEvent = {
+    readonly durationMs: number
+    readonly phases?: {
+      readonly renderer: number
+      readonly diff: number
+      readonly optimize: number
+      readonly write: number
+      readonly patches: number
+      readonly optimizedPatches: number
+      readonly writeBytes: number
+      readonly backpressure: boolean
+      readonly prevFrameDrainMs: number
+      readonly yoga: number
+      readonly commit: number
+      readonly yogaVisited: number
+      readonly yogaMeasured: number
+      readonly yogaCacheHits: number
+      readonly yogaLive: number
+    }
+    readonly flickers: ReadonlyArray<{
+      readonly desiredHeight: number
+      readonly availableHeight: number
+      readonly reason: 'resize' | 'offscreen' | 'clear'
+    }>
+  }
+
+  export type RenderOptions = {
+    readonly stdin?: NodeJS.ReadStream
+    readonly stdout?: NodeJS.WriteStream
+    readonly stderr?: NodeJS.WriteStream
+    readonly exitOnCtrlC?: boolean
+    readonly patchConsole?: boolean
+    readonly onFrame?: (event: FrameEvent) => void
+    readonly onHyperlinkClick?: (url: string) => void
+  }
+
+  export type Instance = {
+    readonly rerender: (node: React.ReactNode) => void
+    readonly unmount: () => void
+    readonly waitUntilExit: () => Promise<void>
+    readonly cleanup: () => void
+  }
+
+  export type ScrollBoxHandle = {
+    readonly scrollTo: (y: number) => void
+    readonly scrollBy: (dy: number) => void
+    readonly scrollToElement: (el: unknown, offset?: number) => void
+    readonly scrollToBottom: () => void
+    readonly getScrollTop: () => number
+    readonly getPendingDelta: () => number
+    readonly getScrollHeight: () => number
+    readonly getFreshScrollHeight: () => number
+    readonly getViewportHeight: () => number
+    readonly getViewportTop: () => number
+    readonly getLastManualScrollAt: () => number
+    readonly isSticky: () => boolean
+    readonly subscribe: (listener: () => void) => () => void
+    readonly setClampBounds: (min: number | undefined, max: number | undefined) => void
+  }
+
+  export const Box: React.ComponentType<any>
+  export const AlternateScreen: React.ComponentType<any>
+  export const Ansi: React.ComponentType<any>
+  export const Link: React.ComponentType<{
+    readonly children?: React.ReactNode
+    readonly fallback?: React.ReactNode
+    readonly url: string
+  }>
+  export const NoSelect: React.ComponentType<any>
+  export const ScrollBox: React.ComponentType<any>
+  export const Text: React.ComponentType<any>
+  export const TextInput: React.ComponentType<any>
+  export const stringWidth: (s: string) => number
+  export function isXtermJs(): boolean
+
+  export type ScrollFastPathStats = {
+    captured: number
+    taken: number
+    declined: {
+      noPrevScreen: number
+      heightDeltaMismatch: number
+      other: number
+    }
+    lastDeclineReason?: string
+    lastHeightDelta?: number
+    lastHintDelta?: number
+    lastScrollHeight?: number
+    lastPrevHeight?: number
+  }
+  export const scrollFastPathStats: ScrollFastPathStats
+
+  export type EvictLevel = 'all' | 'half'
+  export type InkCacheSizes = {
+    readonly lineWidth: number
+    readonly slice: number
+    readonly width: number
+    readonly wrap: number
+  }
+  export function evictInkCaches(level?: EvictLevel): InkCacheSizes
+
+  export function forceRedraw(stdout?: NodeJS.WriteStream): boolean
+  export function render(node: React.ReactNode, options?: NodeJS.WriteStream | RenderOptions): Instance
+
+  export function useApp(): { readonly exit: (error?: Error) => void }
+  export type RunExternalProcess = () => Promise<void>
+  export function useExternalProcess(): (run: RunExternalProcess) => Promise<void>
+  export function withInkSuspended(run: RunExternalProcess): Promise<void>
+  export function useInput(handler: InputHandler, options?: { readonly isActive?: boolean }): void
+  export function useSelection(): {
+    readonly copySelection: () => Promise<string>
+    readonly copySelectionNoClear: () => Promise<string>
+    readonly clearSelection: () => void
+    readonly hasSelection: () => boolean
+    readonly getState: () => unknown
+    readonly version: () => number
+    readonly subscribe: (cb: () => void) => () => void
+    readonly shiftAnchor: (dRow: number, minRow: number, maxRow: number) => void
+    readonly shiftSelection: (dRow: number, minRow: number, maxRow: number) => void
+    readonly moveFocus: (move: unknown) => void
+    readonly captureScrolledRows: (firstRow: number, lastRow: number, side: 'above' | 'below') => void
+    readonly setSelectionBgColor: (color: string) => void
+  }
+  export function useHasSelection(): boolean
+  export function useStdout(): { readonly stdout?: NodeJS.WriteStream }
+  export function useTerminalFocus(): boolean
+  export function useTerminalTitle(title: string | null): void
+  export function useDeclaredCursor(args: {
+    readonly line: number
+    readonly column: number
+    readonly active: boolean
+  }): (el: unknown) => void
+  export function useCursorAdvance(): (dx: number, dy?: number) => void
+  export function useStdin(): {
+    readonly stdin: NodeJS.ReadStream
+    readonly setRawMode: (value: boolean) => void
+    readonly isRawModeSupported: boolean
+    readonly exitOnCtrlC: boolean
+    readonly inputEmitter: NodeJS.EventEmitter
+    readonly querier: unknown
+  }
+}

package/src/types.ts

@@ -0,0 +1,212 @@
+export interface ActiveTool {
+  context?: string
+  id: string
+  name: string
+  verboseArgs?: string
+  startedAt?: number
+}
+
+export interface TodoItem {
+  content: string
+  id: string
+  status: 'cancelled' | 'completed' | 'in_progress' | 'pending'
+}
+
+export interface ActivityItem {
+  id: number
+  text: string
+  tone: 'error' | 'info' | 'warn'
+}
+
+export type SubagentStatus = 'completed' | 'error' | 'failed' | 'interrupted' | 'queued' | 'running' | 'timeout'
+
+export interface SubagentProgress {
+  apiCalls?: number
+  costUsd?: number
+  depth: number
+  durationSeconds?: number
+  filesRead?: string[]
+  filesWritten?: string[]
+  goal: string
+  id: string
+  index: number
+  inputTokens?: number
+  iteration?: number
+  model?: string
+  notes: string[]
+  outputTail?: SubagentOutputEntry[]
+  outputTokens?: number
+  parentId: null | string
+  reasoningTokens?: number
+  startedAt?: number
+  status: SubagentStatus
+  summary?: string
+  taskCount: number
+  thinking: string[]
+  toolCount: number
+  tools: string[]
+  toolsets?: string[]
+}
+
+export interface SubagentOutputEntry {
+  isError: boolean
+  preview: string
+  tool: string
+}
+
+export interface SubagentNode {
+  aggregate: SubagentAggregate
+  children: SubagentNode[]
+  item: SubagentProgress
+}
+
+export interface SubagentAggregate {
+  activeCount: number
+  costUsd: number
+  descendantCount: number
+  filesTouched: number
+  hotness: number
+  inputTokens: number
+  maxDepthFromHere: number
+  outputTokens: number
+  totalDuration: number
+  totalTools: number
+}
+
+export interface DelegationStatus {
+  active: {
+    depth?: number
+    goal?: string
+    model?: null | string
+    parent_id?: null | string
+    started_at?: number
+    status?: string
+    subagent_id?: string
+    tool_count?: number
+  }[]
+  max_concurrent_children?: number
+  max_spawn_depth?: number
+  paused: boolean
+}
+
+export interface ApprovalReq {
+  command: string
+  description: string
+}
+
+export interface ConfirmReq {
+  cancelLabel?: string
+  confirmLabel?: string
+  danger?: boolean
+  detail?: string
+  onConfirm: () => void
+  title: string
+}
+
+export interface ClarifyReq {
+  choices: string[] | null
+  question: string
+  requestId: string
+}
+
+export interface Msg {
+  info?: SessionInfo
+  kind?: 'diff' | 'intro' | 'panel' | 'slash' | 'trail'
+  panelData?: PanelData
+  role: Role
+  text: string
+  thinking?: string
+  thinkingTokens?: number
+  toolTokens?: number
+  tools?: string[]
+  todos?: TodoItem[]
+  todoIncomplete?: boolean
+  todoCollapsedByDefault?: boolean
+}
+
+export type Role = 'assistant' | 'system' | 'tool' | 'user'
+export type DetailsMode = 'hidden' | 'collapsed' | 'expanded'
+export type ThinkingMode = 'collapsed' | 'truncated' | 'full'
+
+// Per-section overrides for the agent details accordion.  Resolution order
+// at lookup time is: explicit `display.sections.<name>` → built-in
+// SECTION_DEFAULTS → global `details_mode`.  Today the built-in defaults
+// expand `thinking`/`tools` and hide `activity`; `subagents` falls through
+// to the global mode.  Any explicit value still wins for that one section.
+export type SectionName = 'thinking' | 'tools' | 'subagents' | 'activity'
+export type SectionVisibility = Partial<Record<SectionName, DetailsMode>>
+
+export interface McpServerStatus {
+  connected: boolean
+  name: string
+  tools: number
+  transport: string
+}
+
+export interface SessionInfo {
+  cwd?: string
+  fast?: boolean
+  lazy?: boolean
+  mcp_servers?: McpServerStatus[]
+  model: string
+  profile_name?: string
+  reasoning_effort?: string
+  release_date?: string
+  service_tier?: string
+  skills: Record<string, string[]>
+  system_prompt?: string
+  tools: Record<string, string[]>
+  update_behind?: number | null
+  update_command?: string
+  usage?: Usage
+  version?: string
+}
+
+export interface Usage {
+  calls: number
+  compressions?: number
+  context_max?: number
+  context_percent?: number
+  context_used?: number
+  cost_status?: string
+  cost_usd?: number
+  input: number
+  output: number
+  reasoning?: number
+  total: number
+}
+
+export interface SudoReq {
+  requestId: string
+}
+
+export interface SecretReq {
+  envVar: string
+  prompt: string
+  requestId: string
+}
+
+export interface PanelData {
+  sections: PanelSection[]
+  title: string
+}
+
+export interface PanelSection {
+  items?: string[]
+  rows?: [string, string][]
+  text?: string
+  title?: string
+}
+
+export interface SlashCatalog {
+  canon: Record<string, string>
+  categories: SlashCategory[]
+  pairs: [string, string][]
+  skillCount: number
+  sub: Record<string, string[]>
+}
+
+export interface SlashCategory {
+  name: string
+  pairs: [string, string][]
+}

package/tsconfig.build.json

@@ -0,0 +1,9 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@nastechai/ink": ["src/types/nastech-ink.d.ts"]
+    }
+  }
+}

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "nodenext",
+    "moduleResolution": "nodenext",
+    "jsx": "react-jsx",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": false,
+    "sourceMap": false,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*.d.ts", "src/**/*.ts", "src/**/*.tsx"],
+  "exclude": ["src/__tests__", "node_modules", "dist"]
+}

package/vitest.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    exclude: ['dist/**', 'node_modules/**']
+  }
+})