@x12i/graphenix-plan-compiler 1.0.0

package/dist/compile/compile-executable-plan.d.ts

@@ -0,0 +1,5 @@
+import type { AuthoringGraphDocument } from "@x12i/graphenix-executable-contracts";
+import type { CompileExecutablePlanOptions, ExecutableGraphPlan } from "@x12i/graphenix-executable-contracts";
+import type { GraphRuntimeObject } from "@x12i/graphenix-executable-contracts";
+export declare function compileExecutablePlan(doc: AuthoringGraphDocument, runtime: GraphRuntimeObject, options?: CompileExecutablePlanOptions): ExecutableGraphPlan;
+//# sourceMappingURL=compile-executable-plan.d.ts.map

package/dist/compile/compile-executable-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-executable-plan.d.ts","sourceRoot":"","sources":["../../src/compile/compile-executable-plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,KAAK,EACV,4BAA4B,EAC5B,mBAAmB,EAIpB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAkG/E,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,sBAAsB,EAC3B,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,4BAAiC,GACzC,mBAAmB,CAgFrB"}

package/dist/compile/compile-executable-plan.js

@@ -0,0 +1,139 @@
+import { validateAuthoringExecutableGraph } from "@x12i/graphenix-authoring-format";
+import { assertNormalizedExecutableGraph } from "@x12i/graphenix-authoring-format";
+import { normalizeExecutableGraph, stripDesignOnlyFieldsFromGraph } from "@x12i/graphenix-authoring-format";
+import { buildDeterministicCaseContext } from "../resolution/build-deterministic-case-context.js";
+import { resolveGraphModelConfig } from "../resolution/resolve-graph-model-config.js";
+import { resolveNodeAiPlan } from "../resolution/resolve-node-ai-plan.js";
+import { buildNodeExecutionUnits } from "./build-node-execution-units.js";
+import { getExecutableProfile, getTaskNodeConfig, isExecutableTaskNode } from "@x12i/graphenix-executable-contracts";
+import { defaultHashFunction } from "@x12i/graphenix-executable-contracts";
+import { EXECUTABLE_PLAN_FORMAT } from "@x12i/graphenix-executable-contracts";
+const AI_MODEL_SLOTS = [
+    "preActionModel",
+    "skillModel",
+    "postActionModel"
+];
+function buildPlanId(graphId, jobId) {
+    const graphSlug = graphId.replace(/^graph:/, "");
+    return `plan:${graphSlug}:${jobId}`;
+}
+function toSelectedCase(caseId, matchedConditions) {
+    if (matchedConditions.length === 0) {
+        return {
+            caseId,
+            matched: true,
+            reason: "default case"
+        };
+    }
+    return {
+        caseId,
+        matched: true,
+        reason: matchedConditions.join("; ")
+    };
+}
+function toResolvedNodePlan(doc, nodeId, context) {
+    const node = doc.graph.nodes.find((n) => n.id === nodeId);
+    if (!node || !isExecutableTaskNode(node)) {
+        throw new Error(`Node ${nodeId} is not an executable task node.`);
+    }
+    const params = getTaskNodeConfig(node);
+    if (!params) {
+        throw new Error(`Node ${nodeId} is missing task parameters.`);
+    }
+    const aiPlan = resolveNodeAiPlan(doc, nodeId, context);
+    const profile = getExecutableProfile(doc);
+    const fallbackPolicy = profile?.modelConfig.fallbackPolicy ?? {
+        enabled: false,
+        allowedTriggers: []
+    };
+    const modelSlots = {};
+    for (const slot of AI_MODEL_SLOTS) {
+        const resolved = aiPlan.slots[slot];
+        modelSlots[slot] = {
+            selection: resolved.selected,
+            source: resolved.source,
+            inherited: resolved.inherited,
+            graphCaseId: aiPlan.graphCaseId,
+            nodeCaseId: aiPlan.nodeCaseId
+        };
+    }
+    return {
+        nodeId,
+        nodeType: "task",
+        skillKey: params.skillKey,
+        selectedCases: {
+            graphCaseId: aiPlan.graphCaseId,
+            nodeCaseId: aiPlan.nodeCaseId
+        },
+        modelSlots,
+        executionUnits: buildNodeExecutionUnits(nodeId, params, modelSlots),
+        fallbackPolicy
+    };
+}
+export function compileExecutablePlan(doc, runtime, options = {}) {
+    const validation = validateAuthoringExecutableGraph(doc);
+    if (!validation.valid) {
+        const summary = validation.errors
+            .map((error) => `${error.path}: ${error.message}`)
+            .join("; ");
+        throw new Error(`Invalid authoring graph: ${summary}`);
+    }
+    const hash = options.hash ?? defaultHashFunction;
+    const now = options.now ?? (() => new Date());
+    const normalized = stripDesignOnlyFieldsFromGraph(normalizeExecutableGraph(doc));
+    assertNormalizedExecutableGraph(normalized);
+    const context = buildDeterministicCaseContext(normalized, runtime);
+    const graphHash = hash(doc);
+    const contextHash = hash(context);
+    const inputHash = runtime.input !== undefined ? hash(runtime.input) : undefined;
+    const profileRegistry = options.profileRegistry ?? {
+        version: "3.0.0"
+    };
+    const taskNodes = normalized.graph.nodes.filter(isExecutableTaskNode);
+    const nodePlans = {};
+    const nodeCaseSelection = {};
+    const graphResolution = resolveGraphModelConfig(normalized, context);
+    const graphCaseSelection = toSelectedCase(graphResolution.caseId, graphResolution.selection.matchedConditions);
+    for (const node of taskNodes) {
+        const aiPlan = resolveNodeAiPlan(normalized, node.id, context);
+        nodeCaseSelection[node.id] = aiPlan.nodeCaseId
+            ? toSelectedCase(aiPlan.nodeCaseId, aiPlan.caseSelection.node?.matchedConditions ?? [])
+            : null;
+        nodePlans[node.id] = toResolvedNodePlan(normalized, node.id, context);
+    }
+    const metadata = doc.graph.metadata;
+    return {
+        format: EXECUTABLE_PLAN_FORMAT,
+        planId: buildPlanId(doc.id, runtime.jobId),
+        createdAt: now().toISOString(),
+        source: {
+            graphId: doc.id,
+            graphRevision: doc.revision,
+            graphHash,
+            formatVersion: doc.formatVersion
+        },
+        profileRegistry: {
+            package: "@x12i/ai-profiles",
+            version: profileRegistry.version,
+            registryHash: profileRegistry.registryHash
+        },
+        runtimeBinding: {
+            jobId: runtime.jobId,
+            mode: runtime.mode,
+            environment: options.environment,
+            inputHash,
+            contextHash
+        },
+        graph: normalized,
+        caseSelection: {
+            graph: graphCaseSelection,
+            nodes: nodeCaseSelection
+        },
+        nodePlans,
+        contracts: {
+            entry: metadata?.graphEntry,
+            response: metadata?.graphResponse
+        }
+    };
+}
+//# sourceMappingURL=compile-executable-plan.js.map

