@farming-labs/docs 0.2.60 → 0.2.62

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 (51) hide show
  1. package/README.md +1 -1
  2. package/package.json +11 -1
  3. package/dist/agent-BFqyqEnC.mjs +0 -4547
  4. package/dist/agent-DlxriaTs.mjs +0 -624
  5. package/dist/agent-evals-kJs2Y9xR.mjs +0 -2144
  6. package/dist/agent-export-BgUaiW8f.mjs +0 -869
  7. package/dist/agent-scope-CCaIY1aK.mjs +0 -283
  8. package/dist/agents-Djh-HXih.mjs +0 -219
  9. package/dist/analytics-Bx44lg6d.mjs +0 -177
  10. package/dist/cli/index.d.mts +0 -15
  11. package/dist/cli/index.mjs +0 -452
  12. package/dist/client/react.d.mts +0 -45
  13. package/dist/client/react.mjs +0 -223
  14. package/dist/cloud-BH_sHX64.mjs +0 -1615
  15. package/dist/cloud-analytics-CSyFE6SS.mjs +0 -132
  16. package/dist/cloud-ask-ai-B2WnG4fF.d.mts +0 -23
  17. package/dist/cloud-ask-ai-hnJfj8-X.mjs +0 -382
  18. package/dist/code-blocks-qe0T8-xe.mjs +0 -871
  19. package/dist/codeblocks-Bq67u32v.mjs +0 -250
  20. package/dist/config-DASewQ0x.mjs +0 -363
  21. package/dist/dev-DgY5xGl9.mjs +0 -1333
  22. package/dist/docs-cloud-server.d.mts +0 -70
  23. package/dist/docs-cloud-server.mjs +0 -310
  24. package/dist/doctor-CO1VMcF_.mjs +0 -1906
  25. package/dist/downgrade-BZs86NVr.mjs +0 -184
  26. package/dist/errors-CVqZ3kOO.mjs +0 -20
  27. package/dist/golden-evaluations-BN9u2wxw.mjs +0 -1483
  28. package/dist/i18n-CAlj1ADU.mjs +0 -40
  29. package/dist/index.d.mts +0 -1099
  30. package/dist/index.mjs +0 -9
  31. package/dist/init-Bd_k06bR.mjs +0 -1233
  32. package/dist/mcp-B_yXL5G5.mjs +0 -137
  33. package/dist/mcp.d.mts +0 -287
  34. package/dist/mcp.mjs +0 -4135
  35. package/dist/metadata-BDuewuzq.mjs +0 -237
  36. package/dist/package-version-qik_4J6C.mjs +0 -128
  37. package/dist/reading-time-BkEft6SD.mjs +0 -741
  38. package/dist/review-NC-sOdXn.mjs +0 -665
  39. package/dist/robots-DskPvGPw.mjs +0 -178
  40. package/dist/robots-ltltiLJF.mjs +0 -197
  41. package/dist/search-C1JitPwi.d.mts +0 -397
  42. package/dist/search-D57JXQLj.mjs +0 -1758
  43. package/dist/search-o4Ud6OXv.mjs +0 -102
  44. package/dist/server.d.mts +0 -341
  45. package/dist/server.mjs +0 -11
  46. package/dist/sitemap-Cq-Yj_iA.mjs +0 -247
  47. package/dist/sitemap-server-C1ibVKOy.mjs +0 -1137
  48. package/dist/templates-DNw15P-x.mjs +0 -2373
  49. package/dist/types-XHABMh_f.d.mts +0 -3248
  50. package/dist/upgrade-BCJTCW3O.mjs +0 -56
  51. package/dist/utils-6UCLxv4B.mjs +0 -225
