@lostgradient/weft 0.23.1 → 0.24.1

package/dist/worker/manifest/registry-contract-builder.d.ts

@@ -7,9 +7,27 @@
  * manifest — see {@link declaredShapeDigest}. This module is that build
  * tooling: it derives `WorkerWorkflowContract`/`WorkerActivityContract`
  * values from the *same* normalized representation `buildRegistrySnapshot`
- * produces for `GET /v1/registry` and `weft codegen`, hashed with the
- * collision-resistant {@link sha256Hex} rather than the cache-key-quality
- * FNV-1a scheme those placeholders use.
+ * produces for `GET /v1/registry` and `weft codegen`, hashed via
+ * `core/contract`'s canonical `contractHash()`/`activityContractHash()`/
+ * `deriveWorkflowRevision()` (WFT-5) — the same normalized-contract vocabulary
+ * `weft codegen` and `WorkflowRevisionManifest` use, rather than this
+ * module's own ad hoc hashing (as it did before WFT-5).
+ *
+ * **WFT-5 digest-value change.** `contractHash`/`workflowRevision` here now
+ * fold in a `contractVersion` domain separator (`WORKFLOW_CONTRACT_VERSION`)
+ * that the pre-WFT-5 formula never had, so digest *strings* for an
+ * otherwise-unchanged registration differ from 0.23.x output — see
+ * `CHANGELOG.md`. `workflowRevision` also now derives from a `WorkflowContract`
+ * that omits `queue`/`retry`/`timeout` (registry-only activity metadata with
+ * no contract-identity meaning), which the pre-WFT-5 formula's
+ * `{ ...entry, version }` spread incidentally included; this is a narrowing,
+ * not a behavior a caller could rely on. `contractHash` also now folds in
+ * whichever activities `options.workflows[type]` names (previously
+ * independent of that list, since only the activity's *own* schema was
+ * hashed) — declaring a different activity subset for the same workflow type
+ * now changes `contractHash`, which is the intended effect of a contract
+ * identity that is supposed to answer "what can a caller do with this
+ * workflow", not just "what does the workflow's own input/output look like".
  *
  * Intended use is a build script: construct an `Engine` with every workflow
  * the artifact bundles registered (never started), call

package/dist/worker/manifest/registry-contract-builder.js

@@ -1,11 +1,13 @@
 import {
-  buildRegistrySnapshot
-} from "../../core/registry-snapshot.js";
+  activityContractHash,
+  contractHash,
+  deriveWorkflowRevision
+} from "../../core/contract/index.js";
+import { buildActivityEntry } from "../../core/registry-snapshot.js";
+import { buildWorkflowManifestForType } from "../../core/registry-workflow-manifest.js";
 import { WeftError } from "../../core/weft-error.js";
 import { VERSION } from "../../version.js";
 import { REMOTE_WORKER_PROTOCOL_VERSION } from "../protocol.js";
-import { canonicalJsonStringify } from "./canonical-json.js";
-import { sha256Hex } from "./content-digest.js";
 import { WORKER_MANIFEST_VERSION } from "./types.js";
 
 export class WorkerManifestBuildError extends WeftError {
@@ -13,43 +15,50 @@ export class WorkerManifestBuildError extends WeftError {
     super("WorkerManifestBuildError", message);
   }
 }
