@ikenga/contract 0.7.0 → 0.9.1

package/dist/canvas/use-drag-snap.js

@@ -0,0 +1,73 @@
+// Scale-aware grid-snap drag for the <Canvas> primitive.
+//
+// Owns the in-flight drag gesture (which item, where it started) and the
+// pointer math that moves it: cursor delta is divided by the current viewport
+// scale (so a 10px screen move at scale 0.5 becomes a 20px canvas move, and at
+// scale 2.0 a 5px canvas move), then snapped to the `gridSnap` lattice.
+//
+//   nx = round((startPos.x + dx / scale) / gridSnap) * gridSnap
+//
+// Does NOT own `layout` — it reads the current placement to seed the gesture
+// and emits the moved layout through `onLayoutChange`. The parent stays the
+// source of truth.
+//
+// Extracted verbatim (behavior-preserving) from shell home.tsx's canvas block.
+import { useCallback, useEffect, useRef } from 'react';
+export function useDragSnap(args) {
+    const { layout, gridSnap, scale, onLayoutChange, stageRef } = args;
+    const dragState = useRef(null);
+    // Keep the freshest layout/scale/snap reachable from the global listener
+    // without re-subscribing it on every render.
+    const layoutRef = useRef(layout);
+    layoutRef.current = layout;
+    const scaleRef = useRef(scale);
+    scaleRef.current = scale;
+    const gridSnapRef = useRef(gridSnap);
+    gridSnapRef.current = gridSnap;
+    const onLayoutChangeRef = useRef(onLayoutChange);
+    onLayoutChangeRef.current = onLayoutChange;
+    const beginDrag = useCallback((id, clientX, clientY) => {
+        const w = layoutRef.current[id];
+        if (!w)
+            return;
+        dragState.current = {
+            id,
+            startMouse: { x: clientX, y: clientY },
+            startPos: { x: w.x, y: w.y },
+        };
+        stageRef.current?.classList.add('is-dragging');
+    }, [stageRef]);
+    const isDragging = useCallback(() => dragState.current != null, []);
+    useEffect(() => {
+        const onMove = (e) => {
+            if (!dragState.current)
+                return;
+            const s = scaleRef.current || 1;
+            const snap = gridSnapRef.current;
+            const dx = e.clientX - dragState.current.startMouse.x;
+            const dy = e.clientY - dragState.current.startMouse.y;
+            const nx = Math.round((dragState.current.startPos.x + dx / s) / snap) * snap;
+            const ny = Math.round((dragState.current.startPos.y + dy / s) / snap) * snap;
+            const id = dragState.current.id;
+            const cur = layoutRef.current;
+            const prev = cur[id];
+            if (!prev || (prev.x === nx && prev.y === ny))
+                return;
+            onLayoutChangeRef.current?.({ ...cur, [id]: { ...prev, x: nx, y: ny } });
+        };
+        const onUp = () => {
+            if (dragState.current) {
+                dragState.current = null;
+                stageRef.current?.classList.remove('is-dragging');
+            }
+        };
+        window.addEventListener('mousemove', onMove);
+        window.addEventListener('mouseup', onUp);
+        return () => {
+            window.removeEventListener('mousemove', onMove);
+            window.removeEventListener('mouseup', onUp);
+        };
+    }, [stageRef]);
+    return { dragState, beginDrag, isDragging };
+}
+//# sourceMappingURL=use-drag-snap.js.map

package/dist/canvas/use-drag-snap.js.map

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

package/dist/canvas/use-pan-zoom.d.ts

