@shipfox/workflow-document 3.2.0 → 3.3.1

package/README.md

@@ -158,14 +158,15 @@ parseWorkflowDocument({
   `model`, `harness`, `thinking`, `provider`, `tools`, and `integrations` are
   valid only on an agent step; using them on a run step is rejected. `thinking`
   is validated against a fixed set (`off`, `minimal`, `low`, `medium`, `high`,
-  `xhigh`). Provider, model, tool, integration connection, and integration
+  `xhigh`, `max`). Provider, model, tool, integration connection, and integration
   catalog checks belong to the model layer, not this parser. The `agent` key is
   reserved for a future step kind and is rejected today. The `tool`,
   `connection`, and `with` fields and the expression `outputs` mapping form are
   reserved for the upcoming tool step kind; any step carrying one of these
   fields is rejected with "Tool steps are not available yet." Their shape still parses:
   `with` is a JSON tree of tool inputs limited to 32768 serialized bytes and 16
-  nesting levels, and its `method` key is rejected.
+  nesting levels, and its `method` key is rejected. `tool` and `connection` must
+  be literal names; interpolated values such as `${{ ... }}` are rejected at parse.
 - `env` can be declared on the workflow, a job, or a run step. Values may be
   strings, numbers, or booleans; the model layer stringifies numbers and
   booleans before a run is saved. Values are literal. Expression interpolation

package/dist/document/index.d.ts

@@ -1,6 +1,6 @@
 export { type CheckoutTargetValidationIssue, checkoutTargetValidationIssues, } from './checkout-target-validation.js';
 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_JOB_OUTPUTS_MAX_ENTRIES, WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_DEPTH, WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_SERIALIZED_BYTES, WORKFLOW_DOCUMENT_STEP_OUTPUTS_MAX_ENTRIES, WORKFLOW_DOCUMENT_TOOL_WITH_MAX_DEPTH, WORKFLOW_DOCUMENT_TOOL_WITH_MAX_SERIALIZED_BYTES, type WorkflowDocument, type WorkflowDocumentCheckout, type WorkflowDocumentEnv, type WorkflowDocumentJob, type WorkflowDocumentJobCheckout, type WorkflowDocumentRunStepGate, type WorkflowDocumentStep, type WorkflowDocumentStepIntegration, type WorkflowDocumentStepOutputs, type WorkflowDocumentStepOutputType, type WorkflowDocumentToolStepOutputs, type WorkflowDocumentToolWith, type WorkflowDocumentTrigger, workflowDocumentCheckoutSchema, workflowDocumentEnvSchema, workflowDocumentJobSchema, workflowDocumentSchema, workflowDocumentStepIntegrationSchema, workflowDocumentStepIntegrationSelectionSchema, workflowDocumentStepOutputsSchema, workflowDocumentStepOutputTypes, workflowDocumentStepSchema, workflowDocumentToolStepOutputsSchema, workflowDocumentToolStepWithSchema, workflowDocumentTriggerSchema, } from './workflow-document.js';
