@byokit/herdr 0.1.0-next.dbe7142

package/dist/generated/methods.d.ts

@@ -0,0 +1,2299 @@
+export interface HerdrMethods {
+    'agent.explain': {
+        params: AgentTarget;
+        result: AgentExplainResponse;
+    };
+    'agent.focus': {
+        params: AgentTarget;
+        result: unknown;
+    };
+    'agent.get': {
+        params: AgentTarget;
+        result: AgentInfoResponse;
+    };
+    'agent.list': {
+        params: EmptyParams;
+        result: AgentListResponse;
+    };
+    'agent.prompt': {
+        params: AgentPromptParams;
+        result: AgentPromptedResponse;
+    };
+    'agent.read': {
+        params: AgentReadParams;
+        result: unknown;
+    };
+    'agent.rename': {
+        params: AgentRenameParams;
+        result: AgentInfoResponse;
+    };
+    'agent.send_keys': {
+        params: AgentSendKeysParams;
+        result: unknown;
+    };
+    'agent.start': {
+        params: AgentStartParams;
+        result: AgentStartedResponse;
+    };
+    'agent.view.clear': {
+        params: AgentViewClearParams;
+        result: AgentViewResponse;
+    };
+    'agent.view.set': {
+        params: AgentViewSetParams;
+        result: AgentViewResponse;
+    };
+    'agent.wait': {
+        params: AgentWaitParams;
+        result: WaitMatchedResponse;
+    };
+    'client.window_title.clear': {
+        params: EmptyParams;
+        result: ClientWindowTitleResponse;
+    };
+    'client.window_title.set': {
+        params: ClientWindowTitleSetParams;
+        result: ClientWindowTitleResponse;
+    };
+    'client_shell.surface.set': {
+        params: ClientShellSurfaceSetParams;
+        result: ClientShellSurfaceSetResponse;
+    };
+    'command.invoke': {
+        params: CommandInvokeParams;
+        result: unknown;
+    };
+    'events.subscribe': {
+        params: EventsSubscribeParams;
+        result: SubscriptionStartedResponse;
+    };
+    'events.wait': {
+        params: EventsWaitParams;
+        result: WaitMatchedResponse;
+    };
+    'integration.install': {
+        params: IntegrationInstallParams;
+        result: IntegrationInstallResponse;
+    };
+    'integration.list': {
+        params: EmptyParams;
+        result: IntegrationListResponse;
+    };
+    'integration.uninstall': {
+        params: IntegrationUninstallParams;
+        result: IntegrationUninstallResponse;
+    };
+    'layout.apply': {
+        params: LayoutApplyParams;
+        result: LayoutApplyResponse;
+    };
+    'layout.export': {
+        params: LayoutExportParams;
+        result: LayoutExportResponse;
+    };
+    'layout.set_split_ratio': {
+        params: LayoutSetSplitRatioParams;
+        result: LayoutSplitRatioSetResponse;
+    };
+    'notification.show': {
+        params: NotificationShowParams;
+        result: NotificationShowResponse;
+    };
+    'pane.clear_agent_authority': {
+        params: PaneClearAgentAuthorityParams;
+        result: OkResponse;
+    };
+    'pane.close': {
+        params: PaneTarget;
+        result: OkResponse;
+    };
+    'pane.copy_motion': {
+        params: PaneCopyMotionParams;
+        result: PaneCopyMotionResponse;
+    };
+    'pane.copy_search': {
+        params: PaneCopySearchParams;
+        result: PaneCopySearchResponse;
+    };
+    'pane.current': {
+        params: PaneCurrentParams;
+        result: PaneCurrentResponse;
+    };
+    'pane.edges': {
+        params: PaneEdgesParams;
+        result: PaneEdgesResponse;
+    };
+    'pane.edit_scrollback': {
+        params: PaneTarget;
+        result: OkResponse;
+    };
+    'pane.focus': {
+        params: PaneTarget;
+        result: PaneFocusDirectionResponse;
+    };
+    'pane.focus_direction': {
+        params: PaneFocusDirectionParams;
+        result: PaneFocusDirectionResponse;
+    };
+    'pane.get': {
+        params: PaneTarget;
+        result: PaneInfoResponse;
+    };
+    'pane.graphics.clear': {
+        params: PaneGraphicsClearParams;
+        result: OkResponse;
+    };
+    'pane.graphics.info': {
+        params: PaneTarget;
+        result: PaneGraphicsInfoResponse;
+    };
+    'pane.graphics.set': {
+        params: PaneGraphicsSetParams;
+        result: unknown;
+    };
+    'pane.input.set': {
+        params: PaneInputSetParams;
+        result: OkResponse;
+    };
+    'pane.layout': {
+        params: PaneLayoutParams;
+        result: PaneLayoutResponse;
+    };
+    'pane.link.activate': {
+        params: PaneLinkActivateParams;
+        result: PaneLinkActivatedResponse;
+    };
+    'pane.link.resolve': {
+        params: PaneLinkActivateParams;
+        result: PaneLinkResolvedResponse;
+    };
+    'pane.list': {
+        params: PaneListParams;
+        result: PaneListResponse;
+    };
+    'pane.move': {
+        params: PaneMoveParams;
+        result: PaneMoveResponse;
+    };
+    'pane.neighbor': {
+        params: PaneNeighborParams;
+        result: PaneNeighborResponse;
+    };
+    'pane.process_info': {
+        params: PaneProcessInfoParams;
+        result: PaneProcessInfoResponse;
+    };
+    'pane.read': {
+        params: PaneReadParams;
+        result: PaneReadResponse;
+    };
+    'pane.release_agent': {
+        params: PaneReleaseAgentParams;
+        result: OkResponse;
+    };
+    'pane.rename': {
+        params: PaneRenameParams;
+        result: PaneInfoResponse;
+    };
+    'pane.report_agent': {
+        params: PaneReportAgentParams;
+        result: OkResponse;
+    };
+    'pane.report_agent_session': {
+        params: PaneReportAgentSessionParams;
+        result: OkResponse;
+    };
+    'pane.report_metadata': {
+        params: PaneReportMetadataParams;
+        result: OkResponse;
+    };
+    'pane.resize': {
+        params: PaneResizeParams;
+        result: PaneResizeResponse;
+    };
+    'pane.scroll': {
+        params: PaneScrollParams;
+        result: PaneInfoResponse;
+    };
+    'pane.selection.read': {
+        params: PaneSelectionReadParams;
+        result: PaneSelectionResponse;
+    };
+    'pane.send_input': {
+        params: PaneSendInputParams;
+        result: OkResponse;
+    };
+    'pane.send_keys': {
+        params: PaneSendKeysParams;
+        result: OkResponse;
+    };
+    'pane.send_text': {
+        params: PaneSendTextParams;
+        result: OkResponse;
+    };
+    'pane.split': {
+        params: PaneSplitParams;
+        result: PaneInfoResponse;
+    };
+    'pane.swap': {
+        params: PaneSwapParams;
+        result: PaneSwapResponse;
+    };
+    'pane.wait_for_output': {
+        params: PaneWaitForOutputParams;
+        result: OutputMatchedResponse;
+    };
+    'pane.zoom': {
+        params: PaneZoomParams;
+        result: PaneZoomResponse;
+    };
+    'ping': {
+        params: PingParams;
+        result: PongResponse;
+    };
+    'plugin.action.invoke': {
+        params: PluginActionInvokeParams;
+        result: PluginActionInvokedResponse;
+    };
+    'plugin.action.list': {
+        params: PluginActionListParams;
+        result: PluginActionListResponse;
+    };
+    'plugin.disable': {
+        params: PluginSetEnabledParams;
+        result: PluginDisabledResponse;
+    };
+    'plugin.enable': {
+        params: PluginSetEnabledParams;
+        result: PluginEnabledResponse;
+    };
+    'plugin.link': {
+        params: PluginLinkParams;
+        result: PluginLinkedResponse;
+    };
+    'plugin.list': {
+        params: PluginListParams;
+        result: PluginListResponse;
+    };
+    'plugin.log.list': {
+        params: PluginLogListParams;
+        result: PluginLogListResponse;
+    };
+    'plugin.pane.close': {
+        params: PluginPaneCloseParams;
+        result: PluginPaneClosedResponse;
+    };
+    'plugin.pane.focus': {
+        params: PluginPaneFocusParams;
+        result: PluginPaneFocusedResponse;
+    };
+    'plugin.pane.open': {
+        params: PluginPaneOpenParams;
+        result: PluginPaneOpenedResponse;
+    };
+    'plugin.unlink': {
+        params: PluginUnlinkParams;
+        result: PluginUnlinkedResponse;
+    };
+    'popup.close': {
+        params: EmptyParams;
+        result: unknown;
+    };
+    'product_announcement.dismiss': {
+        params: ProductAnnouncementDismissParams;
+        result: unknown;
+    };
+    'release_notes.dismiss': {
+        params: ReleaseNotesDismissParams;
+        result: unknown;
+    };
+    'server.agent_manifests': {
+        params: EmptyParams;
+        result: AgentManifestStatusResponse;
+    };
+    'server.live_handoff': {
+        params: ServerLiveHandoffParams;
+        result: unknown;
+    };
+    'server.reload_agent_manifests': {
+        params: EmptyParams;
+        result: AgentManifestReloadResponse;
+    };
+    'server.reload_config': {
+        params: EmptyParams;
+        result: ConfigReloadResponse;
+    };
+    'server.stop': {
+        params: EmptyParams;
+        result: unknown;
+    };
+    'session.snapshot': {
+        params: EmptyParams;
+        result: SessionSnapshotResponse;
+    };
+    'tab.close': {
+        params: TabTarget;
+        result: OkResponse;
+    };
+    'tab.create': {
+        params: TabCreateParams;
+        result: TabCreatedResponse;
+    };
+    'tab.focus': {
+        params: TabTarget;
+        result: TabInfoResponse;
+    };
+    'tab.get': {
+        params: TabTarget;
+        result: TabInfoResponse;
+    };
+    'tab.list': {
+        params: TabListParams;
+        result: TabListResponse;
+    };
+    'tab.move': {
+        params: TabMoveParams;
+        result: TabListResponse;
+    };
+    'tab.rename': {
+        params: TabRenameParams;
+        result: TabInfoResponse;
+    };
+    'workspace.close': {
+        params: WorkspaceCloseParams;
+        result: OkResponse;
+    };
+    'workspace.create': {
+        params: WorkspaceCreateParams;
+        result: WorkspaceCreatedResponse;
+    };
+    'workspace.focus': {
+        params: WorkspaceTarget;
+        result: WorkspaceInfoResponse;
+    };
+    'workspace.get': {
+        params: WorkspaceTarget;
+        result: WorkspaceInfoResponse;
+    };
+    'workspace.list': {
+        params: EmptyParams;
+        result: WorkspaceListResponse;
+    };
+    'workspace.move': {
+        params: WorkspaceMoveParams;
+        result: WorkspaceListResponse;
+    };
+    'workspace.move_block': {
+        params: WorkspaceMoveBlockParams;
+        result: WorkspaceListResponse;
+    };
+    'workspace.rename': {
+        params: WorkspaceRenameParams;
+        result: WorkspaceInfoResponse;
+    };
+    'workspace.report_metadata': {
+        params: WorkspaceReportMetadataParams;
+        result: OkResponse;
+    };
+    'worktree.create': {
+        params: WorktreeCreateParams;
+        result: WorktreeCreatedResponse;
+    };
+    'worktree.list': {
+        params: WorktreeListParams;
+        result: WorktreeListResponse;
+    };
+    'worktree.open': {
+        params: WorktreeOpenParams;
+        result: WorktreeOpenedResponse;
+    };
+    'worktree.remove': {
+        params: WorktreeRemoveParams;
+        result: WorktreeRemovedResponse;
+    };
+}
+export type HerdrMethod = keyof HerdrMethods;
+export type HerdrParams<M extends HerdrMethod> = HerdrMethods[M]['params'];
+export type HerdrResult<M extends HerdrMethod> = HerdrMethods[M]['result'];
+export type AgentSessionRefKind = "id" | "path";
+export type AgentStatus = "idle" | "working" | "blocked" | "done" | "unknown";
+export type ReadSource = "visible" | "recent" | "recent_unwrapped" | "detection";
+export type AgentViewFilter = {
+    filters: AgentViewFilter[];
+    op: "all";
+    [k: string]: unknown;
+} | {
+    filters: AgentViewFilter[];
+    op: "any";
+    [k: string]: unknown;
+} | {
+    filter: AgentViewFilter;
+    op: "not";
+    [k: string]: unknown;
+} | {
+    field: AgentViewField;
+    op: "eq";
+    value: AgentViewValue;
+    [k: string]: unknown;
+} | {
+    field: AgentViewField;
+    op: "in";
+    values: AgentViewValue[];
+    [k: string]: unknown;
+} | {
+    field: AgentViewField;
+    op: "exists";
+    [k: string]: unknown;
+};
+export type AgentViewField = AgentViewBuiltinField | {
+    token: string;
+    [k: string]: unknown;
+};
+export type AgentViewBuiltinField = "status" | "workspace_id" | "tab_id" | "pane_id" | "agent" | "seen" | "state_change_seq";
+export type AgentViewValue = string | boolean | number | {
+    context: AgentViewContext;
+    [k: string]: unknown;
+};
+export type AgentViewContext = "current_workspace_id" | "current_tab_id";
+export type AgentViewSortField = AgentViewBuiltinSortField | {
+    token: string;
+    [k: string]: unknown;
+};
+export type AgentViewBuiltinSortField = "workspace_order" | "tab_order" | "pane_order" | "attention" | "status" | "agent" | "seen" | "state_change_seq";
+export type ClientWindowTitleReason = "set" | "cleared" | "no_foreground_client";
+export type ConfigReloadStatus = "applied" | "partial" | "failed";
+export type Subscription = {
+    type: "workspace.created";
+    [k: string]: unknown;
+} | {
+    type: "workspace.updated";
+    [k: string]: unknown;
+} | {
+    type: "workspace.metadata_updated";
+    [k: string]: unknown;
+} | {
+    type: "workspace.renamed";
+    [k: string]: unknown;
+} | {
+    type: "workspace.moved";
+    [k: string]: unknown;
+} | {
+    type: "workspace.reordered";
+    [k: string]: unknown;
+} | {
+    type: "workspace.closed";
+    [k: string]: unknown;
+} | {
+    type: "workspace.focused";
+    [k: string]: unknown;
+} | {
+    type: "worktree.created";
+    [k: string]: unknown;
+} | {
+    type: "worktree.opened";
+    [k: string]: unknown;
+} | {
+    type: "worktree.removed";
+    [k: string]: unknown;
+} | {
+    type: "tab.created";
+    [k: string]: unknown;
+} | {
+    type: "tab.closed";
+    [k: string]: unknown;
+} | {
+    type: "tab.focused";
+    [k: string]: unknown;
+} | {
+    type: "tab.renamed";
+    [k: string]: unknown;
+} | {
+    type: "tab.moved";
+    [k: string]: unknown;
+} | {
+    type: "pane.created";
+    [k: string]: unknown;
+} | {
+    type: "pane.closed";
+    [k: string]: unknown;
+} | {
+    type: "pane.updated";
+    [k: string]: unknown;
+} | {
+    type: "pane.focused";
+    [k: string]: unknown;
+} | {
+    type: "pane.moved";
+    [k: string]: unknown;
+} | {
+    type: "pane.exited";
+    [k: string]: unknown;
+} | {
+    type: "pane.agent_detected";
+    [k: string]: unknown;
+} | {
+    lines?: number | null;
+    match: OutputMatch;
+    pane_id: string;
+    source: ReadSource;
+    strip_ansi?: boolean;
+    type: "pane.output_matched";
+    [k: string]: unknown;
+} | {
+    agent_status?: AgentStatus | null;
+    pane_id: string;
+    type: "pane.agent_status_changed";
+    [k: string]: unknown;
+} | {
+    pane_id: string;
+    type: "pane.scroll_changed";
+    [k: string]: unknown;
+} | {
+    type: "layout.updated";
+    [k: string]: unknown;
+};
+export type OutputMatch = {
+    type: "substring";
+    value: string;
+    [k: string]: unknown;
+} | {
+    type: "regex";
+    value: string;
+    [k: string]: unknown;
+};
+export type EventMatch = {
+    event: "workspace_created";
+    workspace_id?: string | null;
+    [k: string]: unknown;
+} | {
+    event: "workspace_updated";
+    workspace_id: string;
+    [k: string]: unknown;
+} | {
+    event: "workspace_closed";
+    workspace_id: string;
+    [k: string]: unknown;
+} | {
+    event: "workspace_renamed";
+    label?: string | null;
+    workspace_id: string;
+    [k: string]: unknown;
+} | {
+    event: "workspace_moved";
+    workspace_id: string;
+    [k: string]: unknown;
+} | {
+    event: "workspace_focused";
+    workspace_id: string;
+    [k: string]: unknown;
+} | {
+    event: "tab_created";
+    tab_id?: string | null;
+    workspace_id?: string | null;
+    [k: string]: unknown;
+} | {
+    event: "tab_closed";
+    tab_id: string;
+    [k: string]: unknown;
+} | {
+    event: "tab_renamed";
+    label?: string | null;
+    tab_id: string;
+    [k: string]: unknown;
+} | {
+    event: "tab_moved";
+    tab_id: string;
+    [k: string]: unknown;
+} | {
+    event: "tab_focused";
+    tab_id: string;
+    [k: string]: unknown;
+} | {
+    event: "pane_created";
+    pane_id?: string | null;
+    workspace_id?: string | null;
+    [k: string]: unknown;
+} | {
+    event: "pane_closed";
+    pane_id: string;
+    [k: string]: unknown;
+} | {
+    event: "pane_focused";
+    pane_id: string;
+    [k: string]: unknown;
+} | {
+    event: "pane_moved";
+    pane_id: string;
+    [k: string]: unknown;
+} | {
+    event: "pane_output_changed";
+    min_revision?: number | null;
+    pane_id: string;
+    [k: string]: unknown;
+} | {
+    event: "pane_exited";
+    pane_id: string;
+    [k: string]: unknown;
+} | {
+    agent?: string | null;
+    event: "pane_agent_detected";
+    pane_id: string;
+    [k: string]: unknown;
+} | {
+    agent_status: AgentStatus;
+    event: "pane_agent_status_changed";
+    pane_id: string;
+    [k: string]: unknown;
+};
+export type IntegrationTarget = "pi" | "omp" | "claude" | "codex" | "copilot" | "devin" | "droid" | "kimi" | "opencode" | "kilo" | "hermes" | "qodercli" | "qwen" | "cursor" | "mastracode" | "antigravity_cli" | "grok";
+export type IntegrationState = "not_installed" | "current" | "outdated";
+export type LayoutNode = {
+    command?: string[] | null;
+    cwd?: string | null;
+    env?: {
+        [k: string]: string;
+    };
+    label?: string | null;
+    pane_id?: string | null;
+    type: "pane";
+    [k: string]: unknown;
+} | {
+    direction: SplitDirection;
+    first: LayoutNode;
+    ratio: number;
+    second: LayoutNode;
+    type: "split";
+    [k: string]: unknown;
+};
+export type SplitDirection = "right" | "down";
+export type ResponseLayoutNode = {
+    command?: string[] | null;
+    cwd?: string | null;
+    env?: {
+        [k: string]: string;
+    };
+    label?: string | null;
+    pane_id?: string | null;
+    type: "pane";
+    [k: string]: unknown;
+} | {
+    direction: SplitDirection;
+    first: ResponseLayoutNode;
+    ratio: number;
+    second: ResponseLayoutNode;
+    type: "split";
+    [k: string]: unknown;
+};
+export type ToastHerdrPosition = "top-left" | "top-right" | "bottom-left" | "bottom-right";
+export type NotificationShowSound = "none" | "done" | "request";
+export type NotificationShowReason = "shown" | "disabled" | "rate_limited" | "no_foreground_client" | "busy";
+export type ReadFormat = "text" | "ansi";
+export type PaneCopyMotion = "line_end" | "first_non_blank" | "next_word_start" | "previous_word_start" | "next_word_end" | "next_big_word_start" | "previous_big_word_start" | "next_big_word_end" | "previous_paragraph" | "next_paragraph";
+export type PaneCopySearchDirection = "forward" | "backward";
+export type PaneDirection = "left" | "right" | "up" | "down";
+export type PaneFocusDirectionReason = "no_neighbor";
+export type PaneGraphicsFormat = "png" | "rgb" | "rgba" | "bgra";
+export type PaneRightClickTarget = "herdr" | "pane";
+export type PaneMoveDestination = {
+    ratio?: number | null;
+    split: SplitDirection;
+    tab_id: string;
+    target_pane_id?: string | null;
+    type: "tab";
+    [k: string]: unknown;
+} | {
+    label?: string | null;
+    type: "new_tab";
+    workspace_id?: string | null;
+    [k: string]: unknown;
+} | {
+    label?: string | null;
+    tab_label?: string | null;
+    type: "new_workspace";
+    [k: string]: unknown;
+};
+export type PaneMoveReason = "same_tab" | "zoomed_tab";
+export type PaneAgentState = "idle" | "working" | "blocked" | "unknown";
+export type PaneResizeReason = "unchanged";
+export type PaneSwapReason = "no_neighbor" | "same_pane" | "not_found" | "cross_tab";
+export type PaneZoomReason = "single_pane" | "already_zoomed" | "already_unzoomed";
+export type PluginActionContext = "global" | "workspace" | "tab" | "pane" | "selection";
+export type PluginPlatform = "linux" | "macos" | "windows";
+export type PluginCommandStatus = "running" | "succeeded" | "failed";
+export type PopupSize = number | string;
+export type PluginPanePlacement = "overlay" | "popup" | "split" | "tab" | "zoomed";
+export type EventData = {
+    type: "workspace_created";
+    workspace: WorkspaceInfo;
+    [k: string]: unknown;
+} | {
+    type: "workspace_updated";
+    workspace: WorkspaceInfo;
+    [k: string]: unknown;
+} | {
+    type: "workspace_metadata_updated";
+    workspace: WorkspaceInfo;
+    [k: string]: unknown;
+} | {
+    type: "workspace_closed";
+    workspace?: WorkspaceInfo | null;
+    workspace_id: string;
+    [k: string]: unknown;
+} | {
+    label: string;
+    type: "workspace_renamed";
+    workspace_id: string;
+    [k: string]: unknown;
+} | {
+    insert_index: number;
+    type: "workspace_moved";
+    workspace_id: string;
+    workspaces: WorkspaceInfo[];
+    [k: string]: unknown;
+} | {
+    before_workspace_id?: string | null;
+    type: "workspace_reordered";
+    workspace_ids: string[];
+    workspaces: WorkspaceInfo[];
+    [k: string]: unknown;
+} | {
+    type: "workspace_focused";
+    workspace_id: string;
+    [k: string]: unknown;
+} | {
+    type: "worktree_created";
+    workspace: WorkspaceInfo;
+    worktree: WorktreeInfo;
+    [k: string]: unknown;
+} | {
+    already_open: boolean;
+    type: "worktree_opened";
+    workspace: WorkspaceInfo;
+    worktree: WorktreeInfo;
+    [k: string]: unknown;
+} | {
+    forced: boolean;
+    type: "worktree_removed";
+    workspace?: WorkspaceInfo | null;
+    workspace_id: string;
+    worktree: WorktreeInfo;
+    [k: string]: unknown;
+} | {
+    tab: TabInfo;
+    type: "tab_created";
+    [k: string]: unknown;
+} | {
+    tab_id: string;
+    type: "tab_closed";
+    workspace_id: string;
+    [k: string]: unknown;
+} | {
+    label: string;
+    tab_id: string;
+    type: "tab_renamed";
+    workspace_id: string;
+    [k: string]: unknown;
+} | {
+    insert_index: number;
+    tab_id: string;
+    tabs: TabInfo[];
+    type: "tab_moved";
+    workspace_id: string;
+    [k: string]: unknown;
+} | {
+    tab_id: string;
+    type: "tab_focused";
+    workspace_id: string;
+    [k: string]: unknown;
+} | {
+    pane: PaneInfo;
+    type: "pane_created";
+    [k: string]: unknown;
+} | {
+    pane_id: string;
+    type: "pane_closed";
+    workspace_id: string;
+    [k: string]: unknown;
+} | {
+    pane: PaneInfo;
+    type: "pane_updated";
+    [k: string]: unknown;
+} | {
+    pane_id: string;
+    type: "pane_focused";
+    workspace_id: string;
+    [k: string]: unknown;
+} | {
+    closed_tab_id?: string | null;
+    closed_workspace_id?: string | null;
+    created_tab?: TabInfo | null;
+    created_workspace?: WorkspaceInfo | null;
+    pane: PaneInfo;
+    previous_pane_id: string;
+    previous_tab_id: string;
+    previous_workspace_id: string;
+    type: "pane_moved";
+    [k: string]: unknown;
+} | {
+    pane_id: string;
+    revision: number;
+    type: "pane_output_changed";
+    workspace_id: string;
+    [k: string]: unknown;
+} | {
+    pane_id: string;
+    type: "pane_exited";
+    workspace_id: string;
+    [k: string]: unknown;
+} | {
+    agent?: string | null;
+    final_status?: AgentStatus | null;
+    pane_id: string;
+    released?: boolean;
+    type: "pane_agent_detected";
+    workspace_id: string;
+    [k: string]: unknown;
+} | {
+    agent?: string | null;
+    agent_status: AgentStatus;
+    display_agent?: string | null;
+    pane_id: string;
+    state_labels?: {
+        [k: string]: string;
+    };
+    title?: string | null;
+    type: "pane_agent_status_changed";
+    workspace_id: string;
+    [k: string]: unknown;
+} | {
+    layout: PaneLayoutSnapshot;
+    type: "layout_updated";
+    [k: string]: unknown;
+};
+export type EventKind = "workspace_created" | "workspace_updated" | "workspace_metadata_updated" | "workspace_closed" | "workspace_renamed" | "workspace_moved" | "workspace_reordered" | "workspace_focused" | "worktree_created" | "worktree_opened" | "worktree_removed" | "tab_created" | "tab_closed" | "tab_renamed" | "tab_moved" | "tab_focused" | "pane_created" | "pane_closed" | "pane_updated" | "pane_focused" | "pane_moved" | "pane_output_changed" | "pane_exited" | "pane_agent_detected" | "pane_agent_status_changed" | "layout_updated";
+export interface AgentExplainResponse {
+    explain: unknown;
+    type: "agent_explain";
+    [k: string]: unknown;
+}
+export interface AgentInfoResponse {
+    agent: AgentInfo;
+    type: "agent_info";
+    [k: string]: unknown;
+}
+export interface AgentInfo {
+    agent?: string | null;
+    agent_session?: AgentSessionInfo | null;
+    agent_status: AgentStatus;
+    cwd?: string | null;
+    display_agent?: string | null;
+    focused: boolean;
+    foreground_cwd?: string | null;
+    interactive_ready?: boolean;
+    launch_pending?: boolean;
+    name?: string | null;
+    pane_id: string;
+    revision: number;
+    screen_detection_skipped?: boolean;
+    state_change_seq?: number;
+    state_labels?: {
+        [k: string]: string;
+    };
+    tab_id: string;
+    terminal_id: string;
+    terminal_title?: string | null;
+    terminal_title_stripped?: string | null;
+    title?: string | null;
+    tokens?: {
+        [k: string]: string;
+    };
+    workspace_id: string;
+    [k: string]: unknown;
+}
+export interface AgentSessionInfo {
+    agent: string;
+    kind: AgentSessionRefKind;
+    source: string;
+    value: string;
+    [k: string]: unknown;
+}
+export interface AgentListResponse {
+    agents: AgentInfo[];
+    type: "agent_list";
+    [k: string]: unknown;
+}
+export interface AgentManifestReloadResponse {
+    manifests: AgentManifestInfo[];
+    type: "agent_manifest_reload";
+    [k: string]: unknown;
+}
+export interface AgentManifestInfo {
+    active_version?: string | null;
+    agent: string;
+    cached_remote_version?: string | null;
+    local_override_shadowing_remote: boolean;
+    remote_last_checked_unix?: number | null;
+    remote_update_error?: string | null;
+    remote_update_result?: string | null;
+    source: string;
+    source_kind: string;
+    warning?: string | null;
+    [k: string]: unknown;
+}
+export interface AgentManifestStatusResponse {
+    last_check_unix?: number | null;
+    last_result?: string | null;
+    manifests: AgentManifestInfo[];
+    type: "agent_manifest_status";
+    [k: string]: unknown;
+}
+export interface AgentPromptParams {
+    target: string;
+    text: string;
+    wait?: AgentPromptWaitOptions | null;
+    [k: string]: unknown;
+}
+export interface AgentPromptWaitOptions {
+    timeout_ms?: number | null;
+    until?: AgentStatus[];
+    [k: string]: unknown;
+}
+export interface AgentPromptedResponse {
+    agent: AgentInfo;
+    type: "agent_prompted";
+    [k: string]: unknown;
+}
+export interface AgentReadParams {
+    format?: "text" | "ansi";
+    lines?: number | null;
+    source: ReadSource;
+    strip_ansi?: boolean;
+    target: string;
+    [k: string]: unknown;
+}
+export interface AgentRenameParams {
+    name?: string | null;
+    target: string;
+    [k: string]: unknown;
+}
+export interface AgentSendKeysParams {
+    keys: string[];
+    target: string;
+    [k: string]: unknown;
+}
+export interface AgentStartParams {
+    args?: string[];
+    kind: string;
+    name: string;
+    pane_id: string;
+    /**
+     * Startup timeout in milliseconds. Values must be greater than 3000 and at most 300000.
+     */
+    timeout_ms?: number | null;
+    [k: string]: unknown;
+}
+export interface AgentStartedResponse {
+    agent: AgentInfo;
+    argv: string[];
+    type: "agent_started";
+    [k: string]: unknown;
+}
+export interface AgentTarget {
+    target: string;
+    [k: string]: unknown;
+}
+export interface AgentViewClearParams {
+    source?: string | null;
+    [k: string]: unknown;
+}
+export interface AgentViewResponse {
+    active: boolean;
+    label?: string | null;
+    source?: string | null;
+    type: "agent_view";
+    [k: string]: unknown;
+}
+export interface AgentViewSetParams {
+    filter?: AgentViewFilter | null;
+    label?: string | null;
+    sort?: AgentViewSort[];
+    source: string;
+    [k: string]: unknown;
+}
+export interface AgentViewSort {
+    field: AgentViewSortField;
+    order?: "asc" | "desc";
+    [k: string]: unknown;
+}
+export interface AgentWaitParams {
+    target: string;
+    timeout_ms?: number | null;
+    until?: AgentStatus[];
+    [k: string]: unknown;
+}
+/**
+ * Updates whether the requesting client shell receives and controls pane presentation.
+ */
+export interface ClientShellSurfaceSetParams {
+    active: boolean;
+    [k: string]: unknown;
+}
+/**
+ * Acknowledgement for the client-shell surface interest lease. This method is new on the
+ * endpoint protocol, so its revision-bearing result can establish an activation floor.
+ */
+export interface ClientShellSurfaceSetResponse {
+    active: boolean;
+    projection_revision: number;
+    type: "client_shell_surface_set";
+    [k: string]: unknown;
+}
+export interface ClientWindowTitleResponse {
+    changed: boolean;
+    reason: ClientWindowTitleReason;
+    type: "client_window_title";
+    [k: string]: unknown;
+}
+export interface ClientWindowTitleSetParams {
+    title: string;
+    [k: string]: unknown;
+}
+export interface CommandInvokeParams {
+    /**
+     * Opaque endpoint-issued command identifier from the client-shell projection.
+     */
+    command_id: string;
+    pane_id?: string | null;
+    /**
+     * Client-owned selection coordinates, validated against the pane's content revision.
+     */
+    selection?: PaneSelectionReadParams | null;
+    tab_id?: string | null;
+    workspace_id?: string | null;
+    [k: string]: unknown;
+}
+export interface PaneSelectionReadParams {
+    anchor: PaneTextPoint;
+    content_revision?: number | null;
+    cursor: PaneTextPoint;
+    pane_id: string;
+    [k: string]: unknown;
+}
+export interface PaneTextPoint {
+    col: number;
+    row: number;
+    [k: string]: unknown;
+}
+export interface ConfigReloadResponse {
+    diagnostics: string[];
+    status: ConfigReloadStatus;
+    type: "config_reload";
+    [k: string]: unknown;
+}
+export interface EmptyParams {
+    [k: string]: unknown;
+}
+export interface EventsSubscribeParams {
+    subscriptions: Subscription[];
+    [k: string]: unknown;
+}
+export interface EventsWaitParams {
+    match_event: EventMatch;
+    timeout_ms?: number | null;
+    [k: string]: unknown;
+}
+export interface IntegrationInstallParams {
+    target: IntegrationTarget;
+    [k: string]: unknown;
+}
+export interface IntegrationInstallResponse {
+    details: IntegrationInstallResult;
+    target: IntegrationTarget;
+    type: "integration_install";
+    [k: string]: unknown;
+}
+export interface IntegrationInstallResult {
+    messages: string[];
+    [k: string]: unknown;
+}
+export interface IntegrationListResponse {
+    integrations: IntegrationInfo[];
+    type: "integration_list";
+    [k: string]: unknown;
+}
+export interface IntegrationInfo {
+    available: boolean;
+    command: string;
+    label: string;
+    state: IntegrationState;
+    target: IntegrationTarget;
+    [k: string]: unknown;
+}
+export interface IntegrationUninstallParams {
+    target: IntegrationTarget;
+    [k: string]: unknown;
+}
+export interface IntegrationUninstallResponse {
+    details: IntegrationUninstallResult;
+    target: IntegrationTarget;
+    type: "integration_uninstall";
+    [k: string]: unknown;
+}
+export interface IntegrationUninstallResult {
+    messages: string[];
+    [k: string]: unknown;
+}
+export interface LayoutApplyParams {
+    focus?: boolean;
+    root: LayoutNode;
+    tab_id?: string | null;
+    tab_label?: string | null;
+    workspace_id?: string | null;
+    [k: string]: unknown;
+}
+export interface LayoutApplyResponse {
+    layout: LayoutDescription;
+    type: "layout_apply";
+    [k: string]: unknown;
+}
+export interface LayoutDescription {
+    focused_pane_id: string;
+    root: ResponseLayoutNode;
+    tab_id: string;
+    workspace_id: string;
+    zoomed: boolean;
+    [k: string]: unknown;
+}
+export interface LayoutExportParams {
+    pane_id?: string | null;
+    tab_id?: string | null;
+    [k: string]: unknown;
+}
+export interface LayoutExportResponse {
+    layout: LayoutDescription;
+    type: "layout_export";
+    [k: string]: unknown;
+}
+export interface LayoutSetSplitRatioParams {
+    pane_id?: string | null;
+    path: boolean[];
+    ratio: number;
+    tab_id?: string | null;
+    [k: string]: unknown;
+}
+export interface LayoutSplitRatioSetResponse {
+    layout: LayoutDescription;
+    type: "layout_split_ratio_set";
+    [k: string]: unknown;
+}
+export interface NotificationShowParams {
+    body?: string | null;
+    position?: ToastHerdrPosition | null;
+    sound?: NotificationShowSound;
+    title: string;
+    [k: string]: unknown;
+}
+export interface NotificationShowResponse {
+    reason: NotificationShowReason;
+    shown: boolean;
+    type: "notification_show";
+    [k: string]: unknown;
+}
+export interface OkResponse {
+    type: "ok";
+    [k: string]: unknown;
+}
+export interface OutputMatchedResponse {
+    matched_line?: string | null;
+    pane_id: string;
+    read: PaneReadResult;
+    revision: number;
+    type: "output_matched";
+    [k: string]: unknown;
+}
+export interface PaneReadResult {
+    format: ReadFormat;
+    pane_id: string;
+    revision: number;
+    source: ReadSource;
+    tab_id: string;
+    text: string;
+    truncated: boolean;
+    workspace_id: string;
+    [k: string]: unknown;
+}
+export interface PaneClearAgentAuthorityParams {
+    pane_id: string;
+    seq?: number | null;
+    source?: string | null;
+    [k: string]: unknown;
+}
+export interface PaneCopyMotionParams {
+    content_revision?: number | null;
+    cursor: PaneTextPoint;
+    motion: PaneCopyMotion;
+    pane_id: string;
+    [k: string]: unknown;
+}
+export interface PaneCopyMotionResponse {
+    content_revision: number;
+    cursor: PaneTextPoint;
+    pane_id: string;
+    type: "pane_copy_motion";
+    [k: string]: unknown;
+}
+export interface PaneCopySearchParams {
+    content_revision: number;
+    cursor: PaneTextPoint;
+    direction: PaneCopySearchDirection;
+    pane_id: string;
+    previous?: PaneTextRange | null;
+    query: string;
+    [k: string]: unknown;
+}
+export interface PaneTextRange {
+    end: PaneTextPoint;
+    start: PaneTextPoint;
+    [k: string]: unknown;
+}
+export interface PaneCopySearchResponse {
+    content_revision: number;
+    current?: number | null;
+    current_global?: number | null;
+    matches: ResponsePaneTextRange[];
+    pane_id: string;
+    total: number;
+    type: "pane_copy_search";
+    [k: string]: unknown;
+}
+export interface ResponsePaneTextRange {
+    end: PaneTextPoint;
+    start: PaneTextPoint;
+    [k: string]: unknown;
+}
+export interface PaneCurrentParams {
+    caller_pane_id?: string | null;
+    [k: string]: unknown;
+}
+export interface PaneCurrentResponse {
+    pane: PaneInfo;
+    type: "pane_current";
+    [k: string]: unknown;
+}
+export interface PaneInfo {
+    agent?: string | null;
+    agent_session?: AgentSessionInfo | null;
+    agent_status: AgentStatus;
+    cwd?: string | null;
+    display_agent?: string | null;
+    focused: boolean;
+    foreground_cwd?: string | null;
+    label?: string | null;
+    pane_id: string;
+    revision: number;
+    scroll?: PaneScrollInfo | null;
+    state_labels?: {
+        [k: string]: string;
+    };
+    tab_id: string;
+    terminal_id: string;
+    terminal_title?: string | null;
+    terminal_title_stripped?: string | null;
+    title?: string | null;
+    tokens?: {
+        [k: string]: string;
+    };
+    workspace_id: string;
+    [k: string]: unknown;
+}
+export interface PaneScrollInfo {
+    max_offset_from_bottom: number;
+    offset_from_bottom: number;
+    viewport_rows: number;
+    [k: string]: unknown;
+}
+export interface PaneEdgesParams {
+    pane_id?: string | null;
+    [k: string]: unknown;
+}
+export interface PaneEdgesResponse {
+    edges: PaneEdgesResult;
+    type: "pane_edges";
+    [k: string]: unknown;
+}
+export interface PaneEdgesResult {
+    down: boolean;
+    layout: PaneLayoutSnapshot;
+    left: boolean;
+    pane_id: string;
+    right: boolean;
+    up: boolean;
+    [k: string]: unknown;
+}
+export interface PaneLayoutSnapshot {
+    area: PaneLayoutRect;
+    focused_pane_id: string;
+    panes: PaneLayoutPane[];
+    splits: PaneLayoutSplit[];
+    tab_id: string;
+    workspace_id: string;
+    zoomed: boolean;
+    [k: string]: unknown;
+}
+export interface PaneLayoutRect {
+    height: number;
+    width: number;
+    x: number;
+    y: number;
+    [k: string]: unknown;
+}
+export interface PaneLayoutPane {
+    focused: boolean;
+    pane_id: string;
+    rect: PaneLayoutRect;
+    [k: string]: unknown;
+}
+export interface PaneLayoutSplit {
+    direction: SplitDirection;
+    id: string;
+    ratio: number;
+    rect: PaneLayoutRect;
+    [k: string]: unknown;
+}
+export interface PaneFocusDirectionParams {
+    direction: PaneDirection;
+    pane_id?: string | null;
+    [k: string]: unknown;
+}
+export interface PaneFocusDirectionResponse {
+    focus: PaneFocusDirectionResult;
+    type: "pane_focus_direction";
+    [k: string]: unknown;
+}
+export interface PaneFocusDirectionResult {
+    changed: boolean;
+    focused_pane_id?: string | null;
+    layout: PaneLayoutSnapshot;
+    reason?: PaneFocusDirectionReason | null;
+    source_pane_id: string;
+    [k: string]: unknown;
+}
+export interface PaneGraphicsClearParams {
+    layer_id?: string | null;
+    pane_id: string;
+    [k: string]: unknown;
+}
+export interface PaneGraphicsInfoResponse {
+    cell_height_px: number;
+    cell_width_px: number;
+    /**
+     * Accepts damage metadata while still consuming a complete canonical file.
+     */
+    file_frame_damage?: boolean;
+    file_frame_direct_max_bytes?: number | null;
+    file_frame_directory?: string | null;
+    file_frame_formats?: string[];
+    file_frame_max_bytes?: number | null;
+    file_frame_transport?: string | null;
+    max_layers_per_pane?: number;
+    /**
+     * True only when this pane is on the currently rendered terminal surface.
+     */
+    pane_visible: boolean;
+    pixel_mouse?: boolean;
+    type: "pane_graphics_info";
+    [k: string]: unknown;
+}
+export interface PaneGraphicsSetParams {
+    data_base64?: string;
+    format: PaneGraphicsFormat;
+    image_height: number;
+    image_width: number;
+    layer_id?: string | null;
+    pane_id: string;
+    placement?: PaneGraphicsPlacementParams;
+    z_index?: number;
+    [k: string]: unknown;
+}
+export interface PaneGraphicsPlacementParams {
+    grid_cols?: number;
+    grid_rows?: number;
+    viewport_col?: number;
+    viewport_row?: number;
+    [k: string]: unknown;
+}
+export interface PaneInfoResponse {
+    pane: PaneInfo;
+    type: "pane_info";
+    [k: string]: unknown;
+}
+export interface PaneInputSetParams {
+    pane_id: string;
+    right_click: PaneRightClickTarget;
+    [k: string]: unknown;
+}
+export interface PaneLayoutParams {
+    pane_id?: string | null;
+    [k: string]: unknown;
+}
+export interface PaneLayoutResponse {
+    layout: PaneLayoutSnapshot;
+    type: "pane_layout";
+    [k: string]: unknown;
+}
+export interface PaneLinkActivateParams {
+    col: number;
+    content_revision?: number | null;
+    offset_from_bottom?: number | null;
+    pane_id: string;
+    viewport_row: number;
+    [k: string]: unknown;
+}
+export interface PaneLinkActivatedResponse {
+    handled: boolean;
+    type: "pane_link_activated";
+    url?: string | null;
+    [k: string]: unknown;
+}
+export interface PaneLinkResolvedResponse {
+    regions: PaneLinkRegion[];
+    type: "pane_link_resolved";
+    [k: string]: unknown;
+}
+/**
+ * Inclusive display-cell columns on a pane's current viewport.
+ */
+export interface PaneLinkRegion {
+    end_col: number;
+    row: number;
+    start_col: number;
+    [k: string]: unknown;
+}
+export interface PaneListParams {
+    workspace_id?: string | null;
+    [k: string]: unknown;
+}
+export interface PaneListResponse {
+    panes: PaneInfo[];
+    type: "pane_list";
+    [k: string]: unknown;
+}
+export interface PaneMoveParams {
+    destination: PaneMoveDestination;
+    focus?: boolean;
+    pane_id: string;
+    [k: string]: unknown;
+}
+export interface PaneMoveResponse {
+    move_result: PaneMoveResult;
+    type: "pane_move";
+    [k: string]: unknown;
+}
+export interface PaneMoveResult {
+    changed: boolean;
+    closed_tab_id?: string | null;
+    closed_workspace_id?: string | null;
+    created_tab?: TabInfo | null;
+    created_workspace?: WorkspaceInfo | null;
+    focused_pane_id: string;
+    pane: PaneInfo;
+    previous_pane_id: string;
+    previous_tab_id: string;
+    previous_workspace_id: string;
+    reason?: PaneMoveReason | null;
+    source_layout?: PaneLayoutSnapshot | null;
+    target_layout: PaneLayoutSnapshot;
+    [k: string]: unknown;
+}
+export interface TabInfo {
+    agent_status: AgentStatus;
+    focused: boolean;
+    label: string;
+    number: number;
+    pane_count: number;
+    tab_id: string;
+    workspace_id: string;
+    [k: string]: unknown;
+}
+export interface WorkspaceInfo {
+    active_tab_id: string;
+    agent_status: AgentStatus;
+    focused: boolean;
+    label: string;
+    number: number;
+    pane_count: number;
+    tab_count: number;
+    tokens?: {
+        [k: string]: string;
+    };
+    workspace_id: string;
+    worktree?: WorkspaceWorktreeInfo | null;
+    [k: string]: unknown;
+}
+export interface WorkspaceWorktreeInfo {
+    checkout_path: string;
+    is_linked_worktree: boolean;
+    repo_key: string;
+    repo_name: string;
+    repo_root: string;
+    [k: string]: unknown;
+}
+export interface PaneNeighborParams {
+    direction: PaneDirection;
+    pane_id?: string | null;
+    [k: string]: unknown;
+}
+export interface PaneNeighborResponse {
+    neighbor: PaneNeighborResult;
+    type: "pane_neighbor";
+    [k: string]: unknown;
+}
+export interface PaneNeighborResult {
+    direction: PaneDirection;
+    layout: PaneLayoutSnapshot;
+    neighbor_pane_id?: string | null;
+    pane_id: string;
+    [k: string]: unknown;
+}
+export interface PaneProcessInfoParams {
+    pane_id?: string | null;
+    [k: string]: unknown;
+}
+export interface PaneProcessInfoResponse {
+    process_info: PaneProcessInfo;
+    type: "pane_process_info";
+    [k: string]: unknown;
+}
+export interface PaneProcessInfo {
+    foreground_process_group_id?: number | null;
+    foreground_processes?: PaneProcessInfoProcess[];
+    pane_id: string;
+    shell_pid?: number | null;
+    tty?: string | null;
+    [k: string]: unknown;
+}
+export interface PaneProcessInfoProcess {
+    argv?: string[] | null;
+    argv0?: string | null;
+    cmdline?: string | null;
+    cwd?: string | null;
+    name: string;
+    pid: number;
+    [k: string]: unknown;
+}
+export interface PaneReadParams {
+    format?: "text" | "ansi";
+    lines?: number | null;
+    pane_id: string;
+    source: ReadSource;
+    strip_ansi?: boolean;
+    [k: string]: unknown;
+}
+export interface PaneReadResponse {
+    read: PaneReadResult;
+    type: "pane_read";
+    [k: string]: unknown;
+}
+export interface PaneReleaseAgentParams {
+    agent: string;
+    pane_id: string;
+    seq?: number | null;
+    source: string;
+    [k: string]: unknown;
+}
+export interface PaneRenameParams {
+    label?: string | null;
+    pane_id: string;
+    [k: string]: unknown;
+}
+export interface PaneReportAgentParams {
+    agent: string;
+    agent_session_id?: string | null;
+    agent_session_path?: string | null;
+    message?: string | null;
+    pane_id: string;
+    seq?: number | null;
+    source: string;
+    state: PaneAgentState;
+    [k: string]: unknown;
+}
+export interface PaneReportAgentSessionParams {
+    agent: string;
+    agent_session_id?: string | null;
+    agent_session_path?: string | null;
+    pane_id: string;
+    seq?: number | null;
+    session_start_source?: string | null;
+    source: string;
+    [k: string]: unknown;
+}
+export interface PaneReportMetadataParams {
+    agent?: string | null;
+    applies_to_source?: string | null;
+    clear_display_agent?: boolean;
+    clear_state_labels?: boolean;
+    clear_title?: boolean;
+    display_agent?: string | null;
+    pane_id: string;
+    seq?: number | null;
+    source: string;
+    state_labels?: {
+        [k: string]: string;
+    };
+    title?: string | null;
+    tokens?: {
+        [k: string]: string | null;
+    };
+    ttl_ms?: number | null;
+    [k: string]: unknown;
+}
+export interface PaneResizeParams {
+    amount?: number | null;
+    direction: PaneDirection;
+    pane_id?: string | null;
+    [k: string]: unknown;
+}
+export interface PaneResizeResponse {
+    resize: PaneResizeResult;
+    type: "pane_resize";
+    [k: string]: unknown;
+}
+export interface PaneResizeResult {
+    changed: boolean;
+    focused_pane_id: string;
+    layout: PaneLayoutSnapshot;
+    pane_id: string;
+    reason?: PaneResizeReason | null;
+    [k: string]: unknown;
+}
+export interface PaneScrollParams {
+    offset_from_bottom: number;
+    pane_id: string;
+    [k: string]: unknown;
+}
+export interface PaneSelectionResponse {
+    pane_id: string;
+    text: string;
+    type: "pane_selection";
+    [k: string]: unknown;
+}
+export interface PaneSendInputParams {
+    keys?: string[];
+    pane_id: string;
+    text?: string;
+    [k: string]: unknown;
+}
+export interface PaneSendKeysParams {
+    keys: string[];
+    pane_id: string;
+    [k: string]: unknown;
+}
+export interface PaneSendTextParams {
+    pane_id: string;
+    text: string;
+    [k: string]: unknown;
+}
+export interface PaneSplitParams {
+    cwd?: string | null;
+    direction: SplitDirection;
+    env?: {
+        [k: string]: string;
+    };
+    focus?: boolean;
+    ratio?: number | null;
+    right_click?: "herdr" | "pane";
+    target_pane_id?: string | null;
+    workspace_id?: string | null;
+    [k: string]: unknown;
+}
+export interface PaneSwapParams {
+    direction?: PaneDirection | null;
+    pane_id?: string | null;
+    source_pane_id?: string | null;
+    target_pane_id?: string | null;
+    [k: string]: unknown;
+}
+export interface PaneSwapResponse {
+    swap: PaneSwapResult;
+    type: "pane_swap";
+    [k: string]: unknown;
+}
+export interface PaneSwapResult {
+    changed: boolean;
+    focused_pane_id: string;
+    layout: PaneLayoutSnapshot;
+    reason?: PaneSwapReason | null;
+    source_pane_id: string;
+    target_pane_id?: string | null;
+    [k: string]: unknown;
+}
+export interface PaneTarget {
+    pane_id: string;
+    [k: string]: unknown;
+}
+export interface PaneWaitForOutputParams {
+    lines?: number | null;
+    match: OutputMatch;
+    pane_id: string;
+    source: ReadSource;
+    strip_ansi?: boolean;
+    timeout_ms?: number | null;
+    [k: string]: unknown;
+}
+export interface PaneZoomParams {
+    mode?: "toggle" | "on" | "off";
+    pane_id?: string | null;
+    [k: string]: unknown;
+}
+export interface PaneZoomResponse {
+    type: "pane_zoom";
+    zoom: PaneZoomResult;
+    [k: string]: unknown;
+}
+export interface PaneZoomResult {
+    changed: boolean;
+    focus_changed: boolean;
+    focused_pane_id: string;
+    layout: PaneLayoutSnapshot;
+    pane_id: string;
+    reason?: PaneZoomReason | null;
+    zoom_changed: boolean;
+    zoomed: boolean;
+    [k: string]: unknown;
+}
+export interface PingParams {
+    [k: string]: unknown;
+}
+export interface PluginActionInvokeParams {
+    action_id: string;
+    context?: PluginInvocationContext | null;
+    plugin_id?: string | null;
+    [k: string]: unknown;
+}
+export interface PluginInvocationContext {
+    clicked_url?: string | null;
+    correlation_id?: string | null;
+    focused_pane_agent?: string | null;
+    focused_pane_cwd?: string | null;
+    focused_pane_id?: string | null;
+    focused_pane_status?: AgentStatus | null;
+    invocation_source?: string | null;
+    link_handler_id?: string | null;
+    selected_text?: string | null;
+    tab_id?: string | null;
+    tab_label?: string | null;
+    workspace_cwd?: string | null;
+    workspace_id?: string | null;
+    workspace_label?: string | null;
+    worktree?: WorkspaceWorktreeInfo | null;
+    [k: string]: unknown;
+}
+export interface PluginActionInvokedResponse {
+    action: PluginActionInfo;
+    context: ResponsePluginInvocationContext;
+    log: PluginCommandLogInfo;
+    type: "plugin_action_invoked";
+    [k: string]: unknown;
+}
+export interface PluginActionInfo {
+    action_id: string;
+    command: string[];
+    contexts?: PluginActionContext[];
+    description?: string | null;
+    platforms?: PluginPlatform[] | null;
+    plugin_id: string;
+    title: string;
+    [k: string]: unknown;
+}
+export interface ResponsePluginInvocationContext {
+    clicked_url?: string | null;
+    correlation_id?: string | null;
+    focused_pane_agent?: string | null;
+    focused_pane_cwd?: string | null;
+    focused_pane_id?: string | null;
+    focused_pane_status?: AgentStatus | null;
+    invocation_source?: string | null;
+    link_handler_id?: string | null;
+    selected_text?: string | null;
+    tab_id?: string | null;
+    tab_label?: string | null;
+    workspace_cwd?: string | null;
+    workspace_id?: string | null;
+    workspace_label?: string | null;
+    worktree?: WorkspaceWorktreeInfo | null;
+    [k: string]: unknown;
+}
+export interface PluginCommandLogInfo {
+    action_id?: string | null;
+    command: string[];
+    error?: string | null;
+    event?: string | null;
+    exit_code?: number | null;
+    finished_unix_ms?: number | null;
+    log_id: string;
+    plugin_id: string;
+    started_unix_ms: number;
+    status: PluginCommandStatus;
+    stderr?: string | null;
+    stdout?: string | null;
+    [k: string]: unknown;
+}
+export interface PluginActionListParams {
+    plugin_id?: string | null;
+    [k: string]: unknown;
+}
+export interface PluginActionListResponse {
+    actions: PluginActionInfo[];
+    type: "plugin_action_list";
+    [k: string]: unknown;
+}
+export interface PluginDisabledResponse {
+    plugin: InstalledPluginInfo;
+    type: "plugin_disabled";
+    [k: string]: unknown;
+}
+export interface InstalledPluginInfo {
+    actions?: PluginManifestAction[];
+    build?: PluginManifestBuild[];
+    description?: string | null;
+    enabled: boolean;
+    events?: PluginManifestEventHook[];
+    link_handlers?: PluginManifestLinkHandler[];
+    manifest_path: string;
+    min_herdr_version?: string;
+    name: string;
+    panes?: PluginManifestPane[];
+    platforms?: PluginPlatform[] | null;
+    plugin_id: string;
+    plugin_root: string;
+    source?: ResponsePluginSourceInfo;
+    startup?: PluginManifestStartup[];
+    version: string;
+    /**
+     * Warnings collected at link time or on registry load (e.g. unknown event names,
+     * missing manifest file). Non-fatal — the entry is kept and surfaced by plugin.list.
+     */
+    warnings?: string[];
+    [k: string]: unknown;
+}
+export interface PluginManifestAction {
+    command: string[];
+    contexts?: PluginActionContext[];
+    description?: string | null;
+    id: string;
+    platforms?: PluginPlatform[] | null;
+    title: string;
+    [k: string]: unknown;
+}
+export interface PluginManifestBuild {
+    command: string[];
+    platforms?: PluginPlatform[] | null;
+    [k: string]: unknown;
+}
+export interface PluginManifestEventHook {
+    command: string[];
+    on: string;
+    platforms?: PluginPlatform[] | null;
+    [k: string]: unknown;
+}
+export interface PluginManifestLinkHandler {
+    action: string;
+    id: string;
+    pattern: string;
+    platforms?: PluginPlatform[] | null;
+    title: string;
+    [k: string]: unknown;
+}
+export interface PluginManifestPane {
+    command: string[];
+    description?: string | null;
+    height?: PopupSize | null;
+    id: string;
+    placement?: "overlay" | "popup" | "split" | "tab" | "zoomed";
+    platforms?: PluginPlatform[] | null;
+    title: string;
+    width?: PopupSize | null;
+    [k: string]: unknown;
+}
+export interface ResponsePluginSourceInfo {
+    installed_unix_ms?: number | null;
+    kind?: "local" | "github";
+    managed_path?: string | null;
+    owner?: string | null;
+    repo?: string | null;
+    requested_ref?: string | null;
+    resolved_commit?: string | null;
+    subdir?: string | null;
+    [k: string]: unknown;
+}
+export interface PluginManifestStartup {
+    command: string[];
+    platforms?: PluginPlatform[] | null;
+    [k: string]: unknown;
+}
+export interface PluginEnabledResponse {
+    plugin: InstalledPluginInfo;
+    type: "plugin_enabled";
+    [k: string]: unknown;
+}
+export interface PluginLinkParams {
+    enabled?: boolean;
+    path: string;
+    source?: PluginSourceInfo | null;
+    [k: string]: unknown;
+}
+export interface PluginSourceInfo {
+    installed_unix_ms?: number | null;
+    kind?: "local" | "github";
+    managed_path?: string | null;
+    owner?: string | null;
+    repo?: string | null;
+    requested_ref?: string | null;
+    resolved_commit?: string | null;
+    subdir?: string | null;
+    [k: string]: unknown;
+}
+export interface PluginLinkedResponse {
+    plugin: InstalledPluginInfo;
+    type: "plugin_linked";
+    [k: string]: unknown;
+}
+export interface PluginListParams {
+    plugin_id?: string | null;
+    [k: string]: unknown;
+}
+export interface PluginListResponse {
+    plugins: InstalledPluginInfo[];
+    type: "plugin_list";
+    [k: string]: unknown;
+}
+export interface PluginLogListParams {
+    limit?: number | null;
+    plugin_id?: string | null;
+    [k: string]: unknown;
+}
+export interface PluginLogListResponse {
+    logs: PluginCommandLogInfo[];
+    type: "plugin_log_list";
+    [k: string]: unknown;
+}
+export interface PluginPaneCloseParams {
+    pane_id: string;
+    [k: string]: unknown;
+}
+export interface PluginPaneClosedResponse {
+    pane_id: string;
+    type: "plugin_pane_closed";
+    [k: string]: unknown;
+}
+export interface PluginPaneFocusParams {
+    pane_id: string;
+    [k: string]: unknown;
+}
+export interface PluginPaneFocusedResponse {
+    plugin_pane: PluginPaneInfo;
+    type: "plugin_pane_focused";
+    [k: string]: unknown;
+}
+export interface PluginPaneInfo {
+    entrypoint: string;
+    pane: PaneInfo;
+    plugin_id: string;
+    [k: string]: unknown;
+}
+export interface PluginPaneOpenParams {
+    cwd?: string | null;
+    direction?: SplitDirection | null;
+    entrypoint: string;
+    env?: {
+        [k: string]: string;
+    };
+    focus?: boolean;
+    height?: PopupSize | null;
+    placement?: PluginPanePlacement | null;
+    plugin_id: string;
+    target_pane_id?: string | null;
+    width?: PopupSize | null;
+    workspace_id?: string | null;
+    [k: string]: unknown;
+}
+export interface PluginPaneOpenedResponse {
+    plugin_pane: PluginPaneInfo;
+    type: "plugin_pane_opened";
+    [k: string]: unknown;
+}
+export interface PluginSetEnabledParams {
+    plugin_id: string;
+    [k: string]: unknown;
+}
+export interface PluginUnlinkParams {
+    plugin_id: string;
+    [k: string]: unknown;
+}
+export interface PluginUnlinkedResponse {
+    plugin_id: string;
+    removed: boolean;
+    type: "plugin_unlinked";
+    [k: string]: unknown;
+}
+export interface PongResponse {
+    capabilities?: ServerCapabilities | null;
+    protocol: number;
+    type: "pong";
+    version: string;
+    [k: string]: unknown;
+}
+export interface ServerCapabilities {
+    detached_server_daemon?: boolean;
+    /**
+     * Stable client-owned endpoint generation supported by this server.
+     */
+    endpoint_protocol_generation?: number | null;
+    /**
+     * Whether this server supports endpoint health probes.
+     */
+    health_check?: boolean;
+    live_handoff: boolean;
+    /**
+     * Whether this server supports explicit client-shell surface interest.
+     */
+    surface_interest?: boolean;
+    [k: string]: unknown;
+}
+export interface ProductAnnouncementDismissParams {
+    id: string;
+    version: string;
+    [k: string]: unknown;
+}
+export interface ReleaseNotesDismissParams {
+    version: string;
+    [k: string]: unknown;
+}
+export interface ServerLiveHandoffParams {
+    expected_protocol?: number | null;
+    expected_version?: string | null;
+    import_exe?: string | null;
+    [k: string]: unknown;
+}
+export interface SessionSnapshotResponse {
+    snapshot: SessionSnapshot;
+    type: "session_snapshot";
+    [k: string]: unknown;
+}
+export interface SessionSnapshot {
+    agents: AgentInfo[];
+    focused_pane_id?: string | null;
+    focused_tab_id?: string | null;
+    focused_workspace_id?: string | null;
+    layouts: PaneLayoutSnapshot[];
+    panes: PaneInfo[];
+    protocol: number;
+    tabs: TabInfo[];
+    version: string;
+    workspaces: WorkspaceInfo[];
+    [k: string]: unknown;
+}
+export interface SubscriptionStartedResponse {
+    type: "subscription_started";
+    [k: string]: unknown;
+}
+export interface TabCreateParams {
+    cwd?: string | null;
+    env?: {
+        [k: string]: string;
+    };
+    focus?: boolean;
+    label?: string | null;
+    workspace_id?: string | null;
+    [k: string]: unknown;
+}
+export interface TabCreatedResponse {
+    root_pane: PaneInfo;
+    tab: TabInfo;
+    type: "tab_created";
+    [k: string]: unknown;
+}
+export interface TabInfoResponse {
+    tab: TabInfo;
+    type: "tab_info";
+    [k: string]: unknown;
+}
+export interface TabListParams {
+    workspace_id?: string | null;
+    [k: string]: unknown;
+}
+export interface TabListResponse {
+    tabs: TabInfo[];
+    type: "tab_list";
+    [k: string]: unknown;
+}
+export interface TabMoveParams {
+    insert_index: number;
+    tab_id: string;
+    [k: string]: unknown;
+}
+export interface TabRenameParams {
+    label: string;
+    tab_id: string;
+    [k: string]: unknown;
+}
+export interface TabTarget {
+    tab_id: string;
+    [k: string]: unknown;
+}
+export interface WaitMatchedResponse {
+    event: EventEnvelope;
+    type: "wait_matched";
+    [k: string]: unknown;
+}
+export interface EventEnvelope {
+    data: EventData;
+    event: EventKind;
+    [k: string]: unknown;
+}
+export interface WorktreeInfo {
+    branch?: string | null;
+    is_bare: boolean;
+    is_detached: boolean;
+    is_linked_worktree: boolean;
+    is_prunable: boolean;
+    label: string;
+    open_workspace_id?: string | null;
+    path: string;
+    [k: string]: unknown;
+}
+export interface WorkspaceCloseParams {
+    close_group?: boolean;
+    workspace_id: string;
+    [k: string]: unknown;
+}
+export interface WorkspaceCreateParams {
+    cwd?: string | null;
+    env?: {
+        [k: string]: string;
+    };
+    focus?: boolean;
+    label?: string | null;
+    /**
+     * Workspace whose focused pane supplies the `follow` cwd policy.
+     */
+    source_workspace_id?: string | null;
+    [k: string]: unknown;
+}
+export interface WorkspaceCreatedResponse {
+    root_pane: PaneInfo;
+    tab: TabInfo;
+    type: "workspace_created";
+    workspace: WorkspaceInfo;
+    [k: string]: unknown;
+}
+export interface WorkspaceInfoResponse {
+    type: "workspace_info";
+    workspace: WorkspaceInfo;
+    [k: string]: unknown;
+}
+export interface WorkspaceListResponse {
+    type: "workspace_list";
+    workspaces: WorkspaceInfo[];
+    [k: string]: unknown;
+}
+export interface WorkspaceMoveBlockParams {
+    before_workspace_id?: string | null;
+    workspace_ids: string[];
+    [k: string]: unknown;
+}
+export interface WorkspaceMoveParams {
+    insert_index: number;
+    workspace_id: string;
+    [k: string]: unknown;
+}
+export interface WorkspaceRenameParams {
+    label: string;
+    workspace_id: string;
+    [k: string]: unknown;
+}
+export interface WorkspaceReportMetadataParams {
+    seq?: number | null;
+    source: string;
+    tokens: {
+        [k: string]: string | null;
+    };
+    ttl_ms?: number | null;
+    workspace_id: string;
+    [k: string]: unknown;
+}
+export interface WorkspaceTarget {
+    workspace_id: string;
+    [k: string]: unknown;
+}
+export interface WorktreeCreateParams {
+    base?: string | null;
+    branch?: string | null;
+    cwd?: string | null;
+    focus?: boolean;
+    label?: string | null;
+    path?: string | null;
+    trust_repository?: boolean;
+    workspace_id?: string | null;
+    [k: string]: unknown;
+}
+export interface WorktreeCreatedResponse {
+    root_pane: PaneInfo;
+    tab: TabInfo;
+    type: "worktree_created";
+    workspace: WorkspaceInfo;
+    worktree: WorktreeInfo;
+    [k: string]: unknown;
+}
+export interface WorktreeListParams {
+    cwd?: string | null;
+    trust_repository?: boolean;
+    workspace_id?: string | null;
+    [k: string]: unknown;
+}
+export interface WorktreeListResponse {
+    source: WorktreeSourceInfo;
+    type: "worktree_list";
+    worktrees: WorktreeInfo[];
+    [k: string]: unknown;
+}
+export interface WorktreeSourceInfo {
+    repo_key: string;
+    repo_name: string;
+    repo_root: string;
+    source_checkout_path: string;
+    source_workspace_id?: string | null;
+    [k: string]: unknown;
+}
+export interface WorktreeOpenParams {
+    branch?: string | null;
+    cwd?: string | null;
+    focus?: boolean;
+    label?: string | null;
+    path?: string | null;
+    trust_repository?: boolean;
+    workspace_id?: string | null;
+    [k: string]: unknown;
+}
+export interface WorktreeOpenedResponse {
+    already_open: boolean;
+    root_pane: PaneInfo;
+    tab: TabInfo;
+    type: "worktree_opened";
+    workspace: WorkspaceInfo;
+    worktree: WorktreeInfo;
+    [k: string]: unknown;
+}
+export interface WorktreeRemoveParams {
+    force?: boolean;
+    trust_repository?: boolean;
+    workspace_id: string;
+    [k: string]: unknown;
+}
+export interface WorktreeRemovedResponse {
+    forced: boolean;
+    path: string;
+    type: "worktree_removed";
+    workspace_id: string;
+    [k: string]: unknown;
+}