@@ -0,0 +1,32 @@
+import type { ItemId, Placement, Viewport } from './types.js';
+export interface UsePanZoomArgs {
+    /** Controlled layout (id → placement) the auto-fit bounding box reads. */
+    layout: Record<ItemId, Placement>;
+    /** Controlled edit-mode flag — auto-fit reserves palette width when true. */
+    editMode: boolean;
+    /** Re-fit on window resize. Default true. */
+    autoFitOnResize?: boolean;
+    /** Notified whenever the viewport pan/scale changes (controlled mirror). */
+    onViewportChange?: (viewport: Viewport) => void;
+    /** Escape exits edit mode → parent owns the state flip. */
+    onEditModeChange?: (editMode: boolean) => void;
+    /** Escape clears selection. */
+    onSelectionChange?: (selectedId: ItemId | null) => void;
+}
+export interface UsePanZoom {
+    /** Live viewport (x/y/scale). Mirrors `pan` in the original home code. */
+    pan: Viewport;
+    setPan: React.Dispatch<React.SetStateAction<Viewport>>;
+    /** Imperative re-fit. `animate=false` snaps without the transition. */
+    autoFit: (animate?: boolean) => void;
+    canvasRef: React.RefObject<HTMLDivElement | null>;
+    stageRef: React.RefObject<HTMLDivElement | null>;
+    /** True while Space is held — drag/pan branch reads this. */
+    spaceDown: React.MutableRefObject<boolean>;
+    /** Begin a pan gesture from a mousedown at screen (clientX, clientY). */
+    beginPan: (clientX: number, clientY: number) => void;
+    /** Is a pan gesture in flight? */
+    isPanning: () => boolean;
+}
+export declare function usePanZoom(args: UsePanZoomArgs): UsePanZoom;
+//# sourceMappingURL=use-pan-zoom.d.ts.map

package/dist/canvas/use-pan-zoom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-pan-zoom.d.ts","sourceRoot":"","sources":["../../src/canvas/use-pan-zoom.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE9D,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClC,6EAA6E;IAC7E,QAAQ,EAAE,OAAO,CAAC;IAClB,6CAA6C;IAC7C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IAChD,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,+BAA+B;IAC/B,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACzD;AAED,MAAM,WAAW,UAAU;IACzB,0EAA0E;IAC1E,GAAG,EAAE,QAAQ,CAAC;IACd,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvD,uEAAuE;IACvE,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAClD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACjD,6DAA6D;IAC7D,SAAS,EAAE,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC3C,yEAAyE;IACzE,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,kCAAkC;IAClC,SAAS,EAAE,MAAM,OAAO,CAAC;CAC1B;AAID,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,CAoK3D"}

package/dist/canvas/use-pan-zoom.js

