@agent-native/creative-context 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (618) hide show
  1. package/README.md +108 -0
  2. package/agent-native.package.json +104 -0
  3. package/dist/actions/confirm-canonical-logo.d.ts +6 -0
  4. package/dist/actions/confirm-canonical-logo.d.ts.map +1 -0
  5. package/dist/actions/confirm-canonical-logo.js +19 -0
  6. package/dist/actions/confirm-canonical-logo.js.map +1 -0
  7. package/dist/actions/continue-context-import.d.ts +7 -0
  8. package/dist/actions/continue-context-import.d.ts.map +1 -0
  9. package/dist/actions/continue-context-import.js +10 -0
  10. package/dist/actions/continue-context-import.js.map +1 -0
  11. package/dist/actions/creative-context-a2a.d.ts +10 -0
  12. package/dist/actions/creative-context-a2a.d.ts.map +1 -0
  13. package/dist/actions/creative-context-a2a.js +66 -0
  14. package/dist/actions/creative-context-a2a.js.map +1 -0
  15. package/dist/actions/get-brand-profile.d.ts +33 -0
  16. package/dist/actions/get-brand-profile.d.ts.map +1 -0
  17. package/dist/actions/get-brand-profile.js +13 -0
  18. package/dist/actions/get-brand-profile.js.map +1 -0
  19. package/dist/actions/get-context-import-status.d.ts +22 -0
  20. package/dist/actions/get-context-import-status.d.ts.map +1 -0
  21. package/dist/actions/get-context-import-status.js +12 -0
  22. package/dist/actions/get-context-import-status.js.map +1 -0
  23. package/dist/actions/get-context-item.d.ts +2 -0
  24. package/dist/actions/get-context-item.d.ts.map +1 -0
  25. package/dist/actions/get-context-item.js +2 -0
  26. package/dist/actions/get-context-item.js.map +1 -0
  27. package/dist/actions/get-context-pack.d.ts +7 -0
  28. package/dist/actions/get-context-pack.d.ts.map +1 -0
  29. package/dist/actions/get-context-pack.js +12 -0
  30. package/dist/actions/get-context-pack.js.map +1 -0
  31. package/dist/actions/get-creative-context.d.ts +119 -0
  32. package/dist/actions/get-creative-context.d.ts.map +1 -0
  33. package/dist/actions/get-creative-context.js +112 -0
  34. package/dist/actions/get-creative-context.js.map +1 -0
  35. package/dist/actions/index.d.ts +3 -0
  36. package/dist/actions/index.d.ts.map +1 -0
  37. package/dist/actions/index.js +63 -0
  38. package/dist/actions/index.js.map +1 -0
  39. package/dist/actions/infer-brand-dna.d.ts +52 -0
  40. package/dist/actions/infer-brand-dna.d.ts.map +1 -0
  41. package/dist/actions/infer-brand-dna.js +13 -0
  42. package/dist/actions/infer-brand-dna.js.map +1 -0
  43. package/dist/actions/list-canonical-logo-candidates.d.ts +9 -0
  44. package/dist/actions/list-canonical-logo-candidates.d.ts.map +1 -0
  45. package/dist/actions/list-canonical-logo-candidates.js +82 -0
  46. package/dist/actions/list-canonical-logo-candidates.js.map +1 -0
  47. package/dist/actions/list-context-connections.d.ts +22 -0
  48. package/dist/actions/list-context-connections.d.ts.map +1 -0
  49. package/dist/actions/list-context-connections.js +43 -0
  50. package/dist/actions/list-context-connections.js.map +1 -0
  51. package/dist/actions/list-context-packs.d.ts +10 -0
  52. package/dist/actions/list-context-packs.d.ts.map +1 -0
  53. package/dist/actions/list-context-packs.js +16 -0
  54. package/dist/actions/list-context-packs.js.map +1 -0
  55. package/dist/actions/list-context-sources.d.ts +12 -0
  56. package/dist/actions/list-context-sources.d.ts.map +1 -0
  57. package/dist/actions/list-context-sources.js +20 -0
  58. package/dist/actions/list-context-sources.js.map +1 -0
  59. package/dist/actions/list-context-suggestions.d.ts +13 -0
  60. package/dist/actions/list-context-suggestions.d.ts.map +1 -0
  61. package/dist/actions/list-context-suggestions.js +28 -0
  62. package/dist/actions/list-context-suggestions.js.map +1 -0
  63. package/dist/actions/manage-brand-profile.d.ts +28 -0
  64. package/dist/actions/manage-brand-profile.d.ts.map +1 -0
  65. package/dist/actions/manage-brand-profile.js +47 -0
  66. package/dist/actions/manage-brand-profile.js.map +1 -0
  67. package/dist/actions/manage-context-pack.d.ts +33 -0
  68. package/dist/actions/manage-context-pack.d.ts.map +1 -0
  69. package/dist/actions/manage-context-pack.js +65 -0
  70. package/dist/actions/manage-context-pack.js.map +1 -0
  71. package/dist/actions/manage-context-source.d.ts +51 -0
  72. package/dist/actions/manage-context-source.d.ts.map +1 -0
  73. package/dist/actions/manage-context-source.js +137 -0
  74. package/dist/actions/manage-context-source.js.map +1 -0
  75. package/dist/actions/manage-layout-template.d.ts +13 -0
  76. package/dist/actions/manage-layout-template.d.ts.map +1 -0
  77. package/dist/actions/manage-layout-template.js +43 -0
  78. package/dist/actions/manage-layout-template.js.map +1 -0
  79. package/dist/actions/preview-context-import.d.ts +23 -0
  80. package/dist/actions/preview-context-import.d.ts.map +1 -0
  81. package/dist/actions/preview-context-import.js +57 -0
  82. package/dist/actions/preview-context-import.js.map +1 -0
  83. package/dist/actions/process-context-purge.d.ts +22 -0
  84. package/dist/actions/process-context-purge.d.ts.map +1 -0
  85. package/dist/actions/process-context-purge.js +19 -0
  86. package/dist/actions/process-context-purge.js.map +1 -0
  87. package/dist/actions/propose-brand-dna.d.ts +15 -0
  88. package/dist/actions/propose-brand-dna.d.ts.map +1 -0
  89. package/dist/actions/propose-brand-dna.js +19 -0
  90. package/dist/actions/propose-brand-dna.js.map +1 -0
  91. package/dist/actions/propose-canonical-logo.d.ts +9 -0
  92. package/dist/actions/propose-canonical-logo.d.ts.map +1 -0
  93. package/dist/actions/propose-canonical-logo.js +16 -0
  94. package/dist/actions/propose-canonical-logo.js.map +1 -0
  95. package/dist/actions/publish-brand-dna.d.ts +13 -0
  96. package/dist/actions/publish-brand-dna.d.ts.map +1 -0
  97. package/dist/actions/publish-brand-dna.js +23 -0
  98. package/dist/actions/publish-brand-dna.js.map +1 -0
  99. package/dist/actions/recommend-context-roots.d.ts +14 -0
  100. package/dist/actions/recommend-context-roots.d.ts.map +1 -0
  101. package/dist/actions/recommend-context-roots.js +22 -0
  102. package/dist/actions/recommend-context-roots.js.map +1 -0
  103. package/dist/actions/record-context-feedback.d.ts +10 -0
  104. package/dist/actions/record-context-feedback.d.ts.map +1 -0
  105. package/dist/actions/record-context-feedback.js +14 -0
  106. package/dist/actions/record-context-feedback.js.map +1 -0
  107. package/dist/actions/review-context-items.d.ts +35 -0
  108. package/dist/actions/review-context-items.d.ts.map +1 -0
  109. package/dist/actions/review-context-items.js +65 -0
  110. package/dist/actions/review-context-items.js.map +1 -0
  111. package/dist/actions/run-embedding-bakeoff.d.ts +15 -0
  112. package/dist/actions/run-embedding-bakeoff.d.ts.map +1 -0
  113. package/dist/actions/run-embedding-bakeoff.js +72 -0
  114. package/dist/actions/run-embedding-bakeoff.js.map +1 -0
  115. package/dist/actions/search-creative-context.d.ts +75 -0
  116. package/dist/actions/search-creative-context.d.ts.map +1 -0
  117. package/dist/actions/search-creative-context.js +41 -0
  118. package/dist/actions/search-creative-context.js.map +1 -0
  119. package/dist/actions/set-brand-dna.d.ts +15 -0
  120. package/dist/actions/set-brand-dna.d.ts.map +1 -0
  121. package/dist/actions/set-brand-dna.js +19 -0
  122. package/dist/actions/set-brand-dna.js.map +1 -0
  123. package/dist/actions/start-context-enrichment.d.ts +10 -0
  124. package/dist/actions/start-context-enrichment.d.ts.map +1 -0
  125. package/dist/actions/start-context-enrichment.js +46 -0
  126. package/dist/actions/start-context-enrichment.js.map +1 -0
  127. package/dist/actions/start-context-import.d.ts +9 -0
  128. package/dist/actions/start-context-import.d.ts.map +1 -0
  129. package/dist/actions/start-context-import.js +36 -0
  130. package/dist/actions/start-context-import.js.map +1 -0
  131. package/dist/client/CreativeContextChip.d.ts +13 -0
  132. package/dist/client/CreativeContextChip.d.ts.map +1 -0
  133. package/dist/client/CreativeContextChip.js +45 -0
  134. package/dist/client/CreativeContextChip.js.map +1 -0
  135. package/dist/client/CreativeContextPanel.d.ts +131 -0
  136. package/dist/client/CreativeContextPanel.d.ts.map +1 -0
  137. package/dist/client/CreativeContextPanel.js +778 -0
  138. package/dist/client/CreativeContextPanel.js.map +1 -0
  139. package/dist/client/CreativeContextSettingsLink.d.ts +4 -0
  140. package/dist/client/CreativeContextSettingsLink.d.ts.map +1 -0
  141. package/dist/client/CreativeContextSettingsLink.js +8 -0
  142. package/dist/client/CreativeContextSettingsLink.js.map +1 -0
  143. package/dist/client/actions.d.ts +256 -0
  144. package/dist/client/actions.d.ts.map +1 -0
  145. package/dist/client/actions.js +89 -0
  146. package/dist/client/actions.js.map +1 -0
  147. package/dist/client/agent-tab.d.ts +9 -0
  148. package/dist/client/agent-tab.d.ts.map +1 -0
  149. package/dist/client/agent-tab.js +32 -0
  150. package/dist/client/agent-tab.js.map +1 -0
  151. package/dist/client/application-state.d.ts +22 -0
  152. package/dist/client/application-state.d.ts.map +1 -0
  153. package/dist/client/application-state.js +88 -0
  154. package/dist/client/application-state.js.map +1 -0
  155. package/dist/client/index.d.ts +8 -0
  156. package/dist/client/index.d.ts.map +1 -0
  157. package/dist/client/index.js +8 -0
  158. package/dist/client/index.js.map +1 -0
  159. package/dist/client/messages.d.ts +5 -0
  160. package/dist/client/messages.d.ts.map +1 -0
  161. package/dist/client/messages.js +1059 -0
  162. package/dist/client/messages.js.map +1 -0
  163. package/dist/connectors/context.d.ts +9 -0
  164. package/dist/connectors/context.d.ts.map +1 -0
  165. package/dist/connectors/context.js +59 -0
  166. package/dist/connectors/context.js.map +1 -0
  167. package/dist/connectors/document-parser.d.ts +2 -0
  168. package/dist/connectors/document-parser.d.ts.map +1 -0
  169. package/dist/connectors/document-parser.js +2 -0
  170. package/dist/connectors/document-parser.js.map +1 -0
  171. package/dist/connectors/figma-native.d.ts +18 -0
  172. package/dist/connectors/figma-native.d.ts.map +1 -0
  173. package/dist/connectors/figma-native.js +883 -0
  174. package/dist/connectors/figma-native.js.map +1 -0
  175. package/dist/connectors/figma.d.ts +10 -0
  176. package/dist/connectors/figma.d.ts.map +1 -0
  177. package/dist/connectors/figma.js +166 -0
  178. package/dist/connectors/figma.js.map +1 -0
  179. package/dist/connectors/google-slides-native.d.ts +58 -0
  180. package/dist/connectors/google-slides-native.d.ts.map +1 -0
  181. package/dist/connectors/google-slides-native.js +1118 -0
  182. package/dist/connectors/google-slides-native.js.map +1 -0
  183. package/dist/connectors/google-slides.d.ts +15 -0
  184. package/dist/connectors/google-slides.d.ts.map +1 -0
  185. package/dist/connectors/google-slides.js +896 -0
  186. package/dist/connectors/google-slides.js.map +1 -0
  187. package/dist/connectors/index.d.ts +20 -0
  188. package/dist/connectors/index.d.ts.map +1 -0
  189. package/dist/connectors/index.js +44 -0
  190. package/dist/connectors/index.js.map +1 -0
  191. package/dist/connectors/manual.d.ts +9 -0
  192. package/dist/connectors/manual.d.ts.map +1 -0
  193. package/dist/connectors/manual.js +91 -0
  194. package/dist/connectors/manual.js.map +1 -0
  195. package/dist/connectors/normalize.d.ts +35 -0
  196. package/dist/connectors/normalize.d.ts.map +1 -0
  197. package/dist/connectors/normalize.js +216 -0
  198. package/dist/connectors/normalize.js.map +1 -0
  199. package/dist/connectors/notion.d.ts +10 -0
  200. package/dist/connectors/notion.d.ts.map +1 -0
  201. package/dist/connectors/notion.js +393 -0
  202. package/dist/connectors/notion.js.map +1 -0
  203. package/dist/connectors/private-artifacts.d.ts +39 -0
  204. package/dist/connectors/private-artifacts.d.ts.map +1 -0
  205. package/dist/connectors/private-artifacts.js +175 -0
  206. package/dist/connectors/private-artifacts.js.map +1 -0
  207. package/dist/connectors/provider-response.d.ts +20 -0
  208. package/dist/connectors/provider-response.d.ts.map +1 -0
  209. package/dist/connectors/provider-response.js +98 -0
  210. package/dist/connectors/provider-response.js.map +1 -0
  211. package/dist/connectors/recommendations.d.ts +25 -0
  212. package/dist/connectors/recommendations.d.ts.map +1 -0
  213. package/dist/connectors/recommendations.js +172 -0
  214. package/dist/connectors/recommendations.js.map +1 -0
  215. package/dist/connectors/registry.d.ts +10 -0
  216. package/dist/connectors/registry.d.ts.map +1 -0
  217. package/dist/connectors/registry.js +34 -0
  218. package/dist/connectors/registry.js.map +1 -0
  219. package/dist/connectors/rendered-page.d.ts +101 -0
  220. package/dist/connectors/rendered-page.d.ts.map +1 -0
  221. package/dist/connectors/rendered-page.js +504 -0
  222. package/dist/connectors/rendered-page.js.map +1 -0
  223. package/dist/connectors/smart-defaults.d.ts +9 -0
  224. package/dist/connectors/smart-defaults.d.ts.map +1 -0
  225. package/dist/connectors/smart-defaults.js +72 -0
  226. package/dist/connectors/smart-defaults.js.map +1 -0
  227. package/dist/connectors/types.d.ts +79 -0
  228. package/dist/connectors/types.d.ts.map +1 -0
  229. package/dist/connectors/types.js +2 -0
  230. package/dist/connectors/types.js.map +1 -0
  231. package/dist/connectors/upload.d.ts +9 -0
  232. package/dist/connectors/upload.d.ts.map +1 -0
  233. package/dist/connectors/upload.js +440 -0
  234. package/dist/connectors/upload.js.map +1 -0
  235. package/dist/connectors/website.d.ts +20 -0
  236. package/dist/connectors/website.d.ts.map +1 -0
  237. package/dist/connectors/website.js +616 -0
  238. package/dist/connectors/website.js.map +1 -0
  239. package/dist/embeddings/index.d.ts +3 -0
  240. package/dist/embeddings/index.d.ts.map +1 -0
  241. package/dist/embeddings/index.js +3 -0
  242. package/dist/embeddings/index.js.map +1 -0
  243. package/dist/embeddings/providers.d.ts +7 -0
  244. package/dist/embeddings/providers.d.ts.map +1 -0
  245. package/dist/embeddings/providers.js +176 -0
  246. package/dist/embeddings/providers.js.map +1 -0
  247. package/dist/embeddings/types.d.ts +19 -0
  248. package/dist/embeddings/types.d.ts.map +1 -0
  249. package/dist/embeddings/types.js +2 -0
  250. package/dist/embeddings/types.js.map +1 -0
  251. package/dist/eval/acceptance-fixtures.d.ts +3 -0
  252. package/dist/eval/acceptance-fixtures.d.ts.map +1 -0
  253. package/dist/eval/acceptance-fixtures.js +84 -0
  254. package/dist/eval/acceptance-fixtures.js.map +1 -0
  255. package/dist/eval/acceptance.d.ts +114 -0
  256. package/dist/eval/acceptance.d.ts.map +1 -0
  257. package/dist/eval/acceptance.js +260 -0
  258. package/dist/eval/acceptance.js.map +1 -0
  259. package/dist/eval/fixtures.d.ts +16 -0
  260. package/dist/eval/fixtures.d.ts.map +1 -0
  261. package/dist/eval/fixtures.js +119 -0
  262. package/dist/eval/fixtures.js.map +1 -0
  263. package/dist/eval/index.d.ts +63 -0
  264. package/dist/eval/index.d.ts.map +1 -0
  265. package/dist/eval/index.js +174 -0
  266. package/dist/eval/index.js.map +1 -0
  267. package/dist/index.d.ts +5 -0
  268. package/dist/index.d.ts.map +1 -0
  269. package/dist/index.js +5 -0
  270. package/dist/index.js.map +1 -0
  271. package/dist/jobs/background-worker.d.ts +31 -0
  272. package/dist/jobs/background-worker.d.ts.map +1 -0
  273. package/dist/jobs/background-worker.js +315 -0
  274. package/dist/jobs/background-worker.js.map +1 -0
  275. package/dist/jobs/import-runner.d.ts +3 -0
  276. package/dist/jobs/import-runner.d.ts.map +1 -0
  277. package/dist/jobs/import-runner.js +613 -0
  278. package/dist/jobs/import-runner.js.map +1 -0
  279. package/dist/jobs/index.d.ts +9 -0
  280. package/dist/jobs/index.d.ts.map +1 -0
  281. package/dist/jobs/index.js +8 -0
  282. package/dist/jobs/index.js.map +1 -0
  283. package/dist/jobs/progress.d.ts +3 -0
  284. package/dist/jobs/progress.d.ts.map +1 -0
  285. package/dist/jobs/progress.js +30 -0
  286. package/dist/jobs/progress.js.map +1 -0
  287. package/dist/jobs/rebuild.d.ts +13 -0
  288. package/dist/jobs/rebuild.d.ts.map +1 -0
  289. package/dist/jobs/rebuild.js +178 -0
  290. package/dist/jobs/rebuild.js.map +1 -0
  291. package/dist/jobs/server-worker.d.ts +16 -0
  292. package/dist/jobs/server-worker.d.ts.map +1 -0
  293. package/dist/jobs/server-worker.js +252 -0
  294. package/dist/jobs/server-worker.js.map +1 -0
  295. package/dist/jobs/store-adapter.d.ts +3 -0
  296. package/dist/jobs/store-adapter.d.ts.map +1 -0
  297. package/dist/jobs/store-adapter.js +37 -0
  298. package/dist/jobs/store-adapter.js.map +1 -0
  299. package/dist/jobs/types.d.ts +138 -0
  300. package/dist/jobs/types.d.ts.map +1 -0
  301. package/dist/jobs/types.js +2 -0
  302. package/dist/jobs/types.js.map +1 -0
  303. package/dist/jobs/worker.d.ts +27 -0
  304. package/dist/jobs/worker.d.ts.map +1 -0
  305. package/dist/jobs/worker.js +90 -0
  306. package/dist/jobs/worker.js.map +1 -0
  307. package/dist/media-url.d.ts +7 -0
  308. package/dist/media-url.d.ts.map +1 -0
  309. package/dist/media-url.js +15 -0
  310. package/dist/media-url.js.map +1 -0
  311. package/dist/native-artifact-reassembly.d.ts +25 -0
  312. package/dist/native-artifact-reassembly.d.ts.map +1 -0
  313. package/dist/native-artifact-reassembly.js +262 -0
  314. package/dist/native-artifact-reassembly.js.map +1 -0
  315. package/dist/native-artifact.d.ts +88 -0
  316. package/dist/native-artifact.d.ts.map +1 -0
  317. package/dist/native-artifact.js +86 -0
  318. package/dist/native-artifact.js.map +1 -0
  319. package/dist/schema/index.d.ts +5519 -0
  320. package/dist/schema/index.d.ts.map +1 -0
  321. package/dist/schema/index.js +374 -0
  322. package/dist/schema/index.js.map +1 -0
  323. package/dist/schema/migrations.d.ts +10 -0
  324. package/dist/schema/migrations.d.ts.map +1 -0
  325. package/dist/schema/migrations.js +253 -0
  326. package/dist/schema/migrations.js.map +1 -0
  327. package/dist/search/fusion.d.ts +15 -0
  328. package/dist/search/fusion.d.ts.map +1 -0
  329. package/dist/search/fusion.js +25 -0
  330. package/dist/search/fusion.js.map +1 -0
  331. package/dist/search/mode.d.ts +4 -0
  332. package/dist/search/mode.d.ts.map +1 -0
  333. package/dist/search/mode.js +13 -0
  334. package/dist/search/mode.js.map +1 -0
  335. package/dist/search/postgres-fts.d.ts +22 -0
  336. package/dist/search/postgres-fts.d.ts.map +1 -0
  337. package/dist/search/postgres-fts.js +83 -0
  338. package/dist/search/postgres-fts.js.map +1 -0
  339. package/dist/server/brand-context.d.ts +15 -0
  340. package/dist/server/brand-context.d.ts.map +1 -0
  341. package/dist/server/brand-context.js +149 -0
  342. package/dist/server/brand-context.js.map +1 -0
  343. package/dist/server/context.d.ts +77 -0
  344. package/dist/server/context.d.ts.map +1 -0
  345. package/dist/server/context.js +63 -0
  346. package/dist/server/context.js.map +1 -0
  347. package/dist/server/enrichment.d.ts +23 -0
  348. package/dist/server/enrichment.d.ts.map +1 -0
  349. package/dist/server/enrichment.js +136 -0
  350. package/dist/server/enrichment.js.map +1 -0
  351. package/dist/server/generation-artifact-access.d.ts +21 -0
  352. package/dist/server/generation-artifact-access.d.ts.map +1 -0
  353. package/dist/server/generation-artifact-access.js +111 -0
  354. package/dist/server/generation-artifact-access.js.map +1 -0
  355. package/dist/server/generation-context.d.ts +204 -0
  356. package/dist/server/generation-context.d.ts.map +1 -0
  357. package/dist/server/generation-context.js +310 -0
  358. package/dist/server/generation-context.js.map +1 -0
  359. package/dist/server/index.d.ts +22 -0
  360. package/dist/server/index.d.ts.map +1 -0
  361. package/dist/server/index.js +96 -0
  362. package/dist/server/index.js.map +1 -0
  363. package/dist/server/isolated-a2a.d.ts +172 -0
  364. package/dist/server/isolated-a2a.d.ts.map +1 -0
  365. package/dist/server/isolated-a2a.js +310 -0
  366. package/dist/server/isolated-a2a.js.map +1 -0
  367. package/dist/server/media.d.ts +15 -0
  368. package/dist/server/media.d.ts.map +1 -0
  369. package/dist/server/media.js +93 -0
  370. package/dist/server/media.js.map +1 -0
  371. package/dist/server/prompt-provider.d.ts +5 -0
  372. package/dist/server/prompt-provider.d.ts.map +1 -0
  373. package/dist/server/prompt-provider.js +59 -0
  374. package/dist/server/prompt-provider.js.map +1 -0
  375. package/dist/server/public-serialization.d.ts +160 -0
  376. package/dist/server/public-serialization.d.ts.map +1 -0
  377. package/dist/server/public-serialization.js +108 -0
  378. package/dist/server/public-serialization.js.map +1 -0
  379. package/dist/server/resource-paths.d.ts +3 -0
  380. package/dist/server/resource-paths.d.ts.map +1 -0
  381. package/dist/server/resource-paths.js +5 -0
  382. package/dist/server/resource-paths.js.map +1 -0
  383. package/dist/server/retrieval.d.ts +78 -0
  384. package/dist/server/retrieval.d.ts.map +1 -0
  385. package/dist/server/retrieval.js +443 -0
  386. package/dist/server/retrieval.js.map +1 -0
  387. package/dist/server/untrusted-reference.d.ts +8 -0
  388. package/dist/server/untrusted-reference.d.ts.map +1 -0
  389. package/dist/server/untrusted-reference.js +19 -0
  390. package/dist/server/untrusted-reference.js.map +1 -0
  391. package/dist/store/brand.d.ts +47 -0
  392. package/dist/store/brand.d.ts.map +1 -0
  393. package/dist/store/brand.js +360 -0
  394. package/dist/store/brand.js.map +1 -0
  395. package/dist/store/content.d.ts +120 -0
  396. package/dist/store/content.d.ts.map +1 -0
  397. package/dist/store/content.js +1437 -0
  398. package/dist/store/content.js.map +1 -0
  399. package/dist/store/generation.d.ts +28 -0
  400. package/dist/store/generation.d.ts.map +1 -0
  401. package/dist/store/generation.js +140 -0
  402. package/dist/store/generation.js.map +1 -0
  403. package/dist/store/helpers.d.ts +12 -0
  404. package/dist/store/helpers.d.ts.map +1 -0
  405. package/dist/store/helpers.js +41 -0
  406. package/dist/store/helpers.js.map +1 -0
  407. package/dist/store/index.d.ts +10 -0
  408. package/dist/store/index.d.ts.map +1 -0
  409. package/dist/store/index.js +10 -0
  410. package/dist/store/index.js.map +1 -0
  411. package/dist/store/inference.d.ts +57 -0
  412. package/dist/store/inference.d.ts.map +1 -0
  413. package/dist/store/inference.js +279 -0
  414. package/dist/store/inference.js.map +1 -0
  415. package/dist/store/jobs.d.ts +80 -0
  416. package/dist/store/jobs.d.ts.map +1 -0
  417. package/dist/store/jobs.js +428 -0
  418. package/dist/store/jobs.js.map +1 -0
  419. package/dist/store/packs.d.ts +33 -0
  420. package/dist/store/packs.d.ts.map +1 -0
  421. package/dist/store/packs.js +321 -0
  422. package/dist/store/packs.js.map +1 -0
  423. package/dist/store/purge.d.ts +16 -0
  424. package/dist/store/purge.d.ts.map +1 -0
  425. package/dist/store/purge.js +256 -0
  426. package/dist/store/purge.js.map +1 -0
  427. package/dist/store/sources.d.ts +76 -0
  428. package/dist/store/sources.d.ts.map +1 -0
  429. package/dist/store/sources.js +538 -0
  430. package/dist/store/sources.js.map +1 -0
  431. package/dist/store/suggestions.d.ts +28 -0
  432. package/dist/store/suggestions.d.ts.map +1 -0
  433. package/dist/store/suggestions.js +250 -0
  434. package/dist/store/suggestions.js.map +1 -0
  435. package/dist/types.d.ts +493 -0
  436. package/dist/types.d.ts.map +1 -0
  437. package/dist/types.js +2 -0
  438. package/dist/types.js.map +1 -0
  439. package/dist/vector/index.d.ts +2 -0
  440. package/dist/vector/index.d.ts.map +1 -0
  441. package/dist/vector/index.js +2 -0
  442. package/dist/vector/index.js.map +1 -0
  443. package/dist/vector/pgvector.d.ts +28 -0
  444. package/dist/vector/pgvector.d.ts.map +1 -0
  445. package/dist/vector/pgvector.js +117 -0
  446. package/dist/vector/pgvector.js.map +1 -0
  447. package/docs/evaluation.md +92 -0
  448. package/docs/llms-full.txt +168 -0
  449. package/docs/llms.txt +76 -0
  450. package/docs/skills/creative-context/SKILL.md +74 -0
  451. package/package.json +91 -0
  452. package/src/actions/agent-input-schemas.spec.ts +46 -0
  453. package/src/actions/confirm-canonical-logo.ts +20 -0
  454. package/src/actions/continue-context-import.ts +12 -0
  455. package/src/actions/creative-context-a2a.spec.ts +64 -0
  456. package/src/actions/creative-context-a2a.ts +88 -0
  457. package/src/actions/get-brand-profile.ts +16 -0
  458. package/src/actions/get-context-import-status.ts +13 -0
  459. package/src/actions/get-context-item.ts +1 -0
  460. package/src/actions/get-context-pack.ts +14 -0
  461. package/src/actions/get-creative-context.spec.ts +315 -0
  462. package/src/actions/get-creative-context.ts +148 -0
  463. package/src/actions/index.ts +65 -0
  464. package/src/actions/infer-brand-dna.ts +15 -0
  465. package/src/actions/list-canonical-logo-candidates.ts +121 -0
  466. package/src/actions/list-context-connections.spec.ts +23 -0
  467. package/src/actions/list-context-connections.ts +51 -0
  468. package/src/actions/list-context-packs.ts +17 -0
  469. package/src/actions/list-context-sources.ts +21 -0
  470. package/src/actions/list-context-suggestions.ts +30 -0
  471. package/src/actions/manage-brand-profile.ts +58 -0
  472. package/src/actions/manage-context-pack.ts +75 -0
  473. package/src/actions/manage-context-source.ts +154 -0
  474. package/src/actions/manage-layout-template.ts +51 -0
  475. package/src/actions/preview-context-import.spec.ts +64 -0
  476. package/src/actions/preview-context-import.ts +61 -0
  477. package/src/actions/process-context-purge.ts +25 -0
  478. package/src/actions/propose-brand-dna.ts +22 -0
  479. package/src/actions/propose-canonical-logo.ts +19 -0
  480. package/src/actions/publish-brand-dna.ts +25 -0
  481. package/src/actions/recommend-context-roots.ts +24 -0
  482. package/src/actions/record-context-feedback.ts +16 -0
  483. package/src/actions/review-context-items.ts +69 -0
  484. package/src/actions/run-embedding-bakeoff.ts +90 -0
  485. package/src/actions/search-creative-context.ts +47 -0
  486. package/src/actions/set-brand-dna.ts +22 -0
  487. package/src/actions/start-context-enrichment.ts +50 -0
  488. package/src/actions/start-context-import.ts +37 -0
  489. package/src/client/CreativeContextChip.tsx +162 -0
  490. package/src/client/CreativeContextPanel.tsx +2442 -0
  491. package/src/client/CreativeContextSettingsLink.tsx +30 -0
  492. package/src/client/actions.ts +438 -0
  493. package/src/client/agent-tab.tsx +58 -0
  494. package/src/client/application-state.spec.ts +41 -0
  495. package/src/client/application-state.ts +130 -0
  496. package/src/client/index.ts +62 -0
  497. package/src/client/messages.ts +1240 -0
  498. package/src/client/source-config.spec.ts +152 -0
  499. package/src/connectors/connectors.spec.ts +778 -0
  500. package/src/connectors/context.ts +83 -0
  501. package/src/connectors/document-parser.ts +5 -0
  502. package/src/connectors/figma-native.ts +1192 -0
  503. package/src/connectors/figma-native.visual.spec.ts +221 -0
  504. package/src/connectors/figma.spec.ts +812 -0
  505. package/src/connectors/figma.ts +257 -0
  506. package/src/connectors/fixtures/google-slides-native.json +353 -0
  507. package/src/connectors/google-slides-native.spec.ts +804 -0
  508. package/src/connectors/google-slides-native.ts +1656 -0
  509. package/src/connectors/google-slides-native.visual.spec.ts +119 -0
  510. package/src/connectors/google-slides.ts +1172 -0
  511. package/src/connectors/index.ts +103 -0
  512. package/src/connectors/manual.ts +132 -0
  513. package/src/connectors/normalize.ts +277 -0
  514. package/src/connectors/notion.ts +529 -0
  515. package/src/connectors/private-artifacts.spec.ts +95 -0
  516. package/src/connectors/private-artifacts.ts +248 -0
  517. package/src/connectors/provider-response.ts +144 -0
  518. package/src/connectors/recommendations.ts +237 -0
  519. package/src/connectors/registry.ts +48 -0
  520. package/src/connectors/rendered-page.ts +705 -0
  521. package/src/connectors/smart-defaults.spec.ts +135 -0
  522. package/src/connectors/smart-defaults.ts +87 -0
  523. package/src/connectors/types.ts +115 -0
  524. package/src/connectors/upload.spec.ts +175 -0
  525. package/src/connectors/upload.ts +548 -0
  526. package/src/connectors/website.spec.ts +509 -0
  527. package/src/connectors/website.ts +777 -0
  528. package/src/embeddings/index.ts +2 -0
  529. package/src/embeddings/providers.spec.ts +73 -0
  530. package/src/embeddings/providers.ts +228 -0
  531. package/src/embeddings/types.ts +24 -0
  532. package/src/eval/acceptance-fixtures.ts +97 -0
  533. package/src/eval/acceptance.spec.ts +92 -0
  534. package/src/eval/acceptance.ts +371 -0
  535. package/src/eval/connectors-golden.spec.ts +421 -0
  536. package/src/eval/eval.spec.ts +166 -0
  537. package/src/eval/fixtures/README.md +17 -0
  538. package/src/eval/fixtures/figma-brand-system-v1.json +140 -0
  539. package/src/eval/fixtures/figma-brand-system-v2.json +127 -0
  540. package/src/eval/fixtures/launch-hero.png +0 -0
  541. package/src/eval/fixtures/launch-system-v1.pptx +0 -0
  542. package/src/eval/fixtures/launch-system-v2.pptx +0 -0
  543. package/src/eval/fixtures/notion-brand-root.json +218 -0
  544. package/src/eval/fixtures/pricing-hero.png +0 -0
  545. package/src/eval/fixtures/rendered-brand-page.html +76 -0
  546. package/src/eval/fixtures.spec.ts +43 -0
  547. package/src/eval/fixtures.ts +136 -0
  548. package/src/eval/index.ts +291 -0
  549. package/src/eval/library-flow.acceptance.spec.tsx +141 -0
  550. package/src/index.ts +4 -0
  551. package/src/jobs/background-worker.ts +423 -0
  552. package/src/jobs/import-runner.spec.ts +582 -0
  553. package/src/jobs/import-runner.ts +792 -0
  554. package/src/jobs/index.ts +40 -0
  555. package/src/jobs/progress.ts +37 -0
  556. package/src/jobs/rebuild.ts +245 -0
  557. package/src/jobs/server-worker.spec.ts +159 -0
  558. package/src/jobs/server-worker.ts +344 -0
  559. package/src/jobs/store-adapter.ts +52 -0
  560. package/src/jobs/types.ts +147 -0
  561. package/src/jobs/worker.ts +152 -0
  562. package/src/manifest.spec.ts +26 -0
  563. package/src/media-url.ts +17 -0
  564. package/src/native-artifact-reassembly.spec.ts +386 -0
  565. package/src/native-artifact-reassembly.ts +406 -0
  566. package/src/native-artifact.ts +102 -0
  567. package/src/schema/index.ts +411 -0
  568. package/src/schema/migrations.spec.ts +41 -0
  569. package/src/schema/migrations.ts +258 -0
  570. package/src/search/fusion.spec.ts +21 -0
  571. package/src/search/fusion.ts +39 -0
  572. package/src/search/mode.spec.ts +28 -0
  573. package/src/search/mode.ts +21 -0
  574. package/src/search/postgres-fts.spec.ts +71 -0
  575. package/src/search/postgres-fts.ts +112 -0
  576. package/src/server/brand-context.spec.ts +43 -0
  577. package/src/server/brand-context.ts +160 -0
  578. package/src/server/context.ts +162 -0
  579. package/src/server/enrichment.ts +163 -0
  580. package/src/server/generation-artifact-access.ts +216 -0
  581. package/src/server/generation-context-a2a.spec.ts +131 -0
  582. package/src/server/generation-context-off.spec.ts +213 -0
  583. package/src/server/generation-context.spec.ts +124 -0
  584. package/src/server/generation-context.ts +493 -0
  585. package/src/server/index.ts +135 -0
  586. package/src/server/isolated-a2a.spec.ts +164 -0
  587. package/src/server/isolated-a2a.ts +413 -0
  588. package/src/server/media.spec.ts +92 -0
  589. package/src/server/media.ts +117 -0
  590. package/src/server/prompt-provider.spec.ts +78 -0
  591. package/src/server/prompt-provider.ts +73 -0
  592. package/src/server/public-serialization.spec.ts +149 -0
  593. package/src/server/public-serialization.ts +130 -0
  594. package/src/server/resource-paths.spec.ts +9 -0
  595. package/src/server/resource-paths.ts +5 -0
  596. package/src/server/retrieval-vector.spec.ts +180 -0
  597. package/src/server/retrieval.ts +587 -0
  598. package/src/server/untrusted-reference.spec.ts +22 -0
  599. package/src/server/untrusted-reference.ts +24 -0
  600. package/src/store/access.integration.spec.ts +1922 -0
  601. package/src/store/brand.ts +477 -0
  602. package/src/store/content.ts +1900 -0
  603. package/src/store/generation.ts +226 -0
  604. package/src/store/helpers.ts +53 -0
  605. package/src/store/index.ts +9 -0
  606. package/src/store/inference.spec.ts +84 -0
  607. package/src/store/inference.ts +339 -0
  608. package/src/store/invariants.spec.ts +119 -0
  609. package/src/store/jobs.ts +672 -0
  610. package/src/store/packs.ts +466 -0
  611. package/src/store/purge.ts +321 -0
  612. package/src/store/sources.spec.ts +102 -0
  613. package/src/store/sources.ts +708 -0
  614. package/src/store/suggestions.ts +333 -0
  615. package/src/types.ts +571 -0
  616. package/src/vector/index.ts +1 -0
  617. package/src/vector/pgvector.spec.ts +98 -0
  618. package/src/vector/pgvector.ts +164 -0