package/dist/compile/compile-executable-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-executable-plan.js","sourceRoot":"","sources":["../../src/compile/compile-executable-plan.ts"],"names":[],"mappings":"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"}

package/dist/compile/phase-utility-strategy.d.ts

@@ -0,0 +1,6 @@
+import type { AuthoringActionConfig } from "@x12i/graphenix-executable-contracts";
+/** Read PRE/POST phase utility strategy key from legacy `aiTaskStrategies`. */
+export declare function readPhaseUtilityStrategyKey(aiTaskStrategies: unknown, phase: "pre" | "post"): string | undefined;
+/** Expand design strategy keys only when explicit plan-phase action lists are absent. */
+export declare function shouldExpandPhaseUtilityStrategy(actions: AuthoringActionConfig[] | undefined): boolean;
+//# sourceMappingURL=phase-utility-strategy.d.ts.map

package/dist/compile/phase-utility-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-utility-strategy.d.ts","sourceRoot":"","sources":["../../src/compile/phase-utility-strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAMlF,+EAA+E;AAC/E,wBAAgB,2BAA2B,CACzC,gBAAgB,EAAE,OAAO,EACzB,KAAK,EAAE,KAAK,GAAG,MAAM,GACpB,MAAM,GAAG,SAAS,CAepB;AAED,yFAAyF;AACzF,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,qBAAqB,EAAE,GAAG,SAAS,GAC3C,OAAO,CAET"}

package/dist/compile/phase-utility-strategy.js

@@ -0,0 +1,22 @@
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Read PRE/POST phase utility strategy key from legacy `aiTaskStrategies`. */
+export function readPhaseUtilityStrategyKey(aiTaskStrategies, phase) {
+    if (!isRecord(aiTaskStrategies)) {
+        return undefined;
+    }
+    const value = aiTaskStrategies[phase];
+    if (typeof value === "string" && value.trim().length > 0) {
+        return value;
+    }
+    if (isRecord(value) && typeof value.strategyKey === "string") {
+        return value.strategyKey;
+    }
+    return undefined;
+}
+/** Expand design strategy keys only when explicit plan-phase action lists are absent. */
+export function shouldExpandPhaseUtilityStrategy(actions) {
+    return (actions ?? []).length === 0;
+}
+//# sourceMappingURL=phase-utility-strategy.js.map

