@anchrd/colab-sdk 0.1.10 → 0.1.12

package/dist/runs/runs.d.ts

@@ -32,50 +32,15 @@ export declare const BoardRunCreateInput: z.ZodObject<{
     idempotencyKey: z.ZodString;
 }, z.core.$strict>;
 export type BoardRunCreateInput = z.infer<typeof BoardRunCreateInput>;
-export declare const DashboardRunCreateInput: z.ZodObject<{
-    dashboardId: z.ZodTemplateLiteral<`node_${string}`>;
-    idempotencyKey: z.ZodString;
-}, z.core.$strict>;
-export type DashboardRunCreateInput = z.infer<typeof DashboardRunCreateInput>;
-export declare const RunUpdateInput: z.ZodObject<{
-    runId: z.ZodTemplateLiteral<`run_${string}`>;
-    values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    yaml: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-export type RunUpdateInput = z.infer<typeof RunUpdateInput>;
 export declare const RunCompleteInput: z.ZodObject<{
     runId: z.ZodTemplateLiteral<`run_${string}`>;
     summary: z.ZodOptional<z.ZodString>;
-    values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    yaml: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type RunCompleteInput = z.infer<typeof RunCompleteInput>;
-export declare const RunValueValue: z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodNull]>;
-export type RunValueValue = z.infer<typeof RunValueValue>;
-export declare const RunValue: z.ZodObject<{
-    metrics: z.ZodRecord<z.ZodString, z.ZodObject<{
-        value: z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodNull]>;
-        source: z.ZodNullable<z.ZodString>;
-        node: z.ZodNullable<z.ZodObject<{
-            nodeId: z.ZodTemplateLiteral<`node_${string}`>;
-            name: z.ZodString;
-        }, z.core.$strip>>;
-        parameter: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        report: z.ZodNullable<z.ZodString>;
-        recommendation: z.ZodNullable<z.ZodString>;
-    }, z.core.$strip>>;
-    summaries: z.ZodRecord<z.ZodString, z.ZodObject<{
-        text: z.ZodNullable<z.ZodString>;
-        report: z.ZodNullable<z.ZodString>;
-        recommendation: z.ZodNullable<z.ZodString>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export type RunValue = z.infer<typeof RunValue>;
 export declare const RunItem: z.ZodObject<{
     runId: z.ZodTemplateLiteral<`run_${string}`>;
     nodeId: z.ZodTemplateLiteral<`node_${string}`>;
     kind: z.ZodEnum<{
-        dashboard: "dashboard";
         validation: "validation";
         process: "process";
     }>;
@@ -105,9 +70,6 @@ export declare const RunItem: z.ZodObject<{
         }>>;
     }, z.core.$strip>>;
     summary: z.ZodNullable<z.ZodString>;
-    values: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodNull]>>>;
-    summaries: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
-    reports: z.ZodNullable<z.ZodNumber>;
     rights: z.ZodObject<{
         complete: z.ZodBoolean;
     }, z.core.$strip>;
@@ -118,7 +80,6 @@ export declare const RunList: z.ZodObject<{
         runId: z.ZodTemplateLiteral<`run_${string}`>;
         nodeId: z.ZodTemplateLiteral<`node_${string}`>;
         kind: z.ZodEnum<{
-            dashboard: "dashboard";
             validation: "validation";
             process: "process";
         }>;
@@ -148,9 +109,6 @@ export declare const RunList: z.ZodObject<{
             }>>;
         }, z.core.$strip>>;
         summary: z.ZodNullable<z.ZodString>;
-        values: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodNull]>>>;
-        summaries: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
-        reports: z.ZodNullable<z.ZodNumber>;
         rights: z.ZodObject<{
             complete: z.ZodBoolean;
         }, z.core.$strip>;
@@ -182,38 +140,54 @@ export declare const RunDetail: z.ZodObject<{
         }>;
         tasks: z.ZodNumber;
     }, z.core.$strip>>>;
