@xemahq/dsl 0.6.1 → 0.8.0

package/dist/deliverable-spec/lib/schema.d.ts

@@ -57,6 +57,7 @@ export declare const DeliverableSpecSpecSchema: z.ZodObject<{
     standards: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
     zodSchemaSource: z.ZodOptional<z.ZodString>;
     zodSchemaSourceFile: z.ZodOptional<z.ZodString>;
+    zodSchemaExport: z.ZodOptional<z.ZodString>;
     fetchSpec: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     assets: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
     rules: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -109,6 +110,7 @@ export declare const DeliverableSpecManifestSchema: z.ZodObject<{
         standards: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
         zodSchemaSource: z.ZodOptional<z.ZodString>;
         zodSchemaSourceFile: z.ZodOptional<z.ZodString>;
+        zodSchemaExport: z.ZodOptional<z.ZodString>;
         fetchSpec: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         assets: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
         rules: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;

package/dist/deliverable-spec/lib/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/deliverable-spec/lib/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsCxB,eAAO,MAAM,sBAAsB,6HAQzB,CAAC;AAEX,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAOjF,eAAO,MAAM,gBAAgB,uCAAwC,CAAC;AAEtE,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAOtE,eAAO,MAAM,sBAAsB;;;;iBAQjC,CAAC;AAOH,eAAO,MAAM,oBAAoB;;iBAE/B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;mBAG3B,CAAC;AAMH,eAAO,MAAM,6BAA6B;;;;;iBAcxC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoEnC,CAAC;AAEJ,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYtC,CAAC;AAIL,eAAO,MAAM,oCAAoC;;;iBAU/C,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;;iBA0B1C,CAAC;AAEJ,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;iBAY7C,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/deliverable-spec/lib/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsCxB,eAAO,MAAM,sBAAsB,6HAQzB,CAAC;AAEX,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAOjF,eAAO,MAAM,gBAAgB,uCAAwC,CAAC;AAEtE,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAOtE,eAAO,MAAM,sBAAsB;;;;iBAQjC,CAAC;AAOH,eAAO,MAAM,oBAAoB;;iBAE/B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;mBAG3B,CAAC;AAMH,eAAO,MAAM,6BAA6B;;;;;iBAcxC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2FnC,CAAC;AAEJ,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYtC,CAAC;AAIL,eAAO,MAAM,oCAAoC;;;iBAU/C,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;;iBA0B1C,CAAC;AAEJ,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;iBAY7C,CAAC"}

package/dist/deliverable-spec/lib/schema.js

@@ -69,6 +69,10 @@ exports.DeliverableSpecSpecSchema = zod_1.z
     standards: zod_1.z.array(zod_1.z.unknown()).optional(),
     zodSchemaSource: zod_1.z.string().max(200_000).optional(),
     zodSchemaSourceFile: zod_1.z.string().min(1).optional(),
+    zodSchemaExport: zod_1.z
+        .string()
+        .regex(/^[A-Za-z_$][A-Za-z0-9_$]*$/, 'zodSchemaExport must be a JavaScript identifier (the exported const name)')
+        .optional(),
     fetchSpec: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
     assets: zod_1.z.array(zod_1.z.unknown()).optional(),
     rules: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
@@ -82,7 +86,12 @@ exports.DeliverableSpecSpecSchema = zod_1.z
     .refine((s) => !(s.zodSchemaSource !== undefined && s.zodSchemaSourceFile !== undefined), {
     message: 'spec cannot declare both `zodSchemaSource` and `zodSchemaSourceFile`',
 })
-    .refine((s) => !(s.multiPage === true && (s.pages === undefined || s.pages.length === 0)), { message: 'multiPage=true requires non-empty `pages[]`' });
+    .refine((s) => !(s.multiPage === true && (s.pages === undefined || s.pages.length === 0)), { message: 'multiPage=true requires non-empty `pages[]`' })
+    .refine((s) => s.zodSchemaExport === undefined ||
+    s.zodSchemaSource !== undefined ||
+    s.zodSchemaSourceFile !== undefined, {
+    message: '`zodSchemaExport` names an export in the Zod source, so it requires `zodSchemaSource` or `zodSchemaSourceFile`',
+});
 exports.DeliverableSpecManifestSchema = zod_1.z
     .object({
     apiVersion: zod_1.z.literal('xema.dev/deliverable/v1'),

package/dist/deliverable-spec/lib/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/deliverable-spec/lib/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/deliverable-spec/lib/schema.ts"],"names":[],"mappings":"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"}

package/dist/schema/reusable-workflow.schema.json

@@ -10,7 +10,15 @@
     "apiVersion": { "type": "string", "const": "xema.dev/workflow/v1alpha1" },
     "kind": { "type": "string", "const": "Workflow" },
     "metadata": {
-      "$ref": "https://xema.dev/schemas/workflow/v1alpha1/Workflow.json#/$defs/Metadata"
+      "allOf": [
+        {
+          "$ref": "https://xema.dev/schemas/workflow/v1alpha1/Workflow.json#/$defs/Metadata"
+        },
+        {
+          "type": "object",
+          "required": ["contractVersion"]
+        }
+      ]
     },
     "on": {
       "type": "object",

package/dist/schema/workflow.schema.json

@@ -36,17 +36,24 @@
       "type": "object",
       "description": "Workflow-level named outputs. Each key references a (job, outputName) pair via fromJob/fromOutput and declares the kind of value surfaced.",
       "additionalProperties": { "$ref": "#/$defs/WorkflowOutput" },
-      "propertyNames": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{0,62}$" }
+      "propertyNames": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9_-]{0,62}$"
+      }
     }
   },
   "$defs": {
     "Metadata": {
       "type": "object",
-      "required": ["name", "version"],
+      "required": ["name"],
       "additionalProperties": false,
       "properties": {
         "name": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,62}$" },
-        "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(-[A-Za-z0-9.-]+)?$" },
+        "contractVersion": {
+          "type": "string",
+          "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(-[A-Za-z0-9.-]+)?$",
+          "description": "Compatibility version for an explicitly reusable public workflow contract. Ordinary workflows omit this field."
+        },
         "title": { "type": "string", "maxLength": 120 },
         "description": { "type": "string", "maxLength": 4000 },
         "category": { "type": "string", "minLength": 1, "maxLength": 120 },
@@ -150,7 +157,10 @@
           "description": "Standard 5-field cron expression.",
           "pattern": "^[^\\s]+\\s+[^\\s]+\\s+[^\\s]+\\s+[^\\s]+\\s+[^\\s]+$"
         },
-        "timezone": { "type": "string", "pattern": "^[A-Za-z][A-Za-z0-9+_/-]+$" },
+        "timezone": {
+          "type": "string",
+          "pattern": "^[A-Za-z][A-Za-z0-9+_/-]+$"
+        },
         "inputs": {
           "type": "object",
           "description": "Pre-bound inputs for every fire.",
@@ -260,7 +270,11 @@
       "properties": {
         "maxAttempts": { "type": "integer", "minimum": 1, "maximum": 20 },
         "initialInterval": { "$ref": "#/$defs/Timeout" },
-        "backoffCoefficient": { "type": "number", "minimum": 1.0, "maximum": 10.0 },
+        "backoffCoefficient": {
+          "type": "number",
+          "minimum": 1.0,
+          "maximum": 10.0
+        },
         "maximumInterval": { "$ref": "#/$defs/Timeout" },
         "nonRetryableErrorTypes": {
           "type": "array",
@@ -350,10 +364,7 @@
         },
         "maxParallel": { "type": "integer", "minimum": 1, "maximum": 64 }
       },
-      "oneOf": [
-        { "required": ["matrix"] },
-        { "required": ["dynamic"] }
-      ]
+      "oneOf": [{ "required": ["matrix"] }, { "required": ["dynamic"] }]
     },
     "WorkflowOutput": {
       "type": "object",
@@ -364,19 +375,31 @@
           "properties": {
             "kind": { "const": "deliverable" },
             "slug": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,62}$" },
-            "fromJob": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{0,62}$" },
+            "fromJob": {
+              "type": "string",
+              "pattern": "^[a-z][a-z0-9_-]{0,62}$"
+            },
             "fromOutput": { "type": "string", "minLength": 1 },
             "description": { "type": "string", "maxLength": 4000 },
             "deliverableSpecRef": { "type": "string", "minLength": 1 }
           },
-          "required": ["kind", "slug", "fromJob", "fromOutput", "deliverableSpecRef"]
+          "required": [
+            "kind",
+            "slug",
+            "fromJob",
+            "fromOutput",
+            "deliverableSpecRef"
+          ]
         },
         {
           "additionalProperties": false,
           "properties": {
             "kind": { "const": "structured" },
             "slug": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,62}$" },
-            "fromJob": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{0,62}$" },
+            "fromJob": {
+              "type": "string",
+              "pattern": "^[a-z][a-z0-9_-]{0,62}$"
+            },
             "fromOutput": { "type": "string", "minLength": 1 },
             "description": { "type": "string", "maxLength": 4000 },
             "schemaRef": { "type": "string", "minLength": 1 }
@@ -388,7 +411,10 @@
           "properties": {
             "kind": { "const": "text" },
             "slug": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,62}$" },
-            "fromJob": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{0,62}$" },
+            "fromJob": {
+              "type": "string",
+              "pattern": "^[a-z][a-z0-9_-]{0,62}$"
+            },
             "fromOutput": { "type": "string", "minLength": 1 },
             "description": { "type": "string", "maxLength": 4000 }
           },

