@shipfox/api-workflows 2.0.0

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

@@ -0,0 +1,337 @@
+import { InvalidAgentModelError, UnsupportedHarnessProviderError, UnsupportedHarnessThinkingError, UnsupportedModelProviderError } from '@shipfox/api-agent/core/errors';
+import { AGENT_INTEGRATION_MCP_AUTH, AGENT_INTEGRATION_MCP_ENDPOINT, AGENT_INTEGRATION_MCP_SERVER_NAME, AGENT_INTEGRATION_MCP_TRANSPORT } from '@shipfox/api-agent-dto';
+import { materializeAgentIntegrations } from '#core/agent-tools.js';
+import { AgentConfigUnresolvableError } from '#core/errors.js';
+import { completeStepFieldWithTrace, literalField, resolveStepField } from './fields.js';
+export function resolveAgentStepConfig(params) {
+    const fields = resolveAgentFields(params);
+    const usesAuthoredMode = params.mode === 'authored';
+    if (usesAuthoredMode) return authoredAgentStepConfig(params.step, fields);
+    const hasDeferredModelOrProvider = fields.model?.kind === 'residual' || fields.provider?.kind === 'residual';
+    if (hasDeferredModelOrProvider) return deferredAgentStepConfig(params, fields);
+    return agentStepConfigWithDefaults(params.step, params, fields);
+}
+export function completeAgentConfig(params) {
+    const agent = params.plan.agent;
+    if (agent === undefined) return;
+    const prompt = agent.prompt === undefined ? readConfigString(params.config, 'prompt') : completeAgentField({
+        field: 'agent.prompt',
+        template: agent.prompt,
+        params
+    });
+    const model = agent.model === undefined ? readConfigString(params.config, 'model') : completeAgentField({
+        field: 'agent.model',
+        template: agent.model,
+        params
+    });
+    const provider = agent.provider === undefined ? readConfigString(params.config, 'provider') : completeAgentField({
+        field: 'agent.provider',
+        template: agent.provider,
+        params
+    });
+    const defaults = completeAgentDefaults({
+        harness: agent.harness ?? readConfigHarness(params.config),
+        provider,
+        model,
+        thinking: agent.thinking ?? readConfigThinking(params.config),
+        resolveAgentDefaults: params.resolveAgentDefaults,
+        definitionId: params.definitionId
+    });
+    params.config.harness = defaults.harness;
+    params.config.provider = defaults.provider;
+    params.config.model = defaults.model;
+    params.config.thinking = defaults.thinking;
+    params.config.prompt = prompt;
+    if (agent.tools !== undefined) params.config.tools = [
+        ...agent.tools
+    ];
+    const integrations = agent.integrations === undefined ? undefined : [
+        ...agent.integrations
+    ];
+    if (integrations !== undefined) params.config.integrations = integrations;
+    const mcpServers = agent.mcpServers ?? (integrations === undefined ? undefined : agentIntegrationMcpServers(integrations));
+    if (mcpServers !== undefined) params.config.mcpServers = [
+        ...mcpServers
+    ];
+}
+function completeAgentField(args) {
+    const resolved = completeStepFieldWithTrace({
+        field: args.field,
+        errorField: args.field,
+        template: args.template,
+        context: args.params.context,
+        definitionId: args.params.definitionId
+    });
+    args.params.trace.push(...resolved.trace.map((entry)=>({
+            ...entry,
+            field: args.field
+        })));
+    return resolved.value;
+}
+export function completeAgentDefaults(params) {
+    try {
+        return params.resolveAgentDefaults({
+            harness: params.harness,
+            provider: params.provider,
+            model: params.model,
+            thinking: params.thinking
+        });
+    } catch (error) {
+        if (error instanceof UnsupportedModelProviderError || error instanceof UnsupportedHarnessProviderError || error instanceof UnsupportedHarnessThinkingError || error instanceof InvalidAgentModelError) {
+            throw new AgentConfigUnresolvableError(params.definitionId, {
+                cause: error
+            });
+        }
+        throw error;
+    }
+}
+function resolveAgentFields(params) {
+    const diagnostics = [];
+    const trace = [];
+    const prompt = resolveAgentField({
+        field: 'agent.prompt',
+        value: params.step.prompt,
+        template: params.step.templates?.prompt,
+        context: params.context,
+        mode: params.mode,
+        diagnostics,
+        trace,
+        definitionId: params.definitionId
+    });
+    const model = resolveOptionalAgentField({
+        field: 'agent.model',
+        value: params.step.model,
+        template: params.step.templates?.model,
+        context: params.context,
+        mode: params.mode,
+        diagnostics,
+        trace,
+        definitionId: params.definitionId
+    });
+    const provider = resolveOptionalAgentField({
+        field: 'agent.provider',
+        value: params.step.provider,
+        template: params.step.templates?.provider,
+        context: params.context,
+        mode: params.mode,
+        diagnostics,
+        trace,
+        definitionId: params.definitionId
+    });
+    const hasTemplates = params.step.templates?.prompt !== undefined || params.step.templates?.model !== undefined || params.step.templates?.provider !== undefined;
+    return {
+        diagnostics,
+        trace,
+        prompt,
+        model,
+        provider,
+        hasTemplates
+    };
+}
+function authoredAgentStepConfig(step, fields) {
+    return {
+        config: {
+            ...step.provider === undefined ? {} : {
+                provider: step.provider
+            },
+            ...step.model === undefined ? {} : {
+                model: step.model
+            },
+            ...step.harness === undefined ? {} : {
+                harness: step.harness
+            },
+            ...step.thinking === undefined ? {} : {
+                thinking: step.thinking
+            },
+            ...agentToolsConfig(step),
+            ...authoredAgentIntegrationsConfig(step),
+            prompt: step.prompt
+        },
+        configPlan: null,
+        diagnostics: fields.diagnostics,
+        trace: fields.trace,
+        hasTemplates: fields.hasTemplates
+    };
+}
+function deferredAgentStepConfig(params, fields) {
+    const { step } = params;
+    return {
+        config: {},
+        configPlan: {
+            agent: {
+                prompt: dispatchPlanField(fields.prompt),
+                ...fields.model === undefined ? {} : {
+                    model: dispatchPlanField(fields.model)
+                },
+                ...fields.provider === undefined ? {} : {
+                    provider: dispatchPlanField(fields.provider)
+                },
+                ...step.harness === undefined ? {} : {
+                    harness: step.harness
+                },
+                ...step.thinking === undefined ? {} : {
+                    thinking: step.thinking
+                },
+                ...agentToolsConfig(step),
+                ...materializedAgentIntegrationsConfig(params)
+            }
+        },
+        diagnostics: fields.diagnostics,
+        trace: fields.trace,
+        hasTemplates: fields.hasTemplates
+    };
+}
+function agentStepConfigWithDefaults(step, params, fields) {
+    const providerValue = frozenFieldValue(fields.provider);
+    const modelValue = frozenFieldValue(fields.model);
+    const promptIsDeferred = fields.prompt.kind === 'residual';
+    const resolved = completeAgentDefaults({
+        harness: step.harness,
+        provider: providerValue,
+        model: modelValue,
+        thinking: step.thinking,
+        resolveAgentDefaults: params.resolveAgentDefaults,
+        definitionId: params.definitionId
+    });
+    if (promptIsDeferred) {
+        return {
+            config: {
+                provider: resolved.provider,
+                model: resolved.model,
+                harness: resolved.harness,
+                thinking: resolved.thinking
+            },
+            configPlan: {
+                agent: {
+                    prompt: dispatchPlanField(fields.prompt),
+                    ...agentToolsConfig(step),
+                    ...materializedAgentIntegrationsConfig(params)
+                }
+            },
+            diagnostics: fields.diagnostics,
+            trace: fields.trace,
+            hasTemplates: fields.hasTemplates
+        };
+    }
+    const promptValue = frozenFieldValue(fields.prompt) ?? step.prompt;
+    return {
+        config: {
+            provider: resolved.provider,
+            model: resolved.model,
+            harness: resolved.harness,
+            thinking: resolved.thinking,
+            ...agentToolsConfig(step),
+            ...materializedAgentIntegrationsConfig(params),
+            prompt: promptValue
+        },
+        configPlan: null,
+        diagnostics: fields.diagnostics,
+        trace: fields.trace,
+        hasTemplates: fields.hasTemplates
+    };
+}
+function agentToolsConfig(step) {
+    return step.tools === undefined ? {} : {
+        tools: [
+            ...step.tools
+        ]
+    };
+}
+function authoredAgentIntegrationsConfig(step) {
+    return step.integrations === undefined ? {} : {
+        integrations: step.integrations
+    };
+}
+function materializedAgentIntegrationsConfig(params) {
+    const integrations = materializeAgentIntegrations({
+        jobKey: params.jobKey,
+        stepId: params.step.id,
+        integrations: params.step.integrations,
+        context: params.agentToolContext,
+        snapshot: params.agentToolSnapshot
+    });
+    return integrations === undefined ? {} : {
+        integrations,
+        mcpServers: agentIntegrationMcpServers(integrations)
+    };
+}
+function agentIntegrationMcpServers(integrations) {
+    return [
+        {
+            name: AGENT_INTEGRATION_MCP_SERVER_NAME,
+            transport: AGENT_INTEGRATION_MCP_TRANSPORT,
+            endpoint: AGENT_INTEGRATION_MCP_ENDPOINT,
+            auth: AGENT_INTEGRATION_MCP_AUTH,
+            integrations: [
+                ...integrations
+            ]
+        }
+    ];
+}
+function dispatchPlanField(field) {
+    const isResidual = field.kind === 'residual';
+    return isResidual ? field.field : literalField(field.value);
+}
+function frozenFieldValue(field) {
+    const isFrozen = field?.kind === 'frozen';
+    return isFrozen ? field.value : undefined;
+}
+function resolveAgentField(params) {
+    const hasTemplate = params.template !== undefined;
+    const usesAuthoredMode = params.mode === 'authored';
+    if (!hasTemplate || usesAuthoredMode) {
+        return {
+            kind: 'frozen',
+            value: params.value
+        };
+    }
+    const resolved = resolveStepField({
+        field: params.field,
+        template: {
+            segments: params.template
+        },
+        context: params.context,
+        definitionId: params.definitionId,
+        errorField: params.field
+    });
+    params.diagnostics.push(...resolved.diagnostics.map((diagnostic)=>({
+            ...diagnostic,
+            field: params.field
+        })));
+    params.trace.push(...resolved.trace.map((entry)=>({
+            ...entry,
+            field: params.field
+        })));
+    return fieldResolution(resolved);
+}
+function resolveOptionalAgentField(params) {
+    const hasValue = params.value !== undefined;
+    if (!hasValue) return undefined;
+    return resolveAgentField({
+        ...params,
+        value: params.value
+    });
+}
+function fieldResolution(resolved) {
+    if (resolved.kind === 'residual') return {
+        kind: 'residual',
+        field: resolved.field
+    };
+    return {
+        kind: 'frozen',
+        value: resolved.value
+    };
+}
+function readConfigString(config, key) {
+    const value = config[key];
+    return typeof value === 'string' ? value : undefined;
+}
+function readConfigThinking(config) {
+    const value = config.thinking;
+    return value === 'off' || value === 'minimal' || value === 'low' || value === 'medium' || value === 'high' || value === 'xhigh' ? value : undefined;
+}
+function readConfigHarness(config) {
+    return config.harness === 'pi' || config.harness === 'claude' ? config.harness : undefined;
+}
+
+//# sourceMappingURL=agent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/step-config/agent.ts"],"sourcesContent":["import {\n  InvalidAgentModelError,\n  UnsupportedHarnessProviderError,\n  UnsupportedHarnessThinkingError,\n  UnsupportedModelProviderError,\n} from '@shipfox/api-agent/core/errors';\nimport type {AgentDefaultsResolver} from '@shipfox/api-agent/core/resolve-agent-config';\nimport {\n  AGENT_INTEGRATION_MCP_AUTH,\n  AGENT_INTEGRATION_MCP_ENDPOINT,\n  AGENT_INTEGRATION_MCP_SERVER_NAME,\n  AGENT_INTEGRATION_MCP_TRANSPORT,\n  type AgentIntegrationMcpServerConfigDto,\n  type AgentThinking,\n  type MaterializedAgentIntegrationConfigDto,\n} from '@shipfox/api-agent-dto';\nimport type {WorkflowModel} from '@shipfox/api-definitions';\nimport type {ResolvedField, SiteResolvedField} from '@shipfox/expression';\nimport {\n  type AgentToolMaterializationContext,\n  type AgentToolMaterializationSnapshot,\n  materializeAgentIntegrations,\n} from '#core/agent-tools.js';\nimport type {PersistedEvaluationTraceEntry, StepConfigDispatchPlan} from '#core/entities/step.js';\nimport {AgentConfigUnresolvableError} from '#core/errors.js';\nimport {\n  completeStepFieldWithTrace,\n  literalField,\n  resolveStepField,\n  type WorkflowStepEvaluationTraceEntry,\n  type WorkflowStepTemplateDiagnostic,\n} from './fields.js';\nimport type {WorkflowEvaluationContext} from './workflow-evaluation-context.js';\n\ntype WorkflowModelJob = WorkflowModel['jobs'][number];\ntype WorkflowModelStep = WorkflowModelJob['steps'][number];\ntype WorkflowModelAgentStep = Extract<WorkflowModelStep, {kind: 'agent'}>;\ntype StepConfigMode = 'effective' | 'authored';\ntype FieldResolution =\n  | {readonly kind: 'frozen'; readonly value: string}\n  | {readonly kind: 'residual'; readonly field: ResolvedField};\n\ninterface AgentFieldResolutions {\n  readonly diagnostics: WorkflowStepTemplateDiagnostic[];\n  readonly trace: WorkflowStepEvaluationTraceEntry[];\n  readonly prompt: FieldResolution;\n  readonly model: FieldResolution | undefined;\n  readonly provider: FieldResolution | undefined;\n  readonly hasTemplates: boolean;\n}\n\nexport interface ResolveAgentStepConfigParams {\n  readonly jobKey: string;\n  readonly step: WorkflowModelAgentStep;\n  readonly context: WorkflowEvaluationContext;\n  readonly mode: StepConfigMode;\n  readonly definitionId: string;\n  readonly resolveAgentDefaults: AgentDefaultsResolver;\n  readonly agentToolContext?: AgentToolMaterializationContext | undefined;\n  readonly agentToolSnapshot?: AgentToolMaterializationSnapshot | null | undefined;\n}\n\nexport interface AgentStepConfig {\n  readonly config: Record<string, unknown>;\n  readonly configPlan: StepConfigDispatchPlan | null;\n  readonly diagnostics: readonly WorkflowStepTemplateDiagnostic[];\n  readonly trace: readonly WorkflowStepEvaluationTraceEntry[];\n  readonly hasTemplates: boolean;\n}\n\nexport function resolveAgentStepConfig(params: ResolveAgentStepConfigParams): AgentStepConfig {\n  const fields = resolveAgentFields(params);\n  const usesAuthoredMode = params.mode === 'authored';\n\n  if (usesAuthoredMode) return authoredAgentStepConfig(params.step, fields);\n\n  const hasDeferredModelOrProvider =\n    fields.model?.kind === 'residual' || fields.provider?.kind === 'residual';\n  if (hasDeferredModelOrProvider) return deferredAgentStepConfig(params, fields);\n\n  return agentStepConfigWithDefaults(params.step, params, fields);\n}\n\nexport function completeAgentConfig(params: {\n  readonly config: Record<string, unknown>;\n  readonly plan: StepConfigDispatchPlan;\n  readonly context: WorkflowEvaluationContext;\n  readonly resolveAgentDefaults: AgentDefaultsResolver;\n  readonly definitionId: string;\n  readonly trace: PersistedEvaluationTraceEntry[];\n}): void {\n  const agent = params.plan.agent;\n  if (agent === undefined) return;\n\n  const prompt =\n    agent.prompt === undefined\n      ? readConfigString(params.config, 'prompt')\n      : completeAgentField({\n          field: 'agent.prompt',\n          template: agent.prompt,\n          params,\n        });\n  const model =\n    agent.model === undefined\n      ? readConfigString(params.config, 'model')\n      : completeAgentField({\n          field: 'agent.model',\n          template: agent.model,\n          params,\n        });\n  const provider =\n    agent.provider === undefined\n      ? readConfigString(params.config, 'provider')\n      : completeAgentField({\n          field: 'agent.provider',\n          template: agent.provider,\n          params,\n        });\n\n  const defaults = completeAgentDefaults({\n    harness: agent.harness ?? readConfigHarness(params.config),\n    provider,\n    model,\n    thinking: agent.thinking ?? readConfigThinking(params.config),\n    resolveAgentDefaults: params.resolveAgentDefaults,\n    definitionId: params.definitionId,\n  });\n  params.config.harness = defaults.harness;\n  params.config.provider = defaults.provider;\n  params.config.model = defaults.model;\n  params.config.thinking = defaults.thinking;\n  params.config.prompt = prompt;\n  if (agent.tools !== undefined) params.config.tools = [...agent.tools];\n  const integrations = agent.integrations === undefined ? undefined : [...agent.integrations];\n  if (integrations !== undefined) params.config.integrations = integrations;\n  const mcpServers =\n    agent.mcpServers ??\n    (integrations === undefined ? undefined : agentIntegrationMcpServers(integrations));\n  if (mcpServers !== undefined) params.config.mcpServers = [...mcpServers];\n}\n\nfunction completeAgentField(args: {\n  readonly field: 'agent.prompt' | 'agent.model' | 'agent.provider';\n  readonly template: ResolvedField;\n  readonly params: {\n    readonly context: WorkflowEvaluationContext;\n    readonly definitionId: string;\n    readonly trace: PersistedEvaluationTraceEntry[];\n  };\n}): string {\n  const resolved = completeStepFieldWithTrace({\n    field: args.field,\n    errorField: args.field,\n    template: args.template,\n    context: args.params.context,\n    definitionId: args.params.definitionId,\n  });\n  args.params.trace.push(...resolved.trace.map((entry) => ({...entry, field: args.field})));\n  return resolved.value;\n}\n\nexport function completeAgentDefaults(params: {\n  readonly harness: WorkflowModelAgentStep['harness'] | undefined;\n  readonly provider: string | undefined;\n  readonly model: string | undefined;\n  readonly thinking: AgentThinking | undefined;\n  readonly resolveAgentDefaults: AgentDefaultsResolver;\n  readonly definitionId: string;\n}): ReturnType<AgentDefaultsResolver> {\n  try {\n    return params.resolveAgentDefaults({\n      harness: params.harness,\n      provider: params.provider,\n      model: params.model,\n      thinking: params.thinking,\n    });\n  } catch (error) {\n    if (\n      error instanceof UnsupportedModelProviderError ||\n      error instanceof UnsupportedHarnessProviderError ||\n      error instanceof UnsupportedHarnessThinkingError ||\n      error instanceof InvalidAgentModelError\n    ) {\n      throw new AgentConfigUnresolvableError(params.definitionId, {cause: error});\n    }\n    throw error;\n  }\n}\n\nfunction resolveAgentFields(params: ResolveAgentStepConfigParams): AgentFieldResolutions {\n  const diagnostics: WorkflowStepTemplateDiagnostic[] = [];\n  const trace: WorkflowStepEvaluationTraceEntry[] = [];\n  const prompt = resolveAgentField({\n    field: 'agent.prompt',\n    value: params.step.prompt,\n    template: params.step.templates?.prompt,\n    context: params.context,\n    mode: params.mode,\n    diagnostics,\n    trace,\n    definitionId: params.definitionId,\n  });\n  const model = resolveOptionalAgentField({\n    field: 'agent.model',\n    value: params.step.model,\n    template: params.step.templates?.model,\n    context: params.context,\n    mode: params.mode,\n    diagnostics,\n    trace,\n    definitionId: params.definitionId,\n  });\n  const provider = resolveOptionalAgentField({\n    field: 'agent.provider',\n    value: params.step.provider,\n    template: params.step.templates?.provider,\n    context: params.context,\n    mode: params.mode,\n    diagnostics,\n    trace,\n    definitionId: params.definitionId,\n  });\n  const hasTemplates =\n    params.step.templates?.prompt !== undefined ||\n    params.step.templates?.model !== undefined ||\n    params.step.templates?.provider !== undefined;\n\n  return {diagnostics, trace, prompt, model, provider, hasTemplates};\n}\n\nfunction authoredAgentStepConfig(\n  step: WorkflowModelAgentStep,\n  fields: AgentFieldResolutions,\n): AgentStepConfig {\n  return {\n    config: {\n      ...(step.provider === undefined ? {} : {provider: step.provider}),\n      ...(step.model === undefined ? {} : {model: step.model}),\n      ...(step.harness === undefined ? {} : {harness: step.harness}),\n      ...(step.thinking === undefined ? {} : {thinking: step.thinking}),\n      ...agentToolsConfig(step),\n      ...authoredAgentIntegrationsConfig(step),\n      prompt: step.prompt,\n    },\n    configPlan: null,\n    diagnostics: fields.diagnostics,\n    trace: fields.trace,\n    hasTemplates: fields.hasTemplates,\n  };\n}\n\nfunction deferredAgentStepConfig(\n  params: ResolveAgentStepConfigParams,\n  fields: AgentFieldResolutions,\n): AgentStepConfig {\n  const {step} = params;\n  return {\n    config: {},\n    configPlan: {\n      agent: {\n        prompt: dispatchPlanField(fields.prompt),\n        ...(fields.model === undefined ? {} : {model: dispatchPlanField(fields.model)}),\n        ...(fields.provider === undefined ? {} : {provider: dispatchPlanField(fields.provider)}),\n        ...(step.harness === undefined ? {} : {harness: step.harness}),\n        ...(step.thinking === undefined ? {} : {thinking: step.thinking}),\n        ...agentToolsConfig(step),\n        ...materializedAgentIntegrationsConfig(params),\n      },\n    },\n    diagnostics: fields.diagnostics,\n    trace: fields.trace,\n    hasTemplates: fields.hasTemplates,\n  };\n}\n\nfunction agentStepConfigWithDefaults(\n  step: WorkflowModelAgentStep,\n  params: ResolveAgentStepConfigParams,\n  fields: AgentFieldResolutions,\n): AgentStepConfig {\n  const providerValue = frozenFieldValue(fields.provider);\n  const modelValue = frozenFieldValue(fields.model);\n  const promptIsDeferred = fields.prompt.kind === 'residual';\n\n  const resolved = completeAgentDefaults({\n    harness: step.harness,\n    provider: providerValue,\n    model: modelValue,\n    thinking: step.thinking,\n    resolveAgentDefaults: params.resolveAgentDefaults,\n    definitionId: params.definitionId,\n  });\n  if (promptIsDeferred) {\n    return {\n      config: {\n        provider: resolved.provider,\n        model: resolved.model,\n        harness: resolved.harness,\n        thinking: resolved.thinking,\n      },\n      configPlan: {\n        agent: {\n          prompt: dispatchPlanField(fields.prompt),\n          ...agentToolsConfig(step),\n          ...materializedAgentIntegrationsConfig(params),\n        },\n      },\n      diagnostics: fields.diagnostics,\n      trace: fields.trace,\n      hasTemplates: fields.hasTemplates,\n    };\n  }\n\n  const promptValue = frozenFieldValue(fields.prompt) ?? step.prompt;\n  return {\n    config: {\n      provider: resolved.provider,\n      model: resolved.model,\n      harness: resolved.harness,\n      thinking: resolved.thinking,\n      ...agentToolsConfig(step),\n      ...materializedAgentIntegrationsConfig(params),\n      prompt: promptValue,\n    },\n    configPlan: null,\n    diagnostics: fields.diagnostics,\n    trace: fields.trace,\n    hasTemplates: fields.hasTemplates,\n  };\n}\n\nfunction agentToolsConfig(\n  step: WorkflowModelAgentStep,\n): {readonly tools: readonly string[]} | Record<string, never> {\n  return step.tools === undefined ? {} : {tools: [...step.tools]};\n}\n\nfunction authoredAgentIntegrationsConfig(\n  step: WorkflowModelAgentStep,\n):\n  | {readonly integrations: NonNullable<WorkflowModelAgentStep['integrations']>}\n  | Record<string, never> {\n  return step.integrations === undefined ? {} : {integrations: step.integrations};\n}\n\nfunction materializedAgentIntegrationsConfig(params: ResolveAgentStepConfigParams):\n  | {\n      readonly integrations: readonly MaterializedAgentIntegrationConfigDto[];\n      readonly mcpServers: readonly AgentIntegrationMcpServerConfigDto[];\n    }\n  | Record<string, never> {\n  const integrations = materializeAgentIntegrations({\n    jobKey: params.jobKey,\n    stepId: params.step.id,\n    integrations: params.step.integrations,\n    context: params.agentToolContext,\n    snapshot: params.agentToolSnapshot,\n  });\n  return integrations === undefined\n    ? {}\n    : {integrations, mcpServers: agentIntegrationMcpServers(integrations)};\n}\n\nfunction agentIntegrationMcpServers(\n  integrations: readonly MaterializedAgentIntegrationConfigDto[],\n): readonly AgentIntegrationMcpServerConfigDto[] {\n  return [\n    {\n      name: AGENT_INTEGRATION_MCP_SERVER_NAME,\n      transport: AGENT_INTEGRATION_MCP_TRANSPORT,\n      endpoint: AGENT_INTEGRATION_MCP_ENDPOINT,\n      auth: AGENT_INTEGRATION_MCP_AUTH,\n      integrations: [...integrations],\n    },\n  ];\n}\n\nfunction dispatchPlanField(field: FieldResolution): ResolvedField {\n  const isResidual = field.kind === 'residual';\n  return isResidual ? field.field : literalField(field.value);\n}\n\nfunction frozenFieldValue(field: FieldResolution | undefined): string | undefined {\n  const isFrozen = field?.kind === 'frozen';\n  return isFrozen ? field.value : undefined;\n}\n\nfunction resolveAgentField(params: {\n  readonly field: 'agent.prompt' | 'agent.model' | 'agent.provider';\n  readonly value: string;\n  readonly template: ResolvedField['segments'] | undefined;\n  readonly context: WorkflowEvaluationContext;\n  readonly mode: StepConfigMode;\n  readonly diagnostics: WorkflowStepTemplateDiagnostic[];\n  readonly trace: WorkflowStepEvaluationTraceEntry[];\n  readonly definitionId: string;\n}): FieldResolution {\n  const hasTemplate = params.template !== undefined;\n  const usesAuthoredMode = params.mode === 'authored';\n  if (!hasTemplate || usesAuthoredMode) {\n    return {kind: 'frozen', value: params.value};\n  }\n\n  const resolved = resolveStepField({\n    field: params.field,\n    template: {segments: params.template},\n    context: params.context,\n    definitionId: params.definitionId,\n    errorField: params.field,\n  });\n  params.diagnostics.push(\n    ...resolved.diagnostics.map((diagnostic) => ({...diagnostic, field: params.field})),\n  );\n  params.trace.push(...resolved.trace.map((entry) => ({...entry, field: params.field})));\n  return fieldResolution(resolved);\n}\n\nfunction resolveOptionalAgentField(params: {\n  readonly field: 'agent.prompt' | 'agent.model' | 'agent.provider';\n  readonly value: string | undefined;\n  readonly template: ResolvedField['segments'] | undefined;\n  readonly context: WorkflowEvaluationContext;\n  readonly mode: StepConfigMode;\n  readonly diagnostics: WorkflowStepTemplateDiagnostic[];\n  readonly trace: WorkflowStepEvaluationTraceEntry[];\n  readonly definitionId: string;\n}): FieldResolution | undefined {\n  const hasValue = params.value !== undefined;\n  if (!hasValue) return undefined;\n  return resolveAgentField({...params, value: params.value});\n}\n\nfunction fieldResolution(resolved: SiteResolvedField): FieldResolution {\n  if (resolved.kind === 'residual') return {kind: 'residual', field: resolved.field};\n  return {kind: 'frozen', value: resolved.value};\n}\n\nfunction readConfigString(config: Record<string, unknown>, key: string): string | undefined {\n  const value = config[key];\n  return typeof value === 'string' ? value : undefined;\n}\n\nfunction readConfigThinking(config: Record<string, unknown>): AgentThinking | undefined {\n  const value = config.thinking;\n  return value === 'off' ||\n    value === 'minimal' ||\n    value === 'low' ||\n    value === 'medium' ||\n    value === 'high' ||\n    value === 'xhigh'\n    ? value\n    : undefined;\n}\n\nfunction readConfigHarness(\n  config: Record<string, unknown>,\n): WorkflowModelAgentStep['harness'] | undefined {\n  return config.harness === 'pi' || config.harness === 'claude' ? config.harness : undefined;\n}\n"],"names":["InvalidAgentModelError","UnsupportedHarnessProviderError","UnsupportedHarnessThinkingError","UnsupportedModelProviderError","AGENT_INTEGRATION_MCP_AUTH","AGENT_INTEGRATION_MCP_ENDPOINT","AGENT_INTEGRATION_MCP_SERVER_NAME","AGENT_INTEGRATION_MCP_TRANSPORT","materializeAgentIntegrations","AgentConfigUnresolvableError","completeStepFieldWithTrace","literalField","resolveStepField","resolveAgentStepConfig","params","fields","resolveAgentFields","usesAuthoredMode","mode","authoredAgentStepConfig","step","hasDeferredModelOrProvider","model","kind","provider","deferredAgentStepConfig","agentStepConfigWithDefaults","completeAgentConfig","agent","plan","undefined","prompt","readConfigString","config","completeAgentField","field","template","defaults","completeAgentDefaults","harness","readConfigHarness","thinking","readConfigThinking","resolveAgentDefaults","definitionId","tools","integrations","mcpServers","agentIntegrationMcpServers","args","resolved","errorField","context","trace","push","map","entry","value","error","cause","diagnostics","resolveAgentField","templates","resolveOptionalAgentField","hasTemplates","agentToolsConfig","authoredAgentIntegrationsConfig","configPlan","dispatchPlanField","materializedAgentIntegrationsConfig","providerValue","frozenFieldValue","modelValue","promptIsDeferred","promptValue","jobKey","stepId","id","agentToolContext","snapshot","agentToolSnapshot","name","transport","endpoint","auth","isResidual","isFrozen","hasTemplate","segments","diagnostic","fieldResolution","hasValue","key"],"mappings":"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"}

