@exellix/graph-composer 2.4.2 → 2.5.0

package/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+## 2.5.0
+
+### Added
+
+- **Studio skill invoke preflight** (`studioSkillInvokePreflight.ts`): `analyzeTaskNodeRunTaskRequest`, `analyzeRunTaskRequest`, `analyzeRunSkillRequest`, `buildSkillRequestAnalysisPacket`, `formatSkillRequestAnalysisMarkdown`, and FuncX constant `FUNCX_ANALYZE_GATEWAY_INVOKE_REQUEST_ID`.
+- **Orchestrator invoke contract** (`llmCallConfig.ts`): `collectGraphOrchestratorInvokeWarnings`, `reasoningEffort` authoring helpers; wired into `collectCanonicalGraphWarnings`.
+- Re-exports **`buildTaskNodeRunTaskRequest`**, **`validateTaskNodeRunTaskConfig`**, **`validateTaskNodeRunTaskInvoke`** from `@exellix/graph-engine` for studio single-import ergonomics.
+
+### Changed
+
+- Worker prompts document **`taskConfiguration.llmCall`** tuning (`reasoningEffort`, no `maxTokens` on `modelConfig`).
+- **Peer dependencies:** `@exellix/graph-engine` ^7.7.3, `@exellix/ai-tasks` ^8.6.0, `@exellix/ai-skills` ^6.1.0 (optional; required for preflight).
+
+### Migration
+
+- Replace `@exellix/graph-engine` imports of **`analyzeTaskNodeRunTaskRequest`** / **`analyzeRunTaskRequest`** with **`@exellix/graph-composer`**.

package/README.md

@@ -285,6 +285,8 @@ graph-composer explain-basic
 | `loadCatalogCandidatesFromCatalox`, `createCatalox`, `unifiedCatalogItemToSkillDescriptor`, … | Build `catalogCandidates` from **Catalox** catalogs; see [`docs/catalog-metadb-end-state-contract.md`](./docs/catalog-metadb-end-state-contract.md). |
 | `reportTaskNodeProtocolGaps` | Offline list of **AI task** nodes violating **`taskConfiguration.aiTaskProfile`** (pre/post, **`webScoping.questions`** when enabled, **`inputSynthesis`** fields when synthesis is on). See `docs/task-node-execution-protocol.md`. |
 | `collectCanonicalGraphWarnings` | Warn-first **`@exellix/graph-engine`** canonical checks (top-level keys, metadata placement, memory paths, model profile aliases). |
+| `collectGraphOrchestratorInvokeWarnings` | Authoring: **`taskConfiguration.llmCall.reasoningEffort`**, reject **`maxTokens`** on **`modelConfig`**. |
+| **Studio preflight** | **`analyzeTaskNodeRunTaskRequest`**, **`analyzeRunTaskRequest`**, **`buildSkillRequestAnalysisPacket`**, **`formatSkillRequestAnalysisMarkdown`**, **`FUNCX_ANALYZE_GATEWAY_INVOKE_REQUEST_ID`** — moved from graph-engine / ai-tasks 8.6; see [`docs/graph-entry-agent-contract.md`](./docs/graph-entry-agent-contract.md). |
 | `analyzeGraphModelLayers`, `stampGraphModelLayersOnGraph`, `graphModelLayerLegend` | **Model map** for AI nodes: which `@x12i/ai-profiles` names win (PRE/MAIN/POST), resolved provider ids, precedence layer + color stack — **model JSON only** unless you pass an explicit `runtime` overlay. Stamp with `stampGraphModelLayersOnGraph` before explain/UI. |
 | `formatNodeWinningModelLabel`, `formatGraphDefaultModelLabel` | **Canvas / Agent View labels** — e.g. `balanced (openrouter/…)` on Inference nodes after stamp; see graphs-studio node chrome. |
 | `assertCanonicalGraphDocument` | Re-exported from graph-engine — **`validateCreateModifyOutput` hard-fails** when the canonicalized graph does not pass. |

package/dist/canonicalGraphWarnings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canonicalGraphWarnings.d.ts","sourceRoot":"","sources":["../src/canonicalGraphWarnings.ts"],"names":[],"mappings":"AAwIA;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAuHrE"}
+{"version":3,"file":"canonicalGraphWarnings.d.ts","sourceRoot":"","sources":["../src/canonicalGraphWarnings.ts"],"names":[],"mappings":"AAyIA;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAwHrE"}

package/dist/canonicalGraphWarnings.js

@@ -1,5 +1,6 @@
 import { getCanonicalGraphDocumentViolations, collectAiTasksNodeExtensionIssues, looksLikeConcreteModelId, } from "./graphEngineBridge.js";
 import { LEGACY_GRAPH_MODEL_ALIAS_TO_PROFILE } from "./graphAiModelConfigCanonicalize.js";
+import { collectGraphOrchestratorInvokeWarnings } from "./llmCallConfig.js";
 /** Local-skill execution keys that belong on taskConfiguration (graph-engine parity). */
 const LOCAL_SKILL_METADATA_KEYS = [
     "firstMatchWins",
@@ -208,5 +209,6 @@ export function collectCanonicalGraphWarnings(graph) {
         }
     }
     warnings.push(...collectModelProfileWarnings(g));
