@fnndsc/menu 0.9.0 → 0.11.0

package/dist/messages.d.ts

@@ -427,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';
@@ -439,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<{
@@ -1017,7 +1091,7 @@ export declare const progressMessageSchema: z.ZodObject<{
     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";
@@ -1347,6 +1421,58 @@ 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;
+            title: z.ZodDefault<z.ZodString>;
+            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;
+                errored: z.ZodDefault<z.ZodNumber>;
+                status: z.ZodString;
+                parent: z.ZodNullable<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                status: string;
+                count: number;
+                plugin: string;
+                errored: number;
+                parent: number | null;
+            }, {
+                status: string;
+                count: number;
+                plugin: string;
+                parent: number | null;
+                errored?: number | undefined;
+            }>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            id: number;
+            status: string;
+            title: string;
+            jobs: number;
+            chain: string[];
+            groups: {
+                status: string;
+                count: number;
+                plugin: string;
+                errored: number;
+                parent: number | null;
+            }[];
+        }, {
+            id: number;
+            status: string;
+            jobs: number;
+            chain: string[];
+            title?: string | undefined;
+            groups?: {
+                status: string;
+                count: number;
+                plugin: string;
+                parent: number | null;
+                errored?: number | undefined;
+            }[] | undefined;
+        }>, "many">>;
         roster: z.ZodOptional<z.ZodEnum<["delta", "full"]>>;
     }, "strip", z.ZodTypeAny, {
         loaded: number;
@@ -1367,6 +1493,20 @@ export declare const promptContextSchema: z.ZodObject<{
             failed?: string | undefined;
         } | undefined;
         arrived?: number[] | undefined;
+        landed?: {
+            id: number;
+            status: string;
+            title: string;
+            jobs: number;
+            chain: string[];
+            groups: {
+                status: string;
+                count: number;
+                plugin: string;
+                errored: number;
+                parent: number | null;
+            }[];
+        }[] | undefined;
         roster?: "delta" | "full" | undefined;
     }, {
         loaded: number;
@@ -1387,6 +1527,20 @@ export declare const promptContextSchema: z.ZodObject<{
             failed?: string | undefined;
         } | undefined;
         arrived?: number[] | undefined;
+        landed?: {
+            id: number;
+            status: string;
+            jobs: number;
+            chain: string[];
+            title?: string | undefined;
+            groups?: {
+                status: string;
+                count: number;
+                plugin: string;
+                parent: number | null;
+                errored?: number | undefined;
+            }[] | undefined;
+        }[] | undefined;
         roster?: "delta" | "full" | undefined;
     }>>;
     procIndex: z.ZodOptional<z.ZodObject<{
@@ -1440,6 +1594,20 @@ export declare const promptContextSchema: z.ZodObject<{
             failed?: string | undefined;
         } | undefined;
         arrived?: number[] | undefined;
+        landed?: {
+            id: number;
+            status: string;
+            title: string;
+            jobs: number;
+            chain: string[];
+            groups: {
+                status: string;
+                count: number;
+                plugin: string;
+                errored: number;
+                parent: number | null;
+            }[];
+        }[] | undefined;
         roster?: "delta" | "full" | undefined;
     } | undefined;
     procIndex?: {
@@ -1477,6 +1645,20 @@ export declare const promptContextSchema: z.ZodObject<{
             failed?: string | undefined;
         } | undefined;
         arrived?: number[] | undefined;
+        landed?: {
+            id: number;
+            status: string;
+            jobs: number;
+            chain: string[];
+            title?: string | undefined;
+            groups?: {
+                status: string;
+                count: number;
+                plugin: string;
+                parent: number | null;
+                errored?: number | undefined;
+            }[] | undefined;
+        }[] | undefined;
         roster?: "delta" | "full" | undefined;
     } | undefined;
     procIndex?: {
@@ -1544,6 +1726,58 @@ 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;
+                title: z.ZodDefault<z.ZodString>;
+                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;
+                    errored: z.ZodDefault<z.ZodNumber>;
+                    status: z.ZodString;
+                    parent: z.ZodNullable<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    errored: number;
+                    parent: number | null;
+                }, {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                    errored?: number | undefined;
+                }>, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                id: number;
+                status: string;
+                title: string;
+                jobs: number;
+                chain: string[];
+                groups: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    errored: number;
+                    parent: number | null;
+                }[];
+            }, {
+                id: number;
+                status: string;
+                jobs: number;
+                chain: string[];
+                title?: string | undefined;
+                groups?: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                    errored?: number | undefined;
+                }[] | undefined;
+            }>, "many">>;
             roster: z.ZodOptional<z.ZodEnum<["delta", "full"]>>;
         }, "strip", z.ZodTypeAny, {
             loaded: number;
@@ -1564,6 +1798,20 @@ export declare const promptLineMessageSchema: z.ZodObject<{
                 failed?: string | undefined;
             } | undefined;
             arrived?: number[] | undefined;
+            landed?: {
+                id: number;
+                status: string;
+                title: string;
+                jobs: number;
+                chain: string[];
+                groups: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    errored: number;
+                    parent: number | null;
+                }[];
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         }, {
             loaded: number;
@@ -1584,6 +1832,20 @@ export declare const promptLineMessageSchema: z.ZodObject<{
                 failed?: string | undefined;
             } | undefined;
             arrived?: number[] | undefined;
+            landed?: {
+                id: number;
+                status: string;
+                jobs: number;
+                chain: string[];
+                title?: string | undefined;
+                groups?: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                    errored?: number | undefined;
+                }[] | undefined;
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         }>>;
         procIndex: z.ZodOptional<z.ZodObject<{
@@ -1637,6 +1899,20 @@ export declare const promptLineMessageSchema: z.ZodObject<{
                 failed?: string | undefined;
             } | undefined;
             arrived?: number[] | undefined;
+            landed?: {
+                id: number;
+                status: string;
+                title: string;
+                jobs: number;
+                chain: string[];
+                groups: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    errored: number;
+                    parent: number | null;
+                }[];
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         } | undefined;
         procIndex?: {
@@ -1674,6 +1950,20 @@ export declare const promptLineMessageSchema: z.ZodObject<{
                 failed?: string | undefined;
             } | undefined;
             arrived?: number[] | undefined;
+            landed?: {
+                id: number;
+                status: string;
+                jobs: number;
+                chain: string[];
+                title?: string | undefined;
+                groups?: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                    errored?: number | undefined;
+                }[] | undefined;
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         } | undefined;
         procIndex?: {
@@ -1714,6 +2004,20 @@ export declare const promptLineMessageSchema: z.ZodObject<{
                 failed?: string | undefined;
             } | undefined;
             arrived?: number[] | undefined;
+            landed?: {
+                id: number;
+                status: string;
+                title: string;
+                jobs: number;
+                chain: string[];
+                groups: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    errored: number;
+                    parent: number | null;
+                }[];
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         } | undefined;
         procIndex?: {
@@ -1754,6 +2058,20 @@ export declare const promptLineMessageSchema: z.ZodObject<{
                 failed?: string | undefined;
             } | undefined;
             arrived?: number[] | undefined;
+            landed?: {
+                id: number;
+                status: string;
+                jobs: number;
+                chain: string[];
+                title?: string | undefined;
+                groups?: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                    errored?: number | undefined;
+                }[] | undefined;
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         } | undefined;
         procIndex?: {
@@ -1929,14 +2247,14 @@ export declare const telemetryMessageSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         scheduled: number;
         running: number;
-        runningFeeds: number;
         errored: number;
+        runningFeeds: number;
         erroredFeeds: number;
     }, {
         scheduled: number;
         running: number;
-        runningFeeds: number;
         errored: number;
+        runningFeeds: number;
         erroredFeeds: number;
     }>>;
 }, "strip", z.ZodTypeAny, {
@@ -1948,8 +2266,8 @@ export declare const telemetryMessageSchema: z.ZodObject<{
     state?: {
         scheduled: number;
         running: number;
-        runningFeeds: number;
         errored: number;
+        runningFeeds: number;
         erroredFeeds: number;
     } | undefined;
     lane?: {
@@ -1973,8 +2291,8 @@ export declare const telemetryMessageSchema: z.ZodObject<{
     state?: {
         scheduled: number;
         running: number;
-        runningFeeds: number;
         errored: number;
+        runningFeeds: number;
         erroredFeeds: number;
     } | undefined;
     lane?: {
@@ -2245,7 +2563,7 @@ export declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
     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";
@@ -2496,6 +2814,58 @@ 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;
+                title: z.ZodDefault<z.ZodString>;
+                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;
+                    errored: z.ZodDefault<z.ZodNumber>;
+                    status: z.ZodString;
+                    parent: z.ZodNullable<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    errored: number;
+                    parent: number | null;
+                }, {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                    errored?: number | undefined;
+                }>, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                id: number;
+                status: string;
+                title: string;
+                jobs: number;
+                chain: string[];
+                groups: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    errored: number;
+                    parent: number | null;
+                }[];
+            }, {
+                id: number;
+                status: string;
+                jobs: number;
+                chain: string[];
+                title?: string | undefined;
+                groups?: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                    errored?: number | undefined;
+                }[] | undefined;
+            }>, "many">>;
             roster: z.ZodOptional<z.ZodEnum<["delta", "full"]>>;
         }, "strip", z.ZodTypeAny, {
             loaded: number;
@@ -2516,6 +2886,20 @@ export declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
                 failed?: string | undefined;
             } | undefined;
             arrived?: number[] | undefined;
