@anchrd/colab-sdk 0.1.15 → 0.1.17

package/dist/actions/actions.d.ts

@@ -44,6 +44,7 @@ export declare const ActionTask: z.ZodObject<{
         }>;
     }, z.core.$strip>>;
     handedOver: z.ZodBoolean;
+    rev: z.ZodNumber;
 }, z.core.$strip>;
 export type ActionTask = z.infer<typeof ActionTask>;
 export declare const ActionChat: z.ZodObject<{
@@ -82,6 +83,25 @@ export declare const ActionProcess: z.ZodObject<{
     dueAt: z.ZodISODateTime;
 }, z.core.$strip>;
 export type ActionProcess = z.infer<typeof ActionProcess>;
+export declare const ActionRunTask: z.ZodObject<{
+    taskId: z.ZodTemplateLiteral<`node_${string}`>;
+    title: z.ZodString;
+    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>;
+    rev: z.ZodNumber;
+}, z.core.$strip>;
+export type ActionRunTask = z.infer<typeof ActionRunTask>;
 export declare const ActionRun: z.ZodObject<{
     runId: z.ZodTemplateLiteral<`run_${string}`>;
     status: z.ZodEnum<{
@@ -90,6 +110,24 @@ export declare const ActionRun: z.ZodObject<{
         done: "done";
         running: "running";
     }>;
+    tasks: z.ZodArray<z.ZodObject<{
+        taskId: z.ZodTemplateLiteral<`node_${string}`>;
+        title: z.ZodString;
+        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>;
+        rev: z.ZodNumber;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ActionRun = z.infer<typeof ActionRun>;
 export declare const ActionGadget: z.ZodObject<{
@@ -180,6 +218,7 @@ export declare const ActionItem: z.ZodObject<{
             }>;
         }, z.core.$strip>>;
         handedOver: z.ZodBoolean;
+        rev: z.ZodNumber;
     }, z.core.$strip>>;
     chat: z.ZodNullable<z.ZodObject<{
         unreadCount: z.ZodNumber;
@@ -223,6 +262,24 @@ export declare const ActionItem: z.ZodObject<{
             done: "done";
             running: "running";
         }>;
+        tasks: z.ZodArray<z.ZodObject<{
+            taskId: z.ZodTemplateLiteral<`node_${string}`>;
+            title: z.ZodString;
+            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>;
+            rev: z.ZodNumber;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     gadget: z.ZodNullable<z.ZodObject<{
         problem: z.ZodEnum<{
@@ -513,6 +570,7 @@ export declare const ActionRow: z.ZodUnion<readonly [z.ZodObject<{
             }>;
         }, z.core.$strip>>;
         handedOver: z.ZodBoolean;
+        rev: z.ZodNumber;
     }, z.core.$strip>>;
     chat: z.ZodNullable<z.ZodObject<{
         unreadCount: z.ZodNumber;
@@ -556,6 +614,24 @@ export declare const ActionRow: z.ZodUnion<readonly [z.ZodObject<{
             done: "done";
             running: "running";
         }>;
+        tasks: z.ZodArray<z.ZodObject<{
+            taskId: z.ZodTemplateLiteral<`node_${string}`>;
+            title: z.ZodString;
+            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>;
+            rev: z.ZodNumber;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     gadget: z.ZodNullable<z.ZodObject<{
         problem: z.ZodEnum<{
@@ -727,6 +803,7 @@ export declare const ActionList: z.ZodObject<{
                 }>;
             }, z.core.$strip>>;
             handedOver: z.ZodBoolean;
+            rev: z.ZodNumber;
         }, z.core.$strip>>;
         chat: z.ZodNullable<z.ZodObject<{
             unreadCount: z.ZodNumber;
@@ -770,6 +847,24 @@ export declare const ActionList: z.ZodObject<{
                 done: "done";
                 running: "running";
             }>;
+            tasks: z.ZodArray<z.ZodObject<{
+                taskId: z.ZodTemplateLiteral<`node_${string}`>;
+                title: z.ZodString;
+                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>;
+                rev: z.ZodNumber;
+            }, z.core.$strip>>;
         }, z.core.$strip>>;
         gadget: z.ZodNullable<z.ZodObject<{
             problem: z.ZodEnum<{

package/dist/actions/actions.js

@@ -38,6 +38,8 @@ export const ActionTask = z.object({
     buttons: z.array(TaskColumn),
     // A machine moved it into its column last: "handed over by the Operator".
     handedOver: z.boolean(),
+    // The task's rev (E70, #671): intelligence_task_update takes it without reading the task first.
+    rev: z.number().int(),
 });
 export const ActionChat = z.object({
     // The messages of others not read yet, by the person themselves (not their AI).
@@ -56,9 +58,21 @@ export const ActionProcess = z.object({
     // The moment of the schedule the next run stands for.
     dueAt: z.iso.datetime(),
 });
+// A card of a process run that is the reader's own (#671): what the run waits on from them, with the
+// rev its next save sends, so an Operator writes it without reading the run first.
+export const ActionRunTask = z.object({
+    taskId: NodeId,
+    title: z.string(),
+    column: TaskColumn,
+    rev: z.number().int(),
+});
 export const ActionRun = z.object({
     runId: RunId,
     status: RunStatus,
+    // The cards of this run assigned to the reader, in every column, in the order of the run's columns
+    // and their position; never another's. Empty without one, and always for the validation, whose run
+    // copies no cards.
+    tasks: z.array(ActionRunTask),
 });
 // A gadget whose live version broke (#643, Nodes › Gadget › Einstellungen): every new error and every
 // red test waits on its responsible; without one, on its publisher as a hint to name one. Open until

package/dist/boards/boards.d.ts

@@ -43,6 +43,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";
@@ -164,6 +165,7 @@ export declare const ProcessCheck: z.ZodObject<{
         userId: z.ZodString;
         name: z.ZodString;
     }, z.core.$strip>>;
+    responsibleWrites: z.ZodBoolean;
 }, z.core.$strip>;
 export type ProcessCheck = z.infer<typeof ProcessCheck>;
 export declare const BoardDetail: z.ZodObject<{
@@ -214,6 +216,7 @@ export declare const BoardDetail: z.ZodObject<{
             userId: z.ZodString;
             name: z.ZodString;
         }, z.core.$strip>>;
+        responsibleWrites: z.ZodBoolean;
     }, z.core.$strip>;
     validator: z.ZodNullable<z.ZodObject<{
         userId: z.ZodString;
@@ -223,6 +226,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;
@@ -921,3 +932,14 @@ export declare const TaskDetail: z.ZodObject<{
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type TaskDetail = z.infer<typeof TaskDetail>;
+export declare const TaskSaved: z.ZodObject<{
+    taskId: z.ZodTemplateLiteral<`node_${string}`>;
+    rev: z.ZodNumber;
+    warnings: z.ZodArray<z.ZodObject<{
+        code: z.ZodEnum<{
+            followup_failed: "followup_failed";
+        }>;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type TaskSaved = z.infer<typeof TaskSaved>;

package/dist/boards/boards.js

@@ -1,11 +1,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 { Warning } from "../error/error.js";
 import { idSchema } from "../ids/ids.js";
 import { Flag } from "../list-input.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 +31,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);
@@ -61,7 +63,11 @@ 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."),
     columns: Columns.optional(),
@@ -97,6 +103,9 @@ 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(),
 });
 export const BoardDetail = z.object({
     boardId: NodeId,
@@ -116,6 +125,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),
@@ -385,3 +396,10 @@ export const TaskDetail = z.object({
     // with its description; `current` marks the task's own.
     columns: z.array(BoardColumn.extend({ current: z.boolean() })).optional(),
 });
+// `intelligence_task_update` in place of the task when the change is saved and a step after the
+// save failed (#623): the task's id, the rev for its next change and the warning that says so.
+export const TaskSaved = z.object({
+    taskId: NodeId,
+    rev: z.number().int(),
+    warnings: z.array(Warning),
+});

package/dist/error/error.d.ts

@@ -34,3 +34,10 @@ export declare const ErrorResponse: z.ZodObject<{
     }, z.core.$strict>], "code">;
 }, z.core.$strict>;
 export type ErrorResponse = z.infer<typeof ErrorResponse>;
+export declare const Warning: z.ZodObject<{
+    code: z.ZodEnum<{
+        followup_failed: "followup_failed";
+    }>;
+    message: z.ZodString;
+}, z.core.$strip>;
+export type Warning = z.infer<typeof Warning>;

package/dist/error/error.js

@@ -29,3 +29,11 @@ export const ErrorResponse = z.strictObject({
         }),
     ]),
 });
+// What a write answers beside its result when it went through and something stands out (E126): a
+// hint for the AI, never a refusal; a fixed code and a sentence. #623 brings the first code, #672
+// takes the field to every write over `/mcp` and adds its own.
+// - `followup_failed`: the change is saved, and a step after the save failed and was reported.
+export const Warning = z.object({
+    code: z.enum(["followup_failed"]),
+    message: z.string(),
+});

package/dist/grammar/grammar.d.ts

@@ -39,6 +39,11 @@ export declare const verbs: readonly ["invite", "resend", "disable", "enable", "
 export type Package = (typeof packages)[number];
 export type Resource = keyof typeof resources;
 export type Action = (typeof actions)[number] | (typeof verbs)[number];
+export type ActionAnnotations = {
+    readOnlyHint: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+};
 export type ToolName = {
     package: Package;
     resources: readonly Resource[];
@@ -60,4 +65,5 @@ export declare function parseToolName(name: string): ToolName;
 export declare function toolRoute(name: string): Route;
 export declare function toolPermission(name: string): string;
 export declare function toolEvent(name: string): string;
+export declare function toolAnnotations(name: string): ActionAnnotations | undefined;
 export declare function toolSchemaName(name: string): string;

package/dist/grammar/grammar.js

@@ -94,6 +94,54 @@ export const verbs = [
     // the same (E112): `operator_run_cancel`.
     "cancel",
 ];
+const reads = { readOnlyHint: true };
+// Takes nothing away for good. `archive`, `disable` and `unpublish` have their way back (`restore`,
+// `enable`, `publish`); an `update` changes only what it names, a node's against the `rev` it read
+// (E70), and the node keeps its versions.
+const writes = {
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: false,
+};
+// Destructive as in the rule `destructive`: afterwards nothing is there that another call brings
+// back. A purged node, a revoked grant or session, a removed interface, a rotated key, a cancelled
+// run at a provider.
+const destroys = {
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: false,
+};
+// ⚠️ No action that writes is marked idempotent: a second `archive`, `purge` or `revoke` finds nothing
+// left and refuses, a second `update` of a node with the same `rev` answers `conflict`, a second
+// `create` makes a second thing. A client reading `idempotentHint: true` would take its retry after a
+// timeout for done (rule `destructive`); `false` is the protocol's default and promises nothing. A
+// `Record` over every word: a new verb does not compile without its hints.
+const actionAnnotations = {
+    list: reads,
+    get: reads,
+    create: writes,
+    update: writes,
+    archive: writes,
+    restore: writes,
+    purge: destroys,
+    invite: writes,
+    resend: writes,
+    disable: writes,
+    enable: writes,
+    rotate: destroys,
+    share: writes,
+    move: writes,
+    start: writes,
+    complete: writes,
+    test: writes,
+    revoke: destroys,
+    remove: destroys,
+    unlock: writes,
+    publish: writes,
+    schedule: writes,
+    unpublish: writes,
+    cancel: destroys,
+};
 export function isPackage(word) {
     return packages.includes(word);
 }
@@ -210,6 +258,12 @@ export function toolEvent(name) {
     const { resources: chain, action } = parseToolName(name);
     return [...chain, action].join(".");
 }
+// `access_role_archive` → the hints of `archive`, by the last word. A connector's tool ends in an
+// action too (`shopify_order_list`); a name that does not, which the structure test refuses, has none.
+export function toolAnnotations(name) {
+    const action = name.split("_").at(-1) ?? "";
+    return isAction(action) ? actionAnnotations[action] : undefined;
+}
 // `access_user_invite` → `UserInviteInput`.
 export function toolSchemaName(name) {
     const { resources: chain, action } = parseToolName(name);

package/dist/sdk.d.ts

@@ -1,22 +1,22 @@
-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 { ActionChat, ActionGadget, ActionItem, ActionList, ActionListInput, ActionNotice, ActionNoticeButton, ActionNoticeCrumb, ActionNoticeItem, ActionNoticeKind, ActionNoticeReason, ActionNoticeTitle, ActionProcess, ActionRow, ActionRun, ActionRunTask, 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, BoardTaskCreated, BoardTaskCreateInput, BoardTaskItem, BoardTaskList, BoardTaskListInput, BoardTaskUpdated, BoardTaskUpdateInput, BoardUpdateInput, boardKinds, LabelId, maxBulkTasks, 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, TaskSaved, 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 { 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 { ErrorCode, ErrorIssue, ErrorResponse, errorCodes, Warning, } 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 { type Action, actions, hasRoute, isAction, isPackage, isWord, type Package, packages, parseConnectorFunction, parseToolName, type Resource, type Route, resources, type ToolName, toolAnnotations, 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";
 export { Instructions, InstructionsLink, instructionsNames, isInstructionsName, validationSection, } from "./instructions/instructions.js";

package/dist/sdk.js

@@ -1,25 +1,25 @@
 // 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, ActionGadget, 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, ActionRunTask, 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, BoardTaskCreated, BoardTaskCreateInput, BoardTaskItem, BoardTaskList, BoardTaskListInput, BoardTaskUpdated, BoardTaskUpdateInput, BoardUpdateInput, boardKinds, LabelId, maxBulkTasks, 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, TaskSaved, 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 { 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 { ErrorCode, ErrorIssue, ErrorResponse, errorCodes, Warning, } 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 { actions, hasRoute, isAction, isPackage, isWord, packages, parseConnectorFunction, parseToolName, resources, toolAnnotations, 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";
 export { Instructions, InstructionsLink, instructionsNames, isInstructionsName, validationSection, } from "./instructions/instructions.js";

package/dist/tool.d.ts

@@ -1,5 +1,5 @@
 import type { z } from "zod";
-import type { Package } from "./grammar/grammar.js";
+import type { ActionAnnotations, Package } from "./grammar/grammar.js";
 export type ToolInput = z.ZodObject<z.core.$ZodShape, z.core.$strict>;
 export type Permission = `${Package} / ${string} / ${string}`;
 export type Actor = {
@@ -14,8 +14,7 @@ export type ToolContext = {
     actor: Actor;
     source?: ToolSource;
 };
-export type ToolAnnotations = {
-    readOnlyHint?: boolean;
+export type ToolAnnotations = Partial<ActionAnnotations> & {
     openWorldHint?: boolean;
 };
 export type Tool<Input extends ToolInput = ToolInput> = {

package/package.json

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