@shipfox/expression 1.1.5 → 1.2.1

package/dist/plan/freeze.js

@@ -4,61 +4,53 @@ import { WorkflowTemplateResolutionError } from '../resolver/errors.js';
 import { resolveContextRootAvailability } from '../workflow-context/workflow-context.js';
 import { evaluationTraceEntry } from './evaluation-trace.js';
 import { shouldFillAtSite } from './fill.js';
-/**
- * Segment lifecycle:
- *
- * `{expr}` -> plan -> `{deferred, fillTarget}` -> freeze at a site at or after
- * `fillTarget` -> `{literal}`. Runner-fill segments are never filled server-side.
- *
- * Value fields follow their declared policy at their fill target. Predicates use
- * the planned predicate entry point and fail closed when evaluation is deferred.
- */ export function freezeResolvedFieldAtSite(params) {
+export function freezeResolvedFieldAtSite(params) {
     let value = '';
+    let typedValue;
+    let hasTypedValue = false;
     const diagnostics = [];
     const trace = [];
+    const preserveSingleExpressionType = isExactSingleExpressionField(params);
     for (const segment of params.field.segments){
         if (segment.kind === 'literal') {
             value += segment.value;
             continue;
         }
         if (!shouldFillAtSite(segment.fillTarget, params.site)) {
+            if (exactTypedFieldRequiresFailure(params, segment)) {
+                throw typedFieldNotFillableAtSite(segment);
+            }
             diagnostics.push(missingPathDiagnostic(segment));
             continue;
         }
-        try {
-            const literal = coerceWorkflowValueToString(evaluateWorkflowExpression(segment.expression, params.context));
-            value += literal;
-            trace.push(fillTraceEntry(segment, params.site, literal));
-        } catch (error) {
-            if (error instanceof WorkflowExpressionEvaluationError && error.reason === 'missing-path') {
-                if (missingPathRequiresFailure(segment, params.failurePolicy, params.site)) {
-                    throw new WorkflowTemplateResolutionError({
-                        source: segment.expression.source,
-                        cause: error
-                    });
-                }
-                diagnostics.push(missingPathDiagnostic(segment));
-                trace.push(fillTraceEntry(segment, params.site, '', true));
-                continue;
-            }
-            throw new WorkflowTemplateResolutionError({
-                source: segment.expression.source,
-                cause: error
-            });
+        const evaluated = evaluateFillableSegment(params, segment);
+        trace.push(evaluated.trace);
+        if (evaluated.kind === 'degraded') {
+            diagnostics.push(evaluated.diagnostic);
+            continue;
+        }
+        if (preserveSingleExpressionType) {
+            typedValue = evaluated.value;
+            hasTypedValue = true;
+        } else {
+            value += evaluated.literal;
         }
     }
     return {
-        value,
+        value: preserveSingleExpressionType && hasTypedValue ? typedValue : value,
         diagnostics,
         trace
     };
 }
 export function resolveFieldAtSite(params) {
     let value = '';
+    let typedValue;
+    let hasTypedValue = false;
     const diagnostics = [];
     const trace = [];
     const segments = [];
     let hasResidual = false;
+    const preserveSingleExpressionType = isExactSingleExpressionField(params);
     for (const segment of params.field.segments){
         if (segment.kind === 'literal') {
             value += segment.value;
@@ -70,35 +62,26 @@ export function resolveFieldAtSite(params) {
             segments.push(segment);
             continue;
         }
-        try {
-            const literal = coerceWorkflowValueToString(evaluateWorkflowExpression(segment.expression, params.context));
-            value += literal;
+        const evaluated = evaluateFillableSegment(params, segment);
+        trace.push(evaluated.trace);
+        if (evaluated.kind === 'degraded') {
+            diagnostics.push(evaluated.diagnostic);
             segments.push({
                 kind: 'literal',
-                value: literal
-            });
-            trace.push(fillTraceEntry(segment, params.site, literal));
-        } catch (error) {
-            if (error instanceof WorkflowExpressionEvaluationError && error.reason === 'missing-path') {
-                if (missingPathRequiresFailure(segment, params.failurePolicy, params.site)) {
-                    throw new WorkflowTemplateResolutionError({
-                        source: segment.expression.source,
-                        cause: error
-                    });
-                }
-                diagnostics.push(missingPathDiagnostic(segment));
-                segments.push({
-                    kind: 'literal',
-                    value: ''
-                });
-                trace.push(fillTraceEntry(segment, params.site, '', true));
-                continue;
-            }
-            throw new WorkflowTemplateResolutionError({
-                source: segment.expression.source,
-                cause: error
+                value: ''
             });
+            continue;
+        }
+        if (preserveSingleExpressionType) {
+            typedValue = evaluated.value;
+            hasTypedValue = true;
+        } else {
+            value += evaluated.literal;
         }
+        segments.push({
+            kind: 'literal',
+            value: evaluated.literal
+        });
     }
     if (hasResidual) return {
         kind: 'residual',
@@ -110,11 +93,44 @@ export function resolveFieldAtSite(params) {
     };
     return {
         kind: 'frozen',
-        value,
+        value: preserveSingleExpressionType && hasTypedValue ? typedValue : value,
         diagnostics,
         trace
     };
 }
+function isExactSingleExpressionField(params) {
+    return params.preserveSingleExpressionType === true && params.field.segments.length === 1 && params.field.segments[0]?.kind === 'deferred';
+}
+function evaluateFillableSegment(params, segment) {
+    try {
+        const value = evaluateWorkflowExpression(segment.expression, params.context);
+        const literal = coerceWorkflowValueToString(value);
+        return {
+            kind: 'evaluated',
+            value,
+            literal,
+            trace: fillTraceEntry(segment, params.site, literal)
+        };
+    } catch (error) {
+        if (error instanceof WorkflowExpressionEvaluationError && error.reason === 'missing-path') {
+            if (fieldMissingPathRequiresFailure(params, segment)) {
+                throw new WorkflowTemplateResolutionError({
+                    source: segment.expression.source,
+                    cause: error
+                });
+            }
+            return {
+                kind: 'degraded',
+                diagnostic: missingPathDiagnostic(segment),
+                trace: fillTraceEntry(segment, params.site, '', true)
+            };
+        }
+        throw new WorkflowTemplateResolutionError({
+            source: segment.expression.source,
+            cause: error
+        });
+    }
+}
 function fillTraceEntry(segment, site, value, degraded = false) {
     return evaluationTraceEntry({
         expression: segment.expression.source,
@@ -127,6 +143,18 @@ function fillTraceEntry(segment, site, value, degraded = false) {
         } : {}
     });
 }
+function fieldMissingPathRequiresFailure(params, segment) {
+    return isExactSingleExpressionField(params) && params.failurePolicy === 'fail' || missingPathRequiresFailure(segment, params.failurePolicy, params.site);
+}
+function exactTypedFieldRequiresFailure(params, segment) {
+    return isExactSingleExpressionField(params) && params.failurePolicy === 'fail' && segment.fillTarget !== 'runner-fill';
+}
+function typedFieldNotFillableAtSite(segment) {
+    return new WorkflowTemplateResolutionError({
+        source: segment.expression.source,
+        cause: new Error('Typed field is not fillable at this site.')
+    });
+}
 function missingPathDiagnostic(segment) {
     return {
         reason: 'missing-path',

package/dist/plan/freeze.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/plan/freeze.ts"],"sourcesContent":["import {\n  evaluateWorkflowExpression,\n  type WorkflowExpressionEvaluationContext,\n  WorkflowExpressionEvaluationError,\n} from '../evaluator/index.js';\nimport {coerceWorkflowValueToString} from '../resolver/coerce-workflow-value-to-string.js';\nimport {WorkflowTemplateResolutionError} from '../resolver/errors.js';\nimport {\n  type AvailabilitySite,\n  resolveContextRootAvailability,\n  type WorkflowInterpolationFailurePolicy,\n} from '../workflow-context/workflow-context.js';\nimport {type EvaluationTraceEntry, evaluationTraceEntry} from './evaluation-trace.js';\nimport {shouldFillAtSite} from './fill.js';\nimport type {\n  ResolvedField,\n  ResolvedFieldDeferredSegment,\n  ResolvedFieldSegment,\n} from './resolved-field.js';\n\nexport type WorkflowTemplateFailurePolicy = WorkflowInterpolationFailurePolicy;\n\nexport interface WorkflowTemplateDiagnostic {\n  readonly reason: 'missing-path';\n  readonly expression: string;\n  readonly contextRoots: readonly string[];\n}\n\nexport interface FrozenResolvedField {\n  readonly value: string;\n  readonly diagnostics: readonly WorkflowTemplateDiagnostic[];\n  readonly trace: readonly EvaluationTraceEntry[];\n}\n\nexport type SiteResolvedField =\n  | {\n      readonly kind: 'frozen';\n      readonly value: string;\n      readonly diagnostics: readonly WorkflowTemplateDiagnostic[];\n      readonly trace: readonly EvaluationTraceEntry[];\n    }\n  | {\n      readonly kind: 'residual';\n      readonly field: ResolvedField;\n      readonly diagnostics: readonly WorkflowTemplateDiagnostic[];\n      readonly trace: readonly EvaluationTraceEntry[];\n    };\n\n/**\n * Segment lifecycle:\n *\n * `{expr}` -> plan -> `{deferred, fillTarget}` -> freeze at a site at or after\n * `fillTarget` -> `{literal}`. Runner-fill segments are never filled server-side.\n *\n * Value fields follow their declared policy at their fill target. Predicates use\n * the planned predicate entry point and fail closed when evaluation is deferred.\n */\nexport function freezeResolvedFieldAtSite(params: {\n  readonly field: ResolvedField;\n  readonly failurePolicy: WorkflowInterpolationFailurePolicy;\n  readonly site: AvailabilitySite;\n  readonly context: WorkflowExpressionEvaluationContext;\n}): FrozenResolvedField {\n  let value = '';\n  const diagnostics: WorkflowTemplateDiagnostic[] = [];\n  const trace: EvaluationTraceEntry[] = [];\n\n  for (const segment of params.field.segments) {\n    if (segment.kind === 'literal') {\n      value += segment.value;\n      continue;\n    }\n\n    if (!shouldFillAtSite(segment.fillTarget, params.site)) {\n      diagnostics.push(missingPathDiagnostic(segment));\n      continue;\n    }\n\n    try {\n      const literal = coerceWorkflowValueToString(\n        evaluateWorkflowExpression(segment.expression, params.context),\n      );\n      value += literal;\n      trace.push(fillTraceEntry(segment, params.site, literal));\n    } catch (error) {\n      if (error instanceof WorkflowExpressionEvaluationError && error.reason === 'missing-path') {\n        if (missingPathRequiresFailure(segment, params.failurePolicy, params.site)) {\n          throw new WorkflowTemplateResolutionError({\n            source: segment.expression.source,\n            cause: error,\n          });\n        }\n\n        diagnostics.push(missingPathDiagnostic(segment));\n        trace.push(fillTraceEntry(segment, params.site, '', true));\n        continue;\n      }\n\n      throw new WorkflowTemplateResolutionError({\n        source: segment.expression.source,\n        cause: error,\n      });\n    }\n  }\n\n  return {value, diagnostics, trace};\n}\n\nexport function resolveFieldAtSite(params: {\n  readonly field: ResolvedField;\n  readonly failurePolicy: WorkflowInterpolationFailurePolicy;\n  readonly site: AvailabilitySite;\n  readonly context: WorkflowExpressionEvaluationContext;\n}): SiteResolvedField {\n  let value = '';\n  const diagnostics: WorkflowTemplateDiagnostic[] = [];\n  const trace: EvaluationTraceEntry[] = [];\n  const segments: ResolvedFieldSegment[] = [];\n  let hasResidual = false;\n\n  for (const segment of params.field.segments) {\n    if (segment.kind === 'literal') {\n      value += segment.value;\n      segments.push(segment);\n      continue;\n    }\n\n    if (!shouldFillAtSite(segment.fillTarget, params.site)) {\n      hasResidual = true;\n      segments.push(segment);\n      continue;\n    }\n\n    try {\n      const literal = coerceWorkflowValueToString(\n        evaluateWorkflowExpression(segment.expression, params.context),\n      );\n      value += literal;\n      segments.push({kind: 'literal', value: literal});\n      trace.push(fillTraceEntry(segment, params.site, literal));\n    } catch (error) {\n      if (error instanceof WorkflowExpressionEvaluationError && error.reason === 'missing-path') {\n        if (missingPathRequiresFailure(segment, params.failurePolicy, params.site)) {\n          throw new WorkflowTemplateResolutionError({\n            source: segment.expression.source,\n            cause: error,\n          });\n        }\n\n        diagnostics.push(missingPathDiagnostic(segment));\n        segments.push({kind: 'literal', value: ''});\n        trace.push(fillTraceEntry(segment, params.site, '', true));\n        continue;\n      }\n\n      throw new WorkflowTemplateResolutionError({\n        source: segment.expression.source,\n        cause: error,\n      });\n    }\n  }\n\n  if (hasResidual) return {kind: 'residual', field: {segments}, diagnostics, trace};\n  return {kind: 'frozen', value, diagnostics, trace};\n}\n\nfunction fillTraceEntry(\n  segment: ResolvedFieldDeferredSegment,\n  site: AvailabilitySite,\n  value: string,\n  degraded = false,\n): EvaluationTraceEntry {\n  return evaluationTraceEntry({\n    expression: segment.expression.source,\n    roots: segment.roots,\n    fillTarget: segment.fillTarget,\n    evaluatedAt: site,\n    value,\n    ...(degraded ? {degraded: true} : {}),\n  });\n}\n\nfunction missingPathDiagnostic(segment: ResolvedFieldDeferredSegment): WorkflowTemplateDiagnostic {\n  return {\n    reason: 'missing-path',\n    expression: segment.expression.source,\n    contextRoots: segment.roots,\n  };\n}\n\nfunction missingPathRequiresFailure(\n  segment: ResolvedFieldDeferredSegment,\n  failurePolicy: WorkflowInterpolationFailurePolicy,\n  site: AvailabilitySite,\n): boolean {\n  if (failurePolicy !== 'fail') return false;\n  const rootAvailabilities = segment.roots.flatMap((root) => {\n    const availability = resolveContextRootAvailability(root);\n    return availability === undefined ? [] : [availability];\n  });\n  return (\n    rootAvailabilities.length > 0 &&\n    rootAvailabilities.every((availability) => shouldFillAtSite(availability, site))\n  );\n}\n"],"names":["evaluateWorkflowExpression","WorkflowExpressionEvaluationError","coerceWorkflowValueToString","WorkflowTemplateResolutionError","resolveContextRootAvailability","evaluationTraceEntry","shouldFillAtSite","freezeResolvedFieldAtSite","params","value","diagnostics","trace","segment","field","segments","kind","fillTarget","site","push","missingPathDiagnostic","literal","expression","context","fillTraceEntry","error","reason","missingPathRequiresFailure","failurePolicy","source","cause","resolveFieldAtSite","hasResidual","degraded","roots","evaluatedAt","contextRoots","rootAvailabilities","flatMap","root","availability","undefined","length","every"],"mappings":"AAAA,SACEA,0BAA0B,EAE1BC,iCAAiC,QAC5B,wBAAwB;AAC/B,SAAQC,2BAA2B,QAAO,iDAAiD;AAC3F,SAAQC,+BAA+B,QAAO,wBAAwB;AACtE,SAEEC,8BAA8B,QAEzB,0CAA0C;AACjD,SAAmCC,oBAAoB,QAAO,wBAAwB;AACtF,SAAQC,gBAAgB,QAAO,YAAY;AAmC3C;;;;;;;;CAQC,GACD,OAAO,SAASC,0BAA0BC,MAKzC;IACC,IAAIC,QAAQ;IACZ,MAAMC,cAA4C,EAAE;IACpD,MAAMC,QAAgC,EAAE;IAExC,KAAK,MAAMC,WAAWJ,OAAOK,KAAK,CAACC,QAAQ,CAAE;QAC3C,IAAIF,QAAQG,IAAI,KAAK,WAAW;YAC9BN,SAASG,QAAQH,KAAK;YACtB;QACF;QAEA,IAAI,CAACH,iBAAiBM,QAAQI,UAAU,EAAER,OAAOS,IAAI,GAAG;YACtDP,YAAYQ,IAAI,CAACC,sBAAsBP;YACvC;QACF;QAEA,IAAI;YACF,MAAMQ,UAAUlB,4BACdF,2BAA2BY,QAAQS,UAAU,EAAEb,OAAOc,OAAO;YAE/Db,SAASW;YACTT,MAAMO,IAAI,CAACK,eAAeX,SAASJ,OAAOS,IAAI,EAAEG;QAClD,EAAE,OAAOI,OAAO;YACd,IAAIA,iBAAiBvB,qCAAqCuB,MAAMC,MAAM,KAAK,gBAAgB;gBACzF,IAAIC,2BAA2Bd,SAASJ,OAAOmB,aAAa,EAAEnB,OAAOS,IAAI,GAAG;oBAC1E,MAAM,IAAId,gCAAgC;wBACxCyB,QAAQhB,QAAQS,UAAU,CAACO,MAAM;wBACjCC,OAAOL;oBACT;gBACF;gBAEAd,YAAYQ,IAAI,CAACC,sBAAsBP;gBACvCD,MAAMO,IAAI,CAACK,eAAeX,SAASJ,OAAOS,IAAI,EAAE,IAAI;gBACpD;YACF;YAEA,MAAM,IAAId,gCAAgC;gBACxCyB,QAAQhB,QAAQS,UAAU,CAACO,MAAM;gBACjCC,OAAOL;YACT;QACF;IACF;IAEA,OAAO;QAACf;QAAOC;QAAaC;IAAK;AACnC;AAEA,OAAO,SAASmB,mBAAmBtB,MAKlC;IACC,IAAIC,QAAQ;IACZ,MAAMC,cAA4C,EAAE;IACpD,MAAMC,QAAgC,EAAE;IACxC,MAAMG,WAAmC,EAAE;IAC3C,IAAIiB,cAAc;IAElB,KAAK,MAAMnB,WAAWJ,OAAOK,KAAK,CAACC,QAAQ,CAAE;QAC3C,IAAIF,QAAQG,IAAI,KAAK,WAAW;YAC9BN,SAASG,QAAQH,KAAK;YACtBK,SAASI,IAAI,CAACN;YACd;QACF;QAEA,IAAI,CAACN,iBAAiBM,QAAQI,UAAU,EAAER,OAAOS,IAAI,GAAG;YACtDc,cAAc;YACdjB,SAASI,IAAI,CAACN;YACd;QACF;QAEA,IAAI;YACF,MAAMQ,UAAUlB,4BACdF,2BAA2BY,QAAQS,UAAU,EAAEb,OAAOc,OAAO;YAE/Db,SAASW;YACTN,SAASI,IAAI,CAAC;gBAACH,MAAM;gBAAWN,OAAOW;YAAO;YAC9CT,MAAMO,IAAI,CAACK,eAAeX,SAASJ,OAAOS,IAAI,EAAEG;QAClD,EAAE,OAAOI,OAAO;YACd,IAAIA,iBAAiBvB,qCAAqCuB,MAAMC,MAAM,KAAK,gBAAgB;gBACzF,IAAIC,2BAA2Bd,SAASJ,OAAOmB,aAAa,EAAEnB,OAAOS,IAAI,GAAG;oBAC1E,MAAM,IAAId,gCAAgC;wBACxCyB,QAAQhB,QAAQS,UAAU,CAACO,MAAM;wBACjCC,OAAOL;oBACT;gBACF;gBAEAd,YAAYQ,IAAI,CAACC,sBAAsBP;gBACvCE,SAASI,IAAI,CAAC;oBAACH,MAAM;oBAAWN,OAAO;gBAAE;gBACzCE,MAAMO,IAAI,CAACK,eAAeX,SAASJ,OAAOS,IAAI,EAAE,IAAI;gBACpD;YACF;YAEA,MAAM,IAAId,gCAAgC;gBACxCyB,QAAQhB,QAAQS,UAAU,CAACO,MAAM;gBACjCC,OAAOL;YACT;QACF;IACF;IAEA,IAAIO,aAAa,OAAO;QAAChB,MAAM;QAAYF,OAAO;YAACC;QAAQ;QAAGJ;QAAaC;IAAK;IAChF,OAAO;QAACI,MAAM;QAAUN;QAAOC;QAAaC;IAAK;AACnD;AAEA,SAASY,eACPX,OAAqC,EACrCK,IAAsB,EACtBR,KAAa,EACbuB,WAAW,KAAK;IAEhB,OAAO3B,qBAAqB;QAC1BgB,YAAYT,QAAQS,UAAU,CAACO,MAAM;QACrCK,OAAOrB,QAAQqB,KAAK;QACpBjB,YAAYJ,QAAQI,UAAU;QAC9BkB,aAAajB;QACbR;QACA,GAAIuB,WAAW;YAACA,UAAU;QAAI,IAAI,CAAC,CAAC;IACtC;AACF;AAEA,SAASb,sBAAsBP,OAAqC;IAClE,OAAO;QACLa,QAAQ;QACRJ,YAAYT,QAAQS,UAAU,CAACO,MAAM;QACrCO,cAAcvB,QAAQqB,KAAK;IAC7B;AACF;AAEA,SAASP,2BACPd,OAAqC,EACrCe,aAAiD,EACjDV,IAAsB;IAEtB,IAAIU,kBAAkB,QAAQ,OAAO;IACrC,MAAMS,qBAAqBxB,QAAQqB,KAAK,CAACI,OAAO,CAAC,CAACC;QAChD,MAAMC,eAAenC,+BAA+BkC;QACpD,OAAOC,iBAAiBC,YAAY,EAAE,GAAG;YAACD;SAAa;IACzD;IACA,OACEH,mBAAmBK,MAAM,GAAG,KAC5BL,mBAAmBM,KAAK,CAAC,CAACH,eAAiBjC,iBAAiBiC,cAActB;AAE9E"}
+{"version":3,"sources":["../../src/plan/freeze.ts"],"sourcesContent":["import {\n  evaluateWorkflowExpression,\n  type WorkflowExpressionEvaluationContext,\n  WorkflowExpressionEvaluationError,\n} from '../evaluator/index.js';\nimport {coerceWorkflowValueToString} from '../resolver/coerce-workflow-value-to-string.js';\nimport {WorkflowTemplateResolutionError} from '../resolver/errors.js';\nimport {\n  type AvailabilitySite,\n  resolveContextRootAvailability,\n  type WorkflowInterpolationFailurePolicy,\n} from '../workflow-context/workflow-context.js';\nimport {type EvaluationTraceEntry, evaluationTraceEntry} from './evaluation-trace.js';\nimport {shouldFillAtSite} from './fill.js';\nimport type {\n  ResolvedField,\n  ResolvedFieldDeferredSegment,\n  ResolvedFieldSegment,\n} from './resolved-field.js';\n\nexport type WorkflowTemplateFailurePolicy = WorkflowInterpolationFailurePolicy;\n\nexport interface WorkflowTemplateDiagnostic {\n  readonly reason: 'missing-path';\n  readonly expression: string;\n  readonly contextRoots: readonly string[];\n}\n\nexport interface FrozenResolvedField<Value = string> {\n  readonly value: Value;\n  readonly diagnostics: readonly WorkflowTemplateDiagnostic[];\n  readonly trace: readonly EvaluationTraceEntry[];\n}\n\nexport type SiteResolvedField<Value = string> =\n  | {\n      readonly kind: 'frozen';\n      readonly value: Value;\n      readonly diagnostics: readonly WorkflowTemplateDiagnostic[];\n      readonly trace: readonly EvaluationTraceEntry[];\n    }\n  | {\n      readonly kind: 'residual';\n      readonly field: ResolvedField;\n      readonly diagnostics: readonly WorkflowTemplateDiagnostic[];\n      readonly trace: readonly EvaluationTraceEntry[];\n    };\n\ninterface ResolveFieldAtSiteParams {\n  readonly field: ResolvedField;\n  readonly failurePolicy: WorkflowInterpolationFailurePolicy;\n  readonly site: AvailabilitySite;\n  readonly context: WorkflowExpressionEvaluationContext;\n  /** Preserve the value of an exact single expression instead of stringifying it. */\n  readonly preserveSingleExpressionType?: boolean;\n}\n\n/**\n * Segment lifecycle:\n *\n * `{expr}` -> plan -> `{deferred, fillTarget}` -> freeze at a site at or after\n * `fillTarget` -> `{literal}`. Runner-fill segments are never filled server-side.\n *\n * Value fields follow their declared policy at their fill target. Predicates use\n * the planned predicate entry point and fail closed when evaluation is deferred.\n */\nexport function freezeResolvedFieldAtSite(\n  params: ResolveFieldAtSiteParams & {readonly preserveSingleExpressionType: true},\n): FrozenResolvedField<unknown>;\nexport function freezeResolvedFieldAtSite(\n  params: ResolveFieldAtSiteParams & {readonly preserveSingleExpressionType?: false},\n): FrozenResolvedField;\nexport function freezeResolvedFieldAtSite(\n  params: ResolveFieldAtSiteParams,\n): FrozenResolvedField<unknown>;\nexport function freezeResolvedFieldAtSite(\n  params: ResolveFieldAtSiteParams,\n): FrozenResolvedField<unknown> {\n  let value = '';\n  let typedValue: unknown;\n  let hasTypedValue = false;\n  const diagnostics: WorkflowTemplateDiagnostic[] = [];\n  const trace: EvaluationTraceEntry[] = [];\n  const preserveSingleExpressionType = isExactSingleExpressionField(params);\n\n  for (const segment of params.field.segments) {\n    if (segment.kind === 'literal') {\n      value += segment.value;\n      continue;\n    }\n\n    if (!shouldFillAtSite(segment.fillTarget, params.site)) {\n      if (exactTypedFieldRequiresFailure(params, segment)) {\n        throw typedFieldNotFillableAtSite(segment);\n      }\n      diagnostics.push(missingPathDiagnostic(segment));\n      continue;\n    }\n\n    const evaluated = evaluateFillableSegment(params, segment);\n    trace.push(evaluated.trace);\n    if (evaluated.kind === 'degraded') {\n      diagnostics.push(evaluated.diagnostic);\n      continue;\n    }\n\n    if (preserveSingleExpressionType) {\n      typedValue = evaluated.value;\n      hasTypedValue = true;\n    } else {\n      value += evaluated.literal;\n    }\n  }\n\n  return {\n    value: preserveSingleExpressionType && hasTypedValue ? typedValue : value,\n    diagnostics,\n    trace,\n  };\n}\n\nexport function resolveFieldAtSite(\n  params: ResolveFieldAtSiteParams & {readonly preserveSingleExpressionType: true},\n): SiteResolvedField<unknown>;\nexport function resolveFieldAtSite(\n  params: ResolveFieldAtSiteParams & {readonly preserveSingleExpressionType?: false},\n): SiteResolvedField;\nexport function resolveFieldAtSite(params: ResolveFieldAtSiteParams): SiteResolvedField<unknown>;\nexport function resolveFieldAtSite(params: ResolveFieldAtSiteParams): SiteResolvedField<unknown> {\n  let value = '';\n  let typedValue: unknown;\n  let hasTypedValue = false;\n  const diagnostics: WorkflowTemplateDiagnostic[] = [];\n  const trace: EvaluationTraceEntry[] = [];\n  const segments: ResolvedFieldSegment[] = [];\n  let hasResidual = false;\n  const preserveSingleExpressionType = isExactSingleExpressionField(params);\n\n  for (const segment of params.field.segments) {\n    if (segment.kind === 'literal') {\n      value += segment.value;\n      segments.push(segment);\n      continue;\n    }\n\n    if (!shouldFillAtSite(segment.fillTarget, params.site)) {\n      hasResidual = true;\n      segments.push(segment);\n      continue;\n    }\n\n    const evaluated = evaluateFillableSegment(params, segment);\n    trace.push(evaluated.trace);\n    if (evaluated.kind === 'degraded') {\n      diagnostics.push(evaluated.diagnostic);\n      segments.push({kind: 'literal', value: ''});\n      continue;\n    }\n\n    if (preserveSingleExpressionType) {\n      typedValue = evaluated.value;\n      hasTypedValue = true;\n    } else {\n      value += evaluated.literal;\n    }\n    segments.push({kind: 'literal', value: evaluated.literal});\n  }\n\n  if (hasResidual) return {kind: 'residual', field: {segments}, diagnostics, trace};\n  return {\n    kind: 'frozen',\n    value: preserveSingleExpressionType && hasTypedValue ? typedValue : value,\n    diagnostics,\n    trace,\n  };\n}\n\nfunction isExactSingleExpressionField(params: ResolveFieldAtSiteParams): boolean {\n  return (\n    params.preserveSingleExpressionType === true &&\n    params.field.segments.length === 1 &&\n    params.field.segments[0]?.kind === 'deferred'\n  );\n}\n\ntype FilledFieldSegment =\n  | {\n      readonly kind: 'evaluated';\n      readonly value: unknown;\n      readonly literal: string;\n      readonly trace: EvaluationTraceEntry;\n    }\n  | {\n      readonly kind: 'degraded';\n      readonly diagnostic: WorkflowTemplateDiagnostic;\n      readonly trace: EvaluationTraceEntry;\n    };\n\nfunction evaluateFillableSegment(\n  params: ResolveFieldAtSiteParams,\n  segment: ResolvedFieldDeferredSegment,\n): FilledFieldSegment {\n  try {\n    const value = evaluateWorkflowExpression(segment.expression, params.context);\n    const literal = coerceWorkflowValueToString(value);\n    return {\n      kind: 'evaluated',\n      value,\n      literal,\n      trace: fillTraceEntry(segment, params.site, literal),\n    };\n  } catch (error) {\n    if (error instanceof WorkflowExpressionEvaluationError && error.reason === 'missing-path') {\n      if (fieldMissingPathRequiresFailure(params, segment)) {\n        throw new WorkflowTemplateResolutionError({\n          source: segment.expression.source,\n          cause: error,\n        });\n      }\n\n      return {\n        kind: 'degraded',\n        diagnostic: missingPathDiagnostic(segment),\n        trace: fillTraceEntry(segment, params.site, '', true),\n      };\n    }\n\n    throw new WorkflowTemplateResolutionError({\n      source: segment.expression.source,\n      cause: error,\n    });\n  }\n}\n\nfunction fillTraceEntry(\n  segment: ResolvedFieldDeferredSegment,\n  site: AvailabilitySite,\n  value: string,\n  degraded = false,\n): EvaluationTraceEntry {\n  return evaluationTraceEntry({\n    expression: segment.expression.source,\n    roots: segment.roots,\n    fillTarget: segment.fillTarget,\n    evaluatedAt: site,\n    value,\n    ...(degraded ? {degraded: true} : {}),\n  });\n}\n\nfunction fieldMissingPathRequiresFailure(\n  params: ResolveFieldAtSiteParams,\n  segment: ResolvedFieldDeferredSegment,\n): boolean {\n  return (\n    (isExactSingleExpressionField(params) && params.failurePolicy === 'fail') ||\n    missingPathRequiresFailure(segment, params.failurePolicy, params.site)\n  );\n}\n\nfunction exactTypedFieldRequiresFailure(\n  params: ResolveFieldAtSiteParams,\n  segment: ResolvedFieldDeferredSegment,\n): boolean {\n  return (\n    isExactSingleExpressionField(params) &&\n    params.failurePolicy === 'fail' &&\n    segment.fillTarget !== 'runner-fill'\n  );\n}\n\nfunction typedFieldNotFillableAtSite(\n  segment: ResolvedFieldDeferredSegment,\n): WorkflowTemplateResolutionError {\n  return new WorkflowTemplateResolutionError({\n    source: segment.expression.source,\n    cause: new Error('Typed field is not fillable at this site.'),\n  });\n}\n\nfunction missingPathDiagnostic(segment: ResolvedFieldDeferredSegment): WorkflowTemplateDiagnostic {\n  return {\n    reason: 'missing-path',\n    expression: segment.expression.source,\n    contextRoots: segment.roots,\n  };\n}\n\nfunction missingPathRequiresFailure(\n  segment: ResolvedFieldDeferredSegment,\n  failurePolicy: WorkflowInterpolationFailurePolicy,\n  site: AvailabilitySite,\n): boolean {\n  if (failurePolicy !== 'fail') return false;\n  const rootAvailabilities = segment.roots.flatMap((root) => {\n    const availability = resolveContextRootAvailability(root);\n    return availability === undefined ? [] : [availability];\n  });\n  return (\n    rootAvailabilities.length > 0 &&\n    rootAvailabilities.every((availability) => shouldFillAtSite(availability, site))\n  );\n}\n"],"names":["evaluateWorkflowExpression","WorkflowExpressionEvaluationError","coerceWorkflowValueToString","WorkflowTemplateResolutionError","resolveContextRootAvailability","evaluationTraceEntry","shouldFillAtSite","freezeResolvedFieldAtSite","params","value","typedValue","hasTypedValue","diagnostics","trace","preserveSingleExpressionType","isExactSingleExpressionField","segment","field","segments","kind","fillTarget","site","exactTypedFieldRequiresFailure","typedFieldNotFillableAtSite","push","missingPathDiagnostic","evaluated","evaluateFillableSegment","diagnostic","literal","resolveFieldAtSite","hasResidual","length","expression","context","fillTraceEntry","error","reason","fieldMissingPathRequiresFailure","source","cause","degraded","roots","evaluatedAt","failurePolicy","missingPathRequiresFailure","Error","contextRoots","rootAvailabilities","flatMap","root","availability","undefined","every"],"mappings":"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"}