@eidola.app/cli 0.2.0

package/shrine/shared/shrine-state-colors.d.ts

@@ -0,0 +1,4 @@
+/** Shrine LCD background colors — keep in sync with vessels/camina-shrine/tools/generate-shrine-faces.mjs */
+export declare const SHRINE_STATE_COLORS: Record<string, string>;
+export declare function shrineColorForState(state: string): string;
+//# sourceMappingURL=shrine-state-colors.d.ts.map

package/shrine/shared/shrine-state-colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shrine-state-colors.d.ts","sourceRoot":"","sources":["../../src/shared/shrine-state-colors.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAC7G,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAWtD,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/shrine/shared/shrine-state-colors.js

@@ -0,0 +1,17 @@
+/** Shrine LCD background colors — keep in sync with vessels/camina-shrine/tools/generate-shrine-faces.mjs */
+export const SHRINE_STATE_COLORS = {
+    idle: '#c9a84c',
+    thinking: '#b29e58',
+    waiting: '#7896a8',
+    working: '#da8a3a',
+    searching: '#449eb2',
+    writing: '#76a862',
+    responding: '#eed04e',
+    success: '#a8c850',
+    error: '#9e76c6',
+    attention: '#da302a',
+};
+export function shrineColorForState(state) {
+    return SHRINE_STATE_COLORS[state] ?? SHRINE_STATE_COLORS.idle;
+}
+//# sourceMappingURL=shrine-state-colors.js.map

package/shrine/shared/shrine-state-colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shrine-state-colors.js","sourceRoot":"","sources":["../../src/shared/shrine-state-colors.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAC7G,MAAM,CAAC,MAAM,mBAAmB,GAA2B;IACzD,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,SAAS;IACpB,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,SAAS;IACrB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,SAAS;IAChB,SAAS,EAAE,SAAS;CACrB,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,mBAAmB,CAAC,KAAK,CAAC,IAAI,mBAAmB,CAAC,IAAI,CAAC;AAChE,CAAC"}

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

@@ -0,0 +1,32 @@
+export type ShrineSurfacePresetId = 'ultrawide-4-1' | 'square-1-1' | 'widescreen-16-9' | 'kraken-elite-v2';
+export type ShrineLayoutTier = 'ultrawide' | 'square' | 'widescreen';
+export interface ShrineSurface {
+    preset: ShrineSurfacePresetId | 'custom';
+    width: number;
+    height: number;
+    /** Clip vessel stage to a circle (NZXT Kraken LCD). */
+    circularMask?: boolean;
+    /** Three.js layout tier; defaults from aspect ratio when omitted. */
+    layoutTier?: ShrineLayoutTier;
+}
+export declare const SHRINE_SURFACE_PRESETS: Record<ShrineSurfacePresetId, {
+    width: number;
+    height: number;
+    circularMask?: boolean;
+    layoutTier?: ShrineLayoutTier;
+}>;
+export declare const DEFAULT_SHRINE_SURFACE_PRESET: ShrineSurfacePresetId;
+/** Default HTTP port for CAM Web Integration (state socket stays on 9742). */
+export declare const DEFAULT_SHRINE_HTTP_PORT = 9743;
+export interface ResolveShrineSurfaceInput {
+    surfaceEnv?: string | undefined;
+    widthEnv?: string | undefined;
+    heightEnv?: string | undefined;
+    configSurface?: string | undefined;
+}
+export declare function resolveShrineSurface(input?: ResolveShrineSurfaceInput): ShrineSurface;
+/** All surfaces now run as HTTP — Electron removed in Phase 4.1. Always returns true. */
+export declare function isHttpShrineSurface(_surface: ShrineSurface): boolean;
+export declare function shrineHttpPort(): number;
+export declare function shrineHttpUrl(port?: number): string;
+//# sourceMappingURL=shrine-surface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shrine-surface.d.ts","sourceRoot":"","sources":["../../src/shared/shrine-surface.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAC7B,eAAe,GACf,YAAY,GACZ,iBAAiB,GACjB,iBAAiB,CAAC;AAEtB,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,qBAAqB,GAAG,QAAQ,CAAC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qEAAqE;IACrE,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED,eAAO,MAAM,sBAAsB,EAAE,MAAM,CACzC,qBAAqB,EACrB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAWzF,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,qBAAuC,CAAC;AAEpF,8EAA8E;AAC9E,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,MAAM,WAAW,yBAAyB;IACxC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAiBD,wBAAgB,oBAAoB,CAAC,KAAK,GAAE,yBAA8B,GAAG,aAAa,CA6BzF;AAED,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAEpE;AAED,wBAAgB,cAAc,IAAI,MAAM,CAOvC;AAED,wBAAgB,aAAa,CAAC,IAAI,GAAE,MAAyB,GAAG,MAAM,CAErE"}

