@neosh/api 0.1.0

package/src/generated/MarkDraw.ts

@@ -0,0 +1,40 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { OnDelete } from "./OnDelete";
+import type { VirtChunk } from "./VirtChunk";
+import type { VirtTextPos } from "./VirtTextPos";
+
+/**
+ * One mark of a [`LineDraw`], positioned on that line.
+ */
+export type MarkDraw = {
+  /**
+   * UTF-8 byte offset into the line's text, as every column on this wire is.
+   */
+  col: number;
+  /**
+   * End column for a ranged highlight, as a UTF-8 byte offset. `None` means a point mark.
+   */
+  end_col?: number | null;
+  hl_group?: string | null;
+  /**
+   * A background for the whole rendered row, not just the bytes the mark covers.
+   *
+   * The distinction is the difference between a diff line that is green and a diff line whose
+   * *text* is green: the band has to reach the right edge of the window to read as one line, and
+   * how wide the window is is not known where the row is written. So the group is carried and
+   * the frontend fills to its own edge — which is also what makes the band survive a resize.
+   *
+   * It sits *under* every ranged `hl_group` on the row rather than competing with them, so a
+   * syntax colour on top keeps its foreground and inherits this background. Nothing else in the
+   * mark vocabulary composes; this one has to, because "which line changed" and "what does this
+   * word mean" are two facts about the same character.
+   */
+  line_hl_group?: string | null;
+  virt_text?: Array<VirtChunk>;
+  virt_text_pos: VirtTextPos;
+  on_delete: OnDelete;
+  /**
+   * Higher priority draws over lower when marks overlap.
+   */
+  priority: number;
+};

package/src/generated/Message.ts

@@ -0,0 +1,5 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ContentBlock } from "./ContentBlock";
+import type { Role } from "./Role";
+
+export type Message = { role: Role; content: Array<ContentBlock> };

package/src/generated/MessageLevel.ts

@@ -0,0 +1,3 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type MessageLevel = "info" | "warn" | "error";

package/src/generated/Mode.ts

@@ -0,0 +1,6 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Editing mode, for keymap scoping.
+ */
+export type Mode = "normal" | "insert" | "visual" | "chat";

package/src/generated/ModelCapabilities.ts

@@ -0,0 +1,14 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ProviderOptionDescriptor } from "./ProviderOptionDescriptor";
+
+export type ModelCapabilities = {
+  tools: boolean;
+  vision: boolean;
+  streaming: boolean;
+  thinking: boolean;
+  prompt_caching: boolean;
+  /**
+   * Knobs this specific model exposes. See [`ProviderOptionDescriptor`].
+   */
+  option_descriptors?: Array<ProviderOptionDescriptor>;
+};

package/src/generated/ModelEntry.ts

@@ -0,0 +1,13 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { InstanceId } from "./InstanceId";
+import type { ModelInfo } from "./ModelInfo";
+
+/**
+ * A model together with the instance that serves it.
+ *
+ * The pairing is not decoration. A model id is unique per instance, not globally — two instances
+ * can both serve `gpt-4o`, and one of them may be a local endpoint. A picker that returned bare
+ * [`ModelInfo`] would have to guess the owner, and guessing wrong sends the conversation to the
+ * wrong endpoint with no visible error.
+ */
+export type ModelEntry = { instance: InstanceId; model: ModelInfo };

package/src/generated/ModelId.ts

@@ -0,0 +1,6 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * A model identifier as the provider spells it, e.g. `claude-opus-5`, `gpt-5`, `llama3.3:70b`.
+ */
+export type ModelId = string;

package/src/generated/ModelInfo.ts

@@ -0,0 +1,30 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ModelCapabilities } from "./ModelCapabilities";
+import type { ModelId } from "./ModelId";
+import type { ModelTier } from "./ModelTier";
+import type { Pricing } from "./Pricing";
+
+export type ModelInfo = {
+  id: ModelId;
+  display_name: string;
+  context_window?: number | null;
+  max_output_tokens?: number | null;
+  capabilities: ModelCapabilities;
+  pricing?: Pricing | null;
+  /**
+   * The lineup: `"opus"`, `"sonnet"`, `"gpt-5"`. Models sharing a family are the same product at
+   * different versions, which is what "the best one in that line" means.
+   */
+  family?: string | null;
+  tier?: ModelTier | null;
+  /**
+   * Superseded, but still reachable. Folded away in a picker rather than removed, because the
+   * reason you go looking for last year's model is usually that you need to reproduce something.
+   */
+  legacy: boolean;
+  /**
+   * One line on what it is for. `"Most capable for complex work"`, not `"128k context"` — the
+   * numbers are already columns.
+   */
+  tagline?: string | null;
+};

