@exellix/graph-composer 2.0.0

package/dist/defaultUtilitySkills.d.ts

@@ -0,0 +1,4 @@
+import type { SkillDescriptor } from "./types.js";
+/** Loaded from `functions/graph-composer/prompts/default-utility-skills.json` when `utilitySkills` is omitted. */
+export declare const DEFAULT_UTILITY_SKILLS: SkillDescriptor[];
+//# sourceMappingURL=defaultUtilitySkills.d.ts.map

package/dist/defaultUtilitySkills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultUtilitySkills.d.ts","sourceRoot":"","sources":["../src/defaultUtilitySkills.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,kHAAkH;AAClH,eAAO,MAAM,sBAAsB,EAAE,eAAe,EAK9B,CAAC"}

package/dist/defaultUtilitySkills.js

@@ -0,0 +1,5 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { graphComposerPackRoot } from "./packDir.js";
+/** Loaded from `functions/graph-composer/prompts/default-utility-skills.json` when `utilitySkills` is omitted. */
+export const DEFAULT_UTILITY_SKILLS = JSON.parse(readFileSync(path.join(graphComposerPackRoot(), "prompts", "default-utility-skills.json"), "utf-8"));

package/dist/exampleGeneration.d.ts

@@ -0,0 +1,15 @@
+import { generateContentExample, generateJsonExample, generateMdExample, type ExampleGenLlmOptions, type GenerateContentExampleParams, type GenerateContentExampleResult, type GenerateJsonExampleResult, type GenerateMdExampleParams, type GenerateMdExampleResult } from "@x12i/funcx/functions";
+export type GenerateGraphJsonInputExampleParams = ExampleGenLlmOptions & {
+    /** JSON Schema for the input payload expected by the graph. */
+    jsonSchema: unknown;
+    /** Optional worox graph; metadata is summarized into guidance for the generator. */
+    existingGraph?: object;
+    /** Domain and product hints. Appended after graph-derived guidance. */
+    guidance?: string[];
+    /** Optional known-good or stylistic examples. */
+    examples?: unknown[];
+};
+export declare function buildGraphInputExampleGuidance(existingGraph: object | undefined, guidance?: string[]): string[];
+export declare function generateGraphJsonInputExample(params: GenerateGraphJsonInputExampleParams): 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

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

package/dist/exampleGeneration.js

@@ -0,0 +1,72 @@
+import { generateContentExample, generateJsonExample, generateMdExample, } from "@x12i/funcx/functions";
+function asObject(v) {
+    return v !== null && typeof v === "object" && !Array.isArray(v)
+        ? v
+        : undefined;
+}
+function pickString(o, key) {
+    const v = o?.[key];
+    return typeof v === "string" && v.trim().length > 0 ? v.trim() : undefined;
+}
+function truncate(s, max = 320) {
+    return s.length > max ? `${s.slice(0, max - 3)}...` : s;
+}
+function graphConceptGuidance(existingGraph) {
+    if (!existingGraph)
+        return [];
+    const graph = asObject(existingGraph);
+    const metadata = asObject(graph?.metadata);
+    const concept = asObject(metadata?.graphConcept);
+    const hints = [];
+    const graphId = pickString(graph, "id");
+    if (graphId)
+        hints.push(`Graph id: ${graphId}.`);
+    for (const [label, key] of [
+        ["Primary intent", "primaryIntentStatement"],
+        ["Business objective", "businessObjective"],
+        ["Expected input", "expectedInput"],
+        ["Output description", "outputDescription"],
+        ["Persistence notes", "persistenceNotes"],
+    ]) {
+        const value = pickString(concept, key);
+        if (value)
+            hints.push(`${label}: ${truncate(value)}.`);
+    }
+    const coreTasks = concept?.coreTasks;
+    if (Array.isArray(coreTasks)) {
+        const taskHints = coreTasks
+            .slice(0, 8)
+            .map((task, idx) => {
+            const t = asObject(task);
+            const statement = pickString(t, "statement");
+            const details = pickString(t, "details");
+            const body = [statement, details].filter(Boolean).join(" - ");
+            return body ? `${idx + 1}. ${truncate(body, 220)}` : undefined;
+        })
+            .filter((x) => x !== undefined);
+        if (taskHints.length > 0) {
+            hints.push(`Core tasks: ${taskHints.join(" | ")}.`);
+        }
+    }
+    return hints;
+}
+export function buildGraphInputExampleGuidance(existingGraph, guidance = []) {
+    return [
+        "Generate one realistic example input payload for running this specific worox graph.",
+        "The example must satisfy the provided JSON Schema.",
+        "Use fake but plausible values only; do not create real secrets, API keys, tokens, passwords, or private identifiers.",
+        "Prefer a compact happy-path example unless the caller guidance asks for an edge case.",
+        ...graphConceptGuidance(existingGraph),
+        ...guidance,
+    ];
+}
+export async function generateGraphJsonInputExample(params) {
+    const { jsonSchema, existingGraph, guidance, examples, ...llmOptions } = params;
+    return generateJsonExample({
+        jsonSchema,
+        guidance: buildGraphInputExampleGuidance(existingGraph, guidance),
+        examples,
+        ...llmOptions,
+    });
+}
+export { generateContentExample, generateJsonExample, generateMdExample, };

