@shipfox/api-workflows 2.0.0

package/dist/core/step-config/index.d.ts

@@ -0,0 +1,8 @@
+export { type AssembleExecutionCreationContextParams, type AssembleJobActivationContextParams, type AssembleWorkflowRunContextParams, applyListenerFilterSnapshots, assembleCreationContext, assembleExecutionCreationContext, assembleExecutionResolutionContext, assembleExecutionsContext, assembleGateContext, assembleJobActivationContext, assembleJobResolutionContext, assembleListenerSnapshotContext, assembleStepDispatchContext, assembleWorkflowRunContext, type JobContextInput, type ListenerSnapshotPlan, type ListenerTriggerWithSnapshot, type MatcherSnapshotPlan, planListenerFilterSnapshots, } from './assemble-run-context.js';
+export { completeStepDispatchConfig } from './complete-step-dispatch-config.js';
+export { type MaterializedWorkflowStep, type MaterializeJobExecutionStepsParams, materializeJobExecutionSteps, } from './materialize-job-execution-steps.js';
+export { type MaterializedWorkflowJob, type MaterializeWorkflowModelParams, materializeJobOutputs, materializeJobRunner, materializeWorkflowModel, modelHasAgentStep, } from './materialize-workflow-model.js';
+export { type ResolveJobExecutionNameParams, resolveJobExecutionName, } from './resolve-job-execution-name.js';
+export type { WorkflowStepTemplateDiagnostic } from './resolve-step-config.js';
+export type { WorkflowEvaluationContext } from './workflow-evaluation-context.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/step-config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/step-config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,sCAAsC,EAC3C,KAAK,kCAAkC,EACvC,KAAK,gCAAgC,EACrC,4BAA4B,EAC5B,uBAAuB,EACvB,gCAAgC,EAChC,kCAAkC,EAClC,yBAAyB,EACzB,mBAAmB,EACnB,4BAA4B,EAC5B,4BAA4B,EAC5B,+BAA+B,EAC/B,2BAA2B,EAC3B,0BAA0B,EAC1B,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,KAAK,mBAAmB,EACxB,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAC,0BAA0B,EAAC,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,kCAAkC,EACvC,4BAA4B,GAC7B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EACnC,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,KAAK,6BAA6B,EAClC,uBAAuB,GACxB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAC,8BAA8B,EAAC,MAAM,0BAA0B,CAAC;AAC7E,YAAY,EAAC,yBAAyB,EAAC,MAAM,kCAAkC,CAAC"}

package/dist/core/step-config/index.js

@@ -0,0 +1,7 @@
+export { applyListenerFilterSnapshots, assembleCreationContext, assembleExecutionCreationContext, assembleExecutionResolutionContext, assembleExecutionsContext, assembleGateContext, assembleJobActivationContext, assembleJobResolutionContext, assembleListenerSnapshotContext, assembleStepDispatchContext, assembleWorkflowRunContext, planListenerFilterSnapshots } from './assemble-run-context.js';
+export { completeStepDispatchConfig } from './complete-step-dispatch-config.js';
+export { materializeJobExecutionSteps } from './materialize-job-execution-steps.js';
+export { materializeJobOutputs, materializeJobRunner, materializeWorkflowModel, modelHasAgentStep } from './materialize-workflow-model.js';
+export { resolveJobExecutionName } from './resolve-job-execution-name.js';
+
+//# sourceMappingURL=index.js.map

package/dist/core/step-config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/step-config/index.ts"],"sourcesContent":["export {\n  type AssembleExecutionCreationContextParams,\n  type AssembleJobActivationContextParams,\n  type AssembleWorkflowRunContextParams,\n  applyListenerFilterSnapshots,\n  assembleCreationContext,\n  assembleExecutionCreationContext,\n  assembleExecutionResolutionContext,\n  assembleExecutionsContext,\n  assembleGateContext,\n  assembleJobActivationContext,\n  assembleJobResolutionContext,\n  assembleListenerSnapshotContext,\n  assembleStepDispatchContext,\n  assembleWorkflowRunContext,\n  type JobContextInput,\n  type ListenerSnapshotPlan,\n  type ListenerTriggerWithSnapshot,\n  type MatcherSnapshotPlan,\n  planListenerFilterSnapshots,\n} from './assemble-run-context.js';\nexport {completeStepDispatchConfig} from './complete-step-dispatch-config.js';\nexport {\n  type MaterializedWorkflowStep,\n  type MaterializeJobExecutionStepsParams,\n  materializeJobExecutionSteps,\n} from './materialize-job-execution-steps.js';\nexport {\n  type MaterializedWorkflowJob,\n  type MaterializeWorkflowModelParams,\n  materializeJobOutputs,\n  materializeJobRunner,\n  materializeWorkflowModel,\n  modelHasAgentStep,\n} from './materialize-workflow-model.js';\nexport {\n  type ResolveJobExecutionNameParams,\n  resolveJobExecutionName,\n} from './resolve-job-execution-name.js';\nexport type {WorkflowStepTemplateDiagnostic} from './resolve-step-config.js';\nexport type {WorkflowEvaluationContext} from './workflow-evaluation-context.js';\n"],"names":["applyListenerFilterSnapshots","assembleCreationContext","assembleExecutionCreationContext","assembleExecutionResolutionContext","assembleExecutionsContext","assembleGateContext","assembleJobActivationContext","assembleJobResolutionContext","assembleListenerSnapshotContext","assembleStepDispatchContext","assembleWorkflowRunContext","planListenerFilterSnapshots","completeStepDispatchConfig","materializeJobExecutionSteps","materializeJobOutputs","materializeJobRunner","materializeWorkflowModel","modelHasAgentStep","resolveJobExecutionName"],"mappings":"AAAA,SAIEA,4BAA4B,EAC5BC,uBAAuB,EACvBC,gCAAgC,EAChCC,kCAAkC,EAClCC,yBAAyB,EACzBC,mBAAmB,EACnBC,4BAA4B,EAC5BC,4BAA4B,EAC5BC,+BAA+B,EAC/BC,2BAA2B,EAC3BC,0BAA0B,EAK1BC,2BAA2B,QACtB,4BAA4B;AACnC,SAAQC,0BAA0B,QAAO,qCAAqC;AAC9E,SAGEC,4BAA4B,QACvB,uCAAuC;AAC9C,SAGEC,qBAAqB,EACrBC,oBAAoB,EACpBC,wBAAwB,EACxBC,iBAAiB,QACZ,kCAAkC;AACzC,SAEEC,uBAAuB,QAClB,kCAAkC"}

package/dist/core/step-config/materialize-job-execution-steps.d.ts