package/dist/workflow/index.d.ts

@@ -10,5 +10,8 @@ export { dispatchInputsToJsonSchema } from './lib/dispatch-inputs/to-json-schema
 export { serializeWorkflowDocument } from './lib/serializer';
 export { DECISION_GATE_ACTION_ID, applyGateDefaults, canonicalJsonSha256, canonicalJsonStringify, compileManifestSource, compileWorkflow, getWorkspaceManifestContract, isAgentShapedAction, type CompileInput, type ResolvedAgentMeta, type ResolvedDeliverableSpec, type ResolvedRef, } from './lib/compiler';
 export { extractZodTopLevelObjectKeys, extractJsonSchemaTopLevelKeys, } from './lib/deliverable-spec-keys';
+export { DeliverableSpecIntrospectionError, DeliverableSpecIntrospectionFailure, isDeliverableSpecIntrospectionError, } from './lib/deliverable-spec-introspection-error';
+export { scanTopLevelZodObjectDeclarations } from './lib/deliverable-spec-source-scan';
+export type { TopLevelZodObjectDeclaration } from './lib/deliverable-spec-source-scan';
 export type { ActionContract, ActionManifest, ActionManifestMetadata, ActionManifestRetryDefaults, ActionManifestSpec, ActionManifestTimeoutDefaults, WorkspaceManifestActionContract, ScheduleDeclaration, WebhookDeclaration, WorkflowCallDeclaration, WorkflowConcurrencyDeclaration, WorkflowDefaults, WorkflowGateDefaults, WorkflowDispatchDeclaration, WorkflowDocument, WorkflowDynamicStrategyDeclaration, WorkflowInputDeclaration, WorkflowJobDeclaration, WorkflowMetadata, WorkflowPermissions, WorkflowRetryDeclaration, WorkflowStrategyDeclaration, WorkflowTriggerDeclarations, } from './lib/types';
 //# sourceMappingURL=index.d.ts.map

