@eidola.app/cli 0.2.0

package/soul/injection.d.ts

@@ -0,0 +1,13 @@
+export interface SoulInjectionMessage {
+    role: 'user';
+    content: string;
+}
+export interface SoulInjectionPayload {
+    type: 'soul_injection';
+    engram_id: string;
+    messages: SoulInjectionMessage[];
+}
+export declare function wrapSoulAsSystemReminder(soul: string): string;
+export declare function buildSoulInjectionPayload(engramId: string, soul: string): SoulInjectionPayload;
+export declare function isValidSoulInjectionPayload(value: unknown): value is SoulInjectionPayload;
+//# sourceMappingURL=injection.d.ts.map

package/soul/injection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injection.d.ts","sourceRoot":"","sources":["../../src/soul/injection.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,gBAAgB,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CAClC;AAKD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,oBAAoB,CAW9F;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAsBzF"}

package/soul/injection.js

@@ -0,0 +1,36 @@
+const SYSTEM_REMINDER_OPEN = '<system-reminder>';
+const SYSTEM_REMINDER_CLOSE = '</system-reminder>';
+export function wrapSoulAsSystemReminder(soul) {
+    const prose = soul.replace(/\r\n/g, '\n').trim();
+    return `${SYSTEM_REMINDER_OPEN}\n${prose}\n${SYSTEM_REMINDER_CLOSE}`;
+}
+export function buildSoulInjectionPayload(engramId, soul) {
+    return {
+        type: 'soul_injection',
+        engram_id: engramId,
+        messages: [
+            {
+                role: 'user',
+                content: wrapSoulAsSystemReminder(soul),
+            },
+        ],
+    };
+}
+export function isValidSoulInjectionPayload(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const payload = value;
+    if (payload.type !== 'soul_injection' || typeof payload.engram_id !== 'string') {
+        return false;
+    }
+    if (!Array.isArray(payload.messages) || payload.messages.length === 0) {
+        return false;
+    }
+    const first = payload.messages[0];
+    if (first.role !== 'user' || typeof first.content !== 'string') {
+        return false;
+    }
+    return (first.content.startsWith(SYSTEM_REMINDER_OPEN) && first.content.endsWith(SYSTEM_REMINDER_CLOSE));
+}
+//# sourceMappingURL=injection.js.map

package/soul/injection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injection.js","sourceRoot":"","sources":["../../src/soul/injection.ts"],"names":[],"mappings":"AAWA,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AACjD,MAAM,qBAAqB,GAAG,oBAAoB,CAAC;AAEnD,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,OAAO,GAAG,oBAAoB,KAAK,KAAK,KAAK,qBAAqB,EAAE,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,QAAgB,EAAE,IAAY;IACtE,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,SAAS,EAAE,QAAQ;QACnB,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,wBAAwB,CAAC,IAAI,CAAC;aACxC;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAAc;IACxD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,KAA6B,CAAC;IAC9C,IAAI,OAAO,CAAC,IAAI,KAAK,gBAAgB,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC/E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAClC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC/D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,oBAAoB,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAChG,CAAC;AACJ,CAAC"}

package/soul/reinject.d.ts

@@ -0,0 +1,13 @@
+export interface ReinjectStatus {
+    interval: number;
+    turns_since_injection: number;
+    due: boolean;
+}
+export declare class ReinjectTracker {
+    private turnsSinceInjection;
+    reset(): void;
+    getTurnsSinceInjection(): number;
+    recordAssistantTurn(interval: number): boolean;
+    status(interval: number): ReinjectStatus;
+}
+//# sourceMappingURL=reinject.d.ts.map

package/soul/reinject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reinject.d.ts","sourceRoot":"","sources":["../../src/soul/reinject.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,GAAG,EAAE,OAAO,CAAC;CACd;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,mBAAmB,CAAK;IAEhC,KAAK,IAAI,IAAI;IAIb,sBAAsB,IAAI,MAAM;IAIhC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAc9C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc;CAOzC"}

package/soul/reinject.js

