@neosh/api 0.1.0

package/src/generated/ApiCall.ts

@@ -0,0 +1,520 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AgentCommand } from "./AgentCommand";
+import type { BufferId } from "./BufferId";
+import type { Capability } from "./Capability";
+import type { CursorMotion } from "./CursorMotion";
+import type { CursorShape } from "./CursorShape";
+import type { DiffTarget } from "./DiffTarget";
+import type { DriverKind } from "./DriverKind";
+import type { ExtmarkId } from "./ExtmarkId";
+import type { ExtmarkOpts } from "./ExtmarkOpts";
+import type { FloatConfig } from "./FloatConfig";
+import type { HighlightDef } from "./HighlightDef";
+import type { Hint } from "./Hint";
+import type { HlTarget } from "./HlTarget";
+import type { HookName } from "./HookName";
+import type { InstanceConfig } from "./InstanceConfig";
+import type { InstanceId } from "./InstanceId";
+import type { KeymapScope } from "./KeymapScope";
+import type { LineDraw } from "./LineDraw";
+import type { MessageLevel } from "./MessageLevel";
+import type { Mode } from "./Mode";
+import type { ModelSelection } from "./ModelSelection";
+import type { NamespaceId } from "./NamespaceId";
+import type { NodeId } from "./NodeId";
+import type { NoticeKind } from "./NoticeKind";
+import type { OptionSpec } from "./OptionSpec";
+import type { OptionValue } from "./OptionValue";
+import type { PermissionMode } from "./PermissionMode";
+import type { ProjectKey } from "./ProjectKey";
+import type { ProviderEvent } from "./ProviderEvent";
+import type { QuotaSnapshot } from "./QuotaSnapshot";
+import type { Rect } from "./Rect";
+import type { SelectShape } from "./SelectShape";
+import type { SessionId } from "./SessionId";
+import type { StatusSegment } from "./StatusSegment";
+import type { StreamId } from "./StreamId";
+import type { SurfaceCell } from "./SurfaceCell";
+import type { SurfaceId } from "./SurfaceId";
+import type { TextEdit } from "./TextEdit";
+import type { ToolDef } from "./ToolDef";
+import type { UsageResolution } from "./UsageResolution";
+import type { UserQuestion } from "./UserQuestion";
+import type { VarScope } from "./VarScope";
+import type { ViewId } from "./ViewId";
+import type { WindowId } from "./WindowId";
+import type { WindowLayout } from "./WindowLayout";
+
+export type ApiCall =
+  | {
+    "call": "buf_create";
+    name?: string | null;
+    scratch: boolean;
+    /**
+     * What this buffer *is*, so that somebody else can say something about it.
+     */
+    kind?: string | null;
+  }
+  | { "call": "buf_line_count"; buf: BufferId }
+  | {
+    "call": "buf_get_lines";
+    buf: BufferId;
+    start: number;
+    /**
+     * Exclusive. Negative indices are `len + 1 + i`, as in Neovim: `-1` is one past the last
+     * line, so `0..-1` is the whole buffer.
+     */
+    end: number;
+  }
+  | {
+    "call": "buf_set_lines";
+    buf: BufferId;
+    start: number;
+    end: number;
+    lines: Array<string>;
+  }
+  | {
+    "call": "buf_render";
+    buf: BufferId;
+    ns: NamespaceId;
+    start: number;
+    end: number;
+    lines: Array<LineDraw>;
+  }
+  | { "call": "buf_append_text"; buf: BufferId; text: string }
+  | { "call": "buf_set_name"; buf: BufferId; name: string }
+  | { "call": "buf_set_kind"; buf: BufferId; kind?: string | null }
+  | { "call": "buf_get_kind"; buf: BufferId }
+  | { "call": "buf_attach"; buf: BufferId }
+  | { "call": "buf_detach"; buf: BufferId }
+  | {
+    "call": "win_open";
+    buf: BufferId;
+    layout: WindowLayout;
+    /**
+     * Which terminal to open it in.
+     *
+     * Almost never worth saying. The host works it out from the call — a float anchored to a
+     * window goes where that window is, and a buffer only one terminal is showing names it —
+     * and otherwise from the terminal whose key press is being served, which for anything a
+     * plugin does in answer to a key is exact. What this is for is the case none of that
+     * covers: an orchestrator putting something on a screen other than the one you are at.
+     */
+    view?: ViewId | null;
+  }
+  | { "call": "win_close"; win: WindowId }
+  | { "call": "win_resize"; win: WindowId; size: number | null }
+  | { "call": "win_set_buf"; win: WindowId; buf: BufferId }
+  | { "call": "win_get_cursor"; win: WindowId }
+  | { "call": "win_set_cursor"; win: WindowId; row: number; col: number }
+  | { "call": "win_get_viewport"; win: WindowId }
+  | { "call": "win_scroll_to"; win: WindowId; top_line: number | null }
+  | { "call": "win_list" }
+  | {
+    "call": "win_motion";
+    win: WindowId;
+    motion: CursorMotion;
+    select: boolean;
+  }
+  | { "call": "win_edit"; win: WindowId; edit: TextEdit }
+  | {
+    "call": "win_select";
+    win: WindowId;
+    /**
+     * `false` clears. `true` anchors here even if something was already selected.
+     */
+    on: boolean;
+  }
+  | { "call": "win_select_shape"; win: WindowId; shape: SelectShape }
+  | { "call": "win_cursor_shape"; win: WindowId; shape: CursorShape }
+  | { "call": "win_selection"; win: WindowId }
+  | { "call": "clipboard_write"; text: string }
+  | {
+    "call": "float_open";
+    buf: BufferId;
+    config: FloatConfig;
+    /**
+     * Which terminal to open it in.
+     *
+     * Almost never worth saying. The host works it out from the call — a float anchored to a
+     * window goes where that window is, and a buffer only one terminal is showing names it —
+     * and otherwise from the terminal whose key press is being served, which for anything a
+     * plugin does in answer to a key is exact. What this is for is the case none of that
+     * covers: an orchestrator putting something on a screen other than the one you are at.
+     */
+    view?: ViewId | null;
+  }
+  | { "call": "float_configure"; win: WindowId; config: FloatConfig }
+  | { "call": "ns_create"; name: string }
+  | {
+    "call": "mark_set";
+    ns: NamespaceId;
+    buf: BufferId;
+    row: number;
+    /**
+     * UTF-8 byte offset into the line, not a character or display column.
+     */
+    col: number;
+    opts: ExtmarkOpts;
+  }
+  | { "call": "mark_del"; ns: NamespaceId; buf: BufferId; id: ExtmarkId }
+  | {
+    "call": "mark_clear";
+    ns: NamespaceId;
+    buf: BufferId;
+    start?: number | null;
+    end?: number | null;
+  }
+  | { "call": "mark_get"; ns: NamespaceId; buf: BufferId; id: ExtmarkId }
+  | { "call": "mark_all"; ns: NamespaceId; buf: BufferId }
+  | { "call": "hl_define"; name: string; def: HighlightDef; default: boolean }
+  | { "call": "hl_get"; name: string }
+  | { "call": "hl_list" }
+  | { "call": "hl_reset"; name: string }
+  | {
+    "call": "win_set_highlights";
+    target: HlTarget;
+    map: Record<string, string>;
+  }
+  | { "call": "surface_claim"; win: WindowId; rect: Rect }
+  | { "call": "surface_put"; surface: SurfaceId; cells: Array<SurfaceCell> }
+  | { "call": "surface_release"; surface: SurfaceId }
+  | { "call": "cmd_register"; name: string; desc?: string | null }
+  | { "call": "cmd_unregister"; name: string }
+  | { "call": "cmd_exec"; name: string; args?: Array<string> }
+  | { "call": "cmd_call"; name: string; args?: Array<string> }
+  | { "call": "cmd_list" }
+  | {
+    "call": "keymap_set";
+    mode: Mode;
+    /**
+     * Neovim-style notation: `<C-x>`, `<Esc>`, `<CR>`, `gd`.
+     */
+    lhs: string;
+    /**
+     * Command name to invoke. Plugins bind keys to commands, never to raw callbacks, so that
+     * every binding is discoverable and remappable by the user.
+     */
+    command: string;
+    scope: KeymapScope | null;
+    desc?: string | null;
+  }
+  | { "call": "keymap_del"; mode: Mode; lhs: string; scope: KeymapScope | null }
+  | { "call": "keymap_capture"; win: WindowId; command: string }
+  | { "call": "keymap_release"; win: WindowId }
+  | { "call": "keymap_list"; mode?: Mode | null }
+  | { "call": "focus_push"; win: WindowId }
+  | { "call": "focus_pop" }
+  | { "call": "focus_current" }
+  | {
+    "call": "agent_send";
+    text: string;
+    /**
+     * Files to send with it, by path. Copied into the workspace's own directory on the way
+     * through, so a caller may hand over a temporary file and forget about it.
+     *
+     * Anything already on the composer's attachment row goes too — this is *extra*, for a
+     * plugin that has produced an image of its own rather than one somebody pasted.
+     */
+    images?: Array<string>;
+  }
+  | {
+    "call": "agent_command";
+    session?: SessionId | null;
+    command: AgentCommand;
+  }
+  | { "call": "agent_cancel" }
+  | { "call": "agent_get_selection" }
+  | { "call": "agent_set_selection"; selection: ModelSelection }
+  | {
+    "call": "agent_list_models";
+    instance?: InstanceId | null;
+    /**
+     * Re-query the endpoints instead of using this session's cache.
+     *
+     * Discovery is a network round trip per instance. Doing it on every keystroke that opens a
+     * model picker is seconds of nothing happening, so the answer is cached for the session
+     * and this is how you ask for a fresh one.
+     */
+    refresh: boolean;
+  }
+  | { "call": "agent_list_instances" }
+  | { "call": "agent_driver_commands" }
+  | { "call": "chat_attach"; path?: string | null }
+  | { "call": "chat_attachments" }
+  | { "call": "chat_detach"; index?: number | null }
+  | { "call": "chat_detach_all" }
+  | { "call": "chat_set_draft"; text: string }
+  | { "call": "provider_credentials" }
+  | {
+    "call": "provider_set_credential";
+    instance: InstanceId;
+    /**
+     * Overwrite a key that is already there without asking. Off by default.
+     */
+    replace: boolean;
+  }
+  | { "call": "provider_forget_credential"; instance: InstanceId }
+  | {
+    "call": "session_list";
+    /**
+     * Include conversations that have been put away. Off by default, so every existing caller
+     * keeps showing the list the user actually works in.
+     */
+    include_archived: boolean;
+  }
+  | { "call": "session_current" }
+  | {
+    "call": "session_new";
+    cwd?: string | null;
+    title?: string | null;
+    /**
+     * Switch to it as well. `false` is for restoring a workspace.
+     */
+    activate: boolean;
+  }
+  | {
+    "call": "session_switch";
+    session: SessionId;
+    /**
+     * Which terminal moves. Defaults to the one being served, which is what a key press in a
+     * panel means; an orchestrator sending somebody else's screen somewhere says so.
+     */
+    view?: ViewId | null;
+  }
+  | { "call": "view_list" }
+  | { "call": "session_close"; session: SessionId }
+  | { "call": "session_rename"; session: SessionId; title?: string | null }
+  | { "call": "session_archive"; session: SessionId; archived: boolean }
+  | { "call": "session_messages"; session?: SessionId | null }
+  | { "call": "sessions_stored" }
+  | { "call": "tool_register"; def: ToolDef }
+  | { "call": "tool_unregister"; name: string }
+  | { "call": "tool_list" }
+  | {
+    "call": "hook_register";
+    hook: HookName;
+    /**
+     * Non-blocking hooks are pure observers and cannot veto — that is what stops an audit
+     * plugin from wedging the agent loop. Blocking hooks are awaited, and a timeout is
+     * treated as a veto so a permission plugin fails closed.
+     */
+    blocking: boolean;
+    timeout_ms?: number | null;
+  }
+  | { "call": "hook_unregister"; hook: HookName }
+  | {
+    "call": "provider_register_driver";
+    driver: DriverKind;
+    instances: Array<InstanceConfig>;
+    /**
+     * Whether this driver runs its own agent loop, like `claude` or anything speaking ACP.
+     *
+     * It changes what the host does with the stream, not how the stream is produced: an agent
+     * driver is sent no tool list, because it brings its own, and neosh's tool registry, hooks
+     * and permission layer therefore do not gate what it does. Saying so is the honest option
+     * — a plugin shipping an agent driver that claimed to be a model driver would have the
+     * host run its tool calls a second time.
+     */
+    agent_loop: boolean;
+  }
+  | { "call": "provider_emit"; stream: StreamId; event: ProviderEvent }
+  | { "call": "permission_get_mode" }
+  | { "call": "permission_set_mode"; mode: PermissionMode }
+  | { "call": "permission_check"; capability: Capability }
+  | { "call": "ask_user"; questions: Array<UserQuestion> }
+  | { "call": "opt_declare"; spec: OptionSpec }
+  | { "call": "opt_set"; name: string; value: OptionValue }
+  | { "call": "opt_get"; name: string }
+  | { "call": "opt_reset"; name: string }
+  | { "call": "opt_all" }
+  | { "call": "state_get"; key: string }
+  | { "call": "state_set"; key: string; value: unknown }
+  | { "call": "state_delete"; key: string }
+  | {
+    "call": "ext_contribute";
+    point: string;
+    id: string;
+    item: unknown;
+    /**
+     * Where it sorts among the contributions on this point. Ties break on plugin id, so the
+     * order is stable across restarts rather than being load order.
+     */
+    priority: number;
+  }
+  | { "call": "ext_remove"; point: string; id: string }
+  | { "call": "ext_list"; point: string }
+  | { "call": "ext_points" }
+  | { "call": "plugin_list" }
+  | { "call": "event_emit"; name: string; data?: unknown }
+  | { "call": "var_get"; scope: VarScope; key: string }
+  | { "call": "var_set"; scope: VarScope; key: string; value: unknown }
+  | { "call": "var_delete"; scope: VarScope; key: string }
+  | { "call": "var_all"; scope: VarScope }
+  | { "call": "swarm_self" }
+  | { "call": "swarm_nodes" }
+  | { "call": "swarm_agents" }
+  | { "call": "swarm_hosts_of"; project: ProjectKey }
+  | {
+    "call": "swarm_command";
+    node: NodeId;
+    session: SessionId;
+    command: AgentCommand;
+  }
+  | { "call": "swarm_subscribe"; node: NodeId; session: SessionId }
+  | { "call": "swarm_unsubscribe"; node: NodeId; session: SessionId }
+  | { "call": "swarm_probe"; addr: string }
+  | { "call": "swarm_pair"; node: NodeId; name: string; addr?: string | null }
+  | { "call": "swarm_unpair"; node: NodeId }
+  | { "call": "swarm_reconnect"; node: NodeId }
+  | { "call": "swarm_disconnect"; node: NodeId }
+  | { "call": "swarm_strangers" }
+  | { "call": "quota_list" }
+  | { "call": "quota_refresh"; instance?: InstanceId | null }
+  | { "call": "quota_report"; snapshot: QuotaSnapshot }
+  | {
+    "call": "quota_history";
+    instance?: InstanceId | null;
+    /**
+     * Unix seconds, inclusive.
+     */
+    since: number;
+    /**
+     * Unix seconds, exclusive.
+     */
+    until: number;
+  }
+  | {
+    "call": "usage_history";
+    /**
+     * Unix seconds, inclusive.
+     */
+    since: number;
+    /**
+     * Unix seconds, exclusive.
+     */
+    until: number;
+    resolution: UsageResolution;
+    /**
+     * IANA zone to bucket days in. An offset is wrong for any span crossing a DST boundary.
+     */
+    time_zone?: string | null;
+  }
+  | { "call": "rtp_add"; path: string }
+  | { "call": "rtp_list" }
+  | { "call": "path_complete"; prefix: string }
+  | { "call": "git_status"; cwd?: string | null }
+  | {
+    "call": "git_branches";
+    include_remote: boolean;
+    /**
+     * Which checkout to ask. `None` is the one this conversation is in, which is what almost
+     * every caller means. See [`ApiCall::GitWorktrees`] for why the others exist.
+     */
+    cwd?: string | null;
+  }
+  | { "call": "git_worktrees"; cwd?: string | null }
+  | { "call": "git_log"; limit: number }
+  | {
+    "call": "git_diff";
+    target: DiffTarget;
+    /**
+     * `--stat` instead of the patch. A prompt builder wants this; a diff view does not.
+     */
+    stat: boolean;
+  }
+  | { "call": "git_default_branch" }
+  | { "call": "git_create_branch"; name: string; from?: string | null }
+  | { "call": "git_checkout"; rev: string }
+  | {
+    "call": "git_rename_branch";
+    old: string;
+    new: string;
+    /**
+     * The checkout the branch belongs to. `git branch -m` runs *inside* a repository, and a
+     * caller renaming the branch of a worktree other than the active conversation's has to
+     * say which — the same reason [`Self::GitAddWorktree`] takes one.
+     */
+    cwd?: string | null;
+  }
+  | { "call": "git_stage"; paths: Array<string> }
+  | { "call": "git_unstage"; paths: Array<string> }
+  | { "call": "git_commit"; message: string }
+  | {
+    "call": "git_pull";
+    /**
+     * The repository to pull in. The conversation's own when absent.
+     */
+    cwd?: string | null;
+  }
+  | {
+    "call": "git_add_worktree";
+    path: string;
+    branch: string;
+    create: boolean;
+    /**
+     * The repository to add it to. `git worktree add` runs *inside* a checkout, so a caller
+     * making a worktree of a project other than the active one has to say which.
+     */
+    cwd?: string | null;
+  }
+  | {
+    "call": "git_remove_worktree";
+    path: string;
+    force: boolean;
+    /**
+     * The repository the worktree belongs to. `git worktree remove` has to run from a
+     * checkout *other* than the one being removed, and the conversation the caller is in may
+     * be standing in exactly that one.
+     */
+    cwd?: string | null;
+  }
+  | {
+    "call": "gen_complete";
+    prompt: string;
+    system?: string | null;
+    /**
+     * Ask for JSON and parse it host-side, tolerating the code fences models wrap it in.
+     */
+    json: boolean;
+    /**
+     * Defaults to `gen.model` if set, else the session's own selection.
+     */
+    selection?: ModelSelection | null;
+  }
+  | { "call": "status_set"; key: string; segment: StatusSegment }
+  | { "call": "status_clear"; key: string }
+  | { "call": "hint_set"; key: string; hint: Hint }
+  | { "call": "hint_clear"; key: string }
+  | { "call": "log"; level: MessageLevel; message: string }
+  | {
+    "call": "notify";
+    level: MessageLevel;
+    message: string;
+    /**
+     * Whether the user asked for this. `Reply` is the default and is what a bare
+     * `neosh.notify` has always meant.
+     */
+    kind: NoticeKind;
+    /**
+     * Which progress row to write, for [`NoticeKind::Progress`]. Ignored otherwise.
+     */
+    key?: string | null;
+  }
+  | { "call": "notify_done"; key: string }
+  | {
+    "call": "alert";
+    level: MessageLevel;
+    /**
+     * What this is about, in a few words.
+     */
+    title: string;
+    message: string;
+    /**
+     * Which conversation this is about, if it is about one.
+     *
+     * The test for "can they see it already" is asked against this. An alert with no
+     * conversation is about the workspace, and is never on screen by definition.
+     */
+    session?: SessionId | null;
+  };

