effect-herdr-sdk 0.0.0-stage → 0.0.1-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 iamdin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,2 @@
+Portions of this package (schema/, scripts/gen/, src/generated/, src/socket-path.ts) are derived from
+@brooswit/herdr-sdk 0.3.0 (https://github.com/brooswit-factory/jsHerdrSDK), MIT License, Copyright brooswit-factory.

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "effect-herdr-sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1-beta.0",
+  "description": "Effect-native client for the herdr socket API. Types generated from herdr's published JSON Schema; forked from @brooswit/herdr-sdk (MIT).",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/iamdin/orchestrate-my-agent-cli.git",
+    "directory": "packages/effect-herdr-sdk"
+  },
+  "files": [
+    "src",
+    "NOTICE",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": "./src/index.ts",
+    "./bun": "./src/bun.ts"
+  },
+  "scripts": {
+    "generate": "bun scripts/gen/index.ts",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.core.json && bun scripts/gen/index.ts --check",
+    "test": "cd ../.. && bun --bun vitest run packages/effect-herdr-sdk"
+  },
+  "dependencies": {
+    "effect": "4.0.2"
+  },
+  "peerDependencies": {
+    "@effect/platform-bun": "4.0.2"
+  },
+  "peerDependenciesMeta": {
+    "@effect/platform-bun": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@effect/platform-bun": "4.0.2"
+  }
+}

package/src/bun.ts

@@ -0,0 +1,9 @@
+// Bun implementations of what the core leaves abstract. The only SDK file that names a runtime.
+import { BunPath, BunSocket } from "@effect/platform-bun"
+import { Layer } from "effect"
+import { SocketConnector } from "./socket-connector.js"
+
+export const layerSocketConnector = Layer.succeed(SocketConnector, (endpoint) => BunSocket.makeNet({ path: endpoint }))
+
+/** Everything `Herdr.layer` needs on Bun. */
+export const layer = Layer.mergeAll(layerSocketConnector, BunPath.layer)

package/src/generated/errors.ts

@@ -0,0 +1,4 @@
+// GENERATED by scripts/gen from schema/herdr-api.schema.json — do not edit.
+// herdr protocol 22, schema_version 1.
+
+export type ErrorBody = { "code": string; "message": string; };

package/src/generated/events.ts