package/src/generated/ModelSelection.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.
+import type { InstanceId } from "./InstanceId";
+import type { ModelId } from "./ModelId";
+import type { OptionSelection } from "./OptionSelection";
+
+/**
+ * A model, qualified by the instance that serves it, plus the option values in effect.
+ *
+ * Hot-swappable mid-session: the next turn uses whatever this says.
+ */
+export type ModelSelection = {
+  instance: InstanceId;
+  model: ModelId;
+  options?: Array<OptionSelection>;
+};

package/src/generated/ModelTier.ts

@@ -0,0 +1,14 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Where a model sits on the capability ladder.
+ *
+ * Three rungs, because every lineup worth switching between has three: Opus/Sonnet/Haiku,
+ * gpt-5/mini/nano, Pro/Flash/Flash-Lite. This is what makes "give me the next one down" a question
+ * with an answer, across catalogues that share no naming convention at all.
+ *
+ * It is a *statement about the model*, supplied by whoever describes it — a catalogue entry, a
+ * discovery response, a provider plugin. Nothing infers it from an id, because id conventions are
+ * exactly the thing that differs.
+ */
+export type ModelTier = "fast" | "balanced" | "frontier";

package/src/generated/NamespaceId.ts

@@ -0,0 +1,6 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * An extmark namespace. Namespaces let a plugin clear only its own annotations.
+ */
+export type NamespaceId = number;

package/src/generated/NodeCapabilities.ts

@@ -0,0 +1,30 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { RemoteProject } from "./RemoteProject";
+
+/**
+ * What a node is willing to have done to it.
+ *
+ * Sent in the handshake, so a board can grey out a verb rather than offering one that will be
+ * refused. Advisory to the *caller*; the owner enforces regardless, because a capability list is
+ * something the other side could have lied about.
+ */
+export type NodeCapabilities = {
+  /**
+   * Whether [`AgentCommand::Send`] and friends are accepted at all. `false` makes this node
+   * visible but read-only — a perfectly reasonable thing for a build machine to be.
+   */
+  accepts_commands: boolean;
+  /**
+   * Whether [`AgentCommand::Approve`] is accepted. Separate from `accepts_commands` because it
+   * is a different kind of trust: steering an agent is a message, approving one is a write.
+   */
+  accepts_approvals: boolean;
+  /**
+   * Whether [`AscpMessage::Subscribe`] will produce anything.
+   */
+  streams: boolean;
+  /**
+   * The checkouts this node has, for starting something on it.
+   */
+  projects: Array<RemoteProject>;
+};

package/src/generated/NodeId.ts

@@ -0,0 +1,11 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * A node's public identity: the hex ed25519 public key.
+ *
+ * The key *is* the name. There is no registry, no certificate authority and nothing to revoke
+ * centrally — you authorise a peer by putting its id in your own list, and you de-authorise it by
+ * taking it out. For a workspace that is one person's several computers, a CA would be
+ * infrastructure to run in exchange for nothing.
+ */
+export type NodeId = string;

package/src/generated/NodeInfo.ts

@@ -0,0 +1,24 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { NodeId } from "./NodeId";
+
+/**
+ * What a node says about itself.
+ */
+export type NodeInfo = {
+  id: NodeId;
+  /**
+   * What to call it on screen — the hostname unless the user chose something.
+   *
+   * Advisory, and not unique: two machines may both be called `laptop`. Anything that has to be
+   * right uses [`NodeId`].
+   */
+  name: string;
+  /**
+   * `macos`, `linux`, `windows`. For the icon and for "why is that one behaving differently".
+   */
+  os: string;
+  /**
+   * The neosh version, so a board can say which machine is behind.
+   */
+  version: string;
+};

package/src/generated/NoticeKind.ts

@@ -0,0 +1,11 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * What kind of thing a message is, which is a different question from how bad it is.
+ *
+ * [`MessageLevel`] says how bad and therefore what colour; this says whether you asked for it,
+ * and therefore where it goes and how long it lives. Every message used to be the same kind of
+ * thing — a row in a six-second stack — so a pull's progress, the echo of a key you just pressed
+ * and a node dropping off the swarm were one channel with one lifetime.
+ */
+export type NoticeKind = "reply" | "progress" | "alert";

