@anchrd/colab-sdk 0.1.17 → 0.1.19

package/dist/tables/tables.d.ts

@@ -58,6 +58,7 @@ export declare const TableGetInput: z.ZodObject<{
         rows: "rows";
         csv: "csv";
     }>>;
+    cursor: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type TableGetInput = z.infer<typeof TableGetInput>;
 export declare const TableUpdateInput: z.ZodObject<{
@@ -117,6 +118,37 @@ export declare const TableDetail: z.ZodObject<{
     updatedAt: z.ZodISODateTime;
 }, z.core.$strip>;
 export type TableDetail = z.infer<typeof TableDetail>;
+export declare const TableExcerpt: z.ZodObject<{
+    secret: z.ZodOptional<z.ZodLiteral<true>>;
+    locked: z.ZodOptional<z.ZodBoolean>;
+    tableId: z.ZodTemplateLiteral<`node_${string}`>;
+    name: z.ZodString;
+    columns: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            number: "number";
+            date: "date";
+            email: "email";
+            text: "text";
+            chip: "chip";
+        }>;
+    }, z.core.$strict>>;
+    rows: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodString>>>;
+    csv: z.ZodOptional<z.ZodString>;
+    version: z.ZodNumber;
+    rights: z.ZodObject<{
+        write: z.ZodBoolean;
+    }, z.core.$strip>;
+    updatedAt: z.ZodISODateTime;
+    excerpt: z.ZodObject<{
+        firstRow: z.ZodNumber;
+        lastRow: z.ZodNumber;
+        rowCount: z.ZodNumber;
+        nextCursor: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    rev: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type TableExcerpt = z.infer<typeof TableExcerpt>;
 export declare const TableSaved: z.ZodObject<{
     tableId: z.ZodTemplateLiteral<`node_${string}`>;
     name: z.ZodString;

package/dist/tables/tables.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { ExcerptCursor, RowsExcerpt } from "../excerpt/excerpt.js";
 import { NodeId, SecretFields } from "../nodes/nodes.js";
 import { IdempotencyKey, Rev } from "../primitives/primitives.js";
 // Tables (#40, Nodes › Tabelle, E39, E59, E70): the inputs of `intelligence_table_create`, `_get`
@@ -36,7 +37,7 @@ const Cells = z
 const Rows = z.array(Cells).max(10_000);
 const Csv = z
     .string()
-    .describe("The whole table as CSV: the header line with the column names first, then one line per row, as intelligence_table_get with format csv answers it. At most 1 MB in UTF-8.");
+    .describe("The whole table as CSV: the header line with the column names first, then one line per row, as intelligence_table_get with format csv answers it; a table read in excerpts is every excerpt joined, read until nextCursor is null. At most 1 MB in UTF-8.");
 // Counted from 1 at the first data row; the header line is no row.
 const Position = z
     .number()
@@ -65,6 +66,7 @@ export const TableGetInput = z.strictObject({
         .enum(tableFormats)
         .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."),
+    cursor: ExcerptCursor.optional(),
 });
 // 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.
@@ -138,6 +140,15 @@ export const TableDetail = z.object({
     // caller.
     ...SecretFields,
 });
+// One excerpt of a large table over MCP (E127, #674): whole rows, `rows` or `csv` some of them (the
+// CSV's header line in the first excerpt only), `excerpt` which they are and the cursor of the next.
+// ⚠️ `rev` comes with the last excerpt only: `csv` and `replace` replace by the state a `rev` names,
+// and a `rev` beside a part of the table would let a save of that part drop the rest without a
+// conflict. `set` and `append` need no `rev`.
+export const TableExcerpt = TableDetail.extend({
+    excerpt: RowsExcerpt,
+    rev: z.number().int().optional(),
+});
 // The answer of a create and an update: the state after it, without the rows, so appending one row
 // to a large table does not send the table back.
 export const TableSaved = z.object({

package/dist/tool.d.ts

@@ -1,5 +1,7 @@
 import type { z } from "zod";
+import type { ErrorResponse } from "./error/error.js";
 import type { ActionAnnotations, Package } from "./grammar/grammar.js";
+import type { Written } from "./written/written.js";
 export type ToolInput = z.ZodObject<z.core.$ZodShape, z.core.$strict>;
 export type Permission = `${Package} / ${string} / ${string}`;
 export type Actor = {
@@ -26,5 +28,6 @@ export type Tool<Input extends ToolInput = ToolInput> = {
     browserOnly?: true;
     annotations?: ToolAnnotations;
     handler(input: z.output<Input>, context: ToolContext): Promise<unknown>;
+    written?(input: z.output<Input>, context: ToolContext): Promise<Written | ErrorResponse>;
 };
 export declare function defineTool<Input extends ToolInput>(tool: Tool<Input>): Tool;

package/dist/versions/versions.d.ts

@@ -107,6 +107,7 @@ export type NodeVersionListInput = z.infer<typeof NodeVersionListInput>;
 export declare const NodeVersionGetInput: z.ZodObject<{
     nodeId: z.ZodTemplateLiteral<`node_${string}`>;
     versionId: z.ZodTemplateLiteral<`version_${string}`>;
+    cursor: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type NodeVersionGetInput = z.infer<typeof NodeVersionGetInput>;
 export declare const NodeVersionCreateInput: z.ZodObject<{
@@ -330,3 +331,104 @@ export declare const NodeVersionDetail: z.ZodObject<{
     rev: z.ZodNumber;
 }, z.core.$strip>;
 export type NodeVersionDetail = z.infer<typeof NodeVersionDetail>;
+export declare const NodeVersionExcerpt: z.ZodObject<{
+    versionId: z.ZodTemplateLiteral<`version_${string}`>;
+    nodeId: z.ZodTemplateLiteral<`node_${string}`>;
+    number: z.ZodNumber;
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+    createdBy: z.ZodObject<{
+        userId: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        kind: z.ZodNullable<z.ZodEnum<{
+            machine: "machine";
+            human: "human";
+        }>>;
+    }, z.core.$strip>;
+    appHandle: z.ZodNullable<z.ZodString>;
+    restoredFrom: z.ZodNullable<z.ZodNumber>;
+    current: z.ZodBoolean;
+    size: z.ZodNumber;
+    move: z.ZodNullable<z.ZodObject<{
+        from: z.ZodNullable<z.ZodObject<{
+            columnId: z.ZodTemplateLiteral<`column_${string}`>;
+            name: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<{
+                backlog: "backlog";
+                open: "open";
+                progress: "progress";
+                done: "done";
+                discarded: "discarded";
+                blocked: "blocked";
+                archive: "archive";
+            }>>;
+        }, z.core.$strip>>;
+        to: z.ZodObject<{
+            columnId: z.ZodTemplateLiteral<`column_${string}`>;
+            name: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<{
+                backlog: "backlog";
+                open: "open";
+                progress: "progress";
+                done: "done";
+                discarded: "discarded";
+                blocked: "blocked";
+                archive: "archive";
+            }>>;
+        }, z.core.$strip>;
+        comment: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    changes: z.ZodNullable<z.ZodArray<z.ZodEnum<{
+        fields: "fields";
+        title: "title";
+        text: "text";
+        dates: "dates";
+        assignee: "assignee";
+        labels: "labels";
+        parent: "parent";
+        dependencies: "dependencies";
+        waiting: "waiting";
+    }>>>;
+    secret: z.ZodOptional<z.ZodLiteral<true>>;
+    locked: z.ZodOptional<z.ZodBoolean>;
+    content: z.ZodNullable<z.ZodString>;
+    mediaType: z.ZodNullable<z.ZodString>;
+    columns: z.ZodNullable<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            number: "number";
+            date: "date";
+            email: "email";
+            text: "text";
+            chip: "chip";
+        }>;
+    }, z.core.$strict>>>;
+    fields: z.ZodNullable<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            number: "number";
+            date: "date";
+            list: "list";
+            link: "link";
+            text: "text";
+            checklist: "checklist";
+            select: "select";
+        }>;
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            done: z.ZodBoolean;
+        }, z.core.$strip>>]>;
+    }, z.core.$strip>>>;
+    excerpt: z.ZodUnion<readonly [z.ZodObject<{
+        offset: z.ZodNumber;
+        length: z.ZodNumber;
+        nextCursor: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        firstRow: z.ZodNumber;
+        lastRow: z.ZodNumber;
+        rowCount: z.ZodNumber;
+        nextCursor: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>]>;
+    rev: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type NodeVersionExcerpt = z.infer<typeof NodeVersionExcerpt>;

package/dist/versions/versions.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { CardFieldType, CardFieldValue } from "../card-kinds/card-kinds.js";
 import { ColumnId, ColumnType } from "../columns/columns.js";
+import { ExcerptCursor, RowsExcerpt, TextExcerpt } from "../excerpt/excerpt.js";
 import { idSchema } from "../ids/ids.js";
 import { Limit as PageSize } from "../list-input.js";
 import { NodeId, NodePerson, SecretFields } from "../nodes/nodes.js";
@@ -61,6 +62,7 @@ export const NodeVersionListInput = z.strictObject({
 export const NodeVersionGetInput = z.strictObject({
     nodeId: NodeId.describe("The document, table, file or task the version belongs to."),
     versionId: VersionId.describe("The version to read, from intelligence_node_version_list. A version of another node answers not_found."),
+    cursor: ExcerptCursor.optional(),
 });
 export const NodeVersionCreateInput = z.strictObject({
     nodeId: NodeId.describe("The document, table, file or task to restore an earlier state of."),
@@ -99,6 +101,7 @@ export const NodeVersionList = z.object({
 });
 export const NodeVersionDetail = NodeVersion.extend({
     // The text of a document or a task (Markdown) or a table; null for a file, whose bytes come with #41.
+    // Over MCP a text above `excerptChars` comes in excerpts (E127, #762): see `NodeVersionExcerpt`.
     content: z.string().nullable(),
     // Only for a file: its media type.
     mediaType: z.string().nullable(),
@@ -115,3 +118,14 @@ export const NodeVersionDetail = NodeVersion.extend({
     // this caller.
     ...SecretFields,
 });
+// One excerpt of a version over MCP whose content is above `excerptChars` (E127, #762), cut like the
+// read of its kind (#674): a table's CSV in whole rows (`RowsExcerpt`, the header line in the first
+// excerpt), every other text by characters (`TextExcerpt`). ⚠️ `rev` comes with the last excerpt
+// only: it is the node's `rev`, which `_document_update`, `_table_update` with `csv` and
+// `_task_update` take beside a whole new text, and beside a part of an old version it would let a
+// save of that part cut the rest away without a conflict. A restore takes the `rev` of
+// `intelligence_node_version_list`.
+export const NodeVersionExcerpt = NodeVersionDetail.extend({
+    excerpt: z.union([TextExcerpt, RowsExcerpt]),
+    rev: z.number().int().optional(),
+});

package/dist/written/written.d.ts

@@ -0,0 +1,206 @@
+import { z } from "zod";
+export declare const Changed: z.ZodObject<{
+    nodeId: z.ZodOptional<z.ZodTemplateLiteral<`node_${string}`>>;
+    documentId: z.ZodOptional<z.ZodTemplateLiteral<`node_${string}`>>;
+    tableId: z.ZodOptional<z.ZodTemplateLiteral<`node_${string}`>>;
+    fileId: z.ZodOptional<z.ZodTemplateLiteral<`node_${string}`>>;
+    boardId: z.ZodOptional<z.ZodTemplateLiteral<`node_${string}`>>;
+    taskId: z.ZodOptional<z.ZodTemplateLiteral<`node_${string}`>>;
+    gadgetId: z.ZodOptional<z.ZodTemplateLiteral<`node_${string}`>>;
+    runId: z.ZodOptional<z.ZodTemplateLiteral<`run_${string}`>>;
+    messageId: z.ZodOptional<z.ZodTemplateLiteral<`message_${string}`>>;
+    chatId: z.ZodOptional<z.ZodTemplateLiteral<`node_${string}`>>;
+    grantId: z.ZodOptional<z.ZodTemplateLiteral<`grant_${string}`>>;
+    linkId: z.ZodOptional<z.ZodTemplateLiteral<`link_${string}`>>;
+    userId: z.ZodOptional<z.ZodTemplateLiteral<`user_${string}`>>;
+    machineId: z.ZodOptional<z.ZodTemplateLiteral<`user_${string}`>>;
+    roleId: z.ZodOptional<z.ZodTemplateLiteral<`role_${string}`>>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    invitationId: z.ZodOptional<z.ZodTemplateLiteral<`invitation_${string}`>>;
+    serviceId: z.ZodOptional<z.ZodTemplateLiteral<`service_${string}`>>;
+    interfaceId: z.ZodOptional<z.ZodTemplateLiteral<`interface_${string}`>>;
+    functionId: z.ZodOptional<z.ZodTemplateLiteral<`function_${string}`>>;
+    appId: z.ZodOptional<z.ZodTemplateLiteral<`app_${string}`>>;
+    sessionId: z.ZodOptional<z.ZodTemplateLiteral<`session_${string}`>>;
+    ssoId: z.ZodOptional<z.ZodEnum<{
+        google: "google";
+        microsoft: "microsoft";
+    }>>;
+    connectorId: z.ZodOptional<z.ZodString>;
+    connectionId: z.ZodOptional<z.ZodTemplateLiteral<`connection_${string}`>>;
+    credentialId: z.ZodOptional<z.ZodTemplateLiteral<`credential_${string}`>>;
+    ref: z.ZodOptional<z.ZodString>;
+    rev: z.ZodOptional<z.ZodNumber>;
+    version: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type Changed = z.infer<typeof Changed>;
+export declare const Unblocked: z.ZodObject<{
+    taskId: z.ZodTemplateLiteral<`node_${string}`>;
+    title: z.ZodString;
+    assignee: z.ZodObject<{
+        userId: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    rev: z.ZodNumber;
+    own: z.ZodOptional<z.ZodLiteral<true>>;
+}, z.core.$strip>;
+export type Unblocked = z.infer<typeof Unblocked>;
+export declare const Effects: z.ZodObject<{
+    woken: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        userId: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>>;
+    notified: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        userId: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>>;
+    unblocked: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        taskId: z.ZodTemplateLiteral<`node_${string}`>;
+        title: z.ZodString;
+        assignee: z.ZodObject<{
+            userId: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>;
+        rev: z.ZodNumber;
+        own: z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strip>>>;
+    validationReset: z.ZodOptional<z.ZodArray<z.ZodTemplateLiteral<`node_${string}`>>>;
+    readers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        userId: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        kind: z.ZodNullable<z.ZodEnum<{
+            machine: "machine";
+            human: "human";
+        }>>;
+        right: z.ZodEnum<{
+            share: "share";
+            write: "write";
+            read: "read";
+        }>;
+        origin: z.ZodEnum<{
+            creator: "creator";
+            direct: "direct";
+            inherited: "inherited";
+        }>;
+        fromNodeId: z.ZodTemplateLiteral<`node_${string}`>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type Effects = z.infer<typeof Effects>;
+export declare const Written: z.ZodObject<{
+    changed: z.ZodArray<z.ZodObject<{
+        nodeId: z.ZodOptional<z.ZodTemplateLiteral<`node_${string}`>>;
+        documentId: z.ZodOptional<z.ZodTemplateLiteral<`node_${string}`>>;
+        tableId: z.ZodOptional<z.ZodTemplateLiteral<`node_${string}`>>;
+        fileId: z.ZodOptional<z.ZodTemplateLiteral<`node_${string}`>>;
+        boardId: z.ZodOptional<z.ZodTemplateLiteral<`node_${string}`>>;
+        taskId: z.ZodOptional<z.ZodTemplateLiteral<`node_${string}`>>;
+        gadgetId: z.ZodOptional<z.ZodTemplateLiteral<`node_${string}`>>;
+        runId: z.ZodOptional<z.ZodTemplateLiteral<`run_${string}`>>;
+        messageId: z.ZodOptional<z.ZodTemplateLiteral<`message_${string}`>>;
+        chatId: z.ZodOptional<z.ZodTemplateLiteral<`node_${string}`>>;
+        grantId: z.ZodOptional<z.ZodTemplateLiteral<`grant_${string}`>>;
+        linkId: z.ZodOptional<z.ZodTemplateLiteral<`link_${string}`>>;
+        userId: z.ZodOptional<z.ZodTemplateLiteral<`user_${string}`>>;
+        machineId: z.ZodOptional<z.ZodTemplateLiteral<`user_${string}`>>;
+        roleId: z.ZodOptional<z.ZodTemplateLiteral<`role_${string}`>>;
+        permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        invitationId: z.ZodOptional<z.ZodTemplateLiteral<`invitation_${string}`>>;
+        serviceId: z.ZodOptional<z.ZodTemplateLiteral<`service_${string}`>>;
+        interfaceId: z.ZodOptional<z.ZodTemplateLiteral<`interface_${string}`>>;
+        functionId: z.ZodOptional<z.ZodTemplateLiteral<`function_${string}`>>;
+        appId: z.ZodOptional<z.ZodTemplateLiteral<`app_${string}`>>;
+        sessionId: z.ZodOptional<z.ZodTemplateLiteral<`session_${string}`>>;
+        ssoId: z.ZodOptional<z.ZodEnum<{
+            google: "google";
+            microsoft: "microsoft";
+        }>>;
+        connectorId: z.ZodOptional<z.ZodString>;
+        connectionId: z.ZodOptional<z.ZodTemplateLiteral<`connection_${string}`>>;
+        credentialId: z.ZodOptional<z.ZodTemplateLiteral<`credential_${string}`>>;
+        ref: z.ZodOptional<z.ZodString>;
+        rev: z.ZodOptional<z.ZodNumber>;
+        version: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    effects: z.ZodOptional<z.ZodObject<{
+        woken: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            userId: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>>;
+        notified: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            userId: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>>;
+        unblocked: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            taskId: z.ZodTemplateLiteral<`node_${string}`>;
+            title: z.ZodString;
+            assignee: z.ZodObject<{
+                userId: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strip>;
+            rev: z.ZodNumber;
+            own: z.ZodOptional<z.ZodLiteral<true>>;
+        }, z.core.$strip>>>;
+        validationReset: z.ZodOptional<z.ZodArray<z.ZodTemplateLiteral<`node_${string}`>>>;
+        readers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            userId: z.ZodString;
+            name: z.ZodNullable<z.ZodString>;
+            kind: z.ZodNullable<z.ZodEnum<{
+                machine: "machine";
+                human: "human";
+            }>>;
+            right: z.ZodEnum<{
+                share: "share";
+                write: "write";
+                read: "read";
+            }>;
+            origin: z.ZodEnum<{
+                creator: "creator";
+                direct: "direct";
+                inherited: "inherited";
+            }>;
+            fromNodeId: z.ZodTemplateLiteral<`node_${string}`>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    missing: z.ZodOptional<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>>>;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodEnum<{
+            followup_failed: "followup_failed";
+            test_failed: "test_failed";
+            mail_failed: "mail_failed";
+            unused: "unused";
+            too_long: "too_long";
+        }>;
+        message: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type Written = z.infer<typeof Written>;

package/dist/written/written.js

@@ -0,0 +1,90 @@
+import { z } from "zod";
+import { AppId, SessionId } from "../apps/apps.js";
+import { ConnectionId } from "../connections/connections.js";
+import { ConnectorId } from "../connectors/connectors.js";
+import { Warning } from "../error/error.js";
+import { GrantId } from "../grants/grants.js";
+import { InvitationId } from "../invitations/invitations.js";
+import { LinkId } from "../links/links.js";
+import { MachineId } from "../machines/machines.js";
+import { MessageId } from "../messages/messages.js";
+import { Missing, Reached } from "../missing/missing.js";
+import { NodeId, NodeReader } from "../nodes/nodes.js";
+import { CredentialId } from "../operators/operators.js";
+import { RoleId } from "../roles/roles.js";
+import { RunId } from "../runs/runs.js";
+import { FunctionId, InterfaceId, ServiceId } from "../services/services.js";
+import { SsoId } from "../sso/sso.js";
+import { UserId } from "../users/users.js";
+// What a write answers over `/mcp` (E126, #672): what it changed and what that caused, never the
+// object it wrote. The AI sent the object itself; echoing it back filled an Operator's context with
+// every card and document it saved (#617). `/api` keeps the whole object for the UI.
+// One thing a write changed: its id under its resource's name, and where the resource has them the
+// `rev` for the next save (E70) and the version number. A folder, and a node of any kind where the
+// tool is about nodes, is `nodeId`.
+export const Changed = z.object({
+    nodeId: NodeId.optional(),
+    documentId: NodeId.optional(),
+    tableId: NodeId.optional(),
+    fileId: NodeId.optional(),
+    boardId: NodeId.optional(),
+    taskId: NodeId.optional(),
+    gadgetId: NodeId.optional(),
+    runId: RunId.optional(),
+    messageId: MessageId.optional(),
+    // A chat is its node's (#45).
+    chatId: NodeId.optional(),
+    grantId: GrantId.optional(),
+    linkId: LinkId.optional(),
+    // A person or machine in `access`, and the caller's own settings in `intelligence`.
+    userId: UserId.optional(),
+    // The other packages (#743). A machine is `machineId` in `access` and an Operator in `operator`,
+    // its `user_…` id either way.
+    machineId: MachineId.optional(),
+    roleId: RoleId.optional(),
+    // The rights a switch of a role really turned on or off, which a level in the call expands to.
+    permissions: z.array(z.string()).optional(),
+    invitationId: InvitationId.optional(),
+    serviceId: ServiceId.optional(),
+    interfaceId: InterfaceId.optional(),
+    functionId: FunctionId.optional(),
+    appId: AppId.optional(),
+    sessionId: SessionId.optional(),
+    ssoId: SsoId.optional(),
+    connectorId: ConnectorId.optional(),
+    connectionId: ConnectionId.optional(),
+    credentialId: CredentialId.optional(),
+    // The caller's own name for an entry of a create of many (#625).
+    ref: z.string().optional(),
+    rev: z.number().int().optional(),
+    version: z.number().int().optional(),
+});
+// A task that waited only on what this call closed, and now waits on nothing (Nodes › Aufgabe):
+// whoever closed a task moves the next one to Open (E124). `own` marks the caller's: with its `rev`
+// the caller writes it at once, without reading it first.
+export const Unblocked = z.object({
+    taskId: NodeId,
+    title: z.string(),
+    assignee: Reached,
+    rev: z.number().int(),
+    own: z.literal(true).optional(),
+});
+// What the write caused for others; an empty field is left out.
+export const Effects = z.object({
+    // Machines whose Actions changed by it (#334, E124): an Operator among them wakes.
+    woken: z.array(Reached).optional(),
+    // People it put something in front of in their Actions, by mail as their setting says (#50).
+    notified: z.array(Reached).optional(),
+    // Tasks ready now, because the last thing they waited on was closed by this call.
+    unblocked: z.array(Unblocked).optional(),
+    // Nodes whose validation went back to new (#47): their new version is unchecked.
+    validationReset: z.array(NodeId).optional(),
+    // Who reads a moved node now (#36): a move takes the grants of its new folder.
+    readers: z.array(NodeReader).optional(),
+});
+export const Written = z.object({
+    changed: z.array(Changed),
+    effects: Effects.optional(),
+    missing: z.array(Missing).optional(),
+    warnings: z.array(Warning).optional(),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anchrd/colab-sdk",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "Types, Zod schemas and the service client of Colab, the contract between its UI, backends and outside services.",
   "type": "module",
   "license": "UNLICENSED",