pilotswarm-sdk 0.5.44 → 0.5.46

package/dist/canvas-support.js

@@ -0,0 +1,79 @@
+/**
+ * Canvas helpers shared by the session bridge (session-proxy.ts) and the app
+ * catalog (canvas-app-catalog.ts). Kept in their own module so the catalog
+ * can be exercised without importing the whole bridge, and so the bridge and
+ * the catalog can never disagree about slot names or revision derivation.
+ *
+ * The session canvas: one reserved artifact per session slot, drawn by the
+ * agent with draw_canvas and rendered live in the portal. The revision is
+ * derived from the durable session.canvas_updated event log, not a counter
+ * column — see docs/proposals/session-canvas.md.
+ */
+export const CANVAS_ARTIFACT_FILENAME = "canvas.html";
+/** Slot 1 keeps the historical name; 2-5 are canvas2.html .. canvas5.html. */
+export function canvasArtifactFilename(slot) {
+    return slot <= 1 ? CANVAS_ARTIFACT_FILENAME : `canvas${slot}.html`;
+}
+/** 1-5, defaulting absent to 1. Returns null for anything else. */
+export function normalizeCanvasSlot(value) {
+    if (value === undefined || value === null || value === "")
+        return 1;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 1 || n > 5)
+        return null;
+    return n;
+}
+/** Event rows predate slots; a missing slot means slot 1. */
+export function eventSlot(row) {
+    const n = Number(row?.data?.slot);
+    return Number.isInteger(n) && n >= 1 && n <= 5 ? n : 1;
+}
+/**
+ * Latest canvas draw's full data (rev + armed contract) from the durable
+ * event log — the single authority. Reads a bounded window rather than
+ * exactly one row and takes the max of the VALID revs it finds, so one
+ * garbage event (rev missing, NaN, negative — injectable via
+ * send_session_event, which validates nothing) cannot reset the sequence.
+ *
+ * No empty-coerce on failure: a transient read error that reads as "no
+ * canvas" would mint rev 1 over a live rev-12 canvas. Callers route the
+ * throw to a structured { error }.
+ *
+ * Window 30, not 5: five interleaved slots can push one slot's latest draw
+ * well past a five-event window. The session_canvases table is the fast
+ * path; this scan is the durable fallback.
+ */
+export async function latestCanvasEventData(catalog, sessionId, slot = 1) {
+    const rows = await catalog.getSessionEventsBefore(sessionId, Number.MAX_SAFE_INTEGER, 30, ["session.canvas_updated"]);
+    let latest = { rev: 0 };
+    for (const row of rows || []) {
+        if (eventSlot(row) !== slot)
+            continue;
+        const rev = Number(row?.data?.rev);
+        if (Number.isFinite(rev) && Number.isInteger(rev) && rev > latest.rev) {
+            latest = { rev, responseContract: row?.data?.responseContract };
+        }
+    }
+    return latest;
+}
+/** The current canvas revision: table first (migration 0045), event scan as the durable fallback. */
+export async function latestCanvasRev(catalog, sessionId, slot = 1) {
+    try {
+        const rows = await catalog.getSessionCanvases?.(sessionId);
+        const hit = (rows || []).find((r) => Number(r.slot) === slot);
+        if (hit && Number(hit.latestRev) > 0)
+            return Number(hit.latestRev);
+    }
+    catch { /* fall through to the event scan */ }
+    const rows = await catalog.getSessionEventsBefore(sessionId, Number.MAX_SAFE_INTEGER, 30, ["session.canvas_updated"]);
+    let latest = 0;
+    for (const row of rows || []) {
+        if (eventSlot(row) !== slot)
+            continue;
+        const rev = Number(row?.data?.rev);
+        if (Number.isFinite(rev) && rev > latest && Number.isInteger(rev))
+            latest = rev;
+    }
+    return latest;
+}
+//# sourceMappingURL=canvas-support.js.map

package/dist/canvas-support.js.map

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

package/dist/cms-migrations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cms-migrations.d.ts","sourceRoot":"","sources":["../src/cms-migrations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,CAyT/D"}
+{"version":3,"file":"cms-migrations.d.ts","sourceRoot":"","sources":["../src/cms-migrations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,CAmU/D"}