@shipfox/api-workflows 2.0.0

package/dist/core/job-transition/decide-job-activation.d.ts

@@ -0,0 +1,29 @@
+import type { WorkflowExpression } from '@shipfox/expression';
+import { explicitConditionTrace } from '../condition-trace.js';
+import { type Job, type JobStatusReason } from '../entities/job.js';
+import type { WorkflowRun } from '../entities/workflow-run.js';
+import { type JobContextInput } from '../step-config/assemble-run-context.js';
+import type { RuntimeCompletionStatus } from '../workflow-scheduling/runtime-dag.js';
+export type JobActivationDecision = {
+    kind: 'start-job';
+    jobId: string;
+} | {
+    kind: 'skip-job';
+    jobId: string;
+    status: 'skipped';
+    statusReason: JobStatusReason;
+    evaluationTrace: ReturnType<typeof explicitConditionTrace>;
+} | {
+    kind: 'terminal-job';
+    jobId: string;
+    status: RuntimeCompletionStatus;
+    jobVersion: number;
+};
+export interface DecideJobActivationInput {
+    run: WorkflowRun;
+    job: Job;
+    condition?: WorkflowExpression | undefined;
+    dependencies: readonly JobContextInput[];
+}
+export declare function decideJobActivation(input: DecideJobActivationInput): JobActivationDecision;
+//# sourceMappingURL=decide-job-activation.d.ts.map

package/dist/core/job-transition/decide-job-activation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decide-job-activation.d.ts","sourceRoot":"","sources":["../../../src/core/job-transition/decide-job-activation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAC,sBAAsB,EAAC,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAgB,KAAK,GAAG,EAAE,KAAK,eAAe,EAAC,MAAM,oBAAoB,CAAC;AACjF,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,uCAAuC,CAAC;AAGnF,MAAM,MAAM,qBAAqB,GAC7B;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,CAAC;IAClB,YAAY,EAAE,eAAe,CAAC;IAC9B,eAAe,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;CAC5D,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,uBAAuB,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEN,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,WAAW,CAAC;IACjB,GAAG,EAAE,GAAG,CAAC;IACT,SAAS,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC3C,YAAY,EAAE,SAAS,eAAe,EAAE,CAAC;CAC1C;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,qBAAqB,CAwC1F"}

package/dist/core/job-transition/decide-job-activation.js

@@ -0,0 +1,51 @@
+import { evaluatePlannedPredicateAtSite } from '@shipfox/expression';
+import { explicitConditionTrace } from '../condition-trace.js';
+import { isJobTerminal } from '../entities/job.js';
+import { assembleJobActivationContext } from '../step-config/assemble-run-context.js';
+import { runtimeCompletionStatusForJob } from './runtime-completion-status-for-job.js';
+export function decideJobActivation(input) {
+    if (isJobTerminal(input.job.status)) {
+        return {
+            kind: 'terminal-job',
+            jobId: input.job.id,
+            status: runtimeCompletionStatusForJob(input.job.status),
+            jobVersion: input.job.version
+        };
+    }
+    if (input.condition === undefined) return {
+        kind: 'start-job',
+        jobId: input.job.id
+    };
+    const context = assembleJobActivationContext({
+        run: input.run,
+        triggerPayload: input.run.triggerPayload,
+        inputs: input.run.inputs,
+        jobs: input.dependencies
+    });
+    const outcome = evaluatePlannedPredicateAtSite({
+        expression: input.condition,
+        field: 'job.if',
+        site: context.site,
+        context: context.values
+    });
+    if (outcome.value) return {
+        kind: 'start-job',
+        jobId: input.job.id
+    };
+    return {
+        kind: 'skip-job',
+        jobId: input.job.id,
+        status: 'skipped',
+        statusReason: outcome.evaluationFailed ? 'condition_errored' : 'condition_rejected',
+        evaluationTrace: explicitConditionTrace({
+            expression: input.condition,
+            field: 'job.if',
+            route: outcome.route,
+            site: context.site,
+            value: outcome.value,
+            degraded: outcome.evaluationFailed
+        })
+    };
+}
+
+//# sourceMappingURL=decide-job-activation.js.map

