@expandai/sdk 0.5.1

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 (316) hide show
  1. package/CHANGELOG.md +85 -0
  2. package/LICENSE +201 -0
  3. package/README.md +361 -0
  4. package/api-promise.d.mts +2 -0
  5. package/api-promise.d.mts.map +1 -0
  6. package/api-promise.d.ts +2 -0
  7. package/api-promise.d.ts.map +1 -0
  8. package/api-promise.js +6 -0
  9. package/api-promise.js.map +1 -0
  10. package/api-promise.mjs +2 -0
  11. package/api-promise.mjs.map +1 -0
  12. package/client.d.mts +189 -0
  13. package/client.d.mts.map +1 -0
  14. package/client.d.ts +189 -0
  15. package/client.d.ts.map +1 -0
  16. package/client.js +475 -0
  17. package/client.js.map +1 -0
  18. package/client.mjs +471 -0
  19. package/client.mjs.map +1 -0
  20. package/core/api-promise.d.mts +46 -0
  21. package/core/api-promise.d.mts.map +1 -0
  22. package/core/api-promise.d.ts +46 -0
  23. package/core/api-promise.d.ts.map +1 -0
  24. package/core/api-promise.js +74 -0
  25. package/core/api-promise.js.map +1 -0
  26. package/core/api-promise.mjs +70 -0
  27. package/core/api-promise.mjs.map +1 -0
  28. package/core/error.d.mts +46 -0
  29. package/core/error.d.mts.map +1 -0
  30. package/core/error.d.ts +46 -0
  31. package/core/error.d.ts.map +1 -0
  32. package/core/error.js +113 -0
  33. package/core/error.js.map +1 -0
  34. package/core/error.mjs +97 -0
  35. package/core/error.mjs.map +1 -0
  36. package/core/resource.d.mts +6 -0
  37. package/core/resource.d.mts.map +1 -0
  38. package/core/resource.d.ts +6 -0
  39. package/core/resource.d.ts.map +1 -0
  40. package/core/resource.js +11 -0
  41. package/core/resource.js.map +1 -0
  42. package/core/resource.mjs +7 -0
  43. package/core/resource.mjs.map +1 -0
  44. package/core/uploads.d.mts +3 -0
  45. package/core/uploads.d.mts.map +1 -0
  46. package/core/uploads.d.ts +3 -0
  47. package/core/uploads.d.ts.map +1 -0
  48. package/core/uploads.js +6 -0
  49. package/core/uploads.js.map +1 -0
  50. package/core/uploads.mjs +2 -0
  51. package/core/uploads.mjs.map +1 -0
  52. package/error.d.mts +2 -0
  53. package/error.d.mts.map +1 -0
  54. package/error.d.ts +2 -0
  55. package/error.d.ts.map +1 -0
  56. package/error.js +6 -0
  57. package/error.js.map +1 -0
  58. package/error.mjs +2 -0
  59. package/error.mjs.map +1 -0
  60. package/index.d.mts +6 -0
  61. package/index.d.mts.map +1 -0
  62. package/index.d.ts +6 -0
  63. package/index.d.ts.map +1 -0
  64. package/index.js +30 -0
  65. package/index.js.map +1 -0
  66. package/index.mjs +7 -0
  67. package/index.mjs.map +1 -0
  68. package/internal/builtin-types.d.mts +73 -0
  69. package/internal/builtin-types.d.mts.map +1 -0
  70. package/internal/builtin-types.d.ts +73 -0
  71. package/internal/builtin-types.d.ts.map +1 -0
  72. package/internal/builtin-types.js +4 -0
  73. package/internal/builtin-types.js.map +1 -0
  74. package/internal/builtin-types.mjs +3 -0
  75. package/internal/builtin-types.mjs.map +1 -0
  76. package/internal/detect-platform.d.mts +15 -0
  77. package/internal/detect-platform.d.mts.map +1 -0
  78. package/internal/detect-platform.d.ts +15 -0
  79. package/internal/detect-platform.d.ts.map +1 -0
  80. package/internal/detect-platform.js +162 -0
  81. package/internal/detect-platform.js.map +1 -0
  82. package/internal/detect-platform.mjs +157 -0
  83. package/internal/detect-platform.mjs.map +1 -0
  84. package/internal/errors.d.mts +3 -0
  85. package/internal/errors.d.mts.map +1 -0
  86. package/internal/errors.d.ts +3 -0
  87. package/internal/errors.d.ts.map +1 -0
  88. package/internal/errors.js +41 -0
  89. package/internal/errors.js.map +1 -0
  90. package/internal/errors.mjs +36 -0
  91. package/internal/errors.mjs.map +1 -0
  92. package/internal/headers.d.mts +20 -0
  93. package/internal/headers.d.mts.map +1 -0
  94. package/internal/headers.d.ts +20 -0
  95. package/internal/headers.d.ts.map +1 -0
  96. package/internal/headers.js +79 -0
  97. package/internal/headers.js.map +1 -0
  98. package/internal/headers.mjs +74 -0
  99. package/internal/headers.mjs.map +1 -0
  100. package/internal/parse.d.mts +12 -0
  101. package/internal/parse.d.mts.map +1 -0
  102. package/internal/parse.d.ts +12 -0
  103. package/internal/parse.d.ts.map +1 -0
  104. package/internal/parse.js +35 -0
  105. package/internal/parse.js.map +1 -0
  106. package/internal/parse.mjs +32 -0
  107. package/internal/parse.mjs.map +1 -0
  108. package/internal/request-options.d.mts +75 -0
  109. package/internal/request-options.d.mts.map +1 -0
  110. package/internal/request-options.d.ts +75 -0
  111. package/internal/request-options.d.ts.map +1 -0
  112. package/internal/request-options.js +14 -0
  113. package/internal/request-options.js.map +1 -0
  114. package/internal/request-options.mjs +10 -0
  115. package/internal/request-options.mjs.map +1 -0
  116. package/internal/shim-types.d.mts +17 -0
  117. package/internal/shim-types.d.mts.map +1 -0
  118. package/internal/shim-types.d.ts +17 -0
  119. package/internal/shim-types.d.ts.map +1 -0
  120. package/internal/shim-types.js +4 -0
  121. package/internal/shim-types.js.map +1 -0
  122. package/internal/shim-types.mjs +3 -0
  123. package/internal/shim-types.mjs.map +1 -0
  124. package/internal/shims.d.mts +20 -0
  125. package/internal/shims.d.mts.map +1 -0
  126. package/internal/shims.d.ts +20 -0
  127. package/internal/shims.d.ts.map +1 -0
  128. package/internal/shims.js +92 -0
  129. package/internal/shims.js.map +1 -0
  130. package/internal/shims.mjs +85 -0
  131. package/internal/shims.mjs.map +1 -0
  132. package/internal/to-file.d.mts +45 -0
  133. package/internal/to-file.d.mts.map +1 -0
  134. package/internal/to-file.d.ts +45 -0
  135. package/internal/to-file.d.ts.map +1 -0
  136. package/internal/to-file.js +91 -0
  137. package/internal/to-file.js.map +1 -0
  138. package/internal/to-file.mjs +88 -0
  139. package/internal/to-file.mjs.map +1 -0
  140. package/internal/tslib.js +81 -0
  141. package/internal/tslib.mjs +17 -0
  142. package/internal/types.d.mts +69 -0
  143. package/internal/types.d.mts.map +1 -0
  144. package/internal/types.d.ts +69 -0
  145. package/internal/types.d.ts.map +1 -0
  146. package/internal/types.js +4 -0
  147. package/internal/types.js.map +1 -0
  148. package/internal/types.mjs +3 -0
  149. package/internal/types.mjs.map +1 -0
  150. package/internal/uploads.d.mts +42 -0
  151. package/internal/uploads.d.mts.map +1 -0
  152. package/internal/uploads.d.ts +42 -0
  153. package/internal/uploads.d.ts.map +1 -0
  154. package/internal/uploads.js +141 -0
  155. package/internal/uploads.js.map +1 -0
  156. package/internal/uploads.mjs +131 -0
  157. package/internal/uploads.mjs.map +1 -0
  158. package/internal/utils/base64.d.mts +3 -0
  159. package/internal/utils/base64.d.mts.map +1 -0
  160. package/internal/utils/base64.d.ts +3 -0
  161. package/internal/utils/base64.d.ts.map +1 -0
  162. package/internal/utils/base64.js +38 -0
  163. package/internal/utils/base64.js.map +1 -0
  164. package/internal/utils/base64.mjs +33 -0
  165. package/internal/utils/base64.mjs.map +1 -0
  166. package/internal/utils/bytes.d.mts +4 -0
  167. package/internal/utils/bytes.d.mts.map +1 -0
  168. package/internal/utils/bytes.d.ts +4 -0
  169. package/internal/utils/bytes.d.ts.map +1 -0
  170. package/internal/utils/bytes.js +31 -0
  171. package/internal/utils/bytes.js.map +1 -0
  172. package/internal/utils/bytes.mjs +26 -0
  173. package/internal/utils/bytes.mjs.map +1 -0
  174. package/internal/utils/env.d.mts +9 -0
  175. package/internal/utils/env.d.mts.map +1 -0
  176. package/internal/utils/env.d.ts +9 -0
  177. package/internal/utils/env.d.ts.map +1 -0
  178. package/internal/utils/env.js +22 -0
  179. package/internal/utils/env.js.map +1 -0
  180. package/internal/utils/env.mjs +18 -0
  181. package/internal/utils/env.mjs.map +1 -0
  182. package/internal/utils/log.d.mts +37 -0
  183. package/internal/utils/log.d.mts.map +1 -0
  184. package/internal/utils/log.d.ts +37 -0
  185. package/internal/utils/log.d.ts.map +1 -0
  186. package/internal/utils/log.js +86 -0
  187. package/internal/utils/log.js.map +1 -0
  188. package/internal/utils/log.mjs +80 -0
  189. package/internal/utils/log.mjs.map +1 -0
  190. package/internal/utils/path.d.mts +15 -0
  191. package/internal/utils/path.d.mts.map +1 -0
  192. package/internal/utils/path.d.ts +15 -0
  193. package/internal/utils/path.d.ts.map +1 -0
  194. package/internal/utils/path.js +79 -0
  195. package/internal/utils/path.js.map +1 -0
  196. package/internal/utils/path.mjs +74 -0
  197. package/internal/utils/path.mjs.map +1 -0
  198. package/internal/utils/sleep.d.mts +2 -0
  199. package/internal/utils/sleep.d.mts.map +1 -0
  200. package/internal/utils/sleep.d.ts +2 -0
  201. package/internal/utils/sleep.d.ts.map +1 -0
  202. package/internal/utils/sleep.js +7 -0
  203. package/internal/utils/sleep.js.map +1 -0
  204. package/internal/utils/sleep.mjs +3 -0
  205. package/internal/utils/sleep.mjs.map +1 -0
  206. package/internal/utils/uuid.d.mts +5 -0
  207. package/internal/utils/uuid.d.mts.map +1 -0
  208. package/internal/utils/uuid.d.ts +5 -0
  209. package/internal/utils/uuid.d.ts.map +1 -0
  210. package/internal/utils/uuid.js +19 -0
  211. package/internal/utils/uuid.js.map +1 -0
  212. package/internal/utils/uuid.mjs +15 -0
  213. package/internal/utils/uuid.mjs.map +1 -0
  214. package/internal/utils/values.d.mts +18 -0
  215. package/internal/utils/values.d.mts.map +1 -0
  216. package/internal/utils/values.d.ts +18 -0
  217. package/internal/utils/values.d.ts.map +1 -0
  218. package/internal/utils/values.js +112 -0
  219. package/internal/utils/values.js.map +1 -0
  220. package/internal/utils/values.mjs +94 -0
  221. package/internal/utils/values.mjs.map +1 -0
  222. package/internal/utils.d.mts +7 -0
  223. package/internal/utils.d.mts.map +1 -0
  224. package/internal/utils.d.ts +7 -0
  225. package/internal/utils.d.ts.map +1 -0
  226. package/internal/utils.js +11 -0
  227. package/internal/utils.js.map +1 -0
  228. package/internal/utils.mjs +8 -0
  229. package/internal/utils.mjs.map +1 -0
  230. package/package.json +137 -0
  231. package/resource.d.mts +2 -0
  232. package/resource.d.mts.map +1 -0
  233. package/resource.d.ts +2 -0
  234. package/resource.d.ts.map +1 -0
  235. package/resource.js +6 -0
  236. package/resource.js.map +1 -0
  237. package/resource.mjs +2 -0
  238. package/resource.mjs.map +1 -0
  239. package/resources/index.d.mts +2 -0
  240. package/resources/index.d.mts.map +1 -0
  241. package/resources/index.d.ts +2 -0
  242. package/resources/index.d.ts.map +1 -0
  243. package/resources/index.js +4 -0
  244. package/resources/index.js.map +1 -0
  245. package/resources/index.mjs +3 -0
  246. package/resources/index.mjs.map +1 -0
  247. package/resources/top-level.d.mts +374 -0
  248. package/resources/top-level.d.mts.map +1 -0
  249. package/resources/top-level.d.ts +374 -0
  250. package/resources/top-level.d.ts.map +1 -0
  251. package/resources/top-level.js +4 -0
  252. package/resources/top-level.js.map +1 -0
  253. package/resources/top-level.mjs +3 -0
  254. package/resources/top-level.mjs.map +1 -0
  255. package/resources.d.mts +2 -0
  256. package/resources.d.mts.map +1 -0
  257. package/resources.d.ts +2 -0
  258. package/resources.d.ts.map +1 -0
  259. package/resources.js +5 -0
  260. package/resources.js.map +1 -0
  261. package/resources.mjs +2 -0
  262. package/resources.mjs.map +1 -0
  263. package/src/api-promise.ts +2 -0
  264. package/src/client.ts +747 -0
  265. package/src/core/README.md +3 -0
  266. package/src/core/api-promise.ts +92 -0
  267. package/src/core/error.ts +130 -0
  268. package/src/core/resource.ts +11 -0
  269. package/src/core/uploads.ts +2 -0
  270. package/src/error.ts +2 -0
  271. package/src/index.ts +22 -0
  272. package/src/internal/README.md +3 -0
  273. package/src/internal/builtin-types.ts +93 -0
  274. package/src/internal/detect-platform.ts +196 -0
  275. package/src/internal/errors.ts +33 -0
  276. package/src/internal/headers.ts +97 -0
  277. package/src/internal/parse.ts +50 -0
  278. package/src/internal/request-options.ts +91 -0
  279. package/src/internal/shim-types.ts +26 -0
  280. package/src/internal/shims.ts +107 -0
  281. package/src/internal/to-file.ts +154 -0
  282. package/src/internal/types.ts +95 -0
  283. package/src/internal/uploads.ts +187 -0
  284. package/src/internal/utils/base64.ts +40 -0
  285. package/src/internal/utils/bytes.ts +32 -0
  286. package/src/internal/utils/env.ts +18 -0
  287. package/src/internal/utils/log.ts +127 -0
  288. package/src/internal/utils/path.ts +88 -0
  289. package/src/internal/utils/sleep.ts +3 -0
  290. package/src/internal/utils/uuid.ts +17 -0
  291. package/src/internal/utils/values.ts +105 -0
  292. package/src/internal/utils.ts +8 -0
  293. package/src/lib/.keep +4 -0
  294. package/src/resource.ts +2 -0
  295. package/src/resources/index.ts +8 -0
  296. package/src/resources/top-level.ts +445 -0
  297. package/src/resources.ts +1 -0
  298. package/src/tsconfig.json +11 -0
  299. package/src/uploads.ts +2 -0
  300. package/src/version.ts +1 -0
  301. package/uploads.d.mts +2 -0
  302. package/uploads.d.mts.map +1 -0
  303. package/uploads.d.ts +2 -0
  304. package/uploads.d.ts.map +1 -0
  305. package/uploads.js +6 -0
  306. package/uploads.js.map +1 -0
  307. package/uploads.mjs +2 -0
  308. package/uploads.mjs.map +1 -0
  309. package/version.d.mts +2 -0
  310. package/version.d.mts.map +1 -0
  311. package/version.d.ts +2 -0
  312. package/version.d.ts.map +1 -0
  313. package/version.js +5 -0
  314. package/version.js.map +1 -0
  315. package/version.mjs +2 -0
  316. package/version.mjs.map +1 -0