package/dist/exampleInputs.d.ts

@@ -0,0 +1,12 @@
+import type { GraphComposerInput } from "./types.js";
+export declare function loadExampleGraph(filename: string): Record<string, unknown>;
+/** Skill catalog matching nodes in `network-vuln-subnet-triage.v2.json` (locked explain). */
+export declare function inputExplainNetworkVulnSubnet(): GraphComposerInput;
+/** Same graph as `inputExplainNetworkVulnSubnet`, for `suggestConceptObjective` (locked catalog). */
+export declare function inputSuggestConceptObjectiveNetworkVulnSubnet(): GraphComposerInput;
+/**
+ * `reviewConcept` live smoke: real graph plus `metadata.graphConcept.coreTasks` (length 2) and
+ * `metadata.narrix` on a node — prompts should yield deep requirements or `requirementOptions` / IO findings.
+ */
+export declare function inputReviewConceptIoSmoke(): GraphComposerInput;
+//# sourceMappingURL=exampleInputs.d.ts.map

package/dist/exampleInputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exampleInputs.d.ts","sourceRoot":"","sources":["../src/exampleInputs.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIrD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAO1E;AAED,6FAA6F;AAC7F,wBAAgB,6BAA6B,IAAI,kBAAkB,CA4ClE;AAED,qGAAqG;AACrG,wBAAgB,6CAA6C,IAAI,kBAAkB,CA+ClF;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,kBAAkB,CAsF9D"}

package/dist/exampleInputs.js