package/dist/core/job-transition/decide-job-activation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/job-transition/decide-job-activation.ts"],"sourcesContent":["import type {WorkflowExpression} from '@shipfox/expression';\nimport {evaluatePlannedPredicateAtSite} from '@shipfox/expression';\nimport {explicitConditionTrace} from '../condition-trace.js';\nimport {isJobTerminal, type Job, type JobStatusReason} from '../entities/job.js';\nimport type {WorkflowRun} from '../entities/workflow-run.js';\nimport {\n  assembleJobActivationContext,\n  type JobContextInput,\n} from '../step-config/assemble-run-context.js';\nimport type {RuntimeCompletionStatus} from '../workflow-scheduling/runtime-dag.js';\nimport {runtimeCompletionStatusForJob} from './runtime-completion-status-for-job.js';\n\nexport type JobActivationDecision =\n  | {\n      kind: 'start-job';\n      jobId: string;\n    }\n  | {\n      kind: 'skip-job';\n      jobId: string;\n      status: 'skipped';\n      statusReason: JobStatusReason;\n      evaluationTrace: ReturnType<typeof explicitConditionTrace>;\n    }\n  | {\n      kind: 'terminal-job';\n      jobId: string;\n      status: RuntimeCompletionStatus;\n      jobVersion: number;\n    };\n\nexport interface DecideJobActivationInput {\n  run: WorkflowRun;\n  job: Job;\n  condition?: WorkflowExpression | undefined;\n  dependencies: readonly JobContextInput[];\n}\n\nexport function decideJobActivation(input: DecideJobActivationInput): JobActivationDecision {\n  if (isJobTerminal(input.job.status)) {\n    return {\n      kind: 'terminal-job',\n      jobId: input.job.id,\n      status: runtimeCompletionStatusForJob(input.job.status),\n      jobVersion: input.job.version,\n    };\n  }\n\n  if (input.condition === undefined) return {kind: 'start-job', jobId: input.job.id};\n\n  const context = assembleJobActivationContext({\n    run: input.run,\n    triggerPayload: input.run.triggerPayload,\n    inputs: input.run.inputs,\n    jobs: input.dependencies,\n  });\n  const outcome = evaluatePlannedPredicateAtSite({\n    expression: input.condition,\n    field: 'job.if',\n    site: context.site,\n    context: context.values,\n  });\n  if (outcome.value) return {kind: 'start-job', jobId: input.job.id};\n\n  return {\n    kind: 'skip-job',\n    jobId: input.job.id,\n    status: 'skipped',\n    statusReason: outcome.evaluationFailed ? 'condition_errored' : 'condition_rejected',\n    evaluationTrace: explicitConditionTrace({\n      expression: input.condition,\n      field: 'job.if',\n      route: outcome.route,\n      site: context.site,\n      value: outcome.value,\n      degraded: outcome.evaluationFailed,\n    }),\n  };\n}\n"],"names":["evaluatePlannedPredicateAtSite","explicitConditionTrace","isJobTerminal","assembleJobActivationContext","runtimeCompletionStatusForJob","decideJobActivation","input","job","status","kind","jobId","id","jobVersion","version","condition","undefined","context","run","triggerPayload","inputs","jobs","dependencies","outcome","expression","field","site","values","value","statusReason","evaluationFailed","evaluationTrace","route","degraded"],"mappings":"AACA,SAAQA,8BAA8B,QAAO,sBAAsB;AACnE,SAAQC,sBAAsB,QAAO,wBAAwB;AAC7D,SAAQC,aAAa,QAAuC,qBAAqB;AAEjF,SACEC,4BAA4B,QAEvB,yCAAyC;AAEhD,SAAQC,6BAA6B,QAAO,yCAAyC;AA4BrF,OAAO,SAASC,oBAAoBC,KAA+B;IACjE,IAAIJ,cAAcI,MAAMC,GAAG,CAACC,MAAM,GAAG;QACnC,OAAO;YACLC,MAAM;YACNC,OAAOJ,MAAMC,GAAG,CAACI,EAAE;YACnBH,QAAQJ,8BAA8BE,MAAMC,GAAG,CAACC,MAAM;YACtDI,YAAYN,MAAMC,GAAG,CAACM,OAAO;QAC/B;IACF;IAEA,IAAIP,MAAMQ,SAAS,KAAKC,WAAW,OAAO;QAACN,MAAM;QAAaC,OAAOJ,MAAMC,GAAG,CAACI,EAAE;IAAA;IAEjF,MAAMK,UAAUb,6BAA6B;QAC3Cc,KAAKX,MAAMW,GAAG;QACdC,gBAAgBZ,MAAMW,GAAG,CAACC,cAAc;QACxCC,QAAQb,MAAMW,GAAG,CAACE,MAAM;QACxBC,MAAMd,MAAMe,YAAY;IAC1B;IACA,MAAMC,UAAUtB,+BAA+B;QAC7CuB,YAAYjB,MAAMQ,SAAS;QAC3BU,OAAO;QACPC,MAAMT,QAAQS,IAAI;QAClBT,SAASA,QAAQU,MAAM;IACzB;IACA,IAAIJ,QAAQK,KAAK,EAAE,OAAO;QAAClB,MAAM;QAAaC,OAAOJ,MAAMC,GAAG,CAACI,EAAE;IAAA;IAEjE,OAAO;QACLF,MAAM;QACNC,OAAOJ,MAAMC,GAAG,CAACI,EAAE;QACnBH,QAAQ;QACRoB,cAAcN,QAAQO,gBAAgB,GAAG,sBAAsB;QAC/DC,iBAAiB7B,uBAAuB;YACtCsB,YAAYjB,MAAMQ,SAAS;YAC3BU,OAAO;YACPO,OAAOT,QAAQS,KAAK;YACpBN,MAAMT,QAAQS,IAAI;YAClBE,OAAOL,QAAQK,KAAK;YACpBK,UAAUV,QAAQO,gBAAgB;QACpC;IACF;AACF"}

package/dist/core/job-transition/derive-job-execution-outputs.d.ts

@@ -0,0 +1,18 @@
+import type { WorkflowModel } from '@shipfox/api-definitions';
+import type { Job } from '../entities/job.js';
+import type { JobExecution } from '../entities/job-execution.js';
+import type { Step, StepAttempt } from '../entities/step.js';
+import type { WorkflowRun } from '../entities/workflow-run.js';
+import { type JobContextInput } from '../step-config/assemble-run-context.js';
+export declare function deriveJobExecutionOutputs(params: {
+    run: WorkflowRun;
+    modelJob: WorkflowModel['jobs'][number];
+    job: Job;
+    jobExecution: JobExecution;
+    executions: readonly JobExecution[];
+    steps: readonly Step[];
+    attempts: readonly StepAttempt[];
+    jobs: readonly JobContextInput[];
+    vars?: Record<string, string> | undefined;
+}): Record<string, unknown> | null;
+//# sourceMappingURL=derive-job-execution-outputs.d.ts.map

package/dist/core/job-transition/derive-job-execution-outputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-job-execution-outputs.d.ts","sourceRoot":"","sources":["../../../src/core/job-transition/derive-job-execution-outputs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,oBAAoB,CAAC;AAC5C,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAC,IAAI,EAAE,WAAW,EAAC,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,wCAAwC,CAAC;AAGhD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,GAAG,EAAE,WAAW,CAAC;IACjB,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;IACxC,GAAG,EAAE,GAAG,CAAC;IACT,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,SAAS,YAAY,EAAE,CAAC;IACpC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IACvB,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IACjC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC3C,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAmBjC"}

package/dist/core/job-transition/derive-job-execution-outputs.js

@@ -0,0 +1,23 @@
+import { assembleExecutionResolutionContext } from '../step-config/assemble-run-context.js';
+import { materializeJobOutputs } from '../step-config/materialize-workflow-model.js';
+export function deriveJobExecutionOutputs(params) {
+    const context = assembleExecutionResolutionContext({
+        run: params.run,
+        triggerPayload: params.run.triggerPayload,
+        inputs: params.run.inputs,
+        vars: params.vars,
+        job: params.job,
+        jobExecution: params.jobExecution,
+        executions: params.executions,
+        steps: params.steps,
+        attempts: params.attempts,
+        jobs: params.jobs
+    });
+    return materializeJobOutputs({
+        job: params.modelJob,
+        context,
+        definitionId: params.run.definitionId
+    });
+}
+
+//# sourceMappingURL=derive-job-execution-outputs.js.map