package/src/generated/Offset.ts

@@ -0,0 +1,7 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * A cell offset from the anchor point. May be negative to place a float above or left of its
+ * anchor.
+ */
+export type Offset = { row: number; col: number };

package/src/generated/OnDelete.ts

@@ -0,0 +1,7 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * What happens to a mark when the text it sits on is replaced by content that has no
+ * corresponding line.
+ */
+export type OnDelete = "clamp" | "invalidate";

package/src/generated/OptionChoice.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.
+
+export type OptionChoice = {
+  id: string;
+  label: string;
+  description?: string | null;
+  is_default: boolean;
+};

package/src/generated/OptionEntry.ts

@@ -0,0 +1,23 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { OptionType } from "./OptionType";
+import type { OptionValue } from "./OptionValue";
+
+/**
+ * A declared option with its current value, as listed.
+ */
+export type OptionEntry = {
+  name: string;
+  type: OptionType;
+  value: OptionValue;
+  default: OptionValue;
+  description?: string | null;
+  /**
+   * Who declared it. `neosh` for built-ins; otherwise the plugin id.
+   */
+  owner: string;
+  /**
+   * False while the option still holds its default, so a settings UI can show what the user
+   * actually changed and a `:set` persister knows what is worth writing down.
+   */
+  modified: boolean;
+};

package/src/generated/OptionSelection.ts

@@ -0,0 +1,4 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ProviderOptionValue } from "./ProviderOptionValue";
+
+export type OptionSelection = { id: string; value: ProviderOptionValue };

package/src/generated/OptionSpec.ts

@@ -0,0 +1,17 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { OptionType } from "./OptionType";
+import type { OptionValue } from "./OptionValue";
+
+/**
+ * What a declaration says.
+ */
+export type OptionSpec = {
+  /**
+   * Dotted, lowercase: `agent.model`, `myplugin.enabled`. Validated at declaration so the name
+   * space stays greppable and a future `:set` grammar has something regular to parse.
+   */
+  name: string;
+  type: OptionType;
+  default: OptionValue;
+  description?: string | null;
+};

package/src/generated/OptionType.ts

@@ -0,0 +1,16 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * What an option accepts.
+ *
+ * The constraint travels with the declaration rather than living in the setter, so a settings UI
+ * can render a correct control for an option it has never heard of.
+ */
+export type OptionType =
+  | { "type": "bool" }
+  | { "type": "int"; min?: number | null; max?: number | null }
+  | { "type": "float" }
+  | { "type": "str" }
+  | { "type": "enum"; values: Array<string> }
+  | { "type": "list" }
+  | { "type": "json" };

package/src/generated/OptionValue.ts

@@ -0,0 +1,13 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * An option's value.
+ *
+ * Untagged on purpose: a config file says `border = "rounded"`, not
+ * `border = { kind = "str", value = "rounded" }`. Deserialization tries the variants in
+ * declaration order, so `true` is a `Bool` and `3` is an `Int` rather than both landing in
+ * `Json`. Type checking happens against the declaration, which is where the type actually is.
+ */
+export type OptionValue = boolean | number | number | string | Array<string> | {
+  [key: string]: unknown;
+};

package/src/generated/PermissionDecision.ts

@@ -0,0 +1,6 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type PermissionDecision = { "kind": "allow" } | {
+  "kind": "deny";
+  reason: string;
+} | { "kind": "prompt" };

package/src/generated/PermissionMode.ts

@@ -0,0 +1,3 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type PermissionMode = "ask" | "allow_listed" | "allow" | "deny";

package/src/generated/PermissionOption.ts

@@ -0,0 +1,21 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { PermissionOptionKind } from "./PermissionOptionKind";
+
+/**
+ * One answer a permission request offers.
+ *
+ * Agent drivers word their own options — "Yes, and don't ask again for `cargo test`" is a
+ * sentence only the agent that ran it can write. neosh's own tools offer none, and the prompt
+ * falls back to yes and no.
+ */
+export type PermissionOption = {
+  /**
+   * Opaque, and handed straight back to whoever asked. Never parsed.
+   */
+  id: string;
+  /**
+   * What the option says, in the asker's own words.
+   */
+  label: string;
+  kind: PermissionOptionKind;
+};

package/src/generated/PermissionOptionKind.ts