@@ -0,0 +1,181 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const repoRoot = path.join(fileURLToPath(new URL("..", import.meta.url)));
+export function loadExampleGraph(filename) {
+    const p = path.join(repoRoot, "examples", filename);
+    const data = JSON.parse(readFileSync(p, "utf-8"));
+    if (data === null || typeof data !== "object") {
+        throw new Error(`Example graph ${filename} must be a JSON object`);
+    }
+    return data;
+}
+/** Skill catalog matching nodes in `network-vuln-subnet-triage.v2.json` (locked explain). */
+export function inputExplainNetworkVulnSubnet() {
+    const existingGraph = loadExampleGraph("network-vuln-subnet-triage.v2.json");
+    return {
+        intent: {
+            action: "explain",
+            description: "Explain this production worox graph end-to-end: parallel readers, deterministic branches (CVSS tier, zone routing), LLM step role, and how the finalizer aggregates outputs. Note conditional edges if any.",
+        },
+        existingGraph,
+        skillMode: "locked",
+        aiSkills: [
+            {
+                skillKey: "professional-answer",
+                description: "LLM-backed structured analysis for security/subnet triage (used when rules route to main synthesis path)",
+                isLocal: false,
+            },
+        ],
+        utilitySkills: [
+            {
+                skillKey: "scoped-data-reader",
+                description: "Read scoped documents (subnet inventory, risk summary, topology/exposure) from x-scoped-data",
+                isLocal: true,
+            },
+            {
+                skillKey: "deterministic-rule",
+                description: "Evaluate ordered rules for zone classification, CVSS-based tier skip, and branch routing without LLM",
+                isLocal: true,
+            },
+            {
+                skillKey: "scoped-answer-assembler",
+                description: "Assemble final subnet triage answer payload from upstream node outputs",
+                isLocal: true,
+            },
+            {
+                skillKey: "scoped-answer-writer",
+                description: "Persist triage verdicts / inferences to scoped store (e.g. subnet-triage-verdicts scope map)",
+                isLocal: true,
+            },
+        ],
+    };
+}
+/** Same graph as `inputExplainNetworkVulnSubnet`, for `suggestConceptObjective` (locked catalog). */
+export function inputSuggestConceptObjectiveNetworkVulnSubnet() {
+    const existingGraph = loadExampleGraph("network-vuln-subnet-triage.v2.json");
+    return {
+        intent: {
+            action: "suggestConceptObjective",
+            description: "Propose graph-level primary intent and objective text for product stakeholders, synthesized from the full pipeline (readers, rules, LLM path, finalizer).",
+        },
+        existingGraph,
+        analysisContext: {
+            note: "Stub: real consumers pass full analyzer output (execution order, IO, issues, layers).",
+        },
+        skillMode: "locked",
+        aiSkills: [
+            {
+                skillKey: "professional-answer",
+                description: "LLM-backed structured analysis for security/subnet triage (used when rules route to main synthesis path)",
+                isLocal: false,
+            },
+        ],
+        utilitySkills: [
+            {
+                skillKey: "scoped-data-reader",
+                description: "Read scoped documents (subnet inventory, risk summary, topology/exposure) from x-scoped-data",
+                isLocal: true,
+            },
+            {
+                skillKey: "deterministic-rule",
+                description: "Evaluate ordered rules for zone classification, CVSS-based tier skip, and branch routing without LLM",
+                isLocal: true,
+            },
+            {
+                skillKey: "scoped-answer-assembler",
+                description: "Assemble final subnet triage answer payload from upstream node outputs",
+                isLocal: true,
+            },
+            {
+                skillKey: "scoped-answer-writer",
+                description: "Persist triage verdicts / inferences to scoped store (e.g. subnet-triage-verdicts scope map)",
+                isLocal: true,
+            },
+        ],
+    };
+}
+/**
+ * `reviewConcept` live smoke: real graph plus `metadata.graphConcept.coreTasks` (length 2) and
+ * `metadata.narrix` on a node — prompts should yield deep requirements or `requirementOptions` / IO findings.
+ */
+export function inputReviewConceptIoSmoke() {
+    const base = loadExampleGraph("network-vuln-subnet-triage.v2.json");
+    const g = JSON.parse(JSON.stringify(base));
+    const prevMeta = g.metadata !== null && typeof g.metadata === "object" && !Array.isArray(g.metadata)
+        ? g.metadata
+        : {};
+    g.metadata = {
+        ...prevMeta,
+        graphConcept: {
+            coreTasks: [
+                {
+                    taskType: "question",
+                    statement: "Load subnet and scoped context",
+                    details: "",
+                },
+                {
+                    taskType: "question",
+                    statement: "Triage and persist verdicts",
+                    details: "",
+                },
+            ],
+        },
+    };
+    const nodes = g.nodes;
+    if (Array.isArray(nodes) && nodes.length > 0) {
+        const n0 = nodes[0];
+        if (n0 !== null && typeof n0 === "object" && !Array.isArray(n0)) {
+            const node = n0;
+            const nm = node.metadata !== null &&
+                typeof node.metadata === "object" &&
+                !Array.isArray(node.metadata)
+                ? node.metadata
+                : {};
+            node.metadata = {
+                ...nm,
+                narrix: {
+                    datasetId: "network.subnets",
+                    narrativeTypeIds: ["nt-discovery"],
+                },
+            };
+        }
+    }
+    return {
+        intent: {
+            action: "reviewConcept",
+            description: "Review concept coherence. Populate requirements (narrix, memoryIO, catalogBinding) from the graph; use requirementOptions when ambiguous.",
+        },
+        existingGraph: g,
+        skillMode: "locked",
+        aiSkills: [
+            {
+                skillKey: "professional-answer",
+                description: "LLM-backed structured analysis for security/subnet triage (used when rules route to main synthesis path)",
+                isLocal: false,
+            },
+        ],
+        utilitySkills: [
+            {
+                skillKey: "scoped-data-reader",
+                description: "Read scoped documents (subnet inventory, risk summary, topology/exposure) from x-scoped-data",
+                isLocal: true,
+            },
+            {
+                skillKey: "deterministic-rule",
+                description: "Evaluate ordered rules for zone classification, CVSS-based tier skip, and branch routing without LLM",
+                isLocal: true,
+            },
+            {
+                skillKey: "scoped-answer-assembler",
+                description: "Assemble final subnet triage answer payload from upstream node outputs",
+                isLocal: true,
+            },
+            {
+                skillKey: "scoped-answer-writer",
+                description: "Persist triage verdicts / inferences to scoped store (e.g. subnet-triage-verdicts scope map)",
+                isLocal: true,
+            },
+        ],
+    };
+}

