@exellix/graph-composer 2.5.8 → 2.6.0

package/README.md

@@ -21,7 +21,7 @@ LLM-backed **graph composer** for the **worox-graph** DAG format using [@x12i/fu
 
    Pass **`catalogCandidates`** on `GraphComposerAgentInput` when the goal involves catalog or scoping tools (host loads rows from **Catalox** via `loadCatalogCandidatesFromCatalox`, or supplies fixtures).
 
-Upstream feature requests/specs for first-class tool loops, worker profiles, chat, preset tool arguments, and Rendrix-rendered templates in FuncX/aifunctions-js: [docs/aifunctions-agent-toolbox-feature-request.md](./docs/aifunctions-agent-toolbox-feature-request.md), [docs/funcx-generic-pack-spec.md](./docs/funcx-generic-pack-spec.md).
+FuncX pack / example-generation contract: [docs/funcx-generic-pack-spec.md](./docs/funcx-generic-pack-spec.md).
 
 ## Install
 
@@ -42,7 +42,9 @@ Requires **Node.js 20+** (Catalox embedder and this package align on `>=20`).
 | `LOGXER_PACKAGE_LEVELS` | No | Bulk levels, e.g. `GRAPH_COMPOSER:debug,GRAPH_ENGINE:warn` (applied at module load). |
 | `LOGXER_PACKAGE_LOGS_DEFAULT` | No | Registry default when a prefix has no override (default `warn`). |
 
-Copy [`.env.example`](./.env.example) to `.env` for local development. **Do not commit secrets.**
+Copy [`.env.example`](./.env.example) to `.env` for local development. **Do not commit secrets.** API keys are env-only — never embed `OPENROUTER_API_KEY` in graph JSON or composer input objects.
+
+**Composer `maxTokens` vs graph JSON:** `RunGraphComposerOptions.maxTokens` caps the **composer LLM's own** completion when generating or editing graphs. Authored graph nodes must **not** carry token caps on `taskConfiguration.llmCall` or `modelConfig` — Optimixer owns completion budget at `@exellix/ai-tasks` invoke time.
 
 ## Quick start (direct worker)
 
@@ -295,7 +297,7 @@ graph-composer explain-basic
 | `parseGraphConceptStory`, `isGraphConceptStoryDescription`, `GRAPH_CONCEPT_STORY_MARKER`, … | Parse **graph concept story** text for `create` / `modify` / reviews. |
 | `redactSecretsForLog` | Deep-redact sensitive key names for logging (used by `reviewConcept` tracing). |
 
-`RunGraphComposerOptions`: `client`, `mode`, `model`, `temperature`, `maxTokens`, `askTimeoutMs`, `connectTimeoutMs`, **`catalogMatchListsAssist`**, **`traceReviewConceptIo`**, **`logsLevel`**, **`logging`** — see [integration handoff](./docs/integration-handoff.md).
+`RunGraphComposerOptions`: `client`, `mode`, `model`, `temperature`, `maxTokens`, `askTimeoutMs`, `connectTimeoutMs`, **`catalogMatchListsAssist`**, **`traceReviewConceptIo`**, **`logsLevel`**, **`logging`** — see `RunGraphComposerOptions` in package types / `runGraphComposer.ts`.
 
 **Deep stacks (@x12i/logxer ≥ 4.5):** Call `applyPackageLogLevelsFromEnv()` / `configurePackageLogLevels()` in the host before importing graph-composer, or pass `logging: { packageLevels: { GRAPH_COMPOSER: 'debug' } }` on `runGraphComposer`. Re-exported: `configurePackageLogLevels`, `applyPackageLogLevelsFromEnv`, `StackLoggingOptions`.
 
@@ -330,18 +332,16 @@ npx nx-config2 run --env-file .env -- npm test
 
 **Maintainer smoke (suggest only, truncated JSON):** `npm run suggest-smoke` (repo only; uses `scripts/run-suggest-concept-smoke.ts`).
 
-**Catalox / Firestore live catalog probe:** `npm run verify:catalog-live` — lists configured **`aiSkills`** merge catalogs (core skills + PRE/POST by default; synthesis catalog **only if** `GC_VERIFY_CATALOG_INPUT_SYNTHESIS_MODES` is set) and runs **`loadCatalogCandidatesFromCatalox`**. Defaults **`CataloxContext.superAdmin=true`**; with **@x12i/catalox ≥ 3.4.6**, **`CATALOX_APP_ID`** is optional (catalog-id-first). Needs **`FIREBASE_PROJECT_ID`** (or other project id env) and **`FIREBASE_SERVICE_ACCOUNT_PATH`** / base64 SA / ADC. See [docs/catalox-multi-app-context.md](./docs/catalox-multi-app-context.md) and [docs/catalog-metadb-end-state-contract.md](./docs/catalog-metadb-end-state-contract.md) § Live verification.
+**Catalox / Firestore live catalog probe:** `npm run verify:catalog-live` — lists configured **`aiSkills`** merge catalogs (core skills + PRE/POST by default; synthesis catalog **only if** `GC_VERIFY_CATALOG_INPUT_SYNTHESIS_MODES` is set) and runs **`loadCatalogCandidatesFromCatalox`**. Defaults **`CataloxContext.superAdmin=true`**; with **@x12i/catalox ≥ 3.4.6**, **`CATALOX_APP_ID`** is optional (catalog-id-first). Needs **`FIREBASE_PROJECT_ID`** (or other project id env) and **`FIREBASE_SERVICE_ACCOUNT_PATH`** / base64 SA / ADC. See [docs/catalog-metadb-end-state-contract.md](./docs/catalog-metadb-end-state-contract.md) § Live verification.
 
 ## Documentation in this repo
 
-- **Handoff / forward notes:** [docs/integration-handoff.md](./docs/integration-handoff.md)
 - **Catalog shapes & inspection:** [docs/worox-graphs-catalogs.md](./docs/worox-graphs-catalogs.md)
 - **MetaDB / host CRUD handoff:** [docs/catalog-metadb-end-state-contract.md](./docs/catalog-metadb-end-state-contract.md)
 - **Task node (`aiTaskProfile`) + worox-graph alignment:** [docs/task-node-worox-graph-and-graph-composer.md](./docs/task-node-worox-graph-and-graph-composer.md) · [docs/task-node-execution-protocol.md](./docs/task-node-execution-protocol.md)
-- **aifunctions-js agent toolbox FR:** [docs/aifunctions-agent-toolbox-feature-request.md](./docs/aifunctions-agent-toolbox-feature-request.md)
-- **Funcx example generation context:** [docs/funcx-example-generation-feature-request.md](./docs/funcx-example-generation-feature-request.md)
-- **Verify suggestConceptObjective:** [docs/verify-suggest-concept-objective.md](./docs/verify-suggest-concept-objective.md)
-- **aifunctions-js transport report:** [docs/report-aifunctions-js-undici-http.md](./docs/report-aifunctions-js-undici-http.md)
+- **FuncX pack spec:** [docs/funcx-generic-pack-spec.md](./docs/funcx-generic-pack-spec.md)
+- **Graph entry agent contract:** [docs/graph-entry-agent-contract.md](./docs/graph-entry-agent-contract.md)
+- **Normative graph object formats:** `@exellix/graph-engine` → `formats-documentations/`
 - **Historical spec:** [docs/specs.md](./docs/specs.md) — not published on npm
 
 Published npm tarball still **does not** ship `docs/`; clone the repo or read these on GitHub for integration details.

package/dist/canonicalGraphDocument.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canonicalGraphDocument.d.ts","sourceRoot":"","sources":["../src/canonicalGraphDocument.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmbH,qFAAqF;AACrF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAc7E;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAiCtF;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAWpF"}
+{"version":3,"file":"canonicalGraphDocument.d.ts","sourceRoot":"","sources":["../src/canonicalGraphDocument.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwcH,qFAAqF;AACrF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAc7E;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAiCtF;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAWpF"}

package/dist/canonicalGraphDocument.js

@@ -207,14 +207,32 @@ function ensureGraphResponse(graph) {
     return changed;
 }
 function canonicalizeTaskConfigurationExecutionStrategies(node) {
-    const tc = readRecord(node.taskConfiguration);
-    if (tc === undefined || tc.executionStrategies === undefined)
+    if (node.type !== 'task' && node.type !== undefined)
         return false;
-    const normalized = canonicalizeExecutionStrategies(tc.executionStrategies);
-    if (normalized === tc.executionStrategies)
+    const skillKey = node.skillKey;
+    if (typeof skillKey !== 'string' || skillKey.trim() === '')
         return false;
-    node.taskConfiguration = { ...tc, executionStrategies: normalized };
-    return true;
+    let tc = readRecord(node.taskConfiguration);
+    let changed = false;
+    if (tc === undefined) {
+        tc = {};
+        changed = true;
+    }
+    if (tc.executionStrategies === undefined) {
+        tc = { ...tc, executionStrategies: [] };
+        changed = true;
+    }
+    else {
+        const normalized = canonicalizeExecutionStrategies(tc.executionStrategies);
+        if (normalized !== tc.executionStrategies) {
+            tc = { ...tc, executionStrategies: normalized };
+            changed = true;
+        }
+    }
+    if (changed) {
+        node.taskConfiguration = tc;
+    }
+    return changed;
 }
 function extractWebQuestionsFromNarrix(narrix) {
     const raw = narrix.webScopeQuestions;

package/dist/canonicalGraphWarnings.d.ts.map

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

package/dist/canonicalGraphWarnings.js

@@ -87,7 +87,7 @@ function collectModelProfileWarnings(graph) {
             }
         }
         if ("xynthesisModel" in o) {
-            warnings.push(`${path}: xynthesisModel was removed in graph-engine 7.1 — use preActionModel, skillModel, and postActionModel with profile names (cheap, balanced, deep).`);
+            warnings.push(`${path}: xynthesisModel was removed in graph-engine 7.1 — use preActionModel, skillModel, and postActionModel with profile/choice keys (e.g. cheap/default, pro/default).`);
         }
     };
     const checkSelection = (selection, path) => {
@@ -183,6 +183,11 @@ export function collectCanonicalGraphWarnings(graph) {
                 }
             }
         }