+    warnings.push(...collectGraphOrchestratorInvokeWarnings(graph));
     return warnings;
 }

package/dist/index.d.ts

@@ -22,6 +22,8 @@ export type { ParsedGraphConcept } from "./parseGraphConceptStory.js";
 export { reportTaskNodeProtocolGaps, DEFAULT_LOCAL_SKILL_KEYS, type AiTaskProfileMetadata, type TaskNodeProtocolGap, type TaskNodeProtocolIssueCode, type WebScopingNodeConfig, type InputSynthesisNodeConfig, type InputSynthesisDestination, } from "./aiTaskProfile.js";
 export { assertCanonicalGraphDocument, getCanonicalGraphDocumentViolations, CANONICAL_GRAPH_TOP_LEVEL_KEYS, GRAPH_ENGINE_MEMORY_PATH_ROOTS, isAllowedGraphEngineMemoryPath, collectAiTasksNodeExtensionIssues, assertAiTasksNodeExtensionsValid, resolveGraphEngineMemoryPathValue, buildGraphEngineMemoryResolutionRootFromWorkingMemory, DEFAULT_GRAPH_AI_MODEL_PROFILE_CONFIG, looksLikeConcreteModelId, isGraphAiProfileName, type GraphEngineMemoryResolutionRoot, } from "./graphEngineBridge.js";
 export { collectCanonicalGraphWarnings } from "./canonicalGraphWarnings.js";