+export { isValidWorkflowSessionKeyTemplateLiteralParts, triggerSourceConfigSchemas, WORKFLOW_DOCUMENT_ENV_MAX_ENTRIES, WORKFLOW_DOCUMENT_ENV_MAX_SERIALIZED_BYTES, WORKFLOW_DOCUMENT_JOB_OUTPUTS_MAX_ENTRIES, WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_DEPTH, WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_SERIALIZED_BYTES, WORKFLOW_DOCUMENT_STEP_OUTPUTS_MAX_ENTRIES, WORKFLOW_DOCUMENT_TOOL_WITH_MAX_DEPTH, WORKFLOW_DOCUMENT_TOOL_WITH_MAX_SERIALIZED_BYTES, WORKFLOW_SESSION_KEY_MAX_LENGTH, WORKFLOW_SESSION_KEY_PATTERN, WORKFLOW_SESSION_KEY_PATTERN_SOURCE, type WorkflowDocument, type WorkflowDocumentCheckout, type WorkflowDocumentEnv, type WorkflowDocumentJob, type WorkflowDocumentJobCheckout, type WorkflowDocumentRunStepGate, type WorkflowDocumentStep, type WorkflowDocumentStepIntegration, type WorkflowDocumentStepOutputs, type WorkflowDocumentStepOutputType, type WorkflowDocumentToolStepOutputs, type WorkflowDocumentToolWith, type WorkflowDocumentTrigger, workflowDocumentCheckoutSchema, workflowDocumentEnvSchema, workflowDocumentJobSchema, workflowDocumentSchema, workflowDocumentSessionSchema, workflowDocumentStepIntegrationSchema, workflowDocumentStepIntegrationSelectionSchema, workflowDocumentStepOutputsSchema, workflowDocumentStepOutputTypes, workflowDocumentStepSchema, workflowDocumentToolStepOutputsSchema, workflowDocumentToolStepWithSchema, 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,6BAA6B,EAClC,8BAA8B,GAC/B,MAAM,iCAAiC,CAAC;AACzC,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,yCAAyC,EACzC,8CAA8C,EAC9C,yDAAyD,EACzD,0CAA0C,EAC1C,qCAAqC,EACrC,gDAAgD,EAChD,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,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,+BAA+B,EACpC,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,8BAA8B,EAC9B,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,qCAAqC,EACrC,8CAA8C,EAC9C,iCAAiC,EACjC,+BAA+B,EAC/B,0BAA0B,EAC1B,qCAAqC,EACrC,kCAAkC,EAClC,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/document/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,6BAA6B,EAClC,8BAA8B,GAC/B,MAAM,iCAAiC,CAAC;AACzC,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,6CAA6C,EAC7C,0BAA0B,EAC1B,iCAAiC,EACjC,0CAA0C,EAC1C,yCAAyC,EACzC,8CAA8C,EAC9C,yDAAyD,EACzD,0CAA0C,EAC1C,qCAAqC,EACrC,gDAAgD,EAChD,+BAA+B,EAC/B,4BAA4B,EAC5B,mCAAmC,EACnC,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,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,+BAA+B,EACpC,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,8BAA8B,EAC9B,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,6BAA6B,EAC7B,qCAAqC,EACrC,8CAA8C,EAC9C,iCAAiC,EACjC,+BAA+B,EAC/B,0BAA0B,EAC1B,qCAAqC,EACrC,kCAAkC,EAClC,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,6 +1,6 @@
 export { checkoutTargetValidationIssues } from './checkout-target-validation.js';
 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_JOB_OUTPUTS_MAX_ENTRIES, WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_DEPTH, WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_SERIALIZED_BYTES, WORKFLOW_DOCUMENT_STEP_OUTPUTS_MAX_ENTRIES, WORKFLOW_DOCUMENT_TOOL_WITH_MAX_DEPTH, WORKFLOW_DOCUMENT_TOOL_WITH_MAX_SERIALIZED_BYTES, workflowDocumentCheckoutSchema, workflowDocumentEnvSchema, workflowDocumentJobSchema, workflowDocumentSchema, workflowDocumentStepIntegrationSchema, workflowDocumentStepIntegrationSelectionSchema, workflowDocumentStepOutputsSchema, workflowDocumentStepOutputTypes, workflowDocumentStepSchema, workflowDocumentToolStepOutputsSchema, workflowDocumentToolStepWithSchema, workflowDocumentTriggerSchema } from './workflow-document.js';
+export { isValidWorkflowSessionKeyTemplateLiteralParts, triggerSourceConfigSchemas, WORKFLOW_DOCUMENT_ENV_MAX_ENTRIES, WORKFLOW_DOCUMENT_ENV_MAX_SERIALIZED_BYTES, WORKFLOW_DOCUMENT_JOB_OUTPUTS_MAX_ENTRIES, WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_DEPTH, WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_SERIALIZED_BYTES, WORKFLOW_DOCUMENT_STEP_OUTPUTS_MAX_ENTRIES, WORKFLOW_DOCUMENT_TOOL_WITH_MAX_DEPTH, WORKFLOW_DOCUMENT_TOOL_WITH_MAX_SERIALIZED_BYTES, WORKFLOW_SESSION_KEY_MAX_LENGTH, WORKFLOW_SESSION_KEY_PATTERN, WORKFLOW_SESSION_KEY_PATTERN_SOURCE, workflowDocumentCheckoutSchema, workflowDocumentEnvSchema, workflowDocumentJobSchema, workflowDocumentSchema, workflowDocumentSessionSchema, workflowDocumentStepIntegrationSchema, workflowDocumentStepIntegrationSelectionSchema, workflowDocumentStepOutputsSchema, workflowDocumentStepOutputTypes, workflowDocumentStepSchema, workflowDocumentToolStepOutputsSchema, workflowDocumentToolStepWithSchema, workflowDocumentTriggerSchema } from './workflow-document.js';
 export { InvalidWorkflowDocumentError, invalidWorkflowDocumentErrorCode, parseWorkflowDocument } from './workflow-document-parser.js';
 export { buildWorkflowJsonSchema } from './workflow-json-schema.js';
 