package/dist/workflow/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EACL,oBAAoB,EACpB,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,GACjC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,wBAAwB,EACxB,gCAAgC,EAChC,KAAK,6BAA6B,GACnC,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EACL,0BAA0B,EAC1B,oCAAoC,EACpC,4BAA4B,EAC5B,sBAAsB,EACtB,gCAAgC,EAChC,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,UAAU,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,+BAA+B,EAC/B,KAAK,uBAAuB,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,4BAA4B,EAC5B,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,WAAW,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,cAAc,EACd,cAAc,EACd,sBAAsB,EACtB,2BAA2B,EAC3B,kBAAkB,EAClB,6BAA6B,EAC7B,+BAA+B,EAC/B,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,8BAA8B,EAC9B,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,gBAAgB,EAChB,kCAAkC,EAClC,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EACL,oBAAoB,EACpB,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,GACjC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,wBAAwB,EACxB,gCAAgC,EAChC,KAAK,6BAA6B,GACnC,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EACL,0BAA0B,EAC1B,oCAAoC,EACpC,4BAA4B,EAC5B,sBAAsB,EACtB,gCAAgC,EAChC,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,UAAU,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,+BAA+B,EAC/B,KAAK,uBAAuB,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,4BAA4B,EAC5B,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,WAAW,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,iCAAiC,EACjC,mCAAmC,EACnC,mCAAmC,GACpC,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,iCAAiC,EAAE,MAAM,oCAAoC,CAAC;AACvF,YAAY,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AACvF,YAAY,EACV,cAAc,EACd,cAAc,EACd,sBAAsB,EACtB,2BAA2B,EAC3B,kBAAkB,EAClB,6BAA6B,EAC7B,+BAA+B,EAC/B,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,8BAA8B,EAC9B,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,gBAAgB,EAChB,kCAAkC,EAClC,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,aAAa,CAAC"}

