@glassly/engine 0.1.0-dev.0

package/build/services/MapboxTokenService.js

@@ -0,0 +1,115 @@
+/**
+ * MapboxTokenService
+ *
+ * Single source of truth for which Mapbox access token the app uses. The app
+ * binary deliberately ships NO baked Mapbox key: either the user supplies
+ * their own key (Settings > Keys, `mapbox_api_key`, "use my account"), or the
+ * token comes from Glassly Cloud at runtime.
+ *
+ * Two resolution levels:
+ *
+ * - `resolveMapboxAccessToken()` (sync): the USER key only. Gates phone-side
+ *   direct REST calls (Directions/Geocoding/Search) — without a user key those
+ *   operations go through the cloud maps proxy instead, so the org token is
+ *   only ever billed via the cloud's own auth/cache/rate-limit point.
+ *
+ * - `resolveMapboxRenderToken()` (async): the token for consumers that CANNOT
+ *   be proxied — map tile rendering (miniapp WebView via session.keys.get)
+ *   and the native Mapbox Navigation SDK. User key first; else the public
+ *   render token fetched once from the cloud runtime (/api/maps/render-token)
+ *   and cached. Empty when neither exists (e.g. Glassly Cloud disabled and no
+ *   user key) — callers must fail with a clear error, never fall back to a
+ *   baked credential.
+ */
+import { SETTINGS, useSettingsStore } from "../stores/settings";
+import { cloudClientService } from "./CloudClientService";
+const MAPBOX_TOKENS_URL = "https://api.mapbox.com/tokens/v2";
+/** How long a cloud-fetched render token is trusted before re-fetching. */
+const CLOUD_TOKEN_TTL_MS = 60 * 60 * 1000;
+let cloudRenderToken = null;
+let cloudRenderTokenInflight = null;
+/** The user-supplied Mapbox key from Settings > Keys ("" = not set). */
+export function userMapboxApiKey() {
+    const raw = useSettingsStore.getState().getSetting(SETTINGS.mapbox_api_key.key);
+    return typeof raw === "string" ? raw.trim() : "";
+}
+/**
+ * The token for phone-side DIRECT Mapbox REST calls: the user's key or
+ * nothing. Empty means "route the operation through the cloud maps proxy
+ * instead" (see NavigationHandlers) — the cloud-served org token is
+ * deliberately not used for direct REST from the phone.
+ */
+export function resolveMapboxAccessToken() {
+    return userMapboxApiKey();
+}
+/**
+ * The token for the consumers that cannot be proxied (map tiles, native nav
+ * SDK): user key first, else the cloud-served public render token (cached
+ * with a TTL, in-flight-deduped). "" when neither source yields one — the
+ * caller must surface that as a failure. Never fetches while Glassly Cloud is
+ * disabled: cloud-off + no user key is a deliberate hard stop.
+ */
+export async function resolveMapboxRenderToken() {
+    const userKey = userMapboxApiKey();
+    if (userKey)
+        return userKey;
+    if (cloudClientService.isCloudDisabled())
+        return "";
+    const now = Date.now();
+    if (cloudRenderToken && now - cloudRenderToken.fetchedAt < CLOUD_TOKEN_TTL_MS) {
+        return cloudRenderToken.token;
+    }
+    if (cloudRenderTokenInflight)
+        return cloudRenderTokenInflight;
+    cloudRenderTokenInflight = (async () => {
+        try {
+            const { token } = await cloudClientService.maps.renderToken();
+            const trimmed = typeof token === "string" ? token.trim() : "";
+            if (trimmed) {
+                cloudRenderToken = { token: trimmed, fetchedAt: Date.now() };
+                return trimmed;
+            }
+            // A definite "this deployment serves none" — remember briefly via the
+            // same TTL slot so we don't hammer the endpoint, but as an empty token.
+            cloudRenderToken = { token: "", fetchedAt: Date.now() };
+            return "";
+        }
+        catch (err) {
+            // Transient failure (offline, not connected yet): keep any stale cached
+            // token rather than going dark, and retry on the next call.
+            console.warn("[MapboxTokenService] cloud render-token fetch failed:", err);
+            return cloudRenderToken?.token ?? "";
+        }
+        finally {
+            cloudRenderTokenInflight = null;
+        }
+    })();
+    return cloudRenderTokenInflight;
+}
+/** Test hook: drop the cached cloud render token. */
+export function resetCloudRenderTokenCache() {
+    cloudRenderToken = null;
+    cloudRenderTokenInflight = null;
+}
+/**
+ * Cheap key validation for the Keys screen: GET /tokens/v2 with the candidate
+ * token. Mapbox answers 200 `{code: "TokenValid"}` for a live token and
+ * 401 with TokenMalformed/TokenInvalid/TokenExpired otherwise — no metered
+ * API usage. Network failure → indeterminate (the caller may offer
+ * "save anyway").
+ */
+export async function validateMapboxApiKey(apiKey) {
+    try {
+        const res = await fetch(`${MAPBOX_TOKENS_URL}?access_token=${encodeURIComponent(apiKey.trim())}`, { method: "GET" });
+        if (res.status === 401 || res.status === 403)
+            return { ok: false, reason: "invalid_key" };
+        if (!res.ok)
+            return { ok: false, reason: "network" };
+        const json = (await res.json());
+        return json.code === "TokenValid" ? { ok: true } : { ok: false, reason: "invalid_key" };
+    }
+    catch {
+        return { ok: false, reason: "network" };
+    }
+}
+//# sourceMappingURL=MapboxTokenService.js.map

