@exellix/graph-composer 2.3.1 → 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

@@ -9,7 +9,7 @@ The Git repo lives under the **woroces** org with repo name **graph-composer**.
 
 LLM-backed **graph composer** for the **worox-graph** DAG format using [@x12i/funcx](https://www.npmjs.com/package/@x12i/funcx) and OpenRouter.
 
-**Graph structure:** **create**, **modify**, **explain**. **Product metadata:** **suggestConceptObjective** (`metadata.graphConcept`). **Concept QA:** **reviewConcept** (verdict + findings, no graph rewrite). **Managed catalogs (Catalox-backed rows → planning JSON only — host applies CRUD):** **suggestCatalogResolution**, **suggestCatalogCreations**. **Scoping-only:** **suggestScopingNeedMatch** (natural-language need vs `catalogCandidates.scopingMaps`), **suggestScopingMapCreation** (`scopingMapProposal` + `catalogRequestProposals`).
+**Graph structure:** **create**, **modify**, **explain**. **Product metadata:** **suggestConceptObjective** (`metadata.graphConcept`). **Concept QA:** **reviewConcept** (verdict + findings, no graph rewrite). **Job-start / Layer 01 (graphs-studio Agent View):** **reviewGraphEntryContract**, **suggestGraphEntryInputs**, **suggestGraphEntryExamples**, **suggestGraphEntryConditions**, **suggestJobModelDefaults**, **suggestJobKnowledgeRefs**, **suggestGraphExecutionDefaults** — partial patches only; see [docs/graph-entry-agent-contract.md](./docs/graph-entry-agent-contract.md). **Managed catalogs (Catalox-backed rows → planning JSON only — host applies CRUD):** **suggestCatalogResolution**, **suggestCatalogCreations**. **Scoping-only:** **suggestScopingNeedMatch** (natural-language need vs `catalogCandidates.scopingMaps`), **suggestScopingMapCreation** (`scopingMapProposal` + `catalogRequestProposals`).
 
 ## Architecture (two ways to run)
 
@@ -17,11 +17,11 @@ LLM-backed **graph composer** for the **worox-graph** DAG format using [@x12i/fu
 
 2. **Orchestrator (`runGraphComposerAgent`)** — You pass a natural-language **`goal`**. The orchestrator uses **`runJsonCompletion`** (structured JSON steps) to choose **registered tools**, then runs each selection via the **same** `runGraphWorker` path as direct mode. This costs **more tokens and latency** (multiple LLM rounds) than a single direct call.
 
-   Registered tool ids (mirror `GRAPH_COMPOSER_ACTION_REGISTRY`): `graph_create`, `graph_modify`, `graph_explain`, `graph_suggest_concept_objective`, `graph_suggest_catalog_resolution`, `graph_suggest_catalog_creations`, `graph_suggest_scoping_need_match`, `graph_suggest_scoping_map_creation`, `graph_review_concept`.
+   Registered tool ids (mirror `GRAPH_COMPOSER_ACTION_REGISTRY`): `graph_create`, `graph_modify`, `graph_explain`, `graph_suggest_concept_objective`, `graph_suggest_catalog_resolution`, `graph_suggest_catalog_creations`, `graph_suggest_scoping_need_match`, `graph_suggest_scoping_map_creation`, `graph_review_concept`, `graph_review_graph_entry_contract`, `graph_suggest_graph_entry_inputs`, `graph_suggest_graph_entry_examples`, `graph_suggest_graph_entry_conditions`, `graph_suggest_job_model_defaults`, `graph_suggest_job_knowledge_refs`, `graph_suggest_graph_execution_defaults`.
 
    Pass **`catalogCandidates`** on `GraphComposerAgentInput` when the goal involves catalog or scoping tools (host loads rows from **Catalox** via `loadCatalogCandidatesFromCatalox`, or supplies fixtures).
 
-Upstream feature request for first-class tool loops / worker profiles in aifunctions-js: [docs/aifunctions-agent-toolbox-feature-request.md](./docs/aifunctions-agent-toolbox-feature-request.md).
+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).
 
 ## Install
 
@@ -285,7 +285,10 @@ 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. |
 | `GRAPH_ENGINE_MEMORY_PATH_ROOTS` | Re-exported memory path allowlist from graph-engine — use for validation parity, not a forked copy. |
 | `WoroxScopingMapCatalogCreatePayload`, `WoroxScopedDataDocumentShape` | Host-side CRUD handoff (align field names with your persisted catalog / scoping schema). |

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/catalogMatchAssist.d.ts

@@ -1,9 +1,8 @@
 import type { Client } from "@x12i/funcx";
-import type { LlmMode } from "@x12i/funcx/functions";
 import type { GraphComposerInput, SkillDescriptor } from "./types.js";
 export type CatalogMatchAssistOptions = {
     client: Client;
-    mode?: LlmMode;
+    mode?: string;
     model?: string;
     temperature?: number;
     maxTokens?: number;

package/dist/catalogMatchAssist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalogMatchAssist.d.ts","sourceRoot":"","sources":["../src/catalogMatchAssist.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAEV,kBAAkB,EAGlB,eAAe,EAChB,MAAM,YAAY,CAAC;AAgKpB,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,kBAAkB,GAAG;IAC1B,SAAS,EAAE,QAAQ,GAAG,YAAY,CAAC;IACnC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,aAAa,EAAE,eAAe,EAAE,CAAC;CAClC,EACD,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAqF9C"}
+{"version":3,"file":"catalogMatchAssist.d.ts","sourceRoot":"","sources":["../src/catalogMatchAssist.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAEV,kBAAkB,EAGlB,eAAe,EAChB,MAAM,YAAY,CAAC;AAgKpB,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,kBAAkB,GAAG;IAC1B,SAAS,EAAE,QAAQ,GAAG,YAAY,CAAC;IACnC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,aAAa,EAAE,eAAe,EAAE,CAAC;CAClC,EACD,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAmF9C"}

package/dist/catalogMatchAssist.js

@@ -1,4 +1,5 @@
 import { matchLists } from "@x12i/funcx/functions";
+import { resolveFuncxModel } from "./funcxModel.js";
 function mergeBySkillKey(a, b) {
     if (!b?.length)
         return [...a];
@@ -152,7 +153,8 @@ export async function buildCatalogMatchHints(input, opts) {
         return undefined;
     }
     const hints = {};
-    const { client, mode, model } = opts;
+    const { client } = opts;
+    const model = resolveFuncxModel(opts);
     const aiMerged = mergeBySkillKey(input.aiSkills, cc.aiSkills);
     const utilMerged = mergeBySkillKey(input.utilitySkills, cc.utilitySkills);
     const allSkills = [...utilMerged, ...aiMerged];
@@ -163,7 +165,6 @@ export async function buildCatalogMatchHints(input, opts) {
             list1: nodeSummaries,
             list2: skillCatalogItems(allSkills),
             guidance: "Match each graph task node to the single best catalog skillKey by operational role (data read, rules, LLM, scoped IO, assembly). Prefer local/utility skills for deterministic work. Use reason briefly.",
-            mode,
             client,
             model,
         }, { rules: [] });
@@ -178,7 +179,6 @@ export async function buildCatalogMatchHints(input, opts) {
             list1: scopingNodes,
             list2: scopingCatalogItems(scopingMaps),
             guidance: "Match each scoped-data or scoping-related node to the best scopingMapId or questionId candidate by what the node reads/asks and entity scope. reason briefly.",
-            mode,
             client,
             model,
         }, { rules: [] });
@@ -193,7 +193,6 @@ export async function buildCatalogMatchHints(input, opts) {
             list1: narrixNodes,
             list2: narrixCatalogItems(narrixTemplates),
             guidance: "Match each node that has metadata.narrix to the best narrix template candidate (layer, datasetId, narrativeTypeIds, web scope). reason briefly.",
-            mode,
             client,
             model,
         }, { rules: [] });

package/dist/cataloxCatalogBridge.d.ts

@@ -13,7 +13,6 @@
 import type { Catalox } from "@x12i/catalox/embedder";
 import type { CataloxContext, CatalogQueryOptions, UnifiedCatalogItem } from "@x12i/catalox/embedder";
 import type { Client } from "@x12i/funcx";
-import type { LlmMode } from "@x12i/funcx/functions";
 import type { CatalogCandidates, NarrixTemplateCandidate, ScopingMapCandidate, SkillDescriptor } from "./types.js";
 /**
  * Which Catalox `catalogId` to read for each optional fetch. Several keys
@@ -57,7 +56,7 @@ export type CataloxCatalogBridgeAiItemMatch = {
     minScore?: number;
     /** Max rows pulled from Catalox before ranking (default 200). */
     poolLimit?: number;
-    mode?: LlmMode;
+    mode?: string;
     /** Required: OpenRouter-backed funcx client (same as graph-composer workers). */
     client: Client;
     model?: string;

package/dist/cataloxCatalogBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cataloxCatalogBridge.d.ts","sourceRoot":"","sources":["../src/cataloxCatalogBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EACV,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,0EAA0E;IAC1E,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,qEAAqE;IACrE,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG,OAAO,CACnD,MAAM,CAAC,MAAM,8BAA8B,EAAE,mBAAmB,GAAG,SAAS,CAAC,CAC9E,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,gCAAgC,GAAG,OAAO,CACpD,MAAM,CAAC,MAAM,8BAA8B,EAAE,cAAc,CAAC,CAC7D,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,UAAU,EAAE,8BAA8B,CAAC;IAC3C,WAAW,CAAC,EAAE,+BAA+B,CAAC;IAC9C,4HAA4H;IAC5H,WAAW,CAAC,EAAE,+BAA+B,CAAC;IAC9C;;;OAGG;IACH,kBAAkB,CAAC,EAAE,gCAAgC,CAAC;CACvD,CAAC;AA2FF;;;GAGG;AACH,wBAAgB,mCAAmC,CACjD,IAAI,EAAE,kBAAkB,GACvB,eAAe,CAwBjB;AAED;;GAEG;AACH,wBAAgB,uCAAuC,CACrD,IAAI,EAAE,kBAAkB,GACvB,mBAAmB,CASrB;AAED;;GAEG;AACH,wBAAgB,2CAA2C,CACzD,IAAI,EAAE,kBAAkB,GACvB,uBAAuB,CAYzB;AA2CD;;;GAGG;AACH,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,iBAAiB,CAAC,CAyF5B"}
+{"version":3,"file":"cataloxCatalogBridge.d.ts","sourceRoot":"","sources":["../src/cataloxCatalogBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,KAAK,EACV,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,0EAA0E;IAC1E,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,qEAAqE;IACrE,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG,OAAO,CACnD,MAAM,CAAC,MAAM,8BAA8B,EAAE,mBAAmB,GAAG,SAAS,CAAC,CAC9E,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,gCAAgC,GAAG,OAAO,CACpD,MAAM,CAAC,MAAM,8BAA8B,EAAE,cAAc,CAAC,CAC7D,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,UAAU,EAAE,8BAA8B,CAAC;IAC3C,WAAW,CAAC,EAAE,+BAA+B,CAAC;IAC9C,4HAA4H;IAC5H,WAAW,CAAC,EAAE,+BAA+B,CAAC;IAC9C;;;OAGG;IACH,kBAAkB,CAAC,EAAE,gCAAgC,CAAC;CACvD,CAAC;AA0FF;;;GAGG;AACH,wBAAgB,mCAAmC,CACjD,IAAI,EAAE,kBAAkB,GACvB,eAAe,CAwBjB;AAED;;GAEG;AACH,wBAAgB,uCAAuC,CACrD,IAAI,EAAE,kBAAkB,GACvB,mBAAmB,CASrB;AAED;;GAEG;AACH,wBAAgB,2CAA2C,CACzD,IAAI,EAAE,kBAAkB,GACvB,uBAAuB,CAYzB;AA2CD;;;GAGG;AACH,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,iBAAiB,CAAC,CAyF5B"}

package/dist/cataloxCatalogBridge.js

@@ -1,4 +1,5 @@
 import { rank } from "@x12i/funcx/functions";
+import { resolveFuncxModel } from "./funcxModel.js";
 function resolveBridgeContext(bridgeKey, baseContext, options) {
     const pin = options.contextByBridgeKey?.[bridgeKey];
     return pin ?? baseContext;
@@ -39,9 +40,8 @@ async function rankCatalogPoolWithFuncx(pool, ai) {
     const ranked = await rank({
         items: payloads,
         query: ai.query,
-        mode: ai.mode ?? "normal",
         client: ai.client,
-        model: ai.model,
+        model: resolveFuncxModel({ model: ai.model, mode: ai.mode ?? "normal" }),
     }, { rules: [] });
     const byId = new Map(pool.map((it) => [String(it.itemId), it]));
     const raw = ranked.rankedItems;

package/dist/exampleGeneration.d.ts

@@ -1,4 +1,5 @@
 import { generateContentExample, generateJsonExample, generateMdExample, type ExampleGenLlmOptions, type GenerateContentExampleParams, type GenerateContentExampleResult, type GenerateJsonExampleResult, type GenerateMdExampleParams, type GenerateMdExampleResult } from "@x12i/funcx/functions";
+import type { GraphConceptEntityBindings } from "./types.js";
 export type GenerateGraphJsonInputExampleParams = ExampleGenLlmOptions & {
     /** JSON Schema for the input payload expected by the graph. */
     jsonSchema: unknown;
@@ -11,5 +12,15 @@ export type GenerateGraphJsonInputExampleParams = ExampleGenLlmOptions & {
 };
 export declare function buildGraphInputExampleGuidance(existingGraph: object | undefined, guidance?: string[]): string[];
 export declare function generateGraphJsonInputExample(params: GenerateGraphJsonInputExampleParams): Promise<GenerateJsonExampleResult>;
+export declare function buildGraphEntryExampleGuidance(graphEntry: Record<string, unknown> | object | undefined, graphConcept?: Record<string, unknown>, entityBindings?: GraphConceptEntityBindings, extraGuidance?: string[]): string[];
+export type GenerateGraphEntryInputExampleParams = ExampleGenLlmOptions & {
+    graph?: object;
+    graphEntry?: Record<string, unknown> | object;
+    entityBindings?: GraphConceptEntityBindings;
+    guidance?: string[];
+    examples?: unknown[];
+    seed?: unknown;
+};
+export declare function generateGraphEntryInputExample(params: GenerateGraphEntryInputExampleParams): Promise<GenerateJsonExampleResult>;
 export { generateContentExample, generateJsonExample, generateMdExample, type GenerateContentExampleParams, type GenerateContentExampleResult, type GenerateJsonExampleResult, type GenerateMdExampleParams, type GenerateMdExampleResult, };
 //# sourceMappingURL=exampleGeneration.d.ts.map

package/dist/exampleGeneration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exampleGeneration.d.ts","sourceRoot":"","sources":["../src/exampleGeneration.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC7B,MAAM,uBAAuB,CAAC;AAI/B,MAAM,MAAM,mCAAmC,GAAG,oBAAoB,GAAG;IACvE,+DAA+D;IAC/D,UAAU,EAAE,OAAO,CAAC;IACpB,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB,CAAC;AA0DF,wBAAgB,8BAA8B,CAC5C,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,QAAQ,GAAE,MAAM,EAAO,GACtB,MAAM,EAAE,CASV;AAED,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,mCAAmC,GAC1C,OAAO,CAAC,yBAAyB,CAAC,CAcpC;AAED,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,GAC7B,CAAC"}
+{"version":3,"file":"exampleGeneration.d.ts","sourceRoot":"","sources":["../src/exampleGeneration.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC7B,MAAM,uBAAuB,CAAC;AAM/B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAI7D,MAAM,MAAM,mCAAmC,GAAG,oBAAoB,GAAG;IACvE,+DAA+D;IAC/D,UAAU,EAAE,OAAO,CAAC;IACpB,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB,CAAC;AA0DF,wBAAgB,8BAA8B,CAC5C,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,QAAQ,GAAE,MAAM,EAAO,GACtB,MAAM,EAAE,CASV;AAED,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,mCAAmC,GAC1C,OAAO,CAAC,yBAAyB,CAAC,CAcpC;AAED,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,EACxD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,cAAc,CAAC,EAAE,0BAA0B,EAC3C,aAAa,GAAE,MAAM,EAAO,GAC3B,MAAM,EAAE,CAmCV;AAED,MAAM,MAAM,oCAAoC,GAAG,oBAAoB,GAAG;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;IAC9C,cAAc,CAAC,EAAE,0BAA0B,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,oCAAoC,GAC3C,OAAO,CAAC,yBAAyB,CAAC,CAoCpC;AAED,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,GAC7B,CAAC"}

package/dist/exampleGeneration.js

@@ -1,4 +1,5 @@
 import { generateContentExample, generateJsonExample, generateMdExample, } from "@x12i/funcx/functions";
+import { buildGraphEntryExampleJsonSchema, resolveEffectiveGraphEntry, } from "./graphEntryContract.js";
 function asObject(v) {
     return v !== null && typeof v === "object" && !Array.isArray(v)
         ? v
@@ -69,4 +70,57 @@ export async function generateGraphJsonInputExample(params) {
         ...llmOptions,
     });
 }
+export function buildGraphEntryExampleGuidance(graphEntry, graphConcept, entityBindings, extraGuidance = []) {
+    const entry = resolveEffectiveGraphEntry(graphEntry !== undefined && typeof graphEntry === "object"
+        ? graphEntry
+        : undefined);
+    const inputs = Array.isArray(entry.inputs) ? entry.inputs : [];
+    const pathHints = inputs
+        .slice(0, 12)
+        .map((row, i) => {
+        const r = row;
+        const path = typeof r.path === "string" ? r.path : "";
+        const kind = typeof r.kind === "string" ? r.kind : "scalar";
+        return path ? `${i + 1}. ${kind} @ ${path}` : undefined;
+    })
+        .filter((x) => x !== undefined);
+    const hints = [
+        "Generate example rows for metadata.graphEntry.exampleInputs (graph job-start contract).",
+        "Each example value must be a string; use format json with parseable JSON in value.",
+        "Paths must align with metadata.graphEntry.inputs under execution.input.*.",
+    ];
+    if (pathHints.length > 0) {
+        hints.push(`Declared entry inputs: ${pathHints.join(" | ")}.`);
+    }
+    if (entityBindings?.coreEntityCollectionId) {
+        hints.push(`Core entity collection: ${entityBindings.coreEntityCollectionId}.`);
+    }
+    const expected = graphConcept?.expectedInput;
+    if (typeof expected === "string" && expected.trim()) {
+        hints.push(`Concept expectedInput: ${truncate(expected)}.`);
+    }
+    return [...hints, ...extraGuidance];
+}
+export async function generateGraphEntryInputExample(params) {
+    const { graph, graphEntry, entityBindings, guidance, examples, ...llmOptions } = params;
+    const entry = graphEntry !== undefined
+        ? resolveEffectiveGraphEntry(graphEntry)
+        : graph !== undefined
+            ? resolveEffectiveGraphEntry(graph)
+            : {};
+    const inputs = (Array.isArray(entry.inputs) ? entry.inputs : []);
+    const jsonSchema = buildGraphEntryExampleJsonSchema(inputs, entityBindings);
+    const concept = graph !== null && graph !== undefined && typeof graph === "object"
+        ? graph.metadata?.graphConcept
+        : undefined;
+    const eb = entityBindings ??
+        concept?.entityBindings;
+    return generateGraphJsonInputExample({
+        jsonSchema,
+        existingGraph: graph,
+        guidance: buildGraphEntryExampleGuidance(entry, concept, eb, guidance),
+        examples,
+        ...llmOptions,
+    });
+}
 export { generateContentExample, generateJsonExample, generateMdExample, };

package/dist/funcxModel.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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;
+}): string | undefined;
+//# sourceMappingURL=funcxModel.d.ts.map

package/dist/funcxModel.d.ts.map

@@ -0,0 +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"}

package/dist/funcxModel.js

@@ -0,0 +1,10 @@
+/**
+ * funcx 4.4+ uses `model` on call sites; legacy graph-composer options used `mode` (weak/normal/strong/ultra).
+ */
+export function resolveFuncxModel(opts) {
+    const model = opts.model?.trim();
+    if (model)
+        return model;
+    const mode = opts.mode?.trim();
+    return mode || undefined;
+}

package/dist/graphComposerActions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graphComposerActions.d.ts","sourceRoot":"","sources":["../src/graphComposerActions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EACL,KAAK,eAAe,EASrB,MAAM,oCAAoC,CAAC;AAE5C,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AAEhE,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,uDAAuD;IACvD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC;CAC1C,CAAC;AAaF,eAAO,MAAM,8BAA8B,EAAE,SAAS,6BAA6B,EAkIvE,CAAC;AAYb,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,GACb,6BAA6B,CAQ/B;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,MAAM,GACf,6BAA6B,GAAG,SAAS,CAE3C;AAED,uEAAuE;AACvE,wBAAgB,+BAA+B,IAAI,MAAM,EAAE,CAQ1D;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAS1E"}
+{"version":3,"file":"graphComposerActions.d.ts","sourceRoot":"","sources":["../src/graphComposerActions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EACL,KAAK,eAAe,EASrB,MAAM,oCAAoC,CAAC;AAY5C,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AAEhE,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,uDAAuD;IACvD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC;CAC1C,CAAC;AAaF,eAAO,MAAM,8BAA8B,EAAE,SAAS,6BAA6B,EAwMvE,CAAC;AAYb,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,GACb,6BAA6B,CAQ/B;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,MAAM,GACf,6BAA6B,GAAG,SAAS,CAE3C;AAED,uEAAuE;AACvE,wBAAgB,+BAA+B,IAAI,MAAM,EAAE,CAQ1D;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAS1E"}

package/dist/graphComposerActions.js

@@ -2,6 +2,8 @@ import { readFileSync, existsSync } from "node:fs";
 import path from "node:path";
 import { graphComposerPackRoot } from "./packDir.js";
 import { validateCreateModifyOutput, validateExplainOutput, validateSuggestCatalogCreationsOutput, validateSuggestCatalogResolutionOutput, validateSuggestConceptOutput, validateSuggestScopingMapCreationOutput, validateSuggestScopingNeedMatchOutput, validateReviewConceptOutput, } from "./graphComposerOutputValidation.js";
+import { validateReviewGraphEntryContractOutput, validateSuggestGraphEntryInputsOutput, validateSuggestGraphEntryExamplesOutput, validateSuggestGraphEntryConditionsOutput, validateSuggestJobModelDefaultsOutput, validateSuggestJobKnowledgeRefsOutput, validateSuggestGraphExecutionDefaultsOutput, } from "./graphEntryOutputValidation.js";
+import { GRAPH_ENTRY_SHARED_INCLUDES } from "./graphEntryPostProcess.js";
 function readPromptRelative(rel) {
     const root = graphComposerPackRoot();
     const p = path.join(root, "prompts", rel);
@@ -131,6 +133,69 @@ export const GRAPH_COMPOSER_ACTION_REGISTRY = [
         toolDescription: "Review whether the graph concept makes sense; return verdict, categorized findings with severity, and improvement suggestions. No graph JSON returned.",
         validateOutput: validateReviewConceptOutput,
     },
+    {
+        action: "reviewGraphEntryContract",
+        promptFile: "action-review-graph-entry-contract.md",
+        sharedIncludes: GRAPH_ENTRY_SHARED_INCLUDES,
+        requiresExistingGraph: true,
+        toolName: "graph_review_graph_entry_contract",
+        toolDescription: "Review job-start graphEntry contract, job defaults, and alignment with graphConcept Lane 1. Returns verdict, graph-scoped findings, optional partial patches. No graph JSON.",
+        validateOutput: validateReviewGraphEntryContractOutput,
+    },
+    {
+        action: "suggestGraphEntryInputs",
+        promptFile: "action-suggest-graph-entry-inputs.md",
+        sharedIncludes: GRAPH_ENTRY_SHARED_INCLUDES,
+        requiresExistingGraph: true,
+        toolName: "graph_suggest_graph_entry_inputs",
+        toolDescription: "Propose metadata.graphEntry.inputs rows (execution.input.* paths). No graph JSON.",
+        validateOutput: validateSuggestGraphEntryInputsOutput,
+    },
+    {
+        action: "suggestGraphEntryExamples",
+        promptFile: "action-suggest-graph-entry-examples.md",
+        sharedIncludes: GRAPH_ENTRY_SHARED_INCLUDES,
+        requiresExistingGraph: true,
+        toolName: "graph_suggest_graph_entry_examples",
+        toolDescription: "Propose metadata.graphEntry.exampleInputs with parseable JSON examples. No graph JSON.",
+        validateOutput: validateSuggestGraphEntryExamplesOutput,
+    },
+    {
+        action: "suggestGraphEntryConditions",
+        promptFile: "action-suggest-graph-entry-conditions.md",
+        sharedIncludes: GRAPH_ENTRY_SHARED_INCLUDES,
+        requiresExistingGraph: true,
+        toolName: "graph_suggest_graph_entry_conditions",
+        toolDescription: "Propose metadata.graphEntry.conditions for job-start gating. No graph JSON.",
+        validateOutput: validateSuggestGraphEntryConditionsOutput,
+    },
+    {
+        action: "suggestJobModelDefaults",
+        promptFile: "action-suggest-job-model-defaults.md",
+        sharedIncludes: GRAPH_ENTRY_SHARED_INCLUDES,
+        requiresExistingGraph: true,
+        toolName: "graph_suggest_job_model_defaults",
+        toolDescription: "Propose root modelConfig job defaults (appendCase or replaceDefault). No graph JSON.",
+        validateOutput: validateSuggestJobModelDefaultsOutput,
+    },
+    {
+        action: "suggestJobKnowledgeRefs",
+        promptFile: "action-suggest-job-knowledge-refs.md",
+        sharedIncludes: GRAPH_ENTRY_SHARED_INCLUDES,
+        requiresExistingGraph: true,
+        toolName: "graph_suggest_job_knowledge_refs",
+        toolDescription: "Propose root jobPagentiKnowledge Catalox refs. No graph JSON.",
+        validateOutput: validateSuggestJobKnowledgeRefsOutput,
+    },
+    {
+        action: "suggestGraphExecutionDefaults",
+        promptFile: "action-suggest-graph-execution-defaults.md",
+        sharedIncludes: GRAPH_ENTRY_SHARED_INCLUDES,
+        requiresExistingGraph: true,
+        toolName: "graph_suggest_graph_execution_defaults",
+        toolDescription: "Propose metadata.graphExecution partial defaults. No graph JSON.",
+        validateOutput: validateSuggestGraphExecutionDefaultsOutput,
+    },
 ];
 const byAction = Object.fromEntries(GRAPH_COMPOSER_ACTION_REGISTRY.map((d) => [d.action, d]));
 const byToolName = Object.fromEntries(GRAPH_COMPOSER_ACTION_REGISTRY.map((d) => [d.toolName, d]));

package/dist/graphComposerOutputValidation.d.ts

@@ -4,6 +4,7 @@ export type OutputValidationContext = {
     input?: GraphComposerInput;
 };
 export type OutputValidator = (out: Record<string, unknown>, ctx?: OutputValidationContext) => void;
+export { validateReviewGraphEntryContractOutput, validateSuggestGraphEntryInputsOutput, validateSuggestGraphEntryExamplesOutput, validateSuggestGraphEntryConditionsOutput, validateSuggestJobModelDefaultsOutput, validateSuggestJobKnowledgeRefsOutput, validateSuggestGraphExecutionDefaultsOutput, } from "./graphEntryOutputValidation.js";
 export declare function validateExplainOutput(out: Record<string, unknown>, _ctx?: OutputValidationContext): void;
 export declare function validateReviewConceptOutput(out: Record<string, unknown>, _ctx?: OutputValidationContext): void;
 /**

package/dist/graphComposerOutputValidation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graphComposerOutputValidation.d.ts","sourceRoot":"","sources":["../src/graphComposerOutputValidation.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,kBAAkB,EAAwB,MAAM,YAAY,CAAC;AAE3E,mHAAmH;AACnH,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,CAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,CAAC,EAAE,uBAAuB,KAC1B,IAAI,CAAC;AAuBV,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,CAAC,EAAE,uBAAuB,GAC7B,IAAI,CAIN;AAmYD,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,CAAC,EAAE,uBAAuB,GAC7B,IAAI,CAwGN;AAED;;;;GAIG;AACH,wBAAgB,uCAAuC,CACrD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,KAAK,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACjC,IAAI,CAqCN;AAuBD,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,CAAC,EAAE,uBAAuB,GAC7B,IAAI,CAmBN;AAsBD,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,CAAC,EAAE,uBAAuB,GAC5B,IAAI,CA8BN;AAmBD,wBAAgB,sCAAsC,CACpD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,CAAC,EAAE,uBAAuB,GAC7B,IAAI,CAkDN;AAED,wBAAgB,qCAAqC,CACnD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,CAAC,EAAE,uBAAuB,GAC7B,IAAI,CAiCN;AAUD,wBAAgB,qCAAqC,CACnD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,CAAC,EAAE,uBAAuB,GAC7B,IAAI,CAwDN;AAED,wBAAgB,uCAAuC,CACrD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,CAAC,EAAE,uBAAuB,GAC7B,IAAI,CAwDN"}
+{"version":3,"file":"graphComposerOutputValidation.d.ts","sourceRoot":"","sources":["../src/graphComposerOutputValidation.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,kBAAkB,EAAwB,MAAM,YAAY,CAAC;AAE3E,mHAAmH;AACnH,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,CAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,CAAC,EAAE,uBAAuB,KAC1B,IAAI,CAAC;AAEV,OAAO,EACL,sCAAsC,EACtC,qCAAqC,EACrC,uCAAuC,EACvC,yCAAyC,EACzC,qCAAqC,EACrC,qCAAqC,EACrC,2CAA2C,GAC5C,MAAM,iCAAiC,CAAC;AAuBzC,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,CAAC,EAAE,uBAAuB,GAC7B,IAAI,CAIN;AAmYD,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,CAAC,EAAE,uBAAuB,GAC7B,IAAI,CAwGN;AAED;;;;GAIG;AACH,wBAAgB,uCAAuC,CACrD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,KAAK,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACjC,IAAI,CAqCN;AAuBD,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,CAAC,EAAE,uBAAuB,GAC7B,IAAI,CAmBN;AAsBD,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,CAAC,EAAE,uBAAuB,GAC5B,IAAI,CA8BN;AAmBD,wBAAgB,sCAAsC,CACpD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,CAAC,EAAE,uBAAuB,GAC7B,IAAI,CAkDN;AAED,wBAAgB,qCAAqC,CACnD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,CAAC,EAAE,uBAAuB,GAC7B,IAAI,CAiCN;AAUD,wBAAgB,qCAAqC,CACnD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,CAAC,EAAE,uBAAuB,GAC7B,IAAI,CAwDN;AAED,wBAAgB,uCAAuC,CACrD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,CAAC,EAAE,uBAAuB,GAC7B,IAAI,CAwDN"}

package/dist/graphComposerOutputValidation.js

@@ -2,6 +2,7 @@ import { reportTaskNodeProtocolGaps } from "./aiTaskProfile.js";
 import { collectCanonicalGraphWarnings } from "./canonicalGraphWarnings.js";
 import { assertCanonicalGraphDocument } from "./graphEngineBridge.js";
 import { canonicalizeGraphModel, reportTaskNodeInputsLayoutIssues, taskNodeInputsLayoutWarningMessage, } from "./taskNodeTaskVariable.js";
+export { validateReviewGraphEntryContractOutput, validateSuggestGraphEntryInputsOutput, validateSuggestGraphEntryExamplesOutput, validateSuggestGraphEntryConditionsOutput, validateSuggestJobModelDefaultsOutput, validateSuggestJobKnowledgeRefsOutput, validateSuggestGraphExecutionDefaultsOutput, } from "./graphEntryOutputValidation.js";
 const PRIMARY_INTENT_TYPES = new Set([
     "question",
     "decision",

package/dist/graphEntryContract.d.ts

@@ -0,0 +1,114 @@
+import type { GraphConceptEntityBindings } from "./types.js";
+export type ComposerAgentSurface = "graph-entry" | "task-node";
+/** Studio `buildGraphEntryAgentContext` envelope (FR-G1). */
+export type GraphEntryAgentContext = {
+    surface: "graph-entry";
+    graphEntry: Record<string, unknown>;
+    jobDefaults?: Record<string, unknown>;
+    graphResponse?: Record<string, unknown>;
+    graphExecution?: Record<string, unknown>;
+    graphConcept?: Record<string, unknown>;
+    diagnostics?: Record<string, unknown>;
+    virtualIO?: Record<string, unknown>;
+    lastGraphRun?: Record<string, unknown>;
+};
+export type TaskNodeAgentContext = {
+    surface: "task-node";
+    nodeId: string;
+    lastRunMeta?: Record<string, unknown>;
+};
+export type GraphComposerAgentContext = GraphEntryAgentContext | TaskNodeAgentContext;
+export type GraphEntryInputKind = "scalar" | "record";
+export type GraphEntryInputRow = {
+    kind?: GraphEntryInputKind | string;
+    path: string;
+    required?: boolean;
+    entityIds?: string[];
+    label?: string;
+    description?: string;
+};
+export type GraphEntryExampleFormat = "json" | "markdown" | "text";
+export type GraphEntryExampleRow = {
+    path?: string;
+    format: GraphEntryExampleFormat | string;
+    value: string;
+};
+export type GraphEntryConditionsPatch = {
+    narratives?: unknown[];
+    dataFilters?: unknown[];
+    aiCondition?: Record<string, unknown>;
+};
+export type GraphEntryPatch = {
+    inputs?: GraphEntryInputRow[];
+    exampleInputs?: GraphEntryExampleRow[];
+    conditions?: GraphEntryConditionsPatch;
+};
+export type GraphEntryFindingCategory = "graph_entry" | "expected_input" | "job_models" | "job_knowledge" | "graph_execution" | "graph_conditions";
+export type GraphEntryFinding = {
+    scopeType: "graph";
+    category: GraphEntryFindingCategory | string;
+    severity: "info" | "warning" | "error" | string;
+    summary: string;
+    suggestedChange?: string;
+    proposal?: Record<string, unknown>;
+};
+export type GraphEntryReviewVerdict = {
+    coherent: boolean;
+    summary: string;
+};
+export type ModelConfigPatchMode = "appendCase" | "replaceDefault";
+/** Root `modelConfig` patch (FR-G6). */
+export type ModelConfigPatch = {
+    mode?: ModelConfigPatchMode;
+    cases?: Record<string, unknown>[];
+    /** Single default case triple when mode is replaceDefault. */
+    modelConfig?: {
+        preActionModel?: string;
+        skillModel?: string;
+        postActionModel?: string;
+    };
+};
+export type PagentiKnowledgeRef = {
+    catalogId: string;
+    itemId: string;
+};
+export type JobPagentiKnowledgePatch = {
+    refs?: PagentiKnowledgeRef[];
+    append?: PagentiKnowledgeRef[];
+};
+export type GraphExecutionPatch = Record<string, unknown>;
+export type GraphResponsePatch = {
+    missing?: "omit" | "null";
+    shape?: unknown;
+    studio?: Record<string, unknown>;
+};
+export declare const GRAPH_ENTRY_FINDING_CATEGORIES: Set<string>;
+export declare const GRAPH_ENTRY_PATH_PREFIX = "execution.input.";
+export declare const GRAPH_EXECUTION_PATCH_ALLOWLIST: Set<string>;
+/** Read `metadata.graphEntry` and normalize legacy `exampleInput` → `exampleInputs`. */
+export declare function resolveEffectiveGraphEntry(graphOrEntry: object | Record<string, unknown> | undefined): Record<string, unknown>;
+export declare function isValidGraphEntryPath(path: string): boolean;
+export declare function validateGraphEntryPaths(paths: string[]): string[];
+/** Infer JSON Schema for example generation from declared graph-entry inputs (FR-G4). */
+export declare function buildGraphEntryExampleJsonSchema(inputs: GraphEntryInputRow[] | unknown[], _entityBindings?: GraphConceptEntityBindings): Record<string, unknown>;
+export type EntityBindingMismatch = {
+    inputPath: string;
+    entityIds: string[];
+    message: string;
+};
+/** FR-G3: flag when graphEntry.inputs[].entityIds disagree with graphConcept.entityBindings. */
+export declare function findGraphEntryEntityBindingMismatches(inputs: GraphEntryInputRow[] | unknown[], graphConcept: Record<string, unknown> | undefined): EntityBindingMismatch[];
+export declare function parseJsonExampleValue(value: string): {
+    ok: boolean;
+    error?: string;
+};
+/** Resolve graph-entry context from request (agentContext preferred, analysisContext legacy). */
+export declare function resolveGraphEntryContextFromInput(input: {
+    agentContext?: GraphComposerAgentContext;
+    analysisContext?: object;
+}): GraphEntryAgentContext | undefined;
+export declare function assertGraphEntryAgentSurface(input: {
+    agentContext?: GraphComposerAgentContext;
+    analysisContext?: object;
+}, action: string): void;
+//# sourceMappingURL=graphEntryContract.d.ts.map

package/dist/graphEntryContract.d.ts.map

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