@anchrd/colab-sdk 0.1.16 → 0.1.18

package/dist/actions/actions.d.ts

@@ -9,6 +9,7 @@ export declare const ActionListInput: z.ZodObject<{
     userId: z.ZodOptional<z.ZodTemplateLiteral<`user_${string}`>>;
     cursor: z.ZodOptional<z.ZodString>;
     limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    known: z.ZodOptional<z.ZodPreprocess<z.ZodArray<z.ZodString>, unknown>>;
 }, z.core.$strict>;
 export type ActionListInput = z.infer<typeof ActionListInput>;
 export declare const ActionSection: z.ZodEnum<{
@@ -44,6 +45,8 @@ export declare const ActionTask: z.ZodObject<{
         }>;
     }, z.core.$strip>>;
     handedOver: z.ZodBoolean;
+    rev: z.ZodNumber;
+    startsToday: z.ZodOptional<z.ZodLiteral<true>>;
 }, z.core.$strip>;
 export type ActionTask = z.infer<typeof ActionTask>;
 export declare const ActionChat: z.ZodObject<{
@@ -82,6 +85,30 @@ export declare const ActionProcess: z.ZodObject<{
     dueAt: z.ZodISODateTime;
 }, z.core.$strip>;
 export type ActionProcess = z.infer<typeof ActionProcess>;
+export declare const ActionRunHint: z.ZodEnum<{
+    started: "started";
+    stalled: "stalled";
+}>;
+export type ActionRunHint = z.infer<typeof ActionRunHint>;
+export declare const ActionRunTask: z.ZodObject<{
+    taskId: z.ZodTemplateLiteral<`node_${string}`>;
+    title: z.ZodString;
+    column: z.ZodObject<{
+        columnId: z.ZodTemplateLiteral<`column_${string}`>;
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            backlog: "backlog";
+            open: "open";
+            progress: "progress";
+            done: "done";
+            discarded: "discarded";
+            blocked: "blocked";
+            archive: "archive";
+        }>;
+    }, z.core.$strip>;
+    rev: z.ZodNumber;
+}, z.core.$strip>;
+export type ActionRunTask = z.infer<typeof ActionRunTask>;
 export declare const ActionRun: z.ZodObject<{
     runId: z.ZodTemplateLiteral<`run_${string}`>;
     status: z.ZodEnum<{
@@ -90,6 +117,28 @@ export declare const ActionRun: z.ZodObject<{
         done: "done";
         running: "running";
     }>;
+    tasks: z.ZodArray<z.ZodObject<{
+        taskId: z.ZodTemplateLiteral<`node_${string}`>;
+        title: z.ZodString;
+        column: z.ZodObject<{
+            columnId: z.ZodTemplateLiteral<`column_${string}`>;
+            name: z.ZodString;
+            type: z.ZodEnum<{
+                backlog: "backlog";
+                open: "open";
+                progress: "progress";
+                done: "done";
+                discarded: "discarded";
+                blocked: "blocked";
+                archive: "archive";
+            }>;
+        }, z.core.$strip>;
+        rev: z.ZodNumber;
+    }, z.core.$strip>>;
+    hint: z.ZodOptional<z.ZodEnum<{
+        started: "started";
+        stalled: "stalled";
+    }>>;
 }, z.core.$strip>;
 export type ActionRun = z.infer<typeof ActionRun>;
 export declare const ActionGadget: z.ZodObject<{
@@ -108,6 +157,10 @@ export declare const ActionGadget: z.ZodObject<{
     hint: z.ZodBoolean;
 }, z.core.$strip>;
 export type ActionGadget = z.infer<typeof ActionGadget>;
+export declare const ActionValidation: z.ZodObject<{
+    newTickets: z.ZodNumber;
+}, z.core.$strip>;
+export type ActionValidation = z.infer<typeof ActionValidation>;
 export declare const ActionItem: z.ZodObject<{
     node: z.ZodObject<{
         nodeId: z.ZodTemplateLiteral<`node_${string}`>;
@@ -180,6 +233,8 @@ export declare const ActionItem: z.ZodObject<{
             }>;
         }, z.core.$strip>>;
         handedOver: z.ZodBoolean;
+        rev: z.ZodNumber;
+        startsToday: z.ZodOptional<z.ZodLiteral<true>>;
     }, z.core.$strip>>;
     chat: z.ZodNullable<z.ZodObject<{
         unreadCount: z.ZodNumber;
@@ -223,6 +278,28 @@ export declare const ActionItem: z.ZodObject<{
             done: "done";
             running: "running";
         }>;
+        tasks: z.ZodArray<z.ZodObject<{
+            taskId: z.ZodTemplateLiteral<`node_${string}`>;
+            title: z.ZodString;
+            column: z.ZodObject<{
+                columnId: z.ZodTemplateLiteral<`column_${string}`>;
+                name: z.ZodString;
+                type: z.ZodEnum<{
+                    backlog: "backlog";
+                    open: "open";
+                    progress: "progress";
+                    done: "done";
+                    discarded: "discarded";
+                    blocked: "blocked";
+                    archive: "archive";
+                }>;
+            }, z.core.$strip>;
+            rev: z.ZodNumber;
+        }, z.core.$strip>>;
+        hint: z.ZodOptional<z.ZodEnum<{
+            started: "started";
+            stalled: "stalled";
+        }>>;
     }, z.core.$strip>>;
     gadget: z.ZodNullable<z.ZodObject<{
         problem: z.ZodEnum<{
@@ -239,6 +316,9 @@ export declare const ActionItem: z.ZodObject<{
         }>;
         hint: z.ZodBoolean;
     }, z.core.$strip>>;
+    validation: z.ZodOptional<z.ZodObject<{
+        newTickets: z.ZodNumber;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ActionItem = z.infer<typeof ActionItem>;
 export declare const ActionNoticeKind: z.ZodEnum<{
@@ -513,6 +593,8 @@ export declare const ActionRow: z.ZodUnion<readonly [z.ZodObject<{
             }>;
         }, z.core.$strip>>;
         handedOver: z.ZodBoolean;
+        rev: z.ZodNumber;
+        startsToday: z.ZodOptional<z.ZodLiteral<true>>;
     }, z.core.$strip>>;
     chat: z.ZodNullable<z.ZodObject<{
         unreadCount: z.ZodNumber;
@@ -556,6 +638,28 @@ export declare const ActionRow: z.ZodUnion<readonly [z.ZodObject<{
             done: "done";
             running: "running";
         }>;
+        tasks: z.ZodArray<z.ZodObject<{
+            taskId: z.ZodTemplateLiteral<`node_${string}`>;
+            title: z.ZodString;
+            column: z.ZodObject<{
+                columnId: z.ZodTemplateLiteral<`column_${string}`>;
+                name: z.ZodString;
+                type: z.ZodEnum<{
+                    backlog: "backlog";
+                    open: "open";
+                    progress: "progress";
+                    done: "done";
+                    discarded: "discarded";
+                    blocked: "blocked";
+                    archive: "archive";
+                }>;
+            }, z.core.$strip>;
+            rev: z.ZodNumber;
+        }, z.core.$strip>>;
+        hint: z.ZodOptional<z.ZodEnum<{
+            started: "started";
+            stalled: "stalled";
+        }>>;
     }, z.core.$strip>>;
     gadget: z.ZodNullable<z.ZodObject<{
         problem: z.ZodEnum<{
@@ -572,6 +676,9 @@ export declare const ActionRow: z.ZodUnion<readonly [z.ZodObject<{
         }>;
         hint: z.ZodBoolean;
     }, z.core.$strip>>;
+    validation: z.ZodOptional<z.ZodObject<{
+        newTickets: z.ZodNumber;
+    }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
     notice: z.ZodObject<{
         package: z.ZodEnum<{
@@ -654,6 +761,17 @@ export declare const MachineInstructions: z.ZodObject<{
     version: z.ZodNullable<z.ZodInt>;
 }, z.core.$strip>;
 export type MachineInstructions = z.infer<typeof MachineInstructions>;
+export declare const MachineInstructionsRead: z.ZodUnion<readonly [z.ZodObject<{
+    path: z.ZodString;
+    status: z.ZodNullable<z.ZodString>;
+    markdown: z.ZodString;
+    version: z.ZodNullable<z.ZodInt>;
+    digest: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    digest: z.ZodString;
+    known: z.ZodLiteral<true>;
+}, z.core.$strip>]>;
+export type MachineInstructionsRead = z.infer<typeof MachineInstructionsRead>;
 export declare const ActionList: z.ZodObject<{
     items: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
         node: z.ZodObject<{
@@ -727,6 +845,8 @@ export declare const ActionList: z.ZodObject<{
                 }>;
             }, z.core.$strip>>;
             handedOver: z.ZodBoolean;
+            rev: z.ZodNumber;
+            startsToday: z.ZodOptional<z.ZodLiteral<true>>;
         }, z.core.$strip>>;
         chat: z.ZodNullable<z.ZodObject<{
             unreadCount: z.ZodNumber;
@@ -770,6 +890,28 @@ export declare const ActionList: z.ZodObject<{
                 done: "done";
                 running: "running";
             }>;
+            tasks: z.ZodArray<z.ZodObject<{
+                taskId: z.ZodTemplateLiteral<`node_${string}`>;
+                title: z.ZodString;
+                column: z.ZodObject<{
+                    columnId: z.ZodTemplateLiteral<`column_${string}`>;
+                    name: z.ZodString;
+                    type: z.ZodEnum<{
+                        backlog: "backlog";
+                        open: "open";
+                        progress: "progress";
+                        done: "done";
+                        discarded: "discarded";
+                        blocked: "blocked";
+                        archive: "archive";
+                    }>;
+                }, z.core.$strip>;
+                rev: z.ZodNumber;
+            }, z.core.$strip>>;
+            hint: z.ZodOptional<z.ZodEnum<{
+                started: "started";
+                stalled: "stalled";
+            }>>;
         }, z.core.$strip>>;
         gadget: z.ZodNullable<z.ZodObject<{
             problem: z.ZodEnum<{
@@ -786,6 +928,9 @@ export declare const ActionList: z.ZodObject<{
             }>;
             hint: z.ZodBoolean;
         }, z.core.$strip>>;
+        validation: z.ZodOptional<z.ZodObject<{
+            newTickets: z.ZodNumber;
+        }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
         notice: z.ZodObject<{
             package: z.ZodEnum<{
@@ -861,11 +1006,15 @@ export declare const ActionList: z.ZodObject<{
     }, z.core.$strip>]>>;
     nextCursor: z.ZodNullable<z.ZodString>;
     count: z.ZodNumber;
-    instructions: z.ZodOptional<z.ZodObject<{
+    instructions: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
         path: z.ZodString;
         status: z.ZodNullable<z.ZodString>;
         markdown: z.ZodString;
         version: z.ZodNullable<z.ZodInt>;
-    }, z.core.$strip>>;
+        digest: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        digest: z.ZodString;
+        known: z.ZodLiteral<true>;
+    }, z.core.$strip>]>>;
 }, z.core.$strip>;
 export type ActionList = z.infer<typeof ActionList>;

package/dist/actions/actions.js

@@ -3,7 +3,7 @@ import { ColumnType, TaskColumn } from "../columns/columns.js";
 import { CallId } from "../connectors/connectors.js";
 import { GadgetLevel } from "../gadgets/gadgets.js";
 import { packages } from "../grammar/grammar.js";
-import { InstructionsLink } from "../instructions/instructions.js";
+import { Digest, InstructionsLink, Known, KnownText } from "../instructions/instructions.js";
 import { Limit as PageSize } from "../list-input.js";
 import { MessageAuthor, MessageId } from "../messages/messages.js";
 import { BoardShownKind, NodeId, NodeKind, NodePath } from "../nodes/nodes.js";
@@ -18,7 +18,7 @@ export const ActionListInput = z.strictObject({
     filter: z
         .enum(actionFilters)
         .optional()
-        .describe("Which rows: all, tasks (tasks, due processes, open runs and broken gadgets you answer for) or chats (rows with something unread, a task's chat included). Notices of other parts of Colab come only with all. Leaving it out gives all. count always counts all."),
+        .describe("Which rows: all, tasks (tasks, due processes, open runs, the validation's tickets in New for the holder of validator, and broken gadgets you answer for) or chats (rows with something unread, a task's chat included). Notices of other parts of Colab come only with all. Leaving it out gives all. count always counts all."),
     userId: UserId.optional().describe("Whose Actions to read, `user_…`. Only an admin in admin mode reads another person's, to see where they are stuck; anyone else gets not_found. Leaving it out reads your own."),
     cursor: z
         .string()
@@ -26,6 +26,7 @@ export const ActionListInput = z.strictObject({
         .optional()
         .describe("The nextCursor of the previous page, unchanged, for the rows after it. Leaving it out starts with the newest."),
     limit: PageSize.optional().describe("How many rows one page holds, 1 to 100. Leaving it out gives 50."),
+    known: Known.optional(),
 });
 // The two sections of the page: waiting (open tasks, chats, a due process) and in progress (tasks
 // in progress, an open run).
@@ -38,6 +39,11 @@ export const ActionTask = z.object({
     buttons: z.array(TaskColumn),
     // A machine moved it into its column last: "handed over by the Operator".
     handedOver: z.boolean(),
+    // The task's rev (E70, #671): intelligence_task_update takes it without reading the task first.
+    rev: z.number().int(),
+    // Its start date was reached within the last 24 hours (E124): the row says "starts today", and
+    // `since` is that moment when it came later than the task into its column. Absent otherwise.
+    startsToday: z.literal(true).optional(),
 });
 export const ActionChat = z.object({
     // The messages of others not read yet, by the person themselves (not their AI).
@@ -56,9 +62,27 @@ export const ActionProcess = z.object({
     // The moment of the schedule the next run stands for.
     dueAt: z.iso.datetime(),
 });
+// A hint to the responsible of a process (E124, E125): `started`, a run began and waits on them to
+// move its first tasks into Open; `stalled`, no task of the run is in Open or In progress though not
+// all are closed, and they move the next one on. Gone as soon as a task of the run is open again.
+export const ActionRunHint = z.enum(["started", "stalled"]);
+// A card of a process run that is the reader's own (#671): what the run waits on from them, with the
+// rev its next save sends, so an Operator writes it without reading the run first.
+export const ActionRunTask = z.object({
+    taskId: NodeId,
+    title: z.string(),
+    column: TaskColumn,
+    rev: z.number().int(),
+});
 export const ActionRun = z.object({
     runId: RunId,
     status: RunStatus,
+    // The cards of this run assigned to the reader, in every column, in the order of the run's columns
+    // and their position; never another's. Empty without one, and always for the validation, whose run
+    // copies no cards.
+    tasks: z.array(ActionRunTask),
+    // Only for the responsible of the run's process, while the run waits on them (E124, E125).
+    hint: ActionRunHint.optional(),
 });
 // A gadget whose live version broke (#643, Nodes › Gadget › Einstellungen): every new error and every
 // red test waits on its responsible; without one, on its publisher as a hint to name one. Open until
@@ -75,8 +99,17 @@ export const ActionGadget = z.object({
     // Nobody is responsible: the row reaches the publisher only to name one.
     hint: z.boolean(),
 });
+// The tickets of the validation that wait on the holder of `validator` (E132): its latest run found
+// tickets in New, and they still lie there, so the holder goes on until they are checked. On the
+// validation board's row, beside its open run or its due moment, or alone.
+export const ActionValidation = z.object({
+    // How many tickets lie in New now (a column of type backlog of the validation board), those that
+    // came after the run started included.
+    newTickets: z.number().int().positive(),
+});
 // One row: the node, where it waits, since when, and what makes it wait. Exactly one of task,
 // process, run and gadget, or none of them on a row that is a chat alone; chat beside any of them.
+// `validation` stands on the validation board's row only, beside process or run or alone.
 export const ActionItem = z.object({
     node: z.object({
         nodeId: NodeId,
@@ -92,14 +125,19 @@ export const ActionItem = z.object({
         boardKind: BoardShownKind.nullable(),
     }),
     section: ActionSection,
-    // Since when it waits: a task since it came into its column, a chat since its first unread
-    // message, a due process since its moment, an open run since it started.
+    // Since when it waits: a task since it came into its column (or its start date was reached), a
+    // chat since its first unread message, a due process since its moment, an open run since it
+    // started, a run that stands since its last task left Open or In progress, the tickets left in
+    // New since the run that found them ended.
     since: z.iso.datetime(),
     task: ActionTask.nullable(),
     chat: ActionChat.nullable(),
     process: ActionProcess.nullable(),
     run: ActionRun.nullable(),
     gadget: ActionGadget.nullable(),
+    // Absent on every row but the validation board's of the holder of `validator`, and there too
+    // once no ticket its latest run found lies in New any more.
+    validation: ActionValidation.optional(),
 });
 // What another package puts into a person's Actions (#334, E81, E82): "access invalid" for every
 // admin, "Operator paused" for its responsible person. Gathered when asked like every row, never
@@ -184,6 +222,12 @@ export function isNodeRow(row) {
 export const MachineInstructions = InstructionsLink.extend({
     version: z.int().min(1).nullable(),
 });
+// As `intelligence_action_list` answers them (E123, #677): whole with the digest of all four fields,
+// or only the reference when the machine sent that digest under `known`.
+export const MachineInstructionsRead = z.union([
+    MachineInstructions.extend({ digest: Digest }),
+    KnownText,
+]);
 export const ActionList = z.object({
     // Newest first by since, then by node id (a notice by package and noticeKey). The filters tasks
     // and chats leave the notices out.
@@ -193,6 +237,6 @@ export const ActionList = z.object({
     count: z.number().int(),
     // Only for a machine reading its own Actions over MCP, never over REST: the INSTRUCTIONS of its
     // root folder as one link of #39's chain with its version, empty when there is none (traps P033,
-    // P034).
-    instructions: MachineInstructions.optional(),
+    // P034); only the reference when it sent their digest under `known` (E123).
+    instructions: MachineInstructionsRead.optional(),
 });