@@ -0,0 +1,35 @@
+import { type AgentDefaultsResolver } from '@shipfox/api-agent/core/resolve-agent-config';
+import type { WorkflowModel } from '@shipfox/api-definitions';
+import type { WorkflowExpression } from '@shipfox/expression';
+import type { AgentToolMaterializationContext, AgentToolMaterializationSnapshot } from '#core/agent-tools.js';
+import type { StepConfigDispatchPlan } from '#core/entities/step.js';
+import { type WorkflowStepTemplateDiagnostic } from './resolve-step-config.js';
+import type { WorkflowEvaluationContext } from './workflow-evaluation-context.js';
+type WorkflowModelJob = WorkflowModel['jobs'][number];
+type WorkflowModelStep = WorkflowModelJob['steps'][number];
+type WorkflowSourceLocation = NonNullable<WorkflowModelStep['sourceLocation']>;
+export interface MaterializedWorkflowStep {
+    readonly key: string | null;
+    readonly name: string;
+    readonly sourceLocation: WorkflowSourceLocation | null;
+    readonly status: 'pending';
+    readonly type: WorkflowModelStep['kind'] | 'setup';
+    readonly config: Readonly<Record<string, unknown>>;
+    readonly condition?: WorkflowExpression;
+    readonly configPlan?: StepConfigDispatchPlan;
+    readonly authoredConfig: Readonly<Record<string, unknown>> | null;
+    readonly diagnostics?: readonly WorkflowStepTemplateDiagnostic[];
+    readonly position: number;
+}
+export interface MaterializeJobExecutionStepsParams {
+    readonly model: WorkflowModel;
+    readonly job: WorkflowModelJob;
+    readonly context: WorkflowEvaluationContext;
+    readonly resolveAgentDefaults?: AgentDefaultsResolver | undefined;
+    readonly definitionId?: string | undefined;
+    readonly agentToolContext?: AgentToolMaterializationContext | undefined;
+    readonly agentToolSnapshot?: AgentToolMaterializationSnapshot | null | undefined;
+}
+export declare function materializeJobExecutionSteps(params: MaterializeJobExecutionStepsParams): readonly MaterializedWorkflowStep[];
+export {};
+//# sourceMappingURL=materialize-job-execution-steps.d.ts.map

package/dist/core/step-config/materialize-job-execution-steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize-job-execution-steps.d.ts","sourceRoot":"","sources":["../../../src/core/step-config/materialize-job-execution-steps.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,qBAAqB,EAE3B,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EACV,+BAA+B,EAC/B,gCAAgC,EACjC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAoB,KAAK,8BAA8B,EAAC,MAAM,0BAA0B,CAAC;AAChG,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,kCAAkC,CAAC;AAEhF,KAAK,gBAAgB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AACtD,KAAK,iBAAiB,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAC3D,KAAK,sBAAsB,GAAG,WAAW,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAI/E,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACvD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,sBAAsB,CAAC;IAC7C,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAClE,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,8BAA8B,EAAE,CAAC;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;IAC5C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAClE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,+BAA+B,GAAG,SAAS,CAAC;IACxE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,gCAAgC,GAAG,IAAI,GAAG,SAAS,CAAC;CAClF;AAiBD,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,kCAAkC,GACzC,SAAS,wBAAwB,EAAE,CA6CrC"}

package/dist/core/step-config/materialize-job-execution-steps.js

@@ -0,0 +1,92 @@
+import { catalogDefaultAgentResolver } from '@shipfox/api-agent/core/resolve-agent-config';
+import { resolveStepConfig } from './resolve-step-config.js';
+const FIRST_LINE_PATTERN = /\r?\n/;
+// Synthetic "Set up job" step prepended when a job execution's steps are materialized.
+// The runner prepares the workspace here; failures report through the normal step
+// protocol instead of hanging the job until the lease/timeout fires. Its config is
+// credential-free.
+const SETUP_STEP = {
+    key: null,
+    name: 'Set up job',
+    sourceLocation: null,
+    status: 'pending',
+    type: 'setup',
+    config: {},
+    authoredConfig: null,
+    position: 0
+};
+export function materializeJobExecutionSteps(params) {
+    const { model, job, context, resolveAgentDefaults = catalogDefaultAgentResolver, definitionId = model.name, agentToolContext, agentToolSnapshot } = params;
+    return [
+        SETUP_STEP,
+        ...job.steps.map((step, stepPosition)=>{
+            // The trusted context exposes the stable job key; the authored display field remains `job.name`.
+            const stepContext = {
+                ...context.values,
+                job: {
+                    key: job.key
+                }
+            };
+            const resolved = resolveStepConfig({
+                jobKey: job.key,
+                step,
+                workflowEnv: model.env,
+                workflowEnvTemplates: model.templates?.env,
+                jobEnv: job.env,
+                jobEnvTemplates: job.templates?.env,
+                context: stepContext,
+                site: context.site,
+                resolveAgentDefaults,
+                definitionId,
+                agentToolContext,
+                agentToolSnapshot
+            });
+            return {
+                key: step.key ?? null,
+                name: resolved.name ?? stepDisplayName(step),
+                sourceLocation: step.sourceLocation ?? null,
+                status: 'pending',
+                type: step.kind,
+                config: resolved.config,
+                ...step.if === undefined ? {} : {
+                    condition: step.if
+                },
+                authoredConfig: resolved.authoredConfig,
+                ...materializedConfigPlan(resolved.configPlan, resolved.trace),
+                ...resolved.diagnostics.length === 0 ? {} : {
+                    diagnostics: resolved.diagnostics
+                },
+                position: stepPosition + 1
+            };
+        })
+    ];
+}
+function materializedConfigPlan(configPlan, trace) {
+    if (configPlan === null && trace.length === 0) return {};
+    return {
+        configPlan: {
+            ...configPlan ?? {},
+            ...trace.length === 0 ? {} : {
+                trace
+            }
+        }
+    };
+}
+function stepDisplayName(step) {
+    switch(step.kind){
+        case 'run':
+            return firstLine(step.command.value);
+        case 'agent':
+            return step.model === undefined ? firstLine(step.prompt) : `${step.model} · ${firstLine(step.prompt)}`;
+        default:
+            return assertNever(step);
+    }
+}
+function firstLine(value) {
+    return value.split(FIRST_LINE_PATTERN, 1)[0]?.trim() || value.trim();
+}
+function assertNever(value) {
+    throw new Error(`Unhandled workflow step kind: ${JSON.stringify(value)}`);
+}
+
+//# sourceMappingURL=materialize-job-execution-steps.js.map

