import type { NotificationAttentionAcknowledgement } from './notification-settings-types' import type { CreateWorktreeResult } from './worktree/create-types' import type { WorktreeDefaultTabsLaunch, WorktreeSetupLaunch, WorktreeStartupLaunch } from './worktree/launch-types' import type { SshConnectionState } from './ssh-types' import type { TerminalSideEffectBatch } from './terminal/output/terminal-side-effect-facts' import type { RuntimeNativeChatLaunchDraftResolution } from './runtime-types' import type { RuntimeNavigationTarget } from './runtime-navigation' import type { WorktreeSortOrderUpdate } from './worktree/sort-order-update' import type { SidebarInputsChangedEvent } from './sidebar-list/sidebar-inputs-feed-contract' import type { BrowserClientHostRequestEvent } from './browser/client-hosting/browser-client-host-request-protocol' export type RuntimeClientEvent = | { type: 'notificationAttentionAcknowledged' acknowledgement: NotificationAttentionAcknowledgement } | { type: 'reposChanged' } | { type: 'nativeChatQueueFollowUpsChanged'; queueFollowUps: boolean } /** The Workspace options UI state changed; a mirroring phone re-reads it. */ | { type: 'workspaceViewChanged' } | { type: 'worktreesChanged' repoId: string sortOrderOnly?: boolean // Why: lets a client patch an order save in place instead of refetching the repo (#27268). sortOrders?: WorktreeSortOrderUpdate[] } /** An agent row changed (coalesced, no ids); phones re-read worktree.ps. Sent only while the sidebar feed is off. */ | { type: 'worktreeRowsChanged' } | ({ type: 'nativeChatLaunchDraftResolved' } & RuntimeNativeChatLaunchDraftResolution) | { type: 'terminalSideEffects'; batch: TerminalSideEffectBatch } /** Only while this host's own phone reads the sidebar feed; every other reader drops it. */ | SidebarInputsChangedEvent // Paired clients lack ssh:state-changed IPC; publish host SSH transitions so their reconnect overlays update (STA-1468). | { type: 'sshStateChanged'; targetId: string; state: SshConnectionState } | { type: 'worktreeTerminalSleepState' worktreeId: string generation: number phase: 'started' | 'committed' | 'cancelled' | 'woken' ptyIds: string[] terminalHandles: string[] } // Only the owning automation authority can announce definition/run/usage writes. | { type: 'automationsChanged' selector?: { kind: 'self' } | { kind: 'ssh'; targetId: string } | { kind: 'orphan' } reason?: 'definition' | 'run' | 'usage' } // Why: browser profiles live on the host; old clients drop the unknown type and refetch on their old triggers. | { type: 'browserProfilesChanged' } | { type: 'linearLinkedIssueUpdated' worktreeId: string identifier: string workspaceId: string } | { type: 'activateWorktree' repoId: string worktreeId: string setup?: WorktreeSetupLaunch startup?: WorktreeStartupLaunch defaultTabs?: WorktreeDefaultTabsLaunch providesInitialSurface?: boolean /** Absent on older hosts; clients must not infer navigation intent from a broadcast. */ navigation?: RuntimeNavigationTarget } export type RuntimeClientEventStreamMessage = | ({ type: 'ready'; subscriptionId: string } & { snapshot?: { nativeChatQueueFollowUps?: boolean repos?: unknown[] sshStates?: { targetId: string; state: SshConnectionState }[] } }) | RuntimeClientEvent // Addressed to this subscriber only, never broadcast. | BrowserClientHostRequestEvent | { type: 'end' } export type RuntimeActivateWorktreeEvent = Extract export type AutomationsChangedEvent = Extract /** Publisher payload; `selector` scoping is added by a later host-scope step. */ export type AutomationsChangedPayload = Omit export type PublishAutomationsChanged = (payload: AutomationsChangedPayload) => void export function toRuntimeActivateWorktreeEvent( repoId: string, worktreeId: string, setup?: CreateWorktreeResult['setup'], startup?: WorktreeStartupLaunch, defaultTabs?: CreateWorktreeResult['defaultTabs'], navigation?: RuntimeNavigationTarget, providesInitialSurface?: boolean ): RuntimeActivateWorktreeEvent { return { type: 'activateWorktree', repoId, worktreeId, ...(navigation ? { navigation } : {}), ...(setup ? { setup } : {}), ...(startup ? { startup } : {}), ...(defaultTabs ? { defaultTabs } : {}), ...(providesInitialSurface ? { providesInitialSurface } : {}) } }