-    entries: z.ZodNullable<z.ZodObject<{
-        metrics: z.ZodRecord<z.ZodString, z.ZodObject<{
-            value: z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodNull]>;
-            source: z.ZodNullable<z.ZodString>;
-            node: z.ZodNullable<z.ZodObject<{
-                nodeId: z.ZodTemplateLiteral<`node_${string}`>;
+    cardKinds: z.ZodNullable<z.ZodArray<z.ZodObject<{
+        kindId: z.ZodTemplateLiteral<`kind_${string}`>;
+        name: z.ZodString;
+        icon: z.ZodEnum<{
+            message: "message";
+            user: "user";
+            package: "package";
+            search: "search";
+            flag: "flag";
+            route: "route";
+            "arrow-right": "arrow-right";
+            "square-check": "square-check";
+            "file-text": "file-text";
+            bulb: "bulb";
+            target: "target";
+            calendar: "calendar";
+            star: "star";
+            bolt: "bolt";
+            bug: "bug";
+            rocket: "rocket";
+        }>;
+        description: z.ZodString;
+        standard: z.ZodBoolean;
+        fields: z.ZodArray<z.ZodObject<{
+            fieldId: 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.ZodString;
+            required: z.ZodBoolean;
+            visible: z.ZodBoolean;
+            options: z.ZodArray<z.ZodObject<{
+                optionId: z.ZodTemplateLiteral<`option_${string}`>;
                 name: z.ZodString;
             }, z.core.$strip>>;
-            parameter: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-            report: z.ZodNullable<z.ZodString>;
-            recommendation: z.ZodNullable<z.ZodString>;
-        }, z.core.$strip>>;
-        summaries: z.ZodRecord<z.ZodString, z.ZodObject<{
-            text: z.ZodNullable<z.ZodString>;
-            report: z.ZodNullable<z.ZodString>;
-            recommendation: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>>;
-    }, z.core.$strip>>;
-    assignees: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodObject<{
-        userId: z.ZodString;
-        name: z.ZodNullable<z.ZodString>;
-        kind: z.ZodNullable<z.ZodEnum<{
-            machine: "machine";
-            human: "human";
-        }>>;
-    }, z.core.$strip>>>>;
-    template: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>;
     instruction: z.ZodNullable<z.ZodString>;
     runId: z.ZodTemplateLiteral<`run_${string}`>;
     nodeId: z.ZodTemplateLiteral<`node_${string}`>;
     kind: z.ZodEnum<{
-        dashboard: "dashboard";
         validation: "validation";
         process: "process";
     }>;
@@ -243,9 +217,6 @@ export declare const RunDetail: z.ZodObject<{
         }>>;
     }, z.core.$strip>>;
     summary: z.ZodNullable<z.ZodString>;
-    values: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodNull]>>>;
-    summaries: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
-    reports: z.ZodNullable<z.ZodNumber>;
     rights: z.ZodObject<{
         complete: z.ZodBoolean;
     }, z.core.$strip>;

package/dist/runs/runs.js

@@ -1,24 +1,23 @@
 import { z } from "zod";
 import { BoardId } from "../boards/boards.js";
+import { CardKind } from "../card-kinds/card-kinds.js";
 import { ColumnId, ColumnType } from "../columns/columns.js";
-import { DashboardId } from "../dashboards/dashboards.js";
 import { idSchema } from "../ids/ids.js";
 import { Limit } from "../list-input.js";
 import { NodeId, NodePerson } from "../nodes/nodes.js";
 import { IdempotencyKey } from "../primitives/primitives.js";
-// Runs of a process board and of a dashboard (#43, Funktionen › Läufe, Nodes › Board › Prozess,
-// Nodes › Dashboard, E42, E45, E67, E70): the inputs of `intelligence_run_list`, `_get`,
-// `intelligence_board_run_create`, `intelligence_dashboard_run_create`, `intelligence_run_complete`,
-// and the answers. A run is a sub-resource of its board or dashboard when it is made, and a resource
-// of its own afterwards.
-export const RunId = idSchema("run").describe("The run's id, `run_…`, as intelligence_board_run_create, intelligence_dashboard_run_create or intelligence_run_list returned it.");
+// Runs of a process board and of the validation (#43, Funktionen › Läufe, Nodes › Board › Prozess,
+// E42, E45, E67, E70, E119): the inputs of `intelligence_run_list`, `_get`,
+// `intelligence_board_run_create`, `intelligence_run_complete`, and the answers. A run is a
+// sub-resource of its board when it is made, and a resource of its own afterwards.
+export const RunId = idSchema("run").describe("The run's id, `run_…`, as intelligence_board_run_create or intelligence_run_list returned it.");
 export const runStatuses = ["running", "done", "open", "error"];
 export const RunStatus = z
     .enum(runStatuses)
-    .describe("The run's status, set by Colab from its result, never by the caller: running (started, not completed), done (a process: every task in a done, discarded or archive column; a dashboard: every value and summary there, no report; the validation: no ticket in a column of type open waits on a person), open (a process: a task not in such a column; a dashboard: at least one report; the validation: a ticket in a column of type open is assigned to a person), error (a process: a task in a blocked column; a dashboard and the validation never err, an invalid run is not taken).");
+    .describe("The run's status, set by Colab from its result, never by the caller: running (started, not completed), done (a process: every task in a done, discarded or archive column; the validation: no ticket in a column of type open waits on a person), open (a process: a task not in such a column; the validation: a ticket in a column of type open is assigned to a person), error (a process: a task in a blocked column; the validation never errs).");
 const Moment = z.iso.datetime({ offset: true });
 export const RunListInput = z.strictObject({
-    nodeId: NodeId.describe("The process board or dashboard whose runs to list, one you can read. Runs never stand in the tree."),
+    nodeId: NodeId.describe("The process board or the validation board whose runs to list, one you can read. Runs never stand in the tree."),
     status: RunStatus.optional().describe("Only the runs with this status."),
     from: Moment.optional().describe("Only the runs started at or after this moment, ISO 8601."),
     to: Moment.optional().describe("Only the runs started at or before this moment, ISO 8601."),
@@ -34,61 +33,16 @@ export const BoardRunCreateInput = z.strictObject({
     boardId: BoardId.describe("The process board to start a run of, one you can write to. The run is a copy of its columns and of every task of the template, all in the first column."),
     idempotencyKey: IdempotencyKey,
 });
-export const DashboardRunCreateInput = z.strictObject({
-    dashboardId: DashboardId.describe("The dashboard to start a run of, one you can write to. The run keeps a copy of the configuration as it is now and answers its template."),
-    idempotencyKey: IdempotencyKey,
-});
 const Text = z.string().max(20_000);
-const RunValues = z
-    .record(z.string(), z.unknown())
-    .optional()
-    .describe("A dashboard run's entries as an object, the shape of the template of intelligence_run_get: metrics (value, source, parameter, report, recommendation) and summaries (text, report, recommendation), each under its key. Send at most one of values and yaml.");
-const RunYaml = z
-    .string()
-    .max(200_000)
-    .optional()
-    .describe("A dashboard run's entries as YAML text, the template of intelligence_run_get filled in. Send at most one of values and yaml.");
-// A dashboard run is filled by its assignees, each their own entries (E78, Nodes › Dashboard,
-// Zuständig je Kennzahl): the run closes by itself once every entry is there.
-export const RunUpdateInput = z.strictObject({
-    runId: RunId,
-    values: RunValues.describe("Your entries of a dashboard run as an object: metrics and summaries assigned to you (and those without anybody, where you can write on the dashboard), each under its key with value and source, or text, and a report and a recommendation where something is worth saying. Send exactly one of values and yaml."),
-    yaml: RunYaml.describe("Your entries of a dashboard run as YAML text, the template of intelligence_run_get filled in. Send exactly one of values and yaml."),
-});
 export const RunCompleteInput = z.strictObject({
     runId: RunId,
     summary: Text.optional().describe("What the run did, in a few sentences: what people read in the list of runs."),
-    values: RunValues.describe("Only for a dashboard: the last entries you may write, as an object, before it closes. Entries nobody wrote stay missing and the run is open. Send at most one of values and yaml, neither for a process."),
-    yaml: RunYaml.describe("Only for a dashboard: the last entries you may write, as YAML text, before it closes. Send at most one of values and yaml, neither for a process."),
-});
-// A value as a run stores it: a number, a short text, or null when it is missing.
-export const RunValueValue = z.union([z.number(), z.string(), z.null()]);
-// ⚠️ The entries of a dashboard run as records under their key, the shape the Operator sent
-// (`DashboardRun`), never as a list with a field `key`: `/mcp` strikes every field called `key` as a
-// secret (`redactSecrets` in `shared`), and the answer would name no metric.
-export const RunValue = z.object({
-    metrics: z.record(z.string(), z.object({
-        value: RunValueValue,
-        source: z.string().nullable(),
-        // The node a source `colab://node_…` names, when the caller can read it; null for a tool,
-        // and for a node that is gone or the caller cannot read: then neither its id nor its name,
-        // and `source` is null too (#165).
-        node: z.object({ nodeId: NodeId, name: z.string() }).nullable(),
-        parameter: z.record(z.string(), z.unknown()).nullable(),
-        report: z.string().nullable(),
-        recommendation: z.string().nullable(),
-    })),
-    summaries: z.record(z.string(), z.object({
-        text: z.string().nullable(),
-        report: z.string().nullable(),
-        recommendation: z.string().nullable(),
-    })),
 });
 export const RunItem = z.object({
     runId: RunId,
     nodeId: NodeId,
     // A validation run (#47) copies nothing and carries only its summary.
-    kind: z.enum(["process", "dashboard", "validation"]),
+    kind: z.enum(["process", "validation"]),
     status: RunStatus,
     // The moment of the schedule this run stands for, null for a run started by hand.
     dueAt: z.iso.datetime().nullable(),
@@ -97,16 +51,8 @@ export const RunItem = z.object({
     completedAt: z.iso.datetime().nullable(),
     completedBy: NodePerson.nullable(),
     summary: z.string().nullable(),
-    // A dashboard's value per metric key, one row of its table; null for a process.
-    values: z.record(z.string(), RunValueValue).nullable(),
-    // A dashboard's summary text per summary key, cut to 280 characters for a cell of its table, null
-    // where the Operator wrote none; null for a process. The whole text is in `entries` of
-    // intelligence_run_get (#164).
-    summaries: z.record(z.string(), z.string().nullable()).nullable(),
-    // A dashboard's count of values and summaries that carry a report; null for a process (#164).
-    reports: z.number().int().nullable(),
     // `complete`: whether the caller may close this run with intelligence_run_complete, by the same
-    // check the tool makes (E107): write on a process board or dashboard; on the validation the holder
+    // check the tool makes (E107): write on a process board; on the validation the holder
     // of validator or an admin in admin mode. The UI shows "Lauf beenden" by it.
     rights: z.object({ complete: z.boolean() }),
 });
@@ -128,14 +74,9 @@ export const RunDetail = z.object({
         tasks: z.number().int(),
     }))
         .nullable(),
-    // A dashboard run: every value and summary with where it came from, in the configuration's order.
-    entries: RunValue.nullable(),
-    // A dashboard run: who delivers each metric and summary, by key, as the configuration said when
-    // the run started (E78); null where nobody does. Null for a process.
-    assignees: z.record(z.string(), NodePerson.nullable()).nullable(),
-    // A dashboard run while it runs: the YAML of the entries the caller may write and has not written
-    // yet, to fill in and send to intelligence_run_update; null when there is none.
-    template: z.string().nullable(),
-    // The instruction of the board or dashboard as the run started (E87, #354); null without one.
+    // A process run: the card kinds it copied when it started, with their fields (#638); empty for a
+    // run of a board without kinds, null for the validation.
+    cardKinds: z.array(CardKind).nullable(),
+    // The instruction of the board as the run started (E87, #354); null without one.
     instruction: z.string().nullable(),
 });

package/dist/schedule/schedule.d.ts

@@ -0,0 +1,36 @@
+import { z } from "zod";
+export declare const rhythms: readonly ["manual", "daily", "weekly", "monthly", "dates"];
+export declare const weekdays: readonly ["monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday"];
+export declare const whileOpenModes: readonly ["wait", "continue"];
+export declare const WhileOpen: z.ZodEnum<{
+    wait: "wait";
+    continue: "continue";
+}>;
+export type WhileOpen = z.infer<typeof WhileOpen>;
+export declare const Schedule: z.ZodObject<{
+    rhythm: z.ZodEnum<{
+        manual: "manual";
+        daily: "daily";
+        weekly: "weekly";
+        monthly: "monthly";
+        dates: "dates";
+    }>;
+    days: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        monday: "monday";
+        tuesday: "tuesday";
+        wednesday: "wednesday";
+        thursday: "thursday";
+        friday: "friday";
+        saturday: "saturday";
+        sunday: "sunday";
+    }>>>;
+    dayOfMonth: z.ZodOptional<z.ZodArray<z.ZodInt>>;
+    times: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    dates: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    zone: z.ZodOptional<z.ZodString>;
+    whileOpen: z.ZodOptional<z.ZodEnum<{
+        wait: "wait";
+        continue: "continue";
+    }>>;
+}, z.core.$strict>;
+export type Schedule = z.infer<typeof Schedule>;

package/dist/schedule/schedule.js

@@ -0,0 +1,93 @@
+import { z } from "zod";
+import { TimeZone } from "../profile/profile.js";
+// The schedule (Ausführung) of a process board and the validation (#43, Funktionen › Läufe): when a
+// run falls due and what happens while the last one is still open.
+export const rhythms = ["manual", "daily", "weekly", "monthly", "dates"];
+export const weekdays = [
+    "monday",
+    "tuesday",
+    "wednesday",
+    "thursday",
+    "friday",
+    "saturday",
+    "sunday",
+];
+// No seconds and no zone on the string: a run happens at eight, and the zone is the schedule's own.
+// `24:00` is refused rather than read as midnight, so one moment has one spelling (anchrd/intel
+// `contract/process.ts`, f4eccd16).
+const TimeOfDay = z
+    .string()
+    .regex(/^([01]\d|2[0-3]):[0-5]\d$/, "A time of day is HH:MM, from 00:00 to 23:59, like 08:00.");
+// A fixed moment on the wall clock of the schedule's zone, without seconds and without an offset.
+const LocalMoment = z
+    .string()
+    .regex(/^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])T([01]\d|2[0-3]):[0-5]\d$/, "A date is YYYY-MM-DDTHH:MM on the schedule's clock, like 2026-10-15T08:00.");
+// Which fields each rhythm takes; every other one is refused, so nothing lies stored that no rhythm
+// reads.
+const rhythmFields = {
+    manual: [],
+    daily: ["times"],
+    weekly: ["days", "times"],
+    monthly: ["dayOfMonth", "times"],
+    dates: ["dates"],
+};
+const scheduleFields = ["days", "dayOfMonth", "times", "dates"];
+// What happens when a run falls due while the last one is still open (E75, Funktionen › Läufe):
+// wait (the default) starts none until the last is completed, continue starts it anyway and the
+// open ones stay open.
+export const whileOpenModes = ["wait", "continue"];
+export const WhileOpen = z
+    .enum(whileOpenModes)
+    .describe("When the last run is still open: wait (the default) starts no new run until it is completed, and the process stands overdue in the Actions; continue starts the new run anyway, and the open ones stay open.");
+export const Schedule = z
+    .strictObject({
+    rhythm: z
+        .enum(rhythms)
+        .describe("How often a run falls due: manual (a person starts it), daily, weekly (on days), monthly (on dayOfMonth), or dates (fixed moments, each once)."),
+    days: z
+        .array(z.enum(weekdays))
+        .min(1)
+        .max(7)
+        .optional()
+        .describe("The weekdays of a weekly rhythm, like [monday, thursday]. Only with weekly."),
+    dayOfMonth: z
+        .array(z.int().min(1).max(31))
+        .min(1)
+        .max(31)
+        .optional()
+        .describe("The days of the month of a monthly rhythm, like [1, 15]. A month without that day is skipped, never moved to its last day. Only with monthly."),
+    times: z
+        .array(TimeOfDay)
+        .min(1)
+        .max(24)
+        .optional()
+        .describe("The times of day a daily, weekly or monthly run falls due, HH:MM in zone, like [08:00]."),
+    dates: z
+        .array(LocalMoment)
+        .min(1)
+        .max(200)
+        .optional()
+        .describe("The fixed moments of the rhythm dates, YYYY-MM-DDTHH:MM in zone, each falling due once. Only with dates."),
+    zone: TimeZone.optional().describe("The IANA time zone the times and dates are read in, like Europe/Berlin. Leaving it out takes the time zone of the creator of the process board."),
+    whileOpen: WhileOpen.optional().describe("When the last run is still open: wait starts no new run until it is completed, continue starts it anyway and the open ones stay open. Leaving it out is wait."),
+})
+    .superRefine((schedule, ctx) => {
+    const wanted = rhythmFields[schedule.rhythm];
+    for (const field of scheduleFields) {
+        const present = schedule[field] !== undefined;
+        if (wanted.includes(field) && !present) {
+            ctx.addIssue({
+                code: "custom",
+                path: [field],
+                message: `A ${schedule.rhythm} rhythm needs ${field}${field === "times" ? ", like [08:00]" : ""}.`,
+            });
+        }
+        if (!wanted.includes(field) && present) {
+            ctx.addIssue({
+                code: "custom",
+                path: [field],
+                message: `${field} belongs to ${field === "times" ? "a daily, weekly or monthly" : `a ${Object.entries(rhythmFields).find(([, fields]) => fields.includes(field))?.[0]}`} rhythm, not to ${schedule.rhythm}; leave it out.`,
+            });
+        }
+    }
+});

