@fungi.computer/parakeet 0.0.0-stage → 0.0.1

package/docs/api/headless.md

@@ -0,0 +1,2510 @@
+<!-- Generated by Botanical API docs (TypeDoc + typedoc-plugin-markdown). Do not edit. -->
+
+[**@fungi.computer/parakeet**](README.md)
+
+---
+
+[@fungi.computer/parakeet](README.md) / headless
+
+# headless
+
+## Type Aliases
+
+### LoginMethodKind
+
+```ts
+type LoginMethodKind = "api_key" | "subscription";
+```
+
+How a person proves they may use a provider: an API key or their subscription
+sign-in.
+
+---
+
+### LoginMethod
+
+```ts
+type LoginMethod = Readonly<{
+  kind: LoginMethodKind;
+  label: string;
+}>;
+```
+
+One sign-in method a provider offers, labelled by its owner.
+
+---
+
+### LoginProvider
+
+```ts
+type LoginProvider = Readonly<{
+  id: string;
+  name: string;
+  methods: readonly LoginMethod[];
+}>;
+```
+
+One model provider in the registry. Names come from data, never code.
+
+---
+
+### LoginHost
+
+```ts
+type LoginHost = "local" | "hosted";
+```
+
+Where the credential will be used: the person's machine or Fungi's servers.
+
+---
+
+### LoginScope
+
+```ts
+type LoginScope = "user" | "team";
+```
+
+Whose credential it is: one person, or a Team.
+
+---
+
+### LoginPolicy
+
+```ts
+type LoginPolicy = Readonly<{
+  loginAllowed: (request) => boolean;
+}>;
+```
+
+The credential policy owner's decision, the same shape as
+`@fungi.computer/veil/model-credentials` `loginAllowed`. Login offers only what
+it permits.
+
+---
+
+### ProviderAccess
+
+```ts
+type ProviderAccess = Readonly<{
+  providerId: string;
+  providerName: string;
+  type: "oauth" | "api_key";
+}>;
+```
+
+A configured provider reported by the credential owner, without secrets.
+
+---
+
+### AccountOwner
+
+```ts
+type AccountOwner = Readonly<{
+  popularProviderIds: readonly string[];
+  access: (signal) => Promise<readonly ProviderAccess[]>;
+  providers: (signal) => Promise<readonly LoginProvider[]>;
+  login: (request, interaction) => Promise<void>;
+  logout: (providerId, interaction) => Promise<void>;
+  status: (signal) => Promise<string>;
+}>;
+```
+
+The credential owner behind the account commands.
+
+---
+
+### AccountCommandOptions
+
+```ts
+type AccountCommandOptions = Readonly<{
+  sourceId: string;
+  namespace: string;
+  host: LoginHost;
+  scope: LoginScope;
+  policy: LoginPolicy;
+}>;
+```
+
+Contribution identity and the policy context for account commands.
+
+---
+
+### ModelAccountContext
+
+```ts
+type ModelAccountContext = Pick<
+  AccountCommandOptions,
+  "policy" | "host" | "scope"
+> &
+  Readonly<{
+    owner: AccountOwner;
+  }>;
+```
+
+One account owner and its credential policy context for an interactive model
+picker.
+
+---
+
+### AdvertisedCatalogError
+
+```ts
+type AdvertisedCatalogError = Readonly<{
+  extensionId: string;
+  message: string;
+}>;
+```
+
+Why one advertised catalog could not become commands.
+
+---
+
+### AdvertisedCommands
+
+```ts
+type AdvertisedCommands = Readonly<{
+  update: (slots) => readonly AdvertisedCatalogError[];
+  dispose: () => void;
+}>;
+```
+
+Live commands for every catalog a Session's extensions advertise.
+
+---
+
+### ParakeetBuiltinOptions
+
+```ts
+type ParakeetBuiltinOptions = Readonly<{
+  clear: () => void;
+  showCommands?: () => void | Promise<void>;
+}>;
+```
+
+The few commands every Parakeet client has, whatever the backend offers.
+
+---
+
+### KeyHint
+
+```ts
+type KeyHint = Readonly<{
+  keys: string;
+  label: string;
+  priority: number;
+}>;
+```
+
+One key hint: the keys, what they do, and how much it matters (0 first).
+
+---
+
+### ComposerKeys
+
+```ts
+type ComposerKeys = Readonly<{
+  newline?: string;
+  scroll?: string;
+  queue?: string;
+}>;
+```
+
+The composer's physical keys, which differ slightly between renderers.
+
+---
+
+### ComposerHintContext
+
+```ts
+type ComposerHintContext = Readonly<{
+  completion: SlashCompletion;
+  busy: boolean;
+  bindings: readonly KeyBindingRow[];
+  keys: ComposerKeys;
+}>;
+```
+
+What the composer is doing right now.
+
+---
+
+### ParakeetOpenInteraction
+
+```ts
+type ParakeetOpenInteraction = Readonly<{
+  key: number;
+  host: WhistleInteractionHost;
+  retry: () => void;
+}>;
+```
+
+One interaction a renderer should draw as a dialog or panel.
+
+---
+
+### ParakeetNotice
+
+```ts
+type ParakeetNotice = Readonly<{
+  tone: "info" | "success" | "error";
+  message: string;
+}>;
+```
+
+A one-line result shown beside the composer instead of a dialog.
+
+---
+
+### ParakeetInteractionState
+
+```ts
+type ParakeetInteractionState = Readonly<{
+  open?: ParakeetOpenInteraction;
+  inspection?: Readonly<{
+    entryId: string;
+    rowId: string;
+  }>;
+  notice?: ParakeetNotice;
+}>;
+```
+
+Everything a renderer draws for command conversations.
+
+---
+
+### ParakeetInteractions
+
+```ts
+type ParakeetInteractions = Readonly<{
+  snapshot: () => ParakeetInteractionState;
+  subscribe: (listener) => () => void;
+  close: () => void;
+  inspect: (inspection) => void;
+  report: (notice) => void;
+  attach: (present) => () => void;
+  lastEnd: () => WhistleInteractionEnd["status"] | undefined;
+}>;
+```
+
+Parakeet's command conversation store, shared by every renderer.
+
+---
+
+### SlashRuntime
+
+```ts
+type SlashRuntime = Pick<WhistleRuntime, "snapshot" | "execute">;
+```
+
+The Whistle surface a composer needs to run drafts.
+
+---
+
+### ParakeetCommandRuntime
+
+```ts
+type ParakeetCommandRuntime = Pick<
+  WhistleRuntime,
+  "contribute" | "snapshot" | "subscribe" | "execute" | "present"
+>;
+```
+
+The Whistle runtime a Parakeet composer runs commands through.
+
+---
+
+### SlashCommandOptions
+
+```ts
+type SlashCommandOptions = Readonly<{
+  enabled?: boolean;
+  commands: ParakeetCommandRuntime;
+  origin: WhistleExecutionOrigin;
+  keys: ComposerKeys;
+  busy: boolean;
+  interactionStore?: ParakeetInteractions;
+  showCommands?: () => void | Promise<void>;
+}>;
+```
+
+Inputs for one composer's command controller.
+
+---
+
+### SlashCommandController
+
+```ts
+type SlashCommandController = Readonly<{
+  completion: SlashCompletion;
+  open: boolean;
+  selected: number;
+  hints: readonly KeyHint[];
+  interactions: ParakeetInteractionState;
+  store: ParakeetInteractions;
+  move: (delta) => boolean;
+  highlight: (index) => void;
+  complete: () => boolean;
+  dismiss: () => boolean;
+  submit: (delivery?) => void;
+  choose: (index) => void;
+}>;
+```
+
+Everything a renderer needs to draw and drive slash commands.
+
+---
+
+### ParakeetSessionViewState
+
+```ts
+type ParakeetSessionViewState =
+  | ParakeetOwnerViewState
+  | Readonly<{
+      kind: "connecting";
+    }>
+  | Readonly<{
+      kind: "disconnected";
+      cause: string;
+    }>;
+```
+
+Owner activity with the connection states shown while observation opens.
+
+---
+
+### ParakeetObservation
+
+```ts
+type ParakeetObservation =
+  | Readonly<{
+      status: "connecting";
+    }>
+  | Readonly<{
+      status: "live";
+    }>
+  | Readonly<{
+      status: "unavailable";
+      reason: string;
+    }>;
+```
+
+Health of the current Session observation.
+
+---
+
+### ParakeetReconnectOutcome
+
+```ts
+type ParakeetReconnectOutcome =
+  | Readonly<{
+      kind: "nothing_to_reconnect";
+      state: "connected" | "connecting";
+    }>
+  | Readonly<{
+      kind: "reconnected";
+    }>
+  | Readonly<{
+      kind: "failed";
+      cause: string;
+    }>;
+```
+
+Result of retrying the shared Session observation.
+
+---
+
+### ClientContribution
+
+```ts
+type ClientContribution = Readonly<{
+  entryId: string;
+  value: ClientContributionV1;
+}>;
+```
+
+Decoded client data, still owned and ordered by its composition root.
+
+---
+
+### PlacedClientCell
+
+```ts
+type PlacedClientCell = Readonly<{
+  entryId: string;
+  cell: ClientTimelineCellV1;
+}>;
+```
+
+A committed cell retains its producer namespace in every renderer.
+
+---
+
+### ParakeetOwnerViewState
+
+```ts
+type ParakeetOwnerViewState =
+  | Readonly<{
+      kind: "idle" | "waiting_for_you" | "thinking" | "responding";
+    }>
+  | Readonly<{
+      kind: "cancelling";
+    }>
+  | Readonly<{
+      kind: "compacting";
+      trigger: SessionCompactionTrigger;
+    }>
+  | Readonly<{
+      kind: "queued";
+      queuedCommandId: string;
+      runningWork: AgentRunningWork | null;
+    }>
+  | Readonly<{
+      kind: "retrying";
+      attempt: number;
+      maxAttempts: number;
+      cause: string;
+      nextRetryAt: number;
+    }>
+  | Readonly<{
+      kind: "running_tool";
+      tool: string;
+    }>
+  | Readonly<{
+      kind: "error";
+      cause: string;
+    }>;
+```
+
+What a person's readout of one Session says, decided from Shiitake's raw
+activity facts. Shiitake publishes facts; this module owns their meaning.
+
+---
+
+### SessionViewFacts
+
+```ts
+type SessionViewFacts = Pick<
+  SessionSnapshot,
+  "activity" | "terminals" | "progress"
+>;
+```
+
+The facts a view state is decided from.
+
+---
+
+### SessionActivityStatus
+
+```ts
+type SessionActivityStatus =
+  "cancelling" | "idle" | "queued" | "retrying" | "streaming" | "thinking";
+```
+
+Coarse activity of a Session, for composer gating.
+
+---
+
+### SessionModelChoice
+
+```ts
+type SessionModelChoice = Readonly<{
+  providerId: string;
+  providerName: string;
+  id: string;
+  name: string;
+  reasoning: readonly NonNullable<ModelPreference["reasoning"]>[];
+}>;
+```
+
+A host's maintained catalog projection; no credentials or provider execution.
+
+---
+
+### SessionModelCommandOptions
+
+```ts
+type SessionModelCommandOptions = Readonly<{
+  account: ModelAccountContext;
+  sourceId: string;
+  namespace: string;
+  models: readonly SessionModelChoice[];
+  refreshModels: (signal) => Promise<readonly SessionModelChoice[]>;
+  availability?: () => WhistleAvailability;
+}>;
+```
+
+Contribution identity, catalog and optional local model-picker presentation.
+
+---
+
+### ReloadSource
+
+```ts
+type ReloadSource = Readonly<object &
+  | {
+  effect: "now";
+  reload: (signal) => Promise<void>;
+}
+  | {
+  effect: "next_turn";
+}
+  | {
+  effect: "unsupported";
+  reason: string;
+}>;
+```
+
+One category a host can account for in `/reload`, described by the owner that
+already holds it. Nothing here caches, restarts or replaces anything: `now`
+re-reads through the owner's own refresh, `next_turn` names a source the owner
+already re-reads at the start of every turn, and `unsupported` names a category
+with no safe re-read or replace lifecycle today.
+
+---
+
+### ReloadCommandOptions
+
+```ts
+type ReloadCommandOptions = Readonly<{
+  sourceId: string;
+  namespace: string;
+  sources: () => readonly ReloadSource[];
+}>;
+```
+
+Where one `/reload` contribution comes from and what it can report.
+
+---
+
+### ParakeetSessionCommandOptions
+
+```ts
+type ParakeetSessionCommandOptions = Readonly<{
+  sourceId: string;
+  namespace: string;
+  sessionResume?: () => void | Promise<void>;
+  sessionResumeAvailable: boolean;
+  onEditQueued?: (text) => void;
+  canEditQueued?: () => boolean;
+  onForked?: (sessionId) => void | Promise<void>;
+  forkAvailable: boolean;
+  onTitled?: (title) => void | Promise<void>;
+}>;
+```
+
+Shared Session actions with optional human presentation callbacks.
+
+## Variables
+
+### toolKindSigils
+
+```ts
+const toolKindSigils: object;
+```
+
+Shared artwork identity for browser and native tool rows.
+
+#### Type Declaration
+
+| Name                                    | Type         | Default value | Description                   |
+| --------------------------------------- | ------------ | ------------- | ----------------------------- |
+| <a id="property-code"></a> `code`       | `"computer"` | `"computer"`  | Artwork for code execution.   |
+| <a id="property-command"></a> `command` | `"run"`      | `"run"`       | Artwork for shell commands.   |
+| <a id="property-edit"></a> `edit`       | `"write"`    | `"write"`     | Artwork for file edits.       |
+| <a id="property-other"></a> `other`     | `"working"`  | `"working"`   | Artwork for other tool calls. |
+| <a id="property-read"></a> `read`       | `"read"`     | `"read"`      | Artwork for file reads.       |
+| <a id="property-search"></a> `search`   | `"list"`     | `"list"`      | Artwork for search results.   |
+
+## Functions
+
+### loginRegistry()
+
+```ts
+function loginRegistry(
+  providers,
+  options,
+): readonly Readonly<{
+  id: string;
+  name: string;
+  methods: readonly Readonly<{
+    kind: LoginMethodKind;
+    label: string;
+  }>[];
+}>[];
+```
+
+The providers and methods one surface may offer, in display order.
+
+#### Parameters
+
+| Parameter   | Type                                                                                                                                                                          |
+| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `providers` | readonly `Readonly`\<\{ `id`: `string`; `name`: `string`; `methods`: readonly `Readonly`\<\{ `kind`: [`LoginMethodKind`](#loginmethodkind); `label`: `string`; \}\>[]; \}\>[] |
+| `options`   | `Readonly`\<\{ `policy`: [`LoginPolicy`](#loginpolicy); `host`: [`LoginHost`](#loginhost); `scope`: [`LoginScope`](#loginscope); \}\>                                         |
+
+#### Returns
+
+readonly `Readonly`\<\{ `id`: `string`; `name`: `string`; `methods`: readonly
+`Readonly`\<\{ `kind`: [`LoginMethodKind`](#loginmethodkind); `label`: `string`;
+\}\>[]; \}\>[]
+
+---
+
+### accountCommandDefinitions()
+
+```ts
+function accountCommandDefinitions(owner, options): readonly Readonly<{
+  id: string;
+  title: string;
+  category: string;
+  description?: string;
+  projections?: {
+     bindings?: {
+        order?: number;
+        values: readonly string[];
+     };
+     agent?: {
+        keybind?: string;
+        order?: number;
+     };
+     help?: {
+        order?: number;
+     };
+     menu?: {
+        order?: number;
+     };
+     palette?: {
+        order?: number;
+     };
+     slash?: {
+        aliases: readonly string[];
+        order?: number;
+        arguments?: {
+           hint: string;
+           words?: readonly ...[];
+           text?: {
+              field: ...;
+              arguments: ...;
+              requestIdField?: ...;
+           };
+        };
+     };
+  };
+  action?: {
+     inputSchema?: {
+      [key: string]:
+        | string
+        | number
+        | boolean
+        | readonly string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...[]
+        | {
+      [key: string]: string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...;
+      }
+        | null;
+     };
+     outputSchema?: {
+      [key: string]:
+        | string
+        | number
+        | boolean
+        | readonly string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...[]
+        | {
+      [key: string]: string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...;
+      }
+        | null;
+     };
+     presentation?:   | {
+        type: "action";
+      }
+        | {
+        type: "custom";
+        data: {
+         [key: string]:
+           | string
+           | number
+           | boolean
+           | readonly string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...[]
+           | {
+         [key: string]: string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...;
+         }
+           | null;
+        };
+      }
+        | {
+        type: "choice";
+        options: readonly object[];
+      }
+        | {
+        type: "form";
+        submitLabel?: string;
+      }
+        | {
+        type: "confirmation";
+        message: string;
+        confirmLabel?: string;
+        cancelLabel?: string;
+      };
+  };
+  availability?: () => WhistleAvailability;
+  handler: (input) => unknown;
+}>[];
+```
+
+Provider-agnostic account commands. Every question and status update is a
+Whistle interaction, so any client that renders interactions renders login.
+
+#### Parameters
+
+| Parameter | Type                                              |
+| --------- | ------------------------------------------------- |
+| `owner`   | [`AccountOwner`](#accountowner)                   |
+| `options` | [`AccountCommandOptions`](#accountcommandoptions) |
+
+#### Returns
+
+readonly `Readonly`\<\{ `id`: `string`; `title`: `string`; `category`: `string`;
+`description?`: `string`; `projections?`: \{ `bindings?`: \{ `order?`: `number`;
+`values`: readonly `string`[]; \}; `agent?`: \{ `keybind?`: `string`; `order?`:
+`number`; \}; `help?`: \{ `order?`: `number`; \}; `menu?`: \{ `order?`:
+`number`; \}; `palette?`: \{ `order?`: `number`; \}; `slash?`: \{ `aliases`:
+readonly `string`[]; `order?`: `number`; `arguments?`: \{ `hint`: `string`;
+`words?`: readonly ...[]; `text?`: \{ `field`: ...; `arguments`: ...;
+`requestIdField?`: ...; \}; \}; \}; \}; `action?`: \{ `inputSchema?`: \{
+\[`key`: `string`\]: \| `string` \| `number` \| `boolean` \| readonly string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| number \| boolean \| readonly (string \| number \| boolean \| readonly
+(string \| number \| boolean \| readonly (string \| number \| boolean \|
+readonly (string \| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{
+...; \} \| null)\[\] \| \{ ...; \} \| ...[] \| \{ \[`key`: `string`\]: string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| number \| boolean \| readonly (string \| number \| boolean \| readonly
+(string \| number \| boolean \| readonly (string \| number \| boolean \|
+readonly (string \| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{
+...; \} \| null)\[\] \| \{ ...; \} \| ...; \} \| `null`; \}; `outputSchema?`: \{
+\[`key`: `string`\]: \| `string` \| `number` \| `boolean` \| readonly string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| number \| boolean \| readonly (string \| number \| boolean \| readonly
+(string \| number \| boolean \| readonly (string \| number \| boolean \|
+readonly (string \| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{
+...; \} \| null)\[\] \| \{ ...; \} \| ...[] \| \{ \[`key`: `string`\]: string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| number \| boolean \| readonly (string \| number \| boolean \| readonly
+(string \| number \| boolean \| readonly (string \| number \| boolean \|
+readonly (string \| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{
+...; \} \| null)\[\] \| \{ ...; \} \| ...; \} \| `null`; \}; `presentation?`: \|
+\{ `type`: `"action"`; \} \| \{ `type`: `"custom"`; `data`: \{ \[`key`:
+`string`\]: \| `string` \| `number` \| `boolean` \| readonly string \| number \|
+boolean \| readonly (string \| number \| boolean \| readonly (string \| number
+\| boolean \| readonly (string \| number \| boolean \| readonly (string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{ ...; \} \|
+null)\[\] \| \{ ...; \} \| ...[] \| \{ \[`key`: `string`\]: string \| number \|
+boolean \| readonly (string \| number \| boolean \| readonly (string \| number
+\| boolean \| readonly (string \| number \| boolean \| readonly (string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{ ...; \} \|
+null)\[\] \| \{ ...; \} \| ...; \} \| `null`; \}; \} \| \{ `type`: `"choice"`;
+`options`: readonly `object`[]; \} \| \{ `type`: `"form"`; `submitLabel?`:
+`string`; \} \| \{ `type`: `"confirmation"`; `message`: `string`;
+`confirmLabel?`: `string`; `cancelLabel?`: `string`; \}; \}; `availability?`: ()
+=> `WhistleAvailability`; `handler`: (`input`) => `unknown`; \}\>[]
+
+---
+
+### contributeAccountCommands()
+
+```ts
+function contributeAccountCommands(
+  runtime,
+  owner,
+  options,
+): WhistleContributionLease;
+```
+
+Contribute the account commands as one lease.
+
+#### Parameters
+
+| Parameter | Type                                              |
+| --------- | ------------------------------------------------- |
+| `runtime` | `Pick`\<`WhistleRuntime`, `"contribute"`\>        |
+| `owner`   | [`AccountOwner`](#accountowner)                   |
+| `options` | [`AccountCommandOptions`](#accountcommandoptions) |
+
+#### Returns
+
+`WhistleContributionLease`
+
+---
+
+### useClientActions()
+
+```ts
+function useClientActions(commands): object;
+```
+
+Ordinary advertised actions over the current admitted rows and observation.
+
+#### Parameters
+
+| Parameter  | Type                                                |
+| ---------- | --------------------------------------------------- |
+| `commands` | [`ParakeetCommandRuntime`](#parakeetcommandruntime) |
+
+#### Returns
+
+| Name        | Type                                                                                                                                                                   | Description                                                       |
+| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
+| `state`     | `ReadonlyMap`\<\{ `id`: `string`; `label`: `string`; `input?`: \{ \[`key`: `string`\]: `Json`; \}; \}, `Readonly`\<\{ `pending`: `boolean`; `error?`: `string`; \}\>\> | Current Session-owned state of admitted action intents.           |
+| `enabled`   | `boolean`                                                                                                                                                              | Observation is live and this Session's action owner is attached.  |
+| `execute()` | (`entryId`, `action`, `waiting`) => `Promise`\<`void`\>                                                                                                                | Execute an admitted intent through its owning advertised command. |
+
+---
+
+### advertisedCommands()
+
+```ts
+function advertisedCommands(runtime, session, onInspect?): AdvertisedCommands;
+```
+
+Turn each running extension's advertised `whistle.catalog/v1` catalog into
+Whistle commands that call that extension's own door. The client names no
+command: a new extension's catalog appears as new commands.
+
+#### Parameters
+
+| Parameter    | Type                                                                   |
+| ------------ | ---------------------------------------------------------------------- |
+| `runtime`    | `Pick`\<`WhistleRuntime`, `"contribute"`\>                             |
+| `session`    | `Pick`\<[`ParakeetSession`](index.md#parakeetsession), `"extension"`\> |
+| `onInspect?` | (`entryId`, `commandId`) => `void`                                     |
+
+#### Returns
+
+[`AdvertisedCommands`](#advertisedcommands)
+
+---
+
+### parakeetBuiltinCommands()
+
+```ts
+function parakeetBuiltinCommands(runtime, options): readonly Readonly<{
+  id: string;
+  title: string;
+  category: string;
+  description?: string;
+  projections?: {
+     bindings?: {
+        order?: number;
+        values: readonly string[];
+     };
+     agent?: {
+        keybind?: string;
+        order?: number;
+     };
+     help?: {
+        order?: number;
+     };
+     menu?: {
+        order?: number;
+     };
+     palette?: {
+        order?: number;
+     };
+     slash?: {
+        aliases: readonly string[];
+        order?: number;
+        arguments?: {
+           hint: string;
+           words?: readonly ...[];
+           text?: {
+              field: ...;
+              arguments: ...;
+              requestIdField?: ...;
+           };
+        };
+     };
+  };
+  action?: {
+     inputSchema?: {
+      [key: string]:
+        | string
+        | number
+        | boolean
+        | readonly string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...[]
+        | {
+      [key: string]: string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...;
+      }
+        | null;
+     };
+     outputSchema?: {
+      [key: string]:
+        | string
+        | number
+        | boolean
+        | readonly string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...[]
+        | {
+      [key: string]: string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...;
+      }
+        | null;
+     };
+     presentation?:   | {
+        type: "action";
+      }
+        | {
+        type: "custom";
+        data: {
+         [key: string]:
+           | string
+           | number
+           | boolean
+           | readonly string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...[]
+           | {
+         [key: string]: string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...;
+         }
+           | null;
+        };
+      }
+        | {
+        type: "choice";
+        options: readonly object[];
+      }
+        | {
+        type: "form";
+        submitLabel?: string;
+      }
+        | {
+        type: "confirmation";
+        message: string;
+        confirmLabel?: string;
+        cancelLabel?: string;
+      };
+  };
+  availability?: () => WhistleAvailability;
+  handler: (input) => unknown;
+}>[];
+```
+
+`/help` lists the live commands (built-in and advertised) and runs the one
+chosen; `/keys` does the same for key bindings; `/clear` empties the composer.
+
+#### Parameters
+
+| Parameter | Type                                                    |
+| --------- | ------------------------------------------------------- |
+| `runtime` | `Pick`\<`WhistleRuntime`, `"snapshot"` \| `"execute"`\> |
+| `options` | [`ParakeetBuiltinOptions`](#parakeetbuiltinoptions)     |
+
+#### Returns
+
+readonly `Readonly`\<\{ `id`: `string`; `title`: `string`; `category`: `string`;
+`description?`: `string`; `projections?`: \{ `bindings?`: \{ `order?`: `number`;
+`values`: readonly `string`[]; \}; `agent?`: \{ `keybind?`: `string`; `order?`:
+`number`; \}; `help?`: \{ `order?`: `number`; \}; `menu?`: \{ `order?`:
+`number`; \}; `palette?`: \{ `order?`: `number`; \}; `slash?`: \{ `aliases`:
+readonly `string`[]; `order?`: `number`; `arguments?`: \{ `hint`: `string`;
+`words?`: readonly ...[]; `text?`: \{ `field`: ...; `arguments`: ...;
+`requestIdField?`: ...; \}; \}; \}; \}; `action?`: \{ `inputSchema?`: \{
+\[`key`: `string`\]: \| `string` \| `number` \| `boolean` \| readonly string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| number \| boolean \| readonly (string \| number \| boolean \| readonly
+(string \| number \| boolean \| readonly (string \| number \| boolean \|
+readonly (string \| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{
+...; \} \| null)\[\] \| \{ ...; \} \| ...[] \| \{ \[`key`: `string`\]: string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| number \| boolean \| readonly (string \| number \| boolean \| readonly
+(string \| number \| boolean \| readonly (string \| number \| boolean \|
+readonly (string \| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{
+...; \} \| null)\[\] \| \{ ...; \} \| ...; \} \| `null`; \}; `outputSchema?`: \{
+\[`key`: `string`\]: \| `string` \| `number` \| `boolean` \| readonly string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| number \| boolean \| readonly (string \| number \| boolean \| readonly
+(string \| number \| boolean \| readonly (string \| number \| boolean \|
+readonly (string \| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{
+...; \} \| null)\[\] \| \{ ...; \} \| ...[] \| \{ \[`key`: `string`\]: string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| number \| boolean \| readonly (string \| number \| boolean \| readonly
+(string \| number \| boolean \| readonly (string \| number \| boolean \|
+readonly (string \| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{
+...; \} \| null)\[\] \| \{ ...; \} \| ...; \} \| `null`; \}; `presentation?`: \|
+\{ `type`: `"action"`; \} \| \{ `type`: `"custom"`; `data`: \{ \[`key`:
+`string`\]: \| `string` \| `number` \| `boolean` \| readonly string \| number \|
+boolean \| readonly (string \| number \| boolean \| readonly (string \| number
+\| boolean \| readonly (string \| number \| boolean \| readonly (string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{ ...; \} \|
+null)\[\] \| \{ ...; \} \| ...[] \| \{ \[`key`: `string`\]: string \| number \|
+boolean \| readonly (string \| number \| boolean \| readonly (string \| number
+\| boolean \| readonly (string \| number \| boolean \| readonly (string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{ ...; \} \|
+null)\[\] \| \{ ...; \} \| ...; \} \| `null`; \}; \} \| \{ `type`: `"choice"`;
+`options`: readonly `object`[]; \} \| \{ `type`: `"form"`; `submitLabel?`:
+`string`; \} \| \{ `type`: `"confirmation"`; `message`: `string`;
+`confirmLabel?`: `string`; `cancelLabel?`: `string`; \}; \}; `availability?`: ()
+=> `WhistleAvailability`; `handler`: (`input`) => `unknown`; \}\>[]
+
+---
+
+### composerHints()
+
+```ts
+function composerHints(context): readonly Readonly<{
+  keys: string;
+  label: string;
+  priority: number;
+}>[];
+```
+
+Hints for the current composer state, in display order.
+
+#### Parameters
+
+| Parameter | Type                                          |
+| --------- | --------------------------------------------- |
+| `context` | [`ComposerHintContext`](#composerhintcontext) |
+
+#### Returns
+
+readonly `Readonly`\<\{ `keys`: `string`; `label`: `string`; `priority`:
+`number`; \}\>[]
+
+---
+
+### formatHints()
+
+```ts
+function formatHints(hints): string;
+```
+
+One line of hints.
+
+#### Parameters
+
+| Parameter | Type                                                                                      |
+| --------- | ----------------------------------------------------------------------------------------- |
+| `hints`   | readonly `Readonly`\<\{ `keys`: `string`; `label`: `string`; `priority`: `number`; \}\>[] |
+
+#### Returns
+
+`string`
+
+---
+
+### fitHints()
+
+```ts
+function fitHints(
+  hints,
+  width,
+): readonly Readonly<{
+  keys: string;
+  label: string;
+  priority: number;
+}>[];
+```
+
+Keep the most important hints that fit `width` characters, in order.
+
+#### Parameters
+
+| Parameter | Type                                                                                      |
+| --------- | ----------------------------------------------------------------------------------------- |
+| `hints`   | readonly `Readonly`\<\{ `keys`: `string`; `label`: `string`; `priority`: `number`; \}\>[] |
+| `width`   | `number`                                                                                  |
+
+#### Returns
+
+readonly `Readonly`\<\{ `keys`: `string`; `label`: `string`; `priority`:
+`number`; \}\>[]
+
+---
+
+### createParakeetInteractions()
+
+```ts
+function createParakeetInteractions(): ParakeetInteractions;
+```
+
+Own how commands talk to the human. An interaction opens only when it asks a
+question, hands off to a URL or shows progress; a command that just reports a
+result leaves a one-line notice instead of a dialog.
+
+#### Returns
+
+[`ParakeetInteractions`](#parakeetinteractions)
+
+---
+
+### isCancelledOutcome()
+
+```ts
+function isCancelledOutcome(outcome): boolean;
+```
+
+Whether a handled command declined its input (for example a refused
+replacement).
+
+#### Parameters
+
+| Parameter | Type                      |
+| --------- | ------------------------- |
+| `outcome` | `WhistleExecutionOutcome` |
+
+#### Returns
+
+`boolean`
+
+---
+
+### runSlashDraft()
+
+```ts
+function runSlashDraft(
+  draft,
+  commands,
+  send,
+  origin,
+): Promise<WhistleExecutionOutcome | undefined>;
+```
+
+Run one composer draft: a prompt goes to `send`, a `/command` runs through
+Whistle. A grammar that asks for a request id keeps the same id across retries
+of the same draft until the command is handled.
+
+#### Parameters
+
+| Parameter  | Type                            |
+| ---------- | ------------------------------- |
+| `draft`    | `string`                        |
+| `commands` | [`SlashRuntime`](#slashruntime) |
+| `send`     | () => `void`                    |
+| `origin`   | `WhistleExecutionOrigin`        |
+
+#### Returns
+
+`Promise`\<`WhistleExecutionOutcome` \| `undefined`\>
+
+---
+
+### useSlashCommands()
+
+```ts
+function useSlashCommands(options): SlashCommandController;
+```
+
+The one slash-command controller behind every Parakeet composer. It owns the
+registry, completion, hints, execution and conversations; renderers only draw
+its state and forward keys.
+
+#### Parameters
+
+| Parameter | Type                                          |
+| --------- | --------------------------------------------- |
+| `options` | [`SlashCommandOptions`](#slashcommandoptions) |
+
+#### Returns
+
+[`SlashCommandController`](#slashcommandcontroller)
+
+---
+
+### useParakeetSession()
+
+```ts
+function useParakeetSession(): ParakeetSession;
+```
+
+The Session this conversation observes.
+
+#### Returns
+
+[`ParakeetSession`](index.md#parakeetsession)
+
+---
+
+### useExtensionSlots()
+
+```ts
+function useExtensionSlots(): SessionExtensionSlots;
+```
+
+Read the Session's extension slots, including advertised command catalogs.
+
+#### Returns
+
+`SessionExtensionSlots`
+
+---
+
+### useClientContributions()
+
+```ts
+function useClientContributions(): readonly Readonly<{
+  entryId: string;
+  value: {
+    chips: readonly object[];
+    panel: readonly object[];
+    timeline: {
+      cells: readonly object[];
+      omitted: number;
+    };
+    waiting: {
+      summary: string;
+      cancel: {
+        id: string;
+        label: string;
+        input?: {
+          [key: string]: Json;
+        };
+      };
+    } | null;
+  };
+}>[];
+```
+
+Presentation admitted once from the selected Session's already observed slots.
+
+#### Returns
+
+readonly `Readonly`\<\{ `entryId`: `string`; `value`: \{ `chips`: readonly
+`object`[]; `panel`: readonly `object`[]; `timeline`: \{ `cells`: readonly
+`object`[]; `omitted`: `number`; \}; `waiting`: \| \{ `summary`: `string`;
+`cancel`: \{ `id`: `string`; `label`: `string`; `input?`: \{ \[`key`:
+`string`\]: `Json`; \}; \}; \} \| `null`; \}; \}\>[]
+
+---
+
+### useParakeetInteractions()
+
+```ts
+function useParakeetInteractions(): ParakeetInteractions;
+```
+
+The selected Session's ordinary command interaction owner.
+
+#### Returns
+
+[`ParakeetInteractions`](#parakeetinteractions)
+
+---
+
+### assistantMessageVisible()
+
+```ts
+function assistantMessageVisible(item): boolean;
+```
+
+One rule for whether an assistant row has content either renderer shows.
+
+#### Parameters
+
+| Parameter | Type                                                                    |
+| --------- | ----------------------------------------------------------------------- |
+| `item`    | [`ParakeetAssistantMessageItem`](index.md#parakeetassistantmessageitem) |
+
+#### Returns
+
+`boolean`
+
+---
+
+### placeClientTimeline()
+
+```ts
+function placeClientTimeline(entries, anchors): object;
+```
+
+Page visibility follows real durable command anchors, never event time.
+
+#### Parameters
+
+| Parameter | Type                                                                                                                                                                                                                                                                                                                                                        |
+| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `entries` | readonly `Readonly`\<\{ `entryId`: `string`; `value`: \{ `chips`: readonly `object`[]; `panel`: readonly `object`[]; `timeline`: \{ `cells`: readonly `object`[]; `omitted`: `number`; \}; `waiting`: \| \{ `summary`: `string`; `cancel`: \{ `id`: `string`; `label`: `string`; `input?`: \{ \[`key`: `string`\]: `Json`; \}; \}; \} \| `null`; \}; \}\>[] |
+| `anchors` | `ReadonlyMap`\<`string`, `string`\>                                                                                                                                                                                                                                                                                                                         |
+
+#### Returns
+
+| Name         | Type                                                                                                                                                                                             | Description                                                             |
+| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------- |
+| `after`      | `Map`\<`string`, `Readonly`\<\{ `entryId`: `string`; `cell`: \{ `id`: `string`; `sequence`: `number`; `at`: `number`; `commandId`: `string` \| `null`; `rows`: readonly `object`[]; \}; \}\>[]\> | Loaded durable row IDs mapped to their following committed events.      |
+| `unanchored` | `Readonly`\<\{ `entryId`: `string`; `cell`: \{ `id`: `string`; `sequence`: `number`; `at`: `number`; `commandId`: `string` \| `null`; `rows`: readonly `object`[]; \}; \}\>[]                    | Null-anchor events for the separate Extension changes section.          |
+| `omitted`    | `object`[]                                                                                                                                                                                       | Factual producer retention counts, independent of loaded message pages. |
+
+---
+
+### mergeTerminals()
+
+```ts
+function mergeTerminals(
+  current,
+  incoming,
+): readonly Readonly<{
+  commandId: string;
+  outcome: "completed" | "failed" | "cancelled" | "interrupted";
+  sequence: number;
+  diagnostic: string | null;
+  meta?: Json;
+}>[];
+```
+
+Preserve the first terminal for each command, in observed order.
+
+#### Parameters
+
+| Parameter  | Type                                                                                                                                                                                                       |
+| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `current`  | readonly `Readonly`\<\{ `commandId`: `string`; `outcome`: `"completed"` \| `"failed"` \| `"cancelled"` \| `"interrupted"`; `sequence`: `number`; `diagnostic`: `string` \| `null`; `meta?`: `Json`; \}\>[] |
+| `incoming` | readonly `Readonly`\<\{ `commandId`: `string`; `outcome`: `"completed"` \| `"failed"` \| `"cancelled"` \| `"interrupted"`; `sequence`: `number`; `diagnostic`: `string` \| `null`; `meta?`: `Json`; \}\>[] |
+
+#### Returns
+
+readonly `Readonly`\<\{ `commandId`: `string`; `outcome`: `"completed"` \|
+`"failed"` \| `"cancelled"` \| `"interrupted"`; `sequence`: `number`;
+`diagnostic`: `string` \| `null`; `meta?`: `Json`; \}\>[]
+
+---
+
+### sessionQueryOptions()
+
+```ts
+function sessionQueryOptions(session): OmitKeyof<UseQueryOptions<Readonly<{
+  observation: "live" | "connecting";
+  snapshot:   | Readonly<{
+     sessionId: string;
+     cursor: string | null;
+     hasMore: boolean;
+     oldestCursor?: string | null;
+     messages: readonly Readonly<{
+        meta?: ...;
+        origin?: ...;
+        id: ...;
+        sequence: ...;
+        commandId: ...;
+        value: ...;
+     }>[];
+     terminals: readonly Readonly<{
+        commandId: ...;
+        outcome: ...;
+        sequence: ...;
+        diagnostic: ...;
+        meta?: ...;
+     }>[];
+     compactions?: readonly Readonly<...>[];
+     compactionNotices?: readonly Readonly<...>[];
+     sandboxFailures?: readonly object[];
+     pending: SessionPendingPrompts;
+     activity: SessionActivity;
+     progress:   | Readonly<{
+        messageId: ...;
+        revision: ...;
+        text: ...;
+        thinking: ...;
+        textTruncated: ...;
+        thinkingTruncated: ...;
+      }>
+        | null;
+     extensions: SessionExtensionSlots;
+     attention: readonly object[];
+     context?: Readonly<{
+        tokens: ...;
+        window: ...;
+     }>;
+   }>
+     | undefined;
+  latestPrompt: readonly [string, string] | undefined;
+}>, Error, Readonly<{
+  observation: "live" | "connecting";
+  snapshot:   | Readonly<{
+     sessionId: string;
+     cursor: string | null;
+     hasMore: boolean;
+     oldestCursor?: string | null;
+     messages: readonly Readonly<{
+        meta?: ...;
+        origin?: ...;
+        id: ...;
+        sequence: ...;
+        commandId: ...;
+        value: ...;
+     }>[];
+     terminals: readonly Readonly<{
+        commandId: ...;
+        outcome: ...;
+        sequence: ...;
+        diagnostic: ...;
+        meta?: ...;
+     }>[];
+     compactions?: readonly Readonly<...>[];
+     compactionNotices?: readonly Readonly<...>[];
+     sandboxFailures?: readonly object[];
+     pending: SessionPendingPrompts;
+     activity: SessionActivity;
+     progress:   | Readonly<{
+        messageId: ...;
+        revision: ...;
+        text: ...;
+        thinking: ...;
+        textTruncated: ...;
+        thinkingTruncated: ...;
+      }>
+        | null;
+     extensions: SessionExtensionSlots;
+     attention: readonly object[];
+     context?: Readonly<{
+        tokens: ...;
+        window: ...;
+     }>;
+   }>
+     | undefined;
+  latestPrompt: readonly [string, string] | undefined;
+}>, readonly ["shiitake-session", string]>, "queryFn"> & object & QueryKeyWithDataTag<readonly ["shiitake-session", string], Readonly<{
+  observation: "live" | "connecting";
+  snapshot:   | Readonly<{
+     sessionId: string;
+     cursor: string | null;
+     hasMore: boolean;
+     oldestCursor?: string | null;
+     messages: readonly Readonly<{
+        meta?: ... | ...;
+        origin?: ... | ...;
+        id: string;
+        sequence: number;
+        commandId: ... | ...;
+        value: Message;
+     }>[];
+     terminals: readonly Readonly<{
+        commandId: string;
+        outcome: ... | ... | ... | ...;
+        sequence: number;
+        diagnostic: ... | ...;
+        meta?: ... | ...;
+     }>[];
+     compactions?: readonly Readonly<{
+        id: ...;
+        sequence: ...;
+        at: ...;
+        tokensBefore: ...;
+        tokensAfter: ...;
+        trigger: ...;
+     }>[];
+     compactionNotices?: readonly Readonly<{
+        id: ...;
+        sequence: ...;
+        at: ...;
+        trigger: ...;
+        result: ...;
+        diagnostic: ...;
+     }>[];
+     sandboxFailures?: readonly object[];
+     pending: SessionPendingPrompts;
+     activity: SessionActivity;
+     progress:   | Readonly<{
+        messageId: string;
+        revision: number;
+        text: string;
+        thinking: string;
+        textTruncated: boolean;
+        thinkingTruncated: boolean;
+      }>
+        | null;
+     extensions: SessionExtensionSlots;
+     attention: readonly object[];
+     context?: Readonly<{
+        tokens: number;
+        window: ... | ...;
+     }>;
+   }>
+     | undefined;
+  latestPrompt: readonly [string, string] | undefined;
+}>, Error>;
+```
+
+One shared TanStack observation keyed by Shiitake's logical Session address.
+
+#### Parameters
+
+| Parameter | Type                                          |
+| --------- | --------------------------------------------- |
+| `session` | [`ParakeetSession`](index.md#parakeetsession) |
+
+#### Returns
+
+`OmitKeyof`\<`UseQueryOptions`\<`Readonly`\<\{ `observation`: `"live"` \|
+`"connecting"`; `snapshot`: \| `Readonly`\<\{ `sessionId`: `string`; `cursor`:
+`string` \| `null`; `hasMore`: `boolean`; `oldestCursor?`: `string` \| `null`;
+`messages`: readonly `Readonly`\<\{ `meta?`: ...; `origin?`: ...; `id`: ...;
+`sequence`: ...; `commandId`: ...; `value`: ...; \}\>[]; `terminals`: readonly
+`Readonly`\<\{ `commandId`: ...; `outcome`: ...; `sequence`: ...; `diagnostic`:
+...; `meta?`: ...; \}\>[]; `compactions?`: readonly `Readonly`\<...\>[];
+`compactionNotices?`: readonly `Readonly`\<...\>[]; `sandboxFailures?`: readonly
+`object`[]; `pending`: `SessionPendingPrompts`; `activity`: `SessionActivity`;
+`progress`: \| `Readonly`\<\{ `messageId`: ...; `revision`: ...; `text`: ...;
+`thinking`: ...; `textTruncated`: ...; `thinkingTruncated`: ...; \}\> \| `null`;
+`extensions`: `SessionExtensionSlots`; `attention`: readonly `object`[];
+`context?`: `Readonly`\<\{ `tokens`: ...; `window`: ...; \}\>; \}\> \|
+`undefined`; `latestPrompt`: readonly \[`string`, `string`\] \| `undefined`;
+\}\>, `Error`, `Readonly`\<\{ `observation`: `"live"` \| `"connecting"`;
+`snapshot`: \| `Readonly`\<\{ `sessionId`: `string`; `cursor`: `string` \|
+`null`; `hasMore`: `boolean`; `oldestCursor?`: `string` \| `null`; `messages`:
+readonly `Readonly`\<\{ `meta?`: ...; `origin?`: ...; `id`: ...; `sequence`:
+...; `commandId`: ...; `value`: ...; \}\>[]; `terminals`: readonly
+`Readonly`\<\{ `commandId`: ...; `outcome`: ...; `sequence`: ...; `diagnostic`:
+...; `meta?`: ...; \}\>[]; `compactions?`: readonly `Readonly`\<...\>[];
+`compactionNotices?`: readonly `Readonly`\<...\>[]; `sandboxFailures?`: readonly
+`object`[]; `pending`: `SessionPendingPrompts`; `activity`: `SessionActivity`;
+`progress`: \| `Readonly`\<\{ `messageId`: ...; `revision`: ...; `text`: ...;
+`thinking`: ...; `textTruncated`: ...; `thinkingTruncated`: ...; \}\> \| `null`;
+`extensions`: `SessionExtensionSlots`; `attention`: readonly `object`[];
+`context?`: `Readonly`\<\{ `tokens`: ...; `window`: ...; \}\>; \}\> \|
+`undefined`; `latestPrompt`: readonly \[`string`, `string`\] \| `undefined`;
+\}\>, readonly \[`"shiitake-session"`, `string`\]\>, `"queryFn"`\> & `object` &
+`QueryKeyWithDataTag`\<readonly \[`"shiitake-session"`, `string`\],
+`Readonly`\<\{ `observation`: `"live"` \| `"connecting"`; `snapshot`: \|
+`Readonly`\<\{ `sessionId`: `string`; `cursor`: `string` \| `null`; `hasMore`:
+`boolean`; `oldestCursor?`: `string` \| `null`; `messages`: readonly
+`Readonly`\<\{ `meta?`: ... \| ...; `origin?`: ... \| ...; `id`: `string`;
+`sequence`: `number`; `commandId`: ... \| ...; `value`: `Message`; \}\>[];
+`terminals`: readonly `Readonly`\<\{ `commandId`: `string`; `outcome`: ... \|
+... \| ... \| ...; `sequence`: `number`; `diagnostic`: ... \| ...; `meta?`: ...
+\| ...; \}\>[]; `compactions?`: readonly `Readonly`\<\{ `id`: ...; `sequence`:
+...; `at`: ...; `tokensBefore`: ...; `tokensAfter`: ...; `trigger`: ...; \}\>[];
+`compactionNotices?`: readonly `Readonly`\<\{ `id`: ...; `sequence`: ...; `at`:
+...; `trigger`: ...; `result`: ...; `diagnostic`: ...; \}\>[];
+`sandboxFailures?`: readonly `object`[]; `pending`: `SessionPendingPrompts`;
+`activity`: `SessionActivity`; `progress`: \| `Readonly`\<\{ `messageId`:
+`string`; `revision`: `number`; `text`: `string`; `thinking`: `string`;
+`textTruncated`: `boolean`; `thinkingTruncated`: `boolean`; \}\> \| `null`;
+`extensions`: `SessionExtensionSlots`; `attention`: readonly `object`[];
+`context?`: `Readonly`\<\{ `tokens`: `number`; `window`: ... \| ...; \}\>; \}\>
+\| `undefined`; `latestPrompt`: readonly \[`string`, `string`\] \| `undefined`;
+\}\>, `Error`\>
+
+---
+
+### seedSessionQuery()
+
+```ts
+function seedSessionQuery(queryClient, session, snapshot): void;
+```
+
+Seed the shared observation with a bounded read before its watch mounts.
+
+#### Parameters
+
+| Parameter     | Type                                          |
+| ------------- | --------------------------------------------- |
+| `queryClient` | `QueryClient`                                 |
+| `session`     | [`ParakeetSession`](index.md#parakeetsession) |
+| `snapshot`    | `SessionSnapshot`                             |
+
+#### Returns
+
+`void`
+
+---
+
+### subscribeSessionActivity()
+
+```ts
+function subscribeSessionActivity(queryClient, session, listener): () => void;
+```
+
+Borrow activity from the existing cache without starting another watch.
+
+#### Parameters
+
+| Parameter     | Type                                          |
+| ------------- | --------------------------------------------- |
+| `queryClient` | `QueryClient`                                 |
+| `session`     | [`ParakeetSession`](index.md#parakeetsession) |
+| `listener`    | (`activity`) => `void`                        |
+
+#### Returns
+
+() => `void`
+
+---
+
+### sessionViewState()
+
+```ts
+function sessionViewState(facts): ParakeetOwnerViewState;
+```
+
+Decide a Session's view state from its activity, terminals and progress.
+
+#### Parameters
+
+| Parameter | Type                                    |
+| --------- | --------------------------------------- |
+| `facts`   | [`SessionViewFacts`](#sessionviewfacts) |
+
+#### Returns
+
+[`ParakeetOwnerViewState`](#parakeetownerviewstate)
+
+---
+
+### queuedSessionLabel()
+
+```ts
+function queuedSessionLabel(state): string;
+```
+
+Explain a queued Session using its owner's executor fact.
+
+#### Parameters
+
+| Parameter | Type                                                                                        |
+| --------- | ------------------------------------------------------------------------------------------- |
+| `state`   | `Extract`\<[`ParakeetOwnerViewState`](#parakeetownerviewstate), \{ `kind`: `"queued"`; \}\> |
+
+#### Returns
+
+`string`
+
+---
+
+### sessionActivityStatus()
+
+```ts
+function sessionActivityStatus(view): SessionActivityStatus;
+```
+
+Coarse activity for a view state: what the composer gates on.
+
+#### Parameters
+
+| Parameter | Type                                                |
+| --------- | --------------------------------------------------- |
+| `view`    | [`ParakeetOwnerViewState`](#parakeetownerviewstate) |
+
+#### Returns
+
+[`SessionActivityStatus`](#sessionactivitystatus)
+
+---
+
+### toolStatusTone()
+
+```ts
+function toolStatusTone(status): "error" | "success" | "info" | "neutral";
+```
+
+Shared tool status meaning, used by the browser and native presentations.
+
+#### Parameters
+
+| Parameter | Type                                                     |
+| --------- | -------------------------------------------------------- |
+| `status`  | `"error"` \| `"unknown"` \| `"completed"` \| `"running"` |
+
+#### Returns
+
+`"error"` \| `"success"` \| `"info"` \| `"neutral"`
+
+---
+
+### toolCallView()
+
+```ts
+function toolCallView(item): ParakeetToolCallView;
+```
+
+Build the renderer-neutral view of one call.
+
+#### Parameters
+
+| Parameter | Type                                            |
+| --------- | ----------------------------------------------- |
+| `item`    | [`ParakeetToolItem`](index.md#parakeettoolitem) |
+
+#### Returns
+
+[`ParakeetToolCallView`](index.md#parakeettoolcallview)
+
+---
+
+### sessionModelCommandDefinitions()
+
+```ts
+function sessionModelCommandDefinitions(session, options): readonly Readonly<{
+  id: string;
+  title: string;
+  category: string;
+  description?: string;
+  projections?: {
+     bindings?: {
+        order?: number;
+        values: readonly string[];
+     };
+     agent?: {
+        keybind?: string;
+        order?: number;
+     };
+     help?: {
+        order?: number;
+     };
+     menu?: {
+        order?: number;
+     };
+     palette?: {
+        order?: number;
+     };
+     slash?: {
+        aliases: readonly string[];
+        order?: number;
+        arguments?: {
+           hint: string;
+           words?: readonly ...[];
+           text?: {
+              field: ...;
+              arguments: ...;
+              requestIdField?: ...;
+           };
+        };
+     };
+  };
+  action?: {
+     inputSchema?: {
+      [key: string]:
+        | string
+        | number
+        | boolean
+        | readonly string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...[]
+        | {
+      [key: string]: string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...;
+      }
+        | null;
+     };
+     outputSchema?: {
+      [key: string]:
+        | string
+        | number
+        | boolean
+        | readonly string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...[]
+        | {
+      [key: string]: string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...;
+      }
+        | null;
+     };
+     presentation?:   | {
+        type: "action";
+      }
+        | {
+        type: "custom";
+        data: {
+         [key: string]:
+           | string
+           | number
+           | boolean
+           | readonly string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...[]
+           | {
+         [key: string]: string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...;
+         }
+           | null;
+        };
+      }
+        | {
+        type: "choice";
+        options: readonly object[];
+      }
+        | {
+        type: "form";
+        submitLabel?: string;
+      }
+        | {
+        type: "confirmation";
+        message: string;
+        confirmLabel?: string;
+        cancelLabel?: string;
+      };
+  };
+  availability?: () => WhistleAvailability;
+  handler: (input) => unknown;
+}>[];
+```
+
+Describe and invoke the ordinary model-preference owner from any client.
+
+#### Parameters
+
+| Parameter | Type                                                        |
+| --------- | ----------------------------------------------------------- |
+| `session` | `ModelPreferenceOwner`                                      |
+| `options` | [`SessionModelCommandOptions`](#sessionmodelcommandoptions) |
+
+#### Returns
+
+readonly `Readonly`\<\{ `id`: `string`; `title`: `string`; `category`: `string`;
+`description?`: `string`; `projections?`: \{ `bindings?`: \{ `order?`: `number`;
+`values`: readonly `string`[]; \}; `agent?`: \{ `keybind?`: `string`; `order?`:
+`number`; \}; `help?`: \{ `order?`: `number`; \}; `menu?`: \{ `order?`:
+`number`; \}; `palette?`: \{ `order?`: `number`; \}; `slash?`: \{ `aliases`:
+readonly `string`[]; `order?`: `number`; `arguments?`: \{ `hint`: `string`;
+`words?`: readonly ...[]; `text?`: \{ `field`: ...; `arguments`: ...;
+`requestIdField?`: ...; \}; \}; \}; \}; `action?`: \{ `inputSchema?`: \{
+\[`key`: `string`\]: \| `string` \| `number` \| `boolean` \| readonly string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| number \| boolean \| readonly (string \| number \| boolean \| readonly
+(string \| number \| boolean \| readonly (string \| number \| boolean \|
+readonly (string \| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{
+...; \} \| null)\[\] \| \{ ...; \} \| ...[] \| \{ \[`key`: `string`\]: string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| number \| boolean \| readonly (string \| number \| boolean \| readonly
+(string \| number \| boolean \| readonly (string \| number \| boolean \|
+readonly (string \| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{
+...; \} \| null)\[\] \| \{ ...; \} \| ...; \} \| `null`; \}; `outputSchema?`: \{
+\[`key`: `string`\]: \| `string` \| `number` \| `boolean` \| readonly string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| number \| boolean \| readonly (string \| number \| boolean \| readonly
+(string \| number \| boolean \| readonly (string \| number \| boolean \|
+readonly (string \| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{
+...; \} \| null)\[\] \| \{ ...; \} \| ...[] \| \{ \[`key`: `string`\]: string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| number \| boolean \| readonly (string \| number \| boolean \| readonly
+(string \| number \| boolean \| readonly (string \| number \| boolean \|
+readonly (string \| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{
+...; \} \| null)\[\] \| \{ ...; \} \| ...; \} \| `null`; \}; `presentation?`: \|
+\{ `type`: `"action"`; \} \| \{ `type`: `"custom"`; `data`: \{ \[`key`:
+`string`\]: \| `string` \| `number` \| `boolean` \| readonly string \| number \|
+boolean \| readonly (string \| number \| boolean \| readonly (string \| number
+\| boolean \| readonly (string \| number \| boolean \| readonly (string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{ ...; \} \|
+null)\[\] \| \{ ...; \} \| ...[] \| \{ \[`key`: `string`\]: string \| number \|
+boolean \| readonly (string \| number \| boolean \| readonly (string \| number
+\| boolean \| readonly (string \| number \| boolean \| readonly (string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{ ...; \} \|
+null)\[\] \| \{ ...; \} \| ...; \} \| `null`; \}; \} \| \{ `type`: `"choice"`;
+`options`: readonly `object`[]; \} \| \{ `type`: `"form"`; `submitLabel?`:
+`string`; \} \| \{ `type`: `"confirmation"`; `message`: `string`;
+`confirmLabel?`: `string`; `cancelLabel?`: `string`; \}; \}; `availability?`: ()
+=> `WhistleAvailability`; `handler`: (`input`) => `unknown`; \}\>[]
+
+---
+
+### contributeModelCommands()
+
+```ts
+function contributeModelCommands(
+  commands,
+  session,
+  options,
+): Readonly<{
+  update: (commands) => void;
+  dispose: () => void;
+}>;
+```
+
+Contribute one model action; owners may update its definitions through the
+lease.
+
+#### Parameters
+
+| Parameter  | Type                                                        |
+| ---------- | ----------------------------------------------------------- |
+| `commands` | `Pick`\<`WhistleRuntime`, `"contribute"`\>                  |
+| `session`  | `ModelPreferenceOwner`                                      |
+| `options`  | [`SessionModelCommandOptions`](#sessionmodelcommandoptions) |
+
+#### Returns
+
+`Readonly`\<\{ `update`: (`commands`) => `void`; `dispose`: () => `void`; \}\>
+
+---
+
+### providerChoices()
+
+```ts
+function providerChoices(
+  providers,
+  access,
+  popularProviderIds,
+  screen,
+): readonly object[];
+```
+
+Group the existing registry or model providers without owning another catalog.
+
+#### Parameters
+
+| Parameter            | Type                                                                                                                                                                          |
+| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `providers`          | readonly `Readonly`\<\{ `id`: `string`; `name`: `string`; `methods`: readonly `Readonly`\<\{ `kind`: [`LoginMethodKind`](#loginmethodkind); `label`: `string`; \}\>[]; \}\>[] |
+| `access`             | readonly `Readonly`\<\{ `providerId`: `string`; `providerName`: `string`; `type`: `"oauth"` \| `"api_key"`; \}\>[]                                                            |
+| `popularProviderIds` | readonly `string`[]                                                                                                                                                           |
+| `screen`             | `"login"` \| `"model"`                                                                                                                                                        |
+
+#### Returns
+
+readonly `object`[]
+
+---
+
+### reloadSources()
+
+```ts
+function reloadSources(sources, signal): Promise<string>;
+```
+
+Refresh what supports it and report every category honestly.
+
+#### Parameters
+
+| Parameter | Type                                       |
+| --------- | ------------------------------------------ |
+| `sources` | readonly [`ReloadSource`](#reloadsource)[] |
+| `signal`  | `AbortSignal`                              |
+
+#### Returns
+
+`Promise`\<`string`\>
+
+---
+
+### reloadCommandDefinitions()
+
+```ts
+function reloadCommandDefinitions(options): readonly Readonly<{
+  id: string;
+  title: string;
+  category: string;
+  description?: string;
+  projections?: {
+     bindings?: {
+        order?: number;
+        values: readonly string[];
+     };
+     agent?: {
+        keybind?: string;
+        order?: number;
+     };
+     help?: {
+        order?: number;
+     };
+     menu?: {
+        order?: number;
+     };
+     palette?: {
+        order?: number;
+     };
+     slash?: {
+        aliases: readonly string[];
+        order?: number;
+        arguments?: {
+           hint: string;
+           words?: readonly ...[];
+           text?: {
+              field: ...;
+              arguments: ...;
+              requestIdField?: ...;
+           };
+        };
+     };
+  };
+  action?: {
+     inputSchema?: {
+      [key: string]:
+        | string
+        | number
+        | boolean
+        | readonly string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...[]
+        | {
+      [key: string]: string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...;
+      }
+        | null;
+     };
+     outputSchema?: {
+      [key: string]:
+        | string
+        | number
+        | boolean
+        | readonly string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...[]
+        | {
+      [key: string]: string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...;
+      }
+        | null;
+     };
+     presentation?:   | {
+        type: "action";
+      }
+        | {
+        type: "custom";
+        data: {
+         [key: string]:
+           | string
+           | number
+           | boolean
+           | readonly string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...[]
+           | {
+         [key: string]: string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | number | boolean | readonly (string | ... 4 more ... | null)[] | { ...; } | null)[] | { ...; } | null)[] | { ...; } | ...;
+         }
+           | null;
+        };
+      }
+        | {
+        type: "choice";
+        options: readonly object[];
+      }
+        | {
+        type: "form";
+        submitLabel?: string;
+      }
+        | {
+        type: "confirmation";
+        message: string;
+        confirmLabel?: string;
+        cancelLabel?: string;
+      };
+  };
+  availability?: () => WhistleAvailability;
+  handler: (input) => unknown;
+}>[];
+```
+
+The shared `/reload` definition over host-described reload sources.
+
+#### Parameters
+
+| Parameter | Type                                                                   |
+| --------- | ---------------------------------------------------------------------- |
+| `options` | `Pick`\<[`ReloadCommandOptions`](#reloadcommandoptions), `"sources"`\> |
+
+#### Returns
+
+readonly `Readonly`\<\{ `id`: `string`; `title`: `string`; `category`: `string`;
+`description?`: `string`; `projections?`: \{ `bindings?`: \{ `order?`: `number`;
+`values`: readonly `string`[]; \}; `agent?`: \{ `keybind?`: `string`; `order?`:
+`number`; \}; `help?`: \{ `order?`: `number`; \}; `menu?`: \{ `order?`:
+`number`; \}; `palette?`: \{ `order?`: `number`; \}; `slash?`: \{ `aliases`:
+readonly `string`[]; `order?`: `number`; `arguments?`: \{ `hint`: `string`;
+`words?`: readonly ...[]; `text?`: \{ `field`: ...; `arguments`: ...;
+`requestIdField?`: ...; \}; \}; \}; \}; `action?`: \{ `inputSchema?`: \{
+\[`key`: `string`\]: \| `string` \| `number` \| `boolean` \| readonly string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| number \| boolean \| readonly (string \| number \| boolean \| readonly
+(string \| number \| boolean \| readonly (string \| number \| boolean \|
+readonly (string \| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{
+...; \} \| null)\[\] \| \{ ...; \} \| ...[] \| \{ \[`key`: `string`\]: string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| number \| boolean \| readonly (string \| number \| boolean \| readonly
+(string \| number \| boolean \| readonly (string \| number \| boolean \|
+readonly (string \| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{
+...; \} \| null)\[\] \| \{ ...; \} \| ...; \} \| `null`; \}; `outputSchema?`: \{
+\[`key`: `string`\]: \| `string` \| `number` \| `boolean` \| readonly string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| number \| boolean \| readonly (string \| number \| boolean \| readonly
+(string \| number \| boolean \| readonly (string \| number \| boolean \|
+readonly (string \| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{
+...; \} \| null)\[\] \| \{ ...; \} \| ...[] \| \{ \[`key`: `string`\]: string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| number \| boolean \| readonly (string \| number \| boolean \| readonly
+(string \| number \| boolean \| readonly (string \| number \| boolean \|
+readonly (string \| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{
+...; \} \| null)\[\] \| \{ ...; \} \| ...; \} \| `null`; \}; `presentation?`: \|
+\{ `type`: `"action"`; \} \| \{ `type`: `"custom"`; `data`: \{ \[`key`:
+`string`\]: \| `string` \| `number` \| `boolean` \| readonly string \| number \|
+boolean \| readonly (string \| number \| boolean \| readonly (string \| number
+\| boolean \| readonly (string \| number \| boolean \| readonly (string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{ ...; \} \|
+null)\[\] \| \{ ...; \} \| ...[] \| \{ \[`key`: `string`\]: string \| number \|
+boolean \| readonly (string \| number \| boolean \| readonly (string \| number
+\| boolean \| readonly (string \| number \| boolean \| readonly (string \|
+number \| boolean \| readonly (string \| number \| boolean \| readonly (string
+\| ... 4 more ... \| null)\[\] \| \{ ...; \} \| null)\[\] \| \{ ...; \} \|
+null)\[\] \| \{ ...; \} \| ...; \} \| `null`; \}; \} \| \{ `type`: `"choice"`;
+`options`: readonly `object`[]; \} \| \{ `type`: `"form"`; `submitLabel?`:
+`string`; \} \| \{ `type`: `"confirmation"`; `message`: `string`;
+`confirmLabel?`: `string`; `cancelLabel?`: `string`; \}; \}; `availability?`: ()
+=> `WhistleAvailability`; `handler`: (`input`) => `unknown`; \}\>[]
+
+---
+
+### contributeReloadCommand()
+
+```ts
+function contributeReloadCommand(
+  commands,
+  options,
+): Readonly<{
+  update: (commands) => void;
+  dispose: () => void;
+}>;
+```
+
+Contribute `/reload` to one Whistle host.
+
+#### Parameters
+
+| Parameter  | Type                                            |
+| ---------- | ----------------------------------------------- |
+| `commands` | `Pick`\<`WhistleRuntime`, `"contribute"`\>      |
+| `options`  | [`ReloadCommandOptions`](#reloadcommandoptions) |
+
+#### Returns
+
+`Readonly`\<\{ `update`: (`commands`) => `void`; `dispose`: () => `void`; \}\>
+
+---
+
+### contributeSessionCommands()
+
+```ts
+function contributeSessionCommands(
+  commands,
+  session,
+  options,
+): Readonly<{
+  update: (commands) => void;
+  dispose: () => void;
+}>;
+```
+
+Contribute the shared Session command vocabulary to one Whistle host.
+
+#### Parameters
+
+| Parameter  | Type                                                              |
+| ---------- | ----------------------------------------------------------------- |
+| `commands` | `Pick`\<`SessionCommandRuntime`, `"contribute"`\>                 |
+| `session`  | `SessionCommandSession`                                           |
+| `options`  | [`ParakeetSessionCommandOptions`](#parakeetsessioncommandoptions) |
+
+#### Returns
+
+`Readonly`\<\{ `update`: (`commands`) => `void`; `dispose`: () => `void`; \}\>
+
+## References
+
+### formatModelIdentity
+
+Re-exports [formatModelIdentity](index.md#formatmodelidentity)
+
+---
+
+### formatContextUsage
+
+Re-exports [formatContextUsage](index.md#formatcontextusage)
+
+---
+
+### formatTokenCount
+
+Re-exports [formatTokenCount](index.md#formattokencount)
+
+---
+
+### ParakeetProvider
+
+Re-exports [ParakeetProvider](index.md#parakeetprovider)
+
+---
+
+### useComposer
+
+Re-exports [useComposer](index.md#usecomposer)
+
+---
+
+### useStatus
+
+Re-exports [useStatus](index.md#usestatus)
+
+---
+
+### useTimeline
+
+Re-exports [useTimeline](index.md#usetimeline)
+
+---
+
+### ComposerController
+
+Re-exports [ComposerController](index.md#composercontroller)
+
+---
+
+### ParakeetModel
+
+Re-exports [ParakeetModel](index.md#parakeetmodel)
+
+---
+
+### ParakeetStatus
+
+Re-exports [ParakeetStatus](index.md#parakeetstatus)
+
+---
+
+### ParakeetUsage
+
+Re-exports [ParakeetUsage](index.md#parakeetusage)
+
+---
+
+### StatusController
+
+Re-exports [StatusController](index.md#statuscontroller)
+
+---
+
+### TimelineController
+
+Re-exports [TimelineController](index.md#timelinecontroller)
+
+---
+
+### completeSlash
+
+Re-exports [completeSlash](commands/slash.md#completeslash)
+
+---
+
+### fuzzyMatch
+
+Re-exports [fuzzyMatch](commands/slash.md#fuzzymatch-1)
+
+---
+
+### keyBindings
+
+Re-exports [keyBindings](commands/slash.md#keybindings)
+
+---
+
+### keyLabel
+
+Re-exports [keyLabel](commands/slash.md#keylabel)
+
+---
+
+### parseSlashDraft
+
+Re-exports [parseSlashDraft](commands/slash.md#parseslashdraft)
+
+---
+
+### slashRegistry
+
+Re-exports [slashRegistry](commands/slash.md#slashregistry)
+
+---
+
+### FuzzyMatch
+
+Re-exports [FuzzyMatch](commands/slash.md#fuzzymatch)
+
+---
+
+### KeyBindingRow
+
+Re-exports [KeyBindingRow](commands/slash.md#keybindingrow)
+
+---
+
+### SlashCommand
+
+Re-exports [SlashCommand](commands/slash.md#slashcommand)
+
+---
+
+### SlashCommandItem
+
+Re-exports [SlashCommandItem](commands/slash.md#slashcommanditem)
+
+---
+
+### SlashCompletion
+
+Re-exports [SlashCompletion](commands/slash.md#slashcompletion)
+
+---
+
+### SlashParse
+
+Re-exports [SlashParse](commands/slash.md#slashparse)
+
+---
+
+### SlashWordItem
+
+Re-exports [SlashWordItem](commands/slash.md#slashworditem)
+
+---
+
+### ParakeetSession
+
+Re-exports [ParakeetSession](index.md#parakeetsession)
+
+---
+
+### ParakeetSessionCommand
+
+Re-exports [ParakeetSessionCommand](index.md#parakeetsessioncommand)
+
+---
+
+### ParakeetPromptResult
+
+Re-exports [ParakeetPromptResult](index.md#parakeetpromptresult)
+
+---
+
+### ParakeetAssistantMessageItem
+
+Re-exports [ParakeetAssistantMessageItem](index.md#parakeetassistantmessageitem)
+
+---
+
+### ParakeetTimelineItem
+
+Re-exports [ParakeetTimelineItem](index.md#parakeettimelineitem)
+
+---
+
+### ParakeetToolGroupItem
+
+Re-exports [ParakeetToolGroupItem](index.md#parakeettoolgroupitem)
+
+---
+
+### ParakeetToolItem
+
+Re-exports [ParakeetToolItem](index.md#parakeettoolitem)
+
+---
+
+### ParakeetUserMessageItem
+
+Re-exports [ParakeetUserMessageItem](index.md#parakeetusermessageitem)
+
+---
+
+### ParakeetToolArguments
+
+Re-exports [ParakeetToolArguments](index.md#parakeettoolarguments)
+
+---
+
+### useMarkdown
+
+Re-exports [useMarkdown](index.md#usemarkdown)
+
+---
+
+### formatToolDuration
+
+Re-exports [formatToolDuration](index.md#formattoolduration)
+
+---
+
+### ParakeetToolCallSection
+
+Re-exports [ParakeetToolCallSection](index.md#parakeettoolcallsection)
+
+---
+
+### ParakeetToolCallView
+
+Re-exports [ParakeetToolCallView](index.md#parakeettoolcallview)
+
+---
+
+### ParakeetToolDiffFile
+
+Re-exports [ParakeetToolDiffFile](index.md#parakeettooldifffile)
+
+---
+
+### ParakeetToolDiffHunk
+
+Re-exports [ParakeetToolDiffHunk](index.md#parakeettooldiffhunk)
+
+---
+
+### ParakeetToolDiffLine
+
+Re-exports [ParakeetToolDiffLine](index.md#parakeettooldiffline)
+
+---
+
+### ParakeetToolDiffRow
+
+Re-exports [ParakeetToolDiffRow](index.md#parakeettooldiffrow)
+
+---
+
+### ParakeetToolExcerptLine
+
+Re-exports [ParakeetToolExcerptLine](index.md#parakeettoolexcerptline)
+
+---
+
+### ParakeetToolKind
+
+Re-exports [ParakeetToolKind](index.md#parakeettoolkind)
+
+---
+
+### ParakeetToolMatch
+
+Re-exports [ParakeetToolMatch](index.md#parakeettoolmatch)
+
+---
+
+### ParakeetToolOutputLine
+
+Re-exports [ParakeetToolOutputLine](index.md#parakeettooloutputline)
+
+---
+
+### disclosureOpen
+
+Re-exports [disclosureOpen](index.md#disclosureopen)
+
+---
+
+### initialToolDisclosure
+
+Re-exports [initialToolDisclosure](index.md#initialtooldisclosure)
+
+---
+
+### toggleAllDisclosure
+
+Re-exports [toggleAllDisclosure](index.md#togglealldisclosure)
+
+---
+
+### toggleDisclosure
+
+Re-exports [toggleDisclosure](index.md#toggledisclosure)
+
+---
+
+### toolCallDefaultOpen
+
+Re-exports [toolCallDefaultOpen](index.md#toolcalldefaultopen)
+
+---
+
+### toolGroupDefaultOpen
+
+Re-exports [toolGroupDefaultOpen](index.md#toolgroupdefaultopen)
+
+---
+
+### visibleToolCalls
+
+Re-exports [visibleToolCalls](index.md#visibletoolcalls)
+
+---
+
+### ToolDisclosureState
+
+Re-exports [ToolDisclosureState](index.md#tooldisclosurestate)