@eidola.app/cli 0.2.0

package/shrine/shared/approval-idle-logic.js

@@ -0,0 +1,63 @@
+/** Shell / MCP tools that may block on Shaper approval — arms approval-idle timer. */
+export function isGatedApprovalTool(tool) {
+    if (!tool) {
+        return false;
+    }
+    if (tool === 'Shell' || tool === 'CallMcpTool') {
+        return true;
+    }
+    return tool.startsWith('mcp__') || tool.startsWith('mcp_');
+}
+export function isTurnEndState(state, inTurn) {
+    if (state === 'success') {
+        return true;
+    }
+    return state === 'idle' && inTurn;
+}
+export function shouldArmApprovalIdleTimer(inTurn, state, tool) {
+    if (!inTurn || state === 'waiting') {
+        return false;
+    }
+    return state === 'working' && isGatedApprovalTool(tool);
+}
+/** Pure timeline: when silence after gated working exceeds threshold → waiting. */
+export function simulateApprovalIdleTimeline(events, approvalIdleMs) {
+    const timeline = [];
+    let inTurn = false;
+    let armedAt = null;
+    for (const event of events) {
+        if (event.source === 'approval-idle') {
+            continue;
+        }
+        if (armedAt !== null && event.atMs - armedAt >= approvalIdleMs) {
+            timeline.push({ state: 'waiting', source: 'approval-idle', atMs: armedAt + approvalIdleMs });
+            armedAt = null;
+        }
+        timeline.push({
+            state: event.state,
+            source: event.source ?? 'socket',
+            atMs: event.atMs,
+        });
+        if (isTurnEndState(event.state, inTurn)) {
+            inTurn = false;
+            armedAt = null;
+            continue;
+        }
+        if (!inTurn && event.state === 'thinking') {
+            inTurn = true;
+        }
+        armedAt = null;
+        if (shouldArmApprovalIdleTimer(inTurn, event.state, event.tool)) {
+            armedAt = event.atMs;
+        }
+    }
+    if (armedAt !== null) {
+        timeline.push({
+            state: 'waiting',
+            source: 'approval-idle',
+            atMs: armedAt + approvalIdleMs,
+        });
+    }
+    return timeline;
+}
+//# sourceMappingURL=approval-idle-logic.js.map

package/shrine/shared/approval-idle-logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-idle-logic.js","sourceRoot":"","sources":["../../src/shared/approval-idle-logic.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,MAAe;IAC3D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,KAAK,MAAM,IAAI,MAAM,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,MAAe,EACf,KAAa,EACb,IAAa;IAEb,IAAI,CAAC,MAAM,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,KAAK,KAAK,SAAS,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;AAC1D,CAAC;AASD,mFAAmF;AACnF,MAAM,UAAU,4BAA4B,CAC1C,MAAoC,EACpC,cAAsB;IAEtB,MAAM,QAAQ,GAA2D,EAAE,CAAC;IAC5E,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,OAAO,GAAkB,IAAI,CAAC;IAElC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,eAAe,EAAE,CAAC;YACrC,SAAS;QACX,CAAC;QAED,IAAI,OAAO,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,GAAG,OAAO,IAAI,cAAc,EAAE,CAAC;YAC/D,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,cAAc,EAAE,CAAC,CAAC;YAC7F,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,QAAQ;YAChC,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC,CAAC;QAEH,IAAI,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;YACxC,MAAM,GAAG,KAAK,CAAC;YACf,OAAO,GAAG,IAAI,CAAC;YACf,SAAS;QACX,CAAC;QAED,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAC1C,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;QAED,OAAO,GAAG,IAAI,CAAC;QAEf,IAAI,0BAA0B,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAChE,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC;QACvB,CAAC;IACH,CAAC;IAED,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,eAAe;YACvB,IAAI,EAAE,OAAO,GAAG,cAAc;SAC/B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/shrine/shared/approval-idle-logic.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=approval-idle-logic.test.d.ts.map