package/dist/core/step-config/assemble-run-context.d.ts

@@ -0,0 +1,94 @@
+import { type WorkflowExpressionEvaluationContext } from '@shipfox/expression';
+import type { Job, JobListeningTrigger } from '#core/entities/job.js';
+import type { JobExecution } from '#core/entities/job-execution.js';
+import type { Step, StepAttempt, StepStatus } from '#core/entities/step.js';
+import type { TriggerPayload, WorkflowRun } from '#core/entities/workflow-run.js';
+import type { WorkflowEvaluationContext } from './workflow-evaluation-context.js';
+export interface JobContextInput {
+    readonly job: Pick<Job, 'key' | 'status' | 'outputs'>;
+    readonly executions: readonly JobExecution[];
+}
+export interface AssembleWorkflowRunContextParams {
+    readonly run: Pick<WorkflowRun, 'id' | 'name' | 'definitionId' | 'projectId' | 'workspaceId' | 'createdAt'>;
+    readonly triggerPayload: TriggerPayload;
+    readonly inputs?: Record<string, unknown> | null | undefined;
+    readonly vars?: Record<string, string> | undefined;
+}
+export declare function assembleWorkflowRunContext(params: AssembleWorkflowRunContextParams): WorkflowExpressionEvaluationContext;
+export declare function assembleCreationContext(params: AssembleWorkflowRunContextParams): WorkflowEvaluationContext;
+export interface AssembleExecutionCreationContextParams extends AssembleWorkflowRunContextParams {
+    readonly jobId: string;
+    readonly sequence: number;
+    readonly executionName: string;
+    readonly status: JobExecution['status'];
+    readonly triggerEvents: readonly JobExecution['triggerEvents'][number][];
+    readonly priorExecutions: readonly JobExecution[];
+}
+export declare function assembleExecutionCreationContext(params: AssembleExecutionCreationContextParams): WorkflowEvaluationContext;
+/**
+ * Keeps job-success predicate values aligned with the registry's `executions`
+ * type environment.
+ */
+export declare function assembleExecutionsContext(executions: readonly JobExecution[]): WorkflowExpressionEvaluationContext;
+export declare function assembleJobsContext(jobs: readonly JobContextInput[]): WorkflowExpressionEvaluationContext & {
+    readonly jobs: Record<string, unknown>;
+};
+export interface AssembleJobActivationContextParams extends AssembleWorkflowRunContextParams {
+    readonly jobs: readonly JobContextInput[];
+}
+export declare function assembleJobActivationContext(params: AssembleJobActivationContextParams): WorkflowEvaluationContext;
+type ListenerSnapshotRoot = 'run' | 'trigger' | 'inputs' | 'job' | 'jobs';
+export interface MatcherSnapshotPlan {
+    readonly matcher: JobListeningTrigger;
+    readonly roots: ReadonlySet<ListenerSnapshotRoot>;
+    readonly jobKeys: ReadonlySet<string>;
+}
+export interface ListenerSnapshotPlan {
+    readonly on: readonly MatcherSnapshotPlan[];
+    readonly until: readonly MatcherSnapshotPlan[];
+    readonly roots: ReadonlySet<ListenerSnapshotRoot>;
+    readonly jobKeys: ReadonlySet<string>;
+}
+export declare function planListenerFilterSnapshots(params: {
+    readonly on: readonly JobListeningTrigger[];
+    readonly until: readonly JobListeningTrigger[] | null;
+}): ListenerSnapshotPlan;
+export declare function assembleListenerSnapshotContext(params: {
+    readonly job: Pick<Job, 'key'>;
+    readonly run: AssembleWorkflowRunContextParams['run'];
+    readonly triggerPayload: TriggerPayload;
+    readonly inputs?: Record<string, unknown> | null | undefined;
+    readonly plan: ListenerSnapshotPlan;
+    readonly dependencyJobs: readonly JobContextInput[];
+}): WorkflowExpressionEvaluationContext;
+export type ListenerTriggerWithSnapshot = JobListeningTrigger & {
+    readonly filter_snapshot?: Record<string, unknown>;
+};
+export declare function applyListenerFilterSnapshots(plans: readonly MatcherSnapshotPlan[], context: WorkflowExpressionEvaluationContext): ListenerTriggerWithSnapshot[];
+export declare function assembleStepDispatchContext(params: {
+    readonly steps: readonly Step[];
+    readonly attempts: readonly StepAttempt[];
+    readonly targetStepId: string;
+    readonly jobExecution?: JobExecution;
+    readonly jobs?: readonly JobContextInput[];
+}): WorkflowEvaluationContext;
+export declare function assembleGateContext(params: {
+    readonly status: StepStatus;
+    readonly exitCode: number | null;
+    readonly output?: Record<string, unknown> | null | undefined;
+}): WorkflowEvaluationContext;
+export declare function assembleJobResolutionContext(executions: readonly JobExecution[]): WorkflowEvaluationContext;
+export declare function assembleExecutionResolutionContext(params: {
+    readonly run: AssembleWorkflowRunContextParams['run'];
+    readonly triggerPayload: TriggerPayload;
+    readonly inputs?: Record<string, unknown> | null | undefined;
+    readonly vars?: Record<string, string> | undefined;
+    readonly job: Pick<Job, 'key'>;
+    readonly jobExecution: JobExecution;
+    readonly executions: readonly JobExecution[];
+    readonly steps: readonly Step[];
+    readonly attempts: readonly StepAttempt[];
+    readonly jobs?: readonly JobContextInput[];
+}): WorkflowEvaluationContext;
+export {};
+//# sourceMappingURL=assemble-run-context.d.ts.map