package/dist/core/job-transition/derive-job-execution-outputs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/job-transition/derive-job-execution-outputs.ts"],"sourcesContent":["import type {WorkflowModel} from '@shipfox/api-definitions';\nimport type {Job} from '../entities/job.js';\nimport type {JobExecution} from '../entities/job-execution.js';\nimport type {Step, StepAttempt} from '../entities/step.js';\nimport type {WorkflowRun} from '../entities/workflow-run.js';\nimport {\n  assembleExecutionResolutionContext,\n  type JobContextInput,\n} from '../step-config/assemble-run-context.js';\nimport {materializeJobOutputs} from '../step-config/materialize-workflow-model.js';\n\nexport function deriveJobExecutionOutputs(params: {\n  run: WorkflowRun;\n  modelJob: WorkflowModel['jobs'][number];\n  job: Job;\n  jobExecution: JobExecution;\n  executions: readonly JobExecution[];\n  steps: readonly Step[];\n  attempts: readonly StepAttempt[];\n  jobs: readonly JobContextInput[];\n  vars?: Record<string, string> | undefined;\n}): Record<string, unknown> | null {\n  const context = assembleExecutionResolutionContext({\n    run: params.run,\n    triggerPayload: params.run.triggerPayload,\n    inputs: params.run.inputs,\n    vars: params.vars,\n    job: params.job,\n    jobExecution: params.jobExecution,\n    executions: params.executions,\n    steps: params.steps,\n    attempts: params.attempts,\n    jobs: params.jobs,\n  });\n\n  return materializeJobOutputs({\n    job: params.modelJob,\n    context,\n    definitionId: params.run.definitionId,\n  });\n}\n"],"names":["assembleExecutionResolutionContext","materializeJobOutputs","deriveJobExecutionOutputs","params","context","run","triggerPayload","inputs","vars","job","jobExecution","executions","steps","attempts","jobs","modelJob","definitionId"],"mappings":"AAKA,SACEA,kCAAkC,QAE7B,yCAAyC;AAChD,SAAQC,qBAAqB,QAAO,+CAA+C;AAEnF,OAAO,SAASC,0BAA0BC,MAUzC;IACC,MAAMC,UAAUJ,mCAAmC;QACjDK,KAAKF,OAAOE,GAAG;QACfC,gBAAgBH,OAAOE,GAAG,CAACC,cAAc;QACzCC,QAAQJ,OAAOE,GAAG,CAACE,MAAM;QACzBC,MAAML,OAAOK,IAAI;QACjBC,KAAKN,OAAOM,GAAG;QACfC,cAAcP,OAAOO,YAAY;QACjCC,YAAYR,OAAOQ,UAAU;QAC7BC,OAAOT,OAAOS,KAAK;QACnBC,UAAUV,OAAOU,QAAQ;QACzBC,MAAMX,OAAOW,IAAI;IACnB;IAEA,OAAOb,sBAAsB;QAC3BQ,KAAKN,OAAOY,QAAQ;QACpBX;QACAY,cAAcb,OAAOE,GAAG,CAACW,YAAY;IACvC;AACF"}

package/dist/core/job-transition/derive-job-success.d.ts

@@ -0,0 +1,16 @@
+import type { JobStatusReason } from '../entities/job.js';
+import type { JobExecution } from '../entities/job-execution.js';
+import type { PersistedEvaluationTraceEntry } from '../entities/step.js';
+import { type JobContextInput } from '../step-config/assemble-run-context.js';
+import type { RuntimeCompletionStatus } from '../workflow-scheduling/runtime-dag.js';
+export interface DeriveJobSuccessResult {
+    status: RuntimeCompletionStatus;
+    statusReason: JobStatusReason | null;
+    trace: readonly PersistedEvaluationTraceEntry[];
+}
+export declare function deriveJobSuccess(params: {
+    success: string | null;
+    executions: readonly JobExecution[];
+    jobs: readonly JobContextInput[];
+}): DeriveJobSuccessResult;
+//# sourceMappingURL=derive-job-success.d.ts.map

package/dist/core/job-transition/derive-job-success.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-job-success.d.ts","sourceRoot":"","sources":["../../../src/core/job-transition/derive-job-success.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAC,6BAA6B,EAAC,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,uCAAuC,CAAC;AAEnF,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,uBAAuB,CAAC;IAChC,YAAY,EAAE,eAAe,GAAG,IAAI,CAAC;IACrC,KAAK,EAAE,SAAS,6BAA6B,EAAE,CAAC;CACjD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,SAAS,YAAY,EAAE,CAAC;IACpC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAC;CAClC,GAAG,sBAAsB,CAuCzB"}

package/dist/core/job-transition/derive-job-success.js

@@ -0,0 +1,47 @@
+import { DEFAULT_JOB_SUCCESS } from '@shipfox/api-definitions';
+import { capTraceEntries, createWorkflowExpression, evaluatePlannedPredicateAtSite, predicateTraceEntry } from '@shipfox/expression';
+import { assembleExecutionsContext, assembleJobsContext } from '../step-config/assemble-run-context.js';
+export function deriveJobSuccess(params) {
+    const expression = createWorkflowExpression({
+        source: params.success ?? DEFAULT_JOB_SUCCESS,
+        check: {
+            mode: 'syntax'
+        }
+    });
+    const context = {
+        ...assembleExecutionsContext(params.executions),
+        ...assembleJobsContext(params.jobs)
+    };
+    const outcome = evaluatePlannedPredicateAtSite({
+        expression,
+        field: 'job.success',
+        site: 'job-resolution',
+        context
+    });
+    const trace = capTraceEntries([
+        {
+            ...predicateTraceEntry({
+                expression: expression.source,
+                route: outcome.route,
+                site: 'job-resolution',
+                value: outcome.value,
+                degraded: outcome.evaluationFailed
+            }),
+            field: 'job.success'
+        }
+    ]);
+    const passed = outcome.value;
+    const status = passed ? 'succeeded' : 'failed';
+    if (status === 'succeeded') return {
+        status,
+        statusReason: null,
+        trace
+    };
+    return {
+        status,
+        statusReason: outcome.evaluationFailed ? 'unknown' : params.executions.find((execution)=>execution.statusReason)?.statusReason ?? 'step_failed',
+        trace
+    };
+}
+
+//# sourceMappingURL=derive-job-success.js.map