package/dist/core/step-config/materialize-job-execution-steps.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/step-config/materialize-job-execution-steps.ts"],"sourcesContent":["import {\n  type AgentDefaultsResolver,\n  catalogDefaultAgentResolver,\n} from '@shipfox/api-agent/core/resolve-agent-config';\nimport type {WorkflowModel} from '@shipfox/api-definitions';\nimport type {WorkflowExpression} from '@shipfox/expression';\nimport type {\n  AgentToolMaterializationContext,\n  AgentToolMaterializationSnapshot,\n} from '#core/agent-tools.js';\nimport type {StepConfigDispatchPlan} from '#core/entities/step.js';\nimport {resolveStepConfig, type WorkflowStepTemplateDiagnostic} from './resolve-step-config.js';\nimport type {WorkflowEvaluationContext} from './workflow-evaluation-context.js';\n\ntype WorkflowModelJob = WorkflowModel['jobs'][number];\ntype WorkflowModelStep = WorkflowModelJob['steps'][number];\ntype WorkflowSourceLocation = NonNullable<WorkflowModelStep['sourceLocation']>;\n\nconst FIRST_LINE_PATTERN = /\\r?\\n/;\n\nexport interface MaterializedWorkflowStep {\n  readonly key: string | null;\n  readonly name: string;\n  readonly sourceLocation: WorkflowSourceLocation | null;\n  readonly status: 'pending';\n  readonly type: WorkflowModelStep['kind'] | 'setup';\n  readonly config: Readonly<Record<string, unknown>>;\n  readonly condition?: WorkflowExpression;\n  readonly configPlan?: StepConfigDispatchPlan;\n  readonly authoredConfig: Readonly<Record<string, unknown>> | null;\n  readonly diagnostics?: readonly WorkflowStepTemplateDiagnostic[];\n  readonly position: number;\n}\n\nexport interface MaterializeJobExecutionStepsParams {\n  readonly model: WorkflowModel;\n  readonly job: WorkflowModelJob;\n  readonly context: WorkflowEvaluationContext;\n  readonly resolveAgentDefaults?: AgentDefaultsResolver | undefined;\n  readonly definitionId?: string | undefined;\n  readonly agentToolContext?: AgentToolMaterializationContext | undefined;\n  readonly agentToolSnapshot?: AgentToolMaterializationSnapshot | null | undefined;\n}\n\n// Synthetic \"Set up job\" step prepended when a job execution's steps are materialized.\n// The runner prepares the workspace here; failures report through the normal step\n// protocol instead of hanging the job until the lease/timeout fires. Its config is\n// credential-free.\nconst SETUP_STEP: MaterializedWorkflowStep = {\n  key: null,\n  name: 'Set up job',\n  sourceLocation: null,\n  status: 'pending',\n  type: 'setup',\n  config: {},\n  authoredConfig: null,\n  position: 0,\n};\n\nexport function materializeJobExecutionSteps(\n  params: MaterializeJobExecutionStepsParams,\n): readonly MaterializedWorkflowStep[] {\n  const {\n    model,\n    job,\n    context,\n    resolveAgentDefaults = catalogDefaultAgentResolver,\n    definitionId = model.name,\n    agentToolContext,\n    agentToolSnapshot,\n  } = params;\n\n  return [\n    SETUP_STEP,\n    ...job.steps.map((step, stepPosition) => {\n      // The trusted context exposes the stable job key; the authored display field remains `job.name`.\n      const stepContext = {...context.values, job: {key: job.key}};\n      const resolved = resolveStepConfig({\n        jobKey: job.key,\n        step,\n        workflowEnv: model.env,\n        workflowEnvTemplates: model.templates?.env,\n        jobEnv: job.env,\n        jobEnvTemplates: job.templates?.env,\n        context: stepContext,\n        site: context.site,\n        resolveAgentDefaults,\n        definitionId,\n        agentToolContext,\n        agentToolSnapshot,\n      });\n      return {\n        key: step.key ?? null,\n        name: resolved.name ?? stepDisplayName(step),\n        sourceLocation: step.sourceLocation ?? null,\n        status: 'pending' as const,\n        type: step.kind,\n        config: resolved.config,\n        ...(step.if === undefined ? {} : {condition: step.if}),\n        authoredConfig: resolved.authoredConfig,\n        ...materializedConfigPlan(resolved.configPlan, resolved.trace),\n        ...(resolved.diagnostics.length === 0 ? {} : {diagnostics: resolved.diagnostics}),\n        position: stepPosition + 1,\n      };\n    }),\n  ];\n}\n\nfunction materializedConfigPlan(\n  configPlan: StepConfigDispatchPlan | null,\n  trace: NonNullable<StepConfigDispatchPlan['trace']>,\n): {readonly configPlan?: StepConfigDispatchPlan} {\n  if (configPlan === null && trace.length === 0) return {};\n  return {configPlan: {...(configPlan ?? {}), ...(trace.length === 0 ? {} : {trace})}};\n}\n\nfunction stepDisplayName(step: WorkflowModelStep): string {\n  switch (step.kind) {\n    case 'run':\n      return firstLine(step.command.value);\n    case 'agent':\n      return step.model === undefined\n        ? firstLine(step.prompt)\n        : `${step.model} · ${firstLine(step.prompt)}`;\n    default:\n      return assertNever(step);\n  }\n}\n\nfunction firstLine(value: string): string {\n  return value.split(FIRST_LINE_PATTERN, 1)[0]?.trim() || value.trim();\n}\n\nfunction assertNever(value: never): never {\n  throw new Error(`Unhandled workflow step kind: ${JSON.stringify(value)}`);\n}\n"],"names":["catalogDefaultAgentResolver","resolveStepConfig","FIRST_LINE_PATTERN","SETUP_STEP","key","name","sourceLocation","status","type","config","authoredConfig","position","materializeJobExecutionSteps","params","model","job","context","resolveAgentDefaults","definitionId","agentToolContext","agentToolSnapshot","steps","map","step","stepPosition","stepContext","values","resolved","jobKey","workflowEnv","env","workflowEnvTemplates","templates","jobEnv","jobEnvTemplates","site","stepDisplayName","kind","if","undefined","condition","materializedConfigPlan","configPlan","trace","diagnostics","length","firstLine","command","value","prompt","assertNever","split","trim","Error","JSON","stringify"],"mappings":"AAAA,SAEEA,2BAA2B,QACtB,+CAA+C;AAQtD,SAAQC,iBAAiB,QAA4C,2BAA2B;AAOhG,MAAMC,qBAAqB;AA0B3B,uFAAuF;AACvF,kFAAkF;AAClF,mFAAmF;AACnF,mBAAmB;AACnB,MAAMC,aAAuC;IAC3CC,KAAK;IACLC,MAAM;IACNC,gBAAgB;IAChBC,QAAQ;IACRC,MAAM;IACNC,QAAQ,CAAC;IACTC,gBAAgB;IAChBC,UAAU;AACZ;AAEA,OAAO,SAASC,6BACdC,MAA0C;IAE1C,MAAM,EACJC,KAAK,EACLC,GAAG,EACHC,OAAO,EACPC,uBAAuBjB,2BAA2B,EAClDkB,eAAeJ,MAAMT,IAAI,EACzBc,gBAAgB,EAChBC,iBAAiB,EAClB,GAAGP;IAEJ,OAAO;QACLV;WACGY,IAAIM,KAAK,CAACC,GAAG,CAAC,CAACC,MAAMC;YACtB,iGAAiG;YACjG,MAAMC,cAAc;gBAAC,GAAGT,QAAQU,MAAM;gBAAEX,KAAK;oBAACX,KAAKW,IAAIX,GAAG;gBAAA;YAAC;YAC3D,MAAMuB,WAAW1B,kBAAkB;gBACjC2B,QAAQb,IAAIX,GAAG;gBACfmB;gBACAM,aAAaf,MAAMgB,GAAG;gBACtBC,sBAAsBjB,MAAMkB,SAAS,EAAEF;gBACvCG,QAAQlB,IAAIe,GAAG;gBACfI,iBAAiBnB,IAAIiB,SAAS,EAAEF;gBAChCd,SAASS;gBACTU,MAAMnB,QAAQmB,IAAI;gBAClBlB;gBACAC;gBACAC;gBACAC;YACF;YACA,OAAO;gBACLhB,KAAKmB,KAAKnB,GAAG,IAAI;gBACjBC,MAAMsB,SAAStB,IAAI,IAAI+B,gBAAgBb;gBACvCjB,gBAAgBiB,KAAKjB,cAAc,IAAI;gBACvCC,QAAQ;gBACRC,MAAMe,KAAKc,IAAI;gBACf5B,QAAQkB,SAASlB,MAAM;gBACvB,GAAIc,KAAKe,EAAE,KAAKC,YAAY,CAAC,IAAI;oBAACC,WAAWjB,KAAKe,EAAE;gBAAA,CAAC;gBACrD5B,gBAAgBiB,SAASjB,cAAc;gBACvC,GAAG+B,uBAAuBd,SAASe,UAAU,EAAEf,SAASgB,KAAK,CAAC;gBAC9D,GAAIhB,SAASiB,WAAW,CAACC,MAAM,KAAK,IAAI,CAAC,IAAI;oBAACD,aAAajB,SAASiB,WAAW;gBAAA,CAAC;gBAChFjC,UAAUa,eAAe;YAC3B;QACF;KACD;AACH;AAEA,SAASiB,uBACPC,UAAyC,EACzCC,KAAmD;IAEnD,IAAID,eAAe,QAAQC,MAAME,MAAM,KAAK,GAAG,OAAO,CAAC;IACvD,OAAO;QAACH,YAAY;YAAC,GAAIA,cAAc,CAAC,CAAC;YAAG,GAAIC,MAAME,MAAM,KAAK,IAAI,CAAC,IAAI;gBAACF;YAAK,CAAC;QAAC;IAAC;AACrF;AAEA,SAASP,gBAAgBb,IAAuB;IAC9C,OAAQA,KAAKc,IAAI;QACf,KAAK;YACH,OAAOS,UAAUvB,KAAKwB,OAAO,CAACC,KAAK;QACrC,KAAK;YACH,OAAOzB,KAAKT,KAAK,KAAKyB,YAClBO,UAAUvB,KAAK0B,MAAM,IACrB,GAAG1B,KAAKT,KAAK,CAAC,GAAG,EAAEgC,UAAUvB,KAAK0B,MAAM,GAAG;QACjD;YACE,OAAOC,YAAY3B;IACvB;AACF;AAEA,SAASuB,UAAUE,KAAa;IAC9B,OAAOA,MAAMG,KAAK,CAACjD,oBAAoB,EAAE,CAAC,EAAE,EAAEkD,UAAUJ,MAAMI,IAAI;AACpE;AAEA,SAASF,YAAYF,KAAY;IAC/B,MAAM,IAAIK,MAAM,CAAC,8BAA8B,EAAEC,KAAKC,SAAS,CAACP,QAAQ;AAC1E"}