package/dist/workflow/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractJsonSchemaTopLevelKeys = exports.extractZodTopLevelObjectKeys = exports.isAgentShapedAction = exports.getWorkspaceManifestContract = exports.compileWorkflow = exports.compileManifestSource = exports.canonicalJsonStringify = exports.canonicalJsonSha256 = exports.applyGateDefaults = exports.DECISION_GATE_ACTION_ID = exports.serializeWorkflowDocument = exports.dispatchInputsToJsonSchema = exports.extractDispatchInputDescriptors = exports.DispatchInputStringFormat = exports.DispatchInputFieldType = exports.parseDurationMs = exports.stripInterpolation = exports.isInterpolationWrapped = exports.extractInterpolations = exports.evaluateExpression = exports.compileExpression = exports.ExpressionRoot = exports.ExpressionNodeKind = exports.ExpressionFunction = exports.EMPTY_CONTEXT_SEEDS = exports.validateWorkflowDocument = exports.validateReusableWorkflowDocument = exports.validateActionManifest = exports.parseAndValidateWorkflowYaml = exports.parseAndValidateReusableWorkflowYaml = exports.parseAndValidateActionYaml = exports.collectInstallationResourceHints = exports.InstallationResourceKind = exports.validateActionInputs = exports.isWorkflowDslError = exports.WorkflowDslError = void 0;
+exports.scanTopLevelZodObjectDeclarations = exports.isDeliverableSpecIntrospectionError = exports.DeliverableSpecIntrospectionFailure = exports.DeliverableSpecIntrospectionError = exports.extractJsonSchemaTopLevelKeys = exports.extractZodTopLevelObjectKeys = exports.isAgentShapedAction = exports.getWorkspaceManifestContract = exports.compileWorkflow = exports.compileManifestSource = exports.canonicalJsonStringify = exports.canonicalJsonSha256 = exports.applyGateDefaults = exports.DECISION_GATE_ACTION_ID = exports.serializeWorkflowDocument = exports.dispatchInputsToJsonSchema = exports.extractDispatchInputDescriptors = exports.DispatchInputStringFormat = exports.DispatchInputFieldType = exports.parseDurationMs = exports.stripInterpolation = exports.isInterpolationWrapped = exports.extractInterpolations = exports.evaluateExpression = exports.compileExpression = exports.ExpressionRoot = exports.ExpressionNodeKind = exports.ExpressionFunction = exports.EMPTY_CONTEXT_SEEDS = exports.validateWorkflowDocument = exports.validateReusableWorkflowDocument = exports.validateActionManifest = exports.parseAndValidateWorkflowYaml = exports.parseAndValidateReusableWorkflowYaml = exports.parseAndValidateActionYaml = exports.collectInstallationResourceHints = exports.InstallationResourceKind = exports.validateActionInputs = exports.isWorkflowDslError = exports.WorkflowDslError = void 0;
 var errors_1 = require("./lib/errors");
 Object.defineProperty(exports, "WorkflowDslError", { enumerable: true, get: function () { return errors_1.WorkflowDslError; } });
 Object.defineProperty(exports, "isWorkflowDslError", { enumerable: true, get: function () { return errors_1.isWorkflowDslError; } });