package/dist/core/job-transition/derive-job-success.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/job-transition/derive-job-success.ts"],"sourcesContent":["import {DEFAULT_JOB_SUCCESS} from '@shipfox/api-definitions';\nimport {\n  capTraceEntries,\n  createWorkflowExpression,\n  evaluatePlannedPredicateAtSite,\n  predicateTraceEntry,\n} from '@shipfox/expression';\nimport type {JobStatusReason} from '../entities/job.js';\nimport type {JobExecution} from '../entities/job-execution.js';\nimport type {PersistedEvaluationTraceEntry} from '../entities/step.js';\nimport {\n  assembleExecutionsContext,\n  assembleJobsContext,\n  type JobContextInput,\n} from '../step-config/assemble-run-context.js';\nimport type {RuntimeCompletionStatus} from '../workflow-scheduling/runtime-dag.js';\n\nexport interface DeriveJobSuccessResult {\n  status: RuntimeCompletionStatus;\n  statusReason: JobStatusReason | null;\n  trace: readonly PersistedEvaluationTraceEntry[];\n}\n\nexport function deriveJobSuccess(params: {\n  success: string | null;\n  executions: readonly JobExecution[];\n  jobs: readonly JobContextInput[];\n}): DeriveJobSuccessResult {\n  const expression = createWorkflowExpression({\n    source: params.success ?? DEFAULT_JOB_SUCCESS,\n    check: {mode: 'syntax'},\n  });\n  const context = {\n    ...assembleExecutionsContext(params.executions),\n    ...assembleJobsContext(params.jobs),\n  };\n  const outcome = evaluatePlannedPredicateAtSite({\n    expression,\n    field: 'job.success',\n    site: 'job-resolution',\n    context,\n  });\n  const trace = capTraceEntries([\n    {\n      ...predicateTraceEntry({\n        expression: expression.source,\n        route: outcome.route,\n        site: 'job-resolution',\n        value: outcome.value,\n        degraded: outcome.evaluationFailed,\n      }),\n      field: 'job.success',\n    },\n  ]);\n  const passed = outcome.value;\n  const status: RuntimeCompletionStatus = passed ? 'succeeded' : 'failed';\n  if (status === 'succeeded') return {status, statusReason: null, trace};\n\n  return {\n    status,\n    statusReason: outcome.evaluationFailed\n      ? 'unknown'\n      : (params.executions.find((execution) => execution.statusReason)?.statusReason ??\n        'step_failed'),\n    trace,\n  };\n}\n"],"names":["DEFAULT_JOB_SUCCESS","capTraceEntries","createWorkflowExpression","evaluatePlannedPredicateAtSite","predicateTraceEntry","assembleExecutionsContext","assembleJobsContext","deriveJobSuccess","params","expression","source","success","check","mode","context","executions","jobs","outcome","field","site","trace","route","value","degraded","evaluationFailed","passed","status","statusReason","find","execution"],"mappings":"AAAA,SAAQA,mBAAmB,QAAO,2BAA2B;AAC7D,SACEC,eAAe,EACfC,wBAAwB,EACxBC,8BAA8B,EAC9BC,mBAAmB,QACd,sBAAsB;AAI7B,SACEC,yBAAyB,EACzBC,mBAAmB,QAEd,yCAAyC;AAShD,OAAO,SAASC,iBAAiBC,MAIhC;IACC,MAAMC,aAAaP,yBAAyB;QAC1CQ,QAAQF,OAAOG,OAAO,IAAIX;QAC1BY,OAAO;YAACC,MAAM;QAAQ;IACxB;IACA,MAAMC,UAAU;QACd,GAAGT,0BAA0BG,OAAOO,UAAU,CAAC;QAC/C,GAAGT,oBAAoBE,OAAOQ,IAAI,CAAC;IACrC;IACA,MAAMC,UAAUd,+BAA+B;QAC7CM;QACAS,OAAO;QACPC,MAAM;QACNL;IACF;IACA,MAAMM,QAAQnB,gBAAgB;QAC5B;YACE,GAAGG,oBAAoB;gBACrBK,YAAYA,WAAWC,MAAM;gBAC7BW,OAAOJ,QAAQI,KAAK;gBACpBF,MAAM;gBACNG,OAAOL,QAAQK,KAAK;gBACpBC,UAAUN,QAAQO,gBAAgB;YACpC,EAAE;YACFN,OAAO;QACT;KACD;IACD,MAAMO,SAASR,QAAQK,KAAK;IAC5B,MAAMI,SAAkCD,SAAS,cAAc;IAC/D,IAAIC,WAAW,aAAa,OAAO;QAACA;QAAQC,cAAc;QAAMP;IAAK;IAErE,OAAO;QACLM;QACAC,cAAcV,QAAQO,gBAAgB,GAClC,YACChB,OAAOO,UAAU,CAACa,IAAI,CAAC,CAACC,YAAcA,UAAUF,YAAY,GAAGA,gBAChE;QACJP;IACF;AACF"}

package/dist/core/job-transition/index.d.ts

@@ -0,0 +1,5 @@
+export { type DecideJobActivationInput, decideJobActivation, type JobActivationDecision, } from './decide-job-activation.js';
+export { deriveJobExecutionOutputs } from './derive-job-execution-outputs.js';
+export { type DeriveJobSuccessResult, deriveJobSuccess, } from './derive-job-success.js';
+export { runtimeCompletionStatusForJob } from './runtime-completion-status-for-job.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/job-transition/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/job-transition/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,wBAAwB,EAC7B,mBAAmB,EACnB,KAAK,qBAAqB,GAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAC,yBAAyB,EAAC,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EACL,KAAK,sBAAsB,EAC3B,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAC,6BAA6B,EAAC,MAAM,wCAAwC,CAAC"}

package/dist/core/job-transition/index.js

@@ -0,0 +1,6 @@
+export { decideJobActivation } from './decide-job-activation.js';
+export { deriveJobExecutionOutputs } from './derive-job-execution-outputs.js';
+export { deriveJobSuccess } from './derive-job-success.js';
+export { runtimeCompletionStatusForJob } from './runtime-completion-status-for-job.js';
+
+//# sourceMappingURL=index.js.map

package/dist/core/job-transition/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/job-transition/index.ts"],"sourcesContent":["export {\n  type DecideJobActivationInput,\n  decideJobActivation,\n  type JobActivationDecision,\n} from './decide-job-activation.js';\nexport {deriveJobExecutionOutputs} from './derive-job-execution-outputs.js';\nexport {\n  type DeriveJobSuccessResult,\n  deriveJobSuccess,\n} from './derive-job-success.js';\nexport {runtimeCompletionStatusForJob} from './runtime-completion-status-for-job.js';\n"],"names":["decideJobActivation","deriveJobExecutionOutputs","deriveJobSuccess","runtimeCompletionStatusForJob"],"mappings":"AAAA,SAEEA,mBAAmB,QAEd,6BAA6B;AACpC,SAAQC,yBAAyB,QAAO,oCAAoC;AAC5E,SAEEC,gBAAgB,QACX,0BAA0B;AACjC,SAAQC,6BAA6B,QAAO,yCAAyC"}

package/dist/core/job-transition/runtime-completion-status-for-job.d.ts

@@ -0,0 +1,4 @@
+import type { JobStatus } from '../entities/job.js';
+import type { RuntimeCompletionStatus } from '../workflow-scheduling/runtime-dag.js';
+export declare function runtimeCompletionStatusForJob(status: JobStatus): RuntimeCompletionStatus;
+//# sourceMappingURL=runtime-completion-status-for-job.d.ts.map

package/dist/core/job-transition/runtime-completion-status-for-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-completion-status-for-job.d.ts","sourceRoot":"","sources":["../../../src/core/job-transition/runtime-completion-status-for-job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,uCAAuC,CAAC;AAEnF,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,GAAG,uBAAuB,CAUxF"}

package/dist/core/job-transition/runtime-completion-status-for-job.js

@@ -0,0 +1,8 @@
+export function runtimeCompletionStatusForJob(status) {
+    if (status === 'succeeded' || status === 'failed' || status === 'cancelled' || status === 'skipped') {
+        return status;
+    }
+    throw new Error(`Job status is not terminal: ${status}`);
+}
+
+//# sourceMappingURL=runtime-completion-status-for-job.js.map

