@eidola.app/cli 0.2.0

package/engram/parse.js

@@ -0,0 +1,190 @@
+import { normalizeExpressionKeys } from '../vendor/tool-state.js';
+import { EngramLoadError } from './types.js';
+import { validateEngramVersion } from './validate.js';
+function requireString(value, field) {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        throw new EngramLoadError(`Missing or invalid required field "${field}".`, 'INVALID_FIELD');
+    }
+    return value;
+}
+function requireNumber(value, field) {
+    if (typeof value !== 'number' || Number.isNaN(value)) {
+        throw new EngramLoadError(`Missing or invalid required field "${field}".`, 'INVALID_FIELD');
+    }
+    return value;
+}
+function requireObject(value, field) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new EngramLoadError(`Missing or invalid required field "${field}".`, 'INVALID_FIELD');
+    }
+    return value;
+}
+export function parseEngramYaml(raw) {
+    const data = requireObject(raw, 'engram.yaml root');
+    const engramVersion = requireString(data.engram_version, 'engram_version');
+    validateEngramVersion(engramVersion);
+    const metaRaw = requireObject(data.meta, 'meta');
+    const extensionsRaw = data.extensions;
+    if (extensionsRaw === undefined) {
+        throw new EngramLoadError('Missing or invalid required field "extensions".', 'INVALID_FIELD');
+    }
+    if (!extensionsRaw || typeof extensionsRaw !== 'object' || Array.isArray(extensionsRaw)) {
+        throw new EngramLoadError('Missing or invalid required field "extensions".', 'INVALID_FIELD');
+    }
+    const voiceId = data.voice_id;
+    if (voiceId !== null && typeof voiceId !== 'string') {
+        throw new EngramLoadError('Field "voice_id" must be a string or null.', 'INVALID_FIELD');
+    }
+    const tagsRaw = metaRaw.tags;
+    let tags;
+    if (tagsRaw !== undefined) {
+        if (!Array.isArray(tagsRaw) || tagsRaw.some((tag) => typeof tag !== 'string')) {
+            throw new EngramLoadError('Field "meta.tags" must be an array of strings.', 'INVALID_FIELD');
+        }
+        tags = tagsRaw;
+    }
+    const descriptionRaw = metaRaw.description;
+    const description = descriptionRaw === undefined
+        ? undefined
+        : typeof descriptionRaw === 'string'
+            ? descriptionRaw
+            : (() => {
+                throw new EngramLoadError('Field "meta.description" must be a string.', 'INVALID_FIELD');
+            })();
+    return {
+        engram_version: engramVersion,
+        id: requireString(data.id, 'id'),
+        name: requireString(data.name, 'name'),
+        reinject_interval: requireNumber(data.reinject_interval, 'reinject_interval'),
+        voice_id: voiceId ?? null,
+        meta: {
+            author: requireString(metaRaw.author, 'meta.author'),
+            created: requireString(metaRaw.created, 'meta.created'),
+            ...(description !== undefined ? { description } : {}),
+            ...(tags !== undefined ? { tags } : {}),
+        },
+        extensions: { ...extensionsRaw },
+    };
+}
+function parseExpressions(data, required) {
+    const expressions = {};
+    if (!data.expressions) {
+        if (required) {
+            requireObject(data.expressions, 'expressions'); // throws
+        }
+        return expressions;
+    }
+    const expressionsRaw = requireObject(data.expressions, 'expressions');
+    for (const [state, clip] of Object.entries(expressionsRaw)) {
+        if (typeof clip !== 'string' || clip.trim().length === 0) {
+            if (required) {
+                throw new EngramLoadError(`Expression "${state}" must map to a clip filename.`, 'INVALID_FIELD');
+            }
+            continue;
+        }
+        expressions[state] = clip;
+    }
+    return normalizeExpressionKeys(expressions);
+}
+function parseTransitionsAndPlayback(data) {
+    const transitionsRaw = data.transitions && typeof data.transitions === 'object' && !Array.isArray(data.transitions)
+        ? data.transitions
+        : {};
+    // For component renderers, transitions.default may be an object; treat as crossfade
+    const transitionDefaultRaw = transitionsRaw.default;
+    const transitionDefaultStr = typeof transitionDefaultRaw === 'object' ? 'crossfade' : transitionDefaultRaw;
+    const defaultTransition = transitionDefaultStr === undefined
+        ? 'crossfade'
+        : transitionDefaultStr === 'crossfade' || transitionDefaultStr === 'cut'
+            ? transitionDefaultStr
+            : (() => {
+                throw new EngramLoadError('Field "transitions.default" must be "crossfade" or "cut".', 'INVALID_FIELD');
+            })();
+    const durationRaw = transitionsRaw.duration_ms;
+    const durationMs = durationRaw === undefined
+        ? 300
+        : typeof durationRaw === 'number' && !Number.isNaN(durationRaw)
+            ? durationRaw
+            : (() => {
+                throw new EngramLoadError('Field "transitions.duration_ms" must be a number.', 'INVALID_FIELD');
+            })();
+    const playbackRaw = data.playback && typeof data.playback === 'object' && !Array.isArray(data.playback)
+        ? data.playback
+        : {};
+    const idleLoopsRaw = playbackRaw.idle_loops;
+    const idleLoops = idleLoopsRaw === undefined
+        ? true
+        : typeof idleLoopsRaw === 'boolean'
+            ? idleLoopsRaw
+            : (() => {
+                throw new EngramLoadError('Field "playback.idle_loops" must be a boolean.', 'INVALID_FIELD');
+            })();
+    const approvalIdleMsRaw = playbackRaw.approval_idle_ms;
+    const approvalIdleMs = approvalIdleMsRaw === undefined
+        ? 3000
+        : typeof approvalIdleMsRaw === 'number' && !Number.isNaN(approvalIdleMsRaw)
+            ? approvalIdleMsRaw
+            : (() => {
+                throw new EngramLoadError('Field "playback.approval_idle_ms" must be a number.', 'INVALID_FIELD');
+            })();
+    const successHoldMsRaw = playbackRaw.success_hold_ms ?? playbackRaw.completed_hold_ms;
+    const successHoldMs = successHoldMsRaw === undefined
+        ? 3000
+        : typeof successHoldMsRaw === 'number' && !Number.isNaN(successHoldMsRaw)
+            ? successHoldMsRaw
+            : (() => {
+                throw new EngramLoadError('Field "playback.success_hold_ms" must be a number.', 'INVALID_FIELD');
+            })();
+    return {
+        transitions: { default: defaultTransition, duration_ms: durationMs },
+        playback: {
+            idle_loops: idleLoops,
+            approval_idle_ms: approvalIdleMs,
+            success_hold_ms: successHoldMs,
+        },
+    };
+}
+export function parseVesselYaml(raw) {
+    const data = requireObject(raw, 'vessel.yaml root');
+    const type = data.type;
+    if (type !== 'lottie' &&
+        type !== 'webm' &&
+        type !== 'mp4' &&
+        type !== 'gif' &&
+        type !== 'component') {
+        throw new EngramLoadError('Field "type" must be "lottie", "webm", "mp4", "gif", or "component".', 'INVALID_FIELD');
+    }
+    // component renderers manage expressions internally; lottie/webm require them
+    const expressions = parseExpressions(data, type !== 'component');
+    // Parse optional fallback block (present when type === 'component')
+    let fallback;
+    if (type === 'component' &&
+        data.fallback &&
+        typeof data.fallback === 'object' &&
+        !Array.isArray(data.fallback)) {
+        const fb = data.fallback;
+        const fbExpressions = parseExpressions(fb, true);
+        const { transitions: fbTransitions, playback: fbPlayback } = parseTransitionsAndPlayback(fb);
+        const fbType = fb.type;
+        if (fbType !== 'lottie' && fbType !== 'webm' && fbType !== 'mp4' && fbType !== 'gif') {
+            throw new EngramLoadError('Field "fallback.type" must be "lottie", "webm", "mp4", or "gif".', 'INVALID_FIELD');
+        }
+        fallback = {
+            type: fbType,
+            pack: requireString(fb.pack, 'fallback.pack'),
+            expressions: fbExpressions,
+            transitions: fbTransitions,
+            playback: fbPlayback,
+        };
+    }
+    const { transitions, playback } = parseTransitionsAndPlayback(data);
+    return {
+        type,
+        pack: requireString(data.pack, 'pack'),
+        expressions,
+        transitions,
+        playback,
+        ...(fallback !== undefined ? { fallback } : {}),
+    };
+}
+//# sourceMappingURL=parse.js.map