+        if (node.type === "task" && typeof node.skillKey === "string" && node.skillKey.trim() !== "") {
+            if (tc?.executionStrategies === undefined) {
+                warnings.push(`${prefix}: taskConfiguration.executionStrategies is missing — use [] for plain MAIN.`);
+            }
+        }
         const extIssues = collectAiTasksNodeExtensionIssues(node, `nodes[${i}]`);
         for (const issue of extIssues) {
             warnings.push(`${prefix}: ${issue.code} at ${issue.path}: ${issue.message}`);

package/dist/graphAiModelConfigCanonicalize.d.ts

@@ -1,7 +1,7 @@
 /**
  * Canonicalize graph JSON modelConfig toward graph-engine 7.1+ shape:
  * `{ cases: [{ modelConfig: { preActionModel, skillModel, postActionModel } }] }`
- * with graph-engine profile names (cheap, balanced, deep, …).
+ * with profile/choice keys (e.g. cheap/default, pro/default).
  */
 export type GraphAiModelConfigTriple = {
     preActionModel: string;

package/dist/graphAiModelConfigCanonicalize.js

@@ -1,7 +1,7 @@
 /**
  * Canonicalize graph JSON modelConfig toward graph-engine 7.1+ shape:
  * `{ cases: [{ modelConfig: { preActionModel, skillModel, postActionModel } }] }`
- * with graph-engine profile names (cheap, balanced, deep, …).
+ * with profile/choice keys (e.g. cheap/default, pro/default).
  */
 function readRecord(v) {
     if (v === null || v === undefined || typeof v !== "object" || Array.isArray(v)) {

package/dist/graphModelLayers.d.ts

@@ -47,8 +47,9 @@ export type GraphModelLayersRuntimeOverlay = {
 };
 export type AnalyzeGraphModelLayersOptions = {
     /**
-     * Optional runtime overlay. Omit to analyze **model-authored** config only (recommended).
-     * Do not inject `runtime.modelConfig` at execute time unless you intend to override the graph.
+     * Optional runtime overlay for **studio planning analysis only**.
+     * graph-engine 7.7+ rejects runtime model overrides at execute time — do not inject
+     * `runtime.modelConfig` or `runtime.nodes[id].modelConfig` into executeGraph.
      */
     runtime?: GraphModelLayersRuntimeOverlay;
     utilitySkills?: Iterable<{

package/dist/graphModelLayers.d.ts.map

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

package/dist/graphModelLayers.js

@@ -322,7 +322,7 @@ export async function stampGraphModelLayersOnGraph(graph, options) {
                 ? { providerIds: analysis.graphDefaultProviderIds }
                 : {}),
         },
-        note: "Planning overlay only. Profile names come from graph JSON and graph-engine defaults; concrete provider ids are resolved at execute time by ai-tasks / xynthesis. Omit runtime.modelConfig unless you intend to override the graph.",
+        note: "Planning overlay only. Profile/choice keys come from graph JSON and graph-engine defaults; concrete provider ids are resolved at execute time by ai-tasks. Runtime model overlays are analysis-only — graph-engine 7.7+ rejects them at execute time.",
     };
     g.metadata = rootMeta;
     return graph;

package/dist/llmCallConfig.js

@@ -53,11 +53,11 @@ export function collectGraphOrchestratorInvokeWarnings(graph) {
         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.`);
+                    warnings.push(`${prefix}: taskConfiguration.llmCall.${key} is forbidden — 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.`);
+                warnings.push(`${prefix}: taskConfiguration.llmCall.maxTokensCap is forbidden — use outputExpectation; completion budget is Optimixer-owned at invoke.`);
             }
             if (llmCall.reasoningEffort !== undefined &&
                 !isOptimixerReasoningEffort(llmCall.reasoningEffort)) {

package/functions/graph-composer/prompts/action-create.md

@@ -1,4 +1,4 @@
-You are a graph architect for the **GraphModelObject** static graph format (`docs/formats-documentations/`). Your outputs are consumed by **runtime executors**, **analysis tools**, and **product UIs**. Optimize for: **correct structure**, **faithfulness to the user’s `intent.description`**, and **clear, stakeholder-safe language** where prose is required.
+You are a graph architect for the **GraphModelObject** static graph format (`@exellix/graph-engine` `formats-documentations/`). Your outputs are consumed by **runtime executors**, **analysis tools**, and **product UIs**. Optimize for: **correct structure**, **faithfulness to the user’s `intent.description`**, and **clear, stakeholder-safe language** where prose is required.
 
 **You ONLY perform `action = "create"` in this call.** Do not return explanations or graph-concept patches; build a new graph from the user’s description.
 

package/functions/graph-composer/prompts/action-modify.md

@@ -1,4 +1,4 @@
-You are a graph architect for the **GraphModelObject** static graph format (`docs/formats-documentations/`). Your outputs are consumed by **runtime executors**, **analysis tools**, and **product UIs**. Optimize for: **correct structure**, **faithfulness to the user’s `intent.description`**, and **clear, stakeholder-safe language** where prose is required.
+You are a graph architect for the **GraphModelObject** static graph format (`@exellix/graph-engine` `formats-documentations/`). Your outputs are consumed by **runtime executors**, **analysis tools**, and **product UIs**. Optimize for: **correct structure**, **faithfulness to the user’s `intent.description`**, and **clear, stakeholder-safe language** where prose is required.
 
 **You ONLY perform `action = "modify"` in this call.** Do not produce a greenfield design unrelated to `existingGraph`.
 

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

@@ -1,6 +1,6 @@
 ## Format reference (worox-graph / GraphModelObject)
 
-Normative contracts for the **worox-graph** DAG JSON model: `docs/formats-documentations/graph-model-object-format.md` and `task-node-model-object-format.md`. Graph-composer emits **static model** JSON consumed by `@exellix/graph-engine`.
+Normative contracts for the **worox-graph** DAG JSON model: `@exellix/graph-engine` `formats-documentations/graph-model-object-format.md` and `task-node-model-object-format.md`. Graph-composer emits **static model** JSON consumed by `@exellix/graph-engine`.
 
 A graph is a single JSON object. Top-level fields (canonical root keys only):
 
@@ -11,7 +11,7 @@ A graph is a single JSON object. Top-level fields (canonical root keys only):
 - `variables` (object, optional): graph-level defaults → run as `jobVariables.*` at execution.
 - `response` (object, required for new graphs): executable final output contract (`missing`, `shape` with selectors such as `outputsMemoryPath`, `executionMemoryPath`, `literal`, `firstPresent`).
 - `metadata` (object, optional): authoring only (`name`, `description`, `graphEntry`, `graphExecution`, `catalogRequests`, `graphConcept`, …). **No execution wiring under `metadata`.**
-- `modelConfig`, `jobKnowledge` (optional): see format docs. **`modelConfig` cases use `@x12i/ai-profiles` profile names only** (`cheap`, `balanced`, `deep`, …) — three slots per case: `preActionModel`, `skillModel`, `postActionModel`. Never provider ids like `openrouter/...`. Resolution uses bundled `@x12i/ai-profiles`; `runtime.aliasConfig` is optional.
+- `modelConfig`, `jobKnowledge` (optional): see format docs. **`modelConfig` cases use profile/choice keys only** (e.g. `cheap/default`, `pro/default`) — three slots per case: `preActionModel`, `skillModel`, `postActionModel`. Never provider ids like `openrouter/...`. Do **not** author `runtime.modelConfig`, `runtime.aliasConfig`, or `runtime.nodes[id].modelConfig` — graph-engine 7.7+ rejects runtime model routing.
 
 ### Task node shape
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exellix/graph-composer",
-  "version": "2.5.8",
+  "version": "2.6.0",
   "publishConfig": {
     "access": "public"
   },
@@ -64,8 +64,8 @@
   },
   "homepage": "https://github.com/woroces/graph-composer#readme",
   "peerDependencies": {
-    "@exellix/ai-tasks": "^8.6.2",
-    "@exellix/graph-engine": "^7.7.8"
+    "@exellix/ai-tasks": "^8.7.0",
+    "@exellix/graph-engine": "7.8.1"
   },
   "peerDependenciesMeta": {
     "@exellix/graph-engine": {
@@ -81,13 +81,13 @@
   "dependencies": {
     "@x12i/catalox": "^5.1.3",
     "@x12i/env": "^4.0.1",
-    "@x12i/funcx": "^4.4.0",
+    "@x12i/funcx": "^4.4.4",
     "@x12i/logxer": "^4.6.0"
   },
   "devDependencies": {
-    "@exellix/ai-skills": "^6.1.0",
-    "@exellix/ai-tasks": "^8.6.1",
-    "@exellix/graph-engine": "^7.7.8",
+    "@exellix/ai-skills": "^6.4.0",
+    "@exellix/ai-tasks": "^8.7.0",
+    "@exellix/graph-engine": "7.8.1",
     "@types/node": "^22.10.2",
     "@x12i/rendrix": "^4.3.0",
     "nx-config2": "^3.6.5",