@elizaos/shared 2.0.0-beta.1 → 2.0.11-beta.7

package/utils/name-tokens.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Replace un-substituted `{{name}}` / `{{agentName}}` tokens with the
+ * actual character name. Handles legacy persisted templates from first-run setup.
+ */
+export declare function replaceNameTokens(text: string, name: string): string;
+/**
+ * Reverse of `replaceNameTokens` — rewrite whole-word occurrences of the
+ * given literal character name back into `{{name}}` tokens so that a
+ * later rename continues to propagate through every text field.
+ *
+ * Rules:
+ * - Case-sensitive, whole-word match (word boundaries on both sides).
+ * - Names under 2 characters are ignored; the tokenizer is not
+ *   meaningful for single-letter names and risks destroying prose.
+ * - Idempotent: re-running on already-tokenized text leaves it unchanged because
+ *   `{{name}}` does not contain the literal name.
+ * - Non-destructive on empty input or empty name.
+ *
+ * @param text The text to scan.
+ * @param name The literal character name to tokenize (e.g. "Momo").
+ * @returns The text with whole-word occurrences replaced by `{{name}}`.
+ */
+export declare function tokenizeNameOccurrences(text: string, name: string): string;
+//# sourceMappingURL=name-tokens.d.ts.map

package/utils/name-tokens.js

@@ -0,0 +1,37 @@
+/**
+ * Replace un-substituted `{{name}}` / `{{agentName}}` tokens with the
+ * actual character name. Handles legacy persisted templates from first-run setup.
+ */
+export function replaceNameTokens(text, name) {
+    return text
+        .replace(/\{\{name\}\}/g, name)
+        .replace(/\{\{agentName\}\}/g, name);
+}
+/**
+ * Reverse of `replaceNameTokens` — rewrite whole-word occurrences of the
+ * given literal character name back into `{{name}}` tokens so that a
+ * later rename continues to propagate through every text field.
+ *
+ * Rules:
+ * - Case-sensitive, whole-word match (word boundaries on both sides).
+ * - Names under 2 characters are ignored; the tokenizer is not
+ *   meaningful for single-letter names and risks destroying prose.
+ * - Idempotent: re-running on already-tokenized text leaves it unchanged because
+ *   `{{name}}` does not contain the literal name.
+ * - Non-destructive on empty input or empty name.
+ *
+ * @param text The text to scan.
+ * @param name The literal character name to tokenize (e.g. "Momo").
+ * @returns The text with whole-word occurrences replaced by `{{name}}`.
+ */
+export function tokenizeNameOccurrences(text, name) {
+    if (!text || !name)
+        return text;
+    const trimmed = name.trim();
+    if (trimmed.length < 2)
+        return text;
+    const escaped = trimmed.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const pattern = new RegExp(`\\b${escaped}\\b`, "g");
+    return text.replace(pattern, "{{name}}");
+}
+//# sourceMappingURL=name-tokens.js.map

package/utils/namespace-defaults.d.ts

@@ -0,0 +1,10 @@
+type NamespaceDefaultsEnv = {
+    ELIZA_NAMESPACE?: string;
+};
+/**
+ * App entrypoints should consistently default to the app namespace even
+ * when they bypass the CLI/profile bootstrap path.
+ */
+export declare function ensureNamespaceDefaults(env?: NamespaceDefaultsEnv | undefined): void;
+export {};
+//# sourceMappingURL=namespace-defaults.d.ts.map

package/utils/namespace-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace-defaults.d.ts","sourceRoot":"","sources":["../../src/utils/namespace-defaults.ts"],"names":[],"mappings":"AAAA,KAAK,oBAAoB,GAAG;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAOF;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,GAAE,oBAAoB,GAAG,SAEd,GACb,IAAI,CAMN"}

package/utils/namespace-defaults.js

@@ -0,0 +1,17 @@
+function trimEnvValue(value) {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed : undefined;
+}
+/**
+ * App entrypoints should consistently default to the app namespace even
+ * when they bypass the CLI/profile bootstrap path.
+ */
+export function ensureNamespaceDefaults(env = globalThis.process?.env) {
+    if (!env)
+        return;
+    if (!trimEnvValue(env.ELIZA_NAMESPACE)) {
+        env.ELIZA_NAMESPACE = "eliza";
+    }
+}
+ensureNamespaceDefaults();
+//# sourceMappingURL=namespace-defaults.js.map

