@anchrd/colab-sdk 0.1.5 → 0.1.7

package/dist/actions/actions.d.ts

@@ -607,6 +607,13 @@ export declare const ActionRow: z.ZodUnion<readonly [z.ZodObject<{
 }, z.core.$strict>]>;
 export type ActionRow = z.infer<typeof ActionRow>;
 export declare function isNodeRow(row: ActionRow): row is ActionItem;
+export declare const MachineInstructions: z.ZodObject<{
+    path: z.ZodString;
+    status: z.ZodNullable<z.ZodString>;
+    markdown: z.ZodString;
+    version: z.ZodNullable<z.ZodInt>;
+}, z.core.$strict>;
+export type MachineInstructions = z.infer<typeof MachineInstructions>;
 export declare const ActionList: z.ZodObject<{
     items: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
         node: z.ZodObject<{
@@ -805,6 +812,7 @@ export declare const ActionList: z.ZodObject<{
         path: z.ZodString;
         status: z.ZodNullable<z.ZodString>;
         markdown: z.ZodString;
+        version: z.ZodNullable<z.ZodInt>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 export type ActionList = z.infer<typeof ActionList>;

package/dist/actions/actions.js

@@ -164,6 +164,11 @@ export const ActionRow = z.union([ActionItem, ActionNoticeItem]);
 export function isNodeRow(row) {
     return "node" in row;
 }
+// A machine's own INSTRUCTIONS (#46): one link of #39's chain and the number of the version it was
+// read from, null when there is none. A run of an Operator records that number (#581, E111).
+export const MachineInstructions = InstructionsLink.extend({
+    version: z.int().min(1).nullable(),
+});
 export const ActionList = z.strictObject({
     // Newest first by since, then by node id (a notice by package and noticeKey). The filters tasks
     // and chats leave the notices out.
@@ -172,6 +177,7 @@ export const ActionList = z.strictObject({
     // Every row without the filter, for the number at the Actions icon.
     count: z.number().int(),
     // Only for a machine reading its own Actions over MCP, never over REST: the INSTRUCTIONS of its
-    // root folder as one link of #39's chain, empty when there is none (traps P033, P034).
-    instructions: InstructionsLink.optional(),
+    // root folder as one link of #39's chain with its version, empty when there is none (traps P033,
+    // P034).
+    instructions: MachineInstructions.optional(),
 });

package/dist/grammar/grammar.d.ts

@@ -34,7 +34,7 @@ export declare const resources: {
     readonly secret: "secrets";
 };
 export declare const actions: readonly ["list", "get", "create", "update", "archive", "restore", "purge"];
-export declare const verbs: readonly ["invite", "resend", "disable", "enable", "rotate", "share", "move", "start", "complete", "test", "revoke", "remove", "unlock", "publish", "schedule", "unpublish"];
+export declare const verbs: readonly ["invite", "resend", "disable", "enable", "rotate", "share", "move", "start", "complete", "test", "revoke", "remove", "unlock", "publish", "schedule", "unpublish", "cancel"];
 export type Package = (typeof packages)[number];
 export type Resource = keyof typeof resources;
 export type Action = (typeof actions)[number] | (typeof verbs)[number];

package/dist/grammar/grammar.js

@@ -84,6 +84,10 @@ export const verbs = [
     "publish",
     "schedule",
     "unpublish",
+    // A connector's run at the provider is ended before it completes (#567, E108):
+    // `fal_request_cancel`. Not `revoke`, which ends an access in Colab, and not `archive`: nothing
+    // stays to restore, and a cancelled run may still be billed.
+    "cancel",
 ];
 export function isPackage(word) {
     return packages.includes(word);

package/dist/operators/operators.d.ts

@@ -647,6 +647,12 @@ export declare const OperatorRunTouched: z.ZodObject<{
     connectors: z.ZodArray<z.ZodString>;
 }, z.core.$strict>;
 export type OperatorRunTouched = z.infer<typeof OperatorRunTouched>;
+export declare const OperatorRunInstructions: z.ZodObject<{
+    version: z.ZodNullable<z.ZodInt>;
+    status: z.ZodNullable<z.ZodString>;
+    cut: z.ZodBoolean;
+}, z.core.$strict>;
+export type OperatorRunInstructions = z.infer<typeof OperatorRunInstructions>;
 export declare const OperatorRun: z.ZodObject<{
     trigger: z.ZodEnum<{
         schedule: "schedule";
@@ -673,6 +679,11 @@ export declare const OperatorRun: z.ZodObject<{
         processes: z.ZodArray<z.ZodString>;
         connectors: z.ZodArray<z.ZodString>;
     }, z.core.$strict>;
+    instructions: z.ZodNullable<z.ZodObject<{
+        version: z.ZodNullable<z.ZodInt>;
+        status: z.ZodNullable<z.ZodString>;
+        cut: z.ZodBoolean;
+    }, z.core.$strict>>;
     credentialKind: z.ZodNullable<z.ZodEnum<{
         subscription: "subscription";
         apikey: "apikey";
@@ -809,6 +820,11 @@ export declare const OperatorRunList: z.ZodObject<{
             processes: z.ZodArray<z.ZodString>;
             connectors: z.ZodArray<z.ZodString>;
         }, z.core.$strict>;
+        instructions: z.ZodNullable<z.ZodObject<{
+            version: z.ZodNullable<z.ZodInt>;
+            status: z.ZodNullable<z.ZodString>;
+            cut: z.ZodBoolean;
+        }, z.core.$strict>>;
         credentialKind: z.ZodNullable<z.ZodEnum<{
             subscription: "subscription";
             apikey: "apikey";

package/dist/operators/operators.js

@@ -328,6 +328,13 @@ export const OperatorRunTouched = z.strictObject({
     processes: z.array(z.string().max(200)).max(200),
     connectors: z.array(z.string().max(200)).max(200),
 });
+// The INSTRUCTIONS a run got as its system message (#581, E111): the version of the document in the
+// Operator's root folder, its validation status then, and whether it was cut at the limit.
+export const OperatorRunInstructions = z.strictObject({
+    version: z.int().min(1).nullable(),
+    status: z.string().nullable(),
+    cut: z.boolean(),
+});
 // Who ran, named by the backend (#448): the machine's name in `access`, archived ones included, and
 // when the Operator was deleted (archived), so a run of a deleted Operator still says whose it was.
 const RunMachine = {
@@ -346,6 +353,8 @@ export const OperatorRun = z.strictObject({
     // The summary the Operator wrote at the end itself.
     summary: z.string().nullable(),
     touched: OperatorRunTouched,
+    // Null when the run got none: no text in its INSTRUCTIONS, or a run from before #581.
+    instructions: OperatorRunInstructions.nullable(),
     // The credential's kind decides how the cost reads: `apikey` is cost, `subscription` the API
     // equivalent (E81).
     credentialKind: CredentialKind.nullable(),

package/dist/sdk.d.ts

@@ -1,4 +1,4 @@
-export { ActionChat, ActionItem, ActionList, ActionListInput, ActionNotice, ActionNoticeButton, ActionNoticeCrumb, ActionNoticeItem, ActionNoticeKind, ActionNoticeReason, ActionNoticeTitle, ActionProcess, ActionRow, ActionRun, ActionSection, ActionTask, actionFilters, isNodeRow, } from "./actions/actions.js";
+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 { 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";
@@ -26,7 +26,7 @@ export { Flag, Limit } from "./list-input.js";
 export { MachineArchiveInput, MachineCreateInput, MachineId, MachineKey, MachinePurged, MachinePurgeInput, MachineRestoreInput, MachineRotateInput, MachineUpdateInput, } from "./machines/machines.js";
 export { ChatRead, ChatUpdateInput, Message, MessageAuthor, MessageCreateInput, MessageId, MessageList, MessageListInput, messageMaxLength, } from "./messages/messages.js";
 export { BoardShownKind, BoardSystem, FolderCreated, FolderCreateInput, IntelligenceUser, IntelligenceUserList, IntelligenceUserListInput, NodeDetail, NodeGetInput, NodeHit, NodeHitFoundIn, NodeHitGroup, NodeId, NodeKind, NodeList, NodeListInput, NodeListItem, NodeMoved, NodeMoveInput, NodePath, NodePerson, NodeQuery, NodeReader, NodeSearch, NodeSection, NodeSort, NodeUpdateInput, NodeValidation, nodeKinds, responsibleKinds, SearchIndexState, SecretFields, SecretId, } from "./nodes/nodes.js";
-export { Credential, CredentialCreateInput, CredentialGetInput, CredentialId, CredentialKind, CredentialList, CredentialListInput, CredentialRevokeInput, CredentialState, CredentialTested, CredentialTestInput, CredentialTestResult, CredentialUpdateInput, GatewayTarget, MachineDisableInput, MachineEnableInput, MachineGetInput, MachineListInput, modelsOf, Operator, OperatorLimits, OperatorList, OperatorMachineArchiveInput, OperatorMachineCreateInput, OperatorMachineUpdateInput, OperatorModel, type OperatorProviderEntry, OperatorRun, OperatorRunGetInput, OperatorRunId, OperatorRunList, OperatorRunListInput, OperatorRunReason, OperatorRunStatus, OperatorRunTokens, OperatorRunTouched, OperatorRunTrigger, OperatorRunUsage, OperatorState, operatorDefaults, operatorProviders, PauseReason, Subagents, Trigger, } from "./operators/operators.js";
+export { Credential, CredentialCreateInput, CredentialGetInput, CredentialId, CredentialKind, CredentialList, CredentialListInput, CredentialRevokeInput, CredentialState, CredentialTested, CredentialTestInput, CredentialTestResult, CredentialUpdateInput, GatewayTarget, MachineDisableInput, MachineEnableInput, MachineGetInput, MachineListInput, modelsOf, Operator, OperatorLimits, OperatorList, OperatorMachineArchiveInput, OperatorMachineCreateInput, OperatorMachineUpdateInput, OperatorModel, type OperatorProviderEntry, OperatorRun, OperatorRunGetInput, OperatorRunId, OperatorRunInstructions, OperatorRunList, OperatorRunListInput, OperatorRunReason, OperatorRunStatus, OperatorRunTokens, OperatorRunTouched, OperatorRunTrigger, OperatorRunUsage, OperatorState, operatorDefaults, operatorProviders, PauseReason, Subagents, Trigger, } from "./operators/operators.js";
 export { PageDetail, PageGetInput, PageHead, PageHeading, PageId, PageList, PageListInput, PageSummary, } from "./pages/pages.js";
 export { IdempotencyKey, Rev } from "./primitives/primitives.js";
 export { Locale, locales, Name, ProfileImageResponse, ProfileUpdateInput, profileImageMaxBytes, profileImageTypes, Theme, TimeZone, themes, } from "./profile/profile.js";

package/dist/sdk.js

@@ -1,7 +1,7 @@
 // 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, } from "./actions/actions.js";
+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 { 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";
@@ -29,7 +29,7 @@ export { Flag, Limit } from "./list-input.js";
 export { MachineArchiveInput, MachineCreateInput, MachineId, MachineKey, MachinePurged, MachinePurgeInput, MachineRestoreInput, MachineRotateInput, MachineUpdateInput, } from "./machines/machines.js";
 export { ChatRead, ChatUpdateInput, Message, MessageAuthor, MessageCreateInput, MessageId, MessageList, MessageListInput, messageMaxLength, } from "./messages/messages.js";
 export { BoardShownKind, BoardSystem, FolderCreated, FolderCreateInput, IntelligenceUser, IntelligenceUserList, IntelligenceUserListInput, NodeDetail, NodeGetInput, NodeHit, NodeHitFoundIn, NodeHitGroup, NodeId, NodeKind, NodeList, NodeListInput, NodeListItem, NodeMoved, NodeMoveInput, NodePath, NodePerson, NodeQuery, NodeReader, NodeSearch, NodeSection, NodeSort, NodeUpdateInput, NodeValidation, nodeKinds, responsibleKinds, SearchIndexState, SecretFields, SecretId, } from "./nodes/nodes.js";
-export { Credential, CredentialCreateInput, CredentialGetInput, CredentialId, CredentialKind, CredentialList, CredentialListInput, CredentialRevokeInput, CredentialState, CredentialTested, CredentialTestInput, CredentialTestResult, CredentialUpdateInput, GatewayTarget, MachineDisableInput, MachineEnableInput, MachineGetInput, MachineListInput, modelsOf, Operator, OperatorLimits, OperatorList, OperatorMachineArchiveInput, OperatorMachineCreateInput, OperatorMachineUpdateInput, OperatorModel, OperatorRun, OperatorRunGetInput, OperatorRunId, OperatorRunList, OperatorRunListInput, OperatorRunReason, OperatorRunStatus, OperatorRunTokens, OperatorRunTouched, OperatorRunTrigger, OperatorRunUsage, OperatorState, operatorDefaults, operatorProviders, PauseReason, Subagents, Trigger, } from "./operators/operators.js";
+export { Credential, CredentialCreateInput, CredentialGetInput, CredentialId, CredentialKind, CredentialList, CredentialListInput, CredentialRevokeInput, CredentialState, CredentialTested, CredentialTestInput, CredentialTestResult, CredentialUpdateInput, GatewayTarget, MachineDisableInput, MachineEnableInput, MachineGetInput, MachineListInput, modelsOf, Operator, OperatorLimits, OperatorList, OperatorMachineArchiveInput, OperatorMachineCreateInput, OperatorMachineUpdateInput, OperatorModel, OperatorRun, OperatorRunGetInput, OperatorRunId, OperatorRunInstructions, OperatorRunList, OperatorRunListInput, OperatorRunReason, OperatorRunStatus, OperatorRunTokens, OperatorRunTouched, OperatorRunTrigger, OperatorRunUsage, OperatorState, operatorDefaults, operatorProviders, PauseReason, Subagents, Trigger, } from "./operators/operators.js";
 export { PageDetail, PageGetInput, PageHead, PageHeading, PageId, PageList, PageListInput, PageSummary, } from "./pages/pages.js";
 export { IdempotencyKey, Rev } from "./primitives/primitives.js";
 export { Locale, locales, Name, ProfileImageResponse, ProfileUpdateInput, profileImageMaxBytes, profileImageTypes, Theme, TimeZone, themes, } from "./profile/profile.js";

package/package.json

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