@@ -0,0 +1,161 @@
+// Pan / zoom / auto-fit for the <Canvas> primitive.
+//
+// Owns the viewport pan offset + scale, the imperative auto-fit math, the
+// pan gesture (Space-drag / middle-mouse / empty-canvas drag), and the
+// Space/Escape keyboard affordances + window-resize re-fit. It deliberately
+// does NOT own `layout`, `selectedId`, or `editMode` — those stay parent-held
+// and are threaded in as values so the auto-fit closure can read them.
+//
+// Extracted verbatim (behavior-preserving) from shell home.tsx's canvas block.
+import { useCallback, useEffect, useRef, useState } from 'react';
+const RESERVED_PALETTE_WIDTH = 320;
+export function usePanZoom(args) {
+    const { layout, editMode, autoFitOnResize = true, onViewportChange, onEditModeChange, onSelectionChange, } = args;
+    const [pan, setPan] = useState({ x: 0, y: 0, scale: 1 });
+    const canvasRef = useRef(null);
+    const stageRef = useRef(null);
+    const spaceDown = useRef(false);
+    const panStart = useRef(null);
+    // Latest pan reachable synchronously (for beginPan's offset seed) without
+    // adding `pan` to the gesture callbacks' deps.
+    const panRef = useRef(pan);
+    panRef.current = pan;
+    // Mirror viewport changes to the controlled parent in an effect (never
+    // inside a setState updater — that would setState-during-render the parent
+    // and trip React's "Cannot update a component while rendering a different
+    // component" warning). The ref skips the initial mount so the parent isn't
+    // notified of the default {0,0,1} before any real fit.
+    const viewportCbRef = useRef(onViewportChange);
+    viewportCbRef.current = onViewportChange;
+    const mountedViewport = useRef(false);
+    useEffect(() => {
+        if (!mountedViewport.current) {
+            mountedViewport.current = true;
+            return;
+        }
+        viewportCbRef.current?.(pan);
+    }, [pan]);
+    // Auto-fit: scale the bounding box of all items into the visible area,
+    // scaling down only (never up). Reserves the palette gutter in edit mode.
+    // Threads `layout` + `editMode` as deps so the closure never goes stale.
+    const autoFit = useCallback((animate = true) => {
+        const canvas = canvasRef.current;
+        const items = Object.values(layout);
+        if (!canvas || !items.length)
+            return;
+        let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;
+        for (const w of items) {
+            if (w.x < minX)
+                minX = w.x;
+            if (w.y < minY)
+                minY = w.y;
+            if (w.x + w.w > maxX)
+                maxX = w.x + w.w;
+            if (w.y + w.h > maxY)
+                maxY = w.y + w.h;
+        }
+        const cw = canvas.clientWidth - (editMode ? RESERVED_PALETTE_WIDTH : 0) - 40;
+        const ch = canvas.clientHeight - 44 - 32;
+        const bw = maxX - minX;
+        const bh = maxY - minY;
+        const sx = bw > 0 ? cw / bw : 1;
+        const sy = bh > 0 ? ch / bh : 1;
+        const scale = Math.min(1, sx, sy);
+        const offX = Math.round((cw + 40 - bw * scale) / 2 - minX * scale);
+        const offY = Math.round((ch + 32 - bh * scale) / 2 - minY * scale + 22);
+        setPan({ x: offX, y: offY, scale });
+        if (stageRef.current)
+            stageRef.current.classList.toggle('is-dragging', !animate);
+    }, [layout, editMode, setPan]);
+    // Initial fit + window-resize re-fit. Empty dep array on purpose — autoFit
+    // is read through the ref-stable callback, matching the original effect.
+    useEffect(() => {
+        requestAnimationFrame(() => autoFit(false));
+        if (!autoFitOnResize)
+            return;
+        const onResize = () => autoFit(true);
+        window.addEventListener('resize', onResize);
+        return () => window.removeEventListener('resize', onResize);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    // Re-fit whenever edit mode toggles (palette gutter changes the fit box).
+    useEffect(() => {
+        autoFit(true);
+    }, [editMode, autoFit]);
+    // Keyboard — Escape exits edit, Space arms the pan-grab cursor.
+    useEffect(() => {
+        const down = (e) => {
+            if (e.key === 'Escape' && editMode) {
+                onEditModeChange?.(false);
+                onSelectionChange?.(null);
+            }
+            if (e.code === 'Space' &&
+                !e.repeat &&
+                document.activeElement === document.body &&
+                canvasRef.current) {
+                spaceDown.current = true;
+                canvasRef.current.style.cursor = 'grab';
+                e.preventDefault();
+            }
+        };
+        const up = (e) => {
+            if (e.code === 'Space') {
+                spaceDown.current = false;
+                if (canvasRef.current)
+                    canvasRef.current.style.cursor = '';
+            }
+        };
+        window.addEventListener('keydown', down);
+        window.addEventListener('keyup', up);
+        return () => {
+            window.removeEventListener('keydown', down);
+            window.removeEventListener('keyup', up);
+        };
+    }, [editMode, onEditModeChange, onSelectionChange]);
+    const beginPan = useCallback((clientX, clientY) => {
+        const p = panRef.current;
+        panStart.current = { x: clientX - p.x, y: clientY - p.y };
+        stageRef.current?.classList.add('is-dragging');
+        if (canvasRef.current)
+            canvasRef.current.style.cursor = 'grabbing';
+    }, []);
+    const isPanning = useCallback(() => panStart.current != null, []);
+    // Global pan move/up. Drag (item) move/up lives in use-drag-snap so this
+    // effect only owns the pan branch + its own cleanup.
+    useEffect(() => {
+        const onMove = (e) => {
+            if (panStart.current) {
+                setPan((p) => ({
+                    ...p,
+                    x: e.clientX - panStart.current.x,
+                    y: e.clientY - panStart.current.y,
+                }));
+            }
+        };
+        const onUp = () => {
+            if (panStart.current) {
+                panStart.current = null;
+                stageRef.current?.classList.remove('is-dragging');
+                if (canvasRef.current)
+                    canvasRef.current.style.cursor = spaceDown.current ? 'grab' : '';
+            }
+        };
+        window.addEventListener('mousemove', onMove);
+        window.addEventListener('mouseup', onUp);
+        return () => {
+            window.removeEventListener('mousemove', onMove);
+            window.removeEventListener('mouseup', onUp);
+        };
+    }, [setPan]);
+    return {
+        pan,
+        setPan,
+        autoFit,
+        canvasRef,
+        stageRef,
+        spaceDown,
+        beginPan,
+        isPanning,
+    };
+}
+//# sourceMappingURL=use-pan-zoom.js.map

package/dist/canvas/use-pan-zoom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-pan-zoom.js","sourceRoot":"","sources":["../../src/canvas/use-pan-zoom.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,EAAE;AACF,0EAA0E;AAC1E,uEAAuE;AACvE,4EAA4E;AAC5E,8EAA8E;AAC9E,uEAAuE;AACvE,EAAE;AACF,+EAA+E;AAE/E,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAkCjE,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAEnC,MAAM,UAAU,UAAU,CAAC,IAAoB;IAC7C,MAAM,EACJ,MAAM,EACN,QAAQ,EACR,eAAe,GAAG,IAAI,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,GAClB,GAAG,IAAI,CAAC;IAET,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAW,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAEnE,MAAM,SAAS,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,MAAM,CAAkC,IAAI,CAAC,CAAC;IAC/D,0EAA0E;IAC1E,+CAA+C;IAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC;IAErB,uEAAuE;IACvE,2EAA2E;IAC3E,0EAA0E;IAC1E,2EAA2E;IAC3E,uDAAuD;IACvD,MAAM,aAAa,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC/C,aAAa,CAAC,OAAO,GAAG,gBAAgB,CAAC;IACzC,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACtC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;YAC7B,eAAe,CAAC,OAAO,GAAG,IAAI,CAAC;YAC/B,OAAO;QACT,CAAC;QACD,aAAa,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEV,uEAAuE;IACvE,0EAA0E;IAC1E,yEAAyE;IACzE,MAAM,OAAO,GAAG,WAAW,CACzB,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE;QACjB,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC;QACjC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,OAAO;QACrC,IAAI,IAAI,GAAG,QAAQ,EACjB,IAAI,GAAG,QAAQ,EACf,IAAI,GAAG,CAAC,QAAQ,EAChB,IAAI,GAAG,CAAC,QAAQ,CAAC;QACnB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI;gBAAE,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI;gBAAE,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI;gBAAE,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACvC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI;gBAAE,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC;QACD,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QAC7E,MAAM,EAAE,GAAG,MAAM,CAAC,YAAY,GAAG,EAAE,GAAG,EAAE,CAAC;QACzC,MAAM,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;QACvB,MAAM,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;QACvB,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC;QACxE,MAAM,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACpC,IAAI,QAAQ,CAAC,OAAO;YAAE,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,CAAC;IACnF,CAAC,EACD,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAC3B,CAAC;IAEF,2EAA2E;IAC3E,yEAAyE;IACzE,SAAS,CAAC,GAAG,EAAE;QACb,qBAAqB,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5C,IAAI,CAAC,eAAe;YAAE,OAAO;QAC7B,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC5C,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC5D,uDAAuD;IACzD,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,0EAA0E;IAC1E,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAExB,gEAAgE;IAChE,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,IAAI,GAAG,CAAC,CAAgB,EAAE,EAAE;YAChC,IAAI,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,QAAQ,EAAE,CAAC;gBACnC,gBAAgB,EAAE,CAAC,KAAK,CAAC,CAAC;gBAC1B,iBAAiB,EAAE,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC;YACD,IACE,CAAC,CAAC,IAAI,KAAK,OAAO;gBAClB,CAAC,CAAC,CAAC,MAAM;gBACT,QAAQ,CAAC,aAAa,KAAK,QAAQ,CAAC,IAAI;gBACxC,SAAS,CAAC,OAAO,EACjB,CAAC;gBACD,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;gBACzB,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;gBACxC,CAAC,CAAC,cAAc,EAAE,CAAC;YACrB,CAAC;QACH,CAAC,CAAC;QACF,MAAM,EAAE,GAAG,CAAC,CAAgB,EAAE,EAAE;YAC9B,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACvB,SAAS,CAAC,OAAO,GAAG,KAAK,CAAC;gBAC1B,IAAI,SAAS,CAAC,OAAO;oBAAE,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC;YAC7D,CAAC;QACH,CAAC,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACrC,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC5C,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC1C,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAEpD,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,OAAe,EAAE,OAAe,EAAE,EAAE;QAChE,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;QACzB,QAAQ,CAAC,OAAO,GAAG,EAAE,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC/C,IAAI,SAAS,CAAC,OAAO;YAAE,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC;IACrE,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IAElE,yEAAyE;IACzE,qDAAqD;IACrD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,CAAC,CAAa,EAAE,EAAE;YAC/B,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACrB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACb,GAAG,CAAC;oBACJ,CAAC,EAAE,CAAC,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAQ,CAAC,CAAC;oBAClC,CAAC,EAAE,CAAC,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAQ,CAAC,CAAC;iBACnC,CAAC,CAAC,CAAC;YACN,CAAC;QACH,CAAC,CAAC;QACF,MAAM,IAAI,GAAG,GAAG,EAAE;YAChB,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACrB,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;gBACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;gBAClD,IAAI,SAAS,CAAC,OAAO;oBAAE,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1F,CAAC;QACH,CAAC,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACzC,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,mBAAmB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAChD,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC9C,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,OAAO;QACL,GAAG;QACH,MAAM;QACN,OAAO;QACP,SAAS;QACT,QAAQ;QACR,SAAS;QACT,QAAQ;QACR,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/host-verbs.d.ts

@@ -0,0 +1,194 @@
+/**
+ * Host-bridge verb shapes for the agent-ops pkg — the **G-TRIGGER** freeze gate.
+ *
+ * Unlike the kernel RPC methods in `rpc.ts`, `host.*` verbs are dispatched
+ * FE-side in the iframe host (`shell/src/components/pkg/pkg-iframe-host.tsx`)
+ * and invoked from the iframe via `app.callServerTool({ name, arguments })`,
+ * returning their payload on `res.structuredContent`. These types are the
+ * shared contract the shell (WP-09) produces and the agent-ops pkg
+ * (WP-08 reads, WP-12 writes) consumes. Frozen so changing them after both
+ * sides exist forces a cross-repo re-sync.
+ *
+ * Gated by `capabilities.agentOps` (see `AgentOpsCapabilitySchema`).
+ */
+/** Typed failure codes a host.agentOps verb returns on the `{ ok: false }`
+ *  branch, so the pkg UI can render a specific state rather than a raw string.
+ *  - `daemon_down`   — `~/.agent-ops/daemon.lock` missing or daemon not alive
+ *  - `unauthorized`  — the daemon rejected the token (401) — should not happen
+ *                      in normal operation (the shell reads the live lock)
+ *  - `not_found`     — no job with that id (daemon 404 / config miss)
+ *  - `disabled`      — job is disabled, cannot run-now (daemon 409)
+ *  - `forbidden`     — daemon rejected host/origin/method (403/405)
+ *  - `io_error`      — lock/config file unreadable or unwritable
+ *  - `error`         — any other failure */
+export type AgentOpsErrorCode = 'daemon_down' | 'unauthorized' | 'not_found' | 'disabled' | 'forbidden' | 'io_error' | 'error';
+export interface AgentOpsErrorResult {
+    ok: false;
+    code: AgentOpsErrorCode;
+    /** HTTP status from the daemon when applicable, else null. */
+    status: number | null;
+    error: string;
+}
+/** `host.agentOps.runNow({ jobId })` — fire an out-of-schedule run via the
+ *  daemon's localhost trigger endpoint. The shell reads the 0600
+ *  `~/.agent-ops/daemon.lock` for `{ port, secret }` and POSTs
+ *  `127.0.0.1:<port>/jobs/<jobId>/trigger` with BOTH required headers
+ *  (`x-agent-ops-token: <secret>` + `x-agent-ops-trigger: 1`). */
+export interface AgentOpsRunNowArgs {
+    jobId: string;
+}
+export type AgentOpsRunNowResult = {
+    ok: true;
+    status: number;
+    message: string;
+} | AgentOpsErrorResult;
+/** `host.agentOps.setEnabled({ jobId, enabled })` — flip a job's `enabled`
+ *  flag in the project-scoped config (`~/.atelier/skill-agent-ops/jobs.json`).
+ *  The daemon honors it on next config load. Does NOT touch the executor. */
+export interface AgentOpsSetEnabledArgs {
+    jobId: string;
+    enabled: boolean;
+}
+export type AgentOpsSetEnabledResult = {
+    ok: true;
+    jobId: string;
+    enabled: boolean;
+} | AgentOpsErrorResult;
+/** The editable job fields the CRUD form sends to `host.agentOps.upsertJob`.
+ *  The host fills JobDefinition defaults (schedule_dialect, timeout_ms, retries,
+ *  backoff, concurrency_policy) for any omitted field; the daemon's Zod loader
+ *  is the final validation backstop on next config load. */
+export interface AgentOpsJobInput {
+    id: string;
+    label: string;
+    schedule: string;
+    timezone?: string;
+    enabled?: boolean;
+    mode?: 'agent' | 'script';
+    command: string;
+    model?: string | null;
+    agent?: string | null;
+    schedule_dialect?: '5f' | '6f';
+    timeout_ms?: number;
+}
+/** `host.agentOps.upsertJob({ job })` — create-or-update a job in the
+ *  project-scoped config (atomic rewrite; replace by id if present, else
+ *  append). The daemon honors it on next config load. Validating-only write —
+ *  the shell does NOT run the job, never becomes the executor. */
+export interface AgentOpsUpsertJobArgs {
+    job: AgentOpsJobInput;
+}
+export type AgentOpsUpsertJobResult = {
+    ok: true;
+    jobId: string;
+    created: boolean;
+} | AgentOpsErrorResult;
+/** `host.agentOps.deleteJob({ jobId })` — remove a job from the project-scoped
+ *  config (atomic rewrite). The daemon stops scheduling it on next load. */
+export interface AgentOpsDeleteJobArgs {
+    jobId: string;
+}
+export type AgentOpsDeleteJobResult = {
+    ok: true;
+    jobId: string;
+} | AgentOpsErrorResult;
+/** `host.agentOps.tailRun({ jobId, offset? })` — read the live (or last-completed)
+ *  run output for a job by byte-range, for the pkg's Live-output view.
+ *
+ *  Unlike the other agent-ops verbs (which reach the daemon's localhost endpoint
+ *  or rewrite its config), tailRun is a pure **filesystem read on the shell's own
+ *  event loop**: it opens the per-job marker (`~/.agent-ops/runs/<slug>.marker.json`)
+ *  to learn the current run's `tailPath` + `status` + `pid`, then reads that tail
+ *  file from `offset` forward (capped per call). Because it never touches the
+ *  daemon, the daemon being blocked mid-run (synchronously executing a job) is
+ *  irrelevant — the shell still streams whatever the child has teed to disk so far.
+ *
+ *  Mechanism is **script-mode only**: the daemon tees a script job's combined
+ *  stdout/stderr to the tail file as it runs. Agent jobs (`claude -p`) stay
+ *  byte-for-byte unchanged and have no tail file, so tailRun returns an empty
+ *  chunk with `mode:'agent'` (the pkg renders 'live output not available for
+ *  agent jobs' + a spinner driven off the marker's `status`).
+ *
+ *  Polling loop: call with `offset:0` first, then feed the returned `nextOffset`
+ *  back on each poll. `eof` true means the reader caught up to the current end of
+ *  file; keep polling while `running` is true. After a run completes the marker
+ *  still points at the final tail, so `running:false` STILL returns the final
+ *  chunk for scrollback — the view shows the completed output, not an empty pane.
+ *
+ *  - `running`     — `status === 'running'` AND the marker's `pid` is alive.
+ *  - `status`      — the marker's `status` (`'running' | 'done'`), or `null` when
+ *                    no marker exists yet (job has never produced a run).
+ *  - `startedAtMs` — the run's start epoch-ms from the marker, else `null`.
+ *  - `mode`        — `'script'` (has a tail) / `'agent'` (no tail) / `null` (no marker).
+ *  - `chunk`       — lossy-utf8 decode of the bytes read this call (may be empty).
+ *  - `nextOffset`  — `offset + bytesRead`; pass back on the next poll.
+ *  - `eof`         — reached the current end of the tail file.
+ *
+ *  Best-effort + non-throwing on the shell side: a missing marker / missing tail /
+ *  unreadable file resolves to `{ ok:true, chunk:'', eof:true, ... }` rather than
+ *  an error, so the view degrades to 'no output yet'. Only a path-escape attempt
+ *  (marker.tailPath pointing outside `~/.agent-ops/runs/`) maps to an
+ *  `{ ok:false, code:'io_error' }`. */
+export interface AgentOpsTailRunArgs {
+    jobId: string;
+    /** Byte offset into the tail file to read from. Defaults to 0. */
+    offset?: number;
+}
+export type AgentOpsTailRunResult = {
+    ok: true;
+    running: boolean;
+    status: 'running' | 'done' | null;
+    startedAtMs: number | null;
+    mode: 'agent' | 'script' | null;
+    chunk: string;
+    nextOffset: number;
+    eof: boolean;
+} | AgentOpsErrorResult;
+/** A merged config+state row as returned by `host.agentOps.listJobs`. Config
+ *  fields come from `~/.atelier/skill-agent-ops/jobs.json` (a JobDefinition);
+ *  `state` is that job's entry in `.company/cron/jobs-state.json` (or null if
+ *  it has never run). Field casing matches the on-disk files (camelCase state);
+ *  the pkg's data layer (WP-08) maps this into the snake_case G-VIEW. */
+export interface AgentOpsRawJobState {
+    nextRunAtMs: number | null;
+    lastRunAtMs: number | null;
+    lastStatus: string | null;
+    consecutiveErrors: number;
+    lastDurationMs: number | null;
+    totalCostUsd: number | null;
+    totalRuns: number | null;
+    lastUsage: {
+        costUsd: number | null;
+        numTurns: number | null;
+        inputTokens: number | null;
+        outputTokens: number | null;
+        cacheReadTokens: number | null;
+        sessionId: string | null;
+    } | null;
+}
+export interface AgentOpsRawJob {
+    id: string;
+    label: string;
+    schedule: string;
+    schedule_dialect: '5f' | '6f';
+    timezone: string;
+    enabled: boolean;
+    command: string;
+    mode: 'agent' | 'script';
+    model: string | null;
+    agent: string | null;
+    _disabledReason: string | null;
+    state: AgentOpsRawJobState | null;
+}
+/** `host.agentOps.listJobs({})` — read the project-scoped job config + the
+ *  daemon's runtime state file and return both, merged per job, plus daemon
+ *  liveness. Run history (cron_job_runs / agent_runs) is NOT included here —
+ *  the pkg reads that directly via `host.dbQuery`. */
+export type AgentOpsListJobsArgs = Record<string, never>;
+export type AgentOpsListJobsResult = {
+    ok: true;
+    daemon_up: boolean;
+    daemon_pid: number | null;
+    jobs: AgentOpsRawJob[];
+} | AgentOpsErrorResult;
+//# sourceMappingURL=host-verbs.d.ts.map

package/dist/host-verbs.d.ts.map

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

package/dist/host-verbs.js

@@ -0,0 +1,15 @@
+/**
+ * Host-bridge verb shapes for the agent-ops pkg — the **G-TRIGGER** freeze gate.
+ *
+ * Unlike the kernel RPC methods in `rpc.ts`, `host.*` verbs are dispatched
+ * FE-side in the iframe host (`shell/src/components/pkg/pkg-iframe-host.tsx`)
+ * and invoked from the iframe via `app.callServerTool({ name, arguments })`,
+ * returning their payload on `res.structuredContent`. These types are the
+ * shared contract the shell (WP-09) produces and the agent-ops pkg
+ * (WP-08 reads, WP-12 writes) consumes. Frozen so changing them after both
+ * sides exist forces a cross-repo re-sync.
+ *
+ * Gated by `capabilities.agentOps` (see `AgentOpsCapabilitySchema`).
+ */
+export {};
+//# sourceMappingURL=host-verbs.js.map

package/dist/host-verbs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-verbs.js","sourceRoot":"","sources":["../src/host-verbs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from './manifest.js';
 export * from './rpc.js';
+export * from './host-verbs.js';
 export * from './engine/index.js';
 export * from './scopes.js';
 export * from './iyke.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAE7B,kCAAkC;AAClC,eAAO,MAAM,wBAAwB,EAAG,OAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAE7B,kCAAkC;AAClC,eAAO,MAAM,wBAAwB,EAAG,OAAgB,CAAC"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export * from './manifest.js';
 export * from './rpc.js';
+export * from './host-verbs.js';
 export * from './engine/index.js';
 export * from './scopes.js';
 export * from './iyke.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAE7B,kCAAkC;AAClC,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAE7B,kCAAkC;AAClC,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAgB,CAAC"}