@@ -0,0 +1,28 @@
+export class ReinjectTracker {
+    turnsSinceInjection = 0;
+    reset() {
+        this.turnsSinceInjection = 0;
+    }
+    getTurnsSinceInjection() {
+        return this.turnsSinceInjection;
+    }
+    recordAssistantTurn(interval) {
+        if (interval <= 0) {
+            return false;
+        }
+        this.turnsSinceInjection += 1;
+        if (this.turnsSinceInjection >= interval) {
+            this.turnsSinceInjection = 0;
+            return true;
+        }
+        return false;
+    }
+    status(interval) {
+        return {
+            interval,
+            turns_since_injection: this.turnsSinceInjection,
+            due: interval > 0 && this.turnsSinceInjection >= interval,
+        };
+    }
+}
+//# sourceMappingURL=reinject.js.map

package/soul/reinject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reinject.js","sourceRoot":"","sources":["../../src/soul/reinject.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,eAAe;IAClB,mBAAmB,GAAG,CAAC,CAAC;IAEhC,KAAK;QACH,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,sBAAsB;QACpB,OAAO,IAAI,CAAC,mBAAmB,CAAC;IAClC,CAAC;IAED,mBAAmB,CAAC,QAAgB;QAClC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,mBAAmB,IAAI,CAAC,CAAC;QAC9B,IAAI,IAAI,CAAC,mBAAmB,IAAI,QAAQ,EAAE,CAAC;YACzC,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,QAAgB;QACrB,OAAO;YACL,QAAQ;YACR,qBAAqB,EAAE,IAAI,CAAC,mBAAmB;YAC/C,GAAG,EAAE,QAAQ,GAAG,CAAC,IAAI,IAAI,CAAC,mBAAmB,IAAI,QAAQ;SAC1D,CAAC;IACJ,CAAC;CACF"}

package/tools/handlers.d.ts

@@ -0,0 +1,20 @@
+import type { EidolaRuntimeConfig } from '../config.js';
+import type { SessionState } from '../session/state.js';
+import type { StateSocketServer } from '../socket/server.js';
+export interface ToolTextResult {
+    ok: boolean;
+    error?: string;
+    code?: string;
+    [key: string]: unknown;
+}
+export interface EidolaToolHandlers {
+    loadEidolon(engramId: string): Promise<ToolTextResult>;
+    getEidolon(): Promise<ToolTextResult>;
+    listEidolons(): Promise<ToolTextResult>;
+    setExpression(state: string): Promise<ToolTextResult>;
+    awaken(options?: {
+        surface?: string;
+    }): Promise<ToolTextResult>;
+}
+export declare function createToolHandlers(config: EidolaRuntimeConfig, session: SessionState, stateSocket?: StateSocketServer): EidolaToolHandlers;
+//# sourceMappingURL=handlers.d.ts.map

package/tools/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/tools/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAMrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACvD,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IACtC,YAAY,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IACxC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACtD,MAAM,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACjE;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,YAAY,EACrB,WAAW,CAAC,EAAE,iBAAiB,GAC9B,kBAAkB,CAQpB"}

package/tools/handlers.js