package/engram/parse.js.map

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

package/engram/registry.d.ts

@@ -0,0 +1,9 @@
+export interface EngramListEntry {
+    id: string;
+    name?: string;
+    description?: string;
+    directory: string;
+}
+export declare function listEngramDirectories(engramsDir: string): Promise<EngramListEntry[]>;
+export declare function resolveEngramDirectory(engramsDir: string, engramId: string): string;
+//# sourceMappingURL=registry.d.ts.map

package/engram/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/engram/registry.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CA+B1F;AAiBD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOnF"}

package/engram/registry.js

@@ -0,0 +1,54 @@
+import { readFile, readdir, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import yaml from 'js-yaml';
+import { parseEngramYaml } from './parse.js';
+export async function listEngramDirectories(engramsDir) {
+    let entries;
+    try {
+        entries = await readdir(engramsDir);
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    }
+    const results = [];
+    for (const entry of entries) {
+        const directory = join(engramsDir, entry);
+        const info = await stat(directory);
+        if (!info.isDirectory()) {
+            continue;
+        }
+        const metadata = await readEngramListMetadata(directory);
+        results.push({
+            id: entry,
+            name: metadata?.name,
+            description: metadata?.description,
+            directory,
+        });
+    }
+    return results.sort((a, b) => a.id.localeCompare(b.id));
+}
+async function readEngramListMetadata(directory) {
+    try {
+        const raw = yaml.load(await readFile(join(directory, 'engram.yaml'), 'utf8'));
+        const config = parseEngramYaml(raw);
+        return {
+            name: config.name,
+            description: config.meta.description,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export function resolveEngramDirectory(engramsDir, engramId) {
+    const normalized = engramId.trim();
+    if (!normalized || normalized.includes('..') || /[/\\]/.test(normalized)) {
+        throw new Error(`Invalid engram_id "${engramId}".`);
+    }
+    return join(engramsDir, normalized);
+}
+//# sourceMappingURL=registry.js.map

package/engram/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/engram/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAS7C,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,UAAkB;IAC5D,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;QACnD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,SAAS,CAAC,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,QAAQ,EAAE,IAAI;YACpB,WAAW,EAAE,QAAQ,EAAE,WAAW;YAClC,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,KAAK,UAAU,sBAAsB,CACnC,SAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QAC9E,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QACpC,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW;SACrC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,UAAkB,EAAE,QAAgB;IACzE,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AACtC,CAAC"}

package/engram/types.d.ts

@@ -0,0 +1,58 @@
+export declare const SUPPORTED_ENGRAM_MAJOR = 1;
+export interface EngramMeta {
+    author: string;
+    created: string;
+    description?: string;
+    tags?: string[];
+}
+export interface EngramConfig {
+    engram_version: string;
+    id: string;
+    name: string;
+    reinject_interval: number;
+    voice_id: string | null;
+    meta: EngramMeta;
+    extensions: Record<string, unknown>;
+}
+export type VesselType = 'lottie' | 'webm' | 'mp4' | 'gif' | 'component';
+export interface VesselTransitions {
+    default: 'crossfade' | 'cut';
+    duration_ms: number;
+}
+export interface VesselPlayback {
+    idle_loops: boolean;
+    /** Mid-turn approval idle timer (ms). Overlay-only; default 3000. */
+    approval_idle_ms?: number;
+    /** How long overlay holds `success` before returning to idle. Overlay-only; default 3000. */
+    success_hold_ms?: number;
+}
+export interface VesselConfig {
+    type: VesselType;
+    pack: string;
+    /** Expression map — required for lottie/webm, omitted for component renderers */
+    expressions: Record<string, string>;
+    transitions: VesselTransitions;
+    playback: VesselPlayback;
+    /**
+     * Lottie fallback for overlays that don't support component renderers.
+     * Present when type === 'component'.
+     */
+    fallback?: Omit<VesselConfig, 'fallback'>;
+}
+export interface LoadedEngram {
+    directory: string;
+    soul: string;
+    engram: EngramConfig;
+    vessel: VesselConfig;
+}
+export interface EngramDirectoryOutput {
+    soul: string;
+    vessel: VesselConfig;
+    engram: EngramConfig;
+}
+export declare class EngramLoadError extends Error {
+    readonly code: string;
+    readonly directory?: string;
+    constructor(message: string, code: string, directory?: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/engram/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/engram/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,WAAW,CAAC;AAEzE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,WAAW,GAAG,KAAK,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,OAAO,CAAC;IACpB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6FAA6F;IAC7F,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,EAAE,cAAc,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAM9D"}

package/engram/types.js

@@ -0,0 +1,12 @@
+export const SUPPORTED_ENGRAM_MAJOR = 1;
+export class EngramLoadError extends Error {
+    code;
+    directory;
+    constructor(message, code, directory) {
+        super(message);
+        this.name = 'EngramLoadError';
+        this.code = code;
+        this.directory = directory;
+    }
+}
+//# sourceMappingURL=types.js.map

package/engram/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/engram/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AA6DxC,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAAS;IACb,SAAS,CAAU;IAE5B,YAAY,OAAe,EAAE,IAAY,EAAE,SAAkB;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF"}

package/engram/validate.d.ts

@@ -0,0 +1,7 @@
+export declare function parseSemver(version: string): {
+    major: number;
+    minor: number;
+    patch: number;
+} | null;
+export declare function validateEngramVersion(version: string): void;
+//# sourceMappingURL=validate.d.ts.map

package/engram/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/engram/validate.ts"],"names":[],"mappings":"AAIA,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQnG;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAe3D"}

package/engram/validate.js

@@ -0,0 +1,22 @@
+import { SUPPORTED_ENGRAM_MAJOR, EngramLoadError } from './types.js';
+const SEMVER_PATTERN = /^(\d+)\.(\d+)\.(\d+)$/;
+export function parseSemver(version) {
+    const match = SEMVER_PATTERN.exec(version.trim());
+    if (!match)
+        return null;
+    return {
+        major: Number(match[1]),
+        minor: Number(match[2]),
+        patch: Number(match[3]),
+    };
+}
+export function validateEngramVersion(version) {
+    const parsed = parseSemver(version);
+    if (!parsed) {
+        throw new EngramLoadError(`Unrecognised engram_version "${version}". Expected semver (e.g. "1.0.0").`, 'INVALID_ENGRAM_VERSION');
+    }
+    if (parsed.major !== SUPPORTED_ENGRAM_MAJOR) {
+        throw new EngramLoadError(`Unsupported engram_version "${version}". This runtime supports major version ${SUPPORTED_ENGRAM_MAJOR}.x.x only.`, 'UNSUPPORTED_ENGRAM_VERSION');
+    }
+}
+//# sourceMappingURL=validate.js.map

package/engram/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/engram/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAE/C,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,eAAe,CACvB,gCAAgC,OAAO,oCAAoC,EAC3E,wBAAwB,CACzB,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,KAAK,sBAAsB,EAAE,CAAC;QAC5C,MAAM,IAAI,eAAe,CACvB,+BAA+B,OAAO,0CAA0C,sBAAsB,YAAY,EAClH,4BAA4B,CAC7B,CAAC;IACJ,CAAC;AACH,CAAC"}

package/index.d.ts

@@ -0,0 +1,30 @@
+export { loadEngramFromDirectory } from './engram/loader.js';
+export { listEngramDirectories, resolveEngramDirectory } from './engram/registry.js';
+export { parseEngramYaml, parseVesselYaml } from './engram/parse.js';
+export { validateEngramVersion, parseSemver } from './engram/validate.js';
+export { EngramLoadError, SUPPORTED_ENGRAM_MAJOR, type EngramConfig, type EngramDirectoryOutput, type EngramMeta, type LoadedEngram, type VesselConfig, type VesselPlayback, type VesselTransitions, type VesselType, } from './engram/types.js';
+export { migrateJsonToDirectory } from './migrations/json-to-directory.js';
+export type { LegacyEngramJson } from './migrations/types.js';
+export { resolveEidolaPaths, resolveEidolaRuntimeConfig, type EidolaPaths, type EidolaRuntimeConfig, } from './config.js';
+export { STATE_PROTOCOL_VERSION, STATE_SOCKET_HOST, DEFAULT_STATE_SOCKET_PORT, DEFAULT_STATE_BUFFER_SIZE, SURFACES, VESSEL_STATES, type Surface, type StateBroadcast, type StateInboundEvent, type StateSocketConfig, type VesselState, } from './socket/types.js';
+export { createBroadcast, isKnownVesselState, normalizeInbound, parseInboundLine, serializeBroadcast, } from './socket/protocol.js';
+export { resolveExpressionClip } from './socket/expression.js';
+export { resolveVisualState, WORKING_CLUSTER, isWorkingClusterState } from './vendor/tool-state.js';
+export type { ResolveVisualStateInput, WorkingClusterState } from './vendor/tool-state.js';
+export { createStateSocketServer, type StateSocketServer } from './socket/server.js';
+export { SessionState, type ActiveEidolonSnapshot } from './session/state.js';
+export { buildSoulInjectionPayload, isValidSoulInjectionPayload, wrapSoulAsSystemReminder, type SoulInjectionPayload, } from './soul/injection.js';
+export { ReinjectTracker, type ReinjectStatus } from './soul/reinject.js';
+export { createToolHandlers, type EidolaToolHandlers, type ToolTextResult } from './tools/handlers.js';
+export { startEidolaMcpServer } from './server.js';
+export { autoActivateFromWorkspace, type AutoActivateResult } from './cursor/auto-activate.js';
+export { launchShrine, ensureShrineRunning, type LaunchShrineResult, type LaunchShrineOptions, type EnsureShrineResult, } from './cursor/ensure-shrine.js';
+export { isShrineRunning, isProcessAlive, shrineLockPath, readShrineLock, removeShrineLock, stopShrine, writeShrineLock, type ShrineLockFile, } from './cursor/shrine-lock.js';
+export { resolveShrineSurface, normalizeShrineSurfaceInput, shrineSurfaceEnv, isHttpShrineSurface, shrineHttpPort, shrineHttpUrl, SHRINE_SURFACE_PRESETS, DEFAULT_SHRINE_SURFACE_PRESET, DEFAULT_SHRINE_HTTP_PORT, type ShrineSurface, type ShrineSurfacePresetId, type ShrineLayoutTier, } from './cursor/shrine-surface.js';
+export { compileSoulToCursorRule, parseCompiledCursorRule, } from './cursor/compile.js';
+export { detectSoulSource, type SoulSource } from './cursor/soul-source.js';
+export { computeSoulHash } from './cursor/hash.js';
+export { warnIfStaleSoulCompile, type StaleSoulCompileCheck } from './cursor/stale.js';
+export { buildWorkspaceConfig, cursorRulePath, EIDOLA_WORKSPACE_CONFIG_FILENAME, readWorkspaceConfig, workspaceConfigPath, writeWorkspaceConfig, } from './cursor/workspace-config.js';
+export type { CompiledCursorRule, EidolaWorkspaceConfig } from './cursor/types.js';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

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

package/index.js

@@ -0,0 +1,27 @@
+export { loadEngramFromDirectory } from './engram/loader.js';
+export { listEngramDirectories, resolveEngramDirectory } from './engram/registry.js';
+export { parseEngramYaml, parseVesselYaml } from './engram/parse.js';
+export { validateEngramVersion, parseSemver } from './engram/validate.js';
+export { EngramLoadError, SUPPORTED_ENGRAM_MAJOR, } from './engram/types.js';
+export { migrateJsonToDirectory } from './migrations/json-to-directory.js';
+export { resolveEidolaPaths, resolveEidolaRuntimeConfig, } from './config.js';
+export { STATE_PROTOCOL_VERSION, STATE_SOCKET_HOST, DEFAULT_STATE_SOCKET_PORT, DEFAULT_STATE_BUFFER_SIZE, SURFACES, VESSEL_STATES, } from './socket/types.js';
+export { createBroadcast, isKnownVesselState, normalizeInbound, parseInboundLine, serializeBroadcast, } from './socket/protocol.js';
+export { resolveExpressionClip } from './socket/expression.js';
+export { resolveVisualState, WORKING_CLUSTER, isWorkingClusterState } from './vendor/tool-state.js';
+export { createStateSocketServer } from './socket/server.js';
+export { SessionState } from './session/state.js';
+export { buildSoulInjectionPayload, isValidSoulInjectionPayload, wrapSoulAsSystemReminder, } from './soul/injection.js';
+export { ReinjectTracker } from './soul/reinject.js';
+export { createToolHandlers } from './tools/handlers.js';
+export { startEidolaMcpServer } from './server.js';
+export { autoActivateFromWorkspace } from './cursor/auto-activate.js';
+export { launchShrine, ensureShrineRunning, } from './cursor/ensure-shrine.js';
+export { isShrineRunning, isProcessAlive, shrineLockPath, readShrineLock, removeShrineLock, stopShrine, writeShrineLock, } from './cursor/shrine-lock.js';
+export { resolveShrineSurface, normalizeShrineSurfaceInput, shrineSurfaceEnv, isHttpShrineSurface, shrineHttpPort, shrineHttpUrl, SHRINE_SURFACE_PRESETS, DEFAULT_SHRINE_SURFACE_PRESET, DEFAULT_SHRINE_HTTP_PORT, } from './cursor/shrine-surface.js';
+export { compileSoulToCursorRule, parseCompiledCursorRule, } from './cursor/compile.js';
+export { detectSoulSource } from './cursor/soul-source.js';
+export { computeSoulHash } from './cursor/hash.js';
+export { warnIfStaleSoulCompile } from './cursor/stale.js';
+export { buildWorkspaceConfig, cursorRulePath, EIDOLA_WORKSPACE_CONFIG_FILENAME, readWorkspaceConfig, workspaceConfigPath, writeWorkspaceConfig, } from './cursor/workspace-config.js';
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EACL,eAAe,EACf,sBAAsB,GASvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,OAAO,EACL,kBAAkB,EAClB,0BAA0B,GAG3B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,yBAAyB,EACzB,yBAAyB,EACzB,QAAQ,EACR,aAAa,GAMd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpG,OAAO,EAAE,uBAAuB,EAA0B,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAAE,YAAY,EAA8B,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,GAEzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAuB,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAgD,MAAM,qBAAqB,CAAC;AACvG,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,yBAAyB,EAA2B,MAAM,2BAA2B,CAAC;AAC/F,OAAO,EACL,YAAY,EACZ,mBAAmB,GAIpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,eAAe,EACf,cAAc,EACd,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,eAAe,GAEhB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,sBAAsB,EACtB,6BAA6B,EAC7B,wBAAwB,GAIzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAmB,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAA8B,MAAM,mBAAmB,CAAC;AACvF,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,gCAAgC,EAChC,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,8BAA8B,CAAC"}

package/migrations/json-to-directory.d.ts

@@ -0,0 +1,8 @@
+import type { EngramDirectoryOutput } from '../engram/types.js';
+import type { LegacyEngramJson } from './types.js';
+/**
+ * Pure migration from legacy `.engram.json` to directory package fields.
+ * Never mutates the input object.
+ */
+export declare function migrateJsonToDirectory(legacy: LegacyEngramJson): EngramDirectoryOutput;
+//# sourceMappingURL=json-to-directory.d.ts.map

package/migrations/json-to-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-to-directory.d.ts","sourceRoot":"","sources":["../../src/migrations/json-to-directory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAgB,MAAM,oBAAoB,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA0InD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,qBAAqB,CA0BtF"}

package/migrations/json-to-directory.js

@@ -0,0 +1,151 @@
+const CURRENT_ENGRAM_VERSION = '1.0.0';
+/** Old persona/pack state names → Phase 1 expression keys. */
+const LEGACY_STATE_TO_EXPRESSION = {
+    idle: 'idle',
+    thinking: 'thinking',
+    debug: 'working',
+    working: 'working',
+    warn: 'attention',
+    alerting: 'attention',
+    attention: 'attention',
+    shipit: 'writing',
+    writing: 'writing',
+    searching: 'searching',
+    result: 'responding',
+    responding: 'responding',
+    speaking: 'responding',
+    confused: 'error',
+    error: 'error',
+    completed: 'success',
+    success: 'success',
+};
+const DEFAULT_EXPRESSIONS = {
+    idle: 'idle.json',
+    thinking: 'thinking.json',
+    working: 'working.json',
+    searching: 'searching.json',
+    writing: 'writing.json',
+    responding: 'responding.json',
+    success: 'responding.json',
+    error: 'error.json',
+    attention: 'attention.json',
+};
+function slugify(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+function toIsoDate(value) {
+    if (!value)
+        return new Date().toISOString().slice(0, 10);
+    const parsed = new Date(value);
+    if (Number.isNaN(parsed.getTime()))
+        return new Date().toISOString().slice(0, 10);
+    return parsed.toISOString().slice(0, 10);
+}
+function resolvePackId(legacy) {
+    if (typeof legacy.packId === 'string' && legacy.packId.trim().length > 0) {
+        return legacy.packId.trim();
+    }
+    const vessel = legacy.vessel;
+    if (vessel && typeof vessel === 'object' && 'packId' in vessel) {
+        const packId = vessel.packId;
+        if (typeof packId === 'string' && packId.trim().length > 0) {
+            return packId.trim();
+        }
+    }
+    const id = legacy.id?.trim() || slugify(legacy.name);
+    return id ? `${id}-v1` : 'default-v1';
+}
+function resolveVesselType(legacy) {
+    const vessel = legacy.vessel;
+    if (vessel && typeof vessel === 'object' && 'sourceType' in vessel) {
+        const sourceType = vessel.sourceType;
+        if (sourceType === 'webm')
+            return 'webm';
+    }
+    return 'lottie';
+}
+function buildSoul(legacy) {
+    if (typeof legacy.soulMd === 'string' && legacy.soulMd.trim().length > 0) {
+        return legacy.soulMd.replace(/\r\n/g, '\n').trimEnd() + '\n';
+    }
+    const sections = [`# ${legacy.name.trim()}`];
+    if (legacy.description?.trim()) {
+        sections.push('', legacy.description.trim());
+    }
+    if (legacy.systemPrompt?.trim()) {
+        sections.push('', legacy.systemPrompt.trim());
+    }
+    if (legacy.styleRules?.length) {
+        sections.push('', '## Style', ...legacy.styleRules.map((rule) => `- ${rule}`));
+    }
+    if (legacy.behaviorRules?.length) {
+        sections.push('', '## Rules', ...legacy.behaviorRules.map((rule) => `- ${rule}`));
+    }
+    return sections.join('\n').trimEnd() + '\n';
+}
+function expressionFilename(key) {
+    return `${key}.json`;
+}
+function buildExpressions(legacy) {
+    if (legacy.expressions && Object.keys(legacy.expressions).length > 0) {
+        return { ...legacy.expressions };
+    }
+    const expressions = { ...DEFAULT_EXPRESSIONS };
+    const states = legacy.states ?? Object.keys(LEGACY_STATE_TO_EXPRESSION);
+    for (const state of states) {
+        const mapped = LEGACY_STATE_TO_EXPRESSION[state.toLowerCase()];
+        if (!mapped)
+            continue;
+        expressions[mapped] = expressionFilename(mapped);
+    }
+    expressions.success ??= 'responding.json';
+    return expressions;
+}
+function buildVesselConfig(legacy) {
+    return {
+        type: resolveVesselType(legacy),
+        pack: resolvePackId(legacy),
+        expressions: buildExpressions(legacy),
+        transitions: {
+            default: 'crossfade',
+            duration_ms: 300,
+        },
+        playback: {
+            idle_loops: true,
+            approval_idle_ms: 3000,
+        },
+    };
+}
+/**
+ * Pure migration from legacy `.engram.json` to directory package fields.
+ * Never mutates the input object.
+ */
+export function migrateJsonToDirectory(legacy) {
+    const source = structuredClone(legacy);
+    const id = source.id?.trim() || slugify(source.name);
+    return {
+        soul: buildSoul(source),
+        vessel: buildVesselConfig(source),
+        engram: {
+            engram_version: CURRENT_ENGRAM_VERSION,
+            id,
+            name: source.name.trim(),
+            reinject_interval: typeof source.reinject_interval === 'number' ? source.reinject_interval : 3,
+            voice_id: source.voice && typeof source.voice.voiceId === 'string' ? source.voice.voiceId : null,
+            meta: {
+                author: source.metadata?.author?.trim() || 'unknown',
+                created: toIsoDate(source.metadata?.createdAt),
+                ...(source.description?.trim() ? { description: source.description.trim() } : {}),
+                ...(source.metadata?.tags?.length ? { tags: [...source.metadata.tags] } : {}),
+            },
+            extensions: source.extensions && typeof source.extensions === 'object' && !Array.isArray(source.extensions)
+                ? structuredClone(source.extensions)
+                : {},
+        },
+    };
+}
+//# sourceMappingURL=json-to-directory.js.map