@@ -0,0 +1,59 @@
+// GENERATED by scripts/gen from schema/herdr-api.schema.json — do not edit.
+// herdr protocol 22, schema_version 1.
+
+// ---- session events ----
+export type AgentSessionInfo = { "agent": string; "kind": AgentSessionRefKind; "source": string; "value": string; };
+
+export type AgentSessionRefKind = "id" | "path";
+
+export type AgentStatus = "idle" | "working" | "blocked" | "done" | "unknown";
+
+export type EventData = ({ "type": "workspace_created"; "workspace": WorkspaceInfo; }) | ({ "type": "workspace_updated"; "workspace": WorkspaceInfo; }) | ({ "type": "workspace_metadata_updated"; "workspace": WorkspaceInfo; }) | ({ "type": "workspace_closed"; "workspace"?: (WorkspaceInfo) | (null); "workspace_id": string; }) | ({ "label": string; "type": "workspace_renamed"; "workspace_id": string; }) | ({ "insert_index": number; "type": "workspace_moved"; "workspace_id": string; "workspaces": Array<WorkspaceInfo>; }) | ({ "before_workspace_id"?: string | null; "type": "workspace_reordered"; "workspace_ids": Array<string>; "workspaces": Array<WorkspaceInfo>; }) | ({ "type": "workspace_focused"; "workspace_id": string; }) | ({ "type": "worktree_created"; "workspace": WorkspaceInfo; "worktree": WorktreeInfo; }) | ({ "already_open": boolean; "type": "worktree_opened"; "workspace": WorkspaceInfo; "worktree": WorktreeInfo; }) | ({ "forced": boolean; "type": "worktree_removed"; "workspace"?: (WorkspaceInfo) | (null); "workspace_id": string; "worktree": WorktreeInfo; }) | ({ "tab": TabInfo; "type": "tab_created"; }) | ({ "tab_id": string; "type": "tab_closed"; "workspace_id": string; }) | ({ "label": string; "tab_id": string; "type": "tab_renamed"; "workspace_id": string; }) | ({ "insert_index": number; "tab_id": string; "tabs": Array<TabInfo>; "type": "tab_moved"; "workspace_id": string; }) | ({ "tab_id": string; "type": "tab_focused"; "workspace_id": string; }) | ({ "pane": PaneInfo; "type": "pane_created"; }) | ({ "pane_id": string; "type": "pane_closed"; "workspace_id": string; }) | ({ "pane": PaneInfo; "type": "pane_updated"; }) | ({ "pane_id": string; "type": "pane_focused"; "workspace_id": string; }) | ({ "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"; }) | ({ "pane_id": string; "revision": number; "type": "pane_output_changed"; "workspace_id": string; }) | ({ "pane_id": string; "type": "pane_exited"; "workspace_id": string; }) | ({ "agent"?: string | null; "final_status"?: (AgentStatus) | (null); "pane_id": string; "released"?: boolean; "type": "pane_agent_detected"; "workspace_id": string; }) | ({ "agent"?: string | null; "agent_status": AgentStatus; "display_agent"?: string | null; "pane_id": string; "state_labels"?: { [key: string]: string; }; "title"?: string | null; "type": "pane_agent_status_changed"; "workspace_id": string; }) | ({ "layout": PaneLayoutSnapshot; "type": "layout_updated"; });
+
+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 type 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"?: { [key: string]: string; }; "tab_id": string; "terminal_id": string; "terminal_title"?: string | null; "terminal_title_stripped"?: string | null; "title"?: string | null; "tokens"?: { [key: string]: string; }; "workspace_id": string; };
+
+export type PaneLayoutPane = { "focused": boolean; "pane_id": string; "rect": PaneLayoutRect; };
+
+export type PaneLayoutRect = { "height": number; "width": number; "x": number; "y": number; };
+
+export type PaneLayoutSnapshot = { "area": PaneLayoutRect; "focused_pane_id": string; "panes": Array<PaneLayoutPane>; "splits": Array<PaneLayoutSplit>; "tab_id": string; "workspace_id": string; "zoomed": boolean; };
+
+export type PaneLayoutSplit = { "direction": SplitDirection; "id": string; "ratio": number; "rect": PaneLayoutRect; };
+
+export type PaneScrollInfo = { "max_offset_from_bottom": number; "offset_from_bottom": number; "viewport_rows": number; };
+
+export type SplitDirection = "right" | "down";
+
+export type TabInfo = { "agent_status": AgentStatus; "focused": boolean; "label": string; "number": number; "pane_count": number; "tab_id": string; "workspace_id": string; };
+
+export type WorkspaceInfo = { "active_tab_id": string; "agent_status": AgentStatus; "focused": boolean; "label": string; "number": number; "pane_count": number; "tab_count": number; "tokens"?: { [key: string]: string; }; "workspace_id": string; "worktree"?: (WorkspaceWorktreeInfo) | (null); };
+
+export type WorkspaceWorktreeInfo = { "checkout_path": string; "is_linked_worktree": boolean; "repo_key": string; "repo_name": string; "repo_root": string; };
+
+export type 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; };
+
+export type EventFrame = { event: EventKind; data: EventData };
+
+// ---- subscription-specific events ----
+export type PaneAgentStatusChangedEvent = { "agent"?: string | null; "agent_status": AgentStatus; "display_agent"?: string | null; "pane_id": string; "state_labels"?: { [key: string]: string; }; "title"?: string | null; "workspace_id": string; };
+
+export type PaneOutputMatchedEvent = { "matched_line": string; "pane_id": string; "read": PaneReadResult; };
+
+export type PaneReadResult = { "format": ReadFormat; "pane_id": string; "revision": number; "source": ReadSource; "tab_id": string; "text": string; "truncated": boolean; "workspace_id": string; };
+
+export type PaneScrollChangedEvent = { "pane_id": string; "scroll": PaneScrollInfo; "workspace_id": string; };
+
+export type ReadFormat = "text" | "ansi";
+
+export type ReadSource = "visible" | "recent" | "recent_unwrapped" | "detection";
+
+export type SubscriptionEventData = (PaneOutputMatchedEvent) | (PaneAgentStatusChangedEvent) | (PaneScrollChangedEvent);
+
+export type SubscriptionEventKind = "pane.output_matched" | "pane.agent_status_changed" | "pane.scroll_changed";
+
+export type SubscriptionEventFrame = { event: SubscriptionEventKind; data: SubscriptionEventData };
+
+/** Any frame that can arrive on a subscription connection after the ack. */
+export type PushFrame = EventFrame | SubscriptionEventFrame;

package/src/generated/index.ts