package/dist/core/job-transition/runtime-completion-status-for-job.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/job-transition/runtime-completion-status-for-job.ts"],"sourcesContent":["import type {JobStatus} from '../entities/job.js';\nimport type {RuntimeCompletionStatus} from '../workflow-scheduling/runtime-dag.js';\n\nexport function runtimeCompletionStatusForJob(status: JobStatus): RuntimeCompletionStatus {\n  if (\n    status === 'succeeded' ||\n    status === 'failed' ||\n    status === 'cancelled' ||\n    status === 'skipped'\n  ) {\n    return status;\n  }\n  throw new Error(`Job status is not terminal: ${status}`);\n}\n"],"names":["runtimeCompletionStatusForJob","status","Error"],"mappings":"AAGA,OAAO,SAASA,8BAA8BC,MAAiB;IAC7D,IACEA,WAAW,eACXA,WAAW,YACXA,WAAW,eACXA,WAAW,WACX;QACA,OAAOA;IACT;IACA,MAAM,IAAIC,MAAM,CAAC,4BAA4B,EAAED,QAAQ;AACzD"}

package/dist/core/listener-execution-materialization.d.ts

@@ -0,0 +1,30 @@
+import { type AgentDefaultsResolver } from '@shipfox/api-agent/core/resolve-agent-config';
+import type { WorkflowModel } from '@shipfox/api-definitions';
+import type { AgentToolMaterializationContext, AgentToolMaterializationSnapshot } from './agent-tools.js';
+import type { Job } from './entities/job.js';
+import type { JobExecution, JobExecutionStatus, WorkflowExecutionEvent } from './entities/job-execution.js';
+import type { PersistedEvaluationTraceEntry } from './entities/step.js';
+import type { WorkflowRun } from './entities/workflow-run.js';
+import { type MaterializedWorkflowStep } from './step-config/index.js';
+export interface MaterializeListenerExecutionParams {
+    readonly model: WorkflowModel | null;
+    readonly run: Pick<WorkflowRun, 'id' | 'name' | 'definitionId' | 'projectId' | 'workspaceId' | 'createdAt' | 'triggerPayload' | 'inputs'>;
+    readonly job: Pick<Job, 'id' | 'key'>;
+    readonly sequence: number;
+    readonly triggerEvents: readonly WorkflowExecutionEvent[];
+    readonly priorExecutions: readonly JobExecution[];
+    readonly resolveAgentDefaults?: AgentDefaultsResolver | undefined;
+    readonly agentToolContext?: AgentToolMaterializationContext | undefined;
+    readonly agentToolSnapshot?: AgentToolMaterializationSnapshot | null | undefined;
+}
+export interface MaterializedListenerExecution {
+    readonly name: string;
+    readonly runner: readonly string[];
+    readonly status: JobExecutionStatus;
+    readonly statusReason: 'unknown' | null;
+    readonly triggerEvents: readonly WorkflowExecutionEvent[];
+    readonly evaluationTrace: readonly PersistedEvaluationTraceEntry[] | null;
+    readonly steps: readonly MaterializedWorkflowStep[];
+}
+export declare function materializeListenerExecution(params: MaterializeListenerExecutionParams): MaterializedListenerExecution;
+//# sourceMappingURL=listener-execution-materialization.d.ts.map

package/dist/core/listener-execution-materialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listener-execution-materialization.d.ts","sourceRoot":"","sources":["../../src/core/listener-execution-materialization.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,qBAAqB,EAE3B,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EACV,+BAA+B,EAC/B,gCAAgC,EACjC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,mBAAmB,CAAC;AAC3C,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAC,6BAA6B,EAAC,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,4BAA4B,CAAC;AAO5D,OAAO,EAEL,KAAK,wBAAwB,EAI9B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAChB,WAAW,EACT,IAAI,GACJ,MAAM,GACN,cAAc,GACd,WAAW,GACX,aAAa,GACb,WAAW,GACX,gBAAgB,GAChB,QAAQ,CACX,CAAC;IACF,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,GAAG,KAAK,CAAC,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC1D,QAAQ,CAAC,eAAe,EAAE,SAAS,YAAY,EAAE,CAAC;IAClD,QAAQ,CAAC,oBAAoB,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAClE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,+BAA+B,GAAG,SAAS,CAAC;IACxE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,gCAAgC,GAAG,IAAI,GAAG,SAAS,CAAC;CAClF;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,SAAS,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC1D,QAAQ,CAAC,eAAe,EAAE,SAAS,6BAA6B,EAAE,GAAG,IAAI,CAAC;IAC1E,QAAQ,CAAC,KAAK,EAAE,SAAS,wBAAwB,EAAE,CAAC;CACrD;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,kCAAkC,GACzC,6BAA6B,CAyD/B"}

package/dist/core/listener-execution-materialization.js

@@ -0,0 +1,87 @@
+import { catalogDefaultAgentResolver } from '@shipfox/api-agent/core/resolve-agent-config';
+import { AgentConfigUnresolvableError, AgentIntegrationMaterializationError, InterpolationUnresolvableError, InvalidJobRunnerLabelsError } from './errors.js';
+import { assembleExecutionCreationContext, materializeJobExecutionSteps, materializeJobRunner, resolveJobExecutionName } from './step-config/index.js';
+export function materializeListenerExecution(params) {
+    const fallbackName = `${params.job.key} #${params.sequence}`;
+    let executionName = fallbackName;
+    let evaluationTrace = [];
+    let runner = [];
+    let steps = [];
+    let status = 'pending';
+    try {
+        if (!params.model) throw new PermanentListenerMaterializationError('Run attempt has no model');
+        const modelJob = params.model.jobs.find((job)=>job.key === params.job.key);
+        if (!modelJob) {
+            throw new PermanentListenerMaterializationError(`Workflow model has no job key: ${params.job.key}`);
+        }
+        const resolvedName = resolveJobExecutionName({
+            definitionId: params.run.definitionId,
+            job: modelJob,
+            fallbackName,
+            context: listenerExecutionContext({
+                ...params,
+                executionName,
+                status
+            }).values
+        });
+        executionName = resolvedName.value;
+        evaluationTrace = resolvedName.trace;
+        const context = listenerExecutionContext({
+            ...params,
+            executionName,
+            status
+        });
+        runner = materializeJobRunner({
+            job: modelJob,
+            context,
+            definitionId: params.run.definitionId
+        });
+        steps = materializeJobExecutionSteps({
+            model: params.model,
+            job: modelJob,
+            context,
+            resolveAgentDefaults: params.resolveAgentDefaults ?? catalogDefaultAgentResolver,
+            definitionId: params.run.definitionId,
+            agentToolContext: params.agentToolContext,
+            agentToolSnapshot: params.agentToolSnapshot
+        });
+    } catch (error) {
+        if (!isPermanentListenerMaterializationError(error)) throw error;
+        status = 'failed';
+        steps = [];
+        runner = [];
+    }
+    return {
+        name: executionName,
+        runner,
+        status,
+        statusReason: status === 'failed' ? 'unknown' : null,
+        triggerEvents: params.triggerEvents,
+        evaluationTrace: evaluationTrace.length === 0 ? null : evaluationTrace,
+        steps
+    };
+}
+function listenerExecutionContext(params) {
+    return assembleExecutionCreationContext({
+        run: params.run,
+        triggerPayload: params.run.triggerPayload,
+        inputs: params.run.inputs,
+        jobId: params.job.id,
+        sequence: params.sequence,
+        executionName: params.executionName,
+        status: params.status,
+        triggerEvents: params.triggerEvents,
+        priorExecutions: params.priorExecutions
+    });
+}
+let PermanentListenerMaterializationError = class PermanentListenerMaterializationError extends Error {
+    constructor(message){
+        super(message);
+        this.name = 'PermanentListenerMaterializationError';
+    }
+};
+function isPermanentListenerMaterializationError(error) {
+    return error instanceof PermanentListenerMaterializationError || error instanceof InterpolationUnresolvableError || error instanceof InvalidJobRunnerLabelsError || error instanceof AgentConfigUnresolvableError || error instanceof AgentIntegrationMaterializationError;
+}
+
+//# sourceMappingURL=listener-execution-materialization.js.map

