@fnndsc/menu 0.8.0 → 0.10.0

package/dist/messages.d.ts

@@ -25,6 +25,8 @@ export declare const channelSchema: z.ZodEnum<["data", "err", "status"]>;
 export declare const surfaceCapabilitiesMessageSchema: z.ZodObject<{
     shellCommands: z.ZodBoolean;
     hiddenInput: z.ZodOptional<z.ZodBoolean>;
+    /** Renders ANSI colour, so a thumbnail can be half-blocks, not an ASCII ramp. */
+    color: z.ZodOptional<z.ZodBoolean>;
     /** Can put a file where its operator can reach it. */
     fileDelivery: z.ZodOptional<z.ZodBoolean>;
     /**
@@ -36,11 +38,13 @@ export declare const surfaceCapabilitiesMessageSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     shellCommands: boolean;
     hiddenInput?: boolean | undefined;
+    color?: boolean | undefined;
     fileDelivery?: boolean | undefined;
     localFilesystem?: boolean | undefined;
 }, {
     shellCommands: boolean;
     hiddenInput?: boolean | undefined;
+    color?: boolean | undefined;
     fileDelivery?: boolean | undefined;
     localFilesystem?: boolean | undefined;
 }>;
@@ -53,6 +57,8 @@ export declare const attachMessageSchema: z.ZodObject<{
     capabilities: z.ZodOptional<z.ZodObject<{
         shellCommands: z.ZodBoolean;
         hiddenInput: z.ZodOptional<z.ZodBoolean>;
+        /** Renders ANSI colour, so a thumbnail can be half-blocks, not an ASCII ramp. */
+        color: z.ZodOptional<z.ZodBoolean>;
         /** Can put a file where its operator can reach it. */
         fileDelivery: z.ZodOptional<z.ZodBoolean>;
         /**
@@ -64,11 +70,13 @@ export declare const attachMessageSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         shellCommands: boolean;
         hiddenInput?: boolean | undefined;
+        color?: boolean | undefined;
         fileDelivery?: boolean | undefined;
         localFilesystem?: boolean | undefined;
     }, {
         shellCommands: boolean;
         hiddenInput?: boolean | undefined;
+        color?: boolean | undefined;
         fileDelivery?: boolean | undefined;
         localFilesystem?: boolean | undefined;
     }>>;
@@ -80,6 +88,7 @@ export declare const attachMessageSchema: z.ZodObject<{
     capabilities?: {
         shellCommands: boolean;
         hiddenInput?: boolean | undefined;
+        color?: boolean | undefined;
         fileDelivery?: boolean | undefined;
         localFilesystem?: boolean | undefined;
     } | undefined;
@@ -91,6 +100,7 @@ export declare const attachMessageSchema: z.ZodObject<{
     capabilities?: {
         shellCommands: boolean;
         hiddenInput?: boolean | undefined;
+        color?: boolean | undefined;
         fileDelivery?: boolean | undefined;
         localFilesystem?: boolean | undefined;
     } | undefined;
@@ -417,10 +427,74 @@ export declare const watchedMessageSchema: z.ZodObject<{
     state: "live" | "settled" | "stale";
 }>;
 export type WatchedMessage = z.infer<typeof watchedMessageSchema>;
+/**
+ * Which listing the session's numbers currently count.
+ *
+ * A row can be named by the number beside it (`gather add @2,3`), and the
+ * numbers belong to the session's most recent ANSWER. A surface has to know
+ * WHICH listing that is, or it would light the index pills on a pane whose
+ * rows are no longer the ones `@2` would reach — and pills that lie are
+ * worse than no pills. Pushed whenever the answer changes, and to a late
+ * attacher, the way regard is.
+ */
+export declare const numberedMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"numbered">;
+    /** Rises with each answer, so a surface can tell newer from older. */
+    id: z.ZodNumber;
+    /** The line that produced the answer, which is how a pane recognises its own. */
+    source: z.ZodString;
+    /** How many rows are numbered. */
+    rows: z.ZodNumber;
+    /**
+     * Each numbered row's handle beside its address.
+     *
+     * An index says what it counts — `@SER003`, `@STD001`, `@FIL012`,
+     * `@DIR004` — one sequence per kind across the answer. A surface finds
+     * each of its rows by address and draws the code, rather than counting
+     * down the screen, so a sorted or filtered listing still shows each row
+     * the handle that reaches it. Capped: a listing of thousands is numbered
+     * in the kernel and simply unnumbered on screen.
+     */
+    handles: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        ordinal: z.ZodNumber;
+        address: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: string;
+        address: string;
+        ordinal: number;
+    }, {
+        kind: string;
+        address: string;
+        ordinal: number;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+    type: "numbered";
+    rows: number;
+    source: string;
+    handles: {
+        kind: string;
+        address: string;
+        ordinal: number;
+    }[];
+}, {
+    id: number;
+    type: "numbered";
+    rows: number;
+    source: string;
+    handles: {
+        kind: string;
+        address: string;
+        ordinal: number;
+    }[];
+}>;
+export type NumberedMessage = z.infer<typeof numberedMessageSchema>;
 /**
  * An event the engine originates on its own — a sampler's refreshed model,
- * a watch changing state — rather than in answer to a command. The daemon
- * relays it to every surface; it never enters scrollback.
+ * a watch changing state, the numbering moving to another listing — rather
+ * than in answer to a command. The daemon relays it to every surface; it
+ * never enters scrollback.
  */
 export type AmbientEvent = {
     kind: 'envelope';
@@ -429,6 +503,16 @@ export type AmbientEvent = {
     kind: 'watched';
     subject: string;
     state: WatchState;
+} | {
+    kind: 'numbered';
+    id: number;
+    source: string;
+    rows: number;
+    handles: Array<{
+        kind: string;
+        ordinal: number;
+        address: string;
+    }>;
 };
 /** Any message a surface may send to the daemon. */
 export declare const clientMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
@@ -439,6 +523,8 @@ export declare const clientMessageSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
     capabilities: z.ZodOptional<z.ZodObject<{
         shellCommands: z.ZodBoolean;
         hiddenInput: z.ZodOptional<z.ZodBoolean>;
+        /** Renders ANSI colour, so a thumbnail can be half-blocks, not an ASCII ramp. */
+        color: z.ZodOptional<z.ZodBoolean>;
         /** Can put a file where its operator can reach it. */
         fileDelivery: z.ZodOptional<z.ZodBoolean>;
         /**
@@ -450,11 +536,13 @@ export declare const clientMessageSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
     }, "strip", z.ZodTypeAny, {
         shellCommands: boolean;
         hiddenInput?: boolean | undefined;
+        color?: boolean | undefined;
         fileDelivery?: boolean | undefined;
         localFilesystem?: boolean | undefined;
     }, {
         shellCommands: boolean;
         hiddenInput?: boolean | undefined;
+        color?: boolean | undefined;
         fileDelivery?: boolean | undefined;
         localFilesystem?: boolean | undefined;
     }>>;
@@ -466,6 +554,7 @@ export declare const clientMessageSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
     capabilities?: {
         shellCommands: boolean;
         hiddenInput?: boolean | undefined;
+        color?: boolean | undefined;
         fileDelivery?: boolean | undefined;
         localFilesystem?: boolean | undefined;
     } | undefined;
@@ -477,6 +566,7 @@ export declare const clientMessageSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
     capabilities?: {
         shellCommands: boolean;
         hiddenInput?: boolean | undefined;
+        color?: boolean | undefined;
         fileDelivery?: boolean | undefined;
         localFilesystem?: boolean | undefined;
     } | undefined;
@@ -979,6 +1069,15 @@ export declare const progressMessageSchema: z.ZodObject<{
     percent: z.ZodOptional<z.ZodNumber>;
     unit: z.ZodOptional<z.ZodCatch<z.ZodEnum<["files", "bytes", "series", "jobs", "nodes"]>>>;
     status: z.ZodOptional<z.ZodCatch<z.ZodEnum<["running", "done", "unconfirmed", "stalled", "timeout", "error", "unknown"]>>>;
+    /**
+     * Where the item landed, when the kernel can name it.
+     *
+     * A retrieve is confirmed by count and filed by CUBE a beat later, so the
+     * message that says a series is home may not yet know where. This is the
+     * one that does: a surface offering a verb on the landed thing (IMAGE on a
+     * PACS row) needs the place, and only the kernel can say it.
+     */
+    path: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     type: "progress";
@@ -986,17 +1085,19 @@ export declare const progressMessageSchema: z.ZodObject<{
     phase: "failed" | "scanning" | "transferring" | "watching" | "retrying" | "reading" | "working" | "complete";
     label?: string | undefined;
     status?: "unknown" | "done" | "error" | "running" | "unconfirmed" | "stalled" | "timeout" | undefined;
+    path?: string | undefined;
     total?: number | undefined;
     kind?: "workflow" | "transfer" | "retrieve" | "inspection" | undefined;
     itemId?: string | undefined;
     current?: number | undefined;
     percent?: number | undefined;
-    unit?: "nodes" | "series" | "bytes" | "files" | "jobs" | undefined;
+    unit?: "nodes" | "jobs" | "series" | "bytes" | "files" | undefined;
 }, {
     id: string;
     type: "progress";
     label?: string | undefined;
     status?: unknown;
+    path?: string | undefined;
     total?: number | undefined;
     kind?: unknown;
     operation?: unknown;
@@ -1320,6 +1421,50 @@ export declare const promptContextSchema: z.ZodObject<{
             failed?: string | undefined;
         }>, "many">>;
         arrived: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        landed: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodNumber;
+            jobs: z.ZodNumber;
+            status: z.ZodString;
+            chain: z.ZodArray<z.ZodString, "many">;
+            groups: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                plugin: z.ZodString;
+                count: z.ZodNumber;
+                status: z.ZodString;
+                parent: z.ZodNullable<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                status: string;
+                count: number;
+                plugin: string;
+                parent: number | null;
+            }, {
+                status: string;
+                count: number;
+                plugin: string;
+                parent: number | null;
+            }>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            id: number;
+            status: string;
+            jobs: number;
+            chain: string[];
+            groups: {
+                status: string;
+                count: number;
+                plugin: string;
+                parent: number | null;
+            }[];
+        }, {
+            id: number;
+            status: string;
+            jobs: number;
+            chain: string[];
+            groups?: {
+                status: string;
+                count: number;
+                plugin: string;
+                parent: number | null;
+            }[] | undefined;
+        }>, "many">>;
         roster: z.ZodOptional<z.ZodEnum<["delta", "full"]>>;
     }, "strip", z.ZodTypeAny, {
         loaded: number;
@@ -1340,6 +1485,18 @@ export declare const promptContextSchema: z.ZodObject<{
             failed?: string | undefined;
         } | undefined;
         arrived?: number[] | undefined;
+        landed?: {
+            id: number;
+            status: string;
+            jobs: number;
+            chain: string[];
+            groups: {
+                status: string;
+                count: number;
+                plugin: string;
+                parent: number | null;
+            }[];
+        }[] | undefined;
         roster?: "delta" | "full" | undefined;
     }, {
         loaded: number;
@@ -1360,6 +1517,18 @@ export declare const promptContextSchema: z.ZodObject<{
             failed?: string | undefined;
         } | undefined;
         arrived?: number[] | undefined;
+        landed?: {
+            id: number;
+            status: string;
+            jobs: number;
+            chain: string[];
+            groups?: {
+                status: string;
+                count: number;
+                plugin: string;
+                parent: number | null;
+            }[] | undefined;
+        }[] | undefined;
         roster?: "delta" | "full" | undefined;
     }>>;
     procIndex: z.ZodOptional<z.ZodObject<{
@@ -1413,6 +1582,18 @@ export declare const promptContextSchema: z.ZodObject<{
             failed?: string | undefined;
         } | undefined;
         arrived?: number[] | undefined;
+        landed?: {
+            id: number;
+            status: string;
+            jobs: number;
+            chain: string[];
+            groups: {
+                status: string;
+                count: number;
+                plugin: string;
+                parent: number | null;
+            }[];
+        }[] | undefined;
         roster?: "delta" | "full" | undefined;
     } | undefined;
     procIndex?: {
@@ -1450,6 +1631,18 @@ export declare const promptContextSchema: z.ZodObject<{
             failed?: string | undefined;
         } | undefined;
         arrived?: number[] | undefined;
+        landed?: {
+            id: number;
+            status: string;
+            jobs: number;
+            chain: string[];
+            groups?: {
+                status: string;
+                count: number;
+                plugin: string;
+                parent: number | null;
+            }[] | undefined;
+        }[] | undefined;
         roster?: "delta" | "full" | undefined;
     } | undefined;
     procIndex?: {
@@ -1517,6 +1710,50 @@ export declare const promptLineMessageSchema: z.ZodObject<{
                 failed?: string | undefined;
             }>, "many">>;
             arrived: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+            landed: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodNumber;
+                jobs: z.ZodNumber;
+                status: z.ZodString;
+                chain: z.ZodArray<z.ZodString, "many">;
+                groups: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    plugin: z.ZodString;
+                    count: z.ZodNumber;
+                    status: z.ZodString;
+                    parent: z.ZodNullable<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                }, {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                }>, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                id: number;
+                status: string;
+                jobs: number;
+                chain: string[];
+                groups: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                }[];
+            }, {
+                id: number;
+                status: string;
+                jobs: number;
+                chain: string[];
+                groups?: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                }[] | undefined;
+            }>, "many">>;
             roster: z.ZodOptional<z.ZodEnum<["delta", "full"]>>;
         }, "strip", z.ZodTypeAny, {
             loaded: number;
@@ -1537,6 +1774,18 @@ export declare const promptLineMessageSchema: z.ZodObject<{
                 failed?: string | undefined;
             } | undefined;
             arrived?: number[] | undefined;
+            landed?: {
+                id: number;
+                status: string;
+                jobs: number;
+                chain: string[];
+                groups: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                }[];
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         }, {
             loaded: number;
@@ -1557,6 +1806,18 @@ export declare const promptLineMessageSchema: z.ZodObject<{
                 failed?: string | undefined;
             } | undefined;
             arrived?: number[] | undefined;
+            landed?: {
+                id: number;
+                status: string;
+                jobs: number;
+                chain: string[];
+                groups?: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                }[] | undefined;
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         }>>;
         procIndex: z.ZodOptional<z.ZodObject<{
@@ -1610,6 +1871,18 @@ export declare const promptLineMessageSchema: z.ZodObject<{
                 failed?: string | undefined;
             } | undefined;
             arrived?: number[] | undefined;
+            landed?: {
+                id: number;
+                status: string;
+                jobs: number;
+                chain: string[];
+                groups: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                }[];
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         } | undefined;
         procIndex?: {
@@ -1647,6 +1920,18 @@ export declare const promptLineMessageSchema: z.ZodObject<{
                 failed?: string | undefined;
             } | undefined;
             arrived?: number[] | undefined;
+            landed?: {
+                id: number;
+                status: string;
+                jobs: number;
+                chain: string[];
+                groups?: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                }[] | undefined;
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         } | undefined;
         procIndex?: {
@@ -1687,6 +1972,18 @@ export declare const promptLineMessageSchema: z.ZodObject<{
                 failed?: string | undefined;
             } | undefined;
             arrived?: number[] | undefined;
+            landed?: {
+                id: number;
+                status: string;
+                jobs: number;
+                chain: string[];
+                groups: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                }[];
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         } | undefined;
         procIndex?: {
@@ -1727,6 +2024,18 @@ export declare const promptLineMessageSchema: z.ZodObject<{
                 failed?: string | undefined;
             } | undefined;
             arrived?: number[] | undefined;
+            landed?: {
+                id: number;
+                status: string;
+                jobs: number;
+                chain: string[];
+                groups?: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                }[] | undefined;
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         } | undefined;
         procIndex?: {
@@ -2196,6 +2505,15 @@ export declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
     percent: z.ZodOptional<z.ZodNumber>;
     unit: z.ZodOptional<z.ZodCatch<z.ZodEnum<["files", "bytes", "series", "jobs", "nodes"]>>>;
     status: z.ZodOptional<z.ZodCatch<z.ZodEnum<["running", "done", "unconfirmed", "stalled", "timeout", "error", "unknown"]>>>;
+    /**
+     * Where the item landed, when the kernel can name it.
+     *
+     * A retrieve is confirmed by count and filed by CUBE a beat later, so the
+     * message that says a series is home may not yet know where. This is the
+     * one that does: a surface offering a verb on the landed thing (IMAGE on a
+     * PACS row) needs the place, and only the kernel can say it.
+     */
+    path: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     type: "progress";
@@ -2203,17 +2521,19 @@ export declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
     phase: "failed" | "scanning" | "transferring" | "watching" | "retrying" | "reading" | "working" | "complete";
     label?: string | undefined;
     status?: "unknown" | "done" | "error" | "running" | "unconfirmed" | "stalled" | "timeout" | undefined;
+    path?: string | undefined;
     total?: number | undefined;
     kind?: "workflow" | "transfer" | "retrieve" | "inspection" | undefined;
     itemId?: string | undefined;
     current?: number | undefined;
     percent?: number | undefined;
-    unit?: "nodes" | "series" | "bytes" | "files" | "jobs" | undefined;
+    unit?: "nodes" | "jobs" | "series" | "bytes" | "files" | undefined;
 }, {
     id: string;
     type: "progress";
     label?: string | undefined;
     status?: unknown;
+    path?: string | undefined;
     total?: number | undefined;
     kind?: unknown;
     operation?: unknown;
@@ -2458,6 +2778,50 @@ export declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
                 failed?: string | undefined;
             }>, "many">>;
             arrived: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+            landed: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodNumber;