package/utils/namespace-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace-defaults.js","sourceRoot":"","sources":["../../src/utils/namespace-defaults.ts"],"names":[],"mappings":"AAIA,SAAS,YAAY,CAAC,KAAyB;IAC7C,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAC9B,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,MACE,UACD,CAAC,OAAO,EAAE,GAAG;IAEd,IAAI,CAAC,GAAG;QAAE,OAAO;IAEjB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,eAAe,GAAG,OAAO,CAAC;IAChC,CAAC;AACH,CAAC;AAED,uBAAuB,EAAE,CAAC"}

package/utils/number-parsing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-parsing.d.ts","sourceRoot":"","sources":["../../src/utils/number-parsing.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAUD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC;AACV,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CAAC;AAkBtB,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,OAAO,CAAC,EAAE,0BAA0B,GACnC,MAAM,GAAG,SAAS,CAUpB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,OAAO,EAAE,yBAAyB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GACxD,MAAM,CAAC;AACV,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,OAAO,CAAC,EAAE,yBAAyB,GAClC,MAAM,GAAG,SAAS,CAAC;AAgBtB,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,OAAO,EAAE,0BAA0B,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GACzD,MAAM,CAAC;AACV,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,OAAO,CAAC,EAAE,0BAA0B,GACnC,MAAM,GAAG,SAAS,CAAC"}

package/utils/number-parsing.js

@@ -0,0 +1,57 @@
+function sanitizeNumericText(value) {
+    return value == null ? "" : value.trim();
+}
+function normalizeFallback(fallback) {
+    return Number.isFinite(fallback) ? fallback : undefined;
+}
+export function parsePositiveInteger(value, fallback) {
+    const raw = sanitizeNumericText(value);
+    if (!raw)
+        return normalizeFallback(fallback);
+    if (!/^\d+$/.test(raw)) {
+        return normalizeFallback(fallback);
+    }
+    const parsed = Number.parseInt(raw, 10);
+    return Number.isSafeInteger(parsed) && parsed > 0
+        ? parsed
+        : normalizeFallback(fallback);
+}
+export function parsePositiveFloat(value, options) {
+    const raw = sanitizeNumericText(value);
+    if (!raw)
+        return normalizeFallback(options?.fallback);
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        return normalizeFallback(options?.fallback);
+    }
+    return options?.floor ? Math.floor(parsed) : parsed;
+}
+export function parseClampedFloat(value, options = {}) {
+    const raw = sanitizeNumericText(value);
+    if (!raw)
+        return normalizeFallback(options.fallback);
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed))
+        return normalizeFallback(options.fallback);
+    const min = options.min ?? -Infinity;
+    const max = options.max ?? Infinity;
+    return Math.max(min, Math.min(max, parsed));
+}
+export function parseClampedInteger(value, options = {}) {
+    const raw = sanitizeNumericText(value);
+    if (!raw)
+        return normalizeFallback(options.fallback);
+    if (!/^[+-]?\d+$/.test(raw)) {
+        return normalizeFallback(options.fallback);
+    }
+    const parsed = Number(raw);
+    if (!Number.isSafeInteger(parsed))
+        return normalizeFallback(options.fallback);
+    const { min, max } = options;
+    if (min !== undefined && parsed < min)
+        return min;
+    if (max !== undefined && parsed > max)
+        return max;
+    return parsed;
+}
+//# sourceMappingURL=number-parsing.js.map

package/utils/number-parsing.js.map

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

package/utils/permission-deep-links.d.ts

@@ -0,0 +1,35 @@
+/**
+ * macOS Privacy & Security pane deep-link table.
+ *
+ * Maps permission ids to the `x-apple.systempreferences:` URL that opens the
+ * exact pane the user needs to grant access. The chat permission card calls
+ * `openPermissionSettings(id)` when a permission is denied and the user
+ * clicks "Open System Settings".
+ *
+ * Win32 / Linux: returns with a console warning. Native equivalents (Windows
+ * `ms-settings:privacy-*`, GNOME `gnome-control-center privacy`, etc.) can
+ * be wired in when those platforms gain real support — until then the chat
+ * surface advertises the limitation up-front.
+ */
+import type { PermissionId } from "../contracts/permissions.js";
+export declare function getMacPermissionDeepLink(id: PermissionId): string;
+type Platform = "darwin" | "win32" | "linux" | "unknown";
+export interface OpenPermissionSettingsDeps {
+    /**
+     * Optional opener. Injected for tests; defaults to `window.open` in the
+     * browser/electron renderer. On Node-only contexts the caller must inject
+     * something (e.g. `child_process.exec("open ...")`).
+     */
+    open?: (url: string) => void | Promise<void>;
+    /** Override platform detection (tests). */
+    platform?: Platform;
+}
+/**
+ * Open the system settings pane for the given permission. Resolves once the
+ * opener has been invoked (it doesn't wait for the user). Win32 / Linux:
+ * warns and returns because this table only defines macOS system settings deep
+ * links today.
+ */
+export declare function openPermissionSettings(id: PermissionId, deps?: OpenPermissionSettingsDeps): Promise<void>;
+export {};
+//# sourceMappingURL=permission-deep-links.d.ts.map

