@sapiom/harness 0.1.5 → 0.2.0

package/dist/core/canvas-derive.js.map

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

package/dist/core/canvas-enrichment.d.ts

@@ -1,5 +1,23 @@
-import { z } from "zod";
-import type { CanvasGraph } from "./canvas-graph.js";
+/**
+ * The canvas enrichment contract: the optional annotation layer merged on top
+ * of a deterministic canvas render — a summary line, per-node sublabels/hover
+ * descriptions, edge labels, footer notes, layout hints, and a cross-workflow
+ * tie. Every value is a BOUNDED plain string (the limits below are hard caps
+ * that keep the SVG layout from breaking); the renderer (core/canvas-svg.ts,
+ * core/canvas-body.ts) decides where each field goes.
+ *
+ * The enrichment is produced DETERMINISTICALLY, in-process, from the extracted
+ * graph — see core/canvas-derive.ts. There is no LLM, no user token, no file
+ * write, and no cache: it is recomputed from the current sources on every
+ * render, so it can never go stale. This module is now just the shared shape +
+ * limits both the producer (canvas-derive.ts) and the consumer (canvas-svg.ts,
+ * canvas-body.ts) agree on.
+ *
+ * Layout hints are the one structural field: named groups (rendered as subtle
+ * background bands) and per-layer ordering. The renderer applies a hint only
+ * when every node id it references actually exists in the graph (see
+ * canvas-svg.ts) — ids are validated at render time.
+ */
 export declare const ENRICHMENT_LIMITS: {
     readonly summary: 160;
     readonly sublabel: 48;
@@ -10,135 +28,42 @@ export declare const ENRICHMENT_LIMITS: {
     readonly groupLabel: 48;
     readonly crossWorkflow: 160;
 };
-export declare const canvasEnrichmentSchema: z.ZodObject<{
+/** Per-node annotations, keyed by node id. */
+export interface CanvasNodeDetail {
+    /** Second text line inside the node box. */
+    sublabel?: string;
+    /** Hover tooltip (SVG <title>) — room for a full sentence. */
+    description?: string;
+}
+/**
+ * The one structural hint set: named clusters rendered as background bands
+ * behind their member nodes, and a preferred left-to-right node order per
+ * layout layer (keyed by the layer index as a string). `laneOrder` reorders
+ * WITHIN a computed layer only — it can never move a node between layers.
+ */
+export interface CanvasLayoutHints {
+    groups?: Array<{
+        label: string;
+        nodeIds: string[];
+    }>;
+    laneOrder?: Record<string, string[]>;
+}
+/**
+ * Everything the enrichment layer can add to a deterministic render. Every
+ * field is optional — the base structure render stands on its own without any
+ * of it, so a workflow with nothing worth annotating simply renders clean.
+ */
+export interface CanvasEnrichment {
     /** One-liner under the panel header. */
-    summary: z.ZodOptional<z.ZodString>;
+    summary?: string;
     /** Per-node annotations, keyed by node id. */
-    nodeDetails: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-        /** Second text line inside the node box. */
-        sublabel: z.ZodOptional<z.ZodString>;
-        /** Hover tooltip (SVG <title>) — room for a full sentence. */
-        description: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        description?: string | undefined;
-        sublabel?: string | undefined;
-    }, {
-        description?: string | undefined;
-        sublabel?: string | undefined;
-    }>>>;
+    nodeDetails?: Record<string, CanvasNodeDetail>;
     /** Edge annotations (intent/condition names), keyed `"<from>-><to>"`. */
-    edgeLabels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    edgeLabels?: Record<string, string>;
     /** Footer facts worth knowing that don't fit the diagram itself. */
-    notes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    layoutHints: z.ZodOptional<z.ZodObject<{
-        /** Named clusters rendered as background bands behind member nodes. */
-        groups: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            label: z.ZodString;
-            nodeIds: z.ZodArray<z.ZodString, "many">;
-        }, "strip", z.ZodTypeAny, {
-            label: string;
-            nodeIds: string[];
-        }, {
-            label: string;
-            nodeIds: string[];
-        }>, "many">>;
-        /** Preferred left-to-right node order per layout layer, keyed by the
-         *  layer index as a string. Reorders WITHIN the computed layer only —
-         *  it can never move a node between layers. */
-        laneOrder: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
-    }, "strip", z.ZodTypeAny, {
-        groups?: {
-            label: string;
-            nodeIds: string[];
-        }[] | undefined;
-        laneOrder?: Record<string, string[]> | undefined;
-    }, {
-        groups?: {
-            label: string;
-            nodeIds: string[];
-        }[] | undefined;
-        laneOrder?: Record<string, string[]> | undefined;
-    }>>;
+    notes?: string[];
+    layoutHints?: CanvasLayoutHints;
     /** How this workflow ties into the workspace's other workflows. */
-    crossWorkflow: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    summary?: string | undefined;
-    nodeDetails?: Record<string, {
-        description?: string | undefined;
-        sublabel?: string | undefined;
-    }> | undefined;
-    edgeLabels?: Record<string, string> | undefined;
-    notes?: string[] | undefined;
-    layoutHints?: {
-        groups?: {
-            label: string;
-            nodeIds: string[];
-        }[] | undefined;
-        laneOrder?: Record<string, string[]> | undefined;
-    } | undefined;
-    crossWorkflow?: string | undefined;
-}, {
-    summary?: string | undefined;
-    nodeDetails?: Record<string, {
-        description?: string | undefined;
-        sublabel?: string | undefined;
-    }> | undefined;
-    edgeLabels?: Record<string, string> | undefined;
-    notes?: string[] | undefined;
-    layoutHints?: {
-        groups?: {
-            label: string;
-            nodeIds: string[];
-        }[] | undefined;
-        laneOrder?: Record<string, string[]> | undefined;
-    } | undefined;
-    crossWorkflow?: string | undefined;
-}>;
-export type CanvasEnrichment = z.infer<typeof canvasEnrichmentSchema>;
-export type CanvasLayoutHints = NonNullable<CanvasEnrichment["layoutHints"]>;
-/**
- * Validates a candidate enrichment object. Returns null on ANY schema
- * violation (oversize string, wrong shape, too many notes) — partial
- * salvage is deliberately not attempted, so the contract stays a hard line
- * the prompt can state truthfully: "invalid output is thrown away whole."
- */
-export declare function parseCanvasEnrichment(value: unknown): CanvasEnrichment | null;
-/**
- * Deterministic repair of the two ways an otherwise-good answer most often
- * misses the contract, applied BEFORE strict validation:
- * - `null` where the schema means "omit the field"
- * - strings a few words over their cap (measured live: sonnet writes
- *   excellent content but doesn't count characters — a single 160-char note
- *   against the 140 cap discarded 3 of 4 real enrichments whole), truncated
- *   to the cap with an ellipsis; extra notes beyond the count cap dropped
- *
- * The bound the caps exist for — the AI can never blow up the layout with
- * unbounded text — is still enforced, just deterministically here instead
- * of by rejection. Everything else (wrong shapes, wrong types, unknown
- * structure) still fails `parseCanvasEnrichment` and discards the
- * enrichment whole.
- */
-export declare function normalizeCanvasEnrichmentCandidate(value: unknown): unknown;
-/**
- * What one cache file holds. `sourceFingerprint` is canvas-cache.ts's cheap
- * source fingerprint at the moment the enrichment task was SPAWNED — when it
- * no longer matches the workflow's current sources, the base diagram
- * re-renders immediately from fresh extraction while this enrichment stays
- * displayed with a "stale" chip until a re-run replaces it.
- */
-export interface EnrichmentCacheEntry {
-    /** The graph the enrichment was generated against (diagnostic context —
-     *  renders always use the freshly extracted graph, never this copy). */
-    graph: CanvasGraph;
-    enrichment: CanvasEnrichment;
-    sourceFingerprint: string;
-    enrichedAt: string;
+    crossWorkflow?: string;
 }