-function findWorkflowEntry(snapshot, workflowType) {
-  const entry = snapshot.workflows[workflowType];
-  if (entry === void 0)
+async function findWorkflowManifest(engine, workflowType) {
+  const manifest = await buildWorkflowManifestForType(engine, workflowType);
+  if (manifest === void 0)
     throw new WorkerManifestBuildError(`Cannot build a worker manifest: workflow type "${workflowType}" is not registered on the source Engine.`);
-  return entry;
+  return manifest;
 }
-function findActivityEntry(snapshot, workflowType, activityName) {
-  const entry = snapshot.activities[activityName];
-  if (entry === void 0)
+function findActivityEntry(engine, workflowType, activityName) {
+  const metadata = engine.getWorkflowActivityDefinition(workflowType, activityName);
+  if (metadata === void 0)
     throw new WorkerManifestBuildError(`Cannot build a worker manifest: activity "${activityName}" declared under workflow "${workflowType}" is not registered on the source Engine.`);
-  return entry;
+  return buildActivityEntry(metadata);
 }
-function workflowContractPayload(entry) {
-  return {
-    inputSchema: entry.inputSchema,
-    outputSchema: entry.outputSchema,
-    signals: entry.signals,
-    updates: entry.updates,
-    queries: entry.queries
-  };
-}
-function activityContractPayload(entry) {
-  return { inputSchema: entry.inputSchema, outputSchema: entry.outputSchema };
+function toActivityContract(entry) {
+  const contract = {};
+  if (entry.inputSchema !== void 0)
+    contract.inputSchema = entry.inputSchema;
+  if (entry.outputSchema !== void 0)
+    contract.outputSchema = entry.outputSchema;
+  return contract;
 }
-async function buildActivityContract(snapshot, workflowType, activityName, implementationRevision) {
-  const entry = findActivityEntry(snapshot, workflowType, activityName);
-  return { contractHash: await sha256Hex(canonicalJsonStringify(activityContractPayload(entry))), implementationRevision };
+async function buildActivityContract(engine, workflowType, activityName, implementationRevision) {
+  const entry = findActivityEntry(engine, workflowType, activityName);
+  return { contractHash: await activityContractHash(toActivityContract(entry)), implementationRevision };
 }
-async function buildWorkflowContract(snapshot, workflowVersionsByType, workflowType, activityNames, implementationRevision) {
-  const entry = findWorkflowEntry(snapshot, workflowType), workflowVersion = workflowVersionsByType.get(workflowType), contractHash = await sha256Hex(canonicalJsonStringify(workflowContractPayload(entry))), workflowRevision = await sha256Hex(canonicalJsonStringify({ ...entry, version: workflowVersion })), sortedActivityNames = [...activityNames].toSorted(), activityContracts = await Promise.all(sortedActivityNames.map((activityName) => buildActivityContract(snapshot, workflowType, activityName, implementationRevision))), activities = {};
+async function buildWorkflowContract(engine, workflowType, activityNames, implementationRevision) {
+  const manifest = await findWorkflowManifest(engine, workflowType), workflowVersion = manifest.contract.workflowVersion, sortedActivityNames = [...activityNames].toSorted(), activities = Object.create(null);
+  for (const activityName of sortedActivityNames)
+    activities[activityName] = toActivityContract(findActivityEntry(engine, workflowType, activityName));
+  const baseContract = manifest.contract, contractForHash = Object.keys(activities).length > 0 ? { ...baseContract, activities } : baseContract, [hash, revision] = await Promise.all([
+    contractHash(contractForHash),
+    deriveWorkflowRevision(contractForHash)
+  ]), activityContracts = await Promise.all(sortedActivityNames.map((activityName) => buildActivityContract(engine, workflowType, activityName, implementationRevision))), workerActivities = Object.create(null);
   sortedActivityNames.forEach((activityName, index) => {
-    activities[activityName] = activityContracts[index];
+    workerActivities[activityName] = activityContracts[index];
   });
-  return { workflowVersion, workflowRevision, contractHash, activities };
+  return {
+    workflowVersion,
+    workflowRevision: revision,
+    contractHash: hash,
+    activities: workerActivities
+  };
 }
 export async function buildWorkerManifestFromRegistry(engine, options) {
-  const snapshot = buildRegistrySnapshot(engine), workflowVersionsByType = new Map(engine.listWorkflowDefinitions().map((definition) => [definition.type, definition.version])), sortedWorkflowTypes = Object.keys(options.workflows).toSorted(), workflowContracts = await Promise.all(sortedWorkflowTypes.map((workflowType) => buildWorkflowContract(snapshot, workflowVersionsByType, workflowType, options.workflows[workflowType] ?? [], options.deployment.buildId))), workflows = {};
+  const sortedWorkflowTypes = Object.keys(options.workflows).toSorted(), workflowContracts = await Promise.all(sortedWorkflowTypes.map((workflowType) => buildWorkflowContract(engine, workflowType, options.workflows[workflowType] ?? [], options.deployment.buildId))), workflows = Object.create(null);
   sortedWorkflowTypes.forEach((workflowType, index) => {
     workflows[workflowType] = workflowContracts[index];
   });

package/dist/worker/protocol-messages.d.ts

@@ -103,6 +103,12 @@ export type CompletedTaskResultMessage = {
     readonly value: RemoteWorkerJsonValue;
     /** Required per-dispatch token echoed from the {@link TaskMessage}. */
     readonly attemptToken: string;
+    /**
+     * Echo of {@link TaskMessage.workflowRevision} (WFT-20), when the dispatch
+     * carried one. Missing-or-mismatched echo authorization is transport-specific
+     * — see `remote-worker-protocol.md`'s revision-staleness section.
+     */
+    readonly workflowRevision?: string;
 };
 /**
  * Failed activity result message.
@@ -127,6 +133,8 @@ export type FailedTaskResultMessage = {
     readonly error: string;
     /** Required per-dispatch token echoed from the {@link TaskMessage}. */
     readonly attemptToken: string;
+    /** Echo of {@link TaskMessage.workflowRevision} (WFT-20) — see {@link CompletedTaskResultMessage.workflowRevision}. */
+    readonly workflowRevision?: string;
 };
 /**
  * Cancelled activity result message.
@@ -153,6 +161,8 @@ export type CancelledTaskResultMessage = {
     readonly cancelled?: true;
     /** Required per-dispatch token echoed from the {@link TaskMessage}. */
     readonly attemptToken: string;
+    /** Echo of {@link TaskMessage.workflowRevision} (WFT-20) — see {@link CompletedTaskResultMessage.workflowRevision}. */
+    readonly workflowRevision?: string;
 };
 /**
  * Registration acknowledgement sent after a worker is accepted.
@@ -262,6 +272,13 @@ export type TaskMessage = {
     readonly headers?: Readonly<Record<string, string>>;
     /** Durable token for the workflow run that launched this activity, when known. */
     readonly workflowExecutionToken?: string;
+    /**
+     * The dispatching workflow run's persisted revision (WFT-20), when known.
+     * A worker echoes this back on the resulting `taskResult`; the server
+     * rejects a completion whose echoed revision disagrees with the run's
+     * persisted revision as stale.
+     */
+    readonly workflowRevision?: string;
     /** Unique, unguessable token identifying this dispatch attempt. */
     readonly attemptToken: string;
 };

package/dist/worker/protocol-schemas.d.ts

@@ -84,6 +84,10 @@ export declare const REMOTE_WORKER_MESSAGE_SCHEMAS: {
                     readonly type: "string";
                     readonly minLength: 1;
                 };
+                readonly workflowRevision: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
             };
         }, {
             readonly type: "object";
@@ -107,6 +111,10 @@ export declare const REMOTE_WORKER_MESSAGE_SCHEMAS: {
                     readonly type: "string";
                     readonly minLength: 1;
                 };
+                readonly workflowRevision: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
             };
         }, {
             readonly type: "object";
@@ -133,6 +141,10 @@ export declare const REMOTE_WORKER_MESSAGE_SCHEMAS: {
                     readonly type: "string";
                     readonly minLength: 1;
                 };
+                readonly workflowRevision: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
             };
         }];
     };
@@ -162,6 +174,10 @@ export declare const REMOTE_WORKER_MESSAGE_SCHEMAS: {
                 readonly type: "string";
                 readonly minLength: 1;
             };
+            readonly workflowRevision: {
+                readonly type: "string";
+                readonly minLength: 1;
+            };
             readonly attemptToken: {
                 readonly type: "string";
                 readonly minLength: 1;
@@ -371,6 +387,10 @@ export declare const REMOTE_WORKER_PROTOCOL_JSON_SCHEMA: {
                             readonly type: "string";
                             readonly minLength: 1;
                         };
+                        readonly workflowRevision: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
                     };
                 }, {
                     readonly type: "object";
@@ -394,6 +414,10 @@ export declare const REMOTE_WORKER_PROTOCOL_JSON_SCHEMA: {
                             readonly type: "string";
                             readonly minLength: 1;
                         };
+                        readonly workflowRevision: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
                     };
                 }, {
                     readonly type: "object";
@@ -420,6 +444,10 @@ export declare const REMOTE_WORKER_PROTOCOL_JSON_SCHEMA: {
                             readonly type: "string";
                             readonly minLength: 1;
                         };
+                        readonly workflowRevision: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
                     };
                 }];
             };
@@ -449,6 +477,10 @@ export declare const REMOTE_WORKER_PROTOCOL_JSON_SCHEMA: {
                         readonly type: "string";
                         readonly minLength: 1;
                     };