package/dist/document/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/document/index.ts"],"sourcesContent":["export {\n  type CheckoutTargetValidationIssue,\n  checkoutTargetValidationIssues,\n} from './checkout-target-validation.js';\nexport {\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_JOB_OUTPUTS_MAX_ENTRIES,\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  WORKFLOW_DOCUMENT_TOOL_WITH_MAX_DEPTH,\n  WORKFLOW_DOCUMENT_TOOL_WITH_MAX_SERIALIZED_BYTES,\n  type WorkflowDocument,\n  type WorkflowDocumentCheckout,\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 WorkflowDocumentToolStepOutputs,\n  type WorkflowDocumentToolWith,\n  type WorkflowDocumentTrigger,\n  workflowDocumentCheckoutSchema,\n  workflowDocumentEnvSchema,\n  workflowDocumentJobSchema,\n  workflowDocumentSchema,\n  workflowDocumentStepIntegrationSchema,\n  workflowDocumentStepIntegrationSelectionSchema,\n  workflowDocumentStepOutputsSchema,\n  workflowDocumentStepOutputTypes,\n  workflowDocumentStepSchema,\n  workflowDocumentToolStepOutputsSchema,\n  workflowDocumentToolStepWithSchema,\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":["checkoutTargetValidationIssues","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_JOB_OUTPUTS_MAX_ENTRIES","WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_DEPTH","WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_SERIALIZED_BYTES","WORKFLOW_DOCUMENT_STEP_OUTPUTS_MAX_ENTRIES","WORKFLOW_DOCUMENT_TOOL_WITH_MAX_DEPTH","WORKFLOW_DOCUMENT_TOOL_WITH_MAX_SERIALIZED_BYTES","workflowDocumentCheckoutSchema","workflowDocumentEnvSchema","workflowDocumentJobSchema","workflowDocumentSchema","workflowDocumentStepIntegrationSchema","workflowDocumentStepIntegrationSelectionSchema","workflowDocumentStepOutputsSchema","workflowDocumentStepOutputTypes","workflowDocumentStepSchema","workflowDocumentToolStepOutputsSchema","workflowDocumentToolStepWithSchema","workflowDocumentTriggerSchema","InvalidWorkflowDocumentError","invalidWorkflowDocumentErrorCode","parseWorkflowDocument","buildWorkflowJsonSchema"],"mappings":"AAAA,SAEEA,8BAA8B,QACzB,kCAAkC;AACzC,SAEEC,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,yCAAyC,EACzCC,8CAA8C,EAC9CC,yDAAyD,EACzDC,0CAA0C,EAC1CC,qCAAqC,EACrCC,gDAAgD,EAchDC,8BAA8B,EAC9BC,yBAAyB,EACzBC,yBAAyB,EACzBC,sBAAsB,EACtBC,qCAAqC,EACrCC,8CAA8C,EAC9CC,iCAAiC,EACjCC,+BAA+B,EAC/BC,0BAA0B,EAC1BC,qCAAqC,EACrCC,kCAAkC,EAClCC,6BAA6B,QACxB,yBAAyB;AAChC,SACEC,4BAA4B,EAC5BC,gCAAgC,EAChCC,qBAAqB,QAChB,gCAAgC;AACvC,SAEEC,uBAAuB,QAClB,4BAA4B"}
+{"version":3,"sources":["../../src/document/index.ts"],"sourcesContent":["export {\n  type CheckoutTargetValidationIssue,\n  checkoutTargetValidationIssues,\n} from './checkout-target-validation.js';\nexport {\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  isValidWorkflowSessionKeyTemplateLiteralParts,\n  triggerSourceConfigSchemas,\n  WORKFLOW_DOCUMENT_ENV_MAX_ENTRIES,\n  WORKFLOW_DOCUMENT_ENV_MAX_SERIALIZED_BYTES,\n  WORKFLOW_DOCUMENT_JOB_OUTPUTS_MAX_ENTRIES,\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  WORKFLOW_DOCUMENT_TOOL_WITH_MAX_DEPTH,\n  WORKFLOW_DOCUMENT_TOOL_WITH_MAX_SERIALIZED_BYTES,\n  WORKFLOW_SESSION_KEY_MAX_LENGTH,\n  WORKFLOW_SESSION_KEY_PATTERN,\n  WORKFLOW_SESSION_KEY_PATTERN_SOURCE,\n  type WorkflowDocument,\n  type WorkflowDocumentCheckout,\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 WorkflowDocumentToolStepOutputs,\n  type WorkflowDocumentToolWith,\n  type WorkflowDocumentTrigger,\n  workflowDocumentCheckoutSchema,\n  workflowDocumentEnvSchema,\n  workflowDocumentJobSchema,\n  workflowDocumentSchema,\n  workflowDocumentSessionSchema,\n  workflowDocumentStepIntegrationSchema,\n  workflowDocumentStepIntegrationSelectionSchema,\n  workflowDocumentStepOutputsSchema,\n  workflowDocumentStepOutputTypes,\n  workflowDocumentStepSchema,\n  workflowDocumentToolStepOutputsSchema,\n  workflowDocumentToolStepWithSchema,\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":["checkoutTargetValidationIssues","agentThinkingByHarness","agentThinkingSchema","claudeAgentThinkingSchema","DEFAULT_AGENT_THINKING","DEFAULT_HARNESS","DEFAULT_MODEL_PROVIDER","harnessSchema","piAgentThinkingSchema","thinkingLevelsForHarness","isValidWorkflowSessionKeyTemplateLiteralParts","triggerSourceConfigSchemas","WORKFLOW_DOCUMENT_ENV_MAX_ENTRIES","WORKFLOW_DOCUMENT_ENV_MAX_SERIALIZED_BYTES","WORKFLOW_DOCUMENT_JOB_OUTPUTS_MAX_ENTRIES","WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_DEPTH","WORKFLOW_DOCUMENT_STEP_OUTPUT_SCHEMA_MAX_SERIALIZED_BYTES","WORKFLOW_DOCUMENT_STEP_OUTPUTS_MAX_ENTRIES","WORKFLOW_DOCUMENT_TOOL_WITH_MAX_DEPTH","WORKFLOW_DOCUMENT_TOOL_WITH_MAX_SERIALIZED_BYTES","WORKFLOW_SESSION_KEY_MAX_LENGTH","WORKFLOW_SESSION_KEY_PATTERN","WORKFLOW_SESSION_KEY_PATTERN_SOURCE","workflowDocumentCheckoutSchema","workflowDocumentEnvSchema","workflowDocumentJobSchema","workflowDocumentSchema","workflowDocumentSessionSchema","workflowDocumentStepIntegrationSchema","workflowDocumentStepIntegrationSelectionSchema","workflowDocumentStepOutputsSchema","workflowDocumentStepOutputTypes","workflowDocumentStepSchema","workflowDocumentToolStepOutputsSchema","workflowDocumentToolStepWithSchema","workflowDocumentTriggerSchema","InvalidWorkflowDocumentError","invalidWorkflowDocumentErrorCode","parseWorkflowDocument","buildWorkflowJsonSchema"],"mappings":"AAAA,SAEEA,8BAA8B,QACzB,kCAAkC;AACzC,SAEEC,sBAAsB,EACtBC,mBAAmB,EACnBC,yBAAyB,EACzBC,sBAAsB,EACtBC,eAAe,EACfC,sBAAsB,EAEtBC,aAAa,EACbC,qBAAqB,EACrBC,wBAAwB,QACnB,kBAAkB;AACzB,SACEC,6CAA6C,EAC7CC,0BAA0B,EAC1BC,iCAAiC,EACjCC,0CAA0C,EAC1CC,yCAAyC,EACzCC,8CAA8C,EAC9CC,yDAAyD,EACzDC,0CAA0C,EAC1CC,qCAAqC,EACrCC,gDAAgD,EAChDC,+BAA+B,EAC/BC,4BAA4B,EAC5BC,mCAAmC,EAcnCC,8BAA8B,EAC9BC,yBAAyB,EACzBC,yBAAyB,EACzBC,sBAAsB,EACtBC,6BAA6B,EAC7BC,qCAAqC,EACrCC,8CAA8C,EAC9CC,iCAAiC,EACjCC,+BAA+B,EAC/BC,0BAA0B,EAC1BC,qCAAqC,EACrCC,kCAAkC,EAClCC,6BAA6B,QACxB,yBAAyB;AAChC,SACEC,4BAA4B,EAC5BC,gCAAgC,EAChCC,qBAAqB,QAChB,gCAAgC;AACvC,SAEEC,uBAAuB,QAClB,4BAA4B"}

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

@@ -8,6 +8,7 @@ export declare const DEFAULT_HARNESS: "pi";
 export declare const piAgentThinkingSchema: z.ZodEnum<{
     high: "high";
     low: "low";
+    max: "max";
     medium: "medium";
     minimal: "minimal";
     off: "off";
@@ -35,6 +36,7 @@ export declare const agentThinkingByHarness: {
     readonly pi: z.ZodEnum<{
         high: "high";
         low: "low";
+        max: "max";
         medium: "medium";
         minimal: "minimal";
         off: "off";

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;;;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"}
+{"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;;;;;;;;EAQhC,CAAC;AACH,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

@@ -12,7 +12,8 @@ export const piAgentThinkingSchema = z.enum([
     'low',
     'medium',
     'high',
-    'xhigh'
+    'xhigh',
+    'max'
 ]);
 export const claudeAgentThinkingSchema = z.enum([
     'low',

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']).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"}
+{"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([\n  'off',\n  'minimal',\n  'low',\n  'medium',\n  'high',\n  'xhigh',\n  'max',\n]);\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;IAC1C;IACA;IACA;IACA;IACA;IACA;IACA;CACD,EAAE;AACH,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

@@ -1,6 +1,9 @@
 import { z } from 'zod';
 export declare const WORKFLOW_LITERAL_NAME_PATTERN: RegExp;
 export declare const WORKFLOW_INTERPOLATED_VALUE_PATTERN: RegExp;
+export declare const WORKFLOW_SESSION_KEY_MAX_LENGTH = 128;
+export declare const WORKFLOW_SESSION_KEY_PATTERN_SOURCE = "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$";
+export declare const WORKFLOW_SESSION_KEY_PATTERN: RegExp;
 export declare const agentThinkingFieldSchema: z.ZodUnion<readonly [z.ZodEnum<{
     high: "high";
     low: "low";
@@ -136,7 +139,15 @@ 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 workflowDocumentSessionSchema: z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodObject<{
+    key: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        fork: "fork";
+        resume: "resume";
+    }>>;
+}, z.core.$strict>]>;
+export declare function isValidWorkflowSessionKeyTemplateLiteralParts(source: string): boolean;
+export declare const workflowDocumentAgentStepFields: readonly ['model', 'prompt', 'harness', 'thinking', 'provider', 'tools', 'integrations', 'session'];
 declare const workflowDocumentStepBaseSchema: z.ZodObject<{
     key: z.ZodOptional<z.ZodString>;
     if: z.ZodOptional<z.ZodString>;
@@ -174,6 +185,13 @@ declare const workflowDocumentStepBaseSchema: z.ZodObject<{
         off: "off";
         xhigh: "xhigh";
     }>, z.ZodString]>>;
+    session: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodObject<{
+        key: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+        mode: z.ZodOptional<z.ZodEnum<{
+            fork: "fork";
+            resume: "resume";
+        }>>;
+    }, z.core.$strict>]>>;
     provider: z.ZodOptional<z.ZodString>;
     tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
     integrations: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -251,6 +269,13 @@ export declare const workflowDocumentStepSchema: z.ZodPipe<z.ZodObject<{
         off: "off";
         xhigh: "xhigh";
     }>, z.ZodString]>>;
+    session: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodObject<{
+        key: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+        mode: z.ZodOptional<z.ZodEnum<{
+            fork: "fork";
+            resume: "resume";
+        }>>;
+    }, z.core.$strict>]>>;
     provider: z.ZodOptional<z.ZodString>;
     tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
     integrations: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -310,6 +335,10 @@ export declare const workflowDocumentStepSchema: z.ZodPipe<z.ZodObject<{
     prompt?: string | undefined;
     harness?: "claude" | "pi" | undefined;
     thinking?: string | undefined;
+    session?: string | {
+        key: string;
+        mode?: "fork" | "resume" | undefined;
+    } | undefined;
     provider?: string | undefined;
     tools?: string[] | undefined;
     integrations?: {
@@ -420,6 +449,13 @@ export declare const workflowDocumentJobSchema: z.ZodObject<{
             off: "off";
             xhigh: "xhigh";
         }>, z.ZodString]>>;
+        session: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodObject<{
+            key: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+            mode: z.ZodOptional<z.ZodEnum<{
+                fork: "fork";
+                resume: "resume";
+            }>>;
+        }, z.core.$strict>]>>;
         provider: z.ZodOptional<z.ZodString>;
         tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
         integrations: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -479,6 +515,10 @@ export declare const workflowDocumentJobSchema: z.ZodObject<{
         prompt?: string | undefined;
         harness?: "claude" | "pi" | undefined;
         thinking?: string | undefined;
+        session?: string | {
+            key: string;
+            mode?: "fork" | "resume" | undefined;
+        } | undefined;
         provider?: string | undefined;
         tools?: string[] | undefined;
         integrations?: {
@@ -602,6 +642,13 @@ export declare const workflowDocumentSchema: z.ZodObject<{
                 off: "off";
                 xhigh: "xhigh";
             }>, z.ZodString]>>;
+            session: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodObject<{
+                key: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+                mode: z.ZodOptional<z.ZodEnum<{
+                    fork: "fork";
+                    resume: "resume";
+                }>>;
+            }, z.core.$strict>]>>;
             provider: z.ZodOptional<z.ZodString>;
             tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
             integrations: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -661,6 +708,10 @@ export declare const workflowDocumentSchema: z.ZodObject<{
             prompt?: string | undefined;
             harness?: "claude" | "pi" | undefined;
             thinking?: string | undefined;
+            session?: string | {
+                key: string;
+                mode?: "fork" | "resume" | undefined;
+            } | undefined;
             provider?: string | undefined;
             tools?: string[] | undefined;
             integrations?: {
@@ -703,6 +754,7 @@ export type WorkflowDocumentStepOutputType = (typeof workflowDocumentStepOutputT
 export type WorkflowDocumentStepOutputs = z.infer<typeof workflowDocumentStepOutputsSchema>;
 export type WorkflowDocumentToolStepOutputs = z.infer<typeof workflowDocumentToolStepOutputsSchema>;
 export type WorkflowDocumentToolWith = z.infer<typeof workflowDocumentToolStepWithSchema>;
+export type WorkflowDocumentSession = z.infer<typeof workflowDocumentSessionSchema>;
 export type WorkflowDocumentTrigger = z.infer<typeof workflowDocumentTriggerSchema>;
 export {};
 //# sourceMappingURL=workflow-document.d.ts.map

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;AAUtB,eAAO,MAAM,6BAA6B,QAAoC,CAAC;AAG/E,eAAO,MAAM,mCAAmC,QAAyC,CAAC;AAK1F,eAAO,MAAM,wBAAwB;;;;;;;;iBAajC,CAAC;AAmBL,eAAO,MAAM,iCAAiC,MAAM,CAAC;AACrD,eAAO,MAAM,0CAA0C,QAAY,CAAC;AACpE,eAAO,MAAM,+BAA+B,YAAI,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAU,CAAC;AAChG,eAAO,MAAM,yCAAyC,MAAoC,CAAC;AAC3F,eAAO,MAAM,0CAA0C,MAAoC,CAAC;AAC5F,eAAO,MAAM,yDAAyD,QAC1B,CAAC;AAC7C,eAAO,MAAM,8CAA8C,KAAK,CAAC;AACjE,eAAO,MAAM,gDAAgD,QAAY,CAAC;AAC1E,eAAO,MAAM,qCAAqC,KAAK,CAAC;AAIxD,eAAO,MAAM,yBAAyB,yFAqBlC,CAAC;AAML,KAAK,yBAAyB,GAC1B,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,yBAAyB,EAAE,GAC3B;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,yBAAyB,CAAA;CAAC,CAAC;AAE/C,eAAO,MAAM,kCAAkC,uIA0B3C,CAAC;AAwJL,eAAO,MAAM,2CAA2C;;;;;;;;;;;;;;;oBAkEpD,CAAC;AA2BL,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;qBAK1C,CAAC;AAKL,eAAO,MAAM,qCAAqC,uCAO9C,CAAC;AAmCL,eAAO,MAAM,0BAA0B;;;;;CASF,CAAC;AAItC,eAAO,MAAM,6BAA6B;;;;;;kBA8BtC,CAAC;AAEL,QAAA,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;kBAyDjC,CAAC;AAEL,QAAA,MAAM,8BAA8B;;;;;;kBAwBhC,CAAC;AAiBL,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;kBAwCvC,CAAC;AAEL,QAAA,MAAM,iCAAiC;;;;;;;;yCAWnC,CAAC;AAEL,eAAO,MAAM,8CAA8C,yBAAoC,CAAC;AAEhG,eAAO,MAAM,qCAAqC;;;;;kBAahD,CAAC;AAEH,eAAO,MAAM,+BAA+B,YAC1C,OAAO,EACP,QAAQ,EACR,SAAS,EACT,UAAU,EACV,UAAU,EACV,OAAO,EACP,cAAc,CACN,CAAC;AAYX,QAAA,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAuElC,CAAC;AAEH,KAAK,gCAAgC,GAAG,IAAI,CAC1C,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,EAC9C,SAAS,CACV,GAAG;IACF,OAAO,CAAC,EAAE,2BAA2B,CAAC;CACvC,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiGpC,CAAC;AAcJ,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA2CpC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAoBjC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACtF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAC5F,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,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AACpG,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAC1F,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":"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"}

package/dist/document/workflow-document.js

@@ -12,6 +12,11 @@ export const WORKFLOW_LITERAL_NAME_PATTERN = /^(?:[^$]|\$\$\{\{|\$(?!\{\{))*$/;
 // The inverse of a literal name: a literal prefix followed by an unescaped
 // `${{`. An enum field that also accepts a template matches one or the other.
 export const WORKFLOW_INTERPOLATED_VALUE_PATTERN = /^(?:[^$]|\$\$\{\{|\$(?!\{\{))*\$\{\{/;
+export const WORKFLOW_SESSION_KEY_MAX_LENGTH = 128;
+export const WORKFLOW_SESSION_KEY_PATTERN_SOURCE = '^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$';
+export const WORKFLOW_SESSION_KEY_PATTERN = new RegExp(WORKFLOW_SESSION_KEY_PATTERN_SOURCE);
+const workflowSessionKeyLiteralPartPattern = /^[A-Za-z0-9._-]*$/;
+const workflowSessionKeyLiteralPartStartPattern = /^[A-Za-z0-9]/;
 // Reasoning effort is an enum so editors can complete it, and a template so a
 // workflow can choose the effort from run context. The resolved value is
 // checked against the harness levels when the step is dispatched.
@@ -563,6 +568,115 @@ export const workflowDocumentStepIntegrationSchema = z.strictObject({
         description: 'Allows write-capable integration tools. Omit or set false for read-only access.'
     })
 });
+// A session names an agent conversation that continues across steps of one run.
+// The shorthand string form names the session and resumes it; the long form
+// adds an explicit mode. The key is a field template, evaluated at step
+// dispatch with the same context roots the prompt sees.
+const workflowSessionKeyLiteralSchema = z.string().min(1).max(WORKFLOW_SESSION_KEY_MAX_LENGTH).regex(WORKFLOW_SESSION_KEY_PATTERN, {
+    message: 'Literal session keys must start with a letter or number and contain only letters, numbers, dots, underscores, or hyphens.'
+});
+const workflowSessionKeyTemplateSchema = z.string().min(1).regex(WORKFLOW_INTERPOLATED_VALUE_PATTERN, {
+    message: 'Session keys with interpolation must use a $' + '{{ }} template.'
+}).refine(isValidWorkflowSessionKeyTemplateLiteralParts, {
+    message: 'Literal parts of interpolated session keys may contain only letters, numbers, dots, underscores, or hyphens, and may not exceed 128 characters in total.'
+});
+const workflowSessionKeySchema = z.union([
+    workflowSessionKeyLiteralSchema,
+    workflowSessionKeyTemplateSchema
+]);
+export const workflowDocumentSessionSchema = z.union([
+    workflowSessionKeyLiteralSchema,
+    workflowSessionKeyTemplateSchema,
+    z.strictObject({
+        key: workflowSessionKeySchema.meta({
+            description: 'Session key, or a $' + '{{ }} interpolation that resolves to one.'
+        }),
+        mode: z.enum([
+            'resume',
+            'fork'
+        ]).optional().meta({
+            description: 'Session mode. `resume` continues the session and writes back; `fork` reads a snapshot and never writes. Defaults to `resume`.'
+        })
+    })
+]).meta({
+    description: 'Named agent session continued across steps of one workflow run. A string names the session and resumes it; an object adds the mode.'
+});
+export function isValidWorkflowSessionKeyTemplateLiteralParts(source) {
+    let cursor = 0;
+    let expressionSeen = false;
+    let literalLength = 0;
+    while(true){
+        const opener = source.indexOf('${{', cursor);
+        const literalEnd = opener === -1 ? source.length : opener;
+        const literal = source.slice(cursor, literalEnd);
+        literalLength += literal.length;
+        if (literalLength > WORKFLOW_SESSION_KEY_MAX_LENGTH || !workflowSessionKeyLiteralPartPattern.test(literal) || !expressionSeen && literal.length > 0 && !workflowSessionKeyLiteralPartStartPattern.test(literal)) {
+            return false;
+        }
+        if (opener === -1) return expressionSeen;
+        const close = findWorkflowSessionKeyTemplateClose(source, opener);
+        if (close === -1) return false;
+        expressionSeen = true;
+        cursor = close + 2;
+    }
+}
+function findWorkflowSessionKeyTemplateClose(source, openerIndex) {
+    let index = openerIndex + 3;
+    let depth = 0;
+    while(index < source.length){
+        const stringEnd = scanWorkflowSessionKeyStringLiteral(source, index);
+        if (stringEnd !== null) {
+            index = stringEnd;
+            continue;
+        }
+        if (source.startsWith('//', index)) {
+            const newline = source.indexOf('\n', index + 2);
+            index = newline === -1 ? source.length : newline;
+            continue;
+        }
+        if (depth === 0 && source.startsWith('}}', index)) return index;
+        const char = source[index];
+        if (char === '(' || char === '[' || char === '{') {
+            depth += 1;
+        } else if ((char === ')' || char === ']' || char === '}') && depth > 0) {
+            depth -= 1;
+        }
+        index += 1;
+    }
+    return -1;
+}
+function scanWorkflowSessionKeyStringLiteral(source, index) {
+    for (const prefix of [
+        'r',
+        'R',
+        'b',
+        'B',
+        ''
+    ]){
+        if (!source.startsWith(prefix, index)) continue;
+        const quoteIndex = index + prefix.length;
+        const quote = source[quoteIndex];
+        if (quote !== '"' && quote !== "'") continue;
+        const tripleQuote = quote.repeat(3);
+        if (source.startsWith(tripleQuote, quoteIndex)) {
+            return scanWorkflowSessionKeyQuotedString(source, quoteIndex + 3, tripleQuote, prefix === 'r' || prefix === 'R');
+        }
+        return scanWorkflowSessionKeyQuotedString(source, quoteIndex + 1, quote, prefix === 'r' || prefix === 'R');
+    }
+    return null;
+}
+function scanWorkflowSessionKeyQuotedString(source, startIndex, delimiter, raw) {
+    let index = startIndex;
+    while(index < source.length){
+        if (!raw && source[index] === '\\') {
+            index += 2;
+            continue;
+        }
+        if (source.startsWith(delimiter, index)) return index + delimiter.length;
+        index += 1;
+    }
+    return source.length;
+}
 export const workflowDocumentAgentStepFields = [
     'model',
     'prompt',
@@ -570,7 +684,8 @@ export const workflowDocumentAgentStepFields = [
     'thinking',
     'provider',
     'tools',
-    'integrations'
+    'integrations',
+    'session'
 ];
 // A step is a run step (`run`), an inline agent step (`prompt`), or a checkout
 // step (`checkout`), never two kinds at once. They share one strict object so
@@ -611,6 +726,7 @@ const workflowDocumentStepBaseSchema = z.strictObject({
         description: 'Agent harness. When omitted, Shipfox uses the workspace default harness, or `pi` when none is configured.'
     }),
     thinking: agentThinkingFieldSchema.optional(),
+    session: workflowDocumentSessionSchema.optional(),
     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.'
     }),
@@ -623,10 +739,10 @@ const workflowDocumentStepBaseSchema = z.strictObject({
     agent: z.unknown().optional().meta({
         description: 'Reserved keyword. It is rejected; use `prompt` to define an agent step.'
     }),
-    tool: z.string().min(1).optional().meta({
+    tool: literalNameSchema('Tool id must be literal. Interpolation is rejected.').optional().meta({
         description: 'Literal integration tool id for a tool step. It is rejected; tool steps are not available yet.'
     }),
-    connection: z.string().min(1).optional().meta({
+    connection: literalNameSchema('Connection slug must be literal. Interpolation is rejected.').optional().meta({
         description: 'Literal integration connection slug for a tool step. It is rejected; tool steps are not available yet.'
     }),
     with: workflowDocumentToolStepWithSchema.optional(),
@@ -652,6 +768,13 @@ export const workflowDocumentStepSchema = workflowDocumentStepBaseSchema.superRe
         return;
     }
     const reservedToolField = step.tool !== undefined ? 'tool' : step.connection !== undefined ? 'connection' : undefined;
+    const reservedToolValue = reservedToolField === 'tool' ? step.tool : reservedToolField === 'connection' ? step.connection : undefined;
+    if (reservedToolValue !== undefined && !WORKFLOW_LITERAL_NAME_PATTERN.test(reservedToolValue)) {
+        // The field-level literal-name check already rejected the interpolated
+        // value; skip the reserved-field issue so one defect does not report
+        // twice at the same path.
+        return;
+    }
     if (reservedToolField !== undefined || step.with !== undefined) {
         ctx.addIssue({
             code: 'custom',