+                jobs: z.ZodNumber;
+                status: z.ZodString;
+                chain: z.ZodArray<z.ZodString, "many">;
+                groups: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    plugin: z.ZodString;
+                    count: z.ZodNumber;
+                    status: z.ZodString;
+                    parent: z.ZodNullable<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                }, {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                }>, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                id: number;
+                status: string;
+                jobs: number;
+                chain: string[];
+                groups: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                }[];
+            }, {
+                id: number;
+                status: string;
+                jobs: number;
+                chain: string[];
+                groups?: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                }[] | undefined;
+            }>, "many">>;
             roster: z.ZodOptional<z.ZodEnum<["delta", "full"]>>;
         }, "strip", z.ZodTypeAny, {
             loaded: number;
@@ -2478,6 +2842,18 @@ export declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
                 failed?: string | undefined;
             } | undefined;
             arrived?: number[] | undefined;
+            landed?: {
+                id: number;
+                status: string;
+                jobs: number;
+                chain: string[];
+                groups: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                }[];
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         }, {
             loaded: number;
@@ -2498,6 +2874,18 @@ export declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
                 failed?: string | undefined;
             } | undefined;
             arrived?: number[] | undefined;
+            landed?: {
+                id: number;
+                status: string;
+                jobs: number;
+                chain: string[];
+                groups?: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                }[] | undefined;
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         }>>;
         procIndex: z.ZodOptional<z.ZodObject<{
@@ -2551,6 +2939,18 @@ export declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
                 failed?: string | undefined;
             } | undefined;
             arrived?: number[] | undefined;
