mirror of
https://github.com/stablyai/orca.git
synced 2026-11-19 04:23:57 +00:00
* Separate editor tab placement from content ownership * Show scoped Source Control sections for attached worktrees * Preserve active diff refresh and validate section catalogs * Complete folder section test worktree metadata * Use contextual types for scoped Source Control actions * Preserve optional scoped action parameters * Preserve editor ownership through restore, mirroring and workspace removal * Retire Source Control drafts only after confirmed owner removal * Limit section work to visible expanded repositories * Keep editor follow-up actions and bulk closes in their invoking views * Track the consolidated editor order writer in its owning module * Use complete typed fixtures for repair contracts * Preserve live editor placement during layout readback * Pass projected editor placement directly to serialization * Read attached worktree lineage from shared graph module * Retain inferred owner checks and scope placement retirement * Preserve selection in untouched workspaces during purge * Exercise editor placements in existing launch and lifecycle fixtures * Preserve shared buffer prompts and editor strip order * Pause inactive section context subscriptions * Keep section recovery and file actions in the folder workspace * Describe attached Source Control in folder workspace CLI help * Attribute Git metadata signals once per dispatch * Watch mounted source control sections outside the warm budget * Resolve section watches only for served filesystem roots * Restore restart-stable editor identity across SSH opens * Apply section terminal routing to explicit Chat choices * Include cross-store descendants in folder workspace panels * Keep cross-host recovery on its existing workspace route * Start cross-host section agents in their workspace without navigation * Update memoized Source Control labels on language changes * Remove unused terminal close-to-right implementation * Suspend inactive Source Control body observers * Retain base ref query while section observation pauses * Cover retained base ref search across section visibility * Resolve note menu ownership from the retained snapshot * Preserve section agent working directories and background placement * Keep Source Control sections active while their overlays are open * Read current settings when Source Control commands execute * Adapt editor and browser test stores to view subscriptions * Preserve bound store hooks for ordinary app views * Trust agent starts outside the placement workspace * Trust the section worktree through transient launch ownership * Extract editor follow-up file actions from the panel * Fail section launches when trust capability lookup fails Preserve explicit unsupported-host fallback, propagate lookup failures to the existing launch error path, and let the existing transport retry refresh rejected capability probes. * Follow the moved pane launch test in web configs * Preserve section file ownership during refresh and close * Share tab order removal across editor close paths * Verify companion editor close through the real store * Close all workspace split copies for legacy mobile file requests * Keep unmatched mobile close requests within their workspace * Reuse the agent menu render snapshot * Keep attached folder roots scoped to their resolved host * Apply repository trust decisions to the launch trust owner
352 lines
11 KiB
TypeScript
352 lines
11 KiB
TypeScript
import type { TerminalLaunchResult } from './agent-session/lifecycle/agent-session-resume'
|
||
import type * as AgentSessionResume from './agent-session/lifecycle/agent-session-resume'
|
||
import type { StartupCommandDelivery } from './agent-launch/startup/codex-startup-delivery'
|
||
import type { ExecutionHostId } from './execution-host'
|
||
import type { PtyIncarnationId } from './terminal/pty/lifecycle/pty-incarnation'
|
||
import type { PtyLivenessVerdict } from './terminal/pty/lifecycle/pty-liveness-verdict'
|
||
import type { RuntimeListingHostScope } from './runtime-listing-host-scope'
|
||
import type { RuntimeMobileSessionTabsResult } from './runtime-session-contracts'
|
||
import type { TabGroupLayoutNode } from './tab-types'
|
||
import type { TerminalExitCause } from './terminal/pty/lifecycle/terminal-exit-cause'
|
||
import type { TerminalPaneLayoutNode } from './workspace-layout/terminal-tab-types'
|
||
import type { TerminalAgent } from './agent-status/identity/terminal-agent'
|
||
import type { TuiAgent } from './agent-launch/catalog/tui-agent'
|
||
export type {
|
||
RuntimeTerminalSend,
|
||
RuntimeTerminalPromptStage,
|
||
RuntimeTerminalPromptDelivery
|
||
} from './runtime-terminal-send-contract'
|
||
|
||
export type RuntimeTerminalSummary = {
|
||
handle: string
|
||
ptyId: string | null
|
||
incarnationId?: string | null
|
||
orphaned?: boolean
|
||
/** Orphaned PTY’s last recorded pane may survive in its owning renderer despite graph omission; absent if unknown/old host. */
|
||
recordedPaneKey?: string
|
||
worktreeId: string
|
||
worktreePath: string
|
||
branch: string
|
||
tabId: string
|
||
leafId: string
|
||
title: string | null
|
||
/** A user's name for this pane from the host's saved layout; absent when unset or the host predates it. */
|
||
paneTitle?: string
|
||
connected: boolean
|
||
writable: boolean
|
||
lastOutputAt: number | null
|
||
preview: string
|
||
/** Host-resolved observed agent identity; absent when unknown. Does not imply launch support. */
|
||
agentIdentity?: TerminalAgent
|
||
/** Absent while running or when the host predates the field; never infer a clean finish. */
|
||
exitCause?: TerminalExitCause
|
||
/** Absent when the host predates the field or could not name the execution host. */
|
||
executionHostId?: ExecutionHostId
|
||
/** Read verdict for host liveness: legacy connected can stay true while unreachable. Absent on older hosts. */
|
||
verdict?: PtyLivenessVerdict['status']
|
||
/** Only when the caller asked for it; absent on older hosts. */
|
||
attention?: RuntimeTerminalAttention
|
||
}
|
||
|
||
/** Use of a PTY that its host's own window can't see: a remote client showing it, or input from anywhere. */
|
||
export type RuntimeTerminalAttention = {
|
||
/** A paired client or phone is displaying it. Clients too old to report hidden panes never count. */
|
||
shownRemotely: boolean
|
||
/** Last user input from any client; null if none reached its current process. */
|
||
lastInputAt: number | null
|
||
}
|
||
|
||
export type RuntimeTerminalVisualTerminalNode = {
|
||
type: 'terminal'
|
||
handle: string
|
||
tabId: string
|
||
leafId: string
|
||
title: string | null
|
||
connected: boolean
|
||
active: boolean
|
||
}
|
||
|
||
export type RuntimeTerminalVisualPaneNode =
|
||
| RuntimeTerminalVisualTerminalNode
|
||
| {
|
||
type: 'pane-split'
|
||
direction: Extract<TerminalPaneLayoutNode, { type: 'split' }>['direction']
|
||
first: RuntimeTerminalVisualPaneNode
|
||
second: RuntimeTerminalVisualPaneNode
|
||
}
|
||
|
||
export type RuntimeTerminalVisualTab = {
|
||
tabId: string
|
||
title: string | null
|
||
activeLeafId: string | null
|
||
panes: RuntimeTerminalVisualPaneNode
|
||
}
|
||
|
||
export type RuntimeTerminalVisualGroupNode = {
|
||
type: 'group'
|
||
groupId: string | null
|
||
activeTabId: string | null
|
||
tabs: RuntimeTerminalVisualTab[]
|
||
}
|
||
|
||
export type RuntimeTerminalVisualLayoutNode =
|
||
| RuntimeTerminalVisualGroupNode
|
||
| {
|
||
type: 'split'
|
||
direction: Extract<TabGroupLayoutNode, { type: 'split' }>['direction']
|
||
first: RuntimeTerminalVisualLayoutNode
|
||
second: RuntimeTerminalVisualLayoutNode
|
||
}
|
||
|
||
export type RuntimeTerminalVisualLayout = {
|
||
worktreeId: string
|
||
worktreePath: string
|
||
root: RuntimeTerminalVisualLayoutNode
|
||
}
|
||
|
||
/** The shared listing-scope shape, kept under its incumbent name for existing consumers. */
|
||
export type RuntimeTerminalListHostScope = RuntimeListingHostScope
|
||
|
||
export type RuntimeTerminalListResult = {
|
||
terminals: RuntimeTerminalSummary[]
|
||
visualLayouts?: RuntimeTerminalVisualLayout[]
|
||
topologyRevisions?: Record<string, number>
|
||
totalCount: number
|
||
truncated: boolean
|
||
/** Absent from hosts that predate the field; treat that scope as unverifiable. */
|
||
hostScope?: RuntimeTerminalListHostScope
|
||
}
|
||
|
||
export type RuntimeTerminalOrphanAdoptionClaim = {
|
||
terminal: string
|
||
ptyId: string
|
||
incarnationId: PtyIncarnationId
|
||
tabId: string
|
||
leafId: string
|
||
}
|
||
|
||
export type RuntimeTerminalOrphanTopologyTab = {
|
||
tabId: string
|
||
root: TerminalPaneLayoutNode
|
||
activeLeafId: string
|
||
expandedLeafId: string | null
|
||
}
|
||
|
||
export type RuntimeTerminalOrphanTopologyGroup = {
|
||
id: string
|
||
activeTabId: string
|
||
tabOrder: string[]
|
||
recentTabIds?: string[]
|
||
}
|
||
|
||
export type RuntimeTerminalOrphanTopology = {
|
||
tabs: RuntimeTerminalOrphanTopologyTab[]
|
||
groups: RuntimeTerminalOrphanTopologyGroup[]
|
||
groupLayout?: TabGroupLayoutNode
|
||
}
|
||
|
||
export type RuntimeTerminalOrphanAdoptionRequest = {
|
||
worktree: string
|
||
expectedTopologyRevision: number
|
||
claims: RuntimeTerminalOrphanAdoptionClaim[]
|
||
activeTabId?: string
|
||
activeGroupId?: string
|
||
topology?: RuntimeTerminalOrphanTopology
|
||
}
|
||
|
||
export type RuntimeTerminalOrphanAdoptionResult = {
|
||
adopted: boolean
|
||
topologyRevision: number
|
||
snapshot: RuntimeMobileSessionTabsResult
|
||
}
|
||
|
||
export type RuntimeWorktreeTerminalSleepResult = {
|
||
stopped: number
|
||
stoppedPtyIds: string[]
|
||
livePtyIds: string[]
|
||
} & (
|
||
| { postStopVerified: true; postStopFailure?: never; remainingLivePtyIds?: never }
|
||
| {
|
||
postStopVerified: false
|
||
postStopFailure: 'terminal_liveness_unavailable'
|
||
remainingLivePtyIds?: never
|
||
}
|
||
| {
|
||
postStopVerified: false
|
||
postStopFailure: 'terminal_worktree_sleep_still_live'
|
||
remainingLivePtyIds: string[]
|
||
}
|
||
)
|
||
|
||
export type RuntimeWorktreeTerminalCloseResult = {
|
||
closed: number
|
||
stopped: number
|
||
retiredSurfaces: true
|
||
ptyStopVerdict?: 'live' | 'unverifiable'
|
||
ptyStopReason?: string
|
||
}
|
||
|
||
export type RuntimeTerminalInteractiveWaitSource = 'hook' | 'prompt-text' | 'title'
|
||
|
||
export type RuntimeTerminalInteractiveWait = {
|
||
source: RuntimeTerminalInteractiveWaitSource
|
||
reason?: RuntimeTerminalWaitBlockedReason
|
||
since?: number
|
||
}
|
||
|
||
export type RuntimeTerminalShow = RuntimeTerminalSummary & {
|
||
paneRuntimeId: number
|
||
ptyId: string | null
|
||
rendererGraphEpoch: number
|
||
/** Null means evaluated with no wait; absent means not evaluated. */
|
||
agentWait?: RuntimeTerminalInteractiveWait | null
|
||
}
|
||
|
||
export type RuntimeTerminalState = 'running' | 'exited' | 'unknown'
|
||
|
||
export type RuntimeTerminalRowMetadata = {
|
||
wrapped: boolean
|
||
trailingSpaces: number
|
||
}
|
||
|
||
export type RuntimeTerminalRead = {
|
||
handle: string
|
||
status: RuntimeTerminalState
|
||
tail: string[]
|
||
/** Execution-host wrap evidence, aligned with tail; absent on older peers. */
|
||
tailRows?: RuntimeTerminalRowMetadata[]
|
||
truncated: boolean
|
||
limited?: boolean
|
||
oldestCursor?: string
|
||
nextCursor: string | null
|
||
latestCursor?: string
|
||
returnedLineCount?: number
|
||
source?: 'stream' | 'screen' | 'screen-unavailable'
|
||
/** UI-only composer text, excluded from `tail`. */
|
||
draft?: string
|
||
}
|
||
|
||
export type RuntimeTerminalRename = {
|
||
handle: string
|
||
tabId: string
|
||
title: string | null
|
||
}
|
||
|
||
export type RuntimeTerminalSetPaneTitle = {
|
||
handle: string
|
||
tabId: string
|
||
leafId: string
|
||
title: string | null
|
||
}
|
||
|
||
export type RuntimeTerminalAgentStatusState = 'working' | 'permission' | 'idle' | null
|
||
|
||
export type RuntimeTerminalAgentStatus = {
|
||
handle: string
|
||
isRunningAgent: boolean
|
||
status: RuntimeTerminalAgentStatusState
|
||
}
|
||
|
||
export type RuntimeTerminalPresentation = 'background' | 'focused'
|
||
|
||
type RuntimeTerminalCreateBaseRequestPayload = {
|
||
requestId: string
|
||
worktreeId?: string
|
||
afterTabId?: string
|
||
targetGroupId?: string
|
||
command?: string
|
||
cwd?: string
|
||
env?: Record<string, string>
|
||
envToDelete?: string[]
|
||
launchConfig?: AgentSessionResume.SleepingAgentLaunchConfig
|
||
resumeProviderSession?: AgentSessionResume.AgentProviderSessionMetadata
|
||
launchToken?: string
|
||
launchAgent?: TuiAgent
|
||
trustWorktreeId?: string
|
||
viewMode?: 'terminal' | 'chat'
|
||
startupCommandDelivery?: StartupCommandDelivery
|
||
title?: string
|
||
activate?: boolean
|
||
presentation?: RuntimeTerminalPresentation
|
||
surfaceOwner?: false
|
||
/** Windows shell the created tab spawns AS, instead of the host default. */
|
||
shellOverride?: string
|
||
}
|
||
|
||
export type RuntimeTerminalCreateRequestPayload =
|
||
| (RuntimeTerminalCreateBaseRequestPayload & { source?: undefined })
|
||
| (RuntimeTerminalCreateBaseRequestPayload & {
|
||
worktreeId: string
|
||
source: 'runtime-session'
|
||
})
|
||
|
||
export type { RuntimeTerminalCreate } from './runtime-terminal-create-contract'
|
||
|
||
export type RuntimeTerminalSplit = {
|
||
handle: string
|
||
tabId: string
|
||
paneRuntimeId: number
|
||
// Why: paired callers need the host-created leaf identity to focus the exact pane.
|
||
leafId?: string
|
||
}
|
||
|
||
export type RuntimeTerminalResolvePane = TerminalLaunchResult & {
|
||
handle: string
|
||
/** Host-owned PTY incarnation used to fence remote identity observations. */
|
||
incarnationId?: string | null
|
||
tabId: string
|
||
leafId: string
|
||
ptyId: string | null
|
||
connected?: boolean
|
||
worktreeId?: string
|
||
executionHostId?: ExecutionHostId
|
||
hostPlatform?: NodeJS.Platform
|
||
}
|
||
|
||
export type RuntimeTerminalFocus = {
|
||
handle: string
|
||
tabId: string
|
||
worktreeId: string
|
||
navigated?: boolean
|
||
}
|
||
|
||
export type RuntimeTerminalClose = {
|
||
handle: string
|
||
tabId: string
|
||
closeMode?: 'tab'
|
||
ptyKilled: boolean
|
||
ptyStopVerdict?: 'live' | 'unverifiable'
|
||
ptyStopReason?: string
|
||
/** Durable host kill order replays on SSH reconnect; promise kill replay only when the host reports this field. */
|
||
pendingKillRecorded?: true
|
||
}
|
||
|
||
export type RuntimeTerminalWaitCondition = 'exit' | 'tui-idle'
|
||
|
||
// Keep published codex-* reasons readable forever; emit them only for plausibly Codex-specific wording.
|
||
// Agent-agnostic matchers use agent-* reasons.
|
||
export type RuntimeTerminalWaitBlockedReason =
|
||
| 'codex-update-prompt'
|
||
| 'codex-trust-workspace'
|
||
| 'codex-cwd-prompt'
|
||
| 'codex-model-migration-prompt'
|
||
| 'codex-hooks-review-prompt'
|
||
| 'codex-interactive-prompt'
|
||
| 'agent-update-prompt'
|
||
| 'agent-trust-workspace'
|
||
| 'agent-cwd-prompt'
|
||
| 'agent-hooks-review-prompt'
|
||
| 'agent-interactive-prompt'
|
||
| 'agent-approval-prompt'
|
||
| 'agent-sign-in-prompt'
|
||
|
||
export type RuntimeTerminalWait = {
|
||
handle: string
|
||
condition: RuntimeTerminalWaitCondition
|
||
satisfied: boolean
|
||
status: RuntimeTerminalState
|
||
exitCode: number | null
|
||
exitCause?: TerminalExitCause
|
||
blockedReason?: RuntimeTerminalWaitBlockedReason
|
||
}
|