@exellix/graph-engine 7.4.2 → 7.4.3

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

@@ -91,6 +91,8 @@ export interface GraphRuntimeObject extends HostExecuteGraphRunOptions {
     taskVariables?: Record<string, unknown>;
     /** Runtime default model selection (`cases`); overrides GraphModelObject.modelConfig. */
     modelConfig?: ModelConfigSelection;
+    /** Profile aliases for xynthesis when runtime.modelConfig is host-resolved concrete ids. */
+    aiProfiles?: GraphAiModelConfig;
     /**
      * @deprecated Unused since 7.1 — profile aliases pass through to downstream resolution.
      */
@@ -210,6 +212,8 @@ export declare function createExellixGraphRuntime(opts: ExellixGraphRuntimeOptio
         prevNodeId?: string;
         /** Overrides graph-level / runtime default for this node only. */
         modelConfig?: GraphAiModelConfig;
+        /** Profile aliases for xynthesis PRE/POST when modelConfig is host-resolved concrete ids. */
+        aiProfiles?: GraphAiModelConfig;
         llmCall?: Record<string, unknown>;
         runTaskIdentity?: Record<string, unknown>;
         runTaskExecutionMode?: "default" | "trace";

package/dist/src/runtime/ExellixGraphRuntime.js

@@ -397,7 +397,7 @@ export function createExellixGraphRuntime(opts) {
                             },
                             ...(input.modelConfig != null
                                 ? {
-                                    modelConfig: toRunTaskModelConfigForPhase(input.modelConfig, 'pre'),
+                                    modelConfig: toRunTaskModelConfigForPhase(input.modelConfig, 'pre', input.aiProfiles),
                                 }
                                 : {}),
                             ...(effectiveLlmCall != null ? { llmCall: effectiveLlmCall } : {}),
@@ -610,7 +610,7 @@ export function createExellixGraphRuntime(opts) {
         }
         const effectiveModelConfig = input.modelConfig;
         const mainRunTaskModelConfig = effectiveModelConfig != null
-            ? toRunTaskModelConfigForPhase(effectiveModelConfig, 'main')
+            ? toRunTaskModelConfigForPhase(effectiveModelConfig, 'main', input.aiProfiles)
             : undefined;
         // DEBUG: Verify execution object before sending
         traceExecutionMemory('executeNode', 'Node execution object before runTask', {
@@ -722,6 +722,7 @@ export function createExellixGraphRuntime(opts) {
                 jobContext,
                 prevNodeId: input.prevNodeId,
                 modelConfig: effectiveModelConfig,
+                aiProfiles: input.aiProfiles,
                 llmCall: effectiveLlmCall,
                 runTaskIdentity: runTaskIdentityBase,
                 nodeTaskConfiguration: input.node?.taskConfiguration,
@@ -1023,6 +1024,7 @@ export function createExellixGraphRuntime(opts) {
                 jobContext,
                 prevNodeId: input.prevNodeId,
                 modelConfig: effectiveModelConfig,
+                aiProfiles: input.aiProfiles,
                 llmCall: effectiveLlmCall,
                 runTaskIdentity: runTaskIdentityBase,
                 nodeTaskConfiguration: input.node?.taskConfiguration,
@@ -1616,6 +1618,7 @@ export function createExellixGraphRuntime(opts) {
                                 variables: runtime.variables,
                                 taskVariables: runtime.taskVariables,
                                 modelConfig: effectiveModelConfig,
+                                aiProfiles: merged.aiProfiles,
                                 llmCall: merged.llmCall,
                                 runTaskIdentity: merged.runTaskIdentity,
                                 runTaskExecutionMode: merged.runTaskExecutionMode,

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

@@ -27,6 +27,8 @@ export type RunEngineAiTasksStrategyPhaseArgs = {
     prevNodeId?: string;
     /** Resolved three-phase config; routed to the correct ai-tasks slot for this strategy phase. */
     modelConfig?: GraphAiModelConfig;
+    /** Profile aliases for xynthesis slots when modelConfig is host-resolved concrete ids. */
+    aiProfiles?: GraphAiModelConfig;
     llmCall?: RunTaskRequest['llmCall'];
     runTaskIdentity?: Record<string, unknown>;
     /** Task node `taskConfiguration` (identity envelope merge). */

package/dist/src/runtime/aiTasksStrategyPhases.js

@@ -55,7 +55,7 @@ export async function runEngineAiTasksStrategyPhase(args) {
         executionPipeline: [{ phase: 'main', type: 'direct' }],
         executionStrategies: [],
         modelConfig: args.modelConfig != null
-            ? toRunTaskModelConfigForPhase(args.modelConfig, args.phase)
+            ? toRunTaskModelConfigForPhase(args.modelConfig, args.phase, args.aiProfiles)
             : undefined,
         llmCall: args.llmCall ?? undefined,
         identity,

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

@@ -36,5 +36,9 @@ export type EngineModelPhase = 'pre' | 'main' | 'post';
 /**
  * Maps three-phase graph config to ai-tasks slot pair for a single runTask phase.
  * Values are forwarded as-is (profile aliases or concrete ids).
+ *
+ * When {@link aiProfiles} is set (studio/playground host pattern), xynthesis slots use profile
+ * aliases so PRE synthesis inside ai-tasks resolves via ai-profiles even when {@link config}
+ * carries host-resolved concrete provider ids on `runtime.modelConfig`.
  */
-export declare function toRunTaskModelConfigForPhase(config: GraphAiModelConfig, phase: EngineModelPhase): RunTaskModelConfigWire;
+export declare function toRunTaskModelConfigForPhase(config: GraphAiModelConfig, phase: EngineModelPhase, aiProfiles?: GraphAiModelConfig): RunTaskModelConfigWire;

package/dist/src/runtime/graphAiModelConfig.js

@@ -79,26 +79,37 @@ export async function resolveGraphAiModelConfig(modelConfig, context) {
         postActionModel: normalizeModelSlot(modelConfig.postActionModel, context),
     };
 }
+function xynthesisSlotForWire(config, phase, aiProfiles) {
+    if (aiProfiles != null) {
+        return phase === 'post' ? aiProfiles.postActionModel : aiProfiles.preActionModel;
+    }
+    return phase === 'post' ? config.postActionModel : config.preActionModel;
+}
 /**
  * Maps three-phase graph config to ai-tasks slot pair for a single runTask phase.
  * Values are forwarded as-is (profile aliases or concrete ids).
+ *
+ * When {@link aiProfiles} is set (studio/playground host pattern), xynthesis slots use profile
+ * aliases so PRE synthesis inside ai-tasks resolves via ai-profiles even when {@link config}
+ * carries host-resolved concrete provider ids on `runtime.modelConfig`.
  */
-export function toRunTaskModelConfigForPhase(config, phase) {
+export function toRunTaskModelConfigForPhase(config, phase, aiProfiles) {
+    const xynthesisModel = xynthesisSlotForWire(config, phase, aiProfiles);
     switch (phase) {
         case 'pre':
             return {
-                xynthesisModel: config.preActionModel,
-                skillModel: config.preActionModel,
+                xynthesisModel,
+                skillModel: xynthesisModel,
             };
         case 'main':
             return {
-                xynthesisModel: config.preActionModel,
+                xynthesisModel,
                 skillModel: config.skillModel,
             };
         case 'post':
             return {
-                xynthesisModel: config.postActionModel,
-                skillModel: config.postActionModel,
+                xynthesisModel,
+                skillModel: xynthesisModel,
             };
     }
 }

package/dist/src/runtime/mergeExellixGraphRuntimeInvocation.js

@@ -16,6 +16,7 @@ export function mergeExellixGraphRuntimeInvocation(input, opts) {
         playgroundMeta: input.playgroundMeta ?? opts.playgroundMeta,
         clearSynthesizedContextPerNode: input.clearSynthesizedContextPerNode ?? opts.clearSynthesizedContextPerNode,
         modelConfig: input.modelConfig ?? opts.modelConfig,
+        aiProfiles: input.aiProfiles ?? opts.aiProfiles,
         aliasConfig: input.aliasConfig ?? opts.aliasConfig,
         nodes: input.nodes ?? opts.nodes,
         llmCall: input.llmCall ?? opts.llmCall,

package/dist/src/types/options.d.ts

@@ -1,7 +1,7 @@
 import type { Activix } from '@x12i/activix';
 import type { StackLoggingOptions } from '@x12i/logxer';
 import type { LlmCallConfig, RunTaskRequest as AiTasksRunTaskRequest, RunTaskResponse as AiTasksRunTaskResponse } from '@exellix/ai-tasks';
-import type { GraphModelAliasConfig, ModelConfigSelection, TaskNodeRuntimeObject } from './refs.js';
+import type { GraphAiModelConfig, GraphModelAliasConfig, ModelConfigSelection, TaskNodeRuntimeObject } from './refs.js';
 import type { RuntimeObjects } from '../runtime/runtimeObjects.js';
 /**
  * NOTE: `@exellix/ai-tasks` 5.5+ removed the exported `RunTaskDiagnostics` type.
@@ -63,6 +63,11 @@ export interface HostExecuteGraphRunOptions {
     playgroundMeta?: Record<string, unknown>;
     clearSynthesizedContextPerNode?: boolean;
     modelConfig?: ModelConfigSelection;
+    /**
+     * Profile aliases for xynthesis PRE/POST when {@link modelConfig} carries host-resolved concrete ids.
+     * MAIN `skillModel` still comes from resolved `modelConfig`; xynthesis slots prefer these aliases.
+     */
+    aiProfiles?: GraphAiModelConfig;
     aliasConfig?: GraphModelAliasConfig;
     nodes?: Record<string, TaskNodeRuntimeObject>;
     llmCall?: LlmCallConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exellix/graph-engine",
-  "version": "7.4.2",
+  "version": "7.4.3",
   "type": "module",
   "description": "Graph executor SDK",
   "main": "dist/src/index.js",
@@ -28,6 +28,8 @@
     "test": "npm run build && npm run check:no-legacy && tsx --test --test-force-exit tests/model-alias-contract.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 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-contract.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",
     "run:pre-synthesis": "npm run build && node --env-file=.env scripts/run-pre-synthesis-graph.mjs",
     "check:no-legacy": "node scripts/check-no-legacy.mjs",
     "lint": "eslint src testkit --ext .ts",