@@ -0,0 +1,148 @@
+import { autoActivateFromWorkspace } from '../cursor/auto-activate.js';
+import { launchShrine } from '../cursor/ensure-shrine.js';
+import { detectSoulSource } from '../cursor/soul-source.js';
+import { listEngramDirectories, resolveEngramDirectory } from '../engram/registry.js';
+import { EngramLoadError } from '../engram/types.js';
+import { resolveExpressionClip } from '../socket/expression.js';
+import { buildSoulInjectionPayload } from '../soul/injection.js';
+export function createToolHandlers(config, session, stateSocket) {
+    return {
+        loadEidolon: (engramId) => activateEidolon(config, session, engramId, stateSocket),
+        getEidolon: () => handleGetEidolon(session),
+        listEidolons: () => handleListEidolons(config),
+        setExpression: (state) => handleSetExpression(session, state, stateSocket),
+        awaken: (options) => handleAwaken(config, session, stateSocket, options),
+    };
+}
+async function activateEidolon(config, session, engramId, stateSocket) {
+    let directory;
+    try {
+        directory = resolveEngramDirectory(config.engramsDir, engramId);
+    }
+    catch (error) {
+        return toolError(error);
+    }
+    try {
+        const soulSource = await detectSoulSource(config.workspaceRoot, engramId);
+        const loaded = await session.load(directory, soulSource);
+        const soulInjection = soulSource === 'injection'
+            ? buildSoulInjectionPayload(loaded.engram.id, loaded.soul)
+            : null;
+        const broadcast = stateSocket?.broadcastState({ state: 'success', surface: 'manual' });
+        return {
+            ok: true,
+            engram_id: loaded.engram.id,
+            name: loaded.engram.name,
+            soul_source: soulSource,
+            soul_injection: soulInjection,
+            expression: broadcast?.expression ?? loaded.vessel.expressions.success ?? 'responding.json',
+        };
+    }
+    catch (error) {
+        if (error instanceof EngramLoadError) {
+            return {
+                ok: false,
+                error: error.message,
+                code: error.code,
+                engram_id: engramId,
+            };
+        }
+        return toolError(error);
+    }
+}
+async function handleGetEidolon(session) {
+    const snapshot = session.snapshot();
+    if (!snapshot) {
+        return {
+            ok: false,
+            error: 'No active Eidolon. Call load_eidolon first.',
+            code: 'NO_ACTIVE_EIDOLON',
+            soul_source: 'none',
+        };
+    }
+    return {
+        ok: true,
+        ...snapshot,
+    };
+}
+async function handleListEidolons(paths) {
+    const entries = await listEngramDirectories(paths.engramsDir);
+    return {
+        ok: true,
+        engrams: entries.map((entry) => ({
+            id: entry.id,
+            name: entry.name,
+            description: entry.description,
+            directory: entry.directory,
+        })),
+    };
+}
+async function handleSetExpression(session, state, stateSocket) {
+    const trimmed = state.trim();
+    if (!trimmed) {
+        return {
+            ok: false,
+            error: 'Expression state must be a non-empty string.',
+            code: 'INVALID_EXPRESSION',
+        };
+    }
+    const active = session.getActive();
+    if (!active) {
+        return {
+            ok: false,
+            error: 'No active Eidolon. Call load_eidolon first.',
+            code: 'NO_ACTIVE_EIDOLON',
+        };
+    }
+    session.setExpression(trimmed);
+    const clip = resolveExpressionClip(trimmed, active.vessel);
+    const broadcast = stateSocket?.broadcastState({ state: trimmed, surface: 'manual' });
+    return {
+        ok: true,
+        engram_id: active.engram.id,
+        expression: trimmed,
+        clip: broadcast?.expression ?? clip,
+        mapped: (broadcast?.expression ?? clip) !== null,
+    };
+}
+async function handleAwaken(config, session, stateSocket, options) {
+    const result = await launchShrine(config, undefined, {
+        requestedSurface: options?.surface,
+    });
+    if (result.skipped) {
+        return {
+            ok: false,
+            error: `Shrine launch skipped (${result.reason ?? 'unknown'})`,
+            code: 'SHRINE_LAUNCH_SKIPPED',
+            reason: result.reason,
+        };
+    }
+    const ok = result.launched || result.alreadyRunning;
+    if (ok) {
+        await autoActivateFromWorkspace(config, session, stateSocket);
+    }
+    const active = session.getActive();
+    const broadcast = ok && active
+        ? stateSocket?.broadcastState({ state: 'success', surface: 'manual' })
+        : undefined;
+    return {
+        ok,
+        launched: result.launched,
+        already_running: result.alreadyRunning,
+        surface: result.surface,
+        pid: result.pid,
+        mode: result.mode,
+        url: result.url,
+        restarted: result.restarted,
+        ...(broadcast?.expression ? { expression: broadcast.expression } : {}),
+    };
+}
+function toolError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        ok: false,
+        error: message,
+        code: 'INTERNAL_ERROR',
+    };
+}
+//# sourceMappingURL=handlers.js.map