@@ -0,0 +1,13 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * What taking an option would mean, independent of how it is worded.
+ *
+ * The wording is the agent's and is shown; this is what lets a UI sort the safe answer to the top,
+ * colour the dangerous one, and pick a default without reading English.
+ */
+export type PermissionOptionKind =
+  | "allow_once"
+  | "allow_always"
+  | "reject_once"
+  | "reject_always";

package/src/generated/PlanState.ts

@@ -0,0 +1,6 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * How a step of a plan is going.
+ */
+export type PlanState = "pending" | "active" | "done";

package/src/generated/PlanStep.ts

@@ -0,0 +1,7 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { PlanState } from "./PlanState";
+
+/**
+ * One line of the agent's own checklist.
+ */
+export type PlanStep = { text: string; state: PlanState };

package/src/generated/PluginActivation.ts

@@ -0,0 +1,10 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * The triggers that wake a lazily loaded plugin. See [`PluginManifest::activation`].
+ */
+export type PluginActivation = {
+  on_command?: Array<string>;
+  on_event?: Array<string>;
+  on_kind?: Array<string>;
+};

package/src/generated/PluginEvent.ts

@@ -0,0 +1,77 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Activity } from "./Activity";
+import type { BufferId } from "./BufferId";
+import type { HookName } from "./HookName";
+import type { HookPayload } from "./HookPayload";
+import type { KeyContext } from "./KeyContext";
+import type { ModelSelection } from "./ModelSelection";
+import type { NodeId } from "./NodeId";
+import type { OptionValue } from "./OptionValue";
+import type { QuotaSnapshot } from "./QuotaSnapshot";
+import type { SessionId } from "./SessionId";
+import type { StopReason } from "./StopReason";
+import type { StreamEvent } from "./StreamEvent";
+import type { StreamId } from "./StreamId";
+import type { ToolCall } from "./ToolCall";
+import type { ToolResult } from "./ToolResult";
+import type { TurnId } from "./TurnId";
+import type { Usage } from "./Usage";
+import type { VarScope } from "./VarScope";
+import type { ViewId } from "./ViewId";
+import type { WindowId } from "./WindowId";
+
+export type PluginEvent =
+  | {
+    "type": "command_invoked";
+    name: string;
+    args?: Array<string>;
+    key?: KeyContext | null;
+  }
+  | { "type": "view_attached"; view: ViewId }
+  | { "type": "view_closed"; view: ViewId }
+  | {
+    "type": "buffer_changed";
+    buf: BufferId;
+    start: number;
+    old_end: number;
+    new_end: number;
+  }
+  | { "type": "turn_started"; session: SessionId; turn: TurnId }
+  | { "type": "token"; session: SessionId; turn: TurnId; text: string }
+  | { "type": "thinking_token"; session: SessionId; turn: TurnId; text: string }
+  | { "type": "tool_started"; session: SessionId; turn: TurnId; call: ToolCall }
+  | {
+    "type": "tool_finished";
+    session: SessionId;
+    turn: TurnId;
+    call: ToolCall;
+    result: ToolResult;
+  }
+  | {
+    "type": "turn_ended";
+    session: SessionId;
+    turn: TurnId;
+    stop_reason: StopReason;
+    usage: Usage;
+  }
+  | { "type": "hook_observed"; hook: HookName; payload: HookPayload }
+  | { "type": "focus_changed"; win?: WindowId | null }
+  | { "type": "option_changed"; name: string; value: OptionValue }
+  | { "type": "session_changed"; session: SessionId; view: ViewId }
+  | { "type": "selection_changed"; selection: ModelSelection }
+  | { "type": "activity"; session: SessionId; turn: TurnId; activity: Activity }
+  | { "type": "composer_changed"; text: string }
+  | { "type": "event"; name: string; data?: unknown; from: string }
+  | { "type": "var_changed"; scope: VarScope; key: string; value?: unknown }
+  | { "type": "highlight_changed"; names: Array<string> }
+  | { "type": "contributions_changed"; point: string }
+  | { "type": "swarm_changed" }
+  | {
+    "type": "swarm_stream";
+    node: NodeId;
+    session: SessionId;
+    event: StreamEvent;
+  }
+  | { "type": "quota"; snapshot: QuotaSnapshot }
+  | { "type": "provider_cancel"; stream: StreamId }
+  | { "type": "shutdown" };

package/src/generated/PluginId.ts

@@ -0,0 +1,6 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Identifies a loaded plugin. Stable across reloads; derived from the manifest `name`.
+ */
+export type PluginId = string;

