@exellix/graph-composer 2.0.0

package/dist/graphConceptPatchMerge.d.ts

@@ -0,0 +1,10 @@
+import type { GraphConceptPatchKey } from "./types.js";
+/**
+ * Drops patch keys listed in `onlyIfEmpty` when the existing graph already has
+ * a non-empty string at `metadata.graphConcept.<key>`.
+ */
+export declare function applyGraphConceptPatchOnlyIfEmpty(patch: Record<string, unknown>, onlyIfEmpty: GraphConceptPatchKey[] | undefined, existingGraph: object): {
+    patch: Record<string, unknown>;
+    skipped: GraphConceptPatchKey[];
+};
+//# sourceMappingURL=graphConceptPatchMerge.d.ts.map

package/dist/graphConceptPatchMerge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphConceptPatchMerge.d.ts","sourceRoot":"","sources":["../src/graphConceptPatchMerge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AA+BvD;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,WAAW,EAAE,oBAAoB,EAAE,GAAG,SAAS,EAC/C,aAAa,EAAE,MAAM,GACpB;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,OAAO,EAAE,oBAAoB,EAAE,CAAA;CAAE,CAcrE"}

package/dist/graphConceptPatchMerge.js

@@ -0,0 +1,40 @@
+function readMetadataGraphConcept(existingGraph) {
+    const root = existingGraph;
+    const meta = root.metadata;
+    if (meta === null || meta === undefined || typeof meta !== "object") {
+        return undefined;
+    }
+    const gc = meta.graphConcept;
+    if (gc === null ||
+        gc === undefined ||
+        typeof gc !== "object" ||
+        Array.isArray(gc)) {
+        return undefined;
+    }
+    return gc;
+}
+function graphConceptFieldNonEmpty(concept, key) {
+    if (!concept)
+        return false;
+    const v = concept[key];
+    return typeof v === "string" && v.trim().length > 0;
+}
+/**
+ * Drops patch keys listed in `onlyIfEmpty` when the existing graph already has
+ * a non-empty string at `metadata.graphConcept.<key>`.
+ */
+export function applyGraphConceptPatchOnlyIfEmpty(patch, onlyIfEmpty, existingGraph) {
+    if (!onlyIfEmpty?.length) {
+        return { patch: { ...patch }, skipped: [] };
+    }
+    const concept = readMetadataGraphConcept(existingGraph);
+    const out = { ...patch };
+    const skipped = [];
+    for (const key of onlyIfEmpty) {
+        if (graphConceptFieldNonEmpty(concept, key) && key in out) {
+            delete out[key];
+            skipped.push(key);
+        }
+    }
+    return { patch: out, skipped };
+}

package/dist/graphEngineBridge.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Re-exports from `@exellix/graph-engine` so hosts validate graphs with the same
+ * rules as runtime — do not fork gap codes or memory path allowlists here.
+ */
+export { assertCanonicalGraphDocument, getCanonicalGraphDocumentViolations, CANONICAL_GRAPH_TOP_LEVEL_KEYS, GRAPH_ENGINE_MEMORY_PATH_ROOTS, isAllowedGraphEngineMemoryPath, collectAiTasksNodeExtensionIssues, assertAiTasksNodeExtensionsValid, resolveGraphEngineMemoryPathValue, buildGraphEngineMemoryResolutionRootFromWorkingMemory, } from "@exellix/graph-engine";
+export type { GraphEngineMemoryResolutionRoot } from "@exellix/graph-engine";
+//# sourceMappingURL=graphEngineBridge.d.ts.map

package/dist/graphEngineBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphEngineBridge.d.ts","sourceRoot":"","sources":["../src/graphEngineBridge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,4BAA4B,EAC5B,mCAAmC,EACnC,8BAA8B,EAC9B,8BAA8B,EAC9B,8BAA8B,EAC9B,iCAAiC,EACjC,gCAAgC,EAChC,iCAAiC,EACjC,qDAAqD,GACtD,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,+BAA+B,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/graphEngineBridge.js