package/src/connectors/website.spec.ts ADDED
@@ -0,0 +1,509 @@
1
+ import { beforeEach, describe, expect, it, vi } from "vitest";
2
+
3
+ const isBlockedExtensionUrlWithDns = vi.hoisted(() => vi.fn(async () => false));
4
+ const ssrfSafeFetch = vi.hoisted(() =>
5
+ vi.fn(
6
+ async () =>
7
+ new Response(new Uint8Array([137, 80, 78, 71]), {
8
+ status: 200,
9
+ headers: { "content-type": "image/png" },
10
+ }),
11
+ ),
12
+ );
13
+
14
+ vi.mock("@agent-native/core/extensions/url-safety", () => ({
15
+ isBlockedExtensionUrlWithDns,
16
+ ssrfSafeFetch,
17
+ }));
18
+
19
+ const { LayeredRenderedPageProvider } = await import("./rendered-page.js");
20
+ const { WebsiteContextConnector, discoverWebsiteInventory } =
21
+ await import("./website.js");
22
+
23
+ function response(url: string, body: string, contentType: string): Response {
24
+ const result = new Response(body, {
25
+ status: 200,
26
+ headers: { "content-type": contentType },
27
+ });
28
+ Object.defineProperty(result, "url", { value: url });
29
+ return result;
30
+ }
31
+
32
+ describe("website context connector", () => {
33
+ beforeEach(() => {
34
+ isBlockedExtensionUrlWithDns.mockReset();
35
+ isBlockedExtensionUrlWithDns.mockResolvedValue(false);
36
+ });
37
+
38
+ it("drops signed query capabilities before website URLs become corpus ids", async () => {
39
+ const connector = new WebsiteContextConnector();
40
+ const inventory = await connector.inventory(
41
+ {
42
+ sourceId: "source-1",
43
+ config: {
44
+ urls: [
45
+ "https://example.com/brand?X-Amz-Signature=secret-value#section",
46
+ ],
47
+ },
48
+ },
49
+ { appId: "assets" },
50
+ );
51
+
52
+ expect(inventory.items[0]).toMatchObject({
53
+ externalId: "https://example.com/brand",
54
+ canonicalUrl: "https://example.com/brand",
55
+ });
56
+ expect(JSON.stringify(inventory)).not.toContain("secret-value");
57
+ });
58
+
59
+ it("honors robots, follows same-origin sitemaps, and reports bounded inventory", async () => {
60
+ const fetcher = vi.fn(async (url: string) => {
61
+ if (url.endsWith("/robots.txt")) {
62
+ return response(
63
+ url,
64
+ "User-agent: *\nUser-agent: creative-context\nDisallow: /private\nSitemap: https://example.com/site.xml\nSitemap: https://evil.example.net/stolen.xml",
65
+ "text/plain",
66
+ );
67
+ }
68
+ if (url.endsWith(".xml")) {
69
+ return response(
70
+ url,
71
+ "<urlset><url><loc>https://example.com/about</loc></url><url><loc>https://example.com/private/roadmap</loc></url><url><loc>https://evil.example.net/off-origin</loc></url></urlset>",
72
+ "application/xml",
73
+ );
74
+ }
75
+ return response(
76
+ url,
77
+ '<html><head><title>Example</title></head><body><a href="/product">Product</a><a href="/private/secret">Secret</a></body></html>',
78
+ "text/html",
79
+ );
80
+ });
81
+
82
+ const discovered = await discoverWebsiteInventory(
83
+ {
84
+ domains: ["example.com"],
85
+ maxPages: 3,
86
+ maxInventoryBytes: 50_000,
87
+ },
88
+ undefined,
89
+ fetcher as never,
90
+ );
91
+ expect(discovered.references.map((item) => item.url)).toEqual([
92
+ "https://example.com/",
93
+ "https://example.com/about",
94
+ "https://example.com/product",
95
+ ]);
96
+ expect(
97
+ discovered.references.some((item) => item.url.includes("private")),
98
+ ).toBe(false);
99
+ expect(
100
+ discovered.references.some((item) => item.url.includes("evil")),
101
+ ).toBe(false);
102
+ expect(discovered.truncated).toBe(true);
103
+ expect(fetcher).not.toHaveBeenCalledWith(
104
+ "https://evil.example.net/stolen.xml",
105
+ expect.anything(),
106
+ expect.anything(),
107
+ );
108
+
109
+ const sitemapOnly = await discoverWebsiteInventory(
110
+ {
111
+ sitemapUrls: ["https://example.com/site.xml"],
112
+ maxPages: 2,
113
+ },
114
+ undefined,
115
+ fetcher as never,
116
+ );
117
+ expect(sitemapOnly.references.map((item) => item.url)).toContain(
118
+ "https://example.com/about",
119
+ );
120
+ });
121
+
122
+ it("uses a disclosed SSRF-safe static fallback and blocks private destinations", async () => {
123
+ const staticFetch = vi.fn(async (url: string) =>
124
+ response(
125
+ url,
126
+ '<html><head><title>Brand docs</title><style>:root{--brand:#123456}</style></head><body><h1>API guide</h1><a href="/start">Start</a></body></html>',
127
+ "text/html",
128
+ ),
129
+ );
130
+ const renderer = new LayeredRenderedPageProvider({
131
+ loadPlaywright: async () => null,
132
+ staticFetch: staticFetch as never,
133
+ });
134
+ const rendered = await renderer.render({ url: "https://example.com/docs" });
135
+ expect(rendered).toMatchObject({
136
+ method: "static-html",
137
+ rendered: false,
138
+ title: "Brand docs",
139
+ classification: "documentation",
140
+ confidence: 0.45,
141
+ screenshots: [],
142
+ });
143
+ expect(rendered.warnings).toEqual(
144
+ expect.arrayContaining([
145
+ expect.stringContaining("SSRF-safe static HTML fallback"),
146
+ ]),
147
+ );
148
+ expect(rendered.extraction.internalLinks).toContain(
149
+ "https://example.com/start",
150
+ );
151
+
152
+ isBlockedExtensionUrlWithDns.mockResolvedValue(true);
153
+ await expect(
154
+ renderer.render({ url: "http://127.0.0.1/internal" }),
155
+ ).rejects.toThrow(/SSRF blocked/i);
156
+ });
157
+
158
+ it("aborts private-network browser subresources, not only document navigations", async () => {
159
+ isBlockedExtensionUrlWithDns.mockImplementation(async (url: string) =>
160
+ url.includes("10.0.0.7"),
161
+ );
162
+ const abort = vi.fn(async () => {});
163
+ const continueRoute = vi.fn(async () => {});
164
+ let routeHandler: ((route: unknown) => Promise<void>) | undefined;
165
+ const page = {
166
+ async route(
167
+ _pattern: string,
168
+ handler: (route: unknown) => Promise<void>,
169
+ ) {
170
+ routeHandler = handler;
171
+ },
172
+ async goto() {
173
+ await routeHandler?.({
174
+ request: () => ({
175
+ url: () => "http://10.0.0.7/secret.png",
176
+ isNavigationRequest: () => false,
177
+ resourceType: () => "image",
178
+ }),
179
+ abort,
180
+ continue: continueRoute,
181
+ });
182
+ },
183
+ async title() {
184
+ return "Public page";
185
+ },
186
+ url() {
187
+ return "https://example.com/";
188
+ },
189
+ locator() {
190
+ return { innerText: async () => "Public content" };
191
+ },
192
+ async setViewportSize() {},
193
+ async screenshot() {
194
+ return new Uint8Array([1, 2, 3]);
195
+ },
196
+ async evaluate() {
197
+ return {
198
+ title: "Public page",
199
+ text: "Public content",
200
+ assets: [],
201
+ internalLinks: [],
202
+ designTokens: {
203
+ colors: [],
204
+ typography: [],
205
+ spacing: [],
206
+ radii: [],
207
+ cssVariables: {},
208
+ },
209
+ };
210
+ },
211
+ };
212
+ const browser = {
213
+ contexts: () => [{ pages: () => [page], newPage: async () => page }],
214
+ newContext: async () => ({
215
+ pages: () => [page],
216
+ newPage: async () => page,
217
+ }),
218
+ close: async () => {},
219
+ };
220
+ const renderer = new LayeredRenderedPageProvider({
221
+ loadPlaywright: async () =>
222
+ ({
223
+ chromium: {
224
+ connectOverCDP: async () => browser,
225
+ launch: async () => browser,
226
+ },
227
+ }) as never,
228
+ });
229
+
230
+ await renderer.render({
231
+ url: "https://example.com/",
232
+ preferHosted: false,
233
+ });
234
+ expect(abort).toHaveBeenCalledWith("blockedbyclient");
235
+ expect(continueRoute).not.toHaveBeenCalled();
236
+ });
237
+
238
+ it("persists rendered desktop/mobile evidence and extracted design signals privately", async () => {
239
+ ssrfSafeFetch.mockResolvedValueOnce(
240
+ new Response(
241
+ '<svg xmlns="http://www.w3.org/2000/svg"><path d="M0 0h1v1z"/></svg>',
242
+ { status: 200, headers: { "content-type": "image/svg+xml" } },
243
+ ),
244
+ );
245
+ const putPrivateBlob = vi.fn(async (input: { mimeType?: string }) => ({
246
+ id: `blob-${putPrivateBlob.mock.calls.length}`,
247
+ provider: "fixture",
248
+ opaque: true as const,
249
+ encrypted: true,
250
+ mimeType: input.mimeType,
251
+ }));
252
+ const connector = new WebsiteContextConnector();
253
+ const config = { urls: ["https://example.com/"] };
254
+ const executionContext = {
255
+ appId: "assets",
256
+ ownerEmail: "owner@example.com",
257
+ putPrivateBlob,
258
+ now: () => new Date("2026-07-16T17:00:00.000Z"),
259
+ renderedPages: {
260
+ async render() {
261
+ return {
262
+ url: "https://example.com/",
263
+ finalUrl: "https://example.com/",
264
+ title: "Example brand",
265
+ text: "Built for creative teams",
266
+ method: "builder-browser" as const,
267
+ rendered: true,
268
+ warnings: [],
269
+ extraction: {
270
+ title: "Example brand",
271
+ text: "Built for creative teams",
272
+ assets: [
273
+ {
274
+ url: "https://example.com/logo.svg?token=signed-secret",
275
+ kind: "image" as const,
276
+ },
277
+ ],
278
+ internalLinks: ["https://example.com/about"],
279
+ designTokens: {
280
+ colors: ["#123456"],
281
+ typography: [{ family: "Inter", size: "16px" }],
282
+ spacing: ["16px"],
283
+ radii: ["8px"],
284
+ cssVariables: { "--brand": "#123456" },
285
+ },
286
+ },
287
+ screenshots: [
288
+ {
289
+ viewport: "desktop" as const,
290
+ width: 1440,
291
+ height: 900,
292
+ data: new Uint8Array([1]),
293
+ },
294
+ {
295
+ viewport: "mobile" as const,
296
+ width: 390,
297
+ height: 844,
298
+ data: new Uint8Array([2]),
299
+ },
300
+ ],
301
+ confidence: 0.92,
302
+ classification: "homepage" as const,
303
+ diagnostics: ["captured"],
304
+ metadata: { assetCount: 1, internalLinkCount: 1 },
305
+ };
306
+ },
307
+ },
308
+ };
309
+ const inventory = await connector.inventory(
310
+ { sourceId: "source-1", config },
311
+ executionContext,
312
+ );
313
+ const fetched = await connector.fetch(
314
+ { sourceId: "source-1", config, item: inventory.items[0] },
315
+ executionContext,
316
+ );
317
+ expect(fetched.items[0]).toMatchObject({
318
+ title: "Example brand",
319
+ rawSnapshotBlobRef: expect.stringContaining("creative-context-blob:v1:"),
320
+ thumbnailBlobRef: expect.stringContaining("creative-context-blob:v1:"),
321
+ metadata: {
322
+ confidence: 0.92,
323
+ classification: "homepage",
324
+ extraction: {
325
+ designTokens: {
326
+ colors: ["#123456"],
327
+ cssVariables: { "--brand": "#123456" },
328
+ },
329
+ },
330
+ },
331
+ media: expect.arrayContaining([
332
+ expect.objectContaining({ kind: "document", accessMode: "private" }),
333
+ expect.objectContaining({
334
+ kind: "image",
335
+ width: 1440,
336
+ height: 900,
337
+ accessMode: "private",
338
+ }),
339
+ expect.objectContaining({
340
+ kind: "image",
341
+ width: 390,
342
+ height: 844,
343
+ accessMode: "private",
344
+ }),
345
+ expect.objectContaining({
346
+ kind: "image",
347
+ provenanceUrl: "https://example.com/logo.svg",
348
+ accessMode: "private",
349
+ metadata: expect.objectContaining({ canonicalLogoCandidate: true }),
350
+ }),
351
+ ]),
352
+ });
353
+ expect(JSON.stringify(fetched.items)).not.toContain("signed-secret");
354
+ expect(putPrivateBlob).toHaveBeenCalledTimes(4);
355
+ });
356
+
357
+ it("rejects active website SVG assets without retaining their signed URL", async () => {
358
+ ssrfSafeFetch.mockResolvedValueOnce(
359
+ new Response(
360
+ '<svg xmlns="http://www.w3.org/2000/svg"><image href="https://tracker.example/pixel"/></svg>',
361
+ { status: 200, headers: { "content-type": "image/svg+xml" } },
362
+ ),
363
+ );
364
+ const connector = new WebsiteContextConnector();
365
+ const config = { urls: ["https://example.com/"] };
366
+ const inventory = await connector.inventory(
367
+ { sourceId: "source-1", config },
368
+ { appId: "assets" },
369
+ );
370
+ const fetched = await connector.fetch(
371
+ { sourceId: "source-1", config, item: inventory.items[0] },
372
+ {
373
+ appId: "assets",
374
+ putPrivateBlob: async () => ({
375
+ id: "snapshot",
376
+ provider: "fixture",
377
+ opaque: true,
378
+ encrypted: true,
379
+ }),
380
+ renderedPages: {
381
+ async render() {
382
+ return {
383
+ url: "https://example.com/",
384
+ finalUrl: "https://example.com/",
385
+ title: "Example",
386
+ text: "Brand",
387
+ method: "builder-browser" as const,
388
+ rendered: true,
389
+ warnings: [],
390
+ extraction: {
391
+ title: "Example",
392
+ text: "Brand",
393
+ assets: [
394
+ {
395
+ url: "https://example.com/unsafe.svg?token=never-store",
396
+ kind: "image" as const,
397
+ },
398
+ ],
399
+ internalLinks: [],
400
+ designTokens: {
401
+ colors: [],
402
+ typography: [],
403
+ spacing: [],
404
+ radii: [],
405
+ cssVariables: {},
406
+ },
407
+ },
408
+ screenshots: [],
409
+ confidence: 0.5,
410
+ classification: "homepage" as const,
411
+ diagnostics: [],
412
+ metadata: {},
413
+ };
414
+ },
415
+ },
416
+ },
417
+ );
418
+
419
+ expect(fetched.warnings).toEqual([
420
+ expect.stringContaining("Remote SVG contains an external reference"),
421
+ ]);
422
+ expect(JSON.stringify(fetched)).not.toContain("never-store");
423
+ expect(fetched.items[0]?.media).toHaveLength(1);
424
+ });
425
+
426
+ it("bounds hostile rendered extraction arrays and persists a valid compact snapshot", async () => {
427
+ const stored: Uint8Array[] = [];
428
+ const putPrivateBlob = vi.fn(async (input: { data: Uint8Array }) => {
429
+ stored.push(input.data);
430
+ return {
431
+ id: `blob-${stored.length}`,
432
+ provider: "fixture",
433
+ opaque: true as const,
434
+ encrypted: true,
435
+ };
436
+ });
437
+ const repeated = Array.from({ length: 5_000 }, (_, index) => index);
438
+ const connector = new WebsiteContextConnector();
439
+ const inventory = await connector.inventory(
440
+ { sourceId: "source-1", config: { urls: ["https://example.com/"] } },
441
+ { appId: "assets" },
442
+ );
443
+ const fetched = await connector.fetch(
444
+ {
445
+ sourceId: "source-1",
446
+ config: {
447
+ urls: ["https://example.com/"],
448
+ rehostAssets: false,
449
+ },
450
+ item: inventory.items[0],
451
+ },
452
+ {
453
+ appId: "assets",
454
+ putPrivateBlob,
455
+ renderedPages: {
456
+ async render() {
457
+ return {
458
+ url: "https://example.com/",
459
+ finalUrl: "https://example.com/",
460
+ title: "Example",
461
+ text: "x".repeat(3_000_000),
462
+ method: "local-playwright" as const,
463
+ rendered: true,
464
+ warnings: [],
465
+ extraction: {
466
+ title: "Example",
467
+ text: "y".repeat(3_000_000),
468
+ assets: repeated.map((index) => ({
469
+ url: `https://example.com/${index}.png`,
470
+ kind: "image" as const,
471
+ })),
472
+ internalLinks: repeated.map(
473
+ (index) => `https://example.com/${index}`,
474
+ ),
475
+ designTokens: {
476
+ colors: repeated.map((index) => `rgb(${index},0,0)`),
477
+ typography: repeated.map((index) => ({
478
+ family: `Family ${index}`,
479
+ })),
480
+ spacing: repeated.map((index) => `${index}px`),
481
+ radii: repeated.map((index) => `${index}px`),
482
+ cssVariables: Object.fromEntries(
483
+ repeated.map((index) => [`--token-${index}`, `${index}px`]),
484
+ ),
485
+ },
486
+ },
487
+ screenshots: [],
488
+ confidence: 0.9,
489
+ classification: "homepage" as const,
490
+ diagnostics: [],
491
+ metadata: { hostile: "z".repeat(3_000_000) },
492
+ };
493
+ },
494
+ },
495
+ },
496
+ );
497
+
498
+ expect(stored[0]?.byteLength).toBeLessThanOrEqual(2 * 1024 * 1024);
499
+ expect(() => JSON.parse(new TextDecoder().decode(stored[0]))).not.toThrow();
500
+ expect(
501
+ (fetched.items[0]?.metadata?.extraction as { assets: unknown[] }).assets,
502
+ ).toHaveLength(500);
503
+ expect(fetched.items[0]?.metadata?.diagnostics).toEqual(
504
+ expect.arrayContaining([
505
+ expect.stringContaining("snapshot was compacted"),
506
+ ]),
507
+ );
508
+ });
509
+ });