Files
Neil 234e6de5f4 fix(plugins): date appearance and editor typography floors to their releases (#42691)
The appearance methods first shipped in v1.4.251 and editor.readTypography
in v1.4.257, so a plugin requiring the old floors installed on Orca that
lacks them.
2026-11-15 02:12:31 -08:00

3.1 KiB

Events

Worker events

List each in contributes.events ({ "on": "<event>" }), with main, the trusted-worker profile and the capability shown; then orca.events.on(event, handler) in activate(orca) returns { dispose() }. Payloads:

  • workspace.created (capability workspace:read; since 1.4.245): A worktree workspace was created; workspaceListId (host API 1.7) is the id workspace.list gives it. { workspaceId: string; workspaceListId?: string; kind: "worktree" | "folder"; path: string; branch: string }
  • workspace.removed (capability workspace:read; since 1.4.245): A worktree workspace was removed; workspaceListId (host API 1.7) is the id workspace.list gave it. { workspaceId: string; workspaceListId?: string; kind: "worktree" | "folder"; path: string }
  • agent.status.changed (capability agent:read; since 1.4.160): An agent in a terminal pane changed status; workspaceId is null when Orca cannot tie the pane to a workspace, workspaceListId (host API 1.7) is the id workspace.list gives that workspace, terminalId names its terminal when Orca lists it, and sessionId (host API 1.8) is what agent.resume takes. { workspaceId: string | null; workspaceListId?: string; paneKey: string; terminalId?: string; title?: string; state: "working" | "blocked" | "waiting" | "done"; receivedAt: number; mainAgent?: { state: "working" | "blocked" | "waiting" | "done"; outcome?: "success" | "failure" | "cancellation" | "superseded" | "interruption" | "unconfirmed"; stateStartedAt: number }; sessionId?: string }
  • workspace.changed (capability workspace:read; since 1.4.246): The focused workspace changed, or its terminals were opened, closed or renamed; context is what workspace.readContext now answers, its workspaceId included. Each new subscriber first gets the current context. { context: { workspaceId?: string; branch: string; displayName: string; terminals: { id: string; title?: string }[] } | null }
  • editor.typography.changed (no capability; since 1.4.257): What Orca's file editor uses changed (a setting or the editor zoom); the payload is what editor.readTypography now answers. Needs no capability. { fontFamily: string; cssFontFamily: string; fontSize: number; fontWeight: string; lineHeight: number; fontLigatures: boolean; wordWrap: "on" | "off"; minimap: boolean }

Frame events (orca.on(event, handler) in HTML panels and custom editors)

  • theme: FrameTheme: The --orca-* variables and the light/dark class on <html> already changed.
  • 'editor.document': EditorDocument: Custom editors: a new document; orca.document.onDidChange is the usual way to listen.
  • 'editor.flush': undefined: Custom editors: post pending edits before a save; Orca waits for a returned promise.

Components panel events (on(event, handler) from orca)

  • theme: { colorScheme: 'light' | 'dark' }
  • Every worker event above, with the same payload and capability; a panel needs no contributes.events entry, it subscribes while it is open. HTML panels get them on orca.on too.