@@ -0,0 +1,5 @@
+/**
+ * Re-exports from `@exellix/graph-engine` so hosts validate graphs with the same
+ * rules as runtime — do not fork gap codes or memory path allowlists here.
+ */
+export { assertCanonicalGraphDocument, getCanonicalGraphDocumentViolations, CANONICAL_GRAPH_TOP_LEVEL_KEYS, GRAPH_ENGINE_MEMORY_PATH_ROOTS, isAllowedGraphEngineMemoryPath, collectAiTasksNodeExtensionIssues, assertAiTasksNodeExtensionsValid, resolveGraphEngineMemoryPathValue, buildGraphEngineMemoryResolutionRootFromWorkingMemory, } from "@exellix/graph-engine";

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export { composeInstructions, composeWorkerInstructions, formatSkillList, LOCKED_GATE_TEXT, EXTENSIBLE_GATE_TEXT, } from "./composeInstructions.js";
+export { GRAPH_COMPOSER_ACTION_REGISTRY, getActionDefinition, getActionDefinitionByToolName, requiredPromptPathsFromRegistry, loadWorkerBaseMarkdown, type GraphComposerAction, type GraphComposerActionDefinition, } from "./graphComposerActions.js";
+export { graphComposerPackRoot, readGraphComposerPromptFile, } from "./packDir.js";
+export { DEFAULT_UTILITY_SKILLS } from "./defaultUtilitySkills.js";
+export { runGraphComposer, runGraphWorker, resolveGraphComposerClient, getGraphComposerLlmClient, getPackDir, normalizeGraphComposerExplainOutput, normalizeReviewConceptComposerOutput, redactSecretsForLog, type RunGraphComposerOptions, } from "./runGraphComposer.js";
+export { applyGraphConceptPatchOnlyIfEmpty } from "./graphConceptPatchMerge.js";
+export { runGraphComposerAgent, type GraphComposerAgentResult, type GraphComposerAgentOrchestrationStep, type RunGraphComposerAgentOptions, } from "./graphComposerAgent.js";
+export type { GraphComposerInput, GraphComposerAgentInput, GraphComposerIntent, GraphComposerConstraints, SkillDescriptor, PrimaryIntentType, GraphConceptStatus, GraphConceptEntityBindings, GraphConceptPatch, GraphConceptPatchKey, GraphConceptRequirementsPatch, GraphConceptCoreTaskPatchItem, RequirementOptionCandidate, RequirementOptionEntry, CatalogCandidates, ScopingMapCandidate, NarrixTemplateCandidate, } from "./types.js";
+export { buildCatalogMatchHints, type CatalogMatchAssistOptions, } from "./catalogMatchAssist.js";
+export { buildScopingNeedMatchHints, type ScopingNeedMatchAssistOptions, } from "./scopingNeedMatchAssist.js";
+export { validateCreateModifyOutput, validateSuggestCatalogResolutionOutput, validateSuggestCatalogCreationsOutput, validateSuggestScopingNeedMatchOutput, validateSuggestScopingMapCreationOutput, validateReviewConceptOutput, validateReviewConceptOutputAgainstInput, type OutputValidationContext, } from "./graphComposerOutputValidation.js";
+export type { WoroxScopingMapCatalogCreatePayload, WoroxScopedDataDocumentShape, } from "./scopingCatalogHostTypes.js";
+export { loadExampleGraph, inputExplainNetworkVulnSubnet, inputSuggestConceptObjectiveNetworkVulnSubnet, inputReviewConceptIoSmoke, } from "./exampleInputs.js";
+export { buildGraphInputExampleGuidance, generateGraphJsonInputExample, generateJsonExample, generateMdExample, generateContentExample, type GenerateGraphJsonInputExampleParams, type GenerateJsonExampleResult, type GenerateMdExampleParams, type GenerateMdExampleResult, type GenerateContentExampleParams, type GenerateContentExampleResult, } from "./exampleGeneration.js";
+export { parseGraphConceptStory, parseGraphConceptStoryBody, isGraphConceptStoryDescription, GRAPH_CONCEPT_STORY_MARKER, } from "./parseGraphConceptStory.js";
+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, type GraphEngineMemoryResolutionRoot, } from "./graphEngineBridge.js";
+export { collectCanonicalGraphWarnings } from "./canonicalGraphWarnings.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";
+export type { CataloxContext, CataloxRuntimeConfig, } from "@x12i/catalox/embedder";
+export { loadCatalogCandidatesFromCatalox, unifiedCatalogItemToSkillDescriptor, unifiedCatalogItemToScopingMapCandidate, unifiedCatalogItemToNarrixTemplateCandidate, type CataloxCatalogBridgeCatalogIds, type CataloxCatalogBridgeContextByKey, type CataloxCatalogBridgeListOptions, type CataloxCatalogBridgeAiItemMatch, type CataloxCatalogBridgeOptions, } from "./cataloxCatalogBridge.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,19 @@
+export { composeInstructions, composeWorkerInstructions, formatSkillList, LOCKED_GATE_TEXT, EXTENSIBLE_GATE_TEXT, } from "./composeInstructions.js";
+export { GRAPH_COMPOSER_ACTION_REGISTRY, getActionDefinition, getActionDefinitionByToolName, requiredPromptPathsFromRegistry, loadWorkerBaseMarkdown, } from "./graphComposerActions.js";
+export { graphComposerPackRoot, readGraphComposerPromptFile, } from "./packDir.js";
+export { DEFAULT_UTILITY_SKILLS } from "./defaultUtilitySkills.js";
+export { runGraphComposer, runGraphWorker, resolveGraphComposerClient, getGraphComposerLlmClient, getPackDir, normalizeGraphComposerExplainOutput, normalizeReviewConceptComposerOutput, redactSecretsForLog, } from "./runGraphComposer.js";
+export { applyGraphConceptPatchOnlyIfEmpty } from "./graphConceptPatchMerge.js";
+export { runGraphComposerAgent, } from "./graphComposerAgent.js";
+export { buildCatalogMatchHints, } from "./catalogMatchAssist.js";
+export { buildScopingNeedMatchHints, } from "./scopingNeedMatchAssist.js";
+export { validateCreateModifyOutput, validateSuggestCatalogResolutionOutput, validateSuggestCatalogCreationsOutput, validateSuggestScopingNeedMatchOutput, validateSuggestScopingMapCreationOutput, validateReviewConceptOutput, validateReviewConceptOutputAgainstInput, } from "./graphComposerOutputValidation.js";
+export { loadExampleGraph, inputExplainNetworkVulnSubnet, inputSuggestConceptObjectiveNetworkVulnSubnet, inputReviewConceptIoSmoke, } from "./exampleInputs.js";
+export { buildGraphInputExampleGuidance, generateGraphJsonInputExample, generateJsonExample, generateMdExample, generateContentExample, } from "./exampleGeneration.js";
+export { parseGraphConceptStory, parseGraphConceptStoryBody, isGraphConceptStoryDescription, GRAPH_CONCEPT_STORY_MARKER, } from "./parseGraphConceptStory.js";
+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, } from "./graphEngineBridge.js";
+export { collectCanonicalGraphWarnings } from "./canonicalGraphWarnings.js";
+export { resolveTaskNodeInputs, resolveTaskNodeInputsConfig, resolveTaskNodeTaskVariable, canonicalizeGraphTaskNodeTaskVariable, canonicalizeGraphModel, reportTaskNodeInputsLayoutIssues, taskNodeInputsLayoutWarningMessage, isTaskVariablePathRef, isTaskNode, isFinalizerNode, } from "./taskNodeTaskVariable.js";
+export { createCatalox, bindCataloxContext, Catalox, CataloxBound, } from "@x12i/catalox/embedder";
+export { loadCatalogCandidatesFromCatalox, unifiedCatalogItemToSkillDescriptor, unifiedCatalogItemToScopingMapCandidate, unifiedCatalogItemToNarrixTemplateCandidate, } from "./cataloxCatalogBridge.js";

