@exellix/graph-engine 8.1.7 → 8.1.8

package/CHANGELOG.md

@@ -1,6 +1,18 @@
 # Changelog
 
-## 8.1.3 (unreleased)
+## 8.1.8
+
+### Changed
+
+- **Graphenix 2.1.0 alignment (Tier 2 + 3):** `@x12i/graphenix-core` ^2.0.1 (`formatVersion: "2.1.0"`); lifecycle `@x12i/graphenix-*` ^2.0.0; testkit emits `metadata.modelConfig` (no `metadata.extensions`, no `parameters.profile` / `nodeType`).
+- **`@exellix/ai-tasks` ^9.1.0** — accepts parent plan `"executable-plan"` v2 and trace `"execution-trace"` v2; dedupes nested `graphenix-*@1.1.x` under ai-tasks.
+- **`check:no-legacy`** — fails when ai-tasks < 9.1.0, graphenix-core < 2.0.1, or ai-tasks nests duplicate `@x12i/graphenix-*`.
+
+### Added
+
+- **`tests/reference-fixtures-compile.test.ts`** — compiles `graph-content-pipeline` and `graph-subnets-analysis` authoring fixtures; asserts `validateExecutablePlanV2`.
+
+## 8.1.3
 
 ### Changed
 

package/dist/src/runtime/studioGraphExecuteRequest.d.ts

@@ -1,7 +1,7 @@
 import type { ExecuteGraphInput } from './ExellixGraphRuntime.js';
 /**
  * Removed from the graphs-studio execute envelope (7.8.3+). No reader, no fallback.
- * Default model selection belongs on authoring graph executable profile only.
+ * Default model selection belongs on `graph.metadata.modelConfig` only.
  */
 export declare const STUDIO_GRAPH_EXECUTE_REMOVED_KEYS: readonly ["graphDefaultModel"];
 export type StudioGraphExecuteRemovedKey = (typeof STUDIO_GRAPH_EXECUTE_REMOVED_KEYS)[number];

package/dist/src/runtime/studioGraphExecuteRequest.js