+            landed?: {
+                id: number;
+                status: string;
+                jobs: number;
+                chain: string[];
+                groups: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                }[];
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         } | undefined;
         procIndex?: {
@@ -2588,6 +2988,18 @@ export declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
                 failed?: string | undefined;
             } | undefined;
             arrived?: number[] | undefined;
+            landed?: {
+                id: number;
+                status: string;
+                jobs: number;
+                chain: string[];
+                groups?: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                }[] | undefined;
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         } | undefined;
         procIndex?: {
@@ -2628,6 +3040,18 @@ export declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
                 failed?: string | undefined;
             } | undefined;
             arrived?: number[] | undefined;
+            landed?: {
+                id: number;
+                status: string;
+                jobs: number;
+                chain: string[];
+                groups: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                }[];
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         } | undefined;
         procIndex?: {
@@ -2668,6 +3092,18 @@ export declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
                 failed?: string | undefined;
             } | undefined;
             arrived?: number[] | undefined;
+            landed?: {
+                id: number;
+                status: string;
+                jobs: number;
+                chain: string[];
+                groups?: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                }[] | undefined;
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         } | undefined;
         procIndex?: {
@@ -2915,6 +3351,57 @@ export declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
     type: "watched";
     subject: string;
     state: "live" | "settled" | "stale";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"numbered">;
+    /** Rises with each answer, so a surface can tell newer from older. */
+    id: z.ZodNumber;
+    /** The line that produced the answer, which is how a pane recognises its own. */
+    source: z.ZodString;
+    /** How many rows are numbered. */
+    rows: z.ZodNumber;
+    /**
+     * Each numbered row's handle beside its address.
+     *
+     * An index says what it counts — `@SER003`, `@STD001`, `@FIL012`,
+     * `@DIR004` — one sequence per kind across the answer. A surface finds
+     * each of its rows by address and draws the code, rather than counting
+     * down the screen, so a sorted or filtered listing still shows each row
+     * the handle that reaches it. Capped: a listing of thousands is numbered
+     * in the kernel and simply unnumbered on screen.
+     */
+    handles: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        ordinal: z.ZodNumber;
+        address: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: string;
+        address: string;
+        ordinal: number;
+    }, {
+        kind: string;
+        address: string;
+        ordinal: number;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+    type: "numbered";
+    rows: number;
+    source: string;
+    handles: {
+        kind: string;
+        address: string;
+        ordinal: number;
+    }[];
+}, {
+    id: number;
+    type: "numbered";
+    rows: number;
+    source: string;
+    handles: {
+        kind: string;
+        address: string;
+        ordinal: number;
+    }[];
 }>]>;
 /** A message the daemon sends to a surface. */
 export type ServerMessage = z.infer<typeof serverMessageSchema>;