@exellix/graph-composer 2.2.1 → 2.4.2

package/dist/graphEntryContract.js

@@ -0,0 +1,206 @@
+export const GRAPH_ENTRY_FINDING_CATEGORIES = new Set([
+    "graph_entry",
+    "expected_input",
+    "job_models",
+    "job_knowledge",
+    "graph_execution",
+    "graph_conditions",
+]);
+export const GRAPH_ENTRY_PATH_PREFIX = "execution.input.";
+export const GRAPH_EXECUTION_PATCH_ALLOWLIST = new Set([
+    "failFast",
+    "nodeTimeoutMs",
+    "mode",
+    "goalNodeId",
+    "dimension",
+    "outputMode",
+    "coreObjective",
+    "nodesResponses",
+    "flowOutline",
+    "pipeline",
+]);
+function asObject(v) {
+    return v !== null && typeof v === "object" && !Array.isArray(v)
+        ? v
+        : undefined;
+}
+/** Read `metadata.graphEntry` and normalize legacy `exampleInput` → `exampleInputs`. */
+export function resolveEffectiveGraphEntry(graphOrEntry) {
+    const root = asObject(graphOrEntry);
+    const fromMeta = asObject(root?.metadata)?.graphEntry;
+    const entry = asObject(fromMeta) ??
+        (root && "inputs" in root ? root : undefined) ??
+        {};
+    const out = { ...entry };
+    if (!Array.isArray(out.exampleInputs)) {
+        const legacy = out.exampleInput;
+        if (legacy !== undefined && legacy !== null) {
+            if (Array.isArray(legacy)) {
+                out.exampleInputs = legacy;
+            }
+            else if (typeof legacy === "object" && !Array.isArray(legacy)) {
+                out.exampleInputs = [legacy];
+            }
+        }
+    }
+    return out;
+}
+export function isValidGraphEntryPath(path) {
+    const p = path.trim();
+    return p.startsWith(GRAPH_ENTRY_PATH_PREFIX) && p.length > GRAPH_ENTRY_PATH_PREFIX.length;
+}
+export function validateGraphEntryPaths(paths) {
+    const invalid = [];
+    for (const path of paths) {
+        if (!isValidGraphEntryPath(path))
+            invalid.push(path);
+    }
+    return invalid;
+}
+function pathTail(path) {
+    return path.startsWith(GRAPH_ENTRY_PATH_PREFIX)
+        ? path.slice(GRAPH_ENTRY_PATH_PREFIX.length)
+        : path;
+}
+function schemaPropertyForTail(tail, kind) {
+    const segments = tail.split(".").filter(Boolean);
+    if (segments.length === 0) {
+        return { type: "object", additionalProperties: true };
+    }
+    if (kind === "record" && segments.length === 1) {
+        return {
+            type: "object",
+            additionalProperties: true,
+            description: `Record at execution.input.${segments[0]}`,
+        };
+    }
+    const last = segments[segments.length - 1];
+    if (last === "raw" || tail.endsWith(".raw")) {
+        return { type: "string", description: "Raw caller payload" };
+    }
+    return { type: ["string", "number", "boolean", "object", "array", "null"] };
+}
+/** Infer JSON Schema for example generation from declared graph-entry inputs (FR-G4). */
+export function buildGraphEntryExampleJsonSchema(inputs, _entityBindings) {
+    const rows = Array.isArray(inputs) ? inputs : [];
+    const properties = {};
+    const required = [];
+    for (const row of rows) {
+        const r = asObject(row);
+        if (!r || typeof r.path !== "string")
+            continue;
+        const tail = pathTail(r.path);
+        if (!tail)
+            continue;
+        const kind = typeof r.kind === "string" ? r.kind : "scalar";
+        const topKey = tail.split(".")[0];
+        if (!(topKey in properties)) {
+            if (tail.includes(".") || kind === "scalar") {
+                const nestedTail = tail;
+                if (nestedTail === topKey) {
+                    properties[topKey] = schemaPropertyForTail(tail, kind);
+                }
+                else {
+                    properties[topKey] = {
+                        type: "object",
+                        properties: {
+                            [nestedTail.slice(topKey.length + 1)]: schemaPropertyForTail(nestedTail, kind),
+                        },
+                    };
+                }
+            }
+            else {
+                properties[topKey] = schemaPropertyForTail(tail, kind);
+            }
+        }
+        if (r.required === true && !required.includes(topKey)) {
+            required.push(topKey);
+        }
+    }
+    if (Object.keys(properties).length === 0) {
+        return {
+            type: "object",
+            properties: {
+                raw: { type: "string", description: "Default execution.input.raw" },
+            },
+            additionalProperties: true,
+        };
+    }
+    return {
+        type: "object",
+        properties,
+        ...(required.length > 0 ? { required } : {}),
+        additionalProperties: true,
+    };
+}
+/** FR-G3: flag when graphEntry.inputs[].entityIds disagree with graphConcept.entityBindings. */
+export function findGraphEntryEntityBindingMismatches(inputs, graphConcept) {
+    const concept = asObject(graphConcept);
+    const eb = asObject(concept?.entityBindings);
+    const allowed = new Set();
+    if (eb?.coreEntityCollectionId)
+        allowed.add(eb.coreEntityCollectionId);
+    for (const id of eb?.supportingEntityCollectionIds ?? []) {
+        if (typeof id === "string")
+            allowed.add(id);
+    }
+    if (eb?.targetEntityCollectionId)
+        allowed.add(eb.targetEntityCollectionId);
+    if (allowed.size === 0)
+        return [];
+    const mismatches = [];
+    const rows = Array.isArray(inputs) ? inputs : [];
+    for (const row of rows) {
+        const r = asObject(row);
+        if (!r?.entityIds || !Array.isArray(r.entityIds) || r.entityIds.length === 0) {
+            continue;
+        }
+        const bad = r.entityIds.filter((id) => typeof id === "string" && !allowed.has(id));
+        if (bad.length > 0) {
+            mismatches.push({
+                inputPath: r.path,
+                entityIds: bad,
+                message: `entityIds [${bad.join(", ")}] not in graphConcept.entityBindings`,
+            });
+        }
+    }
+    return mismatches;
+}
+export function parseJsonExampleValue(value) {
+    const trimmed = value.trim();
+    if (trimmed === "")
+        return { ok: false, error: "empty value" };
+    try {
+        JSON.parse(trimmed);
+        return { ok: true };
+    }
+    catch (e) {
+        return {
+            ok: false,
+            error: e instanceof Error ? e.message : String(e),
+        };
+    }
+}
+/** Resolve graph-entry context from request (agentContext preferred, analysisContext legacy). */
+export function resolveGraphEntryContextFromInput(input) {
+    const ac = input.agentContext;
+    if (ac?.surface === "graph-entry")
+        return ac;
+    const legacy = asObject(input.analysisContext);
+    if (legacy?.surface === "graph-entry") {
+        return legacy;
+    }
+    return undefined;
+}
+export function assertGraphEntryAgentSurface(input, action) {
+    if (input.agentContext !== undefined && input.agentContext.surface !== "graph-entry") {
+        throw new Error(`${action} requires agentContext.surface === "graph-entry" (got ${input.agentContext.surface})`);
+    }
+    const legacy = asObject(input.analysisContext);
+    if (legacy !== undefined &&
+        "surface" in legacy &&
+        legacy.surface !== undefined &&
+        legacy.surface !== "graph-entry") {
+        throw new Error(`${action} requires analysisContext.surface === "graph-entry" when surface is set`);
+    }
+}

