@withbuddi/buddi 0.1.0-pre.48 → 0.1.0-pre.49

package/packages/core/dist/views.d.ts

@@ -22,7 +22,7 @@
  * to `structured`, which is a readable view of the JSON rather than a dump.
  */
 /** The renderers the dashboard ships. Shapes, never domains. */
-export type RendererName = 'timeseries' | 'table' | 'bars' | 'keyvalue' | 'tiles' | 'document' | 'diff' | 'terminal' | 'image' | 'preview' | 'envelope' | 'structured';
+export type RendererName = 'timeseries' | 'table' | 'bars' | 'keyvalue' | 'tiles' | 'document' | 'diff' | 'terminal' | 'image' | 'preview' | 'envelope' | 'story' | 'audio' | 'query' | 'structured';
 /**
  * A value, resolved against the tool's output.
  *
@@ -324,7 +324,40 @@ export interface PreviewMap {
      */
     ports?: string;
 }
-export type ViewMap = TimeseriesMap | TableMap | BarsMap | KeyValueMap | TilesMap | DocumentMap | DiffMap | TerminalMap | ImageMap | PreviewMap | Record<string, never>;
+export type ViewMap = TimeseriesMap | TableMap | BarsMap | KeyValueMap | TilesMap | DocumentMap | DiffMap | TerminalMap | ImageMap | PreviewMap | StoryMap | QueryMap | Record<string, never>;
+/**
+ * `story` (host API 1.33): the output is one `StoryRow` (pages.ts) — title,
+ * attributions, image, summary, sources, timeline — or, with `rows`, a list
+ * of them. Every word drawn is the plugin's own.
+ */
+export interface StoryMap {
+    /** Path to an array of story rows; the output itself is one row when left out. */
+    rows?: string;
+}
+/**
+ * `query` (host API 1.33): the canvas asks the descriptor's own plugin one of
+ * its page queries, `params` read out of the output (each a path), and draws
+ * `body` — page components (plugin-pages.md), read-only — against the answer.
+ */
+export interface QueryMap {
+    query: string;
+    params?: Record<string, string>;
+    body: unknown[];
+}
+/**
+ * How a messenger delivers this tool's result (host API 1.33). `mediaFirst`:
+ * when the tool is called (and `when` holds against its input), the reply's
+ * streamed text is held back; what the output lists under `attachments` is
+ * sent first and the full text follows as a new message.
+ */
+export interface MessengerDelivery {
+    mediaFirst: true;
+    /** Read against the tool's *input*: only calls where `path` equals the value lead with media. */
+    when?: {
+        path: string;
+        equals: string | number | boolean | null;
+    };
+}
 /** One tool, one way of drawing it. */
 export interface ViewDescriptor {
     /** The tool whose result this describes, e.g. `weather.forecast`. */
@@ -333,6 +366,8 @@ export interface ViewDescriptor {
     /** Heading for the canvas tab and panel. Defaults to the tool name. */
     title?: string;
     map: ViewMap;
+    /** Since host API 1.33. */
+    messenger?: MessengerDelivery;
 }
 import { z } from 'zod';
 /**
@@ -704,6 +739,31 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     }>;
     tool: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
+    messenger: z.ZodOptional<z.ZodObject<{
+        mediaFirst: z.ZodLiteral<true>;
+        when: z.ZodOptional<z.ZodObject<{
+            path: z.ZodString;
+            equals: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            equals: string | number | boolean | null;
+        }, {
+            path: string;
+            equals: string | number | boolean | null;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }>>;
 }, "strict", z.ZodTypeAny, {
     map: {
         y: string;
@@ -746,6 +806,13 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     tool: string;
     renderer: "timeseries";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }, {
     map: {
         y: string;
@@ -788,6 +855,13 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     tool: string;
     renderer: "timeseries";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }>, z.ZodObject<{
     renderer: z.ZodLiteral<"table">;
     map: z.ZodObject<{
@@ -1131,6 +1205,31 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     }>;
     tool: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
+    messenger: z.ZodOptional<z.ZodObject<{
+        mediaFirst: z.ZodLiteral<true>;
+        when: z.ZodOptional<z.ZodObject<{
+            path: z.ZodString;
+            equals: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            equals: string | number | boolean | null;
+        }, {
+            path: string;
+            equals: string | number | boolean | null;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }>>;
 }, "strict", z.ZodTypeAny, {
     map: {
         rows: string;
@@ -1190,6 +1289,13 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     tool: string;
     renderer: "table";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }, {
     map: {
         rows: string;
@@ -1249,6 +1355,13 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     tool: string;
     renderer: "table";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }>, z.ZodObject<{
     renderer: z.ZodLiteral<"bars">;
     map: z.ZodObject<{
@@ -1292,6 +1405,31 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     }>;
     tool: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
+    messenger: z.ZodOptional<z.ZodObject<{
+        mediaFirst: z.ZodLiteral<true>;
+        when: z.ZodOptional<z.ZodObject<{
+            path: z.ZodString;
+            equals: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            equals: string | number | boolean | null;
+        }, {
+            path: string;
+            equals: string | number | boolean | null;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }>>;
 }, "strict", z.ZodTypeAny, {
     map: {
         value: string;
@@ -1307,6 +1445,13 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     tool: string;
     renderer: "bars";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }, {
     map: {
         value: string;
@@ -1322,6 +1467,13 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     tool: string;
     renderer: "bars";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }>, z.ZodObject<{
     renderer: z.ZodLiteral<"keyvalue">;
     map: z.ZodEffects<z.ZodObject<{
@@ -1456,6 +1608,31 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     }>;
     tool: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
+    messenger: z.ZodOptional<z.ZodObject<{
+        mediaFirst: z.ZodLiteral<true>;
+        when: z.ZodOptional<z.ZodObject<{
+            path: z.ZodString;
+            equals: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            equals: string | number | boolean | null;
+        }, {
+            path: string;
+            equals: string | number | boolean | null;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }>>;
 }, "strict", z.ZodTypeAny, {
     map: {
         from?: string | undefined;
@@ -1478,6 +1655,13 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     tool: string;
     renderer: "keyvalue";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }, {
     map: {
         from?: string | undefined;
@@ -1500,6 +1684,13 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     tool: string;
     renderer: "keyvalue";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }>, z.ZodObject<{
     renderer: z.ZodLiteral<"tiles">;
     map: z.ZodObject<{
@@ -1586,6 +1777,31 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     }>;
     tool: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
+    messenger: z.ZodOptional<z.ZodObject<{
+        mediaFirst: z.ZodLiteral<true>;
+        when: z.ZodOptional<z.ZodObject<{
+            path: z.ZodString;
+            equals: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            equals: string | number | boolean | null;
+        }, {
+            path: string;
+            equals: string | number | boolean | null;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }>>;
 }, "strict", z.ZodTypeAny, {
     map: {
         label: string;
@@ -1610,6 +1826,13 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     tool: string;
     renderer: "tiles";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }, {
     map: {
         label: string;
@@ -1634,6 +1857,13 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     tool: string;
     renderer: "tiles";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }>, z.ZodObject<{
     renderer: z.ZodLiteral<"document">;
     map: z.ZodEffects<z.ZodObject<{
@@ -1789,6 +2019,31 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     }>;
     tool: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
+    messenger: z.ZodOptional<z.ZodObject<{
+        mediaFirst: z.ZodLiteral<true>;
+        when: z.ZodOptional<z.ZodObject<{
+            path: z.ZodString;
+            equals: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            equals: string | number | boolean | null;
+        }, {
+            path: string;
+            equals: string | number | boolean | null;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }>>;
 }, "strict", z.ZodTypeAny, {
     map: {
         kind?: {
@@ -1816,6 +2071,13 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     tool: string;
     renderer: "document";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }, {
     map: {
         kind?: {
@@ -1843,6 +2105,13 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     tool: string;
     renderer: "document";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }>, z.ZodObject<{
     renderer: z.ZodLiteral<"diff">;
     map: z.ZodObject<{
@@ -1928,6 +2197,31 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     }>;
     tool: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
+    messenger: z.ZodOptional<z.ZodObject<{
+        mediaFirst: z.ZodLiteral<true>;
+        when: z.ZodOptional<z.ZodObject<{
+            path: z.ZodString;
+            equals: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            equals: string | number | boolean | null;
+        }, {
+            path: string;
+            equals: string | number | boolean | null;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }>>;
 }, "strict", z.ZodTypeAny, {
     map: {
         diff: string;
@@ -1949,6 +2243,13 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     tool: string;
     renderer: "diff";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }, {
     map: {
         diff: string;
@@ -1970,6 +2271,13 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     tool: string;
     renderer: "diff";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }>, z.ZodObject<{
     renderer: z.ZodLiteral<"terminal">;
     map: z.ZodObject<{
@@ -2064,6 +2372,31 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     }>;
     tool: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
+    messenger: z.ZodOptional<z.ZodObject<{
+        mediaFirst: z.ZodLiteral<true>;
+        when: z.ZodOptional<z.ZodObject<{
+            path: z.ZodString;
+            equals: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            equals: string | number | boolean | null;
+        }, {
+            path: string;
+            equals: string | number | boolean | null;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }>>;
 }, "strict", z.ZodTypeAny, {
     map: {
         output: string;
@@ -2088,6 +2421,13 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     tool: string;
     renderer: "terminal";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }, {
     map: {
         output: string;
@@ -2112,6 +2452,13 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     tool: string;
     renderer: "terminal";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }>, z.ZodObject<{
     renderer: z.ZodLiteral<"image">;
     map: z.ZodObject<{
@@ -2193,6 +2540,31 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     }>;
     tool: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
+    messenger: z.ZodOptional<z.ZodObject<{
+        mediaFirst: z.ZodLiteral<true>;
+        when: z.ZodOptional<z.ZodObject<{
+            path: z.ZodString;
+            equals: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            equals: string | number | boolean | null;
+        }, {
+            path: string;
+            equals: string | number | boolean | null;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }>>;
 }, "strict", z.ZodTypeAny, {
     map: {
         src: string;
@@ -2215,6 +2587,13 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     tool: string;
     renderer: "image";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }, {
     map: {
         src: string;
@@ -2237,6 +2616,13 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     tool: string;
     renderer: "image";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }>, z.ZodObject<{
     renderer: z.ZodLiteral<"preview">;
     map: z.ZodObject<{
@@ -2290,6 +2676,31 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     }>;
     tool: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
+    messenger: z.ZodOptional<z.ZodObject<{
+        mediaFirst: z.ZodLiteral<true>;
+        when: z.ZodOptional<z.ZodObject<{
+            path: z.ZodString;
+            equals: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            equals: string | number | boolean | null;
+        }, {
+            path: string;
+            equals: string | number | boolean | null;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }>>;
 }, "strict", z.ZodTypeAny, {
     map: {
         src: string;
@@ -2307,6 +2718,13 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     tool: string;
     renderer: "preview";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }, {
     map: {
         src: string;
@@ -2324,36 +2742,327 @@ export declare const viewDescriptorSchema: z.ZodDiscriminatedUnion<"renderer", [
     tool: string;
     renderer: "preview";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }>, z.ZodObject<{
     renderer: z.ZodLiteral<"envelope">;
     map: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
     tool: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
+    messenger: z.ZodOptional<z.ZodObject<{
+        mediaFirst: z.ZodLiteral<true>;
+        when: z.ZodOptional<z.ZodObject<{
+            path: z.ZodString;
+            equals: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            equals: string | number | boolean | null;
+        }, {
+            path: string;
+            equals: string | number | boolean | null;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }>>;
 }, "strict", z.ZodTypeAny, {
     map: {};
     tool: string;
     renderer: "envelope";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }, {
     map: {};
     tool: string;
     renderer: "envelope";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    renderer: z.ZodLiteral<"audio">;
+    map: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
+    tool: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    messenger: z.ZodOptional<z.ZodObject<{
+        mediaFirst: z.ZodLiteral<true>;
+        when: z.ZodOptional<z.ZodObject<{
+            path: z.ZodString;
+            equals: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            equals: string | number | boolean | null;
+        }, {
+            path: string;
+            equals: string | number | boolean | null;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    map: {};
+    tool: string;
+    renderer: "audio";
+    title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
+}, {
+    map: {};
+    tool: string;
+    renderer: "audio";
+    title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    renderer: z.ZodLiteral<"query">;
+    map: z.ZodObject<{
+        query: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        body: z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            kind: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            kind: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        body: z.objectOutputType<{
+            kind: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">[];
+        query: string;
+        params?: Record<string, string> | undefined;
+    }, {
+        body: z.objectInputType<{
+            kind: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">[];
+        query: string;
+        params?: Record<string, string> | undefined;
+    }>;
+    tool: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    messenger: z.ZodOptional<z.ZodObject<{
+        mediaFirst: z.ZodLiteral<true>;
+        when: z.ZodOptional<z.ZodObject<{
+            path: z.ZodString;
+            equals: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            equals: string | number | boolean | null;
+        }, {
+            path: string;
+            equals: string | number | boolean | null;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    map: {
+        body: z.objectOutputType<{
+            kind: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">[];
+        query: string;
+        params?: Record<string, string> | undefined;
+    };
+    tool: string;
+    renderer: "query";
+    title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
+}, {
+    map: {
+        body: z.objectInputType<{
+            kind: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">[];
+        query: string;
+        params?: Record<string, string> | undefined;
+    };
+    tool: string;
+    renderer: "query";
+    title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    renderer: z.ZodLiteral<"story">;
+    map: z.ZodObject<{
+        rows: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        rows?: string | undefined;
+    }, {
+        rows?: string | undefined;
+    }>;
+    tool: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    messenger: z.ZodOptional<z.ZodObject<{
+        mediaFirst: z.ZodLiteral<true>;
+        when: z.ZodOptional<z.ZodObject<{
+            path: z.ZodString;
+            equals: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            equals: string | number | boolean | null;
+        }, {
+            path: string;
+            equals: string | number | boolean | null;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    map: {
+        rows?: string | undefined;
+    };
+    tool: string;
+    renderer: "story";
+    title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
+}, {
+    map: {
+        rows?: string | undefined;
+    };
+    tool: string;
+    renderer: "story";
+    title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }>, z.ZodObject<{
     renderer: z.ZodLiteral<"structured">;
     map: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
     tool: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
+    messenger: z.ZodOptional<z.ZodObject<{
+        mediaFirst: z.ZodLiteral<true>;
+        when: z.ZodOptional<z.ZodObject<{
+            path: z.ZodString;
+            equals: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            equals: string | number | boolean | null;
+        }, {
+            path: string;
+            equals: string | number | boolean | null;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }, {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    }>>;
 }, "strict", z.ZodTypeAny, {
     map: {};
     tool: string;
     renderer: "structured";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }, {
     map: {};
     tool: string;
     renderer: "structured";
     title?: string | undefined;
+    messenger?: {
+        mediaFirst: true;
+        when?: {
+            path: string;
+            equals: string | number | boolean | null;
+        } | undefined;
+    } | undefined;
 }>]>;
 /**
  * Validate a manifest's descriptors, or throw naming the plugin and the tool.
@@ -2368,4 +3077,36 @@ export declare function parseViewDescriptors(views: readonly unknown[], opts: {
     tools?: readonly string[];
     pages?: readonly string[];
 }): ViewDescriptor[];
+/**
+ * What a tool whose view declares `messenger.mediaFirst` may list under its
+ * output's reserved `attachments` field: an image of its own plugin's assets
+ * (by key), a saved audio file (by artifact id), or the recording filed with
+ * one of its own plugin's saved reports (by the report's page link,
+ * `#/p/<plugin>/…`). Nothing else, and nothing of another plugin.
+ */
+export type MessengerAttachment = {
+    kind: 'image';
+    asset: string;
+    caption?: string;
+} | {
+    kind: 'audio';
+    artifact: string;
+} | {
+    kind: 'audio';
+    report: string;
+};
+/** The most attachments one output may carry; the rest are dropped. */
+export declare const MESSENGER_ATTACHMENTS_MAX = 4;
+/** Telegram's own cap on a photo caption. */
+export declare const ATTACHMENT_CAPTION_MAX = 1024;
+/** A page link of `plugin`'s own: `#/p/<plugin>/<page>` with an optional query string. */
+export declare function isOwnPageLink(plugin: string, link: unknown): link is string;
+/**
+ * The valid attachments of one tool output, for the tool's own `plugin`.
+ * An entry that is not exactly one of the three shapes, names an asset key
+ * that could not be one, or a report link of another plugin, is left out.
+ */
+export declare function messengerAttachments(plugin: string, output: unknown): MessengerAttachment[];
+/** Whether a call of this tool, with this input, leads with media on a messenger. */
+export declare function leadsWithMedia(descriptor: Pick<ViewDescriptor, 'messenger'> | undefined, input: unknown): boolean;
 //# sourceMappingURL=views.d.ts.map