package/dist/core/step-config/assemble-run-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assemble-run-context.d.ts","sourceRoot":"","sources":["../../../src/core/step-config/assemble-run-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,mCAAmC,EACzC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAC,GAAG,EAAE,mBAAmB,EAAC,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAC,MAAM,wBAAwB,CAAC;AAC1E,OAAO,KAAK,EAAC,cAAc,EAAE,WAAW,EAAC,MAAM,gCAAgC,CAAC;AAChF,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,kCAAkC,CAAC;AAEhF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC;IACtD,QAAQ,CAAC,UAAU,EAAE,SAAS,YAAY,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,GAAG,EAAE,IAAI,CAChB,WAAW,EACX,IAAI,GAAG,MAAM,GAAG,cAAc,GAAG,WAAW,GAAG,aAAa,GAAG,WAAW,CAC3E,CAAC;IACF,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CACpD;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,gCAAgC,GACvC,mCAAmC,CAkBrC;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,gCAAgC,GACvC,yBAAyB,CAK3B;AAED,MAAM,WAAW,sCAAuC,SAAQ,gCAAgC;IAC9F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,SAAS,YAAY,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACzE,QAAQ,CAAC,eAAe,EAAE,SAAS,YAAY,EAAE,CAAC;CACnD;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,sCAAsC,GAC7C,yBAAyB,CA6B3B;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,SAAS,YAAY,EAAE,GAClC,mCAAmC,CAIrC;AAcD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,SAAS,eAAe,EAAE,GAC/B,mCAAmC,GAAG;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAC,CAIhF;AAED,MAAM,WAAW,kCAAmC,SAAQ,gCAAgC;IAC1F,QAAQ,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAC;CAC3C;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,kCAAkC,GACzC,yBAAyB,CAS3B;AAED,KAAK,oBAAoB,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAE1E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,oBAAoB,CAAC,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,oBAAoB,CAAC,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACvC;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,QAAQ,CAAC,EAAE,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,GAAG,IAAI,CAAC;CACvD,GAAG,oBAAoB,CAQvB;AAuCD,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACtD,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,gCAAgC,CAAC,KAAK,CAAC,CAAC;IACtD,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAC7D,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,SAAS,eAAe,EAAE,CAAC;CACrD,GAAG,mCAAmC,CAuBtC;AAaD,MAAM,MAAM,2BAA2B,GAAG,mBAAmB,GAAG;IAC9D,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpD,CAAC;AAEF,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,OAAO,EAAE,mCAAmC,GAC3C,2BAA2B,EAAE,CAO/B;AAsGD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CAC5C,GAAG,yBAAyB,CA2C5B;AAwDD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;CAC9D,GAAG,yBAAyB,CAW5B;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,SAAS,YAAY,EAAE,GAClC,yBAAyB,CAK3B;AAED,wBAAgB,kCAAkC,CAAC,MAAM,EAAE;IACzD,QAAQ,CAAC,GAAG,EAAE,gCAAgC,CAAC,KAAK,CAAC,CAAC;IACtD,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,SAAS,YAAY,EAAE,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CAC5C,GAAG,yBAAyB,CAoB5B"}