@shipfox/workflow-document 2.0.1 → 2.1.1

package/dist/document/index.d.ts

@@ -1,4 +1,5 @@
 export { type AgentThinking, agentThinkingByHarness, agentThinkingSchema, claudeAgentThinkingSchema, DEFAULT_AGENT_THINKING, DEFAULT_HARNESS, DEFAULT_MODEL_PROVIDER, type Harness, harnessSchema, piAgentThinkingSchema, thinkingLevelsForHarness, } from './step-enums.js';
 export { triggerSourceConfigSchemas, WORKFLOW_DOCUMENT_ENV_MAX_ENTRIES, WORKFLOW_DOCUMENT_ENV_MAX_SERIALIZED_BYTES, WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_DEPTH, WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_SERIALIZED_BYTES, WORKFLOW_DOCUMENT_STEP_OUTPUTS_MAX_ENTRIES, type WorkflowDocument, type WorkflowDocumentEnv, type WorkflowDocumentJob, type WorkflowDocumentJobCheckout, type WorkflowDocumentRunStepGate, type WorkflowDocumentStep, type WorkflowDocumentStepIntegration, type WorkflowDocumentStepOutputs, type WorkflowDocumentStepOutputType, type WorkflowDocumentTrigger, workflowDocumentCheckoutSchema, workflowDocumentEnvSchema, workflowDocumentJobSchema, workflowDocumentSchema, workflowDocumentStepIntegrationSchema, workflowDocumentStepIntegrationSelectionSchema, workflowDocumentStepOutputsSchema, workflowDocumentStepOutputTypes, workflowDocumentStepSchema, workflowDocumentTriggerSchema, } from './workflow-document.js';
 export { InvalidWorkflowDocumentError, invalidWorkflowDocumentErrorCode, parseWorkflowDocument, } from './workflow-document-parser.js';
+export { type BuildWorkflowJsonSchemaOptions, buildWorkflowJsonSchema, } from './workflow-json-schema.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/document/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,eAAe,EACf,sBAAsB,EACtB,KAAK,OAAO,EACZ,aAAa,EACb,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,0BAA0B,EAC1B,iCAAiC,EACjC,0CAA0C,EAC1C,8CAA8C,EAC9C,yDAAyD,EACzD,0CAA0C,EAC1C,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,oBAAoB,EACzB,KAAK,+BAA+B,EACpC,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,EACnC,KAAK,uBAAuB,EAC5B,8BAA8B,EAC9B,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,qCAAqC,EACrC,8CAA8C,EAC9C,iCAAiC,EACjC,+BAA+B,EAC/B,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,EAChC,qBAAqB,GACtB,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/document/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,eAAe,EACf,sBAAsB,EACtB,KAAK,OAAO,EACZ,aAAa,EACb,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,0BAA0B,EAC1B,iCAAiC,EACjC,0CAA0C,EAC1C,8CAA8C,EAC9C,yDAAyD,EACzD,0CAA0C,EAC1C,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,oBAAoB,EACzB,KAAK,+BAA+B,EACpC,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,EACnC,KAAK,uBAAuB,EAC5B,8BAA8B,EAC9B,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,qCAAqC,EACrC,8CAA8C,EAC9C,iCAAiC,EACjC,+BAA+B,EAC/B,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,EAChC,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,KAAK,8BAA8B,EACnC,uBAAuB,GACxB,MAAM,2BAA2B,CAAC"}

package/dist/document/index.js

@@ -1,5 +1,6 @@
 export { agentThinkingByHarness, agentThinkingSchema, claudeAgentThinkingSchema, DEFAULT_AGENT_THINKING, DEFAULT_HARNESS, DEFAULT_MODEL_PROVIDER, harnessSchema, piAgentThinkingSchema, thinkingLevelsForHarness } from './step-enums.js';
 export { triggerSourceConfigSchemas, WORKFLOW_DOCUMENT_ENV_MAX_ENTRIES, WORKFLOW_DOCUMENT_ENV_MAX_SERIALIZED_BYTES, WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_DEPTH, WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_SERIALIZED_BYTES, WORKFLOW_DOCUMENT_STEP_OUTPUTS_MAX_ENTRIES, workflowDocumentCheckoutSchema, workflowDocumentEnvSchema, workflowDocumentJobSchema, workflowDocumentSchema, workflowDocumentStepIntegrationSchema, workflowDocumentStepIntegrationSelectionSchema, workflowDocumentStepOutputsSchema, workflowDocumentStepOutputTypes, workflowDocumentStepSchema, workflowDocumentTriggerSchema } from './workflow-document.js';
 export { InvalidWorkflowDocumentError, invalidWorkflowDocumentErrorCode, parseWorkflowDocument } from './workflow-document-parser.js';
+export { buildWorkflowJsonSchema } from './workflow-json-schema.js';
 
 //# sourceMappingURL=index.js.map

package/dist/document/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/document/index.ts"],"sourcesContent":["export {\n  type AgentThinking,\n  agentThinkingByHarness,\n  agentThinkingSchema,\n  claudeAgentThinkingSchema,\n  DEFAULT_AGENT_THINKING,\n  DEFAULT_HARNESS,\n  DEFAULT_MODEL_PROVIDER,\n  type Harness,\n  harnessSchema,\n  piAgentThinkingSchema,\n  thinkingLevelsForHarness,\n} from './step-enums.js';\nexport {\n  triggerSourceConfigSchemas,\n  WORKFLOW_DOCUMENT_ENV_MAX_ENTRIES,\n  WORKFLOW_DOCUMENT_ENV_MAX_SERIALIZED_BYTES,\n  WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_DEPTH,\n  WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_SERIALIZED_BYTES,\n  WORKFLOW_DOCUMENT_STEP_OUTPUTS_MAX_ENTRIES,\n  type WorkflowDocument,\n  type WorkflowDocumentEnv,\n  type WorkflowDocumentJob,\n  type WorkflowDocumentJobCheckout,\n  type WorkflowDocumentRunStepGate,\n  type WorkflowDocumentStep,\n  type WorkflowDocumentStepIntegration,\n  type WorkflowDocumentStepOutputs,\n  type WorkflowDocumentStepOutputType,\n  type WorkflowDocumentTrigger,\n  workflowDocumentCheckoutSchema,\n  workflowDocumentEnvSchema,\n  workflowDocumentJobSchema,\n  workflowDocumentSchema,\n  workflowDocumentStepIntegrationSchema,\n  workflowDocumentStepIntegrationSelectionSchema,\n  workflowDocumentStepOutputsSchema,\n  workflowDocumentStepOutputTypes,\n  workflowDocumentStepSchema,\n  workflowDocumentTriggerSchema,\n} from './workflow-document.js';\nexport {\n  InvalidWorkflowDocumentError,\n  invalidWorkflowDocumentErrorCode,\n  parseWorkflowDocument,\n} from './workflow-document-parser.js';\n"],"names":["agentThinkingByHarness","agentThinkingSchema","claudeAgentThinkingSchema","DEFAULT_AGENT_THINKING","DEFAULT_HARNESS","DEFAULT_MODEL_PROVIDER","harnessSchema","piAgentThinkingSchema","thinkingLevelsForHarness","triggerSourceConfigSchemas","WORKFLOW_DOCUMENT_ENV_MAX_ENTRIES","WORKFLOW_DOCUMENT_ENV_MAX_SERIALIZED_BYTES","WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_DEPTH","WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_SERIALIZED_BYTES","WORKFLOW_DOCUMENT_STEP_OUTPUTS_MAX_ENTRIES","workflowDocumentCheckoutSchema","workflowDocumentEnvSchema","workflowDocumentJobSchema","workflowDocumentSchema","workflowDocumentStepIntegrationSchema","workflowDocumentStepIntegrationSelectionSchema","workflowDocumentStepOutputsSchema","workflowDocumentStepOutputTypes","workflowDocumentStepSchema","workflowDocumentTriggerSchema","InvalidWorkflowDocumentError","invalidWorkflowDocumentErrorCode","parseWorkflowDocument"],"mappings":"AAAA,SAEEA,sBAAsB,EACtBC,mBAAmB,EACnBC,yBAAyB,EACzBC,sBAAsB,EACtBC,eAAe,EACfC,sBAAsB,EAEtBC,aAAa,EACbC,qBAAqB,EACrBC,wBAAwB,QACnB,kBAAkB;AACzB,SACEC,0BAA0B,EAC1BC,iCAAiC,EACjCC,0CAA0C,EAC1CC,8CAA8C,EAC9CC,yDAAyD,EACzDC,0CAA0C,EAW1CC,8BAA8B,EAC9BC,yBAAyB,EACzBC,yBAAyB,EACzBC,sBAAsB,EACtBC,qCAAqC,EACrCC,8CAA8C,EAC9CC,iCAAiC,EACjCC,+BAA+B,EAC/BC,0BAA0B,EAC1BC,6BAA6B,QACxB,yBAAyB;AAChC,SACEC,4BAA4B,EAC5BC,gCAAgC,EAChCC,qBAAqB,QAChB,gCAAgC"}
+{"version":3,"sources":["../../src/document/index.ts"],"sourcesContent":["export {\n  type AgentThinking,\n  agentThinkingByHarness,\n  agentThinkingSchema,\n  claudeAgentThinkingSchema,\n  DEFAULT_AGENT_THINKING,\n  DEFAULT_HARNESS,\n  DEFAULT_MODEL_PROVIDER,\n  type Harness,\n  harnessSchema,\n  piAgentThinkingSchema,\n  thinkingLevelsForHarness,\n} from './step-enums.js';\nexport {\n  triggerSourceConfigSchemas,\n  WORKFLOW_DOCUMENT_ENV_MAX_ENTRIES,\n  WORKFLOW_DOCUMENT_ENV_MAX_SERIALIZED_BYTES,\n  WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_DEPTH,\n  WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_SERIALIZED_BYTES,\n  WORKFLOW_DOCUMENT_STEP_OUTPUTS_MAX_ENTRIES,\n  type WorkflowDocument,\n  type WorkflowDocumentEnv,\n  type WorkflowDocumentJob,\n  type WorkflowDocumentJobCheckout,\n  type WorkflowDocumentRunStepGate,\n  type WorkflowDocumentStep,\n  type WorkflowDocumentStepIntegration,\n  type WorkflowDocumentStepOutputs,\n  type WorkflowDocumentStepOutputType,\n  type WorkflowDocumentTrigger,\n  workflowDocumentCheckoutSchema,\n  workflowDocumentEnvSchema,\n  workflowDocumentJobSchema,\n  workflowDocumentSchema,\n  workflowDocumentStepIntegrationSchema,\n  workflowDocumentStepIntegrationSelectionSchema,\n  workflowDocumentStepOutputsSchema,\n  workflowDocumentStepOutputTypes,\n  workflowDocumentStepSchema,\n  workflowDocumentTriggerSchema,\n} from './workflow-document.js';\nexport {\n  InvalidWorkflowDocumentError,\n  invalidWorkflowDocumentErrorCode,\n  parseWorkflowDocument,\n} from './workflow-document-parser.js';\nexport {\n  type BuildWorkflowJsonSchemaOptions,\n  buildWorkflowJsonSchema,\n} from './workflow-json-schema.js';\n"],"names":["agentThinkingByHarness","agentThinkingSchema","claudeAgentThinkingSchema","DEFAULT_AGENT_THINKING","DEFAULT_HARNESS","DEFAULT_MODEL_PROVIDER","harnessSchema","piAgentThinkingSchema","thinkingLevelsForHarness","triggerSourceConfigSchemas","WORKFLOW_DOCUMENT_ENV_MAX_ENTRIES","WORKFLOW_DOCUMENT_ENV_MAX_SERIALIZED_BYTES","WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_DEPTH","WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_SERIALIZED_BYTES","WORKFLOW_DOCUMENT_STEP_OUTPUTS_MAX_ENTRIES","workflowDocumentCheckoutSchema","workflowDocumentEnvSchema","workflowDocumentJobSchema","workflowDocumentSchema","workflowDocumentStepIntegrationSchema","workflowDocumentStepIntegrationSelectionSchema","workflowDocumentStepOutputsSchema","workflowDocumentStepOutputTypes","workflowDocumentStepSchema","workflowDocumentTriggerSchema","InvalidWorkflowDocumentError","invalidWorkflowDocumentErrorCode","parseWorkflowDocument","buildWorkflowJsonSchema"],"mappings":"AAAA,SAEEA,sBAAsB,EACtBC,mBAAmB,EACnBC,yBAAyB,EACzBC,sBAAsB,EACtBC,eAAe,EACfC,sBAAsB,EAEtBC,aAAa,EACbC,qBAAqB,EACrBC,wBAAwB,QACnB,kBAAkB;AACzB,SACEC,0BAA0B,EAC1BC,iCAAiC,EACjCC,0CAA0C,EAC1CC,8CAA8C,EAC9CC,yDAAyD,EACzDC,0CAA0C,EAW1CC,8BAA8B,EAC9BC,yBAAyB,EACzBC,yBAAyB,EACzBC,sBAAsB,EACtBC,qCAAqC,EACrCC,8CAA8C,EAC9CC,iCAAiC,EACjCC,+BAA+B,EAC/BC,0BAA0B,EAC1BC,6BAA6B,QACxB,yBAAyB;AAChC,SACEC,4BAA4B,EAC5BC,gCAAgC,EAChCC,qBAAqB,QAChB,gCAAgC;AACvC,SAEEC,uBAAuB,QAClB,4BAA4B"}

