@ikenga/contract 0.6.0 → 0.9.0

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

package/dist/engine/index.d.ts

@@ -9,4 +9,6 @@
 export * from './adapter.js';
 export * from './acp.js';
 export * from './errors.js';
+export * from './portability.js';
+export * from './subagent-transcoder.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/engine/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC"}

package/dist/engine/index.js

@@ -9,4 +9,6 @@
 export * from './adapter.js';
 export * from './acp.js';
 export * from './errors.js';
+export * from './portability.js';
+export * from './subagent-transcoder.js';
 //# sourceMappingURL=index.js.map

package/dist/engine/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC"}

package/dist/engine/portability.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Portability surface for engine pkgs — ADR-012.
+ *
+ * Engine pkgs implement this in parallel to the runtime adapter
+ * (`AcpEngine` in `./acp.ts`). The kernel's `engine_assets` registry calls
+ * these methods at pkg install / uninstall time, fanning the operation out
+ * to every installed `EngineAdapter` so a user's pkg investment (skills,
+ * commands, agents, MCP servers) survives an engine swap.
+ *
+ * No manifest schema changes — pkgs continue to declare `skills`,
+ * `commands`, `agents` as folder paths and `mcp[]` as inline entries.
+ * This file is a runtime interface; it has no Zod schema and no
+ * compile-time dependency on the manifest schema beyond reusing
+ * `McpServer` for the spec passed to `registerMcpServer`.
+ */
+import type { McpServer } from '../manifest.js';
+/**
+ * Result of an install / register operation. Per ADR §2 the kernel's pkg
+ * manager UI surfaces these so the user can see exactly what each engine
+ * adapter wrote.
+ */
+export interface InstallReport {
+    /** Absolute paths the adapter wrote or symlinked. */
+    wrote: string[];
+    /** Targets that were already correct — idempotent no-op. */
+    skipped: string[];
+    /** Non-fatal notes (e.g. "commands not supported on Codex; skipped"). */
+    warnings: string[];
+}
+/**
+ * Dry-run output for `EngineAdapter.plan()`. Shape mirrors `InstallReport`
+ * plus the `(engineId, pkgId)` tuple so the pkg manager UI can render a
+ * per-engine breakdown ("this pkg will install assets into 3 engines").
+ */
+export interface InstallPlan extends InstallReport {
+    /** Engine the plan was computed against — matches `EngineAdapter.id`. */
+    engineId: string;
+    /** Pkg the plan was computed for — matches the manifest `id` field. */
+    pkgId: string;
+}
+/**
+ * Minimal pkg manifest slice the adapter needs to compute a plan. Carved
+ * narrow on purpose: `plan()` runs before install, so it shouldn't load
+ * disk content the adapter wouldn't otherwise touch. Folder paths are
+ * relative to the pkg root (same convention as the on-disk manifest).
+ */
+export interface ManifestSnapshot {
+    /** Pkg id (e.g. `com.ikenga.studio`). */
+    id: string;
+    /** Pkg slug used to namespace materialized dirs (id with `.` → `-`). */
+    slug: string;
+    /** Relative folder for `skills/<name>/SKILL.md` files, if any. */
+    skills?: string;
+    /** Relative folder for `commands/<name>.md` files, if any. */
+    commands?: string;
+    /** Relative folder for `agents/<name>.md` files, if any. */
+    agents?: string;
+    /** Inline MCP server specs from the manifest's `mcp[]` block. */
+    mcp: McpServer[];
+}
+/**
+ * Portability adapter exported by every engine pkg alongside its runtime
+ * `AcpEngine`. The kernel resolves both at load time (ADR §2).
+ *
+ * Folder-level methods. Each `install*` call is the adapter's chance to
+ * symlink, copy, or walk-and-transcode the whole folder — the choice
+ * depends on what the engine accepts natively. Idempotent by contract:
+ * re-running with unchanged inputs is a no-op.
+ *
+ * `registerMcpServer` writes a single entry into the engine's external
+ * settings file (`~/.claude/settings.json`, `~/.gemini/settings.json`,
+ * `~/.codex/config.toml`). Entries are keyed `ikenga.<pkg-slug>.<name>`
+ * per ADR §7 so they never collide with user-authored entries.
+ *
+ * Inverses tear down only what this pkg owned — user content in the same
+ * dir / settings file is left untouched.
+ */
+export interface EngineAdapter {
+    /** Engine identifier — matches `engine.agentId` in the pkg manifest. */
+    readonly id: string;
+    /**
+     * Materialize the pkg's skills folder into the engine's recognized
+     * location. Idempotent.
+     */
+    installSkills(folder: string, pkgId: string, pkgSlug: string): Promise<InstallReport>;
+    /**
+     * Materialize the pkg's commands folder. Engines without a first-class
+     * commands primitive (Codex) may emit warnings and skip per-file
+     * instead of erroring — see ADR §5.
+     */
+    installCommands(folder: string, pkgId: string, pkgSlug: string): Promise<InstallReport>;
+    /** Materialize the pkg's agents folder. Codex transcodes MD→TOML. */
+    installAgents(folder: string, pkgId: string, pkgSlug: string): Promise<InstallReport>;
+    /**
+     * Register one MCP server in the engine's external settings file.
+     * Idempotent on the `(pkgSlug, server name)` key.
+     */
+    registerMcpServer(spec: McpServer, pkgId: string, pkgSlug: string): Promise<InstallReport>;
+    /** Inverse of `installSkills`. Removes only entries this pkg owned. */
+    uninstallSkills(pkgId: string, pkgSlug: string): Promise<void>;
+    /** Inverse of `installCommands`. */
+    uninstallCommands(pkgId: string, pkgSlug: string): Promise<void>;
+    /** Inverse of `installAgents`. */
+    uninstallAgents(pkgId: string, pkgSlug: string): Promise<void>;
+    /** Inverse of `registerMcpServer`. */
+    unregisterMcpServer(serverName: string, pkgId: string, pkgSlug: string): Promise<void>;
+    /**
+     * Dry-run used by the pkg manager UI. Returns the same shape as a real
+     * install would produce, without touching the filesystem.
+     */
+    plan(pkgId: string, pkgSlug: string, manifestSnapshot: ManifestSnapshot): Promise<InstallPlan>;
+}
+//# sourceMappingURL=portability.d.ts.map