package/src/generated/PluginInbound.ts

@@ -0,0 +1,10 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ApiResponse } from "./ApiResponse";
+import type { PluginEvent } from "./PluginEvent";
+import type { PluginRequest } from "./PluginRequest";
+import type { RequestId } from "./RequestId";
+
+export type PluginInbound =
+  | { "type": "response"; id: RequestId; response: ApiResponse }
+  | { "type": "request"; id: RequestId; request: PluginRequest }
+  | { "type": "event"; event: PluginEvent };

package/src/generated/PluginInfo.ts

@@ -0,0 +1,19 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { PluginManifest } from "./PluginManifest";
+
+/**
+ * One plugin as [`ApiCall::PluginList`] reports it.
+ */
+export type PluginInfo = {
+  name: string;
+  manifest: PluginManifest;
+  /**
+   * Ships inside the binary.
+   */
+  bundled: boolean;
+  /**
+   * `loaded`, `held` (lazy, waiting for a trigger), or `failed` with the reason in `error`.
+   */
+  state: string;
+  error?: string | null;
+};

package/src/generated/PluginManifest.ts

@@ -0,0 +1,54 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { PluginActivation } from "./PluginActivation";
+import type { PluginPermission } from "./PluginPermission";
+import type { PluginProvides } from "./PluginProvides";
+
+/**
+ * `plugin.toml`, next to the plugin's entry point.
+ */
+export type PluginManifest = {
+  name: string;
+  version: string;
+  /**
+   * Entry module, relative to the plugin directory.
+   */
+  entry: string;
+  description?: string | null;
+  /**
+   * Protocol major this plugin was built against. Checked at load.
+   */
+  api_version: number;
+  permissions?: Array<PluginPermission>;
+  /**
+   * Plugins this one cannot run without.
+   *
+   * Each is loaded and activated first, `import ... from "plugin:<name>"` resolves to its entry
+   * module, and a name nothing provides is an error with the name in it rather than an
+   * `undefined` three calls later. A cycle is reported and neither side loads. Load order used
+   * to be a filesystem sort that the code leaned on; this is the same order, said out loud.
+   */
+  requires?: Array<string>;
+  /**
+   * Plugins to load after if they are present, without needing them.
+   *
+   * For "my section goes under theirs" and "my default key should lose to theirs": a soft
+   * ordering, satisfied by an absent plugin, that does not make the other plugin a dependency.
+   */
+  after?: Array<string>;
+  /**
+   * What this plugin offers for others to build on — the contribution points it reads, the
+   * buffer kinds it publishes, the shared vars it writes. Declared so they can be listed, and
+   * so a contribution to a point nobody reads can be reported instead of silently ignored.
+   */
+  provides?: PluginProvides;
+  /**
+   * When to load, for a plugin that need not be there from the start.
+   *
+   * Absent means at startup, as every plugin always has. Present, the plugin is held until one
+   * of its triggers fires: one of `on_command` is run (the name is registered on its behalf
+   * and the press replayed once it is up), one of `on_event` is emitted, or a buffer of one of
+   * `on_kind` appears. lazy.nvim's `cmd`/`event`/`ft`. A plugin something eager `requires` is
+   * loaded eagerly whatever this says.
+   */
+  activation?: PluginActivation;
+};

package/src/generated/PluginOutbound.ts

@@ -0,0 +1,11 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ApiCall } from "./ApiCall";
+import type { PluginResponse } from "./PluginResponse";
+import type { RequestId } from "./RequestId";
+import type { ViewId } from "./ViewId";
+
+export type PluginOutbound =
+  | { "type": "ready"; protocol_version: number }
+  | { "type": "call"; id: RequestId; call: ApiCall; view?: ViewId | null }
+  | { "type": "notify"; call: ApiCall; view?: ViewId | null }
+  | { "type": "response"; id: RequestId; response: PluginResponse };

package/src/generated/PluginPermission.ts

@@ -0,0 +1,18 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * What a plugin declares it needs.
+ *
+ * Phase 0 records and reports these; enforcement lands with the sandboxing work. Declaring them
+ * now means the manifest format does not change when enforcement arrives.
+ */
+export type PluginPermission =
+  | "tools"
+  | "hooks_blocking"
+  | "providers"
+  | "fs_read"
+  | "fs_write"
+  | "network"
+  | "raw_cells"
+  | "vcs_write"
+  | "notify";