@exellix/graph-composer 2.14.0 → 2.15.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 2.15.0 — graph-engine 9.x response contract alignment
+
+### Changed
+
+- **Peer / dev:** `@exellix/graph-engine` **^9.0.0** — canonical `graph.response` only at execute; `validateGraphResponseWiring` on compile; optional `coerce: 'stringArray'` on response selectors.
+
+### Downstream
+
+- **graphs-playground:** remove execute-time response normalize/coerce; stamp `coerce: 'stringArray'` in studio presets at save time.
+
 ## 2.12.0 — Graphenix 2.7.3 + webQueryTemplate authoring
 
 ### Breaking

package/dist/funcxModel.d.ts

@@ -1,6 +1,3 @@
-/**
- * funcx 4.4+ uses `model` on call sites; legacy graph-composer options used `mode` (weak/normal/strong/ultra).
- */
 export declare function resolveFuncxModel(opts: {
     model?: string;
     mode?: string;

package/dist/funcxModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"funcxModel.d.ts","sourceRoot":"","sources":["../src/funcxModel.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAK7F"}
+{"version":3,"file":"funcxModel.d.ts","sourceRoot":"","sources":["../src/funcxModel.ts"],"names":[],"mappings":"AAmBA,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,GAAG,SAAS,CAcrB"}

package/dist/funcxModel.js

@@ -1,10 +1,32 @@
 /**
- * funcx 4.4+ uses `model` on call sites; legacy graph-composer options used `mode` (weak/normal/strong/ultra).
+ * funcx 4.9+ call sites require `model` as a profile/choice key or catalog slug.
+ * Legacy graph-composer options still accept `mode` (weak/normal/strong/ultra):
+ * resolve via LLM_MODEL_* env, then fall back to ai-profiles keys.
  */
+const MODE_ENV = {
+    weak: "LLM_MODEL_WEAK",
+    normal: "LLM_MODEL_NORMAL",
+    strong: "LLM_MODEL_STRONG",
+    ultra: "LLM_MODEL_ULTRA",
+};
+const MODE_DEFAULT_PROFILE = {
+    weak: "cheap/default",
+    normal: "balanced/default",
+    strong: "balanced/default",
+    ultra: "deep/default",
+};
 export function resolveFuncxModel(opts) {
     const model = opts.model?.trim();
     if (model)
         return model;
-    const mode = opts.mode?.trim();
-    return mode || undefined;
+    const mode = opts.mode?.trim().toLowerCase();
+    if (!mode)
+        return undefined;
+    const envKey = MODE_ENV[mode];
+    if (envKey) {
+        const fromEnv = process.env[envKey]?.trim();
+        if (fromEnv)
+            return fromEnv;
+    }
+    return MODE_DEFAULT_PROFILE[mode];
 }

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

@@ -12,13 +12,14 @@ You are a graph architect for the **worox-graph** flat authoring format (`@exell
 7. **Task node config:** For every **non-local** AI task node, set **`taskConfiguration.aiTaskProfile`** with non-empty **`preStrategyKey`** and **`postStrategyKey`**. Add **`taskConfiguration.narrix`** when discovery applies (discovery only). Add **`webQueryTemplate`** / **`inputSynthesis`** under **`aiTaskProfile`** when needed. Use **`inputsConfig`** + **`taskVariable`** + **`executionMapping`** (not deprecated `inputs` / `outputMapping`). Add **`metadata.graphReadability`** / **`catalogBinding`** for planning only.
 
 **Web scope (Graphenix 2.7.2+ — Rendrix template on `aiTaskProfile`, not `narrix`):**
+In emitted graph JSON, wrap input field paths in Rendrix double-brace delimiters (example field path: `input.assetId`).
 ```json
 "taskConfiguration": {
   "narrix": { "datasetId": "network.assets", "layer": "asset" },
   "aiTaskProfile": {
     "preStrategyKey": "pre-v1",
     "postStrategyKey": "post-v1",
-    "webQueryTemplate": "Is {{input.assetId}} reachable from the internet?"
+    "webQueryTemplate": "Is input.assetId reachable from the internet?"
   }
 }
 ```

package/functions/graph-composer/prompts/action-review-concept.md

@@ -29,7 +29,7 @@ Cover what matters for the graph at hand; skip axes that clearly do not apply. *
 - **Narrix discovery**: For **`professional-answer`** (or other LLM) nodes that imply discovery, check **`taskConfiguration.narrix`** (`datasetId`, `layer`, `narrativeTypeIds`) for coherence with **`inputsConfig`** / **`taskVariable`** and **`catalogCandidates.narrixTemplates`** when present.
 - **Catalog planning vs runtime**: When **`metadata.catalogBinding`** / **`metadata.catalogRequests`** (graph) exist, note mismatches vs actual **`taskConfiguration.narrix`** / **`taskConfiguration.scopingMapId`** on nodes, or vs gaps declared in **`catalogRequests`**.
 - **Graph I/O contracts**: When **`metadata.graphEntry`** or **`metadata.graphResponse`** exist, comment on whether **`inputs`**, **`taskVariable`**, execution paths, and finalizer outputs align with declared **`requiredExecutionPaths`** / **`notableExecutionPaths`** / schemas (authoring-level review).
-- **Web scoping + input synthesis (node-level)**: Under **`taskConfiguration.aiTaskProfile`**, web scope requires non-empty **`webQueryTemplate`** (Rendrix string with `{{input.*}}` refs) — do **not** author **`webScoping`** or web keys on **`narrix`**. When **`inputSynthesis.enabled`** is true, require non-empty **`catalogId`**, **`strategyKey`**, **`outputKey`**, **`sources`**, and **`destination`** (`job`, `task`, or `execution`).
+- **Web scoping + input synthesis (node-level)**: Under **`taskConfiguration.aiTaskProfile`**, web scope requires non-empty **`webQueryTemplate`** (Rendrix string with `input.<fieldName>` refs in double-brace syntax) — do **not** author **`webScoping`** or web keys on **`narrix`**. When **`inputSynthesis.enabled`** is true, require non-empty **`catalogId`**, **`strategyKey`**, **`outputKey`**, **`sources`**, and **`destination`** (`job`, `task`, or `execution`).
 - **Task decomposition**: One clear responsibility per node; avoid redundant or oversized steps.
 - **Skill selection**: Right tool for deterministic vs inferential work; catalog alignment in locked mode.
 - **Data flow**: Execution-memory paths and `jobContextMapping` / `inputs` trace from `input.*` or upstream writers; `taskVariable.question` and other task variables stay out of runtime payload bindings; `taskVariable` refs trace to top-level `variables`; no obvious dangling reads.

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

@@ -43,7 +43,7 @@ A graph is a single JSON object. Top-level fields (canonical root keys only):
     "aiTaskProfile": {
       "preStrategyKey": "<pre-strategy-row-id>",
       "postStrategyKey": "<post-strategy-row-id>",
-      "webQueryTemplate": "Optional Rendrix template, e.g. Patch status for {{input.cveId}}?",
+      "webQueryTemplate": "Optional Rendrix template, e.g. Patch status for input.cveId (wrap field paths in Rendrix double-brace syntax in real graph JSON)",
       "inputSynthesis": { "enabled": false }
     },
     "narrix": { "datasetId": "<optional>", "layer": "<optional>" },

package/functions/graph-composer/prompts/shared/structural-validation.md

@@ -10,7 +10,7 @@ Before returning any graph (create/modify only), verify:
 8. If `maxNodes` is set, the total node count does not exceed it.
 9. All `skillKey` values exist in the provided catalog (unless extensible mode is active).
 10. For every **AI task** node, include **`taskConfiguration.aiTaskProfile.preStrategyKey`** and **`postStrategyKey`** (non-empty strings matching deployment PRE/POST strategy catalog row ids). Omit only on local/utility skills.
-11. When web scope is needed, set non-empty **`taskConfiguration.aiTaskProfile.webQueryTemplate`** (Rendrix string with `{{input.*}}` refs). Optional **`webQueryTemplates[]`** for pack mode. Do **not** author **`webScoping`** or web keys on **`narrix`**.
+11. When web scope is needed, set non-empty **`taskConfiguration.aiTaskProfile.webQueryTemplate`** (Rendrix string with `input.<fieldName>` refs in double-brace syntax). Optional **`webQueryTemplates[]`** for pack mode. Do **not** author **`webScoping`** or web keys on **`narrix`**.
 12. When **`inputSynthesis.enabled`** is `true`, set non-empty **`inputSynthesis.catalogId`**, **`strategyKey`**, **`outputKey`**, **`sources`** (memory paths), and **`destination`** (`job`, `task`, or `execution`). Do not add manual PRE `synthesized-context` steps when profile synthesis is enabled.
 13. Do not author deprecated task-node **`inputs`** or **`outputMapping`** — use **`inputsConfig`** and **`executionMapping`**.
 14. **Narrix** belongs under **`taskConfiguration.narrix`** (`datasetId`, `layer`, `narrativeTypeIds` when needed). Discovery only — no web fields on `narrix`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exellix/graph-composer",
-  "version": "2.14.0",
+  "version": "2.15.0",
   "publishConfig": {
     "access": "public"
   },
@@ -36,7 +36,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-concurrency=1 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/authoring-graph-validation.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/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:unit": "node --import tsx/esm --test --test-force-exit --test-concurrency=1 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/authoring-graph-validation.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/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/unit/funcx-model.test.ts test/unit/instruction-template.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"
@@ -76,7 +76,7 @@
     }
   },
   "dependencies": {
-    "@exellix/graph-engine": "^8.6.0",
+    "@exellix/graph-engine": "^9.0.0",
     "@x12i/catalox": "^5.9.8",
     "@x12i/env": "^4.0.3",
     "@x12i/funcx": "^4.9.13",