@metamask-previews/ai-controllers 0.5.0-preview-a0caca0c0 → 0.6.0-preview-17c76be24

package/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0]
+
+### Added
+
+- `MarketInsightsReport` now includes a required `digestId` field containing the unique UUID returned in the `/asset-summary` API response envelope ([#8283](https://github.com/MetaMask/core/pull/8283)).
+- `AiDigestService` now requires the `{ id, digest }` / `{ id, report }` envelope shape and exposes `id` as `digestId` on the returned report objects; bare (non-enveloped) responses are no longer accepted ([#8283](https://github.com/MetaMask/core/pull/8283)).
+
 ## [0.5.0]
 
 ### Changed
@@ -70,7 +77,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Removes `fetchDigest`, `clearDigest`, and `clearAllDigests` actions from the controller action surface.
   - Removes `DigestData`/`DigestEntry` types and the `digests` state branch.
 
-[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/ai-controllers@0.5.0...HEAD
+[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/ai-controllers@0.6.0...HEAD
+[0.6.0]: https://github.com/MetaMask/core/compare/@metamask/ai-controllers@0.5.0...@metamask/ai-controllers@0.6.0
 [0.5.0]: https://github.com/MetaMask/core/compare/@metamask/ai-controllers@0.4.0...@metamask/ai-controllers@0.5.0
 [0.4.0]: https://github.com/MetaMask/core/compare/@metamask/ai-controllers@0.3.0...@metamask/ai-controllers@0.4.0
 [0.3.0]: https://github.com/MetaMask/core/compare/@metamask/ai-controllers@0.2.0...@metamask/ai-controllers@0.3.0

package/dist/AiDigestService.cjs

@@ -66,6 +66,7 @@ const MarketInsightsReportStruct = (0, superstruct_1.type)({
     metadata: (0, superstruct_1.optional)((0, superstruct_1.array)(AIResponseMetadataStruct)),
 });
 const MarketInsightsDigestEnvelopeStruct = (0, superstruct_1.type)({
+    id: (0, superstruct_1.string)(),
     digest: MarketInsightsReportStruct,
 });
 // Market Overview structs
@@ -103,11 +104,8 @@ const getNormalizedMarketOverview = (value) => {
     return null;
 };
 const getNormalizedMarketInsightsReport = (value) => {
-    if ((0, superstruct_1.is)(value, MarketInsightsReportStruct)) {
-        return value;
-    }
     if ((0, superstruct_1.is)(value, MarketInsightsDigestEnvelopeStruct)) {
-        return value.digest;
+        return { ...value.digest, digestId: value.id };
     }
     return null;
 };

package/dist/AiDigestService.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"AiDigestService.cjs","sourceRoot":"","sources":["../src/AiDigestService.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  array,\n  enums,\n  is,\n  optional,\n  string,\n  type as structType,\n} from '@metamask/superstruct';\n\nimport { AiDigestControllerErrorMessage } from './ai-digest-constants';\nimport type {\n  DigestService,\n  MarketInsightsReport,\n  MarketOverview,\n} from './ai-digest-types';\n\nexport type AiDigestServiceConfig = {\n  baseUrl: string;\n};\n\n// Shared sub-type structs\n\nconst ArticleStruct = structType({\n  title: string(),\n  url: string(),\n  source: string(),\n  date: string(),\n});\n\nconst TweetStruct = structType({\n  contentSummary: string(),\n  url: string(),\n  author: string(),\n  date: string(),\n});\n\nconst SourceStruct = structType({\n  name: string(),\n  url: string(),\n  type: enums(['news', 'data', 'social'] as const),\n});\n\nconst AIResponseMetadataStruct = structType({\n  provider: string(),\n});\n\nconst trendCategoryValues = [\n  'geopolitical',\n  'macro',\n  'regulatory',\n  'technical',\n  'social',\n  'other',\n] as const;\n\nconst trendImpactValues = ['positive', 'negative', 'neutral'] as const;\n\n// Market Insights structs\n\nconst MarketInsightsTrendStruct = structType({\n  title: string(),\n  description: string(),\n  category: enums(trendCategoryValues),\n  impact: enums(trendImpactValues),\n  articles: array(ArticleStruct),\n  tweets: array(TweetStruct),\n});\n\nconst MarketInsightsReportStruct = structType({\n  version: optional(string()),\n  asset: string(),\n  generatedAt: string(),\n  headline: string(),\n  summary: string(),\n  trends: array(MarketInsightsTrendStruct),\n  social: optional(array(TweetStruct)),\n  sources: array(SourceStruct),\n  metadata: optional(array(AIResponseMetadataStruct)),\n});\n\nconst MarketInsightsDigestEnvelopeStruct = structType({\n  digest: MarketInsightsReportStruct,\n});\n\n// Market Overview structs\n\nconst RelatedAssetStruct = structType({\n  name: string(),\n  symbol: string(),\n  caip19: array(string()),\n  sourceAssetId: string(),\n  hlPerpsMarket: optional(string()),\n});\n\nconst MarketOverviewTrendStruct = structType({\n  title: string(),\n  description: string(),\n  category: optional(enums(trendCategoryValues)),\n  impact: optional(enums(trendImpactValues)),\n  articles: array(ArticleStruct),\n  relatedAssets: array(RelatedAssetStruct),\n});\n\nconst MarketOverviewStruct = structType({\n  version: optional(string()),\n  generatedAt: string(),\n  trends: array(MarketOverviewTrendStruct),\n  metadata: optional(array(AIResponseMetadataStruct)),\n});\n\nconst MarketOverviewReportEnvelopeStruct = structType({\n  report: MarketOverviewStruct,\n});\n\nconst getNormalizedMarketOverview = (value: unknown): MarketOverview | null => {\n  if (is(value, MarketOverviewStruct)) {\n    return value;\n  }\n\n  if (is(value, MarketOverviewReportEnvelopeStruct)) {\n    return value.report;\n  }\n\n  return null;\n};\n\nconst getNormalizedMarketInsightsReport = (\n  value: unknown,\n): MarketInsightsReport | null => {\n  if (is(value, MarketInsightsReportStruct)) {\n    return value;\n  }\n\n  if (is(value, MarketInsightsDigestEnvelopeStruct)) {\n    return value.digest;\n  }\n\n  return null;\n};\n\nexport class AiDigestService implements DigestService {\n  readonly #baseUrl: string;\n\n  constructor(config: AiDigestServiceConfig) {\n    this.#baseUrl = config.baseUrl;\n  }\n\n  /**\n   * Fetch the market overview report.\n   *\n   * Calls `GET ${this.#baseUrl}/market-overview`.\n   *\n   * @returns The market overview report, or `null` if none exists (404).\n   */\n  async fetchMarketOverview(): Promise<MarketOverview | null> {\n    const response = await fetch(`${this.#baseUrl}/market-overview`);\n\n    if (response.status === 404) {\n      return null;\n    }\n\n    if (!response.ok) {\n      throw new Error(\n        `${AiDigestControllerErrorMessage.API_REQUEST_FAILED}: ${response.status}`,\n      );\n    }\n\n    const overview = getNormalizedMarketOverview(await response.json());\n\n    if (!overview) {\n      throw new Error(AiDigestControllerErrorMessage.API_INVALID_RESPONSE);\n    }\n\n    return overview;\n  }\n\n  /**\n   * Search for market insights by asset identifier.\n   *\n   * Accepts any identifier the API understands (CAIP-19 asset type, ticker\n   * symbol, asset name, HyperLiquid perps market id, etc.) and forwards it\n   * unchanged via the universal `asset` query parameter.\n   *\n   * Calls `GET ${baseUrl}/asset-summary?asset=<assetIdentifier>`.\n   *\n   * @param assetIdentifier - The asset identifier (e.g. `eip155:1/slip44:60`,\n   *   `ETH`, `Bitcoin`, `xyz:TSLA`).\n   * @returns The market insights report, or `null` if none exists (404).\n   */\n  async searchDigest(\n    assetIdentifier: string,\n  ): Promise<MarketInsightsReport | null> {\n    const response = await fetch(\n      `${this.#baseUrl}/asset-summary?asset=${encodeURIComponent(assetIdentifier)}`,\n    );\n\n    if (response.status === 404) {\n      return null;\n    }\n\n    if (!response.ok) {\n      throw new Error(\n        `${AiDigestControllerErrorMessage.API_REQUEST_FAILED}: ${response.status}`,\n      );\n    }\n\n    const report = getNormalizedMarketInsightsReport(await response.json());\n\n    if (!report) {\n      throw new Error(AiDigestControllerErrorMessage.API_INVALID_RESPONSE);\n    }\n\n    return report;\n  }\n}\n"]}
+{"version":3,"file":"AiDigestService.cjs","sourceRoot":"","sources":["../src/AiDigestService.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  array,\n  enums,\n  is,\n  optional,\n  string,\n  type as structType,\n} from '@metamask/superstruct';\n\nimport { AiDigestControllerErrorMessage } from './ai-digest-constants';\nimport type {\n  DigestService,\n  MarketInsightsReport,\n  MarketOverview,\n} from './ai-digest-types';\n\nexport type AiDigestServiceConfig = {\n  baseUrl: string;\n};\n\n// Shared sub-type structs\n\nconst ArticleStruct = structType({\n  title: string(),\n  url: string(),\n  source: string(),\n  date: string(),\n});\n\nconst TweetStruct = structType({\n  contentSummary: string(),\n  url: string(),\n  author: string(),\n  date: string(),\n});\n\nconst SourceStruct = structType({\n  name: string(),\n  url: string(),\n  type: enums(['news', 'data', 'social'] as const),\n});\n\nconst AIResponseMetadataStruct = structType({\n  provider: string(),\n});\n\nconst trendCategoryValues = [\n  'geopolitical',\n  'macro',\n  'regulatory',\n  'technical',\n  'social',\n  'other',\n] as const;\n\nconst trendImpactValues = ['positive', 'negative', 'neutral'] as const;\n\n// Market Insights structs\n\nconst MarketInsightsTrendStruct = structType({\n  title: string(),\n  description: string(),\n  category: enums(trendCategoryValues),\n  impact: enums(trendImpactValues),\n  articles: array(ArticleStruct),\n  tweets: array(TweetStruct),\n});\n\nconst MarketInsightsReportStruct = structType({\n  version: optional(string()),\n  asset: string(),\n  generatedAt: string(),\n  headline: string(),\n  summary: string(),\n  trends: array(MarketInsightsTrendStruct),\n  social: optional(array(TweetStruct)),\n  sources: array(SourceStruct),\n  metadata: optional(array(AIResponseMetadataStruct)),\n});\n\nconst MarketInsightsDigestEnvelopeStruct = structType({\n  id: string(),\n  digest: MarketInsightsReportStruct,\n});\n\n// Market Overview structs\n\nconst RelatedAssetStruct = structType({\n  name: string(),\n  symbol: string(),\n  caip19: array(string()),\n  sourceAssetId: string(),\n  hlPerpsMarket: optional(string()),\n});\n\nconst MarketOverviewTrendStruct = structType({\n  title: string(),\n  description: string(),\n  category: optional(enums(trendCategoryValues)),\n  impact: optional(enums(trendImpactValues)),\n  articles: array(ArticleStruct),\n  relatedAssets: array(RelatedAssetStruct),\n});\n\nconst MarketOverviewStruct = structType({\n  version: optional(string()),\n  generatedAt: string(),\n  trends: array(MarketOverviewTrendStruct),\n  metadata: optional(array(AIResponseMetadataStruct)),\n});\n\nconst MarketOverviewReportEnvelopeStruct = structType({\n  report: MarketOverviewStruct,\n});\n\nconst getNormalizedMarketOverview = (value: unknown): MarketOverview | null => {\n  if (is(value, MarketOverviewStruct)) {\n    return value;\n  }\n\n  if (is(value, MarketOverviewReportEnvelopeStruct)) {\n    return value.report;\n  }\n\n  return null;\n};\n\nconst getNormalizedMarketInsightsReport = (\n  value: unknown,\n): MarketInsightsReport | null => {\n  if (is(value, MarketInsightsDigestEnvelopeStruct)) {\n    return { ...value.digest, digestId: value.id };\n  }\n\n  return null;\n};\n\nexport class AiDigestService implements DigestService {\n  readonly #baseUrl: string;\n\n  constructor(config: AiDigestServiceConfig) {\n    this.#baseUrl = config.baseUrl;\n  }\n\n  /**\n   * Fetch the market overview report.\n   *\n   * Calls `GET ${this.#baseUrl}/market-overview`.\n   *\n   * @returns The market overview report, or `null` if none exists (404).\n   */\n  async fetchMarketOverview(): Promise<MarketOverview | null> {\n    const response = await fetch(`${this.#baseUrl}/market-overview`);\n\n    if (response.status === 404) {\n      return null;\n    }\n\n    if (!response.ok) {\n      throw new Error(\n        `${AiDigestControllerErrorMessage.API_REQUEST_FAILED}: ${response.status}`,\n      );\n    }\n\n    const overview = getNormalizedMarketOverview(await response.json());\n\n    if (!overview) {\n      throw new Error(AiDigestControllerErrorMessage.API_INVALID_RESPONSE);\n    }\n\n    return overview;\n  }\n\n  /**\n   * Search for market insights by asset identifier.\n   *\n   * Accepts any identifier the API understands (CAIP-19 asset type, ticker\n   * symbol, asset name, HyperLiquid perps market id, etc.) and forwards it\n   * unchanged via the universal `asset` query parameter.\n   *\n   * Calls `GET ${baseUrl}/asset-summary?asset=<assetIdentifier>`.\n   *\n   * @param assetIdentifier - The asset identifier (e.g. `eip155:1/slip44:60`,\n   *   `ETH`, `Bitcoin`, `xyz:TSLA`).\n   * @returns The market insights report, or `null` if none exists (404).\n   */\n  async searchDigest(\n    assetIdentifier: string,\n  ): Promise<MarketInsightsReport | null> {\n    const response = await fetch(\n      `${this.#baseUrl}/asset-summary?asset=${encodeURIComponent(assetIdentifier)}`,\n    );\n\n    if (response.status === 404) {\n      return null;\n    }\n\n    if (!response.ok) {\n      throw new Error(\n        `${AiDigestControllerErrorMessage.API_REQUEST_FAILED}: ${response.status}`,\n      );\n    }\n\n    const report = getNormalizedMarketInsightsReport(await response.json());\n\n    if (!report) {\n      throw new Error(AiDigestControllerErrorMessage.API_INVALID_RESPONSE);\n    }\n\n    return report;\n  }\n}\n"]}

package/dist/AiDigestService.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"AiDigestService.d.cts","sourceRoot":"","sources":["../src/AiDigestService.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,cAAc,EACf,8BAA0B;AAE3B,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AA0HF,qBAAa,eAAgB,YAAW,aAAa;;gBAGvC,MAAM,EAAE,qBAAqB;IAIzC;;;;;;OAMG;IACG,mBAAmB,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAsB3D;;;;;;;;;;;;OAYG;IACG,YAAY,CAChB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;CAuBxC"}
+{"version":3,"file":"AiDigestService.d.cts","sourceRoot":"","sources":["../src/AiDigestService.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,cAAc,EACf,8BAA0B;AAE3B,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAuHF,qBAAa,eAAgB,YAAW,aAAa;;gBAGvC,MAAM,EAAE,qBAAqB;IAIzC;;;;;;OAMG;IACG,mBAAmB,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAsB3D;;;;;;;;;;;;OAYG;IACG,YAAY,CAChB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;CAuBxC"}

package/dist/AiDigestService.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"AiDigestService.d.mts","sourceRoot":"","sources":["../src/AiDigestService.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,cAAc,EACf,8BAA0B;AAE3B,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AA0HF,qBAAa,eAAgB,YAAW,aAAa;;gBAGvC,MAAM,EAAE,qBAAqB;IAIzC;;;;;;OAMG;IACG,mBAAmB,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAsB3D;;;;;;;;;;;;OAYG;IACG,YAAY,CAChB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;CAuBxC"}
+{"version":3,"file":"AiDigestService.d.mts","sourceRoot":"","sources":["../src/AiDigestService.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,cAAc,EACf,8BAA0B;AAE3B,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAuHF,qBAAa,eAAgB,YAAW,aAAa;;gBAGvC,MAAM,EAAE,qBAAqB;IAIzC;;;;;;OAMG;IACG,mBAAmB,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAsB3D;;;;;;;;;;;;OAYG;IACG,YAAY,CAChB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;CAuBxC"}

package/dist/AiDigestService.mjs

@@ -63,6 +63,7 @@ const MarketInsightsReportStruct = structType({
     metadata: optional(array(AIResponseMetadataStruct)),
 });
 const MarketInsightsDigestEnvelopeStruct = structType({
+    id: string(),
     digest: MarketInsightsReportStruct,
 });
 // Market Overview structs
@@ -100,11 +101,8 @@ const getNormalizedMarketOverview = (value) => {
     return null;
 };
 const getNormalizedMarketInsightsReport = (value) => {
-    if (is(value, MarketInsightsReportStruct)) {
-        return value;
-    }
     if (is(value, MarketInsightsDigestEnvelopeStruct)) {
-        return value.digest;
+        return { ...value.digest, digestId: value.id };
     }
     return null;
 };

package/dist/AiDigestService.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"AiDigestService.mjs","sourceRoot":"","sources":["../src/AiDigestService.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  array,\n  enums,\n  is,\n  optional,\n  string,\n  type as structType,\n} from '@metamask/superstruct';\n\nimport { AiDigestControllerErrorMessage } from './ai-digest-constants';\nimport type {\n  DigestService,\n  MarketInsightsReport,\n  MarketOverview,\n} from './ai-digest-types';\n\nexport type AiDigestServiceConfig = {\n  baseUrl: string;\n};\n\n// Shared sub-type structs\n\nconst ArticleStruct = structType({\n  title: string(),\n  url: string(),\n  source: string(),\n  date: string(),\n});\n\nconst TweetStruct = structType({\n  contentSummary: string(),\n  url: string(),\n  author: string(),\n  date: string(),\n});\n\nconst SourceStruct = structType({\n  name: string(),\n  url: string(),\n  type: enums(['news', 'data', 'social'] as const),\n});\n\nconst AIResponseMetadataStruct = structType({\n  provider: string(),\n});\n\nconst trendCategoryValues = [\n  'geopolitical',\n  'macro',\n  'regulatory',\n  'technical',\n  'social',\n  'other',\n] as const;\n\nconst trendImpactValues = ['positive', 'negative', 'neutral'] as const;\n\n// Market Insights structs\n\nconst MarketInsightsTrendStruct = structType({\n  title: string(),\n  description: string(),\n  category: enums(trendCategoryValues),\n  impact: enums(trendImpactValues),\n  articles: array(ArticleStruct),\n  tweets: array(TweetStruct),\n});\n\nconst MarketInsightsReportStruct = structType({\n  version: optional(string()),\n  asset: string(),\n  generatedAt: string(),\n  headline: string(),\n  summary: string(),\n  trends: array(MarketInsightsTrendStruct),\n  social: optional(array(TweetStruct)),\n  sources: array(SourceStruct),\n  metadata: optional(array(AIResponseMetadataStruct)),\n});\n\nconst MarketInsightsDigestEnvelopeStruct = structType({\n  digest: MarketInsightsReportStruct,\n});\n\n// Market Overview structs\n\nconst RelatedAssetStruct = structType({\n  name: string(),\n  symbol: string(),\n  caip19: array(string()),\n  sourceAssetId: string(),\n  hlPerpsMarket: optional(string()),\n});\n\nconst MarketOverviewTrendStruct = structType({\n  title: string(),\n  description: string(),\n  category: optional(enums(trendCategoryValues)),\n  impact: optional(enums(trendImpactValues)),\n  articles: array(ArticleStruct),\n  relatedAssets: array(RelatedAssetStruct),\n});\n\nconst MarketOverviewStruct = structType({\n  version: optional(string()),\n  generatedAt: string(),\n  trends: array(MarketOverviewTrendStruct),\n  metadata: optional(array(AIResponseMetadataStruct)),\n});\n\nconst MarketOverviewReportEnvelopeStruct = structType({\n  report: MarketOverviewStruct,\n});\n\nconst getNormalizedMarketOverview = (value: unknown): MarketOverview | null => {\n  if (is(value, MarketOverviewStruct)) {\n    return value;\n  }\n\n  if (is(value, MarketOverviewReportEnvelopeStruct)) {\n    return value.report;\n  }\n\n  return null;\n};\n\nconst getNormalizedMarketInsightsReport = (\n  value: unknown,\n): MarketInsightsReport | null => {\n  if (is(value, MarketInsightsReportStruct)) {\n    return value;\n  }\n\n  if (is(value, MarketInsightsDigestEnvelopeStruct)) {\n    return value.digest;\n  }\n\n  return null;\n};\n\nexport class AiDigestService implements DigestService {\n  readonly #baseUrl: string;\n\n  constructor(config: AiDigestServiceConfig) {\n    this.#baseUrl = config.baseUrl;\n  }\n\n  /**\n   * Fetch the market overview report.\n   *\n   * Calls `GET ${this.#baseUrl}/market-overview`.\n   *\n   * @returns The market overview report, or `null` if none exists (404).\n   */\n  async fetchMarketOverview(): Promise<MarketOverview | null> {\n    const response = await fetch(`${this.#baseUrl}/market-overview`);\n\n    if (response.status === 404) {\n      return null;\n    }\n\n    if (!response.ok) {\n      throw new Error(\n        `${AiDigestControllerErrorMessage.API_REQUEST_FAILED}: ${response.status}`,\n      );\n    }\n\n    const overview = getNormalizedMarketOverview(await response.json());\n\n    if (!overview) {\n      throw new Error(AiDigestControllerErrorMessage.API_INVALID_RESPONSE);\n    }\n\n    return overview;\n  }\n\n  /**\n   * Search for market insights by asset identifier.\n   *\n   * Accepts any identifier the API understands (CAIP-19 asset type, ticker\n   * symbol, asset name, HyperLiquid perps market id, etc.) and forwards it\n   * unchanged via the universal `asset` query parameter.\n   *\n   * Calls `GET ${baseUrl}/asset-summary?asset=<assetIdentifier>`.\n   *\n   * @param assetIdentifier - The asset identifier (e.g. `eip155:1/slip44:60`,\n   *   `ETH`, `Bitcoin`, `xyz:TSLA`).\n   * @returns The market insights report, or `null` if none exists (404).\n   */\n  async searchDigest(\n    assetIdentifier: string,\n  ): Promise<MarketInsightsReport | null> {\n    const response = await fetch(\n      `${this.#baseUrl}/asset-summary?asset=${encodeURIComponent(assetIdentifier)}`,\n    );\n\n    if (response.status === 404) {\n      return null;\n    }\n\n    if (!response.ok) {\n      throw new Error(\n        `${AiDigestControllerErrorMessage.API_REQUEST_FAILED}: ${response.status}`,\n      );\n    }\n\n    const report = getNormalizedMarketInsightsReport(await response.json());\n\n    if (!report) {\n      throw new Error(AiDigestControllerErrorMessage.API_INVALID_RESPONSE);\n    }\n\n    return report;\n  }\n}\n"]}
+{"version":3,"file":"AiDigestService.mjs","sourceRoot":"","sources":["../src/AiDigestService.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  array,\n  enums,\n  is,\n  optional,\n  string,\n  type as structType,\n} from '@metamask/superstruct';\n\nimport { AiDigestControllerErrorMessage } from './ai-digest-constants';\nimport type {\n  DigestService,\n  MarketInsightsReport,\n  MarketOverview,\n} from './ai-digest-types';\n\nexport type AiDigestServiceConfig = {\n  baseUrl: string;\n};\n\n// Shared sub-type structs\n\nconst ArticleStruct = structType({\n  title: string(),\n  url: string(),\n  source: string(),\n  date: string(),\n});\n\nconst TweetStruct = structType({\n  contentSummary: string(),\n  url: string(),\n  author: string(),\n  date: string(),\n});\n\nconst SourceStruct = structType({\n  name: string(),\n  url: string(),\n  type: enums(['news', 'data', 'social'] as const),\n});\n\nconst AIResponseMetadataStruct = structType({\n  provider: string(),\n});\n\nconst trendCategoryValues = [\n  'geopolitical',\n  'macro',\n  'regulatory',\n  'technical',\n  'social',\n  'other',\n] as const;\n\nconst trendImpactValues = ['positive', 'negative', 'neutral'] as const;\n\n// Market Insights structs\n\nconst MarketInsightsTrendStruct = structType({\n  title: string(),\n  description: string(),\n  category: enums(trendCategoryValues),\n  impact: enums(trendImpactValues),\n  articles: array(ArticleStruct),\n  tweets: array(TweetStruct),\n});\n\nconst MarketInsightsReportStruct = structType({\n  version: optional(string()),\n  asset: string(),\n  generatedAt: string(),\n  headline: string(),\n  summary: string(),\n  trends: array(MarketInsightsTrendStruct),\n  social: optional(array(TweetStruct)),\n  sources: array(SourceStruct),\n  metadata: optional(array(AIResponseMetadataStruct)),\n});\n\nconst MarketInsightsDigestEnvelopeStruct = structType({\n  id: string(),\n  digest: MarketInsightsReportStruct,\n});\n\n// Market Overview structs\n\nconst RelatedAssetStruct = structType({\n  name: string(),\n  symbol: string(),\n  caip19: array(string()),\n  sourceAssetId: string(),\n  hlPerpsMarket: optional(string()),\n});\n\nconst MarketOverviewTrendStruct = structType({\n  title: string(),\n  description: string(),\n  category: optional(enums(trendCategoryValues)),\n  impact: optional(enums(trendImpactValues)),\n  articles: array(ArticleStruct),\n  relatedAssets: array(RelatedAssetStruct),\n});\n\nconst MarketOverviewStruct = structType({\n  version: optional(string()),\n  generatedAt: string(),\n  trends: array(MarketOverviewTrendStruct),\n  metadata: optional(array(AIResponseMetadataStruct)),\n});\n\nconst MarketOverviewReportEnvelopeStruct = structType({\n  report: MarketOverviewStruct,\n});\n\nconst getNormalizedMarketOverview = (value: unknown): MarketOverview | null => {\n  if (is(value, MarketOverviewStruct)) {\n    return value;\n  }\n\n  if (is(value, MarketOverviewReportEnvelopeStruct)) {\n    return value.report;\n  }\n\n  return null;\n};\n\nconst getNormalizedMarketInsightsReport = (\n  value: unknown,\n): MarketInsightsReport | null => {\n  if (is(value, MarketInsightsDigestEnvelopeStruct)) {\n    return { ...value.digest, digestId: value.id };\n  }\n\n  return null;\n};\n\nexport class AiDigestService implements DigestService {\n  readonly #baseUrl: string;\n\n  constructor(config: AiDigestServiceConfig) {\n    this.#baseUrl = config.baseUrl;\n  }\n\n  /**\n   * Fetch the market overview report.\n   *\n   * Calls `GET ${this.#baseUrl}/market-overview`.\n   *\n   * @returns The market overview report, or `null` if none exists (404).\n   */\n  async fetchMarketOverview(): Promise<MarketOverview | null> {\n    const response = await fetch(`${this.#baseUrl}/market-overview`);\n\n    if (response.status === 404) {\n      return null;\n    }\n\n    if (!response.ok) {\n      throw new Error(\n        `${AiDigestControllerErrorMessage.API_REQUEST_FAILED}: ${response.status}`,\n      );\n    }\n\n    const overview = getNormalizedMarketOverview(await response.json());\n\n    if (!overview) {\n      throw new Error(AiDigestControllerErrorMessage.API_INVALID_RESPONSE);\n    }\n\n    return overview;\n  }\n\n  /**\n   * Search for market insights by asset identifier.\n   *\n   * Accepts any identifier the API understands (CAIP-19 asset type, ticker\n   * symbol, asset name, HyperLiquid perps market id, etc.) and forwards it\n   * unchanged via the universal `asset` query parameter.\n   *\n   * Calls `GET ${baseUrl}/asset-summary?asset=<assetIdentifier>`.\n   *\n   * @param assetIdentifier - The asset identifier (e.g. `eip155:1/slip44:60`,\n   *   `ETH`, `Bitcoin`, `xyz:TSLA`).\n   * @returns The market insights report, or `null` if none exists (404).\n   */\n  async searchDigest(\n    assetIdentifier: string,\n  ): Promise<MarketInsightsReport | null> {\n    const response = await fetch(\n      `${this.#baseUrl}/asset-summary?asset=${encodeURIComponent(assetIdentifier)}`,\n    );\n\n    if (response.status === 404) {\n      return null;\n    }\n\n    if (!response.ok) {\n      throw new Error(\n        `${AiDigestControllerErrorMessage.API_REQUEST_FAILED}: ${response.status}`,\n      );\n    }\n\n    const report = getNormalizedMarketInsightsReport(await response.json());\n\n    if (!report) {\n      throw new Error(AiDigestControllerErrorMessage.API_INVALID_RESPONSE);\n    }\n\n    return report;\n  }\n}\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  /** 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  /** Human-readable asset name (e.g. \"Bitcoin\") */\n  name: string;\n  /** Ticker symbol (e.g. \"BTC\") */\n  symbol: string;\n  /** CAIP-19 identifiers for this asset across chains */\n  caip19: string[];\n  /** Canonical source asset identifier (e.g. \"bitcoin\") */\n  sourceAssetId: string;\n  /**\n   * Optional HyperLiquid market identifier 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// 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"]}
+{"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  /** Human-readable asset name (e.g. \"Bitcoin\") */\n  name: string;\n  /** Ticker symbol (e.g. \"BTC\") */\n  symbol: string;\n  /** CAIP-19 identifiers for this asset across chains */\n  caip19: string[];\n  /** Canonical source asset identifier (e.g. \"bitcoin\") */\n  sourceAssetId: string;\n  /**\n   * Optional HyperLiquid market identifier 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// 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"]}

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

@@ -60,6 +60,8 @@ export type MarketInsightsTrend = {
  * Returned by `GET /asset-summary?asset=<identifier>`.
  */
 export type MarketInsightsReport = {
+    /** Unique identifier for this digest, sourced from the API response envelope. */
+    digestId: string;
     /** API version */
     version?: string;
     /** Asset symbol (lowercase, e.g. "btc") */

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

@@ -60,6 +60,8 @@ export type MarketInsightsTrend = {
  * Returned by `GET /asset-summary?asset=<identifier>`.
  */
 export type MarketInsightsReport = {
+    /** Unique identifier for this digest, sourced from the API response envelope. */
+    digestId: string;
     /** API version */
     version?: string;
     /** Asset symbol (lowercase, e.g. "btc") */

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  /** 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  /** Human-readable asset name (e.g. \"Bitcoin\") */\n  name: string;\n  /** Ticker symbol (e.g. \"BTC\") */\n  symbol: string;\n  /** CAIP-19 identifiers for this asset across chains */\n  caip19: string[];\n  /** Canonical source asset identifier (e.g. \"bitcoin\") */\n  sourceAssetId: string;\n  /**\n   * Optional HyperLiquid market identifier 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// 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"]}
+{"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  /** Human-readable asset name (e.g. \"Bitcoin\") */\n  name: string;\n  /** Ticker symbol (e.g. \"BTC\") */\n  symbol: string;\n  /** CAIP-19 identifiers for this asset across chains */\n  caip19: string[];\n  /** Canonical source asset identifier (e.g. \"bitcoin\") */\n  sourceAssetId: string;\n  /**\n   * Optional HyperLiquid market identifier 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// 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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/ai-controllers",
-  "version": "0.5.0-preview-a0caca0c0",
+  "version": "0.6.0-preview-17c76be24",
   "description": "A collection of AI-related controllers",
   "keywords": [
     "MetaMask",