package/dist/sdk.d.ts

@@ -1,20 +1,21 @@
-export { ActionChat, ActionItem, ActionList, ActionListInput, ActionNotice, ActionNoticeButton, ActionNoticeCrumb, ActionNoticeItem, ActionNoticeKind, ActionNoticeReason, ActionNoticeTitle, ActionProcess, ActionRow, ActionRun, ActionSection, ActionTask, actionFilters, isNodeRow, MachineInstructions, } from "./actions/actions.js";
+export { ActionChat, ActionGadget, ActionItem, ActionList, ActionListInput, ActionNotice, ActionNoticeButton, ActionNoticeCrumb, ActionNoticeItem, ActionNoticeKind, ActionNoticeReason, ActionNoticeTitle, ActionProcess, ActionRow, ActionRun, ActionSection, ActionTask, actionFilters, isNodeRow, MachineInstructions, } from "./actions/actions.js";
 export { adminModeHeader, adminModeOn } from "./admin-mode.js";
 export { App, AppId, AppList, AppListInput, AppRevoked, AppRevokeInput, OwnAppListQuery, OwnSessionListQuery, Session, SessionId, SessionList, SessionListInput, SessionRevokeInput, SessionsRevoked, } from "./apps/apps.js";
 export { NodeArchived, NodeArchiveInput, NodePurged, NodePurgeInput, NodeRestoreInput, } from "./archive/archive.js";
 export { PasskeyDeleteInput, SetPasswordInput, SignUpInput, } from "./auth/auth.js";
 export { AuthorizationRequest, AuthorizationResponse, Identity, Rules, } from "./authorization/authorization.js";
