@elizaos/shared 2.0.0-beta.1 → 2.0.3-beta.3

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/string-hash.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Deterministic, non-cryptographic string hash. Multiplies by 31 per character
+ * (the classic JVM `String.hashCode` mixing), keeps the running value in int32
+ * via `| 0`, and returns a non-negative number.
+ *
+ * Used by the hero-art generators to seed palettes/hues/offsets so the same
+ * input always produces byte-identical SVG output across runs and platforms.
+ * Not suitable for security or collision-sensitive use.
+ */
+export declare function hashString(value: string): number;
+//# sourceMappingURL=string-hash.d.ts.map

package/utils/string-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-hash.d.ts","sourceRoot":"","sources":["../../src/utils/string-hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMhD"}

package/utils/string-hash.js

@@ -0,0 +1,17 @@
+/**
+ * Deterministic, non-cryptographic string hash. Multiplies by 31 per character
+ * (the classic JVM `String.hashCode` mixing), keeps the running value in int32
+ * via `| 0`, and returns a non-negative number.
+ *
+ * Used by the hero-art generators to seed palettes/hues/offsets so the same
+ * input always produces byte-identical SVG output across runs and platforms.
+ * Not suitable for security or collision-sensitive use.
+ */
+export function hashString(value) {
+    let hash = 0;
+    for (let index = 0; index < value.length; index += 1) {
+        hash = (hash * 31 + value.charCodeAt(index)) | 0;
+    }
+    return Math.abs(hash);
+}
+//# sourceMappingURL=string-hash.js.map

package/utils/string-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-hash.js","sourceRoot":"","sources":["../../src/utils/string-hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,IAAI,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

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"}

package/utils/tts-debug.js

@@ -0,0 +1,73 @@
+/// <reference types="vite/client" />
+/**
+ * TTS pipeline tracing (opt-in). Prefix: `[eliza][tts]`.
+ * Never pass secrets in `detail`. With debug on, `preview` fields may contain
+ * user-visible spoken text — disable in shared logs / production.
+ *
+ * Playback phases (browser console): `play:web-audio:start|end` (ElevenLabs /
+ * cloud MP3), `speakBrowser:enter`, `play:browser:web-speech:enqueued`,
+ * `play:browser:speechSynthesis:start|end|error`, `play:talkmode:dispatch|speak-failed`,
+ * `play:browser:no-synth`. Server logs: `server:cloud-tts:*` (includes optional
+ * `messageId`, `clipSegment`, `hearingFull` when the client sends
+ * `x-elizaos-tts-*` headers on `/api/tts/cloud`), ChatView: `chat:*`.
+ *
+ * Enable with:
+ * - **Node / API:** `ELIZA_TTS_DEBUG=1` (or `true`, `yes`, `on`) — logs appear in the API
+ *   terminal / `[api]` aggregator only for **server** routes (e.g. `server:cloud-tts:*`).
+ * - **Renderer (WebView / browser):** same env is mirrored via Vite `define` in
+ *   `apps/app/vite.config.ts` when you start dev with `ELIZA_TTS_DEBUG=1`. Those lines
+ *   go to the **renderer** JavaScript console (Electrobun: Web Inspector on the window),
+ *   not `LOG_LEVEL` on the API process alone.
+ */
+function ttsDebugEnabled() {
+    const truthy = (raw) => {
+        if (raw == null)
+            return false;
+        const v = String(raw).trim().toLowerCase();
+        return v === "1" || v === "true" || v === "yes" || v === "on";
+    };
+    if (typeof process !== "undefined" && process.env) {
+        if (truthy(process.env.ELIZA_TTS_DEBUG))
+            return true;
+    }
+    try {
+        // Use static `import.meta.env.*` so Vite `define` can replace ELIZA_TTS_DEBUG at build time.
+        if (truthy(String(import.meta.env.ELIZA_TTS_DEBUG ?? "")))
+            return true;
+        if (truthy(String(import.meta.env.VITE_ELIZA_TTS_DEBUG ?? "")))
+            return true;
+    }
+    catch {
+        /* no import.meta */
+    }
+    return false;
+}
+/** Same predicate as `ttsDebug` — use to attach optional debug headers / task metadata. */
+export function isTtsDebugEnabled() {
+    return ttsDebugEnabled();
+}
+const DEFAULT_PREVIEW_MAX = 160;
+/**
+ * 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 function ttsDebugTextPreview(text, maxChars = DEFAULT_PREVIEW_MAX) {
+    const singleLine = text.replace(/\r?\n/g, "↵ ").replace(/\s+/g, " ").trim();
+    if (singleLine.length <= maxChars)
+        return singleLine;
+    return `${singleLine.slice(0, maxChars)}…`;
+}
+/**
+ * Sink for TTS debug output. Set by the host app (e.g. pino on the server,
+ * Web Inspector in the renderer). Null disables debug output.
+ */
+let _ttsSink = null;
+export function setTtsDebugSink(sink) {
+    _ttsSink = sink;
+}
+export function ttsDebug(phase, detail) {
+    if (!ttsDebugEnabled() || !_ttsSink)
+        return;
+    _ttsSink(phase, detail);
+}
+//# sourceMappingURL=tts-debug.js.map