package/dist/graphComposerActions.d.ts

@@ -0,0 +1,22 @@
+import type { GraphComposerIntent } from "./types.js";
+import { type OutputValidator } from "./graphComposerOutputValidation.js";
+export type GraphComposerAction = GraphComposerIntent["action"];
+export type GraphComposerActionDefinition = {
+    readonly action: GraphComposerAction;
+    /** File under `prompts/` (e.g. `action-create.md`). */
+    readonly promptFile: string;
+    /** More `prompts/` paths, joined before `promptFile`. */
+    readonly sharedIncludes: readonly string[];
+    readonly requiresExistingGraph: boolean;
+    /** Stable tool id for orchestrator (snake_case). */
+    readonly toolName: string;
+    readonly toolDescription: string;
+    readonly validateOutput: OutputValidator;
+};
+export declare const GRAPH_COMPOSER_ACTION_REGISTRY: readonly GraphComposerActionDefinition[];
+export declare function getActionDefinition(action: string): GraphComposerActionDefinition;
+export declare function getActionDefinitionByToolName(toolName: string): GraphComposerActionDefinition | undefined;
+/** Ordered prompt paths that must exist on disk (for verify-local). */
+export declare function requiredPromptPathsFromRegistry(): string[];
+export declare function loadWorkerBaseMarkdown(action: GraphComposerAction): string;
+//# sourceMappingURL=graphComposerActions.d.ts.map

package/dist/graphComposerActions.d.ts.map

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

package/dist/graphComposerActions.js

