@fungi.computer/agar 0.3.1 → 0.5.0

package/dist/agent-message-meta.d.ts

@@ -24,6 +24,11 @@ export declare const FungiDelegationReplySchema: z.ZodLazy<z.ZodObject<{
         outcome_unknown: "outcome_unknown";
     }>;
     diagnostic: z.ZodOptional<z.ZodString>;
+    waitingOnYou: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        itemId: z.ZodLazy<z.ZodString>;
+        kind: z.ZodString;
+        summary: z.ZodString;
+    }, z.core.$strict>>>;
 }, z.core.$strict>>;
 /** A delegated Agent's reply as the admitting host authenticated it. */
 export type FungiDelegationReply = z.infer<typeof FungiDelegationReplySchema>;
@@ -41,6 +46,7 @@ export declare const FungiMessageMetaSchema: z.ZodObject<{
     delegation: z.ZodOptional<z.ZodObject<{
         ancestors: z.ZodArray<z.ZodLazy<z.ZodString>>;
         maxDepth: z.ZodNumber;
+        steer: z.ZodOptional<z.ZodLiteral<true>>;
         reply: z.ZodOptional<z.ZodLazy<z.ZodObject<{
             agentId: z.ZodLazy<z.ZodString>;
             sessionId: z.ZodLazy<z.ZodString>;
@@ -53,6 +59,11 @@ export declare const FungiMessageMetaSchema: z.ZodObject<{
                 outcome_unknown: "outcome_unknown";
             }>;
             diagnostic: z.ZodOptional<z.ZodString>;
+            waitingOnYou: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                itemId: z.ZodLazy<z.ZodString>;
+                kind: z.ZodString;
+                summary: z.ZodString;
+            }, z.core.$strict>>>;
         }, z.core.$strict>>>;
     }, z.core.$strict>>;
 }, z.core.$strict>;

package/dist/agent-message-meta.js

@@ -5,8 +5,8 @@ export const FungiAuthorSchema = z.lazy(() => z.strictObject({
     name: z.string().min(1).max(128),
     /**
      * Present only when the author is another Agent the host admitted a
-     * delegated send or reply from; a line's text never sets it. Human
-     * authors carry no kind.
+     * delegated send or reply from; a line's text never sets it. Human and
+     * host/system authors carry no kind.
      */
     kind: z.literal("agent").optional(),
 }));
@@ -30,6 +30,16 @@ export const FungiDelegationReplySchema = z.lazy(() => z.strictObject({
     ]),
     /** Bounded, single-line terminal diagnostic for work that did not complete. */
     diagnostic: z.string().min(1).max(200).optional(),
+    /** Open items of the replying Session that now wait on the recipient. */
+    waitingOnYou: z
+        .array(z.strictObject({
+        itemId: identifier,
+        kind: z.string().min(1).max(64),
+        summary: z.string().min(1).max(200),
+    }))
+        .min(1)
+        .max(8)
+        .optional(),
 }));
 /**
  * The metadata the host attaches to every prompt and operator line it admits.
@@ -44,6 +54,8 @@ export const FungiMessageMetaSchema = z.strictObject({
         .strictObject({
         ancestors: z.array(identifier).max(8),
         maxDepth: z.number().int().min(1).max(8),
+        /** The sender asked to steer the recipient's running turn, not queue behind it. */
+        steer: z.literal(true).optional(),
         /**
          * Present only on a line the host admitted as an authenticated reply;
          * a line's text never sets it.

package/dist/approvals.js

@@ -1,12 +1,9 @@
 import * as Schema from "effect/Schema";
 import * as z from "zod";
-import { ApprovalViewSchema, ApprovalRefusalReasonSchema, AutoApproveInputSchema, } from "@fungi.computer/approvals";
+import { ApprovalViewSchema, ApprovalRefusalSchema, AutoApproveInputSchema, } from "@fungi.computer/approvals";
 import { defineCapability } from "./capabilities.js";
 import { rpcDataSchema, rpcHandleSchema, rpcMethod, } from "./internal/rpc-contract.js";
-const refusal = Schema.Struct({
-    kind: Schema.Literal("refused"),
-    reason: ApprovalRefusalReasonSchema,
-});
+const refusal = ApprovalRefusalSchema;
 const page = Schema.Struct({
     items: Schema.Array(ApprovalViewSchema),
     nextCursor: Schema.NullOr(Schema.String),

package/dist/errors.d.ts

@@ -34,6 +34,7 @@ export declare function decodeMediaProviderErrorCategory(input: string | undefin
 /** The closed set of reasons an AppError can state; every SDK and
  * host-reported failure is tagged with exactly one of these codes. */
 export declare const appErrorCodes: readonly ["CANCELLED", "CAPABILITY_DENIED", "CAPABILITY_REVOKED", "COMMAND_NOT_DECLARED", "CONFLICT", "DELIVERY_PENDING", "DISCONNECTED", "FILE_TOO_LARGE", "HOST_FAILURE", "IDENTITY", "INSUFFICIENT_CREDIT", "INVALID_ARGUMENT", "PROTOCOL", "SAFETY_FILTER_REFUSED", "SELECTION_CHANGED", "TIMEOUT"];
