@cat-factory/contracts 0.75.0 → 0.77.0

package/dist/visual-pipeline.js

@@ -0,0 +1,51 @@
+// ---------------------------------------------------------------------------
+// Visual-pipeline gating (shared by the SPA surface + the backend run-start gate).
+//
+// A "visual" pipeline exercises a rendered UI — it either drives a real browser
+// against a running frontend (`tester-ui`) or parks for a human to review the
+// captured screenshots vs the task's reference designs (`visual-confirmation`).
+// Such a pipeline only makes sense where there IS a UI to exercise: a `frontend`
+// frame (it owns the app under test), or a frame a `frontend` frame links to (the
+// linked frontend is the UI a change to that service is validated through). The SPA
+// uses these predicates to surface visual pipelines only where they can run; the
+// backend gates a run start on the SAME rule so the guarantee holds server-side.
+// ---------------------------------------------------------------------------
+/**
+ * The agent kind that drives a real browser against a running frontend and captures a
+ * screenshot of each distinct view. The canonical slug also backs orchestration's
+ * `UI_TESTER_AGENT_KIND` (re-exported there); this package is the single source of truth.
+ */
+export const UI_TESTER_AGENT_KIND = 'tester-ui';
+/**
+ * The agent kind of the human visual-confirmation gate: it parks for a person to review the
+ * UI tester's screenshots against the task's uploaded reference designs. The canonical slug
+ * also backs orchestration's `VISUAL_CONFIRM_AGENT_KIND` (re-exported there).
+ */
+export const VISUAL_CONFIRM_AGENT_KIND = 'visual-confirmation';
+/** The visual step kinds: a pipeline carrying any of these is a "visual" pipeline. */
+export const VISUAL_STEP_KINDS = [UI_TESTER_AGENT_KIND, VISUAL_CONFIRM_AGENT_KIND];
+/** Whether a pipeline includes any visual step (`tester-ui` / `visual-confirmation`). */
+export function pipelineHasVisualStep(pipeline) {
+    return pipeline.agentKinds.some((kind) => kind === UI_TESTER_AGENT_KIND || kind === VISUAL_CONFIRM_AGENT_KIND);
+}
+/**
+ * Whether a visual pipeline may run on a task under `frame`. A visual step needs a UI to
+ * exercise, which exists when the enclosing frame is either:
+ *   - a `frontend` frame (it owns the app under test), or
+ *   - a non-frontend frame that some `frontend` frame BINDS as a backend service (a
+ *     frontend→service link in that frontend's `frontendConfig.backendBindings`) — the linked
+ *     frontend is the UI a change to this service is validated through.
+ * Every other frame (a service with no linked frontend, a `library`/`document` repo) has no UI,
+ * so a visual pipeline is refused. `blocks` is the workspace's block list, scanned once for the
+ * frontend→service links (never a per-frame point read).
+ */
+export function frameAllowsVisualPipeline(frame, blocks) {
+    if (!frame)
+        return false;
+    if (frame.type === 'frontend')
+        return true;
+    return blocks.some((b) => b.level === 'frame' &&
+        b.type === 'frontend' &&
+        (b.frontendConfig?.backendBindings ?? []).some((bind) => bind.source.kind === 'service' && bind.source.serviceBlockId === frame.id));
+}
+//# sourceMappingURL=visual-pipeline.js.map

package/dist/visual-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-pipeline.js","sourceRoot":"","sources":["../src/visual-pipeline.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,mFAAmF;AACnF,EAAE;AACF,gFAAgF;AAChF,8EAA8E;AAC9E,gFAAgF;AAChF,iFAAiF;AACjF,kFAAkF;AAClF,oFAAoF;AACpF,iFAAiF;AACjF,iFAAiF;AACjF,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,WAAW,CAAA;AAE/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,qBAAqB,CAAA;AAE9D,sFAAsF;AACtF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,oBAAoB,EAAE,yBAAyB,CAAU,CAAA;AAE3F,yFAAyF;AACzF,MAAM,UAAU,qBAAqB,CAAC,QAAsC;IAC1E,OAAO,QAAQ,CAAC,UAAU,CAAC,IAAI,CAC7B,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,oBAAoB,IAAI,IAAI,KAAK,yBAAyB,CAC9E,CAAA;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAoD,EACpD,MAAmE;IAEnE,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IACxB,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,IAAI,CAAA;IAC1C,OAAO,MAAM,CAAC,IAAI,CAChB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,KAAK,KAAK,OAAO;QACnB,CAAC,CAAC,IAAI,KAAK,UAAU;QACrB,CAAC,CAAC,CAAC,cAAc,EAAE,eAAe,IAAI,EAAE,CAAC,CAAC,IAAI,CAC5C,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,KAAK,KAAK,CAAC,EAAE,CACpF,CACJ,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/contracts",
-  "version": "0.75.0",
+  "version": "0.77.0",
   "description": "Valibot wire contract shared between the Agent Architecture Board frontend and backend.",
   "repository": {
     "type": "git",