@anchrd/colab-sdk 0.1.16 → 0.1.18

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>;
@@ -43,6 +87,7 @@ export declare const BoardUpdateInput: z.ZodObject<{
         board: "board";
         process: "process";
     }>>;
+    responsibleId: z.ZodOptional<z.ZodNullable<z.ZodTemplateLiteral<`user_${string}`>>>;
     schedule: z.ZodOptional<z.ZodObject<{
         rhythm: z.ZodEnum<{
             manual: "manual";
@@ -92,6 +137,7 @@ export declare const BoardUpdateInput: z.ZodObject<{
             message: "message";
             user: "user";
             package: "package";
+            target: "target";
             search: "search";
             flag: "flag";
             route: "route";
@@ -99,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";
@@ -164,8 +209,49 @@ export declare const ProcessCheck: z.ZodObject<{
         userId: z.ZodString;
         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;
@@ -214,6 +300,38 @@ export declare const BoardDetail: z.ZodObject<{
             userId: z.ZodString;
             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;
@@ -223,6 +341,14 @@ export declare const BoardDetail: z.ZodObject<{
             human: "human";
         }>>;
     }, z.core.$strip>>;
+    responsible: z.ZodNullable<z.ZodObject<{
+        userId: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        kind: z.ZodNullable<z.ZodEnum<{
+            machine: "machine";
+            human: "human";
+        }>>;
+    }, z.core.$strip>>;
     columns: z.ZodArray<z.ZodObject<{
         columnId: z.ZodTemplateLiteral<`column_${string}`>;
         name: z.ZodString;
@@ -245,6 +371,7 @@ export declare const BoardDetail: z.ZodObject<{
             message: "message";
             user: "user";
             package: "package";
+            target: "target";
             search: "search";
             flag: "flag";
             route: "route";
@@ -252,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";
@@ -291,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}`>;
@@ -314,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<{
@@ -361,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<{
@@ -470,6 +607,7 @@ export declare const BoardTaskItem: z.ZodObject<{
             message: "message";
             user: "user";
             package: "package";
+            target: "target";
             search: "search";
             flag: "flag";
             route: "route";
@@ -477,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";
@@ -570,6 +707,7 @@ export declare const BoardTaskList: z.ZodObject<{
                 message: "message";
                 user: "user";
                 package: "package";
+                target: "target";
                 search: "search";
                 flag: "flag";
                 route: "route";
@@ -577,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";
@@ -621,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;
@@ -637,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}`>;
@@ -722,6 +960,7 @@ export declare const TaskDetail: z.ZodObject<{
                     message: "message";
                     user: "user";
                     package: "package";
+                    target: "target";
                     search: "search";
                     flag: "flag";
                     route: "route";
@@ -729,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";
@@ -764,6 +1002,7 @@ export declare const TaskDetail: z.ZodObject<{
                 message: "message";
                 user: "user";
                 package: "package";
+                target: "target";
                 search: "search";
                 flag: "flag";
                 route: "route";
@@ -771,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";
@@ -795,6 +1033,7 @@ export declare const TaskDetail: z.ZodObject<{
             message: "message";
             user: "user";
             package: "package";
+            target: "target";
             search: "search";
             flag: "flag";
             route: "route";
@@ -802,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";
@@ -902,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;

package/dist/boards/boards.js

@@ -2,10 +2,13 @@ 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 { 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";
+import { UserId } from "../users/users.js";
 import { TicketSubject, TicketSubjectRef } from "../validation/validation.js";
 import { TaskMove } from "../versions/versions.js";
 // Boards, their columns and labels, and tasks (#42, Nodes › Board, Nodes › Aufgabe, E38, E40, E41,
@@ -29,7 +32,7 @@ const RunRef = idSchema("run");
 export const boardKinds = ["board", "process"];
 export const BoardKind = z
     .enum(boardKinds)
-    .describe("board: a board people work on. process: a template whose runs the Operator works through, each a copy of its columns and tasks; it needs a machine (an Operator) with write on it, a first column of type backlog, and every task of the template in that first column.");
+    .describe("board: a board people work on. process: a template whose runs the Operator works through, each a copy of its columns and tasks; it needs a machine (an Operator) with write on it, a first column of type backlog, every task of the template in that first column, and a responsible who writes on it (or none).");
 const Name = z.string().max(200);
 // A column's description (#624), Markdown for every AI working on the board.
 const ColumnDescription = z.string().max(20_000);
@@ -52,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 });
@@ -61,9 +66,13 @@ const BoardInstruction = z.string().max(200_000);
 export const BoardUpdateInput = z.strictObject({
     boardId: BoardId,
     rev: Rev,
-    kind: BoardKind.optional().describe("Make the board a process or a board again. Saving a process is refused with conflict while no machine can write on the board, the first column is not of type backlog, or a task of the template stands outside the first column."),
+    kind: BoardKind.optional().describe("Make the board a process or a board again. Saving a process is refused with conflict while no machine can write on the board, the first column is not of type backlog, a task of the template stands outside the first column, or its responsible no longer writes on the board."),
+    // E125: a process has one responsible, a board none.
+    responsibleId: UserId.nullable()
+        .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
@@ -97,6 +106,27 @@ export const ProcessCheck = z.object({
     // whom the settings offer "Für Operator freigeben". Empty when there is none. Readable with the board,
     // without any right in `access`.
     operators: z.array(z.object({ userId: z.string(), name: z.string() })),
+    // 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,
@@ -116,6 +146,8 @@ export const BoardDetail = z.object({
     // Who carries the validation (E79, #378): the holder of the role `validator` while they can act,
     // for every reader of the validation board; null without one and for every other board.
     validator: NodePerson.nullable(),
+    // Who is responsible for a process (E125); null for nobody and on every board that is no process.
+    responsible: NodePerson.nullable(),
     columns: z.array(BoardColumn),
     // The card kinds with their fields in order (#638, E115); empty on a board of free cards.
     cardKinds: z.array(CardKind),
@@ -123,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
@@ -130,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({
@@ -146,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
@@ -174,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 = {
@@ -224,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,
@@ -318,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,
@@ -379,8 +430,8 @@ 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(),