package/build/services/MapboxTokenService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapboxTokenService.js","sourceRoot":"","sources":["../../src/services/MapboxTokenService.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * MapboxTokenService\n *\n * Single source of truth for which Mapbox access token the app uses. The app\n * binary deliberately ships NO baked Mapbox key: either the user supplies\n * their own key (Settings > Keys, `mapbox_api_key`, \"use my account\"), or the\n * token comes from Glassly Cloud at runtime.\n *\n * Two resolution levels:\n *\n * - `resolveMapboxAccessToken()` (sync): the USER key only. Gates phone-side\n *   direct REST calls (Directions/Geocoding/Search) — without a user key those\n *   operations go through the cloud maps proxy instead, so the org token is\n *   only ever billed via the cloud's own auth/cache/rate-limit point.\n *\n * - `resolveMapboxRenderToken()` (async): the token for consumers that CANNOT\n *   be proxied — map tile rendering (miniapp WebView via session.keys.get)\n *   and the native Mapbox Navigation SDK. User key first; else the public\n *   render token fetched once from the cloud runtime (/api/maps/render-token)\n *   and cached. Empty when neither exists (e.g. Glassly Cloud disabled and no\n *   user key) — callers must fail with a clear error, never fall back to a\n *   baked credential.\n */\nimport {SETTINGS, useSettingsStore} from \"../stores/settings\"\nimport {cloudClientService} from \"./CloudClientService\"\n\nconst MAPBOX_TOKENS_URL = \"https://api.mapbox.com/tokens/v2\"\n\n/** How long a cloud-fetched render token is trusted before re-fetching. */\nconst CLOUD_TOKEN_TTL_MS = 60 * 60 * 1000\n\nlet cloudRenderToken: {token: string; fetchedAt: number} | null = null\nlet cloudRenderTokenInflight: Promise<string> | null = null\n\n/** The user-supplied Mapbox key from Settings > Keys (\"\" = not set). */\nexport function userMapboxApiKey(): string {\n  const raw = useSettingsStore.getState().getSetting(SETTINGS.mapbox_api_key.key)\n  return typeof raw === \"string\" ? raw.trim() : \"\"\n}\n\n/**\n * The token for phone-side DIRECT Mapbox REST calls: the user's key or\n * nothing. Empty means \"route the operation through the cloud maps proxy\n * instead\" (see NavigationHandlers) — the cloud-served org token is\n * deliberately not used for direct REST from the phone.\n */\nexport function resolveMapboxAccessToken(): string {\n  return userMapboxApiKey()\n}\n\n/**\n * The token for the consumers that cannot be proxied (map tiles, native nav\n * SDK): user key first, else the cloud-served public render token (cached\n * with a TTL, in-flight-deduped). \"\" when neither source yields one — the\n * caller must surface that as a failure. Never fetches while Glassly Cloud is\n * disabled: cloud-off + no user key is a deliberate hard stop.\n */\nexport async function resolveMapboxRenderToken(): Promise<string> {\n  const userKey = userMapboxApiKey()\n  if (userKey) return userKey\n  if (cloudClientService.isCloudDisabled()) return \"\"\n\n  const now = Date.now()\n  if (cloudRenderToken && now - cloudRenderToken.fetchedAt < CLOUD_TOKEN_TTL_MS) {\n    return cloudRenderToken.token\n  }\n  if (cloudRenderTokenInflight) return cloudRenderTokenInflight\n\n  cloudRenderTokenInflight = (async () => {\n    try {\n      const {token} = await cloudClientService.maps.renderToken()\n      const trimmed = typeof token === \"string\" ? token.trim() : \"\"\n      if (trimmed) {\n        cloudRenderToken = {token: trimmed, fetchedAt: Date.now()}\n        return trimmed\n      }\n      // A definite \"this deployment serves none\" — remember briefly via the\n      // same TTL slot so we don't hammer the endpoint, but as an empty token.\n      cloudRenderToken = {token: \"\", fetchedAt: Date.now()}\n      return \"\"\n    } catch (err) {\n      // Transient failure (offline, not connected yet): keep any stale cached\n      // token rather than going dark, and retry on the next call.\n      console.warn(\"[MapboxTokenService] cloud render-token fetch failed:\", err)\n      return cloudRenderToken?.token ?? \"\"\n    } finally {\n      cloudRenderTokenInflight = null\n    }\n  })()\n  return cloudRenderTokenInflight\n}\n\n/** Test hook: drop the cached cloud render token. */\nexport function resetCloudRenderTokenCache(): void {\n  cloudRenderToken = null\n  cloudRenderTokenInflight = null\n}\n\n/**\n * Cheap key validation for the Keys screen: GET /tokens/v2 with the candidate\n * token. Mapbox answers 200 `{code: \"TokenValid\"}` for a live token and\n * 401 with TokenMalformed/TokenInvalid/TokenExpired otherwise — no metered\n * API usage. Network failure → indeterminate (the caller may offer\n * \"save anyway\").\n */\nexport async function validateMapboxApiKey(\n  apiKey: string,\n): Promise<{ok: true} | {ok: false; reason: \"invalid_key\" | \"network\"}> {\n  try {\n    const res = await fetch(`${MAPBOX_TOKENS_URL}?access_token=${encodeURIComponent(apiKey.trim())}`, {method: \"GET\"})\n    if (res.status === 401 || res.status === 403) return {ok: false, reason: \"invalid_key\"}\n    if (!res.ok) return {ok: false, reason: \"network\"}\n    const json = (await res.json()) as {code?: string}\n    return json.code === \"TokenValid\" ? {ok: true} : {ok: false, reason: \"invalid_key\"}\n  } catch {\n    return {ok: false, reason: \"network\"}\n  }\n}\n"]}