package/dist/core/listener-execution-materialization.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/listener-execution-materialization.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 {\n  AgentToolMaterializationContext,\n  AgentToolMaterializationSnapshot,\n} from './agent-tools.js';\nimport type {Job} from './entities/job.js';\nimport type {\n  JobExecution,\n  JobExecutionStatus,\n  WorkflowExecutionEvent,\n} from './entities/job-execution.js';\nimport type {PersistedEvaluationTraceEntry} from './entities/step.js';\nimport type {WorkflowRun} from './entities/workflow-run.js';\nimport {\n  AgentConfigUnresolvableError,\n  AgentIntegrationMaterializationError,\n  InterpolationUnresolvableError,\n  InvalidJobRunnerLabelsError,\n} from './errors.js';\nimport {\n  assembleExecutionCreationContext,\n  type MaterializedWorkflowStep,\n  materializeJobExecutionSteps,\n  materializeJobRunner,\n  resolveJobExecutionName,\n} from './step-config/index.js';\n\nexport interface MaterializeListenerExecutionParams {\n  readonly model: WorkflowModel | null;\n  readonly run: Pick<\n    WorkflowRun,\n    | 'id'\n    | 'name'\n    | 'definitionId'\n    | 'projectId'\n    | 'workspaceId'\n    | 'createdAt'\n    | 'triggerPayload'\n    | 'inputs'\n  >;\n  readonly job: Pick<Job, 'id' | 'key'>;\n  readonly sequence: number;\n  readonly triggerEvents: readonly WorkflowExecutionEvent[];\n  readonly priorExecutions: readonly JobExecution[];\n  readonly resolveAgentDefaults?: AgentDefaultsResolver | undefined;\n  readonly agentToolContext?: AgentToolMaterializationContext | undefined;\n  readonly agentToolSnapshot?: AgentToolMaterializationSnapshot | null | undefined;\n}\n\nexport interface MaterializedListenerExecution {\n  readonly name: string;\n  readonly runner: readonly string[];\n  readonly status: JobExecutionStatus;\n  readonly statusReason: 'unknown' | null;\n  readonly triggerEvents: readonly WorkflowExecutionEvent[];\n  readonly evaluationTrace: readonly PersistedEvaluationTraceEntry[] | null;\n  readonly steps: readonly MaterializedWorkflowStep[];\n}\n\nexport function materializeListenerExecution(\n  params: MaterializeListenerExecutionParams,\n): MaterializedListenerExecution {\n  const fallbackName = `${params.job.key} #${params.sequence}`;\n  let executionName = fallbackName;\n  let evaluationTrace: readonly PersistedEvaluationTraceEntry[] = [];\n  let runner: readonly string[] = [];\n  let steps: readonly MaterializedWorkflowStep[] = [];\n  let status: JobExecutionStatus = 'pending';\n\n  try {\n    if (!params.model) throw new PermanentListenerMaterializationError('Run attempt has no model');\n    const modelJob = params.model.jobs.find((job) => job.key === params.job.key);\n    if (!modelJob) {\n      throw new PermanentListenerMaterializationError(\n        `Workflow model has no job key: ${params.job.key}`,\n      );\n    }\n\n    const resolvedName = resolveJobExecutionName({\n      definitionId: params.run.definitionId,\n      job: modelJob,\n      fallbackName,\n      context: listenerExecutionContext({...params, executionName, status}).values,\n    });\n    executionName = resolvedName.value;\n    evaluationTrace = resolvedName.trace;\n\n    const context = listenerExecutionContext({...params, executionName, status});\n    runner = materializeJobRunner({\n      job: modelJob,\n      context,\n      definitionId: params.run.definitionId,\n    });\n    steps = materializeJobExecutionSteps({\n      model: params.model,\n      job: modelJob,\n      context,\n      resolveAgentDefaults: params.resolveAgentDefaults ?? catalogDefaultAgentResolver,\n      definitionId: params.run.definitionId,\n      agentToolContext: params.agentToolContext,\n      agentToolSnapshot: params.agentToolSnapshot,\n    });\n  } catch (error) {\n    if (!isPermanentListenerMaterializationError(error)) throw error;\n    status = 'failed';\n    steps = [];\n    runner = [];\n  }\n\n  return {\n    name: executionName,\n    runner,\n    status,\n    statusReason: status === 'failed' ? 'unknown' : null,\n    triggerEvents: params.triggerEvents,\n    evaluationTrace: evaluationTrace.length === 0 ? null : evaluationTrace,\n    steps,\n  };\n}\n\nfunction listenerExecutionContext(\n  params: Pick<\n    MaterializeListenerExecutionParams,\n    'run' | 'job' | 'sequence' | 'triggerEvents' | 'priorExecutions'\n  > & {\n    readonly executionName: string;\n    readonly status: JobExecutionStatus;\n  },\n) {\n  return assembleExecutionCreationContext({\n    run: params.run,\n    triggerPayload: params.run.triggerPayload,\n    inputs: params.run.inputs,\n    jobId: params.job.id,\n    sequence: params.sequence,\n    executionName: params.executionName,\n    status: params.status,\n    triggerEvents: params.triggerEvents,\n    priorExecutions: params.priorExecutions,\n  });\n}\n\nclass PermanentListenerMaterializationError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'PermanentListenerMaterializationError';\n  }\n}\n\nfunction isPermanentListenerMaterializationError(error: unknown): boolean {\n  return (\n    error instanceof PermanentListenerMaterializationError ||\n    error instanceof InterpolationUnresolvableError ||\n    error instanceof InvalidJobRunnerLabelsError ||\n    error instanceof AgentConfigUnresolvableError ||\n    error instanceof AgentIntegrationMaterializationError\n  );\n}\n"],"names":["catalogDefaultAgentResolver","AgentConfigUnresolvableError","AgentIntegrationMaterializationError","InterpolationUnresolvableError","InvalidJobRunnerLabelsError","assembleExecutionCreationContext","materializeJobExecutionSteps","materializeJobRunner","resolveJobExecutionName","materializeListenerExecution","params","fallbackName","job","key","sequence","executionName","evaluationTrace","runner","steps","status","model","PermanentListenerMaterializationError","modelJob","jobs","find","resolvedName","definitionId","run","context","listenerExecutionContext","values","value","trace","resolveAgentDefaults","agentToolContext","agentToolSnapshot","error","isPermanentListenerMaterializationError","name","statusReason","triggerEvents","length","triggerPayload","inputs","jobId","id","priorExecutions","Error","message"],"mappings":"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"}