@@ -1,397 +0,0 @@
1
- import { An as ResolvedDocsRelatedLink, Bn as TypesenseDocsSearchConfig, Bt as DocsSearchDocument, Ct as DocsObservabilityConfig, F as DocsAnalyticsConfig, Ft as DocsSearchAdapter, Gt as DocsSearchSourcePage, I as DocsAnalyticsEvent, Kt as DocsSitemapConfig, L as DocsAnalyticsEventInput, Lt as DocsSearchAdapterFactory, M as DocsAgentTraceEventInput, Rt as DocsSearchChunkingConfig, Tt as DocsObservabilityEventInput, Ut as DocsSearchResult, f as CustomDocsSearchConfig, fn as OpenDocsProvider, hn as OpenDocsTarget, ln as McpDocsSearchConfig, q as DocsAskAIMcpConfig, r as AlgoliaDocsSearchConfig, wt as DocsObservabilityEvent, zt as DocsSearchConfig } from "./types-XHABMh_f.mjs";
2
-
3
- //#region src/analytics.d.ts
4
- declare const DOCS_AGENT_TRACE_EVENT_TYPES: readonly ["run.start", "run.end", "run.error", "user.input", "prompt.build", "retrieval.query", "retrieval.result", "retrieval.error", "model.call", "model.response", "model.stream", "model.error", "tool.call", "tool.result", "tool.error", "retry", "timeout", "error", "agent.final"];
5
- interface DocsAgentTraceContext {
6
- traceId: string;
7
- name: string;
8
- startedAt: string;
9
- startedMs: number;
10
- }
11
- interface ResolvedDocsAnalyticsConfig {
12
- enabled: boolean;
13
- console: false | "log" | "info" | "debug";
14
- includeInputs: boolean;
15
- onEvent?: (event: DocsAnalyticsEvent) => void | Promise<void>;
16
- }
17
- interface ResolvedDocsObservabilityConfig {
18
- enabled: boolean;
19
- console: false | "log" | "info" | "debug";
20
- includeInputs: boolean;
21
- onEvent?: (event: DocsObservabilityEvent) => void | Promise<void>;
22
- }
23
- declare function createDocsAgentTraceId(prefix?: string): string;
24
- declare function createDocsAgentTraceContext(name?: string): DocsAgentTraceContext;
25
- declare function getDocsRequestAnalyticsProperties(request: Request): Record<string, unknown>;
26
- declare function resolveDocsAnalyticsConfig(analytics?: boolean | DocsAnalyticsConfig): ResolvedDocsAnalyticsConfig;
27
- declare function resolveDocsObservabilityConfig(observability?: boolean | DocsObservabilityConfig): ResolvedDocsObservabilityConfig;
28
- declare function emitDocsAnalyticsEvent(analytics: boolean | DocsAnalyticsConfig | undefined, event: DocsAnalyticsEventInput): Promise<void>;
29
- declare function emitDocsObservabilityEvent(observability: boolean | DocsObservabilityConfig | undefined, event: DocsObservabilityEventInput): Promise<void>;
30
- declare function emitDocsAgentTraceEvent(observability: boolean | DocsObservabilityConfig | undefined, event: DocsAgentTraceEventInput): Promise<void>;
31
- //#endregion
32
- //#region src/standards-discovery.d.ts
33
- declare const DEFAULT_API_CATALOG_ROUTE = "/.well-known/api-catalog";
34
- declare const DEFAULT_API_CATALOG_FORMAT = "api-catalog";
35
- declare const API_CATALOG_PROFILE_URI = "https://www.rfc-editor.org/info/rfc9727";
36
- declare const API_CATALOG_MEDIA_TYPE = "application/linkset+json";
37
- declare const DEFAULT_AGENT_SKILLS_INDEX_ROUTE = "/.well-known/agent-skills/index.json";
38
- declare const DEFAULT_AGENT_SKILLS_ROUTE_PREFIX = "/.well-known/agent-skills";
39
- declare const DEFAULT_AGENT_SKILLS_ROUTE_PATTERN = "/.well-known/agent-skills/{name}/SKILL.md";
40
- declare const DEFAULT_AGENT_SKILLS_INDEX_FORMAT = "agent-skills";
41
- declare const DEFAULT_AGENT_SKILL_FORMAT = "agent-skill";
42
- declare const AGENT_SKILLS_DISCOVERY_SCHEMA_URI = "https://schemas.agentskills.io/discovery/0.2.0/schema.json";
43
- interface DocsAgentSkillIndexEntry {
44
- name: string;
45
- type: "skill-md";
46
- description: string;
47
- url: string;
48
- digest: `sha256:${string}`;
49
- }
50
- interface DocsAgentSkillsIndex {
51
- $schema: typeof AGENT_SKILLS_DISCOVERY_SCHEMA_URI;
52
- skills: DocsAgentSkillIndexEntry[];
53
- }
54
- interface DocsPublishedAgentSkill extends DocsAgentSkillIndexEntry {
55
- content: string;
56
- sha256: string;
57
- }
58
- interface DocsPublishedAgentSkillOptions {
59
- preferredDocument?: string | null;
60
- fallbackDocument: string;
61
- }
62
- interface DocsApiCatalogLinkTarget {
63
- href: string;
64
- type?: string;
65
- title?: string;
66
- }
67
- interface DocsApiCatalogLinkContext {
68
- anchor: string;
69
- item?: DocsApiCatalogLinkTarget[];
70
- "api-catalog"?: DocsApiCatalogLinkTarget[];
71
- "service-desc"?: DocsApiCatalogLinkTarget[];
72
- "service-doc"?: DocsApiCatalogLinkTarget[];
73
- "service-meta"?: DocsApiCatalogLinkTarget[];
74
- }
75
- interface DocsApiCatalog {
76
- linkset: DocsApiCatalogLinkContext[];
77
- }
78
- interface DocsApiCatalogOptions {
79
- origin: string;
80
- docsRoute?: string;
81
- apiRoute?: string | null;
82
- /** Additional HTTP API endpoints to list as RFC 9727 `item` links. */
83
- apiRoutes?: readonly {
84
- route: string;
85
- type?: string;
86
- title?: string;
87
- }[];
88
- configRoute?: string | null;
89
- diagnosticsRoute?: string | null;
90
- agentManifestRoute?: string | null;
91
- agentSkillsIndexRoute?: string | null;
92
- agentsRoute?: string | null;
93
- skillRoute?: string | null;
94
- markdownRootRoute?: string | null;
95
- llmsRoutes?: readonly string[];
96
- sitemapRoutes?: readonly string[];
97
- robotsRoute?: string | null;
98
- mcpRoute?: string | null;
99
- feedbackRoutes?: readonly string[];
100
- openapiRoute?: string | null;
101
- apiReferenceRoute?: string | null;
102
- }
103
- type DocsStandardsDiscoveryRequest = {
104
- kind: "api-catalog";
105
- } | {
106
- kind: "agent-skills-index";
107
- } | {
108
- kind: "agent-skill";
109
- name: string;
110
- };
111
- interface DocsDiscoveryApiRouteOptions {
112
- /** Same-origin Docs API pathname used by query-form discovery. @default "/api/docs" */
113
- apiRoute?: string;
114
- }
115
- interface DocsStandardsDiscoveryRouteOptions extends DocsDiscoveryApiRouteOptions {}
116
- interface CreateDocsStandardsResponseOptions {
117
- request: Request;
118
- apiCatalog?: DocsApiCatalog;
119
- /** Whether the RFC 9727 catalog is exposed. Defaults to true. */
120
- apiCatalogEnabled?: boolean;
121
- /** Internal docs API route used for query-form forwarding. */
122
- apiRoute?: string;
123
- preferredSkillDocument?: string | null;
124
- fallbackSkillDocument: string;
125
- }
126
- /** Resolve the same-origin Docs API pathname used by query-form discovery routes. */
127
- declare function resolveDocsDiscoveryApiRoute(apiRoute?: string): string;
128
- /** Build an RFC 9727 API Catalog using the RFC 9264 JSON Linkset representation. */
129
- declare function buildDocsApiCatalog(options: DocsApiCatalogOptions): DocsApiCatalog;
130
- declare function sha256DocsDiscoveryContent(content: string): Promise<string>;
131
- /** Select a valid public skill and hash the exact bytes returned by its standards route. */
132
- declare function resolveDocsPublishedAgentSkill({
133
- preferredDocument,
134
- fallbackDocument
135
- }: DocsPublishedAgentSkillOptions): Promise<DocsPublishedAgentSkill>;
136
- declare function buildDocsAgentSkillsIndex(skills: DocsPublishedAgentSkill | readonly DocsPublishedAgentSkill[]): DocsAgentSkillsIndex;
137
- declare function resolveDocsStandardsDiscoveryRequest(url: URL, options?: DocsStandardsDiscoveryRouteOptions): DocsStandardsDiscoveryRequest | null;
138
- declare function isDocsStandardsDiscoveryRequest(url: URL, options?: DocsStandardsDiscoveryRouteOptions): boolean;
139
- /** Cross-link the standards endpoints without replacing an existing canonical Link value. */
140
- declare function getDocsDiscoveryLinkHeader(options?: {
141
- includeApiCatalog?: boolean;
142
- includeManifest?: boolean;
143
- includeSkills?: boolean;
144
- }): string;
145
- declare function appendDocsDiscoveryLinkHeader(headers: Headers, value?: string): Headers;
146
- /** Return one RFC 9727 or Agent Skills discovery response, or null for unrelated requests. */
147
- declare function createDocsStandardsResponse({
148
- request,
149
- apiCatalog,
150
- apiCatalogEnabled,
151
- apiRoute,
152
- preferredSkillDocument,
153
- fallbackSkillDocument
154
- }: CreateDocsStandardsResponseOptions): Promise<Response | null>;
155
- //#endregion
156
- //#region src/audience.d.ts
157
- /** The two content projections emitted by the docs framework. */
158
- type DocsContentAudience = "human" | "agent";
159
- /** Resolve whether content with an optional audience restriction is visible. */
160
- declare function resolveDocsAudienceExposure(only: unknown, audience: DocsContentAudience): boolean;
161
- interface DocsAudienceMdxIssue {
162
- code: "missing-only" | "invalid-only" | "dynamic-only" | "ignored-agent-only" | "ignored-human-only";
163
- index: number;
164
- message: string;
165
- }
166
- /** Find audience declarations that cannot be projected consistently at build time. */
167
- declare function findDocsAudienceMdxIssues(content: string): DocsAudienceMdxIssue[];
168
- /**
169
- * Resolve MDX into its human or agent projection.
170
- *
171
- * `<Agent>` is shorthand for `<Audience only="agent">`, while `<Human>` is
172
- * shorthand for `<Audience only="human">`. Unknown `Audience.only` values are
173
- * treated as shared content so an authoring typo never silently deletes content.
174
- * These primitives shape content for each surface; they are not an access-control boundary.
175
- */
176
- declare function resolveDocsAudienceMdxContent(content: string, audience: DocsContentAudience): string;
177
- /** Backwards-compatible name retained for existing integrations. */
178
- declare function resolveDocsAgentMdxContent(content: string, audience: DocsContentAudience): string;
179
- //#endregion
180
- //#region src/prompt-utils.d.ts
181
- type PromptAction = "copy" | "open";
182
- interface SerializedOpenDocsProvider {
183
- name: string;
184
- iconHtml?: string;
185
- urlTemplate: string;
186
- promptUrlTemplate?: string;
187
- target?: OpenDocsTarget;
188
- prompt?: string;
189
- }
190
- interface PromptProviderChoice {
191
- name: string;
192
- iconHtml?: string;
193
- urlTemplate: string;
194
- }
195
- type PromptProviderInput = Pick<SerializedOpenDocsProvider, "name" | "iconHtml"> & Partial<Pick<SerializedOpenDocsProvider, "promptUrlTemplate" | "urlTemplate">>;
196
- interface SerializeOpenDocsProviderOptions {
197
- target?: OpenDocsTarget;
198
- prompt?: string;
199
- }
200
- declare const DEFAULT_PROMPT_PROVIDER_TEMPLATES: Record<string, string>;
201
- declare const DEFAULT_OPEN_DOCS_TARGET: OpenDocsTarget;
202
- declare const DEFAULT_OPEN_DOCS_PROMPT = "Read this documentation: {url}";
203
- declare const DEFAULT_OPEN_DOCS_PROVIDER_IDS: readonly ["chatgpt", "claude"];
204
- declare function normalizePromptProviderName(name: string): string;
205
- declare function serializeDocsIcon(icon: unknown): string | undefined;
206
- declare function serializeDocsIconRegistry(icons?: Record<string, unknown>): Record<string, string> | undefined;
207
- declare function serializeOpenDocsProviders(providers?: OpenDocsProvider[], options?: SerializeOpenDocsProviderOptions): SerializedOpenDocsProvider[] | undefined;
208
- declare function serializeOpenDocsProvider(provider: OpenDocsProvider, options?: SerializeOpenDocsProviderOptions): SerializedOpenDocsProvider | undefined;
209
- declare function parsePromptStringArray(value: unknown): string[] | undefined;
210
- declare function resolvePromptProviderChoices(availableProviders?: PromptProviderInput[], preferredNames?: string[]): PromptProviderChoice[];
211
- declare function sanitizePromptText(text: string): string;
212
- //#endregion
213
- //#region src/sitemap.d.ts
214
- declare const DEFAULT_SITEMAP_XML_ROUTE = "/sitemap.xml";
215
- declare const DEFAULT_SITEMAP_MD_ROUTE = "/sitemap.md";
216
- declare const DEFAULT_SITEMAP_MD_DOCS_ROUTE = "/docs/sitemap.md";
217
- declare const DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE = "/.well-known/sitemap.md";
218
- declare const DEFAULT_SITEMAP_MANIFEST_PATH = ".farming-labs/sitemap-manifest.json";
219
- type DocsSitemapFormat = "xml" | "markdown";
220
- interface DocsSitemapPageInput {
221
- slug?: string;
222
- url: string;
223
- /** Override the public Markdown representation URL when it differs from `${url}.md`. */
224
- markdownUrl?: string;
225
- title: string;
226
- description?: string;
227
- related?: ResolvedDocsRelatedLink[];
228
- sourcePath?: string;
229
- lastmod?: string;
230
- lastModified?: string;
231
- }
232
- interface DocsSitemapManifestPage {
233
- url: string;
234
- absoluteUrl?: string;
235
- markdownUrl: string;
236
- title: string;
237
- description?: string;
238
- sourcePath?: string;
239
- lastmod?: string;
240
- lastmodSource?: "git" | "filesystem" | "frontmatter" | "manifest" | "unknown";
241
- related?: string[];
242
- }
243
- interface DocsSitemapManifest {
244
- version: 1;
245
- generatedAt: string;
246
- baseUrl?: string;
247
- entry: string;
248
- siteTitle?: string;
249
- pages: DocsSitemapManifestPage[];
250
- }
251
- interface DocsSitemapResolvedConfig {
252
- enabled: boolean;
253
- routePrefix: string;
254
- baseUrl?: string;
255
- manifestPath: string;
256
- xml: {
257
- enabled: boolean;
258
- includeLastmod: boolean;
259
- route: string;
260
- };
261
- markdown: {
262
- enabled: boolean;
263
- includeDescriptions: boolean;
264
- includeLastmod: boolean;
265
- linkTarget: "html" | "markdown" | "both";
266
- route: string;
267
- docsRoute?: string;
268
- wellKnownRoute: string;
269
- };
270
- }
271
- interface CreateDocsSitemapResponseOptions extends DocsDiscoveryApiRouteOptions {
272
- request: Request;
273
- sitemap?: boolean | DocsSitemapConfig;
274
- entry?: string;
275
- siteTitle?: string;
276
- baseUrl?: string;
277
- pages: DocsSitemapPageInput[];
278
- manifest?: DocsSitemapManifest | null;
279
- }
280
- declare function resolveDocsSitemapConfig(sitemap?: boolean | DocsSitemapConfig, defaults?: {
281
- baseUrl?: string;
282
- }): DocsSitemapResolvedConfig;
283
- declare function resolveDocsSitemapRequest(url: URL, sitemap?: boolean | DocsSitemapConfig, options?: DocsDiscoveryApiRouteOptions): DocsSitemapFormat | null;
284
- declare function toDocsSitemapMarkdownUrl(url: string): string;
285
- declare function buildDocsSitemapManifest(options: {
286
- pages: DocsSitemapPageInput[];
287
- entry?: string;
288
- siteTitle?: string;
289
- baseUrl?: string;
290
- generatedAt?: string;
291
- resolveLastmod?: (page: DocsSitemapPageInput) => {
292
- lastmod?: string;
293
- lastmodSource?: DocsSitemapManifestPage["lastmodSource"];
294
- } | undefined;
295
- }): DocsSitemapManifest;
296
- declare function renderDocsSitemapXml(manifest: DocsSitemapManifest, options?: {
297
- baseUrl?: string;
298
- includeLastmod?: boolean;
299
- }): string;
300
- declare function renderDocsSitemapMarkdown(manifest: DocsSitemapManifest, options?: {
301
- baseUrl?: string;
302
- includeDescriptions?: boolean;
303
- includeLastmod?: boolean;
304
- linkTarget?: "html" | "markdown" | "both";
305
- }): string;
306
- declare function readDocsSitemapManifestFromContentMap(contentMap?: Record<string, string> | null): DocsSitemapManifest | null;
307
- declare function resolveDocsSitemapPageLastmod(manifest: DocsSitemapManifest | null | undefined, url: string): string | undefined;
308
- declare function createDocsSitemapResponse({
309
- request,
310
- apiRoute,
311
- sitemap,
312
- entry,
313
- siteTitle,
314
- baseUrl,
315
- pages,
316
- manifest
317
- }: CreateDocsSitemapResponseOptions): Response | null;
318
- //#endregion
319
- //#region src/search.d.ts
320
- interface DocsAskAIContextResult extends DocsSearchResult {
321
- title: string;
322
- contextContent: string;
323
- }
324
- interface DocsAskAIContext {
325
- context: string;
326
- /** Structured production context blocks; avoids reparsing markdown horizontal rules. */
327
- blocks: Array<{
328
- text: string;
329
- result: DocsAskAIContextResult;
330
- }>;
331
- results: DocsAskAIContextResult[];
332
- searchResults: DocsSearchResult[];
333
- packageHints: DocsAskAIPackageHints;
334
- }
335
- interface DocsAskAIPackageHints {
336
- packages: string[];
337
- imports: string[];
338
- installCommands: string[];
339
- }
340
- declare function inferDocsAskAIPackageHints(content: string): DocsAskAIPackageHints;
341
- declare function formatDocsAskAIPackageHints(hints: DocsAskAIPackageHints, packageName?: string): string | undefined;
342
- declare function buildDocsSearchDocuments(pages: DocsSearchSourcePage[], chunking?: DocsSearchChunkingConfig, audience?: DocsContentAudience): DocsSearchDocument[];
343
- declare function createSimpleSearchAdapter(): DocsSearchAdapter;
344
- declare function createTypesenseSearchAdapter(config: TypesenseDocsSearchConfig): DocsSearchAdapter;
345
- declare function resolveSearchRequestConfig(search: boolean | DocsSearchConfig | undefined, requestUrl?: string): boolean | DocsSearchConfig | undefined;
346
- declare function resolveAskAISearchRequestConfig(options: {
347
- search: boolean | DocsSearchConfig | undefined;
348
- useMcp?: boolean | DocsAskAIMcpConfig;
349
- mcpEndpoint?: string;
350
- mcpEnabled?: boolean;
351
- mcpSearchEnabled?: boolean;
352
- requestUrl?: string;
353
- }): boolean | DocsSearchConfig | undefined;
354
- declare function createMcpSearchAdapter(config: McpDocsSearchConfig): DocsSearchAdapter;
355
- declare function createAlgoliaSearchAdapter(config: AlgoliaDocsSearchConfig): DocsSearchAdapter;
356
- declare function performDocsSearch(options: {
357
- pages: DocsSearchSourcePage[];
358
- query: string;
359
- search?: boolean | DocsSearchConfig; /** Selects which audience projection is searchable. Public site search defaults to human. */
360
- audience?: DocsContentAudience;
361
- locale?: string;
362
- pathname?: string;
363
- siteTitle?: string; /** Canonical docs URL used to distinguish same-site absolute hits from foreign MCP results. */
364
- baseUrl?: string;
365
- limit?: number;
366
- /**
367
- * Controls provider failures. Runtime search keeps the resilient `fallback` default;
368
- * diagnostics can request `throw` so a broken configured provider cannot be scored as
369
- * successful simple search.
370
- */
371
- failureMode?: "fallback" | "throw";
372
- /**
373
- * Whether non-simple provider hits are supplemented with exact/local simple results.
374
- * Runtime search defaults to true; provider diagnostics can disable supplementation.
375
- */
376
- supplementExternalResults?: boolean; /** Fail closed on absolute provider hits when no canonical docs origin is available. */
377
- strictExternalOrigins?: boolean; /** Optional cancellation signal forwarded to adapters and their managed requests. */
378
- signal?: AbortSignal;
379
- }): Promise<DocsSearchResult[]>;
380
- declare function buildDocsAskAIContext(options: {
381
- pages: DocsSearchSourcePage[];
382
- query: string;
383
- search?: boolean | DocsSearchConfig;
384
- locale?: string;
385
- pathname?: string;
386
- siteTitle?: string;
387
- baseUrl?: string;
388
- limit?: number;
389
- maxContextChars?: number;
390
- maxResultChars?: number; /** See `performDocsSearch.failureMode`. Defaults to resilient runtime fallback. */
391
- searchFailureMode?: "fallback" | "throw"; /** See `performDocsSearch.strictExternalOrigins`. */
392
- strictExternalOrigins?: boolean; /** Optional cancellation signal forwarded to the configured search provider. */
393
- signal?: AbortSignal;
394
- }): Promise<DocsAskAIContext>;
395
- declare function createCustomSearchAdapter(adapter: DocsSearchAdapter | DocsSearchAdapterFactory): CustomDocsSearchConfig;
396
- //#endregion
397
- export { resolveDocsAudienceMdxContent as $, resolveDocsSitemapRequest as A, resolveDocsStandardsDiscoveryRequest as At, normalizePromptProviderName as B, emitDocsObservabilityEvent as Bt, buildDocsSitemapManifest as C, buildDocsAgentSkillsIndex as Ct, renderDocsSitemapXml as D, isDocsStandardsDiscoveryRequest as Dt, renderDocsSitemapMarkdown as E, getDocsDiscoveryLinkHeader as Et, DEFAULT_PROMPT_PROVIDER_TEMPLATES as F, ResolvedDocsObservabilityConfig as Ft, serializeDocsIconRegistry as G, resolvePromptProviderChoices as H, resolveDocsAnalyticsConfig as Ht, PromptAction as I, createDocsAgentTraceContext as It, DocsAudienceMdxIssue as J, serializeOpenDocsProvider as K, PromptProviderChoice as L, createDocsAgentTraceId as Lt, DEFAULT_OPEN_DOCS_PROMPT as M, DOCS_AGENT_TRACE_EVENT_TYPES as Mt, DEFAULT_OPEN_DOCS_PROVIDER_IDS as N, DocsAgentTraceContext as Nt, resolveDocsSitemapConfig as O, resolveDocsDiscoveryApiRoute as Ot, DEFAULT_OPEN_DOCS_TARGET as P, ResolvedDocsAnalyticsConfig as Pt, resolveDocsAudienceExposure as Q, SerializeOpenDocsProviderOptions as R, emitDocsAgentTraceEvent as Rt, DocsSitemapResolvedConfig as S, appendDocsDiscoveryLinkHeader as St, readDocsSitemapManifestFromContentMap as T, createDocsStandardsResponse as Tt, sanitizePromptText as U, resolveDocsObservabilityConfig as Ut, parsePromptStringArray as V, getDocsRequestAnalyticsProperties as Vt, serializeDocsIcon as W, findDocsAudienceMdxIssues as X, DocsContentAudience as Y, resolveDocsAgentMdxContent as Z, DEFAULT_SITEMAP_XML_ROUTE as _, DocsDiscoveryApiRouteOptions as _t, createMcpSearchAdapter as a, DEFAULT_AGENT_SKILLS_INDEX_ROUTE as at, DocsSitemapManifestPage as b, DocsStandardsDiscoveryRequest as bt, formatDocsAskAIPackageHints as c, DEFAULT_AGENT_SKILL_FORMAT as ct, resolveAskAISearchRequestConfig as d, DocsAgentSkillIndexEntry as dt, AGENT_SKILLS_DISCOVERY_SCHEMA_URI as et, resolveSearchRequestConfig as f, DocsAgentSkillsIndex as ft, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as g, DocsApiCatalogOptions as gt, DEFAULT_SITEMAP_MD_ROUTE as h, DocsApiCatalogLinkTarget as ht, createCustomSearchAdapter as i, DEFAULT_AGENT_SKILLS_INDEX_FORMAT as it, toDocsSitemapMarkdownUrl as j, sha256DocsDiscoveryContent as jt, resolveDocsSitemapPageLastmod as k, resolveDocsPublishedAgentSkill as kt, inferDocsAskAIPackageHints as l, DEFAULT_API_CATALOG_FORMAT as lt, DEFAULT_SITEMAP_MD_DOCS_ROUTE as m, DocsApiCatalogLinkContext as mt, buildDocsSearchDocuments as n, API_CATALOG_PROFILE_URI as nt, createSimpleSearchAdapter as o, DEFAULT_AGENT_SKILLS_ROUTE_PATTERN as ot, DEFAULT_SITEMAP_MANIFEST_PATH as p, DocsApiCatalog as pt, serializeOpenDocsProviders as q, createAlgoliaSearchAdapter as r, CreateDocsStandardsResponseOptions as rt, createTypesenseSearchAdapter as s, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX as st, buildDocsAskAIContext as t, API_CATALOG_MEDIA_TYPE as tt, performDocsSearch as u, DEFAULT_API_CATALOG_ROUTE as ut, DocsSitemapFormat as v, DocsPublishedAgentSkill as vt, createDocsSitemapResponse as w, buildDocsApiCatalog as wt, DocsSitemapPageInput as x, DocsStandardsDiscoveryRouteOptions as xt, DocsSitemapManifest as y, DocsPublishedAgentSkillOptions as yt, SerializedOpenDocsProvider as z, emitDocsAnalyticsEvent as zt };