package/dist/core/step-config/materialize-workflow-model.d.ts

@@ -0,0 +1,42 @@
+import type { AgentDefaultsResolver } from '@shipfox/api-agent/core/resolve-agent-config';
+import type { WorkflowModel } from '@shipfox/api-definitions';
+import type { AgentToolMaterializationContext, AgentToolMaterializationSnapshot } from '#core/agent-tools.js';
+import { type MaterializedWorkflowStep } from './materialize-job-execution-steps.js';
+import type { WorkflowEvaluationContext } from './workflow-evaluation-context.js';
+type WorkflowModelJob = WorkflowModel['jobs'][number];
+export interface MaterializedWorkflowJob {
+    readonly key: string;
+    readonly mode: WorkflowModelJob['mode'];
+    readonly success?: string;
+    readonly executionTimeoutMs?: number;
+    readonly checkout: WorkflowModelJob['checkout'];
+    readonly listening?: WorkflowModelJob['listening'];
+    readonly name?: WorkflowModelJob['name'];
+    readonly outputs?: WorkflowModelJob['outputs'];
+    readonly dependencies: readonly string[];
+    readonly runner: readonly string[];
+    readonly position: number;
+    readonly steps: readonly MaterializedWorkflowStep[];
+}
+export interface MaterializeWorkflowModelParams {
+    readonly model: WorkflowModel;
+    readonly context?: WorkflowEvaluationContext | undefined;
+    readonly resolveAgentDefaults?: AgentDefaultsResolver | undefined;
+    readonly definitionId?: string | undefined;
+    readonly agentToolContext?: AgentToolMaterializationContext | undefined;
+    readonly agentToolSnapshot?: AgentToolMaterializationSnapshot | null | undefined;
+}
+export declare function materializeWorkflowModel(params: MaterializeWorkflowModelParams): readonly MaterializedWorkflowJob[];
+export declare function materializeJobRunner(params: {
+    readonly job: WorkflowModelJob;
+    readonly context: WorkflowEvaluationContext;
+    readonly definitionId: string;
+}): readonly string[];
+export declare function materializeJobOutputs(params: {
+    readonly job: WorkflowModelJob;
+    readonly context: WorkflowEvaluationContext;
+    readonly definitionId: string;
+}): Record<string, string> | null;
+export declare function modelHasAgentStep(model: WorkflowModel): boolean;
+export {};
+//# sourceMappingURL=materialize-workflow-model.d.ts.map