package/dist/core/run-workflow.d.ts

@@ -0,0 +1,11 @@
+import type { TriggerPayload, WorkflowRun } from './entities/workflow-run.js';
+export interface RunWorkflowParams {
+    workspaceId: string;
+    projectId: string;
+    definitionId: string;
+    triggerPayload: TriggerPayload;
+    inputs?: Record<string, unknown> | undefined;
+    triggerIdempotencyKey?: string | undefined;
+}
+export declare function runWorkflow(params: RunWorkflowParams): Promise<WorkflowRun>;
+//# sourceMappingURL=run-workflow.d.ts.map

package/dist/core/run-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-workflow.d.ts","sourceRoot":"","sources":["../../src/core/run-workflow.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,cAAc,EAAE,WAAW,EAAC,MAAM,4BAA4B,CAAC;AAI5E,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC7C,qBAAqB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAuBjF"}

package/dist/core/run-workflow.js

@@ -0,0 +1,28 @@
+import { catalogDefaultAgentResolver } from '@shipfox/api-agent/core/resolve-agent-config';
+import { createWorkspaceAgentDefaultsResolver } from '@shipfox/api-agent/core/workspace-agent-defaults-resolver';
+import { getDefinitionById } from '@shipfox/api-definitions';
+import { createWorkflowRun } from '#db/workflow-runs.js';
+import { DefinitionNotFoundError, ProjectMismatchError } from './errors.js';
+import { modelHasAgentStep } from './step-config/materialize-workflow-model.js';
+export async function runWorkflow(params) {
+    const definition = await getDefinitionById(params.definitionId);
+    if (!definition) throw new DefinitionNotFoundError(params.definitionId);
+    if (definition.projectId !== params.projectId) {
+        throw new ProjectMismatchError(definition.projectId, params.projectId);
+    }
+    const resolveAgentDefaults = modelHasAgentStep(definition.model) ? await createWorkspaceAgentDefaultsResolver(params.workspaceId) : catalogDefaultAgentResolver;
+    return createWorkflowRun({
+        workspaceId: params.workspaceId,
+        projectId: params.projectId,
+        definitionId: definition.id,
+        name: definition.name,
+        model: definition.model,
+        triggerPayload: params.triggerPayload,
+        inputs: params.inputs,
+        sourceSnapshot: definition.sourceSnapshot,
+        triggerIdempotencyKey: params.triggerIdempotencyKey,
+        resolveAgentDefaults
+    });
+}
+
+//# sourceMappingURL=run-workflow.js.map

package/dist/core/run-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/run-workflow.ts"],"sourcesContent":["import {catalogDefaultAgentResolver} from '@shipfox/api-agent/core/resolve-agent-config';\nimport {createWorkspaceAgentDefaultsResolver} from '@shipfox/api-agent/core/workspace-agent-defaults-resolver';\nimport {getDefinitionById} from '@shipfox/api-definitions';\nimport {createWorkflowRun} from '#db/workflow-runs.js';\nimport type {TriggerPayload, WorkflowRun} from './entities/workflow-run.js';\nimport {DefinitionNotFoundError, ProjectMismatchError} from './errors.js';\nimport {modelHasAgentStep} from './step-config/materialize-workflow-model.js';\n\nexport interface RunWorkflowParams {\n  workspaceId: string;\n  projectId: string;\n  definitionId: string;\n  triggerPayload: TriggerPayload;\n  inputs?: Record<string, unknown> | undefined;\n  triggerIdempotencyKey?: string | undefined;\n}\n\nexport async function runWorkflow(params: RunWorkflowParams): Promise<WorkflowRun> {\n  const definition = await getDefinitionById(params.definitionId);\n  if (!definition) throw new DefinitionNotFoundError(params.definitionId);\n\n  if (definition.projectId !== params.projectId) {\n    throw new ProjectMismatchError(definition.projectId, params.projectId);\n  }\n  const resolveAgentDefaults = modelHasAgentStep(definition.model)\n    ? await createWorkspaceAgentDefaultsResolver(params.workspaceId)\n    : catalogDefaultAgentResolver;\n\n  return createWorkflowRun({\n    workspaceId: params.workspaceId,\n    projectId: params.projectId,\n    definitionId: definition.id,\n    name: definition.name,\n    model: definition.model,\n    triggerPayload: params.triggerPayload,\n    inputs: params.inputs,\n    sourceSnapshot: definition.sourceSnapshot,\n    triggerIdempotencyKey: params.triggerIdempotencyKey,\n    resolveAgentDefaults,\n  });\n}\n"],"names":["catalogDefaultAgentResolver","createWorkspaceAgentDefaultsResolver","getDefinitionById","createWorkflowRun","DefinitionNotFoundError","ProjectMismatchError","modelHasAgentStep","runWorkflow","params","definition","definitionId","projectId","resolveAgentDefaults","model","workspaceId","id","name","triggerPayload","inputs","sourceSnapshot","triggerIdempotencyKey"],"mappings":"AAAA,SAAQA,2BAA2B,QAAO,+CAA+C;AACzF,SAAQC,oCAAoC,QAAO,4DAA4D;AAC/G,SAAQC,iBAAiB,QAAO,2BAA2B;AAC3D,SAAQC,iBAAiB,QAAO,uBAAuB;AAEvD,SAAQC,uBAAuB,EAAEC,oBAAoB,QAAO,cAAc;AAC1E,SAAQC,iBAAiB,QAAO,8CAA8C;AAW9E,OAAO,eAAeC,YAAYC,MAAyB;IACzD,MAAMC,aAAa,MAAMP,kBAAkBM,OAAOE,YAAY;IAC9D,IAAI,CAACD,YAAY,MAAM,IAAIL,wBAAwBI,OAAOE,YAAY;IAEtE,IAAID,WAAWE,SAAS,KAAKH,OAAOG,SAAS,EAAE;QAC7C,MAAM,IAAIN,qBAAqBI,WAAWE,SAAS,EAAEH,OAAOG,SAAS;IACvE;IACA,MAAMC,uBAAuBN,kBAAkBG,WAAWI,KAAK,IAC3D,MAAMZ,qCAAqCO,OAAOM,WAAW,IAC7Dd;IAEJ,OAAOG,kBAAkB;QACvBW,aAAaN,OAAOM,WAAW;QAC/BH,WAAWH,OAAOG,SAAS;QAC3BD,cAAcD,WAAWM,EAAE;QAC3BC,MAAMP,WAAWO,IAAI;QACrBH,OAAOJ,WAAWI,KAAK;QACvBI,gBAAgBT,OAAOS,cAAc;QACrCC,QAAQV,OAAOU,MAAM;QACrBC,gBAAgBV,WAAWU,cAAc;QACzCC,uBAAuBZ,OAAOY,qBAAqB;QACnDR;IACF;AACF"}