package/shrine/shared/shrine-surface.js

@@ -0,0 +1,67 @@
+export const SHRINE_SURFACE_PRESETS = {
+    'ultrawide-4-1': { width: 1920, height: 480, layoutTier: 'ultrawide' },
+    'square-1-1': { width: 640, height: 640, layoutTier: 'square' },
+    'widescreen-16-9': { width: 1920, height: 1080, layoutTier: 'widescreen' },
+    'kraken-elite-v2': {
+        width: 640,
+        height: 640,
+        circularMask: true,
+        layoutTier: 'square',
+    },
+};
+export const DEFAULT_SHRINE_SURFACE_PRESET = 'ultrawide-4-1';
+/** Default HTTP port for CAM Web Integration (state socket stays on 9742). */
+export const DEFAULT_SHRINE_HTTP_PORT = 9743;
+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 { preset: 'custom', width, height };
+}
+export function resolveShrineSurface(input = {}) {
+    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 { preset: 'custom', width, height };
+        }
+    }
+    const surfaceRaw = input.surfaceEnv?.trim() ||
+        input.configSurface?.trim() ||
+        process.env.EIDOLA_SHRINE_SURFACE?.trim() ||
+        DEFAULT_SHRINE_SURFACE_PRESET;
+    const custom = parseCustomDimensions(surfaceRaw);
+    if (custom) {
+        return custom;
+    }
+    const preset = SHRINE_SURFACE_PRESETS[surfaceRaw];
+    if (preset) {
+        return { preset: surfaceRaw, ...preset };
+    }
+    const fallback = SHRINE_SURFACE_PRESETS[DEFAULT_SHRINE_SURFACE_PRESET];
+    return { preset: DEFAULT_SHRINE_SURFACE_PRESET, ...fallback };
+}
+/** All surfaces now run as HTTP — Electron removed in Phase 4.1. Always returns true. */
+export function isHttpShrineSurface(_surface) {
+    return true;
+}
+export function shrineHttpPort() {
+    const raw = process.env.EIDOLA_SHRINE_HTTP_PORT?.trim();
+    if (!raw) {
+        return DEFAULT_SHRINE_HTTP_PORT;
+    }
+    const port = Number.parseInt(raw, 10);
+    return Number.isFinite(port) && port > 0 ? port : DEFAULT_SHRINE_HTTP_PORT;
+}
+export function shrineHttpUrl(port = shrineHttpPort()) {
+    return `http://127.0.0.1:${port}/shrine`;
+}
+//# sourceMappingURL=shrine-surface.js.map

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

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

package/shrine/shared/shrine-surface.test.d.ts

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

package/shrine/shared/shrine-surface.test.d.ts.map

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

package/shrine/shared/shrine-surface.test.js

@@ -0,0 +1,35 @@
+import { describe, expect, it } from 'vitest';
+import { resolveShrineSurface, isHttpShrineSurface, shrineHttpUrl } from './shrine-surface.js';
+describe('shrine surface presets', () => {
+    it('defaults to ultrawide-4-1', () => {
+        expect(resolveShrineSurface({})).toEqual({
+            preset: 'ultrawide-4-1',
+            width: 1920,
+            height: 480,
+            layoutTier: 'ultrawide',
+        });
+    });
+    it('resolves square preset', () => {
+        expect(resolveShrineSurface({ configSurface: 'square-1-1' })).toEqual({
+            preset: 'square-1-1',
+            width: 640,
+            height: 640,
+            layoutTier: 'square',
+        });
+    });
+    it('resolves kraken-elite-v2 preset', () => {
+        expect(resolveShrineSurface({ configSurface: 'kraken-elite-v2' })).toEqual({
+            preset: 'kraken-elite-v2',
+            width: 640,
+            height: 640,
+            circularMask: true,
+            layoutTier: 'square',
+        });
+    });
+    it('identifies kraken as HTTP shrine surface', () => {
+        const surface = resolveShrineSurface({ configSurface: 'kraken-elite-v2' });
+        expect(isHttpShrineSurface(surface)).toBe(true);
+        expect(shrineHttpUrl(9743)).toBe('http://127.0.0.1:9743/shrine');
+    });
+});
+//# sourceMappingURL=shrine-surface.test.js.map