package/resources/top-level.d.mts ADDED
@@ -0,0 +1,374 @@
1
+ /**
2
+ * Complete response from a fetch operation
3
+ */
4
+ export interface FetchResponse {
5
+ /**
6
+ * Contains the extracted content in the formats specified by the select
7
+ * configuration
8
+ */
9
+ data: FetchResponse.Data;
10
+ }
11
+ export declare namespace FetchResponse {
12
+ /**
13
+ * Contains the extracted content in the formats specified by the select
14
+ * configuration
15
+ */
16
+ interface Data {
17
+ /**
18
+ * HTTP response information (URL, status code, optionally headers)
19
+ */
20
+ response: Data.Response;
21
+ /**
22
+ * The HTML content of the fetched page
23
+ */
24
+ html?: string;
25
+ /**
26
+ * The markdown-formatted content extracted from the page
27
+ */
28
+ markdown?: string;
29
+ /**
30
+ * Comprehensive metadata extracted from the page HTML head section
31
+ */
32
+ meta?: Data.Meta;
33
+ /**
34
+ * Base64-encoded data URI of the screenshot image
35
+ */
36
+ screenshot?: string;
37
+ /**
38
+ * Relevant snippets extracted from the page based on the search query
39
+ */
40
+ snippets?: Array<Data.Snippet>;
41
+ /**
42
+ * AI-generated summary of the page content
43
+ */
44
+ summary?: string;
45
+ }
46
+ namespace Data {
47
+ /**
48
+ * HTTP response information (URL, status code, optionally headers)
49
+ */
50
+ interface Response {
51
+ /**
52
+ * HTTP status code of the response
53
+ */
54
+ statusCode: number;
55
+ /**
56
+ * The URL that was fetched
57
+ */
58
+ url: string;
59
+ /**
60
+ * Response headers from the fetch operation (keys are lower-cased HTTP header
61
+ * names)
62
+ */
63
+ headers?: {
64
+ [key: string]: string;
65
+ };
66
+ }
67
+ /**
68
+ * Comprehensive metadata extracted from the page HTML head section
69
+ */
70
+ interface Meta {
71
+ /**
72
+ * Canonical URL from <link rel="canonical">
73
+ */
74
+ canonicalUrl?: string;
75
+ /**
76
+ * Character encoding from <meta charset="...">
77
+ */
78
+ charset?: string;
79
+ /**
80
+ * Meta description from <meta name="description">
81
+ */
82
+ description?: string;
83
+ /**
84
+ * Primary favicon URL (first icon found)
85
+ */
86
+ favicon?: string;
87
+ /**
88
+ * All icon links (favicons, apple-touch-icons, etc.)
89
+ */
90
+ icons?: Array<Meta.Icon>;
91
+ /**
92
+ * Page language from <html lang="...">
93
+ */
94
+ language?: string;
95
+ /**
96
+ * Open Graph protocol metadata for rich link previews
97
+ */
98
+ openGraph?: Meta.OpenGraph;
99
+ /**
100
+ * Page title from <title> tag
101
+ */
102
+ title?: string;
103
+ /**
104
+ * Twitter Card metadata for social sharing previews
105
+ */
106
+ twitter?: Meta.Twitter;
107
+ }
108
+ namespace Meta {
109
+ /**
110
+ * Favicon or app icon metadata from <link> tags
111
+ */
112
+ interface Icon {
113
+ /**
114
+ * Icon URL or path
115
+ */
116
+ href: string;
117
+ /**
118
+ * Link relationship type
119
+ */
120
+ rel: string;
121
+ /**
122
+ * Icon dimensions
123
+ */
124
+ sizes?: string;
125
+ /**
126
+ * MIME type of the icon
127
+ */
128
+ type?: string;
129
+ }
130
+ /**
131
+ * Open Graph protocol metadata for rich link previews
132
+ */
133
+ interface OpenGraph {
134
+ /**
135
+ * Open Graph description (og:description)
136
+ */
137
+ description?: string;
138
+ /**
139
+ * Open Graph images (og:image and related properties)
140
+ */
141
+ images?: Array<OpenGraph.Image>;
142
+ /**
143
+ * Locale in language_TERRITORY format (og:locale)
144
+ */
145
+ locale?: string;
146
+ /**
147
+ * Site name (og:site_name)
148
+ */
149
+ siteName?: string;
150
+ /**
151
+ * Open Graph title (og:title)
152
+ */
153
+ title?: string;
154
+ /**
155
+ * Open Graph type (og:type) - website, article, product, etc.
156
+ */
157
+ type?: string;
158
+ /**
159
+ * Canonical URL for the content (og:url)
160
+ */
161
+ url?: string;
162
+ }
163
+ namespace OpenGraph {
164
+ /**
165
+ * Open Graph image with optional dimensions and alt text
166
+ */
167
+ interface Image {
168
+ /**
169
+ * Image URL
170
+ */
171
+ url: string;
172
+ /**
173
+ * Image alt text for accessibility
174
+ */
175
+ alt?: string;
176
+ /**
177
+ * Image height in pixels
178
+ */
179
+ height?: number;
180
+ /**
181
+ * Image width in pixels
182
+ */
183
+ width?: number;
184
+ }
185
+ }
186
+ /**
187
+ * Twitter Card metadata for social sharing previews
188
+ */
189
+ interface Twitter {
190
+ /**
191
+ * Twitter card type (twitter:card)
192
+ */
193
+ card?: string;
194
+ /**
195
+ * Twitter @username of content creator (twitter:creator)
196
+ */
197
+ creator?: string;
198
+ /**
199
+ * Description for Twitter card (twitter:description)
200
+ */
201
+ description?: string;
202
+ /**
203
+ * Image URL for Twitter card (twitter:image)
204
+ */
205
+ image?: string;
206
+ /**
207
+ * Twitter @username of the website (twitter:site)
208
+ */
209
+ site?: string;
210
+ /**
211
+ * Title for Twitter card (twitter:title)
212
+ */
213
+ title?: string;
214
+ }
215
+ }
216
+ /**
217
+ * A relevant snippet extracted from the page, compatible with TextPart for AI
218
+ * messages
219
+ */
220
+ interface Snippet {
221
+ /**
222
+ * Original chunk index
223
+ */
224
+ index: number;
225
+ /**
226
+ * Relevance score from the reranker (0-1)
227
+ */
228
+ score: number;
229
+ /**
230
+ * The text content of the snippet
231
+ */
232
+ text: string;
233
+ /**
234
+ * Type identifier for TextPart compatibility
235
+ */
236
+ type?: 'text';
237
+ }
238
+ }
239
+ }
240
+ export type MarkdownResponse = string;
241
+ export interface FetchParams {
242
+ /**
243
+ * a string to be decoded into a URL
244
+ */
245
+ url: string;
246
+ /**
247
+ * Configuration options for browser behavior during the fetch
248
+ */
249
+ browserConfig?: FetchParams.BrowserConfig;
250
+ /**
251
+ * Specifies which content formats to include in the response
252
+ */
253
+ select?: FetchParams.Select;
254
+ }
255
+ export declare namespace FetchParams {
256
+ /**
257
+ * Configuration options for browser behavior during the fetch
258
+ */
259
+ interface BrowserConfig {
260
+ /**
261
+ * Whether to scroll the entire page to capture lazy-loaded content
262
+ */
263
+ scrollFullPage?: boolean;
264
+ }
265
+ /**
266
+ * Specifies which content formats to include in the response
267
+ */
268
+ interface Select {
269
+ /**
270
+ * Set to true to include HTML
271
+ */
272
+ html?: boolean | unknown | Array<unknown>;
273
+ /**
274
+ * Include markdown-formatted content in the response
275
+ */
276
+ markdown?: boolean | unknown | Array<unknown>;
277
+ /**
278
+ * Include page metadata in the response
279
+ */
280
+ meta?: boolean;
281
+ /**
282
+ * Configure response info options (headers inclusion)
283
+ */
284
+ response?: Select.Response;
285
+ /**
286
+ * Set to true to include a screenshot
287
+ */
288
+ screenshot?: boolean | Select.SelectScreenshotConfig;
289
+ /**
290
+ * Options for extracting relevant snippets from page content using semantic search
291
+ */
292
+ snippets?: Select.Snippets;
293
+ /**
294
+ * Set to true to generate an AI summary
295
+ */
296
+ summary?: boolean | Select.Prompt;
297
+ }
298
+ namespace Select {
299
+ /**
300
+ * Configure response info options (headers inclusion)
301
+ */
302
+ interface Response {
303
+ /**
304
+ * Whether to include HTTP response headers
305
+ */
306
+ includeHeaders?: boolean;
307
+ }
308
+ /**
309
+ * Options for customizing screenshot capture behavior
310
+ */
311
+ interface SelectScreenshotConfig {
312
+ /**
313
+ * Whether to capture the full page including content below the fold
314
+ */
315
+ fullPage?: boolean;
316
+ }
317
+ /**
318
+ * Options for extracting relevant snippets from page content using semantic search
319
+ */
320
+ interface Snippets {
321
+ /**
322
+ * Query to find relevant content snippets from the page (required, non-empty)
323
+ */
324
+ query: string;
325
+ /**
326
+ * Maximum number of snippets to return (1-50)
327
+ */
328
+ maxSnippets?: number;
329
+ /**
330
+ * Minimum relevance score threshold (0-1). Snippets below this score are filtered
331
+ * out.
332
+ */
333
+ minScore?: number;
334
+ /**
335
+ * Target snippet size in characters (100-2000)
336
+ */
337
+ targetSnippetSize?: number;
338
+ }
339
+ /**
340
+ * Options for AI-powered page summarization
341
+ */
342
+ interface Prompt {
343
+ /**
344
+ * Custom prompt for AI summarization (max 5000 characters)
345
+ */
346
+ prompt?: string;
347
+ }
348
+ }
349
+ }
350
+ export interface MarkdownParams {
351
+ /**
352
+ * The URL to fetch markdown content from
353
+ */
354
+ url: string;
355
+ /**
356
+ * Configuration options for browser behavior during the fetch
357
+ */
358
+ browserConfig?: MarkdownParams.BrowserConfig;
359
+ }
360
+ export declare namespace MarkdownParams {
361
+ /**
362
+ * Configuration options for browser behavior during the fetch
363
+ */
364
+ interface BrowserConfig {
365
+ /**
366
+ * Whether to scroll the entire page to capture lazy-loaded content
367
+ */
368
+ scrollFullPage?: boolean;
369
+ }
370
+ }
371
+ export declare namespace TopLevel {
372
+ export { type FetchResponse as FetchResponse, type MarkdownResponse as MarkdownResponse, type FetchParams as FetchParams, type MarkdownParams as MarkdownParams, };
373
+ }
374
+ //# sourceMappingURL=top-level.d.mts.map
package/resources/top-level.d.mts.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"top-level.d.mts","sourceRoot":"","sources":["../src/resources/top-level.ts"],"names":[],"mappings":"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"}