package/dist/core/source-control.d.ts

@@ -0,0 +1,5 @@
+import type { IntegrationSourceControlService } from '@shipfox/api-integration-core';
+export declare function setSourceControl(service: IntegrationSourceControlService): void;
+export declare function clearSourceControl(): void;
+export declare function sourceControl(): IntegrationSourceControlService;
+//# sourceMappingURL=source-control.d.ts.map

package/dist/core/source-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-control.d.ts","sourceRoot":"","sources":["../../src/core/source-control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,+BAA+B,EAAC,MAAM,+BAA+B,CAAC;AAQnF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,+BAA+B,GAAG,IAAI,CAE/E;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,wBAAgB,aAAa,IAAI,+BAA+B,CAK/D"}

package/dist/core/source-control.js

@@ -0,0 +1,19 @@
+// Boot-set holder for the integration source-control service, mirroring the db()
+// singleton. The composition root injects it once at startup; routes read it.
+// Workflows cannot construct the service itself (it needs the integration provider
+// registry and connection lookup that live in @shipfox/api-integration-core).
+let _sourceControl;
+export function setSourceControl(service) {
+    _sourceControl = service;
+}
+export function clearSourceControl() {
+    _sourceControl = undefined;
+}
+export function sourceControl() {
+    if (!_sourceControl) {
+        throw new Error('workflows: source-control integration is not configured');
+    }
+    return _sourceControl;
+}
+
+//# sourceMappingURL=source-control.js.map

package/dist/core/source-control.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/source-control.ts"],"sourcesContent":["import type {IntegrationSourceControlService} from '@shipfox/api-integration-core';\n\n// Boot-set holder for the integration source-control service, mirroring the db()\n// singleton. The composition root injects it once at startup; routes read it.\n// Workflows cannot construct the service itself (it needs the integration provider\n// registry and connection lookup that live in @shipfox/api-integration-core).\nlet _sourceControl: IntegrationSourceControlService | undefined;\n\nexport function setSourceControl(service: IntegrationSourceControlService): void {\n  _sourceControl = service;\n}\n\nexport function clearSourceControl(): void {\n  _sourceControl = undefined;\n}\n\nexport function sourceControl(): IntegrationSourceControlService {\n  if (!_sourceControl) {\n    throw new Error('workflows: source-control integration is not configured');\n  }\n  return _sourceControl;\n}\n"],"names":["_sourceControl","setSourceControl","service","clearSourceControl","undefined","sourceControl","Error"],"mappings":"AAEA,iFAAiF;AACjF,8EAA8E;AAC9E,mFAAmF;AACnF,8EAA8E;AAC9E,IAAIA;AAEJ,OAAO,SAASC,iBAAiBC,OAAwC;IACvEF,iBAAiBE;AACnB;AAEA,OAAO,SAASC;IACdH,iBAAiBI;AACnB;AAEA,OAAO,SAASC;IACd,IAAI,CAACL,gBAAgB;QACnB,MAAM,IAAIM,MAAM;IAClB;IACA,OAAON;AACT"}

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

@@ -0,0 +1,49 @@
+import type { AgentDefaultsResolver } from '@shipfox/api-agent/core/resolve-agent-config';
+import { type AgentThinking } from '@shipfox/api-agent-dto';
+import type { WorkflowModel } from '@shipfox/api-definitions';
+import { type AgentToolMaterializationContext, type AgentToolMaterializationSnapshot } from '#core/agent-tools.js';
+import type { PersistedEvaluationTraceEntry, StepConfigDispatchPlan } from '#core/entities/step.js';
+import { type WorkflowStepEvaluationTraceEntry, type WorkflowStepTemplateDiagnostic } from './fields.js';
+import type { WorkflowEvaluationContext } from './workflow-evaluation-context.js';
+type WorkflowModelJob = WorkflowModel['jobs'][number];
+type WorkflowModelStep = WorkflowModelJob['steps'][number];
+type WorkflowModelAgentStep = Extract<WorkflowModelStep, {
+    kind: 'agent';
+}>;
+type StepConfigMode = 'effective' | 'authored';
+export interface ResolveAgentStepConfigParams {
+    readonly jobKey: string;
+    readonly step: WorkflowModelAgentStep;
+    readonly context: WorkflowEvaluationContext;
+    readonly mode: StepConfigMode;
+    readonly definitionId: string;
+    readonly resolveAgentDefaults: AgentDefaultsResolver;
+    readonly agentToolContext?: AgentToolMaterializationContext | undefined;
+    readonly agentToolSnapshot?: AgentToolMaterializationSnapshot | null | undefined;
+}
+export interface AgentStepConfig {
+    readonly config: Record<string, unknown>;
+    readonly configPlan: StepConfigDispatchPlan | null;
+    readonly diagnostics: readonly WorkflowStepTemplateDiagnostic[];
+    readonly trace: readonly WorkflowStepEvaluationTraceEntry[];
+    readonly hasTemplates: boolean;
+}
+export declare function resolveAgentStepConfig(params: ResolveAgentStepConfigParams): AgentStepConfig;
+export declare function completeAgentConfig(params: {
+    readonly config: Record<string, unknown>;
+    readonly plan: StepConfigDispatchPlan;
+    readonly context: WorkflowEvaluationContext;
+    readonly resolveAgentDefaults: AgentDefaultsResolver;
+    readonly definitionId: string;
+    readonly trace: PersistedEvaluationTraceEntry[];
+}): void;
+export declare function completeAgentDefaults(params: {
+    readonly harness: WorkflowModelAgentStep['harness'] | undefined;
+    readonly provider: string | undefined;
+    readonly model: string | undefined;
+    readonly thinking: AgentThinking | undefined;
+    readonly resolveAgentDefaults: AgentDefaultsResolver;
+    readonly definitionId: string;
+}): ReturnType<AgentDefaultsResolver>;
+export {};
+//# sourceMappingURL=agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/core/step-config/agent.ts"],"names":[],"mappings":"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"}