package/dist/core/step-config/materialize-workflow-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize-workflow-model.d.ts","sourceRoot":"","sources":["../../../src/core/step-config/materialize-workflow-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAE5D,OAAO,KAAK,EACV,+BAA+B,EAC/B,gCAAgC,EACjC,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,KAAK,wBAAwB,EAE9B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,kCAAkC,CAAC;AAEhF,KAAK,gBAAgB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AACtD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC/C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,wBAAwB,EAAE,CAAC;CACrD;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACzD,QAAQ,CAAC,oBAAoB,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAClE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,+BAA+B,GAAG,SAAS,CAAC;IACxE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,gCAAgC,GAAG,IAAI,GAAG,SAAS,CAAC;CAClF;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,8BAA8B,GACrC,SAAS,uBAAuB,EAAE,CAoCpC;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,GAAG,SAAS,MAAM,EAAE,CAgBpB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAgBhC;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAE/D"}

package/dist/core/step-config/materialize-workflow-model.js

@@ -0,0 +1,96 @@
+import { canonicalizeLabels, findInvalidLabels, MAX_RUNNER_LABELS } from '@shipfox/runner-labels';
+import { InvalidJobRunnerLabelsError } from '#core/errors.js';
+import { completeStepField } from './fields.js';
+import { materializeJobExecutionSteps } from './materialize-job-execution-steps.js';
+export function materializeWorkflowModel(params) {
+    const { model, context = {
+        site: 'run-creation',
+        values: {}
+    }, resolveAgentDefaults, definitionId = model.name, agentToolContext, agentToolSnapshot } = params;
+    const jobsById = new Map(model.jobs.map((job)=>[
+            job.id,
+            job
+        ]));
+    return model.jobs.map((job, position)=>({
+            key: job.key,
+            mode: job.mode,
+            ...job.success === undefined ? {} : {
+                success: job.success
+            },
+            ...job.executionTimeoutMs === undefined ? {} : {
+                executionTimeoutMs: job.executionTimeoutMs
+            },
+            checkout: job.checkout,
+            ...job.listening === undefined ? {} : {
+                listening: job.listening
+            },
+            ...job.name === undefined ? {} : {
+                name: job.name
+            },
+            ...job.outputs === undefined ? {} : {
+                outputs: job.outputs
+            },
+            dependencies: dependencySourceNames(job, jobsById),
+            runner: job.runner,
+            position,
+            steps: job.mode === 'listening' ? [] : materializeJobExecutionSteps({
+                model,
+                job,
+                context,
+                resolveAgentDefaults,
+                definitionId,
+                agentToolContext,
+                agentToolSnapshot
+            })
+        }));
+}
+export function materializeJobRunner(params) {
+    const resolvedLabels = (params.job.runnerTemplates ?? []).map((template)=>completeStepField({
+            field: 'job.runner',
+            errorField: 'job.runner',
+            template: {
+                segments: template
+            },
+            context: params.context,
+            definitionId: params.definitionId
+        }));
+    const labels = canonicalizeLabels([
+        ...params.job.runner,
+        ...resolvedLabels
+    ]);
+    const invalidLabels = findInvalidLabels(labels);
+    if (labels.length === 0 || labels.length > MAX_RUNNER_LABELS || invalidLabels.length > 0) {
+        throw new InvalidJobRunnerLabelsError(labels);
+    }
+    return labels;
+}
+export function materializeJobOutputs(params) {
+    const outputs = params.job.outputs;
+    if (outputs === undefined) return null;
+    return Object.fromEntries(Object.entries(outputs).map(([key, template])=>[
+            key,
+            completeStepField({
+                field: 'job.outputs',
+                errorField: 'job.outputs',
+                template: {
+                    segments: template
+                },
+                context: params.context,
+                definitionId: params.definitionId
+            })
+        ]));
+}
+export function modelHasAgentStep(model) {
+    return model.jobs.some((job)=>job.steps.some((step)=>step.kind === 'agent'));
+}
+function dependencySourceNames(job, jobsById) {
+    return job.dependencies.map((dependencyId)=>{
+        const dependency = jobsById.get(dependencyId);
+        if (!dependency) {
+            throw new Error(`Unresolved workflow model dependency "${dependencyId}" for job "${job.id}"`);
+        }
+        return dependency.key;
+    });
+}
+
+//# sourceMappingURL=materialize-workflow-model.js.map