@@ -3,7 +3,7 @@ import { ExellixGraphError } from '../errors/ExellixGraphError.js';
 import { ExellixGraphErrorCode } from '../errors/exellixGraphErrorCodes.js';
 /**
  * Removed from the graphs-studio execute envelope (7.8.3+). No reader, no fallback.
- * Default model selection belongs on authoring graph executable profile only.
+ * Default model selection belongs on `graph.metadata.modelConfig` only.
  */
 export const STUDIO_GRAPH_EXECUTE_REMOVED_KEYS = ['graphDefaultModel'];
 function isPlainObject(v) {
@@ -20,7 +20,7 @@ export function getStudioGraphExecuteRemovedKeyViolations(request) {
 export function assertCanonicalStudioGraphExecuteRequest(request, context) {
     const removed = getStudioGraphExecuteRemovedKeyViolations(request);
     if (removed.length > 0) {
-        throw new ExellixGraphError(ExellixGraphErrorCode.NON_CANONICAL_STUDIO_GRAPH_EXECUTE_REQUEST, `Studio graph execute request must not include removed field(s): ${removed.join(', ')}. Model defaults belong on the authoring graph executable profile only; request-level graphDefaultModel was removed with no legacy fallback.`, { ...context, removedKeys: removed });
+        throw new ExellixGraphError(ExellixGraphErrorCode.NON_CANONICAL_STUDIO_GRAPH_EXECUTE_REQUEST, `Studio graph execute request must not include removed field(s): ${removed.join(', ')}. Model defaults belong on graph.metadata.modelConfig only; request-level graphDefaultModel was removed with no legacy fallback.`, { ...context, removedKeys: removed });
     }
     if (!isPlainObject(request) || request.mode !== 'graph' || typeof request.jobId !== 'string') {
         throw new ExellixGraphError(ExellixGraphErrorCode.NON_CANONICAL_STUDIO_GRAPH_EXECUTE_REQUEST, 'Studio graph execute request requires mode graph and jobId.', context);

package/dist/testkit/authoringGraphFixtures.js

@@ -1,32 +1,6 @@
 import { GRAPHENIX_FORMAT_VERSION } from '@x12i/graphenix-core';
-import { EXECUTABLE_PROFILE_NAMESPACE, EXECUTABLE_PROFILE_VERSION, FINALIZER_NODE_KIND, FINALIZER_NODE_PROFILE, TASK_NODE_KIND, TASK_NODE_PROFILE, } from '@x12i/graphenix-executable-contracts';
-function defaultExecutableModelConfig() {
-    return {
-        version: 'graph-model-config/v1',
-        cases: [
-            {
-                id: 'default',
-                modelConfig: {
-                    preActionModel: { kind: 'profileChoice', key: 'cheap/default' },
-                    skillModel: { kind: 'profileChoice', key: 'pro/default' },
-                    postActionModel: { kind: 'profileChoice', key: 'cheap/default' },
-                },
-            },
-        ],
-        fallbackPolicy: {
-            enabled: true,
-            allowedTriggers: [
-                'nodeSlotMissing',
-                'nodeModelUnavailable',
-                'nodeModelUnsupported',
-                'nodeProviderNotConfigured',
-                'nodeModelRateLimited',
-                'nodeModelTransientFailure',
-            ],
-            maxAttemptsPerSlot: 1,
-        },
-    };
-}
+import { FINALIZER_NODE_KIND, TASK_NODE_KIND } from '@x12i/graphenix-executable-contracts';
+import { defaultExecutableModelConfig } from './flatGraphToAuthoring.js';
 function authoringShell(graphId, nodes, edges, graphResponseShape, extra) {
     const taskNodes = nodes.filter((n) => n.kind === TASK_NODE_KIND);
     const finalizer = nodes.find((n) => n.kind === FINALIZER_NODE_KIND);
@@ -58,12 +32,7 @@ function authoringShell(graphId, nodes, edges, graphResponseShape, extra) {
                 : [],
             metadata: {
                 graphResponse: { shape: graphResponseShape },
-                extensions: {
-                    [EXECUTABLE_PROFILE_NAMESPACE]: {
-                        profileVersion: EXECUTABLE_PROFILE_VERSION,
-                        modelConfig: defaultExecutableModelConfig(),
-                    },
-                },
+                modelConfig: defaultExecutableModelConfig(),
                 ...extra,
             },
         },
@@ -80,8 +49,6 @@ export function buildAiTaskAuthoringGraph(graphId) {
         inputs: [{ id: 'in:record', direction: 'input', type: 'builtin:object', required: true }],
         outputs: [{ id: 'out:answer', direction: 'output', type: 'builtin:object' }],
         parameters: {
-            profile: TASK_NODE_PROFILE,
-            nodeType: 'task',
             skillKey: 'professional-answer',
             executionMapping: {
                 path: 'answers.ask1',
@@ -97,8 +64,6 @@ export function buildAiTaskAuthoringGraph(graphId) {
         inputs: [{ id: 'in:answer', direction: 'input', type: 'builtin:object', required: true }],
         outputs: [{ id: 'out:final', direction: 'output', type: 'builtin:object' }],
         parameters: {
-            profile: FINALIZER_NODE_PROFILE,
-            nodeType: 'finalizer',
             finalizerType: 'select',
             inputs: {
                 answer: { type: 'executionMemoryPath', path: 'answers.ask1.answer' },
@@ -126,8 +91,6 @@ export function buildLocalSkillAuthoringGraph(graphId) {
         inputs: [{ id: 'in:record', direction: 'input', type: 'builtin:object', required: true }],
         outputs: [{ id: 'out:answer', direction: 'output', type: 'builtin:object' }],
         parameters: {
-            profile: TASK_NODE_PROFILE,
-            nodeType: 'task',
             skillKey: 'deterministic-rule',
             taskConfiguration: {
                 rules: [{ id: 'always', condition: { all: [] }, output: { decision: 'go' } }],
@@ -146,8 +109,6 @@ export function buildLocalSkillAuthoringGraph(graphId) {
         inputs: [{ id: 'in:answer', direction: 'input', type: 'builtin:object', required: true }],
         outputs: [{ id: 'out:final', direction: 'output', type: 'builtin:object' }],
         parameters: {
-            profile: FINALIZER_NODE_PROFILE,
-            nodeType: 'finalizer',
             finalizerType: 'select',
             inputs: {
                 decision: { type: 'executionMemoryPath', path: 'rule.decision' },
@@ -176,8 +137,6 @@ export function buildGraphResponseMappingAuthoringGraph(graphId) {
         inputs: [{ id: 'in:record', direction: 'input', type: 'builtin:object', required: true }],
         outputs: [{ id: 'out:answer', direction: 'output', type: 'builtin:object' }],
         parameters: {
-            profile: TASK_NODE_PROFILE,
-            nodeType: 'task',
             skillKey: 'professional-answer',
             taskVariable: { question },
             executionMapping: {
@@ -197,8 +156,6 @@ export function buildGraphResponseMappingAuthoringGraph(graphId) {
         ],
         outputs: [{ id: 'out:final', direction: 'output', type: 'builtin:object' }],
         parameters: {
-            profile: FINALIZER_NODE_PROFILE,
-            nodeType: 'finalizer',
             finalizerType: 'aggregate',
             config: {
                 sections: [
@@ -239,11 +196,8 @@ export function buildGraphResponseMappingAuthoringGraph(graphId) {
 export function withAuthoringGraphModelConfig(doc, modelConfig) {
     const next = structuredClone(doc);
     const metadata = next.graph.metadata;
-    if (!metadata?.extensions)
+    if (!metadata)
         return next;
-    const profile = metadata.extensions[EXECUTABLE_PROFILE_NAMESPACE];
-    if (profile && typeof profile === 'object') {
-        Object.assign(profile, { modelConfig });
-    }
+    metadata.modelConfig = modelConfig;
     return next;
 }

package/dist/testkit/flatGraphToAuthoring.d.ts

@@ -21,7 +21,7 @@ export declare function defaultExecutableModelConfig(): {
     }[];
     fallbackPolicy: {
         enabled: boolean;
-        allowedTriggers: readonly ["nodeSlotMissing", "nodeModelUnavailable", "nodeModelUnsupported", "nodeProviderNotConfigured", "nodeModelRateLimited", "nodeModelTransientFailure"];
+        allowedTriggers: string[];
         maxAttemptsPerSlot: number;
     };
 };

package/dist/testkit/flatGraphToAuthoring.js

@@ -1,5 +1,5 @@
 import { GRAPHENIX_FORMAT_VERSION } from '@x12i/graphenix-core';
-import { EXECUTABLE_PROFILE_NAMESPACE, EXECUTABLE_PROFILE_VERSION, FINALIZER_NODE_KIND, FINALIZER_NODE_PROFILE, TASK_NODE_KIND, TASK_NODE_PROFILE, } from '@x12i/graphenix-executable-contracts';
+import { FINALIZER_NODE_KIND, TASK_NODE_KIND } from '@x12i/graphenix-executable-contracts';
 const ALIAS_TO_CHOICE = {
     cheap: 'cheap/default',
     balanced: 'vol/default',
@@ -130,10 +130,7 @@ function patchTaskConfigurationModelConfig(taskConfiguration) {
 }
 function flatTaskNodeToAuthoring(node) {
     const { id, skillKey, taskVariable, executionMapping, taskConfiguration, inputsConfig, conditions, variables, metadata, executionPipeline, taskKnowledge, smartInput, data, } = node;
-    const parameters = {
-        profile: TASK_NODE_PROFILE,
-        nodeType: 'task',
-    };
+    const parameters = {};
     if (typeof skillKey === 'string')
         parameters.skillKey = skillKey;
     if (taskVariable !== undefined)
@@ -182,8 +179,6 @@ function flatFinalizerNodeToAuthoring(node, incoming) {
         }))
         : [{ id: 'in:final', direction: 'input', type: 'builtin:object', required: false }];
     const parameters = {
-        profile: FINALIZER_NODE_PROFILE,
-        nodeType: 'finalizer',
         finalizerType: node.finalizerType,
         config: isPlainRecord(node.config) ? node.config : {},
     };
@@ -233,19 +228,12 @@ export function flatTestGraphToAuthoringDocument(flat) {
         metadata.jobKnowledge = normalizeKnowledgeRefs(flat.jobKnowledge);
     if (Array.isArray(flat.taskKnowledge))
         metadata.taskKnowledge = normalizeKnowledgeRefs(flat.taskKnowledge);
-    const executableProfile = {
-        profileVersion: EXECUTABLE_PROFILE_VERSION,
-        modelConfig: flatModelConfigToAuthoring(flat.modelConfig) ?? defaultExecutableModelConfig(),
-    };
     metadata.graphResponse = {
         ...(flatResponse.missing != null ? { missing: flatResponse.missing } : {}),
         ...(flatResponse.version != null ? { version: flatResponse.version } : {}),
         shape: responseShape,
     };
-    metadata.extensions = {
-        ...(isPlainRecord(metadata.extensions) ? metadata.extensions : {}),
-        [EXECUTABLE_PROFILE_NAMESPACE]: executableProfile,
-    };
+    metadata.modelConfig = flatModelConfigToAuthoring(flat.modelConfig) ?? defaultExecutableModelConfig();
     const taskNodes = nodes.filter((n) => n.kind === TASK_NODE_KIND);
     const finalizer = nodes.find((n) => n.kind === FINALIZER_NODE_KIND);
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exellix/graph-engine",
-  "version": "8.1.7",
+  "version": "8.1.8",
   "type": "module",
   "description": "Graph executor SDK",
   "main": "dist/src/index.js",
@@ -25,8 +25,8 @@
   "scripts": {
     "prebuild": "node scripts/clean-dist.mjs",
     "build": "tsc",
-    "test": "npm run build && npm run check:no-legacy && tsx --test --test-force-exit --test-timeout=60000 tests/model-alias-canonical.test.ts tests/model-alias-execute.test.ts tests/model-alias-strategy.test.ts tests/model-alias-subnets.test.ts tests/ai-tasks-error-propagation.test.ts tests/reports-fixtures-pre-synthesis.test.ts tests/passthrough-parity.test.ts tests/step-retry-llm-call.test.ts tests/run-log-diagnostics.test.ts",
-    "test:full": "npm run build && npm run check:no-legacy && tsx --test --test-force-exit --test-timeout=60000 tests/graph-engine.test.ts tests/passthrough-parity.test.ts tests/task-node-run-task-preflight.test.ts tests/reports-fixtures-pre-synthesis.test.ts tests/model-alias-canonical.test.ts tests/model-alias-execute.test.ts tests/model-alias-strategy.test.ts tests/model-alias-subnets.test.ts tests/compile-host-patches.test.ts tests/step-retry-llm-call.test.ts",
+    "test": "npm run build && npm run check:no-legacy && tsx --test --test-force-exit --test-timeout=180000 --test-concurrency=2 tests/model-alias-canonical.test.ts tests/model-alias-execute.test.ts tests/model-alias-strategy.test.ts tests/model-alias-subnets.test.ts tests/ai-tasks-error-propagation.test.ts tests/reports-fixtures-pre-synthesis.test.ts tests/passthrough-parity.test.ts tests/step-retry-llm-call.test.ts tests/run-log-diagnostics.test.ts",
+    "test:full": "npm run build && npm run check:no-legacy && tsx --test --test-force-exit --test-timeout=180000 --test-concurrency=2 tests/graph-engine.test.ts tests/passthrough-parity.test.ts tests/task-node-run-task-preflight.test.ts tests/reports-fixtures-pre-synthesis.test.ts tests/model-alias-canonical.test.ts tests/model-alias-execute.test.ts tests/model-alias-strategy.test.ts tests/model-alias-subnets.test.ts tests/compile-host-patches.test.ts tests/reference-fixtures-compile.test.ts tests/step-retry-llm-call.test.ts",
     "test:live": "npm run run:pre-synthesis",
     "test:subnets-graph-fixture": "npm run build && node --test tests/subnets-graph.fixture.test.mjs",
     "test:subnets-graph-live": "npm run build && node --env-file=.env --test tests/subnets-graph.live.test.mjs",
@@ -52,27 +52,28 @@
     "access": "public"
   },
   "dependencies": {
-    "@exellix/ai-skills": "^6.7.0",
-    "@exellix/ai-tasks": "^9.0.6",
-    "@x12i/activix": "^8.6.2",
-    "@x12i/catalox": "5.1.3",
-    "@x12i/env": "4.0.1",
+    "@exellix/ai-skills": "^6.9.0",
+    "@exellix/ai-tasks": "^9.1.0",
+    "@x12i/activix": "^8.6.3",
+    "@x12i/catalox": "^5.2.0",
+    "@x12i/env": "^4.0.1",
     "@x12i/funcx": "^4.9.6",
-    "@x12i/graphenix": "2.5.0",
-    "@x12i/graphenix-authoring-format": "^1.2.1",
-    "@x12i/graphenix-executable-contracts": "^1.1.0",
-    "@x12i/graphenix-executable-format": "^2.1.4",
-    "@x12i/graphenix-execute-envelope": "^1.1.1",
-    "@x12i/graphenix-format": "2.0.0",
-    "@x12i/graphenix-plan-compiler": "^1.1.1",
-    "@x12i/graphenix-plan-format": "^1.1.1",
-    "@x12i/graphenix-trace-format": "^1.1.1",
+    "@x12i/graphenix": "^2.5.0",
+    "@x12i/graphenix-authoring-format": "^2.0.0",
+    "@x12i/graphenix-core": "^2.0.1",
+    "@x12i/graphenix-executable-contracts": "^2.0.0",
+    "@x12i/graphenix-executable-format": "^2.2.0",
+    "@x12i/graphenix-execute-envelope": "^2.0.0",
+    "@x12i/graphenix-format": "^2.0.0",
+    "@x12i/graphenix-plan-compiler": "^2.0.0",
+    "@x12i/graphenix-plan-format": "^2.0.0",
+    "@x12i/graphenix-trace-format": "^2.0.0",
     "@x12i/logxer": "^4.6.0",
-    "@x12i/memorix-descriptors": "1.6.0",
-    "@x12i/memorix-retrieval": "1.11.2",
-    "@x12i/memorix-writer": "1.0.0",
-    "@x12i/rendrix": "4.3.0",
-    "@x12i/runx": "1.3.2"
+    "@x12i/memorix-descriptors": "^1.6.0",
+    "@x12i/memorix-retrieval": "^1.11.2",
+    "@x12i/memorix-writer": "^1.0.0",
+    "@x12i/rendrix": "^4.3.0",
+    "@x12i/runx": "^1.3.2"
   },
   "devDependencies": {
     "@types/node": "25.9.1",