@@ -0,0 +1,168 @@
+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";
+function readPromptRelative(rel) {
+    const root = graphComposerPackRoot();
+    const p = path.join(root, "prompts", rel);
+    if (!existsSync(p)) {
+        throw new Error(`Missing pack prompt file: ${p}`);
+    }
+    return readFileSync(p, "utf-8");
+}
+const workerBaseMarkdownCache = new Map();
+export const GRAPH_COMPOSER_ACTION_REGISTRY = [
+    {
+        action: "create",
+        promptFile: "action-create.md",
+        sharedIncludes: [
+            "shared/request-context.md",
+            "shared/graph-format.md",
+            "shared/skill-selection.md",
+            "shared/structural-validation.md",
+        ],
+        requiresExistingGraph: false,
+        toolName: "graph_create",
+        toolDescription: "Build a new worox-graph from intentDescription and constraints. Returns full graph + changelog.",
+        validateOutput: (out, ctx) => {
+            validateCreateModifyOutput(out, ctx);
+        },
+    },
+    {
+        action: "modify",
+        promptFile: "action-modify.md",
+        sharedIncludes: [
+            "shared/request-context.md",
+            "shared/graph-format.md",
+            "shared/skill-selection.md",
+            "shared/structural-validation.md",
+        ],
+        requiresExistingGraph: true,
+        toolName: "graph_modify",
+        toolDescription: "Patch an existing worox-graph per intentDescription. Preserves unaffected structure. Returns full graph + changelog.",
+        validateOutput: (out, ctx) => {
+            validateCreateModifyOutput(out, ctx);
+        },
+    },
+    {
+        action: "explain",
+        promptFile: "action-explain.md",
+        sharedIncludes: [
+            "shared/request-context.md",
+            "shared/graph-format.md",
+            "shared/skill-selection.md",
+        ],
+        requiresExistingGraph: true,
+        toolName: "graph_explain",
+        toolDescription: "Explain existingGraph for engineers/operators: summary, execution order, node descriptions, data flow, conditional paths. No graph JSON returned.",
+        validateOutput: validateExplainOutput,
+    },
+    {
+        action: "suggestConceptObjective",
+        promptFile: "action-suggest-concept-objective.md",
+        sharedIncludes: ["shared/request-context.md"],
+        requiresExistingGraph: true,
+        toolName: "graph_suggest_concept_objective",
+        toolDescription: "Propose metadata.graphConcept patch (primary intent type, statement, business objective, outcome) for product UIs. No graph JSON returned.",
+        validateOutput: validateSuggestConceptOutput,
+    },
+    {
+        action: "suggestCatalogResolution",
+        promptFile: "action-suggest-catalog-resolution.md",
+        sharedIncludes: [
+            "shared/request-context.md",
+            "shared/graph-format.md",
+            "shared/skill-selection.md",
+            "shared/structural-validation.md",
+        ],
+        requiresExistingGraph: true,
+        toolName: "graph_suggest_catalog_resolution",
+        toolDescription: "Recommend catalog bindings (skills, scoping maps / questionId, narrix) from candidate lists; report gaps. No graph JSON returned.",
+        validateOutput: (out, ctx) => {
+            validateSuggestCatalogResolutionOutput(out, ctx);
+        },
+    },
+    {
+        action: "suggestCatalogCreations",
+        promptFile: "action-suggest-catalog-creations.md",
+        sharedIncludes: [
+            "shared/request-context.md",
+            "shared/graph-format.md",
+        ],
+        requiresExistingGraph: true,
+        toolName: "graph_suggest_catalog_creations",
+        toolDescription: "Propose new managed-catalog entries (catalogRequests-shaped) and optional new AI skills; host applies via Catalox (or your catalog store) after approval. No graph JSON returned.",
+        validateOutput: (out, ctx) => {
+            validateSuggestCatalogCreationsOutput(out, ctx);
+        },
+    },
+    {
+        action: "suggestScopingNeedMatch",
+        promptFile: "action-suggest-scoping-need-match.md",
+        sharedIncludes: ["shared/request-context.md"],
+        requiresExistingGraph: false,
+        toolName: "graph_suggest_scoping_need_match",
+        toolDescription: "Match a natural-language scoping data need against catalogCandidates.scopingMaps; return best scopingMapId/questionId or no fit. No graph required. No graph JSON returned.",
+        validateOutput: (out, ctx) => {
+            validateSuggestScopingNeedMatchOutput(out, ctx);
+        },
+    },
+    {
+        action: "suggestScopingMapCreation",
+        promptFile: "action-suggest-scoping-map-creation.md",
+        sharedIncludes: ["shared/request-context.md", "shared/graph-format.md"],
+        requiresExistingGraph: false,
+        toolName: "graph_suggest_scoping_map_creation",
+        toolDescription: "Propose a new xmemory scoping map (scopingMapProposal + catalogRequestProposals) for MetaDB; host applies via CRUD after approval. No graph JSON returned.",
+        validateOutput: (out, ctx) => {
+            validateSuggestScopingMapCreationOutput(out, ctx);
+        },
+    },
+    {
+        action: "reviewConcept",
+        promptFile: "action-review-concept.md",
+        sharedIncludes: [
+            "shared/request-context.md",
+            "shared/graph-format.md",
+            "shared/skill-selection.md",
+        ],
+        requiresExistingGraph: true,
+        toolName: "graph_review_concept",
+        toolDescription: "Review whether the graph concept makes sense; return verdict, categorized findings with severity, and improvement suggestions. No graph JSON returned.",
+        validateOutput: validateReviewConceptOutput,
+    },
+];
+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]));
+export function getActionDefinition(action) {
+    const d = byAction[action];
+    if (!d) {
+        throw new Error(`Unknown graph-composer action "${action}". Registered: ${GRAPH_COMPOSER_ACTION_REGISTRY.map((x) => x.action).join(", ")}`);
+    }
+    return d;
+}
+export function getActionDefinitionByToolName(toolName) {
+    return byToolName[toolName];
+}
+/** Ordered prompt paths that must exist on disk (for verify-local). */
+export function requiredPromptPathsFromRegistry() {
+    const set = new Set();
+    for (const d of GRAPH_COMPOSER_ACTION_REGISTRY) {
+        set.add(d.promptFile);
+        for (const s of d.sharedIncludes)
+            set.add(s);
+    }
+    set.add("orchestrator-system.md");
+    return [...set].sort();
+}
+export function loadWorkerBaseMarkdown(action) {
+    const hit = workerBaseMarkdownCache.get(action);
+    if (hit !== undefined)
+        return hit;
+    const def = getActionDefinition(action);
+    const parts = def.sharedIncludes.map((rel) => readPromptRelative(rel).trimEnd());
+    parts.push(readPromptRelative(def.promptFile).trimEnd());
+    const built = parts.join("\n\n");
+    workerBaseMarkdownCache.set(action, built);
+    return built;
+}