package/utils/permission-deep-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-deep-links.d.ts","sourceRoot":"","sources":["../../src/utils/permission-deep-links.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAyChE,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,YAAY,GAAG,MAAM,CAEjE;AAED,KAAK,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAwBzD,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,YAAY,EAChB,IAAI,GAAE,0BAA+B,GACpC,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/utils/permission-deep-links.js

@@ -0,0 +1,95 @@
+/**
+ * macOS Privacy & Security pane deep-link table.
+ *
+ * Maps permission ids to the `x-apple.systempreferences:` URL that opens the
+ * exact pane the user needs to grant access. The chat permission card calls
+ * `openPermissionSettings(id)` when a permission is denied and the user
+ * clicks "Open System Settings".
+ *
+ * Win32 / Linux: returns with a console warning. Native equivalents (Windows
+ * `ms-settings:privacy-*`, GNOME `gnome-control-center privacy`, etc.) can
+ * be wired in when those platforms gain real support — until then the chat
+ * surface advertises the limitation up-front.
+ */
+const ROOT_PRIVACY = "x-apple.systempreferences:com.apple.preference.security?Privacy";
+/**
+ * Per-id deep links. The right-hand value is the full URL.
+ * Permissions without a dedicated pane fall through to {@link ROOT_PRIVACY}.
+ */
+const MAC_DEEP_LINKS = {
+    accessibility: `${ROOT_PRIVACY}_Accessibility`,
+    "screen-recording": `${ROOT_PRIVACY}_ScreenCapture`,
+    reminders: `${ROOT_PRIVACY}_Reminders`,
+    calendar: `${ROOT_PRIVACY}_Calendars`,
+    contacts: `${ROOT_PRIVACY}_Contacts`,
+    notes: `${ROOT_PRIVACY}_Automation`,
+    health: `${ROOT_PRIVACY}_Health`,
+    microphone: `${ROOT_PRIVACY}_Microphone`,
+    camera: `${ROOT_PRIVACY}_Camera`,
+    location: `${ROOT_PRIVACY}_LocationServices`,
+    notifications: "x-apple.systempreferences:com.apple.preference.notifications",
+    "full-disk": `${ROOT_PRIVACY}_AllFiles`,
+    automation: `${ROOT_PRIVACY}_Automation`,
+    "speech-recognition": `${ROOT_PRIVACY}_SpeechRecognition`,
+    photos: `${ROOT_PRIVACY}_Photos`,
+    phone: ROOT_PRIVACY,
+    messages: `${ROOT_PRIVACY}_AllFiles`,
+    wifi: `${ROOT_PRIVACY}_LocationServices`,
+    bluetooth: "x-apple.systempreferences:com.apple.BluetoothSettings",
+    "app-blocking": "x-apple.systempreferences:com.apple.preference.screentime",
+    "usage-access": "x-apple.systempreferences:com.apple.preference.screentime",
+    overlay: ROOT_PRIVACY,
+    "write-settings": ROOT_PRIVACY,
+    "local-network": `${ROOT_PRIVACY}_LocalNetwork`,
+    "battery-optimization": ROOT_PRIVACY,
+    // Permissions without dedicated panes — fall back to root Privacy.
+    shell: ROOT_PRIVACY,
+    "website-blocking": ROOT_PRIVACY,
+    screentime: "x-apple.systempreferences:com.apple.preference.screentime",
+};
+export function getMacPermissionDeepLink(id) {
+    return MAC_DEEP_LINKS[id] ?? ROOT_PRIVACY;
+}
+function detectPlatform() {
+    if (typeof globalThis !== "undefined" &&
+        typeof globalThis.process
+            ?.platform === "string") {
+        const p = globalThis.process
+            .platform;
+        if (p === "darwin" || p === "win32" || p === "linux")
+            return p;
+    }
+    if (typeof navigator !== "undefined" &&
+        typeof navigator.userAgent === "string") {
+        const ua = navigator.userAgent;
+        if (/Mac/.test(ua))
+            return "darwin";
+        if (/Win/.test(ua))
+            return "win32";
+        if (/Linux/.test(ua))
+            return "linux";
+    }
+    return "unknown";
+}
+/**
+ * Open the system settings pane for the given permission. Resolves once the
+ * opener has been invoked (it doesn't wait for the user). Win32 / Linux:
+ * warns and returns because this table only defines macOS system settings deep
+ * links today.
+ */
+export async function openPermissionSettings(id, deps = {}) {
+    const platform = deps.platform ?? detectPlatform();
+    if (platform !== "darwin") {
+        console.warn(`[permission-deep-links] openPermissionSettings: no system-settings deep link for platform=${platform} (id=${id}); please open settings manually.`);
+        return;
+    }
+    const url = getMacPermissionDeepLink(id);
+    const opener = deps.open ??
+        ((u) => {
+            if (typeof window !== "undefined" && typeof window.open === "function") {
+                window.open(u, "_self");
+            }
+        });
+    await opener(url);
+}
+//# sourceMappingURL=permission-deep-links.js.map