package/build/services/MemoryCapture.d.ts

@@ -0,0 +1,40 @@
+/**
+ * MemoryCapture — decide what the runtime writes into the shared memory
+ * timeline as speech flows past.
+ *
+ * Kept as pure logic (no store, no settings, no singletons) so the rules can be
+ * unit-tested directly; LocalMiniappRuntime owns the side effects. Mirrors the
+ * split already used for TranscriptionRouting.
+ */
+/** The subset of a forwarded transcription/translation event we care about. */
+export interface CaptureCandidate {
+    text?: string;
+    /** Translation events only: the words actually spoken, pre-translation. */
+    originalText?: string;
+    isFinal?: boolean;
+    speakerId?: string;
+    /** Resolved enrolled-speaker name (on-device speaker ID), when present. */
+    resolvedSpeakerName?: string;
+    transcribeLanguage?: string;
+}
+/** What to append, once a candidate is accepted. */
+export interface CaptureDecision {
+    text: string;
+    speakerId: string | null;
+    resolvedSpeakerName: string | null;
+    language: string | null;
+}
+/**
+ * Extract the line to store, or null when the event isn't capturable.
+ *
+ * For translation we take `originalText` — what was SPOKEN — not the
+ * translated `text`. A MemoryEntry holds a single text + language, so the
+ * translated variant has nowhere to live; recording the source keeps
+ * translation- and transcription-driven sessions consistent, and means a
+ * translation-only conversation still lands in the timeline.
+ *
+ * Only finals are capturable: interims are superseded within the same
+ * utterance and would bloat the timeline with partial text.
+ */
+export declare function captureDecisionFor(stream: string, event: CaptureCandidate | null): CaptureDecision | null;
+//# sourceMappingURL=MemoryCapture.d.ts.map