package/src/generated/ApiError.ts

@@ -0,0 +1,15 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Why a call failed.
+ *
+ * Distinguishing these matters: a plugin should retry a `Busy`, surface a `Denied` to the user,
+ * and treat `InvalidArgument` as its own bug.
+ */
+export type ApiError =
+  | { "kind": "not_found"; what: string }
+  | { "kind": "invalid_argument"; message: string }
+  | { "kind": "denied"; reason: string }
+  | { "kind": "not_permitted"; capability: string }
+  | { "kind": "busy"; message: string }
+  | { "kind": "internal"; message: string };

package/src/generated/ApiOk.ts

@@ -0,0 +1,110 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AttachmentInfo } from "./AttachmentInfo";
+import type { BranchInfo } from "./BranchInfo";
+import type { BufferId } from "./BufferId";
+import type { CommandEntry } from "./CommandEntry";
+import type { CommitInfo } from "./CommitInfo";
+import type { Contribution } from "./Contribution";
+import type { CredentialInfo } from "./CredentialInfo";
+import type { DriverCommand } from "./DriverCommand";
+import type { ExtmarkId } from "./ExtmarkId";
+import type { ExtmarkInfo } from "./ExtmarkInfo";
+import type { HighlightDef } from "./HighlightDef";
+import type { HighlightEntry } from "./HighlightEntry";
+import type { HighlightSpec } from "./HighlightSpec";
+import type { InstanceConfig } from "./InstanceConfig";
+import type { KeymapEntry } from "./KeymapEntry";
+import type { Message } from "./Message";
+import type { ModelEntry } from "./ModelEntry";
+import type { ModelSelection } from "./ModelSelection";
+import type { NamespaceId } from "./NamespaceId";
+import type { NodeInfo } from "./NodeInfo";
+import type { OptionEntry } from "./OptionEntry";
+import type { PermissionDecision } from "./PermissionDecision";
+import type { PermissionMode } from "./PermissionMode";
+import type { PluginInfo } from "./PluginInfo";
+import type { PointInfo } from "./PointInfo";
+import type { QuestionAnswer } from "./QuestionAnswer";
+import type { QuotaSample } from "./QuotaSample";
+import type { QuotaSnapshot } from "./QuotaSnapshot";
+import type { RepoStatus } from "./RepoStatus";
+import type { SessionId } from "./SessionId";
+import type { SessionInfo } from "./SessionInfo";
+import type { SurfaceId } from "./SurfaceId";
+import type { SwarmAgent } from "./SwarmAgent";
+import type { SwarmNode } from "./SwarmNode";
+import type { SwarmStranger } from "./SwarmStranger";
+import type { ToolDef } from "./ToolDef";
+import type { UsageHistory } from "./UsageHistory";
+import type { ViewInfo } from "./ViewInfo";
+import type { Viewport } from "./Viewport";
+import type { WindowId } from "./WindowId";
+import type { WindowInfo } from "./WindowInfo";
+import type { WorktreeInfo } from "./WorktreeInfo";
+
+/**
+ * Successful results. One variant per shape rather than a bag of JSON, so the TS side gets real
+ * discriminated unions.
+ */
+export type ApiOk =
+  | { "ok": "unit" }
+  | { "ok": "bool"; value: boolean }
+  | { "ok": "buf"; buf: BufferId }
+  | { "ok": "win"; win: WindowId }
+  | { "ok": "views"; views: Array<ViewInfo> }
+  | { "ok": "ns"; ns: NamespaceId }
+  | { "ok": "mark"; id: ExtmarkId }
+  | { "ok": "surface"; surface: SurfaceId }
+  | { "ok": "lines"; lines: Array<string> }
+  | { "ok": "count"; n: number }
+  | { "ok": "cursor"; row: number; col: number }
+  | { "ok": "mark_info"; info: ExtmarkInfo | null }
+  | { "ok": "marks"; marks: Array<ExtmarkInfo> }
+  | { "ok": "models"; models: Array<ModelEntry> }
+  | { "ok": "instances"; instances: Array<InstanceConfig> }
+  | { "ok": "selection"; selection: ModelSelection | null }
+  | { "ok": "tools"; tools: Array<ToolDef> }
+  | { "ok": "names"; names: Array<string> }
+  | { "ok": "commands"; commands: Array<CommandEntry> }
+  | { "ok": "driver_commands"; commands: Array<DriverCommand> }
+  | { "ok": "keymaps"; keymaps: Array<KeymapEntry> }
+  | { "ok": "permission"; decision: PermissionDecision }
+  | { "ok": "answers"; answers?: Array<QuestionAnswer> | null }
+  | { "ok": "permission_mode"; mode: PermissionMode }
+  | { "ok": "focused_win"; win: WindowId | null }
+  | { "ok": "option"; entry: OptionEntry | null }
+  | { "ok": "options"; options: Array<OptionEntry> }
+  | { "ok": "paths"; paths: Array<string> }
+  | { "ok": "viewport"; viewport: Viewport | null }
+  | { "ok": "sessions"; sessions: Array<SessionInfo> }
+  | { "ok": "credentials"; credentials: Array<CredentialInfo> }
+  | { "ok": "session"; session: SessionInfo }
+  | { "ok": "maybe_session"; session: SessionId | null }
+  | { "ok": "messages"; messages: Array<Message> }
+  | { "ok": "status"; status: RepoStatus }
+  | { "ok": "branches"; branches: Array<BranchInfo> }
+  | { "ok": "worktrees"; worktrees: Array<WorktreeInfo> }
+  | { "ok": "commits"; commits: Array<CommitInfo> }
+  | { "ok": "commit"; commit: CommitInfo }
+  | { "ok": "text"; text: string }
+  | { "ok": "maybe_text"; text: string | null }
+  | { "ok": "json"; value: unknown }
+  | { "ok": "vars"; vars: Record<string, unknown> }
+  | { "ok": "contributions"; contributions: Array<Contribution> }
+  | { "ok": "windows"; windows: Array<WindowInfo> }
+  | {
+    "ok": "highlight";
+    def?: HighlightDef | null;
+    resolved?: HighlightSpec | null;
+  }
+  | { "ok": "highlights"; groups: Array<HighlightEntry> }
+  | { "ok": "points"; points: Array<PointInfo> }
+  | { "ok": "plugins"; plugins: Array<PluginInfo> }
+  | { "ok": "attachments"; attachments: Array<AttachmentInfo> }
+  | { "ok": "swarm_self"; node: NodeInfo | null }
+  | { "ok": "swarm_nodes"; nodes: Array<SwarmNode> }
+  | { "ok": "swarm_agents"; agents: Array<SwarmAgent> }
+  | { "ok": "swarm_strangers"; strangers: Array<SwarmStranger> }
+  | { "ok": "quotas"; quotas: Array<QuotaSnapshot> }
+  | { "ok": "quota_history"; samples: Array<QuotaSample> }
+  | { "ok": "usage_history"; history: UsageHistory };

package/src/generated/ApiResponse.ts

@@ -0,0 +1,8 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ApiError } from "./ApiError";
+import type { ApiOk } from "./ApiOk";
+
+export type ApiResponse = { "status": "ok"; value: ApiOk } | {
+  "status": "err";
+  error: ApiError;
+};