native macOS codings agent orchestrator prowl.onev.cat
Something went wrong. Try again.
Swift
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180import AppKitimport CoreGraphicsimport Foundationimport GhosttyKitimport Observationimport ProwlCLISharedimport Sharing
let terminalStateLogger = ProwlLogger("TerminalState")let activeAgentDetectionInterval: Duration = .milliseconds(300)let idleAgentDetectionInterval: Duration = .seconds(2)
enum TerminalCloseConfirmationMode { case prompt(TerminalCloseConfirmationTarget) case skip}
enum TerminalCloseConfirmationTarget { case pane case tab case tabs(count: Int)
var messageText: String { switch self { case .pane: return String(localized: "Close Terminal Pane?") case .tab: return String(localized: "Close Terminal Tab?") case .tabs(let count): return count == 1 ? String(localized: "Close Terminal Tab?") : String(localized: "Close Terminal Tabs?") } }
var confirmButtonTitle: String { switch self { case .pane: return String(localized: "Close Pane") case .tab: return String(localized: "Close Tab") case .tabs(let count): return count == 1 ? String(localized: "Close Tab") : String(localized: "Close Tabs") } }}
/// Transition metadata only. Never carry rendered screen text in diagnostics.struct AgentDetectionDiagnostic { let tabId: TerminalTabID let childPID: pid_t? let processGroupID: pid_t? let job: ForegroundJob? let identified: IdentifiedAgentProcess? let retainedAgent: DetectedAgent? let raw: AgentRawState? let reason: AgentScreenDetectionReason? let stabilized: AgentRawState?
var summary: String { let processSummary = job?.processes .map { "\($0.pid):\($0.argv0 ?? $0.name)" } .joined(separator: ",") ?? "none" return [ "tab=\(tabId.rawValue.uuidString.prefix(8))", "childPID=\(childPID.map(String.init) ?? "nil")", "ptyPGID=\(processGroupID.map(String.init) ?? "nil")", "fgPGID=\(job.map { String($0.processGroupID) } ?? "nil")", "processes=\(processSummary)", "identified=\(identified.map { "\($0.agent.rawValue)(\($0.name)):\($0.process.pid)" } ?? "nil")", "launch=\(identified.map { String($0.launchProcessID) } ?? "nil")", "retained=\(retainedAgent?.rawValue ?? "nil")", "raw=\(raw?.rawValue ?? "nil")", "reason=\(reason?.identifier ?? "nil")", "state=\(stabilized?.rawValue ?? "nil")", ].joined(separator: " ") }}
@MainActor@Observablefinal class WorktreeTerminalState { struct SurfaceActivity: Equatable { let isVisible: Bool let isFocused: Bool }
/// One memoized agent-screen scan: the complete detection result produced for /// `text` under `agent`. Cached per surface so an unchanged screen is not /// re-parsed on the next poll and retains the rule or fallback reason. struct AgentScreenScan: Equatable { let agent: DetectedAgent let text: String let detection: AgentScreenDetection }
let tabManager: TerminalTabManager let runtime: GhosttyRuntime let worktree: Worktree private let targetHandleRegistry: TerminalTargetHandleRegistry let skipsSurfaceCreationForTesting: Bool let failsSurfaceCreationForTesting: Bool @ObservationIgnored @SharedReader private var repositorySettings: RepositorySettings var trees: [TerminalTabID: SplitTree<GhosttySurfaceView>] = [:] var surfaces: [UUID: GhosttySurfaceView] = [:] var focusedSurfaceIdByTab: [TerminalTabID: UUID] = [:] struct SurfaceLaunchProfile: Equatable { let profileID: UUID /// Display name recorded at launch. Deliberately frozen: later profile /// renames or deletions never relabel a live pane. let name: String /// The runtime this profile launched. The config root only applies to /// detections of the same runtime: after the launched agent exits, a /// manually started *different* agent in the same pane uses its default /// home, and handing it the profile home would break its session /// attribution. let runtime: AgentProfileRuntime /// Relocated runtime home for account-bound profiles; the session /// resolver uses it as the config root for this surface. Nil for pure /// presets (default home layout). let dedicatedHome: URL? /// The native session layout may be nested below the provisioned home /// (Gemini: `.gemini`, Cline: `data`). Keep provisioning and attribution /// roots distinct instead of teaching the resolver launch semantics. let sessionConfigRoot: URL?
init( profileID: UUID, name: String, runtime: AgentProfileRuntime, dedicatedHome: URL?, sessionConfigRoot: URL? = nil ) { self.profileID = profileID self.name = name self.runtime = runtime self.dedicatedHome = dedicatedHome self.sessionConfigRoot = sessionConfigRoot ?? dedicatedHome }
func configRoot(forDetected agent: DetectedAgent) -> URL? { runtime.agent == agent ? sessionConfigRoot : nil } }
var surfaceAgentStates: [UUID: PaneAgentState] = [:] @ObservationIgnored var agentDetectionCoordinators: [UUID: AgentDetectionCoordinator] = [:] /// Launch identity recorded at surface creation for Prowl-launched agent /// profiles (docs-ai 053). Never rewritten: recommendation or designation /// edits must not relabel a live pane. Detected-but-not-launched agents /// have no entry here. var launchProfilesBySurface: [UUID: SurfaceLaunchProfile] = [:] /// The managed-hook registration handed to the manager at Profile launch, /// kept so an undone close can register the surviving process again. @ObservationIgnored var launchHookRegistrationsBySurface: [UUID: AgentHookLaunchRegistration] = [:] var agentDetectionSchedules: [UUID: AgentDetectionSchedule] = [:] var agentDetectionTasks: [UUID: Task<Void, Never>] = [:] var agentDetectionPresenceBySurface: [UUID: AgentDetectionPresence] = [:] var lastAgentDetectionDiagnosticsBySurface: [UUID: String] = [:] /// Memoizes the last agent-screen scan per surface so `detectAgentState` can /// reuse it while the terminal text and detected agent are unchanged. A /// live-but-idle agent is polled every 300 ms; without this each poll re-ran /// `DetectedAgent.detectState` — line splitting, lowercasing, and heuristic /// scans over identical text. Observation-ignored: a pure cache that never /// drives the UI. @ObservationIgnored var lastAgentScreenScanBySurface: [UUID: AgentScreenScan] = [:] /// Last `ActiveAgentEntry` emitted per surface. `detectAgentState` re-emits /// whenever any `PaneAgentState` field changes, including internal /// bookkeeping (raw-state oscillation, session miss streaks, presence /// holds); comparing against the consumer-visible entry here keeps that /// churn out of the terminal event stream and the TCA action log. var lastEmittedAgentEntriesBySurface: [UUID: ActiveAgentEntry] = [:] /// When each surface last emitted, used to space out title-only emissions. /// Pure bookkeeping for `emitAgentEntry`; no view reads it. @ObservationIgnored var lastAgentEntryEmitAtBySurface: [UUID: Date] = [:] /// The most recent title-only entry held back by coalescing. A spinner that /// stops animating produces no further title change, so without a trailing /// flush the last frame would stay on screen until some unrelated state /// change happened to carry the current title along. @ObservationIgnored var pendingAgentEntryBySurface: [UUID: ActiveAgentEntry] = [:] var tabIsRunningById: [TerminalTabID: Bool] = [:] /// Per-tab aggregate of agent busy-state: `true` when at least one surface in /// the tab has a detected agent whose stabilized `displayState` is `.working` /// or `.blocked`. OR-ed into `taskStatus` alongside `tabIsRunningById` so the /// sidebar spinner and `prowl list` reflect agent activity, not just OSC 9;4 /// command progress (which Claude Code does not emit while it works). var tabAgentBusyById: [TerminalTabID: Bool] = [:] /// Per-tab aggregate of the `.blocked` slice of `tabAgentBusyById`: `true` /// when a surface in the tab holds an agent awaiting an answer (permission /// prompt, AskUserQuestion). Kept separate rather than folded into /// `taskStatus` because the two states call for opposite affordances — a /// spinner tells you to wait, a blocked agent is waiting on you — and /// `WorktreeTaskStatus` has no case to carry the difference. var tabAgentBlockedById: [TerminalTabID: Bool] = [:] var boundDirectoryTabIDs: [String: TerminalTabID] = [:] var surfaceRunningStartedAtById: [UUID: Date] = [:] var lastDefocusedAt: Date? var runScriptTabId: TerminalTabID? var pendingSetupScript: Bool var defaultFontSize: Float32? var isEnsuringInitialTab = false var lastReportedTaskStatus: WorktreeTaskStatus? var lastEmittedFocusSurfaceId: UUID? var lastWindowIsKey: Bool? var lastWindowIsVisible: Bool? /// When `true`, Canvas owns occlusion management for this state's surfaces. /// `syncFocusIfNeeded` skips `applySurfaceActivity` to avoid overriding /// Canvas-set occlusion with stale normal-mode window activity values. var isCanvasManaged = false /// Tab whose icon picker should be presented. `nil` hides the picker. var iconPickerTabId: TerminalTabID? var notifications: [WorktreeTerminalNotification] = [] var notificationsEnabled = true var commandFinishedNotificationEnabled = true var commandFinishedNotificationThreshold = 10 var lastKeyInputTimeBySurface: [UUID: ContinuousClock.Instant] = [:] var commandFinishedWaiters: [UUID: AsyncStream<(exitCode: Int?, durationMs: Int)>.Continuation] = [:] /// Surfaces that should auto-close on the next `command_finished` event with exit code 0. /// Populated by `markSurfaceForAutoClose` and consumed (one-shot) in `handleCommandFinished`. var autoCloseSurfaceIds: Set<UUID> = [] /// Surfaces running a tracked Custom Command. The stored name is surfaced as a success /// toast when the command exits with code 0. One-shot: removed on the first finish event. var pendingCustomCommands: [UUID: String] = [:] /// Ghostty's `undo-timeout`. While positive, closed panes and tabs are /// detached and handed to `onCloseRecorded` instead of freed; zero keeps the /// historical free-on-close behavior (docs-ai 069). var undoCloseTimeout: Duration = .zero /// Collects the tab records of one batch close (Close Other Tabs, ...) so /// they reach `onCloseRecorded` as a single undoable entry. @ObservationIgnored var pendingCloseGroup: [TerminalClosedTabRecord]? /// Surfaces whose `forgetSurface` is running for a retained (undoable) close. @ObservationIgnored var retainedForUndoSurfaceIDs: Set<UUID> = [] /// Per-surface set of titles known to be the shell's idle prompt /// (the title `precmd` restores between commands). Populated by /// observing the first title that arrives after each /// `command_finished` — reliably the precmd-set prompt. Subsequent /// occurrences are skipped so they can't clobber the icon set by a /// real command. var learnedIdleTitlesBySurface: [UUID: Set<String>] = [:] /// Surfaces whose next title-change should be added to /// `learnedIdleTitlesBySurface`. Armed by `command_finished`, /// consumed by the next title arrival. var awaitingIdleTitleLearningBySurface: Set<UUID> = [] var hasUnseenNotification: Bool { notifications.contains { !$0.isRead } }
func hasUnseenNotification(forSurfaceID surfaceID: UUID) -> Bool { notifications.contains { !$0.isRead && $0.surfaceId == surfaceID } }
func hasUnseenNotification(for tabId: TerminalTabID) -> Bool { let surfaceIds = trees[tabId]?.leaves().map(\.id) ?? [] return notifications.contains { !$0.isRead && surfaceIds.contains($0.surfaceId) } }
func unreadNotifications() -> [WorktreeTerminalNotification] { notifications.filter { !$0.isRead }.sorted { left, right in if left.createdAt != right.createdAt { return left.createdAt > right.createdAt } return left.id.uuidString > right.id.uuidString } }
var canCloseFocusedTab: Bool { tabManager.selectedTabId != nil }
var canCloseFocusedSurface: Bool { guard let tabId = tabManager.selectedTabId, let focusedId = focusedSurfaceIdByTab[tabId] else { return false } return surfaces[focusedId] != nil }
var isSelected: () -> Bool = { false } /// `isViewed` is true when the notification's surface is the one the user is /// actively looking at (selected worktree, focused pane, key + visible window), /// so the reducer can suppress a redundant banner/sound for it. var onNotificationReceived: ((_ surfaceId: UUID, _ title: String, _ body: String, _ isViewed: Bool) -> Void)? var onNotificationIndicatorChanged: (() -> Void)? var onTabCreated: (() -> Void)? var onTabClosed: (() -> Void)? var onFocusChanged: ((UUID) -> Void)? var onTaskStatusChanged: ((WorktreeTaskStatus) -> Void)? var onAgentEntryChanged: ((ActiveAgentEntry) -> Void)? var onAgentEntryRemoved: ((ActiveAgentEntry.ID) -> Void)? /// Emitted exactly once after agent cleanup for each torn-down surface. var onSurfaceClosed: ((UUID) -> Void)? /// A close kept its surfaces alive; the receiver owns them until it restores /// them through `restore(tab:)` / `restore(pane:)` or frees them. var onCloseRecorded: ((TerminalCloseRecord) -> Void)? /// A retained surface's process exited during the grace window. var onRetainedSurfaceExited: ((UUID) -> Void)? /// An undo put a Profile-launched surface back; its process still signals /// under this registration, so the receiver registers it again. var onManagedHookReadopted: ((UUID, AgentHookLaunchRegistration) -> Void)? /// Every surface of this worktree is being torn down outside the undoable /// close paths (layout restore, prune); retained closes are void. var onSurfacesReset: (() -> Void)? /// Ghostty `undo` / `redo` from a surface in this worktree. Return `true` /// when something was restored or re-closed. var onUndoRequested: (() -> Bool)? var onRedoRequested: (() -> Bool)? /// The exact surface is installed but its Profile command has not been sent. /// Returning false rolls the surface back before agent input can execute. var onAgentProfileSurfacePrepared: ((UUID, AgentProfileLaunchPlan) -> Bool)? var onRunScriptStatusChanged: ((Bool) -> Void)? var onCommandPaletteToggle: (() -> Void)? var onSetupScriptConsumed: (() -> Void)? var onFontSizeAdjusted: (() -> Void)? /// Emitted when a tracked Custom Command finishes with exit code 0. /// Payload carries the user-facing command name and run duration in milliseconds. var onCustomCommandSucceeded: ((String, Int) -> Void)?
init( runtime: GhosttyRuntime, worktree: Worktree, runSetupScript: Bool = false, defaultFontSize: Float32? = nil, targetHandleRegistry: TerminalTargetHandleRegistry? = nil, titleFlushClock: any Clock<Duration> = ContinuousClock(), skipsSurfaceCreationForTesting: Bool = false, failsSurfaceCreationForTesting: Bool = false ) { self.runtime = runtime self.worktree = worktree self.targetHandleRegistry = targetHandleRegistry ?? TerminalTargetHandleRegistry() self.skipsSurfaceCreationForTesting = skipsSurfaceCreationForTesting self.failsSurfaceCreationForTesting = failsSurfaceCreationForTesting self.pendingSetupScript = runSetupScript self.defaultFontSize = defaultFontSize self.tabManager = TerminalTabManager(titleFlushClock: titleFlushClock) _repositorySettings = SharedReader( wrappedValue: RepositorySettings.default, .repositorySettings(worktree.repositoryRootURL) ) self.tabManager.onCoalescedTitlesFlushed = { [weak self] tabIDs in for tabID in tabIDs { self?.refreshAgentEntriesForTitleChange(in: tabID) } } }
var worktreeID: Worktree.ID { worktree.id } var worktreeName: String { worktree.name } var repositoryRootURL: URL { worktree.repositoryRootURL }
func registerTargetHandle(for tabID: TerminalTabID) -> Int { targetHandleRegistry.register(tabID: tabID) }
func registerTargetHandle(for paneID: UUID) -> Int { targetHandleRegistry.register(paneID: paneID) }
func tabHandle(for tabID: TerminalTabID) -> Int? { targetHandleRegistry.handle(for: tabID) }
func paneHandle(for paneID: UUID) -> Int? { targetHandleRegistry.handle(for: paneID) }
func unregisterTargetHandle(for tabID: TerminalTabID) { targetHandleRegistry.unregister(tabID: tabID) }
func unregisterTargetHandle(for paneID: UUID) { targetHandleRegistry.unregister(paneID: paneID) }
var activeSurfaceView: GhosttySurfaceView? { guard let selectedTabId = tabManager.selectedTabId, let surfaceId = focusedSurfaceIdByTab[selectedTabId] else { return nil } return surfaces[surfaceId] }
var activeSurfaceID: UUID? { currentFocusedSurfaceId() }
func surfaceView(for tabId: TerminalTabID) -> GhosttySurfaceView? { guard let surfaceId = focusedSurfaceIdByTab[tabId] else { return nil } return surfaces[surfaceId] }
func surfaceView(for surfaceID: UUID) -> GhosttySurfaceView? { surfaces[surfaceID] }
@discardableResult func insertCommittedText(_ text: String, in tabId: TerminalTabID) -> Bool { guard let surface = surfaceView(for: tabId) else { return false } surface.insertCommittedTextForBroadcast(text) wakeAgentDetection(forSurfaceID: surface.id) return true }
@discardableResult func insertCommittedText(_ text: String, in surfaceID: UUID) -> Bool { guard let surface = surfaceView(for: surfaceID) else { return false } surface.insertCommittedTextForBroadcast(text) wakeAgentDetection(forSurfaceID: surface.id) return true }
@discardableResult func applyMirroredKey(_ key: MirroredTerminalKey, in tabId: TerminalTabID) -> Bool { guard let surface = surfaceView(for: tabId) else { return false } return surface.applyMirroredKeyForBroadcast(key) }
@discardableResult func submitLine(in surfaceID: UUID) -> Bool { guard let surface = surfaceView(for: surfaceID) else { return false } let submitted = surface.submitLine() if submitted { wakeAgentDetection(forSurfaceID: surface.id) } return submitted }
@discardableResult func sendKeyToken(_ token: String, in surfaceID: UUID) -> Bool { guard let surface = surfaceView(for: surfaceID) else { return false } let sent = surface.sendCLIKeyToken(token) if sent { wakeAgentDetection(forSurfaceID: surface.id) } return sent }
var taskStatus: WorktreeTaskStatus { let hasRunningCommand = tabIsRunningById.values.contains(true) let hasBusyAgent = tabAgentBusyById.values.contains(true) return (hasRunningCommand || hasBusyAgent) ? .running : .idle }
/// Whether any tab holds an agent awaiting an answer. Read alongside /// `taskStatus` by the sidebar so a blocked worktree shows an attention /// affordance instead of the running spinner. `taskStatus` itself is /// unchanged, so `prowl list` keeps reporting `running` for these. var hasBlockedAgent: Bool { tabAgentBlockedById.values.contains(true) }
var isRunScriptRunning: Bool { runScriptTabId != nil }
func setDefaultFontSize(_ fontSize: Float32?) { defaultFontSize = fontSize }
func focusedFontSize() -> Float32? { guard let surfaceId = currentFocusedSurfaceId() else { return nil } return inheritedSurfaceConfig(fromSurfaceId: surfaceId, context: GHOSTTY_SURFACE_CONTEXT_TAB).fontSize }
func ensureInitialTab(focusing: Bool) { guard tabManager.tabs.isEmpty else { return } guard !isEnsuringInitialTab else { return } isEnsuringInitialTab = true Task { let setupScript: String? if pendingSetupScript { setupScript = repositorySettings.setupScript } else { setupScript = nil } await MainActor.run { if tabManager.tabs.isEmpty { _ = createTab(focusing: focusing, setupScript: setupScript) } isEnsuringInitialTab = false } } }
@discardableResult func createTab( focusing: Bool = true, selecting: Bool = true, title: String? = nil, setupScript: String? = nil, initialInput: String? = nil, inheritingFromSurfaceId: UUID? = nil, workingDirectoryOverride: URL? = nil ) -> TerminalTabID? { let context = GHOSTTY_SURFACE_CONTEXT_TAB let resolvedInheritanceSurfaceId = inheritingFromSurfaceId ?? currentFocusedSurfaceId() let title = title ?? "\(worktree.name) \(nextTabIndex())" let setupInput = setupScriptInput(setupScript: setupScript) let commandInput = initialInput.flatMap { runScriptInput($0) } let resolvedInput: String? switch (setupInput, commandInput) { case (nil, nil): resolvedInput = nil case (let setupInput?, nil): resolvedInput = setupInput case (nil, let commandInput?): resolvedInput = commandInput case (let setupInput?, let commandInput?): resolvedInput = setupInput + commandInput } let shouldConsumeSetupScript = pendingSetupScript && setupScript != nil if shouldConsumeSetupScript { pendingSetupScript = false } let tabId = createTab( TabCreation( title: title, icon: "terminal", isTitleLocked: false, initialInput: resolvedInput, focusing: focusing, selecting: selecting, inheritingFromSurfaceId: resolvedInheritanceSurfaceId, context: context, workingDirectoryOverride: workingDirectoryOverride ) ) if shouldConsumeSetupScript, tabId != nil { onSetupScriptConsumed?() } return tabId }
func freezeAgentProfileLaunchContext( _ request: AgentProfileLaunchRequest ) -> Result<FrozenAgentProfileLaunchContext, AgentProfileLaunchError> { let anchor: UUID? let context: ghostty_surface_context_e let tracksFocusedAnchor: Bool switch request.placement { case .tab: anchor = request.inheritanceAnchor ?? currentFocusedSurfaceId() context = GHOSTTY_SURFACE_CONTEXT_TAB tracksFocusedAnchor = request.inheritanceAnchor == nil case .split(let requestedAnchor, _, _): guard let resolved = requestedAnchor ?? currentFocusedSurfaceId(), surfaces[resolved] != nil else { return .failure(.splitAnchorUnavailable) } anchor = resolved context = GHOSTTY_SURFACE_CONTEXT_SPLIT tracksFocusedAnchor = requestedAnchor == nil } let inheritedCWD = request.workingDirectoryOverride ?? inheritedSurfaceConfig(fromSurfaceId: anchor, context: context).workingDirectory ?? worktree.workingDirectory let frozenPlacement: AgentProfileLaunchRequest.Placement = switch request.placement { case .tab(let background): .tab(background: background) case .split(_, let direction, let background): .split(anchor: anchor, direction: direction, background: background) } return .success( FrozenAgentProfileLaunchContext( request: AgentProfileLaunchRequest( plan: request.plan, placement: frozenPlacement, workingDirectoryOverride: inheritedCWD, inheritanceAnchor: anchor, title: request.title ), inheritedCWD: inheritedCWD.standardizedFileURL, anchorSurfaceID: anchor, tracksFocusedAnchor: tracksFocusedAnchor, tracksInheritedCWD: request.workingDirectoryOverride == nil ) ) }
func isAgentProfileLaunchContextValid( _ context: FrozenAgentProfileLaunchContext, inheritedCWDOverride: URL? = nil ) -> Bool { if let anchor = context.anchorSurfaceID, surfaces[anchor] == nil { return false } if context.tracksFocusedAnchor, currentFocusedSurfaceId() != context.anchorSurfaceID { return false } guard context.tracksInheritedCWD else { return true } let surfaceContext: ghostty_surface_context_e = switch context.request.placement { case .tab: GHOSTTY_SURFACE_CONTEXT_TAB case .split: GHOSTTY_SURFACE_CONTEXT_SPLIT } let currentCWD = inheritedCWDOverride ?? inheritedSurfaceConfig( fromSurfaceId: context.anchorSurfaceID, context: surfaceContext ).workingDirectory ?? worktree.workingDirectory return AgentProfileLaunchPlanner.pathString(currentCWD) == AgentProfileLaunchPlanner.pathString(context.inheritedCWD) }
/// Launches an agent profile through the deterministic A2 boundary. Explicit /// split placement never falls back to a tab; callers receive both identities /// synchronously and can resolve the exact created target without using focus. @discardableResult func launchAgentProfile( _ request: AgentProfileLaunchRequest ) -> Result<LaunchedSurface, AgentProfileLaunchError> { guard provisionAgentProfileHome(for: request.plan) else { return .failure(.homeProvisioningFailed) } return launchProvisionedAgentProfile(request) }
/// Compatibility wrapper for the shipped menu/palette path. It preserves the /// original split-to-tab fallback and UUID-only result while the CLI/runner use /// the typed request boundary above. @discardableResult func launchAgentProfile(_ plan: AgentProfileLaunchPlan) -> UUID? { guard provisionAgentProfileHome(for: plan) else { return nil } if plan.placement == .split { let splitRequest = AgentProfileLaunchRequest( plan: plan, placement: .split( anchor: nil, direction: plan.splitDirection, background: false ) ) if case .success(let launched) = launchProvisionedAgentProfile(splitRequest) { return launched.surfaceID } } return try? launchProvisionedAgentProfile( AgentProfileLaunchRequest( plan: plan, placement: .tab(background: false) ) ).get().surfaceID }
func provisionAgentProfileHome(for plan: AgentProfileLaunchPlan) -> Bool { guard let home = plan.dedicatedHome else { return true } do { try AgentProfileHomeProvisioner.provision( home: home, base: ProwlPaths.agentProfileHomesDirectory ) return true } catch { terminalStateLogger.warning("Agent profile home provisioning failed: \(error)") return false } }
private func launchProvisionedAgentProfile( _ request: AgentProfileLaunchRequest ) -> Result<LaunchedSurface, AgentProfileLaunchError> { let plan = request.plan let launched: Result<LaunchedSurface, AgentProfileLaunchError> switch request.placement { case .tab(let background): launched = createAgentProfileTab(request, background: background) case .split(let requestedAnchor, let direction, let background): guard let anchor = requestedAnchor ?? currentFocusedSurfaceId() else { return .failure(.splitAnchorUnavailable) } switch createSplit( of: anchor, direction: direction, initialInput: plan.terminalInput, workingDirectoryOverride: request.workingDirectoryOverride, additionalEnvironment: plan.surfaceEnvironment, focusing: !background, defersSurfaceCreation: true ) { case .success(let surfaceID): guard let tabID = tabID(containing: surfaceID) else { return .failure(.splitCreationFailed(.insertionFailed)) } launched = .success(LaunchedSurface(tabID: tabID, surfaceID: surfaceID)) case .failure(let error): launched = .failure(.splitCreationFailed(error)) } }
guard case .success(let surface) = launched else { return launched } launchProfilesBySurface[surface.surfaceID] = SurfaceLaunchProfile( profileID: plan.profileID, name: plan.profileName, runtime: plan.runtime, dedicatedHome: plan.dedicatedHome, sessionConfigRoot: plan.sessionConfigRoot ) launchHookRegistrationsBySurface[surface.surfaceID] = plan.hookRegistration if case .split = request.placement, let icon = Self.launchTabIcon(for: plan.runtime) { applyResolvedIcon(icon, surfaceId: surface.surfaceID, tabId: surface.tabID) } guard onAgentProfileSurfacePrepared?(surface.surfaceID, plan) != false else { rollbackAgentProfileSurface(surface, placement: request.placement) return .failure(.hookRegistrationFailed) } guard let view = surfaces[surface.surfaceID], view.armSurfaceCreation() else { rollbackAgentProfileSurface(surface, placement: request.placement) return .failure(.surfaceCreationFailed) } wakeAgentDetection(for: view, tabId: surface.tabID) return launched }
private func createAgentProfileTab( _ request: AgentProfileLaunchRequest, background: Bool ) -> Result<LaunchedSurface, AgentProfileLaunchError> { let plan = request.plan guard let tabID = createTab( TabCreation( title: request.title ?? plan.profileName, icon: Self.launchTabIcon(for: plan.runtime)?.storageString ?? "terminal", isTitleLocked: false, initialInput: runScriptInput(plan.terminalInput), focusing: !background, selecting: !background, inheritingFromSurfaceId: request.inheritanceAnchor ?? currentFocusedSurfaceId(), context: GHOSTTY_SURFACE_CONTEXT_TAB, workingDirectoryOverride: request.workingDirectoryOverride, additionalEnvironment: plan.surfaceEnvironment, defersSurfaceCreation: true ) ) else { return .failure(.tabCreationFailed) } guard let surfaceID = trees[tabID]?.root?.leftmostLeaf().id else { return .failure(.launchedSurfaceMissing(tabID)) } return .success(LaunchedSurface(tabID: tabID, surfaceID: surfaceID)) }
private func rollbackAgentProfileSurface( _ surface: LaunchedSurface, placement: AgentProfileLaunchRequest.Placement ) { // The surface never ran its Profile command: nothing worth restoring. switch placement { case .tab: _ = closeTab(surface.tabID, confirmation: .skip, retainForUndo: false) case .split: _ = closeSurface(id: surface.surfaceID, confirmation: .skip, retainForUndo: false) } }
/// Icon for a profile launch. The launch path knows its runtime, so it /// resolves the brand icon directly instead of waiting for `CommandIconMap` /// to recognise the shell title: a profile that sets launch-scoped /// environment variables runs as `env VAR=… claude`, whose first token is /// `env`, and an unmatched token leaves the icon untouched. The lock stays /// `.auto`, so a later recognised command in the same tab can still take the /// slot, exactly as it does for a hand-typed agent. `nil` means the runtime /// has no mapping, in which case the tab keeps whatever icon it has. static func launchTabIcon(for runtime: AgentProfileRuntime) -> TabIconSource? { CommandIconMap.iconForFirstToken(runtime.agent.iconLookupToken) }
@discardableResult func focusOrCreateTab( boundToDirectory directory: URL, title: String? ) -> TerminalTabID? { let directoryKey = boundDirectoryKey(for: directory) if let tabId = boundDirectoryTabIDs[directoryKey], tabManager.tabs.contains(where: { $0.id == tabId }) { selectTab(tabId) return tabId } boundDirectoryTabIDs.removeValue(forKey: directoryKey)
if let tabId = tabID(withWorkingDirectoryKey: directoryKey) { boundDirectoryTabIDs[directoryKey] = tabId selectTab(tabId) return tabId }
let tabId = createTab( title: title, workingDirectoryOverride: directory ) if let tabId { boundDirectoryTabIDs[directoryKey] = tabId } return tabId }
@discardableResult func runScript(_ script: String) -> TerminalTabID? { guard let input = runScriptInput(script) else { return nil } if let existing = runScriptTabId { closeTab(existing, confirmation: .skip, retainForUndo: false) } let tabId = createTab( TabCreation( title: String(localized: "RUN SCRIPT"), icon: "play.fill", isTitleLocked: true, initialInput: input, focusing: true, inheritingFromSurfaceId: currentFocusedSurfaceId(), context: GHOSTTY_SURFACE_CONTEXT_TAB, workingDirectoryOverride: nil ) ) if let tabId { // Lock in the play glyph as a script-level override so OSC-2 // titles emitted by the script (e.g. `npm run dev`) can't swap // the icon out from under it. tabManager.setScriptIcon(tabId, icon: "play.fill") } setRunScriptTabId(tabId) return tabId }
@discardableResult func stopRunScript() -> Bool { guard let runScriptTabId else { return false } return closeTab(runScriptTabId, confirmation: .skip, retainForUndo: false) }
private struct TabCreation: Equatable { let title: String let icon: String? let isTitleLocked: Bool let initialInput: String? let focusing: Bool var selecting: Bool = true let inheritingFromSurfaceId: UUID? let context: ghostty_surface_context_e let workingDirectoryOverride: URL? var additionalEnvironment: [String: String] = [:] var defersSurfaceCreation = false }
private func createTab(_ creation: TabCreation) -> TerminalTabID? { let tabId = tabManager.createTab( title: creation.title, icon: creation.icon, isTitleLocked: creation.isTitleLocked, select: creation.selecting ) let tree = splitTree( for: tabId, inheritingFromSurfaceId: creation.inheritingFromSurfaceId, initialInput: creation.initialInput, workingDirectoryOverride: creation.workingDirectoryOverride, context: creation.context, additionalEnvironment: creation.additionalEnvironment, defersSurfaceCreation: creation.defersSurfaceCreation ) _ = registerTargetHandle(for: tabId) for surface in tree.leaves() { _ = registerTargetHandle(for: surface.id) } tabIsRunningById[tabId] = false if creation.focusing, let surface = tree.root?.leftmostLeaf() { focusSurface(surface, in: tabId) } onTabCreated?() return tabId }
func selectTab(_ tabId: TerminalTabID) { tabManager.selectTab(tabId) focusSurface(in: tabId) emitTaskStatusIfChanged() }
func focusSelectedTab() { terminalStateLogger.interval("focusSelectedTab") { guard let tabId = tabManager.selectedTabId else { return } focusSurface(in: tabId) } }
@discardableResult func focusAndInsertText(_ text: String) -> Bool { guard let tabId = tabManager.selectedTabId, let focusedId = focusedSurfaceIdByTab[tabId], let surface = surfaces[focusedId] else { return false } surface.requestFocus() surface.insertText(text, replacementRange: NSRange(location: 0, length: 0)) return true }
@discardableResult func focusAndRunCommand(_ text: String) -> Bool { guard let tabId = tabManager.selectedTabId, let focusedId = focusedSurfaceIdByTab[tabId], let surface = surfaces[focusedId] else { return false } let trimmed = text.trimmingCharacters(in: .whitespacesAndNewlines) guard !trimmed.isEmpty else { return false } let command = text.trimmingCharacters(in: .newlines) surface.requestFocus() surface.insertText(command, replacementRange: NSRange(location: 0, length: 0)) return surface.submitLine() }
func syncFocus(windowIsKey: Bool, windowIsVisible: Bool) { terminalStateLogger.interval("syncFocus") { lastWindowIsKey = windowIsKey lastWindowIsVisible = windowIsVisible applySurfaceActivity() } }
func applySurfaceActivity() { terminalStateLogger.interval("applySurfaceActivity") { applySurfaceActivityImpl() } }
private func applySurfaceActivityImpl() { let selectedTabId = tabManager.selectedTabId var surfaceToFocus: GhosttySurfaceView? for (tabId, tree) in trees { let focusedId = focusedSurfaceIdByTab[tabId] let isSelectedTab = (tabId == selectedTabId) let visibleSurfaceIDs = Set(tree.visibleLeaves().map(\.id)) for surface in tree.leaves() { let activity = Self.surfaceActivity( isSurfaceVisibleInTree: visibleSurfaceIDs.contains(surface.id), isSelectedTab: isSelectedTab, windowIsVisible: lastWindowIsVisible == true, windowIsKey: lastWindowIsKey == true, focusedSurfaceID: focusedId, surfaceID: surface.id ) surface.setOcclusion(activity.isVisible) surface.focusDidChange(activity.isFocused) if activity.isFocused { surfaceToFocus = surface } } } if let surfaceToFocus, surfaceToFocus.window?.firstResponder is GhosttySurfaceView { surfaceToFocus.window?.makeFirstResponder(surfaceToFocus) } }
static func surfaceActivity( isSurfaceVisibleInTree: Bool = true, isSelectedTab: Bool, windowIsVisible: Bool, windowIsKey: Bool, focusedSurfaceID: UUID?, surfaceID: UUID ) -> SurfaceActivity { let isVisible = isSurfaceVisibleInTree && isSelectedTab && windowIsVisible let isFocused = isVisible && windowIsKey && focusedSurfaceID == surfaceID return SurfaceActivity(isVisible: isVisible, isFocused: isFocused) }
@discardableResult func focusSurface(id: UUID) -> Bool { guard let tabId = tabId(containing: id), let surface = surfaces[id] else { return false } tabManager.selectTab(tabId) focusSurface(surface, in: tabId) return true }
@discardableResult func closeFocusedTab() -> Bool { guard let tabId = tabManager.selectedTabId else { return false } return closeTab(tabId) }
@discardableResult func closeFocusedSurface() -> Bool { guard let tabId = tabManager.selectedTabId, let focusedId = focusedSurfaceIdByTab[tabId], let surface = surfaces[focusedId] else { return false } surface.performBindingAction("close_surface") return true }
@discardableResult func performBindingActionOnFocusedSurface(_ action: String) -> Bool { guard let tabId = tabManager.selectedTabId, let focusedId = focusedSurfaceIdByTab[tabId], let surface = surfaces[focusedId] else { return false } surface.performBindingAction(action) return true }
@discardableResult func performBindingAction(_ action: String, onSurfaceID surfaceID: UUID) -> Bool { guard let surface = surfaces[surfaceID] else { return false } surface.performBindingAction(action) return true }
@discardableResult func navigateSearchOnFocusedSurface(_ direction: GhosttySearchDirection) -> Bool { guard let tabId = tabManager.selectedTabId, let focusedId = focusedSurfaceIdByTab[tabId], let surface = surfaces[focusedId] else { return false } surface.navigateSearch(direction) return true }
@discardableResult func closeTab(_ tabId: TerminalTabID) -> Bool { closeTab(tabId, confirmation: .prompt(.tab)) }
/// `retainForUndo: false` frees the surfaces at once, for closes that make /// no sense to restore (a replaced Run Script tab, a rolled-back launch). @discardableResult func closeTab( _ tabId: TerminalTabID, confirmation: TerminalCloseConfirmationMode, retainForUndo: Bool = true ) -> Bool { guard confirmCloseIfNeeded(tabIds: [tabId], mode: confirmation) else { return false } let wasRunScriptTab = tabId == runScriptTabId let record = retainForUndo ? makeClosedTabRecord(for: tabId) : nil if record != nil { detachTree(for: tabId) } else { removeTree(for: tabId) } unregisterTargetHandle(for: tabId) removeBoundDirectoryTab(tabId) tabManager.closeTab(tabId) if let selected = tabManager.selectedTabId { focusSurface(in: selected) } else { lastEmittedFocusSurfaceId = nil } emitTaskStatusIfChanged() if wasRunScriptTab { setRunScriptTabId(nil) } onTabClosed?() if let record { recordClosedTab(record) } return true }
func closeOtherTabs(keeping tabId: TerminalTabID) { let ids = tabManager.tabs.map(\.id).filter { $0 != tabId } guard confirmCloseIfNeeded(tabIds: ids, mode: .prompt(.tabs(count: ids.count))) else { return } closeTabs(ids) }
func closeTabsToRight(of tabId: TerminalTabID) { guard let index = tabManager.tabs.firstIndex(where: { $0.id == tabId }) else { return } let ids = tabManager.tabs.dropFirst(index + 1).map(\.id) guard confirmCloseIfNeeded(tabIds: ids, mode: .prompt(.tabs(count: ids.count))) else { return } closeTabs(ids) }
func closeAllTabs() { let ids = tabManager.tabs.map(\.id) guard confirmCloseIfNeeded(tabIds: ids, mode: .prompt(.tabs(count: ids.count))) else { return } closeTabs(ids) }
/// Closes already-confirmed tabs as one undoable batch. func closeTabs(_ ids: [TerminalTabID]) { pendingCloseGroup = [] for id in ids { closeTab(id, confirmation: .skip) } let records = pendingCloseGroup ?? [] pendingCloseGroup = nil if !records.isEmpty { onCloseRecorded?(.tabs(worktreeID: worktreeID, records)) } }
func needsSetupScript() -> Bool { pendingSetupScript }
func enableSetupScriptIfNeeded() { if pendingSetupScript { return } if tabManager.tabs.isEmpty { pendingSetupScript = true } }
private func setupScriptInput(setupScript: String?) -> String? { guard pendingSetupScript, let script = setupScript else { return nil } return formatCommandInput(script) }
func removeBoundDirectoryTab(_ tabId: TerminalTabID) { boundDirectoryTabIDs = boundDirectoryTabIDs.filter { $0.value != tabId } }
private func tabID(withWorkingDirectoryKey directoryKey: String) -> TerminalTabID? { for tab in tabManager.tabs { let paneIDs = trees[tab.id]?.leaves().map(\.id) ?? [] let hasMatchingPane = paneIDs.contains { paneID in guard let workingDirectory = inheritedSurfaceConfig( fromSurfaceId: paneID, context: GHOSTTY_SURFACE_CONTEXT_TAB ).workingDirectory else { return false } return boundDirectoryKey(for: workingDirectory) == directoryKey } if hasMatchingPane { return tab.id } } return nil }
private func boundDirectoryKey(for url: URL) -> String { url.standardizedFileURL.path(percentEncoded: false) }
// Env vars are injected into the surface's shell process via // `GhosttySurfaceView(environment:)`, so scripts no longer need a shell // export prefix. private func formatCommandInput(_ script: String) -> String? { makeCommandInput(script: script) }
func runScriptInput(_ script: String) -> String? { formatCommandInput(script) }
// Appends a bare `exit`, which preserves the most recent command status in // bash, zsh, and fish while remaining portable across those shells. // Without this, the interactive shell stays alive after the script finishes // and GHOSTTY_ACTION_SHOW_CHILD_EXITED never fires for completion detection. private func blockingScriptInput(_ script: String) -> String? { makeBlockingScriptInput(script: script) }
func setRunScriptTabId(_ tabId: TerminalTabID?) { let wasRunning = runScriptTabId != nil runScriptTabId = tabId let isRunning = tabId != nil if wasRunning != isRunning { onRunScriptStatusChanged?(isRunning) } }
}