package/dist/openRouterConnectTimeout.d.ts

@@ -0,0 +1,3 @@
+/** Run `fn` with undici connect timeout (ms) applied to `fetch` in this async context. */
+export declare function runWithOpenRouterConnectTimeout<T>(connectTimeoutMs: number | undefined, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=openRouterConnectTimeout.d.ts.map

package/dist/openRouterConnectTimeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openRouterConnectTimeout.d.ts","sourceRoot":"","sources":["../src/openRouterConnectTimeout.ts"],"names":[],"mappings":"AAgDA,0FAA0F;AAC1F,wBAAgB,+BAA+B,CAAC,CAAC,EAC/C,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAIZ"}

package/dist/openRouterConnectTimeout.js

@@ -0,0 +1,48 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { Agent } from "undici";
+function initHasDispatcher(init) {
+    return (init !== undefined &&
+        typeof init === "object" &&
+        "dispatcher" in init &&
+        init.dispatcher !== undefined);
+}
+/**
+ * Node's global `fetch` (undici) defaults to a 10s TCP connect timeout, separate from
+ * request/response `timeoutMs` in aifunctions-js. Until that library forwards connect
+ * options, we attach an undici `Agent` with a higher `connectTimeout` for the duration
+ * of `runGraphComposer` via AsyncLocalStorage-scoped `fetch` wrapping.
+ */
+const connectTimeoutMsAls = new AsyncLocalStorage();
+const agentByMs = new Map();
+function agentFor(ms) {
+    let a = agentByMs.get(ms);
+    if (!a) {
+        a = new Agent({ connectTimeout: ms });
+        agentByMs.set(ms, a);
+    }
+    return a;
+}
+let installed = false;
+const innerFetch = globalThis.fetch.bind(globalThis);
+function installFetchWrapper() {
+    if (installed)
+        return;
+    installed = true;
+    globalThis.fetch = ((input, init) => {
+        const ms = connectTimeoutMsAls.getStore();
+        if (ms === undefined || initHasDispatcher(init)) {
+            return innerFetch(input, init);
+        }
+        return innerFetch(input, {
+            ...init,
+            dispatcher: agentFor(ms),
+        });
+    });
+}
+/** Run `fn` with undici connect timeout (ms) applied to `fetch` in this async context. */
+export function runWithOpenRouterConnectTimeout(connectTimeoutMs, fn) {
+    if (connectTimeoutMs === undefined)
+        return fn();
+    installFetchWrapper();
+    return connectTimeoutMsAls.run(connectTimeoutMs, fn);
+}

package/dist/packDir.d.ts

@@ -0,0 +1,7 @@
+/** Root of the shipped `functions/graph-composer` pack (contains `prompts/`, `meta.json`, …). */
+export declare function graphComposerPackRoot(): string;
+/** Read a file from `functions/graph-composer/prompts/`. */
+export declare function readGraphComposerPromptFile(name: string): string;
+/** First fenced ``` / ```json block in markdown (trimmed inner text). */
+export declare function extractFirstFencedJsonBlock(markdown: string): string;
+//# sourceMappingURL=packDir.d.ts.map

package/dist/packDir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packDir.d.ts","sourceRoot":"","sources":["../src/packDir.ts"],"names":[],"mappings":"AAIA,iGAAiG;AACjG,wBAAgB,qBAAqB,IAAI,MAAM,CAM9C;AAED,4DAA4D;AAC5D,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMhE;AAED,yEAAyE;AACzE,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMpE"}

package/dist/packDir.js

@@ -0,0 +1,23 @@
+import { readFileSync, existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+/** Root of the shipped `functions/graph-composer` pack (contains `prompts/`, `meta.json`, …). */
+export function graphComposerPackRoot() {
+    return path.join(fileURLToPath(new URL("..", import.meta.url)), "functions", "graph-composer");
+}
+/** Read a file from `functions/graph-composer/prompts/`. */
+export function readGraphComposerPromptFile(name) {
+    const p = path.join(graphComposerPackRoot(), "prompts", name);
+    if (!existsSync(p)) {
+        throw new Error(`Missing pack prompt file: ${p}`);
+    }
+    return readFileSync(p, "utf-8");
+}
+/** First fenced ``` / ```json block in markdown (trimmed inner text). */
+export function extractFirstFencedJsonBlock(markdown) {
+    const m = markdown.match(/```(?:json)?\s*([\s\S]*?)```/);
+    if (!m) {
+        throw new Error("No fenced ```json block found in markdown");
+    }
+    return m[1].trim();
+}

package/dist/parseGraphConceptStory.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Deterministic parser for the "graph concept story" text format used in
+ * intent.description (marker line + key: value lines and multiline "|" blocks).
+ */
+/** Structured concept fields produced by {@link parseGraphConceptStory}. */
+export type ParsedGraphConcept = Record<string, unknown>;
+/** Match a line that starts the graph concept story section. */
+export declare const GRAPH_CONCEPT_STORY_MARKER: RegExp;
+/** True when `text` contains a graph concept story marker line. */
+export declare function isGraphConceptStoryDescription(text: string): boolean;
+/**
+ * Parse graph concept story body (comments should already be stripped, or use
+ * {@link parseGraphConceptStory} which strips full-line `#` comments).
+ */
+export declare function parseGraphConceptStoryBody(text: string): ParsedGraphConcept;
+/**
+ * Strip full-line `#` comments, then parse key / multiline `|` blocks into a
+ * flat object plus `coreTasks` array entries merged from `coreTasks.N.field` keys.
+ */
+export declare function parseGraphConceptStory(text: string): ParsedGraphConcept;
+//# sourceMappingURL=parseGraphConceptStory.d.ts.map

package/dist/parseGraphConceptStory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseGraphConceptStory.d.ts","sourceRoot":"","sources":["../src/parseGraphConceptStory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,4EAA4E;AAC5E,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEzD,gEAAgE;AAChE,eAAO,MAAM,0BAA0B,QAAoC,CAAC;AAE5E,mEAAmE;AACnE,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKpE;AA0CD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAmD3E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAEvE"}

package/dist/parseGraphConceptStory.js

@@ -0,0 +1,105 @@
+/**
+ * Deterministic parser for the "graph concept story" text format used in
+ * intent.description (marker line + key: value lines and multiline "|" blocks).
+ */
+/** Match a line that starts the graph concept story section. */
+export const GRAPH_CONCEPT_STORY_MARKER = /^\s*#\s*graphConcept\s+story\b/i;
+/** True when `text` contains a graph concept story marker line. */
+export function isGraphConceptStoryDescription(text) {
+    for (const line of text.split(/\r?\n/)) {
+        if (GRAPH_CONCEPT_STORY_MARKER.test(line))
+            return true;
+    }
+    return false;
+}
+/** Line looks like `key:` or `key: rest` (key may contain dots). */
+const KEY_LINE_RE = /^([a-zA-Z_][\w.]*):\s*(.*)$/;
+function stripFullLineComments(text) {
+    return text
+        .split(/\r?\n/)
+        .filter((line) => {
+        const t = line.trim();
+        return t.length === 0 || !t.startsWith("#");
+    })
+        .join("\n");
+}
+function looksLikeKeyLine(trimmed) {
+    return KEY_LINE_RE.test(trimmed);
+}
+function assignValue(out, fullKey, value) {
+    const m = /^coreTasks\.(\d+)\.(.+)$/.exec(fullKey);
+    if (m) {
+        const idx = parseInt(m[1], 10);
+        const field = m[2];
+        let arr = out.coreTasks;
+        if (!Array.isArray(arr)) {
+            arr = [];
+            out.coreTasks = arr;
+        }
+        const a = arr;
+        while (a.length <= idx)
+            a.push({});
+        const prev = a[idx] ?? {};
+        a[idx] = { ...prev, [field]: value };
+        return;
+    }
+    out[fullKey] = value;
+}
+/**
+ * Parse graph concept story body (comments should already be stripped, or use
+ * {@link parseGraphConceptStory} which strips full-line `#` comments).
+ */
+export function parseGraphConceptStoryBody(text) {
+    const lines = text.split(/\r?\n/);
+    const out = {};
+    let i = 0;
+    while (i < lines.length) {
+        const raw = lines[i];
+        const trimmed = raw.trim();
+        if (trimmed.length === 0) {
+            i += 1;
+            continue;
+        }
+        const km = KEY_LINE_RE.exec(trimmed);
+        if (!km) {
+            i += 1;
+            continue;
+        }
+        const key = km[1];
+        const restRaw = km[2];
+        const inline = restRaw.trim();
+        i += 1;
+        if (inline.length > 0) {
+            assignValue(out, key, inline);
+            continue;
+        }
+        if (i >= lines.length) {
+            assignValue(out, key, "");
+            continue;
+        }
+        const nextTrim = lines[i].trim();
+        if (nextTrim === "|") {
+            i += 1;
+            const bodyLines = [];
+            while (i < lines.length) {
+                const lt = lines[i].trim();
+                if (looksLikeKeyLine(lt))
+                    break;
+                bodyLines.push(lines[i]);
+                i += 1;
+            }
+            assignValue(out, key, bodyLines.join("\n").replace(/\s+$/, ""));
+        }
+        else {
+            assignValue(out, key, "");
+        }
+    }
+    return out;
+}
+/**
+ * Strip full-line `#` comments, then parse key / multiline `|` blocks into a
+ * flat object plus `coreTasks` array entries merged from `coreTasks.N.field` keys.
+ */
+export function parseGraphConceptStory(text) {
+    return parseGraphConceptStoryBody(stripFullLineComments(text));
+}

package/dist/redactForLog.d.ts

@@ -0,0 +1,2 @@
+export declare function redactSecretsForLog(value: unknown): unknown;
+//# sourceMappingURL=redactForLog.d.ts.map

package/dist/redactForLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redactForLog.d.ts","sourceRoot":"","sources":["../src/redactForLog.ts"],"names":[],"mappings":"AAgBA,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAoB3D"}

package/dist/redactForLog.js

@@ -0,0 +1,37 @@
+/**
+ * Deep-clone plain JSON-like trees and replace values for sensitive-looking keys
+ * so request/response payloads can be logged safely.
+ */
+function shouldRedactKey(key) {
+    const k = key.toLowerCase();
+    return (k.includes("apikey") ||
+        k.includes("openrouterapikey") ||
+        k === "authorization" ||
+        k.includes("password") ||
+        k === "token" ||
+        k.includes("secret"));
+}
+export function redactSecretsForLog(value) {
+    if (value === null || value === undefined)
+        return value;
+    const t = typeof value;
+    if (t === "string" || t === "number" || t === "boolean")
+        return value;
+    if (Array.isArray(value)) {
+        return value.map((x) => redactSecretsForLog(x));
+    }
+    if (t === "object") {
+        const o = value;
+        const out = {};
+        for (const [k, v] of Object.entries(o)) {
+            if (shouldRedactKey(k)) {
+                out[k] = "[redacted]";
+            }
+            else {
+                out[k] = redactSecretsForLog(v);
+            }
+        }
+        return out;
+    }
+    return value;
+}

package/dist/runGraphComposer.d.ts

@@ -0,0 +1,54 @@
+import type { Client } from "@x12i/funcx";
+import { type LlmMode } from "@x12i/funcx/functions";
+import type { GraphComposerInput } from "./types.js";
+import { redactSecretsForLog } from "./redactForLog.js";
+export { redactSecretsForLog };
+export { applyGraphConceptPatchOnlyIfEmpty } from "./graphConceptPatchMerge.js";
+/**
+ * Maps `suggestedCatalogArtifacts` to `catalogProposals` when the latter is empty
+ * or missing (consumer contract alias). No-op for other actions.
+ */
+export declare function normalizeReviewConceptComposerOutput(out: Record<string, unknown>): void;
+/**
+ * If `action` is `explain` and known fields are flattened at the top level, moves them under `explanation` (see `functions/graph-composer/meta.json`). Maps `perNode` / `perNodeDescriptions` to `nodeDescriptions`. No-op for other actions or when `explanation` is already an object.
+ */
+export declare function normalizeGraphComposerExplainOutput(result: unknown): unknown;
+export type RunGraphComposerOptions = {
+    client?: Client;
+    /**
+     * When true (default), `suggestCatalog*` actions with `catalogCandidates` may run
+     * `matchLists` pre-pass and inject `catalogMatchHints` into the worker prompt.
+     */
+    catalogMatchListsAssist?: boolean;
+    /** When set, wraps the OpenRouter client so each `ask` uses at least this timeout (ms). */
+    askTimeoutMs?: number;
+    /**
+     * TCP/TLS connect timeout for OpenRouter (ms), forwarded to @x12i/funcx
+     * `createClient({ openrouter: { connectTimeoutMs } })` when this package creates the client.
+     * If you pass `client`, set `connectTimeoutMs` on your own `createClient` instead; this field is then ignored.
+     */
+    connectTimeoutMs?: number;
+    mode?: LlmMode;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    /**
+     * When true, `reviewConcept` logs redacted serialized request and raw LLM result at `info`.
+     * When false (default), the same traces use `debug` (enable via `GRAPH_COMPOSER_LOGS_LEVEL=debug`).
+     */
+    traceReviewConceptIo?: boolean;
+};
+export declare function resolveGraphComposerClient(options: RunGraphComposerOptions): Client | undefined;
+/**
+ * Returns a concrete OpenRouter client for flows that require `client.ask` (e.g. orchestrator).
+ * Unlike `resolveGraphComposerClient`, this always returns a `Client` when OpenRouter is configured.
+ */
+export declare function getGraphComposerLlmClient(options?: RunGraphComposerOptions): Client;
+/**
+ * Run a single graph-composer worker (`intent.action`) with the per-action system prompt.
+ * Shared by `runGraphComposer` and `runGraphComposerAgent`.
+ */
+export declare function runGraphWorker(input: GraphComposerInput, options?: RunGraphComposerOptions): Promise<unknown>;
+export declare function runGraphComposer(input: GraphComposerInput, options?: RunGraphComposerOptions): Promise<unknown>;
+export declare function getPackDir(): string;
+//# sourceMappingURL=runGraphComposer.d.ts.map

package/dist/runGraphComposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runGraphComposer.d.ts","sourceRoot":"","sources":["../src/runGraphComposer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAIL,KAAK,OAAO,EACb,MAAM,uBAAuB,CAAC;AAc/B,OAAO,KAAK,EAAE,kBAAkB,EAAmB,MAAM,YAAY,CAAC;AAEtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAC/B,OAAO,EAAE,iCAAiC,EAAE,MAAM,6BAA6B,CAAC;AAsHhF;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,IAAI,CASN;AAuDD;;GAEG;AACH,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,OAAO,GACd,OAAO,CAKT;AA0ED,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,2FAA2F;IAC3F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAgDF,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,uBAAuB,GAC/B,MAAM,GAAG,SAAS,CA4BpB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,uBAA4B,GACpC,MAAM,CAYR;AAMD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,OAAO,CAAC,CAkJlB;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}