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

package/src/generated/results.ts

@@ -0,0 +1,444 @@
+// GENERATED by scripts/gen from schema/herdr-api.schema.json — do not edit.
+// herdr protocol 22, schema_version 1.
+
+export type 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"?: { [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 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; };
+
+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 ClientWindowTitleReason = "set" | "cleared" | "no_foreground_client";
+
+export type ConfigReloadStatus = "applied" | "partial" | "failed";
+
+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 EventEnvelope = { "data": EventData; "event": EventKind; };
+
+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 InstalledPluginInfo = { "actions"?: Array<PluginManifestAction>; "build"?: Array<PluginManifestBuild>; "description"?: string | null; "enabled": boolean; "events"?: Array<PluginManifestEventHook>; "link_handlers"?: Array<PluginManifestLinkHandler>; "manifest_path": string; "min_herdr_version"?: string; "name": string; "panes"?: Array<PluginManifestPane>; "platforms"?: Array<PluginPlatform> | null; "plugin_id": string; "plugin_root": string; "source"?: PluginSourceInfo; "startup"?: Array<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"?: Array<string>; };
+
+export type IntegrationInfo = { "available": boolean; "command": string; "label": string; "state": IntegrationState; "target": IntegrationTarget; };
+
+export type IntegrationInstallResult = { "messages": Array<string>; };
+
+export type IntegrationState = "not_installed" | "current" | "outdated";
+
+export type IntegrationTarget = "pi" | "omp" | "claude" | "codex" | "copilot" | "devin" | "droid" | "kimi" | "opencode" | "kilo" | "hermes" | "qodercli" | "qwen" | "cursor" | "mastracode" | "antigravity_cli" | "grok";
+
+export type IntegrationUninstallResult = { "messages": Array<string>; };
+
+export type LayoutDescription = { "focused_pane_id": string; "root": LayoutNode; "tab_id": string; "workspace_id": string; "zoomed": boolean; };
+
+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 NotificationShowReason = "shown" | "disabled" | "rate_limited" | "no_foreground_client" | "busy";
+
+export type PaneDirection = "left" | "right" | "up" | "down";
+
+export type PaneEdgesResult = { "down": boolean; "layout": PaneLayoutSnapshot; "left": boolean; "pane_id": string; "right": boolean; "up": boolean; };
+
+export type PaneFocusDirectionReason = "no_neighbor";
+
+export type PaneFocusDirectionResult = { "changed": boolean; "focused_pane_id"?: string | null; "layout": PaneLayoutSnapshot; "reason"?: (PaneFocusDirectionReason) | (null); "source_pane_id": string; };
+
+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; };
+
+/** Inclusive display-cell columns on a pane's current viewport. */
+export type PaneLinkRegion = { "end_col": number; "row": number; "start_col": number; };
+
+export type PaneMoveReason = "same_tab" | "zoomed_tab";
+
+export type 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; };
+
+export type PaneNeighborResult = { "direction": PaneDirection; "layout": PaneLayoutSnapshot; "neighbor_pane_id"?: string | null; "pane_id": string; };
+
+export type PaneProcessInfo = { "foreground_process_group_id"?: number | null; "foreground_processes"?: Array<PaneProcessInfoProcess>; "pane_id": string; "shell_pid"?: number | null; "tty"?: string | null; };
+
+export type PaneProcessInfoProcess = { "argv"?: Array<string> | null; "argv0"?: string | null; "cmdline"?: string | null; "cwd"?: string | null; "name": string; "pid": number; };
+
+export type PaneReadResult = { "format": ReadFormat; "pane_id": string; "revision": number; "source": ReadSource; "tab_id": string; "text": string; "truncated": boolean; "workspace_id": string; };
+
+export type PaneResizeReason = "unchanged";
+
+export type PaneResizeResult = { "changed": boolean; "focused_pane_id": string; "layout": PaneLayoutSnapshot; "pane_id": string; "reason"?: (PaneResizeReason) | (null); };
+
+export type PaneScrollInfo = { "max_offset_from_bottom": number; "offset_from_bottom": number; "viewport_rows": number; };
+
+export type PaneSwapReason = "no_neighbor" | "same_pane" | "not_found" | "cross_tab";
+
+export type PaneSwapResult = { "changed": boolean; "focused_pane_id": string; "layout": PaneLayoutSnapshot; "reason"?: (PaneSwapReason) | (null); "source_pane_id": string; "target_pane_id"?: string | null; };
+
+export type PaneTextPoint = { "col": number; "row": number; };
+
+export type PaneTextRange = { "end": PaneTextPoint; "start": PaneTextPoint; };
+
+export type PaneZoomReason = "single_pane" | "already_zoomed" | "already_unzoomed";
+
+export type PaneZoomResult = { "changed": boolean; "focus_changed": boolean; "focused_pane_id": string; "layout": PaneLayoutSnapshot; "pane_id": string; "reason"?: (PaneZoomReason) | (null); "zoom_changed": boolean; "zoomed": boolean; };
+
+export type PluginActionContext = "global" | "workspace" | "tab" | "pane" | "selection";
+
+export type PluginActionInfo = { "action_id": string; "command": Array<string>; "contexts"?: Array<PluginActionContext>; "description"?: string | null; "platforms"?: Array<PluginPlatform> | null; "plugin_id": string; "title": string; };
+
+export type PluginCommandLogInfo = { "action_id"?: string | null; "command": Array<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; };
+
+export type PluginCommandStatus = "running" | "succeeded" | "failed";
+
+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 PluginManifestAction = { "command": Array<string>; "contexts"?: Array<PluginActionContext>; "description"?: string | null; "id": string; "platforms"?: Array<PluginPlatform> | null; "title": string; };
+
+export type PluginManifestBuild = { "command": Array<string>; "platforms"?: Array<PluginPlatform> | null; };
+
+export type PluginManifestEventHook = { "command": Array<string>; "on": string; "platforms"?: Array<PluginPlatform> | null; };
+
+export type PluginManifestLinkHandler = { "action": string; "id": string; "pattern": string; "platforms"?: Array<PluginPlatform> | null; "title": string; };
+
+export type PluginManifestPane = { "command": Array<string>; "description"?: string | null; "height"?: (PopupSize) | (null); "id": string; "placement"?: PluginPanePlacement; "platforms"?: Array<PluginPlatform> | null; "title": string; "width"?: (PopupSize) | (null); };
+
+export type PluginManifestStartup = { "command": Array<string>; "platforms"?: Array<PluginPlatform> | null; };
+
+export type PluginPaneInfo = { "entrypoint": string; "pane": PaneInfo; "plugin_id": string; };
+
+export type PluginPanePlacement = "overlay" | "popup" | "split" | "tab" | "zoomed";
+
+export type PluginPlatform = "linux" | "macos" | "windows";
+
+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 PopupSize = (number) | (string);
+
+export type ReadFormat = "text" | "ansi";
+
+export type ReadSource = "visible" | "recent" | "recent_unwrapped" | "detection";
+
+export type 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; };
+
+export type SessionSnapshot = { "agents": Array<AgentInfo>; "focused_pane_id"?: string | null; "focused_tab_id"?: string | null; "focused_workspace_id"?: string | null; "layouts": Array<PaneLayoutSnapshot>; "panes": Array<PaneInfo>; "protocol": number; "tabs": Array<TabInfo>; "version": string; "workspaces": Array<WorkspaceInfo>; };
+
+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 WorktreeSourceInfo = { "repo_key": string; "repo_name": string; "repo_root": string; "source_checkout_path": string; "source_workspace_id"?: string | null; };
+
+export type Result_pong = { "capabilities"?: (ServerCapabilities) | (null); "protocol": number; "type": "pong"; "version": string; };
+
+export type Result_session_snapshot = { "snapshot": SessionSnapshot; "type": "session_snapshot"; };
+
+export type Result_workspace_info = { "type": "workspace_info"; "workspace": WorkspaceInfo; };
+
+export type Result_workspace_created = { "root_pane": PaneInfo; "tab": TabInfo; "type": "workspace_created"; "workspace": WorkspaceInfo; };
+
+export type Result_workspace_list = { "type": "workspace_list"; "workspaces": Array<WorkspaceInfo>; };
+
+export type Result_worktree_list = { "source": WorktreeSourceInfo; "type": "worktree_list"; "worktrees": Array<WorktreeInfo>; };
+
+export type Result_worktree_created = { "root_pane": PaneInfo; "tab": TabInfo; "type": "worktree_created"; "workspace": WorkspaceInfo; "worktree": WorktreeInfo; };
+
+export type Result_worktree_opened = { "already_open": boolean; "root_pane": PaneInfo; "tab": TabInfo; "type": "worktree_opened"; "workspace": WorkspaceInfo; "worktree": WorktreeInfo; };
+
+export type Result_worktree_removed = { "forced": boolean; "path": string; "type": "worktree_removed"; "workspace_id": string; };
+
+export type Result_tab_info = { "tab": TabInfo; "type": "tab_info"; };
+
+export type Result_tab_created = { "root_pane": PaneInfo; "tab": TabInfo; "type": "tab_created"; };
+
+export type Result_tab_list = { "tabs": Array<TabInfo>; "type": "tab_list"; };
+
+export type Result_agent_info = { "agent": AgentInfo; "type": "agent_info"; };
+
+export type Result_agent_started = { "agent": AgentInfo; "argv": Array<string>; "type": "agent_started"; };
+
+export type Result_agent_prompted = { "agent": AgentInfo; "type": "agent_prompted"; };
+
+export type Result_agent_list = { "agents": Array<AgentInfo>; "type": "agent_list"; };
+
+export type Result_agent_view = { "active": boolean; "label"?: string | null; "source"?: string | null; "type": "agent_view"; };
+
+export type Result_pane_info = { "pane": PaneInfo; "type": "pane_info"; };
+
+export type Result_pane_list = { "panes": Array<PaneInfo>; "type": "pane_list"; };
+
+export type Result_pane_current = { "pane": PaneInfo; "type": "pane_current"; };
+
+export type Result_pane_swap = { "swap": PaneSwapResult; "type": "pane_swap"; };
+
+export type Result_pane_move = { "move_result": PaneMoveResult; "type": "pane_move"; };
+
+export type Result_pane_zoom = { "type": "pane_zoom"; "zoom": PaneZoomResult; };
+
+export type Result_pane_layout = { "layout": PaneLayoutSnapshot; "type": "pane_layout"; };
+
+export type Result_pane_process_info = { "process_info": PaneProcessInfo; "type": "pane_process_info"; };
+
+export type Result_layout_export = { "layout": LayoutDescription; "type": "layout_export"; };
+
+export type Result_layout_apply = { "layout": LayoutDescription; "type": "layout_apply"; };
+
+export type Result_layout_split_ratio_set = { "layout": LayoutDescription; "type": "layout_split_ratio_set"; };
+
+export type Result_pane_neighbor = { "neighbor": PaneNeighborResult; "type": "pane_neighbor"; };
+
+export type Result_pane_edges = { "edges": PaneEdgesResult; "type": "pane_edges"; };
+
+export type Result_pane_focus_direction = { "focus": PaneFocusDirectionResult; "type": "pane_focus_direction"; };
+
+export type Result_pane_resize = { "resize": PaneResizeResult; "type": "pane_resize"; };
+
+export type Result_pane_read = { "read": PaneReadResult; "type": "pane_read"; };
+
+export type Result_pane_selection = { "pane_id": string; "text": string; "type": "pane_selection"; };
+
+export type Result_pane_copy_motion = { "content_revision": number; "cursor": PaneTextPoint; "pane_id": string; "type": "pane_copy_motion"; };
+
+export type Result_pane_copy_search = { "content_revision": number; "current"?: number | null; "current_global"?: number | null; "matches": Array<PaneTextRange>; "pane_id": string; "total": number; "type": "pane_copy_search"; };
+
+export type Result_pane_graphics_frame_ack = { "revision": number; "sequence": number; "type": "pane_graphics_frame_ack"; };
+
+export type Result_pane_graphics_info = { "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"?: Array<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"; };
+
+export type Result_agent_explain = { "explain": unknown; "type": "agent_explain"; };
+
+export type Result_subscription_started = { "type": "subscription_started"; };
+
+export type Result_wait_matched = { "event": EventEnvelope; "type": "wait_matched"; };
+
+export type Result_output_matched = { "matched_line"?: string | null; "pane_id": string; "read": PaneReadResult; "revision": number; "type": "output_matched"; };
+
+export type Result_notification_show = { "reason": NotificationShowReason; "shown": boolean; "type": "notification_show"; };
+
+export type Result_client_window_title = { "changed": boolean; "reason": ClientWindowTitleReason; "type": "client_window_title"; };
+
+export type Result_integration_list = { "integrations": Array<IntegrationInfo>; "type": "integration_list"; };
+
+export type Result_integration_install = { "details": IntegrationInstallResult; "target": IntegrationTarget; "type": "integration_install"; };
+
+export type Result_integration_uninstall = { "details": IntegrationUninstallResult; "target": IntegrationTarget; "type": "integration_uninstall"; };
+
+export type Result_agent_manifest_reload = { "manifests": Array<AgentManifestInfo>; "type": "agent_manifest_reload"; };
+
+export type Result_agent_manifest_status = { "last_check_unix"?: number | null; "last_result"?: string | null; "manifests": Array<AgentManifestInfo>; "type": "agent_manifest_status"; };
+
+export type Result_plugin_linked = { "plugin": InstalledPluginInfo; "type": "plugin_linked"; };
+
+export type Result_plugin_list = { "plugins": Array<InstalledPluginInfo>; "type": "plugin_list"; };
+
+export type Result_plugin_unlinked = { "plugin_id": string; "removed": boolean; "type": "plugin_unlinked"; };
+
+export type Result_plugin_enabled = { "plugin": InstalledPluginInfo; "type": "plugin_enabled"; };
+
+export type Result_plugin_disabled = { "plugin": InstalledPluginInfo; "type": "plugin_disabled"; };
+
+export type Result_plugin_action_list = { "actions": Array<PluginActionInfo>; "type": "plugin_action_list"; };
+
+export type Result_plugin_action_invoked = { "action": PluginActionInfo; "context": PluginInvocationContext; "log": PluginCommandLogInfo; "type": "plugin_action_invoked"; };
+
+export type Result_pane_link_resolved = { "regions": Array<PaneLinkRegion>; "type": "pane_link_resolved"; };
+
+export type Result_pane_link_activated = { "handled": boolean; "type": "pane_link_activated"; "url"?: string | null; };
+
+export type Result_plugin_log_list = { "logs": Array<PluginCommandLogInfo>; "type": "plugin_log_list"; };
+
+export type Result_plugin_pane_opened = { "plugin_pane": PluginPaneInfo; "type": "plugin_pane_opened"; };
+
+export type Result_plugin_pane_focused = { "plugin_pane": PluginPaneInfo; "type": "plugin_pane_focused"; };
+
+export type Result_plugin_pane_closed = { "pane_id": string; "type": "plugin_pane_closed"; };
+
+export type Result_config_reload = { "diagnostics": Array<string>; "status": ConfigReloadStatus; "type": "config_reload"; };
+
+export type Result_client_shell_surface_set = { "active": boolean; "projection_revision": number; "type": "client_shell_surface_set"; };
+
+export type Result_ok = { "type": "ok"; };
+
+/** The full union of every result shape the server can return. */
+export type ResponseResult =
+  | Result_pong
+  | Result_session_snapshot
+  | Result_workspace_info
+  | Result_workspace_created
+  | Result_workspace_list
+  | Result_worktree_list
+  | Result_worktree_created
+  | Result_worktree_opened
+  | Result_worktree_removed
+  | Result_tab_info
+  | Result_tab_created
+  | Result_tab_list
+  | Result_agent_info
+  | Result_agent_started
+  | Result_agent_prompted
+  | Result_agent_list
+  | Result_agent_view
+  | Result_pane_info
+  | Result_pane_list
+  | Result_pane_current
+  | Result_pane_swap
+  | Result_pane_move
+  | Result_pane_zoom
+  | Result_pane_layout
+  | Result_pane_process_info
+  | Result_layout_export
+  | Result_layout_apply
+  | Result_layout_split_ratio_set
+  | Result_pane_neighbor
+  | Result_pane_edges
+  | Result_pane_focus_direction
+  | Result_pane_resize
+  | Result_pane_read
+  | Result_pane_selection
+  | Result_pane_copy_motion
+  | Result_pane_copy_search
+  | Result_pane_graphics_frame_ack
+  | Result_pane_graphics_info
+  | Result_agent_explain
+  | Result_subscription_started
+  | Result_wait_matched
+  | Result_output_matched
+  | Result_notification_show
+  | Result_client_window_title
+  | Result_integration_list
+  | Result_integration_install
+  | Result_integration_uninstall
+  | Result_agent_manifest_reload
+  | Result_agent_manifest_status
+  | Result_plugin_linked
+  | Result_plugin_list
+  | Result_plugin_unlinked
+  | Result_plugin_enabled
+  | Result_plugin_disabled
+  | Result_plugin_action_list
+  | Result_plugin_action_invoked
+  | Result_pane_link_resolved
+  | Result_pane_link_activated
+  | Result_plugin_log_list
+  | Result_plugin_pane_opened
+  | Result_plugin_pane_focused
+  | Result_plugin_pane_closed
+  | Result_config_reload
+  | Result_client_shell_surface_set
+  | Result_ok;
+
+/** Result shape, keyed by its `type` tag. */
+export interface ResultByTag {
+  "pong": Result_pong;
+  "session_snapshot": Result_session_snapshot;
+  "workspace_info": Result_workspace_info;
+  "workspace_created": Result_workspace_created;
+  "workspace_list": Result_workspace_list;
+  "worktree_list": Result_worktree_list;
+  "worktree_created": Result_worktree_created;
+  "worktree_opened": Result_worktree_opened;
+  "worktree_removed": Result_worktree_removed;
+  "tab_info": Result_tab_info;
+  "tab_created": Result_tab_created;
+  "tab_list": Result_tab_list;
+  "agent_info": Result_agent_info;
+  "agent_started": Result_agent_started;
+  "agent_prompted": Result_agent_prompted;
+  "agent_list": Result_agent_list;
+  "agent_view": Result_agent_view;
+  "pane_info": Result_pane_info;
+  "pane_list": Result_pane_list;
+  "pane_current": Result_pane_current;
+  "pane_swap": Result_pane_swap;
+  "pane_move": Result_pane_move;
+  "pane_zoom": Result_pane_zoom;
+  "pane_layout": Result_pane_layout;
+  "pane_process_info": Result_pane_process_info;
+  "layout_export": Result_layout_export;
+  "layout_apply": Result_layout_apply;
+  "layout_split_ratio_set": Result_layout_split_ratio_set;
+  "pane_neighbor": Result_pane_neighbor;
+  "pane_edges": Result_pane_edges;
+  "pane_focus_direction": Result_pane_focus_direction;
+  "pane_resize": Result_pane_resize;
+  "pane_read": Result_pane_read;
+  "pane_selection": Result_pane_selection;
+  "pane_copy_motion": Result_pane_copy_motion;
+  "pane_copy_search": Result_pane_copy_search;
+  "pane_graphics_frame_ack": Result_pane_graphics_frame_ack;
+  "pane_graphics_info": Result_pane_graphics_info;
+  "agent_explain": Result_agent_explain;
+  "subscription_started": Result_subscription_started;
+  "wait_matched": Result_wait_matched;
+  "output_matched": Result_output_matched;
+  "notification_show": Result_notification_show;
+  "client_window_title": Result_client_window_title;
+  "integration_list": Result_integration_list;
+  "integration_install": Result_integration_install;
+  "integration_uninstall": Result_integration_uninstall;
+  "agent_manifest_reload": Result_agent_manifest_reload;
+  "agent_manifest_status": Result_agent_manifest_status;
+  "plugin_linked": Result_plugin_linked;
+  "plugin_list": Result_plugin_list;
+  "plugin_unlinked": Result_plugin_unlinked;
+  "plugin_enabled": Result_plugin_enabled;
+  "plugin_disabled": Result_plugin_disabled;
+  "plugin_action_list": Result_plugin_action_list;
+  "plugin_action_invoked": Result_plugin_action_invoked;
+  "pane_link_resolved": Result_pane_link_resolved;
+  "pane_link_activated": Result_pane_link_activated;
+  "plugin_log_list": Result_plugin_log_list;
+  "plugin_pane_opened": Result_plugin_pane_opened;
+  "plugin_pane_focused": Result_plugin_pane_focused;
+  "plugin_pane_closed": Result_plugin_pane_closed;
+  "config_reload": Result_config_reload;
+  "client_shell_surface_set": Result_client_shell_surface_set;
+  "ok": Result_ok;
+}
+
+export type ResultTag = keyof ResultByTag;
+
+/** See scripts/gen/method-result-map.ts. */
+export const METHOD_RESULT = {
+  "ping": "pong",
+  "session.snapshot": "session_snapshot",
+  "workspace.create": "workspace_created",
+  "workspace.list": "workspace_list",
+  "workspace.get": "workspace_info",
+  "worktree.list": "worktree_list",
+  "worktree.create": "worktree_created",
+  "worktree.open": "worktree_opened",
+  "worktree.remove": "worktree_removed",
+  "tab.create": "tab_created",
+  "tab.list": "tab_list",
+  "tab.get": "tab_info",
+  "agent.list": "agent_list",
+  "agent.get": "agent_info",
+  "agent.read": "pane_read",
+  "agent.start": "agent_started",
+  "agent.prompt": "agent_prompted",
+  "agent.wait": "agent_info",
+  "agent.view.set": "agent_view",
+  "agent.view.clear": "agent_view",
+  "pane.list": "pane_list",
+  "pane.current": "pane_current",
+  "pane.get": "pane_info",
+  "pane.read": "pane_read",
+  "events.subscribe": "subscription_started"
+} as const;

package/src/herdr.ts

@@ -0,0 +1,142 @@
+// Effect-native client for the herdr socket API.
+// Wire facts (herdr 0.9, protocol 22): newline-delimited JSON; `{id, method, params}` → `{id, result}` | `{id, error}`;
+// the server closes after one response, so every call is its own connection. `events.subscribe` acks with
+// `subscription_started` and then keeps the connection open, streaming `{event, data}` frames.
+import { Cause, Config, Context, Effect, Layer, Option, type Path, Random, Schema, Stream } from "effect"
+import * as Socket from "effect/socket/Socket"
+import type { PushFrame } from "./generated/events.js"
+import { PROTOCOL } from "./generated/index.js"
+import type { Method, MethodParams, Subscription } from "./generated/params.js"
+import type { METHOD_RESULT, ResponseResult, ResultByTag } from "./generated/results.js"
+import { SocketConnector } from "./socket-connector.js"
+import { defaultSocketPath, socketEndpoint, type SocketPathOptions } from "./socket-path.js"
+
+export type ResultOf<M extends Method> = M extends keyof typeof METHOD_RESULT ? ResultByTag[(typeof METHOD_RESULT)[M]] : ResponseResult
+export type ParamsOf<M extends Method> = MethodParams[M]
+
+/** The server answered `{ error }`. `code` is herdr's machine-readable code (`timeout`, `agent_pane_busy`, …). */
+export class HerdrError extends Schema.TaggedError<HerdrError>()("HerdrError", {
+  method: Schema.String,
+  code: Schema.String,
+  message: Schema.String,
+}) {}
+
+/** Socket missing, refused, or closed before a response. */
+export class HerdrTransportError extends Schema.TaggedError<HerdrTransportError>()("HerdrTransportError", {
+  method: Schema.String,
+  message: Schema.String,
+}) {}
+
+export type HerdrFailure = HerdrError | HerdrTransportError
+
+/** The server speaks a different protocol than the one this SDK's types were generated for (`PROTOCOL`). */
+export class HerdrProtocolMismatch extends Schema.TaggedError<HerdrProtocolMismatch>()("HerdrProtocolMismatch", {
+  socketPath: Schema.String,
+  expected: Schema.Number,
+  actual: Schema.Number,
+  serverVersion: Schema.String,
+}) {}
+
+export interface HerdrShape {
+  readonly socketPath: string
+  readonly call: <M extends Method>(method: M, params: ParamsOf<M>) => Effect.Effect<ResultOf<M>, HerdrFailure>
+  /** Long-lived push stream. Ends when the server closes the connection. */
+  readonly subscribe: (subscriptions: ReadonlyArray<Subscription>) => Stream.Stream<PushFrame, HerdrFailure>
+}
+
+export class Herdr extends Context.Service<Herdr, HerdrShape>()("effect-herdr-sdk/Herdr") {
+  /**
+   * The handshake every consumer runs before trusting a server: the generated types (and the unchecked casts that
+   * hand them out, see `call` / `subscribe`) are only true for the protocol they were generated from.
+   */
+  static readonly verifyProtocol = (herdr: HerdrShape): Effect.Effect<void, HerdrFailure | HerdrProtocolMismatch> =>
+    herdr.call("ping", {}).pipe(
+      Effect.flatMap((pong) =>
+        pong.protocol === PROTOCOL
+          ? Effect.void
+          : Effect.fail(new HerdrProtocolMismatch({ socketPath: herdr.socketPath, expected: PROTOCOL, actual: pong.protocol, serverVersion: pong.version })),
+      ),
+    )
+
+  /** A client for `socketPath`, dialing through the provided `SocketConnector`. */
+  static readonly make = (socketPath: string): Effect.Effect<HerdrShape, never, SocketConnector> =>
+    Effect.map(SocketConnector, (connect) => makeClient(socketPath, connect))
+  /** Socket from `options.socketPath`, else herdr's own resolution (HERDR_SOCKET_PATH, XDG_CONFIG_HOME, HOME …) read through Config. */
+  static readonly layer = (
+    options: { socketPath?: string } & SocketPathOptions = {},
+  ): Layer.Layer<Herdr, Config.ConfigError, SocketConnector | Path.Path> =>
+    Layer.effect(
+      Herdr,
+      (options.socketPath ? Effect.succeed(options.socketPath) : defaultSocketPath(options)).pipe(Effect.flatMap(Herdr.make)),
+    )
+}
+
+// Wire frames (herdr protocol 22). `id: ""` = the server could not parse our request; still ours.
+const Response = Schema.Struct({
+  id: Schema.String,
+  result: Schema.optional(Schema.Unknown),
+  error: Schema.optional(Schema.Struct({ code: Schema.String, message: Schema.String })),
+})
+const Push = Schema.Struct({ event: Schema.String, data: Schema.Unknown })
+const decodeLine = Schema.decodeUnknownEffect(Schema.fromJsonString(Schema.Union([Response, Push])))
+const Request = Schema.Struct({ id: Schema.String, method: Schema.String, params: Schema.Unknown })
+const encodeRequest = Schema.encodeEffect(Schema.fromJsonString(Request))
+const isResponse = (m: typeof Response.Type | typeof Push.Type): m is typeof Response.Type => "id" in m
+
+const requestId = (prefix: string) => Random.nextIntBetween(0, 2 ** 31).pipe(Effect.map((n) => `${prefix}-${n.toString(36)}`))
+
+function makeClient(socketPath: string, connect: SocketConnector["Service"]): HerdrShape {
+  const transport = (method: string) => (e: { readonly message: string }) => new HerdrTransportError({ method, message: e.message })
+  const serverError = (method: string, error: { code: string; message: string }) => new HerdrError({ method, code: error.code, message: error.message })
+
+  /** Open a connection, send one request line, and expose the decoded response lines. Scoped: closing the scope closes the socket. */
+  const open = (method: string, request: typeof Request.Type) =>
+    Effect.gen(function* () {
+      const socket = yield* connect(socketEndpoint(socketPath))
+      // Acquiring the reader dials; the writer waits on that, so writing first would hang forever.
+      const pull = yield* Socket.readerString(socket)
+      const writer = yield* socket.writer
+      yield* writer.write(`${yield* encodeRequest(request).pipe(Effect.orDie)}\n`)
+      // Every close surfaces as a SocketError; a clean close is just the end of the stream.
+      const text = pull.pipe(Effect.catchIf((e) => e.reason._tag === "SocketCloseError", () => Cause.done()))
+      return Stream.fromPull(Effect.succeed(text)).pipe(
+        Stream.splitLines,
+        Stream.filter((l) => l.length > 0),
+        Stream.mapEffect((line) => decodeLine(line)),
+        Stream.mapError(transport(method)),
+      )
+    }).pipe(Effect.mapError(transport(method)))
+
+  const call = <M extends Method>(method: M, params: ParamsOf<M>) =>
+    Effect.gen(function* () {
+      const id = yield* requestId("omac")
+      const lines = yield* open(method, { id, method, params })
+      const found = yield* lines.pipe(
+        Stream.filter(isResponse),
+        Stream.filter((m) => m.id === id || m.id === ""),
+        Stream.runHead,
+      )
+      if (Option.isNone(found)) return yield* new HerdrTransportError({ method, message: "connection closed before a response" })
+      if (found.value.error) return yield* serverError(method, found.value.error)
+      // Not decoded at runtime: the shape is herdr's contract for PROTOCOL, checked once per server by verifyProtocol.
+      return found.value.result as ResultOf<M>
+    }).pipe(Effect.scoped)
+
+  /** herdr acks with a response first and only then pushes frames, so no ack state is needed. */
+  const subscribe = (subscriptions: ReadonlyArray<Subscription>): Stream.Stream<PushFrame, HerdrFailure> => {
+    const method = "events.subscribe"
+    return Effect.gen(function* () {
+      const id = yield* requestId("sub")
+      const lines = yield* open(method, { id, method, params: { subscriptions } })
+      return lines.pipe(
+        Stream.flatMap((m): Stream.Stream<PushFrame, HerdrFailure> =>
+          isResponse(m)
+            ? (m.id === id || m.id === "") && m.error ? Stream.fail(serverError(method, m.error)) : Stream.empty
+            : Stream.make(m as PushFrame), // herdr's contract for PROTOCOL, as in `call`
+        ),
+      )
+    }).pipe(Stream.unwrap)
+  }
+
+  return { socketPath, call, subscribe }
+}

package/src/index.ts

@@ -0,0 +1,10 @@
+export * from "./herdr.js"
+export { SocketConnector } from "./socket-connector.js"
+export { configDir, defaultSocketPath, socketEndpoint, type SocketPathOptions } from "./socket-path.js"
+export * as params from "./generated/params.js"
+export * as results from "./generated/results.js"
+export * as events from "./generated/events.js"
+export type { Method, MethodParams, Subscription } from "./generated/params.js"
+export type { ResponseResult, ResultByTag, ResultTag } from "./generated/results.js"
+export type { AgentStatus, EventFrame, EventKind, PushFrame, SubscriptionEventFrame, SubscriptionEventKind } from "./generated/events.js"
+export { PROTOCOL, SCHEMA_VERSION } from "./generated/index.js"

package/src/socket-connector.ts

@@ -0,0 +1,9 @@
+// The one runtime capability the client needs and `effect` has no service for: dial a local socket.
+// The core only names this service; `effect-herdr-sdk/bun` (or another runtime's layer) provides it.
+import { Context, type Effect } from "effect"
+import type * as Socket from "effect/socket/Socket"
+
+/** Dial `endpoint` (a unix socket path, or `\\.\pipe\…` on Windows). Like `WebSocketConstructor`, for local sockets. */
+export class SocketConnector extends Context.Service<SocketConnector, (endpoint: string) => Effect.Effect<Socket.Socket>>()(
+  "effect-herdr-sdk/SocketConnector",
+) {}