-export { BoardColumn, BoardCreateInput, BoardDetail, BoardGetInput, BoardId, BoardKind, BoardLabel, BoardTaskCreateInput, BoardTaskItem, BoardTaskList, BoardTaskListInput, BoardUpdateInput, boardKinds, LabelId, ProcessCheck, TaskDetail, TaskGetInput, TaskId, TaskImage, TaskUpdateInput, } from "./boards/boards.js";
+export { BoardColumn, BoardCreateInput, BoardDetail, BoardGetInput, BoardId, BoardKind, BoardLabel, BoardTaskCreated, BoardTaskCreateInput, BoardTaskItem, BoardTaskList, BoardTaskListInput, BoardTaskUpdated, BoardTaskUpdateInput, BoardUpdateInput, boardKinds, LabelId, maxBulkTasks, ProcessCheck, TaskDetail, TaskGetInput, TaskId, TaskImage, TaskUpdateInput, } from "./boards/boards.js";
+export { CardField, CardFieldId, CardFieldInput, CardFieldOption, CardFieldType, CardFieldValue, CardKind, CardKindIcon, CardKindId, CardKindInput, CardOptionId, ChecklistItem, cardFieldTypes, cardKindIcons, emptyValue, TaskFields, TaskKind, } from "./card-kinds/card-kinds.js";
 export { ColumnId, ColumnType, columnTypes, TaskColumn } from "./columns/columns.js";
 export { Connection, ConnectionCreateInput, ConnectionCredential, ConnectionDetail, ConnectionGetInput, ConnectionId, ConnectionList, ConnectionListInput, ConnectionRevokeInput, ConnectionState, ConnectionTested, ConnectionTestInput, ConnectionTestResult, ConnectionUpdateInput, } from "./connections/connections.js";
 export { Call, CallId, CallList, CallListInput, CallSource, Connector, ConnectorField, ConnectorGetInput, ConnectorId, ConnectorList, ConnectorListInput, ConnectorTool, } from "./connectors/connectors.js";