package/tools/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/tools/handlers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAiBjE,MAAM,UAAU,kBAAkB,CAChC,MAA2B,EAC3B,OAAqB,EACrB,WAA+B;IAE/B,OAAO;QACL,WAAW,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC;QAClF,UAAU,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC;QAC3C,YAAY,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC;QAC9C,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC;QAC1E,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC;KACzE,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,MAA2B,EAC3B,OAAqB,EACrB,QAAgB,EAChB,WAA+B;IAE/B,IAAI,SAAiB,CAAC;IACtB,IAAI,CAAC;QACH,SAAS,GAAG,sBAAsB,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAClE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACzD,MAAM,aAAa,GACjB,UAAU,KAAK,WAAW;YACxB,CAAC,CAAC,yBAAyB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC;YAC1D,CAAC,CAAC,IAAI,CAAC;QACX,MAAM,SAAS,GAAG,WAAW,EAAE,cAAc,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEvF,OAAO;YACL,EAAE,EAAE,IAAI;YACR,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE;YAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI;YACxB,WAAW,EAAE,UAAU;YACvB,cAAc,EAAE,aAAa;YAC7B,UAAU,EAAE,SAAS,EAAE,UAAU,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,IAAI,iBAAiB;SAC5F,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;YACrC,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,KAAK,CAAC,OAAO;gBACpB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,SAAS,EAAE,QAAQ;aACpB,CAAC;QACJ,CAAC;QAED,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,OAAqB;IACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IACpC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,6CAA6C;YACpD,IAAI,EAAE,mBAAmB;YACzB,WAAW,EAAE,MAAM;SACpB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI;QACR,GAAG,QAAQ;KACZ,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,KAAkB;IAClD,MAAM,OAAO,GAAG,MAAM,qBAAqB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC9D,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC/B,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,OAAqB,EACrB,KAAa,EACb,WAA+B;IAE/B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,8CAA8C;YACrD,IAAI,EAAE,oBAAoB;SAC3B,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,6CAA6C;YACpD,IAAI,EAAE,mBAAmB;SAC1B,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAE/B,MAAM,IAAI,GAAG,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,WAAW,EAAE,cAAc,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IAErF,OAAO;QACL,EAAE,EAAE,IAAI;QACR,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE;QAC3B,UAAU,EAAE,OAAO;QACnB,IAAI,EAAE,SAAS,EAAE,UAAU,IAAI,IAAI;QACnC,MAAM,EAAE,CAAC,SAAS,EAAE,UAAU,IAAI,IAAI,CAAC,KAAK,IAAI;KACjD,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,MAA2B,EAC3B,OAAqB,EACrB,WAA0C,EAC1C,OAA8B;IAE9B,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE;QACnD,gBAAgB,EAAE,OAAO,EAAE,OAAO;KACnC,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,0BAA0B,MAAM,CAAC,MAAM,IAAI,SAAS,GAAG;YAC9D,IAAI,EAAE,uBAAuB;YAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,cAAc,CAAC;IACpD,IAAI,EAAE,EAAE,CAAC;QACP,MAAM,yBAAyB,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IACnC,MAAM,SAAS,GACb,EAAE,IAAI,MAAM;QACV,CAAC,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;QACtE,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO;QACL,EAAE;QACF,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,eAAe,EAAE,MAAM,CAAC,cAAc;QACtC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvE,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO;QACL,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,gBAAgB;KACvB,CAAC;AACJ,CAAC"}

package/tools/register.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { EidolaToolHandlers } from './handlers.js';
+export declare function registerEidolaTools(server: McpServer, handlers: EidolaToolHandlers): void;
+//# sourceMappingURL=register.d.ts.map

package/tools/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/tools/register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAaxD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CA8DzF"}

package/tools/register.js

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+function jsonResult(payload) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(payload, null, 2),
+            },
+        ],
+    };
+}
+export function registerEidolaTools(server, handlers) {
+    server.registerTool('load_eidolon', {
+        title: 'Load Eidolon',
+        description: 'Load an Engram by id and inject its Soul as a system-reminder in the messages array.',
+        inputSchema: {
+            engram_id: z.string().describe('Engram directory id (e.g. camina-drummer)'),
+        },
+    }, async ({ engram_id }) => jsonResult(await handlers.loadEidolon(engram_id)));
+    server.registerTool('get_eidolon', {
+        title: 'Get Active Eidolon',
+        description: 'Return the active Eidolon metadata, vessel config, expression override, and reinject status.',
+        inputSchema: {},
+    }, async () => jsonResult(await handlers.getEidolon()));
+    server.registerTool('list_eidolons', {
+        title: 'List Eidolons',
+        description: 'Enumerate Engram directories available under engrams/.',
+        inputSchema: {},
+    }, async () => jsonResult(await handlers.listEidolons()));
+    server.registerTool('awaken', {
+        title: 'Awaken',
+        description: 'Start the Eidola Shrine HTTP server for browser-based display surfaces. Idempotent when the same surface is already running.',
+        inputSchema: {
+            surface: z
+                .string()
+                .optional()
+                .describe('Shrine surface preset or alias — use "kraken" for NZXT Kraken LCD'),
+        },
+    }, async ({ surface }) => jsonResult(await handlers.awaken(surface ? { surface } : undefined)));
+    server.registerTool('set_expression', {
+        title: 'Set Expression',
+        description: 'Manually override the active Vessel expression state for testing.',
+        inputSchema: {
+            state: z.string().describe('Expression state key from vessel.yaml (e.g. idle, thinking)'),
+        },
+    }, async ({ state }) => jsonResult(await handlers.setExpression(state)));
+}
+//# sourceMappingURL=register.js.map