package/shrine/shared/approval-idle-logic.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-idle-logic.test.d.ts","sourceRoot":"","sources":["../../src/shared/approval-idle-logic.test.ts"],"names":[],"mappings":""}

package/shrine/shared/approval-idle-logic.test.js

@@ -0,0 +1,49 @@
+import { describe, expect, it } from 'vitest';
+import { isGatedApprovalTool, shouldArmApprovalIdleTimer, simulateApprovalIdleTimeline, } from './approval-idle-logic.js';
+describe('isGatedApprovalTool', () => {
+    it('matches shell and MCP tools', () => {
+        expect(isGatedApprovalTool('Shell')).toBe(true);
+        expect(isGatedApprovalTool('CallMcpTool')).toBe(true);
+        expect(isGatedApprovalTool('mcp__eidola__load_eidolon')).toBe(true);
+        expect(isGatedApprovalTool('Grep')).toBe(false);
+    });
+});
+describe('shouldArmApprovalIdleTimer', () => {
+    it('arms only in-turn gated working', () => {
+        expect(shouldArmApprovalIdleTimer(true, 'working', 'Shell')).toBe(true);
+        expect(shouldArmApprovalIdleTimer(true, 'thinking', undefined)).toBe(false);
+        expect(shouldArmApprovalIdleTimer(false, 'working', 'Shell')).toBe(false);
+        expect(shouldArmApprovalIdleTimer(true, 'waiting', 'Shell')).toBe(false);
+        expect(shouldArmApprovalIdleTimer(true, 'working', 'Grep')).toBe(false);
+    });
+});
+describe('simulateApprovalIdleTimeline', () => {
+    it('escalates to waiting after approval_idle_ms silence', () => {
+        const timeline = simulateApprovalIdleTimeline([
+            { atMs: 0, state: 'idle' },
+            { atMs: 100, state: 'thinking' },
+            { atMs: 200, state: 'working', tool: 'Shell' },
+        ], 3000);
+        expect(timeline.some((entry) => entry.source === 'approval-idle' && entry.state === 'waiting')).toBe(true);
+    });
+    it('does not escalate during long thinking without gated tool', () => {
+        const timeline = simulateApprovalIdleTimeline([
+            { atMs: 0, state: 'idle' },
+            { atMs: 100, state: 'thinking' },
+            { atMs: 5000, state: 'searching', tool: 'Grep' },
+        ], 3000);
+        expect(timeline.some((entry) => entry.source === 'approval-idle')).toBe(false);
+    });
+    it('disarms between turns', () => {
+        const timeline = simulateApprovalIdleTimeline([
+            { atMs: 0, state: 'thinking' },
+            { atMs: 100, state: 'working', tool: 'Shell' },
+            { atMs: 500, state: 'success' },
+            { atMs: 600, state: 'idle' },
+            { atMs: 700, state: 'thinking' },
+            { atMs: 800, state: 'searching', tool: 'Grep' },
+        ], 3000);
+        expect(timeline.filter((entry) => entry.source === 'approval-idle')).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=approval-idle-logic.test.js.map

package/shrine/shared/approval-idle-logic.test.js.map

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

package/shrine/shared/kraken-detect.d.ts

@@ -0,0 +1,36 @@
+import type { ShrineSurface } from './shrine-surface.js';
+import { SHRINE_SURFACE_PRESETS } from './shrine-surface.js';
+export interface NzxtViewport {
+    width: number;
+    height: number;
+    shape: string;
+    targetFps?: number;
+}
+export interface KrakenDetection {
+    /** CAM Kraken LCD browser (`?kraken=1` or `window.nzxt.v1`). */
+    isKrakenBrowser: boolean;
+    /** CAM configuration browser (same URL, no kraken param). */
+    isConfigBrowser: boolean;
+    viewport: NzxtViewport | null;
+}
+interface NzxtV1 {
+    width?: number;
+    height?: number;
+    shape?: string;
+    targetFps?: number;
+}
+declare global {
+    interface Window {
+        nzxt?: {
+            v1?: NzxtV1;
+        };
+    }
+}
+export declare function readNzxtViewport(): NzxtViewport | null;
+export declare function isKrakenQueryParam(search?: string): boolean;
+export declare function detectKrakenMode(search?: string): KrakenDetection;
+/** Resolve runtime surface for browser/CAM contexts. */
+export declare function resolveBrowserShrineSurface(detection: KrakenDetection, fallbackPreset?: keyof typeof SHRINE_SURFACE_PRESETS): ShrineSurface;
+export declare function shouldApplyCircularMask(surface: ShrineSurface, detection: KrakenDetection): boolean;
+export {};
+//# sourceMappingURL=kraken-detect.d.ts.map

package/shrine/shared/kraken-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kraken-detect.d.ts","sourceRoot":"","sources":["../../src/shared/kraken-detect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,eAAe,EAAE,OAAO,CAAC;IACzB,6DAA6D;IAC7D,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;CAC/B;AAED,UAAU,MAAM;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,IAAI,CAAC,EAAE;YACL,EAAE,CAAC,EAAE,MAAM,CAAC;SACb,CAAC;KACH;CACF;AAED,wBAAgB,gBAAgB,IAAI,YAAY,GAAG,IAAI,CAgBtD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAK3D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe,CAWjE;AAED,wDAAwD;AACxD,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,eAAe,EAC1B,cAAc,GAAE,MAAM,OAAO,sBAA0C,GACtE,aAAa,CAqBf;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,GAAG,OAAO,CAUnG"}

package/shrine/shared/kraken-detect.js

@@ -0,0 +1,61 @@
+import { SHRINE_SURFACE_PRESETS } from './shrine-surface.js';
+export function readNzxtViewport() {
+    if (typeof window === 'undefined') {
+        return null;
+    }
+    const v1 = window.nzxt?.v1;
+    if (!v1) {
+        return null;
+    }
+    const width = typeof v1.width === 'number' ? v1.width : 640;
+    const height = typeof v1.height === 'number' ? v1.height : 640;
+    const shape = typeof v1.shape === 'string' ? v1.shape : 'circle';
+    const targetFps = typeof v1.targetFps === 'number' ? v1.targetFps : undefined;
+    return { width, height, shape, targetFps };
+}
+export function isKrakenQueryParam(search) {
+    const query = search ?? (typeof window !== 'undefined' ? window.location.search : '');
+    const params = new URLSearchParams(query);
+    const kraken = params.get('kraken');
+    return kraken === '1' || kraken === 'true';
+}
+export function detectKrakenMode(search) {
+    const query = search ?? (typeof window !== 'undefined' ? window.location.search : '');
+    const krakenQuery = isKrakenQueryParam(query);
+    const viewport = readNzxtViewport();
+    const isKrakenBrowser = krakenQuery || viewport !== null;
+    return {
+        isKrakenBrowser,
+        isConfigBrowser: !isKrakenBrowser,
+        viewport,
+    };
+}
+/** Resolve runtime surface for browser/CAM contexts. */
+export function resolveBrowserShrineSurface(detection, fallbackPreset = 'kraken-elite-v2') {
+    if (!detection.isKrakenBrowser) {
+        return { preset: fallbackPreset, ...SHRINE_SURFACE_PRESETS[fallbackPreset] };
+    }
+    const preset = SHRINE_SURFACE_PRESETS['kraken-elite-v2'];
+    const viewport = detection.viewport;
+    if (!viewport) {
+        return { preset: 'kraken-elite-v2', ...preset };
+    }
+    const circularMask = viewport.shape === 'circle' || preset.circularMask === true;
+    return {
+        preset: 'kraken-elite-v2',
+        width: viewport.width,
+        height: viewport.height,
+        circularMask,
+        layoutTier: preset.layoutTier,
+    };
+}
+export function shouldApplyCircularMask(surface, detection) {
+    if (surface.circularMask) {
+        return true;
+    }
+    if (detection.isKrakenBrowser && detection.viewport?.shape === 'circle') {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=kraken-detect.js.map

package/shrine/shared/kraken-detect.js.map

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

package/shrine/shared/kraken-detect.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=kraken-detect.test.d.ts.map

package/shrine/shared/kraken-detect.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kraken-detect.test.d.ts","sourceRoot":"","sources":["../../src/shared/kraken-detect.test.ts"],"names":[],"mappings":""}

package/shrine/shared/kraken-detect.test.js

@@ -0,0 +1,35 @@
+import { describe, expect, it } from 'vitest';
+import { detectKrakenMode, isKrakenQueryParam, resolveBrowserShrineSurface, shouldApplyCircularMask, } from './kraken-detect.js';
+describe('kraken detection', () => {
+    it('detects ?kraken=1 query param', () => {
+        expect(isKrakenQueryParam('?kraken=1')).toBe(true);
+        expect(isKrakenQueryParam('?kraken=true')).toBe(true);
+        expect(isKrakenQueryParam('')).toBe(false);
+    });
+    it('marks config browser when kraken param absent', () => {
+        const detection = detectKrakenMode('');
+        expect(detection.isKrakenBrowser).toBe(false);
+        expect(detection.isConfigBrowser).toBe(true);
+    });
+    it('marks kraken browser from query param', () => {
+        const detection = detectKrakenMode('?kraken=1');
+        expect(detection.isKrakenBrowser).toBe(true);
+        expect(detection.isConfigBrowser).toBe(false);
+    });
+    it('resolves kraken-elite-v2 surface for kraken browser', () => {
+        const detection = detectKrakenMode('?kraken=1');
+        expect(resolveBrowserShrineSurface(detection)).toEqual({
+            preset: 'kraken-elite-v2',
+            width: 640,
+            height: 640,
+            circularMask: true,
+            layoutTier: 'square',
+        });
+    });
+    it('applies circular mask for kraken preset', () => {
+        const detection = detectKrakenMode('?kraken=1');
+        const surface = resolveBrowserShrineSurface(detection);
+        expect(shouldApplyCircularMask(surface, detection)).toBe(true);
+    });
+});
+//# sourceMappingURL=kraken-detect.test.js.map

package/shrine/shared/kraken-detect.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kraken-detect.test.js","sourceRoot":"","sources":["../../src/shared/kraken-detect.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAE5B,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,SAAS,GAAG,gBAAgB,CAAC,EAAE,CAAC,CAAC;QACvC,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,SAAS,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,SAAS,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,CAAC,2BAA2B,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;YACrD,MAAM,EAAE,iBAAiB;YACzB,KAAK,EAAE,GAAG;YACV,MAAM,EAAE,GAAG;YACX,YAAY,EAAE,IAAI;YAClB,UAAU,EAAE,QAAQ;SACrB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,SAAS,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,2BAA2B,CAAC,SAAS,CAAC,CAAC;QACvD,MAAM,CAAC,uBAAuB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/shrine/shared/shrine-api.d.ts

@@ -0,0 +1,15 @@
+import type { ShrineStatePayload, ShrineSurfacePayload, ShrineVesselConfig } from './types.js';
+export interface ShrineApi {
+    onState(handler: (payload: ShrineStatePayload) => void): () => void;
+    onVesselConfig(handler: (config: ShrineVesselConfig) => void): () => void;
+    onSurface(handler: (payload: ShrineSurfacePayload) => void): () => void;
+    ready(): void;
+    log(message: string): void;
+}
+declare global {
+    interface Window {
+        eidolaShrine: ShrineApi;
+    }
+}
+export {};
+//# sourceMappingURL=shrine-api.d.ts.map

package/shrine/shared/shrine-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shrine-api.d.ts","sourceRoot":"","sources":["../../src/shared/shrine-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE/F,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACpE,cAAc,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC1E,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACxE,KAAK,IAAI,IAAI,CAAC;IACd,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,YAAY,EAAE,SAAS,CAAC;KACzB;CACF;AAED,OAAO,EAAE,CAAC"}

package/shrine/shared/shrine-api.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shrine-api.js.map

package/shrine/shared/shrine-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shrine-api.js","sourceRoot":"","sources":["../../src/shared/shrine-api.ts"],"names":[],"mappings":""}

package/shrine/shared/shrine-display-config.d.ts

@@ -0,0 +1,34 @@
+import { type ShrineLayoutTier, type ShrineSurface } from './shrine-surface.js';
+/** Layout geometry — independent from display surface / mask mode. */
+export type ShrineAspectRatioId = 'ultrawide-4-1' | 'widescreen-16-9' | 'square-1-1';
+/** Where the Shrine runs — browser window vs NZXT Kraken LCD integration. */
+export type ShrineSurfaceModeId = 'browser' | 'kraken';
+export declare const SHRINE_ASPECT_RATIO_PRESETS: Record<ShrineAspectRatioId, {
+    width: number;
+    height: number;
+    layoutTier: ShrineLayoutTier;
+}>;
+export declare const DEFAULT_SHRINE_ASPECT_RATIO: ShrineAspectRatioId;
+export declare const DEFAULT_SHRINE_SURFACE_MODE: ShrineSurfaceModeId;
+export interface ShrineDisplayConfig {
+    aspectRatio: ShrineAspectRatioId;
+    surfaceMode: ShrineSurfaceModeId;
+    width: number;
+    height: number;
+}
+export interface ResolveDisplayConfigInput {
+    aspectRatio?: string | undefined;
+    surfaceMode?: string | undefined;
+    /** Legacy single-field preset from eidola.json `shrine_surface`. */
+    legacySurface?: string | undefined;
+    widthEnv?: string | undefined;
+    heightEnv?: string | undefined;
+}
+export declare function normalizeAspectRatioInput(value: string): ShrineAspectRatioId | null;
+export declare function normalizeSurfaceModeInput(value: string): ShrineSurfaceModeId | null;
+export declare function resolveDisplayConfig(input?: ResolveDisplayConfigInput): ShrineDisplayConfig;
+export declare function composeShrineSurface(config: ShrineDisplayConfig): ShrineSurface;
+/** Legacy `shrine_surface` value for MCP / lock file compatibility. */
+export declare function legacyShrineSurfaceValue(config: ShrineDisplayConfig): string;
+export declare function displayConfigFromSurface(surface: ShrineSurface): ShrineDisplayConfig;
+//# sourceMappingURL=shrine-display-config.d.ts.map

package/shrine/shared/shrine-display-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shrine-display-config.d.ts","sourceRoot":"","sources":["../../src/shared/shrine-display-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAEnB,MAAM,qBAAqB,CAAC;AAE7B,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,iBAAiB,GAAG,YAAY,CAAC;AAErF,6EAA6E;AAC7E,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEvD,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAC9C,mBAAmB,EACnB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,gBAAgB,CAAA;CAAE,CAKhE,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,mBAAqC,CAAC;AAChF,eAAO,MAAM,2BAA2B,EAAE,mBAA+B,CAAC;AAE1E,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,mBAAmB,CAAC;IACjC,WAAW,EAAE,mBAAmB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AA+FD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAMnF;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CASnF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,GAAE,yBAA8B,GAAG,mBAAmB,CA4C/F;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CAuB/E;AAED,uEAAuE;AACvE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAK5E;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,GAAG,mBAAmB,CA0BpF"}

package/shrine/shared/shrine-display-config.js

@@ -0,0 +1,197 @@
+import { SHRINE_SURFACE_PRESETS, } from './shrine-surface.js';
+export const SHRINE_ASPECT_RATIO_PRESETS = {
+    'ultrawide-4-1': { width: 1920, height: 480, layoutTier: 'ultrawide' },
+    'widescreen-16-9': { width: 1920, height: 1080, layoutTier: 'widescreen' },
+    'square-1-1': { width: 640, height: 640, layoutTier: 'square' },
+};
+export const DEFAULT_SHRINE_ASPECT_RATIO = 'ultrawide-4-1';
+export const DEFAULT_SHRINE_SURFACE_MODE = 'browser';
+const KRAKEN_SURFACE_ALIASES = new Set([
+    'kraken',
+    'kraken-lcd',
+    'kraken-elite',
+    'kraken-elite-v2',
+]);
+function isAspectRatioId(value) {
+    return value in SHRINE_ASPECT_RATIO_PRESETS;
+}
+function isSurfaceModeId(value) {
+    return value === 'browser' || value === 'kraken';
+}
+function parseCustomDimensions(value) {
+    const match = value.trim().match(/^(\d+)\s*[x×]\s*(\d+)$/i);
+    if (!match) {
+        return null;
+    }
+    const width = Number.parseInt(match[1] ?? '', 10);
+    const height = Number.parseInt(match[2] ?? '', 10);
+    if (!Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0) {
+        return null;
+    }
+    return { width, height };
+}
+function closestAspectRatio(width, height) {
+    const ratio = width / height;
+    const entries = Object.entries(SHRINE_ASPECT_RATIO_PRESETS);
+    let best = DEFAULT_SHRINE_ASPECT_RATIO;
+    let bestDelta = Number.POSITIVE_INFINITY;
+    for (const [id, preset] of entries) {
+        const delta = Math.abs(ratio - preset.width / preset.height);
+        if (delta < bestDelta) {
+            bestDelta = delta;
+            best = id;
+        }
+    }
+    return best;
+}
+function deriveFromLegacySurface(legacy) {
+    const trimmed = legacy.trim();
+    const lower = trimmed.toLowerCase();
+    if (KRAKEN_SURFACE_ALIASES.has(lower) || lower === 'kraken-elite-v2') {
+        const preset = SHRINE_ASPECT_RATIO_PRESETS['square-1-1'];
+        return {
+            aspectRatio: 'square-1-1',
+            surfaceMode: 'kraken',
+            width: preset.width,
+            height: preset.height,
+        };
+    }
+    if (isAspectRatioId(trimmed)) {
+        const preset = SHRINE_ASPECT_RATIO_PRESETS[trimmed];
+        return {
+            aspectRatio: trimmed,
+            surfaceMode: 'browser',
+            width: preset.width,
+            height: preset.height,
+        };
+    }
+    const custom = parseCustomDimensions(trimmed);
+    if (custom) {
+        return {
+            aspectRatio: closestAspectRatio(custom.width, custom.height),
+            surfaceMode: 'browser',
+            width: custom.width,
+            height: custom.height,
+        };
+    }
+    const fallback = SHRINE_ASPECT_RATIO_PRESETS[DEFAULT_SHRINE_ASPECT_RATIO];
+    return {
+        aspectRatio: DEFAULT_SHRINE_ASPECT_RATIO,
+        surfaceMode: 'browser',
+        width: fallback.width,
+        height: fallback.height,
+    };
+}
+export function normalizeAspectRatioInput(value) {
+    const trimmed = value.trim();
+    if (isAspectRatioId(trimmed)) {
+        return trimmed;
+    }
+    return null;
+}
+export function normalizeSurfaceModeInput(value) {
+    const lower = value.trim().toLowerCase();
+    if (lower === 'browser' || lower === 'standard') {
+        return 'browser';
+    }
+    if (KRAKEN_SURFACE_ALIASES.has(lower) || lower === 'kraken') {
+        return 'kraken';
+    }
+    return null;
+}
+export function resolveDisplayConfig(input = {}) {
+    const customFromEnv = (() => {
+        const widthEnv = input.widthEnv ?? process.env.EIDOLA_SHRINE_WIDTH;
+        const heightEnv = input.heightEnv ?? process.env.EIDOLA_SHRINE_HEIGHT;
+        if (widthEnv?.trim() && heightEnv?.trim()) {
+            const width = Number.parseInt(widthEnv.trim(), 10);
+            const height = Number.parseInt(heightEnv.trim(), 10);
+            if (Number.isFinite(width) && Number.isFinite(height) && width > 0 && height > 0) {
+                return { width, height };
+            }
+        }
+        return null;
+    })();
+    if (input.aspectRatio?.trim() && input.surfaceMode?.trim()) {
+        const aspectRatio = normalizeAspectRatioInput(input.aspectRatio);
+        const surfaceMode = normalizeSurfaceModeInput(input.surfaceMode);
+        if (aspectRatio && surfaceMode) {
+            const preset = SHRINE_ASPECT_RATIO_PRESETS[aspectRatio];
+            return {
+                aspectRatio,
+                surfaceMode,
+                width: customFromEnv?.width ?? preset.width,
+                height: customFromEnv?.height ?? preset.height,
+            };
+        }
+    }
+    if (input.legacySurface?.trim()) {
+        return deriveFromLegacySurface(input.legacySurface);
+    }
+    const envSurface = process.env.EIDOLA_SHRINE_SURFACE?.trim();
+    if (envSurface) {
+        return deriveFromLegacySurface(envSurface);
+    }
+    const fallback = SHRINE_ASPECT_RATIO_PRESETS[DEFAULT_SHRINE_ASPECT_RATIO];
+    return {
+        aspectRatio: DEFAULT_SHRINE_ASPECT_RATIO,
+        surfaceMode: DEFAULT_SHRINE_SURFACE_MODE,
+        width: fallback.width,
+        height: fallback.height,
+    };
+}
+export function composeShrineSurface(config) {
+    const aspect = SHRINE_ASPECT_RATIO_PRESETS[config.aspectRatio];
+    const width = config.width || aspect.width;
+    const height = config.height || aspect.height;
+    if (config.surfaceMode === 'kraken') {
+        const krakenPreset = SHRINE_SURFACE_PRESETS['kraken-elite-v2'];
+        return {
+            preset: 'kraken-elite-v2',
+            width,
+            height,
+            circularMask: krakenPreset.circularMask,
+            layoutTier: aspect.layoutTier,
+        };
+    }
+    const presetId = config.aspectRatio;
+    return {
+        preset: presetId in SHRINE_SURFACE_PRESETS ? presetId : 'custom',
+        width,
+        height,
+        layoutTier: aspect.layoutTier,
+    };
+}
+/** Legacy `shrine_surface` value for MCP / lock file compatibility. */
+export function legacyShrineSurfaceValue(config) {
+    if (config.surfaceMode === 'kraken') {
+        return 'kraken-elite-v2';
+    }
+    return config.aspectRatio;
+}
+export function displayConfigFromSurface(surface) {
+    if (surface.preset === 'kraken-elite-v2' || surface.circularMask) {
+        const aspectRatio = closestAspectRatio(surface.width, surface.height);
+        return {
+            aspectRatio,
+            surfaceMode: 'kraken',
+            width: surface.width,
+            height: surface.height,
+        };
+    }
+    if (surface.preset !== 'custom' && isAspectRatioId(surface.preset)) {
+        return {
+            aspectRatio: surface.preset,
+            surfaceMode: 'browser',
+            width: surface.width,
+            height: surface.height,
+        };
+    }
+    return {
+        aspectRatio: closestAspectRatio(surface.width, surface.height),
+        surfaceMode: 'browser',
+        width: surface.width,
+        height: surface.height,
+    };
+}
+//# sourceMappingURL=shrine-display-config.js.map

package/shrine/shared/shrine-display-config.js.map

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

package/shrine/shared/shrine-display-config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shrine-display-config.test.d.ts.map

package/shrine/shared/shrine-display-config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shrine-display-config.test.d.ts","sourceRoot":"","sources":["../../src/shared/shrine-display-config.test.ts"],"names":[],"mappings":""}

package/shrine/shared/shrine-display-config.test.js

@@ -0,0 +1,53 @@
+import { describe, expect, it } from 'vitest';
+import { composeShrineSurface, legacyShrineSurfaceValue, resolveDisplayConfig, } from './shrine-display-config.js';
+describe('shrine display config', () => {
+    it('defaults to ultrawide browser', () => {
+        expect(resolveDisplayConfig({})).toEqual({
+            aspectRatio: 'ultrawide-4-1',
+            surfaceMode: 'browser',
+            width: 1920,
+            height: 480,
+        });
+    });
+    it('derives kraken from legacy preset', () => {
+        expect(resolveDisplayConfig({ legacySurface: 'kraken-elite-v2' })).toEqual({
+            aspectRatio: 'square-1-1',
+            surfaceMode: 'kraken',
+            width: 640,
+            height: 640,
+        });
+    });
+    it('composes kraken surface with circular mask', () => {
+        const config = resolveDisplayConfig({
+            aspectRatio: 'square-1-1',
+            surfaceMode: 'kraken',
+        });
+        expect(composeShrineSurface(config)).toMatchObject({
+            preset: 'kraken-elite-v2',
+            circularMask: true,
+            width: 640,
+            height: 640,
+        });
+    });
+    it('composes browser ultrawide without mask', () => {
+        const config = resolveDisplayConfig({
+            aspectRatio: 'ultrawide-4-1',
+            surfaceMode: 'browser',
+        });
+        expect(composeShrineSurface(config)).toEqual({
+            preset: 'ultrawide-4-1',
+            width: 1920,
+            height: 480,
+            layoutTier: 'ultrawide',
+        });
+    });
+    it('maps legacy shrine_surface for MCP compat', () => {
+        const config = resolveDisplayConfig({
+            aspectRatio: 'widescreen-16-9',
+            surfaceMode: 'browser',
+        });
+        expect(legacyShrineSurfaceValue(config)).toBe('widescreen-16-9');
+        expect(legacyShrineSurfaceValue({ ...config, surfaceMode: 'kraken' })).toBe('kraken-elite-v2');
+    });
+});
+//# sourceMappingURL=shrine-display-config.test.js.map

package/shrine/shared/shrine-display-config.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shrine-display-config.test.js","sourceRoot":"","sources":["../../src/shared/shrine-display-config.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AAEpC,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACvC,WAAW,EAAE,eAAe;YAC5B,WAAW,EAAE,SAAS;YACtB,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,GAAG;SACZ,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,oBAAoB,CAAC,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACzE,WAAW,EAAE,YAAY;YACzB,WAAW,EAAE,QAAQ;YACrB,KAAK,EAAE,GAAG;YACV,MAAM,EAAE,GAAG;SACZ,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,MAAM,GAAG,oBAAoB,CAAC;YAClC,WAAW,EAAE,YAAY;YACzB,WAAW,EAAE,QAAQ;SACtB,CAAC,CAAC;QACH,MAAM,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC;YACjD,MAAM,EAAE,iBAAiB;YACzB,YAAY,EAAE,IAAI;YAClB,KAAK,EAAE,GAAG;YACV,MAAM,EAAE,GAAG;SACZ,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,MAAM,GAAG,oBAAoB,CAAC;YAClC,WAAW,EAAE,eAAe;YAC5B,WAAW,EAAE,SAAS;SACvB,CAAC,CAAC;QACH,MAAM,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YAC3C,MAAM,EAAE,eAAe;YACvB,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,GAAG;YACX,UAAU,EAAE,WAAW;SACxB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,MAAM,GAAG,oBAAoB,CAAC;YAClC,WAAW,EAAE,iBAAiB;YAC9B,WAAW,EAAE,SAAS;SACvB,CAAC,CAAC;QACH,MAAM,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACjE,MAAM,CAAC,wBAAwB,CAAC,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACjG,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}