@sapiom/harness 0.1.6 → 0.2.0

package/dist/core/canvas-body.js

@@ -1,36 +1,134 @@
-import { renderGraphSvg } from "./canvas-svg.js";
+import { renderGraphSvg, usedKinds } from "./canvas-svg.js";
 function esc(s) {
     return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
-/** One workflow's full panel: title/badges header, step/entry stats, SVG
- *  diagram — with any enrichment merged in (summary line, node/edge
- *  annotations, a "stale" chip when its fingerprint no longer matches). */
-export function buildWorkflowPanelHtml(graph, meta, panelEnrichment) {
+const NODE_KIND_LABEL = {
+    entry: "entry / active step",
+    step: "step",
+    pause: "pause / waits for input",
+    "terminal-success": "terminal · success",
+    "terminal-warn": "terminal · escalation",
+    "launched-workflow": "launches another workflow",
+};
+const NODE_KIND_ORDER = [
+    "entry",
+    "step",
+    "pause",
+    "terminal-success",
+    "terminal-warn",
+    "launched-workflow",
+];
+/**
+ * The color/shape key for one diagram: only the node kinds that actually appear
+ * (in stable order), plus a cross-workflow row when the graph has cross edges.
+ * Returns "" when nothing is worth keying, so the panel omits the footer.
+ */
+export function buildLegendHtml(nodeKinds, edgeKinds) {
+    const items = NODE_KIND_ORDER.filter((k) => nodeKinds.has(k)).map((k) => `<span class="canvas-legend-item"><span class="canvas-legend-marker canvas-legend-marker--${k}"></span>${NODE_KIND_LABEL[k]}</span>`);
+    if (edgeKinds.has("cross")) {
+        items.push(`<span class="canvas-legend-item"><span class="canvas-legend-marker canvas-legend-marker--cross"></span>cross-workflow signal/handoff</span>`);
+    }
+    if (items.length === 0)
+        return "";
+    return `<footer class="canvas-legend">${items.join("")}</footer>`;
+}
+/**
+ * Serializes the graph (enrichment merged) into the JSON payload the app's
+ * Steps tab / inspector consumes, embedded as a `<script id="sapiom-graph">`
+ * data block that `bootCanvasGraph` (canvas-run-state.ts) posts to the parent.
+ *
+ * The projection mirrors `renderGraphSvg`'s merge EXACTLY so the Steps tab and
+ * the drawn board never disagree: `role` = the node's sublabel (enrichment
+ * override first), `description` = the enrichment hover text, and each edge's
+ * `label` is keyed `from->to`. Web-only fields the server graph doesn't carry
+ * (timeout / input schema / capabilities) are omitted — `parseCanvasGraph`
+ * defaults them, so the drill-down degrades to names + roles + branch facts.
+ *
+ * `<` is escaped to `<` so a label containing `</script>` can't break out
+ * of the JSON block; the result is still valid JSON.
+ */
+function buildGraphPayload(graph, enrichment) {
+    const payload = {
+        name: graph.manifestName,
+        entry: graph.entry,
+        nodes: graph.nodes.map((n) => {
+            const details = enrichment?.nodeDetails?.[n.id];
+            return {
+                id: n.id,
+                kind: n.kind,
+                label: n.label,
+                role: details?.sublabel ?? n.sublabel ?? "",
+                // Manifest-authored description (Option A) wins; enrichment is the
+                // legacy fallback (currently always undefined).
+                description: details?.description ?? n.description ?? "",
+                inputSchema: n.inputSchema ?? null,
+                capabilities: n.capabilities ?? [],
+                timeoutMs: n.timeoutMs ?? null,
+            };
+        }),
+        edges: graph.edges.map((e) => ({
+            from: e.from,
+            to: e.to,
+            kind: e.kind,
+            label: enrichment?.edgeLabels?.[`${e.from}->${e.to}`] ?? e.label ?? "",
+        })),
+        warnings: graph.warnings,
+    };
+    return JSON.stringify(payload).replace(/</g, "\\u003c");
+}
+/** The workflow-level overview the Canvas tab's bottom panel shows: a
+ *  deterministic stats line ("N steps · M exits · <entry> entry"), the shape
+ *  summary as the description, and the graph's validation notes. Embedded as a
+ *  JSON data block (read by bootCanvasOverview), the same pattern as the step
+ *  graph — everything here is derived from the graph, no LLM. */
+function buildOverviewPayload(graph, enrichment) {
+    const exits = graph.nodes.filter((n) => n.kind === "terminal-success" || n.kind === "terminal-warn").length;
+    const steps = graph.nodes.length - exits;
+    const entryLabel = graph.nodes.find((n) => n.id === graph.entry)?.label ?? graph.entry;
+    const parts = [`${steps} ${steps === 1 ? "step" : "steps"}`];
+    if (exits > 0)
+        parts.push(`${exits} ${exits === 1 ? "exit" : "exits"}`);
+    if (entryLabel)
+        parts.push(`${entryLabel} entry`);
+    const overview = {
+        // Human-authored workflow description from the manifest (Option A); "" when
+        // the workflow declares none (the shape summary still renders on the board).
+        description: graph.description ?? "",
+        stats: parts.join(" · "),
+        notes: enrichment?.notes ?? [],
+    };
+    // JSON in a <script> block: neutralize any "</script>"/"<" in derived text.
+    return JSON.stringify(overview).replace(/</g, "\\u003c");
+}
+/** One workflow's full panel: title/badges + summary header and the SVG
+ *  diagram, with the deterministic enrichment merged in (summary line and
+ *  node/edge annotations), plus the embedded step-graph payload the Steps tab
+ *  reads. */
+export function buildWorkflowPanelHtml(graph, meta, enrichment) {
     const badges = (meta.badges ?? [])
         .map((b) => `<span class="canvas-badge">${esc(b)}</span>`)
         .join("");
     const warningBadge = graph.warnings.length > 0
         ? `<span class="canvas-badge">${graph.warnings.length} warning${graph.warnings.length === 1 ? "" : "s"}</span>`
         : "";
-    const enrichment = panelEnrichment?.enrichment ?? null;
-    const staleBadge = panelEnrichment?.stale
-        ? `<span class="canvas-badge canvas-badge--stale">stale — Refresh</span>`
-        : "";
     const summary = enrichment?.summary ? `\n    <p class="canvas-subtitle">${esc(enrichment.summary)}</p>` : "";
+    const used = usedKinds(graph);
+    const legend = buildLegendHtml(used.nodeKinds, used.edgeKinds);
+    const legendHtml = legend ? `\n  ${legend}` : "";
+    const graphData = buildGraphPayload(graph, enrichment);
+    const overviewData = buildOverviewPayload(graph, enrichment);
     return `<section class="canvas-panel">
   <header class="canvas-header">
     <div class="canvas-title-row">
       <h1 class="canvas-title">${esc(meta.title)}</h1>
-      ${badges}${warningBadge}${staleBadge}
+      ${badges}${warningBadge}
     </div>${summary}
-    <div class="canvas-stats">
-      <div class="canvas-stat"><span class="canvas-stat-value">${graph.nodes.length}</span><span class="canvas-stat-label">steps</span></div>
-      <div class="canvas-stat"><span class="canvas-stat-value">${esc(graph.entry)}</span><span class="canvas-stat-label">entry</span></div>
-    </div>
   </header>
   <div class="canvas-diagram-panel">
 ${renderGraphSvg(graph, enrichment)}
-  </div>
+  </div>${legendHtml}
+  <script type="application/json" id="sapiom-graph">${graphData}</script>
+  <script type="application/json" id="sapiom-overview">${overviewData}</script>
 </section>`;
 }
 /** A degraded panel for a workflow whose graph couldn't be extracted — never
@@ -49,46 +147,10 @@ export function buildErrorPanelHtml(title, reason) {
   </div>
 </section>`;
 }
-const NODE_KIND_LABEL = {
-    entry: "entry / active step",
-    step: "step",
-    pause: "pause / waits for input",
-    "terminal-success": "terminal · success",
-    "terminal-warn": "terminal · escalation",
-    "launched-workflow": "launches another workflow",
-};
-const NODE_KIND_ORDER = [
-    "entry",
-    "step",
-    "pause",
-    "terminal-success",
-    "terminal-warn",
-    "launched-workflow",
-];
-/** Legend footer covering every node/edge kind actually used across every
- *  rendered panel (aggregate, not per-panel — matches the template's shape). */
-export function buildLegendHtml(nodeKinds, edgeKinds) {
-    const items = NODE_KIND_ORDER.filter((k) => nodeKinds.has(k)).map((k) => `<span class="canvas-legend-item"><span class="canvas-legend-marker canvas-legend-marker--${k}"></span>${NODE_KIND_LABEL[k]}</span>`);
-    if (edgeKinds.has("cross")) {
-        items.push(`<span class="canvas-legend-item"><span class="canvas-legend-marker canvas-legend-marker--cross"></span>cross-workflow signal/handoff</span>`);
-    }
-    return `<div class="canvas-legend">${items.join("")}</div>`;
-}
-/** Joins panels + a footer (enrichment notes/cross-workflow tie, legend,
- *  note) into the final `#canvas-root` body — the string
- *  `renderCanvasDocument()` wraps. */
+/** Joins the workflow panel(s) into the final `#canvas-root` body — the string
+ *  `renderCanvasDocument()` wraps. Each panel already carries its own legend
+ *  footer (see `buildWorkflowPanelHtml`); there is no document-level footer. */
 export function assembleCanvasBody(input) {
-    const parts = [...input.panels];
-    const notesHtml = input.notes && input.notes.length > 0
-        ? `\n  <ul class="canvas-notes">${input.notes.map((n) => `<li>${esc(n)}</li>`).join("")}</ul>`
-        : "";
-    const crossHtml = input.crossWorkflow
-        ? `\n  <p class="canvas-cross-workflow">${esc(input.crossWorkflow)}</p>`
-        : "";
-    parts.push(`<footer class="canvas-footer">${notesHtml}${crossHtml}
-${input.legend}
-  <p class="canvas-note">${esc(input.note)}</p>
-</footer>`);
-    return parts.join("\n\n");
+    return input.panels.join("\n\n");
 }
 //# sourceMappingURL=canvas-body.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"canvas-body.js","sourceRoot":"","sources":["../../src/core/canvas-body.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"canvas-body.js","sourceRoot":"","sources":["../../src/core/canvas-body.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5D,SAAS,GAAG,CAAC,CAAS;IACpB,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACtG,CAAC;AAOD,MAAM,eAAe,GAAmC;IACtD,KAAK,EAAE,qBAAqB;IAC5B,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,yBAAyB;IAChC,kBAAkB,EAAE,oBAAoB;IACxC,eAAe,EAAE,uBAAuB;IACxC,mBAAmB,EAAE,2BAA2B;CACjD,CAAC;AAEF,MAAM,eAAe,GAAqB;IACxC,OAAO;IACP,MAAM;IACN,OAAO;IACP,kBAAkB;IAClB,eAAe;IACf,mBAAmB;CACpB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,SAA8B,EAAE,SAA8B;IAC5F,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAC/D,CAAC,CAAC,EAAE,EAAE,CACJ,4FAA4F,CAAC,YAAY,eAAe,CAAC,CAAC,CAAC,SAAS,CACvI,CAAC;IACF,IAAI,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CACR,6IAA6I,CAC9I,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,OAAO,iCAAiC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC;AACpE,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAS,iBAAiB,CAAC,KAAkB,EAAE,UAAoC;IACjF,MAAM,OAAO,GAAG;QACd,IAAI,EAAE,KAAK,CAAC,YAAY;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC3B,MAAM,OAAO,GAAG,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAChD,OAAO;gBACL,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,IAAI,EAAE,OAAO,EAAE,QAAQ,IAAI,CAAC,CAAC,QAAQ,IAAI,EAAE;gBAC3C,mEAAmE;gBACnE,gDAAgD;gBAChD,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,CAAC,CAAC,WAAW,IAAI,EAAE;gBACxD,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,IAAI;gBAClC,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,EAAE;gBAClC,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,IAAI;aAC/B,CAAC;QACJ,CAAC,CAAC;QACF,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE;SACvE,CAAC,CAAC;QACH,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAC1D,CAAC;AAED;;;;iEAIiE;AACjE,SAAS,oBAAoB,CAAC,KAAkB,EAAE,UAAoC;IACpF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,kBAAkB,IAAI,CAAC,CAAC,IAAI,KAAK,eAAe,CACnE,CAAC,MAAM,CAAC;IACT,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;IACzC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC;IACvF,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7D,IAAI,KAAK,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACxE,IAAI,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,QAAQ,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG;QACf,4EAA4E;QAC5E,6EAA6E;QAC7E,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;QACpC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;QACxB,KAAK,EAAE,UAAU,EAAE,KAAK,IAAI,EAAE;KAC/B,CAAC;IACF,4EAA4E;IAC5E,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAC3D,CAAC;AAED;;;aAGa;AACb,MAAM,UAAU,sBAAsB,CACpC,KAAkB,EAClB,IAAuB,EACvB,UAAoC;IAEpC,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;SAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,8BAA8B,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;SACzD,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,MAAM,YAAY,GAChB,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QACvB,CAAC,CAAC,8BAA8B,KAAK,CAAC,QAAQ,CAAC,MAAM,WAAW,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,SAAS;QAC/G,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,OAAO,GAAG,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,oCAAoC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7G,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,MAAM,SAAS,GAAG,iBAAiB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACvD,MAAM,YAAY,GAAG,oBAAoB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAC7D,OAAO;;;iCAGwB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;QACxC,MAAM,GAAG,YAAY;YACjB,OAAO;;;EAGjB,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC;UACzB,UAAU;sDACkC,SAAS;yDACN,YAAY;WAC1D,CAAC;AACZ,CAAC;AAED;;qCAEqC;AACrC,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,MAAc;IAC/D,OAAO;;;iCAGwB,GAAG,CAAC,KAAK,CAAC;;;;;iFAKsC,GAAG,CAAC,MAAM,CAAC;;WAEjF,CAAC;AACZ,CAAC;AAED;;gFAEgF;AAChF,MAAM,UAAU,kBAAkB,CAAC,KAA2B;IAC5D,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC"}

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

@@ -0,0 +1,43 @@
+/**
+ * Deterministic canvas enrichment (no LLM, no user token, no file reads, no
+ * cache). Given the already-extracted CanvasGraph (core/canvas-graph.ts), it
+ * computes the same CanvasEnrichment shape the old AI task returned
+ * (core/canvas-enrichment.ts) — a summary line, footer notes, and a
+ * cross-workflow tie — entirely from the graph's own structure. Pure and
+ * total: the same graph in always yields the same enrichment out, and every
+ * string is kept within ENRICHMENT_LIMITS so the layout can't break.
+ *
+ * What it deliberately does NOT reproduce from the retired AI pass: free-prose
+ * per-step descriptions and condition-named edge labels, which needed a reading
+ * of the step bodies. The base render already conveys role (node border +
+ * classify-derived sublabel) and outcome (edge color), so their absence
+ * degrades to "less prose", never "less structure".
+ */
+import { type CanvasEnrichment } from "./canvas-enrichment.js";
+import type { CanvasGraph } from "./canvas-graph.js";
+/**
+ * A one-line description of the workflow's shape — step count, branch points,
+ * and terminal outcomes — the deterministic stand-in for the AI summary. Reads
+ * the same graph the diagram is drawn from, so it can never disagree with it.
+ */
+export declare function deriveSummary(graph: CanvasGraph): string;
+/**
+ * Footer notes: the graph's own validation warnings (unreachable steps, no path
+ * to a terminal) — facts worth surfacing that the diagram can't show on its own.
+ * Undefined when the graph is clean, capped to the contract's count/length.
+ */
+export declare function deriveNotes(graph: CanvasGraph): string[] | undefined;
+/**
+ * The cross-workflow tie, derived from the dashed launched-workflow nodes the
+ * extraction already merged in (core/canvas-graph.ts's mergeLaunchesIntoGraph,
+ * fed by the grep in core/canvas-interconnections.ts). Undefined when this
+ * workflow launches none.
+ */
+export declare function deriveCrossWorkflow(graph: CanvasGraph): string | undefined;
+/**
+ * Builds the deterministic enrichment for a graph. Only sets a field when it
+ * has real content, so an annotation-light but valid workflow renders its clean
+ * base — matching the "every field optional" contract the AI enrichment had.
+ */
+export declare function deriveEnrichment(graph: CanvasGraph): CanvasEnrichment;
+//# sourceMappingURL=canvas-derive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-derive.d.ts","sourceRoot":"","sources":["../../src/core/canvas-derive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,KAAK,EAAE,WAAW,EAA8B,MAAM,mBAAmB,CAAC;AAgBjF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAuBxD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,EAAE,GAAG,SAAS,CAMpE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAK1E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,gBAAgB,CAOrE"}

package/dist/core/canvas-derive.js

@@ -0,0 +1,95 @@
+/**
+ * Deterministic canvas enrichment (no LLM, no user token, no file reads, no
+ * cache). Given the already-extracted CanvasGraph (core/canvas-graph.ts), it
+ * computes the same CanvasEnrichment shape the old AI task returned
+ * (core/canvas-enrichment.ts) — a summary line, footer notes, and a
+ * cross-workflow tie — entirely from the graph's own structure. Pure and
+ * total: the same graph in always yields the same enrichment out, and every
+ * string is kept within ENRICHMENT_LIMITS so the layout can't break.
+ *
+ * What it deliberately does NOT reproduce from the retired AI pass: free-prose
+ * per-step descriptions and condition-named edge labels, which needed a reading
+ * of the step bodies. The base render already conveys role (node border +
+ * classify-derived sublabel) and outcome (edge color), so their absence
+ * degrades to "less prose", never "less structure".
+ */
+import { ENRICHMENT_LIMITS } from "./canvas-enrichment.js";
+/** Truncates to a hard cap with an ellipsis. The derivations below stay well
+ *  under their caps; this just makes the same guarantee the contract does. */
+function clamp(value, max) {
+    return value.length <= max ? value : `${value.slice(0, max - 1)}…`;
+}
+function countKind(nodes, kind) {
+    return nodes.filter((n) => n.kind === kind).length;
+}
+function plural(n, one, many = `${one}s`) {
+    return n === 1 ? one : many;
+}
+/**
+ * A one-line description of the workflow's shape — step count, branch points,
+ * and terminal outcomes — the deterministic stand-in for the AI summary. Reads
+ * the same graph the diagram is drawn from, so it can never disagree with it.
+ */
+export function deriveSummary(graph) {
+    // Real steps only — exclude the dashed launched-workflow placeholders.
+    const stepCount = graph.nodes.filter((n) => n.kind !== "launched-workflow").length;
+    // A branch point is a step that fans out to multiple successors; the graph
+    // marks exactly those edges "branching" (core/canvas-graph.ts's edgesForStep).
+    const branchPoints = new Set(graph.edges.filter((e) => e.kind === "branching").map((e) => e.from)).size;
+    const success = countKind(graph.nodes, "terminal-success");
+    const warn = countKind(graph.nodes, "terminal-warn");
+    const parts = [`${stepCount} ${plural(stepCount, "step")}`];
+    if (branchPoints > 0)
+        parts.push(`${branchPoints} ${plural(branchPoints, "branch point")}`);
+    const outcomes = [];
+    if (success > 0)
+        outcomes.push(`${success} success`);
+    if (warn > 0)
+        outcomes.push(`${warn} escalation`);
+    if (outcomes.length > 0) {
+        parts.push(`${outcomes.join(" / ")} ${plural(success + warn, "outcome")}`);
+    }
+    return clamp(parts.join(" · "), ENRICHMENT_LIMITS.summary);
+}
+/**
+ * Footer notes: the graph's own validation warnings (unreachable steps, no path
+ * to a terminal) — facts worth surfacing that the diagram can't show on its own.
+ * Undefined when the graph is clean, capped to the contract's count/length.
+ */
+export function deriveNotes(graph) {
+    if (graph.warnings.length === 0)
+        return undefined;
+    const notes = graph.warnings
+        .slice(0, ENRICHMENT_LIMITS.noteCount)
+        .map((w) => clamp(w, ENRICHMENT_LIMITS.note));
+    return notes.length > 0 ? notes : undefined;
+}
+/**
+ * The cross-workflow tie, derived from the dashed launched-workflow nodes the
+ * extraction already merged in (core/canvas-graph.ts's mergeLaunchesIntoGraph,
+ * fed by the grep in core/canvas-interconnections.ts). Undefined when this
+ * workflow launches none.
+ */
+export function deriveCrossWorkflow(graph) {
+    const launched = graph.nodes.filter((n) => n.kind === "launched-workflow").map((n) => n.label);
+    if (launched.length === 0)
+        return undefined;
+    const unique = [...new Set(launched)].sort();
+    return clamp(`Launches ${unique.join(", ")}.`, ENRICHMENT_LIMITS.crossWorkflow);
+}
+/**
+ * Builds the deterministic enrichment for a graph. Only sets a field when it
+ * has real content, so an annotation-light but valid workflow renders its clean
+ * base — matching the "every field optional" contract the AI enrichment had.
+ */
+export function deriveEnrichment(graph) {
+    const enrichment = { summary: deriveSummary(graph) };
+    const notes = deriveNotes(graph);
+    if (notes)
+        enrichment.notes = notes;
+    const crossWorkflow = deriveCrossWorkflow(graph);
+    if (crossWorkflow)
+        enrichment.crossWorkflow = crossWorkflow;
+    return enrichment;
+}
+//# sourceMappingURL=canvas-derive.js.map

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":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,iBAAiB,EAAyB,MAAM,wBAAwB,CAAC;AAGlF;8EAC8E;AAC9E,SAAS,KAAK,CAAC,KAAa,EAAE,GAAW;IACvC,OAAO,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;AACrE,CAAC;AAED,SAAS,SAAS,CAAC,KAA4B,EAAE,IAAoB;IACnE,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC;AACrD,CAAC;AAED,SAAS,MAAM,CAAC,CAAS,EAAE,GAAW,EAAE,IAAI,GAAG,GAAG,GAAG,GAAG;IACtD,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAkB;IAC9C,uEAAuE;IACvE,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC,MAAM,CAAC;IAEnF,2EAA2E;IAC3E,+EAA+E;IAC/E,MAAM,YAAY,GAAG,IAAI,GAAG,CAC1B,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CACrE,CAAC,IAAI,CAAC;IAEP,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;IAErD,MAAM,KAAK,GAAG,CAAC,GAAG,SAAS,IAAI,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5D,IAAI,YAAY,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,YAAY,IAAI,MAAM,CAAC,YAAY,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC;IAC5F,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,OAAO,GAAG,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,UAAU,CAAC,CAAC;IACrD,IAAI,IAAI,GAAG,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,aAAa,CAAC,CAAC;IAClD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,GAAG,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAkB;IAC5C,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAClD,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ;SACzB,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,SAAS,CAAC;SACrC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAkB;IACpD,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/F,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,OAAO,KAAK,CAAC,YAAY,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,aAAa,CAAC,CAAC;AAClF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAkB;IACjD,MAAM,UAAU,GAAqB,EAAE,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;IACvE,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,KAAK;QAAE,UAAU,CAAC,KAAK,GAAG,KAAK,CAAC;IACpC,MAAM,aAAa,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,aAAa;QAAE,UAAU,CAAC,aAAa,GAAG,aAAa,CAAC;IAC5D,OAAO,UAAU,CAAC;AACpB,CAAC"}

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"}