@metamask-previews/ai-controllers 0.8.0-preview-e3275932a → 0.8.0-preview-99421bfe4

package/CHANGELOG.md

@@ -9,15 +9,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
-- **BREAKING:** `AiDigestController` no longer caches `fetchMarketInsights` or `fetchMarketOverview` results (no TTL, eviction, or persisted `marketInsights` / `marketOverview` state). Each call is a passthrough to `AiDigestService`. Clients must own freshness.
-  - `AiDigestControllerState` is now an empty object (`Record<string, never>`).
-  - The constructor no longer accepts a `state` option.
 - Bump `@metamask/superstruct` from `^3.1.0` to `^3.4.1` ([#9754](https://github.com/MetaMask/core/pull/9754))
 
-### Removed
-
-- **BREAKING:** Remove `MarketInsightsEntry`, `MarketOverviewEntry`, `CACHE_DURATION_MS`, and `MAX_CACHE_ENTRIES`. Cache policy belongs to clients.
-
 ## [0.8.0]
 
 ### Added

package/dist/AiDigestController-method-action-types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"AiDigestController-method-action-types.cjs","sourceRoot":"","sources":["../src/AiDigestController-method-action-types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { AiDigestController } from './AiDigestController.js';\n\n/**\n * Fetches market insights for a given asset identifier.\n *\n * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps\n * market symbol (e.g. `ETH`). The service handles choosing the correct API\n * query parameter automatically. Clients own freshness/caching.\n *\n * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).\n * @returns The market insights report, or `null` if none exists.\n */\nexport type AiDigestControllerFetchMarketInsightsAction = {\n  type: `AiDigestController:fetchMarketInsights`;\n  handler: AiDigestController['fetchMarketInsights'];\n};\n\n/**\n * Fetches the market overview report.\n *\n * Clients own freshness/caching.\n *\n * @returns The market overview report, or `null` if none exists.\n */\nexport type AiDigestControllerFetchMarketOverviewAction = {\n  type: `AiDigestController:fetchMarketOverview`;\n  handler: AiDigestController['fetchMarketOverview'];\n};\n\n/**\n * Fetches a single market overview front page by id.\n *\n * Unlike the market overview report (which only returns the latest items),\n * this resolves an older item that has since dropped out of the report, so\n * clients can render it directly (e.g. from a deep link).\n *\n * @param id - The front-page identifier (UUID).\n * @returns The market overview front page, or `null` if none exists.\n */\nexport type AiDigestControllerFetchFrontPageItemAction = {\n  type: `AiDigestController:fetchFrontPageItem`;\n  handler: AiDigestController['fetchFrontPageItem'];\n};\n\n/**\n * Union of all AiDigestController action types.\n */\nexport type AiDigestControllerMethodActions =\n  | AiDigestControllerFetchMarketInsightsAction\n  | AiDigestControllerFetchMarketOverviewAction\n  | AiDigestControllerFetchFrontPageItemAction;\n"]}
+{"version":3,"file":"AiDigestController-method-action-types.cjs","sourceRoot":"","sources":["../src/AiDigestController-method-action-types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { AiDigestController } from './AiDigestController.js';\n\n/**\n * Fetches market insights for a given asset identifier.\n * Returns cached data if still fresh, otherwise calls the service.\n *\n * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps\n * market symbol (e.g. `ETH`). The service handles choosing the correct API\n * query parameter automatically.\n *\n * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).\n * @returns The market insights report, or `null` if none exists.\n */\nexport type AiDigestControllerFetchMarketInsightsAction = {\n  type: `AiDigestController:fetchMarketInsights`;\n  handler: AiDigestController['fetchMarketInsights'];\n};\n\n/**\n * Fetches the market overview report.\n * Returns cached data if still fresh, otherwise calls the service.\n *\n * @returns The market overview report, or `null` if none exists.\n */\nexport type AiDigestControllerFetchMarketOverviewAction = {\n  type: `AiDigestController:fetchMarketOverview`;\n  handler: AiDigestController['fetchMarketOverview'];\n};\n\n/**\n * Fetches a single market overview front page by id.\n *\n * Unlike the market overview report (which only returns the latest items),\n * this resolves an older item that has since dropped out of the report, so\n * clients can render it directly (e.g. from a deep link).\n *\n * @param id - The front-page identifier (UUID).\n * @returns The market overview front page, or `null` if none exists.\n */\nexport type AiDigestControllerFetchFrontPageItemAction = {\n  type: `AiDigestController:fetchFrontPageItem`;\n  handler: AiDigestController['fetchFrontPageItem'];\n};\n\n/**\n * Union of all AiDigestController action types.\n */\nexport type AiDigestControllerMethodActions =\n  | AiDigestControllerFetchMarketInsightsAction\n  | AiDigestControllerFetchMarketOverviewAction\n  | AiDigestControllerFetchFrontPageItemAction;\n"]}

package/dist/AiDigestController-method-action-types.d.cts

@@ -5,10 +5,11 @@
 import type { AiDigestController } from "./AiDigestController.cjs";
 /**
  * Fetches market insights for a given asset identifier.
+ * Returns cached data if still fresh, otherwise calls the service.
  *
  * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps
  * market symbol (e.g. `ETH`). The service handles choosing the correct API
- * query parameter automatically. Clients own freshness/caching.
+ * query parameter automatically.
  *
  * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).
  * @returns The market insights report, or `null` if none exists.
@@ -19,8 +20,7 @@ export type AiDigestControllerFetchMarketInsightsAction = {
 };
 /**
  * Fetches the market overview report.
- *
- * Clients own freshness/caching.
+ * Returns cached data if still fresh, otherwise calls the service.
  *
  * @returns The market overview report, or `null` if none exists.
  */

package/dist/AiDigestController-method-action-types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"AiDigestController-method-action-types.d.cts","sourceRoot":"","sources":["../src/AiDigestController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,iCAAgC;AAElE;;;;;;;;;GASG;AACH,MAAM,MAAM,2CAA2C,GAAG;IACxD,IAAI,EAAE,wCAAwC,CAAC;IAC/C,OAAO,EAAE,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;CACpD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,2CAA2C,GAAG;IACxD,IAAI,EAAE,wCAAwC,CAAC;IAC/C,OAAO,EAAE,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;CACpD,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,0CAA0C,GAAG;IACvD,IAAI,EAAE,uCAAuC,CAAC;IAC9C,OAAO,EAAE,kBAAkB,CAAC,oBAAoB,CAAC,CAAC;CACnD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,+BAA+B,GACvC,2CAA2C,GAC3C,2CAA2C,GAC3C,0CAA0C,CAAC"}
+{"version":3,"file":"AiDigestController-method-action-types.d.cts","sourceRoot":"","sources":["../src/AiDigestController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,iCAAgC;AAElE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,2CAA2C,GAAG;IACxD,IAAI,EAAE,wCAAwC,CAAC;IAC/C,OAAO,EAAE,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;CACpD,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,2CAA2C,GAAG;IACxD,IAAI,EAAE,wCAAwC,CAAC;IAC/C,OAAO,EAAE,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;CACpD,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,0CAA0C,GAAG;IACvD,IAAI,EAAE,uCAAuC,CAAC;IAC9C,OAAO,EAAE,kBAAkB,CAAC,oBAAoB,CAAC,CAAC;CACnD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,+BAA+B,GACvC,2CAA2C,GAC3C,2CAA2C,GAC3C,0CAA0C,CAAC"}

package/dist/AiDigestController-method-action-types.d.mts

@@ -5,10 +5,11 @@
 import type { AiDigestController } from "./AiDigestController.mjs";
 /**
  * Fetches market insights for a given asset identifier.
+ * Returns cached data if still fresh, otherwise calls the service.
  *
  * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps
  * market symbol (e.g. `ETH`). The service handles choosing the correct API
- * query parameter automatically. Clients own freshness/caching.
+ * query parameter automatically.
  *
  * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).
  * @returns The market insights report, or `null` if none exists.
@@ -19,8 +20,7 @@ export type AiDigestControllerFetchMarketInsightsAction = {
 };
 /**
  * Fetches the market overview report.
- *
- * Clients own freshness/caching.
+ * Returns cached data if still fresh, otherwise calls the service.
  *
  * @returns The market overview report, or `null` if none exists.
  */

package/dist/AiDigestController-method-action-types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"AiDigestController-method-action-types.d.mts","sourceRoot":"","sources":["../src/AiDigestController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,iCAAgC;AAElE;;;;;;;;;GASG;AACH,MAAM,MAAM,2CAA2C,GAAG;IACxD,IAAI,EAAE,wCAAwC,CAAC;IAC/C,OAAO,EAAE,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;CACpD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,2CAA2C,GAAG;IACxD,IAAI,EAAE,wCAAwC,CAAC;IAC/C,OAAO,EAAE,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;CACpD,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,0CAA0C,GAAG;IACvD,IAAI,EAAE,uCAAuC,CAAC;IAC9C,OAAO,EAAE,kBAAkB,CAAC,oBAAoB,CAAC,CAAC;CACnD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,+BAA+B,GACvC,2CAA2C,GAC3C,2CAA2C,GAC3C,0CAA0C,CAAC"}
+{"version":3,"file":"AiDigestController-method-action-types.d.mts","sourceRoot":"","sources":["../src/AiDigestController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,iCAAgC;AAElE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,2CAA2C,GAAG;IACxD,IAAI,EAAE,wCAAwC,CAAC;IAC/C,OAAO,EAAE,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;CACpD,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,2CAA2C,GAAG;IACxD,IAAI,EAAE,wCAAwC,CAAC;IAC/C,OAAO,EAAE,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;CACpD,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,0CAA0C,GAAG;IACvD,IAAI,EAAE,uCAAuC,CAAC;IAC9C,OAAO,EAAE,kBAAkB,CAAC,oBAAoB,CAAC,CAAC;CACnD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,+BAA+B,GACvC,2CAA2C,GAC3C,2CAA2C,GAC3C,0CAA0C,CAAC"}

package/dist/AiDigestController-method-action-types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"AiDigestController-method-action-types.mjs","sourceRoot":"","sources":["../src/AiDigestController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { AiDigestController } from './AiDigestController.js';\n\n/**\n * Fetches market insights for a given asset identifier.\n *\n * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps\n * market symbol (e.g. `ETH`). The service handles choosing the correct API\n * query parameter automatically. Clients own freshness/caching.\n *\n * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).\n * @returns The market insights report, or `null` if none exists.\n */\nexport type AiDigestControllerFetchMarketInsightsAction = {\n  type: `AiDigestController:fetchMarketInsights`;\n  handler: AiDigestController['fetchMarketInsights'];\n};\n\n/**\n * Fetches the market overview report.\n *\n * Clients own freshness/caching.\n *\n * @returns The market overview report, or `null` if none exists.\n */\nexport type AiDigestControllerFetchMarketOverviewAction = {\n  type: `AiDigestController:fetchMarketOverview`;\n  handler: AiDigestController['fetchMarketOverview'];\n};\n\n/**\n * Fetches a single market overview front page by id.\n *\n * Unlike the market overview report (which only returns the latest items),\n * this resolves an older item that has since dropped out of the report, so\n * clients can render it directly (e.g. from a deep link).\n *\n * @param id - The front-page identifier (UUID).\n * @returns The market overview front page, or `null` if none exists.\n */\nexport type AiDigestControllerFetchFrontPageItemAction = {\n  type: `AiDigestController:fetchFrontPageItem`;\n  handler: AiDigestController['fetchFrontPageItem'];\n};\n\n/**\n * Union of all AiDigestController action types.\n */\nexport type AiDigestControllerMethodActions =\n  | AiDigestControllerFetchMarketInsightsAction\n  | AiDigestControllerFetchMarketOverviewAction\n  | AiDigestControllerFetchFrontPageItemAction;\n"]}
+{"version":3,"file":"AiDigestController-method-action-types.mjs","sourceRoot":"","sources":["../src/AiDigestController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { AiDigestController } from './AiDigestController.js';\n\n/**\n * Fetches market insights for a given asset identifier.\n * Returns cached data if still fresh, otherwise calls the service.\n *\n * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps\n * market symbol (e.g. `ETH`). The service handles choosing the correct API\n * query parameter automatically.\n *\n * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).\n * @returns The market insights report, or `null` if none exists.\n */\nexport type AiDigestControllerFetchMarketInsightsAction = {\n  type: `AiDigestController:fetchMarketInsights`;\n  handler: AiDigestController['fetchMarketInsights'];\n};\n\n/**\n * Fetches the market overview report.\n * Returns cached data if still fresh, otherwise calls the service.\n *\n * @returns The market overview report, or `null` if none exists.\n */\nexport type AiDigestControllerFetchMarketOverviewAction = {\n  type: `AiDigestController:fetchMarketOverview`;\n  handler: AiDigestController['fetchMarketOverview'];\n};\n\n/**\n * Fetches a single market overview front page by id.\n *\n * Unlike the market overview report (which only returns the latest items),\n * this resolves an older item that has since dropped out of the report, so\n * clients can render it directly (e.g. from a deep link).\n *\n * @param id - The front-page identifier (UUID).\n * @returns The market overview front page, or `null` if none exists.\n */\nexport type AiDigestControllerFetchFrontPageItemAction = {\n  type: `AiDigestController:fetchFrontPageItem`;\n  handler: AiDigestController['fetchFrontPageItem'];\n};\n\n/**\n * Union of all AiDigestController action types.\n */\nexport type AiDigestControllerMethodActions =\n  | AiDigestControllerFetchMarketInsightsAction\n  | AiDigestControllerFetchMarketOverviewAction\n  | AiDigestControllerFetchFrontPageItemAction;\n"]}

package/dist/AiDigestController.cjs

@@ -10,39 +10,60 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _AiDigestController_digestService;
+var _AiDigestController_instances, _AiDigestController_digestService, _AiDigestController_evictStaleCachedEntries;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AiDigestController = exports.getDefaultAiDigestControllerState = void 0;
 const base_controller_1 = require("@metamask/base-controller");
 const ai_digest_constants_js_1 = require("./ai-digest-constants.cjs");
 function getDefaultAiDigestControllerState() {
-    return {};
+    return {
+        marketInsights: {},
+        marketOverview: null,
+    };
 }
 exports.getDefaultAiDigestControllerState = getDefaultAiDigestControllerState;
-const aiDigestControllerMetadata = {};
+const aiDigestControllerMetadata = {
+    marketInsights: {
+        persist: true,
+        includeInDebugSnapshot: true,
+        includeInStateLogs: true,
+        usedInUi: true,
+    },
+    marketOverview: {
+        persist: true,
+        includeInDebugSnapshot: true,
+        includeInStateLogs: true,
+        usedInUi: true,
+    },
+};
 const MESSENGER_EXPOSED_METHODS = [
     'fetchMarketInsights',
     'fetchMarketOverview',
     'fetchFrontPageItem',
 ];
 class AiDigestController extends base_controller_1.BaseController {
-    constructor({ messenger, digestService }) {
+    constructor({ messenger, state, digestService }) {
         super({
             name: ai_digest_constants_js_1.controllerName,
             metadata: aiDigestControllerMetadata,
-            state: getDefaultAiDigestControllerState(),
+            state: {
+                ...getDefaultAiDigestControllerState(),
+                ...state,
+            },
             messenger,
         });
+        _AiDigestController_instances.add(this);
         _AiDigestController_digestService.set(this, void 0);
         __classPrivateFieldSet(this, _AiDigestController_digestService, digestService, "f");
         this.messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
     }
     /**
      * Fetches market insights for a given asset identifier.
+     * Returns cached data if still fresh, otherwise calls the service.
      *
      * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps
      * market symbol (e.g. `ETH`). The service handles choosing the correct API
-     * query parameter automatically. Clients own freshness/caching.
+     * query parameter automatically.
      *
      * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).
      * @returns The market insights report, or `null` if none exists.
@@ -51,17 +72,61 @@ class AiDigestController extends base_controller_1.BaseController {
         if (!assetIdentifier) {
             throw new Error(ai_digest_constants_js_1.AiDigestControllerErrorMessage.INVALID_ASSET_IDENTIFIER);
         }
-        return __classPrivateFieldGet(this, _AiDigestController_digestService, "f").searchDigest(assetIdentifier);
+        const existing = this.state.marketInsights[assetIdentifier];
+        if (existing) {
+            const age = Date.now() - existing.fetchedAt;
+            if (age < ai_digest_constants_js_1.CACHE_DURATION_MS) {
+                return existing.data;
+            }
+        }
+        const data = await __classPrivateFieldGet(this, _AiDigestController_digestService, "f").searchDigest(assetIdentifier);
+        if (data === null) {
+            // No insights available for this asset — clear any stale cache entry
+            this.update((state) => {
+                delete state.marketInsights[assetIdentifier];
+            });
+            return null;
+        }
+        const entry = {
+            assetIdentifier,
+            fetchedAt: Date.now(),
+            data,
+        };
+        this.update((state) => {
+            state.marketInsights[assetIdentifier] = entry;
+            __classPrivateFieldGet(this, _AiDigestController_instances, "m", _AiDigestController_evictStaleCachedEntries).call(this, state.marketInsights);
+        });
+        return data;
     }
     /**
      * Fetches the market overview report.
-     *
-     * Clients own freshness/caching.
+     * Returns cached data if still fresh, otherwise calls the service.
      *
      * @returns The market overview report, or `null` if none exists.
      */
     async fetchMarketOverview() {
-        return __classPrivateFieldGet(this, _AiDigestController_digestService, "f").fetchMarketOverview();
+        const existing = this.state.marketOverview;
+        if (existing) {
+            const age = Date.now() - existing.fetchedAt;
+            if (age < ai_digest_constants_js_1.CACHE_DURATION_MS) {
+                return existing.data;
+            }
+        }
+        const data = await __classPrivateFieldGet(this, _AiDigestController_digestService, "f").fetchMarketOverview();
+        if (data === null) {
+            this.update((state) => {
+                state.marketOverview = null;
+            });
+            return null;
+        }
+        const entry = {
+            fetchedAt: Date.now(),
+            data,
+        };
+        this.update((state) => {
+            state.marketOverview = entry;
+        });
+        return data;
     }
     /**
      * Fetches a single market overview front page by id.
@@ -81,5 +146,28 @@ class AiDigestController extends base_controller_1.BaseController {
     }
 }
 exports.AiDigestController = AiDigestController;
-_AiDigestController_digestService = new WeakMap();
+_AiDigestController_digestService = new WeakMap(), _AiDigestController_instances = new WeakSet(), _AiDigestController_evictStaleCachedEntries = function _AiDigestController_evictStaleCachedEntries(cache) {
+    const now = Date.now();
+    const entries = Object.entries(cache);
+    const keysToDelete = [];
+    const freshEntries = [];
+    for (const [key, entry] of entries) {
+        if (now - entry.fetchedAt >= ai_digest_constants_js_1.CACHE_DURATION_MS) {
+            keysToDelete.push(key);
+        }
+        else {
+            freshEntries.push([key, entry]);
+        }
+    }
+    if (freshEntries.length > ai_digest_constants_js_1.MAX_CACHE_ENTRIES) {
+        freshEntries.sort((a, b) => a[1].fetchedAt - b[1].fetchedAt);
+        const entriesToRemove = freshEntries.length - ai_digest_constants_js_1.MAX_CACHE_ENTRIES;
+        for (let i = 0; i < entriesToRemove; i++) {
+            keysToDelete.push(freshEntries[i][0]);
+        }
+    }
+    for (const key of keysToDelete) {
+        delete cache[key];
+    }
+};
 //# sourceMappingURL=AiDigestController.cjs.map

package/dist/AiDigestController.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"AiDigestController.cjs","sourceRoot":"","sources":["../src/AiDigestController.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAKA,+DAA2D;AAG3D,sEAGkC;AAqClC,SAAgB,iCAAiC;IAC/C,OAAO,EAAE,CAAC;AACZ,CAAC;AAFD,8EAEC;AAED,MAAM,0BAA0B,GAA2C,EAAE,CAAC;AAE9E,MAAM,yBAAyB,GAAG;IAChC,qBAAqB;IACrB,qBAAqB;IACrB,oBAAoB;CACZ,CAAC;AAEX,MAAa,kBAAmB,SAAQ,gCAIvC;IAGC,YAAY,EAAE,SAAS,EAAE,aAAa,EAA6B;QACjE,KAAK,CAAC;YACJ,IAAI,EAAE,uCAAc;YACpB,QAAQ,EAAE,0BAA0B;YACpC,KAAK,EAAE,iCAAiC,EAAE;YAC1C,SAAS;SACV,CAAC,CAAC;QARI,oDAA8B;QAUrC,uBAAA,IAAI,qCAAkB,aAAa,MAAA,CAAC;QACpC,IAAI,CAAC,SAAS,CAAC,4BAA4B,CACzC,IAAI,EACJ,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,mBAAmB,CACvB,eAAuB;QAEvB,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,uDAA8B,CAAC,wBAAwB,CAAC,CAAC;QAC3E,CAAC;QAED,OAAO,uBAAA,IAAI,yCAAe,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,mBAAmB;QACvB,OAAO,uBAAA,IAAI,yCAAe,CAAC,mBAAmB,EAAE,CAAC;IACnD,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,kBAAkB,CACtB,EAAU;QAEV,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,uDAA8B,CAAC,qBAAqB,CAAC,CAAC;QACxE,CAAC;QAED,OAAO,uBAAA,IAAI,yCAAe,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF;AAxED,gDAwEC","sourcesContent":["import type {\n  StateMetadata,\n  ControllerStateChangeEvent,\n  ControllerGetStateAction,\n} from '@metamask/base-controller';\nimport { BaseController } from '@metamask/base-controller';\nimport type { Messenger } from '@metamask/messenger';\n\nimport {\n  AiDigestControllerErrorMessage,\n  controllerName,\n} from './ai-digest-constants.js';\nimport type {\n  AiDigestControllerState,\n  DigestService,\n  MarketInsightsReport,\n  MarketOverview,\n  MarketOverviewFrontPage,\n} from './ai-digest-types.js';\nimport type { AiDigestControllerMethodActions } from './AiDigestController-method-action-types.js';\n\nexport type AiDigestControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  AiDigestControllerState\n>;\n\nexport type AiDigestControllerActions =\n  | AiDigestControllerGetStateAction\n  | AiDigestControllerMethodActions;\n\nexport type AiDigestControllerStateChangeEvent = ControllerStateChangeEvent<\n  typeof controllerName,\n  AiDigestControllerState\n>;\n\nexport type AiDigestControllerEvents = AiDigestControllerStateChangeEvent;\n\nexport type AiDigestControllerMessenger = Messenger<\n  typeof controllerName,\n  AiDigestControllerActions,\n  AiDigestControllerEvents\n>;\n\nexport type AiDigestControllerOptions = {\n  messenger: AiDigestControllerMessenger;\n  digestService: DigestService;\n};\n\nexport function getDefaultAiDigestControllerState(): AiDigestControllerState {\n  return {};\n}\n\nconst aiDigestControllerMetadata: StateMetadata<AiDigestControllerState> = {};\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'fetchMarketInsights',\n  'fetchMarketOverview',\n  'fetchFrontPageItem',\n] as const;\n\nexport class AiDigestController extends BaseController<\n  typeof controllerName,\n  AiDigestControllerState,\n  AiDigestControllerMessenger\n> {\n  readonly #digestService: DigestService;\n\n  constructor({ messenger, digestService }: AiDigestControllerOptions) {\n    super({\n      name: controllerName,\n      metadata: aiDigestControllerMetadata,\n      state: getDefaultAiDigestControllerState(),\n      messenger,\n    });\n\n    this.#digestService = digestService;\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Fetches market insights for a given asset identifier.\n   *\n   * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps\n   * market symbol (e.g. `ETH`). The service handles choosing the correct API\n   * query parameter automatically. Clients own freshness/caching.\n   *\n   * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).\n   * @returns The market insights report, or `null` if none exists.\n   */\n  async fetchMarketInsights(\n    assetIdentifier: string,\n  ): Promise<MarketInsightsReport | null> {\n    if (!assetIdentifier) {\n      throw new Error(AiDigestControllerErrorMessage.INVALID_ASSET_IDENTIFIER);\n    }\n\n    return this.#digestService.searchDigest(assetIdentifier);\n  }\n\n  /**\n   * Fetches the market overview report.\n   *\n   * Clients own freshness/caching.\n   *\n   * @returns The market overview report, or `null` if none exists.\n   */\n  async fetchMarketOverview(): Promise<MarketOverview | null> {\n    return this.#digestService.fetchMarketOverview();\n  }\n\n  /**\n   * Fetches a single market overview front page by id.\n   *\n   * Unlike the market overview report (which only returns the latest items),\n   * this resolves an older item that has since dropped out of the report, so\n   * clients can render it directly (e.g. from a deep link).\n   *\n   * @param id - The front-page identifier (UUID).\n   * @returns The market overview front page, or `null` if none exists.\n   */\n  async fetchFrontPageItem(\n    id: string,\n  ): Promise<MarketOverviewFrontPage | null> {\n    if (!id) {\n      throw new Error(AiDigestControllerErrorMessage.INVALID_FRONT_PAGE_ID);\n    }\n\n    return this.#digestService.fetchFrontPageItem(id);\n  }\n}\n"]}
+{"version":3,"file":"AiDigestController.cjs","sourceRoot":"","sources":["../src/AiDigestController.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  StateMetadata,\n  ControllerStateChangeEvent,\n  ControllerGetStateAction,\n} from '@metamask/base-controller';\nimport { BaseController } from '@metamask/base-controller';\nimport type { Messenger } from '@metamask/messenger';\n\nimport {\n  AiDigestControllerErrorMessage,\n  controllerName,\n  CACHE_DURATION_MS,\n  MAX_CACHE_ENTRIES,\n} from './ai-digest-constants.js';\nimport type {\n  AiDigestControllerState,\n  DigestService,\n  MarketInsightsReport,\n  MarketInsightsEntry,\n  MarketOverview,\n  MarketOverviewEntry,\n  MarketOverviewFrontPage,\n} from './ai-digest-types.js';\nimport type { AiDigestControllerMethodActions } from './AiDigestController-method-action-types.js';\n\nexport type AiDigestControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  AiDigestControllerState\n>;\n\nexport type AiDigestControllerActions =\n  | AiDigestControllerGetStateAction\n  | AiDigestControllerMethodActions;\n\nexport type AiDigestControllerStateChangeEvent = ControllerStateChangeEvent<\n  typeof controllerName,\n  AiDigestControllerState\n>;\n\nexport type AiDigestControllerEvents = AiDigestControllerStateChangeEvent;\n\nexport type AiDigestControllerMessenger = Messenger<\n  typeof controllerName,\n  AiDigestControllerActions,\n  AiDigestControllerEvents\n>;\n\nexport type AiDigestControllerOptions = {\n  messenger: AiDigestControllerMessenger;\n  state?: Partial<AiDigestControllerState>;\n  digestService: DigestService;\n};\n\nexport function getDefaultAiDigestControllerState(): AiDigestControllerState {\n  return {\n    marketInsights: {},\n    marketOverview: null,\n  };\n}\n\nconst aiDigestControllerMetadata: StateMetadata<AiDigestControllerState> = {\n  marketInsights: {\n    persist: true,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: true,\n  },\n  marketOverview: {\n    persist: true,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: true,\n  },\n};\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'fetchMarketInsights',\n  'fetchMarketOverview',\n  'fetchFrontPageItem',\n] as const;\n\nexport class AiDigestController extends BaseController<\n  typeof controllerName,\n  AiDigestControllerState,\n  AiDigestControllerMessenger\n> {\n  readonly #digestService: DigestService;\n\n  constructor({ messenger, state, digestService }: AiDigestControllerOptions) {\n    super({\n      name: controllerName,\n      metadata: aiDigestControllerMetadata,\n      state: {\n        ...getDefaultAiDigestControllerState(),\n        ...state,\n      },\n      messenger,\n    });\n\n    this.#digestService = digestService;\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Fetches market insights for a given asset identifier.\n   * Returns cached data if still fresh, otherwise calls the service.\n   *\n   * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps\n   * market symbol (e.g. `ETH`). The service handles choosing the correct API\n   * query parameter automatically.\n   *\n   * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).\n   * @returns The market insights report, or `null` if none exists.\n   */\n  async fetchMarketInsights(\n    assetIdentifier: string,\n  ): Promise<MarketInsightsReport | null> {\n    if (!assetIdentifier) {\n      throw new Error(AiDigestControllerErrorMessage.INVALID_ASSET_IDENTIFIER);\n    }\n\n    const existing = this.state.marketInsights[assetIdentifier];\n    if (existing) {\n      const age = Date.now() - existing.fetchedAt;\n      if (age < CACHE_DURATION_MS) {\n        return existing.data;\n      }\n    }\n\n    const data = await this.#digestService.searchDigest(assetIdentifier);\n\n    if (data === null) {\n      // No insights available for this asset — clear any stale cache entry\n      this.update((state) => {\n        delete state.marketInsights[assetIdentifier];\n      });\n      return null;\n    }\n\n    const entry: MarketInsightsEntry = {\n      assetIdentifier,\n      fetchedAt: Date.now(),\n      data,\n    };\n\n    this.update((state) => {\n      state.marketInsights[assetIdentifier] = entry;\n      this.#evictStaleCachedEntries(state.marketInsights);\n    });\n\n    return data;\n  }\n\n  /**\n   * Fetches the market overview report.\n   * Returns cached data if still fresh, otherwise calls the service.\n   *\n   * @returns The market overview report, or `null` if none exists.\n   */\n  async fetchMarketOverview(): Promise<MarketOverview | null> {\n    const existing = this.state.marketOverview;\n    if (existing) {\n      const age = Date.now() - existing.fetchedAt;\n      if (age < CACHE_DURATION_MS) {\n        return existing.data;\n      }\n    }\n\n    const data = await this.#digestService.fetchMarketOverview();\n\n    if (data === null) {\n      this.update((state) => {\n        state.marketOverview = null;\n      });\n      return null;\n    }\n\n    const entry: MarketOverviewEntry = {\n      fetchedAt: Date.now(),\n      data,\n    };\n\n    this.update((state) => {\n      state.marketOverview = entry;\n    });\n\n    return data;\n  }\n\n  /**\n   * Fetches a single market overview front page by id.\n   *\n   * Unlike the market overview report (which only returns the latest items),\n   * this resolves an older item that has since dropped out of the report, so\n   * clients can render it directly (e.g. from a deep link).\n   *\n   * @param id - The front-page identifier (UUID).\n   * @returns The market overview front page, or `null` if none exists.\n   */\n  async fetchFrontPageItem(\n    id: string,\n  ): Promise<MarketOverviewFrontPage | null> {\n    if (!id) {\n      throw new Error(AiDigestControllerErrorMessage.INVALID_FRONT_PAGE_ID);\n    }\n\n    return this.#digestService.fetchFrontPageItem(id);\n  }\n\n  /**\n   * Evicts stale (TTL expired) and oldest entries (FIFO) if cache exceeds max size.\n   *\n   * @param cache - The cache record to evict entries from.\n   */\n  #evictStaleCachedEntries<EntryType extends { fetchedAt: number }>(\n    cache: Record<string, EntryType>,\n  ): void {\n    const now = Date.now();\n    const entries = Object.entries(cache);\n    const keysToDelete: string[] = [];\n    const freshEntries: [string, EntryType][] = [];\n\n    for (const [key, entry] of entries) {\n      if (now - entry.fetchedAt >= CACHE_DURATION_MS) {\n        keysToDelete.push(key);\n      } else {\n        freshEntries.push([key, entry]);\n      }\n    }\n\n    if (freshEntries.length > MAX_CACHE_ENTRIES) {\n      freshEntries.sort((a, b) => a[1].fetchedAt - b[1].fetchedAt);\n      const entriesToRemove = freshEntries.length - MAX_CACHE_ENTRIES;\n      for (let i = 0; i < entriesToRemove; i++) {\n        keysToDelete.push(freshEntries[i][0]);\n      }\n    }\n\n    for (const key of keysToDelete) {\n      delete cache[key];\n    }\n  }\n}\n"]}

package/dist/AiDigestController.d.cts

@@ -11,18 +11,20 @@ export type AiDigestControllerEvents = AiDigestControllerStateChangeEvent;
 export type AiDigestControllerMessenger = Messenger<typeof controllerName, AiDigestControllerActions, AiDigestControllerEvents>;
 export type AiDigestControllerOptions = {
     messenger: AiDigestControllerMessenger;
+    state?: Partial<AiDigestControllerState>;
     digestService: DigestService;
 };
 export declare function getDefaultAiDigestControllerState(): AiDigestControllerState;
 export declare class AiDigestController extends BaseController<typeof controllerName, AiDigestControllerState, AiDigestControllerMessenger> {
     #private;
-    constructor({ messenger, digestService }: AiDigestControllerOptions);
+    constructor({ messenger, state, digestService }: AiDigestControllerOptions);
     /**
      * Fetches market insights for a given asset identifier.
+     * Returns cached data if still fresh, otherwise calls the service.
      *
      * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps
      * market symbol (e.g. `ETH`). The service handles choosing the correct API
-     * query parameter automatically. Clients own freshness/caching.
+     * query parameter automatically.
      *
      * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).
      * @returns The market insights report, or `null` if none exists.
@@ -30,8 +32,7 @@ export declare class AiDigestController extends BaseController<typeof controller
     fetchMarketInsights(assetIdentifier: string): Promise<MarketInsightsReport | null>;
     /**
      * Fetches the market overview report.
-     *
-     * Clients own freshness/caching.
+     * Returns cached data if still fresh, otherwise calls the service.
      *
      * @returns The market overview report, or `null` if none exists.
      */

package/dist/AiDigestController.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"AiDigestController.d.cts","sourceRoot":"","sources":["../src/AiDigestController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,0BAA0B,EAC1B,wBAAwB,EACzB,kCAAkC;AACnC,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAErD,OAAO,EAEL,cAAc,EACf,kCAAiC;AAClC,OAAO,KAAK,EACV,uBAAuB,EACvB,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACxB,8BAA6B;AAC9B,OAAO,KAAK,EAAE,+BAA+B,EAAE,qDAAoD;AAEnG,MAAM,MAAM,gCAAgC,GAAG,wBAAwB,CACrE,OAAO,cAAc,EACrB,uBAAuB,CACxB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GACjC,gCAAgC,GAChC,+BAA+B,CAAC;AAEpC,MAAM,MAAM,kCAAkC,GAAG,0BAA0B,CACzE,OAAO,cAAc,EACrB,uBAAuB,CACxB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,kCAAkC,CAAC;AAE1E,MAAM,MAAM,2BAA2B,GAAG,SAAS,CACjD,OAAO,cAAc,EACrB,yBAAyB,EACzB,wBAAwB,CACzB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,EAAE,2BAA2B,CAAC;IACvC,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF,wBAAgB,iCAAiC,IAAI,uBAAuB,CAE3E;AAUD,qBAAa,kBAAmB,SAAQ,cAAc,CACpD,OAAO,cAAc,EACrB,uBAAuB,EACvB,2BAA2B,CAC5B;;gBAGa,EAAE,SAAS,EAAE,aAAa,EAAE,EAAE,yBAAyB;IAenE;;;;;;;;;OASG;IACG,mBAAmB,CACvB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAQvC;;;;;;OAMG;IACG,mBAAmB,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAI3D;;;;;;;;;OASG;IACG,kBAAkB,CACtB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;CAO3C"}
+{"version":3,"file":"AiDigestController.d.cts","sourceRoot":"","sources":["../src/AiDigestController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,0BAA0B,EAC1B,wBAAwB,EACzB,kCAAkC;AACnC,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAErD,OAAO,EAEL,cAAc,EAGf,kCAAiC;AAClC,OAAO,KAAK,EACV,uBAAuB,EACvB,aAAa,EACb,oBAAoB,EAEpB,cAAc,EAEd,uBAAuB,EACxB,8BAA6B;AAC9B,OAAO,KAAK,EAAE,+BAA+B,EAAE,qDAAoD;AAEnG,MAAM,MAAM,gCAAgC,GAAG,wBAAwB,CACrE,OAAO,cAAc,EACrB,uBAAuB,CACxB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GACjC,gCAAgC,GAChC,+BAA+B,CAAC;AAEpC,MAAM,MAAM,kCAAkC,GAAG,0BAA0B,CACzE,OAAO,cAAc,EACrB,uBAAuB,CACxB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,kCAAkC,CAAC;AAE1E,MAAM,MAAM,2BAA2B,GAAG,SAAS,CACjD,OAAO,cAAc,EACrB,yBAAyB,EACzB,wBAAwB,CACzB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,EAAE,2BAA2B,CAAC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACzC,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF,wBAAgB,iCAAiC,IAAI,uBAAuB,CAK3E;AAuBD,qBAAa,kBAAmB,SAAQ,cAAc,CACpD,OAAO,cAAc,EACrB,uBAAuB,EACvB,2BAA2B,CAC5B;;gBAGa,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,yBAAyB;IAkB1E;;;;;;;;;;OAUG;IACG,mBAAmB,CACvB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAqCvC;;;;;OAKG;IACG,mBAAmB,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA8B3D;;;;;;;;;OASG;IACG,kBAAkB,CACtB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;CAyC3C"}

package/dist/AiDigestController.d.mts

@@ -11,18 +11,20 @@ export type AiDigestControllerEvents = AiDigestControllerStateChangeEvent;
 export type AiDigestControllerMessenger = Messenger<typeof controllerName, AiDigestControllerActions, AiDigestControllerEvents>;
 export type AiDigestControllerOptions = {
     messenger: AiDigestControllerMessenger;
+    state?: Partial<AiDigestControllerState>;
     digestService: DigestService;
 };
 export declare function getDefaultAiDigestControllerState(): AiDigestControllerState;
 export declare class AiDigestController extends BaseController<typeof controllerName, AiDigestControllerState, AiDigestControllerMessenger> {
     #private;
-    constructor({ messenger, digestService }: AiDigestControllerOptions);
+    constructor({ messenger, state, digestService }: AiDigestControllerOptions);
     /**
      * Fetches market insights for a given asset identifier.
+     * Returns cached data if still fresh, otherwise calls the service.
      *
      * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps
      * market symbol (e.g. `ETH`). The service handles choosing the correct API
-     * query parameter automatically. Clients own freshness/caching.
+     * query parameter automatically.
      *
      * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).
      * @returns The market insights report, or `null` if none exists.
@@ -30,8 +32,7 @@ export declare class AiDigestController extends BaseController<typeof controller
     fetchMarketInsights(assetIdentifier: string): Promise<MarketInsightsReport | null>;
     /**
      * Fetches the market overview report.
-     *
-     * Clients own freshness/caching.
+     * Returns cached data if still fresh, otherwise calls the service.
      *
      * @returns The market overview report, or `null` if none exists.
      */

package/dist/AiDigestController.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"AiDigestController.d.mts","sourceRoot":"","sources":["../src/AiDigestController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,0BAA0B,EAC1B,wBAAwB,EACzB,kCAAkC;AACnC,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAErD,OAAO,EAEL,cAAc,EACf,kCAAiC;AAClC,OAAO,KAAK,EACV,uBAAuB,EACvB,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACxB,8BAA6B;AAC9B,OAAO,KAAK,EAAE,+BAA+B,EAAE,qDAAoD;AAEnG,MAAM,MAAM,gCAAgC,GAAG,wBAAwB,CACrE,OAAO,cAAc,EACrB,uBAAuB,CACxB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GACjC,gCAAgC,GAChC,+BAA+B,CAAC;AAEpC,MAAM,MAAM,kCAAkC,GAAG,0BAA0B,CACzE,OAAO,cAAc,EACrB,uBAAuB,CACxB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,kCAAkC,CAAC;AAE1E,MAAM,MAAM,2BAA2B,GAAG,SAAS,CACjD,OAAO,cAAc,EACrB,yBAAyB,EACzB,wBAAwB,CACzB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,EAAE,2BAA2B,CAAC;IACvC,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF,wBAAgB,iCAAiC,IAAI,uBAAuB,CAE3E;AAUD,qBAAa,kBAAmB,SAAQ,cAAc,CACpD,OAAO,cAAc,EACrB,uBAAuB,EACvB,2BAA2B,CAC5B;;gBAGa,EAAE,SAAS,EAAE,aAAa,EAAE,EAAE,yBAAyB;IAenE;;;;;;;;;OASG;IACG,mBAAmB,CACvB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAQvC;;;;;;OAMG;IACG,mBAAmB,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAI3D;;;;;;;;;OASG;IACG,kBAAkB,CACtB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;CAO3C"}
+{"version":3,"file":"AiDigestController.d.mts","sourceRoot":"","sources":["../src/AiDigestController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,0BAA0B,EAC1B,wBAAwB,EACzB,kCAAkC;AACnC,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAErD,OAAO,EAEL,cAAc,EAGf,kCAAiC;AAClC,OAAO,KAAK,EACV,uBAAuB,EACvB,aAAa,EACb,oBAAoB,EAEpB,cAAc,EAEd,uBAAuB,EACxB,8BAA6B;AAC9B,OAAO,KAAK,EAAE,+BAA+B,EAAE,qDAAoD;AAEnG,MAAM,MAAM,gCAAgC,GAAG,wBAAwB,CACrE,OAAO,cAAc,EACrB,uBAAuB,CACxB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GACjC,gCAAgC,GAChC,+BAA+B,CAAC;AAEpC,MAAM,MAAM,kCAAkC,GAAG,0BAA0B,CACzE,OAAO,cAAc,EACrB,uBAAuB,CACxB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,kCAAkC,CAAC;AAE1E,MAAM,MAAM,2BAA2B,GAAG,SAAS,CACjD,OAAO,cAAc,EACrB,yBAAyB,EACzB,wBAAwB,CACzB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,EAAE,2BAA2B,CAAC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACzC,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF,wBAAgB,iCAAiC,IAAI,uBAAuB,CAK3E;AAuBD,qBAAa,kBAAmB,SAAQ,cAAc,CACpD,OAAO,cAAc,EACrB,uBAAuB,EACvB,2BAA2B,CAC5B;;gBAGa,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,yBAAyB;IAkB1E;;;;;;;;;;OAUG;IACG,mBAAmB,CACvB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAqCvC;;;;;OAKG;IACG,mBAAmB,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA8B3D;;;;;;;;;OASG;IACG,kBAAkB,CACtB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;CAyC3C"}

package/dist/AiDigestController.mjs

@@ -9,36 +9,57 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _AiDigestController_digestService;
+var _AiDigestController_instances, _AiDigestController_digestService, _AiDigestController_evictStaleCachedEntries;
 import { BaseController } from "@metamask/base-controller";
-import { AiDigestControllerErrorMessage, controllerName } from "./ai-digest-constants.mjs";
+import { AiDigestControllerErrorMessage, controllerName, CACHE_DURATION_MS, MAX_CACHE_ENTRIES } from "./ai-digest-constants.mjs";
 export function getDefaultAiDigestControllerState() {
-    return {};
+    return {
+        marketInsights: {},
+        marketOverview: null,
+    };
 }
-const aiDigestControllerMetadata = {};
+const aiDigestControllerMetadata = {
+    marketInsights: {
+        persist: true,
+        includeInDebugSnapshot: true,
+        includeInStateLogs: true,
+        usedInUi: true,
+    },
+    marketOverview: {
+        persist: true,
+        includeInDebugSnapshot: true,
+        includeInStateLogs: true,
+        usedInUi: true,
+    },
+};
 const MESSENGER_EXPOSED_METHODS = [
     'fetchMarketInsights',
     'fetchMarketOverview',
     'fetchFrontPageItem',
 ];
 export class AiDigestController extends BaseController {
-    constructor({ messenger, digestService }) {
+    constructor({ messenger, state, digestService }) {
         super({
             name: controllerName,
             metadata: aiDigestControllerMetadata,
-            state: getDefaultAiDigestControllerState(),
+            state: {
+                ...getDefaultAiDigestControllerState(),
+                ...state,
+            },
             messenger,
         });
+        _AiDigestController_instances.add(this);
         _AiDigestController_digestService.set(this, void 0);
         __classPrivateFieldSet(this, _AiDigestController_digestService, digestService, "f");
         this.messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
     }
     /**
      * Fetches market insights for a given asset identifier.
+     * Returns cached data if still fresh, otherwise calls the service.
      *
      * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps
      * market symbol (e.g. `ETH`). The service handles choosing the correct API
-     * query parameter automatically. Clients own freshness/caching.
+     * query parameter automatically.
      *
      * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).
      * @returns The market insights report, or `null` if none exists.
@@ -47,17 +68,61 @@ export class AiDigestController extends BaseController {
         if (!assetIdentifier) {
             throw new Error(AiDigestControllerErrorMessage.INVALID_ASSET_IDENTIFIER);
         }
-        return __classPrivateFieldGet(this, _AiDigestController_digestService, "f").searchDigest(assetIdentifier);
+        const existing = this.state.marketInsights[assetIdentifier];
+        if (existing) {
+            const age = Date.now() - existing.fetchedAt;
+            if (age < CACHE_DURATION_MS) {
+                return existing.data;
+            }
+        }
+        const data = await __classPrivateFieldGet(this, _AiDigestController_digestService, "f").searchDigest(assetIdentifier);
+        if (data === null) {
+            // No insights available for this asset — clear any stale cache entry
+            this.update((state) => {
+                delete state.marketInsights[assetIdentifier];
+            });
+            return null;
+        }
+        const entry = {
+            assetIdentifier,
+            fetchedAt: Date.now(),
+            data,
+        };
+        this.update((state) => {
+            state.marketInsights[assetIdentifier] = entry;
+            __classPrivateFieldGet(this, _AiDigestController_instances, "m", _AiDigestController_evictStaleCachedEntries).call(this, state.marketInsights);
+        });
+        return data;
     }
     /**
      * Fetches the market overview report.
-     *
-     * Clients own freshness/caching.
+     * Returns cached data if still fresh, otherwise calls the service.
      *
      * @returns The market overview report, or `null` if none exists.
      */
     async fetchMarketOverview() {
-        return __classPrivateFieldGet(this, _AiDigestController_digestService, "f").fetchMarketOverview();
+        const existing = this.state.marketOverview;
+        if (existing) {
+            const age = Date.now() - existing.fetchedAt;
+            if (age < CACHE_DURATION_MS) {
+                return existing.data;
+            }
+        }
+        const data = await __classPrivateFieldGet(this, _AiDigestController_digestService, "f").fetchMarketOverview();
+        if (data === null) {
+            this.update((state) => {
+                state.marketOverview = null;
+            });
+            return null;
+        }
+        const entry = {
+            fetchedAt: Date.now(),
+            data,
+        };
+        this.update((state) => {
+            state.marketOverview = entry;
+        });
+        return data;
     }
     /**
      * Fetches a single market overview front page by id.
@@ -76,5 +141,28 @@ export class AiDigestController extends BaseController {
         return __classPrivateFieldGet(this, _AiDigestController_digestService, "f").fetchFrontPageItem(id);
     }
 }
-_AiDigestController_digestService = new WeakMap();
+_AiDigestController_digestService = new WeakMap(), _AiDigestController_instances = new WeakSet(), _AiDigestController_evictStaleCachedEntries = function _AiDigestController_evictStaleCachedEntries(cache) {
+    const now = Date.now();
+    const entries = Object.entries(cache);
+    const keysToDelete = [];
+    const freshEntries = [];
+    for (const [key, entry] of entries) {
+        if (now - entry.fetchedAt >= CACHE_DURATION_MS) {
+            keysToDelete.push(key);
+        }
+        else {
+            freshEntries.push([key, entry]);
+        }
+    }
+    if (freshEntries.length > MAX_CACHE_ENTRIES) {
+        freshEntries.sort((a, b) => a[1].fetchedAt - b[1].fetchedAt);
+        const entriesToRemove = freshEntries.length - MAX_CACHE_ENTRIES;
+        for (let i = 0; i < entriesToRemove; i++) {
+            keysToDelete.push(freshEntries[i][0]);
+        }
+    }
+    for (const key of keysToDelete) {
+        delete cache[key];
+    }
+};
 //# sourceMappingURL=AiDigestController.mjs.map

package/dist/AiDigestController.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"AiDigestController.mjs","sourceRoot":"","sources":["../src/AiDigestController.ts"],"names":[],"mappings":";;;;;;;;;;;;AAKA,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAG3D,OAAO,EACL,8BAA8B,EAC9B,cAAc,EACf,kCAAiC;AAqClC,MAAM,UAAU,iCAAiC;IAC/C,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,0BAA0B,GAA2C,EAAE,CAAC;AAE9E,MAAM,yBAAyB,GAAG;IAChC,qBAAqB;IACrB,qBAAqB;IACrB,oBAAoB;CACZ,CAAC;AAEX,MAAM,OAAO,kBAAmB,SAAQ,cAIvC;IAGC,YAAY,EAAE,SAAS,EAAE,aAAa,EAA6B;QACjE,KAAK,CAAC;YACJ,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,0BAA0B;YACpC,KAAK,EAAE,iCAAiC,EAAE;YAC1C,SAAS;SACV,CAAC,CAAC;QARI,oDAA8B;QAUrC,uBAAA,IAAI,qCAAkB,aAAa,MAAA,CAAC;QACpC,IAAI,CAAC,SAAS,CAAC,4BAA4B,CACzC,IAAI,EACJ,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,mBAAmB,CACvB,eAAuB;QAEvB,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,wBAAwB,CAAC,CAAC;QAC3E,CAAC;QAED,OAAO,uBAAA,IAAI,yCAAe,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,mBAAmB;QACvB,OAAO,uBAAA,IAAI,yCAAe,CAAC,mBAAmB,EAAE,CAAC;IACnD,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,kBAAkB,CACtB,EAAU;QAEV,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,qBAAqB,CAAC,CAAC;QACxE,CAAC;QAED,OAAO,uBAAA,IAAI,yCAAe,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF","sourcesContent":["import type {\n  StateMetadata,\n  ControllerStateChangeEvent,\n  ControllerGetStateAction,\n} from '@metamask/base-controller';\nimport { BaseController } from '@metamask/base-controller';\nimport type { Messenger } from '@metamask/messenger';\n\nimport {\n  AiDigestControllerErrorMessage,\n  controllerName,\n} from './ai-digest-constants.js';\nimport type {\n  AiDigestControllerState,\n  DigestService,\n  MarketInsightsReport,\n  MarketOverview,\n  MarketOverviewFrontPage,\n} from './ai-digest-types.js';\nimport type { AiDigestControllerMethodActions } from './AiDigestController-method-action-types.js';\n\nexport type AiDigestControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  AiDigestControllerState\n>;\n\nexport type AiDigestControllerActions =\n  | AiDigestControllerGetStateAction\n  | AiDigestControllerMethodActions;\n\nexport type AiDigestControllerStateChangeEvent = ControllerStateChangeEvent<\n  typeof controllerName,\n  AiDigestControllerState\n>;\n\nexport type AiDigestControllerEvents = AiDigestControllerStateChangeEvent;\n\nexport type AiDigestControllerMessenger = Messenger<\n  typeof controllerName,\n  AiDigestControllerActions,\n  AiDigestControllerEvents\n>;\n\nexport type AiDigestControllerOptions = {\n  messenger: AiDigestControllerMessenger;\n  digestService: DigestService;\n};\n\nexport function getDefaultAiDigestControllerState(): AiDigestControllerState {\n  return {};\n}\n\nconst aiDigestControllerMetadata: StateMetadata<AiDigestControllerState> = {};\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'fetchMarketInsights',\n  'fetchMarketOverview',\n  'fetchFrontPageItem',\n] as const;\n\nexport class AiDigestController extends BaseController<\n  typeof controllerName,\n  AiDigestControllerState,\n  AiDigestControllerMessenger\n> {\n  readonly #digestService: DigestService;\n\n  constructor({ messenger, digestService }: AiDigestControllerOptions) {\n    super({\n      name: controllerName,\n      metadata: aiDigestControllerMetadata,\n      state: getDefaultAiDigestControllerState(),\n      messenger,\n    });\n\n    this.#digestService = digestService;\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Fetches market insights for a given asset identifier.\n   *\n   * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps\n   * market symbol (e.g. `ETH`). The service handles choosing the correct API\n   * query parameter automatically. Clients own freshness/caching.\n   *\n   * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).\n   * @returns The market insights report, or `null` if none exists.\n   */\n  async fetchMarketInsights(\n    assetIdentifier: string,\n  ): Promise<MarketInsightsReport | null> {\n    if (!assetIdentifier) {\n      throw new Error(AiDigestControllerErrorMessage.INVALID_ASSET_IDENTIFIER);\n    }\n\n    return this.#digestService.searchDigest(assetIdentifier);\n  }\n\n  /**\n   * Fetches the market overview report.\n   *\n   * Clients own freshness/caching.\n   *\n   * @returns The market overview report, or `null` if none exists.\n   */\n  async fetchMarketOverview(): Promise<MarketOverview | null> {\n    return this.#digestService.fetchMarketOverview();\n  }\n\n  /**\n   * Fetches a single market overview front page by id.\n   *\n   * Unlike the market overview report (which only returns the latest items),\n   * this resolves an older item that has since dropped out of the report, so\n   * clients can render it directly (e.g. from a deep link).\n   *\n   * @param id - The front-page identifier (UUID).\n   * @returns The market overview front page, or `null` if none exists.\n   */\n  async fetchFrontPageItem(\n    id: string,\n  ): Promise<MarketOverviewFrontPage | null> {\n    if (!id) {\n      throw new Error(AiDigestControllerErrorMessage.INVALID_FRONT_PAGE_ID);\n    }\n\n    return this.#digestService.fetchFrontPageItem(id);\n  }\n}\n"]}
+{"version":3,"file":"AiDigestController.mjs","sourceRoot":"","sources":["../src/AiDigestController.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  StateMetadata,\n  ControllerStateChangeEvent,\n  ControllerGetStateAction,\n} from '@metamask/base-controller';\nimport { BaseController } from '@metamask/base-controller';\nimport type { Messenger } from '@metamask/messenger';\n\nimport {\n  AiDigestControllerErrorMessage,\n  controllerName,\n  CACHE_DURATION_MS,\n  MAX_CACHE_ENTRIES,\n} from './ai-digest-constants.js';\nimport type {\n  AiDigestControllerState,\n  DigestService,\n  MarketInsightsReport,\n  MarketInsightsEntry,\n  MarketOverview,\n  MarketOverviewEntry,\n  MarketOverviewFrontPage,\n} from './ai-digest-types.js';\nimport type { AiDigestControllerMethodActions } from './AiDigestController-method-action-types.js';\n\nexport type AiDigestControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  AiDigestControllerState\n>;\n\nexport type AiDigestControllerActions =\n  | AiDigestControllerGetStateAction\n  | AiDigestControllerMethodActions;\n\nexport type AiDigestControllerStateChangeEvent = ControllerStateChangeEvent<\n  typeof controllerName,\n  AiDigestControllerState\n>;\n\nexport type AiDigestControllerEvents = AiDigestControllerStateChangeEvent;\n\nexport type AiDigestControllerMessenger = Messenger<\n  typeof controllerName,\n  AiDigestControllerActions,\n  AiDigestControllerEvents\n>;\n\nexport type AiDigestControllerOptions = {\n  messenger: AiDigestControllerMessenger;\n  state?: Partial<AiDigestControllerState>;\n  digestService: DigestService;\n};\n\nexport function getDefaultAiDigestControllerState(): AiDigestControllerState {\n  return {\n    marketInsights: {},\n    marketOverview: null,\n  };\n}\n\nconst aiDigestControllerMetadata: StateMetadata<AiDigestControllerState> = {\n  marketInsights: {\n    persist: true,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: true,\n  },\n  marketOverview: {\n    persist: true,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: true,\n  },\n};\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'fetchMarketInsights',\n  'fetchMarketOverview',\n  'fetchFrontPageItem',\n] as const;\n\nexport class AiDigestController extends BaseController<\n  typeof controllerName,\n  AiDigestControllerState,\n  AiDigestControllerMessenger\n> {\n  readonly #digestService: DigestService;\n\n  constructor({ messenger, state, digestService }: AiDigestControllerOptions) {\n    super({\n      name: controllerName,\n      metadata: aiDigestControllerMetadata,\n      state: {\n        ...getDefaultAiDigestControllerState(),\n        ...state,\n      },\n      messenger,\n    });\n\n    this.#digestService = digestService;\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Fetches market insights for a given asset identifier.\n   * Returns cached data if still fresh, otherwise calls the service.\n   *\n   * Accepts either a CAIP-19 asset type (e.g. `eip155:1/slip44:60`) or a perps\n   * market symbol (e.g. `ETH`). The service handles choosing the correct API\n   * query parameter automatically.\n   *\n   * @param assetIdentifier - The asset identifier (CAIP-19 ID or perps market symbol).\n   * @returns The market insights report, or `null` if none exists.\n   */\n  async fetchMarketInsights(\n    assetIdentifier: string,\n  ): Promise<MarketInsightsReport | null> {\n    if (!assetIdentifier) {\n      throw new Error(AiDigestControllerErrorMessage.INVALID_ASSET_IDENTIFIER);\n    }\n\n    const existing = this.state.marketInsights[assetIdentifier];\n    if (existing) {\n      const age = Date.now() - existing.fetchedAt;\n      if (age < CACHE_DURATION_MS) {\n        return existing.data;\n      }\n    }\n\n    const data = await this.#digestService.searchDigest(assetIdentifier);\n\n    if (data === null) {\n      // No insights available for this asset — clear any stale cache entry\n      this.update((state) => {\n        delete state.marketInsights[assetIdentifier];\n      });\n      return null;\n    }\n\n    const entry: MarketInsightsEntry = {\n      assetIdentifier,\n      fetchedAt: Date.now(),\n      data,\n    };\n\n    this.update((state) => {\n      state.marketInsights[assetIdentifier] = entry;\n      this.#evictStaleCachedEntries(state.marketInsights);\n    });\n\n    return data;\n  }\n\n  /**\n   * Fetches the market overview report.\n   * Returns cached data if still fresh, otherwise calls the service.\n   *\n   * @returns The market overview report, or `null` if none exists.\n   */\n  async fetchMarketOverview(): Promise<MarketOverview | null> {\n    const existing = this.state.marketOverview;\n    if (existing) {\n      const age = Date.now() - existing.fetchedAt;\n      if (age < CACHE_DURATION_MS) {\n        return existing.data;\n      }\n    }\n\n    const data = await this.#digestService.fetchMarketOverview();\n\n    if (data === null) {\n      this.update((state) => {\n        state.marketOverview = null;\n      });\n      return null;\n    }\n\n    const entry: MarketOverviewEntry = {\n      fetchedAt: Date.now(),\n      data,\n    };\n\n    this.update((state) => {\n      state.marketOverview = entry;\n    });\n\n    return data;\n  }\n\n  /**\n   * Fetches a single market overview front page by id.\n   *\n   * Unlike the market overview report (which only returns the latest items),\n   * this resolves an older item that has since dropped out of the report, so\n   * clients can render it directly (e.g. from a deep link).\n   *\n   * @param id - The front-page identifier (UUID).\n   * @returns The market overview front page, or `null` if none exists.\n   */\n  async fetchFrontPageItem(\n    id: string,\n  ): Promise<MarketOverviewFrontPage | null> {\n    if (!id) {\n      throw new Error(AiDigestControllerErrorMessage.INVALID_FRONT_PAGE_ID);\n    }\n\n    return this.#digestService.fetchFrontPageItem(id);\n  }\n\n  /**\n   * Evicts stale (TTL expired) and oldest entries (FIFO) if cache exceeds max size.\n   *\n   * @param cache - The cache record to evict entries from.\n   */\n  #evictStaleCachedEntries<EntryType extends { fetchedAt: number }>(\n    cache: Record<string, EntryType>,\n  ): void {\n    const now = Date.now();\n    const entries = Object.entries(cache);\n    const keysToDelete: string[] = [];\n    const freshEntries: [string, EntryType][] = [];\n\n    for (const [key, entry] of entries) {\n      if (now - entry.fetchedAt >= CACHE_DURATION_MS) {\n        keysToDelete.push(key);\n      } else {\n        freshEntries.push([key, entry]);\n      }\n    }\n\n    if (freshEntries.length > MAX_CACHE_ENTRIES) {\n      freshEntries.sort((a, b) => a[1].fetchedAt - b[1].fetchedAt);\n      const entriesToRemove = freshEntries.length - MAX_CACHE_ENTRIES;\n      for (let i = 0; i < entriesToRemove; i++) {\n        keysToDelete.push(freshEntries[i][0]);\n      }\n    }\n\n    for (const key of keysToDelete) {\n      delete cache[key];\n    }\n  }\n}\n"]}

package/dist/ai-digest-constants.cjs

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AiDigestControllerErrorMessage = exports.controllerName = void 0;
+exports.AiDigestControllerErrorMessage = exports.MAX_CACHE_ENTRIES = exports.CACHE_DURATION_MS = exports.controllerName = void 0;
 exports.controllerName = 'AiDigestController';
+exports.CACHE_DURATION_MS = 10 * 60 * 1000; // 10 minutes
+exports.MAX_CACHE_ENTRIES = 50;
 exports.AiDigestControllerErrorMessage = {
     API_REQUEST_FAILED: 'API request failed',
     API_INVALID_RESPONSE: 'API returned invalid response',

package/dist/ai-digest-constants.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ai-digest-constants.cjs","sourceRoot":"","sources":["../src/ai-digest-constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,cAAc,GAAG,oBAAoB,CAAC;AAEtC,QAAA,8BAA8B,GAAG;IAC5C,kBAAkB,EAAE,oBAAoB;IACxC,oBAAoB,EAAE,+BAA+B;IACrD,wBAAwB,EAAE,0BAA0B;IACpD,qBAAqB,EAAE,uBAAuB;CACtC,CAAC","sourcesContent":["export const controllerName = 'AiDigestController';\n\nexport const AiDigestControllerErrorMessage = {\n  API_REQUEST_FAILED: 'API request failed',\n  API_INVALID_RESPONSE: 'API returned invalid response',\n  INVALID_ASSET_IDENTIFIER: 'Invalid asset identifier',\n  INVALID_FRONT_PAGE_ID: 'Invalid front page id',\n} as const;\n"]}
+{"version":3,"file":"ai-digest-constants.cjs","sourceRoot":"","sources":["../src/ai-digest-constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,cAAc,GAAG,oBAAoB,CAAC;AAEtC,QAAA,iBAAiB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;AAEjD,QAAA,iBAAiB,GAAG,EAAE,CAAC;AAEvB,QAAA,8BAA8B,GAAG;IAC5C,kBAAkB,EAAE,oBAAoB;IACxC,oBAAoB,EAAE,+BAA+B;IACrD,wBAAwB,EAAE,0BAA0B;IACpD,qBAAqB,EAAE,uBAAuB;CACtC,CAAC","sourcesContent":["export const controllerName = 'AiDigestController';\n\nexport const CACHE_DURATION_MS = 10 * 60 * 1000; // 10 minutes\n\nexport const MAX_CACHE_ENTRIES = 50;\n\nexport const AiDigestControllerErrorMessage = {\n  API_REQUEST_FAILED: 'API request failed',\n  API_INVALID_RESPONSE: 'API returned invalid response',\n  INVALID_ASSET_IDENTIFIER: 'Invalid asset identifier',\n  INVALID_FRONT_PAGE_ID: 'Invalid front page id',\n} as const;\n"]}

package/dist/ai-digest-constants.d.cts

@@ -1,4 +1,6 @@
 export declare const controllerName = "AiDigestController";
+export declare const CACHE_DURATION_MS: number;
+export declare const MAX_CACHE_ENTRIES = 50;
 export declare const AiDigestControllerErrorMessage: {
     readonly API_REQUEST_FAILED: "API request failed";
     readonly API_INVALID_RESPONSE: "API returned invalid response";

package/dist/ai-digest-constants.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-digest-constants.d.cts","sourceRoot":"","sources":["../src/ai-digest-constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,uBAAuB,CAAC;AAEnD,eAAO,MAAM,8BAA8B;;;;;CAKjC,CAAC"}
+{"version":3,"file":"ai-digest-constants.d.cts","sourceRoot":"","sources":["../src/ai-digest-constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,uBAAuB,CAAC;AAEnD,eAAO,MAAM,iBAAiB,QAAiB,CAAC;AAEhD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,eAAO,MAAM,8BAA8B;;;;;CAKjC,CAAC"}

package/dist/ai-digest-constants.d.mts

@@ -1,4 +1,6 @@
 export declare const controllerName = "AiDigestController";
+export declare const CACHE_DURATION_MS: number;
+export declare const MAX_CACHE_ENTRIES = 50;
 export declare const AiDigestControllerErrorMessage: {
     readonly API_REQUEST_FAILED: "API request failed";
     readonly API_INVALID_RESPONSE: "API returned invalid response";

package/dist/ai-digest-constants.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-digest-constants.d.mts","sourceRoot":"","sources":["../src/ai-digest-constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,uBAAuB,CAAC;AAEnD,eAAO,MAAM,8BAA8B;;;;;CAKjC,CAAC"}
+{"version":3,"file":"ai-digest-constants.d.mts","sourceRoot":"","sources":["../src/ai-digest-constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,uBAAuB,CAAC;AAEnD,eAAO,MAAM,iBAAiB,QAAiB,CAAC;AAEhD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,eAAO,MAAM,8BAA8B;;;;;CAKjC,CAAC"}

package/dist/ai-digest-constants.mjs

@@ -1,4 +1,6 @@
 export const controllerName = 'AiDigestController';
+export const CACHE_DURATION_MS = 10 * 60 * 1000; // 10 minutes
+export const MAX_CACHE_ENTRIES = 50;
 export const AiDigestControllerErrorMessage = {
     API_REQUEST_FAILED: 'API request failed',
     API_INVALID_RESPONSE: 'API returned invalid response',

package/dist/ai-digest-constants.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ai-digest-constants.mjs","sourceRoot":"","sources":["../src/ai-digest-constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,oBAAoB,CAAC;AAEnD,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,kBAAkB,EAAE,oBAAoB;IACxC,oBAAoB,EAAE,+BAA+B;IACrD,wBAAwB,EAAE,0BAA0B;IACpD,qBAAqB,EAAE,uBAAuB;CACtC,CAAC","sourcesContent":["export const controllerName = 'AiDigestController';\n\nexport const AiDigestControllerErrorMessage = {\n  API_REQUEST_FAILED: 'API request failed',\n  API_INVALID_RESPONSE: 'API returned invalid response',\n  INVALID_ASSET_IDENTIFIER: 'Invalid asset identifier',\n  INVALID_FRONT_PAGE_ID: 'Invalid front page id',\n} as const;\n"]}
+{"version":3,"file":"ai-digest-constants.mjs","sourceRoot":"","sources":["../src/ai-digest-constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,oBAAoB,CAAC;AAEnD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;AAE9D,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,kBAAkB,EAAE,oBAAoB;IACxC,oBAAoB,EAAE,+BAA+B;IACrD,wBAAwB,EAAE,0BAA0B;IACpD,qBAAqB,EAAE,uBAAuB;CACtC,CAAC","sourcesContent":["export const controllerName = 'AiDigestController';\n\nexport const CACHE_DURATION_MS = 10 * 60 * 1000; // 10 minutes\n\nexport const MAX_CACHE_ENTRIES = 50;\n\nexport const AiDigestControllerErrorMessage = {\n  API_REQUEST_FAILED: 'API request failed',\n  API_INVALID_RESPONSE: 'API returned invalid response',\n  INVALID_ASSET_IDENTIFIER: 'Invalid asset identifier',\n  INVALID_FRONT_PAGE_ID: 'Invalid front page id',\n} as const;\n"]}

package/dist/ai-digest-types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ai-digest-types.cjs","sourceRoot":"","sources":["../src/ai-digest-types.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E","sourcesContent":["// ---------------------------------------------------------------------------\n// Shared sub-types\n// ---------------------------------------------------------------------------\n\n/**\n * A news article referenced by a trend.\n */\nexport type Article = {\n  /** Article title */\n  title: string;\n  /** Full URL to the article */\n  url: string;\n  /** Source domain name (e.g. \"coindesk.com\") */\n  source: string;\n  /** ISO date string */\n  date: string;\n};\n\n/**\n * A social media post referenced by a trend.\n */\nexport type Tweet = {\n  /** Summary of the tweet content */\n  contentSummary: string;\n  /** Full URL to the tweet */\n  url: string;\n  /** Author handle (e.g. \"@saylordocs\") */\n  author: string;\n  /** ISO date string */\n  date: string;\n};\n\n/**\n * A data source used to generate a report.\n */\nexport type Source = {\n  /** Source name (e.g. \"CoinDesk\") */\n  name: string;\n  /** Source URL */\n  url: string;\n  /** Source type */\n  type: 'news' | 'data' | 'social';\n};\n\nexport type MarketInsightsArticle = Article;\nexport type MarketInsightsTweet = Tweet;\nexport type MarketInsightsSource = Source;\n\n// ---------------------------------------------------------------------------\n// Market Insights types (asset-specific)\n// ---------------------------------------------------------------------------\n\n/**\n * A key market trend identified in the insights report.\n */\nexport type MarketInsightsTrend = {\n  /** Trend title (e.g. \"Institutions Buying the Dip\") */\n  title: string;\n  /** Detailed description of the trend */\n  description: string;\n  /** Category of the trend */\n  category:\n    | 'geopolitical'\n    | 'macro'\n    | 'regulatory'\n    | 'technical'\n    | 'social'\n    | 'other';\n  /** Impact direction */\n  impact: 'positive' | 'negative' | 'neutral';\n  /** Related news articles */\n  articles: Article[];\n  /** Related social media posts */\n  tweets: Tweet[];\n};\n\n/**\n * AI-generated market insights report for a crypto asset.\n * Returned by `GET /asset-summary?asset=<identifier>`.\n */\nexport type MarketInsightsReport = {\n  /** Unique identifier for this digest, sourced from the API response envelope. */\n  digestId: string;\n  /** API version */\n  version?: string;\n  /** Asset symbol (lowercase, e.g. \"btc\") */\n  asset: string;\n  /** ISO date string when the report was generated */\n  generatedAt: string;\n  /** Main headline */\n  headline: string;\n  /** Summary paragraph */\n  summary: string;\n  /** Key market trends */\n  trends: MarketInsightsTrend[];\n  /** Optional top-level social posts included by the API */\n  social?: Tweet[];\n  /** Data sources used to generate the report */\n  sources: Source[];\n  /** Provider metadata */\n  metadata?: AIResponseMetadata[];\n};\n\n// ---------------------------------------------------------------------------\n// Market Overview types (non-asset-specific)\n// ---------------------------------------------------------------------------\n\n/**\n * A crypto asset related to a market overview trend.\n * Returned by the `/market-overview` API as a rich object.\n */\nexport type RelatedAsset = {\n  /**\n   * Human-readable asset name (e.g. \"Bitcoin\"). Optional — clients must fall\n   * back to `symbol` when absent.\n   */\n  name?: string;\n  /** Ticker symbol (e.g. \"BTC\"). The only field guaranteed to be present. */\n  symbol: string;\n  /**\n   * CAIP-19 identifiers for this asset across chains. May be absent for\n   * purely synthetic / perps-only assets (e.g. ETHFI). The service\n   * normalises missing values to `[]`.\n   */\n  caip19?: string[];\n  /**\n   * Canonical source asset identifier (e.g. \"bitcoin\"). Optional — may be\n   * absent when the API pipeline cannot enrich the asset record.\n   */\n  sourceAssetId?: string;\n  /**\n   * Optional HyperLiquid market identifiers for this asset (e.g. `BTC`, `ETH`,\n   * `xyz:TSLA`). Covers both regular crypto tokens that trade on HyperLiquid\n   * and purely synthetic perps assets. Use this to resolve Perps icon URLs via\n   * `getAssetIconUrls` on clients when `caip19` is empty.\n   */\n  hlPerpsMarket?: string[];\n};\n\nexport type MarketOverviewTrend = {\n  title: string;\n  description: string;\n  category?:\n    | 'geopolitical'\n    | 'macro'\n    | 'regulatory'\n    | 'technical'\n    | 'social'\n    | 'other';\n  impact?: 'positive' | 'negative' | 'neutral';\n  articles: Article[];\n  relatedAssets: RelatedAsset[];\n};\n\n/**\n * Provider metadata included in AI API responses.\n */\nexport type AIResponseMetadata = {\n  provider: string;\n};\n\nexport type MarketOverview = {\n  version?: string;\n  generatedAt: string;\n  trends: MarketOverviewTrend[];\n  metadata?: AIResponseMetadata[];\n};\n\n/**\n * A single market overview item. Shares the exact same schema as a\n * {@link MarketOverviewTrend} — i.e. one entry of `MarketOverview.trends`.\n */\nexport type MarketOverviewItem = MarketOverviewTrend;\n\n/**\n * A market overview \"front page\": a single AI-selected item (mirroring the\n * front page of a newspaper) plus its call-to-action copy, addressable by id.\n *\n * Returned by `GET /market-overview/front-page/:id` (and `.../latest`). Unlike\n * `/market-overview`, which only ever returns the latest report, this lets\n * clients fetch an older item that has since dropped out of the report.\n */\nexport type MarketOverviewFrontPage = {\n  /** Unique identifier of the front-page row (UUID). */\n  id: string;\n  /** The selected item — same schema as an individual market overview item. */\n  item: MarketOverviewItem;\n  /** Call-to-action title for the front-page item. */\n  ctaTitle: string;\n  /** Call-to-action description for the front-page item. */\n  ctaDescription: string;\n  /** ISO date string when the front-page row was created. */\n  createdAt: string;\n};\n\n// ---------------------------------------------------------------------------\n// Controller state\n// ---------------------------------------------------------------------------\n\n/**\n * AiDigestController has no persisted cache. Digest freshness is owned by\n * clients (e.g. React Query).\n */\nexport type AiDigestControllerState = Record<string, never>;\n\n// ---------------------------------------------------------------------------\n// Service interface\n// ---------------------------------------------------------------------------\n\nexport type DigestService = {\n  /**\n   * Search for market insights by asset identifier.\n   *\n   * Accepts any identifier the API understands — CAIP-19 asset type\n   * (e.g. `eip155:1/slip44:60`), ticker symbol (e.g. `ETH`), asset name\n   * (e.g. `Bitcoin`), or HyperLiquid perps market id (e.g. `xyz:TSLA`).\n   *\n   * Calls `GET /asset-summary?asset=<assetIdentifier>`.\n   *\n   * @param assetIdentifier - The asset identifier.\n   * @returns The market insights report, or `null` if no insights exist (404).\n   */\n  searchDigest(assetIdentifier: string): Promise<MarketInsightsReport | null>;\n\n  /**\n   * Fetch the market overview report.\n   * Calls `GET /market-overview`.\n   *\n   * @returns The market overview report, or `null` if none exists (404).\n   */\n  fetchMarketOverview(): Promise<MarketOverview | null>;\n\n  /**\n   * Fetch a single market overview front page by id.\n   * Calls `GET /market-overview/front-page/:id`.\n   *\n   * @param id - The front-page identifier (UUID).\n   * @returns The market overview front page, or `null` if none exists (404).\n   */\n  fetchFrontPageItem(id: string): Promise<MarketOverviewFrontPage | null>;\n};\n"]}
+{"version":3,"file":"ai-digest-types.cjs","sourceRoot":"","sources":["../src/ai-digest-types.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E","sourcesContent":["// ---------------------------------------------------------------------------\n// Shared sub-types\n// ---------------------------------------------------------------------------\n\n/**\n * A news article referenced by a trend.\n */\nexport type Article = {\n  /** Article title */\n  title: string;\n  /** Full URL to the article */\n  url: string;\n  /** Source domain name (e.g. \"coindesk.com\") */\n  source: string;\n  /** ISO date string */\n  date: string;\n};\n\n/**\n * A social media post referenced by a trend.\n */\nexport type Tweet = {\n  /** Summary of the tweet content */\n  contentSummary: string;\n  /** Full URL to the tweet */\n  url: string;\n  /** Author handle (e.g. \"@saylordocs\") */\n  author: string;\n  /** ISO date string */\n  date: string;\n};\n\n/**\n * A data source used to generate a report.\n */\nexport type Source = {\n  /** Source name (e.g. \"CoinDesk\") */\n  name: string;\n  /** Source URL */\n  url: string;\n  /** Source type */\n  type: 'news' | 'data' | 'social';\n};\n\nexport type MarketInsightsArticle = Article;\nexport type MarketInsightsTweet = Tweet;\nexport type MarketInsightsSource = Source;\n\n// ---------------------------------------------------------------------------\n// Market Insights types (asset-specific)\n// ---------------------------------------------------------------------------\n\n/**\n * A key market trend identified in the insights report.\n */\nexport type MarketInsightsTrend = {\n  /** Trend title (e.g. \"Institutions Buying the Dip\") */\n  title: string;\n  /** Detailed description of the trend */\n  description: string;\n  /** Category of the trend */\n  category:\n    | 'geopolitical'\n    | 'macro'\n    | 'regulatory'\n    | 'technical'\n    | 'social'\n    | 'other';\n  /** Impact direction */\n  impact: 'positive' | 'negative' | 'neutral';\n  /** Related news articles */\n  articles: Article[];\n  /** Related social media posts */\n  tweets: Tweet[];\n};\n\n/**\n * AI-generated market insights report for a crypto asset.\n * Returned by `GET /asset-summary?asset=<identifier>`.\n */\nexport type MarketInsightsReport = {\n  /** Unique identifier for this digest, sourced from the API response envelope. */\n  digestId: string;\n  /** API version */\n  version?: string;\n  /** Asset symbol (lowercase, e.g. \"btc\") */\n  asset: string;\n  /** ISO date string when the report was generated */\n  generatedAt: string;\n  /** Main headline */\n  headline: string;\n  /** Summary paragraph */\n  summary: string;\n  /** Key market trends */\n  trends: MarketInsightsTrend[];\n  /** Optional top-level social posts included by the API */\n  social?: Tweet[];\n  /** Data sources used to generate the report */\n  sources: Source[];\n  /** Provider metadata */\n  metadata?: AIResponseMetadata[];\n};\n\n/**\n * A cached market insights entry.\n */\nexport type MarketInsightsEntry = {\n  /** Asset identifier — either a CAIP-19 ID (e.g. \"eip155:1/slip44:60\") or a perps market symbol (e.g. \"ETH\") */\n  assetIdentifier: string;\n  /** Timestamp when the entry was fetched */\n  fetchedAt: number;\n  /** The market insights report data */\n  data: MarketInsightsReport;\n};\n\n/**\n * A cached market overview entry.\n */\nexport type MarketOverviewEntry = {\n  /** Timestamp when the entry was fetched */\n  fetchedAt: number;\n  /** The market overview data */\n  data: MarketOverview;\n};\n\n// ---------------------------------------------------------------------------\n// Market Overview types (non-asset-specific)\n// ---------------------------------------------------------------------------\n\n/**\n * A crypto asset related to a market overview trend.\n * Returned by the `/market-overview` API as a rich object.\n */\nexport type RelatedAsset = {\n  /**\n   * Human-readable asset name (e.g. \"Bitcoin\"). Optional — clients must fall\n   * back to `symbol` when absent.\n   */\n  name?: string;\n  /** Ticker symbol (e.g. \"BTC\"). The only field guaranteed to be present. */\n  symbol: string;\n  /**\n   * CAIP-19 identifiers for this asset across chains. May be absent for\n   * purely synthetic / perps-only assets (e.g. ETHFI). The service\n   * normalises missing values to `[]`.\n   */\n  caip19?: string[];\n  /**\n   * Canonical source asset identifier (e.g. \"bitcoin\"). Optional — may be\n   * absent when the API pipeline cannot enrich the asset record.\n   */\n  sourceAssetId?: string;\n  /**\n   * Optional HyperLiquid market identifiers for this asset (e.g. `BTC`, `ETH`,\n   * `xyz:TSLA`). Covers both regular crypto tokens that trade on HyperLiquid\n   * and purely synthetic perps assets. Use this to resolve Perps icon URLs via\n   * `getAssetIconUrls` on clients when `caip19` is empty.\n   */\n  hlPerpsMarket?: string[];\n};\n\nexport type MarketOverviewTrend = {\n  title: string;\n  description: string;\n  category?:\n    | 'geopolitical'\n    | 'macro'\n    | 'regulatory'\n    | 'technical'\n    | 'social'\n    | 'other';\n  impact?: 'positive' | 'negative' | 'neutral';\n  articles: Article[];\n  relatedAssets: RelatedAsset[];\n};\n\n/**\n * Provider metadata included in AI API responses.\n */\nexport type AIResponseMetadata = {\n  provider: string;\n};\n\nexport type MarketOverview = {\n  version?: string;\n  generatedAt: string;\n  trends: MarketOverviewTrend[];\n  metadata?: AIResponseMetadata[];\n};\n\n/**\n * A single market overview item. Shares the exact same schema as a\n * {@link MarketOverviewTrend} — i.e. one entry of `MarketOverview.trends`.\n */\nexport type MarketOverviewItem = MarketOverviewTrend;\n\n/**\n * A market overview \"front page\": a single AI-selected item (mirroring the\n * front page of a newspaper) plus its call-to-action copy, addressable by id.\n *\n * Returned by `GET /market-overview/front-page/:id` (and `.../latest`). Unlike\n * `/market-overview`, which only ever returns the latest report, this lets\n * clients fetch an older item that has since dropped out of the report.\n */\nexport type MarketOverviewFrontPage = {\n  /** Unique identifier of the front-page row (UUID). */\n  id: string;\n  /** The selected item — same schema as an individual market overview item. */\n  item: MarketOverviewItem;\n  /** Call-to-action title for the front-page item. */\n  ctaTitle: string;\n  /** Call-to-action description for the front-page item. */\n  ctaDescription: string;\n  /** ISO date string when the front-page row was created. */\n  createdAt: string;\n};\n\n// ---------------------------------------------------------------------------\n// Controller state\n// ---------------------------------------------------------------------------\n\nexport type AiDigestControllerState = {\n  marketInsights: Record<string, MarketInsightsEntry>;\n  marketOverview: MarketOverviewEntry | null;\n};\n\n// ---------------------------------------------------------------------------\n// Service interface\n// ---------------------------------------------------------------------------\n\nexport type DigestService = {\n  /**\n   * Search for market insights by asset identifier.\n   *\n   * Accepts any identifier the API understands — CAIP-19 asset type\n   * (e.g. `eip155:1/slip44:60`), ticker symbol (e.g. `ETH`), asset name\n   * (e.g. `Bitcoin`), or HyperLiquid perps market id (e.g. `xyz:TSLA`).\n   *\n   * Calls `GET /asset-summary?asset=<assetIdentifier>`.\n   *\n   * @param assetIdentifier - The asset identifier.\n   * @returns The market insights report, or `null` if no insights exist (404).\n   */\n  searchDigest(assetIdentifier: string): Promise<MarketInsightsReport | null>;\n\n  /**\n   * Fetch the market overview report.\n   * Calls `GET /market-overview`.\n   *\n   * @returns The market overview report, or `null` if none exists (404).\n   */\n  fetchMarketOverview(): Promise<MarketOverview | null>;\n\n  /**\n   * Fetch a single market overview front page by id.\n   * Calls `GET /market-overview/front-page/:id`.\n   *\n   * @param id - The front-page identifier (UUID).\n   * @returns The market overview front page, or `null` if none exists (404).\n   */\n  fetchFrontPageItem(id: string): Promise<MarketOverviewFrontPage | null>;\n};\n"]}

package/dist/ai-digest-types.d.cts

@@ -81,6 +81,26 @@ export type MarketInsightsReport = {
     /** Provider metadata */
     metadata?: AIResponseMetadata[];
 };
+/**
+ * A cached market insights entry.
+ */
+export type MarketInsightsEntry = {
+    /** Asset identifier — either a CAIP-19 ID (e.g. "eip155:1/slip44:60") or a perps market symbol (e.g. "ETH") */
+    assetIdentifier: string;
+    /** Timestamp when the entry was fetched */
+    fetchedAt: number;
+    /** The market insights report data */
+    data: MarketInsightsReport;
+};
+/**
+ * A cached market overview entry.
+ */
+export type MarketOverviewEntry = {
+    /** Timestamp when the entry was fetched */
+    fetchedAt: number;
+    /** The market overview data */
+    data: MarketOverview;
+};
 /**
  * A crypto asset related to a market overview trend.
  * Returned by the `/market-overview` API as a rich object.
@@ -157,11 +177,10 @@ export type MarketOverviewFrontPage = {
     /** ISO date string when the front-page row was created. */
     createdAt: string;
 };
-/**
- * AiDigestController has no persisted cache. Digest freshness is owned by
- * clients (e.g. React Query).
- */
-export type AiDigestControllerState = Record<string, never>;
+export type AiDigestControllerState = {
+    marketInsights: Record<string, MarketInsightsEntry>;
+    marketOverview: MarketOverviewEntry | null;
+};
 export type DigestService = {
     /**
      * Search for market insights by asset identifier.

package/dist/ai-digest-types.d.cts.map

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

package/dist/ai-digest-types.d.mts

@@ -81,6 +81,26 @@ export type MarketInsightsReport = {
     /** Provider metadata */
     metadata?: AIResponseMetadata[];
 };
+/**
+ * A cached market insights entry.
+ */
+export type MarketInsightsEntry = {
+    /** Asset identifier — either a CAIP-19 ID (e.g. "eip155:1/slip44:60") or a perps market symbol (e.g. "ETH") */
+    assetIdentifier: string;
+    /** Timestamp when the entry was fetched */
+    fetchedAt: number;
+    /** The market insights report data */
+    data: MarketInsightsReport;
+};
+/**
+ * A cached market overview entry.
+ */
+export type MarketOverviewEntry = {
+    /** Timestamp when the entry was fetched */
+    fetchedAt: number;
+    /** The market overview data */
+    data: MarketOverview;
+};
 /**
  * A crypto asset related to a market overview trend.
  * Returned by the `/market-overview` API as a rich object.
@@ -157,11 +177,10 @@ export type MarketOverviewFrontPage = {
     /** ISO date string when the front-page row was created. */
     createdAt: string;
 };
-/**
- * AiDigestController has no persisted cache. Digest freshness is owned by
- * clients (e.g. React Query).
- */
-export type AiDigestControllerState = Record<string, never>;
+export type AiDigestControllerState = {
+    marketInsights: Record<string, MarketInsightsEntry>;
+    marketOverview: MarketOverviewEntry | null;
+};
 export type DigestService = {
     /**
      * Search for market insights by asset identifier.

package/dist/ai-digest-types.d.mts.map

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

package/dist/ai-digest-types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ai-digest-types.mjs","sourceRoot":"","sources":["../src/ai-digest-types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E","sourcesContent":["// ---------------------------------------------------------------------------\n// Shared sub-types\n// ---------------------------------------------------------------------------\n\n/**\n * A news article referenced by a trend.\n */\nexport type Article = {\n  /** Article title */\n  title: string;\n  /** Full URL to the article */\n  url: string;\n  /** Source domain name (e.g. \"coindesk.com\") */\n  source: string;\n  /** ISO date string */\n  date: string;\n};\n\n/**\n * A social media post referenced by a trend.\n */\nexport type Tweet = {\n  /** Summary of the tweet content */\n  contentSummary: string;\n  /** Full URL to the tweet */\n  url: string;\n  /** Author handle (e.g. \"@saylordocs\") */\n  author: string;\n  /** ISO date string */\n  date: string;\n};\n\n/**\n * A data source used to generate a report.\n */\nexport type Source = {\n  /** Source name (e.g. \"CoinDesk\") */\n  name: string;\n  /** Source URL */\n  url: string;\n  /** Source type */\n  type: 'news' | 'data' | 'social';\n};\n\nexport type MarketInsightsArticle = Article;\nexport type MarketInsightsTweet = Tweet;\nexport type MarketInsightsSource = Source;\n\n// ---------------------------------------------------------------------------\n// Market Insights types (asset-specific)\n// ---------------------------------------------------------------------------\n\n/**\n * A key market trend identified in the insights report.\n */\nexport type MarketInsightsTrend = {\n  /** Trend title (e.g. \"Institutions Buying the Dip\") */\n  title: string;\n  /** Detailed description of the trend */\n  description: string;\n  /** Category of the trend */\n  category:\n    | 'geopolitical'\n    | 'macro'\n    | 'regulatory'\n    | 'technical'\n    | 'social'\n    | 'other';\n  /** Impact direction */\n  impact: 'positive' | 'negative' | 'neutral';\n  /** Related news articles */\n  articles: Article[];\n  /** Related social media posts */\n  tweets: Tweet[];\n};\n\n/**\n * AI-generated market insights report for a crypto asset.\n * Returned by `GET /asset-summary?asset=<identifier>`.\n */\nexport type MarketInsightsReport = {\n  /** Unique identifier for this digest, sourced from the API response envelope. */\n  digestId: string;\n  /** API version */\n  version?: string;\n  /** Asset symbol (lowercase, e.g. \"btc\") */\n  asset: string;\n  /** ISO date string when the report was generated */\n  generatedAt: string;\n  /** Main headline */\n  headline: string;\n  /** Summary paragraph */\n  summary: string;\n  /** Key market trends */\n  trends: MarketInsightsTrend[];\n  /** Optional top-level social posts included by the API */\n  social?: Tweet[];\n  /** Data sources used to generate the report */\n  sources: Source[];\n  /** Provider metadata */\n  metadata?: AIResponseMetadata[];\n};\n\n// ---------------------------------------------------------------------------\n// Market Overview types (non-asset-specific)\n// ---------------------------------------------------------------------------\n\n/**\n * A crypto asset related to a market overview trend.\n * Returned by the `/market-overview` API as a rich object.\n */\nexport type RelatedAsset = {\n  /**\n   * Human-readable asset name (e.g. \"Bitcoin\"). Optional — clients must fall\n   * back to `symbol` when absent.\n   */\n  name?: string;\n  /** Ticker symbol (e.g. \"BTC\"). The only field guaranteed to be present. */\n  symbol: string;\n  /**\n   * CAIP-19 identifiers for this asset across chains. May be absent for\n   * purely synthetic / perps-only assets (e.g. ETHFI). The service\n   * normalises missing values to `[]`.\n   */\n  caip19?: string[];\n  /**\n   * Canonical source asset identifier (e.g. \"bitcoin\"). Optional — may be\n   * absent when the API pipeline cannot enrich the asset record.\n   */\n  sourceAssetId?: string;\n  /**\n   * Optional HyperLiquid market identifiers for this asset (e.g. `BTC`, `ETH`,\n   * `xyz:TSLA`). Covers both regular crypto tokens that trade on HyperLiquid\n   * and purely synthetic perps assets. Use this to resolve Perps icon URLs via\n   * `getAssetIconUrls` on clients when `caip19` is empty.\n   */\n  hlPerpsMarket?: string[];\n};\n\nexport type MarketOverviewTrend = {\n  title: string;\n  description: string;\n  category?:\n    | 'geopolitical'\n    | 'macro'\n    | 'regulatory'\n    | 'technical'\n    | 'social'\n    | 'other';\n  impact?: 'positive' | 'negative' | 'neutral';\n  articles: Article[];\n  relatedAssets: RelatedAsset[];\n};\n\n/**\n * Provider metadata included in AI API responses.\n */\nexport type AIResponseMetadata = {\n  provider: string;\n};\n\nexport type MarketOverview = {\n  version?: string;\n  generatedAt: string;\n  trends: MarketOverviewTrend[];\n  metadata?: AIResponseMetadata[];\n};\n\n/**\n * A single market overview item. Shares the exact same schema as a\n * {@link MarketOverviewTrend} — i.e. one entry of `MarketOverview.trends`.\n */\nexport type MarketOverviewItem = MarketOverviewTrend;\n\n/**\n * A market overview \"front page\": a single AI-selected item (mirroring the\n * front page of a newspaper) plus its call-to-action copy, addressable by id.\n *\n * Returned by `GET /market-overview/front-page/:id` (and `.../latest`). Unlike\n * `/market-overview`, which only ever returns the latest report, this lets\n * clients fetch an older item that has since dropped out of the report.\n */\nexport type MarketOverviewFrontPage = {\n  /** Unique identifier of the front-page row (UUID). */\n  id: string;\n  /** The selected item — same schema as an individual market overview item. */\n  item: MarketOverviewItem;\n  /** Call-to-action title for the front-page item. */\n  ctaTitle: string;\n  /** Call-to-action description for the front-page item. */\n  ctaDescription: string;\n  /** ISO date string when the front-page row was created. */\n  createdAt: string;\n};\n\n// ---------------------------------------------------------------------------\n// Controller state\n// ---------------------------------------------------------------------------\n\n/**\n * AiDigestController has no persisted cache. Digest freshness is owned by\n * clients (e.g. React Query).\n */\nexport type AiDigestControllerState = Record<string, never>;\n\n// ---------------------------------------------------------------------------\n// Service interface\n// ---------------------------------------------------------------------------\n\nexport type DigestService = {\n  /**\n   * Search for market insights by asset identifier.\n   *\n   * Accepts any identifier the API understands — CAIP-19 asset type\n   * (e.g. `eip155:1/slip44:60`), ticker symbol (e.g. `ETH`), asset name\n   * (e.g. `Bitcoin`), or HyperLiquid perps market id (e.g. `xyz:TSLA`).\n   *\n   * Calls `GET /asset-summary?asset=<assetIdentifier>`.\n   *\n   * @param assetIdentifier - The asset identifier.\n   * @returns The market insights report, or `null` if no insights exist (404).\n   */\n  searchDigest(assetIdentifier: string): Promise<MarketInsightsReport | null>;\n\n  /**\n   * Fetch the market overview report.\n   * Calls `GET /market-overview`.\n   *\n   * @returns The market overview report, or `null` if none exists (404).\n   */\n  fetchMarketOverview(): Promise<MarketOverview | null>;\n\n  /**\n   * Fetch a single market overview front page by id.\n   * Calls `GET /market-overview/front-page/:id`.\n   *\n   * @param id - The front-page identifier (UUID).\n   * @returns The market overview front page, or `null` if none exists (404).\n   */\n  fetchFrontPageItem(id: string): Promise<MarketOverviewFrontPage | null>;\n};\n"]}
+{"version":3,"file":"ai-digest-types.mjs","sourceRoot":"","sources":["../src/ai-digest-types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E","sourcesContent":["// ---------------------------------------------------------------------------\n// Shared sub-types\n// ---------------------------------------------------------------------------\n\n/**\n * A news article referenced by a trend.\n */\nexport type Article = {\n  /** Article title */\n  title: string;\n  /** Full URL to the article */\n  url: string;\n  /** Source domain name (e.g. \"coindesk.com\") */\n  source: string;\n  /** ISO date string */\n  date: string;\n};\n\n/**\n * A social media post referenced by a trend.\n */\nexport type Tweet = {\n  /** Summary of the tweet content */\n  contentSummary: string;\n  /** Full URL to the tweet */\n  url: string;\n  /** Author handle (e.g. \"@saylordocs\") */\n  author: string;\n  /** ISO date string */\n  date: string;\n};\n\n/**\n * A data source used to generate a report.\n */\nexport type Source = {\n  /** Source name (e.g. \"CoinDesk\") */\n  name: string;\n  /** Source URL */\n  url: string;\n  /** Source type */\n  type: 'news' | 'data' | 'social';\n};\n\nexport type MarketInsightsArticle = Article;\nexport type MarketInsightsTweet = Tweet;\nexport type MarketInsightsSource = Source;\n\n// ---------------------------------------------------------------------------\n// Market Insights types (asset-specific)\n// ---------------------------------------------------------------------------\n\n/**\n * A key market trend identified in the insights report.\n */\nexport type MarketInsightsTrend = {\n  /** Trend title (e.g. \"Institutions Buying the Dip\") */\n  title: string;\n  /** Detailed description of the trend */\n  description: string;\n  /** Category of the trend */\n  category:\n    | 'geopolitical'\n    | 'macro'\n    | 'regulatory'\n    | 'technical'\n    | 'social'\n    | 'other';\n  /** Impact direction */\n  impact: 'positive' | 'negative' | 'neutral';\n  /** Related news articles */\n  articles: Article[];\n  /** Related social media posts */\n  tweets: Tweet[];\n};\n\n/**\n * AI-generated market insights report for a crypto asset.\n * Returned by `GET /asset-summary?asset=<identifier>`.\n */\nexport type MarketInsightsReport = {\n  /** Unique identifier for this digest, sourced from the API response envelope. */\n  digestId: string;\n  /** API version */\n  version?: string;\n  /** Asset symbol (lowercase, e.g. \"btc\") */\n  asset: string;\n  /** ISO date string when the report was generated */\n  generatedAt: string;\n  /** Main headline */\n  headline: string;\n  /** Summary paragraph */\n  summary: string;\n  /** Key market trends */\n  trends: MarketInsightsTrend[];\n  /** Optional top-level social posts included by the API */\n  social?: Tweet[];\n  /** Data sources used to generate the report */\n  sources: Source[];\n  /** Provider metadata */\n  metadata?: AIResponseMetadata[];\n};\n\n/**\n * A cached market insights entry.\n */\nexport type MarketInsightsEntry = {\n  /** Asset identifier — either a CAIP-19 ID (e.g. \"eip155:1/slip44:60\") or a perps market symbol (e.g. \"ETH\") */\n  assetIdentifier: string;\n  /** Timestamp when the entry was fetched */\n  fetchedAt: number;\n  /** The market insights report data */\n  data: MarketInsightsReport;\n};\n\n/**\n * A cached market overview entry.\n */\nexport type MarketOverviewEntry = {\n  /** Timestamp when the entry was fetched */\n  fetchedAt: number;\n  /** The market overview data */\n  data: MarketOverview;\n};\n\n// ---------------------------------------------------------------------------\n// Market Overview types (non-asset-specific)\n// ---------------------------------------------------------------------------\n\n/**\n * A crypto asset related to a market overview trend.\n * Returned by the `/market-overview` API as a rich object.\n */\nexport type RelatedAsset = {\n  /**\n   * Human-readable asset name (e.g. \"Bitcoin\"). Optional — clients must fall\n   * back to `symbol` when absent.\n   */\n  name?: string;\n  /** Ticker symbol (e.g. \"BTC\"). The only field guaranteed to be present. */\n  symbol: string;\n  /**\n   * CAIP-19 identifiers for this asset across chains. May be absent for\n   * purely synthetic / perps-only assets (e.g. ETHFI). The service\n   * normalises missing values to `[]`.\n   */\n  caip19?: string[];\n  /**\n   * Canonical source asset identifier (e.g. \"bitcoin\"). Optional — may be\n   * absent when the API pipeline cannot enrich the asset record.\n   */\n  sourceAssetId?: string;\n  /**\n   * Optional HyperLiquid market identifiers for this asset (e.g. `BTC`, `ETH`,\n   * `xyz:TSLA`). Covers both regular crypto tokens that trade on HyperLiquid\n   * and purely synthetic perps assets. Use this to resolve Perps icon URLs via\n   * `getAssetIconUrls` on clients when `caip19` is empty.\n   */\n  hlPerpsMarket?: string[];\n};\n\nexport type MarketOverviewTrend = {\n  title: string;\n  description: string;\n  category?:\n    | 'geopolitical'\n    | 'macro'\n    | 'regulatory'\n    | 'technical'\n    | 'social'\n    | 'other';\n  impact?: 'positive' | 'negative' | 'neutral';\n  articles: Article[];\n  relatedAssets: RelatedAsset[];\n};\n\n/**\n * Provider metadata included in AI API responses.\n */\nexport type AIResponseMetadata = {\n  provider: string;\n};\n\nexport type MarketOverview = {\n  version?: string;\n  generatedAt: string;\n  trends: MarketOverviewTrend[];\n  metadata?: AIResponseMetadata[];\n};\n\n/**\n * A single market overview item. Shares the exact same schema as a\n * {@link MarketOverviewTrend} — i.e. one entry of `MarketOverview.trends`.\n */\nexport type MarketOverviewItem = MarketOverviewTrend;\n\n/**\n * A market overview \"front page\": a single AI-selected item (mirroring the\n * front page of a newspaper) plus its call-to-action copy, addressable by id.\n *\n * Returned by `GET /market-overview/front-page/:id` (and `.../latest`). Unlike\n * `/market-overview`, which only ever returns the latest report, this lets\n * clients fetch an older item that has since dropped out of the report.\n */\nexport type MarketOverviewFrontPage = {\n  /** Unique identifier of the front-page row (UUID). */\n  id: string;\n  /** The selected item — same schema as an individual market overview item. */\n  item: MarketOverviewItem;\n  /** Call-to-action title for the front-page item. */\n  ctaTitle: string;\n  /** Call-to-action description for the front-page item. */\n  ctaDescription: string;\n  /** ISO date string when the front-page row was created. */\n  createdAt: string;\n};\n\n// ---------------------------------------------------------------------------\n// Controller state\n// ---------------------------------------------------------------------------\n\nexport type AiDigestControllerState = {\n  marketInsights: Record<string, MarketInsightsEntry>;\n  marketOverview: MarketOverviewEntry | null;\n};\n\n// ---------------------------------------------------------------------------\n// Service interface\n// ---------------------------------------------------------------------------\n\nexport type DigestService = {\n  /**\n   * Search for market insights by asset identifier.\n   *\n   * Accepts any identifier the API understands — CAIP-19 asset type\n   * (e.g. `eip155:1/slip44:60`), ticker symbol (e.g. `ETH`), asset name\n   * (e.g. `Bitcoin`), or HyperLiquid perps market id (e.g. `xyz:TSLA`).\n   *\n   * Calls `GET /asset-summary?asset=<assetIdentifier>`.\n   *\n   * @param assetIdentifier - The asset identifier.\n   * @returns The market insights report, or `null` if no insights exist (404).\n   */\n  searchDigest(assetIdentifier: string): Promise<MarketInsightsReport | null>;\n\n  /**\n   * Fetch the market overview report.\n   * Calls `GET /market-overview`.\n   *\n   * @returns The market overview report, or `null` if none exists (404).\n   */\n  fetchMarketOverview(): Promise<MarketOverview | null>;\n\n  /**\n   * Fetch a single market overview front page by id.\n   * Calls `GET /market-overview/front-page/:id`.\n   *\n   * @param id - The front-page identifier (UUID).\n   * @returns The market overview front page, or `null` if none exists (404).\n   */\n  fetchFrontPageItem(id: string): Promise<MarketOverviewFrontPage | null>;\n};\n"]}

package/dist/index.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AiDigestControllerErrorMessage = exports.aiDigestControllerName = exports.AiDigestService = exports.getDefaultAiDigestControllerState = exports.AiDigestController = void 0;
+exports.AiDigestControllerErrorMessage = exports.MAX_CACHE_ENTRIES = exports.CACHE_DURATION_MS = exports.aiDigestControllerName = exports.AiDigestService = exports.getDefaultAiDigestControllerState = exports.AiDigestController = void 0;
 var AiDigestController_js_1 = require("./AiDigestController.cjs");
 Object.defineProperty(exports, "AiDigestController", { enumerable: true, get: function () { return AiDigestController_js_1.AiDigestController; } });
 Object.defineProperty(exports, "getDefaultAiDigestControllerState", { enumerable: true, get: function () { return AiDigestController_js_1.getDefaultAiDigestControllerState; } });
@@ -8,5 +8,7 @@ var AiDigestService_js_1 = require("./AiDigestService.cjs");
 Object.defineProperty(exports, "AiDigestService", { enumerable: true, get: function () { return AiDigestService_js_1.AiDigestService; } });
 var ai_digest_constants_js_1 = require("./ai-digest-constants.cjs");
 Object.defineProperty(exports, "aiDigestControllerName", { enumerable: true, get: function () { return ai_digest_constants_js_1.controllerName; } });
+Object.defineProperty(exports, "CACHE_DURATION_MS", { enumerable: true, get: function () { return ai_digest_constants_js_1.CACHE_DURATION_MS; } });
+Object.defineProperty(exports, "MAX_CACHE_ENTRIES", { enumerable: true, get: function () { return ai_digest_constants_js_1.MAX_CACHE_ENTRIES; } });
 Object.defineProperty(exports, "AiDigestControllerErrorMessage", { enumerable: true, get: function () { return ai_digest_constants_js_1.AiDigestControllerErrorMessage; } });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAQA,kEAGiC;AAF/B,2HAAA,kBAAkB,OAAA;AAClB,0IAAA,iCAAiC,OAAA;AASnC,4DAAuD;AAA9C,qHAAA,eAAe,OAAA;AAqBxB,oEAGkC;AAFhC,gIAAA,cAAc,OAA0B;AACxC,wIAAA,8BAA8B,OAAA","sourcesContent":["export type {\n  AiDigestControllerActions,\n  AiDigestControllerEvents,\n  AiDigestControllerGetStateAction,\n  AiDigestControllerMessenger,\n  AiDigestControllerOptions,\n  AiDigestControllerStateChangeEvent,\n} from './AiDigestController.js';\nexport {\n  AiDigestController,\n  getDefaultAiDigestControllerState,\n} from './AiDigestController.js';\nexport type {\n  AiDigestControllerFetchMarketInsightsAction,\n  AiDigestControllerFetchMarketOverviewAction,\n  AiDigestControllerFetchFrontPageItemAction,\n} from './AiDigestController-method-action-types.js';\n\nexport type { AiDigestServiceConfig } from './AiDigestService.js';\nexport { AiDigestService } from './AiDigestService.js';\n\nexport type {\n  AiDigestControllerState,\n  AIResponseMetadata,\n  Article,\n  DigestService,\n  MarketInsightsArticle,\n  MarketInsightsReport,\n  MarketInsightsSource,\n  MarketInsightsTrend,\n  MarketInsightsTweet,\n  MarketOverview,\n  MarketOverviewFrontPage,\n  MarketOverviewItem,\n  MarketOverviewTrend,\n  RelatedAsset,\n  Source,\n  Tweet,\n} from './ai-digest-types.js';\n\nexport {\n  controllerName as aiDigestControllerName,\n  AiDigestControllerErrorMessage,\n} from './ai-digest-constants.js';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAQA,kEAGiC;AAF/B,2HAAA,kBAAkB,OAAA;AAClB,0IAAA,iCAAiC,OAAA;AASnC,4DAAuD;AAA9C,qHAAA,eAAe,OAAA;AAuBxB,oEAKkC;AAJhC,gIAAA,cAAc,OAA0B;AACxC,2HAAA,iBAAiB,OAAA;AACjB,2HAAA,iBAAiB,OAAA;AACjB,wIAAA,8BAA8B,OAAA","sourcesContent":["export type {\n  AiDigestControllerActions,\n  AiDigestControllerEvents,\n  AiDigestControllerGetStateAction,\n  AiDigestControllerMessenger,\n  AiDigestControllerOptions,\n  AiDigestControllerStateChangeEvent,\n} from './AiDigestController.js';\nexport {\n  AiDigestController,\n  getDefaultAiDigestControllerState,\n} from './AiDigestController.js';\nexport type {\n  AiDigestControllerFetchMarketInsightsAction,\n  AiDigestControllerFetchMarketOverviewAction,\n  AiDigestControllerFetchFrontPageItemAction,\n} from './AiDigestController-method-action-types.js';\n\nexport type { AiDigestServiceConfig } from './AiDigestService.js';\nexport { AiDigestService } from './AiDigestService.js';\n\nexport type {\n  AiDigestControllerState,\n  AIResponseMetadata,\n  Article,\n  DigestService,\n  MarketInsightsArticle,\n  MarketInsightsEntry,\n  MarketInsightsReport,\n  MarketInsightsSource,\n  MarketInsightsTrend,\n  MarketInsightsTweet,\n  MarketOverview,\n  MarketOverviewEntry,\n  MarketOverviewFrontPage,\n  MarketOverviewItem,\n  MarketOverviewTrend,\n  RelatedAsset,\n  Source,\n  Tweet,\n} from './ai-digest-types.js';\n\nexport {\n  controllerName as aiDigestControllerName,\n  CACHE_DURATION_MS,\n  MAX_CACHE_ENTRIES,\n  AiDigestControllerErrorMessage,\n} from './ai-digest-constants.js';\n"]}

package/dist/index.d.cts

@@ -3,6 +3,6 @@ export { AiDigestController, getDefaultAiDigestControllerState, } from "./AiDige
 export type { AiDigestControllerFetchMarketInsightsAction, AiDigestControllerFetchMarketOverviewAction, AiDigestControllerFetchFrontPageItemAction, } from "./AiDigestController-method-action-types.cjs";
 export type { AiDigestServiceConfig } from "./AiDigestService.cjs";
 export { AiDigestService } from "./AiDigestService.cjs";
-export type { AiDigestControllerState, AIResponseMetadata, Article, DigestService, MarketInsightsArticle, MarketInsightsReport, MarketInsightsSource, MarketInsightsTrend, MarketInsightsTweet, MarketOverview, MarketOverviewFrontPage, MarketOverviewItem, MarketOverviewTrend, RelatedAsset, Source, Tweet, } from "./ai-digest-types.cjs";
-export { controllerName as aiDigestControllerName, AiDigestControllerErrorMessage, } from "./ai-digest-constants.cjs";
+export type { AiDigestControllerState, AIResponseMetadata, Article, DigestService, MarketInsightsArticle, MarketInsightsEntry, MarketInsightsReport, MarketInsightsSource, MarketInsightsTrend, MarketInsightsTweet, MarketOverview, MarketOverviewEntry, MarketOverviewFrontPage, MarketOverviewItem, MarketOverviewTrend, RelatedAsset, Source, Tweet, } from "./ai-digest-types.cjs";
+export { controllerName as aiDigestControllerName, CACHE_DURATION_MS, MAX_CACHE_ENTRIES, AiDigestControllerErrorMessage, } from "./ai-digest-constants.cjs";
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACxB,gCAAgC,EAChC,2BAA2B,EAC3B,yBAAyB,EACzB,kCAAkC,GACnC,iCAAgC;AACjC,OAAO,EACL,kBAAkB,EAClB,iCAAiC,GAClC,iCAAgC;AACjC,YAAY,EACV,2CAA2C,EAC3C,2CAA2C,EAC3C,0CAA0C,GAC3C,qDAAoD;AAErD,YAAY,EAAE,qBAAqB,EAAE,8BAA6B;AAClE,OAAO,EAAE,eAAe,EAAE,8BAA6B;AAEvD,YAAY,EACV,uBAAuB,EACvB,kBAAkB,EAClB,OAAO,EACP,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,MAAM,EACN,KAAK,GACN,8BAA6B;AAE9B,OAAO,EACL,cAAc,IAAI,sBAAsB,EACxC,8BAA8B,GAC/B,kCAAiC"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACxB,gCAAgC,EAChC,2BAA2B,EAC3B,yBAAyB,EACzB,kCAAkC,GACnC,iCAAgC;AACjC,OAAO,EACL,kBAAkB,EAClB,iCAAiC,GAClC,iCAAgC;AACjC,YAAY,EACV,2CAA2C,EAC3C,2CAA2C,EAC3C,0CAA0C,GAC3C,qDAAoD;AAErD,YAAY,EAAE,qBAAqB,EAAE,8BAA6B;AAClE,OAAO,EAAE,eAAe,EAAE,8BAA6B;AAEvD,YAAY,EACV,uBAAuB,EACvB,kBAAkB,EAClB,OAAO,EACP,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,MAAM,EACN,KAAK,GACN,8BAA6B;AAE9B,OAAO,EACL,cAAc,IAAI,sBAAsB,EACxC,iBAAiB,EACjB,iBAAiB,EACjB,8BAA8B,GAC/B,kCAAiC"}

package/dist/index.d.mts

@@ -3,6 +3,6 @@ export { AiDigestController, getDefaultAiDigestControllerState, } from "./AiDige
 export type { AiDigestControllerFetchMarketInsightsAction, AiDigestControllerFetchMarketOverviewAction, AiDigestControllerFetchFrontPageItemAction, } from "./AiDigestController-method-action-types.mjs";
 export type { AiDigestServiceConfig } from "./AiDigestService.mjs";
 export { AiDigestService } from "./AiDigestService.mjs";
-export type { AiDigestControllerState, AIResponseMetadata, Article, DigestService, MarketInsightsArticle, MarketInsightsReport, MarketInsightsSource, MarketInsightsTrend, MarketInsightsTweet, MarketOverview, MarketOverviewFrontPage, MarketOverviewItem, MarketOverviewTrend, RelatedAsset, Source, Tweet, } from "./ai-digest-types.mjs";
-export { controllerName as aiDigestControllerName, AiDigestControllerErrorMessage, } from "./ai-digest-constants.mjs";
+export type { AiDigestControllerState, AIResponseMetadata, Article, DigestService, MarketInsightsArticle, MarketInsightsEntry, MarketInsightsReport, MarketInsightsSource, MarketInsightsTrend, MarketInsightsTweet, MarketOverview, MarketOverviewEntry, MarketOverviewFrontPage, MarketOverviewItem, MarketOverviewTrend, RelatedAsset, Source, Tweet, } from "./ai-digest-types.mjs";
+export { controllerName as aiDigestControllerName, CACHE_DURATION_MS, MAX_CACHE_ENTRIES, AiDigestControllerErrorMessage, } from "./ai-digest-constants.mjs";
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACxB,gCAAgC,EAChC,2BAA2B,EAC3B,yBAAyB,EACzB,kCAAkC,GACnC,iCAAgC;AACjC,OAAO,EACL,kBAAkB,EAClB,iCAAiC,GAClC,iCAAgC;AACjC,YAAY,EACV,2CAA2C,EAC3C,2CAA2C,EAC3C,0CAA0C,GAC3C,qDAAoD;AAErD,YAAY,EAAE,qBAAqB,EAAE,8BAA6B;AAClE,OAAO,EAAE,eAAe,EAAE,8BAA6B;AAEvD,YAAY,EACV,uBAAuB,EACvB,kBAAkB,EAClB,OAAO,EACP,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,MAAM,EACN,KAAK,GACN,8BAA6B;AAE9B,OAAO,EACL,cAAc,IAAI,sBAAsB,EACxC,8BAA8B,GAC/B,kCAAiC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACxB,gCAAgC,EAChC,2BAA2B,EAC3B,yBAAyB,EACzB,kCAAkC,GACnC,iCAAgC;AACjC,OAAO,EACL,kBAAkB,EAClB,iCAAiC,GAClC,iCAAgC;AACjC,YAAY,EACV,2CAA2C,EAC3C,2CAA2C,EAC3C,0CAA0C,GAC3C,qDAAoD;AAErD,YAAY,EAAE,qBAAqB,EAAE,8BAA6B;AAClE,OAAO,EAAE,eAAe,EAAE,8BAA6B;AAEvD,YAAY,EACV,uBAAuB,EACvB,kBAAkB,EAClB,OAAO,EACP,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,MAAM,EACN,KAAK,GACN,8BAA6B;AAE9B,OAAO,EACL,cAAc,IAAI,sBAAsB,EACxC,iBAAiB,EACjB,iBAAiB,EACjB,8BAA8B,GAC/B,kCAAiC"}

package/dist/index.mjs

@@ -1,4 +1,4 @@
 export { AiDigestController, getDefaultAiDigestControllerState } from "./AiDigestController.mjs";
 export { AiDigestService } from "./AiDigestService.mjs";
-export { controllerName as aiDigestControllerName, AiDigestControllerErrorMessage } from "./ai-digest-constants.mjs";
+export { controllerName as aiDigestControllerName, CACHE_DURATION_MS, MAX_CACHE_ENTRIES, AiDigestControllerErrorMessage } from "./ai-digest-constants.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,kBAAkB,EAClB,iCAAiC,EAClC,iCAAgC;AAQjC,OAAO,EAAE,eAAe,EAAE,8BAA6B;AAqBvD,OAAO,EACL,cAAc,IAAI,sBAAsB,EACxC,8BAA8B,EAC/B,kCAAiC","sourcesContent":["export type {\n  AiDigestControllerActions,\n  AiDigestControllerEvents,\n  AiDigestControllerGetStateAction,\n  AiDigestControllerMessenger,\n  AiDigestControllerOptions,\n  AiDigestControllerStateChangeEvent,\n} from './AiDigestController.js';\nexport {\n  AiDigestController,\n  getDefaultAiDigestControllerState,\n} from './AiDigestController.js';\nexport type {\n  AiDigestControllerFetchMarketInsightsAction,\n  AiDigestControllerFetchMarketOverviewAction,\n  AiDigestControllerFetchFrontPageItemAction,\n} from './AiDigestController-method-action-types.js';\n\nexport type { AiDigestServiceConfig } from './AiDigestService.js';\nexport { AiDigestService } from './AiDigestService.js';\n\nexport type {\n  AiDigestControllerState,\n  AIResponseMetadata,\n  Article,\n  DigestService,\n  MarketInsightsArticle,\n  MarketInsightsReport,\n  MarketInsightsSource,\n  MarketInsightsTrend,\n  MarketInsightsTweet,\n  MarketOverview,\n  MarketOverviewFrontPage,\n  MarketOverviewItem,\n  MarketOverviewTrend,\n  RelatedAsset,\n  Source,\n  Tweet,\n} from './ai-digest-types.js';\n\nexport {\n  controllerName as aiDigestControllerName,\n  AiDigestControllerErrorMessage,\n} from './ai-digest-constants.js';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,kBAAkB,EAClB,iCAAiC,EAClC,iCAAgC;AAQjC,OAAO,EAAE,eAAe,EAAE,8BAA6B;AAuBvD,OAAO,EACL,cAAc,IAAI,sBAAsB,EACxC,iBAAiB,EACjB,iBAAiB,EACjB,8BAA8B,EAC/B,kCAAiC","sourcesContent":["export type {\n  AiDigestControllerActions,\n  AiDigestControllerEvents,\n  AiDigestControllerGetStateAction,\n  AiDigestControllerMessenger,\n  AiDigestControllerOptions,\n  AiDigestControllerStateChangeEvent,\n} from './AiDigestController.js';\nexport {\n  AiDigestController,\n  getDefaultAiDigestControllerState,\n} from './AiDigestController.js';\nexport type {\n  AiDigestControllerFetchMarketInsightsAction,\n  AiDigestControllerFetchMarketOverviewAction,\n  AiDigestControllerFetchFrontPageItemAction,\n} from './AiDigestController-method-action-types.js';\n\nexport type { AiDigestServiceConfig } from './AiDigestService.js';\nexport { AiDigestService } from './AiDigestService.js';\n\nexport type {\n  AiDigestControllerState,\n  AIResponseMetadata,\n  Article,\n  DigestService,\n  MarketInsightsArticle,\n  MarketInsightsEntry,\n  MarketInsightsReport,\n  MarketInsightsSource,\n  MarketInsightsTrend,\n  MarketInsightsTweet,\n  MarketOverview,\n  MarketOverviewEntry,\n  MarketOverviewFrontPage,\n  MarketOverviewItem,\n  MarketOverviewTrend,\n  RelatedAsset,\n  Source,\n  Tweet,\n} from './ai-digest-types.js';\n\nexport {\n  controllerName as aiDigestControllerName,\n  CACHE_DURATION_MS,\n  MAX_CACHE_ENTRIES,\n  AiDigestControllerErrorMessage,\n} from './ai-digest-constants.js';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/ai-controllers",
-  "version": "0.8.0-preview-e3275932a",
+  "version": "0.8.0-preview-99421bfe4",
   "description": "A collection of AI-related controllers",
   "keywords": [
     "Ethereum",