package/dist/core/step-config/materialize-workflow-model.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/step-config/materialize-workflow-model.ts"],"sourcesContent":["import type {AgentDefaultsResolver} from '@shipfox/api-agent/core/resolve-agent-config';\nimport type {WorkflowModel} from '@shipfox/api-definitions';\nimport {canonicalizeLabels, findInvalidLabels, MAX_RUNNER_LABELS} from '@shipfox/runner-labels';\nimport type {\n  AgentToolMaterializationContext,\n  AgentToolMaterializationSnapshot,\n} from '#core/agent-tools.js';\nimport {InvalidJobRunnerLabelsError} from '#core/errors.js';\nimport {completeStepField} from './fields.js';\nimport {\n  type MaterializedWorkflowStep,\n  materializeJobExecutionSteps,\n} from './materialize-job-execution-steps.js';\nimport type {WorkflowEvaluationContext} from './workflow-evaluation-context.js';\n\ntype WorkflowModelJob = WorkflowModel['jobs'][number];\nexport interface MaterializedWorkflowJob {\n  readonly key: string;\n  readonly mode: WorkflowModelJob['mode'];\n  readonly success?: string;\n  readonly executionTimeoutMs?: number;\n  readonly checkout: WorkflowModelJob['checkout'];\n  readonly listening?: WorkflowModelJob['listening'];\n  readonly name?: WorkflowModelJob['name'];\n  readonly outputs?: WorkflowModelJob['outputs'];\n  readonly dependencies: readonly string[];\n  readonly runner: readonly string[];\n  readonly position: number;\n  readonly steps: readonly MaterializedWorkflowStep[];\n}\n\nexport interface MaterializeWorkflowModelParams {\n  readonly model: WorkflowModel;\n  readonly context?: WorkflowEvaluationContext | undefined;\n  readonly resolveAgentDefaults?: AgentDefaultsResolver | undefined;\n  readonly definitionId?: string | undefined;\n  readonly agentToolContext?: AgentToolMaterializationContext | undefined;\n  readonly agentToolSnapshot?: AgentToolMaterializationSnapshot | null | undefined;\n}\n\nexport function materializeWorkflowModel(\n  params: MaterializeWorkflowModelParams,\n): readonly MaterializedWorkflowJob[] {\n  const {\n    model,\n    context = {site: 'run-creation', values: {}},\n    resolveAgentDefaults,\n    definitionId = model.name,\n    agentToolContext,\n    agentToolSnapshot,\n  } = params;\n  const jobsById = new Map(model.jobs.map((job) => [job.id, job]));\n\n  return model.jobs.map((job, position) => ({\n    key: job.key,\n    mode: job.mode,\n    ...(job.success === undefined ? {} : {success: job.success}),\n    ...(job.executionTimeoutMs === undefined ? {} : {executionTimeoutMs: job.executionTimeoutMs}),\n    checkout: job.checkout,\n    ...(job.listening === undefined ? {} : {listening: job.listening}),\n    ...(job.name === undefined ? {} : {name: job.name}),\n    ...(job.outputs === undefined ? {} : {outputs: job.outputs}),\n    dependencies: dependencySourceNames(job, jobsById),\n    runner: job.runner,\n    position,\n    steps:\n      job.mode === 'listening'\n        ? []\n        : materializeJobExecutionSteps({\n            model,\n            job,\n            context,\n            resolveAgentDefaults,\n            definitionId,\n            agentToolContext,\n            agentToolSnapshot,\n          }),\n  }));\n}\n\nexport function materializeJobRunner(params: {\n  readonly job: WorkflowModelJob;\n  readonly context: WorkflowEvaluationContext;\n  readonly definitionId: string;\n}): readonly string[] {\n  const resolvedLabels = (params.job.runnerTemplates ?? []).map((template) =>\n    completeStepField({\n      field: 'job.runner',\n      errorField: 'job.runner',\n      template: {segments: template},\n      context: params.context,\n      definitionId: params.definitionId,\n    }),\n  );\n  const labels = canonicalizeLabels([...params.job.runner, ...resolvedLabels]);\n  const invalidLabels = findInvalidLabels(labels);\n  if (labels.length === 0 || labels.length > MAX_RUNNER_LABELS || invalidLabels.length > 0) {\n    throw new InvalidJobRunnerLabelsError(labels);\n  }\n  return labels;\n}\n\nexport function materializeJobOutputs(params: {\n  readonly job: WorkflowModelJob;\n  readonly context: WorkflowEvaluationContext;\n  readonly definitionId: string;\n}): Record<string, string> | null {\n  const outputs = params.job.outputs;\n  if (outputs === undefined) return null;\n\n  return Object.fromEntries(\n    Object.entries(outputs).map(([key, template]) => [\n      key,\n      completeStepField({\n        field: 'job.outputs',\n        errorField: 'job.outputs',\n        template: {segments: template},\n        context: params.context,\n        definitionId: params.definitionId,\n      }),\n    ]),\n  );\n}\n\nexport function modelHasAgentStep(model: WorkflowModel): boolean {\n  return model.jobs.some((job) => job.steps.some((step) => step.kind === 'agent'));\n}\n\nfunction dependencySourceNames(\n  job: WorkflowModelJob,\n  jobsById: ReadonlyMap<string, WorkflowModelJob>,\n): readonly string[] {\n  return job.dependencies.map((dependencyId) => {\n    const dependency = jobsById.get(dependencyId);\n    if (!dependency) {\n      throw new Error(`Unresolved workflow model dependency \"${dependencyId}\" for job \"${job.id}\"`);\n    }\n    return dependency.key;\n  });\n}\n"],"names":["canonicalizeLabels","findInvalidLabels","MAX_RUNNER_LABELS","InvalidJobRunnerLabelsError","completeStepField","materializeJobExecutionSteps","materializeWorkflowModel","params","model","context","site","values","resolveAgentDefaults","definitionId","name","agentToolContext","agentToolSnapshot","jobsById","Map","jobs","map","job","id","position","key","mode","success","undefined","executionTimeoutMs","checkout","listening","outputs","dependencies","dependencySourceNames","runner","steps","materializeJobRunner","resolvedLabels","runnerTemplates","template","field","errorField","segments","labels","invalidLabels","length","materializeJobOutputs","Object","fromEntries","entries","modelHasAgentStep","some","step","kind","dependencyId","dependency","get","Error"],"mappings":"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"}

package/dist/core/step-config/resolve-job-execution-name.d.ts

@@ -0,0 +1,18 @@
+import type { WorkflowModel } from '@shipfox/api-definitions';
+import { type WorkflowExpressionEvaluationContext } from '@shipfox/expression';
+import type { PersistedEvaluationTraceEntry } from '#core/entities/step.js';
+interface WorkflowModelJobName {
+    readonly name?: WorkflowModel['jobs'][number]['name'] | undefined;
+}
+export interface ResolveJobExecutionNameParams {
+    readonly definitionId: string;
+    readonly job: WorkflowModelJobName;
+    readonly fallbackName: string;
+    readonly context: WorkflowExpressionEvaluationContext;
+}
+export declare function resolveJobExecutionName(params: ResolveJobExecutionNameParams): {
+    readonly value: string;
+    readonly trace: readonly PersistedEvaluationTraceEntry[];
+};
+export {};
+//# sourceMappingURL=resolve-job-execution-name.d.ts.map

package/dist/core/step-config/resolve-job-execution-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-job-execution-name.d.ts","sourceRoot":"","sources":["../../../src/core/step-config/resolve-job-execution-name.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAIL,KAAK,mCAAmC,EAEzC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAG1E,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;CACnE;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,oBAAoB,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,mCAAmC,CAAC;CACvD;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,6BAA6B,GAAG;IAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,6BAA6B,EAAE,CAAC;CAC1D,CAyBA"}

package/dist/core/step-config/resolve-job-execution-name.js

@@ -0,0 +1,36 @@
+import { capTraceEntries, getWorkflowInterpolationFieldFailurePolicy, resolveFieldAtSite, WorkflowTemplateResolutionError } from '@shipfox/expression';
+import { InterpolationUnresolvableError } from '#core/errors.js';
+export function resolveJobExecutionName(params) {
+    if (params.job.name === undefined) return {
+        value: params.fallbackName,
+        trace: []
+    };
+    try {
+        const resolved = resolveFieldAtSite({
+            field: {
+                segments: params.job.name
+            },
+            site: 'execution-creation',
+            context: params.context,
+            failurePolicy: getWorkflowInterpolationFieldFailurePolicy('job.name')
+        });
+        return {
+            value: resolved.kind === 'frozen' && resolved.value !== '' ? resolved.value : params.fallbackName,
+            trace: capTraceEntries(resolved.trace.map((entry)=>({
+                    ...entry,
+                    field: 'job.name'
+                })))
+        };
+    } catch (error) {
+        if (error instanceof WorkflowTemplateResolutionError) {
+            throw new InterpolationUnresolvableError(params.definitionId, {
+                field: 'job.name',
+                source: error.source,
+                cause: error
+            });
+        }
+        throw error;
+    }
+}
+
+//# sourceMappingURL=resolve-job-execution-name.js.map