+export { OPTIMIXER_REASONING_EFFORT_VALUES, collectGraphOrchestratorInvokeWarnings, isOptimixerReasoningEffort, type GraphTaskNodeLlmCallConfig, type OptimixerReasoningEffort, } from "./llmCallConfig.js";
+export { FUNCX_ANALYZE_GATEWAY_INVOKE_REQUEST_ID, FUNCX_MIN_VERSION_FOR_ANALYZE_GATEWAY, analyzeRunSkillRequest, analyzeRunTaskRequest, analyzeTaskNodeRunTaskRequest, buildTaskNodeRunTaskRequest, validateTaskNodeRunTaskConfig, validateTaskNodeRunTaskInvoke, validateTaskNodeRunTaskInvokeFromGraph, pickRunSkillRequestFields, validateRunTaskConfig, validateRunTaskInvoke, analyzeExpectedRunTaskInput, checkExpectedInputAgainstRequest, analyzeSkillRequest, buildSkillRequestAnalysisPacket, formatSkillRequestAnalysisMarkdown, type AnalyzeRunTaskRequestOptions, type AnalyzeRunTaskRequestResult, type AnalyzeTaskNodeRunTaskRequestArgs, type AnalyzeTaskNodeRunTaskRequestResult, type AnalyzeSkillRequestOptions, type AnalyzeSkillRequestResult, type SkillRequestAnalysisFinding, type SkillRequestAnalysisReport, type SkillRequestAnalysisVerdict, type BuildSkillRequestAnalysisPacketResult, type ValidateTaskNodeRunTaskConfigArgs, type ValidateTaskNodeRunTaskConfigResult, type ValidateTaskNodeRunTaskInvokeArgs, type ValidateTaskNodeRunTaskInvokeResult, type BuildTaskNodeRunTaskRequestArgs, type BuildTaskNodeRunTaskRequestResult, } from "./studioSkillInvokePreflight.js";
 export { analyzeGraphModelLayers, stampGraphModelLayersOnGraph, graphModelLayerLegend, graphModelProfileAccent, resolveGraphModelProfileName, readNodeGraphModelLayersFromNode, formatNodeWinningModelLabel, formatGraphDefaultModelLabel, type FormatNodeModelLabelOptions, type AnalyzeGraphModelLayersOptions, type GraphModelLayerPhase, type GraphModelLayerSource, type GraphModelLayerStackEntry, type GraphModelLayersAnalysis, type GraphModelLayersRuntimeOverlay, type GraphModelProfilesTriple, type NodeGraphModelLayers, } from "./graphModelLayers.js";
 export { resolveTaskNodeInputs, resolveTaskNodeInputsConfig, resolveTaskNodeTaskVariable, canonicalizeGraphTaskNodeTaskVariable, canonicalizeGraphModel, reportTaskNodeInputsLayoutIssues, taskNodeInputsLayoutWarningMessage, isTaskVariablePathRef, isTaskNode, isFinalizerNode, type TaskNodeInputsLayoutIssue, type TaskNodeInputsLayoutIssueCode, } from "./taskNodeTaskVariable.js";
 export { createCatalox, bindCataloxContext, Catalox, CataloxBound, } from "@x12i/catalox/embedder";

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -18,6 +18,8 @@ export { parseGraphConceptStory, parseGraphConceptStoryBody, isGraphConceptStory
 export { reportTaskNodeProtocolGaps, DEFAULT_LOCAL_SKILL_KEYS, } from "./aiTaskProfile.js";
 export { assertCanonicalGraphDocument, getCanonicalGraphDocumentViolations, CANONICAL_GRAPH_TOP_LEVEL_KEYS, GRAPH_ENGINE_MEMORY_PATH_ROOTS, isAllowedGraphEngineMemoryPath, collectAiTasksNodeExtensionIssues, assertAiTasksNodeExtensionsValid, resolveGraphEngineMemoryPathValue, buildGraphEngineMemoryResolutionRootFromWorkingMemory, DEFAULT_GRAPH_AI_MODEL_PROFILE_CONFIG, looksLikeConcreteModelId, isGraphAiProfileName, } from "./graphEngineBridge.js";
 export { collectCanonicalGraphWarnings } from "./canonicalGraphWarnings.js";
+export { OPTIMIXER_REASONING_EFFORT_VALUES, collectGraphOrchestratorInvokeWarnings, isOptimixerReasoningEffort, } from "./llmCallConfig.js";
+export { FUNCX_ANALYZE_GATEWAY_INVOKE_REQUEST_ID, FUNCX_MIN_VERSION_FOR_ANALYZE_GATEWAY, analyzeRunSkillRequest, analyzeRunTaskRequest, analyzeTaskNodeRunTaskRequest, buildTaskNodeRunTaskRequest, validateTaskNodeRunTaskConfig, validateTaskNodeRunTaskInvoke, validateTaskNodeRunTaskInvokeFromGraph, pickRunSkillRequestFields, validateRunTaskConfig, validateRunTaskInvoke, analyzeExpectedRunTaskInput, checkExpectedInputAgainstRequest, analyzeSkillRequest, buildSkillRequestAnalysisPacket, formatSkillRequestAnalysisMarkdown, } from "./studioSkillInvokePreflight.js";
 export { analyzeGraphModelLayers, stampGraphModelLayersOnGraph, graphModelLayerLegend, graphModelProfileAccent, resolveGraphModelProfileName, readNodeGraphModelLayersFromNode, formatNodeWinningModelLabel, formatGraphDefaultModelLabel, } from "./graphModelLayers.js";
 export { resolveTaskNodeInputs, resolveTaskNodeInputsConfig, resolveTaskNodeTaskVariable, canonicalizeGraphTaskNodeTaskVariable, canonicalizeGraphModel, reportTaskNodeInputsLayoutIssues, taskNodeInputsLayoutWarningMessage, isTaskVariablePathRef, isTaskNode, isFinalizerNode, } from "./taskNodeTaskVariable.js";
 export { createCatalox, bindCataloxContext, Catalox, CataloxBound, } from "@x12i/catalox/embedder";

package/dist/llmCallConfig.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Graph authoring contract for MAIN invoke tuning (`node.taskConfiguration.llmCall`).
+ * Runtime: graph-engine merges `llmCall` with resolved `skillModel`; ai-tasks forwards to ai-skills Optimixer.
+ *
+ * Hosts send: model (runtime-resolved), temperature, topP, reasoningEffort, timeoutMs, outputExpectation.
+ * Hosts do not send: maxTokens / max_completion_tokens on modelConfig or as a literal completion budget on llmCall.
+ */
+/** Mirrors `@x12i/optimixer` — kept local so graph-composer does not depend on optimixer directly. */
+export type OptimixerReasoningEffort = "not-applicable" | "none" | "low" | "medium" | "high";
+export declare const OPTIMIXER_REASONING_EFFORT_VALUES: readonly OptimixerReasoningEffort[];
+/** Authoring shape for `taskConfiguration.llmCall` on graph JSON (model set at runtime by graph-engine). */
+export type GraphTaskNodeLlmCallConfig = {
+    /** Ignored on graph JSON — graph-engine sets from resolved skillModel at runTask. */
+    model?: string;
+    temperature?: number;
+    topP?: number;
+    reasoningEffort?: OptimixerReasoningEffort;
+    maxOutputLength?: number;
+    timeoutMs?: number;
+    outputExpectation?: Record<string, unknown>;
+    /** @deprecated Use outputExpectation; literal caps are Optimixer-owned at invoke. */
+    maxTokensCap?: number;
+    /** @deprecated Optimixer-owned; do not author on new graphs. */
+    maxTokens?: number;
+    max_tokens?: number;
+    max_completion_tokens?: number;
+    max_output_tokens?: number;
+};
+export declare function isOptimixerReasoningEffort(value: unknown): value is OptimixerReasoningEffort;
+/** Warn-only checks for orchestrator invoke contract on static graph JSON. */
+export declare function collectGraphOrchestratorInvokeWarnings(graph: object): string[];
+//# sourceMappingURL=llmCallConfig.d.ts.map

package/dist/llmCallConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llmCallConfig.d.ts","sourceRoot":"","sources":["../src/llmCallConfig.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sGAAsG;AACtG,MAAM,MAAM,wBAAwB,GAChC,gBAAgB,GAChB,MAAM,GACN,KAAK,GACL,QAAQ,GACR,MAAM,CAAC;AAEX,eAAO,MAAM,iCAAiC,EAAE,SAAS,wBAAwB,EAMvE,CAAC;AAEX,4GAA4G;AAC5G,MAAM,MAAM,0BAA0B,GAAG;IACvC,qFAAqF;IACrF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,wBAAwB,CAAC;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,qFAAqF;IACrF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAwBF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,wBAAwB,CAK5F;AAED,8EAA8E;AAC9E,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA4E9E"}

package/dist/llmCallConfig.js

@@ -0,0 +1,100 @@
+/**
+ * Graph authoring contract for MAIN invoke tuning (`node.taskConfiguration.llmCall`).
+ * Runtime: graph-engine merges `llmCall` with resolved `skillModel`; ai-tasks forwards to ai-skills Optimixer.
+ *
+ * Hosts send: model (runtime-resolved), temperature, topP, reasoningEffort, timeoutMs, outputExpectation.
+ * Hosts do not send: maxTokens / max_completion_tokens on modelConfig or as a literal completion budget on llmCall.
+ */
+export const OPTIMIXER_REASONING_EFFORT_VALUES = [
+    "not-applicable",
+    "none",
+    "low",
+    "medium",
+    "high",
+];
+const LEGACY_LLM_CALL_TOKEN_KEYS = [
+    "maxTokens",
+    "max_tokens",
+    "max_completion_tokens",
+    "max_output_tokens",
+];
+const FORBIDDEN_MODEL_CONFIG_TOKEN_KEYS = [
+    "maxTokens",
+    "max_tokens",
+    "max_completion_tokens",
+    "max_output_tokens",
+    "maxTokensCap",
+];
+function readRecord(v) {
+    if (v === null || v === undefined || typeof v !== "object" || Array.isArray(v)) {
+        return undefined;
+    }
+    return v;
+}
+export function isOptimixerReasoningEffort(value) {
+    return (typeof value === "string" &&
+        OPTIMIXER_REASONING_EFFORT_VALUES.includes(value));
+}
+/** Warn-only checks for orchestrator invoke contract on static graph JSON. */
+export function collectGraphOrchestratorInvokeWarnings(graph) {
+    const warnings = [];
+    const g = graph;
+    const nodes = g.nodes;
+    if (!Array.isArray(nodes))
+        return warnings;
+    for (let i = 0; i < nodes.length; i++) {
+        const node = readRecord(nodes[i]);
+        if (node === undefined)
+            continue;
+        const nodeId = typeof node.id === "string" ? node.id : `nodes[${i}]`;
+        const prefix = `node "${nodeId}"`;
+        const tc = readRecord(node.taskConfiguration);
+        const llmCall = readRecord(tc?.llmCall);
+        if (llmCall !== undefined) {
+            for (const key of LEGACY_LLM_CALL_TOKEN_KEYS) {
+                if (key in llmCall) {
+                    warnings.push(`${prefix}: taskConfiguration.llmCall.${key} is deprecated — token budget is Optimixer-owned at invoke; use outputExpectation / reasoningEffort instead.`);
+                }
+            }
+            if ("maxTokensCap" in llmCall) {
+                warnings.push(`${prefix}: taskConfiguration.llmCall.maxTokensCap is deprecated in ai-tasks 8.6+ — use outputExpectation; step retry may still bump caps at runtime only.`);
+            }
+            if (llmCall.reasoningEffort !== undefined &&
+                !isOptimixerReasoningEffort(llmCall.reasoningEffort)) {
+                warnings.push(`${prefix}: taskConfiguration.llmCall.reasoningEffort must be one of ${OPTIMIXER_REASONING_EFFORT_VALUES.join(", ")}.`);
+            }
+            if (typeof llmCall.model === "string" && llmCall.model.trim() !== "") {
+                warnings.push(`${prefix}: taskConfiguration.llmCall.model is ignored on graph JSON — graph-engine sets llmCall.model from resolved skillModel.`);
+            }
+        }
+        const modelConfigSel = readRecord(tc?.modelConfig);
+        if (modelConfigSel?.cases && Array.isArray(modelConfigSel.cases)) {
+            for (let c = 0; c < modelConfigSel.cases.length; c++) {
+                const caseRow = readRecord(modelConfigSel.cases[c]);
+                const triple = readRecord(caseRow?.modelConfig);
+                if (triple === undefined)
+                    continue;
+                for (const key of FORBIDDEN_MODEL_CONFIG_TOKEN_KEYS) {
+                    if (key in triple) {
+                        warnings.push(`${prefix}: taskConfiguration.modelConfig.cases[${c}].modelConfig.${key} is forbidden — profile triple only (preActionModel, skillModel, postActionModel).`);
+                    }
+                }
+            }
+        }
+    }
+    const rootSel = readRecord(g.modelConfig);
+    if (rootSel?.cases && Array.isArray(rootSel.cases)) {
+        for (let c = 0; c < rootSel.cases.length; c++) {
+            const caseRow = readRecord(rootSel.cases[c]);
+            const triple = readRecord(caseRow?.modelConfig);
+            if (triple === undefined)
+                continue;
+            for (const key of FORBIDDEN_MODEL_CONFIG_TOKEN_KEYS) {
+                if (key in triple) {
+                    warnings.push(`graph.modelConfig.cases[${c}].modelConfig.${key} is forbidden — profile triple only.`);
+                }
+            }
+        }
+    }
+    return warnings;
+}

package/dist/studioSkillInvokePreflight.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Studio / graphs-composer preflight — skill invoke analysis and RunTask validation.
+ *
+ * Moved out of `@exellix/graph-engine` and `@exellix/ai-tasks` runtime exports (8.6+).
+ * Studio should depend on `@exellix/graph-composer` for these checks, not graph-engine execute paths.
+ */
+import type { Catalox } from "@x12i/catalox";
+import type { Logxer } from "@x12i/logxer";
+import type { RunTaskRequest } from "@exellix/ai-tasks";
+import { pickRunSkillRequestFields, validateRunTaskConfig, validateRunTaskInvoke, analyzeExpectedRunTaskInput, checkExpectedInputAgainstRequest, type RunTaskValidationIssue, type ValidateRunTaskInvokeParams } from "@exellix/ai-tasks";
+import { buildTaskNodeRunTaskRequest, validateTaskNodeRunTaskConfig, validateTaskNodeRunTaskInvoke } from "@exellix/graph-engine";
+import type { BuildTaskNodeRunTaskRequestArgs, BuildTaskNodeRunTaskRequestResult, ValidateTaskNodeRunTaskConfigArgs, ValidateTaskNodeRunTaskConfigResult, ValidateTaskNodeRunTaskInvokeArgs, ValidateTaskNodeRunTaskInvokeResult } from "@exellix/graph-engine";
+import { analyzeSkillRequest } from "@exellix/ai-skills/dist/analysis/analyze-skill-request.js";
+import { buildSkillRequestAnalysisPacket } from "@exellix/ai-skills/dist/analysis/build-skill-request-analysis-packet.js";
+import { formatSkillRequestAnalysisMarkdown } from "@exellix/ai-skills/dist/analysis/format-skill-request-analysis-markdown.js";
+import type { AnalyzeSkillRequestOptions, AnalyzeSkillRequestResult, BuildSkillRequestAnalysisPacketResult, SkillRequestAnalysisFinding, SkillRequestAnalysisReport, SkillRequestAnalysisVerdict } from "@exellix/ai-skills/dist/analysis/types.js";
+/** FuncX optional LLM review step (see `@x12i/funcx` GATEWAY-INVOKE-ANALYSIS). */
+export declare const FUNCX_ANALYZE_GATEWAY_INVOKE_REQUEST_ID: "ai-skills/analyze-gateway-invoke-request";
+export declare const FUNCX_MIN_VERSION_FOR_ANALYZE_GATEWAY: "4.3.3";
+export type { AnalyzeSkillRequestOptions, AnalyzeSkillRequestResult, BuildSkillRequestAnalysisPacketResult, SkillRequestAnalysisFinding, SkillRequestAnalysisReport, SkillRequestAnalysisVerdict, BuildTaskNodeRunTaskRequestArgs, BuildTaskNodeRunTaskRequestResult, ValidateTaskNodeRunTaskConfigArgs, ValidateTaskNodeRunTaskConfigResult, ValidateTaskNodeRunTaskInvokeArgs, ValidateTaskNodeRunTaskInvokeResult, };
+export { buildTaskNodeRunTaskRequest, validateTaskNodeRunTaskConfig, validateTaskNodeRunTaskInvoke, pickRunSkillRequestFields, validateRunTaskConfig, validateRunTaskInvoke, analyzeExpectedRunTaskInput, checkExpectedInputAgainstRequest, analyzeSkillRequest, buildSkillRequestAnalysisPacket, formatSkillRequestAnalysisMarkdown, };
+export type AnalyzeRunTaskRequestOptions = AnalyzeSkillRequestOptions & {
+    logger?: Logxer;
+    /** When true (default), merge validateRunTaskConfig into the analysis report. */
+    includeAiTasksConfigValidation?: boolean;
+};
+export type AnalyzeRunTaskRequestResult = AnalyzeSkillRequestResult & {
+    aiTasksConfigValidation?: {
+        ok: boolean;
+        issues: RunTaskValidationIssue[];
+    };
+};
+/** Preflight on a flat {@link RunSkillRequest} slice (Catalox templates + deterministic checks). */
+export declare function analyzeRunSkillRequest(catalox: Catalox, skillRequest: Parameters<typeof analyzeSkillRequest>[1], options?: AnalyzeSkillRequestOptions & {
+    logger?: Logxer;
+}): Promise<AnalyzeSkillRequestResult>;
+/**
+ * Preflight for a graph-built or hand-authored {@link RunTaskRequest}.
+ * Does not invoke runTask, xynthesis, or the gateway.
+ */
+export declare function analyzeRunTaskRequest(catalox: Catalox, request: RunTaskRequest, options?: AnalyzeRunTaskRequestOptions): Promise<AnalyzeRunTaskRequestResult>;
+export type AnalyzeTaskNodeRunTaskRequestArgs = BuildTaskNodeRunTaskRequestArgs & {
+    catalox: Catalox;
+    analyzeOptions?: AnalyzeRunTaskRequestOptions;
+};
+export type AnalyzeTaskNodeRunTaskRequestResult = {
+    skipped: true;
+    skillKey: string;
+    reason: "local_skill" | "finalizer";
+} | ({
+    skipped: false;
+    skillKey: string;
+    request: RunTaskRequest;
+} & AnalyzeRunTaskRequestResult);
+/** Build the same RunTaskRequest as graph-engine executeNode, then run studio preflight. */
+export declare function analyzeTaskNodeRunTaskRequest(args: AnalyzeTaskNodeRunTaskRequestArgs): Promise<AnalyzeTaskNodeRunTaskRequestResult>;
+export type ValidateTaskNodeRunTaskInvokeWithTemplatesArgs = ValidateTaskNodeRunTaskInvokeArgs & Omit<ValidateRunTaskInvokeParams, "request">;
+/** validateTaskNodeRunTaskInvoke re-export with stable name for studio imports. */
+export { validateTaskNodeRunTaskInvoke as validateTaskNodeRunTaskInvokeFromGraph };
+//# sourceMappingURL=studioSkillInvokePreflight.d.ts.map

package/dist/studioSkillInvokePreflight.d.ts.map

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

package/dist/studioSkillInvokePreflight.js

@@ -0,0 +1,104 @@
+import { pickRunSkillRequestFields, validateRunTaskConfig, validateRunTaskInvoke, analyzeExpectedRunTaskInput, checkExpectedInputAgainstRequest, } from "@exellix/ai-tasks";
+import { buildTaskNodeRunTaskRequest, validateTaskNodeRunTaskConfig, validateTaskNodeRunTaskInvoke, } from "@exellix/graph-engine";
+import { analyzeSkillRequest } from "@exellix/ai-skills/dist/analysis/analyze-skill-request.js";
+import { buildSkillRequestAnalysisPacket } from "@exellix/ai-skills/dist/analysis/build-skill-request-analysis-packet.js";
+import { formatSkillRequestAnalysisMarkdown } from "@exellix/ai-skills/dist/analysis/format-skill-request-analysis-markdown.js";
+/** FuncX optional LLM review step (see `@x12i/funcx` GATEWAY-INVOKE-ANALYSIS). */
+export const FUNCX_ANALYZE_GATEWAY_INVOKE_REQUEST_ID = "ai-skills/analyze-gateway-invoke-request";
+export const FUNCX_MIN_VERSION_FOR_ANALYZE_GATEWAY = "4.3.3";
+export { buildTaskNodeRunTaskRequest, validateTaskNodeRunTaskConfig, validateTaskNodeRunTaskInvoke, pickRunSkillRequestFields, validateRunTaskConfig, validateRunTaskInvoke, analyzeExpectedRunTaskInput, checkExpectedInputAgainstRequest, analyzeSkillRequest, buildSkillRequestAnalysisPacket, formatSkillRequestAnalysisMarkdown, };
+function categoryForAiTasksIssue(issue) {
+    const p = issue.path ?? "";
+    if (p.startsWith("smartInput"))
+        return "smartInput";
+    if (p.includes("executionPipeline"))
+        return "template";
+    if (p.includes("executionMemory"))
+        return "executionMemory";
+    if (p.includes("modelConfig") || p.includes("llmCall") || p.includes("timeoutMs")) {
+        return "modelConfig";
+    }
+    if (p.startsWith("agentId") || p.startsWith("jobTypeId") || p.startsWith("taskTypeId")) {
+        return "activix";
+    }
+    return "catalog";
+}
+function aiTasksIssueToFinding(issue) {
+    return {
+        id: `AI_TASKS_${issue.code}`,
+        severity: issue.severity,
+        category: categoryForAiTasksIssue(issue),
+        path: issue.path,
+        message: issue.message,
+        suggestion: "Fix the RunTaskRequest field before runTask() or graph compile.",
+    };
+}
+function mergeVerdict(a, b) {
+    if (a === "errors" || b === "errors")
+        return "errors";
+    if (a === "warnings" || b === "warnings")
+        return "warnings";
+    return "ok";
+}
+/** Preflight on a flat {@link RunSkillRequest} slice (Catalox templates + deterministic checks). */
+export async function analyzeRunSkillRequest(catalox, skillRequest, options) {
+    return analyzeSkillRequest(catalox, skillRequest, options);
+}
+/**
+ * Preflight for a graph-built or hand-authored {@link RunTaskRequest}.
+ * Does not invoke runTask, xynthesis, or the gateway.
+ */
+export async function analyzeRunTaskRequest(catalox, request, options) {
+    const skillRequest = pickRunSkillRequestFields(request);
+    let aiTasksConfigValidation;
+    const extraFindings = [];
+    if (options?.includeAiTasksConfigValidation !== false) {
+        const v = validateRunTaskConfig(request);
+        aiTasksConfigValidation = { ok: v.ok, issues: v.issues };
+        extraFindings.push(...v.issues.map(aiTasksIssueToFinding));
+    }
+    const skillResult = await analyzeSkillRequest(catalox, skillRequest, options);
+    if (extraFindings.length === 0) {
+        return { ...skillResult, aiTasksConfigValidation };
+    }
+    const mergedFindings = [...skillResult.deterministicFindings, ...extraFindings];
+    const configVerdict = aiTasksConfigValidation?.ok
+        ? "ok"
+        : aiTasksConfigValidation?.issues.some((issue) => issue.severity === "error")
+            ? "errors"
+            : "warnings";
+    const verdict = mergeVerdict(skillResult.verdict, configVerdict);
+    const report = {
+        ...skillResult.report,
+        verdict,
+        findings: [...skillResult.report.findings, ...extraFindings],
+        configAssessment: {
+            ...skillResult.report.configAssessment,
+            issues: [
+                ...skillResult.report.configAssessment.issues,
+                ...extraFindings.filter((f) => f.category === "modelConfig" ||
+                    f.category === "catalog" ||
+                    f.category === "activix" ||
+                    f.category === "template"),
+            ],
+        },
+    };
+    return {
+        ...skillResult,
+        verdict,
+        deterministicFindings: mergedFindings,
+        report,
+        aiTasksConfigValidation,
+    };
+}
+/** Build the same RunTaskRequest as graph-engine executeNode, then run studio preflight. */
+export async function analyzeTaskNodeRunTaskRequest(args) {
+    const built = await buildTaskNodeRunTaskRequest(args);
+    if (!built.runnable) {
+        return { skipped: true, skillKey: built.skillKey, reason: built.reason };
+    }
+    const analysis = await analyzeRunTaskRequest(args.catalox, built.request, args.analyzeOptions);
+    return { ...analysis, skipped: false, skillKey: built.skillKey, request: built.request };
+}
+/** validateTaskNodeRunTaskInvoke re-export with stable name for studio imports. */
+export { validateTaskNodeRunTaskInvoke as validateTaskNodeRunTaskInvokeFromGraph };

package/functions/graph-composer/prompts/shared/graph-format.md

@@ -64,11 +64,13 @@ A graph is a single JSON object. Top-level fields (canonical root keys only):
 | Dynamic task config | `taskVariable` | `question`, literals, `$path` to `jobVariables.*` / `taskVariables.*`. |
 | Node templates | `variables` | Node-only defaults → `taskVariables.*` at run time. |
 | Graph templates | top-level `variables` | Run-wide defaults → `jobVariables.*` (legacy path alias `variables.*`). |
-| Execution config | `taskConfiguration.*` | `aiTaskProfile`, `narrix`, `modelConfig`, `executionStrategies`, `aiTasksOutputValidation`, local-skill keys (`rules`, `scopingMapId`, `firstMatchWins`, …), … |
+| Execution config | `taskConfiguration.*` | `aiTaskProfile`, `narrix`, `modelConfig`, `executionStrategies`, `aiTasksOutputValidation`, **`llmCall`** (tuning only), local-skill keys (`rules`, `scopingMapId`, `firstMatchWins`, …), … |
 | Planning / UX | `metadata.*` | `graphReadability`, `catalogBinding`, `name`, `description` — **not** `aiTaskProfile` or `narrix`. |
 | Result wiring | `executionMapping` | Writes into execution memory after the task succeeds. |
 
 - **AI task nodes** must include **`taskConfiguration.aiTaskProfile`** with non-empty **`preStrategyKey`** and **`postStrategyKey`** (deployment catalog row ids). Add **`taskConfiguration.narrix`** when discovery applies. Add **`webScoping`** / **`inputSynthesis`** under **`aiTaskProfile`** when needed. Legacy **`metadata.aiTaskProfile`** is dual-read and canonicalized to **`taskConfiguration`** on output — do not author new graphs under `metadata`.
+- **`taskConfiguration.llmCall`** (MAIN tuning only): optional **`temperature`**, **`topP`**, **`reasoningEffort`** (`not-applicable` | `none` | `low` | `medium` | `high`), **`timeoutMs`**, **`outputExpectation`**. Do **not** author **`maxTokens`**, **`max_completion_tokens`**, or **`maxTokensCap`** — Optimixer owns completion budget at invoke. Do **not** set **`llmCall.model`** on graph JSON (runtime resolves from **`skillModel`**).
+- **`modelConfig`** cases hold **`@x12i/ai-profiles` profile names only** in three slots — never token caps or provider ids on graph JSON.
 - `skillKey` must come from the provided skill catalog unless extensible mode is active.
 - Do **not** put `question`, literals, or `$path` variable refs under `inputsConfig`. Do **not** use deprecated task-node `inputs` or `outputMapping` (graph-composer renames them on output).
 - `taskVariable.question` should be clear and self-contained.

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@exellix/graph-composer",
-  "version": "2.4.2",
+  "version": "2.5.0",
   "publishConfig": {
     "access": "public"
   },
-  "description": "LLM-backed worox-graph DAG composer: create, modify, explain, suggestConceptObjective, reviewConcept, graph-entry agent patches (reviewGraphEntryContract, suggestGraphEntry*), catalog resolution/creation, scoping need match and scoping map creation plans, plus optional orchestrator — OpenRouter via @x12i/funcx; catalog rows from @x12i/catalox (loadCatalogCandidatesFromCatalox)",
+  "description": "LLM-backed worox-graph DAG composer and studio preflight: graph authoring actions, graph-entry patches, skill invoke analysis (analyzeTaskNodeRunTaskRequest), llmCall/reasoningEffort orchestrator contract — OpenRouter via @x12i/funcx; catalog rows from @x12i/catalox",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -23,6 +23,7 @@
     "functions",
     "examples",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE",
     ".env.example"
   ],