package/shrine/shared/shrine-surface.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shrine-surface.test.js","sourceRoot":"","sources":["../../src/shared/shrine-surface.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE/F,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACvC,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,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,CAAC,oBAAoB,CAAC,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACpE,MAAM,EAAE,YAAY;YACpB,KAAK,EAAE,GAAG;YACV,MAAM,EAAE,GAAG;YACX,UAAU,EAAE,QAAQ;SACrB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,oBAAoB,CAAC,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACzE,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,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,OAAO,GAAG,oBAAoB,CAAC,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAC,CAAC;QAC3E,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/shrine/shared/state-socket-client.d.ts

@@ -0,0 +1,30 @@
+import type { StateBroadcast } from '../vendor/mcp.js';
+export type BroadcastHandler = (broadcast: StateBroadcast) => void;
+export interface StateSocketClientOptions {
+    host?: string;
+    port: number;
+    onBroadcast: BroadcastHandler;
+    onConnect?: () => void;
+    onDisconnect?: () => void;
+    reconnectMs?: number;
+}
+export declare class StateSocketClient {
+    private readonly host;
+    private readonly port;
+    private readonly onBroadcast;
+    private readonly onConnect?;
+    private readonly onDisconnect?;
+    private readonly reconnectMs;
+    private socket;
+    private pending;
+    private reconnectTimer;
+    private closed;
+    constructor(options: StateSocketClientOptions);
+    start(): void;
+    stop(): void;
+    private connect;
+    private scheduleReconnect;
+    private handleData;
+}
+export declare function parseBroadcastLine(line: string): StateBroadcast | null;
+//# sourceMappingURL=state-socket-client.d.ts.map

package/shrine/shared/state-socket-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-socket-client.d.ts","sourceRoot":"","sources":["../../src/shared/state-socket-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,MAAM,gBAAgB,GAAG,CAAC,SAAS,EAAE,cAAc,KAAK,IAAI,CAAC;AAEnE,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,gBAAgB,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAa;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,wBAAwB;IAS7C,KAAK,IAAI,IAAI;IAKb,IAAI,IAAI,IAAI;IAUZ,OAAO,CAAC,OAAO;IA2Bf,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,UAAU;CAYnB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CA6BtE"}

package/shrine/shared/state-socket-client.js