package/dist/core/step-config/resolve-job-execution-name.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/step-config/resolve-job-execution-name.ts"],"sourcesContent":["import type {WorkflowModel} from '@shipfox/api-definitions';\nimport {\n  capTraceEntries,\n  getWorkflowInterpolationFieldFailurePolicy,\n  resolveFieldAtSite,\n  type WorkflowExpressionEvaluationContext,\n  WorkflowTemplateResolutionError,\n} from '@shipfox/expression';\nimport type {PersistedEvaluationTraceEntry} from '#core/entities/step.js';\nimport {InterpolationUnresolvableError} from '#core/errors.js';\n\ninterface WorkflowModelJobName {\n  readonly name?: WorkflowModel['jobs'][number]['name'] | undefined;\n}\n\nexport interface ResolveJobExecutionNameParams {\n  readonly definitionId: string;\n  readonly job: WorkflowModelJobName;\n  readonly fallbackName: string;\n  readonly context: WorkflowExpressionEvaluationContext;\n}\n\nexport function resolveJobExecutionName(params: ResolveJobExecutionNameParams): {\n  readonly value: string;\n  readonly trace: readonly PersistedEvaluationTraceEntry[];\n} {\n  if (params.job.name === undefined) return {value: params.fallbackName, trace: []};\n\n  try {\n    const resolved = resolveFieldAtSite({\n      field: {segments: params.job.name},\n      site: 'execution-creation',\n      context: params.context,\n      failurePolicy: getWorkflowInterpolationFieldFailurePolicy('job.name'),\n    });\n    return {\n      value:\n        resolved.kind === 'frozen' && resolved.value !== '' ? resolved.value : params.fallbackName,\n      trace: capTraceEntries(resolved.trace.map((entry) => ({...entry, field: 'job.name'}))),\n    };\n  } catch (error) {\n    if (error instanceof WorkflowTemplateResolutionError) {\n      throw new InterpolationUnresolvableError(params.definitionId, {\n        field: 'job.name',\n        source: error.source,\n        cause: error,\n      });\n    }\n    throw error;\n  }\n}\n"],"names":["capTraceEntries","getWorkflowInterpolationFieldFailurePolicy","resolveFieldAtSite","WorkflowTemplateResolutionError","InterpolationUnresolvableError","resolveJobExecutionName","params","job","name","undefined","value","fallbackName","trace","resolved","field","segments","site","context","failurePolicy","kind","map","entry","error","definitionId","source","cause"],"mappings":"AACA,SACEA,eAAe,EACfC,0CAA0C,EAC1CC,kBAAkB,EAElBC,+BAA+B,QAC1B,sBAAsB;AAE7B,SAAQC,8BAA8B,QAAO,kBAAkB;AAa/D,OAAO,SAASC,wBAAwBC,MAAqC;IAI3E,IAAIA,OAAOC,GAAG,CAACC,IAAI,KAAKC,WAAW,OAAO;QAACC,OAAOJ,OAAOK,YAAY;QAAEC,OAAO,EAAE;IAAA;IAEhF,IAAI;QACF,MAAMC,WAAWX,mBAAmB;YAClCY,OAAO;gBAACC,UAAUT,OAAOC,GAAG,CAACC,IAAI;YAAA;YACjCQ,MAAM;YACNC,SAASX,OAAOW,OAAO;YACvBC,eAAejB,2CAA2C;QAC5D;QACA,OAAO;YACLS,OACEG,SAASM,IAAI,KAAK,YAAYN,SAASH,KAAK,KAAK,KAAKG,SAASH,KAAK,GAAGJ,OAAOK,YAAY;YAC5FC,OAAOZ,gBAAgBa,SAASD,KAAK,CAACQ,GAAG,CAAC,CAACC,QAAW,CAAA;oBAAC,GAAGA,KAAK;oBAAEP,OAAO;gBAAU,CAAA;QACpF;IACF,EAAE,OAAOQ,OAAO;QACd,IAAIA,iBAAiBnB,iCAAiC;YACpD,MAAM,IAAIC,+BAA+BE,OAAOiB,YAAY,EAAE;gBAC5DT,OAAO;gBACPU,QAAQF,MAAME,MAAM;gBACpBC,OAAOH;YACT;QACF;QACA,MAAMA;IACR;AACF"}

package/dist/core/step-config/resolve-step-config.d.ts

@@ -0,0 +1,33 @@
+import type { AgentDefaultsResolver } from '@shipfox/api-agent/core/resolve-agent-config';
+import type { WorkflowEnvTemplates, WorkflowModel } from '@shipfox/api-definitions';
+import { type AvailabilitySite, type EvaluationTraceLimitEntry, type WorkflowExpressionEvaluationContext } from '@shipfox/expression';
+import type { AgentToolMaterializationContext, AgentToolMaterializationSnapshot } from '#core/agent-tools.js';
+import type { StepConfigDispatchPlan } from '#core/entities/step.js';
+import { type StepConfigField, type WorkflowStepEvaluationTraceEntry, type WorkflowStepTemplateDiagnostic } from './fields.js';
+type WorkflowModelJob = WorkflowModel['jobs'][number];
+type WorkflowModelStep = WorkflowModelJob['steps'][number];
+export type { StepConfigField, WorkflowStepTemplateDiagnostic };
+export interface ResolvedStepConfig {
+    readonly config: Record<string, unknown>;
+    readonly configPlan: StepConfigDispatchPlan | null;
+    readonly authoredConfig: Record<string, unknown> | null;
+    readonly name?: string;
+    readonly diagnostics: readonly WorkflowStepTemplateDiagnostic[];
+    readonly trace: readonly (WorkflowStepEvaluationTraceEntry | EvaluationTraceLimitEntry)[];
+}
+export interface ResolveStepConfigParams {
+    readonly jobKey: string;
+    readonly step: WorkflowModelStep;
+    readonly workflowEnv: WorkflowModel['env'];
+    readonly workflowEnvTemplates: WorkflowEnvTemplates | undefined;
+    readonly jobEnv: WorkflowModelJob['env'];
+    readonly jobEnvTemplates: WorkflowEnvTemplates | undefined;
+    readonly context: WorkflowExpressionEvaluationContext;
+    readonly site: AvailabilitySite;
+    readonly resolveAgentDefaults: AgentDefaultsResolver;
+    readonly definitionId: string;
+    readonly agentToolContext?: AgentToolMaterializationContext | undefined;
+    readonly agentToolSnapshot?: AgentToolMaterializationSnapshot | null | undefined;
+}
+export declare function resolveStepConfig(params: ResolveStepConfigParams): ResolvedStepConfig;
+//# sourceMappingURL=resolve-step-config.d.ts.map