package/dist/graphEntryOutputValidation.d.ts

@@ -0,0 +1,9 @@
+import type { OutputValidationContext } from "./graphComposerOutputValidation.js";
+export declare function validateSuggestGraphEntryInputsOutput(out: Record<string, unknown>, ctx?: OutputValidationContext): void;
+export declare function validateSuggestGraphEntryExamplesOutput(out: Record<string, unknown>, ctx?: OutputValidationContext): void;
+export declare function validateSuggestGraphEntryConditionsOutput(out: Record<string, unknown>, ctx?: OutputValidationContext): void;
+export declare function validateSuggestJobModelDefaultsOutput(out: Record<string, unknown>, ctx?: OutputValidationContext): void;
+export declare function validateSuggestJobKnowledgeRefsOutput(out: Record<string, unknown>, ctx?: OutputValidationContext): void;
+export declare function validateSuggestGraphExecutionDefaultsOutput(out: Record<string, unknown>, ctx?: OutputValidationContext): void;
+export declare function validateReviewGraphEntryContractOutput(out: Record<string, unknown>, ctx?: OutputValidationContext): void;
+//# sourceMappingURL=graphEntryOutputValidation.d.ts.map

package/dist/graphEntryOutputValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphEntryOutputValidation.d.ts","sourceRoot":"","sources":["../src/graphEntryOutputValidation.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAgLlF,wBAAgB,qCAAqC,CACnD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,CAAC,EAAE,uBAAuB,GAC5B,IAAI,CAIN;AAED,wBAAgB,uCAAuC,CACrD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,CAAC,EAAE,uBAAuB,GAC5B,IAAI,CAUN;AAED,wBAAgB,yCAAyC,CACvD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,CAAC,EAAE,uBAAuB,GAC5B,IAAI,CAWN;AAED,wBAAgB,qCAAqC,CACnD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,CAAC,EAAE,uBAAuB,GAC5B,IAAI,CAWN;AAED,wBAAgB,qCAAqC,CACnD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,CAAC,EAAE,uBAAuB,GAC5B,IAAI,CAaN;AAED,wBAAgB,2CAA2C,CACzD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,CAAC,EAAE,uBAAuB,GAC5B,IAAI,CAeN;AAED,wBAAgB,sCAAsC,CACpD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,CAAC,EAAE,uBAAuB,GAC5B,IAAI,CA0EN"}