+/** One closed App error code from `appErrorCodes`. */
 export type AppErrorCode = (typeof appErrorCodes)[number];
 /** One pending-delivery refusal shared by admission and the shell. */
 export type AppDeliveryPending = Readonly<{

package/dist/internal/schemas.js

@@ -123,6 +123,8 @@ const statusItemsSchema = Schema.Array(Schema.Union([
         kind: Schema.Literal("button"),
         icon: Schema.optionalKey(Schema.Literals(["folder", "ports", "processes", "access"])),
         count: statusCount,
+        tone: Schema.optionalKey(Schema.Literals(["neutral", "success", "warning", "error"])),
+        busy: Schema.optionalKey(Schema.Boolean),
         title: Schema.optionalKey(statusText(1_024)),
         disabled: Schema.optionalKey(Schema.Boolean),
         opens: Schema.optionalKey(Schema.Literal("dialog")),

package/dist/media-json.d.ts

@@ -21,6 +21,7 @@ export declare const mediaGenerationDescriptionSchema: Schema.Struct<{
             readonly defaultWidth: Schema.Number;
             readonly dimensions: Schema.Literals<readonly ["none", "own"]>;
             readonly maxDimension: Schema.NullOr<Schema.Number>;
+            readonly maxDimensionDocumented: Schema.Boolean;
             readonly maxReferences: Schema.Number;
             readonly maxSteps: Schema.NullOr<Schema.Number>;
             readonly referenceField: Schema.NullOr<Schema.String>;
@@ -29,6 +30,7 @@ export declare const mediaGenerationDescriptionSchema: Schema.Struct<{
         }>;
         readonly kind: Schema.Literals<readonly ["image", "video"]>;
         readonly label: Schema.String;
+        readonly maxPromptLength: Schema.Number;
         readonly tier: Schema.Literals<readonly ["draft", "balanced", "premium", "max"]>;
         readonly outputFormats: Schema.$Array<Schema.Literals<readonly ["png", "jpeg", "webp"]>>;
         readonly sizes: Schema.NullOr<Schema.$Array<Schema.String>>;
@@ -46,8 +48,8 @@ export declare const mediaGenerationDescriptionSchema: Schema.Struct<{
             }>>;
             readonly defaultResolution: Schema.Literals<readonly ["480p", "720p", "768p", "1080p", "4k"]>;
             readonly defaultAspectRatio: Schema.Literals<readonly ["16:9", "4:3", "1:1", "3:4", "9:16", "21:9", "9:21"]>;
+            readonly supportsAudio: Schema.Boolean;
             readonly defaultGenerateAudio: Schema.NullOr<Schema.Boolean>;
-            readonly maxPromptLength: Schema.Number;
             readonly referenceRoles: Schema.$Array<Schema.Literals<readonly ["first-frame", "last-frame", "reference"]>>;
             readonly maxReferenceImages: Schema.Number;
             readonly referenceResolutions: Schema.$Array<Schema.Literals<readonly ["480p", "720p", "768p", "1080p", "4k"]>>;

package/dist/media.d.ts

@@ -159,10 +159,10 @@ export declare const mediaVideoModelSchema: Schema.Struct<{
     readonly defaultResolution: Schema.Literals<readonly ["480p", "720p", "768p", "1080p", "4k"]>;
     /** Default requested aspect. */
     readonly defaultAspectRatio: Schema.Literals<readonly ["16:9", "4:3", "1:1", "3:4", "9:16", "21:9", "9:21"]>;
+    /** Whether the model documents an audio on/off choice. */
+    readonly supportsAudio: Schema.Boolean;
     /** Audio default, or null when the provider default is undocumented. */
     readonly defaultGenerateAudio: Schema.NullOr<Schema.Boolean>;
-    /** Host/provider prompt bound. */
-    readonly maxPromptLength: Schema.Number;
     /** Roles admitted by this model. */
     readonly referenceRoles: Schema.$Array<Schema.Literals<readonly ["first-frame", "last-frame", "reference"]>>;
     /** Maximum images in reference-image mode. */
@@ -190,6 +190,7 @@ export declare const mediaModelSchema: Schema.Struct<{
         readonly defaultWidth: Schema.Number;
         readonly dimensions: Schema.Literals<readonly ["none", "own"]>;
         readonly maxDimension: Schema.NullOr<Schema.Number>;
+        readonly maxDimensionDocumented: Schema.Boolean;
         readonly maxReferences: Schema.Number;
         readonly maxSteps: Schema.NullOr<Schema.Number>;
         readonly referenceField: Schema.NullOr<Schema.String>;
@@ -198,6 +199,8 @@ export declare const mediaModelSchema: Schema.Struct<{
     }>;
     readonly kind: Schema.Literals<readonly ["image", "video"]>;
     readonly label: Schema.String;
+    /** Maximum prompt length in characters for this model. */
+    readonly maxPromptLength: Schema.Number;
     readonly tier: Schema.Literals<readonly ["draft", "balanced", "premium", "max"]>;
     readonly outputFormats: Schema.$Array<Schema.Literals<readonly ["png", "jpeg", "webp"]>>;
     readonly sizes: Schema.NullOr<Schema.$Array<Schema.String>>;
@@ -227,10 +230,10 @@ export declare const mediaModelSchema: Schema.Struct<{
         readonly defaultResolution: Schema.Literals<readonly ["480p", "720p", "768p", "1080p", "4k"]>;
         /** Default requested aspect. */
         readonly defaultAspectRatio: Schema.Literals<readonly ["16:9", "4:3", "1:1", "3:4", "9:16", "21:9", "9:21"]>;
+        /** Whether the model documents an audio on/off choice. */
+        readonly supportsAudio: Schema.Boolean;
         /** Audio default, or null when the provider default is undocumented. */
         readonly defaultGenerateAudio: Schema.NullOr<Schema.Boolean>;
-        /** Host/provider prompt bound. */
-        readonly maxPromptLength: Schema.Number;
         /** Roles admitted by this model. */
         readonly referenceRoles: Schema.$Array<Schema.Literals<readonly ["first-frame", "last-frame", "reference"]>>;
         /** Maximum images in reference-image mode. */
@@ -251,8 +254,14 @@ export declare const mediaModelSchema: Schema.Struct<{
 /** One generation model as the host describes it: identity, tier, input
  * limits and supported output formats. The host owns the catalog. */
 export type MediaModel = Schema.Schema.Type<typeof mediaModelSchema>;
-/** The most reference images one generation request may name. */
-export declare const MAX_MEDIA_REFERENCES = 4;
+/**
+ * Schema ceiling for reference images in one request: the largest per-model
+ * limit (GPT Image 2 takes 16). The host's catalog `maxReferences` is the
+ * authoritative per-model limit and is enforced after this parse.
+ */
+export declare const MAX_MEDIA_REFERENCES = 16;
+/** Video reference images: every verified video model's catalog value is 4. */
+export declare const MAX_VIDEO_REFERENCES = 4;
 /**
  * Validates the shape of an App's generation settings. Model-specific limits
  * (sizes, steps, durations, reference counts) and defaults are the host's:

package/dist/media.js

@@ -129,6 +129,7 @@ const modelInputSchema = Schema.Struct({
     defaultWidth: positiveInteger,
     dimensions: Schema.Literals(["none", "own"]),
     maxDimension: Schema.NullOr(positiveInteger),
+    maxDimensionDocumented: Schema.Boolean,
     maxReferences: nonNegativeInteger,
     maxSteps: Schema.NullOr(positiveInteger),
     referenceField: Schema.NullOr(text(256)),
@@ -162,10 +163,10 @@ export const mediaVideoModelSchema = Schema.Struct({
     defaultResolution: mediaVideoResolutionSchema,
     /** Default requested aspect. */
     defaultAspectRatio: mediaVideoAspectRatioSchema,
+    /** Whether the model documents an audio on/off choice. */
+    supportsAudio: Schema.Boolean,
     /** Audio default, or null when the provider default is undocumented. */
     defaultGenerateAudio: Schema.NullOr(Schema.Boolean),
-    /** Host/provider prompt bound. */
-    maxPromptLength: positiveInteger,
     /** Roles admitted by this model. */
     referenceRoles: Schema.Array(mediaVideoReferenceRoleSchema),
     /** Maximum images in reference-image mode. */
@@ -188,6 +189,8 @@ export const mediaModelSchema = Schema.Struct({
     input: modelInputSchema,
     kind: Schema.Literals(["image", "video"]),
     label: text(512),
+    /** Maximum prompt length in characters for this model. */
+    maxPromptLength: positiveInteger,
     tier: Schema.Literals(["draft", "balanced", "premium", "max"]),
     outputFormats: Schema.Array(Schema.Literals(["png", "jpeg", "webp"])).pipe(Schema.check(Schema.isMaxLength(3))),
     sizes: Schema.NullOr(Schema.Array(Schema.String.pipe(Schema.check(Schema.isPattern(/^\d+x\d+$/u))))),
@@ -200,8 +203,14 @@ const descriptionSchema = Schema.Struct({
     models: modelsSchema,
     canGenerate: Schema.Boolean,
 });
-/** The most reference images one generation request may name. */
-export const MAX_MEDIA_REFERENCES = 4;
+/**
+ * Schema ceiling for reference images in one request: the largest per-model
+ * limit (GPT Image 2 takes 16). The host's catalog `maxReferences` is the
+ * authoritative per-model limit and is enforced after this parse.
+ */
+export const MAX_MEDIA_REFERENCES = 16;
+/** Video reference images: every verified video model's catalog value is 4. */
+export const MAX_VIDEO_REFERENCES = 4;
 /**
  * Validates the shape of an App's generation settings. Model-specific limits
  * (sizes, steps, durations, reference counts) and defaults are the host's:
@@ -234,7 +243,7 @@ export const mediaVideoSelectionSchema = Schema.Struct({
     /** Explicit audio choice. The host owns omitted defaults. */
     generateAudio: Schema.optional(Schema.Boolean),
     /** At most four paths with explicit frame/reference roles. */
-    references: Schema.optional(Schema.Array(mediaVideoReferenceSchema).pipe(Schema.check(Schema.isMaxLength(MAX_MEDIA_REFERENCES)))),
+    references: Schema.optional(Schema.Array(mediaVideoReferenceSchema).pipe(Schema.check(Schema.isMaxLength(MAX_VIDEO_REFERENCES)))),
 });
 /** Public diagnostic stages a host may name when a generation fails. */
 export const mediaFailureStages = [

package/dist/ui.d.ts

@@ -74,6 +74,10 @@ export type AppStatusItem = Readonly<{
     icon?: AppStatusIcon;
     /** A positive count after the label; zero is hidden. */
     count?: number;
+    /** A small status light before the label; omitted draws none. */
+    tone?: AppStatusTone;
+    /** Work is under way: the light pulses (neutral tone when none is set). */
+    busy?: boolean;
     /** A longer description, such as a full folder path. */
     title?: string;
     disabled?: boolean;

package/docs/api/errors.md

@@ -50,7 +50,23 @@ Error.constructor;
 ##### code
 
 ```ts
-readonly code: AppErrorCode;
+readonly code:
+  | "CANCELLED"
+  | "CAPABILITY_DENIED"
+  | "CAPABILITY_REVOKED"
+  | "COMMAND_NOT_DECLARED"
+  | "CONFLICT"
+  | "DELIVERY_PENDING"
+  | "DISCONNECTED"
+  | "FILE_TOO_LARGE"
+  | "HOST_FAILURE"
+  | "IDENTITY"
+  | "INSUFFICIENT_CREDIT"
+  | "INVALID_ARGUMENT"
+  | "PROTOCOL"
+  | "SAFETY_FILTER_REFUSED"
+  | "SELECTION_CHANGED"
+  | "TIMEOUT";
 ```
 
 ##### retryable
@@ -88,26 +104,22 @@ Declaration-safe projection of the canonical Media diagnostic grammar.
 ### AppErrorCode
 
 ```ts
-type AppErrorCode =
-  | "CANCELLED"
-  | "CAPABILITY_DENIED"
-  | "CAPABILITY_REVOKED"
-  | "COMMAND_NOT_DECLARED"
-  | "CONFLICT"
-  | "DISCONNECTED"
-  | "FILE_TOO_LARGE"
-  | "HOST_FAILURE"
-  | "IDENTITY"
-  | "INSUFFICIENT_CREDIT"
-  | "INVALID_ARGUMENT"
-  | "PROTOCOL"
-  | "SAFETY_FILTER_REFUSED"
-  | "SELECTION_CHANGED"
-  | "TIMEOUT";
+type AppErrorCode = (typeof appErrorCodes)[number];
 ```
 
-The closed set of reasons an AppError can state; every SDK and host-reported
-failure is tagged with exactly one of these codes.
+One closed App error code from `appErrorCodes`.
+
+---
+
+### AppDeliveryPending
+
+```ts
+type AppDeliveryPending = Readonly<{
+  code: Extract<AppErrorCode, "DELIVERY_PENDING">;
+}>;
+```
+
+One pending-delivery refusal shared by admission and the shell.
 
 ---
 
@@ -200,6 +212,34 @@ Documentable wire projection of the canonical diagnostic grammar. Maintained
 converters preserve its closed objects and numeric bounds; decoding still
 returns the declaration-safe public diagnostic type.
 
+---
+
+### appErrorCodes
+
+```ts
+const appErrorCodes: readonly [
+  "CANCELLED",
+  "CAPABILITY_DENIED",
+  "CAPABILITY_REVOKED",
+  "COMMAND_NOT_DECLARED",
+  "CONFLICT",
+  "DELIVERY_PENDING",
+  "DISCONNECTED",
+  "FILE_TOO_LARGE",
+  "HOST_FAILURE",
+  "IDENTITY",
+  "INSUFFICIENT_CREDIT",
+  "INVALID_ARGUMENT",
+  "PROTOCOL",
+  "SAFETY_FILTER_REFUSED",
+  "SELECTION_CHANGED",
+  "TIMEOUT",
+];
+```
+
+The closed set of reasons an AppError can state; every SDK and host-reported
+failure is tagged with exactly one of these codes.
+
 ## Functions
 
 ### decodeMediaProviderDiagnostic()
@@ -263,10 +303,10 @@ prerequisites, so they can accompany a non-retryable operation.
 
 #### Parameters
 
-| Parameter    | Type                                                                                                                  |
-| ------------ | --------------------------------------------------------------------------------------------------------------------- |
-| `cause`      | `unknown`                                                                                                             |
-| `overrides?` | `Partial`\<`Record`\<[`AppErrorCode`](#apperrorcode), `Readonly`\<\{ `title`: `string`; `message`: `string`; \}\>\>\> |
+| Parameter    | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `cause`      | `unknown`                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| `overrides?` | `Partial`\<`Record`\< \| `"CANCELLED"` \| `"CAPABILITY_DENIED"` \| `"CAPABILITY_REVOKED"` \| `"COMMAND_NOT_DECLARED"` \| `"CONFLICT"` \| `"DELIVERY_PENDING"` \| `"DISCONNECTED"` \| `"FILE_TOO_LARGE"` \| `"HOST_FAILURE"` \| `"IDENTITY"` \| `"INSUFFICIENT_CREDIT"` \| `"INVALID_ARGUMENT"` \| `"PROTOCOL"` \| `"SAFETY_FILTER_REFUSED"` \| `"SELECTION_CHANGED"` \| `"TIMEOUT"`, `Readonly`\<\{ `title`: `string`; `message`: `string`; \}\>\>\> |
 
 #### Returns
 

package/docs/api/index.md

@@ -1627,6 +1627,8 @@ type AppStatusItem =
       kind: "button";
       icon?: AppStatusIcon;
       count?: number;
+      tone?: AppStatusTone;
+      busy?: boolean;
       title?: string;
       disabled?: boolean;
       opens?: "dialog";
@@ -2071,6 +2073,18 @@ const FungiDelegationReplySchema: ZodLazy<
         outcome_unknown: "outcome_unknown";
       }>;
       diagnostic: ZodOptional<ZodString>;
+      waitingOnYou: ZodOptional<
+        ZodArray<
+          ZodObject<
+            {
+              itemId: ZodLazy<ZodString>;
+              kind: ZodString;
+              summary: ZodString;
+            },
+            $strict
+          >
+        >
+      >;
     },
     $strict
   >
@@ -2096,6 +2110,7 @@ const FungiMessageMetaSchema: ZodObject<{
   delegation: ZodOptional<ZodObject<{
      ancestors: ZodArray<ZodLazy<ZodString>>;
      maxDepth: ZodNumber;
+     steer: ZodOptional<ZodLiteral<true>>;
      reply: ZodOptional<ZodLazy<ZodObject<{
         agentId: ZodLazy<ZodString>;
         sessionId: ZodLazy<ZodString>;
@@ -2108,6 +2123,7 @@ const FungiMessageMetaSchema: ZodObject<{
            outcome_unknown: ...;
         }>;
         diagnostic: ZodOptional<ZodString>;
+        waitingOnYou: ZodOptional<ZodArray<...>>;
      }, $strict>>>;
   }, $strict>>;
 }, $strict>;
@@ -2531,6 +2547,18 @@ Message type the host posts to hand the App its RPC MessagePort.
 
 ---
 
+### appDeliveryPendingSchema
+
+```ts
+const appDeliveryPendingSchema: Struct<{
+  code: Literals<readonly ["DELIVERY_PENDING"]>;
+}>;
+```
+
+Effect projection of the error owner's declaration-safe pending refusal.
+
+---
+
 ### parseAppStatusItems
 
 ```ts
@@ -2595,6 +2623,7 @@ const mediaModelSchema: Struct<{
     defaultWidth: Number;
     dimensions: Literals<readonly ["none", "own"]>;
     maxDimension: NullOr<Number>;
+    maxDimensionDocumented: Boolean;
     maxReferences: Number;
     maxSteps: NullOr<Number>;
     referenceField: NullOr<String>;
@@ -2603,6 +2632,7 @@ const mediaModelSchema: Struct<{
   }>;
   kind: Literals<readonly ["image", "video"]>;
   label: String;
+  maxPromptLength: Number;
   tier: Literals<readonly ["draft", "balanced", "premium", "max"]>;
   outputFormats: $Array<Literals<readonly ["png", "jpeg", "webp"]>>;
   sizes: NullOr<$Array<String>>;
@@ -2631,8 +2661,8 @@ const mediaModelSchema: Struct<{
       defaultAspectRatio: Literals<
         readonly ["16:9", "4:3", "1:1", "3:4", "9:16", "21:9", "9:21"]
       >;
+      supportsAudio: Boolean;
       defaultGenerateAudio: NullOr<Boolean>;
-      maxPromptLength: Number;
       referenceRoles: $Array<
         Literals<readonly ["first-frame", "last-frame", "reference"]>
       >;
@@ -3016,11 +3046,11 @@ The author a message's metadata names; none for anything else.
 }
 ```
 
-| Name    | Type      | Description                                                                                                                                               |
-| ------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `id`    | `string`  | -                                                                                                                                                         |
-| `name`  | `string`  | -                                                                                                                                                         |
-| `kind?` | `"agent"` | Present only when the author is another Agent the host admitted a delegated send or reply from; a line's text never sets it. Human authors carry no kind. |
+| Name    | Type      | Description                                                                                                                                                               |
+| ------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `id`    | `string`  | -                                                                                                                                                                         |
+| `name`  | `string`  | -                                                                                                                                                                         |
+| `kind?` | `"agent"` | Present only when the author is another Agent the host admitted a delegated send or reply from; a line's text never sets it. Human and host/system authors carry no kind. |
 
 ---
 
@@ -3043,6 +3073,7 @@ function messageDelegationReply(meta):
         | "cancelled"
         | "outcome_unknown";
       diagnostic?: string;
+      waitingOnYou?: object[];
     }
   | undefined;
 ```
@@ -3067,16 +3098,18 @@ other line, including text that merely looks like a reply.
   commandId: string;
   outcome: "completed" | "failed" | "interrupted" | "cancelled" | "outcome_unknown";
   diagnostic?: string;
+  waitingOnYou?: object[];
 }
 ```
 
-| 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. |
+| 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. |
+| `waitingOnYou?` | `object`[]                                                                             | -             | Open items of the replying Session that now wait on the recipient.       |
 
 ---
 
@@ -3094,12 +3127,12 @@ The metadata the host attaches for one authenticated author.
 
 #### Parameters
 
-| Parameter      | Type                                                        | Description                                                                                                                                               |
-| -------------- | ----------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `author`       | \{ `id`: `string`; `name`: `string`; `kind?`: `"agent"`; \} | -                                                                                                                                                         |
-| `author.id`    | `string`                                                    | -                                                                                                                                                         |
-| `author.name`  | `string`                                                    | -                                                                                                                                                         |
-| `author.kind?` | `"agent"`                                                   | Present only when the author is another Agent the host admitted a delegated send or reply from; a line's text never sets it. Human authors carry no kind. |
+| Parameter      | Type                                                        | Description                                                                                                                                                               |
+| -------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `author`       | \{ `id`: `string`; `name`: `string`; `kind?`: `"agent"`; \} | -                                                                                                                                                                         |
+| `author.id`    | `string`                                                    | -                                                                                                                                                                         |
+| `author.name`  | `string`                                                    | -                                                                                                                                                                         |
+| `author.kind?` | `"agent"`                                                   | Present only when the author is another Agent the host admitted a delegated send or reply from; a line's text never sets it. Human and host/system authors carry no kind. |
 
 #### Returns
 
@@ -3535,6 +3568,12 @@ Re-exports [AppError](errors.md#apperror)
 
 ---
 
+### AppDeliveryPending
+
+Re-exports [AppDeliveryPending](errors.md#appdeliverypending)
+
+---
+
 ### AppErrorCode
 
 Re-exports [AppErrorCode](errors.md#apperrorcode)

package/docs/api/media-json.md

@@ -323,6 +323,7 @@ const mediaGenerationDescriptionSchema: Struct<{
         defaultWidth: Number;
         dimensions: Literals<readonly ["none", "own"]>;
         maxDimension: NullOr<Number>;
+        maxDimensionDocumented: Boolean;
         maxReferences: Number;
         maxSteps: NullOr<Number>;
         referenceField: NullOr<String>;
@@ -331,6 +332,7 @@ const mediaGenerationDescriptionSchema: Struct<{
      }>;
      kind: Literals<readonly ["image", "video"]>;
      label: String;
+     maxPromptLength: Number;
      tier: Literals<readonly ["draft", "balanced", "premium", "max"]>;
      outputFormats: $Array<Literals<readonly ["png", "jpeg", "webp"]>>;
      sizes: NullOr<$Array<String>>;
@@ -348,8 +350,8 @@ const mediaGenerationDescriptionSchema: Struct<{
         }>>;
         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"]>;
+        supportsAudio: Boolean;
         defaultGenerateAudio: NullOr<Boolean>;
-        maxPromptLength: Number;
         referenceRoles: $Array<Literals<readonly [..., ..., ...]>>;
         maxReferenceImages: Number;
         referenceResolutions: $Array<Literals<readonly [..., ..., ..., ..., ...]>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fungi.computer/agar",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "author": "Levi <levi@technomancy.dev>",
   "description": "App contract for fungi.computer: typed backend methods, host capabilities and the App frontend connection",
   "type": "module",
@@ -169,7 +169,7 @@
   },
   "dependencies": {
     "@fungi.computer/puffball": "0.2.0",
-    "@fungi.computer/whistle": "0.1.0",
+    "@fungi.computer/whistle": "0.3.0",
     "@opentui/keymap": "0.5.10",
     "@fungi.computer/capnweb": "0.12.0",
     "effect": "4.0.2",
@@ -181,7 +181,7 @@
     "@fungi.computer/gills": "0.2.0",
     "@fungi.computer/cairn": "0.1.0",
     "@fungi.computer/sprite": "0.2.0",
-    "@fungi.computer/approvals": "0.1.0"
+    "@fungi.computer/approvals": "0.2.0"
   },
   "peerDependencies": {
     "react": "^18.3.1 || ^19.2.0",