package/tools/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../src/tools/register.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,SAAS,UAAU,CAAC,OAAgB;IAClC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;aACvC;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,QAA4B;IACjF,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,sFAAsF;QACxF,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;SAC5E;KACF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAC3E,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,8FAA8F;QAChG,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC,CACpD,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,wDAAwD;QACrE,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE,CAAC,CACtD,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,QAAQ,EACR;QACE,KAAK,EAAE,QAAQ;QACf,WAAW,EACT,8HAA8H;QAChI,WAAW,EAAE;YACX,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,mEAAmE,CAAC;SACjF;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAC5F,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,mEAAmE;QAChF,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;SAC1F;KACF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CACrE,CAAC;AACJ,CAAC"}

package/vendor/tool-state-pkg/index.d.ts

@@ -0,0 +1,23 @@
+export declare const LEGACY_VESSEL_STATE_ALIASES: Record<string, string>;
+/** Map legacy vessel state names to canonical keys. */
+export declare function normalizeVesselState(state: string): string;
+/** Remap legacy expression keys to canonical; prefer canonical when both exist. */
+export declare function normalizeExpressionKeys(expressions: Record<string, string>): Record<string, string>;
+export declare const TOOL_AWARE_STATES: readonly ["searching", "writing", "working"];
+/** Semantic states that collapse to visual `working` after the first tool hook in a turn. */
+export declare const WORKING_CLUSTER: readonly ["thinking", "searching", "writing", "working"];
+export type WorkingClusterState = (typeof WORKING_CLUSTER)[number];
+export declare function isWorkingClusterState(state: string): state is WorkingClusterState;
+export interface ResolveVisualStateInput {
+    state: string;
+    firstToolStarted: boolean;
+}
+/** Map semantic vessel state + turn lock to a visual tier for renderer/clip playback. */
+export declare function resolveVisualState({ state, firstToolStarted }: ResolveVisualStateInput): string;
+export type ToolAwareState = (typeof TOOL_AWARE_STATES)[number];
+export declare function isSkillPath(path: string): boolean;
+export declare function extractReadPath(toolInput: unknown): string | undefined;
+export declare function extractSubagentType(toolInput: unknown): string | undefined;
+export declare function resolveStateFromTool(toolName: string | undefined, hookName: string, toolInput?: unknown): ToolAwareState;
+export declare function refineGenericWorkingState(state: string, tool: string | undefined, toolInput?: unknown): string;
+//# sourceMappingURL=index.d.ts.map

package/vendor/tool-state-pkg/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAI9D,CAAC;AAEF,uDAAuD;AACvD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,mFAAmF;AACnF,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoBxB;AAED,eAAO,MAAM,iBAAiB,8CAA+C,CAAC;AAE9E,6FAA6F;AAC7F,eAAO,MAAM,eAAe,0DAA2D,CAAC;AAExF,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,mBAAmB,CAEjF;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,uBAAuB,GAAG,MAAM,CAQ/F;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAkChE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQjD;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAetE;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAW1E;AAmBD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,OAAO,GAClB,cAAc,CAwBhB;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,SAAS,CAAC,EAAE,OAAO,GAClB,MAAM,CAMR"}

package/vendor/tool-state-pkg/index.js

