@elizaos/shared 2.0.0-alpha.538 → 2.0.3-beta.2

package/utils/asset-url.d.ts

@@ -0,0 +1,24 @@
+type AssetUrlResolveOptions = {
+    currentUrl?: string;
+    baseUrl?: string;
+};
+/**
+ * Resolve an app public asset path into a URL safe across http(s), custom
+ * schemes, and packaged file:// runtimes.
+ */
+export declare function resolveAppAssetUrl(assetPath: string, options?: AssetUrlResolveOptions): string;
+/**
+ * Resolve an API path (e.g. "/api/avatar/vrm") to a full URL reachable from
+ * the renderer. In desktop shells the page origin is electrobun:// or
+ * file://, so bare /api/... paths resolve to the SPA instead of the backend.
+ *
+ * Resolution order: boot `apiBase` → shell-injected `__ELIZAOS_API_BASE__` →
+ * `sessionStorage` fallback. The boot config is the current client-owned
+ * source of truth because `client.setBaseUrl()` updates it whenever the user
+ * switches servers. Injection still beats stale session state from prior
+ * sessions, but it must not override the active runtime target once the client
+ * has changed it.
+ */
+export declare function resolveApiUrl(apiPath: string): string;
+export {};
+//# sourceMappingURL=asset-url.d.ts.map

package/utils/asset-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-url.d.ts","sourceRoot":"","sources":["../../src/utils/asset-url.ts"],"names":[],"mappings":"AAWA,KAAK,sBAAsB,GAAG;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AA0EF;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,MAAM,CAgCR;AAgBD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAYrD"}

package/utils/asset-url.js

