seal-gate 0.3.0

package/dist/drift/baseline.d.ts

@@ -0,0 +1,35 @@
+import { DriftDb } from './drift-db.js';
+import { Embedder } from './embedder.js';
+export type BaselineStatus = 'READY' | 'DEGRADED' | 'MISSING';
+export interface BaselinePaths {
+    soulPath: string;
+    axiomsPath?: string;
+    primePath?: string;
+}
+export interface BaselineResult {
+    vector: number[];
+    hash: string;
+    status: BaselineStatus;
+}
+/**
+ * Manages per-agent identity baseline vectors.
+ * Loads substrate files, caches by content hash, and delegates encoding to Embedder.
+ */
+export declare class BaselineManager {
+    private db;
+    private embedder;
+    private statusMap;
+    constructor(db: DriftDb, embedder?: Embedder);
+    /**
+     * Get or compute the baseline vector for an agent.
+     * Caches by SHA-256 hash of concatenated substrate text.
+     */
+    getOrCompute(agentId: string, paths: BaselinePaths): Promise<BaselineResult>;
+    /**
+     * Get the cached baseline without recomputing.
+     * Returns zero vector if not yet computed.
+     */
+    getCached(agentId: string): number[] | null;
+    status(agentId: string): BaselineStatus;
+    private readSubstrate;
+}

package/dist/drift/baseline.js

@@ -0,0 +1,77 @@
+import { createHash } from 'crypto';
+import { readFileSync, existsSync } from 'fs';
+import { Embedder } from './embedder.js';
+/**
+ * Manages per-agent identity baseline vectors.
+ * Loads substrate files, caches by content hash, and delegates encoding to Embedder.
+ */
+export class BaselineManager {
+    db;
+    embedder;
+    statusMap = new Map();
+    constructor(db, embedder) {
+        this.db = db;
+        this.embedder = embedder ?? new Embedder();
+    }
+    /**
+     * Get or compute the baseline vector for an agent.
+     * Caches by SHA-256 hash of concatenated substrate text.
+     */
+    async getOrCompute(agentId, paths) {
+        const substrate = this.readSubstrate(paths);
+        if (!substrate.found) {
+            this.statusMap.set(agentId, 'DEGRADED');
+            return {
+                vector: new Array(this.embedder.dim).fill(0),
+                hash: '',
+                status: 'DEGRADED',
+            };
+        }
+        const hash = createHash('sha256').update(substrate.text).digest('hex');
+        // Check cache
+        const cached = this.db.baseline.get(agentId);
+        if (cached && cached.content_hash === hash) {
+            this.statusMap.set(agentId, 'READY');
+            return {
+                vector: JSON.parse(cached.baseline_vector),
+                hash,
+                status: 'READY',
+            };
+        }
+        // Compute and cache
+        const vector = await this.embedder.encode(substrate.text);
+        this.db.baseline.set(agentId, vector, hash, 'all-MiniLM-L6-v2');
+        this.statusMap.set(agentId, 'READY');
+        return { vector, hash, status: 'READY' };
+    }
+    /**
+     * Get the cached baseline without recomputing.
+     * Returns zero vector if not yet computed.
+     */
+    getCached(agentId) {
+        const cached = this.db.baseline.get(agentId);
+        if (!cached)
+            return null;
+        return JSON.parse(cached.baseline_vector);
+    }
+    status(agentId) {
+        return this.statusMap.get(agentId) ?? 'MISSING';
+    }
+    readSubstrate(paths) {
+        const parts = [];
+        if (paths.soulPath && existsSync(paths.soulPath)) {
+            parts.push(readFileSync(paths.soulPath, 'utf-8'));
+        }
+        if (paths.axiomsPath && existsSync(paths.axiomsPath)) {
+            parts.push(readFileSync(paths.axiomsPath, 'utf-8'));
+        }
+        if (paths.primePath && existsSync(paths.primePath)) {
+            parts.push(readFileSync(paths.primePath, 'utf-8'));
+        }
+        if (parts.length === 0) {
+            return { text: '', found: false };
+        }
+        return { text: parts.join('\n---\n'), found: true };
+    }
+}
+//# sourceMappingURL=baseline.js.map