package/build/services/MemoryCapture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryCapture.d.ts","sourceRoot":"","sources":["../../src/services/MemoryCapture.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,+EAA+E;AAC/E,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2EAA2E;IAC3E,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,GAAG,eAAe,GAAG,IAAI,CAmBzG"}

package/build/services/MemoryCapture.js

@@ -0,0 +1,42 @@
+/**
+ * MemoryCapture — decide what the runtime writes into the shared memory
+ * timeline as speech flows past.
+ *
+ * Kept as pure logic (no store, no settings, no singletons) so the rules can be
+ * unit-tested directly; LocalMiniappRuntime owns the side effects. Mirrors the
+ * split already used for TranscriptionRouting.
+ */
+/**
+ * Extract the line to store, or null when the event isn't capturable.
+ *
+ * For translation we take `originalText` — what was SPOKEN — not the
+ * translated `text`. A MemoryEntry holds a single text + language, so the
+ * translated variant has nowhere to live; recording the source keeps
+ * translation- and transcription-driven sessions consistent, and means a
+ * translation-only conversation still lands in the timeline.
+ *
+ * Only finals are capturable: interims are superseded within the same
+ * utterance and would bloat the timeline with partial text.
+ */
+export function captureDecisionFor(stream, event) {
+    const isTranslation = stream.startsWith("translation:");
+    if (!isTranslation && !stream.startsWith("transcription:"))
+        return null;
+    if (!event?.isFinal)
+        return null;
+    // When a translation event omits originalText there is no source text to
+    // record — storing the translation under the source language would be wrong.
+    const spoken = isTranslation ? event.originalText : event.text;
+    if (typeof spoken !== "string" || !spoken.trim())
+        return null;
+    const language = event.transcribeLanguage;
+    return {
+        text: spoken.trim(),
+        speakerId: typeof event.speakerId === "string" ? event.speakerId : null,
+        resolvedSpeakerName: typeof event.resolvedSpeakerName === "string" ? event.resolvedSpeakerName : null,
+        // "auto" is a subscription mode, not a language — an undetected source
+        // language is genuinely unknown, so store null rather than the sentinel.
+        language: typeof language === "string" && language !== "auto" ? language : null,
+    };
+}
+//# sourceMappingURL=MemoryCapture.js.map