package/dist/graphEntryOutputValidation.js

@@ -0,0 +1,276 @@
+import { assertGraphEntryAgentSurface, GRAPH_ENTRY_FINDING_CATEGORIES, GRAPH_ENTRY_PATH_PREFIX, GRAPH_EXECUTION_PATCH_ALLOWLIST, isValidGraphEntryPath, parseJsonExampleValue, } from "./graphEntryContract.js";
+function assertNoGraph(out, action) {
+    if ("graph" in out && out.graph !== undefined) {
+        throw new Error(`${action} action must not return a graph object`);
+    }
+}
+function assertStringField(o, key, ctx) {
+    const v = o[key];
+    if (typeof v !== "string" || v.trim() === "") {
+        throw new Error(`${ctx}.${key} must be a non-empty string`);
+    }
+}
+function validateGraphEntryInputRows(rows, ctx) {
+    for (let i = 0; i < rows.length; i++) {
+        const row = rows[i];
+        if (row === null || typeof row !== "object" || Array.isArray(row)) {
+            throw new Error(`${ctx}[${i}] must be an object`);
+        }
+        const r = row;
+        if (typeof r.path !== "string" || !isValidGraphEntryPath(r.path)) {
+            throw new Error(`${ctx}[${i}].path must be a non-empty string starting with ${GRAPH_ENTRY_PATH_PREFIX}`);
+        }
+        if (r.kind !== undefined) {
+            const k = r.kind;
+            if (k !== "scalar" && k !== "record" && typeof k !== "string") {
+                throw new Error(`${ctx}[${i}].kind must be scalar, record, or string`);
+            }
+        }
+        if (r.required !== undefined && typeof r.required !== "boolean") {
+            throw new Error(`${ctx}[${i}].required must be a boolean when present`);
+        }
+        if (r.entityIds !== undefined) {
+            if (!Array.isArray(r.entityIds)) {
+                throw new Error(`${ctx}[${i}].entityIds must be an array when present`);
+            }
+            for (let j = 0; j < r.entityIds.length; j++) {
+                if (typeof r.entityIds[j] !== "string") {
+                    throw new Error(`${ctx}[${i}].entityIds[${j}] must be a string`);
+                }
+            }
+        }
+    }
+}
+function validateGraphEntryExampleRows(rows, ctx) {
+    for (let i = 0; i < rows.length; i++) {
+        const row = rows[i];
+        if (row === null || typeof row !== "object" || Array.isArray(row)) {
+            throw new Error(`${ctx}[${i}] must be an object`);
+        }
+        const r = row;
+        if (typeof r.format !== "string" || r.format.trim() === "") {
+            throw new Error(`${ctx}[${i}].format must be a non-empty string`);
+        }
+        if (typeof r.value !== "string") {
+            throw new Error(`${ctx}[${i}].value must be a string`);
+        }
+        if (r.format === "json") {
+            const check = parseJsonExampleValue(r.value);
+            if (!check.ok) {
+                throw new Error(`${ctx}[${i}].value must be valid JSON when format is json: ${check.error}`);
+            }
+        }
+    }
+}
+function validateOptionalGraphEntryPatch(patch, fieldName, requireInputs, requireExamples) {
+    if (patch === undefined)
+        return;
+    if (patch === null || typeof patch !== "object" || Array.isArray(patch)) {
+        throw new Error(`${fieldName} must be a plain object when present`);
+    }
+    const p = patch;
+    if (p.inputs !== undefined) {
+        if (!Array.isArray(p.inputs)) {
+            throw new Error(`${fieldName}.inputs must be an array when present`);
+        }
+        validateGraphEntryInputRows(p.inputs, `${fieldName}.inputs`);
+    }
+    else if (requireInputs) {
+        throw new Error(`${fieldName} must include inputs array`);
+    }
+    if (p.exampleInputs !== undefined) {
+        if (!Array.isArray(p.exampleInputs)) {
+            throw new Error(`${fieldName}.exampleInputs must be an array when present`);
+        }
+        validateGraphEntryExampleRows(p.exampleInputs, `${fieldName}.exampleInputs`);
+    }
+    else if (requireExamples) {
+        throw new Error(`${fieldName} must include exampleInputs array`);
+    }
+    if (p.conditions !== undefined) {
+        if (p.conditions === null || typeof p.conditions !== "object" || Array.isArray(p.conditions)) {
+            throw new Error(`${fieldName}.conditions must be a plain object when present`);
+        }
+    }
+}
+function validateGraphEntryFindings(findings, action) {
+    for (let i = 0; i < findings.length; i++) {
+        const row = findings[i];
+        if (row === null || typeof row !== "object" || Array.isArray(row)) {
+            throw new Error(`${action} findings[${i}] must be an object`);
+        }
+        const f = row;
+        if (f.scopeType !== undefined && f.scopeType !== "graph") {
+            throw new Error(`${action} findings[${i}].scopeType must be "graph" when present`);
+        }
+        assertStringField(f, "category", `${action} findings[${i}]`);
+        assertStringField(f, "severity", `${action} findings[${i}]`);
+        assertStringField(f, "summary", `${action} findings[${i}]`);
+        const sev = f.severity;
+        if (!["info", "warning", "error"].includes(sev)) {
+            throw new Error(`${action} findings[${i}].severity must be info, warning, or error`);
+        }
+        if (f.suggestedChange !== undefined &&
+            typeof f.suggestedChange !== "string") {
+            throw new Error(`${action} findings[${i}].suggestedChange must be a string when present`);
+        }
+    }
+}
+function validateRequirementOptions(opts, ctx) {
+    if (opts === undefined)
+        return;
+    if (!Array.isArray(opts)) {
+        throw new Error(`${ctx} must be an array when present`);
+    }
+    for (let i = 0; i < opts.length; i++) {
+        const row = opts[i];
+        if (row === null || typeof row !== "object" || Array.isArray(row)) {
+            throw new Error(`${ctx}[${i}] must be an object`);
+        }
+    }
+}
+function validatePagentiRefs(refs, ctx) {
+    for (let i = 0; i < refs.length; i++) {
+        const row = refs[i];
+        if (row === null || typeof row !== "object" || Array.isArray(row)) {
+            throw new Error(`${ctx}[${i}] must be an object`);
+        }
+        const r = row;
+        if (typeof r.catalogId !== "string" || r.catalogId.trim() === "") {
+            throw new Error(`${ctx}[${i}].catalogId must be a non-empty string`);
+        }
+        if (typeof r.itemId !== "string" || r.itemId.trim() === "") {
+            throw new Error(`${ctx}[${i}].itemId must be a non-empty string`);
+        }
+    }
+}
+function graphEntrySurfaceCheck(ctx, action) {
+    if (!ctx?.input || !action)
+        return;
+    assertGraphEntryAgentSurface(ctx.input, action);
+}
+export function validateSuggestGraphEntryInputsOutput(out, ctx) {
+    graphEntrySurfaceCheck(ctx, "suggestGraphEntryInputs");
+    assertNoGraph(out, "suggestGraphEntryInputs");
+    validateOptionalGraphEntryPatch(out.graphEntryPatch, "graphEntryPatch", true);
+}
+export function validateSuggestGraphEntryExamplesOutput(out, ctx) {
+    graphEntrySurfaceCheck(ctx, "suggestGraphEntryExamples");
+    assertNoGraph(out, "suggestGraphEntryExamples");
+    validateOptionalGraphEntryPatch(out.graphEntryPatch, "graphEntryPatch", false, true);
+    validateRequirementOptions(out.requirementOptions, "requirementOptions");
+}
+export function validateSuggestGraphEntryConditionsOutput(out, ctx) {
+    graphEntrySurfaceCheck(ctx, "suggestGraphEntryConditions");
+    assertNoGraph(out, "suggestGraphEntryConditions");
+    const patch = out.graphEntryPatch;
+    if (patch === null || typeof patch !== "object" || Array.isArray(patch)) {
+        throw new Error("suggestGraphEntryConditions must include graphEntryPatch object");
+    }
+    const p = patch;
+    if (p.conditions === undefined) {
+        throw new Error("graphEntryPatch.conditions is required for suggestGraphEntryConditions");
+    }
+}
+export function validateSuggestJobModelDefaultsOutput(out, ctx) {
+    graphEntrySurfaceCheck(ctx, "suggestJobModelDefaults");
+    assertNoGraph(out, "suggestJobModelDefaults");
+    const patch = out.modelConfigPatch;
+    if (patch === null || typeof patch !== "object" || Array.isArray(patch)) {
+        throw new Error("suggestJobModelDefaults must include modelConfigPatch object");
+    }
+    const p = patch;
+    if (p.mode !== undefined && p.mode !== "appendCase" && p.mode !== "replaceDefault") {
+        throw new Error('modelConfigPatch.mode must be "appendCase" or "replaceDefault"');
+    }
+}
+export function validateSuggestJobKnowledgeRefsOutput(out, ctx) {
+    graphEntrySurfaceCheck(ctx, "suggestJobKnowledgeRefs");
+    assertNoGraph(out, "suggestJobKnowledgeRefs");
+    const patch = out.jobPagentiKnowledgePatch;
+    if (patch === null || typeof patch !== "object" || Array.isArray(patch)) {
+        throw new Error("suggestJobKnowledgeRefs must include jobPagentiKnowledgePatch object");
+    }
+    const p = patch;
+    const refs = p.refs ?? p.append;
+    if (refs === undefined || !Array.isArray(refs)) {
+        throw new Error("jobPagentiKnowledgePatch must include refs or append array");
+    }
+    validatePagentiRefs(refs, "jobPagentiKnowledgePatch");
+}
+export function validateSuggestGraphExecutionDefaultsOutput(out, ctx) {
+    graphEntrySurfaceCheck(ctx, "suggestGraphExecutionDefaults");
+    assertNoGraph(out, "suggestGraphExecutionDefaults");
+    const patch = out.graphExecutionPatch;
+    if (patch === null || typeof patch !== "object" || Array.isArray(patch)) {
+        throw new Error("suggestGraphExecutionDefaults must include graphExecutionPatch object");
+    }
+    const p = patch;
+    for (const key of Object.keys(p)) {
+        if (!GRAPH_EXECUTION_PATCH_ALLOWLIST.has(key)) {
+            throw new Error(`graphExecutionPatch.${key} is not an allowed key (${[...GRAPH_EXECUTION_PATCH_ALLOWLIST].join(", ")})`);
+        }
+    }
+}
+export function validateReviewGraphEntryContractOutput(out, ctx) {
+    graphEntrySurfaceCheck(ctx, "reviewGraphEntryContract");
+    assertNoGraph(out, "reviewGraphEntryContract");
+    if ("changelog" in out && out.changelog !== undefined) {
+        throw new Error("reviewGraphEntryContract must not return changelog");
+    }
+    const verdict = out.verdict;
+    if (verdict === null ||
+        verdict === undefined ||
+        typeof verdict !== "object" ||
+        Array.isArray(verdict)) {
+        throw new Error("reviewGraphEntryContract must include verdict object");
+    }
+    const v = verdict;
+    if (typeof v.coherent !== "boolean") {
+        throw new Error("reviewGraphEntryContract.verdict.coherent must be a boolean");
+    }
+    if (typeof v.summary !== "string" || v.summary.trim() === "") {
+        throw new Error("reviewGraphEntryContract.verdict.summary must be non-empty");
+    }
+    if (!Array.isArray(out.findings)) {
+        throw new Error("reviewGraphEntryContract must include findings array");
+    }
+    validateGraphEntryFindings(out.findings, "reviewGraphEntryContract");
+    for (const f of out.findings) {
+        const cat = f.category;
+        if (!GRAPH_ENTRY_FINDING_CATEGORIES.has(cat)) {
+            // allow custom categories but prefer known set — no throw
+        }
+    }
+    validateOptionalGraphEntryPatch(out.graphEntryPatch, "graphEntryPatch");
+    validateOptionalGraphEntryPatch(out.suggestedGraphEntryPatch, "suggestedGraphEntryPatch");
+    if (out.modelConfigPatch !== undefined) {
+        validateSuggestJobModelDefaultsOutput({ action: "reviewGraphEntryContract", modelConfigPatch: out.modelConfigPatch }, ctx);
+    }
+    if (out.jobPagentiKnowledgePatch !== undefined) {
+        validateSuggestJobKnowledgeRefsOutput({
+            action: "reviewGraphEntryContract",
+            jobPagentiKnowledgePatch: out.jobPagentiKnowledgePatch,
+        }, ctx);
+    }
+    if (out.graphExecutionPatch !== undefined) {
+        validateSuggestGraphExecutionDefaultsOutput({
+            action: "reviewGraphEntryContract",
+            graphExecutionPatch: out.graphExecutionPatch,
+        }, ctx);
+    }
+    if (out.graphResponsePatch !== undefined) {
+        if (out.graphResponsePatch === null ||
+            typeof out.graphResponsePatch !== "object" ||
+            Array.isArray(out.graphResponsePatch)) {
+            throw new Error("graphResponsePatch must be a plain object when present");
+        }
+    }
+    if (out.graphConceptPatch !== undefined) {
+        const gcp = out.graphConceptPatch;
+        if (gcp === null || typeof gcp !== "object" || Array.isArray(gcp)) {
+            throw new Error("graphConceptPatch must be a plain object when present");
+        }
+    }
+    validateRequirementOptions(out.requirementOptions, "requirementOptions");
+}