package/dist/drift/baseline.js.map

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

package/dist/drift/drift-db.d.ts

@@ -0,0 +1,80 @@
+export interface DriftBaselineRow {
+    agent_id: string;
+    baseline_vector: string;
+    content_hash: string;
+    embedding_model: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface DriftHistoryRow {
+    id: number;
+    agent_id: string;
+    session_id: string;
+    turn_number: number;
+    current_vector: string;
+    distance: number;
+    status: string;
+    re_anchor_id: number | null;
+    timestamp: string;
+}
+export interface PendingReAnchorRow {
+    id: number;
+    agent_id: string;
+    session_id: string;
+    payload: string;
+    created_at: string;
+    status: 'PENDING' | 'CONSUMED' | 'EXPIRED';
+    consumed_at: string | null;
+}
+export interface DriftRepairLogRow {
+    id: number;
+    agent_id: string;
+    session_id: string;
+    turn_number: number;
+    distance: number;
+    hard_limit: number;
+    message_excerpt: string;
+    triggered_at: string;
+    human_review_flag: 'PENDING' | 'REVIEWED' | 'IGNORED';
+    recovery_status: 'UNKNOWN' | 'RECOVERED' | 'PERSISTENT_DRIFT';
+    notes: string | null;
+}
+export declare class DriftDb {
+    private db;
+    constructor(dbPath?: string);
+    private initSchema;
+    baseline: {
+        get: (agentId: string) => DriftBaselineRow | null;
+        set: (agentId: string, vector: number[], hash: string, model: string) => void;
+    };
+    history: {
+        append: (row: {
+            agent_id: string;
+            session_id: string;
+            turn_number: number;
+            current_vector: number[];
+            distance: number;
+            status: string;
+            timestamp: string;
+        }) => void;
+        list: (agentId: string, sessionId: string) => DriftHistoryRow[];
+        getLatest: (agentId: string, sessionId: string) => DriftHistoryRow | null;
+    };
+    pending: {
+        set: (agentId: string, sessionId: string, payload: string) => number;
+        getPending: (agentId: string, sessionId: string) => PendingReAnchorRow | null;
+        markConsumed: (id: number) => void;
+    };
+    repair: {
+        append: (row: {
+            agent_id: string;
+            session_id: string;
+            turn_number: number;
+            distance: number;
+            hard_limit: number;
+            message_excerpt?: string;
+        }) => number;
+        listPending: (agentId: string) => DriftRepairLogRow[];
+    };
+    close(): void;
+}

package/dist/drift/drift-db.js

@@ -0,0 +1,151 @@
+import { createRequire } from 'node:module';
+import { join } from 'path';
+import { homedir } from 'os';
+const _require = createRequire(import.meta.url);
+const isBun = typeof globalThis.Bun !== 'undefined';
+const DatabaseSync = isBun
+    ? _require('bun:sqlite').Database
+    : _require('node:sqlite').DatabaseSync;
+export class DriftDb {
+    db;
+    constructor(dbPath) {
+        const path = dbPath ?? join(homedir(), '.seal', 'drift.db');
+        this.db = new DatabaseSync(path);
+        this.db.exec('PRAGMA journal_mode = WAL;');
+        this.initSchema();
+    }
+    initSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS drift_baseline (
+        agent_id TEXT PRIMARY KEY,
+        baseline_vector TEXT NOT NULL,
+        content_hash TEXT NOT NULL,
+        embedding_model TEXT NOT NULL,
+        created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+        updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+      );
+
+      CREATE TABLE IF NOT EXISTS drift_history (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        agent_id TEXT NOT NULL,
+        session_id TEXT NOT NULL,
+        turn_number INTEGER NOT NULL,
+        current_vector TEXT,
+        distance REAL,
+        status TEXT NOT NULL,
+        re_anchor_id INTEGER,
+        timestamp DATETIME DEFAULT CURRENT_TIMESTAMP
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_history_agent_session
+        ON drift_history(agent_id, session_id);
+
+      CREATE TABLE IF NOT EXISTS pending_re_anchor (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        agent_id TEXT NOT NULL,
+        session_id TEXT NOT NULL,
+        payload TEXT NOT NULL,
+        created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+        status TEXT DEFAULT 'PENDING',
+        consumed_at DATETIME
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_reanchor_pending
+        ON pending_re_anchor(agent_id, session_id, status);
+
+      CREATE TABLE IF NOT EXISTS drift_repair_log (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        agent_id TEXT NOT NULL,
+        session_id TEXT NOT NULL,
+        turn_number INTEGER NOT NULL,
+        distance REAL NOT NULL,
+        hard_limit REAL NOT NULL,
+        message_excerpt TEXT,
+        triggered_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+        human_review_flag TEXT DEFAULT 'PENDING',
+        recovery_status TEXT DEFAULT 'UNKNOWN',
+        notes TEXT
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_repair_pending
+        ON drift_repair_log(agent_id, human_review_flag);
+    `);
+    }
+    // ── Baseline CRUD ────────────────────────────────────────────────
+    baseline = {
+        get: (agentId) => {
+            const stmt = this.db.prepare('SELECT * FROM drift_baseline WHERE agent_id = ?');
+            return stmt.get(agentId) ?? null;
+        },
+        set: (agentId, vector, hash, model) => {
+            const stmt = this.db.prepare(`INSERT INTO drift_baseline (agent_id, baseline_vector, content_hash, embedding_model)
+         VALUES (?, ?, ?, ?)
+         ON CONFLICT(agent_id) DO UPDATE SET
+           baseline_vector = excluded.baseline_vector,
+           content_hash = excluded.content_hash,
+           embedding_model = excluded.embedding_model,
+           updated_at = CURRENT_TIMESTAMP`);
+            stmt.run(agentId, JSON.stringify(vector), hash, model);
+        },
+    };
+    // ── History CRUD ─────────────────────────────────────────────────
+    history = {
+        append: (row) => {
+            const stmt = this.db.prepare(`INSERT INTO drift_history
+         (agent_id, session_id, turn_number, current_vector, distance, status, timestamp)
+         VALUES (?, ?, ?, ?, ?, ?, ?)`);
+            stmt.run(row.agent_id, row.session_id, row.turn_number, JSON.stringify(row.current_vector), row.distance, row.status, row.timestamp);
+        },
+        list: (agentId, sessionId) => {
+            const stmt = this.db.prepare('SELECT * FROM drift_history WHERE agent_id = ? AND session_id = ? ORDER BY turn_number');
+            return stmt.all(agentId, sessionId);
+        },
+        getLatest: (agentId, sessionId) => {
+            const stmt = this.db.prepare(`SELECT * FROM drift_history
+         WHERE agent_id = ? AND session_id = ?
+         ORDER BY turn_number DESC LIMIT 1`);
+            return stmt.get(agentId, sessionId) ?? null;
+        },
+    };
+    // ── Pending Re-Anchor CRUD ───────────────────────────────────────
+    pending = {
+        set: (agentId, sessionId, payload) => {
+            const stmt = this.db.prepare(`INSERT INTO pending_re_anchor (agent_id, session_id, payload, status)
+         VALUES (?, ?, ?, 'PENDING')`);
+            const result = stmt.run(agentId, sessionId, payload);
+            return Number(result.lastInsertRowid);
+        },
+        getPending: (agentId, sessionId) => {
+            const stmt = this.db.prepare(`SELECT * FROM pending_re_anchor
+         WHERE agent_id = ? AND session_id = ? AND status = 'PENDING'
+         ORDER BY created_at DESC LIMIT 1`);
+            return stmt.get(agentId, sessionId) ?? null;
+        },
+        markConsumed: (id) => {
+            const stmt = this.db.prepare(`UPDATE pending_re_anchor
+         SET status = 'CONSUMED', consumed_at = CURRENT_TIMESTAMP
+         WHERE id = ?`);
+            stmt.run(id);
+        },
+    };
+    // ── Repair Log CRUD ──────────────────────────────────────────────
+    repair = {
+        append: (row) => {
+            const stmt = this.db.prepare(`INSERT INTO drift_repair_log
+         (agent_id, session_id, turn_number, distance, hard_limit, message_excerpt)
+         VALUES (?, ?, ?, ?, ?, ?)`);
+            const result = stmt.run(row.agent_id, row.session_id, row.turn_number, row.distance, row.hard_limit, row.message_excerpt ?? null);
+            return Number(result.lastInsertRowid);
+        },
+        listPending: (agentId) => {
+            const stmt = this.db.prepare(`SELECT * FROM drift_repair_log
+         WHERE agent_id = ? AND human_review_flag = 'PENDING'
+         ORDER BY triggered_at`);
+            return stmt.all(agentId);
+        },
+    };
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=drift-db.js.map

package/dist/drift/drift-db.js.map

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

package/dist/drift/drift-guard.d.ts

@@ -0,0 +1,46 @@
+import { DriftDb } from './drift-db.js';
+import { BaselineManager } from './baseline.js';
+import { Embedder } from './embedder.js';
+export type DriftStatus = 'NORMAL' | 'SOFT_DRIFT' | 'HARD_DRIFT';
+export interface DriftAction {
+    type: 'NONE' | 'INJECT_RE_ANCHOR' | 'QUARANTINE' | 'FULL_SOUL_RELOAD';
+    payload?: string;
+}
+export interface DriftResult {
+    status: DriftStatus;
+    distance: number;
+    action: DriftAction;
+    softLimit: number;
+    hardLimit: number;
+}
+export interface DriftGuardOptions {
+    db: DriftDb;
+    embedder?: Embedder;
+    baselineManager?: BaselineManager;
+    softLimit?: number;
+    hardLimit?: number;
+    cadence?: number;
+}
+/**
+ * Per-turn drift detection orchestrator.
+ * Stateless between calls except for DB persistence.
+ */
+export declare class DriftGuard {
+    private db;
+    private baseline;
+    private embedder;
+    private softLimit;
+    private hardLimit;
+    private cadence;
+    private quarantine;
+    private softCorrection;
+    constructor(opts: DriftGuardOptions);
+    /**
+     * Classify a raw distance value into drift tier.
+     */
+    classify(distance: number): DriftStatus;
+    /**
+     * Run a full drift detection cycle for one turn.
+     */
+    runCycle(agentId: string, sessionId: string, turnNumber: number, outputText: string): Promise<DriftResult>;
+}

package/dist/drift/drift-guard.js

@@ -0,0 +1,106 @@
+import { BaselineManager } from './baseline.js';
+import { Embedder, cosineDistance } from './embedder.js';
+import { Quarantine } from './quarantine.js';
+import { SoftCorrection } from './soft-correction.js';
+/**
+ * Per-turn drift detection orchestrator.
+ * Stateless between calls except for DB persistence.
+ */
+export class DriftGuard {
+    db;
+    baseline;
+    embedder;
+    softLimit;
+    hardLimit;
+    cadence;
+    quarantine;
+    softCorrection;
+    constructor(opts) {
+        this.db = opts.db;
+        this.embedder = opts.embedder ?? new Embedder();
+        this.baseline = opts.baselineManager ?? new BaselineManager(this.db, this.embedder);
+        this.softLimit = opts.softLimit ?? 0.30;
+        this.hardLimit = opts.hardLimit ?? 0.55;
+        this.cadence = opts.cadence ?? 1;
+        this.quarantine = new Quarantine(this.db);
+        this.softCorrection = new SoftCorrection();
+    }
+    /**
+     * Classify a raw distance value into drift tier.
+     */
+    classify(distance) {
+        if (distance >= this.hardLimit)
+            return 'HARD_DRIFT';
+        if (distance >= this.softLimit)
+            return 'SOFT_DRIFT';
+        return 'NORMAL';
+    }
+    /**
+     * Run a full drift detection cycle for one turn.
+     */
+    async runCycle(agentId, sessionId, turnNumber, outputText) {
+        // Cadence gate
+        if (this.cadence > 1 && turnNumber % this.cadence !== 0) {
+            return {
+                status: 'NORMAL',
+                distance: 0,
+                action: { type: 'NONE' },
+                softLimit: this.softLimit,
+                hardLimit: this.hardLimit,
+            };
+        }
+        // Load baseline
+        const baselineVec = this.baseline.getCached(agentId);
+        if (!baselineVec) {
+            // First run — wizard or degraded. Defer detection.
+            return {
+                status: 'NORMAL',
+                distance: 0,
+                action: { type: 'NONE', payload: 'Baseline not loaded for this agent.' },
+                softLimit: this.softLimit,
+                hardLimit: this.hardLimit,
+            };
+        }
+        // Encode current output
+        const currentVec = await this.embedder.encode(outputText);
+        // Compare
+        const distance = cosineDistance(baselineVec, currentVec);
+        const status = this.classify(distance);
+        // Record history
+        this.db.history.append({
+            agent_id: agentId,
+            session_id: sessionId,
+            turn_number: turnNumber,
+            current_vector: currentVec,
+            distance,
+            status,
+            timestamp: new Date().toISOString(),
+        });
+        // Determine action
+        let action = { type: 'NONE' };
+        if (status === 'SOFT_DRIFT') {
+            const payload = this.softCorrection.generate({
+                name: agentId,
+                primeDirective: 'Reset to baseline identity. Do not drift.',
+                relationship: 'agent',
+                axiomKeyphrase: 'Identity anchor',
+            });
+            if (payload) {
+                const reAnchorId = this.db.pending.set(agentId, sessionId, payload);
+                action = { type: 'INJECT_RE_ANCHOR', payload };
+            }
+        }
+        if (status === 'HARD_DRIFT') {
+            this.quarantine.logRepair(agentId, sessionId, turnNumber, outputText);
+            action = { type: 'QUARANTINE' };
+        }
+        return {
+            status,
+            distance,
+            action,
+            softLimit: this.softLimit,
+            hardLimit: this.hardLimit,
+        };
+    }
+}
+//# sourceMappingURL=drift-guard.js.map

package/dist/drift/drift-guard.js.map

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

package/dist/drift/embedder.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Cosine distance between two vectors.
+ * Returns value in [0, 2] where:
+ *   0 = identical direction
+ *   1 = orthogonal
+ *   2 = opposite direction
+ * For drift thresholds, we typically use [0, 1] range (divide by 2)
+ * or adjust thresholds accordingly.
+ */
+export declare function cosineDistance(a: number[], b: number[]): number;
+export interface EmbedderBackend {
+    readonly isActive: boolean;
+    readonly dim: number;
+    encode(text: string): Promise<number[]>;
+}
+/**
+ * Main embedder facade.
+ * Prefers ONNX backend; silently falls back to naive embedder
+ * when ONNX is missing or platform-incompatible.
+ */
+export declare class Embedder {
+    private backend;
+    readonly dim: number;
+    constructor(modelPath?: string);
+    get isActive(): boolean;
+    encode(text: string): Promise<number[]>;
+}

package/dist/drift/embedder.js

@@ -0,0 +1,127 @@
+import { createHash } from 'crypto';
+/**
+ * Cosine distance between two vectors.
+ * Returns value in [0, 2] where:
+ *   0 = identical direction
+ *   1 = orthogonal
+ *   2 = opposite direction
+ * For drift thresholds, we typically use [0, 1] range (divide by 2)
+ * or adjust thresholds accordingly.
+ */
+export function cosineDistance(a, b) {
+    if (a.length !== b.length) {
+        throw new Error(`Vector length mismatch: ${a.length} vs ${b.length}`);
+    }
+    if (a.length === 0)
+        return 0;
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    if (denom === 0)
+        return 0;
+    // Clamp to [-1, 1] to avoid floating-point drift
+    const sim = Math.max(-1, Math.min(1, dot / denom));
+    // Distance = 1 - similarity, range [0, 2]
+    return 1 - sim;
+}
+/**
+ * Naive deterministic embedder.
+ * Produces consistent 384-dim vectors from text hash —
+ * suitable for testing and as a graceful fallback when ONNX is unavailable.
+ * NOT semantically meaningful; replaced by ONNX backend in production.
+ */
+class NaiveEmbedder {
+    isActive = true;
+    dim = 384;
+    async encode(text) {
+        const hash = createHash('sha256').update(text).digest();
+        const vec = new Array(this.dim);
+        // Deterministic pseudo-random expansion from 256-bit hash
+        for (let i = 0; i < this.dim; i++) {
+            const hashIdx = i % hash.length;
+            const seed = hash[hashIdx] ^ (i >>> 3);
+            // Signed float in roughly [-0.5, 0.5]
+            vec[i] = ((seed / 255) * 2 - 1) * 0.5;
+        }
+        // L2 normalize for cosine distance stability
+        const norm = Math.sqrt(vec.reduce((s, v) => s + v * v, 0));
+        if (norm > 0) {
+            for (let i = 0; i < this.dim; i++) {
+                vec[i] /= norm;
+            }
+        }
+        return vec;
+    }
+}
+/**
+ * ONNX Runtime embedder (placeholder for now).
+ * Attempts to load the ONNX model on first encode().
+ * Falls back to NaiveEmbedder if model unavailable.
+ */
+class OnnxEmbedder {
+    isActive = false;
+    dim = 384;
+    modelPath;
+    fallback;
+    triedLoading = false;
+    constructor(modelPath) {
+        // TODO(v2): resolve path
+        this.modelPath = modelPath ?? './models/all-MiniLM-L6-v2.onnx';
+        this.fallback = new NaiveEmbedder();
+    }
+    async encode(text) {
+        if (!this.triedLoading) {
+            await this.tryLoad();
+            this.triedLoading = true;
+        }
+        if (!this.isActive) {
+            return this.fallback.encode(text);
+        }
+        // TODO(v2): actual ONNX inference
+        // For now, also fall through to naive to keep system working
+        console.warn(`[Embedder] ONNX model at ${this.modelPath} not loaded; using naive fallback.`);
+        return this.fallback.encode(text);
+    }
+    async tryLoad() {
+        try {
+            // Bun's Node-API support may or may not handle onnxruntime-node.
+            // We'll attempt dynamic import and catch any failure.
+            // const ort = await import('onnxruntime-node');
+            // ... load model ...
+            // this.isActive = true;
+            // Placeholder: always fails until ONNX model is present and Bun support verified
+            this.isActive = false;
+        }
+        catch {
+            this.isActive = false;
+        }
+    }
+}
+/**
+ * Main embedder facade.
+ * Prefers ONNX backend; silently falls back to naive embedder
+ * when ONNX is missing or platform-incompatible.
+ */
+export class Embedder {
+    backend;
+    dim;
+    constructor(modelPath) {
+        const onnx = new OnnxEmbedder(modelPath);
+        this.backend = onnx.isActive ? onnx : new NaiveEmbedder();
+        this.dim = this.backend.dim;
+    }
+    get isActive() {
+        return this.backend.isActive;
+    }
+    async encode(text) {
+        const truncated = text.slice(0, 4000); // rough char limit
+        return this.backend.encode(truncated);
+    }
+}
+//# sourceMappingURL=embedder.js.map