+                    readonly workflowRevision: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
                     readonly attemptToken: {
                         readonly type: "string";
                         readonly minLength: 1;

package/dist/worker/protocol-schemas.js

@@ -44,7 +44,8 @@ export const REMOTE_WORKER_MESSAGE_SCHEMAS = {
           operationId: { type: "string", minLength: 1 },
           status: { const: "completed" },
           value: jsonValueSchema,
-          attemptToken: { type: "string", minLength: 1 }
+          attemptToken: { type: "string", minLength: 1 },
+          workflowRevision: { type: "string", minLength: 1 }
         }
       },
       {
@@ -56,7 +57,8 @@ export const REMOTE_WORKER_MESSAGE_SCHEMAS = {
           operationId: { type: "string", minLength: 1 },
           status: { const: "failed" },
           error: { type: "string" },
-          attemptToken: { type: "string", minLength: 1 }
+          attemptToken: { type: "string", minLength: 1 },
+          workflowRevision: { type: "string", minLength: 1 }
         }
       },
       {
@@ -69,7 +71,8 @@ export const REMOTE_WORKER_MESSAGE_SCHEMAS = {
           status: { const: "cancelled" },
           error: { type: "string" },
           cancelled: { const: !0 },
-          attemptToken: { type: "string", minLength: 1 }
+          attemptToken: { type: "string", minLength: 1 },
+          workflowRevision: { type: "string", minLength: 1 }
         }
       }
     ]
@@ -86,6 +89,7 @@ export const REMOTE_WORKER_MESSAGE_SCHEMAS = {
       attempt: { type: "number", minimum: 1 },
       headers: stringMapSchema,
       workflowExecutionToken: { type: "string", minLength: 1 },
+      workflowRevision: { type: "string", minLength: 1 },
       attemptToken: { type: "string", minLength: 1 }
     }
   },

package/dist/worker/protocol-task-result.js

@@ -9,6 +9,14 @@ function parseEchoedAttemptToken(record) {
     return protocolFailure("invalid_message", "taskResult.attemptToken must be a non-empty string");
   return { ok: !0, message: { attemptToken } };
 }