@@ -0,0 +1,19 @@
+// GENERATED by scripts/gen from schema/herdr-api.schema.json — do not edit.
+// herdr protocol 22, schema_version 1.
+
+// Each schema namespace is its own module: 12 type names (PaneInfo, TabInfo,
+// WorkspaceInfo, ...) are defined DIFFERENTLY in the event and response
+// namespaces, so a flat merge would be wrong, not just ambiguous.
+export * as params from "./params.js";
+export * as results from "./results.js";
+export * as errors from "./errors.js";
+export * as events from "./events.js";
+// The handful of names everything needs, re-exported flat for convenience.
+export type { Method, MethodParams, Subscription } from "./params.js";
+export { METHODS } from "./params.js";
+export type { ResponseResult, ResultByTag, ResultTag } from "./results.js";
+export { METHOD_RESULT } from "./results.js";
+export type { ErrorBody } from "./errors.js";
+export type { EventFrame, SubscriptionEventFrame, PushFrame, AgentStatus, EventKind, SubscriptionEventKind } from "./events.js";
+export const PROTOCOL = 22 as const;
+export const SCHEMA_VERSION = 1 as const;

package/src/generated/params.ts

@@ -0,0 +1,460 @@
+// GENERATED by scripts/gen from schema/herdr-api.schema.json — do not edit.
+// herdr protocol 22, schema_version 1.
+
+export type AgentPromptParams = { "target": string; "text": string; "wait"?: (AgentPromptWaitOptions) | (null); };
+
+export type AgentPromptWaitOptions = { "timeout_ms"?: number | null; "until"?: Array<AgentStatus>; };
+
+export type AgentReadParams = { "format"?: ReadFormat; "lines"?: number | null; "source": ReadSource; "strip_ansi"?: boolean; "target": string; };
+
+export type AgentRenameParams = { "name"?: string | null; "target": string; };
+
+export type AgentSendKeysParams = { "keys": Array<string>; "target": string; };
+
+export type AgentStartParams = { "args"?: Array<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; };
+
+export type AgentStatus = "idle" | "working" | "blocked" | "done" | "unknown";
+
+export type AgentTarget = { "target": string; };
+
+export type AgentViewBuiltinField = "status" | "workspace_id" | "tab_id" | "pane_id" | "agent" | "seen" | "state_change_seq";
+
+export type AgentViewBuiltinSortField = "workspace_order" | "tab_order" | "pane_order" | "attention" | "status" | "agent" | "seen" | "state_change_seq";
+
+export type AgentViewClearParams = { "source"?: string | null; };
+
+export type AgentViewContext = "current_workspace_id" | "current_tab_id";
+
+export type AgentViewField = (AgentViewBuiltinField) | ({ "token": string; });
+
+export type AgentViewFilter = ({ "filters": Array<AgentViewFilter>; "op": "all"; }) | ({ "filters": Array<AgentViewFilter>; "op": "any"; }) | ({ "filter": AgentViewFilter; "op": "not"; }) | ({ "field": AgentViewField; "op": "eq"; "value": AgentViewValue; }) | ({ "field": AgentViewField; "op": "in"; "values": Array<AgentViewValue>; }) | ({ "field": AgentViewField; "op": "exists"; });
+
+export type AgentViewSetParams = { "filter"?: (AgentViewFilter) | (null); "label"?: string | null; "sort"?: Array<AgentViewSort>; "source": string; };
+
+export type AgentViewSort = { "field": AgentViewSortField; "order"?: AgentViewSortOrder; };
+
+export type AgentViewSortField = (AgentViewBuiltinSortField) | ({ "token": string; });
+
+export type AgentViewSortOrder = "asc" | "desc";
+
+export type AgentViewValue = (string) | (boolean) | (number) | ({ "context": AgentViewContext; });
+
+export type AgentWaitParams = { "target": string; "timeout_ms"?: number | null; "until"?: Array<AgentStatus>; };
+
+/** Updates whether the requesting client shell receives and controls pane presentation. */
+export type ClientShellSurfaceSetParams = { "active": boolean; };
+
+export type ClientWindowTitleSetParams = { "title": string; };
+
+export type 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; };
+
+export type EmptyParams = Record<string, never>;
+
+export type EventMatch = ({ "event": "workspace_created"; "workspace_id"?: string | null; }) | ({ "event": "workspace_updated"; "workspace_id": string; }) | ({ "event": "workspace_closed"; "workspace_id": string; }) | ({ "event": "workspace_renamed"; "label"?: string | null; "workspace_id": string; }) | ({ "event": "workspace_moved"; "workspace_id": string; }) | ({ "event": "workspace_focused"; "workspace_id": string; }) | ({ "event": "tab_created"; "tab_id"?: string | null; "workspace_id"?: string | null; }) | ({ "event": "tab_closed"; "tab_id": string; }) | ({ "event": "tab_renamed"; "label"?: string | null; "tab_id": string; }) | ({ "event": "tab_moved"; "tab_id": string; }) | ({ "event": "tab_focused"; "tab_id": string; }) | ({ "event": "pane_created"; "pane_id"?: string | null; "workspace_id"?: string | null; }) | ({ "event": "pane_closed"; "pane_id": string; }) | ({ "event": "pane_focused"; "pane_id": string; }) | ({ "event": "pane_moved"; "pane_id": string; }) | ({ "event": "pane_output_changed"; "min_revision"?: number | null; "pane_id": string; }) | ({ "event": "pane_exited"; "pane_id": string; }) | ({ "agent"?: string | null; "event": "pane_agent_detected"; "pane_id": string; }) | ({ "agent_status": AgentStatus; "event": "pane_agent_status_changed"; "pane_id": string; });
+
+export type EventsSubscribeParams = { "subscriptions": Array<Subscription>; };
+
+export type EventsWaitParams = { "match_event": EventMatch; "timeout_ms"?: number | null; };
+
+export type IntegrationInstallParams = { "target": IntegrationTarget; };
+
+export type IntegrationTarget = "pi" | "omp" | "claude" | "codex" | "copilot" | "devin" | "droid" | "kimi" | "opencode" | "kilo" | "hermes" | "qodercli" | "qwen" | "cursor" | "mastracode" | "antigravity_cli" | "grok";
+
+export type IntegrationUninstallParams = { "target": IntegrationTarget; };
+
+export type LayoutApplyParams = { "focus"?: boolean; "root": LayoutNode; "tab_id"?: string | null; "tab_label"?: string | null; "workspace_id"?: string | null; };
+
+export type LayoutExportParams = { "pane_id"?: string | null; "tab_id"?: string | null; };
+
+export type LayoutNode = ({ "command"?: Array<string> | null; "cwd"?: string | null; "env"?: { [key: string]: string; }; "label"?: string | null; "pane_id"?: string | null; "type": "pane"; }) | ({ "direction": SplitDirection; "first": LayoutNode; "ratio": number; "second": LayoutNode; "type": "split"; });
+
+export type LayoutSetSplitRatioParams = { "pane_id"?: string | null; "path": Array<boolean>; "ratio": number; "tab_id"?: string | null; };
+
+export type NotificationShowParams = { "body"?: string | null; "position"?: (ToastHerdrPosition) | (null); "sound"?: NotificationShowSound; "title": string; };
+
+export type NotificationShowSound = "none" | "done" | "request";
+
+export type OutputMatch = ({ "type": "substring"; "value": string; }) | ({ "type": "regex"; "value": string; });
+
+export type PaneAgentState = "idle" | "working" | "blocked" | "unknown";
+
+export type PaneClearAgentAuthorityParams = { "pane_id": string; "seq"?: number | null; "source"?: string | null; };
+
+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 PaneCopyMotionParams = { "content_revision"?: number | null; "cursor": PaneTextPoint; "motion": PaneCopyMotion; "pane_id": string; };
+
+export type PaneCopySearchDirection = "forward" | "backward";
+
+export type PaneCopySearchParams = { "content_revision": number; "cursor": PaneTextPoint; "direction": PaneCopySearchDirection; "pane_id": string; "previous"?: (PaneTextRange) | (null); "query": string; };
+
+export type PaneCurrentParams = { "caller_pane_id"?: string | null; };
+
+export type PaneDirection = "left" | "right" | "up" | "down";
+
+export type PaneEdgesParams = { "pane_id"?: string | null; };
+
+export type PaneFocusDirectionParams = { "direction": PaneDirection; "pane_id"?: string | null; };
+
+export type PaneGraphicsClearParams = { "layer_id"?: string | null; "pane_id": string; };
+
+export type PaneGraphicsFormat = "png" | "rgb" | "rgba" | "bgra";
+
+export type PaneGraphicsPlacementParams = { "grid_cols"?: number; "grid_rows"?: number; "viewport_col"?: number; "viewport_row"?: number; };
+
+export type PaneGraphicsSetParams = { "data_base64"?: string; "format": PaneGraphicsFormat; "image_height": number; "image_width": number; "layer_id"?: string | null; "pane_id": string; "placement"?: PaneGraphicsPlacementParams; "z_index"?: number; };
+
+export type PaneInputSetParams = { "pane_id": string; "right_click": PaneRightClickTarget; };
+
+export type PaneLayoutParams = { "pane_id"?: string | null; };
+
+export type PaneLinkActivateParams = { "col": number; "content_revision"?: number | null; "offset_from_bottom"?: number | null; "pane_id": string; "viewport_row": number; };
+
+export type PaneListParams = { "workspace_id"?: string | null; };
+
+export type PaneMoveDestination = ({ "ratio"?: number | null; "split": SplitDirection; "tab_id": string; "target_pane_id"?: string | null; "type": "tab"; }) | ({ "label"?: string | null; "type": "new_tab"; "workspace_id"?: string | null; }) | ({ "label"?: string | null; "tab_label"?: string | null; "type": "new_workspace"; });
+
+export type PaneMoveParams = { "destination": PaneMoveDestination; "focus"?: boolean; "pane_id": string; };
+
+export type PaneNeighborParams = { "direction": PaneDirection; "pane_id"?: string | null; };
+
+export type PaneProcessInfoParams = { "pane_id"?: string | null; };
+
+export type PaneReadParams = { "format"?: ReadFormat; "lines"?: number | null; "pane_id": string; "source": ReadSource; "strip_ansi"?: boolean; };
+
+export type PaneReleaseAgentParams = { "agent": string; "pane_id": string; "seq"?: number | null; "source": string; };
+
+export type PaneRenameParams = { "label"?: string | null; "pane_id": string; };
+
+export type 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; };
+
+export type 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; };
+
+export type 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"?: { [key: string]: string; }; "title"?: string | null; "tokens"?: { [key: string]: string | null; }; "ttl_ms"?: number | null; };
+
+export type PaneResizeParams = { "amount"?: number | null; "direction": PaneDirection; "pane_id"?: string | null; };
+
+export type PaneRightClickTarget = "herdr" | "pane";
+
+export type PaneScrollParams = { "offset_from_bottom": number; "pane_id": string; };
+
+export type PaneSelectionReadParams = { "anchor": PaneTextPoint; "content_revision"?: number | null; "cursor": PaneTextPoint; "pane_id": string; };
+
+export type PaneSendInputParams = { "keys"?: Array<string>; "pane_id": string; "text"?: string; };
+
+export type PaneSendKeysParams = { "keys": Array<string>; "pane_id": string; };
+
+export type PaneSendTextParams = { "pane_id": string; "text": string; };
+
+export type PaneSplitParams = { "cwd"?: string | null; "direction": SplitDirection; "env"?: { [key: string]: string; }; "focus"?: boolean; "ratio"?: number | null; "right_click"?: PaneRightClickTarget; "target_pane_id"?: string | null; "workspace_id"?: string | null; };
+
+export type PaneSwapParams = { "direction"?: (PaneDirection) | (null); "pane_id"?: string | null; "source_pane_id"?: string | null; "target_pane_id"?: string | null; };
+
+export type PaneTarget = { "pane_id": string; };
+
+export type PaneTextPoint = { "col": number; "row": number; };
+
+export type PaneTextRange = { "end": PaneTextPoint; "start": PaneTextPoint; };
+
+export type PaneWaitForOutputParams = { "lines"?: number | null; "match": OutputMatch; "pane_id": string; "source": ReadSource; "strip_ansi"?: boolean; "timeout_ms"?: number | null; };
+
+export type PaneZoomMode = "toggle" | "on" | "off";
+
+export type PaneZoomParams = { "mode"?: PaneZoomMode; "pane_id"?: string | null; };
+
+export type PingParams = Record<string, never>;
+
+export type PluginActionInvokeParams = { "action_id": string; "context"?: (PluginInvocationContext) | (null); "plugin_id"?: string | null; };
+
+export type PluginActionListParams = { "plugin_id"?: string | null; };
+
+export type 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); };
+
+export type PluginLinkParams = { "enabled"?: boolean; "path": string; "source"?: (PluginSourceInfo) | (null); };
+
+export type PluginListParams = { "plugin_id"?: string | null; };
+
+export type PluginLogListParams = { "limit"?: number | null; "plugin_id"?: string | null; };
+
+export type PluginPaneCloseParams = { "pane_id": string; };
+
+export type PluginPaneFocusParams = { "pane_id": string; };
+
+export type PluginPaneOpenParams = { "cwd"?: string | null; "direction"?: (SplitDirection) | (null); "entrypoint": string; "env"?: { [key: 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; };
+
+export type PluginPanePlacement = "overlay" | "popup" | "split" | "tab" | "zoomed";
+
+export type PluginSetEnabledParams = { "plugin_id": string; };
+
+export type PluginSourceInfo = { "installed_unix_ms"?: number | null; "kind"?: PluginSourceKind; "managed_path"?: string | null; "owner"?: string | null; "repo"?: string | null; "requested_ref"?: string | null; "resolved_commit"?: string | null; "subdir"?: string | null; };
+
+export type PluginSourceKind = "local" | "github";
+
+export type PluginUnlinkParams = { "plugin_id": string; };
+
+export type PopupSize = (number) | (string);
+
+export type ProductAnnouncementDismissParams = { "id": string; "version": string; };
+
+export type ReadFormat = "text" | "ansi";
+
+export type ReadSource = "visible" | "recent" | "recent_unwrapped" | "detection";
+
+export type ReleaseNotesDismissParams = { "version": string; };
+
+export type ServerLiveHandoffParams = { "expected_protocol"?: number | null; "expected_version"?: string | null; "import_exe"?: string | null; };
+
+export type SplitDirection = "right" | "down";
+
+export type Subscription = ({ "type": "workspace.created"; }) | ({ "type": "workspace.updated"; }) | ({ "type": "workspace.metadata_updated"; }) | ({ "type": "workspace.renamed"; }) | ({ "type": "workspace.moved"; }) | ({ "type": "workspace.reordered"; }) | ({ "type": "workspace.closed"; }) | ({ "type": "workspace.focused"; }) | ({ "type": "worktree.created"; }) | ({ "type": "worktree.opened"; }) | ({ "type": "worktree.removed"; }) | ({ "type": "tab.created"; }) | ({ "type": "tab.closed"; }) | ({ "type": "tab.focused"; }) | ({ "type": "tab.renamed"; }) | ({ "type": "tab.moved"; }) | ({ "type": "pane.created"; }) | ({ "type": "pane.closed"; }) | ({ "type": "pane.updated"; }) | ({ "type": "pane.focused"; }) | ({ "type": "pane.moved"; }) | ({ "type": "pane.exited"; }) | ({ "type": "pane.agent_detected"; }) | ({ "lines"?: number | null; "match": OutputMatch; "pane_id": string; "source": ReadSource; "strip_ansi"?: boolean; "type": "pane.output_matched"; }) | ({ "agent_status"?: (AgentStatus) | (null); "pane_id": string; "type": "pane.agent_status_changed"; }) | ({ "pane_id": string; "type": "pane.scroll_changed"; }) | ({ "type": "layout.updated"; });
+
+export type TabCreateParams = { "cwd"?: string | null; "env"?: { [key: string]: string; }; "focus"?: boolean; "label"?: string | null; "workspace_id"?: string | null; };
+
+export type TabListParams = { "workspace_id"?: string | null; };
+
+export type TabMoveParams = { "insert_index": number; "tab_id": string; };
+
+export type TabRenameParams = { "label": string; "tab_id": string; };
+
+export type TabTarget = { "tab_id": string; };
+
+export type ToastHerdrPosition = "top-left" | "top-right" | "bottom-left" | "bottom-right";
+
+export type WorkspaceCloseParams = { "close_group"?: boolean; "workspace_id": string; };
+
+export type WorkspaceCreateParams = { "cwd"?: string | null; "env"?: { [key: string]: string; }; "focus"?: boolean; "label"?: string | null; /** Workspace whose focused pane supplies the `follow` cwd policy. */ "source_workspace_id"?: string | null; };
+
+export type WorkspaceMoveBlockParams = { "before_workspace_id"?: string | null; "workspace_ids": Array<string>; };
+
+export type WorkspaceMoveParams = { "insert_index": number; "workspace_id": string; };
+
+export type WorkspaceRenameParams = { "label": string; "workspace_id": string; };
+
+export type WorkspaceReportMetadataParams = { "seq"?: number | null; "source": string; "tokens": { [key: string]: string | null; }; "ttl_ms"?: number | null; "workspace_id": string; };
+
+export type WorkspaceTarget = { "workspace_id": string; };
+
+export type WorkspaceWorktreeInfo = { "checkout_path": string; "is_linked_worktree": boolean; "repo_key": string; "repo_name": string; "repo_root": string; };
+
+export type 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; };
+
+export type WorktreeListParams = { "cwd"?: string | null; "trust_repository"?: boolean; "workspace_id"?: string | null; };
+
+export type WorktreeOpenParams = { "branch"?: string | null; "cwd"?: string | null; "focus"?: boolean; "label"?: string | null; "path"?: string | null; "trust_repository"?: boolean; "workspace_id"?: string | null; };
+
+export type WorktreeRemoveParams = { "force"?: boolean; "trust_repository"?: boolean; "workspace_id": string; };
+
+/** Every method the server accepts, mapped to its params type. */
+export interface MethodParams {
+  "ping": PingParams;
+  "server.stop": EmptyParams;
+  "server.live_handoff": ServerLiveHandoffParams;
+  "server.reload_config": EmptyParams;
+  "server.agent_manifests": EmptyParams;
+  "server.reload_agent_manifests": EmptyParams;
+  "notification.show": NotificationShowParams;
+  "product_announcement.dismiss": ProductAnnouncementDismissParams;
+  "release_notes.dismiss": ReleaseNotesDismissParams;
+  "command.invoke": CommandInvokeParams;
+  "client.window_title.set": ClientWindowTitleSetParams;
+  "client.window_title.clear": EmptyParams;
+  "client_shell.surface.set": ClientShellSurfaceSetParams;
+  "session.snapshot": EmptyParams;
+  "workspace.create": WorkspaceCreateParams;
+  "workspace.list": EmptyParams;
+  "workspace.get": WorkspaceTarget;
+  "workspace.focus": WorkspaceTarget;
+  "workspace.rename": WorkspaceRenameParams;
+  "workspace.move": WorkspaceMoveParams;
+  "workspace.move_block": WorkspaceMoveBlockParams;
+  "workspace.report_metadata": WorkspaceReportMetadataParams;
+  "workspace.close": WorkspaceCloseParams;
+  "worktree.list": WorktreeListParams;
+  "worktree.create": WorktreeCreateParams;
+  "worktree.open": WorktreeOpenParams;
+  "worktree.remove": WorktreeRemoveParams;
+  "tab.create": TabCreateParams;
+  "tab.list": TabListParams;
+  "tab.get": TabTarget;
+  "tab.focus": TabTarget;
+  "tab.rename": TabRenameParams;
+  "tab.move": TabMoveParams;
+  "tab.close": TabTarget;
+  "agent.list": EmptyParams;
+  "agent.get": AgentTarget;
+  "agent.read": AgentReadParams;
+  "agent.explain": AgentTarget;
+  "agent.send_keys": AgentSendKeysParams;
+  "agent.rename": AgentRenameParams;
+  "agent.view.set": AgentViewSetParams;
+  "agent.view.clear": AgentViewClearParams;
+  "agent.focus": AgentTarget;
+  "agent.start": AgentStartParams;
+  "agent.prompt": AgentPromptParams;
+  "agent.wait": AgentWaitParams;
+  "pane.split": PaneSplitParams;
+  "pane.swap": PaneSwapParams;
+  "pane.move": PaneMoveParams;
+  "pane.zoom": PaneZoomParams;
+  "pane.layout": PaneLayoutParams;
+  "pane.process_info": PaneProcessInfoParams;
+  "layout.export": LayoutExportParams;
+  "layout.apply": LayoutApplyParams;
+  "layout.set_split_ratio": LayoutSetSplitRatioParams;
+  "pane.neighbor": PaneNeighborParams;
+  "pane.edges": PaneEdgesParams;
+  "pane.focus_direction": PaneFocusDirectionParams;
+  "pane.resize": PaneResizeParams;
+  "pane.scroll": PaneScrollParams;
+  "pane.edit_scrollback": PaneTarget;
+  "pane.selection.read": PaneSelectionReadParams;
+  "pane.copy_motion": PaneCopyMotionParams;
+  "pane.copy_search": PaneCopySearchParams;
+  "pane.list": PaneListParams;
+  "pane.current": PaneCurrentParams;
+  "pane.get": PaneTarget;
+  "pane.focus": PaneTarget;
+  "pane.input.set": PaneInputSetParams;
+  "pane.link.activate": PaneLinkActivateParams;
+  "pane.link.resolve": PaneLinkActivateParams;
+  "pane.rename": PaneRenameParams;
+  "pane.send_text": PaneSendTextParams;
+  "pane.send_keys": PaneSendKeysParams;
+  "pane.send_input": PaneSendInputParams;
+  "pane.read": PaneReadParams;
+  "pane.graphics.set": PaneGraphicsSetParams;
+  "pane.graphics.clear": PaneGraphicsClearParams;
+  "pane.graphics.info": PaneTarget;
+  "pane.report_agent": PaneReportAgentParams;
+  "pane.report_agent_session": PaneReportAgentSessionParams;
+  "pane.report_metadata": PaneReportMetadataParams;
+  "pane.clear_agent_authority": PaneClearAgentAuthorityParams;
+  "pane.release_agent": PaneReleaseAgentParams;
+  "pane.close": PaneTarget;
+  "popup.close": EmptyParams;
+  "events.subscribe": EventsSubscribeParams;
+  "events.wait": EventsWaitParams;
+  "pane.wait_for_output": PaneWaitForOutputParams;
+  "integration.list": EmptyParams;
+  "integration.install": IntegrationInstallParams;
+  "integration.uninstall": IntegrationUninstallParams;
+  "plugin.link": PluginLinkParams;
+  "plugin.list": PluginListParams;
+  "plugin.unlink": PluginUnlinkParams;
+  "plugin.enable": PluginSetEnabledParams;
+  "plugin.disable": PluginSetEnabledParams;
+  "plugin.action.list": PluginActionListParams;
+  "plugin.action.invoke": PluginActionInvokeParams;
+  "plugin.log.list": PluginLogListParams;
+  "plugin.pane.open": PluginPaneOpenParams;
+  "plugin.pane.focus": PluginPaneFocusParams;
+  "plugin.pane.close": PluginPaneCloseParams;
+}
+
+export type Method = keyof MethodParams;
+
+export const METHODS = [
+  "ping",
+  "server.stop",
+  "server.live_handoff",
+  "server.reload_config",
+  "server.agent_manifests",
+  "server.reload_agent_manifests",
+  "notification.show",
+  "product_announcement.dismiss",
+  "release_notes.dismiss",
+  "command.invoke",
+  "client.window_title.set",
+  "client.window_title.clear",
+  "client_shell.surface.set",
+  "session.snapshot",
+  "workspace.create",
+  "workspace.list",
+  "workspace.get",
+  "workspace.focus",
+  "workspace.rename",
+  "workspace.move",
+  "workspace.move_block",
+  "workspace.report_metadata",
+  "workspace.close",
+  "worktree.list",
+  "worktree.create",
+  "worktree.open",
+  "worktree.remove",
+  "tab.create",
+  "tab.list",
+  "tab.get",
+  "tab.focus",
+  "tab.rename",
+  "tab.move",
+  "tab.close",
+  "agent.list",
+  "agent.get",
+  "agent.read",
+  "agent.explain",
+  "agent.send_keys",
+  "agent.rename",
+  "agent.view.set",
+  "agent.view.clear",
+  "agent.focus",
+  "agent.start",
+  "agent.prompt",
+  "agent.wait",
+  "pane.split",
+  "pane.swap",
+  "pane.move",
+  "pane.zoom",
+  "pane.layout",
+  "pane.process_info",
+  "layout.export",
+  "layout.apply",
+  "layout.set_split_ratio",
+  "pane.neighbor",
+  "pane.edges",
+  "pane.focus_direction",
+  "pane.resize",
+  "pane.scroll",
+  "pane.edit_scrollback",
+  "pane.selection.read",
+  "pane.copy_motion",
+  "pane.copy_search",
+  "pane.list",
+  "pane.current",
+  "pane.get",
+  "pane.focus",
+  "pane.input.set",
+  "pane.link.activate",
+  "pane.link.resolve",
+  "pane.rename",
+  "pane.send_text",
+  "pane.send_keys",
+  "pane.send_input",
+  "pane.read",
+  "pane.graphics.set",
+  "pane.graphics.clear",
+  "pane.graphics.info",
+  "pane.report_agent",
+  "pane.report_agent_session",
+  "pane.report_metadata",
+  "pane.clear_agent_authority",
+  "pane.release_agent",
+  "pane.close",
+  "popup.close",
+  "events.subscribe",
+  "events.wait",
+  "pane.wait_for_output",
+  "integration.list",
+  "integration.install",
+  "integration.uninstall",
+  "plugin.link",
+  "plugin.list",
+  "plugin.unlink",
+  "plugin.enable",
+  "plugin.disable",
+  "plugin.action.list",
+  "plugin.action.invoke",
+  "plugin.log.list",
+  "plugin.pane.open",
+  "plugin.pane.focus",
+  "plugin.pane.close",
+] as const satisfies readonly Method[];