@anchrd/colab-sdk 0.1.17 → 0.1.19

package/dist/boards/boards.d.ts

@@ -29,6 +29,50 @@ export declare const BoardCreateInput: z.ZodObject<{
         visible: z.ZodOptional<z.ZodBoolean>;
         description: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>>;
+    cardKinds: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kindId: z.ZodOptional<z.ZodTemplateLiteral<`kind_${string}`>>;
+        name: z.ZodString;
+        icon: z.ZodOptional<z.ZodEnum<{
+            message: "message";
+            user: "user";
+            package: "package";
+            target: "target";
+            search: "search";
+            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";
+            rocket: "rocket";
+        }>>;
+        description: z.ZodOptional<z.ZodString>;
+        standard: z.ZodOptional<z.ZodBoolean>;
+        fields: z.ZodArray<z.ZodObject<{
+            fieldId: z.ZodOptional<z.ZodTemplateLiteral<`field_${string}`>>;
+            name: z.ZodString;
+            type: z.ZodEnum<{
+                number: "number";
+                date: "date";
+                list: "list";
+                link: "link";
+                text: "text";
+                checklist: "checklist";
+                select: "select";
+            }>;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            visible: z.ZodOptional<z.ZodBoolean>;
+            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                optionId: z.ZodOptional<z.ZodTemplateLiteral<`option_${string}`>>;
+                name: z.ZodString;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>;
     idempotencyKey: z.ZodString;
 }, z.core.$strict>;
 export type BoardCreateInput = z.infer<typeof BoardCreateInput>;
@@ -93,6 +137,7 @@ export declare const BoardUpdateInput: z.ZodObject<{
             message: "message";
             user: "user";
             package: "package";
+            target: "target";
             search: "search";
             flag: "flag";
             route: "route";
@@ -100,7 +145,6 @@ export declare const BoardUpdateInput: z.ZodObject<{
             "square-check": "square-check";
             "file-text": "file-text";
             bulb: "bulb";
-            target: "target";
             calendar: "calendar";
             star: "star";
             bolt: "bolt";
@@ -166,8 +210,48 @@ export declare const ProcessCheck: z.ZodObject<{
         name: z.ZodString;
     }, z.core.$strip>>;
     responsibleWrites: z.ZodBoolean;
+    missing: z.ZodArray<z.ZodObject<{
+        code: z.ZodEnum<{
+            test_failed: "test_failed";
+            no_role: "no_role";
+            no_folder: "no_folder";
+            credential_invalid: "credential_invalid";
+            incomplete: "incomplete";
+            no_right: "no_right";
+            no_kind: "no_kind";
+            no_assignee: "no_assignee";
+            no_machine: "no_machine";
+        }>;
+        machineId: z.ZodOptional<z.ZodTemplateLiteral<`user_${string}`>>;
+        credentialId: z.ZodOptional<z.ZodTemplateLiteral<`credential_${string}`>>;
+        connectorId: z.ZodOptional<z.ZodString>;
+        connectionId: z.ZodOptional<z.ZodTemplateLiteral<`connection_${string}`>>;
+        taskId: z.ZodOptional<z.ZodTemplateLiteral<`node_${string}`>>;
+        documentId: z.ZodOptional<z.ZodTemplateLiteral<`node_${string}`>>;
+        userId: z.ZodOptional<z.ZodTemplateLiteral<`user_${string}`>>;
+        nodeId: z.ZodOptional<z.ZodTemplateLiteral<`node_${string}`>>;
+        message: z.ZodString;
+        right: z.ZodOptional<z.ZodString>;
+        givenBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            userId: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>>;
+        call: z.ZodOptional<z.ZodObject<{
+            tool: z.ZodString;
+            arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ProcessCheck = z.infer<typeof ProcessCheck>;
+export declare const TemplateNote: z.ZodObject<{
+    message: z.ZodString;
+    runs: z.ZodArray<z.ZodObject<{
+        runId: z.ZodTemplateLiteral<`run_${string}`>;
+        startedAt: z.ZodISODateTime;
+        dueAt: z.ZodNullable<z.ZodISODateTime>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type TemplateNote = z.infer<typeof TemplateNote>;
 export declare const BoardDetail: z.ZodObject<{
     boardId: z.ZodTemplateLiteral<`node_${string}`>;
     name: z.ZodString;
@@ -217,6 +301,37 @@ export declare const BoardDetail: z.ZodObject<{
             name: z.ZodString;
         }, z.core.$strip>>;
         responsibleWrites: z.ZodBoolean;
+        missing: z.ZodArray<z.ZodObject<{
+            code: z.ZodEnum<{
+                test_failed: "test_failed";
+                no_role: "no_role";
+                no_folder: "no_folder";
+                credential_invalid: "credential_invalid";
+                incomplete: "incomplete";
+                no_right: "no_right";
+                no_kind: "no_kind";
+                no_assignee: "no_assignee";
+                no_machine: "no_machine";
+            }>;
+            machineId: z.ZodOptional<z.ZodTemplateLiteral<`user_${string}`>>;
+            credentialId: z.ZodOptional<z.ZodTemplateLiteral<`credential_${string}`>>;
+            connectorId: z.ZodOptional<z.ZodString>;
+            connectionId: z.ZodOptional<z.ZodTemplateLiteral<`connection_${string}`>>;
+            taskId: z.ZodOptional<z.ZodTemplateLiteral<`node_${string}`>>;
+            documentId: z.ZodOptional<z.ZodTemplateLiteral<`node_${string}`>>;
+            userId: z.ZodOptional<z.ZodTemplateLiteral<`user_${string}`>>;
+            nodeId: z.ZodOptional<z.ZodTemplateLiteral<`node_${string}`>>;
+            message: z.ZodString;
+            right: z.ZodOptional<z.ZodString>;
+            givenBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                userId: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strip>>>;
+            call: z.ZodOptional<z.ZodObject<{
+                tool: z.ZodString;
+                arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
     validator: z.ZodNullable<z.ZodObject<{
         userId: z.ZodString;
@@ -256,6 +371,7 @@ export declare const BoardDetail: z.ZodObject<{
             message: "message";
             user: "user";
             package: "package";
+            target: "target";
             search: "search";
             flag: "flag";
             route: "route";
@@ -263,7 +379,6 @@ export declare const BoardDetail: z.ZodObject<{
             "square-check": "square-check";
             "file-text": "file-text";
             bulb: "bulb";
-            target: "target";
             calendar: "calendar";
             star: "star";
             bolt: "bolt";
@@ -302,8 +417,17 @@ export declare const BoardDetail: z.ZodObject<{
     }, z.core.$strip>;
     rev: z.ZodNumber;
     updatedAt: z.ZodISODateTime;
+    template: z.ZodOptional<z.ZodObject<{
+        message: z.ZodString;
+        runs: z.ZodArray<z.ZodObject<{
+            runId: z.ZodTemplateLiteral<`run_${string}`>;
+            startedAt: z.ZodISODateTime;
+            dueAt: z.ZodNullable<z.ZodISODateTime>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type BoardDetail = z.infer<typeof BoardDetail>;
+export declare const compactTaskLimit = 50;
 export declare const maxBulkTasks = 100;
 export declare const BoardTaskListInput: z.ZodObject<{
     boardId: z.ZodTemplateLiteral<`node_${string}`>;
@@ -325,6 +449,7 @@ export declare const BoardTaskListInput: z.ZodObject<{
     content: z.ZodOptional<z.ZodPreprocess<z.ZodBoolean, unknown>>;
     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 BoardTaskListInput = z.infer<typeof BoardTaskListInput>;
 export declare const BoardTaskCreateInput: z.ZodObject<{
@@ -372,6 +497,7 @@ export declare const BoardTaskCreated: z.ZodObject<{
 export type BoardTaskCreated = z.infer<typeof BoardTaskCreated>;
 export declare const TaskGetInput: z.ZodObject<{
     taskId: z.ZodTemplateLiteral<`node_${string}`>;
+    known: z.ZodOptional<z.ZodPreprocess<z.ZodArray<z.ZodString>, unknown>>;
 }, z.core.$strict>;
 export type TaskGetInput = z.infer<typeof TaskGetInput>;
 export declare const TaskUpdateInput: z.ZodObject<{
@@ -481,6 +607,7 @@ export declare const BoardTaskItem: z.ZodObject<{
             message: "message";
             user: "user";
             package: "package";
+            target: "target";
             search: "search";
             flag: "flag";
             route: "route";
@@ -488,7 +615,6 @@ export declare const BoardTaskItem: z.ZodObject<{
             "square-check": "square-check";
             "file-text": "file-text";
             bulb: "bulb";
-            target: "target";
             calendar: "calendar";
             star: "star";
             bolt: "bolt";
@@ -581,6 +707,7 @@ export declare const BoardTaskList: z.ZodObject<{
                 message: "message";
                 user: "user";
                 package: "package";
+                target: "target";
                 search: "search";
                 flag: "flag";
                 route: "route";
@@ -588,7 +715,6 @@ export declare const BoardTaskList: z.ZodObject<{
                 "square-check": "square-check";
                 "file-text": "file-text";
                 bulb: "bulb";
-                target: "target";
                 calendar: "calendar";
                 star: "star";
                 bolt: "bolt";
@@ -632,7 +758,13 @@ export declare const BoardTaskList: z.ZodObject<{
         content: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     nextCursor: z.ZodNullable<z.ZodString>;
-    instruction: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    instruction: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+        digest: z.ZodString;
+        markdown: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        digest: z.ZodString;
+        known: z.ZodLiteral<true>;
+    }, z.core.$strip>]>>>;
     columns: z.ZodOptional<z.ZodArray<z.ZodObject<{
         columnId: z.ZodTemplateLiteral<`column_${string}`>;
         name: z.ZodString;
@@ -648,8 +780,103 @@ export declare const BoardTaskList: z.ZodObject<{
         visible: z.ZodBoolean;
         description: z.ZodString;
     }, z.core.$strip>>>;
+    template: z.ZodOptional<z.ZodObject<{
+        message: z.ZodString;
+        runs: z.ZodArray<z.ZodObject<{
+            runId: z.ZodTemplateLiteral<`run_${string}`>;
+            startedAt: z.ZodISODateTime;
+            dueAt: z.ZodNullable<z.ZodISODateTime>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type BoardTaskList = z.infer<typeof BoardTaskList>;
+export declare const BoardTaskBrief: z.ZodObject<{
+    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>;
+    taskId: z.ZodTemplateLiteral<`node_${string}`>;
+    rev: z.ZodNumber;
+    title: z.ZodString;
+    assignee: z.ZodObject<{
+        userId: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        kind: z.ZodNullable<z.ZodEnum<{
+            machine: "machine";
+            human: "human";
+        }>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type BoardTaskBrief = z.infer<typeof BoardTaskBrief>;
+export declare const BoardTaskBriefList: z.ZodObject<{
+    nextCursor: z.ZodNullable<z.ZodString>;
+    instruction: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+        digest: z.ZodString;
+        markdown: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        digest: z.ZodString;
+        known: z.ZodLiteral<true>;
+    }, z.core.$strip>]>>>;
+    columns: z.ZodOptional<z.ZodArray<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";
+        }>;
+        visible: z.ZodBoolean;
+        description: z.ZodString;
+    }, z.core.$strip>>>;
+    template: z.ZodOptional<z.ZodObject<{
+        message: z.ZodString;
+        runs: z.ZodArray<z.ZodObject<{
+            runId: z.ZodTemplateLiteral<`run_${string}`>;
+            startedAt: z.ZodISODateTime;
+            dueAt: z.ZodNullable<z.ZodISODateTime>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    items: z.ZodArray<z.ZodObject<{
+        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>;
+        taskId: z.ZodTemplateLiteral<`node_${string}`>;
+        rev: z.ZodNumber;
+        title: z.ZodString;
+        assignee: z.ZodObject<{
+            userId: z.ZodString;
+            name: z.ZodNullable<z.ZodString>;
+            kind: z.ZodNullable<z.ZodEnum<{
+                machine: "machine";
+                human: "human";
+            }>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type BoardTaskBriefList = z.infer<typeof BoardTaskBriefList>;
 export declare const TaskDetail: z.ZodObject<{
     taskId: z.ZodTemplateLiteral<`node_${string}`>;
     boardId: z.ZodTemplateLiteral<`node_${string}`>;
@@ -733,6 +960,7 @@ export declare const TaskDetail: z.ZodObject<{
                     message: "message";
                     user: "user";
                     package: "package";
+                    target: "target";
                     search: "search";
                     flag: "flag";
                     route: "route";
@@ -740,7 +968,6 @@ export declare const TaskDetail: z.ZodObject<{
                     "square-check": "square-check";
                     "file-text": "file-text";
                     bulb: "bulb";
-                    target: "target";
                     calendar: "calendar";
                     star: "star";
                     bolt: "bolt";
@@ -775,6 +1002,7 @@ export declare const TaskDetail: z.ZodObject<{
                 message: "message";
                 user: "user";
                 package: "package";
+                target: "target";
                 search: "search";
                 flag: "flag";
                 route: "route";
@@ -782,7 +1010,6 @@ export declare const TaskDetail: z.ZodObject<{
                 "square-check": "square-check";
                 "file-text": "file-text";
                 bulb: "bulb";
-                target: "target";
                 calendar: "calendar";
                 star: "star";
                 bolt: "bolt";
@@ -806,6 +1033,7 @@ export declare const TaskDetail: z.ZodObject<{
             message: "message";
             user: "user";
             package: "package";
+            target: "target";
             search: "search";
             flag: "flag";
             route: "route";
@@ -813,7 +1041,6 @@ export declare const TaskDetail: z.ZodObject<{
             "square-check": "square-check";
             "file-text": "file-text";
             bulb: "bulb";
-            target: "target";
             calendar: "calendar";
             star: "star";
             bolt: "bolt";
@@ -913,7 +1140,13 @@ export declare const TaskDetail: z.ZodObject<{
     archivedAt: z.ZodNullable<z.ZodISODateTime>;
     createdAt: z.ZodISODateTime;
     updatedAt: z.ZodISODateTime;
-    instruction: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    instruction: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+        digest: z.ZodString;
+        markdown: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        digest: z.ZodString;
+        known: z.ZodLiteral<true>;
+    }, z.core.$strip>]>>>;
     columns: z.ZodOptional<z.ZodArray<z.ZodObject<{
         columnId: z.ZodTemplateLiteral<`column_${string}`>;
         name: z.ZodString;
@@ -932,14 +1165,3 @@ export declare const TaskDetail: z.ZodObject<{
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type TaskDetail = z.infer<typeof TaskDetail>;
-export declare const TaskSaved: z.ZodObject<{
-    taskId: z.ZodTemplateLiteral<`node_${string}`>;
-    rev: z.ZodNumber;
-    warnings: z.ZodArray<z.ZodObject<{
-        code: z.ZodEnum<{
-            followup_failed: "followup_failed";
-        }>;
-        message: z.ZodString;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export type TaskSaved = z.infer<typeof TaskSaved>;

package/dist/boards/boards.js

@@ -1,9 +1,10 @@
 import { z } from "zod";
 import { CardKind, CardKindsInput, TaskFields, TaskFieldsInput, TaskKind, TaskKindInput, } from "../card-kinds/card-kinds.js";
 import { ColumnId, ColumnType, TaskColumn } from "../columns/columns.js";
-import { Warning } from "../error/error.js";
 import { idSchema } from "../ids/ids.js";
+import { InstructionRead, Known } from "../instructions/instructions.js";
 import { Flag } from "../list-input.js";
+import { Missing } from "../missing/missing.js";
 import { BoardShownKind, BoardSystem, NodeId, NodePerson } from "../nodes/nodes.js";
 import { IdempotencyKey, Rev } from "../primitives/primitives.js";
 import { Schedule } from "../schedule/schedule.js";
@@ -54,7 +55,9 @@ export const BoardCreateInput = z.strictObject({
     // ⚠️ Required and nullable (trap C015): null is the top level of Shared.
     parentId: NodeId.nullable().describe("The folder to create the board in, one you can write to; null creates it on the top level of Shared, visible to you until you share it."),
     name: Name.describe("The board's name as people read it."),
-    columns: Columns.optional().describe("The board's columns in their order, without columnId. Exactly one of type archive, last. Leaving it out gives Backlog, Open, In progress, Done and Archive, named in your language."),
+    columns: Columns.optional().describe("The board's columns in their order, without columnId, each with its description if it has one. Exactly one of type archive, last. Leaving it out gives Backlog, Open, In progress, Done and Archive, named in your language."),
+    // #675: a copied template has its kinds with the create, not with a second call.
+    cardKinds: CardKindsInput.optional().describe("The board's card kinds in their order, each with its fields, as intelligence_board_update takes them but without kindId, fieldId and optionId. The first is the standard unless one says standard. Leaving it out makes a board of free cards."),
     idempotencyKey: IdempotencyKey,
 });
 export const BoardGetInput = z.strictObject({ boardId: BoardId });
@@ -69,7 +72,7 @@ export const BoardUpdateInput = z.strictObject({
         .optional()
         .describe("The process's responsible: a person or machine who writes on the board, `user_…`; null for nobody, then whoever made it a process gets the hints. They get the start of a run and a run that stands as an Action and open its first checkpoints. Only with a process. Leaving it out keeps it; a board made a process without one gets whoever makes it a process, when they write on it."),
     schedule: Schedule.optional().describe("When a run of the process or of the validation falls due (Ausführung). Leaving it out keeps it; a board made a process without one runs by hand."),
-    instruction: BoardInstruction.optional().describe("The board's instruction, Markdown: what the board is about and how every AI working on it goes about it. It comes along with every read of the board and its tasks over MCP. On the validation board only an admin in admin mode changes it. An empty text removes it; leaving it out keeps it."),
+    instruction: BoardInstruction.optional().describe("The board's instruction, Markdown: what the board is about and how every AI working on it goes about it. It comes along with every read of the board and its tasks over MCP, as only its digest where the read sends that digest under known. On the validation board only an admin in admin mode changes it. An empty text removes it; leaving it out keeps it."),
     columns: Columns.optional(),
     cardKinds: CardKindsInput.optional(),
     labels: z
@@ -106,6 +109,24 @@ export const ProcessCheck = z.object({
     // The process's responsible writes on the board (E125); true without one and on a board that is
     // no process.
     responsibleWrites: z.boolean(),
+    // The template check of a process (#675): what a run of its template needs and Colab can check
+    // without knowing what a field means, each entry with the card's `taskId`: a card without a kind
+    // on a board with kinds, an empty required field, an assignee who is gone or does not write on the
+    // board, a node a link field names that the assignee cannot read. The same entries a save of the
+    // process and a template card's create answer under `missing`. Empty on a board that is no process.
+    missing: z.array(Missing),
+});
+// A process read without `runId` is its template, not a run (#678): said so over MCP, with the runs
+// that run now, so an AI works on a run's cards and not on the template's. Absent on a board that is
+// no process, and with `runId`.
+export const TemplateNote = z.object({
+    message: z.string(),
+    runs: z.array(z.object({
+        runId: RunRef,
+        startedAt: z.iso.datetime(),
+        // The moment of the schedule the run stands for; null for one started by hand.
+        dueAt: z.iso.datetime().nullable(),
+    })),
 });
 export const BoardDetail = z.object({
     boardId: NodeId,
@@ -134,6 +155,8 @@ export const BoardDetail = z.object({
     rights: z.object({ write: z.boolean() }),
     rev: z.number().int(),
     updatedAt: z.iso.datetime(),
+    // Over MCP only, on a process (#678): this is the template, and the runs that run now.
+    template: TemplateNote.optional(),
 });
 // The most one page of a board's tasks holds: a board is read whole for the kanban.
 const TaskLimit = z.coerce
@@ -141,7 +164,10 @@ const TaskLimit = z.coerce
     .int()
     .min(1)
     .max(500)
-    .describe("How many tasks one page holds, 1 to 500. Leaving it out gives 200. With content at most 100, and leaving it out gives 100.");
+    .describe("How many tasks one page holds, 1 to 500. Leaving it out gives 50 over MCP and 200 over the API. With content at most 100, and leaving it out gives 100.");
+// Over MCP a page without `content` holds this many tasks unless `limit` says otherwise (E127,
+// #674); the board view, a gadget and every other caller keep 200.
+export const compactTaskLimit = 50;
 // The most tasks one call reads by id, creates or changes (#625, E114).
 export const maxBulkTasks = 100;
 export const BoardTaskListInput = z.strictObject({
@@ -157,13 +183,14 @@ export const BoardTaskListInput = z.strictObject({
         .preprocess((value) => (typeof value === "string" ? value.split(",") : value), z.array(TaskId).min(1).max(maxBulkTasks))
         .optional()
         .describe("Only these tasks of the board (of the run, with runId), 1 to 100, also from the archive column: one you cannot read or that is not there is left out without a note."),
-    content: Flag.optional().describe("true: every task also carries its Markdown text as content, beside its rev, so you check a whole board without reading task by task. A page then holds at most 100 tasks."),
+    content: Flag.optional().describe("true: every task comes whole, with its dates, labels, subtask depth, readiness, images, card kind and fields, and its Markdown text as content, so you check a whole board without reading task by task. A page then holds at most 100 tasks. Without it each task is compact: taskId, title, column, assignee and rev."),
     cursor: z
         .string()
         .max(1000)
         .optional()
         .describe("The nextCursor of the previous page, unchanged. Leaving it out starts at the top."),
     limit: TaskLimit.optional(),
+    known: Known.optional(),
 });
 const Title = z.string().max(500).describe("The task's title.");
 const Content = z
@@ -185,7 +212,7 @@ const Position = z
     .string()
     .min(1)
     .max(100)
-    .describe("The place in the column: a fractional-indexing key between the positions of the neighbours, as intelligence_board_task_list returns them. Leaving it out puts the task at the end of its column.");
+    .describe("The place in the column: a fractional-indexing key between the positions of the neighbours, as intelligence_board_task_list returns them with content: true, or intelligence_task_get. Leaving it out puts the task at the end of its column.");
 const Assignee = idSchema("user").describe("The one person responsible for the task, someone who can read the board. Leaving it out on create makes it you, on a process the first machine that can write on it.");
 // The fields of one new task, alone or as an entry of `tasks` (#625).
 const newTask = {
@@ -235,7 +262,7 @@ export const BoardTaskCreateInput = z.strictObject({
 export const BoardTaskCreated = z.object({
     tasks: z.array(z.object({ ref: z.string(), taskId: NodeId, rev: z.number().int() })),
 });
-export const TaskGetInput = z.strictObject({ taskId: TaskId });
+export const TaskGetInput = z.strictObject({ taskId: TaskId, known: Known.optional() });
 export const TaskUpdateInput = z.strictObject({
     taskId: TaskId,
     rev: Rev,
@@ -329,12 +356,25 @@ export const BoardTaskList = z.object({
     items: z.array(BoardTaskItem),
     nextCursor: z.string().nullable(),
     // Over MCP only (E87, #354): the board's instruction, a run's copy of it with `runId`; null
-    // without one.
-    instruction: z.string().nullable().optional(),
+    // without one, the reference when known (E123, #677).
+    instruction: InstructionRead.optional(),
     // Over MCP only (#624): every column of the board (of the run, with `runId`) in order, with its
     // description, once per page.
     columns: z.array(BoardColumn).optional(),
+    // Over MCP only, on a process without `runId` (#678): these are the template's cards, and the runs
+    // that run now.
+    template: TemplateNote.optional(),
+});
+// A card as the list answers it over MCP without `content` (E127, #674): what finds a card and moves
+// it on, without its text and the rest of the card.
+export const BoardTaskBrief = BoardTaskItem.pick({
+    taskId: true,
+    title: true,
+    column: true,
+    assignee: true,
+    rev: true,
 });
+export const BoardTaskBriefList = BoardTaskList.extend({ items: z.array(BoardTaskBrief) });
 // A subtask or a task waited for; `kind` its card kind (#638), null without one.
 const TaskRef = z.object({
     taskId: NodeId,
@@ -390,16 +430,9 @@ export const TaskDetail = z.object({
     createdAt: z.iso.datetime(),
     updatedAt: z.iso.datetime(),
     // Over MCP only (E87, #354): the instruction of the task's board, of its run for a run's task;
-    // null without one.
-    instruction: z.string().nullable().optional(),
+    // null without one, the reference when known (E123, #677).
+    instruction: InstructionRead.optional(),
     // Over MCP only (#624): every column of the task's board (of its run for a run's task) in order,
     // with its description; `current` marks the task's own.
     columns: z.array(BoardColumn.extend({ current: z.boolean() })).optional(),
 });
-// `intelligence_task_update` in place of the task when the change is saved and a step after the
-// save failed (#623): the task's id, the rev for its next change and the warning that says so.
-export const TaskSaved = z.object({
-    taskId: NodeId,
-    rev: z.number().int(),
-    warnings: z.array(Warning),
-});

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

@@ -21,6 +21,7 @@ export declare const CardKindIcon: z.ZodEnum<{
     message: "message";
     user: "user";
     package: "package";
+    target: "target";
     search: "search";
     flag: "flag";
     route: "route";
@@ -28,7 +29,6 @@ export declare const CardKindIcon: z.ZodEnum<{
     "square-check": "square-check";
     "file-text": "file-text";
     bulb: "bulb";
-    target: "target";
     calendar: "calendar";
     star: "star";
     bolt: "bolt";
@@ -68,6 +68,7 @@ export declare const CardKindInput: z.ZodObject<{
         message: "message";
         user: "user";
         package: "package";
+        target: "target";
         search: "search";
         flag: "flag";
         route: "route";
@@ -75,7 +76,6 @@ export declare const CardKindInput: z.ZodObject<{
         "square-check": "square-check";
         "file-text": "file-text";
         bulb: "bulb";
-        target: "target";
         calendar: "calendar";
         star: "star";
         bolt: "bolt";
@@ -113,6 +113,7 @@ export declare const CardKindsInput: z.ZodArray<z.ZodObject<{
         message: "message";
         user: "user";
         package: "package";
+        target: "target";
         search: "search";
         flag: "flag";
         route: "route";
@@ -120,7 +121,6 @@ export declare const CardKindsInput: z.ZodArray<z.ZodObject<{
         "square-check": "square-check";
         "file-text": "file-text";
         bulb: "bulb";
-        target: "target";
         calendar: "calendar";
         star: "star";
         bolt: "bolt";
@@ -183,6 +183,7 @@ export declare const CardKind: z.ZodObject<{
         message: "message";
         user: "user";
         package: "package";
+        target: "target";
         search: "search";
         flag: "flag";
         route: "route";
@@ -190,7 +191,6 @@ export declare const CardKind: z.ZodObject<{
         "square-check": "square-check";
         "file-text": "file-text";
         bulb: "bulb";
-        target: "target";
         calendar: "calendar";
         star: "star";
         bolt: "bolt";
@@ -228,6 +228,7 @@ export declare const TaskKind: z.ZodObject<{
         message: "message";
         user: "user";
         package: "package";
+        target: "target";
         search: "search";
         flag: "flag";
         route: "route";
@@ -235,7 +236,6 @@ export declare const TaskKind: z.ZodObject<{
         "square-check": "square-check";
         "file-text": "file-text";
         bulb: "bulb";
-        target: "target";
         calendar: "calendar";
         star: "star";
         bolt: "bolt";