@anchrd/colab-sdk 0.1.21 → 0.1.23

package/dist/actions/actions.js

@@ -7,7 +7,9 @@ import { Digest, InstructionsLink, Known, KnownText } from "../instructions/inst
 import { Limit as PageSize } from "../list-input.js";
 import { MessageAuthor, MessageId } from "../messages/messages.js";
 import { BoardShownKind, NodeId, NodeKind, NodePath } from "../nodes/nodes.js";
+import { OperatorRunId } from "../operators/operators.js";
 import { RunId, RunStatus } from "../runs/runs.js";
+import { SkillOffer } from "../skills/skills.js";
 import { UserId } from "../users/users.js";
 // Actions (#46, Seiten › Actions, E43, E67): one list over every board and chat with what waits on a
 // person. Every row is a node shown live, never a copy, and a node is one row, never two: a task of
@@ -18,7 +20,7 @@ export const ActionListInput = z.strictObject({
     filter: z
         .enum(actionFilters)
         .optional()
-        .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."),
+        .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."),
     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()
@@ -41,9 +43,12 @@ export const ActionTask = z.object({
     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
+    // Its start date was reached within the last 24 hours (E141): 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(),
+    // Its due date (`endsAt`) was reached within the last 24 hours (E141): "due today", like
+    // `startsToday`. Absent otherwise.
+    dueToday: z.literal(true).optional(),
 });
 export const ActionChat = z.object({
     // The messages of others not read yet, by the person themselves (not their AI).
@@ -78,8 +83,7 @@ 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.
+    // and their position; never another's. Empty without one.
     tasks: z.array(ActionRunTask),
     // Only for the responsible of the run's process, while the run waits on them (E124, E125).
     hint: ActionRunHint.optional(),
@@ -99,17 +103,8 @@ 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,
@@ -119,7 +114,8 @@ export const ActionItem = z.object({
         // A ticket of the validation board (#47) is called after its node, its crumb is the board.
         path: NodePath,
         // The validation status (#47): the type of the column the ticket of a document, table or file
-        // stands in, and a ticket's own; null for every other node.
+        // stands in, and a ticket's own; null for every other node. ⚠️ A ticket in New reads `backlog`
+        // (unchecked) although New is a column of type open (#814, E141).
         status: ColumnType.nullable(),
         // What a board is, like `NodeListItem.boardKind` (#227); null for every other kind.
         boardKind: BoardShownKind.nullable(),
@@ -127,17 +123,13 @@ export const ActionItem = z.object({
     section: ActionSection,
     // 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.
+    // started, a run that stands since its last task left Open or In progress.
     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
@@ -146,16 +138,33 @@ export const ActionItem = z.object({
 //
 // Every text is a closed word with its values, never a sentence (#379, E22): the UI words it in the
 // reader's language, and the AI reads the same structure.
-// What the notice is, for its icon: an access that stopped working, a paused Operator.
-export const ActionNoticeKind = z.enum(["credential", "paused"]);
+// A technical abort of an Operator's run (E141, #825): a timeout, a crash or a container that did
+// not start, a run without its closing result, an error of Colab's own, or a provider that failed
+// or set a limit. Never a wanted stop (the Operator waits, a person stops it, the budget or the
+// daily limit), and never a refused credential or a locked Operator, which have their own rows.
+export const ActionAbortReason = z.enum([
+    "timeout",
+    "crash",
+    "container",
+    "noresult",
+    "error",
+    "provider",
+]);
+// What the notice is, for its icon: an access that stopped working, a paused Operator, a run that
+// broke off for a technical reason (E141, #825).
+export const ActionNoticeKind = z.enum(["credential", "paused", "abort"]);
 // Its title: which notice, and the name it is about.
 export const ActionNoticeTitle = z.discriminatedUnion("text", [
     // "Access invalid: <the credential's name>".
     z.object({ text: z.literal("credentialInvalid"), name: z.string() }),
     // "Operator paused: daily limit reached".
     z.object({ text: z.literal("pausedLimit") }),
+    // "Monthly limit reached": a person's personal Operators pause (E143, #804).
+    z.object({ text: z.literal("pausedBudget") }),
     // "Operator paused: <failures> failures".
     z.object({ text: z.literal("pausedFailures"), failures: z.number().int().positive() }),
+    // "Run aborted: <reason>" (E141, #825).
+    z.object({ text: z.literal("runAborted"), reason: ActionAbortReason }),
 ]);
 // One step of the grey path below the title: a word the UI translates, or a name shown as it is.
 export const ActionNoticeCrumb = z.union([
@@ -180,6 +189,13 @@ export const ActionNoticeReason = z.object({
             limit: z.number().int().positive(),
             until: z.iso.datetime(),
         }),
+        // "<spentUsd> of <limitUsd> this month. Your Operators go on on <until>." (E143, #804)
+        z.object({
+            text: z.literal("budgetReached"),
+            spentUsd: z.number().nonnegative(),
+            limitUsd: z.number().nonnegative(),
+            until: z.iso.datetime(),
+        }),
         // "Last at <at>: <detail>", the last failed run; null without one.
         z.object({
             text: z.literal("lastFailure"),
@@ -190,9 +206,17 @@ export const ActionNoticeReason = z.object({
 });
 // A button of the row: its word and where it leads, a path within Colab. The first is the primary.
 export const ActionNoticeButton = z.object({
-    label: z.enum(["replaceCredential", "resume", "changeLimit", "viewLog"]),
+    label: z.enum(["replaceCredential", "resume", "changeLimit", "viewLog", "viewRun"]),
     href: z.string(),
 });
+// What the abort row carries over `/mcp` (Seiten › Actions): why, the run, and the cards the run
+// stood at that are still In progress, each with its rev, so the Operator tidies them up first when
+// it is woken next. The row itself wakes nobody and starts no run.
+export const ActionAbort = z.object({
+    reason: ActionAbortReason,
+    runId: OperatorRunId,
+    tasks: z.array(ActionRunTask),
+});
 export const ActionNotice = z.object({
     // The package that names it.
     package: z.enum(packages),
@@ -205,6 +229,8 @@ export const ActionNotice = z.object({
     // Where the row leads: the page of the access or the Operator, a path within Colab.
     href: z.string(),
     buttons: z.array(ActionNoticeButton).max(3),
+    // Only on a row of the kind `abort`; operator_run_update with read: true marks it read.
+    abort: ActionAbort.optional(),
 });
 export const ActionNoticeItem = z.object({
     notice: ActionNotice,
@@ -239,4 +265,8 @@ export const ActionList = z.object({
     // root folder as one link of #39's chain with its version, empty when there is none (traps P033,
     // P034); only the reference when it sent their digest under `known` (E123).
     instructions: MachineInstructionsRead.optional(),
+    // Only for a machine reading its own Actions over MCP (E140, #817): name and trigger of every
+    // readable skill with its trigger on, from `.Skills` and the folders above the nodes of its rows.
+    // An Operator gets them at the start of a run and decides itself which to load.
+    skills: z.array(SkillOffer).optional(),
 });

package/dist/boards/boards.d.ts

@@ -38,13 +38,13 @@ export declare const BoardCreateInput: z.ZodObject<{
             package: "package";
             target: "target";
             search: "search";
+            calendar: "calendar";
             flag: "flag";
             route: "route";
             "arrow-right": "arrow-right";
             "square-check": "square-check";
             "file-text": "file-text";
             bulb: "bulb";
-            calendar: "calendar";
             star: "star";
             bolt: "bolt";
             bug: "bug";
@@ -106,6 +106,24 @@ export declare const BoardUpdateInput: z.ZodObject<{
             sunday: "sunday";
         }>>>;
         dayOfMonth: z.ZodOptional<z.ZodArray<z.ZodInt>>;
+        weekdayOfMonth: z.ZodOptional<z.ZodObject<{
+            week: z.ZodEnum<{
+                first: "first";
+                last: "last";
+                second: "second";
+                third: "third";
+                fourth: "fourth";
+            }>;
+            day: z.ZodEnum<{
+                monday: "monday";
+                tuesday: "tuesday";
+                wednesday: "wednesday";
+                thursday: "thursday";
+                friday: "friday";
+                saturday: "saturday";
+                sunday: "sunday";
+            }>;
+        }, z.core.$strict>>;
         times: z.ZodOptional<z.ZodArray<z.ZodString>>;
         dates: z.ZodOptional<z.ZodArray<z.ZodString>>;
         zone: z.ZodOptional<z.ZodString>;
@@ -139,13 +157,13 @@ export declare const BoardUpdateInput: z.ZodObject<{
             package: "package";
             target: "target";
             search: "search";
+            calendar: "calendar";
             flag: "flag";
             route: "route";
             "arrow-right": "arrow-right";
             "square-check": "square-check";
             "file-text": "file-text";
             bulb: "bulb";
-            calendar: "calendar";
             star: "star";
             bolt: "bolt";
             bug: "bug";
@@ -194,6 +212,7 @@ export declare const BoardColumn: z.ZodObject<{
     }>;
     visible: z.ZodBoolean;
     description: z.ZodString;
+    system: z.ZodOptional<z.ZodLiteral<"new">>;
 }, z.core.$strip>;
 export type BoardColumn = z.infer<typeof BoardColumn>;
 export declare const BoardLabel: z.ZodObject<{
@@ -281,6 +300,24 @@ export declare const BoardDetail: z.ZodObject<{
             sunday: "sunday";
         }>>>;
         dayOfMonth: z.ZodOptional<z.ZodArray<z.ZodInt>>;
+        weekdayOfMonth: z.ZodOptional<z.ZodObject<{
+            week: z.ZodEnum<{
+                first: "first";
+                last: "last";
+                second: "second";
+                third: "third";
+                fourth: "fourth";
+            }>;
+            day: z.ZodEnum<{
+                monday: "monday";
+                tuesday: "tuesday";
+                wednesday: "wednesday";
+                thursday: "thursday";
+                friday: "friday";
+                saturday: "saturday";
+                sunday: "sunday";
+            }>;
+        }, z.core.$strict>>;
         times: z.ZodOptional<z.ZodArray<z.ZodString>>;
         dates: z.ZodOptional<z.ZodArray<z.ZodString>>;
         zone: z.ZodOptional<z.ZodString>;
@@ -363,6 +400,7 @@ export declare const BoardDetail: z.ZodObject<{
         }>;
         visible: z.ZodBoolean;
         description: z.ZodString;
+        system: z.ZodOptional<z.ZodLiteral<"new">>;
     }, z.core.$strip>>;
     cardKinds: z.ZodArray<z.ZodObject<{
         kindId: z.ZodTemplateLiteral<`kind_${string}`>;
@@ -373,13 +411,13 @@ export declare const BoardDetail: z.ZodObject<{
             package: "package";
             target: "target";
             search: "search";
+            calendar: "calendar";
             flag: "flag";
             route: "route";
             "arrow-right": "arrow-right";
             "square-check": "square-check";
             "file-text": "file-text";
             bulb: "bulb";
-            calendar: "calendar";
             star: "star";
             bolt: "bolt";
             bug: "bug";
@@ -609,13 +647,13 @@ export declare const BoardTaskItem: z.ZodObject<{
             package: "package";
             target: "target";
             search: "search";
+            calendar: "calendar";
             flag: "flag";
             route: "route";
             "arrow-right": "arrow-right";
             "square-check": "square-check";
             "file-text": "file-text";
             bulb: "bulb";
-            calendar: "calendar";
             star: "star";
             bolt: "bolt";
             bug: "bug";
@@ -636,6 +674,8 @@ export declare const BoardTaskItem: z.ZodObject<{
             board: "board";
             task: "task";
             gadget: "gadget";
+            goal: "goal";
+            skill: "skill";
         }>;
         path: z.ZodObject<{
             section: z.ZodEnum<{
@@ -709,13 +749,13 @@ export declare const BoardTaskList: z.ZodObject<{
                 package: "package";
                 target: "target";
                 search: "search";
+                calendar: "calendar";
                 flag: "flag";
                 route: "route";
                 "arrow-right": "arrow-right";
                 "square-check": "square-check";
                 "file-text": "file-text";
                 bulb: "bulb";
-                calendar: "calendar";
                 star: "star";
                 bolt: "bolt";
                 bug: "bug";
@@ -736,6 +776,8 @@ export declare const BoardTaskList: z.ZodObject<{
                 board: "board";
                 task: "task";
                 gadget: "gadget";
+                goal: "goal";
+                skill: "skill";
             }>;
             path: z.ZodObject<{
                 section: z.ZodEnum<{
@@ -779,6 +821,7 @@ export declare const BoardTaskList: z.ZodObject<{
         }>;
         visible: z.ZodBoolean;
         description: z.ZodString;
+        system: z.ZodOptional<z.ZodLiteral<"new">>;
     }, z.core.$strip>>>;
     template: z.ZodOptional<z.ZodObject<{
         message: z.ZodString;
@@ -840,6 +883,7 @@ export declare const BoardTaskBriefList: z.ZodObject<{
         }>;
         visible: z.ZodBoolean;
         description: z.ZodString;
+        system: z.ZodOptional<z.ZodLiteral<"new">>;
     }, z.core.$strip>>>;
     template: z.ZodOptional<z.ZodObject<{
         message: z.ZodString;
@@ -962,13 +1006,13 @@ export declare const TaskDetail: z.ZodObject<{
                     package: "package";
                     target: "target";
                     search: "search";
+                    calendar: "calendar";
                     flag: "flag";
                     route: "route";
                     "arrow-right": "arrow-right";
                     "square-check": "square-check";
                     "file-text": "file-text";
                     bulb: "bulb";
-                    calendar: "calendar";
                     star: "star";
                     bolt: "bolt";
                     bug: "bug";
@@ -1004,13 +1048,13 @@ export declare const TaskDetail: z.ZodObject<{
                 package: "package";
                 target: "target";
                 search: "search";
+                calendar: "calendar";
                 flag: "flag";
                 route: "route";
                 "arrow-right": "arrow-right";
                 "square-check": "square-check";
                 "file-text": "file-text";
                 bulb: "bulb";
-                calendar: "calendar";
                 star: "star";
                 bolt: "bolt";
                 bug: "bug";
@@ -1035,13 +1079,13 @@ export declare const TaskDetail: z.ZodObject<{
             package: "package";
             target: "target";
             search: "search";
+            calendar: "calendar";
             flag: "flag";
             route: "route";
             "arrow-right": "arrow-right";
             "square-check": "square-check";
             "file-text": "file-text";
             bulb: "bulb";
-            calendar: "calendar";
             star: "star";
             bolt: "bolt";
             bug: "bug";
@@ -1076,6 +1120,8 @@ export declare const TaskDetail: z.ZodObject<{
             board: "board";
             task: "task";
             gadget: "gadget";
+            goal: "goal";
+            skill: "skill";
         }>;
         name: z.ZodString;
         path: z.ZodObject<{
@@ -1161,6 +1207,7 @@ export declare const TaskDetail: z.ZodObject<{
         }>;
         visible: z.ZodBoolean;
         description: z.ZodString;
+        system: z.ZodOptional<z.ZodLiteral<"new">>;
         current: z.ZodBoolean;
     }, z.core.$strip>>>;
 }, z.core.$strip>;

package/dist/boards/boards.js

@@ -91,6 +91,9 @@ export const BoardColumn = z.object({
     visible: z.boolean(),
     // Markdown, empty without one (#624).
     description: z.string(),
+    // `new` on the validation board's New only (#814): a column of type open where every ticket starts,
+    // shown unchecked (grey, dashed) like the status of its tickets. Absent on every other column.
+    system: z.literal("new").optional(),
 });
 export const BoardLabel = z.object({ labelId: LabelId, name: z.string() });
 // What stands between a board and saving it as a process (#43): the UI shows a box for each, and the

package/dist/card-kinds/card-kinds.d.ts

@@ -23,13 +23,13 @@ export declare const CardKindIcon: z.ZodEnum<{
     package: "package";
     target: "target";
     search: "search";
+    calendar: "calendar";
     flag: "flag";
     route: "route";
     "arrow-right": "arrow-right";
     "square-check": "square-check";
     "file-text": "file-text";
     bulb: "bulb";
-    calendar: "calendar";
     star: "star";
     bolt: "bolt";
     bug: "bug";
@@ -70,13 +70,13 @@ export declare const CardKindInput: z.ZodObject<{
         package: "package";
         target: "target";
         search: "search";
+        calendar: "calendar";
         flag: "flag";
         route: "route";
         "arrow-right": "arrow-right";
         "square-check": "square-check";
         "file-text": "file-text";
         bulb: "bulb";
-        calendar: "calendar";
         star: "star";
         bolt: "bolt";
         bug: "bug";
@@ -115,13 +115,13 @@ export declare const CardKindsInput: z.ZodArray<z.ZodObject<{
         package: "package";
         target: "target";
         search: "search";
+        calendar: "calendar";
         flag: "flag";
         route: "route";
         "arrow-right": "arrow-right";
         "square-check": "square-check";
         "file-text": "file-text";
         bulb: "bulb";
-        calendar: "calendar";
         star: "star";
         bolt: "bolt";
         bug: "bug";
@@ -185,13 +185,13 @@ export declare const CardKind: z.ZodObject<{
         package: "package";
         target: "target";
         search: "search";
+        calendar: "calendar";
         flag: "flag";
         route: "route";
         "arrow-right": "arrow-right";
         "square-check": "square-check";
         "file-text": "file-text";
         bulb: "bulb";
-        calendar: "calendar";
         star: "star";
         bolt: "bolt";
         bug: "bug";
@@ -230,13 +230,13 @@ export declare const TaskKind: z.ZodObject<{
         package: "package";
         target: "target";
         search: "search";
+        calendar: "calendar";
         flag: "flag";
         route: "route";
         "arrow-right": "arrow-right";
         "square-check": "square-check";
         "file-text": "file-text";
         bulb: "bulb";
-        calendar: "calendar";
         star: "star";
         bolt: "bolt";
         bug: "bug";

package/dist/connections/connections.d.ts

@@ -3,8 +3,8 @@ export declare const ConnectionId: z.ZodTemplateLiteral<`connection_${string}`>;
 export declare const ConnectionState: z.ZodEnum<{
     expired: "expired";
     running: "running";
-    not_connected: "not_connected";
     unreachable: "unreachable";
+    not_connected: "not_connected";
 }>;
 export type ConnectionState = z.infer<typeof ConnectionState>;
 export declare const ConnectionListInput: z.ZodObject<{
@@ -49,8 +49,8 @@ export declare const Connection: z.ZodObject<{
     state: z.ZodEnum<{
         expired: "expired";
         running: "running";
-        not_connected: "not_connected";
         unreachable: "unreachable";
+        not_connected: "not_connected";
     }>;
     checkedAt: z.ZodNullable<z.ZodISODateTime>;
     expiredAt: z.ZodNullable<z.ZodISODateTime>;
@@ -70,8 +70,8 @@ export declare const ConnectionDetail: z.ZodObject<{
     state: z.ZodEnum<{
         expired: "expired";
         running: "running";
-        not_connected: "not_connected";
         unreachable: "unreachable";
+        not_connected: "not_connected";
     }>;
     checkedAt: z.ZodNullable<z.ZodISODateTime>;
     expiredAt: z.ZodNullable<z.ZodISODateTime>;
@@ -93,8 +93,8 @@ export declare const ConnectionList: z.ZodObject<{
         state: z.ZodEnum<{
             expired: "expired";
             running: "running";
-            not_connected: "not_connected";
             unreachable: "unreachable";
+            not_connected: "not_connected";
         }>;
         checkedAt: z.ZodNullable<z.ZodISODateTime>;
         expiredAt: z.ZodNullable<z.ZodISODateTime>;
@@ -125,8 +125,8 @@ export declare const ConnectionTested: z.ZodObject<{
         state: z.ZodEnum<{
             expired: "expired";
             running: "running";
-            not_connected: "not_connected";
             unreachable: "unreachable";
+            not_connected: "not_connected";
         }>;
         checkedAt: z.ZodNullable<z.ZodISODateTime>;
         expiredAt: z.ZodNullable<z.ZodISODateTime>;

package/dist/files/files.d.ts

@@ -50,8 +50,8 @@ export declare const fileTextStates: readonly ["reading", "done", "failed", "non
 export declare const FileTextState: z.ZodEnum<{
     done: "done";
     failed: "failed";
-    reading: "reading";
     none: "none";
+    reading: "reading";
 }>;
 export type FileTextState = z.infer<typeof FileTextState>;
 export declare const FileDetail: z.ZodObject<{
@@ -69,8 +69,8 @@ export declare const FileDetail: z.ZodObject<{
     textState: z.ZodEnum<{
         done: "done";
         failed: "failed";
-        reading: "reading";
         none: "none";
+        reading: "reading";
     }>;
     excerpt: z.ZodOptional<z.ZodObject<{
         offset: z.ZodNumber;