Skip to content

Node-based terminal manager for AI coding agents — tmux-backed terminals and parallel agent sessions as draggable nodes on an infinite pan/zoom canvas. macOS, Linux, and a browser Server Edition.

4.4 KB
Raw Blame
/** A partial or transport-uncertain paste must never be retried or represented as submitted. */
export type TextDeliveryResult = boolean | 'pasted-not-submitted'
export const TEXT_NOT_SUBMITTED = 'Text may already be pasted, but submission could not be confirmed. Do not resend it. Inspect the terminal before taking further action.'

/**
 * The ⌘M chat view's send was refused BEFORE anything was written: the agent's own UI owns the
 * keyboard (shared/agents/claude-screen.ts). `dialog` is the dialog's text when one was recognized,
 * `null` when the input box is simply not on screen. The draft is untouched — nothing reached the pane.
 */
export interface ChatPromptBlocked {
  blocked: 'screen'
  dialog: string | null
}
/** What a chat-view send answers: a text delivery, or a refusal before writing. */
export type ChatPromptResult = TextDeliveryResult | ChatPromptBlocked
export const isChatPromptBlocked = (r: ChatPromptResult): r is ChatPromptBlocked =>
  typeof r === 'object' && r !== null && r.blocked === 'screen'

/**
 * Why a write that must land only in an EMPTY composer (`pty.sendToEmptyPrompt` — the context-link
 * and note-link pushes, issue #1144) was not made. Every refusal is decided before a byte is written,
 * except `not-submitted` (typed, but the Enter was withheld) and `failed` (the transport refused).
 * - `unsupported` — no measured reader for this agent's composer, so emptiness cannot be proven.
 * - `draft` — the composer already holds the user's text.
 * - `no-prompt` — a dialog owns the keyboard, or no input box is on screen (a shell, a starting CLI).
 * - `unknown` — the screen could not be read.
 */
export type EmptyPromptRefusal = 'unsupported' | 'draft' | 'no-prompt' | 'unknown' | 'not-submitted' | 'failed'
export type EmptyPromptResult = { sent: true } | { sent: false; reason: EmptyPromptRefusal }

/**
 * Why Esc from the ⌘M chat view (`pty.interruptChat`) did not reach the agent. Every refusal is decided
 * before the Esc is written.
 * - `unsupported` — not an agent whose interrupt and screen we have measured (claude only).
 * - `dialog` — the agent's own dialog owns the keyboard (Esc would cancel it), or no input box is on
 *   screen. `dialog` carries its text when one was recognized.
 * - the rest are `sendPaneKeys`'s: the pane could not be reached or typed into.
 */
export type ChatInterruptRefusal = 'unsupported' | 'dialog' | 'not-connected' | 'unsupported-backend' | 'no-ssh' | 'failed'
/**
 * `restored` is the prompt Claude put back into its own input box when the Esc landed before the
 * reply started, taken back out of it (the box is cleared) so the chat view can put it in its own
 * composer. null when nothing was put back, or when it could not be taken out cleanly.
 */
export type ChatInterruptResult =
  | { sent: true; restored: string | null }
  | { sent: false; reason: ChatInterruptRefusal; dialog?: string | null }

/**
 * Carrying a draft between the ⌘M chat composer and the agent's own input box when the user flips
 * the view (`pty.putChatDraft` / `pty.takeChatDraft`). The draft MOVES: whichever side receives it,
 * the other is emptied, so it is never sent twice. Claude only (its composer is measured).
 * - `unsupported` — not an agent whose composer we can read and type into, or a backend with no
 *   typed path (Zellij, the Windows session host, a native Windows pane).
 * - `unreadable` — the screen could not be read, or shows no input box (a dialog, a shell).
 * - `has-draft` — (put) the input box already holds a draft: the two are not merged.
 * - `empty` — (take) nothing to carry.
 * - `multi-line` / `placeholder` / `not-prompt` — (take) a draft that cannot be read back exactly
 *   (`readClaudeDraftLine`); it stays in the input box.
 * - `unconfirmed` — (put) the text was typed but did not show in the box in time: it may be there.
 * - `not-cleared` — (take) the box did not read empty after clearing it: nothing is handed over.
 * - `failed` — the pane could not be reached or typed into; nothing was changed.
 */
export type ChatDraftCarryRefusal =
  | 'unsupported'
  | 'unreadable'
  | 'has-draft'
  | 'empty'
  | 'multi-line'
  | 'placeholder'
  | 'not-prompt'
  | 'unconfirmed'
  | 'not-cleared'
  | 'failed'
export type ChatDraftPutResult = { put: true } | { put: false; reason: ChatDraftCarryRefusal }
export type ChatDraftTakeResult = { taken: true; text: string } | { taken: false; reason: ChatDraftCarryRefusal }