-export { type BoxType, boxTypes, chartTypes, type DashboardBox, DashboardConfig, DashboardCreateInput, DashboardDetail, DashboardGetInput, DashboardId, DashboardKey, DashboardRun, DashboardUpdateInput, rhythms, Schedule, WhileOpen, weekdays, whileOpenModes, } from "./dashboards/dashboards.js";
 export { DirectoryPrincipal, DirectorySearchInput } from "./directory/directory.js";
 export { DocumentCreateInput, DocumentDetail, DocumentGetInput, DocumentUpdateInput, } from "./documents/documents.js";
 export { ErrorCode, ErrorIssue, ErrorResponse, errorCodes } from "./error/error.js";
 export { ActorKind, Event, EventId, EventKind, EventList, EventListInput, } from "./events/events.js";
 export { FileCreateInput, FileDetail, type FileFormat, FileGetInput, FileId, FileTextState, FileUpdateInput, FileUpload, fileFormatExtensions, fileFormatOf, fileTextStates, maxFileBytes, UploadTicket, uploadTicketHeader, uploadTicketLifetimeMs, } from "./files/files.js";
 export { FunctionRemoved, ServiceInterfaceFunctionCreateInput, ServiceInterfaceFunctionRemoveInput, ServiceInterfaceFunctionUpdateInput, } from "./functions/functions.js";
+export { GadgetCall, GadgetCallCreateInput, GadgetCallEntry, GadgetCallGetInput, GadgetCallItem, GadgetCallList, GadgetCallListInput, GadgetCallStatus, GadgetChange, GadgetClientLog, GadgetConsoleLine, GadgetCreateInput, GadgetDetail, GadgetFile, GadgetFilePath, GadgetFunction, GadgetFunctionName, GadgetGetInput, GadgetLevel, GadgetManifest, GadgetPublishInput, GadgetSettings, GadgetTestInput, GadgetTestResult, GadgetTestRun, GadgetToolUse, GadgetUpdateInput, GadgetVersionRef, gadgetLimits, gadgetLogDays, } from "./gadgets/gadgets.js";
 export { type Action, actions, hasRoute, isAction, isPackage, isWord, type Package, packages, parseConnectorFunction, parseToolName, type Resource, type Route, resources, type ToolName, toolEvent, toolPermission, toolRoute, toolSchemaName, verbs, } from "./grammar/grammar.js";
 export { GrantId, GrantRight, NodeGrant, NodeGrantList, NodeGrantListInput, NodeGrantRevoked, NodeGrantRevokeInput, NodeShared, NodeShareInput, } from "./grants/grants.js";
 export { createId, type Id, idSchema } from "./ids/ids.js";