package/utils/tts-debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tts-debug.js","sourceRoot":"","sources":["../../src/utils/tts-debug.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAErC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAS,eAAe;IACtB,MAAM,MAAM,GAAG,CAAC,GAA8B,EAAW,EAAE;QACzD,IAAI,GAAG,IAAI,IAAI;YAAE,OAAO,KAAK,CAAC;QAC9B,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,IAAI,CAAC;IAChE,CAAC,CAAC;IAEF,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAClD,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;YAAE,OAAO,IAAI,CAAC;IACvD,CAAC;IAED,IAAI,CAAC;QACH,6FAA6F;QAC7F,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACvE,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;IAC9E,CAAC;IAAC,MAAM,CAAC;QACP,oBAAoB;IACtB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,iBAAiB;IAC/B,OAAO,eAAe,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,WAAmB,mBAAmB;IAEtC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5E,IAAI,UAAU,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,UAAU,CAAC;IACrD,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,IAAI,QAAQ,GAED,IAAI,CAAC;AAEhB,MAAM,UAAU,eAAe,CAC7B,IAAwE;IAExE,QAAQ,GAAG,IAAI,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,KAAa,EACb,MAAgC;IAEhC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,QAAQ;QAAE,OAAO;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAC1B,CAAC"}

package/view-hero-art.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Branded hero-image generator for plugin **views**.
+ *
+ * A view is a mini-app contributed by a plugin (`Plugin.views`). Each one is
+ * served a square hero image at `/api/views/<id>/hero`. Real heroes live in the
+ * plugin at `assets/hero.<ext>`; when a plugin ships none, the agent serves a
+ * generated SVG produced here so the catalog never shows a broken or ugly tile.
+ *
+ * The composition is intentionally **no-blue-dominant** (the app surface forbids
+ * blue accents — orange/jewel tones only) and **deterministic**: the same input
+ * always yields byte-identical output, so `scripts/generate-view-heroes.mjs`
+ * (which commits real heroes into plugins) and the runtime fallback render the
+ * exact same art. This is the single source of truth for that art — the script
+ * and the agent both import `renderViewHeroSvg` from here.
+ *
+ * Pure string generation only: no Node APIs, so this module stays importable
+ * from the runtime-agnostic `@elizaos/shared` barrel (browser + server).
+ */
+export interface ViewHeroFrameInput {
+    /** Stable slug used to namespace SVG gradient/filter ids. */
+    id: string;
+    /** Accent hue (0–359). Keep out of the pure-blue band for the app surface. */
+    hue: number;
+    /** Inline SVG markup for the centered line-icon glyph. */
+    iconSvg: string;
+    /** Display label rendered along the bottom. */
+    label: string;
+}
+/**
+ * Render the full branded hero SVG. Shared chrome (defs, background, depth
+ * blobs, faint grid, accent arc, bottom label + vignette) with the icon glyph
+ * slotted in. Output is deterministic and byte-identical for identical input.
+ */
+export declare function renderViewHeroSvg({ id, hue, iconSvg, label, }: ViewHeroFrameInput): string;
+/**
+ * Hand-drawn vector line-icons, centered at (0,0) spanning roughly -150..150.
+ * Each inherits stroke styling from the parent <g>; fills are set explicitly
+ * where a filled glyph reads better. Keyed names map to the catalog below.
+ */
+export declare const VIEW_HERO_ICONS: {
+    readonly modelTester: "    <rect x=\"-110\" y=\"-110\" width=\"220\" height=\"220\" rx=\"28\"/>\n    <rect x=\"-58\" y=\"-58\" width=\"116\" height=\"116\" rx=\"14\"/>\n    <line x1=\"-110\" y1=\"-66\" x2=\"-150\" y2=\"-66\"/>\n    <line x1=\"-110\" y1=\"0\" x2=\"-150\" y2=\"0\"/>\n    <line x1=\"-110\" y1=\"66\" x2=\"-150\" y2=\"66\"/>\n    <line x1=\"110\" y1=\"-66\" x2=\"150\" y2=\"-66\"/>\n    <line x1=\"110\" y1=\"0\" x2=\"150\" y2=\"0\"/>\n    <line x1=\"110\" y1=\"66\" x2=\"150\" y2=\"66\"/>\n    <line x1=\"-66\" y1=\"-110\" x2=\"-66\" y2=\"-150\"/>\n    <line x1=\"0\" y1=\"-110\" x2=\"0\" y2=\"-150\"/>\n    <line x1=\"66\" y1=\"-110\" x2=\"66\" y2=\"-150\"/>\n    <line x1=\"-66\" y1=\"110\" x2=\"-66\" y2=\"150\"/>\n    <line x1=\"0\" y1=\"110\" x2=\"0\" y2=\"150\"/>\n    <line x1=\"66\" y1=\"110\" x2=\"66\" y2=\"150\"/>\n    <circle cx=\"0\" cy=\"0\" r=\"14\" stroke-width=\"0\" fill=\"currentColor\"/>";
+    readonly views: "    <rect x=\"-150\" y=\"-150\" width=\"130\" height=\"130\" rx=\"18\"/>\n    <rect x=\"20\" y=\"-150\" width=\"130\" height=\"130\" rx=\"18\"/>\n    <rect x=\"-150\" y=\"20\" width=\"130\" height=\"130\" rx=\"18\"/>\n    <rect x=\"20\" y=\"20\" width=\"130\" height=\"130\" rx=\"18\"/>";
+    readonly focus: "    <path d=\"M0 -150 L130 -100 L130 24 C130 110 70 152 0 175 C-70 152 -130 110 -130 24 L-130 -100 Z\"/>\n    <circle cx=\"0\" cy=\"-2\" r=\"34\"/>\n    <line x1=\"-92\" y1=\"-96\" x2=\"96\" y2=\"120\"/>";
+    readonly calendar: "    <rect x=\"-140\" y=\"-118\" width=\"280\" height=\"248\" rx=\"24\"/>\n    <line x1=\"-140\" y1=\"-52\" x2=\"140\" y2=\"-52\"/>\n    <line x1=\"-78\" y1=\"-150\" x2=\"-78\" y2=\"-92\"/>\n    <line x1=\"78\" y1=\"-150\" x2=\"78\" y2=\"-92\"/>\n    <circle cx=\"-66\" cy=\"6\" r=\"11\" stroke-width=\"0\" fill=\"currentColor\"/>\n    <circle cx=\"0\" cy=\"6\" r=\"11\" stroke-width=\"0\" fill=\"currentColor\"/>\n    <circle cx=\"66\" cy=\"6\" r=\"11\" stroke-width=\"0\" fill=\"currentColor\"/>\n    <circle cx=\"-66\" cy=\"72\" r=\"11\" stroke-width=\"0\" fill=\"currentColor\"/>\n    <circle cx=\"0\" cy=\"72\" r=\"11\" stroke-width=\"0\" fill=\"currentColor\"/>";
+    readonly headphones: "    <path d=\"M-140 30 V-10 A140 140 0 0 1 140 -10 V30\"/>\n    <rect x=\"-160\" y=\"26\" width=\"58\" height=\"110\" rx=\"26\" fill=\"currentColor\" stroke-width=\"0\"/>\n    <rect x=\"102\" y=\"26\" width=\"58\" height=\"110\" rx=\"26\" fill=\"currentColor\" stroke-width=\"0\"/>\n    <rect x=\"-160\" y=\"26\" width=\"58\" height=\"110\" rx=\"26\"/>\n    <rect x=\"102\" y=\"26\" width=\"58\" height=\"110\" rx=\"26\"/>";
+    readonly glasses: "    <circle cx=\"-86\" cy=\"20\" r=\"68\"/>\n    <circle cx=\"86\" cy=\"20\" r=\"68\"/>\n    <path d=\"M-18 20 Q0 -2 18 20\"/>\n    <line x1=\"-154\" y1=\"-12\" x2=\"-180\" y2=\"-44\"/>\n    <line x1=\"154\" y1=\"-12\" x2=\"180\" y2=\"-44\"/>";
+    readonly finances: "    <polyline points=\"-150,-150 -150,150 150,150\"/>\n    <polyline points=\"-118,86 -50,-2 6,52 76,-62 132,-104\" fill=\"none\"/>\n    <circle cx=\"-50\" cy=\"-2\" r=\"13\" stroke-width=\"0\" fill=\"currentColor\"/>\n    <circle cx=\"76\" cy=\"-62\" r=\"13\" stroke-width=\"0\" fill=\"currentColor\"/>\n    <circle cx=\"132\" cy=\"-104\" r=\"13\" stroke-width=\"0\" fill=\"currentColor\"/>";
+    readonly goals: "    <circle cx=\"0\" cy=\"0\" r=\"150\"/>\n    <circle cx=\"0\" cy=\"0\" r=\"92\"/>\n    <circle cx=\"0\" cy=\"0\" r=\"34\"/>\n    <circle cx=\"0\" cy=\"0\" r=\"9\" stroke-width=\"0\" fill=\"currentColor\"/>";
+    readonly health: "    <path d=\"M0 150 C-180 18 -120 -120 0 -52 C120 -120 180 18 0 150 Z\"/>\n    <polyline points=\"-150,-10 -64,-10 -28,-58 14,52 48,-10 150,-10\" fill=\"none\"/>";
+    readonly inbox: "    <path d=\"M-150 -40 L-110 -130 H110 L150 -40 V120 A20 20 0 0 1 130 140 H-130 A20 20 0 0 1 -150 120 Z\"/>\n    <path d=\"M-150 -40 H-44 L-10 24 H10 L44 -40 H150\"/>";
+    readonly messages: "    <path d=\"M-150 -120 H150 A24 24 0 0 1 174 -96 V60 A24 24 0 0 1 150 84 H-30 L-100 150 V84 H-150 A24 24 0 0 1 -174 60 V-96 A24 24 0 0 1 -150 -120 Z\"/>\n    <line x1=\"-100\" y1=\"-44\" x2=\"100\" y2=\"-44\"/>\n    <line x1=\"-100\" y1=\"16\" x2=\"40\" y2=\"16\"/>";
+    readonly socialAlpha: "    <polyline points=\"-150,80 -54,-22 6,38 150,-110\" fill=\"none\"/>\n    <polyline points=\"92,-110 150,-110 150,-52\" fill=\"none\"/>\n    <circle cx=\"-110\" cy=\"128\" r=\"26\"/>\n    <circle cx=\"0\" cy=\"128\" r=\"26\"/>\n    <circle cx=\"110\" cy=\"128\" r=\"26\"/>";
+    readonly todos: "    <rect x=\"-150\" y=\"-150\" width=\"300\" height=\"300\" rx=\"36\"/>\n    <polyline points=\"-92,-6 -36,52 92,-78\" fill=\"none\"/>";
+    readonly vectorBrowser: "    <line x1=\"-110\" y1=\"-96\" x2=\"0\" y2=\"0\"/>\n    <line x1=\"120\" y1=\"-110\" x2=\"0\" y2=\"0\"/>\n    <line x1=\"-130\" y1=\"86\" x2=\"0\" y2=\"0\"/>\n    <line x1=\"110\" y1=\"104\" x2=\"0\" y2=\"0\"/>\n    <circle cx=\"0\" cy=\"0\" r=\"30\" fill=\"currentColor\" stroke-width=\"0\"/>\n    <circle cx=\"0\" cy=\"0\" r=\"30\"/>\n    <circle cx=\"-110\" cy=\"-96\" r=\"22\"/>\n    <circle cx=\"120\" cy=\"-110\" r=\"22\"/>\n    <circle cx=\"-130\" cy=\"86\" r=\"22\"/>\n    <circle cx=\"110\" cy=\"104\" r=\"22\"/>";
+};
+export type ViewHeroIconKind = keyof typeof VIEW_HERO_ICONS;
+/** Deterministically pick a non-blue accent hue for an arbitrary view key. */
+export declare function hueForViewKey(key: string): number;
+export interface ViewHeroSource {
+    id?: string;
+    label: string;
+    /** Lucide icon name declared by the view, used as a keyword hint. */
+    icon?: string;
+    tags?: readonly string[];
+}
+/** Pick the best-matching icon glyph for a view, defaulting to the grid. */
+export declare function pickViewHeroIcon(source: ViewHeroSource): ViewHeroIconKind;
+/**
+ * High-level entry point: render a branded hero SVG for a view, choosing the
+ * accent hue and icon glyph automatically from the view's metadata. Used by the
+ * agent's hero fallback and by view scaffolding/icon-regeneration so a generated
+ * hero looks the same everywhere.
+ */
+export declare function generateViewHeroSvgFor(source: ViewHeroSource): string;
+//# sourceMappingURL=view-hero-art.d.ts.map

package/view-hero-art.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-hero-art.d.ts","sourceRoot":"","sources":["../src/view-hero-art.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA4DH,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,EAAE,EACF,GAAG,EACH,OAAO,EACP,KAAK,GACN,EAAE,kBAAkB,GAAG,MAAM,CAuE7B;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;CAsGlB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,eAAe,CAAC;AAW5D,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGjD;AAyDD,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,CAazE;AAWD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAQrE"}