@@ -0,0 +1,151 @@
+/**
+ * Resolve app-shipped public assets (e.g. vrms/, animations/) to runtime-safe URLs.
+ *
+ * In packaged desktop builds, the renderer can run on file:// and later navigate to
+ * absolute paths (e.g. /chat). Root-relative assets like /vrms/1.vrm then
+ * resolve to file:///vrms/1.vrm and fail. We lock the asset base URL once from
+ * initial startup and resolve assets against that stable base.
+ */
+import { getBootConfig } from "../config/boot-config.js";
+import { getElizaApiBase } from "./eliza-globals.js";
+let cachedRuntimeBaseHref = null;
+function stripLeadingPathMarkers(assetPath) {
+    return assetPath
+        .trim()
+        .replace(/^\.?\//, "")
+        .replace(/^\/+/, "");
+}
+function isAlreadyAbsolute(assetPath) {
+    if (assetPath.startsWith("//"))
+        return true;
+    return /^[A-Za-z][A-Za-z0-9+.-]*:/.test(assetPath);
+}
+function normalizeBaseHref(baseHref) {
+    return baseHref.endsWith("/") ? baseHref : `${baseHref}/`;
+}
+function inferBaseForUrl(url) {
+    if (url.protocol !== "file:")
+        return "/";
+    const pathname = url.pathname || "/";
+    if (pathname.endsWith("/"))
+        return pathname;
+    const lastSlash = pathname.lastIndexOf("/");
+    if (lastSlash < 0)
+        return "/";
+    const tail = pathname.slice(lastSlash + 1);
+    // If the path ends in a file name, use that file's directory.
+    if (tail.includes("."))
+        return pathname.slice(0, lastSlash + 1) || "/";
+    return "/";
+}
+/**
+ * For http/https origins (web + Electrobun dev static server) the static asset
+ * root is always the origin root. We must NOT honor Vite's `base: "./"` here
+ * because relative resolution against the current SPA route URL produces
+ * `/apps/app-heroes/...` etc., which the SPA's catch-all returns HTML for —
+ * silently breaking <img> tags via decode errors.
+ */
+function shouldIgnoreViteBase(url) {
+    return url.protocol === "http:" || url.protocol === "https:";
+}
+function computeBaseHref(currentUrl, baseUrl) {
+    const current = new URL(currentUrl);
+    const explicit = baseUrl?.trim();
+    const base = explicit && !shouldIgnoreViteBase(current)
+        ? explicit
+        : inferBaseForUrl(current);
+    return new URL(base, current).href;
+}
+function runtimeBaseHref() {
+    if (cachedRuntimeBaseHref)
+        return cachedRuntimeBaseHref;
+    if (typeof window === "undefined")
+        return null;
+    const href = window.location?.href;
+    if (typeof href !== "string" || !href)
+        return null;
+    try {
+        const viteBaseUrl = import.meta.env
+            ?.BASE_URL;
+        cachedRuntimeBaseHref = computeBaseHref(href, viteBaseUrl);
+        return cachedRuntimeBaseHref;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve an app public asset path into a URL safe across http(s), custom
+ * schemes, and packaged file:// runtimes.
+ */
+export function resolveAppAssetUrl(assetPath, options) {
+    if (!assetPath)
+        return assetPath;
+    if (isAlreadyAbsolute(assetPath))
+        return assetPath;
+    const normalized = stripLeadingPathMarkers(assetPath);
+    if (!normalized)
+        return normalized;
+    const configuredBaseUrl = getBootConfig().assetBaseUrl?.trim();
+    if (configuredBaseUrl) {
+        try {
+            return new URL(normalized, normalizeBaseHref(configuredBaseUrl)).toString();
+        }
+        catch {
+            // Fall through to local runtime resolution when the configured CDN base is invalid.
+        }
+    }
+    if (options?.currentUrl) {
+        try {
+            const baseHref = computeBaseHref(options.currentUrl, options.baseUrl);
+            return new URL(normalized, baseHref).toString();
+        }
+        catch {
+            return `/${normalized}`;
+        }
+    }
+    const baseHref = runtimeBaseHref();
+    if (!baseHref)
+        return `/${normalized}`;
+    return new URL(normalized, baseHref).toString();
+}
+/** Keep in sync with `ElizaClient` SESSION_STORAGE_API_BASE_KEY. */
+const ELIZA_API_BASE_SESSION_KEY = "elizaos_api_base";
+function readSessionStorageApiBase() {
+    try {
+        if (typeof window === "undefined")
+            return undefined;
+        const raw = window.sessionStorage.getItem(ELIZA_API_BASE_SESSION_KEY);
+        const trimmed = raw?.trim();
+        return trimmed && trimmed.length > 0 ? trimmed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Resolve an API path (e.g. "/api/avatar/vrm") to a full URL reachable from
+ * the renderer. In desktop shells the page origin is electrobun:// or
+ * file://, so bare /api/... paths resolve to the SPA instead of the backend.
+ *
+ * Resolution order: boot `apiBase` → shell-injected `__ELIZAOS_API_BASE__` →
+ * `sessionStorage` fallback. The boot config is the current client-owned
+ * source of truth because `client.setBaseUrl()` updates it whenever the user
+ * switches servers. Injection still beats stale session state from prior
+ * sessions, but it must not override the active runtime target once the client
+ * has changed it.
+ */
+export function resolveApiUrl(apiPath) {
+    const bootRaw = getBootConfig().apiBase?.trim();
+    const boot = bootRaw && bootRaw.length > 0 ? bootRaw : undefined;
+    const injectedRaw = getElizaApiBase()?.trim();
+    const injected = injectedRaw && injectedRaw.length > 0 ? injectedRaw : undefined;
+    const stored = readSessionStorageApiBase();
+    const base = boot ?? injected ?? stored;
+    if (!base)
+        return apiPath;
+    const normalized = base.replace(/\/+$/, "");
+    const suffix = apiPath.startsWith("/") ? apiPath : `/${apiPath}`;
+    return `${normalized}${suffix}`;
+}
+//# sourceMappingURL=asset-url.js.map

package/utils/asset-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-url.js","sourceRoot":"","sources":["../../src/utils/asset-url.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAOrD,IAAI,qBAAqB,GAAkB,IAAI,CAAC;AAEhD,SAAS,uBAAuB,CAAC,SAAiB;IAChD,OAAO,SAAS;SACb,IAAI,EAAE;SACN,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAiB;IAC1C,IAAI,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO,2BAA2B,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgB;IACzC,OAAO,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,GAAG,CAAC;AAC5D,CAAC;AAED,SAAS,eAAe,CAAC,GAAQ;IAC/B,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,GAAG,CAAC;IAEzC,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC;IACrC,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IAE5C,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,SAAS,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAE9B,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IAC3C,8DAA8D;IAC9D,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC;IAEvE,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,SAAS,oBAAoB,CAAC,GAAQ;IACpC,OAAO,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC;AAC/D,CAAC;AAED,SAAS,eAAe,CAAC,UAAkB,EAAE,OAAgB;IAC3D,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC;IACjC,MAAM,IAAI,GACR,QAAQ,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC;QACxC,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAC/B,OAAO,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;AACrC,CAAC;AAED,SAAS,eAAe;IACtB,IAAI,qBAAqB;QAAE,OAAO,qBAAqB,CAAC;IACxD,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAE/C,MAAM,IAAI,GAAI,MAAM,CAAC,QAA2C,EAAE,IAAI,CAAC;IACvE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEnD,IAAI,CAAC;QACH,MAAM,WAAW,GAAI,MAAM,CAAC,IAAwC,CAAC,GAAG;YACtE,EAAE,QAAQ,CAAC;QACb,qBAAqB,GAAG,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAC3D,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAAiB,EACjB,OAAgC;IAEhC,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,IAAI,iBAAiB,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAEnD,MAAM,UAAU,GAAG,uBAAuB,CAAC,SAAS,CAAC,CAAC;IACtD,IAAI,CAAC,UAAU;QAAE,OAAO,UAAU,CAAC;IAEnC,MAAM,iBAAiB,GAAG,aAAa,EAAE,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC;IAC/D,IAAI,iBAAiB,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,IAAI,GAAG,CACZ,UAAU,EACV,iBAAiB,CAAC,iBAAiB,CAAC,CACrC,CAAC,QAAQ,EAAE,CAAC;QACf,CAAC;QAAC,MAAM,CAAC;YACP,oFAAoF;QACtF,CAAC;IACH,CAAC;IAED,IAAI,OAAO,EAAE,UAAU,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YACtE,OAAO,IAAI,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,UAAU,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IACnC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,UAAU,EAAE,CAAC;IAEvC,OAAO,IAAI,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;AAClD,CAAC;AAED,oEAAoE;AACpE,MAAM,0BAA0B,GAAG,kBAAkB,CAAC;AAEtD,SAAS,yBAAyB;IAChC,IAAI,CAAC;QACH,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO,SAAS,CAAC;QACpD,MAAM,GAAG,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC;QAC5B,OAAO,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,MAAM,WAAW,GAAG,eAAe,EAAE,EAAE,IAAI,EAAE,CAAC;IAC9C,MAAM,QAAQ,GACZ,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,MAAM,MAAM,GAAG,yBAAyB,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAI,IAAI,QAAQ,IAAI,MAAM,CAAC;IACxC,IAAI,CAAC,IAAI;QAAE,OAAO,OAAO,CAAC;IAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;IACjE,OAAO,GAAG,UAAU,GAAG,MAAM,EAAE,CAAC;AAClC,CAAC"}

package/utils/assistant-text.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Extracts the user-facing reply from a response-handler payload that leaked as
+ * plain text. Local models can emit tool arguments as text when function-call
+ * transport is unavailable, for example:
+ *
+ *   "RESPOND", "contexts": ["simple"], "replyText": "Hello"
+ *
+ * That string is valid object content once the first value is named
+ * `shouldRespond`, so parse that shape without touching ordinary chat text.
+ */
+export declare function extractAssistantReplyText(input: string): string | null;
+export declare function stripAssistantStageDirections(input: string): string;
+//# sourceMappingURL=assistant-text.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-text.d.ts","sourceRoot":"","sources":["../../src/utils/assistant-text.ts"],"names":[],"mappings":"AA0PA;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA6CtE;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMnE"}

package/utils/assistant-text.js

@@ -0,0 +1,292 @@
+const STAGE_DIRECTION_FIRST_WORDS = new Set([
+    "beam",
+    "beams",
+    "beaming",
+    "blink",
+    "blinks",
+    "blinking",
+    "blush",
+    "blushes",
+    "blushing",
+    "bow",
+    "bows",
+    "bowing",
+    "breathe",
+    "breathes",
+    "breathing",
+    "cheer",
+    "cheers",
+    "cheering",
+    "chuckle",
+    "chuckles",
+    "chuckling",
+    "clap",
+    "claps",
+    "clapping",
+    "cry",
+    "cries",
+    "crying",
+    "curtsy",
+    "curtsies",
+    "curtsying",
+    "dance",
+    "dances",
+    "dancing",
+    "frown",
+    "frowns",
+    "frowning",
+    "gasp",
+    "gasps",
+    "gasping",
+    "gesture",
+    "gestures",
+    "gesturing",
+    "giggle",
+    "giggles",
+    "giggling",
+    "glance",
+    "glances",
+    "glancing",
+    "grin",
+    "grins",
+    "grinning",
+    "laugh",
+    "laughs",
+    "laughing",
+    "lean",
+    "leans",
+    "leaning",
+    "look",
+    "looks",
+    "looking",
+    "nod",
+    "nods",
+    "nodding",
+    "pause",
+    "pauses",
+    "pausing",
+    "point",
+    "points",
+    "pointing",
+    "pose",
+    "poses",
+    "posing",
+    "pout",
+    "pouts",
+    "pouting",
+    "raise",
+    "raises",
+    "raising",
+    "shrug",
+    "shrugs",
+    "shrugging",
+    "sigh",
+    "sighs",
+    "sighing",
+    "smile",
+    "smiles",
+    "smiling",
+    "smirk",
+    "smirks",
+    "smirking",
+    "spin",
+    "spins",
+    "spinning",
+    "stare",
+    "stares",
+    "staring",
+    "stretch",
+    "stretches",
+    "stretching",
+    "sway",
+    "sways",
+    "swaying",
+    "tilt",
+    "tilts",
+    "tilting",
+    "wave",
+    "waves",
+    "waving",
+    "whisper",
+    "whispers",
+    "whispering",
+    "wink",
+    "winks",
+    "winking",
+    "yawn",
+    "yawns",
+    "yawning",
+]);
+function collapseInlineWhitespace(input) {
+    return input.replace(/[ \t]+/g, " ").trim();
+}
+function looksLikeStageDirection(input) {
+    const normalized = collapseInlineWhitespace(input).trim();
+    if (!normalized || normalized.length > 100)
+        return false;
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: intentional ASCII-range check to reject non-ASCII input
+    if (/[^\x00-\x7F]/.test(normalized)) {
+        return false;
+    }
+    const wordMatch = normalized.match(/^[^\w]*([A-Za-z]+)/);
+    if (!wordMatch)
+        return false;
+    const firstWord = wordMatch[1].toLowerCase();
+    return STAGE_DIRECTION_FIRST_WORDS.has(firstWord);
+}
+function stripWrappedStageDirections(input, pattern) {
+    return input.replace(pattern, (match, inner, offset, source) => {
+        const prev = source[offset - 1] ?? "";
+        const next = source[offset + match.length] ?? "";
+        const hasSafeLeftBoundary = offset === 0 || /[\s([{>"'“‘.!?,;:-]/.test(prev);
+        const hasSafeRightBoundary = offset + match.length >= source.length ||
+            /[\s)\]}<"'”’.!?,;:-]/.test(next);
+        if (!hasSafeLeftBoundary ||
+            !hasSafeRightBoundary ||
+            !looksLikeStageDirection(inner)) {
+            return match;
+        }
+        return " ";
+    });
+}
+function tidyAssistantTextSpacing(input) {
+    const safe = input.length > 200_000 ? input.slice(0, 200_000) : input;
+    return safe
+        .replace(/[ \t]+\n/g, "\n")
+        .replace(/\n[ \t]+/g, "\n")
+        .replace(/[ \t]{2,}/g, " ")
+        .replace(/ ?([,.;!?])/g, "$1")
+        .replace(/\(\s+/g, "(")
+        .replace(/\s+\)/g, ")");
+}
+function tryParseObject(input) {
+    try {
+        const parsed = JSON.parse(input);
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed)
+            ? parsed
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+function isResponseHandlerPayload(value) {
+    const shouldRespond = value.shouldRespond;
+    return (typeof value.replyText === "string" &&
+        (shouldRespond === "RESPOND" ||
+            shouldRespond === "IGNORE" ||
+            shouldRespond === "STOP" ||
+            Array.isArray(value.contexts) ||
+            Array.isArray(value.intents) ||
+            Array.isArray(value.threadOps) ||
+            Array.isArray(value.candidateActionNames)));
+}
+// Structural keys an elizaOS reply object may legitimately carry alongside the
+// user-facing `reply`. When a parsed object's keys are ALL within this set and
+// it has a string `reply`, the model emitted its whole response object as text
+// (e.g. `{"reply":"107"}` or `{"reply":"…","action":"NONE"}`) — unwrap it. The
+// allow-list keeps us from stripping real chat content that merely happens to be
+// JSON with a `reply` field plus unrelated data.
+const REPLY_PAYLOAD_KEYS = new Set([
+    "reply",
+    "response",
+    "text",
+    "message",
+    "thought",
+    "action",
+    "actions",
+    "simple",
+    "providers",
+    "evaluators",
+    "inReplyTo",
+    "attachments",
+]);
+// The model wraps its answer under `reply` or `response` (the key drifts by
+// model/image — both observed on cloud agents). Return the primitive value from
+// whichever is present, but only when EVERY key is a known response-shape key,
+// so ordinary chat text that merely contains JSON is never rewritten. Allows a
+// primitive value (`{"reply":42}` / `{"response":true}`), not just strings;
+// objects/arrays aren't user-facing text and are rejected.
+const PRIMARY_REPLY_KEYS = ["reply", "response"];
+function getSimpleReplyValue(value) {
+    let found;
+    for (const key of PRIMARY_REPLY_KEYS) {
+        const candidate = value[key];
+        if (typeof candidate === "string" ||
+            typeof candidate === "number" ||
+            typeof candidate === "boolean") {
+            found = candidate;
+            break;
+        }
+    }
+    if (found === undefined)
+        return null;
+    for (const key of Object.keys(value)) {
+        if (!REPLY_PAYLOAD_KEYS.has(key))
+            return null;
+    }
+    return String(found);
+}
+/**
+ * Extracts the user-facing reply from a response-handler payload that leaked as
+ * plain text. Local models can emit tool arguments as text when function-call
+ * transport is unavailable, for example:
+ *
+ *   "RESPOND", "contexts": ["simple"], "replyText": "Hello"
+ *
+ * That string is valid object content once the first value is named
+ * `shouldRespond`, so parse that shape without touching ordinary chat text.
+ */
+export function extractAssistantReplyText(input) {
+    if (typeof input !== "string")
+        return null;
+    const trimmed = input.trim();
+    // Shape 1: a leaked response-handler payload keyed by `replyText` — either the
+    // full object or a bare argument fragment (`"RESPOND", "replyText": "Hi"`).
+    if (trimmed.includes("replyText")) {
+        const candidates = [trimmed];
+        if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) {
+            candidates.push(`{"shouldRespond":${trimmed}}`);
+            if (trimmed.endsWith("}")) {
+                candidates.push(`{"shouldRespond":${trimmed.slice(0, -1)}}`);
+            }
+        }
+        for (const candidate of candidates) {
+            const parsed = tryParseObject(candidate);
+            if (!parsed || !isResponseHandlerPayload(parsed))
+                continue;
+            const replyText = parsed.replyText.trim();
+            if (!replyText)
+                return null;
+            return stripAssistantStageDirections(replyText).trim() || null;
+        }
+    }
+    // Shape 2: the model emitted its whole reply object as text, e.g.
+    // `{"reply":"107"}`, `{"response":"54"}`, or `{"reply":"…","action":"NONE"}`
+    // (observed from gpt-oss/glm on cloud agents; the wrapper key drifts between
+    // `reply` and `response`). Only unwrap a well-formed object whose keys are all
+    // known response-shape keys, so ordinary chat text that merely contains JSON
+    // is never rewritten.
+    if (trimmed.startsWith("{") &&
+        trimmed.endsWith("}") &&
+        (trimmed.includes('"reply"') || trimmed.includes('"response"'))) {
+        const parsed = tryParseObject(trimmed);
+        const reply = parsed ? getSimpleReplyValue(parsed) : null;
+        if (reply !== null) {
+            const trimmedReply = reply.trim();
+            if (!trimmedReply)
+                return null;
+            return stripAssistantStageDirections(trimmedReply).trim() || null;
+        }
+    }
+    return null;
+}
+export function stripAssistantStageDirections(input) {
+    if (typeof input !== "string")
+        return "";
+    let normalized = input;
+    normalized = stripWrappedStageDirections(normalized, /\*([^*\n]+)\*/g);
+    normalized = stripWrappedStageDirections(normalized, /_([^_\n]+)_/g);
+    return tidyAssistantTextSpacing(normalized);
+}
+//# sourceMappingURL=assistant-text.js.map

package/utils/assistant-text.js.map

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

package/utils/browser-tab-kit-types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Typed contract for the in-tab kit installed by BROWSER_TAB_PRELOAD_SCRIPT.
+ *
+ * The kit lives at `window.__elizaTabKit` inside every <electrobun-webview>
+ * tab and provides:
+ *   - a visual cursor overlay the user sees moving as the agent works,
+ *   - faithful pointer-event sequences (vs the bare `element.click()` of the
+ *     legacy command path),
+ *   - keyboard-accurate typing that triggers React controlled-input change
+ *     detection.
+ *
+ * The host (running in the main webview) calls these via short
+ * `tag.executeJavascript(...)` snippets that reference `window.__elizaTabKit.*`.
+ * The original `__elizaTabExec(requestId, script)` channel is unchanged — the
+ * kit is additive.
+ *
+ * Synthetic events have `isTrusted === false` (not forge-able from script).
+ * That's acceptable for React-driven sites and most Web3 UIs; sites that
+ * specifically gate on `isTrusted` cannot be driven by this kit; callers must
+ * use a CDP-backed browser automation path for those pages.
+ */
+export interface BrowserTabKitCursorPoint {
+    x: number;
+    y: number;
+}
+export interface BrowserTabKitMoveOptions {
+    /** Animation duration in ms; defaults to 220. */
+    durationMs?: number;
+}
+export interface BrowserTabKitDispatchOptions {
+    /** Center of the click in viewport CSS pixels. Defaults to element center. */
+    x?: number;
+    y?: number;
+    /** Mouse button: 0 = primary, 1 = middle, 2 = secondary. Default 0. */
+    button?: 0 | 1 | 2;
+    /** True for double-click semantics. */
+    doubleClick?: boolean;
+}
+export interface BrowserTabKitTypeOptions {
+    /** Per-character delay in ms (uniform). Defaults to 18. */
+    perCharDelayMs?: number;
+    /** True to clear the existing value first. */
+    replace?: boolean;
+}
+/**
+ * Fully-formed RPC surface attached to `window.__elizaTabKit` inside every
+ * agent-driven tab. Methods are async (returning Promise) when they involve
+ * animation or fetch; sync otherwise.
+ */
+export interface BrowserTabKit {
+    cursor: {
+        moveTo: (target: BrowserTabKitCursorPoint, options?: BrowserTabKitMoveOptions) => Promise<void>;
+        click: (target: BrowserTabKitCursorPoint) => Promise<void>;
+        highlight: (element: Element, durationMs?: number) => void;
+        show: () => void;
+        hide: () => void;
+    };
+    dispatchPointerSequence: (target: Element, options?: BrowserTabKitDispatchOptions) => Promise<void>;
+    typeRealistic: (target: Element, text: string, options?: BrowserTabKitTypeOptions) => Promise<void>;
+    /**
+     * Populate an `<input type=file>` from a URL or data: URI by fetching the
+     * bytes, wrapping them in a File, and assigning via DataTransfer. Real
+     * browser file inputs cannot be set from script otherwise — security
+     * sandbox blocks direct .files assignment of arbitrary paths. DataTransfer
+     * is the standard workaround that fires the file's `change` event.
+     */
+    setFileInput: (target: HTMLInputElement, url: string, options?: {
+        fileName?: string;
+        mimeType?: string;
+    }) => Promise<{
+        name: string;
+        size: number;
+        type: string;
+    }>;
+}
+declare global {
+    interface Window {
+        __elizaTabKit?: BrowserTabKit;
+    }
+}
+//# sourceMappingURL=browser-tab-kit-types.d.ts.map

package/utils/browser-tab-kit-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-tab-kit-types.d.ts","sourceRoot":"","sources":["../../src/utils/browser-tab-kit-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,wBAAwB;IACvC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,wBAAwB;IACvC,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,4BAA4B;IAC3C,8EAA8E;IAC9E,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,uCAAuC;IACvC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE;QACN,MAAM,EAAE,CACN,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,wBAAwB,KAC/B,OAAO,CAAC,IAAI,CAAC,CAAC;QACnB,KAAK,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3D,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QAC3D,IAAI,EAAE,MAAM,IAAI,CAAC;QACjB,IAAI,EAAE,MAAM,IAAI,CAAC;KAClB,CAAC;IACF,uBAAuB,EAAE,CACvB,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,4BAA4B,KACnC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,aAAa,EAAE,CACb,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,wBAAwB,KAC/B,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB;;;;;;OAMG;IACH,YAAY,EAAE,CACZ,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,KAC/C,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,aAAa,CAAC,EAAE,aAAa,CAAC;KAC/B;CACF"}

package/utils/browser-tab-kit-types.js

@@ -0,0 +1,23 @@
+/**
+ * Typed contract for the in-tab kit installed by BROWSER_TAB_PRELOAD_SCRIPT.
+ *
+ * The kit lives at `window.__elizaTabKit` inside every <electrobun-webview>
+ * tab and provides:
+ *   - a visual cursor overlay the user sees moving as the agent works,
+ *   - faithful pointer-event sequences (vs the bare `element.click()` of the
+ *     legacy command path),
+ *   - keyboard-accurate typing that triggers React controlled-input change
+ *     detection.
+ *
+ * The host (running in the main webview) calls these via short
+ * `tag.executeJavascript(...)` snippets that reference `window.__elizaTabKit.*`.
+ * The original `__elizaTabExec(requestId, script)` channel is unchanged — the
+ * kit is additive.
+ *
+ * Synthetic events have `isTrusted === false` (not forge-able from script).
+ * That's acceptable for React-driven sites and most Web3 UIs; sites that
+ * specifically gate on `isTrusted` cannot be driven by this kit; callers must
+ * use a CDP-backed browser automation path for those pages.
+ */
+export {};
+//# sourceMappingURL=browser-tab-kit-types.js.map

package/utils/browser-tab-kit-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-tab-kit-types.js","sourceRoot":"","sources":["../../src/utils/browser-tab-kit-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}