@@ -31,8 +32,9 @@ export { PageDetail, PageGetInput, PageHead, PageHeading, PageId, PageList, Page
 export { IdempotencyKey, Rev } from "./primitives/primitives.js";
 export { Locale, locales, Name, ProfileImageResponse, ProfileUpdateInput, profileImageMaxBytes, profileImageTypes, Theme, TimeZone, themes, } from "./profile/profile.js";
 export { GrantChange, PermissionsResponse, RightInCode, RightPath, RightTree, Role, RoleArchiveInput, RoleCreateInput, RoleDetail, RoleGetInput, RoleGrantCreateInput, RoleGrantRevokeInput, RoleId, RoleList, RoleListInput, RoleRestoreInput, RoleUpdateInput, } from "./roles/roles.js";
-export { BoardRunCreateInput, DashboardRunCreateInput, RunCompleteInput, RunDetail, RunGetInput, RunId, RunItem, RunList, RunListInput, RunStatus, RunUpdateInput, RunValue, RunValueValue, runStatuses, } from "./runs/runs.js";
+export { BoardRunCreateInput, RunCompleteInput, RunDetail, RunGetInput, RunId, RunItem, RunList, RunListInput, RunStatus, runStatuses, } from "./runs/runs.js";
 export { RuntimeConfig } from "./runtime-config.js";
+export { rhythms, Schedule, WhileOpen, weekdays, whileOpenModes } from "./schedule/schedule.js";
 export { NodeSecret, NodeSecretCreateInput, NodeSecretDetail, NodeSecretGetInput, NodeSecretRemoveInput, NodeSecretUpdateInput, NodeUnlocked, NodeUnlockInput, unlockMinutes, } from "./secrets/secrets.js";
 export { type Authorized, type AuthorizeResult, createServiceClient, type InterfaceDeclaredResult, type InterfaceRemovedResult, type ServiceClient, type ServiceClientDeps, type ServiceClientFailure, } from "./service-client/service-client.js";
 export { FunctionId, InterfaceId, RightWord, Service, ServiceArchiveInput, ServiceCreateInput, ServiceFunction, ServiceId, ServiceInterface, ServiceKeyIssued, ServiceList, ServiceListInput, ServiceName, ServicePurged, ServicePurgeInput, ServiceRestoreInput, ServiceRotateInput, ServiceUpdateInput, } from "./services/services.js";
@@ -41,5 +43,5 @@ export { TableColumn, TableColumnChange, TableColumnType, TableCreateInput, Tabl
 export { type Actor, defineTool, type Permission, type Tool, type ToolAnnotations, type ToolContext, type ToolInput, type ToolSource, } from "./tool.js";
 export { IntelligenceUserGetInput, IntelligenceUserUpdateInput, NotifyMode, notifyModes, UserSettings, } from "./user-settings/user-settings.js";
 export { MachineFacts, MachineKeyFacts, MachineKind, MessageMachine, OperatorProvider, OwnRoleList, SignInMethod, User, UserDetail, UserDisableInput, UserEnableInput, UserGetInput, UserId, UserKind, UserList, UserListInput, UserListItem, UserStatus, UserTestInput, UserTestResult, UserUpdateInput, } from "./users/users.js";
-export { TicketColumn, TicketMove, TicketSubject, TicketSubjectRef, ValidationBoardId, validationBoardId, } from "./validation/validation.js";
-export { NodeVersion, NodeVersionCreateInput, NodeVersionDetail, NodeVersionGetInput, NodeVersionList, NodeVersionListInput, VersionId, versionKinds, } from "./versions/versions.js";
+export { TicketSubject, TicketSubjectRef, ValidationBoardId, validationBoardId, } from "./validation/validation.js";
+export { MoveColumn, NodeVersion, NodeVersionCreateInput, NodeVersionDetail, NodeVersionGetInput, NodeVersionList, NodeVersionListInput, TaskMove, TaskVersionChange, taskVersionChanges, VersionId, VersionMove, versionKinds, } from "./versions/versions.js";

package/dist/sdk.js

@@ -1,23 +1,24 @@
 // The contract between UI, backends and outside services, published as `@anchrd/colab-sdk`. The
 // package exports only this file, so everything public is named here once.
 // biome-ignore lint/performance/noBarrelFile: this file IS the entry point of the package.
-export { ActionChat, ActionItem, ActionList, ActionListInput, ActionNotice, ActionNoticeButton, ActionNoticeCrumb, ActionNoticeItem, ActionNoticeKind, ActionNoticeReason, ActionNoticeTitle, ActionProcess, ActionRow, ActionRun, ActionSection, ActionTask, actionFilters, isNodeRow, MachineInstructions, } from "./actions/actions.js";
+export { ActionChat, ActionGadget, ActionItem, ActionList, ActionListInput, ActionNotice, ActionNoticeButton, ActionNoticeCrumb, ActionNoticeItem, ActionNoticeKind, ActionNoticeReason, ActionNoticeTitle, ActionProcess, ActionRow, ActionRun, ActionSection, ActionTask, actionFilters, isNodeRow, MachineInstructions, } from "./actions/actions.js";
 export { adminModeHeader, adminModeOn } from "./admin-mode.js";
 export { App, AppId, AppList, AppListInput, AppRevoked, AppRevokeInput, OwnAppListQuery, OwnSessionListQuery, Session, SessionId, SessionList, SessionListInput, SessionRevokeInput, SessionsRevoked, } from "./apps/apps.js";
 export { NodeArchived, NodeArchiveInput, NodePurged, NodePurgeInput, NodeRestoreInput, } from "./archive/archive.js";
 export { PasskeyDeleteInput, SetPasswordInput, SignUpInput, } from "./auth/auth.js";
 export { AuthorizationRequest, AuthorizationResponse, Identity, Rules, } from "./authorization/authorization.js";
-export { BoardColumn, BoardCreateInput, BoardDetail, BoardGetInput, BoardId, BoardKind, BoardLabel, BoardTaskCreateInput, BoardTaskItem, BoardTaskList, BoardTaskListInput, BoardUpdateInput, boardKinds, LabelId, ProcessCheck, TaskDetail, TaskGetInput, TaskId, TaskImage, TaskUpdateInput, } from "./boards/boards.js";
+export { BoardColumn, BoardCreateInput, BoardDetail, BoardGetInput, BoardId, BoardKind, BoardLabel, BoardTaskCreated, BoardTaskCreateInput, BoardTaskItem, BoardTaskList, BoardTaskListInput, BoardTaskUpdated, BoardTaskUpdateInput, BoardUpdateInput, boardKinds, LabelId, maxBulkTasks, ProcessCheck, TaskDetail, TaskGetInput, TaskId, TaskImage, TaskUpdateInput, } from "./boards/boards.js";
+export { CardField, CardFieldId, CardFieldInput, CardFieldOption, CardFieldType, CardFieldValue, CardKind, CardKindIcon, CardKindId, CardKindInput, CardOptionId, ChecklistItem, cardFieldTypes, cardKindIcons, emptyValue, TaskFields, TaskKind, } from "./card-kinds/card-kinds.js";
 export { ColumnId, ColumnType, columnTypes, TaskColumn } from "./columns/columns.js";
 export { Connection, ConnectionCreateInput, ConnectionCredential, ConnectionDetail, ConnectionGetInput, ConnectionId, ConnectionList, ConnectionListInput, ConnectionRevokeInput, ConnectionState, ConnectionTested, ConnectionTestInput, ConnectionTestResult, ConnectionUpdateInput, } from "./connections/connections.js";
 export { Call, CallId, CallList, CallListInput, CallSource, Connector, ConnectorField, ConnectorGetInput, ConnectorId, ConnectorList, ConnectorListInput, ConnectorTool, } from "./connectors/connectors.js";
-export { boxTypes, chartTypes, DashboardConfig, DashboardCreateInput, DashboardDetail, DashboardGetInput, DashboardId, DashboardKey, DashboardRun, DashboardUpdateInput, rhythms, Schedule, WhileOpen, weekdays, whileOpenModes, } from "./dashboards/dashboards.js";
 export { DirectoryPrincipal, DirectorySearchInput } from "./directory/directory.js";
 export { DocumentCreateInput, DocumentDetail, DocumentGetInput, DocumentUpdateInput, } from "./documents/documents.js";
 export { ErrorCode, ErrorIssue, ErrorResponse, errorCodes } from "./error/error.js";
 export { ActorKind, Event, EventId, EventKind, EventList, EventListInput, } from "./events/events.js";
 export { FileCreateInput, FileDetail, FileGetInput, FileId, FileTextState, FileUpdateInput, FileUpload, fileFormatExtensions, fileFormatOf, fileTextStates, maxFileBytes, UploadTicket, uploadTicketHeader, uploadTicketLifetimeMs, } from "./files/files.js";
 export { FunctionRemoved, ServiceInterfaceFunctionCreateInput, ServiceInterfaceFunctionRemoveInput, ServiceInterfaceFunctionUpdateInput, } from "./functions/functions.js";
+export { GadgetCall, GadgetCallCreateInput, GadgetCallEntry, GadgetCallGetInput, GadgetCallItem, GadgetCallList, GadgetCallListInput, GadgetCallStatus, GadgetChange, GadgetClientLog, GadgetConsoleLine, GadgetCreateInput, GadgetDetail, GadgetFile, GadgetFilePath, GadgetFunction, GadgetFunctionName, GadgetGetInput, GadgetLevel, GadgetManifest, GadgetPublishInput, GadgetSettings, GadgetTestInput, GadgetTestResult, GadgetTestRun, GadgetToolUse, GadgetUpdateInput, GadgetVersionRef, gadgetLimits, gadgetLogDays, } from "./gadgets/gadgets.js";
 export { actions, hasRoute, isAction, isPackage, isWord, packages, parseConnectorFunction, parseToolName, resources, toolEvent, toolPermission, toolRoute, toolSchemaName, verbs, } from "./grammar/grammar.js";
 export { GrantId, GrantRight, NodeGrant, NodeGrantList, NodeGrantListInput, NodeGrantRevoked, NodeGrantRevokeInput, NodeShared, NodeShareInput, } from "./grants/grants.js";
 export { createId, idSchema } from "./ids/ids.js";
@@ -34,8 +35,9 @@ export { PageDetail, PageGetInput, PageHead, PageHeading, PageId, PageList, Page
 export { IdempotencyKey, Rev } from "./primitives/primitives.js";
 export { Locale, locales, Name, ProfileImageResponse, ProfileUpdateInput, profileImageMaxBytes, profileImageTypes, Theme, TimeZone, themes, } from "./profile/profile.js";
 export { GrantChange, PermissionsResponse, RightInCode, RightPath, RightTree, Role, RoleArchiveInput, RoleCreateInput, RoleDetail, RoleGetInput, RoleGrantCreateInput, RoleGrantRevokeInput, RoleId, RoleList, RoleListInput, RoleRestoreInput, RoleUpdateInput, } from "./roles/roles.js";
-export { BoardRunCreateInput, DashboardRunCreateInput, RunCompleteInput, RunDetail, RunGetInput, RunId, RunItem, RunList, RunListInput, RunStatus, RunUpdateInput, RunValue, RunValueValue, runStatuses, } from "./runs/runs.js";
+export { BoardRunCreateInput, RunCompleteInput, RunDetail, RunGetInput, RunId, RunItem, RunList, RunListInput, RunStatus, runStatuses, } from "./runs/runs.js";
 export { RuntimeConfig } from "./runtime-config.js";
+export { rhythms, Schedule, WhileOpen, weekdays, whileOpenModes } from "./schedule/schedule.js";
 export { NodeSecret, NodeSecretCreateInput, NodeSecretDetail, NodeSecretGetInput, NodeSecretRemoveInput, NodeSecretUpdateInput, NodeUnlocked, NodeUnlockInput, unlockMinutes, } from "./secrets/secrets.js";
 export { createServiceClient, } from "./service-client/service-client.js";
 export { FunctionId, InterfaceId, RightWord, Service, ServiceArchiveInput, ServiceCreateInput, ServiceFunction, ServiceId, ServiceInterface, ServiceKeyIssued, ServiceList, ServiceListInput, ServiceName, ServicePurged, ServicePurgeInput, ServiceRestoreInput, ServiceRotateInput, ServiceUpdateInput, } from "./services/services.js";
@@ -44,5 +46,5 @@ export { TableColumn, TableColumnChange, TableColumnType, TableCreateInput, Tabl
 export { defineTool, } from "./tool.js";
 export { IntelligenceUserGetInput, IntelligenceUserUpdateInput, NotifyMode, notifyModes, UserSettings, } from "./user-settings/user-settings.js";
 export { MachineFacts, MachineKeyFacts, MachineKind, MessageMachine, OperatorProvider, OwnRoleList, SignInMethod, User, UserDetail, UserDisableInput, UserEnableInput, UserGetInput, UserId, UserKind, UserList, UserListInput, UserListItem, UserStatus, UserTestInput, UserTestResult, UserUpdateInput, } from "./users/users.js";
-export { TicketColumn, TicketMove, TicketSubject, TicketSubjectRef, ValidationBoardId, validationBoardId, } from "./validation/validation.js";
-export { NodeVersion, NodeVersionCreateInput, NodeVersionDetail, NodeVersionGetInput, NodeVersionList, NodeVersionListInput, VersionId, versionKinds, } from "./versions/versions.js";
+export { TicketSubject, TicketSubjectRef, ValidationBoardId, validationBoardId, } from "./validation/validation.js";
+export { MoveColumn, NodeVersion, NodeVersionCreateInput, NodeVersionDetail, NodeVersionGetInput, NodeVersionList, NodeVersionListInput, TaskMove, TaskVersionChange, taskVersionChanges, VersionId, VersionMove, versionKinds, } from "./versions/versions.js";

package/dist/tables/tables.d.ts

@@ -76,6 +76,14 @@ export declare const TableUpdateInput: z.ZodObject<{
         from: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strict>>>;
     csv: z.ZodOptional<z.ZodString>;
+    key: z.ZodOptional<z.ZodString>;
+    set: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        keyValue: z.ZodString;
+        cells: z.ZodRecord<z.ZodString, z.ZodObject<{
+            value: z.ZodString;
+            from: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>;
     append: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodString>>>;
     replace: z.ZodOptional<z.ZodArray<z.ZodObject<{
         position: z.ZodNumber;

package/dist/tables/tables.js

@@ -4,8 +4,9 @@ import { IdempotencyKey, Rev } from "../primitives/primitives.js";
 // Tables (#40, Nodes › Tabelle, E39, E59, E70): the inputs of `intelligence_table_create`, `_get`
 // and `_update`, and their answers. A table is CSV, stored and exported as it is, whose first line is
 // the header; beside it every version keeps the columns with their types. A row has no id: it is
-// addressed by its position, counted from 1 at the first data row, against the state `rev` names.
-// Appending, replacing and removing rows are fields of `_update`, not a resource of their own.
+// addressed by its position, counted from 1 at the first data row, against the state `rev` names,
+// or by its text in a key column the call names (`set`, #630, E120), checked cell by cell instead.
+// Setting, appending, replacing and removing rows are fields of `_update`, not a resource of their own.
 export const TableId = NodeId.describe("The table's id, a `node_…` of kind table.");
 // The five types of a column (E39). The type only decides how a cell is shown; a cell is never
 // checked against it.
@@ -65,9 +66,26 @@ export const TableGetInput = z.strictObject({
         .optional()
         .describe("rows (the default) answers the rows as lists of cells; csv answers the whole table as CSV text instead, the header line first."),
 });
+// One cell of a `set` entry (#630, E120): the new text and the text that was read. The cell is
+// checked on its own, so a change elsewhere in the table is no conflict.
+const CellChange = z.strictObject({
+    value: z.string().describe("The cell's new text."),
+    from: z
+        .string()
+        .describe("The cell's text as you read it. If it is something else now, nothing in the call changes and the answer is conflict, naming the cell."),
+});
+const SetEntry = z.strictObject({
+    keyValue: z
+        .string()
+        .describe("The row to change, by its text in the key column. Exactly one row must hold it; an unknown or doubled one answers invalid and changes nothing."),
+    cells: z
+        .record(ColumnName, CellChange)
+        .refine((cells) => Object.keys(cells).length > 0, "Name at least one cell to change.")
+        .describe("Only the cells to change, by column name, each with its new value and the value you read (from). The other cells of the row stay as they are."),
+});
 export const TableUpdateInput = z.strictObject({
     tableId: TableId,
-    rev: Rev.optional().describe("The revision of the table this change is based on, as the last read returned it; the positions of replace and remove are counted in that state. Required for every change except appending rows alone, which collides with nothing. If someone saved in between, the call answers conflict and changes nothing: read the table again and decide."),
+    rev: Rev.optional().describe("The revision of the table this change is based on, as the last read returned it; the positions of replace and remove are counted in that state. Required for replace, remove, columns and csv; set and append work without it. If someone saved in between, the call answers conflict and changes nothing: read the table again and decide."),
     editSession: EditSession,
     columns: z
         .array(TableColumnChange)
@@ -76,9 +94,16 @@ export const TableUpdateInput = z.strictObject({
         .optional()
         .describe("The whole new column list in its new order: names, types, new columns and, by leaving them out, removed ones. A removed column's cells stay only in the table's history; the answer names the rows that had content in it. With csv, it is the header the csv must match instead."),
     csv: Csv.optional().describe("Replace the whole table: CSV whose header line holds exactly the column names, the current ones or those sent in columns alongside."),
+    key: ColumnName.optional().describe("The key column of set: the column, by name, whose text names the row of each entry. Any column whose texts are unique in the rows you change; the table itself has no key."),
+    set: z
+        .array(SetEntry)
+        .min(1)
+        .max(10_000)
+        .optional()
+        .describe("Change single cells of rows found by their text in the key column, without rev and without positions: a change elsewhere in the table in between is no conflict, only a cell that is no longer what you read (from). All or nothing: a stale cell answers conflict, an unknown or doubled key value invalid, each with issues naming every entry, and nothing changes. Goes with append only, applied first."),
     append: Rows.min(1)
         .optional()
-        .describe("Rows to add at the end, each a list of cells in the order of the columns. Appending alone needs no rev and no reading of the table first."),
+        .describe("Rows to add at the end, each a list of cells in the order of the columns. Appending alone or with set needs no rev and no reading of the table first."),
     replace: z
         .array(z.strictObject({
         position: Position,

package/dist/users/users.js

@@ -17,8 +17,8 @@ export const UserStatus = z.enum(["invited", "expired", "disabled", "archived"])
 // extern").
 export const MachineKind = z.enum(["operator", "external"]);
 // The providers of the catalog (`operatorProviders` in `operators.ts`). Here, beside the kinds, so a
-// schema of `nodes` or `messages` can name it without importing `operators`, which reaches `nodes`
-// through `dashboards`.
+// schema of `nodes` or `messages` can name it without importing `operators`, whose module graph
+// reaches far.
 export const OperatorProvider = z.enum(["claude", "codex", "gemini"]);
 // What a machine is beside its name (#348, #403, E77, E80, E85): its kind from `access`, and for an
 // Operator the provider it runs at from `operator`; null for one whose row is gone there. A chat