package/utils/permission-deep-links.js.map

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

package/utils/serialise.js

@@ -0,0 +1,22 @@
+/**
+ * Creates a serialised (sequential) promise queue.
+ *
+ * Each call to the returned function chains the provided async `fn` after
+ * the previous one completes, ensuring only one operation runs at a time.
+ *
+ * Usage:
+ *   const run = createSerialise();
+ *   await run(async () => { ... });
+ */
+export function createSerialise() {
+    let lock = Promise.resolve();
+    return (fn) => {
+        const prev = lock;
+        let resolve;
+        lock = new Promise((r) => {
+            resolve = r;
+        });
+        return prev.then(fn).finally(() => resolve());
+    };
+}
+//# sourceMappingURL=serialise.js.map

package/utils/serialise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialise.js","sourceRoot":"","sources":["../../src/utils/serialise.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,IAAI,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5C,OAAO,CAAI,EAAoB,EAAc,EAAE;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC;QAClB,IAAI,OAAmB,CAAC;QACxB,IAAI,GAAG,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE;YAC7B,OAAO,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC;AACJ,CAAC"}

package/utils/sql-compat.js

@@ -0,0 +1,112 @@
+const repairedRuntimes = new WeakSet();
+const repairPromises = new WeakMap();
+export function quoteIdent(name) {
+    return `"${name.replace(/"/g, '""')}"`;
+}
+export function sanitizeIdentifier(value) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    if (!trimmed)
+        return null;
+    const sanitized = trimmed.replace(/[^a-zA-Z0-9_]/g, "");
+    if (sanitized.length === 0 || sanitized.length > 128)
+        return null;
+    return sanitized;
+}
+export function sqlLiteral(value) {
+    return `'${value.replace(/'/g, "''")}'`;
+}
+export async function executeRawSql(runtime, sqlText) {
+    const db = runtime.adapter.db;
+    if (!db?.execute) {
+        throw new Error("Database adapter not available");
+    }
+    const { sql } = await import("drizzle-orm");
+    const result = await db.execute(sql.raw(sqlText));
+    const rows = Array.isArray(result.rows) ? result.rows : [];
+    const columns = Array.isArray(result.fields)
+        ? result.fields.map((field) => field.name)
+        : Object.keys(rows[0] ?? {});
+    return { rows, columns };
+}
+async function getTableColumnNames(runtime, tableName, schemaName = "public") {
+    const columns = new Set();
+    try {
+        const { rows } = await executeRawSql(runtime, `SELECT column_name
+         FROM information_schema.columns
+        WHERE table_schema = ${sqlLiteral(schemaName)}
+          AND table_name = ${sqlLiteral(tableName)}
+        ORDER BY ordinal_position`);
+        for (const row of rows) {
+            const value = row.column_name;
+            if (typeof value === "string" && value.length > 0) {
+                columns.add(value);
+            }
+        }
+    }
+    catch {
+        // Fall through to PRAGMA for PGlite/SQLite compatibility.
+    }
+    if (columns.size > 0) {
+        return columns;
+    }
+    try {
+        const safeTableName = sanitizeIdentifier(tableName);
+        if (!safeTableName) {
+            return columns;
+        }
+        const { rows } = await executeRawSql(runtime, `PRAGMA table_info(${safeTableName})`);
+        for (const row of rows) {
+            const value = row.name;
+            if (typeof value === "string" && value.length > 0) {
+                columns.add(value);
+            }
+        }
+    }
+    catch {
+        // Ignore missing-table/missing-pragma support.
+    }
+    return columns;
+}
+async function addColumnIfMissing(runtime, tableName, columnName, definition) {
+    const columns = await getTableColumnNames(runtime, tableName);
+    if (columns.has(columnName)) {
+        return;
+    }
+    throw new Error(`[sql-compat] Missing required column ${quoteIdent(tableName)}.${quoteIdent(columnName)} (${definition}). Run the appropriate database migrations before starting the app.`);
+}
+export async function ensureRuntimeSqlCompatibility(runtime) {
+    if (!runtime?.adapter?.db) {
+        return;
+    }
+    if (repairedRuntimes.has(runtime)) {
+        return;
+    }
+    const existingRepair = repairPromises.get(runtime);
+    if (existingRepair) {
+        await existingRepair;
+        return;
+    }
+    const repairPromise = (async () => {
+        await addColumnIfMissing(runtime, "participants", "agent_id", 'uuid REFERENCES "agents"("id") ON DELETE CASCADE');
+        await addColumnIfMissing(runtime, "participants", "room_state", "text");
+        for (const [columnName, definition] of [
+            ["step_count", "integer NOT NULL DEFAULT 0"],
+            ["llm_call_count", "integer NOT NULL DEFAULT 0"],
+            ["total_prompt_tokens", "integer NOT NULL DEFAULT 0"],
+            ["total_completion_tokens", "integer NOT NULL DEFAULT 0"],
+            ["total_reward", "real NOT NULL DEFAULT 0"],
+            ["scenario_id", "text"],
+            ["batch_id", "text"],
+        ]) {
+            await addColumnIfMissing(runtime, "trajectories", columnName, definition);
+        }
+        repairedRuntimes.add(runtime);
+    })().finally(() => {
+        repairPromises.delete(runtime);
+    });
+    repairPromises.set(runtime, repairPromise);
+    await repairPromise;
+}
+//# sourceMappingURL=sql-compat.js.map