package/dist/engine/portability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portability.d.ts","sourceRoot":"","sources":["../../src/engine/portability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yEAAyE;IACzE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,GAAG,EAAE,SAAS,EAAE,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEtF;;;;OAIG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAExF,qEAAqE;IACrE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEtF;;;OAGG;IACH,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE3F,uEAAuE;IACvE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,oCAAoC;IACpC,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,kCAAkC;IAClC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,sCAAsC;IACtC,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvF;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAChG"}

package/dist/engine/portability.js

@@ -0,0 +1,17 @@
+/**
+ * Portability surface for engine pkgs — ADR-012.
+ *
+ * Engine pkgs implement this in parallel to the runtime adapter
+ * (`AcpEngine` in `./acp.ts`). The kernel's `engine_assets` registry calls
+ * these methods at pkg install / uninstall time, fanning the operation out
+ * to every installed `EngineAdapter` so a user's pkg investment (skills,
+ * commands, agents, MCP servers) survives an engine swap.
+ *
+ * No manifest schema changes — pkgs continue to declare `skills`,
+ * `commands`, `agents` as folder paths and `mcp[]` as inline entries.
+ * This file is a runtime interface; it has no Zod schema and no
+ * compile-time dependency on the manifest schema beyond reusing
+ * `McpServer` for the spec passed to `registerMcpServer`.
+ */
+export {};
+//# sourceMappingURL=portability.js.map

package/dist/engine/portability.js.map

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

package/dist/engine/subagent-transcoder.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Subagent format transcoder — ADR-012 §5.
+ *
+ * Translates between the canonical Markdown + YAML-frontmatter shape used
+ * by Claude Code and Gemini CLI and the TOML shape used by Codex CLI.
+ * Zero external dependencies: hand-rolled mini-parsers for YAML
+ * frontmatter and the TOML keys ADR §5 lists.
+ *
+ * Supported keys (top-level):
+ *   - Canonical (round-trips): name, description, tools, model, system_prompt
+ *   - Codex extras (preserved when present): developer_instructions,
+ *     sandbox_mode, mcp_servers, skills
+ *   - Claude/Gemini extras (preserved in YAML, ignored by Codex):
+ *     temperature, max_turns, timeout_mins
+ *
+ * Nested table support is limited to `[mcp_servers]` — that's the only
+ * realistic surface for subagents. Arrays of tables, inline tables, and
+ * comments are not parsed; the transcoder operates on files we generate
+ * or files following ADR §5's spec.
+ */
+export declare function mdToCodexToml(md: string): string;
+export declare function codexTomlToMd(toml: string): string;
+export declare function mdToGeminiCommandToml(md: string): string;
+//# sourceMappingURL=subagent-transcoder.d.ts.map

package/dist/engine/subagent-transcoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-transcoder.d.ts","sourceRoot":"","sources":["../../src/engine/subagent-transcoder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAOxD"}