@fnndsc/menu 0.9.0 → 0.10.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,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;
@@ -1367,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;
@@ -1387,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<{
@@ -1440,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?: {
@@ -1477,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?: {
@@ -1544,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;
@@ -1564,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;
@@ -1584,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<{
@@ -1637,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?: {
@@ -1674,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?: {
@@ -1714,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?: {
@@ -1754,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?: {
@@ -2245,7 +2527,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 +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;
@@ -2516,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;
@@ -2536,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<{
@@ -2589,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?: {
@@ -2626,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?: {
@@ -2666,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?: {
@@ -2706,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?: {
@@ -2953,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>;

package/dist/messages.js

@@ -196,6 +196,40 @@ export const watchedMessageSchema = z.object({
     subject: z.string(),
     state: watchStateSchema,
 });
+/**
+ * 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 const numberedMessageSchema = z.object({
+    type: z.literal('numbered'),
+    /** Rises with each answer, so a surface can tell newer from older. */
+    id: z.number(),
+    /** The line that produced the answer, which is how a pane recognises its own. */
+    source: z.string(),
+    /** How many rows are numbered. */
+    rows: z.number(),
+    /**
+     * 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.array(z.object({
+        kind: z.string(),
+        ordinal: z.number(),
+        address: z.string(),
+    })),
+});
 /** Any message a surface may send to the daemon. */
 export const clientMessageSchema = z.discriminatedUnion('type', [
     attachMessageSchema,
@@ -443,6 +477,13 @@ export const promptContextSchema = z.object({
             failed: z.string().optional(),
         })).optional(),
         arrived: z.array(z.number()).optional(),
+        landed: z.array(z.object({
+            id: z.number(),
+            jobs: z.number(),
+            status: z.string(),
+            chain: z.array(z.string()),
+            groups: z.array(z.object({ plugin: z.string(), count: z.number(), status: z.string(), parent: z.number().nullable() })).default([]),
+        })).optional(),
         roster: z.enum(['delta', 'full']).optional(),
     }).optional(),
     procIndex: z.object({
@@ -566,6 +607,7 @@ export const serverMessageSchema = z.discriminatedUnion('type', [
     deliverMessageSchema,
     regardMessageSchema,
     watchedMessageSchema,
+    numberedMessageSchema,
 ]);
 /**
  * The message types this contract build knows. A surface receiving a typed