package/utils/sql-compat.js.map

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

package/utils/streaming-text.d.ts

@@ -0,0 +1,9 @@
+export declare function mergeStreamingText(existing: string, incoming: string): string;
+export declare function computeStreamingDelta(existing: string, incoming: string): string;
+export type StreamingUpdateResult = {
+    kind: "append" | "replace" | "unchanged";
+    nextText: string;
+    emittedText: string;
+};
+export declare function resolveStreamingUpdate(existing: string, incoming: string): StreamingUpdateResult;
+//# sourceMappingURL=streaming-text.d.ts.map

package/utils/streaming-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-text.d.ts","sourceRoot":"","sources":["../../src/utils/streaming-text.ts"],"names":[],"mappings":"AA6DA,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiE7E;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,CAOR;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,qBAAqB,CAgBvB"}

package/utils/streaming-text.js

@@ -0,0 +1,116 @@
+/**
+ * Merge streaming text updates that may arrive as pure deltas, cumulative
+ * snapshots, or overlapping suffix/prefix fragments.
+ */
+function commonPrefixLength(left, right) {
+    const maxLength = Math.min(left.length, right.length);
+    let index = 0;
+    while (index < maxLength &&
+        left.charCodeAt(index) === right.charCodeAt(index)) {
+        index += 1;
+    }
+    return index;
+}
+function commonSuffixLength(left, right, sharedPrefixLength) {
+    const maxLength = Math.min(left.length - sharedPrefixLength, right.length - sharedPrefixLength);
+    let length = 0;
+    while (length < maxLength &&
+        left.charCodeAt(left.length - 1 - length) ===
+            right.charCodeAt(right.length - 1 - length)) {
+        length += 1;
+    }
+    return length;
+}
+function isLikelySnapshotReplacement(existing, incoming) {
+    const sharedPrefixLength = commonPrefixLength(existing, incoming);
+    const sharedSuffixLength = commonSuffixLength(existing, incoming, sharedPrefixLength);
+    const sharedLength = sharedPrefixLength + sharedSuffixLength;
+    const minLength = Math.min(existing.length, incoming.length);
+    // For short strings, a modest shared prefix is strong evidence of a
+    // snapshot replacement (e.g. case correction, punctuation addition).
+    if (minLength < 30 && sharedPrefixLength >= 2) {
+        return true;
+    }
+    return (sharedPrefixLength >= 8 ||
+        sharedLength >= Math.max(4, Math.ceil(minLength * 0.7)));
+}
+export function mergeStreamingText(existing, incoming) {
+    if (!incoming)
+        return existing;
+    if (!existing)
+        return incoming;
+    // Normalize unicode for comparison, but return original incoming when selected.
+    const existingNorm = existing.normalize("NFC");
+    const incomingNorm = incoming.normalize("NFC");
+    if (incomingNorm === existingNorm) {
+        return incoming.length === 1 && /\S/u.test(incoming)
+            ? `${existing}${incoming}`
+            : incoming;
+    }
+    // Common case: the stream sends the full text-so-far.
+    if (incomingNorm.startsWith(existingNorm)) {
+        return incoming;
+    }
+    // Some providers resend the full text with a revised prefix or wrapper.
+    if (incomingNorm.includes(existingNorm)) {
+        return incoming;
+    }
+    // Ignore clearly regressive snapshots.
+    if (existingNorm.startsWith(incomingNorm)) {
+        return existing;
+    }
+    // Use trimmed existing for overlap detection so trailing whitespace
+    // does not prevent finding a valid overlap.
+    const existingTrimmed = existingNorm.trimEnd();
+    const maxOverlap = Math.min(existingTrimmed.length, incomingNorm.length);
+    const existingTrimmedLength = existingTrimmed.length;
+    for (let overlap = maxOverlap; overlap > 0; overlap -= 1) {
+        const existingStart = existingTrimmedLength - overlap;
+        let match = true;
+        for (let index = 0; index < overlap; index += 1) {
+            if (existingTrimmed.charCodeAt(existingStart + index) !==
+                incomingNorm.charCodeAt(index)) {
+                match = false;
+                break;
+            }
+        }
+        if (!match)
+            continue;
+        if (overlap === incomingNorm.length) {
+            // Preserve repeated single-character deltas like "l" + "l", but avoid
+            // replaying larger suffix fragments already present in the buffer.
+            return incoming.length === 1 ? `${existing}${incoming}` : existing;
+        }
+        return `${existing.slice(0, existing.length - (existingNorm.length - existingTrimmedLength))}${incoming.slice(overlap)}`;
+    }
+    // Some providers revise earlier words in-place while still sending the full
+    // text-so-far. Treat those as snapshot replacements instead of appends.
+    if (isLikelySnapshotReplacement(existingNorm, incomingNorm)) {
+        return incoming;
+    }
+    return `${existing}${incoming}`;
+}
+export function computeStreamingDelta(existing, incoming) {
+    const merged = mergeStreamingText(existing, incoming);
+    if (merged === existing)
+        return "";
+    if (merged.startsWith(existing)) {
+        return merged.slice(existing.length);
+    }
+    return incoming;
+}
+export function resolveStreamingUpdate(existing, incoming) {
+    const merged = mergeStreamingText(existing, incoming);
+    if (merged === existing) {
+        return { kind: "unchanged", nextText: existing, emittedText: "" };
+    }
+    if (merged.startsWith(existing)) {
+        return {
+            kind: "append",
+            nextText: merged,
+            emittedText: merged.slice(existing.length),
+        };
+    }
+    return { kind: "replace", nextText: merged, emittedText: merged };
+}
+//# sourceMappingURL=streaming-text.js.map

package/utils/streaming-text.js.map

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

package/utils/tts-debug.d.ts

@@ -0,0 +1,10 @@
+/** Same predicate as `ttsDebug` — use to attach optional debug headers / task metadata. */
+export declare function isTtsDebugEnabled(): boolean;
+/**
+ * Single-line preview of text for TTS debug logs (avoids huge console lines).
+ * Enable `ELIZA_TTS_DEBUG` only when you accept that spoken lines may appear in logs.
+ */
+export declare function ttsDebugTextPreview(text: string, maxChars?: number): string;
+export declare function setTtsDebugSink(sink: ((phase: string, detail?: Record<string, unknown>) => void) | null): void;
+export declare function ttsDebug(phase: string, detail?: Record<string, unknown>): void;
+//# sourceMappingURL=tts-debug.d.ts.map

package/utils/tts-debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tts-debug.d.ts","sourceRoot":"","sources":["../../src/utils/tts-debug.ts"],"names":[],"mappings":"AA4CA,2FAA2F;AAC3F,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAA4B,GACrC,MAAM,CAIR;AAUD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,GACvE,IAAI,CAEN;AAED,wBAAgB,QAAQ,CACtB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI,CAGN"}