package/dist/core/step-config/resolve-step-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-step-config.d.ts","sourceRoot":"","sources":["../../../src/core/step-config/resolve-step-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EAAC,oBAAoB,EAAE,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAClF,OAAO,EACL,KAAK,gBAAgB,EAErB,KAAK,yBAAyB,EAC9B,KAAK,mCAAmC,EACzC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,+BAA+B,EAC/B,gCAAgC,EACjC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,wBAAwB,CAAC;AAEnE,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,gCAAgC,EACrC,KAAK,8BAA8B,EACpC,MAAM,aAAa,CAAC;AAIrB,KAAK,gBAAgB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AACtD,KAAK,iBAAiB,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAI3D,YAAY,EAAC,eAAe,EAAE,8BAA8B,EAAC,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,SAAS,8BAA8B,EAAE,CAAC;IAChE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,gCAAgC,GAAG,yBAAyB,CAAC,EAAE,CAAC;CAC3F;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAC3C,QAAQ,CAAC,oBAAoB,EAAE,oBAAoB,GAAG,SAAS,CAAC;IAChE,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,oBAAoB,GAAG,SAAS,CAAC;IAC3D,QAAQ,CAAC,OAAO,EAAE,mCAAmC,CAAC;IACtD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,oBAAoB,EAAE,qBAAqB,CAAC;IACrD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,+BAA+B,GAAG,SAAS,CAAC;IACxE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,gCAAgC,GAAG,IAAI,GAAG,SAAS,CAAC;CAClF;AAYD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,kBAAkB,CAgBrF"}

package/dist/core/step-config/resolve-step-config.js

@@ -0,0 +1,164 @@
+import { capTraceEntries } from '@shipfox/expression';
+import { resolveAgentStepConfig } from './agent.js';
+import { freezeStepField } from './fields.js';
+import { resolveRunStepConfig } from './run.js';
+export function resolveStepConfig(params) {
+    const context = evaluationContext(params);
+    const effective = buildStepConfig({
+        ...params,
+        context,
+        mode: 'effective'
+    });
+    const authoredConfig = effective.hasTemplates ? buildStepConfig({
+        ...params,
+        context,
+        mode: 'authored'
+    }).config : null;
+    const name = resolveStepName(params.step, context, params.definitionId);
+    return {
+        config: effective.config,
+        configPlan: effective.configPlan,
+        authoredConfig,
+        ...name.value === undefined || name.value === '' ? {} : {
+            name: name.value
+        },
+        diagnostics: [
+            ...effective.diagnostics,
+            ...name.diagnostics
+        ],
+        trace: capTraceEntries([
+            ...effective.trace,
+            ...name.trace
+        ])
+    };
+}
+function buildStepConfig(params) {
+    const gate = gateConfigForStep(params.step);
+    const outputs = outputsConfigForStep(params.step);
+    const runStep = runStepOrNull(params.step);
+    const isRunStep = runStep !== null;
+    if (isRunStep) {
+        const run = resolveRunStepConfig({
+            ...params,
+            step: runStep
+        });
+        return {
+            config: {
+                ...run.config,
+                ...gate,
+                ...outputs
+            },
+            configPlan: run.configPlan,
+            diagnostics: run.diagnostics,
+            trace: run.trace,
+            hasTemplates: run.hasTemplates
+        };
+    }
+    const agentStep = agentStepOrNull(params.step);
+    if (agentStep === null) throw new Error(`Unsupported workflow step kind: ${params.step.kind}`);
+    const agent = resolveAgentStepConfig({
+        ...params,
+        step: agentStep
+    });
+    return {
+        config: {
+            ...agent.config,
+            ...gate,
+            ...outputs
+        },
+        configPlan: agent.configPlan,
+        diagnostics: agent.diagnostics,
+        trace: agent.trace,
+        hasTemplates: agent.hasTemplates
+    };
+}
+function evaluationContext(params) {
+    return {
+        site: params.site,
+        values: params.context
+    };
+}
+function runStepOrNull(step) {
+    const isRunStep = step.kind === 'run';
+    return isRunStep ? step : null;
+}
+function agentStepOrNull(step) {
+    const isAgentStep = step.kind === 'agent';
+    return isAgentStep ? step : null;
+}
+function gateConfigForStep(step) {
+    const hasGate = step.gate !== undefined;
+    return hasGate ? {
+        gate: stepGateConfig(step.gate)
+    } : {};
+}
+function outputsConfigForStep(step) {
+    const hasOutputs = step.outputs !== undefined;
+    return hasOutputs ? {
+        outputs: step.outputs
+    } : {};
+}
+function resolveStepName(step, context, definitionId) {
+    const hasName = step.name !== undefined;
+    if (!hasName) return {
+        value: undefined,
+        diagnostics: [],
+        trace: []
+    };
+    const hasNameTemplate = step.templates?.name !== undefined;
+    if (!hasNameTemplate) return {
+        value: step.name,
+        diagnostics: [],
+        trace: []
+    };
+    const resolved = freezeStepField({
+        field: 'step.name',
+        template: {
+            segments: step.templates.name
+        },
+        context,
+        definitionId,
+        errorField: 'step.name'
+    });
+    return {
+        value: resolved.value,
+        diagnostics: resolved.diagnostics.map((diagnostic)=>({
+                ...diagnostic,
+                field: 'step.name'
+            })),
+        trace: resolved.trace.map((entry)=>({
+                ...entry,
+                field: 'step.name'
+            }))
+    };
+}
+function stepGateConfig(gate) {
+    const hasSuccess = gate.success !== undefined;
+    const hasOnFailure = gate.onFailure !== undefined;
+    const hasOnFailureFeedback = gate.onFailure?.feedback !== undefined;
+    const hasOnFailureFeedbackTemplate = gate.onFailure?.feedbackTemplate !== undefined;
+    return {
+        ...hasSuccess ? {
+            success: {
+                language: gate.success.language,
+                check: gate.success.check,
+                source: gate.success.source
+            }
+        } : {},
+        ...hasOnFailure ? {
+            on_failure: {
+                restart_from: gate.onFailure.restartFrom,
+                ...hasOnFailureFeedback ? {
+                    feedback: gate.onFailure.feedback
+                } : {},
+                ...hasOnFailureFeedbackTemplate ? {
+                    feedback_template: {
+                        segments: gate.onFailure.feedbackTemplate
+                    }
+                } : {}
+            }
+        } : {}
+    };
+}
+
+//# sourceMappingURL=resolve-step-config.js.map