@@ -36,7 +37,7 @@
     "verify:local": "tsx src/verify-local.ts",
     "verify:catalog-live": "x12i-env run --env-file .env -- tsx scripts/verify-catalog-live.ts",
     "test": "npm run test:unit && npm run test:live",
-    "test:unit": "node --import tsx/esm --test --test-force-exit test/unit/explain-shape.test.ts test/unit/graph-concept-patch.test.ts test/unit/graph-concept-story-parse.test.ts test/unit/review-concept-output-validation.test.ts test/unit/review-concept-catalog-alias.test.ts test/unit/redact-for-log.test.ts test/unit/graph-composer-logging.test.ts test/unit/worker-instructions.test.ts test/unit/catalog-output-validation.test.ts test/unit/catalox-catalog-bridge.test.ts test/unit/ai-task-profile.test.ts test/unit/create-modify-output-validation.test.ts test/unit/task-node-task-variable.test.ts test/unit/canonical-graph-document.test.ts test/unit/graph-engine-bridge.test.ts test/unit/graph-model-layers.test.ts test/unit/example-generation.test.ts test/unit/graph-entry-schema.test.ts test/unit/graph-entry-patch-validation.test.ts test/unit/graph-entry-entity-alignment.test.ts test/unit/graph-entry-example-generation.test.ts test/unit/model-config-patch-merge.test.ts test/unit/graph-entry-registry.test.ts test/unit/graph-model-label-format.test.ts",
+    "test:unit": "node --import tsx/esm --test --test-force-exit test/unit/explain-shape.test.ts test/unit/graph-concept-patch.test.ts test/unit/graph-concept-story-parse.test.ts test/unit/review-concept-output-validation.test.ts test/unit/review-concept-catalog-alias.test.ts test/unit/redact-for-log.test.ts test/unit/graph-composer-logging.test.ts test/unit/worker-instructions.test.ts test/unit/catalog-output-validation.test.ts test/unit/catalox-catalog-bridge.test.ts test/unit/ai-task-profile.test.ts test/unit/create-modify-output-validation.test.ts test/unit/task-node-task-variable.test.ts test/unit/canonical-graph-document.test.ts test/unit/graph-engine-bridge.test.ts test/unit/graph-model-layers.test.ts test/unit/example-generation.test.ts test/unit/graph-entry-schema.test.ts test/unit/graph-entry-patch-validation.test.ts test/unit/graph-entry-entity-alignment.test.ts test/unit/graph-entry-example-generation.test.ts test/unit/model-config-patch-merge.test.ts test/unit/graph-entry-registry.test.ts test/unit/graph-model-label-format.test.ts test/unit/llm-call-config.test.ts",
     "test:live": "x12i-env run --env-file .env -- node --import tsx/esm --test test/live/all.ts",
     "pack:check": "npm pack --dry-run",
     "suggest-smoke": "x12i-env run --env-file .env -- tsx scripts/run-suggest-concept-smoke.ts"
@@ -63,11 +64,19 @@
   },
   "homepage": "https://github.com/woroces/graph-composer#readme",
   "peerDependencies": {
-    "@exellix/graph-engine": "^7.7.1"
+    "@exellix/ai-skills": "^6.1.0",
+    "@exellix/ai-tasks": "^8.6.0",
+    "@exellix/graph-engine": "^7.7.3"
   },
   "peerDependenciesMeta": {
     "@exellix/graph-engine": {
       "optional": true
+    },
+    "@exellix/ai-tasks": {
+      "optional": true
+    },
+    "@exellix/ai-skills": {
+      "optional": true
     }
   },
   "dependencies": {
@@ -78,7 +87,9 @@
     "@x12i/logxer": "^4.6.0"
   },
   "devDependencies": {
-    "@exellix/graph-engine": "^7.7.1",
+    "@exellix/ai-skills": "^6.1.0",
+    "@exellix/ai-tasks": "^8.6.1",
+    "@exellix/graph-engine": "^7.7.3",
     "@types/node": "^22.10.2",
     "@x12i/rendrix": "^4.3.0",
     "nx-config2": "^3.6.5",