@@ -0,0 +1,140 @@
+export const LEGACY_VESSEL_STATE_ALIASES = {
+    completed: 'success',
+    confused: 'error',
+    alerting: 'attention',
+};
+/** Map legacy vessel state names to canonical keys. */
+export function normalizeVesselState(state) {
+    return LEGACY_VESSEL_STATE_ALIASES[state] ?? state;
+}
+/** Remap legacy expression keys to canonical; prefer canonical when both exist. */
+export function normalizeExpressionKeys(expressions) {
+    const result = {};
+    const legacyPending = [];
+    for (const [key, clip] of Object.entries(expressions)) {
+        const canonical = normalizeVesselState(key);
+        if (key === canonical) {
+            result[canonical] = clip;
+        }
+        else {
+            legacyPending.push([canonical, clip]);
+        }
+    }
+    for (const [canonical, clip] of legacyPending) {
+        if (!(canonical in result)) {
+            result[canonical] = clip;
+        }
+    }
+    return result;
+}
+export const TOOL_AWARE_STATES = ['searching', 'writing', 'working'];
+/** Semantic states that collapse to visual `working` after the first tool hook in a turn. */
+export const WORKING_CLUSTER = ['thinking', 'searching', 'writing', 'working'];
+export function isWorkingClusterState(state) {
+    return WORKING_CLUSTER.includes(state);
+}
+/** Map semantic vessel state + turn lock to a visual tier for renderer/clip playback. */
+export function resolveVisualState({ state, firstToolStarted }) {
+    if (isWorkingClusterState(state)) {
+        if (state === 'thinking' && !firstToolStarted) {
+            return 'thinking';
+        }
+        return 'working';
+    }
+    return state;
+}
+const SEARCH_TOOLS = new Set([
+    'Grep',
+    'Glob',
+    'Read',
+    'SemanticSearch',
+    'TabRead',
+]);
+const WRITE_TOOLS = new Set([
+    'Write',
+    'StrReplace',
+    'EditNotebook',
+    'Delete',
+    'TabWrite',
+]);
+const WORKING_TOOLS = new Set(['Shell', 'Task', 'CallMcpTool']);
+const TOOL_AWARE_HOOKS = new Set([
+    'preToolUse',
+    'beforeShellExecution',
+    'beforeMCPExecution',
+]);
+const WORKING_HOOK_DEFAULT = 'working';
+const SEARCH_SUBAGENT_TYPES = new Set(['explore', 'generalPurpose']);
+function normalizePath(path) {
+    return path.replace(/\\/g, '/');
+}
+export function isSkillPath(path) {
+    const normalized = normalizePath(path);
+    return (normalized.endsWith('/SKILL.md') ||
+        normalized.endsWith('SKILL.md') ||
+        normalized.includes('/.cursor/skills/') ||
+        normalized.includes('/skills-cursor/'));
+}
+export function extractReadPath(toolInput) {
+    if (!toolInput || typeof toolInput !== 'object' || Array.isArray(toolInput)) {
+        return undefined;
+    }
+    const input = toolInput;
+    if (typeof input.path === 'string' && input.path.length > 0) {
+        return input.path;
+    }
+    if (typeof input.file_path === 'string' && input.file_path.length > 0) {
+        return input.file_path;
+    }
+    return undefined;
+}
+export function extractSubagentType(toolInput) {
+    if (!toolInput || typeof toolInput !== 'object' || Array.isArray(toolInput)) {
+        return undefined;
+    }
+    const input = toolInput;
+    if (typeof input.subagent_type === 'string' && input.subagent_type.length > 0) {
+        return input.subagent_type;
+    }
+    return undefined;
+}
+function isMcpToolName(toolName) {
+    return toolName.startsWith('mcp__') || toolName.startsWith('mcp_');
+}
+function resolveTaskState(toolInput) {
+    const subagentType = extractSubagentType(toolInput);
+    if (subagentType && SEARCH_SUBAGENT_TYPES.has(subagentType)) {
+        return 'searching';
+    }
+    if (subagentType === 'shell') {
+        return 'working';
+    }
+    return 'working';
+}
+export function resolveStateFromTool(toolName, hookName, toolInput) {
+    if (toolName === 'Task') {
+        return resolveTaskState(toolInput);
+    }
+    if (toolName) {
+        if (SEARCH_TOOLS.has(toolName)) {
+            return 'searching';
+        }
+        if (WRITE_TOOLS.has(toolName)) {
+            return 'writing';
+        }
+        if (WORKING_TOOLS.has(toolName) || isMcpToolName(toolName)) {
+            return 'working';
+        }
+    }
+    if (TOOL_AWARE_HOOKS.has(hookName)) {
+        return WORKING_HOOK_DEFAULT;
+    }
+    return WORKING_HOOK_DEFAULT;
+}
+export function refineGenericWorkingState(state, tool, toolInput) {
+    if (state !== 'working' || !tool) {
+        return state;
+    }
+    return resolveStateFromTool(tool, 'preToolUse', toolInput);
+}
+//# sourceMappingURL=index.js.map