package/dist/document/step-enums.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"step-enums.d.ts","sourceRoot":"","sources":["../../src/document/step-enums.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,eAAO,MAAM,aAAa;;;EAA2B,CAAC;AACtD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,eAAO,MAAM,eAAe,MAAkC,CAAC;AAE/D,eAAO,MAAM,qBAAqB;;;;;;;EAA+D,CAAC;AAClG,eAAO,MAAM,yBAAyB;;;;;;EAAoD,CAAC;AAC3F,eAAO,MAAM,mBAAmB;;;;;;;;EAQ9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,sBAAsB,SAA2C,CAAC;AAE/E,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;CAMlC,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,aAAa,EAAE,CAEnF;AAGD,eAAO,MAAM,sBAAsB,EAAG,WAAoB,CAAC"}
+{"version":3,"file":"step-enums.d.ts","sourceRoot":"","sources":["../../src/document/step-enums.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,eAAO,MAAM,aAAa;;;EAGxB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,eAAO,MAAM,eAAe,MAAkC,CAAC;AAE/D,eAAO,MAAM,qBAAqB;;;;;;;EAA+D,CAAC;AAClG,eAAO,MAAM,yBAAyB;;;;;;EAAoD,CAAC;AAC3F,eAAO,MAAM,mBAAmB;;;;;;;;EAK5B,CAAC;AAEL,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,sBAAsB,SAA2C,CAAC;AAE/E,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;CAMlC,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,aAAa,EAAE,CAEnF;AAGD,eAAO,MAAM,sBAAsB,EAAG,WAAoB,CAAC"}

package/dist/document/step-enums.js

@@ -2,7 +2,9 @@ import { z } from 'zod';
 export const harnessSchema = z.enum([
     'pi',
     'claude'
-]);
+]).meta({
+    description: 'Agent harness. When omitted, Shipfox uses the workspace default harness, or `pi` when none is configured.'
+});
 export const DEFAULT_HARNESS = 'pi';
 export const piAgentThinkingSchema = z.enum([
     'off',
@@ -27,7 +29,9 @@ export const agentThinkingSchema = z.enum([
     'high',
     'xhigh',
     'max'
-]);
+]).meta({
+    description: 'Reasoning effort for an agent step. Supported values depend on the resolved harness. When omitted, Shipfox uses the provider default, or `xhigh` when none is configured.'
+});
 export const DEFAULT_AGENT_THINKING = 'xhigh';
 export const agentThinkingByHarness = {
     pi: piAgentThinkingSchema,

package/dist/document/step-enums.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/document/step-enums.ts"],"sourcesContent":["import {z} from 'zod';\n\nexport const harnessSchema = z.enum(['pi', 'claude']);\nexport type Harness = z.infer<typeof harnessSchema>;\nexport const DEFAULT_HARNESS = 'pi' as const satisfies Harness;\n\nexport const piAgentThinkingSchema = z.enum(['off', 'minimal', 'low', 'medium', 'high', 'xhigh']);\nexport const claudeAgentThinkingSchema = z.enum(['low', 'medium', 'high', 'xhigh', 'max']);\nexport const agentThinkingSchema = z.enum([\n  'off',\n  'minimal',\n  'low',\n  'medium',\n  'high',\n  'xhigh',\n  'max',\n]);\n\nexport type AgentThinking = z.infer<typeof agentThinkingSchema>;\n\nexport const DEFAULT_AGENT_THINKING = 'xhigh' as const satisfies AgentThinking;\n\nexport const agentThinkingByHarness = {\n  pi: piAgentThinkingSchema,\n  claude: claudeAgentThinkingSchema,\n} as const satisfies Record<\n  Harness,\n  typeof piAgentThinkingSchema | typeof claudeAgentThinkingSchema\n>;\n\nexport function thinkingLevelsForHarness(harness: Harness): readonly AgentThinking[] {\n  return agentThinkingByHarness[harness].options;\n}\n\n// Used by later resolution layers when no workspace or instance provider is configured.\nexport const DEFAULT_MODEL_PROVIDER = 'anthropic' as const;\n"],"names":["z","harnessSchema","enum","DEFAULT_HARNESS","piAgentThinkingSchema","claudeAgentThinkingSchema","agentThinkingSchema","DEFAULT_AGENT_THINKING","agentThinkingByHarness","pi","claude","thinkingLevelsForHarness","harness","options","DEFAULT_MODEL_PROVIDER"],"mappings":"AAAA,SAAQA,CAAC,QAAO,MAAM;AAEtB,OAAO,MAAMC,gBAAgBD,EAAEE,IAAI,CAAC;IAAC;IAAM;CAAS,EAAE;AAEtD,OAAO,MAAMC,kBAAkB,KAAgC;AAE/D,OAAO,MAAMC,wBAAwBJ,EAAEE,IAAI,CAAC;IAAC;IAAO;IAAW;IAAO;IAAU;IAAQ;CAAQ,EAAE;AAClG,OAAO,MAAMG,4BAA4BL,EAAEE,IAAI,CAAC;IAAC;IAAO;IAAU;IAAQ;IAAS;CAAM,EAAE;AAC3F,OAAO,MAAMI,sBAAsBN,EAAEE,IAAI,CAAC;IACxC;IACA;IACA;IACA;IACA;IACA;IACA;CACD,EAAE;AAIH,OAAO,MAAMK,yBAAyB,QAAyC;AAE/E,OAAO,MAAMC,yBAAyB;IACpCC,IAAIL;IACJM,QAAQL;AACV,EAGE;AAEF,OAAO,SAASM,yBAAyBC,OAAgB;IACvD,OAAOJ,sBAAsB,CAACI,QAAQ,CAACC,OAAO;AAChD;AAEA,wFAAwF;AACxF,OAAO,MAAMC,yBAAyB,YAAqB"}
+{"version":3,"sources":["../../src/document/step-enums.ts"],"sourcesContent":["import {z} from 'zod';\n\nexport const harnessSchema = z.enum(['pi', 'claude']).meta({\n  description:\n    'Agent harness. When omitted, Shipfox uses the workspace default harness, or `pi` when none is configured.',\n});\nexport type Harness = z.infer<typeof harnessSchema>;\nexport const DEFAULT_HARNESS = 'pi' as const satisfies Harness;\n\nexport const piAgentThinkingSchema = z.enum(['off', 'minimal', 'low', 'medium', 'high', 'xhigh']);\nexport const claudeAgentThinkingSchema = z.enum(['low', 'medium', 'high', 'xhigh', 'max']);\nexport const agentThinkingSchema = z\n  .enum(['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max'])\n  .meta({\n    description:\n      'Reasoning effort for an agent step. Supported values depend on the resolved harness. When omitted, Shipfox uses the provider default, or `xhigh` when none is configured.',\n  });\n\nexport type AgentThinking = z.infer<typeof agentThinkingSchema>;\n\nexport const DEFAULT_AGENT_THINKING = 'xhigh' as const satisfies AgentThinking;\n\nexport const agentThinkingByHarness = {\n  pi: piAgentThinkingSchema,\n  claude: claudeAgentThinkingSchema,\n} as const satisfies Record<\n  Harness,\n  typeof piAgentThinkingSchema | typeof claudeAgentThinkingSchema\n>;\n\nexport function thinkingLevelsForHarness(harness: Harness): readonly AgentThinking[] {\n  return agentThinkingByHarness[harness].options;\n}\n\n// Used by later resolution layers when no workspace or instance provider is configured.\nexport const DEFAULT_MODEL_PROVIDER = 'anthropic' as const;\n"],"names":["z","harnessSchema","enum","meta","description","DEFAULT_HARNESS","piAgentThinkingSchema","claudeAgentThinkingSchema","agentThinkingSchema","DEFAULT_AGENT_THINKING","agentThinkingByHarness","pi","claude","thinkingLevelsForHarness","harness","options","DEFAULT_MODEL_PROVIDER"],"mappings":"AAAA,SAAQA,CAAC,QAAO,MAAM;AAEtB,OAAO,MAAMC,gBAAgBD,EAAEE,IAAI,CAAC;IAAC;IAAM;CAAS,EAAEC,IAAI,CAAC;IACzDC,aACE;AACJ,GAAG;AAEH,OAAO,MAAMC,kBAAkB,KAAgC;AAE/D,OAAO,MAAMC,wBAAwBN,EAAEE,IAAI,CAAC;IAAC;IAAO;IAAW;IAAO;IAAU;IAAQ;CAAQ,EAAE;AAClG,OAAO,MAAMK,4BAA4BP,EAAEE,IAAI,CAAC;IAAC;IAAO;IAAU;IAAQ;IAAS;CAAM,EAAE;AAC3F,OAAO,MAAMM,sBAAsBR,EAChCE,IAAI,CAAC;IAAC;IAAO;IAAW;IAAO;IAAU;IAAQ;IAAS;CAAM,EAChEC,IAAI,CAAC;IACJC,aACE;AACJ,GAAG;AAIL,OAAO,MAAMK,yBAAyB,QAAyC;AAE/E,OAAO,MAAMC,yBAAyB;IACpCC,IAAIL;IACJM,QAAQL;AACV,EAGE;AAEF,OAAO,SAASM,yBAAyBC,OAAgB;IACvD,OAAOJ,sBAAsB,CAACI,QAAQ,CAACC,OAAO;AAChD;AAEA,wFAAwF;AACxF,OAAO,MAAMC,yBAAyB,YAAqB"}

package/dist/document/workflow-document.d.ts

@@ -85,6 +85,7 @@ export declare const workflowDocumentStepIntegrationSchema: z.ZodObject<{
     exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
     allow_write: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
+export declare const workflowDocumentAgentStepFields: readonly ["model", "prompt", "harness", "thinking", "provider", "tools", "integrations"];
 export declare const workflowDocumentStepSchema: z.ZodObject<{
     key: z.ZodOptional<z.ZodString>;
     if: z.ZodOptional<z.ZodString>;

package/dist/document/workflow-document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-document.d.ts","sourceRoot":"","sources":["../../src/document/workflow-document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAetB,eAAO,MAAM,iCAAiC,MAAM,CAAC;AACrD,eAAO,MAAM,0CAA0C,QAAY,CAAC;AACpE,eAAO,MAAM,+BAA+B,kDAAmD,CAAC;AAChG,eAAO,MAAM,0CAA0C,MAAoC,CAAC;AAC5F,eAAO,MAAM,yDAAyD,QAC1B,CAAC;AAC7C,eAAO,MAAM,8CAA8C,KAAK,CAAC;AAIjE,eAAO,MAAM,yBAAyB,yFAkBlC,CAAC;AAuDL,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;qBAmB1C,CAAC;AASL,eAAO,MAAM,0BAA0B;;;;;CAKF,CAAC;AAItC,eAAO,MAAM,6BAA6B;;;;;;kBA2BtC,CAAC;AAEL,QAAA,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;kBAkCjC,CAAC;AAEL,QAAA,MAAM,8BAA8B;;;;;;kBAYhC,CAAC;AAEL,eAAO,MAAM,8BAA8B;;;;;;;;kBAOzC,CAAC;AAEH,eAAO,MAAM,8CAA8C,yBAAoC,CAAC;AAEhG,eAAO,MAAM,qCAAqC;;;;;kBAKhD,CAAC;AAQH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAgFnC,CAAC;AAEL,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAYpC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAMjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACzF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAC3F,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACzF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AACpG,MAAM,MAAM,8BAA8B,GAAG,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;AAC9F,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAC5F,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC"}
+{"version":3,"file":"workflow-document.d.ts","sourceRoot":"","sources":["../../src/document/workflow-document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAetB,eAAO,MAAM,iCAAiC,MAAM,CAAC;AACrD,eAAO,MAAM,0CAA0C,QAAY,CAAC;AACpE,eAAO,MAAM,+BAA+B,kDAAmD,CAAC;AAChG,eAAO,MAAM,0CAA0C,MAAoC,CAAC;AAC5F,eAAO,MAAM,yDAAyD,QAC1B,CAAC;AAC7C,eAAO,MAAM,8CAA8C,KAAK,CAAC;AAIjE,eAAO,MAAM,yBAAyB,yFAqBlC,CAAC;AAmEL,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;qBAsB1C,CAAC;AAqBL,eAAO,MAAM,0BAA0B;;;;;CASF,CAAC;AAItC,eAAO,MAAM,6BAA6B;;;;;;kBA6BtC,CAAC;AAEL,QAAA,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;kBAyDjC,CAAC;AAEL,QAAA,MAAM,8BAA8B;;;;;;kBAwBhC,CAAC;AAEL,eAAO,MAAM,8BAA8B;;;;;;;;kBAczC,CAAC;AAEH,eAAO,MAAM,8CAA8C,yBAAoC,CAAC;AAEhG,eAAO,MAAM,qCAAqC;;;;;kBAahD,CAAC;AAEH,eAAO,MAAM,+BAA+B,0FAQlC,CAAC;AAQX,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA2GnC,CAAC;AAEL,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0CpC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAiBjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACzF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAC3F,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACzF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AACpG,MAAM,MAAM,8BAA8B,GAAG,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;AAC9F,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAC5F,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC"}

package/dist/document/workflow-document.js

@@ -44,16 +44,22 @@ export const workflowDocumentEnvSchema = z.record(envNameSchema, z.union([
             message: `Env cannot serialize to more than ${WORKFLOW_DOCUMENT_ENV_MAX_SERIALIZED_BYTES} bytes.`
         });
     }
+}).meta({
+    description: `Environment variables as string, number, or boolean values. Each map allows up to ${WORKFLOW_DOCUMENT_ENV_MAX_ENTRIES} entries and ${WORKFLOW_DOCUMENT_ENV_MAX_SERIALIZED_BYTES} serialized bytes.`
 });
 const workflowDocumentStepOutputKeyPattern = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
-const workflowDocumentStepOutputTypeSchema = z.enum(workflowDocumentStepOutputTypes);
+const workflowDocumentStepOutputTypeSchema = z.enum(workflowDocumentStepOutputTypes).meta({
+    description: 'Declared output type. Use `json` when the output has a JSON Schema.'
+});
 const workflowDocumentStepOutputDeclarationSchema = z.union([
     workflowDocumentStepOutputTypeSchema.transform((type)=>({
             type
         })),
     z.strictObject({
         type: workflowDocumentStepOutputTypeSchema,
-        schema: z.unknown().optional()
+        schema: z.unknown().optional().meta({
+            description: 'JSON Schema for a `json` output. It allows up to ' + WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_SERIALIZED_BYTES + ' serialized bytes and ' + WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_DEPTH + ' nesting levels.'
+        })
     })
 ]).superRefine((declaration, ctx)=>{
     const schema = 'schema' in declaration ? declaration.schema : undefined;
@@ -117,23 +123,39 @@ export const workflowDocumentStepOutputsSchema = z.record(z.string(), workflowDo
             message: 'Output keys must be CEL identifiers.'
         });
     }
+}).meta({
+    description: `Named step outputs. Keys must be CEL identifiers and each step allows up to ${WORKFLOW_DOCUMENT_STEP_OUTPUTS_MAX_ENTRIES} declarations.`
 });
 const workflowDocumentTriggerBaseSchema = {
-    source: z.string().min(1),
-    with: z.record(z.string(), z.unknown()).optional(),
-    filter: z.string().min(1).optional(),
-    config: z.record(z.string(), z.unknown()).optional()
+    source: z.string().min(1).meta({
+        description: 'Integration connection slug or built-in trigger source. See [Trigger sources](/reference/trigger-sources).'
+    }),
+    with: z.record(z.string(), z.unknown()).optional().meta({
+        description: 'Provider-specific values used to match or configure the trigger. See [expressions](/reference/expressions#context-available).'
+    }),
+    filter: z.string().min(1).optional().meta({
+        description: 'CEL condition that filters matching events. It is not supported for `manual` or `cron` triggers. See [trigger filters](/reference/expressions#trigger-filters).'
+    }),
+    config: z.record(z.string(), z.unknown()).optional().meta({
+        description: 'Source-specific configuration. It is supported only for top-level triggers with a known built-in source. See [cron triggers](/reference/trigger-sources#cron).'
+    })
 };
 export const triggerSourceConfigSchemas = {
     cron: z.strictObject({
-        schedule: z.string().min(1).optional(),
-        timezone: z.string().min(1).optional()
+        schedule: z.string().min(1).optional().meta({
+            description: 'Cron expression that schedules the workflow.'
+        }),
+        timezone: z.string().min(1).optional().meta({
+            description: 'IANA time zone used to evaluate `schedule`.'
+        })
     })
 };
 const triggerSourceConfigSchemaRegistry = triggerSourceConfigSchemas;
 export const workflowDocumentTriggerSchema = z.strictObject({
     ...workflowDocumentTriggerBaseSchema,
-    event: z.string().min(1)
+    event: z.string().min(1).meta({
+        description: 'Provider event name that starts the workflow.'
+    })
 }).superRefine((trigger, ctx)=>{
     if (trigger.config === undefined) return;
     const configSchema = triggerSourceConfigSchemaRegistry[trigger.source];
@@ -160,21 +182,39 @@ export const workflowDocumentTriggerSchema = z.strictObject({
     }
 });
 const workflowDocumentListeningSchema = z.strictObject({
-    on: z.array(workflowDocumentTriggerSchema).min(1),
-    until: z.array(workflowDocumentTriggerSchema).min(1).optional(),
-    timeout: z.string().min(1).optional(),
-    max_executions: z.number().int().positive().optional(),
+    on: z.array(workflowDocumentTriggerSchema).min(1).meta({
+        description: 'Events that start listening. Listening triggers cannot use `config`.'
+    }),
+    until: z.array(workflowDocumentTriggerSchema).min(1).optional().meta({
+        description: 'Events that resolve listening. Listening jobs need this, `timeout`, or `max_executions`; these triggers cannot use `config`.'
+    }),
+    timeout: z.string().min(1).optional().meta({
+        description: 'Maximum duration to listen before resolving. A listening job needs this, `until`, or `max_executions`.'
+    }),
+    max_executions: z.number().int().positive().optional().meta({
+        description: 'Maximum number of matching events before resolving. A listening job needs this, `until`, or `timeout`.'
+    }),
     batch: z.strictObject({
-        debounce: z.string().min(1).optional(),
-        max_size: z.number().int().positive().optional(),
-        max_wait: z.string().min(1).optional()
+        debounce: z.string().min(1).optional().meta({
+            description: 'Quiet period to wait for more matching events before processing a batch.'
+        }),
+        max_size: z.number().int().positive().optional().meta({
+            description: 'Maximum number of matching events in one batch.'
+        }),
+        max_wait: z.string().min(1).optional().meta({
+            description: 'Maximum time to wait before processing a partial batch.'
+        })
     }).refine((value)=>value.debounce !== undefined || value.max_size !== undefined || value.max_wait !== undefined, {
         message: 'Expected debounce, max_size, or max_wait'
-    }).optional(),
+    }).optional().meta({
+        description: 'Optional batching policy. Set at least one of `debounce`, `max_size`, or `max_wait`.'
+    }),
     on_resolve: z.enum([
         'finish',
         'cancel'
-    ]).optional()
+    ]).optional().meta({
+        description: 'How the job resolves when its listening condition is met.'
+    })
 }).superRefine((listening, ctx)=>{
     for (const field of [
         'on',
@@ -196,11 +236,19 @@ const workflowDocumentListeningSchema = z.strictObject({
     }
 });
 const workflowDocumentStepGateSchema = z.strictObject({
-    success: z.string().min(1).optional(),
+    success: z.string().min(1).optional().meta({
+        description: 'CEL expression that must evaluate to true for the step to succeed. See [gate outcomes](/understand/feedback-loops#gate-outcomes).'
+    }),
     on_failure: z.strictObject({
-        restart_from: z.string().min(1),
-        feedback: z.string().min(1).optional()
-    }).optional()
+        restart_from: z.string().min(1).meta({
+            description: 'Key of an earlier step in the same job to restart from after a failed gate.'
+        }),
+        feedback: z.string().min(1).optional().meta({
+            description: 'Feedback supplied when the gate fails before restarting.'
+        })
+    }).optional().meta({
+        description: 'Restart behavior when the success gate fails. See [feedback loops](/understand/feedback-loops).'
+    })
 }).refine((value)=>value.success !== undefined || value.on_failure !== undefined, {
     message: 'Expected success or on_failure'
 });
@@ -209,17 +257,40 @@ export const workflowDocumentCheckoutSchema = z.strictObject({
         contents: z.enum([
             'read',
             'write'
-        ]).optional()
-    }).optional(),
-    'persist-credentials': z.boolean().optional()
+        ]).optional().meta({
+            description: 'Repository contents permission granted to checkout.'
+        })
+    }).optional().meta({
+        description: 'Repository permissions used during checkout.'
+    }),
+    'persist-credentials': z.boolean().optional().meta({
+        description: 'Whether checkout credentials remain available to later run steps.'
+    })
 });
 export const workflowDocumentStepIntegrationSelectionSchema = z.array(z.string().min(1)).min(1);
 export const workflowDocumentStepIntegrationSchema = z.strictObject({
-    connection: z.string().min(1).optional(),
-    include: workflowDocumentStepIntegrationSelectionSchema,
-    exclude: workflowDocumentStepIntegrationSelectionSchema.optional(),
-    allow_write: z.boolean().optional()
+    connection: z.string().min(1).optional().meta({
+        description: 'Integration connection slug to use for these tools.'
+    }),
+    include: workflowDocumentStepIntegrationSelectionSchema.meta({
+        description: 'Tool selectors to make available to the agent.'
+    }),
+    exclude: workflowDocumentStepIntegrationSelectionSchema.optional().meta({
+        description: 'Tool selectors to remove from the included tools.'
+    }),
+    allow_write: z.boolean().optional().meta({
+        description: 'Allows write-capable integration tools. Omit or set false for read-only access.'
+    })
 });