package/dist/graphEntryPostProcess.d.ts

@@ -0,0 +1,11 @@
+import type { GraphComposerInput } from "./types.js";
+export declare const GRAPH_ENTRY_SHARED_INCLUDES: readonly string[];
+/** Alias suggestedGraphEntryPatch → graphEntryPatch when latter empty. */
+export declare function normalizeReviewGraphEntryComposerOutput(out: Record<string, unknown>): void;
+export declare function processSuggestJobModelDefaultsOutput(shaped: Record<string, unknown>, existingGraph: object): void;
+export declare function repairGraphEntryExampleRows(shaped: Record<string, unknown>, existingGraph: object): void;
+export declare function processSuggestGraphEntryExamplesOutput(shaped: Record<string, unknown>, input: GraphComposerInput, options: {
+    repairWithLlm?: boolean;
+    client?: import("@x12i/funcx").Client;
+}): Promise<void>;
+//# sourceMappingURL=graphEntryPostProcess.d.ts.map

package/dist/graphEntryPostProcess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphEntryPostProcess.d.ts","sourceRoot":"","sources":["../src/graphEntryPostProcess.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAQrD,eAAO,MAAM,2BAA2B,EAAE,SAAS,MAAM,EAAuB,CAAC;AAQjF,0EAA0E;AAC1E,wBAAgB,uCAAuC,CACrD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,IAAI,CAaN;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,aAAa,EAAE,MAAM,GACpB,IAAI,CAQN;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,aAAa,EAAE,MAAM,GACpB,IAAI,CA6BN;AAED,wBAAsB,sCAAsC,CAC1D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,aAAa,EAAE,MAAM,CAAA;CAAE,GAC1E,OAAO,CAAC,IAAI,CAAC,CAqDf"}