package/vendor/tool-state-pkg/index.js.map

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

package/vendor/tool-state.d.ts

@@ -0,0 +1,3 @@
+/** Bundled @eidola/tool-state — publish build copies dist into vendor/tool-state-pkg. */
+export * from './tool-state-pkg/index.js';
+//# sourceMappingURL=tool-state.d.ts.map

package/vendor/tool-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-state.d.ts","sourceRoot":"","sources":["../../src/vendor/tool-state.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,cAAc,oBAAoB,CAAC"}

package/vendor/tool-state.js

@@ -0,0 +1,3 @@
+/** Bundled @eidola/tool-state — publish build copies dist into vendor/tool-state-pkg. */
+export * from './tool-state-pkg/index.js';
+//# sourceMappingURL=tool-state.js.map

package/vendor/tool-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-state.js","sourceRoot":"","sources":["../../src/vendor/tool-state.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,cAAc,oBAAoB,CAAC"}

package/watch/filesystem.d.ts

@@ -0,0 +1,7 @@
+import type { EidolaPaths } from '../config.js';
+import type { SessionState } from '../session/state.js';
+export interface FilesystemWatchHandle {
+    close(): void;
+}
+export declare function watchEidolaPaths(paths: EidolaPaths, session: SessionState, onReload?: (reason: string) => void): FilesystemWatchHandle;
+//# sourceMappingURL=filesystem.d.ts.map

package/watch/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/watch/filesystem.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIxD,MAAM,WAAW,qBAAqB;IACpC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,YAAY,EACrB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAClC,qBAAqB,CAoDvB"}

package/watch/filesystem.js

@@ -0,0 +1,66 @@
+import { watch } from 'node:fs';
+import { join } from 'node:path';
+import { EngramLoadError } from '../engram/types.js';
+const DEBOUNCE_MS = 250;
+export function watchEidolaPaths(paths, session, onReload) {
+    const watchers = [];
+    const timers = new Map();
+    const scheduleReload = (label, directory) => {
+        const key = `${label}:${directory}`;
+        const existing = timers.get(key);
+        if (existing) {
+            clearTimeout(existing);
+        }
+        timers.set(key, setTimeout(() => {
+            timers.delete(key);
+            void reloadActive(session, onReload, `${label} change in ${directory}`);
+        }, DEBOUNCE_MS));
+    };
+    for (const directory of [paths.engramsDir, paths.vesselsDir]) {
+        try {
+            const watcher = watch(directory, { recursive: true }, (_event, filename) => {
+                if (!filename) {
+                    scheduleReload('directory', directory);
+                    return;
+                }
+                scheduleReload('file', join(directory, filename.toString()));
+            });
+            watcher.on('error', () => {
+                // Non-fatal — watcher may fail on some platforms for recursive watch.
+            });
+            watchers.push(watcher);
+        }
+        catch {
+            // Directory may not exist yet; server still runs.
+        }
+    }
+    return {
+        close() {
+            for (const timer of timers.values()) {
+                clearTimeout(timer);
+            }
+            timers.clear();
+            for (const watcher of watchers) {
+                watcher.close();
+            }
+        },
+    };
+}
+async function reloadActive(session, onReload, reason) {
+    const active = session.getActive();
+    if (!active) {
+        return;
+    }
+    try {
+        await session.reloadActive();
+        onReload?.(reason);
+    }
+    catch (error) {
+        if (error instanceof EngramLoadError) {
+            onReload?.(`hot-reload failed: ${error.message}`);
+            return;
+        }
+        onReload?.(`hot-reload failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=filesystem.js.map

package/watch/filesystem.js.map

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