@@ -48,4 +48,10 @@ Object.defineProperty(exports, "isAgentShapedAction", { enumerable: true, get: f
 var deliverable_spec_keys_1 = require("./lib/deliverable-spec-keys");
 Object.defineProperty(exports, "extractZodTopLevelObjectKeys", { enumerable: true, get: function () { return deliverable_spec_keys_1.extractZodTopLevelObjectKeys; } });
 Object.defineProperty(exports, "extractJsonSchemaTopLevelKeys", { enumerable: true, get: function () { return deliverable_spec_keys_1.extractJsonSchemaTopLevelKeys; } });
+var deliverable_spec_introspection_error_1 = require("./lib/deliverable-spec-introspection-error");
+Object.defineProperty(exports, "DeliverableSpecIntrospectionError", { enumerable: true, get: function () { return deliverable_spec_introspection_error_1.DeliverableSpecIntrospectionError; } });
+Object.defineProperty(exports, "DeliverableSpecIntrospectionFailure", { enumerable: true, get: function () { return deliverable_spec_introspection_error_1.DeliverableSpecIntrospectionFailure; } });
+Object.defineProperty(exports, "isDeliverableSpecIntrospectionError", { enumerable: true, get: function () { return deliverable_spec_introspection_error_1.isDeliverableSpecIntrospectionError; } });
+var deliverable_spec_source_scan_1 = require("./lib/deliverable-spec-source-scan");
+Object.defineProperty(exports, "scanTopLevelZodObjectDeclarations", { enumerable: true, get: function () { return deliverable_spec_source_scan_1.scanTopLevelZodObjectDeclarations; } });
 //# sourceMappingURL=index.js.map

package/dist/workflow/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":";;;AAeA,uCAAoE;AAA3D,0GAAA,gBAAgB,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAC7C,uEAIsC;AAHpC,8HAAA,oBAAoB,OAAA;AAItB,+EAI0C;AAHxC,sIAAA,wBAAwB,OAAA;AACxB,8IAAA,gCAAgC,OAAA;AAIlC,2CAOwB;AANtB,sHAAA,0BAA0B,OAAA;AAC1B,gIAAA,oCAAoC,OAAA;AACpC,wHAAA,4BAA4B,OAAA;AAC5B,kHAAA,sBAAsB,OAAA;AACtB,4HAAA,gCAAgC,OAAA;AAChC,oHAAA,wBAAwB,OAAA;AAE1B,+CAa0B;AAZxB,iHAAA,mBAAmB,OAAA;AACnB,gHAAA,kBAAkB,OAAA;AAClB,gHAAA,kBAAkB,OAAA;AAClB,4GAAA,cAAc,OAAA;AACd,+GAAA,iBAAiB,OAAA;AACjB,gHAAA,kBAAkB,OAAA;AAClB,mHAAA,qBAAqB,OAAA;AACrB,oHAAA,sBAAsB,OAAA;AACtB,gHAAA,kBAAkB,OAAA;AAKpB,2CAAiD;AAAxC,2GAAA,eAAe,OAAA;AACxB,yDAK+B;AAJ7B,yHAAA,sBAAsB,OAAA;AACtB,4HAAA,yBAAyB,OAAA;AACzB,kIAAA,+BAA+B,OAAA;AAGjC,uEAAkF;AAAzE,4HAAA,0BAA0B,OAAA;AACnC,+CAA6D;AAApD,uHAAA,yBAAyB,OAAA;AAClC,2CAawB;AAZtB,mHAAA,uBAAuB,OAAA;AACvB,6GAAA,iBAAiB,OAAA;AACjB,+GAAA,mBAAmB,OAAA;AACnB,kHAAA,sBAAsB,OAAA;AACtB,iHAAA,qBAAqB,OAAA;AACrB,2GAAA,eAAe,OAAA;AACf,wHAAA,4BAA4B,OAAA;AAC5B,+GAAA,mBAAmB,OAAA;AAMrB,qEAGqC;AAFnC,qIAAA,4BAA4B,OAAA;AAC5B,sIAAA,6BAA6B,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":";;;AAeA,uCAAoE;AAA3D,0GAAA,gBAAgB,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAC7C,uEAIsC;AAHpC,8HAAA,oBAAoB,OAAA;AAItB,+EAI0C;AAHxC,sIAAA,wBAAwB,OAAA;AACxB,8IAAA,gCAAgC,OAAA;AAIlC,2CAOwB;AANtB,sHAAA,0BAA0B,OAAA;AAC1B,gIAAA,oCAAoC,OAAA;AACpC,wHAAA,4BAA4B,OAAA;AAC5B,kHAAA,sBAAsB,OAAA;AACtB,4HAAA,gCAAgC,OAAA;AAChC,oHAAA,wBAAwB,OAAA;AAE1B,+CAa0B;AAZxB,iHAAA,mBAAmB,OAAA;AACnB,gHAAA,kBAAkB,OAAA;AAClB,gHAAA,kBAAkB,OAAA;AAClB,4GAAA,cAAc,OAAA;AACd,+GAAA,iBAAiB,OAAA;AACjB,gHAAA,kBAAkB,OAAA;AAClB,mHAAA,qBAAqB,OAAA;AACrB,oHAAA,sBAAsB,OAAA;AACtB,gHAAA,kBAAkB,OAAA;AAKpB,2CAAiD;AAAxC,2GAAA,eAAe,OAAA;AACxB,yDAK+B;AAJ7B,yHAAA,sBAAsB,OAAA;AACtB,4HAAA,yBAAyB,OAAA;AACzB,kIAAA,+BAA+B,OAAA;AAGjC,uEAAkF;AAAzE,4HAAA,0BAA0B,OAAA;AACnC,+CAA6D;AAApD,uHAAA,yBAAyB,OAAA;AAClC,2CAawB;AAZtB,mHAAA,uBAAuB,OAAA;AACvB,6GAAA,iBAAiB,OAAA;AACjB,+GAAA,mBAAmB,OAAA;AACnB,kHAAA,sBAAsB,OAAA;AACtB,iHAAA,qBAAqB,OAAA;AACrB,2GAAA,eAAe,OAAA;AACf,wHAAA,4BAA4B,OAAA;AAC5B,+GAAA,mBAAmB,OAAA;AAMrB,qEAGqC;AAFnC,qIAAA,4BAA4B,OAAA;AAC5B,sIAAA,6BAA6B,OAAA;AAE/B,mGAIoD;AAHlD,yJAAA,iCAAiC,OAAA;AACjC,2JAAA,mCAAmC,OAAA;AACnC,2JAAA,mCAAmC,OAAA;AAErC,mFAAuF;AAA9E,iJAAA,iCAAiC,OAAA"}

package/dist/workflow/lib/compiler/compile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../../src/workflow/lib/compiler/compile.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,WAAW,EAGjB,MAAM,mCAAmC,CAAC;AAyC3C,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,SAAS,CAAC;AAmBjB,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW,CAyRhE"}
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../../src/workflow/lib/compiler/compile.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,WAAW,EAGjB,MAAM,mCAAmC,CAAC;AAyC3C,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,SAAS,CAAC;AAmBjB,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW,CA4ThE"}

package/dist/workflow/lib/compiler/compile.js

@@ -19,7 +19,7 @@ const payload_reach_in_1 = require("./payload-reach-in");
 const installation_resource_validator_1 = require("./installation-resource-validator");
 const variable_requirements_1 = require("./variable-requirements");
 function compileWorkflow(input) {
-    const { workflowRef, trigger, resolvedRefs, workflowDefinitionVersionSha256 } = input;
+    const { workflowRef, trigger, resolvedRefs, workflowDefinitionContentHash } = input;
     const workflow = (0, gate_defaults_1.applyGateDefaults)(input.workflow, resolvedRefs);
     const inputs = (0, inputs_1.bindTriggerInputs)(workflow, trigger, input.previewMode ?? false);
     const vars = workflow.vars ?? {};
@@ -49,6 +49,13 @@ function compileWorkflow(input) {
             : authoredNeeds;
         return { key, payload: decl, needs: merged };
     }));
+    const manifestSourcesByJob = {};
+    for (const [jobKey, job] of Object.entries(workflow.jobs)) {
+        const resolved = lookupResolvedRef(job.uses, resolvedRefs);
+        manifestSourcesByJob[jobKey] = resolved.isReusableWorkflow
+            ? null
+            : (0, manifest_source_1.compileManifestSource)(jobKey, job.with, resolved.actionManifest, input.resolvedAgents ?? {});
+    }
     const compiledJobs = orderedJobs.map(({ key, payload, needs }) => {
         const resolved = lookupResolvedRef(payload.uses, resolvedRefs);
         const actionRef = {
@@ -61,7 +68,7 @@ function compileWorkflow(input) {
             isReusableWorkflow: resolved.isReusableWorkflow,
             inputsSchema: resolved.isReusableWorkflow
                 ? null
-                : resolved.actionManifest?.spec.inputs ?? null,
+                : (resolved.actionManifest?.spec.inputs ?? null),
         };
         const jobPermissions = (0, permissions_1.normalizePermissions)(payload.permissions);
         (0, permissions_1.assertJobPermissionsFit)(jobPermissions, permissions, key);
@@ -69,9 +76,7 @@ function compileWorkflow(input) {
         const mountPlan = resolved.isReusableWorkflow
             ? { readOnly: {}, readWrite: {} }
             : (0, mount_plan_1.compileMountPlan)(key, payload.with, resolved.actionManifest);
-        const manifestSource = resolved.isReusableWorkflow
-            ? null
-            : (0, manifest_source_1.compileManifestSource)(key, payload.with, resolved.actionManifest);
+        const manifestSource = manifestSourcesByJob[key] ?? null;
         const retry = (0, retry_timeout_1.resolveJobRetry)(defaults.retry, resolved.actionManifest?.spec.retryDefaults ?? null, payload.retry);
         const timeoutMs = (0, retry_timeout_1.resolveJobTimeout)(defaults.timeoutMs, resolved.actionManifest?.spec.timeoutDefaults ?? null, payload.timeout);
         const ifExpression = payload.if !== undefined
@@ -82,7 +87,7 @@ function compileWorkflow(input) {
                 return rewritten;
             })()
             : null;
-        const compiledWith = (0, review_step_1.rewriteReviewStepWith)(key, payload, workflow);
+        const compiledWith = attachResolvedReviewerPins((0, review_step_1.rewriteReviewStepWith)(key, payload, workflow, manifestSourcesByJob), input.resolvedAgents ?? {});
         (0, installation_resource_validator_1.validateInstallationResourceBindings)({
             jobKey: key,
             actionId: actionRef.id,
@@ -94,7 +99,9 @@ function compileWorkflow(input) {
             jobKey: key,
             title: payload.title ?? null,
             needs,
-            matrixGather: Object.freeze([...(payload.matrixGather ?? [])]),
+            matrixGather: Object.freeze([
+                ...(payload.matrixGather ?? []),
+            ]),
             ifExpression,
             strategy,
             action: actionRef,
@@ -125,7 +132,7 @@ function compileWorkflow(input) {
         defaults,
         jobs: Object.freeze(compiledJobs),
         snapshotCreatedAt,
-        workflowDefinitionVersionSha256,
+        workflowDefinitionContentHash,
         workflowCallOutputs,
         workflowOutputs,
         ...(input.briefcase !== undefined && { briefcase: input.briefcase }),
@@ -245,6 +252,18 @@ function validateJobLiteralReferences(jobKey, job, resolvedAgents, resolvedSpecs
         if (resolvedAgents) {
             assertLiteralAgent(jobKey, 'with.agentRef', withMap['agentRef'], resolvedAgents);
             validateReviewerAgents(jobKey, withMap['reviewers'], resolvedAgents);
+            validateReviewerAgents(jobKey, withMap['recipients'], resolvedAgents);
+            const escalationChain = withMap['escalationChain'];
+            if (Array.isArray(escalationChain)) {
+                for (let i = 0; i < escalationChain.length; i++) {
+                    const step = escalationChain[i];
+                    if (step !== null &&
+                        typeof step === 'object' &&
+                        !Array.isArray(step)) {
+                        validateReviewerAgents(jobKey, step['recipients'], resolvedAgents);
+                    }
+                }
+            }
         }
         if (resolvedSpecs) {
             assertLiteralDeliverableSpec(jobKey, 'with.deliverableSpecRef', withMap['deliverableSpecRef'], resolvedSpecs);
@@ -263,8 +282,66 @@ function validateReviewerAgents(jobKey, reviewers, resolvedAgents) {
             Array.isArray(reviewer)) {
             continue;
         }
-        assertLiteralAgent(jobKey, `with.reviewers[${i}].agentRef`, reviewer['agentRef'], resolvedAgents);
+        assertLiteralAgent(jobKey, `with.reviewers[${i}].agentRef`, reviewer['target']?.['agentRef'] ?? reviewer['agentRef'], resolvedAgents);
+    }
+}
+function attachResolvedReviewerPins(withBlock, resolvedAgents) {
+    const pinRecipients = (value) => {
+        if (!Array.isArray(value))
+            return value;
+        return value.map((recipient) => {
+            if (recipient === null ||
+                typeof recipient !== 'object' ||
+                Array.isArray(recipient)) {
+                return recipient;
+            }
+            const record = recipient;
+            if (record['kind'] !== 'agent')
+                return recipient;
+            const target = record['target'];
+            if (target === null ||
+                typeof target !== 'object' ||
+                Array.isArray(target)) {
+                return recipient;
+            }
+            const targetRecord = target;
+            const agentRef = targetRecord['agentRef'];
+            if (!isLiteralStringValue(agentRef))
+                return recipient;
+            const resolved = resolvedAgents[agentRef];
+            if (resolved === undefined)
+                return recipient;
+            return Object.freeze({
+                ...record,
+                target: Object.freeze({
+                    ...targetRecord,
+                    agentRevisionPin: Object.freeze({
+                        agentRevisionId: resolved.agentRevisionId,
+                        agentContentHash: resolved.agentContentHash,
+                        agentSlug: resolved.slug,
+                    }),
+                }),
+            });
+        });
+    };
+    const out = { ...withBlock };
+    if ('reviewers' in out)
+        out['reviewers'] = pinRecipients(out['reviewers']);
+    if ('recipients' in out)
+        out['recipients'] = pinRecipients(out['recipients']);
+    if (Array.isArray(out['escalationChain'])) {
+        out['escalationChain'] = out['escalationChain'].map((step) => {
+            if (step === null || typeof step !== 'object' || Array.isArray(step)) {
+                return step;
+            }
+            const record = step;
+            return Object.freeze({
+                ...record,
+                recipients: pinRecipients(record['recipients']),
+            });
+        });
     }
+    return Object.freeze(out);
 }
 function isLiteralStringValue(value) {
     return typeof value === 'string' && !value.includes('${{');
@@ -273,16 +350,16 @@ function assertLiteralAgent(jobKey, fieldPath, value, resolvedAgents) {
     if (!isLiteralStringValue(value)) {
         return;
     }
-    const slug = agentRefSlug(value);
-    if (resolvedAgents[slug] !== undefined) {
+    if (resolvedAgents[value] !== undefined) {
         return;
     }
     const knownPreview = formatKnownPreview(Object.keys(resolvedAgents));
-    throw new errors_1.WorkflowDslError(workflow_1.WorkflowErrorCode.DSL_UNKNOWN_AGENT, `Job '${jobKey}' ${fieldPath} = '${value}' is not a registered agent. Known: [${knownPreview}].`, { jobKey, fieldPath, value, knownCount: Object.keys(resolvedAgents).length });
-}
-function agentRefSlug(ref) {
-    const at = ref.indexOf('@');
-    return at === -1 ? ref : ref.slice(0, at);
+    throw new errors_1.WorkflowDslError(workflow_1.WorkflowErrorCode.DSL_UNKNOWN_AGENT, `Job '${jobKey}' ${fieldPath} = '${value}' is not a registered agent. Known: [${knownPreview}].`, {
+        jobKey,
+        fieldPath,
+        value,
+        knownCount: Object.keys(resolvedAgents).length,
+    });
 }
 function assertLiteralDeliverableSpec(jobKey, fieldPath, value, resolvedSpecs) {
     if (!isLiteralStringValue(value)) {
@@ -371,7 +448,11 @@ function compileWorkflowOutputs(workflow) {
             throw new errors_1.WorkflowDslError(workflow_1.WorkflowErrorCode.DSL_SEMANTIC_INVALID, `outputs.${name}: fromJob "${decl.fromJob}" is not a declared job`, { outputName: name, fromJob: decl.fromJob });
         }
         if (!job.outputs || !(decl.fromOutput in job.outputs)) {
-            throw new errors_1.WorkflowDslError(workflow_1.WorkflowErrorCode.DSL_SEMANTIC_INVALID, `outputs.${name}: job "${decl.fromJob}" does not declare an output named "${decl.fromOutput}"`, { outputName: name, fromJob: decl.fromJob, fromOutput: decl.fromOutput });
+            throw new errors_1.WorkflowDslError(workflow_1.WorkflowErrorCode.DSL_SEMANTIC_INVALID, `outputs.${name}: job "${decl.fromJob}" does not declare an output named "${decl.fromOutput}"`, {
+                outputName: name,
+                fromJob: decl.fromJob,
+                fromOutput: decl.fromOutput,
+            });
         }
         if (seenSlugs.has(decl.slug)) {
             throw new errors_1.WorkflowDslError(workflow_1.WorkflowErrorCode.DSL_SEMANTIC_INVALID, `outputs.${name}: slug "${decl.slug}" is already used by another output`, { outputName: name, slug: decl.slug });
@@ -422,7 +503,9 @@ function validateMatrixGather(doc) {
             if (!targetDecl) {
                 throw new errors_1.WorkflowDslError(workflow_1.WorkflowErrorCode.DSL_SEMANTIC_INVALID, `Job '${jobKey}' matrixGather references unknown job '${target}'.`, { jobKey, target });
             }
-            if (!targetDecl.strategy || (!('matrix' in targetDecl.strategy) && !('dynamic' in targetDecl.strategy))) {
+            if (!targetDecl.strategy ||
+                (!('matrix' in targetDecl.strategy) &&
+                    !('dynamic' in targetDecl.strategy))) {
                 throw new errors_1.WorkflowDslError(workflow_1.WorkflowErrorCode.DSL_SEMANTIC_INVALID, `Job '${jobKey}' matrixGather references '${target}' which has no matrix/dynamic strategy; gathering only makes sense across matrix entries.`, { jobKey, target });
             }
         }
@@ -576,7 +659,8 @@ function validateNeedsAccess(doc, consumerJobKey, fieldPath, consumerBinding, ac
         return;
     }
     const keyBy = isDynamicMatrix
-        ? upstream.strategy.dynamic.keyBy ?? null
+        ? (upstream.strategy.dynamic.keyBy ??
+            null)
         : null;
     if (access.steps.length === 0)
         return;
@@ -666,7 +750,8 @@ function collectMatrixMemberPath(node) {
 }
 function assertStrategyInvariants(compiled) {
     for (const job of compiled.jobs) {
-        if (job.strategy.kind === workflow_1.MatrixStrategyKind.STATIC && job.strategy.entries.length === 0) {
+        if (job.strategy.kind === workflow_1.MatrixStrategyKind.STATIC &&
+            job.strategy.entries.length === 0) {
             throw new errors_1.WorkflowDslError(workflow_1.WorkflowErrorCode.DSL_SEMANTIC_INVALID, `Job '${job.jobKey}' static strategy expansion produced zero entries.`, { jobKey: job.jobKey });
         }
     }