package/dist/graphEntryPostProcess.js

@@ -0,0 +1,114 @@
+import { parseJsonExampleValue, resolveEffectiveGraphEntry, } from "./graphEntryContract.js";
+import { applyModelConfigPatchGuard } from "./modelConfigPatchMerge.js";
+const GRAPH_ENTRY_SHARED = [
+    "shared/request-context.md",
+    "shared/graph-format.md",
+    "shared/graph-entry-scope.md",
+];
+export const GRAPH_ENTRY_SHARED_INCLUDES = GRAPH_ENTRY_SHARED;
+function asObject(v) {
+    return v !== null && typeof v === "object" && !Array.isArray(v)
+        ? v
+        : undefined;
+}
+/** Alias suggestedGraphEntryPatch → graphEntryPatch when latter empty. */
+export function normalizeReviewGraphEntryComposerOutput(out) {
+    const cur = out.graphEntryPatch;
+    const has = cur !== null &&
+        cur !== undefined &&
+        typeof cur === "object" &&
+        !Array.isArray(cur) &&
+        Object.keys(cur).length > 0;
+    if (has)
+        return;
+    const alt = out.suggestedGraphEntryPatch;
+    if (alt !== null && typeof alt === "object" && !Array.isArray(alt)) {
+        out.graphEntryPatch = alt;
+    }
+}
+export function processSuggestJobModelDefaultsOutput(shaped, existingGraph) {
+    const raw = shaped.modelConfigPatch;
+    if (raw === null || typeof raw !== "object" || Array.isArray(raw))
+        return;
+    const guarded = applyModelConfigPatchGuard(raw, existingGraph);
+    shaped.modelConfigPatch = guarded;
+}
+export function repairGraphEntryExampleRows(shaped, existingGraph) {
+    const patch = asObject(shaped.graphEntryPatch);
+    if (!patch || !Array.isArray(patch.exampleInputs))
+        return;
+    const rows = patch.exampleInputs;
+    for (const row of rows) {
+        if (row.format === "json" && typeof row.value === "string") {
+            const check = parseJsonExampleValue(row.value);
+            if (!check.ok && row.value.trim().startsWith("{")) {
+                try {
+                    const reparsed = JSON.stringify(JSON.parse(row.value.trim()));
+                    row.value = reparsed;
+                }
+                catch {
+                    /* keep original; validation will fail */
+                }
+            }
+        }
+    }
+    const entry = resolveEffectiveGraphEntry(existingGraph);
+    const inputs = Array.isArray(entry.inputs) ? entry.inputs : [];
+    const requiredPaths = inputs
+        .filter((r) => {
+        const o = asObject(r);
+        return o?.required === true && typeof o.path === "string";
+    })
+        .map((r) => asObject(r).path);
+    if (requiredPaths.length > 0 && rows.length === 0) {
+        shaped._graphEntryExamplesIncomplete = true;
+    }
+}
+export async function processSuggestGraphEntryExamplesOutput(shaped, input, options) {
+    repairGraphEntryExampleRows(shaped, input.existingGraph);
+    if (!options.repairWithLlm || options.client === undefined)
+        return;
+    const patch = asObject(shaped.graphEntryPatch);
+    const examples = patch?.exampleInputs;
+    const needsRepair = shaped._graphEntryExamplesIncomplete === true ||
+        !Array.isArray(examples) ||
+        examples.length === 0 ||
+        (Array.isArray(examples) &&
+            examples.some((row) => {
+                const r = asObject(row);
+                if (!r || r.format !== "json")
+                    return false;
+                return typeof r.value === "string" && !parseJsonExampleValue(r.value).ok;
+            }));
+    if (!needsRepair || input.existingGraph === undefined)
+        return;
+    try {
+        const { generateGraphEntryInputExample } = await import("./exampleGeneration.js");
+        const ctx = input.agentContext;
+        const entityBindings = ctx?.surface === "graph-entry"
+            ? ctx.graphConcept?.entityBindings
+            : undefined;
+        const gen = await generateGraphEntryInputExample({
+            graph: input.existingGraph,
+            entityBindings,
+            client: options.client,
+        });
+        const value = typeof gen.example === "string"
+            ? gen.example
+            : JSON.stringify(gen.example ?? {});
+        if (!patch) {
+            shaped.graphEntryPatch = {
+                exampleInputs: [{ format: "json", value, path: "execution.input.raw" }],
+            };
+        }
+        else {
+            patch.exampleInputs = [
+                { format: "json", value, path: "execution.input.raw" },
+            ];
+        }
+        delete shaped._graphEntryExamplesIncomplete;
+    }
+    catch {
+        /* LLM repair optional */
+    }
+}