+            landed?: {
+                id: number;
+                status: string;
+                title: string;
+                jobs: number;
+                chain: string[];
+                groups: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    errored: number;
+                    parent: number | null;
+                }[];
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         }, {
             loaded: number;
@@ -2536,6 +2920,20 @@ 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[];
+                title?: string | undefined;
+                groups?: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                    errored?: number | undefined;
+                }[] | undefined;
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         }>>;
         procIndex: z.ZodOptional<z.ZodObject<{
@@ -2589,6 +2987,20 @@ export declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
                 failed?: string | undefined;
             } | undefined;
             arrived?: number[] | undefined;
+            landed?: {
+                id: number;
+                status: string;
+                title: string;
+                jobs: number;
+                chain: string[];
+                groups: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    errored: number;
+                    parent: number | null;
+                }[];
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         } | undefined;
         procIndex?: {
@@ -2626,6 +3038,20 @@ 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[];
+                title?: string | undefined;
+                groups?: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                    errored?: number | undefined;
+                }[] | undefined;
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         } | undefined;
         procIndex?: {
@@ -2666,6 +3092,20 @@ export declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
                 failed?: string | undefined;
             } | undefined;
             arrived?: number[] | undefined;
+            landed?: {
+                id: number;
+                status: string;
+                title: string;
+                jobs: number;
+                chain: string[];
+                groups: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    errored: number;
+                    parent: number | null;
+                }[];
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         } | undefined;
         procIndex?: {
@@ -2706,6 +3146,20 @@ 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[];
+                title?: string | undefined;
+                groups?: {
+                    status: string;
+                    count: number;
+                    plugin: string;
+                    parent: number | null;
+                    errored?: number | undefined;
+                }[] | undefined;
+            }[] | undefined;
             roster?: "delta" | "full" | undefined;
         } | undefined;
         procIndex?: {
@@ -2781,14 +3235,14 @@ export declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
     }, "strip", z.ZodTypeAny, {
         scheduled: number;
         running: number;
-        runningFeeds: number;
         errored: number;
+        runningFeeds: number;
         erroredFeeds: number;
     }, {
         scheduled: number;
         running: number;
-        runningFeeds: number;
         errored: number;
+        runningFeeds: number;
         erroredFeeds: number;
     }>>;
 }, "strip", z.ZodTypeAny, {
@@ -2800,8 +3254,8 @@ export declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
     state?: {
         scheduled: number;
         running: number;
-        runningFeeds: number;
         errored: number;
+        runningFeeds: number;
         erroredFeeds: number;
     } | undefined;
     lane?: {
@@ -2825,8 +3279,8 @@ export declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.Zod
     state?: {
         scheduled: number;
         running: number;
-        runningFeeds: number;
         errored: number;
+        runningFeeds: number;
         erroredFeeds: number;
     } | undefined;
     lane?: {
@@ -2953,6 +3407,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>;