@fungi.computer/agar 0.0.0-stage → 0.0.1

package/docs/api/index.md

@@ -0,0 +1,2880 @@
+<!-- Generated by Botanical API docs (TypeDoc + typedoc-plugin-markdown). Do not edit. -->
+
+[**@fungi.computer/agar**](README.md)
+
+---
+
+[@fungi.computer/agar](modules.md) / index
+
+# index
+
+## Type Aliases
+
+### FungiAuthor
+
+```ts
+type FungiAuthor = z.infer<typeof FungiAuthorSchema>;
+```
+
+Who a Session line came from, as the admitting host authenticated them.
+
+---
+
+### FungiDelegationReply
+
+```ts
+type FungiDelegationReply = z.infer<typeof FungiDelegationReplySchema>;
+```
+
+A delegated Agent's reply as the admitting host authenticated it.
+
+---
+
+### FungiMessageMeta
+
+```ts
+type FungiMessageMeta = z.infer<typeof FungiMessageMetaSchema>;
+```
+
+The metadata the host attaches to every prompt and operator line it admits.
+
+---
+
+### MessageMetaValue
+
+```ts
+type MessageMetaValue =
+  | string
+  | number
+  | boolean
+  | null
+  | readonly MessageMetaValue[]
+  | Readonly<{
+      [key: string]: MessageMetaValue;
+    }>;
+```
+
+Any JSON value, as Shiitake returns a message's metadata.
+
+---
+
+### AuthorMeta
+
+```ts
+type AuthorMeta = Readonly<{
+  author: Readonly<FungiAuthor>;
+}>;
+```
+
+The metadata the host attaches for one authenticated author, as JSON.
+
+---
+
+### AppAgent
+
+```ts
+type AppAgent = Schema.Schema.Type<typeof appAgentSchema>;
+```
+
+An Agent record as decoded from the host: its id, display name, and which
+session operations this App is permitted to perform on it.
+
+---
+
+### AppAgentCreateInput
+
+```ts
+type AppAgentCreateInput = Readonly<
+  Schema.Schema.Type<typeof appAgentCreateInputSchema>
+>;
+```
+
+Input for creating a new Agent: its name, a caller-chosen request id for
+idempotency, and whether to provision a new Computer for it.
+
+---
+
+### AppAgentTransportHandle
+
+```ts
+type AppAgentTransportHandle = object;
+```
+
+Live object-capability shape received from Cap'n Web.
+
+#### Methods
+
+##### fetch()
+
+```ts
+fetch(request): Promise<Response>;
+```
+
+Send one request to the Agent's session endpoint.
+
+###### Parameters
+
+| Parameter | Type      |
+| --------- | --------- |
+| `request` | `Request` |
+
+###### Returns
+
+`Promise`\<`Response`\>
+
+##### close()
+
+```ts
+close(): Promise<void>;
+```
+
+Release the underlying object capability.
+
+###### Returns
+
+`Promise`\<`void`\>
+
+##### \[dispose\]()
+
+```ts
+dispose: void;
+```
+
+Synchronously release local resources, for `using` disposal.
+
+###### Returns
+
+`void`
+
+---
+
+### AppAgentListHandle
+
+```ts
+type AppAgentListHandle = object;
+```
+
+Capability handle for listing the Agents in a directory.
+
+#### Methods
+
+##### list()
+
+```ts
+list(): Promise<readonly object[]>;
+```
+
+List the Agents visible to this App in the directory.
+
+###### Returns
+
+`Promise`\<readonly `object`[]\>
+
+---
+
+### AppAgentCreateHandle
+
+```ts
+type AppAgentCreateHandle = object;
+```
+
+Capability handle for creating a new Agent in a directory.
+
+#### Methods
+
+##### create()
+
+```ts
+create(input): Promise<{
+  agentId: string;
+  name: string;
+  sessionOperations: readonly ("agent.manage" | "agent.read" | "agent.send")[];
+}>;
+```
+
+Create a new Agent with the given name and request id.
+
+###### Parameters
+
+| Parameter | Type                                          |
+| --------- | --------------------------------------------- |
+| `input`   | [`AppAgentCreateInput`](#appagentcreateinput) |
+
+###### Returns
+
+`Promise`\<\{ `agentId`: `string`; `name`: `string`; `sessionOperations`:
+readonly (`"agent.manage"` \| `"agent.read"` \| `"agent.send"`)[]; \}\>
+
+---
+
+### AppAgentDirectoryHandle
+
+```ts
+type AppAgentDirectoryHandle = AppAgentListHandle &
+  AppAgentCreateHandle &
+  object;
+```
+
+Live capability handle for listing and creating Agents in a Team or
+local-project directory, and opening transports to them.
+
+#### Type Declaration
+
+| Name          | Type                                                                            | Description                                                   |
+| ------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------- |
+| `open()`      | (`input`) => `Promise`\<[`AppAgentTransportHandle`](#appagenttransporthandle)\> | Open a transport to the Agent identified by `agentId`.        |
+| `openInbox()` | () => `Promise`\<[`AppAgentTransportHandle`](#appagenttransporthandle)\>        | The member's inbox feed, limited to Agents this App may read. |
+
+---
+
+### AppAgentRenameInput
+
+```ts
+type AppAgentRenameInput = Readonly<
+  Schema.Schema.Type<typeof appAgentRenameInputSchema>
+>;
+```
+
+Input for renaming an existing Agent: its id and the owner's chosen replacement
+display name.
+
+---
+
+### AppAgentRenameHandle
+
+```ts
+type AppAgentRenameHandle = object;
+```
+
+Capability handle for renaming an Agent the owner already created.
+
+#### Methods
+
+##### rename()
+
+```ts
+rename(input): Promise<{
+  agentId: string;
+  name: string;
+  sessionOperations: readonly ("agent.manage" | "agent.read" | "agent.send")[];
+}>;
+```
+
+Rename an existing Agent and return its updated record.
+
+###### Parameters
+
+| Parameter | Type                                          |
+| --------- | --------------------------------------------- |
+| `input`   | [`AppAgentRenameInput`](#appagentrenameinput) |
+
+###### Returns
+
+`Promise`\<\{ `agentId`: `string`; `name`: `string`; `sessionOperations`:
+readonly (`"agent.manage"` \| `"agent.read"` \| `"agent.send"`)[]; \}\>
+
+---
+
+### AppAgentToolPolicyStatus
+
+```ts
+type AppAgentToolPolicyStatus = z.infer<typeof appAgentToolPolicyStatusSchema>;
+```
+
+Whether an Agent's App tools are still pending the owner's approval.
+
+---
+
+### AppAgentToolPolicyResult
+
+```ts
+type AppAgentToolPolicyResult = z.infer<typeof appAgentToolPolicyResultSchema>;
+```
+
+The outcome of an owner's direct App-tool approval.
+
+---
+
+### AppAgentToolPolicyHandle
+
+```ts
+type AppAgentToolPolicyHandle = object;
+```
+
+Capability handle for reading and approving an Agent's App-tool policy.
+
+#### Methods
+
+##### status()
+
+```ts
+status(input): Promise<
+  | {
+  status: "pending";
+  revision: string;
+}
+  | {
+  status: "approved";
+  revision: string;
+}
+| null>;
+```
+
+This Agent's current policy status, or `null` for no such Agent.
+
+###### Parameters
+
+| Parameter       | Type                       |
+| --------------- | -------------------------- |
+| `input`         | \{ `agentId`: `string`; \} |
+| `input.agentId` | `string`                   |
+
+###### Returns
+
+`Promise`\< \| \{ `status`: `"pending"`; `revision`: `string`; \} \| \{
+`status`: `"approved"`; `revision`: `string`; \} \| `null`\>
+
+##### approve()
+
+```ts
+approve(input): Promise<
+  | {
+  status: "pending";
+  revision: string;
+}
+  | {
+  status: "approved";
+  revision: string;
+}
+  | {
+  error: string;
+}>;
+```
+
+Approve (or re-request) this Agent's App tools under a CAS revision.
+
+###### Parameters
+
+| Parameter                | Type                                                                                               |
+| ------------------------ | -------------------------------------------------------------------------------------------------- |
+| `input`                  | \{ `agentId`: `string`; `level`: `"read"` \| `"write"`; `expectedRevision`: `string` \| `null`; \} |
+| `input.agentId`          | `string`                                                                                           |
+| `input.level`            | `"read"` \| `"write"`                                                                              |
+| `input.expectedRevision` | `string` \| `null`                                                                                 |
+
+###### Returns
+
+`Promise`\< \| \{ `status`: `"pending"`; `revision`: `string`; \} \| \{
+`status`: `"approved"`; `revision`: `string`; \} \| \{ `error`: `string`; \}\>
+
+---
+
+### AppAgentTransport
+
+```ts
+type AppAgentTransport = Readonly<{
+  baseUrl: string;
+  fetch: typeof globalThis.fetch;
+  close: () => Promise<void>;
+}>;
+```
+
+A Fetch-based transport to one Agent's session endpoint, scoped to this App and
+safe to hand to an HTTP client adapter.
+
+---
+
+### CapabilityContract
+
+```ts
+type CapabilityContract<T> = object;
+```
+
+A capability owner's frozen, typed descriptor. Descriptor identity is not
+authority.
+
+#### Type Parameters
+
+| Type Parameter |
+| -------------- |
+| `T`            |
+
+#### Properties
+
+##### id
+
+```ts
+readonly id: string;
+```
+
+##### version
+
+```ts
+readonly version: number;
+```
+
+##### schema
+
+```ts
+readonly schema: z.ZodType<T>;
+```
+
+---
+
+### CapabilityDirectory
+
+```ts
+type CapabilityDirectory = object;
+```
+
+The App's read-only view of its currently admitted capabilities.
+
+#### Properties
+
+##### version
+
+```ts
+readonly version: number;
+```
+
+Changes after a successful grant replacement or disconnection.
+
+#### Methods
+
+##### subscribe()
+
+```ts
+subscribe(listener): Disposer;
+```
+
+Read the current directory after a change. Does not emit on subscribe.
+
+###### Parameters
+
+| Parameter  | Type         |
+| ---------- | ------------ |
+| `listener` | () => `void` |
+
+###### Returns
+
+[`Disposer`](#disposer)
+
+##### has()
+
+```ts
+has(contract): boolean;
+```
+
+Whether an implementation for this contract is currently admitted.
+
+###### Parameters
+
+| Parameter  | Type                                                     |
+| ---------- | -------------------------------------------------------- |
+| `contract` | [`CapabilityContract`](#capabilitycontract)\<`unknown`\> |
+
+###### Returns
+
+`boolean`
+
+##### require()
+
+```ts
+require<T>(contract): T;
+```
+
+The admitted implementation for this contract, or throw a `CAPABILITY_DENIED`
+AppError when none is granted.
+
+###### Type Parameters
+
+| Type Parameter |
+| -------------- |
+| `T`            |
+
+###### Parameters
+
+| Parameter  | Type                                               |
+| ---------- | -------------------------------------------------- |
+| `contract` | [`CapabilityContract`](#capabilitycontract)\<`T`\> |
+
+###### Returns
+
+`T`
+
+---
+
+### CapabilityRegistry
+
+```ts
+type CapabilityRegistry = CapabilityDirectory & object;
+```
+
+Local capabilities admitted through their owner's typed contract.
+
+#### Type Declaration
+
+| Name        | Type                                            | Description                                                                                                           |
+| ----------- | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| `provide()` | \<`T`\>(`contract`, `implementation`) => `void` | Admit an implementation for this contract, replacing any previous one and bumping `version` so subscribers can react. |
+
+---
+
+### AppCommand
+
+```ts
+type AppCommand = WhistleCommandDefinition;
+```
+
+Semantic command metadata supplied by an App and owned by Whistle.
+
+---
+
+### AppCommandHandler
+
+```ts
+type AppCommandHandler = (
+  invocation,
+) => Promise<WhistleJsonValue | undefined> | WhistleJsonValue | undefined;
+```
+
+One invocation's semantic input; host correlation IDs are private.
+
+#### Parameters
+
+| Parameter    | Type                                            |
+| ------------ | ----------------------------------------------- |
+| `invocation` | [`AppCommandInvocation`](#appcommandinvocation) |
+
+#### Returns
+
+\| `Promise`\<`WhistleJsonValue` \| `undefined`\> \| `WhistleJsonValue` \|
+`undefined`
+
+---
+
+### AppCommandInvocation
+
+```ts
+type AppCommandInvocation = object;
+```
+
+One command invocation's semantic input, passed to its handler.
+
+#### Properties
+
+##### arguments?
+
+```ts
+readonly optional arguments?: WhistleJsonValue;
+```
+
+##### origin
+
+```ts
+readonly origin: WhistleExecutionOrigin;
+```
+
+##### signal
+
+```ts
+readonly signal: AbortSignal;
+```
+
+---
+
+### AppCommands
+
+```ts
+type AppCommands = object;
+```
+
+Registers a command with the authenticated host for this page session. The
+promise resolves only after the host accepts the registration.
+
+#### Methods
+
+##### register()
+
+```ts
+register(command, handler): Promise<Disposer>;
+```
+
+Register one command and its handler with the host; resolves once the host
+accepts it. Call the returned Disposer to unregister.
+
+###### Parameters
+
+| Parameter               | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `command`               | \{ `id`: `z.ZodString`; `title`: `z.ZodString`; `category`: `z.ZodString`; `description?`: `z.ZodOptional`\<`z.ZodString`\>; `projections?`: `z.ZodOptional`\<`z.ZodObject`\<\{ `bindings`: `z.ZodOptional`\<`z.ZodObject`\<\{ `order`: `z.ZodOptional`\<`z.ZodNumber`\>; `values`: `z.ZodArray`\<`z.ZodString`\>; \}, `z.core.$strict`\>\>; `agent`: `z.ZodOptional`\<`z.ZodObject`\<\{ `keybind`: `z.ZodOptional`\<`z.ZodString`\>; `order`: `z.ZodOptional`\<`z.ZodNumber`\>; \}, `z.core.$strict`\>\>; `help`: `z.ZodOptional`\<`z.ZodObject`\<\{ `order`: `z.ZodOptional`\<`z.ZodNumber`\>; \}, `z.core.$strict`\>\>; `menu`: `z.ZodOptional`\<`z.ZodObject`\<\{ `order`: `z.ZodOptional`\<`z.ZodNumber`\>; \}, `z.core.$strict`\>\>; `palette`: `z.ZodOptional`\<`z.ZodObject`\<\{ `order`: `z.ZodOptional`\<`z.ZodNumber`\>; \}, `z.core.$strict`\>\>; `slash`: `z.ZodOptional`\<`z.ZodObject`\<\{ `aliases`: `z.ZodArray`\<`z.ZodString`\>; `order`: `z.ZodOptional`\<`z.ZodNumber`\>; `arguments`: `z.ZodOptional`\<`z.ZodObject`\<\{ `hint`: ...; `words`: ...; `text`: ...; \}, `z.core.$strict`\>\>; \}, `z.core.$strict`\>\>; \}, `z.core.$strict`\>\>; `action?`: `z.ZodOptional`\<`z.ZodObject`\<\{ `inputSchema`: `z.ZodOptional`\<`z.ZodRecord`\<`z.ZodString`, `z.ZodJSONSchema`\>\>; `outputSchema`: `z.ZodOptional`\<`z.ZodRecord`\<`z.ZodString`, `z.ZodJSONSchema`\>\>; `presentation`: `z.ZodOptional`\<`z.ZodUnion`\<readonly \[`z.ZodObject`\<\{ `type`: ...; \}, `z.core.$strict`\>, `z.ZodObject`\<\{ `type`: ...; `data`: ...; \}, `z.core.$strict`\>, `z.ZodObject`\<\{ `type`: ...; `options`: ...; \}, `z.core.$strict`\>, `z.ZodObject`\<\{ `type`: ...; `submitLabel`: ...; \}, `z.core.$strict`\>, `z.ZodObject`\<\{ `type`: ...; `message`: ...; `confirmLabel`: ...; `cancelLabel`: ...; \}, `z.core.$strict`\>\]\>\>; \}, `z.core.$strict`\>\>; `availability?`: `z.ZodOptional`\<`z.ZodDiscriminatedUnion`\<\[`z.ZodObject`\<\{ `status`: `z.ZodLiteral`\<`"available"`\>; \}, `z.core.$strict`\>, `z.ZodObject`\<\{ `status`: `z.ZodLiteral`\<`"unavailable"`\>; `reason`: `z.ZodString`; \}, `z.core.$strict`\>\], `"status"`\>\>; \} |
+| `command.id`            | `z.ZodString`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `command.title`         | `z.ZodString`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `command.category`      | `z.ZodString`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `command.description?`  | `z.ZodOptional`\<`z.ZodString`\>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| `command.projections?`  | `z.ZodOptional`\<`z.ZodObject`\<\{ `bindings`: `z.ZodOptional`\<`z.ZodObject`\<\{ `order`: `z.ZodOptional`\<`z.ZodNumber`\>; `values`: `z.ZodArray`\<`z.ZodString`\>; \}, `z.core.$strict`\>\>; `agent`: `z.ZodOptional`\<`z.ZodObject`\<\{ `keybind`: `z.ZodOptional`\<`z.ZodString`\>; `order`: `z.ZodOptional`\<`z.ZodNumber`\>; \}, `z.core.$strict`\>\>; `help`: `z.ZodOptional`\<`z.ZodObject`\<\{ `order`: `z.ZodOptional`\<`z.ZodNumber`\>; \}, `z.core.$strict`\>\>; `menu`: `z.ZodOptional`\<`z.ZodObject`\<\{ `order`: `z.ZodOptional`\<`z.ZodNumber`\>; \}, `z.core.$strict`\>\>; `palette`: `z.ZodOptional`\<`z.ZodObject`\<\{ `order`: `z.ZodOptional`\<`z.ZodNumber`\>; \}, `z.core.$strict`\>\>; `slash`: `z.ZodOptional`\<`z.ZodObject`\<\{ `aliases`: `z.ZodArray`\<`z.ZodString`\>; `order`: `z.ZodOptional`\<`z.ZodNumber`\>; `arguments`: `z.ZodOptional`\<`z.ZodObject`\<\{ `hint`: ...; `words`: ...; `text`: ...; \}, `z.core.$strict`\>\>; \}, `z.core.$strict`\>\>; \}, `z.core.$strict`\>\>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| `command.action?`       | `z.ZodOptional`\<`z.ZodObject`\<\{ `inputSchema`: `z.ZodOptional`\<`z.ZodRecord`\<`z.ZodString`, `z.ZodJSONSchema`\>\>; `outputSchema`: `z.ZodOptional`\<`z.ZodRecord`\<`z.ZodString`, `z.ZodJSONSchema`\>\>; `presentation`: `z.ZodOptional`\<`z.ZodUnion`\<readonly \[`z.ZodObject`\<\{ `type`: ...; \}, `z.core.$strict`\>, `z.ZodObject`\<\{ `type`: ...; `data`: ...; \}, `z.core.$strict`\>, `z.ZodObject`\<\{ `type`: ...; `options`: ...; \}, `z.core.$strict`\>, `z.ZodObject`\<\{ `type`: ...; `submitLabel`: ...; \}, `z.core.$strict`\>, `z.ZodObject`\<\{ `type`: ...; `message`: ...; `confirmLabel`: ...; `cancelLabel`: ...; \}, `z.core.$strict`\>\]\>\>; \}, `z.core.$strict`\>\>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `command.availability?` | `z.ZodOptional`\<`z.ZodDiscriminatedUnion`\<\[`z.ZodObject`\<\{ `status`: `z.ZodLiteral`\<`"available"`\>; \}, `z.core.$strict`\>, `z.ZodObject`\<\{ `status`: `z.ZodLiteral`\<`"unavailable"`\>; `reason`: `z.ZodString`; \}, `z.core.$strict`\>\], `"status"`\>\>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `handler`               | [`AppCommandHandler`](#appcommandhandler)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+
+###### Returns
+
+`Promise`\<[`Disposer`](#disposer)\>
+
+---
+
+### ConnectAppOptions
+
+```ts
+type ConnectAppOptions = object;
+```
+
+Options for connecting this iframe page to its authenticated host.
+
+#### Properties
+
+##### expectedHostOrigin
+
+```ts
+readonly expectedHostOrigin: string;
+```
+
+The origin the host handshake message must come from; the connection is refused
+when it comes from anywhere else.
+
+##### signal?
+
+```ts
+readonly optional signal?: AbortSignal;
+```
+
+Cancels a pending connection attempt.
+
+---
+
+### AppConnectMessage
+
+```ts
+type AppConnectMessage = object;
+```
+
+The host's handshake message that hands the App its RPC MessagePort.
+
+#### Properties
+
+##### epoch
+
+```ts
+readonly epoch: string;
+```
+
+##### protocolVersion
+
+```ts
+readonly protocolVersion: typeof APP_PROTOCOL_VERSION;
+```
+
+##### type
+
+```ts
+readonly type: typeof APP_CONNECT_TYPE;
+```
+
+---
+
+### AppReadyMessage
+
+```ts
+type AppReadyMessage = object;
+```
+
+The App iframe's handshake message announcing it is ready to connect.
+
+#### Properties
+
+##### protocolVersion
+
+```ts
+readonly protocolVersion: typeof APP_PROTOCOL_VERSION;
+```
+
+##### type
+
+```ts
+readonly type: typeof APP_READY_TYPE;
+```
+
+---
+
+### AppContext
+
+```ts
+type AppContext = object;
+```
+
+The host-published state surrounding a connected App: its Computer selection,
+focus, visibility, and any pending open request.
+
+#### Properties
+
+##### computerId
+
+```ts
+readonly computerId: string | null;
+```
+
+Host-selected Computer backing this App's admitted resource capabilities.
+
+##### teamHasComputers?
+
+```ts
+readonly optional teamHasComputers?: boolean | null;
+```
+
+Whether the Team has Computers, when this host owns its Team directory.
+
+##### computerAccessGranted?
+
+```ts
+readonly optional computerAccessGranted?: boolean;
+```
+
+Whether this App has execute access across the Team, when known.
+
+##### focus
+
+```ts
+readonly focus: FocusState;
+```
+
+##### openRequest
+
+```ts
+readonly openRequest: AppOpenRequest | null;
+```
+
+One host-issued App open action, present only on the launch/reconfigure.
+
+##### visibility
+
+```ts
+readonly visibility: "hidden" | "visible";
+```
+
+---
+
+### AppOpenRequest
+
+```ts
+type AppOpenRequest =
+  | Readonly<{
+      kind: "compose";
+      requestId: string;
+      text: string;
+    }>
+  | Readonly<{
+      kind: "navigate";
+      requestId: string;
+      params: readonly Readonly<{
+        key: string;
+        value: string;
+      }>[];
+    }>;
+```
+
+One host-issued action an App must act on when it opens or reconfigures: start
+composing given text, or navigate to the given params. Each carries a
+`requestId` so the App can tell a repeated open from a fresh one.
+
+---
+
+### AppIdentity
+
+```ts
+type AppIdentity = object;
+```
+
+The App's own identity, as admitted by its host.
+
+#### Properties
+
+##### appId
+
+```ts
+readonly appId: string;
+```
+
+##### releaseId
+
+```ts
+readonly releaseId: string;
+```
+
+##### surfaceId
+
+```ts
+readonly surfaceId: string;
+```
+
+---
+
+### AppLifecycle
+
+```ts
+type AppLifecycle =
+  | "connected"
+  | "connecting"
+  | "disconnected"
+  | "disposed"
+  | "disposing"
+  | "suspended";
+```
+
+The connection state of this App's session with its host.
+
+---
+
+### FocusState
+
+```ts
+type FocusState = object;
+```
+
+Whether the App's own surface is being edited and which surface, if any, the
+host considers focused.
+
+#### Properties
+
+##### editing
+
+```ts
+readonly editing: boolean;
+```
+
+##### surface
+
+```ts
+readonly surface: null | string;
+```
+
+---
+
+### MediaGenerationInput
+
+```ts
+type MediaGenerationInput = Readonly<{
+  destination: Readonly<{
+    path: string;
+  }>;
+  settings: MediaGenerationSelection;
+}>;
+```
+
+The Media owner decides Team, Installation, Release, Grant and Computer
+authority before issuing this handle. The App contributes only generation
+settings and selected destination/references. The IDs in those selections are
+not authority: the host revalidates every one against its current admitted
+Computer scope when it accepts a generation.
+
+The owner intentionally returns completed metadata. Operation state, provider
+identifiers and billing records remain owner facts. The exposed request
+reference identifies a replay; it grants no authority.
+
+---
+
+### MediaOutputFormat
+
+```ts
+type MediaOutputFormat = "png" | "jpeg" | "gif" | "webp" | "mp4";
+```
+
+The encodings a completed generation can be saved as.
+
+---
+
+### MediaGenerationResult
+
+```ts
+type MediaGenerationResult = Readonly<{
+  bytes: number;
+  costMilliunits: number;
+  destination: Readonly<{
+    computerId: string;
+    path: string;
+  }>;
+  format: MediaOutputFormat;
+  height: number;
+  model: string;
+  width: number;
+}>;
+```
+
+Metadata for one completed generation: the saved destination, pixel dimensions,
+format, model used, and its cost.
+
+---
+
+### MediaGenerationFailure
+
+```ts
+type MediaGenerationFailure = Schema.Schema.Type<
+  typeof mediaGenerationFailureSchema
+>;
+```
+
+The host's typed reason a generation failed: code, message, retry truth and,
+when known, the stage that failed.
+
+---
+
+### MediaGenerationOutcome
+
+```ts
+type MediaGenerationOutcome =
+  | Readonly<{
+      kind: "succeeded";
+      result: MediaGenerationResult;
+    }>
+  | Readonly<{
+      kind: "failed";
+      failure: MediaGenerationFailure;
+    }>;
+```
+
+Transport-safe result from the host-owned generation attempt.
+
+---
+
+### MediaGenerationHandle
+
+```ts
+type MediaGenerationHandle = object;
+```
+
+Live object-capability shape supplied by the host.
+
+#### Methods
+
+##### describe()
+
+```ts
+describe(): Promise<Partial<Disposable> & object>;
+```
+
+Fetch the Computer scope, available models, and whether generation is currently
+allowed.
+
+###### Returns
+
+`Promise`\<`Partial`\<`Disposable`\> & `object`\>
+
+##### createAttempt()
+
+```ts
+createAttempt(): Promise<MediaGenerationAttemptHandle>;
+```
+
+Begin a new generation attempt on the host and return its handle.
+
+###### Returns
+
+`Promise`\<[`MediaGenerationAttemptHandle`](#mediagenerationattempthandle)\>
+
+##### restoreAttempt()
+
+```ts
+restoreAttempt(reference): Promise<MediaGenerationAttemptHandle>;
+```
+
+Resume a previously started attempt identified by its reference.
+
+###### Parameters
+
+| Parameter              | Type                                                 |
+| ---------------------- | ---------------------------------------------------- |
+| `reference`            | \{ `requestId`: `string`; `computerId`: `string`; \} |
+| `reference.requestId`  | `string`                                             |
+| `reference.computerId` | `string`                                             |
+
+###### Returns
+
+`Promise`\<[`MediaGenerationAttemptHandle`](#mediagenerationattempthandle)\>
+
+##### cancelAttempt()
+
+```ts
+cancelAttempt(reference): Promise<void>;
+```
+
+Tell the host to stop an in-flight or pending attempt.
+
+###### Parameters
+
+| Parameter              | Type                                                 |
+| ---------------------- | ---------------------------------------------------- |
+| `reference`            | \{ `requestId`: `string`; `computerId`: `string`; \} |
+| `reference.requestId`  | `string`                                             |
+| `reference.computerId` | `string`                                             |
+
+###### Returns
+
+`Promise`\<`void`\>
+
+---
+
+### MediaGenerationAttemptHandle
+
+```ts
+type MediaGenerationAttemptHandle = Partial<Disposable> & object;
+```
+
+Host-supplied object-capability for one attempt, before Agar wraps it into the
+typed MediaGenerationAttempt.
+
+#### Type Declaration
+
+| Name          | Type                                                                                                      | Description                                                           |
+| ------------- | --------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
+| `reference()` | () => `Promise`\<`object` & `Partial`\<`Disposable`\>\>                                                   | Fetch this attempt's replay reference from the host.                  |
+| `generate()`  | (`input`) => `Promise`\<[`MediaGenerationOutcome`](#mediagenerationoutcome) & `Partial`\<`Disposable`\>\> | Ask the host to run generation for this attempt with the given input. |
+
+---
+
+### MediaGenerationAttempt
+
+```ts
+type MediaGenerationAttempt = Disposable & object;
+```
+
+One generation attempt: a stable reference plus the ability to run (or retry)
+generation against it until disposed.
+
+#### Type Declaration
+
+| Name         | Type                                                                                                                                                                                                                                                                                                  | Description                                                                                                                        |
+| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| `reference`  | [`MediaGenerationReference`](#mediagenerationreference)                                                                                                                                                                                                                                               | -                                                                                                                                  |
+| `generate()` | (`input`, `options?`) => `Promise`\<`Readonly`\<\{ `bytes`: `number`; `costMilliunits`: `number`; `destination`: `Readonly`\<\{ `computerId`: `string`; `path`: `string`; \}\>; `format`: [`MediaOutputFormat`](#mediaoutputformat); `height`: `number`; `model`: `string`; `width`: `number`; \}\>\> | Run generation for this attempt and return the saved result, or throw MediaGenerationError on failure; an abort signal cancels it. |
+
+---
+
+### MediaGenerationSession
+
+```ts
+type MediaGenerationSession = Readonly<{
+  computerId: string;
+  canGenerate: boolean;
+  models: readonly MediaModel[];
+  createAttempt: Promise<MediaGenerationAttempt>;
+  restoreAttempt: Promise<MediaGenerationAttempt>;
+}>;
+```
+
+The validated, App-facing handle returned by openMediaGeneration: the Computer's
+model catalog plus the ability to start or resume attempts.
+
+---
+
+### MediaGenerationReference
+
+```ts
+type MediaGenerationReference = Schema.Schema.Type<
+  typeof mediaGenerationReferenceSchema
+>;
+```
+
+An opaque replay identity for one attempt; it identifies a request, not an
+authorization to use it.
+
+---
+
+### MediaModel
+
+```ts
+type MediaModel = Schema.Schema.Type<typeof mediaModelSchema>;
+```
+
+One generation model as the host describes it: identity, tier, input limits and
+supported output formats. The host owns the catalog.
+
+---
+
+### MediaGenerationSelection
+
+```ts
+type MediaGenerationSelection = Schema.Schema.Type<
+  typeof mediaGenerationSelectionSchema
+>;
+```
+
+An App's generation settings: model, prompt, size and optional steps, duration
+and Computer-relative reference paths.
+
+---
+
+### Pending
+
+```ts
+type Pending = Readonly<z.output<typeof pendingSchema>>;
+```
+
+The shared polling result, owned by the App contract.
+
+---
+
+### AppRoot
+
+```ts
+type AppRoot = object;
+```
+
+The App's live connection to its host: its admitted capabilities, commands,
+context, theme, UI door and window, all torn down together by `dispose`.
+Returned by `connectApp` and passed to `mountApp`.
+
+#### Properties
+
+##### capabilities
+
+```ts
+readonly capabilities: CapabilityDirectory;
+```
+
+##### commands
+
+```ts
+readonly commands: AppCommands;
+```
+
+##### context
+
+```ts
+readonly context: ReadonlyStore<AppContext>;
+```
+
+##### identity
+
+```ts
+readonly identity: Readonly<AppIdentity>;
+```
+
+##### lifecycle
+
+```ts
+readonly lifecycle: ReadonlyStore<AppLifecycle>;
+```
+
+##### theme
+
+```ts
+readonly theme: ReadonlyStore<string>;
+```
+
+##### ui
+
+```ts
+readonly ui: HostUi;
+```
+
+##### window
+
+```ts
+readonly window: AppWindow;
+```
+
+#### Methods
+
+##### dispose()
+
+```ts
+dispose(): void;
+```
+
+End this App's connection to its host and release everything it owns.
+
+###### Returns
+
+`void`
+
+---
+
+### Disposer
+
+```ts
+type Disposer = () => void;
+```
+
+Releases a subscription or other held resource. Call once; further calls are a
+no-op.
+
+#### Returns
+
+`void`
+
+---
+
+### ReadonlyStore
+
+```ts
+type ReadonlyStore<T> = object;
+```
+
+A retained SDK-owned snapshot.
+
+#### Type Parameters
+
+| Type Parameter |
+| -------------- |
+| `T`            |
+
+#### Methods
+
+##### get()
+
+```ts
+get(): T;
+```
+
+The current value; always available, even before any subscription.
+
+###### Returns
+
+`T`
+
+##### subscribe()
+
+```ts
+subscribe(listener): Disposer;
+```
+
+Call `listener` on every change until the returned Disposer runs. Does not emit
+the current value immediately on subscribe.
+
+###### Parameters
+
+| Parameter  | Type                |
+| ---------- | ------------------- |
+| `listener` | (`value`) => `void` |
+
+###### Returns
+
+[`Disposer`](#disposer)
+
+---
+
+### HostUi
+
+```ts
+type HostUi = object;
+```
+
+Deliberately narrow shell affordances; domain work belongs to capabilities.
+
+#### Methods
+
+##### requestComputerChoice()
+
+```ts
+requestComputerChoice(): Promise<void>;
+```
+
+Open the host-owned Computer picker; selection arrives through App context.
+
+###### Returns
+
+`Promise`\<`void`\>
+
+##### requestBrowserAction()
+
+```ts
+requestBrowserAction(input): Promise<AppBrowserActionOutcome>;
+```
+
+Request a host browser action from a fresh user click in this App.
+
+###### Parameters
+
+| Parameter | Type                                    |
+| --------- | --------------------------------------- |
+| `input`   | [`AppBrowserAction`](#appbrowseraction) |
+
+###### Returns
+
+`Promise`\<[`AppBrowserActionOutcome`](#appbrowseractionoutcome)\>
+
+##### requestAppPermissions()
+
+```ts
+requestAppPermissions(input): Promise<AppPermissionOutcome>;
+```
+
+Ask the trusted host for App rights. The host, never the App, renders the
+consent and writes any grant; an empty request opens App permissions.
+
+###### Parameters
+
+| Parameter | Type                                            |
+| --------- | ----------------------------------------------- |
+| `input`   | [`AppPermissionRequest`](#apppermissionrequest) |
+
+###### Returns
+
+`Promise`\<[`AppPermissionOutcome`](#apppermissionoutcome)\>
+
+##### openNavigation()
+
+```ts
+openNavigation(input): Promise<void>;
+```
+
+Ask the host to open an already admitted Computer file.
+
+###### Parameters
+
+| Parameter | Type                                          |
+| --------- | --------------------------------------------- |
+| `input`   | [`FileNavigationInput`](#filenavigationinput) |
+
+###### Returns
+
+`Promise`\<`void`\>
+
+##### reportStatus()
+
+```ts
+reportStatus(items): Promise<void>;
+```
+
+Declare this window's status bar items, such as "2 documents" or a Ports button.
+The host renders them beside the Computer it owns; the newest report wins and an
+empty list clears them.
+
+###### Parameters
+
+| Parameter | Type                                         |
+| --------- | -------------------------------------------- |
+| `items`   | readonly [`AppStatusItem`](#appstatusitem)[] |
+
+###### Returns
+
+`Promise`\<`void`\>
+
+##### onStatusAction()
+
+```ts
+onStatusAction(handler): () => void;
+```
+
+Hear the person use one of this window's declared status items. One owner at a
+time; the host never renders App UI in its chrome.
+
+###### Parameters
+
+| Parameter | Type                                                |
+| --------- | --------------------------------------------------- |
+| `handler` | [`AppStatusActionHandler`](#appstatusactionhandler) |
+
+###### Returns
+
+() => `void`
+
+##### openTeamBilling()
+
+```ts
+openTeamBilling(): Promise<void>;
+```
+
+Leave the App for the host's Billing page for this Team.
+
+###### Returns
+
+`Promise`\<`void`\>
+
+##### openDesktopSettings()
+
+```ts
+openDesktopSettings(): Promise<void>;
+```
+
+Suggest this App's desktop Gills while focused with browser activation. The host
+shows a notice; the member must choose Review to open Settings. The App receives
+no layout or placement authority.
+
+###### Returns
+
+`Promise`\<`void`\>
+
+##### reportAgentSessionSelection()
+
+```ts
+reportAgentSessionSelection(selection): Promise<void>;
+```
+
+Tell the host which Agent conversation this App currently has selected, or null
+when none is selected.
+
+###### Parameters
+
+| Parameter   | Type                                                                         |
+| ----------- | ---------------------------------------------------------------------------- |
+| `selection` | \| `Readonly`\<\{ `agentId`: `string`; `sessionId`: `string`; \}\> \| `null` |
+
+###### Returns
+
+`Promise`\<`void`\>
+
+##### showToast()
+
+```ts
+showToast(input): Promise<void>;
+```
+
+Ask the host to show a transient toast notification.
+
+###### Parameters
+
+| Parameter | Type                        |
+| --------- | --------------------------- |
+| `input`   | [`ToastInput`](#toastinput) |
+
+###### Returns
+
+`Promise`\<`void`\>
+
+---
+
+### AppStatusIcon
+
+```ts
+type AppStatusIcon = "folder" | "ports" | "processes" | "access";
+```
+
+The marks a host can draw before a status button's label.
+
+---
+
+### AppStatusTone
+
+```ts
+type AppStatusTone = "neutral" | "success" | "warning" | "error";
+```
+
+A readout's live state, shown as a small light before its text.
+
+---
+
+### AppStatusOption
+
+```ts
+type AppStatusOption = Readonly<{
+  id: string;
+  text: string;
+  checked?: boolean;
+  disabled?: boolean;
+}>;
+```
+
+One choice in a status menu, such as a folder or a port.
+
+---
+
+### AppStatusItem
+
+```ts
+type AppStatusItem =
+  | Readonly<{
+      id: string;
+      text: string;
+      end?: boolean;
+      kind: "text";
+      tone?: AppStatusTone;
+    }>
+  | Readonly<{
+      id: string;
+      text: string;
+      end?: boolean;
+      kind: "button";
+      icon?: AppStatusIcon;
+      count?: number;
+      title?: string;
+      disabled?: boolean;
+      opens?: "dialog";
+      expanded?: boolean;
+    }>
+  | Readonly<{
+      id: string;
+      text: string;
+      end?: boolean;
+      kind: "toggle";
+      pressed: boolean;
+    }>
+  | Readonly<{
+      id: string;
+      text: string;
+      end?: boolean;
+      kind: "menu";
+      count?: number;
+      title?: string;
+      options: readonly AppStatusOption[];
+    }>;
+```
+
+One item an App declares for its window's status bar, as data: a readout, a
+button, a toggle, or a menu of choices. Using one delivers an
+[AppStatusAction](#appstatusaction) back to the App.
+
+---
+
+### AppStatusAction
+
+```ts
+type AppStatusAction = Readonly<{
+  itemId: string;
+  optionId?: string;
+  anchor?: Readonly<{
+    start: number;
+    width: number;
+  }>;
+}>;
+```
+
+The person used a status item; `optionId` names a chosen menu option. `anchor`
+is where the item sits along the App's surface, in CSS pixels from its inline
+start, so App UI it opens can sit above it.
+
+---
+
+### AppStatusActionHandler
+
+```ts
+type AppStatusActionHandler = (action) => boolean | Promise<boolean>;
+```
+
+Handles one status action; `true` when the App acted on it.
+
+#### Parameters
+
+| Parameter | Type                                  |
+| --------- | ------------------------------------- |
+| `action`  | [`AppStatusAction`](#appstatusaction) |
+
+#### Returns
+
+`boolean` \| `Promise`\<`boolean`\>
+
+---
+
+### AgentSessionSelection
+
+```ts
+type AgentSessionSelection = Readonly<{
+  agentId: string;
+  sessionId: string;
+}>;
+```
+
+Exact Agent conversation selected by an App for the authenticated shell.
+
+---
+
+### FileNavigationInput
+
+```ts
+type FileNavigationInput = object;
+```
+
+A presentation-neutral request to open an already admitted Computer file.
+
+#### Properties
+
+##### computerId
+
+```ts
+readonly computerId: string;
+```
+
+##### path
+
+```ts
+readonly path: string;
+```
+
+---
+
+### ToastInput
+
+```ts
+type ToastInput = object;
+```
+
+A transient notification an App asks its host to show.
+
+#### Properties
+
+##### message
+
+```ts
+readonly message: string;
+```
+
+##### tone?
+
+```ts
+readonly optional tone?: "error" | "info" | "success" | "warning";
+```
+
+---
+
+### AgentAccessOperation
+
+```ts
+type AgentAccessOperation =
+  "agent.list" | "agent.manage" | "agent.read" | "agent.send";
+```
+
+Agent rights an App may ask its host to grant through consent.
+
+---
+
+### ComputerAccessOperation
+
+```ts
+type ComputerAccessOperation =
+  | "computer.list"
+  | "computer.readFile"
+  | "computer.writeFile"
+  | "computer.execute";
+```
+
+Computer rights an App may ask its host to grant through consent.
+
+---
+
+### AppPermissionRequest
+
+```ts
+type AppPermissionRequest = Readonly<{
+  agents?: readonly AgentAccessOperation[];
+  computers?: readonly ComputerAccessOperation[];
+}>;
+```
+
+The rights an App asks for; the host bounds them by its declared ceiling.
+
+---
+
+### AppPermissionOutcome
+
+```ts
+type AppPermissionOutcome = "granted" | "declined" | "customize";
+```
+
+`granted`: the host saved a grant covering the request. `declined`: the user
+said not now. `customize`: the host opened its full permission settings.
+
+---
+
+### AppBrowserAction
+
+```ts
+type AppBrowserAction =
+  | Readonly<{
+      kind: "saveFile";
+      name: string;
+      mime: string;
+      bytes: Uint8Array;
+    }>
+  | Readonly<{
+      kind: "copyText";
+      text: string;
+    }>;
+```
+
+Data only; browser authority and the gesture check belong to the host.
+
+---
+
+### AppBrowserActionRefusal
+
+```ts
+type AppBrowserActionRefusal = Readonly<{
+  kind: "refused";
+  reason:
+    | "no-user-gesture"
+    | "too-large"
+    | "invalid-request"
+    | "unavailable"
+    | "denied"
+    | "busy";
+}>;
+```
+
+A browser action can be refused without disconnecting the App.
+
+---
+
+### AppBrowserActionOutcome
+
+```ts
+type AppBrowserActionOutcome =
+  | Readonly<{
+      kind: "saved";
+    }>
+  | Readonly<{
+      kind: "copied";
+    }>
+  | AppBrowserActionRefusal;
+```
+
+Saved means a browser download was initiated, not a confirmed disk write.
+
+---
+
+### BeforeAppClose
+
+```ts
+type BeforeAppClose = () => boolean | Promise<boolean>;
+```
+
+Consulted before the person closes the App's window; return (or resolve) `true`
+to allow the close.
+
+#### Returns
+
+`boolean` \| `Promise`\<`boolean`\>
+
+---
+
+### AppNavigationState
+
+```ts
+type AppNavigationState = Readonly<{
+  canGoBack: boolean;
+  title?: string;
+}>;
+```
+
+What the App's own router can do right now. The App owns its history; the host
+only offers a Back affordance and relays the person's request.
+
+---
+
+### AppBackHandler
+
+```ts
+type AppBackHandler = () => boolean | Promise<boolean>;
+```
+
+Go back one step in the App's own history; `true` when it moved.
+
+#### Returns
+
+`boolean` \| `Promise`\<`boolean`\>
+
+---
+
+### HostNavigation
+
+```ts
+type HostNavigation = Readonly<{
+  publish: Promise<void>;
+  onBack: Disposer;
+}>;
+```
+
+The App's half of the host navigation contract.
+
+---
+
+### AppWindow
+
+```ts
+type AppWindow = Readonly<{
+  onBeforeClose: Disposer;
+  navigation: HostNavigation;
+}>;
+```
+
+App-owned presentation policy consulted before a user closes its window.
+
+## Variables
+
+### FungiAuthorSchema
+
+```ts
+const FungiAuthorSchema: ZodObject<
+  {
+    id: ZodString;
+    name: ZodString;
+  },
+  $strict
+>;
+```
+
+Who a Session line came from, as the admitting host authenticated them.
+
+---
+
+### FungiDelegationReplySchema
+
+```ts
+const FungiDelegationReplySchema: ZodObject<
+  {
+    agentId: ZodString;
+    sessionId: ZodString;
+    commandId: ZodString;
+    outcome: ZodEnum<{
+      completed: "completed";
+      failed: "failed";
+      interrupted: "interrupted";
+      cancelled: "cancelled";
+      outcome_unknown: "outcome_unknown";
+    }>;
+    diagnostic: ZodOptional<ZodString>;
+  },
+  $strict
+>;
+```
+
+A delegated Agent's reply as the admitting host authenticated it against the
+mail it sent. `commandId` is the replying Session's accepted command, the same
+id as the sender's `agents.send` receipt.
+
+---
+
+### FungiMessageMetaSchema
+
+```ts
+const FungiMessageMetaSchema: ZodObject<
+  {
+    author: ZodOptional<
+      ZodObject<
+        {
+          id: ZodString;
+          name: ZodString;
+        },
+        $strict
+      >
+    >;
+    delegation: ZodOptional<
+      ZodObject<
+        {
+          ancestors: ZodArray<ZodString>;
+          maxDepth: ZodNumber;
+          reply: ZodOptional<
+            ZodObject<
+              {
+                agentId: ZodString;
+                sessionId: ZodString;
+                commandId: ZodString;
+                outcome: ZodEnum<{
+                  completed: "completed";
+                  failed: "failed";
+                  interrupted: "interrupted";
+                  cancelled: "cancelled";
+                  outcome_unknown: "outcome_unknown";
+                }>;
+                diagnostic: ZodOptional<ZodString>;
+              },
+              $strict
+            >
+          >;
+        },
+        $strict
+      >
+    >;
+  },
+  $strict
+>;
+```
+
+The metadata the host attaches to every prompt and operator line it admits.
+Shiitake stores it opaquely; the host writes it and Apps read it.
+
+---
+
+### appAgentSchema
+
+```ts
+const appAgentSchema: Struct<{
+  agentId: String;
+  name: String;
+  sessionOperations: $Array<
+    Literals<readonly ["agent.read", "agent.send", "agent.manage"]>
+  >;
+}>;
+```
+
+Validates the wire shape of an Agent record: its id, display name, and which
+session operations (read, send, manage) this App may perform on it.
+
+---
+
+### appAgentCreateInputSchema
+
+```ts
+const appAgentCreateInputSchema: Struct<{
+  name: String;
+  requestId: String;
+  computer: optionalKey<Literals<readonly ["new", "none"]>>;
+}>;
+```
+
+Validates Agent creation input: a name, a caller-chosen request id and an
+optional Computer provisioning choice.
+
+---
+
+### agentList
+
+```ts
+const agentList: CapabilityContract<AppAgentListHandle>;
+```
+
+Capability to list the Agents visible to this App in read-only form.
+
+---
+
+### agentManage
+
+```ts
+const agentManage: CapabilityContract<
+  Pick<AppAgentDirectoryHandle, "create" | "open">
+>;
+```
+
+Capability to create new Agents and open transports to them.
+
+---
+
+### appAgentRenameInputSchema
+
+```ts
+const appAgentRenameInputSchema: Struct<{
+  agentId: String;
+  name: String;
+}>;
+```
+
+Validates Agent rename input: the target Agent and its new display name.
+
+---
+
+### agentRename
+
+```ts
+const agentRename: CapabilityContract<AppAgentRenameHandle>;
+```
+
+Owner-only capability to rename an existing Agent; not every host grants it.
+
+---
+
+### appAgentToolPolicyStatusSchema
+
+```ts
+const appAgentToolPolicyStatusSchema: ZodUnion<
+  readonly [
+    ZodObject<
+      {
+        status: ZodLiteral<"pending">;
+        revision: ZodString;
+      },
+      $strip
+    >,
+    ZodObject<
+      {
+        status: ZodLiteral<"approved">;
+        revision: ZodString;
+      },
+      $strip
+    >,
+  ]
+>;
+```
+
+One Agent's App-tool policy, as the owner-only policy capability reports it.
+
+---
+
+### appAgentToolPolicyResultSchema
+
+```ts
+const appAgentToolPolicyResultSchema: ZodUnion<
+  readonly [
+    ZodUnion<
+      readonly [
+        ZodObject<
+          {
+            status: ZodLiteral<"pending">;
+            revision: ZodString;
+          },
+          $strip
+        >,
+        ZodObject<
+          {
+            status: ZodLiteral<"approved">;
+            revision: ZodString;
+          },
+          $strip
+        >,
+      ]
+    >,
+    ZodObject<
+      {
+        error: ZodString;
+      },
+      $strip
+    >,
+  ]
+>;
+```
+
+The outcome of an owner's direct App-tool approval.
+
+---
+
+### agentToolPolicy
+
+```ts
+const agentToolPolicy: CapabilityContract<AppAgentToolPolicyHandle>;
+```
+
+Owner-only capability to read and approve an Agent's App-tool policy.
+
+---
+
+### agentSessionRead
+
+```ts
+const agentSessionRead: CapabilityContract<
+  Pick<AppAgentDirectoryHandle, "open" | "openInbox">
+>;
+```
+
+Capability for read-only Agent sessions: open a transport to an existing Agent,
+or read the member's inbox feed.
+
+---
+
+### agentSessionWrite
+
+```ts
+const agentSessionWrite: CapabilityContract<
+  Pick<AppAgentDirectoryHandle, "open" | "openInbox">
+>;
+```
+
+Capability for read-write Agent sessions: open a transport to an existing Agent
+and send to it, including the member's inbox feed.
+
+---
+
+### APP\_PROTOCOL\_VERSION
+
+```ts
+const APP_PROTOCOL_VERSION: 2;
+```
+
+The iframe handshake version both App and host must speak.
+
+---
+
+### APP\_READY\_TYPE
+
+```ts
+const APP_READY_TYPE: "fungi.app.ready";
+```
+
+Message type the App iframe posts to announce it is ready to connect.
+
+---
+
+### APP\_CONNECT\_TYPE
+
+```ts
+const APP_CONNECT_TYPE: "fungi.app.connect";
+```
+
+Message type the host posts to hand the App its RPC MessagePort.
+
+---
+
+### parseAppStatusItems
+
+```ts
+const parseAppStatusItems: (...a) => readonly AppStatusItem[];
+```
+
+Both edges: one window's status items, bounded and copied.
+
+#### Parameters
+
+| Parameter | Type                          |
+| --------- | ----------------------------- |
+| ...`a`    | \[`unknown`, `ParseOptions`\] |
+
+#### Returns
+
+readonly [`AppStatusItem`](#appstatusitem)[]
+
+---
+
+### parseAppStatusAction
+
+```ts
+const parseAppStatusAction: (...a) => C;
+```
+
+App edge: the status item the person used, as the host relays it.
+
+#### Parameters
+
+| Parameter | Type                          |
+| --------- | ----------------------------- |
+| ...`a`    | \[`unknown`, `ParseOptions`\] |
+
+#### Returns
+
+`C`
+
+---
+
+### mediaGenerationReferenceSchema
+
+```ts
+const mediaGenerationReferenceSchema: Struct<{
+  requestId: String;
+  computerId: String;
+}>;
+```
+
+A replay identity, never an authorization capability.
+
+---
+
+### mediaModelSchema
+
+```ts
+const mediaModelSchema: Struct<{
+  id: String;
+  input: Struct<{
+    defaultHeight: Number;
+    defaultSteps: NullOr<Number>;
+    defaultWidth: Number;
+    dimensions: Literals<readonly ["none", "own"]>;
+    maxDimension: NullOr<Number>;
+    maxReferences: Number;
+    maxSteps: NullOr<Number>;
+    referenceField: NullOr<String>;
+    steps: Literals<readonly ["steps", "num_steps", "fixed"]>;
+    transport: Literals<readonly ["json", "multipart"]>;
+  }>;
+  kind: Literals<readonly ["image", "video"]>;
+  label: String;
+  tier: Literals<readonly ["draft", "balanced", "premium", "max"]>;
+  outputFormats: $Array<Literals<readonly ["png", "jpeg", "webp"]>>;
+  sizes: NullOr<$Array<String>>;
+  video: NullOr<
+    Struct<{
+      minSeconds: Number;
+      maxSeconds: Number;
+      defaultSeconds: Number;
+      durations: $Array<Number>;
+      provider: Literals<readonly ["seedance", "veo", "minimax"]>;
+      formats: $Array<
+        Struct<{
+          resolution: Literals<
+            readonly ["480p", "720p", "768p", "1080p", "4k"]
+          >;
+          aspectRatio: Literals<
+            readonly ["16:9", "4:3", "1:1", "3:4", "9:16", "21:9", "9:21"]
+          >;
+          width: Number;
+          height: Number;
+        }>
+      >;
+      defaultResolution: Literals<
+        readonly ["480p", "720p", "768p", "1080p", "4k"]
+      >;
+      defaultAspectRatio: Literals<
+        readonly ["16:9", "4:3", "1:1", "3:4", "9:16", "21:9", "9:21"]
+      >;
+      defaultGenerateAudio: NullOr<Boolean>;
+      maxPromptLength: Number;
+      referenceRoles: $Array<
+        Literals<readonly ["first-frame", "last-frame", "reference"]>
+      >;
+      maxReferenceImages: Number;
+      referenceResolutions: $Array<
+        Literals<readonly ["480p", "720p", "768p", "1080p", "4k"]>
+      >;
+      prices: $Array<
+        Struct<{
+          resolution: Literals<
+            readonly ["480p", "720p", "768p", "1080p", "4k"]
+          >;
+          silentMilliunitsPerSecond: Number;
+          audioMilliunitsPerSecond: Number;
+        }>
+      >;
+    }>
+  >;
+}>;
+```
+
+Validates one model row of the host's Media catalog.
+
+---
+
+### mediaGenerationSelectionSchema
+
+```ts
+const mediaGenerationSelectionSchema: Struct<{
+  model: String;
+  prompt: String;
+  width: Number;
+  height: Number;
+  steps: optional<Number>;
+  durationSeconds: optional<Number>;
+  resolution: optional<
+    Literals<readonly ["480p", "720p", "768p", "1080p", "4k"]>
+  >;
+  aspectRatio: optional<
+    Literals<readonly ["16:9", "4:3", "1:1", "3:4", "9:16", "21:9", "9:21"]>
+  >;
+  generateAudio: optional<Boolean>;
+  references: optional<
+    $Array<
+      Struct<{
+        path: String;
+        role: optional<
+          Literals<readonly ["first-frame", "last-frame", "reference"]>
+        >;
+      }>
+    >
+  >;
+}>;
+```
+
+Validates the shape of an App's generation settings. Model-specific limits
+(sizes, steps, durations, reference counts) and defaults are the host's: it
+checks the selection against its catalog when it accepts a generation.
+
+---
+
+### mediaGenerationFailureSchema
+
+```ts
+const mediaGenerationFailureSchema: Struct<{
+  message: String;
+  stage: optional<
+    Literals<
+      readonly [
+        "admission",
+        "generation-authorization",
+        "settings",
+        "estimate",
+        "billing",
+        "operation",
+        "provider",
+        "normalization",
+        "artifact",
+        "destination-authorization",
+        "destination-write",
+      ]
+    >
+  >;
+  code: Literals<
+    readonly [
+      "CANCELLED",
+      "CAPABILITY_DENIED",
+      "CAPABILITY_REVOKED",
+      "DISCONNECTED",
+      "HOST_FAILURE",
+      "IDENTITY",
+      "INSUFFICIENT_CREDIT",
+      "INVALID_ARGUMENT",
+      "PROTOCOL",
+      "SAFETY_FILTER_REFUSED",
+      "TIMEOUT",
+    ]
+  >;
+  retryable: Boolean;
+}>;
+```
+
+Validates the typed failure a host reports for a generation attempt.
+
+---
+
+### mediaGeneration
+
+```ts
+const mediaGeneration: CapabilityContract<MediaGenerationHandle>;
+```
+
+Capability contract for generating Media (images or video). Apps declare it to
+request access; openMediaGeneration uses it to obtain the host's handle.
+
+---
+
+### pendingSchema
+
+```ts
+const pendingSchema: ZodObject<
+  {
+    kind: ZodLiteral<"pending">;
+    retryAfterMs: ZodNumber;
+  },
+  $strict
+>;
+```
+
+An opted-in App method is still working; poll again after this bounded delay.
+
+---
+
+### APP\_STATUS\_ITEMS\_MAX
+
+```ts
+const APP_STATUS_ITEMS_MAX: 6 = 6;
+```
+
+The most readouts one App window's status bar shows.
+
+---
+
+### APP\_STATUS\_TEXT\_MAX
+
+```ts
+const APP_STATUS_TEXT_MAX: 80 = 80;
+```
+
+The longest readout a window's status bar shows.
+
+---
+
+### APP\_STATUS\_OPTIONS\_MAX
+
+```ts
+const APP_STATUS_OPTIONS_MAX: 16 = 16;
+```
+
+The most choices one status menu offers.
+
+---
+
+### APP\_BROWSER\_SAVE\_MAX\_BYTES
+
+```ts
+const APP_BROWSER_SAVE_MAX_BYTES: number;
+```
+
+Maximum file size sent through the user-initiated host browser door.
+
+---
+
+### APP\_BROWSER\_COPY\_MAX\_BYTES
+
+```ts
+const APP_BROWSER_COPY_MAX_BYTES: number;
+```
+
+Maximum UTF-8 text size sent to the host clipboard.
+
+---
+
+### APP\_NAVIGATION\_CONTRACT\_VERSION
+
+```ts
+const APP_NAVIGATION_CONTRACT_VERSION: 1;
+```
+
+Version of the navigation contract an App publishes. The host rejects any other
+version, so a future shape can never be misread as this one.
+
+---
+
+### APP\_NAVIGATION\_TITLE\_MAX
+
+```ts
+const APP_NAVIGATION_TITLE_MAX: 80 = 80;
+```
+
+The longest page title a host shows beside the App's own name.
+
+---
+
+### inertHostNavigation
+
+```ts
+const inertHostNavigation: HostNavigation;
+```
+
+Navigation for a root with no host chrome, such as a workbench fixture: it
+accepts every report and never asks the App to go back.
+
+## Functions
+
+### messageAuthor()
+
+```ts
+function messageAuthor(meta):
+  | {
+      id: string;
+      name: string;
+    }
+  | undefined;
+```
+
+The author a message's metadata names; none for anything else.
+
+#### Parameters
+
+| Parameter | Type                                                   |
+| --------- | ------------------------------------------------------ |
+| `meta`    | [`MessageMetaValue`](#messagemetavalue) \| `undefined` |
+
+#### Returns
+
+\| \{ `id`: `string`; `name`: `string`; \} \| `undefined`
+
+---
+
+### messageDelegationReply()
+
+```ts
+function messageDelegationReply(meta):
+  | {
+      agentId: string;
+      sessionId: string;
+      commandId: string;
+      outcome:
+        | "completed"
+        | "failed"
+        | "interrupted"
+        | "cancelled"
+        | "outcome_unknown";
+      diagnostic?: string;
+    }
+  | undefined;
+```
+
+The authenticated delegation reply a message's metadata carries; none for any
+other line, including text that merely looks like a reply.
+
+#### Parameters
+
+| Parameter | Type                                                   |
+| --------- | ------------------------------------------------------ |
+| `meta`    | [`MessageMetaValue`](#messagemetavalue) \| `undefined` |
+
+#### Returns
+
+##### Type Literal
+
+```ts
+{
+  agentId: string;
+  sessionId: string;
+  commandId: string;
+  outcome: "completed" | "failed" | "interrupted" | "cancelled" | "outcome_unknown";
+  diagnostic?: string;
+}
+```
+
+| Name          | Type                                                                                   | Default value | Description                                                              |
+| ------------- | -------------------------------------------------------------------------------------- | ------------- | ------------------------------------------------------------------------ |
+| `agentId`     | `string`                                                                               | `identifier`  | -                                                                        |
+| `sessionId`   | `string`                                                                               | `identifier`  | -                                                                        |
+| `commandId`   | `string`                                                                               | `identifier`  | -                                                                        |
+| `outcome`     | `"completed"` \| `"failed"` \| `"interrupted"` \| `"cancelled"` \| `"outcome_unknown"` | -             | The exact settlement outcome; failures are never collapsed.              |
+| `diagnostic?` | `string`                                                                               | -             | Bounded, single-line terminal diagnostic for work that did not complete. |
+
+---
+
+`undefined`
+
+---
+
+### authorMeta()
+
+```ts
+function authorMeta(author): AuthorMeta;
+```
+
+The metadata the host attaches for one authenticated author.
+
+#### Parameters
+
+| Parameter     | Type                                    |
+| ------------- | --------------------------------------- |
+| `author`      | \{ `id`: `string`; `name`: `string`; \} |
+| `author.id`   | `string`                                |
+| `author.name` | `string`                                |
+
+#### Returns
+
+[`AuthorMeta`](#authormeta)
+
+---
+
+### renameAppAgent()
+
+```ts
+function renameAppAgent(
+  capabilities,
+  input,
+): Promise<{
+  agentId: string;
+  name: string;
+  sessionOperations: readonly ("agent.manage" | "agent.read" | "agent.send")[];
+}>;
+```
+
+Rename an Agent through the host-granted owner-only capability.
+
+#### Parameters
+
+| Parameter      | Type                                          |
+| -------------- | --------------------------------------------- |
+| `capabilities` | [`CapabilityDirectory`](#capabilitydirectory) |
+| `input`        | [`AppAgentRenameInput`](#appagentrenameinput) |
+
+#### Returns
+
+`Promise`\<\{ `agentId`: `string`; `name`: `string`; `sessionOperations`:
+readonly (`"agent.manage"` \| `"agent.read"` \| `"agent.send"`)[]; \}\>
+
+---
+
+### listAppAgents()
+
+```ts
+function listAppAgents(capabilities): Promise<readonly object[]>;
+```
+
+List the Agents in the host-granted Team or local-project scope.
+
+#### Parameters
+
+| Parameter      | Type                                          |
+| -------------- | --------------------------------------------- |
+| `capabilities` | [`CapabilityDirectory`](#capabilitydirectory) |
+
+#### Returns
+
+`Promise`\<readonly `object`[]\>
+
+---
+
+### createAppAgent()
+
+```ts
+function createAppAgent(
+  capabilities,
+  input,
+): Promise<{
+  agentId: string;
+  name: string;
+  sessionOperations: readonly ("agent.manage" | "agent.read" | "agent.send")[];
+}>;
+```
+
+Create an Agent through the Team directory selected by the host.
+
+#### Parameters
+
+| Parameter      | Type                                          |
+| -------------- | --------------------------------------------- |
+| `capabilities` | [`CapabilityDirectory`](#capabilitydirectory) |
+| `input`        | [`AppAgentCreateInput`](#appagentcreateinput) |
+
+#### Returns
+
+`Promise`\<\{ `agentId`: `string`; `name`: `string`; `sessionOperations`:
+readonly (`"agent.manage"` \| `"agent.read"` \| `"agent.send"`)[]; \}\>
+
+---
+
+### openAppAgent()
+
+```ts
+function openAppAgent(
+  capabilities,
+  input,
+): Promise<
+  Readonly<{
+    baseUrl: string;
+    fetch: {
+      (input, init?): Promise<Response>;
+      (input, init?): Promise<Response>;
+    };
+    close: () => Promise<void>;
+  }>
+>;
+```
+
+Adapt one live object capability to Fetch without exposing the parent's
+authenticated URL or credentials to the isolated App.
+
+#### Parameters
+
+| Parameter       | Type                                          |
+| --------------- | --------------------------------------------- |
+| `capabilities`  | [`CapabilityDirectory`](#capabilitydirectory) |
+| `input`         | \{ `agentId`: `string`; \}                    |
+| `input.agentId` | `string`                                      |
+
+#### Returns
+
+`Promise`\<`Readonly`\<\{ `baseUrl`: `string`; `fetch`: \{ (`input`, `init?`):
+`Promise`\<`Response`\>; (`input`, `init?`): `Promise`\<`Response`\>; \};
+`close`: () => `Promise`\<`void`\>; \}\>\>
+
+---
+
+### defineCapability()
+
+```ts
+function defineCapability<T>(id, version, schema): CapabilityContract<T>;
+```
+
+Define a capability with the owner's decoder for its live RPC interface.
+
+#### Type Parameters
+
+| Type Parameter |
+| -------------- |
+| `T`            |
+
+#### Parameters
+
+| Parameter | Type             |
+| --------- | ---------------- |
+| `id`      | `string`         |
+| `version` | `number`         |
+| `schema`  | `ZodType`\<`T`\> |
+
+#### Returns
+
+[`CapabilityContract`](#capabilitycontract)\<`T`\>
+
+---
+
+### createCapabilityRegistry()
+
+```ts
+function createCapabilityRegistry(): CapabilityRegistry;
+```
+
+Register typed local implementations without reopening their erased types.
+
+#### Returns
+
+[`CapabilityRegistry`](#capabilityregistry)
+
+---
+
+### registerCatalog()
+
+```ts
+function registerCatalog(commands, catalog): Disposer;
+```
+
+Register one App's Whistle catalog with its host. An App defines each command
+once, contributes the same catalog to its own composer runtime for slash
+commands, and registers it here so the shell projects it into the palette,
+menus, keys and the agent view. Availability is read once at registration;
+register again to publish a change.
+
+#### Parameters
+
+| Parameter  | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Description                                    |
+| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
+| `commands` | [`AppCommands`](#appcommands)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | The App's host command door, `app.commands`.   |
+| `catalog`  | 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 App's Whistle commands, handlers included. |
+
+#### Returns
+
+[`Disposer`](#disposer)
+
+Release every registration made by this call.
+
+---
+
+### connectApp()
+
+```ts
+function connectApp(options): Promise<AppRoot>;
+```
+
+Connects this iframe page to its authenticated host.
+
+#### Parameters
+
+| Parameter | Type                                      |
+| --------- | ----------------------------------------- |
+| `options` | [`ConnectAppOptions`](#connectappoptions) |
+
+#### Returns
+
+`Promise`\<[`AppRoot`](#approot)\>
+
+---
+
+### openMediaGeneration()
+
+```ts
+function openMediaGeneration(capabilities): Promise<
+  Readonly<{
+    computerId: string;
+    canGenerate: boolean;
+    models: readonly object[];
+    createAttempt: Promise<MediaGenerationAttempt>;
+    restoreAttempt: Promise<MediaGenerationAttempt>;
+  }>
+>;
+```
+
+Discover the exact retained model catalog surfaced by the owner.
+
+#### Parameters
+
+| Parameter      | Type                                          |
+| -------------- | --------------------------------------------- |
+| `capabilities` | [`CapabilityDirectory`](#capabilitydirectory) |
+
+#### Returns
+
+`Promise`\<`Readonly`\<\{ `computerId`: `string`; `canGenerate`: `boolean`;
+`models`: readonly `object`[]; `createAttempt`:
+`Promise`\<[`MediaGenerationAttempt`](#mediagenerationattempt)\>;
+`restoreAttempt`:
+`Promise`\<[`MediaGenerationAttempt`](#mediagenerationattempt)\>; \}\>\>
+
+---
+
+### pending()
+
+```ts
+function pending(retryAfterMs): Pending;
+```
+
+Return Pending with a polling delay between one and sixty seconds.
+
+#### Parameters
+
+| Parameter      | Type     |
+| -------------- | -------- |
+| `retryAfterMs` | `number` |
+
+#### Returns
+
+[`Pending`](#pending)
+
+---
+
+### statusText()
+
+```ts
+function statusText(value, max?): string;
+```
+
+Make person- or Computer-supplied text fit one status item: drop unsafe
+characters, collapse whitespace and shorten with an ellipsis.
+
+#### Parameters
+
+| Parameter | Type     | Default value         |
+| --------- | -------- | --------------------- |
+| `value`   | `string` | `undefined`           |
+| `max`     | `number` | `APP_STATUS_TEXT_MAX` |
+
+#### Returns
+
+`string`
+
+---
+
+### statusActionAllowed()
+
+```ts
+function statusActionAllowed(items, action): boolean;
+```
+
+Whether an action names something the App declares now: an enabled item, and for
+a menu exactly one enabled option. Every hop that delivers an action applies
+this rule against its own latest copy of the items.
+
+#### Parameters
+
+| Parameter | Type                                         |
+| --------- | -------------------------------------------- |
+| `items`   | readonly [`AppStatusItem`](#appstatusitem)[] |
+| `action`  | [`AppStatusAction`](#appstatusaction)        |
+
+#### Returns
+
+`boolean`
+
+## References
+
+### AppError
+
+Re-exports [AppError](errors.md#apperror)
+
+---
+
+### AppErrorCode
+
+Re-exports [AppErrorCode](errors.md#apperrorcode)
+
+---
+
+### AppErrorOptions
+
+Re-exports [AppErrorOptions](errors.md#apperroroptions)
+
+---
+
+### appStorage
+
+Re-exports [appStorage](storage.md#appstorage-1)
+
+---
+
+### AppStorageError
+
+Re-exports [AppStorageError](storage.md#appstorageerror)
+
+---
+
+### AppStorage
+
+Re-exports [AppStorage](storage.md#appstorage)
+
+---
+
+### AppStorageWatch
+
+Re-exports [AppStorageWatch](storage.md#appstoragewatch)
+
+---
+
+### AppStorageWrite
+
+Re-exports [AppStorageWrite](storage.md#appstoragewrite)
+
+---
+
+### AppStorageReset
+
+Re-exports [AppStorageReset](storage.md#appstoragereset)
+
+---
+
+### ResolvedAppStorage
+
+Re-exports [ResolvedAppStorage](storage.md#resolvedappstorage)