package/dist/graphModelLayers.d.ts

@@ -88,4 +88,23 @@ export declare function resolveGraphModelProfileName(profileName: string): Promi
     modelId: string;
     formatted: string;
 }>;
+export type FormatNodeModelLabelOptions = {
+    /** When true (default), append resolved provider id when it differs from the profile name. */
+    includeProviderIds?: boolean;
+    /**
+     * `main` — one line for canvas badges (MAIN / skillModel only).
+     * `triple` — PRE · MAIN · POST profile names.
+     * `tripleWithSource` — triple plus winning layer path (e.g. graph.modelConfig).
+     */
+    mode?: "main" | "triple" | "tripleWithSource";
+};
+/** Read `metadata.graphModelLayers` stamped by `stampGraphModelLayersOnGraph`. */
+export declare function readNodeGraphModelLayersFromNode(node: unknown): NodeGraphModelLayers | undefined;
+/**
+ * Human-readable model label for graph canvas / Agent View (graphs-studio).
+ * Requires `stampGraphModelLayersOnGraph` (or equivalent `metadata.graphModelLayers` on the node).
+ */
+export declare function formatNodeWinningModelLabel(nodeOrLayers: unknown, options?: FormatNodeModelLabelOptions): string | undefined;
+/** Label for graph-root default from `metadata.graphModelLayersSummary`. */
+export declare function formatGraphDefaultModelLabel(graph: object, options?: FormatNodeModelLabelOptions): string | undefined;
 //# sourceMappingURL=graphModelLayers.d.ts.map

package/dist/graphModelLayers.d.ts.map

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