-/** Reads + validates one enrichment cache file. Null for missing, unparsable
- *  or schema-invalid content — a bad cache degrades to "no enrichment". */
-export declare function readEnrichmentCacheFile(filePath: string): Promise<EnrichmentCacheEntry | null>;
-export declare function writeEnrichmentCacheFile(filePath: string, entry: EnrichmentCacheEntry): Promise<void>;
-/** Deletes one enrichment cache file (the visualize macro's force refresh).
- *  Missing file is fine — the goal state is "no cache". */
-export declare function removeEnrichmentCacheFile(filePath: string): Promise<void>;
 //# sourceMappingURL=canvas-enrichment.d.ts.map

package/dist/core/canvas-enrichment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canvas-enrichment.d.ts","sourceRoot":"","sources":["../../src/core/canvas-enrichment.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,iBAAiB;;;;;;;;;CASpB,CAAC;AAIX,eAAO,MAAM,sBAAsB;IAE/B,wCAAwC;;IAExC,8CAA8C;;QAKtC,4CAA4C;;QAE5C,8DAA8D;;;;;;;;;IAMtE,yEAAyE;;IAEzE,oEAAoE;;;QAIhE,uEAAuE;;;;;;;;;;;QAWvE;;uDAE+C;;;;;;;;;;;;;;;IAKnD,mEAAmE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAG7D,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC;AAE7E;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAG7E;AAkBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA6C1E;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC;4EACwE;IACxE,KAAK,EAAE,WAAW,CAAC;IACnB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAmBD;2EAC2E;AAC3E,wBAAsB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAepG;AAED,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3G;AAED;2DAC2D;AAC3D,wBAAsB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/E"}
+{"version":3,"file":"canvas-enrichment.d.ts","sourceRoot":"","sources":["../../src/core/canvas-enrichment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;CASpB,CAAC;AAEX,8CAA8C;AAC9C,MAAM,WAAW,gBAAgB;IAC/B,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC/C,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/core/canvas-enrichment.js

@@ -1,22 +1,23 @@
 /**
- * The AI enrichment contract: everything the enrichment task is allowed to
- * add to a deterministic canvas render, as a zod schema. The AI never writes
- * HTML — it returns one JSON object of BOUNDED plain strings (every limit
- * below is a hard cap, not advice) and the renderer decides where they go.
- * Unknown keys are stripped; any parse failure means the whole enrichment is
- * discarded and the base render stands — a malformed answer can degrade
- * nothing but itself.
+ * The canvas enrichment contract: the optional annotation layer merged on top
+ * of a deterministic canvas render — a summary line, per-node sublabels/hover
+ * descriptions, edge labels, footer notes, layout hints, and a cross-workflow
+ * tie. Every value is a BOUNDED plain string (the limits below are hard caps
+ * that keep the SVG layout from breaking); the renderer (core/canvas-svg.ts,
+ * core/canvas-body.ts) decides where each field goes.
  *
- * Layout hints are the one structural concession: named groups (rendered as
- * subtle background bands) and per-layer ordering. The renderer applies a
- * hint only when every node id it references actually exists in the graph
- * (see canvas-svg.ts) — ids are validated at render time, not here, because
- * an enrichment can outlive the graph it was written against (the "stale"
- * cache state).
+ * The enrichment is produced DETERMINISTICALLY, in-process, from the extracted
+ * graph — see core/canvas-derive.ts. There is no LLM, no user token, no file
+ * write, and no cache: it is recomputed from the current sources on every
+ * render, so it can never go stale. This module is now just the shared shape +
+ * limits both the producer (canvas-derive.ts) and the consumer (canvas-svg.ts,
+ * canvas-body.ts) agree on.
+ *
+ * Layout hints are the one structural field: named groups (rendered as subtle
+ * background bands) and per-layer ordering. The renderer applies a hint only
+ * when every node id it references actually exists in the graph (see
+ * canvas-svg.ts) — ids are validated at render time.
  */
-import * as fs from "node:fs/promises";
-import * as path from "node:path";
-import { z } from "zod";
 export const ENRICHMENT_LIMITS = {
     summary: 160,
     sublabel: 48,
@@ -27,166 +28,4 @@ export const ENRICHMENT_LIMITS = {
     groupLabel: 48,
     crossWorkflow: 160,
 };
-const bounded = (max) => z.string().max(max);
-export const canvasEnrichmentSchema = z
-    .object({
-    /** One-liner under the panel header. */
-    summary: bounded(ENRICHMENT_LIMITS.summary).optional(),
-    /** Per-node annotations, keyed by node id. */
-    nodeDetails: z
-        .record(z
-        .object({
-        /** Second text line inside the node box. */
-        sublabel: bounded(ENRICHMENT_LIMITS.sublabel).optional(),
-        /** Hover tooltip (SVG <title>) — room for a full sentence. */
-        description: bounded(ENRICHMENT_LIMITS.description).optional(),
-    })
-        .strip())
-        .optional(),
-    /** Edge annotations (intent/condition names), keyed `"<from>-><to>"`. */
-    edgeLabels: z.record(bounded(ENRICHMENT_LIMITS.edgeLabel)).optional(),
-    /** Footer facts worth knowing that don't fit the diagram itself. */
-    notes: z.array(bounded(ENRICHMENT_LIMITS.note)).max(ENRICHMENT_LIMITS.noteCount).optional(),
-    layoutHints: z
-        .object({
-        /** Named clusters rendered as background bands behind member nodes. */
-        groups: z
-            .array(z
-            .object({
-            label: bounded(ENRICHMENT_LIMITS.groupLabel),
-            nodeIds: z.array(z.string()).min(1),
-        })
-            .strip())
-            .optional(),
-        /** Preferred left-to-right node order per layout layer, keyed by the
-         *  layer index as a string. Reorders WITHIN the computed layer only —
-         *  it can never move a node between layers. */
-        laneOrder: z.record(z.array(z.string()).min(1)).optional(),
-    })
-        .strip()
-        .optional(),
-    /** How this workflow ties into the workspace's other workflows. */
-    crossWorkflow: bounded(ENRICHMENT_LIMITS.crossWorkflow).optional(),
-})
-    .strip();
-/**
- * Validates a candidate enrichment object. Returns null on ANY schema
- * violation (oversize string, wrong shape, too many notes) — partial
- * salvage is deliberately not attempted, so the contract stays a hard line
- * the prompt can state truthfully: "invalid output is thrown away whole."
- */
-export function parseCanvasEnrichment(value) {
-    const parsed = canvasEnrichmentSchema.safeParse(value);
-    return parsed.success ? parsed.data : null;
-}
-function clampString(value, max) {
-    if (typeof value !== "string" || value.length <= max)
-        return value;
-    return `${value.slice(0, max - 1)}…`;
-}
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-/** Removes null/undefined-valued properties (models write `"field": null`
- *  to mean "omitted"; the schema means it as `undefined`). Shallow — called
- *  per level below where object shapes are known. */
-function dropNulls(record) {
-    return Object.fromEntries(Object.entries(record).filter(([, v]) => v != null));
-}
-/**
- * Deterministic repair of the two ways an otherwise-good answer most often
- * misses the contract, applied BEFORE strict validation:
- * - `null` where the schema means "omit the field"
- * - strings a few words over their cap (measured live: sonnet writes
- *   excellent content but doesn't count characters — a single 160-char note
- *   against the 140 cap discarded 3 of 4 real enrichments whole), truncated
- *   to the cap with an ellipsis; extra notes beyond the count cap dropped
- *
- * The bound the caps exist for — the AI can never blow up the layout with
- * unbounded text — is still enforced, just deterministically here instead
- * of by rejection. Everything else (wrong shapes, wrong types, unknown
- * structure) still fails `parseCanvasEnrichment` and discards the
- * enrichment whole.
- */
-export function normalizeCanvasEnrichmentCandidate(value) {
-    if (!isRecord(value))
-        return value;
-    const L = ENRICHMENT_LIMITS;
-    const out = { ...value };
-    out.summary = clampString(out.summary, L.summary);
-    out.crossWorkflow = clampString(out.crossWorkflow, L.crossWorkflow);
-    if (isRecord(out.nodeDetails)) {
-        out.nodeDetails = Object.fromEntries(Object.entries(out.nodeDetails).map(([id, details]) => {
-            if (!isRecord(details))
-                return [id, details];
-            return [
-                id,
-                dropNulls({
-                    ...details,
-                    sublabel: clampString(details.sublabel, L.sublabel),
-                    description: clampString(details.description, L.description),
-                }),
-            ];
-        }));
-    }
-    if (isRecord(out.edgeLabels)) {
-        out.edgeLabels = Object.fromEntries(Object.entries(out.edgeLabels).map(([key, label]) => [key, clampString(label, L.edgeLabel)]));
-    }
-    if (Array.isArray(out.notes)) {
-        out.notes = out.notes.slice(0, L.noteCount).map((note) => clampString(note, L.note));
-    }
-    if (isRecord(out.layoutHints)) {
-        const hints = dropNulls({ ...out.layoutHints });
-        if (Array.isArray(hints.groups)) {
-            hints.groups = hints.groups.map((group) => isRecord(group) ? dropNulls({ ...group, label: clampString(group.label, L.groupLabel) }) : group);
-        }
-        out.layoutHints = hints;
-    }
-    return dropNulls(out);
-}
-/** Envelope validation is deliberately shallow for `graph` (it's our own
- *  writer's serialization, not AI output) and strict for `enrichment` (it IS
- *  AI output — re-validated on every read, so a hand-edited or corrupted
- *  cache file can never smuggle unbounded strings into a render). */
-const cacheEntrySchema = z.object({
-    graph: z.object({
-        manifestName: z.string(),
-        entry: z.string(),
-        nodes: z.array(z.record(z.unknown())),
-        edges: z.array(z.record(z.unknown())),
-        warnings: z.array(z.string()),
-    }),
-    enrichment: canvasEnrichmentSchema,
-    sourceFingerprint: z.string(),
-    enrichedAt: z.string(),
-});
-/** Reads + validates one enrichment cache file. Null for missing, unparsable
- *  or schema-invalid content — a bad cache degrades to "no enrichment". */
-export async function readEnrichmentCacheFile(filePath) {
-    let raw;
-    try {
-        raw = await fs.readFile(filePath, "utf8");
-    }
-    catch {
-        return null;
-    }
-    try {
-        const parsed = cacheEntrySchema.safeParse(JSON.parse(raw));
-        // The shallow node/edge validation above means this cast, not a full
-        // structural proof — see the schema's own comment for why that's enough.
-        return parsed.success ? parsed.data : null;
-    }
-    catch {
-        return null;
-    }
-}
-export async function writeEnrichmentCacheFile(filePath, entry) {
-    await fs.mkdir(path.dirname(filePath), { recursive: true });
-    await fs.writeFile(filePath, JSON.stringify(entry, null, 2), "utf8");
-}
-/** Deletes one enrichment cache file (the visualize macro's force refresh).
- *  Missing file is fine — the goal state is "no cache". */
-export async function removeEnrichmentCacheFile(filePath) {
-    await fs.rm(filePath, { force: true });
-}
 //# sourceMappingURL=canvas-enrichment.js.map

package/dist/core/canvas-enrichment.js.map

@@ -1 +1 @@
-{"version":3,"file":"canvas-enrichment.js","sourceRoot":"","sources":["../../src/core/canvas-enrichment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,EAAE;IACZ,WAAW,EAAE,GAAG;IAChB,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,CAAC;IACZ,IAAI,EAAE,GAAG;IACT,UAAU,EAAE,EAAE;IACd,aAAa,EAAE,GAAG;CACV,CAAC;AAEX,MAAM,OAAO,GAAG,CAAC,GAAW,EAAe,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAElE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC;KACpC,MAAM,CAAC;IACN,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE;IACtD,8CAA8C;IAC9C,WAAW,EAAE,CAAC;SACX,MAAM,CACL,CAAC;SACE,MAAM,CAAC;QACN,4CAA4C;QAC5C,QAAQ,EAAE,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE;QACxD,8DAA8D;QAC9D,WAAW,EAAE,OAAO,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;KAC/D,CAAC;SACD,KAAK,EAAE,CACX;SACA,QAAQ,EAAE;IACb,yEAAyE;IACzE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;IACrE,oEAAoE;IACpE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE;IAC3F,WAAW,EAAE,CAAC;SACX,MAAM,CAAC;QACN,uEAAuE;QACvE,MAAM,EAAE,CAAC;aACN,KAAK,CACJ,CAAC;aACE,MAAM,CAAC;YACN,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC;YAC5C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;SACpC,CAAC;aACD,KAAK,EAAE,CACX;aACA,QAAQ,EAAE;QACb;;uDAE+C;QAC/C,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;KAC3D,CAAC;SACD,KAAK,EAAE;SACP,QAAQ,EAAE;IACb,mEAAmE;IACnE,aAAa,EAAE,OAAO,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;CACnE,CAAC;KACD,KAAK,EAAE,CAAC;AAKX;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED,SAAS,WAAW,CAAC,KAAc,EAAE,GAAW;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,KAAK,CAAC;IACnE,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;AACvC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;qDAEqD;AACrD,SAAS,SAAS,CAAC,MAA+B;IAChD,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;AACjF,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kCAAkC,CAAC,KAAc;IAC/D,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,MAAM,CAAC,GAAG,iBAAiB,CAAC;IAC5B,MAAM,GAAG,GAA4B,EAAE,GAAG,KAAK,EAAE,CAAC;IAElD,GAAG,CAAC,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IAClD,GAAG,CAAC,aAAa,GAAG,WAAW,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC;IAEpE,IAAI,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9B,GAAG,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAClC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE;YACpD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YAC7C,OAAO;gBACL,EAAE;gBACF,SAAS,CAAC;oBACR,GAAG,OAAO;oBACV,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC;oBACnD,WAAW,EAAE,WAAW,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC;iBAC7D,CAAC;aACH,CAAC;QACJ,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC,WAAW,CACjC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAC7F,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACvF,CAAC;IAED,IAAI,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QAChD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACxC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CACjG,CAAC;QACJ,CAAC;QACD,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC;AAsBD;;;qEAGqE;AACrE,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACrC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACrC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KAC9B,CAAC;IACF,UAAU,EAAE,sBAAsB;IAClC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC7B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAEH;2EAC2E;AAC3E,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,QAAgB;IAC5D,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3D,qEAAqE;QACrE,yEAAyE;QACzE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAE,MAAM,CAAC,IAAwC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,QAAgB,EAAE,KAA2B;IAC1F,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACvE,CAAC;AAED;2DAC2D;AAC3D,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,QAAgB;IAC9D,MAAM,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"canvas-enrichment.js","sourceRoot":"","sources":["../../src/core/canvas-enrichment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,EAAE;IACZ,WAAW,EAAE,GAAG;IAChB,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,CAAC;IACZ,IAAI,EAAE,GAAG;IACT,UAAU,EAAE,EAAE;IACd,aAAa,EAAE,GAAG;CACV,CAAC"}

package/dist/core/canvas-graph.d.ts

@@ -10,7 +10,7 @@
  * instead of crashing or silently falling back to an LLM.
  */
 import type { AgentManifest } from "@sapiom/agent";
-import { type DetectedLaunch } from "./canvas-interconnections.js";
+import { type DetectedLaunch, type DetectedCapability } from "./canvas-interconnections.js";
 export type CanvasNodeKind = "entry" | "step" | "pause" | "terminal-success" | "terminal-warn" | "launched-workflow";
 export type CanvasEdgeKind = "sequential" | "branching" | "cross" | "launch";
 export interface CanvasNode {
@@ -18,6 +18,14 @@ export interface CanvasNode {
     kind: CanvasNodeKind;
     label: string;
     sublabel?: string;
+    /** Human-authored step description from the manifest (Option A); "" when none. */
+    description?: string;
+    /** The step's declared input contract (JSON Schema) from the manifest. */
+    inputSchema?: Record<string, unknown> | null;
+    /** Author-declared Sapiom capabilities the step calls. */
+    capabilities?: readonly string[];
+    /** The step's declared dispatch timeout (ms); null when unset. */
+    timeoutMs?: number | null;
 }
 export interface CanvasEdge {
     from: string;
@@ -30,6 +38,8 @@ export interface CanvasGraph {
     /** The manifest's own name — used both as a display title fallback and as
      *  the match key for cross-workflow interconnection detection. */
     manifestName: string;
+    /** Human-authored workflow description from the manifest (Option A); "" when none. */
+    description?: string;
     entry: string;
     nodes: CanvasNode[];
     edges: CanvasEdge[];
@@ -47,6 +57,31 @@ export interface ExtractionFailure {
     reason: string;
 }
 export type ExtractionResult = ExtractionSuccess | ExtractionFailure;
+/**
+ * The precedence table above, over nothing but a step's declared transition
+ * kinds — so a caller that has transitions from somewhere OTHER than a local
+ * `AgentManifest` classifies identically.
+ *
+ * Exported because the Studio's template preview projects the SAME graph from
+ * core's relayed `DefinitionTransitionDto[]` (see `core/template-catalog.ts`).
+ * That preview claims parity with the canvas, so it must not re-derive this:
+ * a second copy of the rule is a second answer to "what kind of node is this",
+ * and the two surfaces disagreeing is the exact class of bug the template work
+ * set out to remove. Collapsing the four kinds into a single `terminal` boolean
+ * (as the first cut of that preview did) renders a fail-only sink as a green
+ * success exit and a `continue`-plus-`terminate` gate as a terminal.
+ */
+export declare function classifyStepKind(input: {
+    name: string;
+    entry: string;
+    transitions: ReadonlyArray<{
+        kind: string;
+        signal?: string | null;
+    }>;
+}): {
+    kind: CanvasNodeKind;
+    sublabel: string;
+};
 /** Reshapes a validated `AgentManifest` into the render-ready graph model. */
 export declare function graphFromManifest(manifest: AgentManifest, warnings: string[]): CanvasGraph;
 /**
@@ -58,6 +93,10 @@ export declare function graphFromManifest(manifest: AgentManifest, warnings: str
  * already shows those steps. Pure — returns a new graph.
  */
 export declare function mergeLaunchesIntoGraph(graph: CanvasGraph, launches: readonly DetectedLaunch[]): CanvasGraph;
+/** Fills each step node's `capabilities` from statically-detected
+ *  `ctx.sapiom.*` calls, unless the manifest already declared them (authored
+ *  capabilities win). Pure — returns a new graph. */
+export declare function mergeCapabilitiesIntoGraph(graph: CanvasGraph, detected: readonly DetectedCapability[]): CanvasGraph;
 /**
  * Extracts a workflow's step graph from its project directory, with detected
  * cross-workflow launches merged in as dashed nodes. Never throws: any

package/dist/core/canvas-graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canvas-graph.d.ts","sourceRoot":"","sources":["../../src/core/canvas-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,aAAa,EAAqB,MAAM,eAAe,CAAC;AAEtE,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE3F,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,kBAAkB,GAAG,eAAe,GAAG,mBAAmB,CAAC;AACrH,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE7E,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,oDAAoD;AACpD,MAAM,WAAW,WAAW;IAC1B;sEACkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB;mEAC+D;IAC/D,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,KAAK,CAAC;IACV,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AA0DrE,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,WAAW,CAS1F;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,WAAW,CAqB3G;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAMvF"}
+{"version":3,"file":"canvas-graph.d.ts","sourceRoot":"","sources":["../../src/core/canvas-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,aAAa,EAAqB,MAAM,eAAe,CAAC;AAEtE,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACxB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,kBAAkB,GAAG,eAAe,GAAG,mBAAmB,CAAC;AACrH,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE7E,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7C,0DAA0D;IAC1D,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,oDAAoD;AACpD,MAAM,WAAW,WAAW;IAC1B;sEACkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,sFAAsF;IACtF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB;mEAC+D;IAC/D,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,KAAK,CAAC;IACV,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AA2BrE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CACtE,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAiB7C;AAmBD,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,WAAW,CAyB1F;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,WAAW,CAqB3G;AAED;;qDAEqD;AACrD,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,SAAS,kBAAkB,EAAE,GACtC,WAAW,CAiBb;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAUvF"}

package/dist/core/canvas-graph.js

@@ -1,5 +1,5 @@
 import { runManifestCheck } from "./canvas-manifest-check.js";
-import { detectWorkflowLaunches } from "./canvas-interconnections.js";
+import { scanWorkflowSources, } from "./canvas-interconnections.js";
 /**
  * Classifies a step for node styling. Priority: the entry step always reads
  * as "entry" (the diagram's obvious starting point) even if it also happens
@@ -18,10 +18,28 @@ import { detectWorkflowLaunches } from "./canvas-interconnections.js";
  * prefers an enrichment-supplied sublabel over this default when present.
  */
 function classifyNode(name, entry, step) {
-    const continueTargets = step.transitions.filter((t) => t.kind === "continue");
-    const pause = step.transitions.find((t) => t.kind === "pause");
-    const hasTerminate = step.transitions.some((t) => t.kind === "terminate");
-    const hasFail = step.transitions.some((t) => t.kind === "fail");
+    return classifyStepKind({ name, entry, transitions: step.transitions });
+}
+/**
+ * The precedence table above, over nothing but a step's declared transition
+ * kinds — so a caller that has transitions from somewhere OTHER than a local
+ * `AgentManifest` classifies identically.
+ *
+ * Exported because the Studio's template preview projects the SAME graph from
+ * core's relayed `DefinitionTransitionDto[]` (see `core/template-catalog.ts`).
+ * That preview claims parity with the canvas, so it must not re-derive this:
+ * a second copy of the rule is a second answer to "what kind of node is this",
+ * and the two surfaces disagreeing is the exact class of bug the template work
+ * set out to remove. Collapsing the four kinds into a single `terminal` boolean
+ * (as the first cut of that preview did) renders a fail-only sink as a green
+ * success exit and a `continue`-plus-`terminate` gate as a terminal.
+ */
+export function classifyStepKind(input) {
+    const { name, entry, transitions } = input;
+    const continueTargets = transitions.filter((t) => t.kind === "continue");
+    const pause = transitions.find((t) => t.kind === "pause");
+    const hasTerminate = transitions.some((t) => t.kind === "terminate");
+    const hasFail = transitions.some((t) => t.kind === "fail");
     if (name === entry)
         return { kind: "entry", sublabel: "entry" };
     if (pause)
@@ -55,10 +73,26 @@ function edgesForStep(name, step) {
 export function graphFromManifest(manifest, warnings) {
     const nodes = Object.entries(manifest.steps).map(([name, step]) => {
         const { kind, sublabel } = classifyNode(name, manifest.entry, step);
-        return { id: name, kind, label: name, sublabel };
+        return {
+            id: name,
+            kind,
+            label: name,
+            sublabel,
+            description: step.description ?? "",
+            inputSchema: step.inputSchema ?? null,
+            capabilities: step.capabilities ?? [],
+            timeoutMs: step.timeoutMs ?? null,
+        };
     });
     const edges = Object.entries(manifest.steps).flatMap(([name, step]) => edgesForStep(name, step));
-    return { manifestName: manifest.name, entry: manifest.entry, nodes, edges, warnings };
+    return {
+        manifestName: manifest.name,
+        description: manifest.description ?? "",
+        entry: manifest.entry,
+        nodes,
+        edges,
+        warnings,
+    };
 }
 /**
  * Merges heuristically detected cross-workflow launches into the workflow's
@@ -91,6 +125,30 @@ export function mergeLaunchesIntoGraph(graph, launches) {
     }
     return { ...graph, nodes, edges };
 }
+/** Fills each step node's `capabilities` from statically-detected
+ *  `ctx.sapiom.*` calls, unless the manifest already declared them (authored
+ *  capabilities win). Pure — returns a new graph. */
+export function mergeCapabilitiesIntoGraph(graph, detected) {
+    if (detected.length === 0)
+        return graph;
+    const byStep = new Map();
+    for (const d of detected) {
+        if (!d.fromStepId)
+            continue;
+        const set = byStep.get(d.fromStepId) ?? new Set();
+        set.add(d.capability);
+        byStep.set(d.fromStepId, set);
+    }
+    return {
+        ...graph,
+        nodes: graph.nodes.map((n) => {
+            if ((n.capabilities?.length ?? 0) > 0)
+                return n; // authored capabilities win
+            const caps = byStep.get(n.id);
+            return caps ? { ...n, capabilities: [...caps].sort() } : n;
+        }),
+    };
+}
 /**
  * Extracts a workflow's step graph from its project directory, with detected
  * cross-workflow launches merged in as dashed nodes. Never throws: any
@@ -105,7 +163,11 @@ export async function extractWorkflowGraph(sourceDir) {
     if (!result.ok)
         return { ok: false, reason: result.reason };
     const graph = graphFromManifest(result.manifest, result.warnings);
-    const launches = await detectWorkflowLaunches(sourceDir, new Set(graph.nodes.map((n) => n.id)));
-    return { ok: true, graph: mergeLaunchesIntoGraph(graph, launches) };
+    const stepIds = new Set(graph.nodes.map((n) => n.id));
+    // One walk over the sources yields both — halves the I/O on the auto-render
+    // hot path (this runs on every workflow-source save).
+    const { launches, capabilities } = await scanWorkflowSources(sourceDir, stepIds);
+    const withLaunches = mergeLaunchesIntoGraph(graph, launches);
+    return { ok: true, graph: mergeCapabilitiesIntoGraph(withLaunches, capabilities) };
 }
 //# sourceMappingURL=canvas-graph.js.map