Files
orca/src/shared/runtime-client-events.ts
T
Kelvin Amoaba 9abd095d08 feat(agents): send paired phones the desktop Agents list's verdict per agent (#39243)
While a phone is paired, the desktop window publishes its own Agents-list
classification for each pane (listed, status, unread, clearable, title,
worker parent) and worktree.ps attaches it to each agent row, so the phone
lists agents exactly as the sidebar does. agentActivity.setRead/clear apply
through the sidebar's own Activity actions and resolve once the new
verdicts are stored.
2026-11-08 19:30:27 +00:00

124 lines
5.2 KiB
TypeScript

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 }
| { type: 'nativeChatCiResultLinesChanged'; ciResultLines: boolean }
/** The Workspace options UI state changed; a mirroring phone re-reads it. */
| { type: 'workspaceViewChanged' }
// Index, HEAD or refs moved in a watched local repo; without `worktreeIds` any of its checkouts may have changed.
| { type: 'gitStatusChanged'; repoId: string; worktreeIds?: string[] }
/** Top-level settings whose values changed; a phone re-reads only the settings it shows. */
| { type: 'settingsChanged'; keys: string[] }
/** The desktop Agents list's verdicts changed; worktree.ps carries them. */
| { type: 'agentListChanged' }
| {
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
nativeChatCiResultLines?: boolean
repos?: unknown[]
sshStates?: { targetId: string; state: SshConnectionState }[]
}
})
| RuntimeClientEvent
// Addressed to this subscriber only, never broadcast.
| BrowserClientHostRequestEvent
| { type: 'end' }
export type RuntimeActivateWorktreeEvent = Extract<RuntimeClientEvent, { type: 'activateWorktree' }>
export type AutomationsChangedEvent = Extract<RuntimeClientEvent, { type: 'automationsChanged' }>
/** Publisher payload; `selector` scoping is added by a later host-scope step. */
export type AutomationsChangedPayload = Omit<AutomationsChangedEvent, 'type'>
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 } : {})
}
}