package/dist/graphComposerAgent.d.ts

@@ -0,0 +1,26 @@
+import { type GraphComposerAction } from "./graphComposerActions.js";
+import { type RunGraphComposerOptions } from "./runGraphComposer.js";
+import type { GraphComposerAgentInput } from "./types.js";
+export type GraphComposerAgentOrchestrationStep = {
+    kind: "call_tool";
+    tool: string;
+    action: GraphComposerAction;
+};
+export type GraphComposerAgentResult = {
+    orchestration: {
+        summary: string;
+        steps: GraphComposerAgentOrchestrationStep[];
+    };
+    /** Last worker JSON result, or `null` if the orchestrator finished without calling a tool. */
+    result: unknown | null;
+};
+export type RunGraphComposerAgentOptions = RunGraphComposerOptions & {
+    /** Upper bound on orchestrator JSON steps (each step may invoke one worker). Default 8. */
+    maxOrchestratorSteps?: number;
+};
+/**
+ * Orchestrator: chooses registered graph workers via structured JSON steps (`runJsonCompletion`),
+ * then runs each selection with `runGraphWorker` (same prompts as direct `runGraphComposer`).
+ */
+export declare function runGraphComposerAgent(input: GraphComposerAgentInput, options?: RunGraphComposerAgentOptions): Promise<GraphComposerAgentResult>;
+//# sourceMappingURL=graphComposerAgent.d.ts.map

package/dist/graphComposerAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphComposerAgent.d.ts","sourceRoot":"","sources":["../src/graphComposerAgent.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAEV,uBAAuB,EAKxB,MAAM,YAAY,CAAC;AAyGpB,MAAM,MAAM,mCAAmC,GAAG;IAChD,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,aAAa,EAAE;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,mCAAmC,EAAE,CAAC;KAC9C,CAAC;IACF,8FAA8F;IAC9F,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,uBAAuB,GAAG;IACnE,2FAA2F;IAC3F,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAwBF;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,uBAAuB,EAC9B,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,wBAAwB,CAAC,CAmGnC"}