package/build/services/MemoryCapture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryCapture.js","sourceRoot":"","sources":["../../src/services/MemoryCapture.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsBH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,KAA8B;IAC/E,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,cAAc,CAAC,CAAA;IACvD,IAAI,CAAC,aAAa,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC;QAAE,OAAO,IAAI,CAAA;IACvE,IAAI,CAAC,KAAK,EAAE,OAAO;QAAE,OAAO,IAAI,CAAA;IAEhC,yEAAyE;IACzE,6EAA6E;IAC7E,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAA;IAC9D,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,IAAI,CAAA;IAE7D,MAAM,QAAQ,GAAG,KAAK,CAAC,kBAAkB,CAAA;IACzC,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;QACnB,SAAS,EAAE,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI;QACvE,mBAAmB,EAAE,OAAO,KAAK,CAAC,mBAAmB,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI;QACrG,uEAAuE;QACvE,yEAAyE;QACzE,QAAQ,EAAE,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;KAChF,CAAA;AACH,CAAC","sourcesContent":["/**\n * MemoryCapture — decide what the runtime writes into the shared memory\n * timeline as speech flows past.\n *\n * Kept as pure logic (no store, no settings, no singletons) so the rules can be\n * unit-tested directly; LocalMiniappRuntime owns the side effects. Mirrors the\n * split already used for TranscriptionRouting.\n */\n\n/** The subset of a forwarded transcription/translation event we care about. */\nexport interface CaptureCandidate {\n  text?: string\n  /** Translation events only: the words actually spoken, pre-translation. */\n  originalText?: string\n  isFinal?: boolean\n  speakerId?: string\n  /** Resolved enrolled-speaker name (on-device speaker ID), when present. */\n  resolvedSpeakerName?: string\n  transcribeLanguage?: string\n}\n\n/** What to append, once a candidate is accepted. */\nexport interface CaptureDecision {\n  text: string\n  speakerId: string | null\n  resolvedSpeakerName: string | null\n  language: string | null\n}\n\n/**\n * Extract the line to store, or null when the event isn't capturable.\n *\n * For translation we take `originalText` — what was SPOKEN — not the\n * translated `text`. A MemoryEntry holds a single text + language, so the\n * translated variant has nowhere to live; recording the source keeps\n * translation- and transcription-driven sessions consistent, and means a\n * translation-only conversation still lands in the timeline.\n *\n * Only finals are capturable: interims are superseded within the same\n * utterance and would bloat the timeline with partial text.\n */\nexport function captureDecisionFor(stream: string, event: CaptureCandidate | null): CaptureDecision | null {\n  const isTranslation = stream.startsWith(\"translation:\")\n  if (!isTranslation && !stream.startsWith(\"transcription:\")) return null\n  if (!event?.isFinal) return null\n\n  // When a translation event omits originalText there is no source text to\n  // record — storing the translation under the source language would be wrong.\n  const spoken = isTranslation ? event.originalText : event.text\n  if (typeof spoken !== \"string\" || !spoken.trim()) return null\n\n  const language = event.transcribeLanguage\n  return {\n    text: spoken.trim(),\n    speakerId: typeof event.speakerId === \"string\" ? event.speakerId : null,\n    resolvedSpeakerName: typeof event.resolvedSpeakerName === \"string\" ? event.resolvedSpeakerName : null,\n    // \"auto\" is a subscription mode, not a language — an undetected source\n    // language is genuinely unknown, so store null rather than the sentinel.\n    language: typeof language === \"string\" && language !== \"auto\" ? language : null,\n  }\n}\n"]}

package/build/services/MemoryStore.d.ts