package/dist/compile/phase-utility-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-utility-strategy.js","sourceRoot":"","sources":["../../src/compile/phase-utility-strategy.ts"],"names":[],"mappings":"AAEA,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,2BAA2B,CACzC,gBAAyB,EACzB,KAAqB;IAErB,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAChC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QAC7D,OAAO,KAAK,CAAC,WAAW,CAAC;IAC3B,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,gCAAgC,CAC9C,OAA4C;IAE5C,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;AACtC,CAAC"}

package/dist/explain/explain-node-inheritance.d.ts

@@ -0,0 +1,3 @@
+import type { ResolvedNodeAiPlan } from "@x12i/graphenix-executable-contracts";
+export declare function explainNodeInheritance(plan: ResolvedNodeAiPlan): string;
+//# sourceMappingURL=explain-node-inheritance.d.ts.map

package/dist/explain/explain-node-inheritance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain-node-inheritance.d.ts","sourceRoot":"","sources":["../../src/explain/explain-node-inheritance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAG/E,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAiDvE"}

package/dist/explain/explain-node-inheritance.js

@@ -0,0 +1,38 @@
+import { formatAiModelSelectionLabel } from "@x12i/graphenix-authoring-format";
+export function explainNodeInheritance(plan) {
+    const lines = [];
+    lines.push(`Graph case selected: ${plan.caseSelection.graph.selectedCaseId}`);
+    if (plan.caseSelection.graph.matchedConditions.length > 0) {
+        lines.push(`Graph case reason: ${plan.caseSelection.graph.matchedConditions.join(", ")}`);
+    }
+    if (plan.caseSelection.node) {
+        lines.push(`Node case selected: ${plan.caseSelection.node.selectedCaseId}`);
+        if (plan.caseSelection.node.matchedConditions.length > 0) {
+            lines.push(`Node case reason: ${plan.caseSelection.node.matchedConditions.join(", ")}`);
+        }
+    }
+    lines.push(`Node: ${plan.nodeId}`);
+    for (const slot of [
+        "preActionModel",
+        "skillModel",
+        "postActionModel"
+    ]) {
+        const resolved = plan.slots[slot];
+        const label = formatAiModelSelectionLabel(resolved.selected);
+        if (resolved.fallback?.attempted) {
+            lines.push(`${slot}: fallback to graph case ${plan.graphCaseId} (${label}, trigger=${resolved.fallback.trigger})`);
+            continue;
+        }
+        if (resolved.inherited) {
+            lines.push(`${slot}: source=graph case ${plan.graphCaseId}, key=${label}, inherited=true`);
+        }
+        else {
+            const source = plan.nodeCaseId
+                ? `node case ${plan.nodeCaseId}`
+                : "node override";
+            lines.push(`${slot}: source=${source}, key=${label}, inherited=false`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=explain-node-inheritance.js.map

package/dist/explain/explain-node-inheritance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain-node-inheritance.js","sourceRoot":"","sources":["../../src/explain/explain-node-inheritance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAE/E,MAAM,UAAU,sBAAsB,CAAC,IAAwB;IAC7D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,wBAAwB,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC;IAC9E,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,KAAK,CAAC,IAAI,CACR,sBAAsB,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC9E,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,uBAAuB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QAC5E,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzD,KAAK,CAAC,IAAI,CACR,qBAAqB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAEnC,KAAK,MAAM,IAAI,IAAI;QACjB,gBAAgB;QAChB,YAAY;QACZ,iBAAiB;KACT,EAAE,CAAC;QACX,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,2BAA2B,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAE7D,IAAI,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CACR,GAAG,IAAI,4BAA4B,IAAI,CAAC,WAAW,KAAK,KAAK,aAAa,QAAQ,CAAC,QAAQ,CAAC,OAAO,GAAG,CACvG,CAAC;YACF,SAAS;QACX,CAAC;QAED,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CACR,GAAG,IAAI,uBAAuB,IAAI,CAAC,WAAW,SAAS,KAAK,kBAAkB,CAC/E,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU;gBAC5B,CAAC,CAAC,aAAa,IAAI,CAAC,UAAU,EAAE;gBAChC,CAAC,CAAC,eAAe,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,YAAY,MAAM,SAAS,KAAK,mBAAmB,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { compileExecutablePlan } from "./compile/compile-executable-plan.js";
+export { compileExecutablePlanV2 } from "./compile/compile-executable-plan-v2.js";
+export { buildNodeExecutionUnits } from "./compile/build-node-execution-units.js";
+export { buildNodeExecutionUnitsV2 } from "./compile/build-node-execution-units-v2.js";
+export { buildPlanTopology } from "./compile/build-plan-topology.js";
+export { buildDeferredGates } from "./compile/build-deferred-gates.js";
+export { buildNodeInvokeContract } from "./compile/build-node-invoke-contract.js";
+export { buildFinalizerPlans } from "./compile/build-finalizer-plans.js";
+export { resolveGraphModelConfig, selectGraphModelCase } from "./resolution/resolve-graph-model-config.js";
+export { resolveNodeModelConfig, selectNodeModelCase } from "./resolution/resolve-node-model-config.js";
+export { resolveNodeModelSlot } from "./resolution/resolve-node-model-slot.js";
+export { resolveNodeAiPlan, resolveAllNodeAiPlans } from "./resolution/resolve-node-ai-plan.js";
+export { buildDeterministicCaseContext } from "./resolution/build-deterministic-case-context.js";
+export { explainNodeInheritance } from "./explain/explain-node-inheritance.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,4CAA4C,CAAC;AAEpD,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,2CAA2C,CAAC;AAEnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAE/E,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,6BAA6B,EAAE,MAAM,kDAAkD,CAAC;AAEjG,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+export { compileExecutablePlan } from "./compile/compile-executable-plan.js";
+export { compileExecutablePlanV2 } from "./compile/compile-executable-plan-v2.js";
+export { buildNodeExecutionUnits } from "./compile/build-node-execution-units.js";
+export { buildNodeExecutionUnitsV2 } from "./compile/build-node-execution-units-v2.js";
+export { buildPlanTopology } from "./compile/build-plan-topology.js";
+export { buildDeferredGates } from "./compile/build-deferred-gates.js";
+export { buildNodeInvokeContract } from "./compile/build-node-invoke-contract.js";
+export { buildFinalizerPlans } from "./compile/build-finalizer-plans.js";
+export { resolveGraphModelConfig, selectGraphModelCase } from "./resolution/resolve-graph-model-config.js";
+export { resolveNodeModelConfig, selectNodeModelCase } from "./resolution/resolve-node-model-config.js";
+export { resolveNodeModelSlot } from "./resolution/resolve-node-model-slot.js";
+export { resolveNodeAiPlan, resolveAllNodeAiPlans } from "./resolution/resolve-node-ai-plan.js";
+export { buildDeterministicCaseContext } from "./resolution/build-deterministic-case-context.js";
+export { explainNodeInheritance } from "./explain/explain-node-inheritance.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,4CAA4C,CAAC;AAEpD,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,2CAA2C,CAAC;AAEnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAE/E,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,6BAA6B,EAAE,MAAM,kDAAkD,CAAC;AAEjG,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/resolution/build-deterministic-case-context.d.ts

@@ -0,0 +1,9 @@
+import type { DeterministicCaseContext } from "@x12i/graphenix-executable-contracts";
+import type { ExecutableGraphDocument } from "@x12i/graphenix-executable-contracts";
+import type { GraphRuntimeObject } from "@x12i/graphenix-executable-contracts";
+export declare function buildDeterministicCaseContext(doc: ExecutableGraphDocument, runtime?: Partial<GraphRuntimeObject> & {
+    environment?: DeterministicCaseContext["runtime"]["environment"];
+    flags?: Record<string, unknown>;
+    context?: Record<string, unknown>;
+}): DeterministicCaseContext;
+//# sourceMappingURL=build-deterministic-case-context.d.ts.map

package/dist/resolution/build-deterministic-case-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-deterministic-case-context.d.ts","sourceRoot":"","sources":["../../src/resolution/build-deterministic-case-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AACrF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAE/E,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,uBAAuB,EAC5B,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG;IACtC,WAAW,CAAC,EAAE,wBAAwB,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,CAAC;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,GACA,wBAAwB,CAqB1B"}

package/dist/resolution/build-deterministic-case-context.js

@@ -0,0 +1,23 @@
+export function buildDeterministicCaseContext(doc, runtime) {
+    return {
+        runtime: {
+            mode: runtime?.mode,
+            environment: runtime?.environment,
+            job: runtime?.job
+                ? {
+                    agentId: runtime.job.agentId,
+                    jobTypeId: runtime.job.jobTypeId
+                }
+                : undefined,
+            input: runtime?.input,
+            variables: runtime?.variables,
+            flags: runtime?.flags,
+            context: runtime?.context
+        },
+        graph: {
+            id: doc.id,
+            revision: doc.revision
+        }
+    };
+}
+//# sourceMappingURL=build-deterministic-case-context.js.map

package/dist/resolution/build-deterministic-case-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-deterministic-case-context.js","sourceRoot":"","sources":["../../src/resolution/build-deterministic-case-context.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,6BAA6B,CAC3C,GAA4B,EAC5B,OAIC;IAED,OAAO;QACL,OAAO,EAAE;YACP,IAAI,EAAE,OAAO,EAAE,IAAI;YACnB,WAAW,EAAE,OAAO,EAAE,WAAW;YACjC,GAAG,EAAE,OAAO,EAAE,GAAG;gBACf,CAAC,CAAC;oBACE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO;oBAC5B,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS;iBACjC;gBACH,CAAC,CAAC,SAAS;YACb,KAAK,EAAE,OAAO,EAAE,KAAK;YACrB,SAAS,EAAE,OAAO,EAAE,SAAS;YAC7B,KAAK,EAAE,OAAO,EAAE,KAAK;YACrB,OAAO,EAAE,OAAO,EAAE,OAAO;SAC1B;QACD,KAAK,EAAE;YACL,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,QAAQ,EAAE,GAAG,CAAC,QAAQ;SACvB;KACF,CAAC;AACJ,CAAC"}

package/dist/resolution/resolve-graph-model-config.d.ts

@@ -0,0 +1,12 @@
+import type { ExecutableGraphDocument } from "@x12i/graphenix-executable-contracts";
+import type { GraphModelConfig, RequiredAiModelTriplet } from "@x12i/graphenix-executable-contracts";
+import type { DeterministicCaseContext, SelectedGraphModelCase } from "@x12i/graphenix-executable-contracts";
+import { selectGraphModelCase } from "@x12i/graphenix-case-format";
+export declare function resolveGraphModelConfig(doc: ExecutableGraphDocument, context?: DeterministicCaseContext): {
+    caseId: string;
+    triplet: RequiredAiModelTriplet;
+    modelConfig: GraphModelConfig;
+    selection: SelectedGraphModelCase;
+};
+export { selectGraphModelCase };
+//# sourceMappingURL=resolve-graph-model-config.d.ts.map

package/dist/resolution/resolve-graph-model-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-graph-model-config.d.ts","sourceRoot":"","sources":["../../src/resolution/resolve-graph-model-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EACV,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,uBAAuB,EAC5B,OAAO,CAAC,EAAE,wBAAwB,GACjC;IACD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,sBAAsB,CAAC;IAChC,WAAW,EAAE,gBAAgB,CAAC;IAC9B,SAAS,EAAE,sBAAsB,CAAC;CACnC,CAoBA;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/resolution/resolve-graph-model-config.js

@@ -0,0 +1,24 @@
+import { getExecutableProfile } from "@x12i/graphenix-executable-contracts";
+import { validateGraphModelConfig } from "@x12i/graphenix-authoring-format";
+import { selectGraphModelCase } from "@x12i/graphenix-case-format";
+import { buildDeterministicCaseContext } from "./build-deterministic-case-context.js";
+export function resolveGraphModelConfig(doc, context) {
+    const profile = getExecutableProfile(doc);
+    if (!profile?.modelConfig) {
+        throw new Error("Executable graph is missing graph modelConfig.");
+    }
+    const validationErrors = validateGraphModelConfig(profile.modelConfig);
+    if (validationErrors.length > 0) {
+        throw new Error(validationErrors[0]?.message ?? "Invalid graph modelConfig.");
+    }
+    const resolvedContext = context ?? buildDeterministicCaseContext(doc);
+    const selection = selectGraphModelCase(profile.modelConfig, resolvedContext);
+    return {
+        caseId: selection.caseId,
+        triplet: selection.triplet,
+        modelConfig: profile.modelConfig,
+        selection
+    };
+}
+export { selectGraphModelCase };
+//# sourceMappingURL=resolve-graph-model-config.js.map

package/dist/resolution/resolve-graph-model-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-graph-model-config.js","sourceRoot":"","sources":["../../src/resolution/resolve-graph-model-config.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AAEtF,MAAM,UAAU,uBAAuB,CACrC,GAA4B,EAC5B,OAAkC;IAOlC,MAAM,OAAO,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,gBAAgB,GAAG,wBAAwB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACvE,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,4BAA4B,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,eAAe,GAAG,OAAO,IAAI,6BAA6B,CAAC,GAAG,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;IAE7E,OAAO;QACL,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,OAAO,EAAE,SAAS,CAAC,OAAO;QAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,SAAS;KACV,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/resolution/resolve-node-ai-plan.d.ts

@@ -0,0 +1,7 @@
+import type { ExecutableGraphDocument } from "@x12i/graphenix-executable-contracts";
+import type { ResolvedNodeAiPlan } from "@x12i/graphenix-executable-contracts";
+import type { AiModelSlot } from "@x12i/graphenix-executable-contracts";
+import type { DeterministicCaseContext } from "@x12i/graphenix-executable-contracts";
+export declare function resolveNodeAiPlan(doc: ExecutableGraphDocument, nodeId: string, context?: DeterministicCaseContext, availabilityBySlot?: Partial<Record<AiModelSlot, import("@x12i/graphenix-executable-contracts").AiModelAvailabilityResult>>): ResolvedNodeAiPlan;
+export declare function resolveAllNodeAiPlans(doc: ExecutableGraphDocument, context?: DeterministicCaseContext): ResolvedNodeAiPlan[];
+//# sourceMappingURL=resolve-node-ai-plan.d.ts.map

package/dist/resolution/resolve-node-ai-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-node-ai-plan.d.ts","sourceRoot":"","sources":["../../src/resolution/resolve-node-ai-plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAQrF,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,uBAAuB,EAC5B,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,wBAAwB,EAClC,kBAAkB,CAAC,EAAE,OAAO,CAC1B,MAAM,CAAC,WAAW,EAAE,OAAO,sCAAsC,EAAE,yBAAyB,CAAC,CAC9F,GACA,kBAAkB,CAqDpB;AAED,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,uBAAuB,EAC5B,OAAO,CAAC,EAAE,wBAAwB,GACjC,kBAAkB,EAAE,CAItB"}

package/dist/resolution/resolve-node-ai-plan.js

@@ -0,0 +1,60 @@
+import { isExecutableTaskNode } from "@x12i/graphenix-executable-contracts";
+import { resolveGraphModelConfig } from "./resolve-graph-model-config.js";
+import { resolveNodeModelConfig } from "./resolve-node-model-config.js";
+import { resolveNodeModelSlot } from "./resolve-node-model-slot.js";
+import { getExecutableProfile } from "@x12i/graphenix-executable-contracts";
+import { buildDeterministicCaseContext } from "./build-deterministic-case-context.js";
+export function resolveNodeAiPlan(doc, nodeId, context, availabilityBySlot) {
+    const node = doc.graph.nodes.find((n) => n.id === nodeId);
+    if (!node || !isExecutableTaskNode(node)) {
+        throw new Error(`Node ${nodeId} is not an executable task node.`);
+    }
+    const resolvedContext = context ?? buildDeterministicCaseContext(doc);
+    const profile = getExecutableProfile(doc);
+    const fallbackPolicy = profile?.modelConfig.fallbackPolicy ?? {
+        enabled: false,
+        allowedTriggers: []
+    };
+    const { caseId: graphCaseId, selection: graphSelection } = resolveGraphModelConfig(doc, resolvedContext);
+    const nodeResolution = resolveNodeModelConfig(doc, node, resolvedContext);
+    const slots = ["preActionModel", "skillModel", "postActionModel"];
+    const resolvedSlots = {};
+    for (const slot of slots) {
+        resolvedSlots[slot] = resolveNodeModelSlot({
+            slot,
+            graphSelection: graphSelection.triplet[slot],
+            nodeSelection: nodeResolution.partial[slot],
+            fallbackPolicy,
+            availabilityResult: availabilityBySlot?.[slot],
+            graphCaseId,
+            nodeCaseId: nodeResolution.nodeCaseId,
+            nodeId
+        });
+    }
+    return {
+        graphId: doc.id,
+        graphRevision: doc.revision,
+        nodeId,
+        graphCaseId,
+        nodeCaseId: nodeResolution.nodeCaseId,
+        slots: resolvedSlots,
+        caseSelection: {
+            graph: {
+                selectedCaseId: graphCaseId,
+                matchedConditions: graphSelection.matchedConditions
+            },
+            node: nodeResolution.nodeCaseId
+                ? {
+                    selectedCaseId: nodeResolution.nodeCaseId,
+                    matchedConditions: nodeResolution.nodeMatchedConditions
+                }
+                : undefined
+        }
+    };
+}
+export function resolveAllNodeAiPlans(doc, context) {
+    return doc.graph.nodes
+        .filter(isExecutableTaskNode)
+        .map((node) => resolveNodeAiPlan(doc, node.id, context));
+}
+//# sourceMappingURL=resolve-node-ai-plan.js.map

package/dist/resolution/resolve-node-ai-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-node-ai-plan.js","sourceRoot":"","sources":["../../src/resolution/resolve-node-ai-plan.ts"],"names":[],"mappings":"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"}

package/dist/resolution/resolve-node-model-config.d.ts

@@ -0,0 +1,15 @@
+import type { PartialAiModelTriplet, RequiredAiModelTriplet } from "@x12i/graphenix-executable-contracts";
+import type { ExecutableGraphDocument } from "@x12i/graphenix-executable-contracts";
+import type { Node } from "@x12i/graphenix-core";
+import type { DeterministicCaseContext } from "@x12i/graphenix-executable-contracts";
+import { selectNodeModelCase } from "@x12i/graphenix-case-format";
+export declare function resolveNodeModelConfig(doc: ExecutableGraphDocument, node: Node, context?: DeterministicCaseContext): {
+    inherit: boolean;
+    nodeCaseId?: string;
+    partial: PartialAiModelTriplet;
+    resolved: RequiredAiModelTriplet;
+    graphCaseId: string;
+    nodeMatchedConditions: string[];
+};
+export { selectNodeModelCase };
+//# sourceMappingURL=resolve-node-model-config.d.ts.map

package/dist/resolution/resolve-node-model-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-node-model-config.d.ts","sourceRoot":"","sources":["../../src/resolution/resolve-node-model-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAGrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,uBAAuB,EAC5B,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,wBAAwB,GACjC;IACD,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,qBAAqB,CAAC;IAC/B,QAAQ,EAAE,sBAAsB,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,EAAE,CAAC;CACjC,CAoCA;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/resolution/resolve-node-model-config.js

@@ -0,0 +1,33 @@
+import { getTaskNodeConfig } from "@x12i/graphenix-executable-contracts";
+import { mergeTriplets } from "@x12i/graphenix-authoring-format";
+import { resolveGraphModelConfig } from "./resolve-graph-model-config.js";
+import { selectNodeModelCase } from "@x12i/graphenix-case-format";
+export function resolveNodeModelConfig(doc, node, context) {
+    const { caseId: graphCaseId, triplet: graphTriplet } = resolveGraphModelConfig(doc, context);
+    const taskConfig = getTaskNodeConfig(node);
+    const nodeModelConfig = taskConfig?.taskConfiguration?.modelConfig;
+    const inherit = nodeModelConfig?.inherit !== false;
+    const resolvedContext = context ?? {
+        runtime: {},
+        graph: { id: doc.id, revision: doc.revision }
+    };
+    const nodeCase = selectNodeModelCase(nodeModelConfig, resolvedContext);
+    const partial = nodeCase?.partial ??
+        nodeModelConfig?.cases?.find((c) => c.id === "default")?.modelConfig ??
+        nodeModelConfig?.modelConfig ??
+        {};
+    const resolved = mergeTriplets(graphTriplet, partial, inherit);
+    if (!resolved) {
+        throw new Error(`Node ${node.id} could not resolve model inheritance.`);
+    }
+    return {
+        inherit,
+        nodeCaseId: nodeCase?.caseId,
+        partial,
+        resolved,
+        graphCaseId,
+        nodeMatchedConditions: nodeCase?.matchedConditions ?? []
+    };
+}
+export { selectNodeModelCase };
+//# sourceMappingURL=resolve-node-model-config.js.map

package/dist/resolution/resolve-node-model-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-node-model-config.js","sourceRoot":"","sources":["../../src/resolution/resolve-node-model-config.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAIzE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,UAAU,sBAAsB,CACpC,GAA4B,EAC5B,IAAU,EACV,OAAkC;IASlC,MAAM,EACJ,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,YAAY,EACtB,GAAG,uBAAuB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAE1C,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,eAAe,GACnB,UAAU,EAAE,iBAAiB,EAAE,WAAW,CAAC;IAE7C,MAAM,OAAO,GAAG,eAAe,EAAE,OAAO,KAAK,KAAK,CAAC;IACnD,MAAM,eAAe,GAAG,OAAO,IAAI;QACjC,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE;KAC9C,CAAC;IACF,MAAM,QAAQ,GAAG,mBAAmB,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;IAEvE,MAAM,OAAO,GACX,QAAQ,EAAE,OAAO;QACjB,eAAe,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,EAAE,WAAW;QACpE,eAAe,EAAE,WAAW;QAC5B,EAAE,CAAC;IAEL,MAAM,QAAQ,GAAG,aAAa,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,EAAE,uCAAuC,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO;QACL,OAAO;QACP,UAAU,EAAE,QAAQ,EAAE,MAAM;QAC5B,OAAO;QACP,QAAQ;QACR,WAAW;QACX,qBAAqB,EAAE,QAAQ,EAAE,iBAAiB,IAAI,EAAE;KACzD,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/resolution/resolve-node-model-slot.d.ts

@@ -0,0 +1,7 @@
+import type { ResolvedAiModelSlot, ResolveNodeModelSlotArgs } from "@x12i/graphenix-executable-contracts";
+export declare function resolveNodeModelSlot(args: ResolveNodeModelSlotArgs & {
+    graphCaseId: string;
+    nodeCaseId?: string;
+    nodeId: string;
+}): ResolvedAiModelSlot;
+//# sourceMappingURL=resolve-node-model-slot.d.ts.map

package/dist/resolution/resolve-node-model-slot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-node-model-slot.d.ts","sourceRoot":"","sources":["../../src/resolution/resolve-node-model-slot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,sCAAsC,CAAC;AAS9C,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,wBAAwB,GAAG;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,GACA,mBAAmB,CA6ErB"}

package/dist/resolution/resolve-node-model-slot.js

@@ -0,0 +1,62 @@
+import { EXECUTABLE_PROFILE_PATH } from "@x12i/graphenix-executable-contracts";
+const DEFAULT_SLOTS = [
+    "preActionModel",
+    "skillModel",
+    "postActionModel"
+];
+export function resolveNodeModelSlot(args) {
+    const { slot, graphSelection, nodeSelection, fallbackPolicy, availabilityResult, graphCaseId, nodeCaseId, nodeId } = args;
+    const graphPath = `${EXECUTABLE_PROFILE_PATH}/modelConfig`;
+    const nodePath = `/graph/nodes/${nodeId}/parameters/taskConfiguration/modelConfig/modelConfig/${slot}`;
+    const provenance = {
+        graphPath,
+        nodePath: nodeSelection ? nodePath : undefined,
+        graphCaseId,
+        nodeCaseId
+    };
+    if (nodeSelection === undefined) {
+        return {
+            slot,
+            selected: graphSelection,
+            source: "graphDefault",
+            inherited: true,
+            provenance
+        };
+    }
+    const available = availabilityResult?.available ?? true;
+    if (available) {
+        return {
+            slot,
+            selected: nodeSelection,
+            source: nodeCaseId ? "nodeCaseOverride" : "nodeOverride",
+            inherited: false,
+            provenance
+        };
+    }
+    if (!fallbackPolicy.enabled) {
+        throw new Error(`Fallback to graph ${slot} is not allowed for node ${nodeId}: fallback disabled.`);
+    }
+    const allowedSlots = fallbackPolicy.slots ?? DEFAULT_SLOTS;
+    if (!allowedSlots.includes(slot)) {
+        throw new Error(`Fallback to graph ${slot} is not allowed for node ${nodeId}: slot not in policy.`);
+    }
+    const trigger = availabilityResult?.trigger;
+    if (trigger && !fallbackPolicy.allowedTriggers.includes(trigger)) {
+        throw new Error(`Fallback to graph ${slot} is not allowed for node ${nodeId}: trigger ${trigger} not allowed.`);
+    }
+    return {
+        slot,
+        selected: graphSelection,
+        source: "fallbackToGraphDefault",
+        inherited: true,
+        fallback: {
+            attempted: true,
+            from: nodeSelection,
+            to: graphSelection,
+            trigger: trigger ?? "nodeModelUnavailable",
+            reason: availabilityResult?.reason
+        },
+        provenance
+    };
+}
+//# sourceMappingURL=resolve-node-model-slot.js.map

package/dist/resolution/resolve-node-model-slot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-node-model-slot.js","sourceRoot":"","sources":["../../src/resolution/resolve-node-model-slot.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAE/E,MAAM,aAAa,GAAkB;IACnC,gBAAgB;IAChB,YAAY;IACZ,iBAAiB;CAClB,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAClC,IAIC;IAED,MAAM,EACJ,IAAI,EACJ,cAAc,EACd,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,MAAM,EACP,GAAG,IAAI,CAAC;IAET,MAAM,SAAS,GAAG,GAAG,uBAAuB,cAAc,CAAC;IAC3D,MAAM,QAAQ,GAAG,gBAAgB,MAAM,yDAAyD,IAAI,EAAE,CAAC;IACvG,MAAM,UAAU,GAAG;QACjB,SAAS;QACT,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;QAC9C,WAAW;QACX,UAAU;KACX,CAAC;IAEF,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO;YACL,IAAI;YACJ,QAAQ,EAAE,cAAc;YACxB,MAAM,EAAE,cAAc;YACtB,SAAS,EAAE,IAAI;YACf,UAAU;SACX,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,kBAAkB,EAAE,SAAS,IAAI,IAAI,CAAC;IAExD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO;YACL,IAAI;YACJ,QAAQ,EAAE,aAAa;YACvB,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,cAAc;YACxD,SAAS,EAAE,KAAK;YAChB,UAAU;SACX,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,qBAAqB,IAAI,4BAA4B,MAAM,sBAAsB,CAClF,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,cAAc,CAAC,KAAK,IAAI,aAAa,CAAC;IAC3D,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,qBAAqB,IAAI,4BAA4B,MAAM,uBAAuB,CACnF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,kBAAkB,EAAE,OAAO,CAAC;IAC5C,IAAI,OAAO,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CACb,qBAAqB,IAAI,4BAA4B,MAAM,aAAa,OAAO,eAAe,CAC/F,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI;QACJ,QAAQ,EAAE,cAAc;QACxB,MAAM,EAAE,wBAAwB;QAChC,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE;YACR,SAAS,EAAE,IAAI;YACf,IAAI,EAAE,aAAa;YACnB,EAAE,EAAE,cAAc;YAClB,OAAO,EAAE,OAAO,IAAI,sBAAsB;YAC1C,MAAM,EAAE,kBAAkB,EAAE,MAAM;SACnC;QACD,UAAU;KACX,CAAC;AACJ,CAAC"}