@@ -0,0 +1,103 @@
+import { connect } from 'node:net';
+export class StateSocketClient {
+    host;
+    port;
+    onBroadcast;
+    onConnect;
+    onDisconnect;
+    reconnectMs;
+    socket = null;
+    pending = '';
+    reconnectTimer = null;
+    closed = false;
+    constructor(options) {
+        this.host = options.host ?? '127.0.0.1';
+        this.port = options.port;
+        this.onBroadcast = options.onBroadcast;
+        this.onConnect = options.onConnect;
+        this.onDisconnect = options.onDisconnect;
+        this.reconnectMs = options.reconnectMs ?? 2000;
+    }
+    start() {
+        this.closed = false;
+        this.connect();
+    }
+    stop() {
+        this.closed = true;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        this.socket?.destroy();
+        this.socket = null;
+    }
+    connect() {
+        if (this.closed) {
+            return;
+        }
+        const socket = connect({ host: this.host, port: this.port });
+        this.socket = socket;
+        socket.on('connect', () => {
+            this.onConnect?.();
+        });
+        socket.on('data', (chunk) => {
+            this.handleData(chunk.toString('utf8'));
+        });
+        socket.on('close', () => {
+            this.socket = null;
+            this.onDisconnect?.();
+            this.scheduleReconnect();
+        });
+        socket.on('error', () => {
+            socket.destroy();
+        });
+    }
+    scheduleReconnect() {
+        if (this.closed || this.reconnectTimer) {
+            return;
+        }
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.connect();
+        }, this.reconnectMs);
+    }
+    handleData(chunk) {
+        this.pending += chunk;
+        const lines = this.pending.split('\n');
+        this.pending = lines.pop() ?? '';
+        for (const line of lines) {
+            const broadcast = parseBroadcastLine(line);
+            if (broadcast) {
+                this.onBroadcast(broadcast);
+            }
+        }
+    }
+}
+export function parseBroadcastLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed) {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (typeof parsed.protocol_version !== 'string' ||
+            typeof parsed.ts !== 'number' ||
+            typeof parsed.state !== 'string' ||
+            typeof parsed.engram_id !== 'string' ||
+            typeof parsed.expression !== 'string') {
+            return null;
+        }
+        return {
+            protocol_version: parsed.protocol_version,
+            ts: parsed.ts,
+            state: parsed.state,
+            engram_id: parsed.engram_id,
+            expression: parsed.expression,
+            ...(typeof parsed.tool === 'string' ? { tool: parsed.tool } : {}),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=state-socket-client.js.map

package/shrine/shared/state-socket-client.js.map

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

package/shrine/shared/state-socket-client.test.d.ts

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

package/shrine/shared/state-socket-client.test.d.ts.map

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

package/shrine/shared/state-socket-client.test.js

@@ -0,0 +1,20 @@
+import { describe, expect, it } from 'vitest';
+import { parseBroadcastLine } from './state-socket-client.js';
+describe('parseBroadcastLine', () => {
+    it('parses valid broadcast lines', () => {
+        const line = '{"protocol_version":"1.0","ts":1000,"state":"thinking","engram_id":"camina-drummer","expression":"thinking.json"}';
+        expect(parseBroadcastLine(line)).toEqual({
+            protocol_version: '1.0',
+            ts: 1000,
+            state: 'thinking',
+            engram_id: 'camina-drummer',
+            expression: 'thinking.json',
+        });
+    });
+    it('returns null for malformed lines', () => {
+        expect(parseBroadcastLine('')).toBeNull();
+        expect(parseBroadcastLine('not-json')).toBeNull();
+        expect(parseBroadcastLine('{"state":"thinking"}')).toBeNull();
+    });
+});
+//# sourceMappingURL=state-socket-client.test.js.map

package/shrine/shared/state-socket-client.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-socket-client.test.js","sourceRoot":"","sources":["../../src/shared/state-socket-client.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,IAAI,GACR,mHAAmH,CAAC;QACtH,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;YACvC,gBAAgB,EAAE,KAAK;YACvB,EAAE,EAAE,IAAI;YACR,KAAK,EAAE,UAAU;YACjB,SAAS,EAAE,gBAAgB;YAC3B,UAAU,EAAE,eAAe;SAC5B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC1C,MAAM,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAClD,MAAM,CAAC,kBAAkB,CAAC,sBAAsB,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IAChE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/shrine/shared/types.d.ts

@@ -0,0 +1,43 @@
+import type { VesselConfig } from '../vendor/mcp.js';
+import type { StateBroadcast } from '../vendor/mcp.js';
+import type { ShrineSurface } from './shrine-surface.js';
+export declare const SHRINE_CHANNELS: {
+    readonly state: "shrine:state";
+    readonly vesselConfig: "shrine:vessel-config";
+    readonly surface: "shrine:surface";
+    readonly ready: "shrine:ready";
+    readonly log: "shrine:log";
+};
+export type ShrineRendererType = 'lottie' | 'webm' | 'component';
+export interface ShrineVesselConfig {
+    /** Clip format (lottie/webm) or component (Three.js pack) */
+    rendererType: ShrineRendererType;
+    pack: string;
+    idleClip: string;
+    crossfadeMs: number;
+    idleLoops: boolean;
+    approvalIdleMs: number;
+    successHoldMs: number;
+}
+export interface ShrineStatePayload {
+    broadcast: StateBroadcast & {
+        tool?: string;
+    };
+    clipUrl: string;
+    loop: boolean;
+    returnToIdle: boolean;
+    source: 'socket' | 'fallback' | 'approval-idle';
+}
+export interface ShrineSurfacePayload {
+    surface: ShrineSurface;
+}
+export declare function vesselConfigFromYaml(vessel: VesselConfig, pack: string): ShrineVesselConfig;
+/** Busy states loop during hook silence; one-shot states play once then return to idle. */
+export declare function shouldLoopExpression(state: string, idleLoops: boolean): boolean;
+export declare function shouldReturnToIdle(state: string): boolean;
+export declare function buildClipUrl(pack: string, clip: string): string;
+/** HTTP shrine serves vessel assets under `/vessels/`. */
+export declare function buildHttpClipUrl(pack: string, clip: string): string;
+/** Rewrite an `eidola://` clip URL for browser HTTP mode. */
+export declare function toHttpClipUrl(clipUrl: string): string;
+//# sourceMappingURL=types.d.ts.map

package/shrine/shared/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,eAAO,MAAM,eAAe;;;;;;CAMlB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,YAAY,EAAE,kBAAkB,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,cAAc,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,eAAe,CAAC;CACjD;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,aAAa,CAAC;CACxB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAkB3F;AAED,2FAA2F;AAC3F,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAU/E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAYrD"}

package/shrine/shared/types.js

@@ -0,0 +1,58 @@
+export const SHRINE_CHANNELS = {
+    state: 'shrine:state',
+    vesselConfig: 'shrine:vessel-config',
+    surface: 'shrine:surface',
+    ready: 'shrine:ready',
+    log: 'shrine:log',
+};
+export function vesselConfigFromYaml(vessel, pack) {
+    const rendererType = vessel.type === 'component'
+        ? 'component'
+        : vessel.type === 'webm' || vessel.type === 'mp4'
+            ? 'webm'
+            : 'lottie';
+    return {
+        rendererType,
+        pack,
+        idleClip: (vessel.type === 'component' ? vessel.fallback : vessel)?.expressions.idle ?? 'idle.json',
+        crossfadeMs: vessel.transitions.duration_ms,
+        idleLoops: vessel.playback.idle_loops,
+        approvalIdleMs: vessel.playback.approval_idle_ms ?? 3000,
+        successHoldMs: vessel.playback.success_hold_ms ?? 3000,
+    };
+}
+/** Busy states loop during hook silence; one-shot states play once then return to idle. */
+export function shouldLoopExpression(state, idleLoops) {
+    if (state === 'idle') {
+        return idleLoops;
+    }
+    if (state === 'responding' || state === 'error' || state === 'attention' || state === 'success') {
+        return false;
+    }
+    return true;
+}
+export function shouldReturnToIdle(state) {
+    return state === 'responding' || state === 'error' || state === 'attention';
+}
+export function buildClipUrl(pack, clip) {
+    return `eidola://vessel/${encodeURIComponent(pack)}/${encodeURIComponent(clip)}`;
+}
+/** HTTP shrine serves vessel assets under `/vessels/`. */
+export function buildHttpClipUrl(pack, clip) {
+    return `/vessels/${encodeURIComponent(pack)}/${clip.split('/').map(encodeURIComponent).join('/')}`;
+}
+/** Rewrite an `eidola://` clip URL for browser HTTP mode. */
+export function toHttpClipUrl(clipUrl) {
+    if (!clipUrl.startsWith('eidola://vessel/')) {
+        return clipUrl;
+    }
+    const path = clipUrl.slice('eidola://vessel/'.length);
+    const segments = path.split('/').map((segment) => decodeURIComponent(segment));
+    if (segments.length < 2) {
+        return clipUrl;
+    }
+    const pack = segments[0] ?? '';
+    const clip = segments.slice(1).join('/');
+    return buildHttpClipUrl(pack, clip);
+}
+//# sourceMappingURL=types.js.map

package/shrine/shared/types.js.map

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

package/shrine/shared/types.test.d.ts

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

package/shrine/shared/types.test.d.ts.map

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

package/shrine/shared/types.test.js

@@ -0,0 +1,26 @@
+import { describe, expect, it } from 'vitest';
+import { shouldLoopExpression, shouldReturnToIdle } from './types.js';
+describe('playback flags', () => {
+    it('loops idle when configured', () => {
+        expect(shouldLoopExpression('idle', true)).toBe(true);
+        expect(shouldLoopExpression('idle', false)).toBe(false);
+    });
+    it('does not loop one-shot states', () => {
+        expect(shouldLoopExpression('responding', true)).toBe(false);
+        expect(shouldLoopExpression('error', true)).toBe(false);
+        expect(shouldLoopExpression('success', true)).toBe(false);
+    });
+    it('loops sustained busy states during hook silence', () => {
+        expect(shouldLoopExpression('thinking', true)).toBe(true);
+        expect(shouldLoopExpression('working', true)).toBe(true);
+        expect(shouldLoopExpression('searching', true)).toBe(true);
+        expect(shouldLoopExpression('writing', true)).toBe(true);
+    });
+    it('marks return-to-idle states (success uses overlay hold timer)', () => {
+        expect(shouldReturnToIdle('responding')).toBe(true);
+        expect(shouldReturnToIdle('error')).toBe(true);
+        expect(shouldReturnToIdle('success')).toBe(false);
+        expect(shouldReturnToIdle('thinking')).toBe(false);
+    });
+});
+//# sourceMappingURL=types.test.js.map

package/shrine/shared/types.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.test.js","sourceRoot":"","sources":["../../src/shared/types.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEtE,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,oBAAoB,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7D,MAAM,CAAC,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxD,MAAM,CAAC,oBAAoB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,oBAAoB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,CAAC,oBAAoB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,CAAC,oBAAoB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3D,MAAM,CAAC,oBAAoB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClD,MAAM,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/shrine/shared/vessel-resolver.d.ts

@@ -0,0 +1,37 @@
+import { type LoadedEngram } from '../vendor/mcp.js';
+import { type ShrineStatePayload, type ShrineVesselConfig } from './types.js';
+export interface VesselResolverOptions {
+    engramsDir: string;
+    vesselsDir: string;
+}
+export declare class VesselResolver {
+    private readonly engramsDir;
+    private readonly vesselsDir;
+    private activeEngramId;
+    private loaded;
+    private shrineConfig;
+    private lastValidConfig;
+    constructor(options: VesselResolverOptions);
+    getConfig(): ShrineVesselConfig | null;
+    syncEngram(engramId: string): Promise<ShrineVesselConfig | null>;
+    buildStatePayload(broadcast: {
+        state: string;
+        engram_id: string;
+        expression: string;
+        ts: number;
+        protocol_version: string;
+        visual_state?: string;
+        tool?: string;
+    }, source?: ShrineStatePayload['source']): Promise<ShrineStatePayload | null>;
+    private defaultConfig;
+    buildIdlePayload(broadcast: {
+        protocol_version: string;
+        ts: number;
+        engram_id: string;
+    }): Promise<ShrineStatePayload | null>;
+    private resolveClipForConfig;
+    private resolveClip;
+}
+export declare function createDefaultResolver(): VesselResolver;
+export type { LoadedEngram };
+//# sourceMappingURL=vessel-resolver.d.ts.map

package/shrine/shared/vessel-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vessel-resolver.d.ts","sourceRoot":"","sources":["../../src/shared/vessel-resolver.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAKL,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACxB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,cAAc,CAAM;IAC5B,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,YAAY,CAAmC;IACvD,OAAO,CAAC,eAAe,CAAmC;gBAE9C,OAAO,EAAE,qBAAqB;IAK1C,SAAS,IAAI,kBAAkB,GAAG,IAAI;IAIhC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAuBhE,iBAAiB,CACrB,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,EAAE,EAAE,MAAM,CAAC;QACX,gBAAgB,EAAE,MAAM,CAAC;QACzB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,EACD,MAAM,GAAE,kBAAkB,CAAC,QAAQ,CAAY,GAC9C,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IA6BrC,OAAO,CAAC,aAAa;IAgBf,gBAAgB,CACpB,SAAS,EAAE;QACT,gBAAgB,EAAE,MAAM,CAAC;QACzB,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;KACnB,GACA,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;YAuBvB,oBAAoB;YAWpB,WAAW;CAc1B;AAWD,wBAAgB,qBAAqB,IAAI,cAAc,CAMtD;AAED,YAAY,EAAE,YAAY,EAAE,CAAC"}