@@ -0,0 +1,184 @@
+/**
+ * MemoryStore — the user's shared, phone-local memory timeline.
+ *
+ * One unified per-hour stream of what happened around the user — spoken
+ * transcript lines AND notes (manual, voice, auto) in one timeline — plus the
+ * hourly conversation summary that heads each session. Scoped to the Glassly
+ * USER (not to a miniapp): every miniapp that declares the MEMORY manifest
+ * permission reads and writes the same store through LocalMiniappRuntime's
+ * MEMORY_* handlers, and Settings > Memory manages it via engine.memory.
+ *
+ * A "session" is one clock hour that has entries, derived from entry
+ * timestamps at read time — nothing is stored per-session, so there is no
+ * session id to keep in sync.
+ *
+ * The store began life inside the Assist miniapp (its SessionStore); on first
+ * load it migrates Assist's per-app storage namespace into the shared
+ * user-scoped keys so existing history survives the move.
+ */
+import type { MemoryEntry, MemoryNoteSource, MemorySession, MemorySummary } from "@glassly/miniapp";
+/**
+ * How much timeline a tier can SEE. Retention gating is a read window, not a
+ * delete: pruning always keeps {@link EXTENDED_RETENTION}'s worth of data, and
+ * the active policy decides how far back reads reach. A lapsed subscriber's
+ * older timeline is frozen, not lost — upgrading again restores it instantly.
+ */
+export interface MemoryRetentionPolicy {
+    maxAgeMs: number;
+    maxEntries: number;
+    maxSummaries: number;
+}
+/** Free-tier visibility: a 14-day rolling window. */
+export declare const STANDARD_RETENTION: MemoryRetentionPolicy;
+/**
+ * Plus/Pro visibility — and the store's PHYSICAL bounds for every tier. The
+ * entry cap also bounds the write cost — every persist re-serializes the
+ * whole timeline, so this cap is a perf ceiling as much as a product number.
+ */
+export declare const EXTENDED_RETENTION: MemoryRetentionPolicy;
+export interface MemoryStoreBackend {
+    get(key: string): unknown | null;
+    set(key: string, value: unknown): void;
+    remove(key: string): void;
+}
+export interface MemoryStoreHooks {
+    getUserId: () => Promise<string>;
+    backend: MemoryStoreBackend;
+    /**
+     * Debounce window for transcript-line writes, in ms. Appends coalesce into
+     * one serialization instead of re-stringifying the whole timeline per
+     * utterance. Set to 0 to persist synchronously (tests).
+     */
+    writeDebounceMs?: number;
+    /**
+     * Visibility policy resolver, consulted at every read. A function (not a
+     * value) so the host can flip between STANDARD and EXTENDED as the user's
+     * subscription changes without rebuilding the store. Absent = standard.
+     * Never affects what is STORED — pruning is fixed at EXTENDED bounds.
+     */
+    getRetention?: () => MemoryRetentionPolicy;
+}
+export interface MemoryStats {
+    entryCount: number;
+    lineCount: number;
+    noteCount: number;
+    summaryCount: number;
+    /** Epoch ms of the oldest entry, or null when empty. */
+    oldestAt: number | null;
+}
+export declare function hourStartOf(ms: number): number;
+export declare function dayStartOf(ms: number): number;
+export declare class MemoryStore {
+    private readonly hooks;
+    private entries;
+    private summaries;
+    /** User the in-memory cache was loaded for; reload when identity changes. */
+    private loadedUserId;
+    private loadPromise;
+    private readonly changeListeners;
+    /** Pending debounced log write (transcript appends), if any. */
+    private logFlushTimer;
+    private logDirty;
+    constructor(hooks: MemoryStoreHooks);
+    /**
+     * Write any debounced changes out now. Call before the app backgrounds or
+     * terminates so a crash can't lose the coalesced tail of the timeline.
+     */
+    flush(): Promise<void>;
+    /** Subscribe to mutations (adds, edits, deletes, clears). */
+    onChanged(listener: () => void): () => void;
+    appendLine(input: {
+        text: string;
+        speakerId: string | null;
+        /** Resolved enrolled-speaker name (on-device speaker ID), when known. */
+        resolvedSpeakerName?: string | null;
+        language: string | null;
+        at: number;
+    }): Promise<void>;
+    /**
+     * Add a note. `at` targets the hour it belongs to — pass a timestamp inside
+     * a past hour to append to that session. Dedupes on normalized text within
+     * the same hour (auto-notes re-extract); resolves null on duplicate/empty.
+     */
+    addNote(text: string, source: MemoryNoteSource, at?: number): Promise<MemoryEntry | null>;
+    /** Rewrite a note's text in place (Settings > Memory edit). */
+    updateNote(id: string, text: string): Promise<boolean>;
+    removeEntry(id: string): Promise<boolean>;
+    /** Delete every entry (and summary) in an hour, or a whole day of hours. */
+    removeScope(scope: "session" | "day", at: number): Promise<void>;
+    /** Drop the entire timeline: every entry and every summary. */
+    clear(): Promise<void>;
+    addSummary(summary: MemorySummary): Promise<void>;
+    /** Entries in [sinceMs, untilMs), newest last. */
+    window(sinceMs: number, untilMs?: number): Promise<MemoryEntry[]>;
+    /** All note entries, newest first (Settings > Memory list). */
+    notes(): Promise<MemoryEntry[]>;
+    stats(): Promise<MemoryStats>;
+    /** All sessions (hours with entries), newest hour first. */
+    sessionList(): Promise<MemorySession[]>;
+    /**
+     * Query the FULL store by absolute-time window and keyword — the executor
+     * behind LLM history-search tools. Newest last, so the limit keeps the most
+     * recent matches. `contains` is an exact substring; `terms` is fuzzy any-of
+     * matching (mistranscribed-name tolerant) — see utils/memory/search.ts.
+     */
+    query(q: {
+        sinceMs?: number;
+        untilMs?: number;
+        contains?: string;
+        terms?: string[];
+        limit?: number;
+    }): Promise<MemoryEntry[]>;
+    /**
+     * query() plus `windowCount` — how many entries the TIME window held before
+     * keyword filtering, so an LLM caller can distinguish "keyword matched
+     * nothing" from "history doesn't reach that far back" without a retry.
+     */
+    search(q: {
+        sinceMs?: number;
+        untilMs?: number;
+        contains?: string;
+        terms?: string[];
+        limit?: number;
+    }): Promise<{
+        entries: MemoryEntry[];
+        windowCount: number;
+    }>;
+    summaryList(): Promise<MemorySummary[]>;
+    /** Most recent COMPLETED hour with lines but no summary, or null. */
+    pendingSummaryHour(nowMs?: number): Promise<number | null>;
+    /** Plain-text export of a scope, for the OS share sheet. */
+    exportText(scope: "session" | "day" | "all", at?: number): Promise<string>;
+    private ensureLoaded;
+    private loadFor;
+    /**
+     * One-time migration: fold the Assist miniapp's per-app store (the previous
+     * home of this timeline) into the shared user-scoped keys. Assist's old keys
+     * are left in place; its new build reads through the memory bridge instead.
+     */
+    private migrateFromAssist;
+    private retention;
+    /** Entries inside the active tier's visibility window, oldest first. */
+    private visibleEntries;
+    private visibleSummaries;
+    /**
+     * Physical bounds, ALWAYS the extended policy regardless of tier. A free or
+     * lapsed user's older timeline stays on disk (reads just can't see past
+     * their window) so upgrading — or re-upgrading — restores it rather than
+     * finding it deleted. Deleting remains the user's call: clear()/removeScope
+     * operate on the physical store.
+     */
+    private prune;
+    private key;
+    /**
+     * Mark the log dirty and arm the debounce timer. Repeated appends inside the
+     * window collapse into a single serialization; the first append after a
+     * flush starts a fresh window (trailing-edge, so a steady stream of speech
+     * still lands on disk every `writeDebounceMs`).
+     */
+    private schedulePersistLog;
+    private persistLog;
+    private persistSummaries;
+    private emitChanged;
+}
+//# sourceMappingURL=MemoryStore.d.ts.map

package/build/services/MemoryStore.d.ts.map

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