+function parseEchoedWorkflowRevision(record) {
+  const workflowRevision = record.workflowRevision;
+  if (workflowRevision === void 0)
+    return { ok: !0, message: {} };
+  if (!isNonEmptyString(workflowRevision))
+    return protocolFailure("invalid_message", "taskResult.workflowRevision must be a non-empty string when present");
+  return { ok: !0, message: { workflowRevision } };
+}
 function parseCompletedTaskResult(operationId, record) {
   const value = record.value;
   if (!isRemoteWorkerJsonValue(value))
@@ -16,9 +24,19 @@ function parseCompletedTaskResult(operationId, record) {
   const token = parseEchoedAttemptToken(record);
   if (!token.ok)
     return token;
+  const revision = parseEchoedWorkflowRevision(record);
+  if (!revision.ok)
+    return revision;
   return {
     ok: !0,
-    message: { type: "taskResult", operationId, status: "completed", value, ...token.message }
+    message: {
+      type: "taskResult",
+      operationId,
+      status: "completed",
+      value,
+      ...token.message,
+      ...revision.message
+    }
   };
 }
 function parseFailedTaskResult(operationId, record) {
@@ -28,9 +46,19 @@ function parseFailedTaskResult(operationId, record) {
   const token = parseEchoedAttemptToken(record);
   if (!token.ok)
     return token;
+  const revision = parseEchoedWorkflowRevision(record);
+  if (!revision.ok)
+    return revision;
   return {
     ok: !0,
-    message: { type: "taskResult", operationId, status: "failed", error, ...token.message }
+    message: {
+      type: "taskResult",
+      operationId,
+      status: "failed",
+      error,
+      ...token.message,
+      ...revision.message
+    }
   };
 }
 function parseCancelledTaskResult(operationId, record) {
@@ -43,6 +71,9 @@ function parseCancelledTaskResult(operationId, record) {
   const token = parseEchoedAttemptToken(record);
   if (!token.ok)
     return token;
+  const revision = parseEchoedWorkflowRevision(record);
+  if (!revision.ok)
+    return revision;
   return {
     ok: !0,
     message: {
@@ -51,7 +82,8 @@ function parseCancelledTaskResult(operationId, record) {
       status: "cancelled",
       error,
       ...cancelled === !0 ? { cancelled } : {},
-      ...token.message
+      ...token.message,
+      ...revision.message
     }
   };
 }

package/dist/worker/protocol.js

@@ -1,2 +1,2 @@
 // @bun
-var X=import.meta.require;function l(e){return e!==null&&typeof e==="object"&&!Array.isArray(e)}function p(e){if(e===null||typeof e==="string"||typeof e==="boolean"||typeof e==="number"&&Number.isFinite(e))return!0;if(Array.isArray(e))return e.every(p);if(!l(e))return!1;return Object.values(e).every(p)}function a(e){return typeof e==="string"&&e.length>0}function _(e){return Array.isArray(e)&&e.every(a)}function E(e){if(!l(e))return!1;return Object.values(e).every((t)=>typeof t==="string")}function u(e){return typeof e==="number"&&Number.isFinite(e)}function r(e,t,s){return{ok:!1,error:{code:e,message:t,...s!==void 0?{requestedProtocolVersion:s}:{}}}}function d(e,t,s){let o={};for(let[n,g,c,f]of s){let m=t[n];if(m===void 0){if(g)return{ok:!1,error:r(e,f)};continue}if(!c(m))return{ok:!1,error:r(e,f)};o[n]=m}return{ok:!0,values:o}}var i=3,M=3,O=3,T=[3];var R={$ref:"#/$defs/jsonValue"},S={type:"object",additionalProperties:R},w={type:"object",additionalProperties:{type:"string"}},P={const:i},k={register:{type:"object",additionalProperties:!1,required:["type","protocolVersion","workerId","manifest"],properties:{type:{const:"register"},protocolVersion:P,workerId:{type:"string",minLength:1},manifest:{type:"object"},concurrency:{type:"number",minimum:1,maximum:1000},startedAt:{type:"number"}}},heartbeat:{type:"object",additionalProperties:!1,required:["type","workerId"],properties:{type:{const:"heartbeat"},workerId:{type:"string",minLength:1}}},taskResult:{oneOf:[{type:"object",additionalProperties:!1,required:["type","operationId","status","value","attemptToken"],properties:{type:{const:"taskResult"},operationId:{type:"string",minLength:1},status:{const:"completed"},value:R,attemptToken:{type:"string",minLength:1}}},{type:"object",additionalProperties:!1,required:["type","operationId","status","error","attemptToken"],properties:{type:{const:"taskResult"},operationId:{type:"string",minLength:1},status:{const:"failed"},error:{type:"string"},attemptToken:{type:"string",minLength:1}}},{type:"object",additionalProperties:!1,required:["type","operationId","status","error","attemptToken"],properties:{type:{const:"taskResult"},operationId:{type:"string",minLength:1},status:{const:"cancelled"},error:{type:"string"},cancelled:{const:!0},attemptToken:{type:"string",minLength:1}}}]},task:{type:"object",additionalProperties:!1,required:["type","operationId","activityName","input","attemptToken"],properties:{type:{const:"task"},operationId:{type:"string",minLength:1},activityName:{type:"string",minLength:1},input:R,attempt:{type:"number",minimum:1},headers:w,workflowExecutionToken:{type:"string",minLength:1},attemptToken:{type:"string",minLength:1}}},cancel:{type:"object",additionalProperties:!1,required:["type","operationId"],properties:{type:{const:"cancel"},operationId:{type:"string",minLength:1}}},shutdown:{type:"object",additionalProperties:!1,required:["type"],properties:{type:{const:"shutdown"}}},registerAck:{type:"object",additionalProperties:!1,required:["type","protocolVersion","workerId","queue","concurrency","acceptedManifestDigest","serverCapabilities"],properties:{type:{const:"registerAck"},protocolVersion:P,workerId:{type:"string",minLength:1},queue:{type:"string",minLength:1},concurrency:{type:"number",minimum:1,maximum:1000},acceptedManifestDigest:{type:"string",minLength:1},serverCapabilities:{type:"array",items:{type:"string",minLength:1}}}},registerError:{type:"object",additionalProperties:!1,required:["type","code","message","supportedProtocolVersions"],properties:{type:{const:"registerError"},code:{enum:["invalid_registration","unsupported_protocol_version","deployment_conflict","registration_rejected"]},message:{type:"string"},supportedProtocolVersions:{type:"array",items:{type:"number"}},requestedProtocolVersion:{type:"number"}}},protocolError:{type:"object",additionalProperties:!1,required:["type","code","message"],properties:{type:{const:"protocolError"},code:{enum:["invalid_json","invalid_message","unknown_message_type","registration_required"]},message:{type:"string"}}}},W={$schema:"https://json-schema.org/draft/2020-12/schema",$id:`https://weft.dev/schemas/remote-worker-protocol.v${String(i)}.json`,title:`Weft RemoteWorker Protocol v${String(i)}`,oneOf:Object.keys(k).map((e)=>({$ref:`#/$defs/messages/${e}`})),$defs:{jsonValue:{oneOf:[{type:"null"},{type:"boolean"},{type:"number"},{type:"string"},{type:"array",items:{$ref:"#/$defs/jsonValue"}},{type:"object",additionalProperties:{$ref:"#/$defs/jsonValue"}}]},jsonObject:S,messages:k}};function y(e){let t=e.attemptToken;if(!a(t))return r("invalid_message","taskResult.attemptToken must be a non-empty string");return{ok:!0,message:{attemptToken:t}}}function h(e,t){let s=t.value;if(!p(s))return r("invalid_message","completed taskResult.value must be valid JSON");let o=y(t);if(!o.ok)return o;return{ok:!0,message:{type:"taskResult",operationId:e,status:"completed",value:s,...o.message}}}function v(e,t){let s=t.error;if(typeof s!=="string")return r("invalid_message","failed taskResult.error must be a string");let o=y(t);if(!o.ok)return o;return{ok:!0,message:{type:"taskResult",operationId:e,status:"failed",error:s,...o.message}}}function V(e,t){let s=t.error;if(typeof s!=="string")return r("invalid_message","cancelled taskResult.error must be a string");let o=t.cancelled;if(o!==void 0&&o!==!0)return r("invalid_message","taskResult.cancelled must be true when present");let n=y(t);if(!n.ok)return n;return{ok:!0,message:{type:"taskResult",operationId:e,status:"cancelled",error:s,...o===!0?{cancelled:o}:{},...n.message}}}var I={completed:h,failed:v,cancelled:V};function C(e){return e==="completed"||e==="failed"||e==="cancelled"}function b(e){let t=e.operationId;if(!a(t))return r("invalid_message","taskResult.operationId must be a non-empty string");let s=e.status;if(!C(s))return r("invalid_message","taskResult.status must be completed, failed, or cancelled");return I[s](t,e)}var j=new Set(["register","heartbeat","taskResult"]),A=new Set(["registerAck","registerError","protocolError","task","cancel","shutdown"]);function L(e){if(e===i)return{ok:!0,message:e};let t=u(e)?e:void 0;return r("unsupported_protocol_version",`Unsupported RemoteWorker protocol version: ${String(e)}`,t)}var N=[["workerId",!0,a,"register.workerId must be a non-empty string"],["manifest",!0,l,"register.manifest must be a JSON object"],["concurrency",!1,u,"register.concurrency must be a finite number"],["startedAt",!1,u,"register.startedAt must be a finite number when present"]];function x(e){let t=L(e.protocolVersion);if(!t.ok)return t;let s=d("invalid_registration",e,N);if(!s.ok)return s.error;return{ok:!0,message:{type:"register",protocolVersion:t.message,...s.values}}}function F(e){let t=e.workerId;if(!a(t))return r("invalid_message","heartbeat.workerId must be a non-empty string");return{ok:!0,message:{type:"heartbeat",workerId:t}}}var q=[["operationId",!0,a,"task.operationId must be a non-empty string"],["activityName",!0,a,"task.activityName must be a non-empty string"],["input",!0,p,"task.input must be valid JSON"],["attempt",!1,u,"task.attempt must be a finite number"],["headers",!1,E,"task.headers must be a string map"],["workflowExecutionToken",!1,a,"task.workflowExecutionToken must be a non-empty string"],["attemptToken",!0,a,"task.attemptToken must be a non-empty string"]];function J(e){let t=d("invalid_message",e,q);if(!t.ok)return t.error;return{ok:!0,message:{type:"task",...t.values}}}function K(e){let t=e.operationId;if(!a(t))return r("invalid_message","cancel.operationId must be a non-empty string");return{ok:!0,message:{type:"cancel",operationId:t}}}function D(){return{ok:!0,message:{type:"shutdown"}}}function H(e){let t=e.protocolVersion;if(t!==i)return r("invalid_message",`registerAck.protocolVersion must be ${String(i)}`);let{workerId:s,queue:o,concurrency:n,acceptedManifestDigest:g,serverCapabilities:c}=e;if(!a(s))return r("invalid_message","registerAck.workerId must be a non-empty string");if(!a(o))return r("invalid_message","registerAck.queue must be a non-empty string");if(typeof n!=="number"||!Number.isFinite(n))return r("invalid_message","registerAck.concurrency must be a finite number");if(!a(g))return r("invalid_message","registerAck.acceptedManifestDigest must be a non-empty string");if(!_(c))return r("invalid_message","registerAck.serverCapabilities must be an array of non-empty strings");return{ok:!0,message:{type:"registerAck",protocolVersion:t,workerId:s,queue:o,concurrency:n,acceptedManifestDigest:g,serverCapabilities:c}}}function U(e){return e==="invalid_registration"||e==="unsupported_protocol_version"||e==="deployment_conflict"||e==="registration_rejected"}function G(e){let{code:t,message:s,supportedProtocolVersions:o,requestedProtocolVersion:n}=e;if(!U(t))return r("invalid_message","registerError.code is not recognized");if(typeof s!=="string")return r("invalid_message","registerError.message must be a string");if(!Array.isArray(o)||!o.every((c)=>u(c)))return r("invalid_message","registerError.supportedProtocolVersions is invalid");if(n!==void 0&&!u(n))return r("invalid_message","registerError.requestedProtocolVersion must be a finite number");return{ok:!0,message:{type:"registerError",code:t,message:s,supportedProtocolVersions:o,...n!==void 0?{requestedProtocolVersion:n}:{}}}}function z(e){let{code:t,message:s}=e;if(t!=="invalid_json"&&t!=="invalid_message"&&t!=="unknown_message_type"&&t!=="registration_required")return r("invalid_message","protocolError.code is not recognized");if(typeof s!=="string")return r("invalid_message","protocolError.message must be a string");return{ok:!0,message:{type:"protocolError",code:t,message:s}}}function ie(e){if(!l(e))return r("invalid_message","Worker protocol message must be a JSON object");let t=e.type;if(typeof t!=="string")return r("invalid_message","Worker protocol message.type must be a string");if(!j.has(t))return r("unknown_message_type",`Unknown worker message type: ${t}`);switch(t){case"register":return x(e);case"heartbeat":return F(e);case"taskResult":return b(e);default:return r("unknown_message_type",`Unknown worker message type: ${t}`)}}function ue(e){if(!l(e))return r("invalid_message","Server protocol message must be a JSON object");let t=e.type;if(typeof t!=="string")return r("invalid_message","Server protocol message.type must be a string");if(!A.has(t))return r("unknown_message_type",`Unknown server message type: ${t}`);switch(t){case"registerAck":return H(e);case"registerError":return G(e);case"protocolError":return z(e);case"task":return J(e);case"cancel":return K(e);case"shutdown":return D();default:return r("unknown_message_type",`Unknown server message type: ${t}`)}}export{O as REMOTE_WORKER_MAX_PROTOCOL_VERSION,k as REMOTE_WORKER_MESSAGE_SCHEMAS,M as REMOTE_WORKER_MIN_PROTOCOL_VERSION,W as REMOTE_WORKER_PROTOCOL_JSON_SCHEMA,i as REMOTE_WORKER_PROTOCOL_VERSION,T as REMOTE_WORKER_SUPPORTED_PROTOCOL_VERSIONS,p as isRemoteWorkerJsonValue,ue as parseServerToWorkerMessage,ie as parseWorkerToServerMessage};
+var Y=import.meta.require;function g(e){return e!==null&&typeof e==="object"&&!Array.isArray(e)}function p(e){if(e===null||typeof e==="string"||typeof e==="boolean"||typeof e==="number"&&Number.isFinite(e))return!0;if(Array.isArray(e))return e.every(p);if(!g(e))return!1;return Object.values(e).every(p)}function i(e){return typeof e==="string"&&e.length>0}function E(e){return Array.isArray(e)&&e.every(i)}function P(e){if(!g(e))return!1;return Object.values(e).every((t)=>typeof t==="string")}function c(e){return typeof e==="number"&&Number.isFinite(e)}function r(e,t,s){return{ok:!1,error:{code:e,message:t,...s!==void 0?{requestedProtocolVersion:s}:{}}}}function d(e,t,s){let n={};for(let[o,a,l,_]of s){let m=t[o];if(m===void 0){if(a)return{ok:!1,error:r(e,_)};continue}if(!l(m))return{ok:!1,error:r(e,_)};n[o]=m}return{ok:!0,values:n}}var u=3,O=3,w=3,T=[3];var k={$ref:"#/$defs/jsonValue"},S={type:"object",additionalProperties:k},v={type:"object",additionalProperties:{type:"string"}},b={const:u},R={register:{type:"object",additionalProperties:!1,required:["type","protocolVersion","workerId","manifest"],properties:{type:{const:"register"},protocolVersion:b,workerId:{type:"string",minLength:1},manifest:{type:"object"},concurrency:{type:"number",minimum:1,maximum:1000},startedAt:{type:"number"}}},heartbeat:{type:"object",additionalProperties:!1,required:["type","workerId"],properties:{type:{const:"heartbeat"},workerId:{type:"string",minLength:1}}},taskResult:{oneOf:[{type:"object",additionalProperties:!1,required:["type","operationId","status","value","attemptToken"],properties:{type:{const:"taskResult"},operationId:{type:"string",minLength:1},status:{const:"completed"},value:k,attemptToken:{type:"string",minLength:1},workflowRevision:{type:"string",minLength:1}}},{type:"object",additionalProperties:!1,required:["type","operationId","status","error","attemptToken"],properties:{type:{const:"taskResult"},operationId:{type:"string",minLength:1},status:{const:"failed"},error:{type:"string"},attemptToken:{type:"string",minLength:1},workflowRevision:{type:"string",minLength:1}}},{type:"object",additionalProperties:!1,required:["type","operationId","status","error","attemptToken"],properties:{type:{const:"taskResult"},operationId:{type:"string",minLength:1},status:{const:"cancelled"},error:{type:"string"},cancelled:{const:!0},attemptToken:{type:"string",minLength:1},workflowRevision:{type:"string",minLength:1}}}]},task:{type:"object",additionalProperties:!1,required:["type","operationId","activityName","input","attemptToken"],properties:{type:{const:"task"},operationId:{type:"string",minLength:1},activityName:{type:"string",minLength:1},input:k,attempt:{type:"number",minimum:1},headers:v,workflowExecutionToken:{type:"string",minLength:1},workflowRevision:{type:"string",minLength:1},attemptToken:{type:"string",minLength:1}}},cancel:{type:"object",additionalProperties:!1,required:["type","operationId"],properties:{type:{const:"cancel"},operationId:{type:"string",minLength:1}}},shutdown:{type:"object",additionalProperties:!1,required:["type"],properties:{type:{const:"shutdown"}}},registerAck:{type:"object",additionalProperties:!1,required:["type","protocolVersion","workerId","queue","concurrency","acceptedManifestDigest","serverCapabilities"],properties:{type:{const:"registerAck"},protocolVersion:b,workerId:{type:"string",minLength:1},queue:{type:"string",minLength:1},concurrency:{type:"number",minimum:1,maximum:1000},acceptedManifestDigest:{type:"string",minLength:1},serverCapabilities:{type:"array",items:{type:"string",minLength:1}}}},registerError:{type:"object",additionalProperties:!1,required:["type","code","message","supportedProtocolVersions"],properties:{type:{const:"registerError"},code:{enum:["invalid_registration","unsupported_protocol_version","deployment_conflict","registration_rejected"]},message:{type:"string"},supportedProtocolVersions:{type:"array",items:{type:"number"}},requestedProtocolVersion:{type:"number"}}},protocolError:{type:"object",additionalProperties:!1,required:["type","code","message"],properties:{type:{const:"protocolError"},code:{enum:["invalid_json","invalid_message","unknown_message_type","registration_required"]},message:{type:"string"}}}},W={$schema:"https://json-schema.org/draft/2020-12/schema",$id:`https://weft.dev/schemas/remote-worker-protocol.v${String(u)}.json`,title:`Weft RemoteWorker Protocol v${String(u)}`,oneOf:Object.keys(R).map((e)=>({$ref:`#/$defs/messages/${e}`})),$defs:{jsonValue:{oneOf:[{type:"null"},{type:"boolean"},{type:"number"},{type:"string"},{type:"array",items:{$ref:"#/$defs/jsonValue"}},{type:"object",additionalProperties:{$ref:"#/$defs/jsonValue"}}]},jsonObject:S,messages:R}};function y(e){let t=e.attemptToken;if(!i(t))return r("invalid_message","taskResult.attemptToken must be a non-empty string");return{ok:!0,message:{attemptToken:t}}}function f(e){let t=e.workflowRevision;if(t===void 0)return{ok:!0,message:{}};if(!i(t))return r("invalid_message","taskResult.workflowRevision must be a non-empty string when present");return{ok:!0,message:{workflowRevision:t}}}function h(e,t){let s=t.value;if(!p(s))return r("invalid_message","completed taskResult.value must be valid JSON");let n=y(t);if(!n.ok)return n;let o=f(t);if(!o.ok)return o;return{ok:!0,message:{type:"taskResult",operationId:e,status:"completed",value:s,...n.message,...o.message}}}function V(e,t){let s=t.error;if(typeof s!=="string")return r("invalid_message","failed taskResult.error must be a string");let n=y(t);if(!n.ok)return n;let o=f(t);if(!o.ok)return o;return{ok:!0,message:{type:"taskResult",operationId:e,status:"failed",error:s,...n.message,...o.message}}}function I(e,t){let s=t.error;if(typeof s!=="string")return r("invalid_message","cancelled taskResult.error must be a string");let n=t.cancelled;if(n!==void 0&&n!==!0)return r("invalid_message","taskResult.cancelled must be true when present");let o=y(t);if(!o.ok)return o;let a=f(t);if(!a.ok)return a;return{ok:!0,message:{type:"taskResult",operationId:e,status:"cancelled",error:s,...n===!0?{cancelled:n}:{},...o.message,...a.message}}}var C={completed:h,failed:V,cancelled:I};function j(e){return e==="completed"||e==="failed"||e==="cancelled"}function M(e){let t=e.operationId;if(!i(t))return r("invalid_message","taskResult.operationId must be a non-empty string");let s=e.status;if(!j(s))return r("invalid_message","taskResult.status must be completed, failed, or cancelled");return C[s](t,e)}var A=new Set(["register","heartbeat","taskResult"]),L=new Set(["registerAck","registerError","protocolError","task","cancel","shutdown"]);function N(e){if(e===u)return{ok:!0,message:e};let t=c(e)?e:void 0;return r("unsupported_protocol_version",`Unsupported RemoteWorker protocol version: ${String(e)}`,t)}var x=[["workerId",!0,i,"register.workerId must be a non-empty string"],["manifest",!0,g,"register.manifest must be a JSON object"],["concurrency",!1,c,"register.concurrency must be a finite number"],["startedAt",!1,c,"register.startedAt must be a finite number when present"]];function F(e){let t=N(e.protocolVersion);if(!t.ok)return t;let s=d("invalid_registration",e,x);if(!s.ok)return s.error;return{ok:!0,message:{type:"register",protocolVersion:t.message,...s.values}}}function q(e){let t=e.workerId;if(!i(t))return r("invalid_message","heartbeat.workerId must be a non-empty string");return{ok:!0,message:{type:"heartbeat",workerId:t}}}var J=[["operationId",!0,i,"task.operationId must be a non-empty string"],["activityName",!0,i,"task.activityName must be a non-empty string"],["input",!0,p,"task.input must be valid JSON"],["attempt",!1,c,"task.attempt must be a finite number"],["headers",!1,P,"task.headers must be a string map"],["workflowExecutionToken",!1,i,"task.workflowExecutionToken must be a non-empty string"],["workflowRevision",!1,i,"task.workflowRevision must be a non-empty string"],["attemptToken",!0,i,"task.attemptToken must be a non-empty string"]];function K(e){let t=d("invalid_message",e,J);if(!t.ok)return t.error;return{ok:!0,message:{type:"task",...t.values}}}function D(e){let t=e.operationId;if(!i(t))return r("invalid_message","cancel.operationId must be a non-empty string");return{ok:!0,message:{type:"cancel",operationId:t}}}function H(){return{ok:!0,message:{type:"shutdown"}}}function U(e){let t=e.protocolVersion;if(t!==u)return r("invalid_message",`registerAck.protocolVersion must be ${String(u)}`);let{workerId:s,queue:n,concurrency:o,acceptedManifestDigest:a,serverCapabilities:l}=e;if(!i(s))return r("invalid_message","registerAck.workerId must be a non-empty string");if(!i(n))return r("invalid_message","registerAck.queue must be a non-empty string");if(typeof o!=="number"||!Number.isFinite(o))return r("invalid_message","registerAck.concurrency must be a finite number");if(!i(a))return r("invalid_message","registerAck.acceptedManifestDigest must be a non-empty string");if(!E(l))return r("invalid_message","registerAck.serverCapabilities must be an array of non-empty strings");return{ok:!0,message:{type:"registerAck",protocolVersion:t,workerId:s,queue:n,concurrency:o,acceptedManifestDigest:a,serverCapabilities:l}}}function G(e){return e==="invalid_registration"||e==="unsupported_protocol_version"||e==="deployment_conflict"||e==="registration_rejected"}function z(e){let{code:t,message:s,supportedProtocolVersions:n,requestedProtocolVersion:o}=e;if(!G(t))return r("invalid_message","registerError.code is not recognized");if(typeof s!=="string")return r("invalid_message","registerError.message must be a string");if(!Array.isArray(n)||!n.every((l)=>c(l)))return r("invalid_message","registerError.supportedProtocolVersions is invalid");if(o!==void 0&&!c(o))return r("invalid_message","registerError.requestedProtocolVersion must be a finite number");return{ok:!0,message:{type:"registerError",code:t,message:s,supportedProtocolVersions:n,...o!==void 0?{requestedProtocolVersion:o}:{}}}}function X(e){let{code:t,message:s}=e;if(t!=="invalid_json"&&t!=="invalid_message"&&t!=="unknown_message_type"&&t!=="registration_required")return r("invalid_message","protocolError.code is not recognized");if(typeof s!=="string")return r("invalid_message","protocolError.message must be a string");return{ok:!0,message:{type:"protocolError",code:t,message:s}}}function ue(e){if(!g(e))return r("invalid_message","Worker protocol message must be a JSON object");let t=e.type;if(typeof t!=="string")return r("invalid_message","Worker protocol message.type must be a string");if(!A.has(t))return r("unknown_message_type",`Unknown worker message type: ${t}`);switch(t){case"register":return F(e);case"heartbeat":return q(e);case"taskResult":return M(e);default:return r("unknown_message_type",`Unknown worker message type: ${t}`)}}function ce(e){if(!g(e))return r("invalid_message","Server protocol message must be a JSON object");let t=e.type;if(typeof t!=="string")return r("invalid_message","Server protocol message.type must be a string");if(!L.has(t))return r("unknown_message_type",`Unknown server message type: ${t}`);switch(t){case"registerAck":return U(e);case"registerError":return z(e);case"protocolError":return X(e);case"task":return K(e);case"cancel":return D(e);case"shutdown":return H();default:return r("unknown_message_type",`Unknown server message type: ${t}`)}}export{w as REMOTE_WORKER_MAX_PROTOCOL_VERSION,R as REMOTE_WORKER_MESSAGE_SCHEMAS,O as REMOTE_WORKER_MIN_PROTOCOL_VERSION,W as REMOTE_WORKER_PROTOCOL_JSON_SCHEMA,u as REMOTE_WORKER_PROTOCOL_VERSION,T as REMOTE_WORKER_SUPPORTED_PROTOCOL_VERSIONS,p as isRemoteWorkerJsonValue,ce as parseServerToWorkerMessage,ue as parseWorkerToServerMessage};

package/dist/worker/registry/types.d.ts

@@ -125,6 +125,8 @@ export interface InFlightTask {
     fairShareKey?: string;
     /** Unique, unguessable token for this dispatch attempt. */
     attemptToken: string;
+    /** The dispatching workflow run's persisted revision (WFT-20), when the `TaskDispatch` carried one. */
+    workflowRevision?: string;
 }
 export interface WorkerRegistryOptions {
     /** Routing policy used by {@link WorkerRegistry.findWorker}. Default: `'least-loaded'`. */

package/dist/worker/registry.d.ts

@@ -76,7 +76,7 @@ export declare class WorkerRegistry {
      */
     findWorker(activityName: string, options?: RoutingOptions): WorkerInfo | undefined;
     /** Track a task assignment with a visibility timeout deadline. */
-    assignTask(workerId: string, operationId: string, visibilityTimeout: number, fairShareKey: string | undefined, attemptToken: string): void;
+    assignTask(workerId: string, operationId: string, visibilityTimeout: number, fairShareKey: string | undefined, attemptToken: string, workflowRevision?: string): void;
     /**
      * Undo exactly `assignTask`'s effects — capacity increment, fair-share
      * count, and the in-flight entry — when the durable claim that was

package/dist/worker/registry.js

@@ -132,7 +132,7 @@ export class WorkerRegistry {
       return pickFairShare(eligible, this.#fairShareCounts, fairShareKey);
     return pickLeastLoaded(eligible);
   }
-  assignTask(workerId, operationId, visibilityTimeout, fairShareKey, attemptToken) {
+  assignTask(workerId, operationId, visibilityTimeout, fairShareKey, attemptToken, workflowRevision) {
     const deadline = Date.now() + visibilityTimeout, task = {
       operationId,
       workerId,
@@ -144,6 +144,8 @@ export class WorkerRegistry {
       task.fairShareKey = fairShareKey;
       this.#fairShareCounts.increment(workerId, fairShareKey);
     }
+    if (workflowRevision !== void 0)
+      task.workflowRevision = workflowRevision;
     this.#inFlightTasks.set(operationId, task);
     this.taskAssigned(workerId);
   }

package/dist/workers/workflow-runner.d.ts

@@ -42,6 +42,14 @@ export interface WorkflowRunnerContext {
     generators: Map<string, AsyncGenerator>;
     abortControllers: Map<string, AbortController>;
     replayStates: Map<string, WorkerReplayState>;
+    /**
+     * The revision (WFT-20) captured from the `run` message that started this
+     * workflow, keyed by workflow id — a `resume` inbound message never
+     * re-sends it, so `workflow-worker-entry.ts`'s `attachWorkerProtocol` reads
+     * it from here to stamp every outbound message for the workflow's
+     * remaining turns.
+     */
+    workflowRevisions: Map<string, string>;
 }
 export declare function createWorkflowRunnerContext(): WorkflowRunnerContext;
 export declare function handleRunMessage(context: WorkflowRunnerContext, message: {
@@ -53,6 +61,7 @@ export declare function handleRunMessage(context: WorkflowRunnerContext, message
     executionStateOwnerId?: string;
     deadline?: number;
     headers?: [string, string][];
+    workflowRevision?: string;
 }, getWorkflowHandler: (type: string) => ((ctx: WorkerWorkflowContext, input: unknown) => AsyncGenerator) | undefined, postLog?: WorkerLogPoster): Promise<WorkerOutboundMessage>;
 export declare function handleResumeMessage(context: WorkflowRunnerContext, message: {
     workflowId: string;

package/dist/workers/workflow-runner.js

@@ -77,10 +77,15 @@ export function createWorkflowRunnerContext() {
   return {
     generators: new Map,
     abortControllers: new Map,
-    replayStates: new Map
+    replayStates: new Map,
+    workflowRevisions: new Map
   };
 }
 export async function handleRunMessage(context, message, getWorkflowHandler, postLog) {
+  if (message.workflowRevision !== void 0)
+    context.workflowRevisions.set(message.workflowId, message.workflowRevision);
+  else
+    context.workflowRevisions.delete(message.workflowId);
   const handler = getWorkflowHandler(message.workflowType);
   if (!handler)
     return {
@@ -152,8 +157,10 @@ export async function handleCancelMessage(context, message) {
     try {
       await capturedGenerator.return(void 0);
     } catch {}
-  if (context.generators.get(message.workflowId) === capturedGenerator)
+  if (context.generators.get(message.workflowId) === capturedGenerator) {
     context.generators.delete(message.workflowId);
+    context.workflowRevisions.delete(message.workflowId);
+  }
   if (context.abortControllers.get(message.workflowId) === capturedController)
     context.abortControllers.delete(message.workflowId);
   if (context.replayStates.get(message.workflowId) === capturedReplayState)

package/dist/workers/workflow-worker-entry.js

@@ -49,7 +49,9 @@ export function initializeWorkerMessageLoop(workflows) {
   });
 }
 function postOutboundMessage(runnerContext, message, inboundMessage) {
-  const outboundMessage = attachWorkerProtocol(message, inboundMessage);
+  const activeTurnRevision = runnerContext.workflowRevisions.get(inboundMessage.workflowId), outboundMessage = attachWorkerProtocol(runnerContext, message, inboundMessage);
+  if (outboundMessage.type === "completed" || outboundMessage.type === "failed")
+    runnerContext.workflowRevisions.delete(inboundMessage.workflowId);
   try {
     assertWorkerProtocolMessageWithinLimit(outboundMessage, inboundMessage.maxProtocolMessageBytes);
     if (outboundMessage.type === "checkpoint")
@@ -62,7 +64,8 @@ function postOutboundMessage(runnerContext, message, inboundMessage) {
       workflowId: inboundMessage.workflowId,
       error: error instanceof Error ? error.message : String(error),
       failureCategory: "resource",
-      ...inboundMessage.turnId === void 0 ? {} : { turnId: inboundMessage.turnId }
+      ...inboundMessage.turnId === void 0 ? {} : { turnId: inboundMessage.turnId },
+      ...activeTurnRevision === void 0 ? {} : { workflowRevision: activeTurnRevision }
     });
     try {
       workerPostMessage(failedMessage);
@@ -71,10 +74,12 @@ function postOutboundMessage(runnerContext, message, inboundMessage) {
     }
   }
 }
-function attachWorkerProtocol(message, inboundMessage) {
+function attachWorkerProtocol(runnerContext, message, inboundMessage) {
+  const workflowRevision = runnerContext.workflowRevisions.get(inboundMessage.workflowId);
   return {
     ...message,
     protocolVersion: WORKER_PROTOCOL_VERSION,
-    ...inboundMessage.turnId === void 0 ? {} : { turnId: inboundMessage.turnId }
+    ...inboundMessage.turnId === void 0 ? {} : { turnId: inboundMessage.turnId },
+    ...workflowRevision === void 0 ? {} : { workflowRevision }
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lostgradient/weft",
-  "version": "0.23.1",
+  "version": "0.24.1",
   "description": "A Bun-native durable execution engine with pluggable key-value storage.",
   "keywords": [
     "bun",
@@ -221,7 +221,7 @@
     "dev": "bun --watch run src/index.ts",
     "format": "prettier --write \"**/*.{ts,tsx,js,jsx,json,md}\"",
     "format:check": "prettier --check \"**/*.{ts,tsx,js,jsx,json,md}\"",
-    "lint": "oxlint --type-aware --tsconfig ./tsconfig.json --report-unused-disable-directives-severity=error && bun run scripts/check-lint-disables.ts && bun run scripts/check-implementation-file-sizes.ts && bun run scripts/check-import-cycles.ts && bun run scripts/check-internal-imports.ts && bun run scripts/check-engine-internals-field-access.ts && bun run scripts/check-definition-vocabulary.ts && bun run scripts/check-catalog-completeness.ts && bun run scripts/check-catalog-drift.ts && bun run scripts/check-type-ergonomics.ts",
+    "lint": "oxlint --type-aware --tsconfig ./tsconfig.json --report-unused-disable-directives-severity=error && bun run scripts/check-lint-disables.ts && bun run scripts/check-implementation-file-sizes.ts && bun run scripts/check-import-cycles.ts && bun run scripts/check-internal-imports.ts && bun run scripts/check-engine-internals-field-access.ts && bun run scripts/check-revision-keyed-lookups.ts && bun run scripts/check-definition-vocabulary.ts && bun run scripts/check-catalog-completeness.ts && bun run scripts/check-catalog-drift.ts && bun run scripts/check-type-ergonomics.ts",
     "lint:fix": "oxlint --fix --type-aware --tsconfig ./tsconfig.json",
     "markdown-doctests:inventory": "bun run scripts/extract-markdown-doctests.ts inventory",
     "prepack": "bun run scripts/run-gates.ts prepack",