@absolutejs/voice 0.0.22-beta.575 → 0.0.22-beta.576

package/dist/core/cachedTTS.d.ts

@@ -1,4 +1,21 @@
-import type { TTSAdapter, TTSAdapterOpenOptions } from "./types";
+import type { TTSAdapter, TTSAdapterOpenOptions, TTSAudioEvent } from "./types";
+/**
+ * Optional persistent backing store for the cache — an L2 behind the in-memory
+ * LRU. Lets rendered audio survive process restarts/deploys so a fixed prompt
+ * (e.g. a greeting) is synthesized once *ever* per content key, not once per
+ * process. The store is content-addressed by the same `keyFor` key, so a
+ * changed prompt/voice/model naturally lands on a new key and re-renders.
+ *
+ * The store is told `TTSAudioEvent[]` and must return the same on read; how it
+ * serializes the binary `chunk`s (base64 in JSON, bytea, a file, etc.) is up to
+ * the implementation. `get` returns `null`/`undefined` on a miss. Both may be
+ * sync or async; errors should be swallowed by the implementation (a store
+ * failure must never break playback — the wrapper falls back to live render).
+ */
+export type CachedTTSStore = {
+    get: (key: string) => Promise<TTSAudioEvent[] | null | undefined> | TTSAudioEvent[] | null | undefined;
+    set: (key: string, events: TTSAudioEvent[]) => Promise<void> | void;
+};
 export type CachedTTSOptions = {
     /**
      * Return a stable cache key for an utterance whose synthesized audio should
@@ -13,8 +30,15 @@ export type CachedTTSOptions = {
      * (and re-caches) while the old entry is simply orphaned.
      */
     keyFor: (text: string, openOptions: TTSAdapterOpenOptions) => string | null | undefined;
-    /** Max distinct utterances to retain (LRU by insertion). Default 32. */
+    /** Max distinct utterances to retain in memory (LRU by insertion). Default 32. */
     maxEntries?: number;
+    /**
+     * Optional persistent L2 store (see {@link CachedTTSStore}). When set, an
+     * in-memory miss consults the store before rendering; a store hit is replayed
+     * and promoted into memory, and a fresh render is written through to it. Omit
+     * for memory-only behaviour (unchanged).
+     */
+    store?: CachedTTSStore;
 };
 /**
  * Wrap a TTS adapter so selected utterances are synthesized once and replayed

package/dist/index.d.ts

@@ -223,7 +223,7 @@ export type { VoiceSimulationSuiteAssertionInput, VoiceSimulationSuiteAssertionR
 export type { VoiceWorkflowContract, VoiceWorkflowContractDefinition, VoiceWorkflowContractField, VoiceWorkflowContractFieldMatch, VoiceWorkflowContractPresetName, VoiceWorkflowContractPresetOptions, VoiceWorkflowContractTracePayload, VoiceWorkflowContractValidation, VoiceWorkflowContractValidationIssue, VoiceWorkflowOutcome, } from "./core/workflowContract";
 export type { VoiceSessionListHTMLHandlerOptions, VoiceSessionListItem, VoiceSessionListOptions, VoiceSessionListRoutesOptions, VoiceSessionListStatus, VoiceProviderFallbackRecoverySummary, VoiceSessionReplay, VoiceSessionReplayHTMLHandlerOptions, VoiceSessionReplayOptions, VoiceSessionReplayRoutesOptions, VoiceSessionReplayTurn, } from "./core/sessionReplay";
 export type { AnthropicVoiceAssistantModelOptions, GeminiVoiceAssistantModelOptions, OpenAIVoiceAssistantModelOptions, VoiceProviderRouterEvent, VoiceProviderRouterFallbackMode, VoiceProviderRouterHealthOptions, VoiceProviderRouterOptions, VoiceProviderOrchestrationProfile, VoiceProviderOrchestrationProfileOptions, VoiceProviderOrchestrationResolvedSurface, VoiceProviderOrchestrationSurface, VoiceProviderRouterPolicy, VoiceProviderRouterPolicyPreset, VoiceProviderRouterPolicyWeights, VoiceProviderRouterProviderHealth, VoiceProviderRouterProviderProfile, VoiceProviderRouterStrategy, VoiceJSONAssistantModelHandler, VoiceJSONAssistantModelOptions, } from "./core/modelAdapters";
-export type { CachedTTSOptions } from "./core/cachedTTS";
+export type { CachedTTSOptions, CachedTTSStore } from "./core/cachedTTS";
 export type { OpenAIVoiceTTSOptions, OpenAIVoiceTTSVoice, } from "./core/openaiTTS";
 export type { VoiceProviderHealthStatus, VoiceProviderHealthSummary, VoiceProviderHealthSummaryOptions, } from "./core/providerHealth";
 export type { VoiceProviderCapabilityDefinition, VoiceProviderCapabilityHandlerOptions, VoiceProviderCapabilityHTMLHandlerOptions, VoiceProviderCapabilityKind, VoiceProviderCapabilityOptions, VoiceProviderCapabilityReport, VoiceProviderCapabilityRoutesOptions, VoiceProviderCapabilitySummary, } from "./core/providerCapabilities";

package/dist/index.js

@@ -45566,6 +45566,7 @@ var createGeminiVoiceAssistantModel = (options) => {
 var DEFAULT_MAX_ENTRIES = 32;
 var createCachedTTS = (inner, options) => {
   const maxEntries = options.maxEntries ?? DEFAULT_MAX_ENTRIES;
+  const { store } = options;
   const cache = new Map;
   const remember = (key, events) => {
     cache.delete(key);
@@ -45578,6 +45579,18 @@ var createCachedTTS = (inner, options) => {
       cache.delete(oldest);
     }
   };
+  const loadFromStore = async (key) => {
+    if (!store)
+      return null;
+    try {
+      const events = await store.get(key);
+      if (events && events.length > 0) {
+        remember(key, events);
+        return events;
+      }
+    } catch {}
+    return null;
+  };
   return {
     kind: "tts",
     open: async (openOptions) => {
@@ -45608,9 +45621,8 @@ var createCachedTTS = (inner, options) => {
             await session.send(text);
             return;
           }
-          const cached = cache.get(key);
-          if (cached) {
-            for (const event of cached) {
+          const replayEvents = async (events) => {
+            for (const event of events) {
               const replay = {
                 ...event,
                 receivedAt: Date.now()
@@ -45619,12 +45631,22 @@ var createCachedTTS = (inner, options) => {
                 await Promise.resolve(handler(replay));
               }
             }
+          };
+          const cached = cache.get(key) ?? await loadFromStore(key);
+          if (cached) {
+            await replayEvents(cached);
             return;
           }
           capture = [];
           await session.send(text);
-          remember(key, capture);
+          const rendered = capture;
+          remember(key, rendered);
           capture = null;
+          if (store) {
+            try {
+              await store.set(key, rendered);
+            } catch {}
+          }
         }
       };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@absolutejs/voice",
-	"version": "0.0.22-beta.575",
+	"version": "0.0.22-beta.576",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",