+export const workflowDocumentAgentStepFields = [
+    'model',
+    'prompt',
+    'harness',
+    'thinking',
+    'provider',
+    'tools',
+    'integrations'
+];
 // A step is a run step (`run`) or an inline agent step (`prompt`), never
 // both. They share one strict object so an unknown key is still rejected; the
 // `superRefine` discriminates by which payload keys are present and emits one
@@ -227,21 +298,51 @@ export const workflowDocumentStepIntegrationSchema = z.strictObject({
 // errors at once). The `agent` keyword is declared only so the reserved-keyword
 // case produces a clear message instead of a generic "unrecognized key".
 export const workflowDocumentStepSchema = z.strictObject({
-    key: z.string().min(1).optional(),
-    if: z.string().min(1).optional(),
-    name: z.string().min(1).optional(),
-    run: z.string().min(1).optional(),
-    model: z.string().min(1).optional(),
-    prompt: z.string().min(1).optional(),
-    harness: harnessSchema.optional(),
-    thinking: agentThinkingSchema.optional(),
-    provider: z.string().min(1).optional(),
-    tools: z.array(z.string().min(1)).min(1).optional(),
-    integrations: z.array(workflowDocumentStepIntegrationSchema).min(1).optional(),
-    agent: z.unknown().optional(),
-    gate: workflowDocumentStepGateSchema.optional(),
-    env: workflowDocumentEnvSchema.optional(),
-    outputs: workflowDocumentStepOutputsSchema.optional()
+    key: z.string().min(1).optional().meta({
+        description: 'Stable step key for dependencies and outputs.'
+    }),
+    if: z.string().min(1).optional().meta({
+        description: 'CEL condition wrapped in exactly one $' + '{{ }} interpolation. See [conditionals](/reference/expressions#conditionals-if).'
+    }),
+    name: z.string().min(1).optional().meta({
+        description: 'Human-readable step name.'
+    }),
+    run: z.string().min(1).optional().meta({
+        description: 'Shell command for a run step. Do not combine it with agent-only fields.'
+    }),
+    model: z.string().min(1).optional().meta({
+        description: 'Model ID for an agent step. It requires `prompt` and is not valid on a run step.'
+    }),
+    prompt: z.string().min(1).optional().meta({
+        description: 'Prompt for an agent step. It is required when any agent-only field is set.'
+    }),
+    harness: harnessSchema.optional().meta({
+        description: 'Agent harness. When omitted, Shipfox uses the workspace default harness, or `pi` when none is configured.'
+    }),
+    thinking: agentThinkingSchema.optional().meta({
+        description: 'Reasoning effort for an agent step. Supported values depend on the resolved harness. When omitted, Shipfox uses the provider default, or `xhigh` when none is configured.'
+    }),
+    provider: z.string().min(1).optional().meta({
+        description: 'Model provider ID for an agent step. It requires `prompt` and is not valid on a run step.'
+    }),
+    tools: z.array(z.string().min(1)).min(1).optional().meta({
+        description: 'Built-in tool IDs for an agent step. It requires `prompt` and is not valid on a run step.'
+    }),
+    integrations: z.array(workflowDocumentStepIntegrationSchema).min(1).optional().meta({
+        description: 'Integration tools available to an agent step. It requires `prompt` and is not valid on a run step. See [integration tools](/how-to/author-workflows/use-integration-tools).'
+    }),
+    agent: z.unknown().optional().meta({
+        description: 'Reserved keyword. It is rejected; use `prompt` to define an agent step.'
+    }),
+    gate: workflowDocumentStepGateSchema.optional().meta({
+        description: 'Success gate and optional restart behavior after the step runs.'
+    }),
+    env: workflowDocumentEnvSchema.optional().meta({
+        description: 'Environment variables for a run step. They are not valid on an agent step.'
+    }),
+    outputs: workflowDocumentStepOutputsSchema.optional().meta({
+        description: 'Named output declarations produced by this step.'
+    })
 }).superRefine((step, ctx)=>{
     if (step.agent !== undefined) {
         ctx.addIssue({
@@ -254,15 +355,7 @@ export const workflowDocumentStepSchema = z.strictObject({
         return;
     }
     if (step.run !== undefined) {
-        for (const key of [
-            'model',
-            'prompt',
-            'harness',
-            'thinking',
-            'provider',
-            'tools',
-            'integrations'
-        ]){
+        for (const key of workflowDocumentAgentStepFields){
             if (step[key] !== undefined) {
                 ctx.addIssue({
                     code: 'custom',
@@ -275,7 +368,7 @@ export const workflowDocumentStepSchema = z.strictObject({
         }
         return;
     }
-    const isAgent = step.model !== undefined || step.prompt !== undefined || step.harness !== undefined || step.thinking !== undefined || step.provider !== undefined || step.tools !== undefined || step.integrations !== undefined;
+    const isAgent = workflowDocumentAgentStepFields.some((field)=>step[field] !== undefined);
     if (!isAgent) {
         ctx.addIssue({
             code: 'custom',
@@ -303,24 +396,56 @@ export const workflowDocumentStepSchema = z.strictObject({
     }
 });
 export const workflowDocumentJobSchema = z.strictObject({
-    needs: stringOrStringArraySchema.optional(),
-    if: z.string().min(1).optional(),
-    runner: stringOrStringArraySchema.optional(),
-    success: z.string().min(1).optional(),
-    outputs: nonEmptyRecordSchema(z.string().min(1)).optional(),
-    execution_timeout: z.string().min(1).optional(),
-    checkout: workflowDocumentCheckoutSchema.optional(),
-    listening: workflowDocumentListeningSchema.optional(),
-    name: z.string().min(1).optional(),
-    env: workflowDocumentEnvSchema.optional(),
-    steps: z.array(workflowDocumentStepSchema).min(1)
+    needs: stringOrStringArraySchema.optional().meta({
+        description: 'Job key or keys that must complete before this job starts.'
+    }),
+    if: z.string().min(1).optional().meta({
+        description: 'CEL condition wrapped in exactly one $' + '{{ }} interpolation. See [conditionals](/reference/expressions#conditionals-if).'
+    }),
+    runner: stringOrStringArraySchema.optional().meta({
+        description: 'Runner label or ordered fallback labels for this job. See [runners and execution environments](/understand/runners-and-execution-environments).'
+    }),
+    success: z.string().min(1).optional().meta({
+        description: 'CEL expression that determines whether the job succeeds. See [job success](/reference/expressions#job-success-success).'
+    }),
+    outputs: nonEmptyRecordSchema(z.string().min(1)).optional().meta({
+        description: 'Named job outputs mapped from step values.'
+    }),
+    execution_timeout: z.string().min(1).optional().meta({
+        description: 'Maximum duration for one job execution.'
+    }),
+    checkout: workflowDocumentCheckoutSchema.optional().meta({
+        description: 'Checkout settings for repository content and credentials.'
+    }),
+    listening: workflowDocumentListeningSchema.optional().meta({
+        description: 'Event-listening configuration for this job. See [listening jobs](/understand/listening-jobs).'
+    }),
+    name: z.string().min(1).optional().meta({
+        description: 'Human-readable job name.'
+    }),
+    env: workflowDocumentEnvSchema.optional().meta({
+        description: 'Environment variables for run steps in this job. They do not apply to agent steps. See [secrets and variables](/reference/secrets-variables).'
+    }),
+    steps: z.array(workflowDocumentStepSchema).min(1).meta({
+        description: 'Ordered run or agent steps. Each job needs at least one step.'
+    })
 });
 export const workflowDocumentSchema = z.strictObject({
-    name: z.string().min(1),
-    runner: stringOrStringArraySchema.optional(),
-    env: workflowDocumentEnvSchema.optional(),
-    triggers: nonEmptyRecordSchema(workflowDocumentTriggerSchema).optional(),
-    jobs: nonEmptyRecordSchema(workflowDocumentJobSchema)
+    name: z.string().min(1).meta({
+        description: 'Human-readable workflow name.'
+    }),
+    runner: stringOrStringArraySchema.optional().meta({
+        description: 'Default runner label or ordered fallback labels for run jobs. See [runners and execution environments](/understand/runners-and-execution-environments).'
+    }),
+    env: workflowDocumentEnvSchema.optional().meta({
+        description: 'Workflow-level environment variables for run steps. They do not apply to agent steps. See [secrets and variables](/reference/secrets-variables).'
+    }),
+    triggers: nonEmptyRecordSchema(workflowDocumentTriggerSchema).optional().meta({
+        description: 'Named events that start workflow runs. A workflow can have at most one `manual` trigger.'
+    }),
+    jobs: nonEmptyRecordSchema(workflowDocumentJobSchema).meta({
+        description: 'Named jobs that make up the workflow. At least one job is required.'
+    })
 });
 function maxJsonDepth(value) {
     if (value === null || typeof value !== 'object') return 0;

package/dist/document/workflow-document.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/document/workflow-document.ts"],"sourcesContent":["import {z} from 'zod';\nimport {agentThinkingSchema, harnessSchema} from './step-enums.js';\n\nconst stringOrStringArraySchema = z.union([z.string().min(1), z.array(z.string().min(1)).min(1)]);\nconst nonEmptyRecordSchema = <ValueSchema extends z.ZodType>(valueSchema: ValueSchema) =>\n  z\n    .record(z.string().min(1), valueSchema)\n    .refine((value) => Object.keys(value).length > 0, {message: 'Expected at least one entry'});\n\n// Runner shell steps execute on Unix shells, so workflow env names follow the\n// portable POSIX-style variable shape.\nconst envNameSchema = z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/);\nconst envStringValueSchema = z.string().refine((value) => !value.includes('\\u0000'), {\n  message: 'Env string values cannot contain null bytes',\n});\nexport const WORKFLOW_DOCUMENT_ENV_MAX_ENTRIES = 128;\nexport const WORKFLOW_DOCUMENT_ENV_MAX_SERIALIZED_BYTES = 32 * 1024;\nexport const workflowDocumentStepOutputTypes = ['string', 'number', 'boolean', 'json'] as const;\nexport const WORKFLOW_DOCUMENT_STEP_OUTPUTS_MAX_ENTRIES = WORKFLOW_DOCUMENT_ENV_MAX_ENTRIES;\nexport const WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_SERIALIZED_BYTES =\n  WORKFLOW_DOCUMENT_ENV_MAX_SERIALIZED_BYTES;\nexport const WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_DEPTH = 64;\n\nconst utf8Encoder = new TextEncoder();\n\nexport const workflowDocumentEnvSchema = z\n  .record(envNameSchema, z.union([envStringValueSchema, z.number(), z.boolean()]))\n  .superRefine((env, ctx) => {\n    const entries = Object.keys(env).length;\n    if (entries > WORKFLOW_DOCUMENT_ENV_MAX_ENTRIES) {\n      ctx.addIssue({\n        code: 'custom',\n        message: `Env cannot define more than ${WORKFLOW_DOCUMENT_ENV_MAX_ENTRIES} entries.`,\n      });\n    }\n\n    const serializedBytes = utf8Encoder.encode(JSON.stringify(env)).byteLength;\n    if (serializedBytes > WORKFLOW_DOCUMENT_ENV_MAX_SERIALIZED_BYTES) {\n      ctx.addIssue({\n        code: 'custom',\n        message: `Env cannot serialize to more than ${WORKFLOW_DOCUMENT_ENV_MAX_SERIALIZED_BYTES} bytes.`,\n      });\n    }\n  });\n\nconst workflowDocumentStepOutputKeyPattern = /^[a-zA-Z_][a-zA-Z0-9_]*$/;\n\nconst workflowDocumentStepOutputTypeSchema = z.enum(workflowDocumentStepOutputTypes);\n\nconst workflowDocumentStepOutputDeclarationSchema = z\n  .union([\n    workflowDocumentStepOutputTypeSchema.transform((type) => ({type})),\n    z.strictObject({\n      type: workflowDocumentStepOutputTypeSchema,\n      schema: z.unknown().optional(),\n    }),\n  ])\n  .superRefine((declaration, ctx) => {\n    const schema = 'schema' in declaration ? declaration.schema : undefined;\n    if (declaration.type !== 'json' && schema !== undefined) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['schema'],\n        message: '`schema` is only supported for json outputs.',\n      });\n      return;\n    }\n\n    if (schema === undefined) return;\n\n    if (!isJsonSchemaDocument(schema)) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['schema'],\n        message: 'Schema must be a valid JSON Schema document.',\n      });\n      return;\n    }\n\n    const serializedBytes = utf8Encoder.encode(JSON.stringify(schema)).byteLength;\n    if (serializedBytes > WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_SERIALIZED_BYTES) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['schema'],\n        message: `Output JSON Schema cannot serialize to more than ${WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_SERIALIZED_BYTES} bytes.`,\n      });\n    }\n\n    const depth = maxJsonDepth(schema);\n    if (depth > WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_DEPTH) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['schema'],\n        message: `Output JSON Schema cannot be nested deeper than ${WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_DEPTH} levels.`,\n      });\n    }\n  });\n\nexport const workflowDocumentStepOutputsSchema = z\n  .record(z.string(), workflowDocumentStepOutputDeclarationSchema)\n  .superRefine((outputs, ctx) => {\n    const entries = Object.keys(outputs).length;\n    if (entries > WORKFLOW_DOCUMENT_STEP_OUTPUTS_MAX_ENTRIES) {\n      ctx.addIssue({\n        code: 'custom',\n        message: `Step outputs cannot define more than ${WORKFLOW_DOCUMENT_STEP_OUTPUTS_MAX_ENTRIES} entries.`,\n      });\n    }\n\n    for (const key of Object.keys(outputs)) {\n      if (workflowDocumentStepOutputKeyPattern.test(key)) continue;\n      ctx.addIssue({\n        code: 'custom',\n        path: [key],\n        message: 'Output keys must be CEL identifiers.',\n      });\n    }\n  });\n\nconst workflowDocumentTriggerBaseSchema = {\n  source: z.string().min(1),\n  with: z.record(z.string(), z.unknown()).optional(),\n  filter: z.string().min(1).optional(),\n  config: z.record(z.string(), z.unknown()).optional(),\n} satisfies z.ZodRawShape;\n\nexport const triggerSourceConfigSchemas = {\n  cron: z.strictObject({\n    schedule: z.string().min(1).optional(),\n    timezone: z.string().min(1).optional(),\n  }),\n} satisfies Record<string, z.ZodType>;\nconst triggerSourceConfigSchemaRegistry: Readonly<Record<string, z.ZodType>> =\n  triggerSourceConfigSchemas;\n\nexport const workflowDocumentTriggerSchema = z\n  .strictObject({\n    ...workflowDocumentTriggerBaseSchema,\n    event: z.string().min(1),\n  })\n  .superRefine((trigger, ctx) => {\n    if (trigger.config === undefined) return;\n\n    const configSchema = triggerSourceConfigSchemaRegistry[trigger.source];\n    if (configSchema === undefined) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['config'],\n        message: `\\`config\\` is not supported for source \\`${trigger.source}\\`.`,\n      });\n      return;\n    }\n\n    const configResult = configSchema.safeParse(trigger.config);\n    if (configResult.success) return;\n\n    for (const configIssue of configResult.error.issues) {\n      ctx.addIssue({\n        ...configIssue,\n        path: ['config', ...configIssue.path],\n      });\n    }\n  });\n\nconst workflowDocumentListeningSchema = z\n  .strictObject({\n    on: z.array(workflowDocumentTriggerSchema).min(1),\n    until: z.array(workflowDocumentTriggerSchema).min(1).optional(),\n    timeout: z.string().min(1).optional(),\n    max_executions: z.number().int().positive().optional(),\n    batch: z\n      .strictObject({\n        debounce: z.string().min(1).optional(),\n        max_size: z.number().int().positive().optional(),\n        max_wait: z.string().min(1).optional(),\n      })\n      .refine(\n        (value) =>\n          value.debounce !== undefined ||\n          value.max_size !== undefined ||\n          value.max_wait !== undefined,\n        {message: 'Expected debounce, max_size, or max_wait'},\n      )\n      .optional(),\n    on_resolve: z.enum(['finish', 'cancel']).optional(),\n  })\n  .superRefine((listening, ctx) => {\n    for (const field of ['on', 'until'] as const) {\n      for (const [index, trigger] of (listening[field] ?? []).entries()) {\n        if (trigger.config !== undefined) {\n          ctx.addIssue({\n            code: 'custom',\n            path: [field, index, 'config'],\n            message: '`config` is only supported on top-level triggers.',\n          });\n        }\n      }\n    }\n  });\n\nconst workflowDocumentStepGateSchema = z\n  .strictObject({\n    success: z.string().min(1).optional(),\n    on_failure: z\n      .strictObject({\n        restart_from: z.string().min(1),\n        feedback: z.string().min(1).optional(),\n      })\n      .optional(),\n  })\n  .refine((value) => value.success !== undefined || value.on_failure !== undefined, {\n    message: 'Expected success or on_failure',\n  });\n\nexport const workflowDocumentCheckoutSchema = z.strictObject({\n  permissions: z\n    .strictObject({\n      contents: z.enum(['read', 'write']).optional(),\n    })\n    .optional(),\n  'persist-credentials': z.boolean().optional(),\n});\n\nexport const workflowDocumentStepIntegrationSelectionSchema = z.array(z.string().min(1)).min(1);\n\nexport const workflowDocumentStepIntegrationSchema = z.strictObject({\n  connection: z.string().min(1).optional(),\n  include: workflowDocumentStepIntegrationSelectionSchema,\n  exclude: workflowDocumentStepIntegrationSelectionSchema.optional(),\n  allow_write: z.boolean().optional(),\n});\n\n// A step is a run step (`run`) or an inline agent step (`prompt`), never\n// both. They share one strict object so an unknown key is still rejected; the\n// `superRefine` discriminates by which payload keys are present and emits one\n// targeted issue per failure mode (a plain union would surface every branch's\n// errors at once). The `agent` keyword is declared only so the reserved-keyword\n// case produces a clear message instead of a generic \"unrecognized key\".\nexport const workflowDocumentStepSchema = z\n  .strictObject({\n    key: z.string().min(1).optional(),\n    if: z.string().min(1).optional(),\n    name: z.string().min(1).optional(),\n    run: z.string().min(1).optional(),\n    model: z.string().min(1).optional(),\n    prompt: z.string().min(1).optional(),\n    harness: harnessSchema.optional(),\n    thinking: agentThinkingSchema.optional(),\n    provider: z.string().min(1).optional(),\n    tools: z.array(z.string().min(1)).min(1).optional(),\n    integrations: z.array(workflowDocumentStepIntegrationSchema).min(1).optional(),\n    agent: z.unknown().optional(),\n    gate: workflowDocumentStepGateSchema.optional(),\n    env: workflowDocumentEnvSchema.optional(),\n    outputs: workflowDocumentStepOutputsSchema.optional(),\n  })\n  .superRefine((step, ctx) => {\n    if (step.agent !== undefined) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['agent'],\n        message: 'The \"agent\" keyword is reserved for a future step kind and is not supported yet.',\n      });\n      return;\n    }\n\n    if (step.run !== undefined) {\n      for (const key of [\n        'model',\n        'prompt',\n        'harness',\n        'thinking',\n        'provider',\n        'tools',\n        'integrations',\n      ] as const) {\n        if (step[key] !== undefined) {\n          ctx.addIssue({\n            code: 'custom',\n            path: [key],\n            message: `\"${key}\" is not valid on a run step.`,\n          });\n        }\n      }\n      return;\n    }\n\n    const isAgent =\n      step.model !== undefined ||\n      step.prompt !== undefined ||\n      step.harness !== undefined ||\n      step.thinking !== undefined ||\n      step.provider !== undefined ||\n      step.tools !== undefined ||\n      step.integrations !== undefined;\n\n    if (!isAgent) {\n      ctx.addIssue({\n        code: 'custom',\n        message: 'A step must define either \"run\" or an agent \"prompt\".',\n      });\n      return;\n    }\n\n    if (step.env !== undefined) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['env'],\n        message: '\"env\" is supported only on run steps.',\n      });\n    }\n    if (step.prompt === undefined) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['prompt'],\n        message: 'An agent step requires \"prompt\".',\n      });\n    }\n  });\n\nexport const workflowDocumentJobSchema = z.strictObject({\n  needs: stringOrStringArraySchema.optional(),\n  if: z.string().min(1).optional(),\n  runner: stringOrStringArraySchema.optional(),\n  success: z.string().min(1).optional(),\n  outputs: nonEmptyRecordSchema(z.string().min(1)).optional(),\n  execution_timeout: z.string().min(1).optional(),\n  checkout: workflowDocumentCheckoutSchema.optional(),\n  listening: workflowDocumentListeningSchema.optional(),\n  name: z.string().min(1).optional(),\n  env: workflowDocumentEnvSchema.optional(),\n  steps: z.array(workflowDocumentStepSchema).min(1),\n});\n\nexport const workflowDocumentSchema = z.strictObject({\n  name: z.string().min(1),\n  runner: stringOrStringArraySchema.optional(),\n  env: workflowDocumentEnvSchema.optional(),\n  triggers: nonEmptyRecordSchema(workflowDocumentTriggerSchema).optional(),\n  jobs: nonEmptyRecordSchema(workflowDocumentJobSchema),\n});\n\nexport type WorkflowDocument = z.infer<typeof workflowDocumentSchema>;\nexport type WorkflowDocumentJobCheckout = z.infer<typeof workflowDocumentCheckoutSchema>;\nexport type WorkflowDocumentEnv = z.infer<typeof workflowDocumentEnvSchema>;\nexport type WorkflowDocumentJob = z.infer<typeof workflowDocumentJobSchema>;\nexport type WorkflowDocumentJobListening = z.infer<typeof workflowDocumentListeningSchema>;\nexport type WorkflowDocumentRunStepGate = z.infer<typeof workflowDocumentStepGateSchema>;\nexport type WorkflowDocumentStepIntegration = z.infer<typeof workflowDocumentStepIntegrationSchema>;\nexport type WorkflowDocumentStepOutputType = (typeof workflowDocumentStepOutputTypes)[number];\nexport type WorkflowDocumentStepOutputs = z.infer<typeof workflowDocumentStepOutputsSchema>;\nexport type WorkflowDocumentStep = z.infer<typeof workflowDocumentStepSchema>;\nexport type WorkflowDocumentTrigger = z.infer<typeof workflowDocumentTriggerSchema>;\n\nfunction maxJsonDepth(value: unknown): number {\n  if (value === null || typeof value !== 'object') return 0;\n  if (Array.isArray(value)) {\n    if (value.length === 0) return 1;\n    return 1 + Math.max(...value.map(maxJsonDepth));\n  }\n\n  const entries = Object.values(value);\n  if (entries.length === 0) return 1;\n  return 1 + Math.max(...entries.map(maxJsonDepth));\n}\n\nfunction isJsonSchemaDocument(value: unknown): boolean {\n  return (\n    typeof value === 'boolean' ||\n    (typeof value === 'object' && value !== null && !Array.isArray(value))\n  );\n}\n"],"names":["z","agentThinkingSchema","harnessSchema","stringOrStringArraySchema","union","string","min","array","nonEmptyRecordSchema","valueSchema","record","refine","value","Object","keys","length","message","envNameSchema","regex","envStringValueSchema","includes","WORKFLOW_DOCUMENT_ENV_MAX_ENTRIES","WORKFLOW_DOCUMENT_ENV_MAX_SERIALIZED_BYTES","workflowDocumentStepOutputTypes","WORKFLOW_DOCUMENT_STEP_OUTPUTS_MAX_ENTRIES","WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_SERIALIZED_BYTES","WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_DEPTH","utf8Encoder","TextEncoder","workflowDocumentEnvSchema","number","boolean","superRefine","env","ctx","entries","addIssue","code","serializedBytes","encode","JSON","stringify","byteLength","workflowDocumentStepOutputKeyPattern","workflowDocumentStepOutputTypeSchema","enum","workflowDocumentStepOutputDeclarationSchema","transform","type","strictObject","schema","unknown","optional","declaration","undefined","path","isJsonSchemaDocument","depth","maxJsonDepth","workflowDocumentStepOutputsSchema","outputs","key","test","workflowDocumentTriggerBaseSchema","source","with","filter","config","triggerSourceConfigSchemas","cron","schedule","timezone","triggerSourceConfigSchemaRegistry","workflowDocumentTriggerSchema","event","trigger","configSchema","configResult","safeParse","success","configIssue","error","issues","workflowDocumentListeningSchema","on","until","timeout","max_executions","int","positive","batch","debounce","max_size","max_wait","on_resolve","listening","field","index","workflowDocumentStepGateSchema","on_failure","restart_from","feedback","workflowDocumentCheckoutSchema","permissions","contents","workflowDocumentStepIntegrationSelectionSchema","workflowDocumentStepIntegrationSchema","connection","include","exclude","allow_write","workflowDocumentStepSchema","if","name","run","model","prompt","harness","thinking","provider","tools","integrations","agent","gate","step","isAgent","workflowDocumentJobSchema","needs","runner","execution_timeout","checkout","steps","workflowDocumentSchema","triggers","jobs","Array","isArray","Math","max","map","values"],"mappings":"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"}
+{"version":3,"sources":["../../src/document/workflow-document.ts"],"sourcesContent":["import {z} from 'zod';\nimport {agentThinkingSchema, harnessSchema} from './step-enums.js';\n\nconst stringOrStringArraySchema = z.union([z.string().min(1), z.array(z.string().min(1)).min(1)]);\nconst nonEmptyRecordSchema = <ValueSchema extends z.ZodType>(valueSchema: ValueSchema) =>\n  z\n    .record(z.string().min(1), valueSchema)\n    .refine((value) => Object.keys(value).length > 0, {message: 'Expected at least one entry'});\n\n// Runner shell steps execute on Unix shells, so workflow env names follow the\n// portable POSIX-style variable shape.\nconst envNameSchema = z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/);\nconst envStringValueSchema = z.string().refine((value) => !value.includes('\\u0000'), {\n  message: 'Env string values cannot contain null bytes',\n});\nexport const WORKFLOW_DOCUMENT_ENV_MAX_ENTRIES = 128;\nexport const WORKFLOW_DOCUMENT_ENV_MAX_SERIALIZED_BYTES = 32 * 1024;\nexport const workflowDocumentStepOutputTypes = ['string', 'number', 'boolean', 'json'] as const;\nexport const WORKFLOW_DOCUMENT_STEP_OUTPUTS_MAX_ENTRIES = WORKFLOW_DOCUMENT_ENV_MAX_ENTRIES;\nexport const WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_SERIALIZED_BYTES =\n  WORKFLOW_DOCUMENT_ENV_MAX_SERIALIZED_BYTES;\nexport const WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_DEPTH = 64;\n\nconst utf8Encoder = new TextEncoder();\n\nexport const workflowDocumentEnvSchema = z\n  .record(envNameSchema, z.union([envStringValueSchema, z.number(), z.boolean()]))\n  .superRefine((env, ctx) => {\n    const entries = Object.keys(env).length;\n    if (entries > WORKFLOW_DOCUMENT_ENV_MAX_ENTRIES) {\n      ctx.addIssue({\n        code: 'custom',\n        message: `Env cannot define more than ${WORKFLOW_DOCUMENT_ENV_MAX_ENTRIES} entries.`,\n      });\n    }\n\n    const serializedBytes = utf8Encoder.encode(JSON.stringify(env)).byteLength;\n    if (serializedBytes > WORKFLOW_DOCUMENT_ENV_MAX_SERIALIZED_BYTES) {\n      ctx.addIssue({\n        code: 'custom',\n        message: `Env cannot serialize to more than ${WORKFLOW_DOCUMENT_ENV_MAX_SERIALIZED_BYTES} bytes.`,\n      });\n    }\n  })\n  .meta({\n    description: `Environment variables as string, number, or boolean values. Each map allows up to ${WORKFLOW_DOCUMENT_ENV_MAX_ENTRIES} entries and ${WORKFLOW_DOCUMENT_ENV_MAX_SERIALIZED_BYTES} serialized bytes.`,\n  });\n\nconst workflowDocumentStepOutputKeyPattern = /^[a-zA-Z_][a-zA-Z0-9_]*$/;\n\nconst workflowDocumentStepOutputTypeSchema = z.enum(workflowDocumentStepOutputTypes).meta({\n  description: 'Declared output type. Use `json` when the output has a JSON Schema.',\n});\n\nconst workflowDocumentStepOutputDeclarationSchema = z\n  .union([\n    workflowDocumentStepOutputTypeSchema.transform((type) => ({type})),\n    z.strictObject({\n      type: workflowDocumentStepOutputTypeSchema,\n      schema: z\n        .unknown()\n        .optional()\n        .meta({\n          description:\n            'JSON Schema for a `json` output. It allows up to ' +\n            WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_SERIALIZED_BYTES +\n            ' serialized bytes and ' +\n            WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_DEPTH +\n            ' nesting levels.',\n        }),\n    }),\n  ])\n  .superRefine((declaration, ctx) => {\n    const schema = 'schema' in declaration ? declaration.schema : undefined;\n    if (declaration.type !== 'json' && schema !== undefined) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['schema'],\n        message: '`schema` is only supported for json outputs.',\n      });\n      return;\n    }\n\n    if (schema === undefined) return;\n\n    if (!isJsonSchemaDocument(schema)) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['schema'],\n        message: 'Schema must be a valid JSON Schema document.',\n      });\n      return;\n    }\n\n    const serializedBytes = utf8Encoder.encode(JSON.stringify(schema)).byteLength;\n    if (serializedBytes > WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_SERIALIZED_BYTES) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['schema'],\n        message: `Output JSON Schema cannot serialize to more than ${WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_SERIALIZED_BYTES} bytes.`,\n      });\n    }\n\n    const depth = maxJsonDepth(schema);\n    if (depth > WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_DEPTH) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['schema'],\n        message: `Output JSON Schema cannot be nested deeper than ${WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_DEPTH} levels.`,\n      });\n    }\n  });\n\nexport const workflowDocumentStepOutputsSchema = z\n  .record(z.string(), workflowDocumentStepOutputDeclarationSchema)\n  .superRefine((outputs, ctx) => {\n    const entries = Object.keys(outputs).length;\n    if (entries > WORKFLOW_DOCUMENT_STEP_OUTPUTS_MAX_ENTRIES) {\n      ctx.addIssue({\n        code: 'custom',\n        message: `Step outputs cannot define more than ${WORKFLOW_DOCUMENT_STEP_OUTPUTS_MAX_ENTRIES} entries.`,\n      });\n    }\n\n    for (const key of Object.keys(outputs)) {\n      if (workflowDocumentStepOutputKeyPattern.test(key)) continue;\n      ctx.addIssue({\n        code: 'custom',\n        path: [key],\n        message: 'Output keys must be CEL identifiers.',\n      });\n    }\n  })\n  .meta({\n    description: `Named step outputs. Keys must be CEL identifiers and each step allows up to ${WORKFLOW_DOCUMENT_STEP_OUTPUTS_MAX_ENTRIES} declarations.`,\n  });\n\nconst workflowDocumentTriggerBaseSchema = {\n  source: z.string().min(1).meta({\n    description:\n      'Integration connection slug or built-in trigger source. See [Trigger sources](/reference/trigger-sources).',\n  }),\n  with: z.record(z.string(), z.unknown()).optional().meta({\n    description:\n      'Provider-specific values used to match or configure the trigger. See [expressions](/reference/expressions#context-available).',\n  }),\n  filter: z.string().min(1).optional().meta({\n    description:\n      'CEL condition that filters matching events. It is not supported for `manual` or `cron` triggers. See [trigger filters](/reference/expressions#trigger-filters).',\n  }),\n  config: z.record(z.string(), z.unknown()).optional().meta({\n    description:\n      'Source-specific configuration. It is supported only for top-level triggers with a known built-in source. See [cron triggers](/reference/trigger-sources#cron).',\n  }),\n} satisfies z.ZodRawShape;\n\nexport const triggerSourceConfigSchemas = {\n  cron: z.strictObject({\n    schedule: z.string().min(1).optional().meta({\n      description: 'Cron expression that schedules the workflow.',\n    }),\n    timezone: z.string().min(1).optional().meta({\n      description: 'IANA time zone used to evaluate `schedule`.',\n    }),\n  }),\n} satisfies Record<string, z.ZodType>;\nconst triggerSourceConfigSchemaRegistry: Readonly<Record<string, z.ZodType>> =\n  triggerSourceConfigSchemas;\n\nexport const workflowDocumentTriggerSchema = z\n  .strictObject({\n    ...workflowDocumentTriggerBaseSchema,\n    event: z.string().min(1).meta({\n      description: 'Provider event name that starts the workflow.',\n    }),\n  })\n  .superRefine((trigger, ctx) => {\n    if (trigger.config === undefined) return;\n\n    const configSchema = triggerSourceConfigSchemaRegistry[trigger.source];\n    if (configSchema === undefined) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['config'],\n        message: `\\`config\\` is not supported for source \\`${trigger.source}\\`.`,\n      });\n      return;\n    }\n\n    const configResult = configSchema.safeParse(trigger.config);\n    if (configResult.success) return;\n\n    for (const configIssue of configResult.error.issues) {\n      ctx.addIssue({\n        ...configIssue,\n        path: ['config', ...configIssue.path],\n      });\n    }\n  });\n\nconst workflowDocumentListeningSchema = z\n  .strictObject({\n    on: z.array(workflowDocumentTriggerSchema).min(1).meta({\n      description: 'Events that start listening. Listening triggers cannot use `config`.',\n    }),\n    until: z.array(workflowDocumentTriggerSchema).min(1).optional().meta({\n      description:\n        'Events that resolve listening. Listening jobs need this, `timeout`, or `max_executions`; these triggers cannot use `config`.',\n    }),\n    timeout: z.string().min(1).optional().meta({\n      description:\n        'Maximum duration to listen before resolving. A listening job needs this, `until`, or `max_executions`.',\n    }),\n    max_executions: z.number().int().positive().optional().meta({\n      description:\n        'Maximum number of matching events before resolving. A listening job needs this, `until`, or `timeout`.',\n    }),\n    batch: z\n      .strictObject({\n        debounce: z.string().min(1).optional().meta({\n          description: 'Quiet period to wait for more matching events before processing a batch.',\n        }),\n        max_size: z.number().int().positive().optional().meta({\n          description: 'Maximum number of matching events in one batch.',\n        }),\n        max_wait: z.string().min(1).optional().meta({\n          description: 'Maximum time to wait before processing a partial batch.',\n        }),\n      })\n      .refine(\n        (value) =>\n          value.debounce !== undefined ||\n          value.max_size !== undefined ||\n          value.max_wait !== undefined,\n        {message: 'Expected debounce, max_size, or max_wait'},\n      )\n      .optional()\n      .meta({\n        description:\n          'Optional batching policy. Set at least one of `debounce`, `max_size`, or `max_wait`.',\n      }),\n    on_resolve: z.enum(['finish', 'cancel']).optional().meta({\n      description: 'How the job resolves when its listening condition is met.',\n    }),\n  })\n  .superRefine((listening, ctx) => {\n    for (const field of ['on', 'until'] as const) {\n      for (const [index, trigger] of (listening[field] ?? []).entries()) {\n        if (trigger.config !== undefined) {\n          ctx.addIssue({\n            code: 'custom',\n            path: [field, index, 'config'],\n            message: '`config` is only supported on top-level triggers.',\n          });\n        }\n      }\n    }\n  });\n\nconst workflowDocumentStepGateSchema = z\n  .strictObject({\n    success: z.string().min(1).optional().meta({\n      description:\n        'CEL expression that must evaluate to true for the step to succeed. See [gate outcomes](/understand/feedback-loops#gate-outcomes).',\n    }),\n    on_failure: z\n      .strictObject({\n        restart_from: z.string().min(1).meta({\n          description:\n            'Key of an earlier step in the same job to restart from after a failed gate.',\n        }),\n        feedback: z.string().min(1).optional().meta({\n          description: 'Feedback supplied when the gate fails before restarting.',\n        }),\n      })\n      .optional()\n      .meta({\n        description:\n          'Restart behavior when the success gate fails. See [feedback loops](/understand/feedback-loops).',\n      }),\n  })\n  .refine((value) => value.success !== undefined || value.on_failure !== undefined, {\n    message: 'Expected success or on_failure',\n  });\n\nexport const workflowDocumentCheckoutSchema = z.strictObject({\n  permissions: z\n    .strictObject({\n      contents: z.enum(['read', 'write']).optional().meta({\n        description: 'Repository contents permission granted to checkout.',\n      }),\n    })\n    .optional()\n    .meta({\n      description: 'Repository permissions used during checkout.',\n    }),\n  'persist-credentials': z.boolean().optional().meta({\n    description: 'Whether checkout credentials remain available to later run steps.',\n  }),\n});\n\nexport const workflowDocumentStepIntegrationSelectionSchema = z.array(z.string().min(1)).min(1);\n\nexport const workflowDocumentStepIntegrationSchema = z.strictObject({\n  connection: z.string().min(1).optional().meta({\n    description: 'Integration connection slug to use for these tools.',\n  }),\n  include: workflowDocumentStepIntegrationSelectionSchema.meta({\n    description: 'Tool selectors to make available to the agent.',\n  }),\n  exclude: workflowDocumentStepIntegrationSelectionSchema.optional().meta({\n    description: 'Tool selectors to remove from the included tools.',\n  }),\n  allow_write: z.boolean().optional().meta({\n    description: 'Allows write-capable integration tools. Omit or set false for read-only access.',\n  }),\n});\n\nexport const workflowDocumentAgentStepFields = [\n  'model',\n  'prompt',\n  'harness',\n  'thinking',\n  'provider',\n  'tools',\n  'integrations',\n] as const;\n\n// A step is a run step (`run`) or an inline agent step (`prompt`), never\n// both. They share one strict object so an unknown key is still rejected; the\n// `superRefine` discriminates by which payload keys are present and emits one\n// targeted issue per failure mode (a plain union would surface every branch's\n// errors at once). The `agent` keyword is declared only so the reserved-keyword\n// case produces a clear message instead of a generic \"unrecognized key\".\nexport const workflowDocumentStepSchema = z\n  .strictObject({\n    key: z\n      .string()\n      .min(1)\n      .optional()\n      .meta({description: 'Stable step key for dependencies and outputs.'}),\n    if: z\n      .string()\n      .min(1)\n      .optional()\n      .meta({\n        description:\n          'CEL condition wrapped in exactly one $' +\n          '{{ }} interpolation. See [conditionals](/reference/expressions#conditionals-if).',\n      }),\n    name: z.string().min(1).optional().meta({description: 'Human-readable step name.'}),\n    run: z.string().min(1).optional().meta({\n      description: 'Shell command for a run step. Do not combine it with agent-only fields.',\n    }),\n    model: z.string().min(1).optional().meta({\n      description:\n        'Model ID for an agent step. It requires `prompt` and is not valid on a run step.',\n    }),\n    prompt: z.string().min(1).optional().meta({\n      description: 'Prompt for an agent step. It is required when any agent-only field is set.',\n    }),\n    harness: harnessSchema.optional().meta({\n      description:\n        'Agent harness. When omitted, Shipfox uses the workspace default harness, or `pi` when none is configured.',\n    }),\n    thinking: agentThinkingSchema.optional().meta({\n      description:\n        'Reasoning effort for an agent step. Supported values depend on the resolved harness. When omitted, Shipfox uses the provider default, or `xhigh` when none is configured.',\n    }),\n    provider: z.string().min(1).optional().meta({\n      description:\n        'Model provider ID for an agent step. It requires `prompt` and is not valid on a run step.',\n    }),\n    tools: z.array(z.string().min(1)).min(1).optional().meta({\n      description:\n        'Built-in tool IDs for an agent step. It requires `prompt` and is not valid on a run step.',\n    }),\n    integrations: z.array(workflowDocumentStepIntegrationSchema).min(1).optional().meta({\n      description:\n        'Integration tools available to an agent step. It requires `prompt` and is not valid on a run step. See [integration tools](/how-to/author-workflows/use-integration-tools).',\n    }),\n    agent: z.unknown().optional().meta({\n      description: 'Reserved keyword. It is rejected; use `prompt` to define an agent step.',\n    }),\n    gate: workflowDocumentStepGateSchema.optional().meta({\n      description: 'Success gate and optional restart behavior after the step runs.',\n    }),\n    env: workflowDocumentEnvSchema.optional().meta({\n      description: 'Environment variables for a run step. They are not valid on an agent step.',\n    }),\n    outputs: workflowDocumentStepOutputsSchema.optional().meta({\n      description: 'Named output declarations produced by this step.',\n    }),\n  })\n  .superRefine((step, ctx) => {\n    if (step.agent !== undefined) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['agent'],\n        message: 'The \"agent\" keyword is reserved for a future step kind and is not supported yet.',\n      });\n      return;\n    }\n\n    if (step.run !== undefined) {\n      for (const key of workflowDocumentAgentStepFields) {\n        if (step[key] !== undefined) {\n          ctx.addIssue({\n            code: 'custom',\n            path: [key],\n            message: `\"${key}\" is not valid on a run step.`,\n          });\n        }\n      }\n      return;\n    }\n\n    const isAgent = workflowDocumentAgentStepFields.some((field) => step[field] !== undefined);\n\n    if (!isAgent) {\n      ctx.addIssue({\n        code: 'custom',\n        message: 'A step must define either \"run\" or an agent \"prompt\".',\n      });\n      return;\n    }\n\n    if (step.env !== undefined) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['env'],\n        message: '\"env\" is supported only on run steps.',\n      });\n    }\n    if (step.prompt === undefined) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['prompt'],\n        message: 'An agent step requires \"prompt\".',\n      });\n    }\n  });\n\nexport const workflowDocumentJobSchema = z.strictObject({\n  needs: stringOrStringArraySchema.optional().meta({\n    description: 'Job key or keys that must complete before this job starts.',\n  }),\n  if: z\n    .string()\n    .min(1)\n    .optional()\n    .meta({\n      description:\n        'CEL condition wrapped in exactly one $' +\n        '{{ }} interpolation. See [conditionals](/reference/expressions#conditionals-if).',\n    }),\n  runner: stringOrStringArraySchema.optional().meta({\n    description:\n      'Runner label or ordered fallback labels for this job. See [runners and execution environments](/understand/runners-and-execution-environments).',\n  }),\n  success: z.string().min(1).optional().meta({\n    description:\n      'CEL expression that determines whether the job succeeds. See [job success](/reference/expressions#job-success-success).',\n  }),\n  outputs: nonEmptyRecordSchema(z.string().min(1)).optional().meta({\n    description: 'Named job outputs mapped from step values.',\n  }),\n  execution_timeout: z.string().min(1).optional().meta({\n    description: 'Maximum duration for one job execution.',\n  }),\n  checkout: workflowDocumentCheckoutSchema.optional().meta({\n    description: 'Checkout settings for repository content and credentials.',\n  }),\n  listening: workflowDocumentListeningSchema.optional().meta({\n    description:\n      'Event-listening configuration for this job. See [listening jobs](/understand/listening-jobs).',\n  }),\n  name: z.string().min(1).optional().meta({description: 'Human-readable job name.'}),\n  env: workflowDocumentEnvSchema.optional().meta({\n    description:\n      'Environment variables for run steps in this job. They do not apply to agent steps. See [secrets and variables](/reference/secrets-variables).',\n  }),\n  steps: z.array(workflowDocumentStepSchema).min(1).meta({\n    description: 'Ordered run or agent steps. Each job needs at least one step.',\n  }),\n});\n\nexport const workflowDocumentSchema = z.strictObject({\n  name: z.string().min(1).meta({description: 'Human-readable workflow name.'}),\n  runner: stringOrStringArraySchema.optional().meta({\n    description:\n      'Default runner label or ordered fallback labels for run jobs. See [runners and execution environments](/understand/runners-and-execution-environments).',\n  }),\n  env: workflowDocumentEnvSchema.optional().meta({\n    description:\n      'Workflow-level environment variables for run steps. They do not apply to agent steps. See [secrets and variables](/reference/secrets-variables).',\n  }),\n  triggers: nonEmptyRecordSchema(workflowDocumentTriggerSchema).optional().meta({\n    description:\n      'Named events that start workflow runs. A workflow can have at most one `manual` trigger.',\n  }),\n  jobs: nonEmptyRecordSchema(workflowDocumentJobSchema).meta({\n    description: 'Named jobs that make up the workflow. At least one job is required.',\n  }),\n});\n\nexport type WorkflowDocument = z.infer<typeof workflowDocumentSchema>;\nexport type WorkflowDocumentJobCheckout = z.infer<typeof workflowDocumentCheckoutSchema>;\nexport type WorkflowDocumentEnv = z.infer<typeof workflowDocumentEnvSchema>;\nexport type WorkflowDocumentJob = z.infer<typeof workflowDocumentJobSchema>;\nexport type WorkflowDocumentJobListening = z.infer<typeof workflowDocumentListeningSchema>;\nexport type WorkflowDocumentRunStepGate = z.infer<typeof workflowDocumentStepGateSchema>;\nexport type WorkflowDocumentStepIntegration = z.infer<typeof workflowDocumentStepIntegrationSchema>;\nexport type WorkflowDocumentStepOutputType = (typeof workflowDocumentStepOutputTypes)[number];\nexport type WorkflowDocumentStepOutputs = z.infer<typeof workflowDocumentStepOutputsSchema>;\nexport type WorkflowDocumentStep = z.infer<typeof workflowDocumentStepSchema>;\nexport type WorkflowDocumentTrigger = z.infer<typeof workflowDocumentTriggerSchema>;\n\nfunction maxJsonDepth(value: unknown): number {\n  if (value === null || typeof value !== 'object') return 0;\n  if (Array.isArray(value)) {\n    if (value.length === 0) return 1;\n    return 1 + Math.max(...value.map(maxJsonDepth));\n  }\n\n  const entries = Object.values(value);\n  if (entries.length === 0) return 1;\n  return 1 + Math.max(...entries.map(maxJsonDepth));\n}\n\nfunction isJsonSchemaDocument(value: unknown): boolean {\n  return (\n    typeof value === 'boolean' ||\n    (typeof value === 'object' && value !== null && !Array.isArray(value))\n  );\n}\n"],"names":["z","agentThinkingSchema","harnessSchema","stringOrStringArraySchema","union","string","min","array","nonEmptyRecordSchema","valueSchema","record","refine","value","Object","keys","length","message","envNameSchema","regex","envStringValueSchema","includes","WORKFLOW_DOCUMENT_ENV_MAX_ENTRIES","WORKFLOW_DOCUMENT_ENV_MAX_SERIALIZED_BYTES","workflowDocumentStepOutputTypes","WORKFLOW_DOCUMENT_STEP_OUTPUTS_MAX_ENTRIES","WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_SERIALIZED_BYTES","WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_DEPTH","utf8Encoder","TextEncoder","workflowDocumentEnvSchema","number","boolean","superRefine","env","ctx","entries","addIssue","code","serializedBytes","encode","JSON","stringify","byteLength","meta","description","workflowDocumentStepOutputKeyPattern","workflowDocumentStepOutputTypeSchema","enum","workflowDocumentStepOutputDeclarationSchema","transform","type","strictObject","schema","unknown","optional","declaration","undefined","path","isJsonSchemaDocument","depth","maxJsonDepth","workflowDocumentStepOutputsSchema","outputs","key","test","workflowDocumentTriggerBaseSchema","source","with","filter","config","triggerSourceConfigSchemas","cron","schedule","timezone","triggerSourceConfigSchemaRegistry","workflowDocumentTriggerSchema","event","trigger","configSchema","configResult","safeParse","success","configIssue","error","issues","workflowDocumentListeningSchema","on","until","timeout","max_executions","int","positive","batch","debounce","max_size","max_wait","on_resolve","listening","field","index","workflowDocumentStepGateSchema","on_failure","restart_from","feedback","workflowDocumentCheckoutSchema","permissions","contents","workflowDocumentStepIntegrationSelectionSchema","workflowDocumentStepIntegrationSchema","connection","include","exclude","allow_write","workflowDocumentAgentStepFields","workflowDocumentStepSchema","if","name","run","model","prompt","harness","thinking","provider","tools","integrations","agent","gate","step","isAgent","some","workflowDocumentJobSchema","needs","runner","execution_timeout","checkout","steps","workflowDocumentSchema","triggers","jobs","Array","isArray","Math","max","map","values"],"mappings":"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"}