@farming-labs/docs 0.2.54 → 0.2.56

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 (28) hide show
  1. package/dist/{agent-BXvi0uhS.mjs → agent-3IpxY9F6.mjs} +3 -2
  2. package/dist/{agent-DXkXi-pS.mjs → agent-CxDzPqtl.mjs} +1121 -53
  3. package/dist/{agent-export-n-a0GbeU.mjs → agent-export-BtlITzt3.mjs} +10 -5
  4. package/dist/{agent-surface-drift-LS8zQgbq.mjs → agent-surface-drift-rGFS38Ak.mjs} +61 -63
  5. package/dist/{agents-BJaRQimo.mjs → agents-BguzxLhO.mjs} +3 -3
  6. package/dist/cli/index.mjs +14 -14
  7. package/dist/client/react.d.mts +1 -1
  8. package/dist/{cloud-ask-ai-466g6uAi.d.mts → cloud-ask-ai-CvRVnwdK.d.mts} +1 -1
  9. package/dist/docs-cloud-server.d.mts +2 -2
  10. package/dist/{doctor-CQpQ2zZm.mjs → doctor-Cra5qEEi.mjs} +11 -11
  11. package/dist/index.d.mts +12 -4
  12. package/dist/index.mjs +5 -5
  13. package/dist/{mcp-DnxZZWpY.mjs → mcp-BwYAu9DJ.mjs} +3 -3
  14. package/dist/mcp.d.mts +1 -1
  15. package/dist/mcp.mjs +17 -59
  16. package/dist/{reading-time-BrTd3DIh.mjs → reading-time-W_Id2ayC.mjs} +2 -2
  17. package/dist/{review-B6gyEFkD.mjs → review-x3zV5jZp.mjs} +14 -6
  18. package/dist/{robots-4BUJxlvV.mjs → robots-BSPfXA3J.mjs} +2 -2
  19. package/dist/{robots-DAptQnkx.mjs → robots-DRpoiYAV.mjs} +1 -1
  20. package/dist/{search-CfWvmVYA.d.mts → search-9uEaC23e.d.mts} +29 -4
  21. package/dist/{search-CJIC1Cqo.mjs → search-OHp36znm.mjs} +102 -42
  22. package/dist/{search-CbPm2x5g.mjs → search-vG59kGqo.mjs} +3 -3
  23. package/dist/server.d.mts +3 -3
  24. package/dist/server.mjs +3 -3
  25. package/dist/{sitemap-D6nP3J1Q.mjs → sitemap-DqxsKlvI.mjs} +3 -3
  26. package/dist/{sitemap-server-wsNLyVkb.mjs → sitemap-server-zFYctvCa.mjs} +1 -1
  27. package/dist/{types-BVgucdVm.d.mts → types-R-DN23yw.d.mts} +2 -1
  28. package/package.json +3 -2
@@ -1,8 +1,8 @@
1
- import { M as buildDocsAgentDiscoverySpec, Mt as renderDocsSitemapXml, Nt as resolveDocsSitemapConfig, Ot as buildDocsSitemapManifest, T as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, ct as resolveDocsAgentFeedbackConfig, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, it as renderDocsMarkdownDocument, jt as renderDocsSitemapMarkdown, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nt as renderDocsAgentsDocument, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, ot as renderDocsSkillDocument, rt as renderDocsLlmsTxt, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, w as DEFAULT_SKILL_MD_ROUTE, xt as toDocsMarkdownUrl, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-DXkXi-pS.mjs";
2
- import "./search-CJIC1Cqo.mjs";
1
+ import { Ft as renderDocsSitemapMarkdown, It as renderDocsSitemapXml, Lt as resolveDocsSitemapConfig, M as buildDocsAgentDiscoverySpec, Mt as buildDocsSitemapManifest, T as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, bt as toDocsMarkdownUrl, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, ct as resolveDocsAgentFeedbackConfig, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, it as renderDocsMarkdownDocument, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nt as renderDocsAgentsDocument, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, ot as renderDocsSkillDocument, rt as renderDocsLlmsTxt, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, w as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-CxDzPqtl.mjs";
2
+ import "./search-OHp36znm.mjs";
3
3
  import { t as resolveDocsI18n } from "./i18n-CAlj1ADU.mjs";
4
- import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-DAptQnkx.mjs";
5
- import "./sitemap-server-wsNLyVkb.mjs";
4
+ import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-DRpoiYAV.mjs";
5
+ import "./sitemap-server-zFYctvCa.mjs";
6
6
  import "./agent-evals-BD17jOqL.mjs";
7
7
  import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
8
8
  import "./code-blocks-C9awWzEQ.mjs";
@@ -693,7 +693,12 @@ async function exportAgentBundle(options = {}) {
693
693
  markdownUrl: staticMarkdownRoute(page, sourceEntry, routeEntry),
694
694
  title: page.title,
695
695
  description: page.description,
696
- content: page.agentRawContent ?? page.agentFallbackRawContent ?? page.rawContent ?? page.content
696
+ content: page.content,
697
+ rawContent: page.rawContent,
698
+ agentContent: page.agentContent,
699
+ agentRawContent: page.agentRawContent,
700
+ agentFallbackContent: page.agentFallbackContent,
701
+ agentFallbackRawContent: page.agentFallbackRawContent
697
702
  })), llms);
698
703
  for (const route of [DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE]) addOutput(outputs, publicDir, route, "llms", "text/plain", llmsContent.llmsTxt);
699
704
  for (const route of [DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE]) addOutput(outputs, publicDir, route, "llms", "text/plain", llmsContent.llmsFullTxt);
@@ -1,4 +1,4 @@
1
- import { Gt as hasStructuredPageAgentContract, Kt as normalizePageAgentFrontmatter } from "./agent-DXkXi-pS.mjs";
1
+ import { Ct as findDocsAudienceMdxTags, Et as resolveDocsAudienceMdxContent, Xt as normalizePageAgentFrontmatter, Yt as hasStructuredPageAgentContract } from "./agent-CxDzPqtl.mjs";
2
2
  import { n as agentVersionConstraintsOverlap, o as normalizeAgentVersion, r as normalizeAgentFramework } from "./agent-scope-B8lptqCd.mjs";
3
3
  import { t as extractCodeBlocksFromMarkdown } from "./code-blocks-C9awWzEQ.mjs";
4
4
  import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
@@ -210,67 +210,63 @@ const PACKAGE_MANAGER_OPTIONS_WITH_VALUES = new Set([
210
210
  "-F",
211
211
  "-w"
212
212
  ]);
213
- /** Extract actual `<Agent>` blocks while ignoring examples inside fenced code blocks. */
213
+ function isAgentContextVisible(scopes) {
214
+ return scopes.every((scope) => scope.only === void 0 || scope.only === "agent");
215
+ }
216
+ /**
217
+ * Extract actual agent-only context while ignoring examples in fenced and inline code.
218
+ *
219
+ * `<Agent>` is agent-only shorthand. `<Audience>` counts only when `only` is the
220
+ * static value `"agent"`; human-only and dynamic/invalid audience declarations do
221
+ * not contribute to agent-context usefulness metrics.
222
+ */
214
223
  function extractAgentBlocks(source, options = {}) {
215
224
  const sourcePath = options.sourcePath ?? "unknown";
216
- const lines = source.split(/\r?\n/);
225
+ const tags = findDocsAudienceMdxTags(source);
217
226
  const blocks = [];
218
- let fence;
227
+ const scopes = [];
228
+ let nextScopeId = 1;
229
+ let cursor = 0;
219
230
  let active;
220
- for (let index = 0; index < lines.length; index += 1) {
221
- const line = lines[index] ?? "";
222
- const trimmed = line.trim();
223
- const nextFence = advanceFence(trimmed, fence);
224
- if (active) {
225
- if (fence || nextFence) {
226
- active.content.push(line);
227
- fence = nextFence;
228
- continue;
229
- }
230
- if (/^<Agent(?:\s[^>]*)?>\s*$/.test(trimmed)) {
231
- active.depth += 1;
232
- continue;
233
- }
234
- const closeWithContent = /^(.*?)<\/Agent>\s*$/.exec(line);
235
- if (closeWithContent) {
236
- if (closeWithContent[1]) active.content.push(closeWithContent[1]);
237
- active.depth -= 1;
238
- if (active.depth === 0) {
239
- blocks.push({
240
- sourcePath,
241
- route: options.route,
242
- line: active.line,
243
- content: active.content.join("\n").trim()
244
- });
245
- active = void 0;
246
- }
247
- continue;
248
- }
249
- active.content.push(line);
250
- continue;
251
- }
252
- if (fence || nextFence) {
253
- fence = nextFence;
254
- continue;
255
- }
256
- if (/^<Agent(?:\s[^>]*)?\s*\/>$/.test(trimmed)) continue;
257
- const singleLine = /^<Agent(?:\s[^>]*)?>(.*?)<\/Agent>\s*$/.exec(trimmed);
258
- if (singleLine) {
259
- blocks.push({
260
- sourcePath,
261
- route: options.route,
262
- line: index + 1,
263
- content: (singleLine[1] ?? "").trim()
264
- });
231
+ const appendVisibleContent = (content) => {
232
+ if (active && isAgentContextVisible(scopes)) active.content.push(content);
233
+ };
234
+ const finishActiveBlock = () => {
235
+ if (!active) return;
236
+ blocks.push({
237
+ sourcePath,
238
+ route: options.route,
239
+ line: active.line,
240
+ content: active.content.join("").trim()
241
+ });
242
+ active = void 0;
243
+ };
244
+ for (const tag of tags) {
245
+ const activeScope = scopes.at(-1);
246
+ if (tag.closing && activeScope?.name !== tag.name) continue;
247
+ appendVisibleContent(source.slice(cursor, tag.index));
248
+ cursor = tag.end;
249
+ if (tag.closing) {
250
+ const closedScope = scopes.pop();
251
+ if (active && closedScope?.id === active.scopeId) finishActiveBlock();
265
252
  continue;
266
253
  }
267
- const opening = /^<Agent(?:\s[^>]*)?>(.*)$/.exec(trimmed);
268
- if (opening) active = {
269
- line: index + 1,
270
- depth: 1,
271
- content: opening[1] ? [opening[1]] : []
254
+ if (tag.selfClosing) continue;
255
+ const scope = {
256
+ id: nextScopeId,
257
+ name: tag.name,
258
+ only: tag.only
259
+ };
260
+ nextScopeId += 1;
261
+ scopes.push(scope);
262
+ const isAgentOnly = tag.name === "Agent" || tag.name === "Audience" && tag.only === "agent";
263
+ if (!active && isAgentOnly && isAgentContextVisible(scopes)) active = {
264
+ line: source.slice(0, tag.index).split(/\r?\n/).length,
265
+ scopeId: scope.id,
266
+ content: []
272
267
  };
273
268
  }
269
+ appendVisibleContent(source.slice(cursor));
274
270
  return blocks;
275
271
  }
276
272
  /** Analyze page-level context quality without executing documented commands. */
@@ -298,10 +294,10 @@ function analyzeAgentUsefulness(options) {
298
294
  let brokenRelatedLinks = 0;
299
295
  const knownRoutes = new Set(options.pages.map((page) => normalizeRoute(page.route)));
300
296
  for (const analysis of pages) {
301
- const { page, agent, actionable } = analysis;
297
+ const { page, agent, actionable, projectedSource } = analysis;
302
298
  if (actionable) {
303
299
  const guidance = [
304
- stripFencedContent(page.source),
300
+ stripFencedContent(projectedSource),
305
301
  page.agentSource ? stripFencedContent(page.agentSource) : void 0,
306
302
  ...analysis.blocks.map((block) => stripFencedContent(block.content))
307
303
  ].filter((value) => Boolean(value)).join("\n\n");
@@ -428,15 +424,17 @@ function analyzeAgentUsefulness(options) {
428
424
  }
429
425
  function analyzePage(page) {
430
426
  const agent = normalizePageAgentFrontmatter(page.agent);
427
+ const projectedSource = resolveDocsAudienceMdxContent(page.source, "agent");
431
428
  const blocks = extractAgentBlocks(page.source, {
432
429
  sourcePath: page.sourcePath,
433
430
  route: page.route
434
431
  });
435
- const shellCommands = collectPageCommands(page, agent);
432
+ const shellCommands = collectPageCommands(page, agent, projectedSource);
436
433
  return {
437
434
  page,
438
435
  agent,
439
436
  blocks,
437
+ projectedSource,
440
438
  shellCommands,
441
439
  actionable: page.actionable ?? (hasStructuredPageAgentContract(agent) || shellCommands.length > 0 || blocks.some((block) => ACTIONABLE_PATTERN.test(block.content)) || ACTIONABLE_PATTERN.test(page.agentSource ?? ""))
442
440
  };
@@ -489,7 +487,7 @@ function analyzeBlockQuality(pages, config) {
489
487
  category: "context",
490
488
  line: item.block.line,
491
489
  relatedFiles: relatedFiles.filter((file) => file !== item.block.sourcePath),
492
- message: `Agent block duplicates context used on ${group.length - 1} other page${group.length === 2 ? "" : "s"}.`
490
+ message: `Agent-only block duplicates context used on ${group.length - 1} other page${group.length === 2 ? "" : "s"}.`
493
491
  }));
494
492
  }
495
493
  }
@@ -507,7 +505,7 @@ function analyzeBlockQuality(pages, config) {
507
505
  severity: "warning",
508
506
  category: "context",
509
507
  line: item.block.line,
510
- message: `${Math.round(ratio * 100)}% of this Agent block repeats sentences used across the docs corpus.`
508
+ message: `${Math.round(ratio * 100)}% of this agent-only block repeats sentences used across the docs corpus.`
511
509
  }));
512
510
  }
513
511
  if (isGenericAgentBlock(item.block.content, sentences)) {
@@ -518,7 +516,7 @@ function analyzeBlockQuality(pages, config) {
518
516
  severity: "suggestion",
519
517
  category: "context",
520
518
  line: item.block.line,
521
- message: "Agent block is generic and lacks a concrete command, path, identifier, version, or task-specific constraint."
519
+ message: "Agent-only block is generic and lacks a concrete command, path, identifier, version, or task-specific constraint."
522
520
  }));
523
521
  }
524
522
  }
@@ -684,7 +682,7 @@ function commandAnalysis(findings) {
684
682
  status: "healthy"
685
683
  };
686
684
  }
687
- function collectPageCommands(page, agent) {
685
+ function collectPageCommands(page, agent, projectedSource) {
688
686
  const commands = [];
689
687
  for (const command of agent?.commands ?? []) commands.push(normalizeAgentCommand(command, page.sourcePath));
690
688
  for (const verification of agent?.verification ?? []) if (typeof verification !== "string" && verification.run) commands.push({
@@ -692,7 +690,7 @@ function collectPageCommands(page, agent) {
692
690
  sourcePath: page.sourcePath,
693
691
  source: "contract"
694
692
  });
695
- collectMarkdownCommands(commands, page.source, page.sourcePath);
693
+ collectMarkdownCommands(commands, projectedSource, page.sourcePath);
696
694
  if (page.agentSource) collectMarkdownCommands(commands, page.agentSource, page.agentSourcePath ?? page.sourcePath);
697
695
  return dedupeCommands(commands);
698
696
  }
@@ -1426,4 +1424,4 @@ function analyzeAgentSurfaceDrift(options) {
1426
1424
  }
1427
1425
 
1428
1426
  //#endregion
1429
- export { analyzeAgentUsefulness as n, createAgentUsefulnessPagesFromMcp as r, analyzeAgentSurfaceDrift as t };
1427
+ export { extractAgentBlocks as i, analyzeAgentUsefulness as n, createAgentUsefulnessPagesFromMcp as r, analyzeAgentSurfaceDrift as t };
@@ -1,6 +1,6 @@
1
- import { C as DEFAULT_OPENAPI_SCHEMA_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, ct as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nt as renderDocsAgentsDocument, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE } from "./agent-DXkXi-pS.mjs";
2
- import "./search-CJIC1Cqo.mjs";
3
- import { S as resolveApiReferenceConfig } from "./sitemap-server-wsNLyVkb.mjs";
1
+ import { C as DEFAULT_OPENAPI_SCHEMA_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, ct as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nt as renderDocsAgentsDocument, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE } from "./agent-CxDzPqtl.mjs";
2
+ import "./search-OHp36znm.mjs";
3
+ import { S as resolveApiReferenceConfig } from "./sitemap-server-zFYctvCa.mjs";
4
4
  import "./agent-evals-BD17jOqL.mjs";
5
5
  import { resolveDocsMcpConfig } from "./mcp.mjs";
6
6
  import "./code-blocks-C9awWzEQ.mjs";
@@ -138,10 +138,10 @@ async function main() {
138
138
  printCloudHelp();
139
139
  process.exit(1);
140
140
  } else if (parsedCommand.command === "mcp") {
141
- const { runMcp } = await import("../mcp-DnxZZWpY.mjs");
141
+ const { runMcp } = await import("../mcp-BwYAu9DJ.mjs");
142
142
  await runMcp(mcpOptions);
143
143
  } else if (parsedCommand.command === "agent" && subcommand === "compact") {
144
- const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-BXvi0uhS.mjs").then((n) => n.t);
144
+ const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-3IpxY9F6.mjs").then((n) => n.t);
145
145
  const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
146
146
  if (agentCompactOptions.help) {
147
147
  printAgentCompactHelp();
@@ -149,7 +149,7 @@ async function main() {
149
149
  }
150
150
  await compactAgentDocs(agentCompactOptions);
151
151
  } else if (parsedCommand.command === "agent" && subcommand === "export") {
152
- const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-n-a0GbeU.mjs");
152
+ const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-BtlITzt3.mjs");
153
153
  const agentExportOptions = parseAgentExportArgs(args.slice(2));
154
154
  if (agentExportOptions.help) {
155
155
  printAgentExportHelp();
@@ -159,13 +159,13 @@ async function main() {
159
159
  } else if (parsedCommand.command === "agent") {
160
160
  console.error(pc.red(`Unknown agent subcommand: ${subcommand ?? "(missing)"}`));
161
161
  console.error();
162
- const { printAgentCompactHelp } = await import("../agent-BXvi0uhS.mjs").then((n) => n.t);
163
- const { printAgentExportHelp } = await import("../agent-export-n-a0GbeU.mjs");
162
+ const { printAgentCompactHelp } = await import("../agent-3IpxY9F6.mjs").then((n) => n.t);
163
+ const { printAgentExportHelp } = await import("../agent-export-BtlITzt3.mjs");
164
164
  printAgentCompactHelp();
165
165
  printAgentExportHelp();
166
166
  process.exit(1);
167
167
  } else if (parsedCommand.command === "agents" && subcommand === "generate") {
168
- const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-BJaRQimo.mjs");
168
+ const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-BguzxLhO.mjs");
169
169
  const agentsOptions = parseAgentsGenerateArgs(args.slice(2));
170
170
  if (agentsOptions.help) {
171
171
  printAgentsGenerateHelp();
@@ -175,11 +175,11 @@ async function main() {
175
175
  } else if (parsedCommand.command === "agents") {
176
176
  console.error(pc.red(`Unknown agents subcommand: ${subcommand ?? "(missing)"}`));
177
177
  console.error();
178
- const { printAgentsGenerateHelp } = await import("../agents-BJaRQimo.mjs");
178
+ const { printAgentsGenerateHelp } = await import("../agents-BguzxLhO.mjs");
179
179
  printAgentsGenerateHelp();
180
180
  process.exit(1);
181
181
  } else if (parsedCommand.command === "doctor") {
182
- const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-CQpQ2zZm.mjs");
182
+ const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-Cra5qEEi.mjs");
183
183
  const doctorOptions = parseDoctorArgs(args.slice(1));
184
184
  if (doctorOptions.help) {
185
185
  printDoctorHelp();
@@ -187,7 +187,7 @@ async function main() {
187
187
  }
188
188
  await runDoctor(doctorOptions);
189
189
  } else if (parsedCommand.command === "review") {
190
- const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-B6gyEFkD.mjs");
190
+ const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-x3zV5jZp.mjs");
191
191
  const reviewOptions = parseReviewArgs(args.slice(1));
192
192
  if (reviewOptions.help) {
193
193
  printReviewHelp();
@@ -209,7 +209,7 @@ async function main() {
209
209
  printCodeBlocksValidateHelp();
210
210
  process.exit(1);
211
211
  } else if (parsedCommand.command === "search" && subcommand === "sync") {
212
- const { syncSearch } = await import("../search-CbPm2x5g.mjs");
212
+ const { syncSearch } = await import("../search-vG59kGqo.mjs");
213
213
  await syncSearch(searchSyncOptions);
214
214
  } else if (parsedCommand.command === "search") {
215
215
  console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
@@ -217,7 +217,7 @@ async function main() {
217
217
  printHelp();
218
218
  process.exit(1);
219
219
  } else if (parsedCommand.command === "sitemap" && subcommand === "generate") {
220
- const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-D6nP3J1Q.mjs");
220
+ const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-DqxsKlvI.mjs");
221
221
  const sitemapOptions = parseSitemapGenerateArgs(args.slice(2));
222
222
  if (sitemapOptions.help) {
223
223
  printSitemapGenerateHelp();
@@ -227,11 +227,11 @@ async function main() {
227
227
  } else if (parsedCommand.command === "sitemap") {
228
228
  console.error(pc.red(`Unknown sitemap subcommand: ${subcommand ?? "(missing)"}`));
229
229
  console.error();
230
- const { printSitemapGenerateHelp } = await import("../sitemap-D6nP3J1Q.mjs");
230
+ const { printSitemapGenerateHelp } = await import("../sitemap-DqxsKlvI.mjs");
231
231
  printSitemapGenerateHelp();
232
232
  process.exit(1);
233
233
  } else if (parsedCommand.command === "robots" && subcommand === "generate") {
234
- const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-4BUJxlvV.mjs");
234
+ const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-BSPfXA3J.mjs");
235
235
  const robotsOptions = parseRobotsGenerateArgs(args.slice(2));
236
236
  if (robotsOptions.help) {
237
237
  printRobotsGenerateHelp();
@@ -241,7 +241,7 @@ async function main() {
241
241
  } else if (parsedCommand.command === "robots") {
242
242
  console.error(pc.red(`Unknown robots subcommand: ${subcommand ?? "(missing)"}`));
243
243
  console.error();
244
- const { printRobotsGenerateHelp } = await import("../robots-4BUJxlvV.mjs");
244
+ const { printRobotsGenerateHelp } = await import("../robots-BSPfXA3J.mjs");
245
245
  printRobotsGenerateHelp();
246
246
  process.exit(1);
247
247
  } else if (parsedCommand.command === "downgrade") {
@@ -1,4 +1,4 @@
1
- import { T as DocsAnalyticsConfig } from "../types-BVgucdVm.mjs";
1
+ import { T as DocsAnalyticsConfig } from "../types-R-DN23yw.mjs";
2
2
  import { ReactNode } from "react";
3
3
 
4
4
  //#region src/docs-cloud-client.d.ts
@@ -1,4 +1,4 @@
1
- import { T as DocsAnalyticsConfig, t as AIConfig, z as DocsCloudConfig } from "./types-BVgucdVm.mjs";
1
+ import { T as DocsAnalyticsConfig, t as AIConfig, z as DocsCloudConfig } from "./types-R-DN23yw.mjs";
2
2
 
3
3
  //#region src/cloud-ask-ai.d.ts
4
4
  interface DocsCloudAskAIConfig {
@@ -1,5 +1,5 @@
1
- import { D as DocsAnalyticsEventInput, E as DocsAnalyticsEvent, T as DocsAnalyticsConfig } from "./types-BVgucdVm.mjs";
2
- import { n as DocsCloudAskAIResponseOptions, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-466g6uAi.mjs";
1
+ import { D as DocsAnalyticsEventInput, E as DocsAnalyticsEvent, T as DocsAnalyticsConfig } from "./types-R-DN23yw.mjs";
2
+ import { n as DocsCloudAskAIResponseOptions, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-CvRVnwdK.mjs";
3
3
 
4
4
  //#region src/docs-cloud-server.d.ts
5
5
  type DocsCloudRuntimeValue<T = string> = T | undefined | null | (() => T | undefined | null);
@@ -1,16 +1,16 @@
1
- import { i as scanDocsPageTargets, n as compactAgentDocs, r as inspectAgentCompactionState } from "./agent-BXvi0uhS.mjs";
2
- import "./reading-time-BrTd3DIh.mjs";
3
- import { Bt as PAGE_AGENT_CONTRACT_FIELDS, Dt as DEFAULT_SITEMAP_XML_ROUTE, Et as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, I as buildDocsMcpEndpointCandidates, M as buildDocsAgentDiscoverySpec, Nt as resolveDocsSitemapConfig, O as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, P as buildDocsConfigMap, S as DEFAULT_MCP_WELL_KNOWN_ROUTE, T as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Tt as DEFAULT_SITEMAP_MD_ROUTE, b as DEFAULT_MCP_PUBLIC_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, f as DEFAULT_DOCS_CONFIG_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, u as DEFAULT_DOCS_API_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, w as DEFAULT_SKILL_MD_ROUTE } from "./agent-DXkXi-pS.mjs";
4
- import "./search-CJIC1Cqo.mjs";
5
- import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-DAptQnkx.mjs";
6
- import "./sitemap-server-wsNLyVkb.mjs";
1
+ import { i as scanDocsPageTargets, n as compactAgentDocs, r as inspectAgentCompactionState } from "./agent-3IpxY9F6.mjs";
2
+ import "./reading-time-W_Id2ayC.mjs";
3
+ import { At as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, I as buildDocsMcpEndpointCandidates, Lt as resolveDocsSitemapConfig, M as buildDocsAgentDiscoverySpec, O as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, P as buildDocsConfigMap, S as DEFAULT_MCP_WELL_KNOWN_ROUTE, T as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Wt as PAGE_AGENT_CONTRACT_FIELDS, b as DEFAULT_MCP_PUBLIC_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, f as DEFAULT_DOCS_CONFIG_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, jt as DEFAULT_SITEMAP_XML_ROUTE, kt as DEFAULT_SITEMAP_MD_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, u as DEFAULT_DOCS_API_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, w as DEFAULT_SKILL_MD_ROUTE } from "./agent-CxDzPqtl.mjs";
4
+ import "./search-OHp36znm.mjs";
5
+ import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-DRpoiYAV.mjs";
6
+ import "./sitemap-server-zFYctvCa.mjs";
7
7
  import { t as runDocsGoldenTasks } from "./agent-evals-BD17jOqL.mjs";
8
8
  import { createFilesystemDocsMcpSource, getDocsConfigSchema, resolveDocsMcpConfig } from "./mcp.mjs";
9
9
  import "./code-blocks-C9awWzEQ.mjs";
10
10
  import "./server.mjs";
11
11
  import { a as loadDocsConfigModuleResultWithProjectEnv, h as resolveDocsContentDir, l as readNavTitle, m as resolveDocsConfigPath, p as readTopLevelStringProperty, r as extractTopLevelConfigObject, s as readBooleanProperty, t as extractNestedObjectLiteral } from "./config-CydaZ5PB.mjs";
12
12
  import { t as detectFramework } from "./utils-DBCCkkJS.mjs";
13
- import { n as analyzeAgentUsefulness, r as createAgentUsefulnessPagesFromMcp, t as analyzeAgentSurfaceDrift } from "./agent-surface-drift-LS8zQgbq.mjs";
13
+ import { n as analyzeAgentUsefulness, r as createAgentUsefulnessPagesFromMcp, t as analyzeAgentSurfaceDrift } from "./agent-surface-drift-rGFS38Ak.mjs";
14
14
  import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
15
15
  import path from "node:path";
16
16
  import { LATEST_PROTOCOL_VERSION } from "@modelcontextprotocol/sdk/types.js";
@@ -1483,8 +1483,8 @@ async function inspectAgentReadiness(options = {}) {
1483
1483
  checks.push(agentFeedbackEnabled ? makeCheck("feedback", "Agent feedback", "pass", 5, 5, `Structured agent feedback is enabled at ${feedbackRoute} with schema ${feedbackSchemaRoute}.`) : makeCheck("feedback", "Agent feedback", "warn", 0, 5, "Structured agent feedback is not enabled.", "Enable feedback.agent if you want agents to discover and post feedback through the shared docs API."));
1484
1484
  checks.push(makeCheck("metadata", "Page metadata", metadataResult.status, metadataResult.score, 5, coverage.totalPages > 0 ? `${metadataCoverage.describedPages}/${coverage.totalPages} pages include descriptions and ${metadataCoverage.relatedPages}/${coverage.totalPages} pages include related links (${metadataCoverage.descriptionCoverage}% described, ${metadataCoverage.relatedCoverage}% related).` : "No docs pages were available to score page metadata.", metadataCoverage.descriptionCoverage >= 75 ? void 0 : "Add page descriptions and related links to more docs pages so agent markdown output carries better context and navigation hints."));
1485
1485
  const coverageResult = coverageScore(coverage.explicitCoverage);
1486
- checks.push(makeCheck("coverage", "Explicit page optimization", coverageResult.status, coverageResult.score, 10, coverage.totalPages > 0 ? `${coverage.explicitPages}/${coverage.totalPages} pages define explicit machine-only context (${coverage.pagesWithAgentFiles} agent.md, ${coverage.pagesWithAgentBlocks} Agent blocks, ${coverage.explicitCoverage}% of pages).` : "No docs pages were available to score explicit page optimization.", coverage.explicitCoverage >= 50 ? void 0 : "Add agent.md files or <Agent> blocks to more pages, or run docs agent compact to create page-level machine docs."));
1487
- checks.push(makeCheck("agent-context-quality", "Agent context usefulness", contextQualityResult.status, contextQualityResult.score, 15, usefulness.metrics.agentBlocks.total > 0 ? `${usefulness.metrics.agentBlocks.useful}/${usefulness.metrics.agentBlocks.total} Agent blocks are specific and non-repetitive (${usefulness.metrics.agentBlocks.duplicate} duplicate, ${usefulness.metrics.agentBlocks.boilerplate} boilerplate, ${usefulness.metrics.agentBlocks.generic} generic).` : "No embedded Agent blocks were present; page contracts and sibling agent.md files remain available as alternatives.", usefulness.metrics.agentBlocks.total > 0 && usefulness.metrics.agentBlocks.useful === usefulness.metrics.agentBlocks.total ? void 0 : "Replace repeated Agent boilerplate with page-specific constraints, commands, files, expected results, and recovery guidance."));
1486
+ checks.push(makeCheck("coverage", "Audience-tailored page optimization", coverageResult.status, coverageResult.score, 10, coverage.totalPages > 0 ? `${coverage.explicitPages}/${coverage.totalPages} pages define audience-tailored context (${coverage.pagesWithAgentFiles} page${coverage.pagesWithAgentFiles === 1 ? "" : "s"} with agent.md, ${coverage.pagesWithAgentBlocks} page${coverage.pagesWithAgentBlocks === 1 ? "" : "s"} with embedded audience projections, ${coverage.explicitCoverage}% of pages).` : "No docs pages were available to score audience-tailored page optimization.", coverage.explicitCoverage >= 50 ? void 0 : "Add agent.md files or audience primitives such as <Agent>, <Human>, or <Audience only=\"agent\"> to more pages, or run docs agent compact to create page-level machine docs."));
1487
+ checks.push(makeCheck("agent-context-quality", "Agent context usefulness", contextQualityResult.status, contextQualityResult.score, 15, usefulness.metrics.agentBlocks.total > 0 ? `${usefulness.metrics.agentBlocks.useful}/${usefulness.metrics.agentBlocks.total} agent-only blocks are specific and non-repetitive (${usefulness.metrics.agentBlocks.duplicate} duplicate, ${usefulness.metrics.agentBlocks.boilerplate} boilerplate, ${usefulness.metrics.agentBlocks.generic} generic).` : "No embedded agent-only blocks were present; page contracts and sibling agent.md files remain available as alternatives.", usefulness.metrics.agentBlocks.total > 0 && usefulness.metrics.agentBlocks.useful === usefulness.metrics.agentBlocks.total ? void 0 : "Replace repeated agent-only boilerplate with page-specific constraints, commands, files, expected results, and recovery guidance."));
1488
1488
  checks.push(makeCheck("agent-task-completeness", "Agent task completeness", taskCompletenessResult.status, taskCompletenessResult.score, 15, `${usefulness.metrics.taskCompleteness.completePages}/${usefulness.metrics.actionablePages} actionable pages include prerequisites, an expected result, and recovery guidance (${usefulness.metrics.taskCompleteness.coverage}% complete).`, usefulness.metrics.actionablePages > 0 && usefulness.metrics.taskCompleteness.coverage >= 80 ? void 0 : "Add prerequisites, observable outcomes or verification expectations, and rollback or resolved failure modes to actionable pages."));
1489
1489
  checks.push(makeCheck("agent-applicability", "Framework and version applicability", applicabilityResult.status, applicabilityResult.score, 10, `${usefulness.metrics.applicability.conflictingPages} conflicting, ${usefulness.metrics.applicability.ambiguousPages} ambiguous, and ${usefulness.metrics.applicability.mismatchedPages} project-mismatched actionable pages.`, usefulness.metrics.actionablePages > 0 && applicabilityIssueCount === 0 ? void 0 : "Declare consistent framework/version metadata in page frontmatter and agent.appliesTo so retrieval can select the right variant."));
1490
1490
  checks.push(makeCheck("command-health", "Documented command health", commandHealthResult.status, commandHealthResult.score, 10, `${usefulness.metrics.commands.healthy}/${usefulness.metrics.commands.total} statically inspected commands are healthy; ${usefulness.metrics.commands.unhealthy} are unhealthy and ${usefulness.metrics.commands.unverified} could not be verified safely.`, usefulness.metrics.commands.total > 0 && usefulness.metrics.commands.unhealthy === 0 && usefulness.metrics.commands.unverified === 0 ? void 0 : "Update broken or stale commands and make workspace selectors resolvable so scripts, working directories, package managers, and docs CLI subcommands can be verified."));
@@ -1600,8 +1600,8 @@ function printAgentDoctorReport(report) {
1600
1600
  console.log(`${pc.bold("Score:")} ${pc.cyan(`${report.score}%`)} ${pc.dim(`(${report.grade})`)}`);
1601
1601
  console.log(`${pc.bold("Framework:")} ${report.framework} ${pc.dim("•")} ${pc.bold("Entry:")} ${report.entry ?? "docs"} ${pc.dim("•")} ${pc.bold("Content:")} ${report.contentDir ?? "-"}`);
1602
1602
  if (report.url) console.log(`${pc.bold("Hosted URL:")} ${report.url}`);
1603
- console.log(`${pc.bold("Explicit agent-friendly pages:")} ${report.coverage.explicitPages}/${report.coverage.totalPages} pages ${pc.dim(`(${report.coverage.explicitCoverage}%)`)}`);
1604
- if (report.usefulness) console.log(`${pc.bold("Useful Agent blocks:")} ${report.usefulness.agentBlocks.useful}/${report.usefulness.agentBlocks.total} ${pc.dim(`• ${report.usefulness.taskCompleteness.completePages}/${report.usefulness.actionablePages} actionable pages task-complete`)}`);
1603
+ console.log(`${pc.bold("Audience-tailored pages:")} ${report.coverage.explicitPages}/${report.coverage.totalPages} pages ${pc.dim(`(${report.coverage.explicitCoverage}%)`)}`);
1604
+ if (report.usefulness) console.log(`${pc.bold("Useful agent-only blocks:")} ${report.usefulness.agentBlocks.useful}/${report.usefulness.agentBlocks.total} ${pc.dim(`• ${report.usefulness.taskCompleteness.completePages}/${report.usefulness.actionablePages} actionable pages task-complete`)}`);
1605
1605
  if (report.evaluations) console.log(`${pc.bold("Golden tasks:")} ${report.evaluations.status === "unmeasured" ? "unmeasured" : `${report.evaluations.passedTaskCount}/${report.evaluations.taskCount} passed (${report.evaluations.score}/100)`}`);
1606
1606
  console.log(`${pc.bold("Generated agent.md freshness:")} ${report.coverage.compaction.freshGeneratedPages} fresh ${pc.dim("•")} ${report.coverage.compaction.staleGeneratedPages} stale ${pc.dim("•")} ${report.coverage.compaction.modifiedGeneratedPages} modified ${pc.dim("•")} ${report.coverage.compaction.tokenBudgetMissingPages} token-budget missing`);
1607
1607
  if (report.fixes && report.fixes.length > 0) console.log(`${pc.bold("Fixes:")} ${report.fixes.map((fix) => `${fix.status === "applied" ? "applied" : "skipped"} ${fix.title}`).join(pc.dim(" • "))}`);
package/dist/index.d.mts CHANGED
@@ -1,5 +1,5 @@
1
- import { $ as DocsFeedbackValue, $t as McpDocsSearchConfig, A as DocsAnalyticsSource, An as TypesenseDocsSearchConfig, At as DocsSearchDocument, B as DocsCloudFeatureConfig, Bt as DocsTelemetryEventInput, C as DocsAgentTraceEventType, Cn as SidebarFolderIndexBehavior, Ct as DocsRobotsConfig, D as DocsAnalyticsEventInput, Dn as SidebarTree, Dt as DocsSearchAdapterFactory, E as DocsAnalyticsEvent, En as SidebarPageNode, Et as DocsSearchAdapterContext, F as DocsAskAIFeedbackMessage, Ft as DocsSearchSourcePage, G as DocsCodeBlocksPlannerProvider, Gt as FeedbackConfig, H as DocsCloudPublishConfig, Ht as DocsTelemetryFeatures, I as DocsAskAIFeedbackValue, It as DocsSitemapConfig, J as DocsCodeBlocksValidateConfig, Jt as LastUpdatedConfig, K as DocsCodeBlocksRunnerConfig, Kt as FontStyle, L as DocsAskAIMcpConfig, Lt as DocsTelemetryAgentSurface, M as DocsAskAIActionType, Mn as UIConfig, Mt as DocsSearchQuery, N as DocsAskAIFeedbackConfig, Nt as DocsSearchResult, O as DocsAnalyticsEventType, On as SimpleDocsSearchConfig, Ot as DocsSearchChunkingConfig, P as DocsAskAIFeedbackData, Pt as DocsSearchResultType, Q as DocsFeedbackData, Qt as LlmsTxtSectionConfig, R as DocsCloudApiKeyConfig, Rt as DocsTelemetryConfig, S as DocsAgentTraceEventInput, Sn as SidebarConfig, St as DocsReviewSeverity, T as DocsAnalyticsConfig, Tn as SidebarNode, Tt as DocsSearchAdapter, U as DocsCodeBlocksConfig, Ut as DocsTelemetryFramework, V as DocsCloudPreviewConfig, Vt as DocsTelemetryEventType, W as DocsCodeBlocksPlannerConfig, Wt as DocsTheme, X as DocsCodeBlocksValidationPolicy, Xt as LlmsTxtMaxCharsConfig, Y as DocsCodeBlocksValidationMode, Yt as LlmsTxtConfig, Z as DocsConfig, Zt as LlmsTxtMaxCharsMode, _ as DocsAgentFeedbackData, _n as PageTwitter, _t as DocsReviewCiConfig, a as ApiReferenceRenderer, an as OpenDocsTarget, at as DocsMcpAuthenticateResult, b as DocsAgentGoldenTaskExpectation, bn as ResolvedDocsRelatedLink, bt as DocsReviewRulesConfig, c as ChangelogFrontmatter, cn as PageActionsConfig, ct as DocsMcpOriginContext, d as CopyMarkdownFormat, dn as PageAgentFailureMode, dt as DocsMetadata, en as OGConfig, et as DocsI18nConfig, f as CustomDocsSearchConfig, fn as PageAgentFrontmatter, ft as DocsNav, g as DocsAgentFeedbackContext, gn as PageSidebarFrontmatter, gt as DocsRelatedItem, h as DocsAgentEvaluationsConfig, hn as PageOpenGraph, ht as DocsObservabilityEventInput, i as ApiReferenceConfig, in as OpenDocsProviderId, it as DocsMcpAuthenticateContext, j as DocsAskAIActionData, jn as TypographyConfig, jt as DocsSearchEmbeddingsConfig, k as DocsAnalyticsInput, kn as ThemeToggleConfig, kt as DocsSearchConfig, l as CodeBlockCopyData, ln as PageAgentAppliesTo, lt as DocsMcpSecurityConfig, m as DocsAgentConfig, mn as PageFrontmatter, mt as DocsObservabilityEvent, n as AgentFeedbackConfig, nn as OpenDocsProvider, nt as DocsMcpAuthPrincipal, o as BreadcrumbConfig, on as OpenGraphImage, ot as DocsMcpConfig, p as DocsAgentCompactConfig, pn as PageAgentVerification, pt as DocsObservabilityConfig, q as DocsCodeBlocksRunnerProvider, qt as GithubConfig, r as AlgoliaDocsSearchConfig, rn as OpenDocsProviderConfig, rt as DocsMcpAuthenticate, s as ChangelogConfig, sn as OrderingItem, st as DocsMcpCorsConfig, t as AIConfig, tn as OpenDocsConfig, tt as DocsMcpAllowedOrigins, u as CopyMarkdownConfig, un as PageAgentCommand, ut as DocsMcpToolsConfig, v as DocsAgentGoldenExpectedExample, vn as ReadingTimeConfig, vt as DocsReviewCiMode, w as DocsAgentTraceStatus, wn as SidebarFolderNode, wt as DocsRobotsRule, x as DocsAgentGoldenTaskFilters, xn as SidebarComponentProps, xt as DocsReviewScoreConfig, y as DocsAgentGoldenTask, yn as ReadingTimeFormat, yt as DocsReviewConfig, z as DocsCloudConfig, zt as DocsTelemetryEvent } from "./types-BVgucdVm.mjs";
2
- import { $ as createDocsAgentTraceId, A as resolveDocsSitemapRequest, C as buildDocsSitemapManifest, D as renderDocsSitemapXml, E as renderDocsSitemapMarkdown, I as PromptAction, J as DOCS_AGENT_TRACE_EVENT_TYPES, L as PromptProviderChoice, O as resolveDocsSitemapConfig, Q as createDocsAgentTraceContext, R as SerializeOpenDocsProviderOptions, S as DocsSitemapResolvedConfig, T as readDocsSitemapManifestFromContentMap, X as ResolvedDocsAnalyticsConfig, Y as DocsAgentTraceContext, Z as ResolvedDocsObservabilityConfig, _ as DEFAULT_SITEMAP_XML_ROUTE, a as createMcpSearchAdapter, at as resolveDocsObservabilityConfig, b as DocsSitemapManifestPage, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, et as emitDocsAgentTraceEvent, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, h as DEFAULT_SITEMAP_MD_ROUTE, i as createCustomSearchAdapter, it as resolveDocsAnalyticsConfig, j as toDocsSitemapMarkdownUrl, k as resolveDocsSitemapPageLastmod, l as inferDocsAskAIPackageHints, m as DEFAULT_SITEMAP_MD_DOCS_ROUTE, n as buildDocsSearchDocuments, nt as emitDocsObservabilityEvent, o as createSimpleSearchAdapter, p as DEFAULT_SITEMAP_MANIFEST_PATH, r as createAlgoliaSearchAdapter, rt as getDocsRequestAnalyticsProperties, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, tt as emitDocsAnalyticsEvent, u as performDocsSearch, v as DocsSitemapFormat, w as createDocsSitemapResponse, x as DocsSitemapPageInput, y as DocsSitemapManifest, z as SerializedOpenDocsProvider } from "./search-CfWvmVYA.mjs";
1
+ import { $ as DocsFeedbackValue, $t as McpDocsSearchConfig, A as DocsAnalyticsSource, An as TypesenseDocsSearchConfig, At as DocsSearchDocument, B as DocsCloudFeatureConfig, Bt as DocsTelemetryEventInput, C as DocsAgentTraceEventType, Cn as SidebarFolderIndexBehavior, Ct as DocsRobotsConfig, D as DocsAnalyticsEventInput, Dn as SidebarTree, Dt as DocsSearchAdapterFactory, E as DocsAnalyticsEvent, En as SidebarPageNode, Et as DocsSearchAdapterContext, F as DocsAskAIFeedbackMessage, Ft as DocsSearchSourcePage, G as DocsCodeBlocksPlannerProvider, Gt as FeedbackConfig, H as DocsCloudPublishConfig, Ht as DocsTelemetryFeatures, I as DocsAskAIFeedbackValue, It as DocsSitemapConfig, J as DocsCodeBlocksValidateConfig, Jt as LastUpdatedConfig, K as DocsCodeBlocksRunnerConfig, Kt as FontStyle, L as DocsAskAIMcpConfig, Lt as DocsTelemetryAgentSurface, M as DocsAskAIActionType, Mn as UIConfig, Mt as DocsSearchQuery, N as DocsAskAIFeedbackConfig, Nt as DocsSearchResult, O as DocsAnalyticsEventType, On as SimpleDocsSearchConfig, Ot as DocsSearchChunkingConfig, P as DocsAskAIFeedbackData, Pt as DocsSearchResultType, Q as DocsFeedbackData, Qt as LlmsTxtSectionConfig, R as DocsCloudApiKeyConfig, Rt as DocsTelemetryConfig, S as DocsAgentTraceEventInput, Sn as SidebarConfig, St as DocsReviewSeverity, T as DocsAnalyticsConfig, Tn as SidebarNode, Tt as DocsSearchAdapter, U as DocsCodeBlocksConfig, Ut as DocsTelemetryFramework, V as DocsCloudPreviewConfig, Vt as DocsTelemetryEventType, W as DocsCodeBlocksPlannerConfig, Wt as DocsTheme, X as DocsCodeBlocksValidationPolicy, Xt as LlmsTxtMaxCharsConfig, Y as DocsCodeBlocksValidationMode, Yt as LlmsTxtConfig, Z as DocsConfig, Zt as LlmsTxtMaxCharsMode, _ as DocsAgentFeedbackData, _n as PageTwitter, _t as DocsReviewCiConfig, a as ApiReferenceRenderer, an as OpenDocsTarget, at as DocsMcpAuthenticateResult, b as DocsAgentGoldenTaskExpectation, bn as ResolvedDocsRelatedLink, bt as DocsReviewRulesConfig, c as ChangelogFrontmatter, cn as PageActionsConfig, ct as DocsMcpOriginContext, d as CopyMarkdownFormat, dn as PageAgentFailureMode, dt as DocsMetadata, en as OGConfig, et as DocsI18nConfig, f as CustomDocsSearchConfig, fn as PageAgentFrontmatter, ft as DocsNav, g as DocsAgentFeedbackContext, gn as PageSidebarFrontmatter, gt as DocsRelatedItem, h as DocsAgentEvaluationsConfig, hn as PageOpenGraph, ht as DocsObservabilityEventInput, i as ApiReferenceConfig, in as OpenDocsProviderId, it as DocsMcpAuthenticateContext, j as DocsAskAIActionData, jn as TypographyConfig, jt as DocsSearchEmbeddingsConfig, k as DocsAnalyticsInput, kn as ThemeToggleConfig, kt as DocsSearchConfig, l as CodeBlockCopyData, ln as PageAgentAppliesTo, lt as DocsMcpSecurityConfig, m as DocsAgentConfig, mn as PageFrontmatter, mt as DocsObservabilityEvent, n as AgentFeedbackConfig, nn as OpenDocsProvider, nt as DocsMcpAuthPrincipal, o as BreadcrumbConfig, on as OpenGraphImage, ot as DocsMcpConfig, p as DocsAgentCompactConfig, pn as PageAgentVerification, pt as DocsObservabilityConfig, q as DocsCodeBlocksRunnerProvider, qt as GithubConfig, r as AlgoliaDocsSearchConfig, rn as OpenDocsProviderConfig, rt as DocsMcpAuthenticate, s as ChangelogConfig, sn as OrderingItem, st as DocsMcpCorsConfig, t as AIConfig, tn as OpenDocsConfig, tt as DocsMcpAllowedOrigins, u as CopyMarkdownConfig, un as PageAgentCommand, ut as DocsMcpToolsConfig, v as DocsAgentGoldenExpectedExample, vn as ReadingTimeConfig, vt as DocsReviewCiMode, w as DocsAgentTraceStatus, wn as SidebarFolderNode, wt as DocsRobotsRule, x as DocsAgentGoldenTaskFilters, xn as SidebarComponentProps, xt as DocsReviewScoreConfig, y as DocsAgentGoldenTask, yn as ReadingTimeFormat, yt as DocsReviewConfig, z as DocsCloudConfig, zt as DocsTelemetryEvent } from "./types-R-DN23yw.mjs";
2
+ import { $ as resolveDocsAudienceMdxContent, A as resolveDocsSitemapRequest, C as buildDocsSitemapManifest, D as renderDocsSitemapXml, E as renderDocsSitemapMarkdown, I as PromptAction, J as DocsAudienceMdxIssue, L as PromptProviderChoice, O as resolveDocsSitemapConfig, Q as resolveDocsAudienceExposure, R as SerializeOpenDocsProviderOptions, S as DocsSitemapResolvedConfig, T as readDocsSitemapManifestFromContentMap, X as findDocsAudienceMdxIssues, Y as DocsContentAudience, Z as resolveDocsAgentMdxContent, _ as DEFAULT_SITEMAP_XML_ROUTE, a as createMcpSearchAdapter, at as createDocsAgentTraceId, b as DocsSitemapManifestPage, c as formatDocsAskAIPackageHints, ct as emitDocsObservabilityEvent, d as resolveAskAISearchRequestConfig, dt as resolveDocsObservabilityConfig, et as DOCS_AGENT_TRACE_EVENT_TYPES, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, h as DEFAULT_SITEMAP_MD_ROUTE, i as createCustomSearchAdapter, it as createDocsAgentTraceContext, j as toDocsSitemapMarkdownUrl, k as resolveDocsSitemapPageLastmod, l as inferDocsAskAIPackageHints, lt as getDocsRequestAnalyticsProperties, m as DEFAULT_SITEMAP_MD_DOCS_ROUTE, n as buildDocsSearchDocuments, nt as ResolvedDocsAnalyticsConfig, o as createSimpleSearchAdapter, ot as emitDocsAgentTraceEvent, p as DEFAULT_SITEMAP_MANIFEST_PATH, r as createAlgoliaSearchAdapter, rt as ResolvedDocsObservabilityConfig, s as createTypesenseSearchAdapter, st as emitDocsAnalyticsEvent, t as buildDocsAskAIContext, tt as DocsAgentTraceContext, u as performDocsSearch, ut as resolveDocsAnalyticsConfig, v as DocsSitemapFormat, w as createDocsSitemapResponse, x as DocsSitemapPageInput, y as DocsSitemapManifest, z as SerializedOpenDocsProvider } from "./search-9uEaC23e.mjs";
3
3
  import { DocsMcpPage, DocsMcpResolvedConfig } from "./mcp.mjs";
4
4
 
5
5
  //#region src/define-docs.d.ts
@@ -28,6 +28,10 @@ interface DocsTelemetryAgentSurfaceRequestOptions {
28
28
  feedback?: DocsConfig["feedback"];
29
29
  }
30
30
  declare function resolveDocsTelemetryConfig(telemetry?: boolean | DocsTelemetryConfig): ResolvedDocsTelemetryConfig;
31
+ /** Normalize an HTTP(S) telemetry site value to its origin. */
32
+ declare function normalizeDocsTelemetryOrigin(candidate: string | undefined): string | undefined;
33
+ /** Return whether a telemetry origin points at a local development server. */
34
+ declare function isLocalDocsTelemetryOrigin(candidate: string | undefined): boolean;
31
35
  declare function getDocsTelemetryFeatures(config: Partial<DocsConfig>): DocsTelemetryFeatures;
32
36
  declare function emitDocsTelemetryEvent(telemetry: boolean | DocsTelemetryConfig | undefined, event: DocsTelemetryEvent): Promise<void>;
33
37
  declare function emitDocsTelemetryProjectEvent(config: Partial<DocsConfig>, context?: DocsTelemetryContext): void;
@@ -535,6 +539,11 @@ interface DocsLlmsTxtPageInput {
535
539
  title: string;
536
540
  description?: string;
537
541
  content: string;
542
+ rawContent?: string;
543
+ agentContent?: string;
544
+ agentRawContent?: string;
545
+ agentFallbackContent?: string;
546
+ agentFallbackRawContent?: string;
538
547
  }
539
548
  interface DocsLlmsTxtGeneratedSection extends DocsLlmsTxtResolvedSection {
540
549
  llmsTxt: string;
@@ -734,7 +743,6 @@ declare function renderDocsMarkdownDocument(page: DocsMcpPage | DocsSearchSource
734
743
  declare function renderDocsMarkdownDocument(page: DocsMarkdownPage, options?: DocsMarkdownDocumentOptions): string;
735
744
  declare function renderDocsSkillDocument(options: DocsSkillDocumentOptions): string;
736
745
  declare function renderDocsAgentsDocument(options: DocsAgentsDocumentOptions): string;
737
- declare function resolveDocsAgentMdxContent(content: string, audience: "human" | "agent"): string;
738
746
  /** Resolve only the task tools that the advertised MCP endpoint actually exposes. */
739
747
  declare function resolveDocsAgentContractMcpTools(mcp: DocsMcpResolvedConfig): DocsAgentContractMcpTools | undefined;
740
748
  declare function buildDocsAgentDiscoverySpec({
@@ -1010,4 +1018,4 @@ declare function renderDocsRobotsGeneratedBlock(options?: DocsRobotsRenderOption
1010
1018
  declare function upsertDocsRobotsGeneratedBlock(existing: string, block: string): string;
1011
1019
  declare function analyzeDocsRobotsTxt(content: string, options?: DocsRobotsRenderOptions): DocsRobotsAnalysis;
1012
1020
  //#endregion
1013
- export { type AIConfig, type AgentFeedbackConfig, type AlgoliaDocsSearchConfig, type ApiReferenceConfig, type ApiReferenceRenderer, type BreadcrumbConfig, type ChangelogConfig, type ChangelogEntrySummary, type ChangelogFrontmatter, type CodeBlockCopyData, type CopyMarkdownConfig, type CopyMarkdownFormat, type CustomDocsSearchConfig, DEFAULT_AGENTS_MD_ROUTE, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA, DEFAULT_AGENT_FEEDBACK_ROUTE, DEFAULT_AGENT_MD_ROUTE, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_SPEC_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS, DEFAULT_DOCS_API_ROUTE, DEFAULT_DOCS_CONFIG_FORMAT, DEFAULT_DOCS_CONFIG_ROUTE, DEFAULT_DOCS_DIAGNOSTICS_FORMAT, DEFAULT_DOCS_DIAGNOSTICS_ROUTE, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, DEFAULT_LLMS_TXT_MAX_CHARS, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE, DEFAULT_OPENAPI_SCHEMA_ROUTE, DEFAULT_ROBOTS_TXT_ROUTE, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DEFAULT_SKILL_MD_ROUTE, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, DOCS_AGENT_CONTRACT_VERSION, DOCS_AGENT_TRACE_EVENT_TYPES, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, DOCS_ROBOTS_GENERATED_BLOCK_END, DOCS_ROBOTS_GENERATED_BLOCK_START, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, type DocsAgentAdapter, type DocsAgentCompactConfig, type DocsAgentConfig, type DocsAgentConformanceCaseResult, type DocsAgentConformanceReport, type DocsAgentContractCase, type DocsAgentContractExpectation, type DocsAgentContractMcpTools, type DocsAgentContractRequest, type DocsAgentContractSurface, type DocsAgentDiscoverySpecOptions, type DocsAgentEvaluationsConfig, type DocsAgentFeedbackContext, type DocsAgentFeedbackData, type DocsAgentFeedbackDiscoveryConfig, type DocsAgentFeedbackRequest, type DocsAgentFeedbackResolvedConfig, type DocsAgentGoldenExpectedExample, type DocsAgentGoldenTask, type DocsAgentGoldenTaskExpectation, type DocsAgentGoldenTaskFilters, type DocsAgentTraceContext, type DocsAgentTraceEventInput, type DocsAgentTraceEventType, type DocsAgentTraceStatus, type DocsAgentsDocumentOptions, type DocsAnalyticsConfig, type DocsAnalyticsEvent, type DocsAnalyticsEventInput, type DocsAnalyticsEventType, type DocsAnalyticsInput, type DocsAnalyticsSource, type DocsAskAIActionData, type DocsAskAIActionType, type DocsAskAIFeedbackConfig, type DocsAskAIFeedbackData, type DocsAskAIFeedbackMessage, type DocsAskAIFeedbackValue, type DocsAskAIMcpConfig, type DocsCloudApiKeyConfig, type DocsCloudConfig, type DocsCloudFeatureConfig, type DocsCloudPreviewConfig, type DocsCloudPublishConfig, type DocsCodeBlocksConfig, type DocsCodeBlocksPlannerConfig, type DocsCodeBlocksPlannerProvider, type DocsCodeBlocksRunnerConfig, type DocsCodeBlocksRunnerProvider, type DocsCodeBlocksValidateConfig, type DocsCodeBlocksValidationMode, type DocsCodeBlocksValidationPolicy, type DocsConfig, type DocsConfigMap, type DocsConfigMapJsonValue, type DocsConfigMapPointer, type DocsDiagnostics, type DocsDiagnosticsFeature, type DocsDiagnosticsIssue, type DocsDiagnosticsIssueSeverity, type DocsDiagnosticsOptions, type DocsDiagnosticsStatus, type DocsFeedbackData, type DocsFeedbackValue, type DocsI18nConfig, type DocsLlmsDiscoveryConfig, type DocsLlmsTxtGeneratedContent, type DocsLlmsTxtGeneratedSection, type DocsLlmsTxtMaxCharsIssue, type DocsLlmsTxtPageInput, type DocsLlmsTxtRequest, type DocsLlmsTxtResolvedMaxChars, type DocsLlmsTxtResolvedSection, type DocsLlmsTxtSelectedContent, type DocsMarkdownAgentDetection, type DocsMarkdownPage, type DocsMarkdownRecoveryMatch, type DocsMarkdownRecoveryResult, type DocsMarkdownResponseOptions, type DocsMcpAllowedOrigins, type DocsMcpAuthPrincipal, type DocsMcpAuthenticate, type DocsMcpAuthenticateContext, type DocsMcpAuthenticateResult, type DocsMcpConfig, type DocsMcpCorsConfig, type DocsMcpEndpointCandidate, type DocsMcpEndpointCandidateOptions, type DocsMcpOriginContext, type DocsMcpSecurityConfig, type DocsMcpToolsConfig, type DocsMetadata, type DocsNav, type DocsObservabilityConfig, type DocsObservabilityEvent, type DocsObservabilityEventInput, type DocsOpenApiDiscoveryConfig, type DocsOpenApiResolvedDiscoveryConfig, type DocsPageStructuredDataInput, type DocsPathMatch, type DocsRelatedItem, type DocsReviewCiConfig, type DocsReviewCiMode, type DocsReviewConfig, type DocsReviewRulesConfig, type DocsReviewScoreConfig, type DocsReviewSeverity, type DocsRobotsConfig, type DocsRobotsRenderOptions, type DocsRobotsResolvedConfig, type DocsRobotsRule, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchChunkingConfig, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchEmbeddingsConfig, type DocsSearchQuery, type DocsSearchResult, type DocsSearchResultType, type DocsSearchSourcePage, type DocsSitemapConfig, type DocsSitemapFormat, type DocsSitemapManifest, type DocsSitemapManifestPage, type DocsSitemapPageInput, type DocsSitemapResolvedConfig, type DocsSkillDocumentOptions, type DocsStructuredDataBreadcrumb, type DocsTelemetryAgentSurface, type DocsTelemetryAgentSurfaceContext, type DocsTelemetryAgentSurfaceRequestOptions, type DocsTelemetryConfig, type DocsTelemetryContext, type DocsTelemetryEvent, type DocsTelemetryEventInput, type DocsTelemetryEventType, type DocsTelemetryFeatures, type DocsTelemetryFramework, type DocsTheme, type FeedbackConfig, type FontStyle, GENERATED_AGENT_PROVENANCE_MARKER, GENERATED_AGENT_PROVENANCE_VERSION, type GeneratedAgentProvenance, type GeneratedAgentSourceKind, type GithubConfig, type LastUpdatedConfig, type LlmsTxtConfig, type LlmsTxtMaxCharsConfig, type LlmsTxtMaxCharsMode, type LlmsTxtSectionConfig, type McpDocsSearchConfig, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, type OpenDocsProviderConfig, type OpenDocsProviderId, type OpenDocsTarget, type OpenGraphImage, type OrderingItem, PAGE_AGENT_CONTRACT_END_MARKER, PAGE_AGENT_CONTRACT_FIELDS, PAGE_AGENT_CONTRACT_FIELD_SCHEMA, PAGE_AGENT_CONTRACT_START_MARKER, PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS, type PageActionsConfig, type PageAgentAppliesTo, type PageAgentCommand, type PageAgentFailureMode, type PageAgentFrontmatter, type PageAgentFrontmatterIssue, type PageAgentVerification, type PageFrontmatter, type PageOpenGraph, type PageSidebarFrontmatter, type PageTwitter, type PromptAction, type PromptProviderChoice, type ReadingTimeConfig, type ReadingTimeFormat, type ResolvedChangelogConfig, type ResolvedDocsAnalyticsConfig, type ResolvedDocsI18n, type ResolvedDocsObservabilityConfig, type ResolvedDocsRelatedLink, type ResolvedDocsTelemetryConfig, type RunDocsAgentConformanceOptions, type SerializeOpenDocsProviderOptions, type SerializedOpenDocsProvider, type SidebarComponentProps, type SidebarConfig, type SidebarFolderIndexBehavior, type SidebarFolderNode, type SidebarNode, type SidebarPageNode, type SidebarTree, type SimpleDocsSearchConfig, type ThemeToggleConfig, type TypesenseDocsSearchConfig, type TypographyConfig, type UIConfig, acceptsDocsMarkdown, analyzeDocsRobotsTxt, applySidebarFolderIndexBehavior, buildDocsAgentDiscoverySpec, buildDocsAgentFeedbackSchema, buildDocsAskAIContext, buildDocsConfigMap, buildDocsDiagnostics, buildDocsMcpEndpointCandidates, buildDocsPageStructuredData, buildDocsSearchDocuments, buildDocsSitemapManifest, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentContractCases, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, detectDocsMarkdownAgentRequest, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryEvent, emitDocsTelemetryMcpToolEvent, emitDocsTelemetryProjectEvent, estimateReadingTimeMinutes, extendTheme, findDocsMarkdownPage, formatDocsAskAIPackageHints, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownCanonicalLinkHeader, getDocsMarkdownVaryHeader, getDocsRequestAnalyticsProperties, getDocsRobotsAllowRoutes, getDocsTelemetryFeatures, getPageAgentFrontmatterIssues, hasDocsMarkdownSignatureAgent, hasStructuredPageAgentContract, hashGeneratedAgentContent, inferDocsAskAIPackageHints, inferDocsTelemetryAgentSurface, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsConfigRequest, isDocsDiagnosticsRequest, isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsSkillRequest, matchesDocsLlmsTxtSection, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsUrlPath, normalizeGeneratedAgentContent, normalizePageAgentFrontmatter, parseDocsAgentFeedbackData, parseGeneratedAgentDocument, performDocsSearch, readDocsSitemapManifestFromContentMap, renderDocsAgentsDocument, renderDocsLlmsTxt, renderDocsMarkdownDocument, renderDocsMarkdownNotFound, renderDocsPageStructuredDataJson, renderDocsRelatedMarkdownLines, renderDocsRobotsGeneratedBlock, renderDocsRobotsTxt, renderDocsSitemapMarkdown, renderDocsSitemapXml, renderDocsSkillDocument, renderPageAgentContractMarkdown, renderPageAgentFrontmatterYamlLines, resolveAskAISearchRequestConfig, resolveChangelogConfig, resolveDocsAgentContractMcpTools, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolveDocsAgentMdxContent, resolveDocsAgentsFormat, resolveDocsAnalyticsConfig, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLlmsTxtRequest, resolveDocsLlmsTxtSections, resolveDocsLocale, resolveDocsMarkdownCanonicalUrl, resolveDocsMarkdownRecovery, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsObservabilityConfig, resolveDocsOpenApiDiscoveryConfig, resolveDocsPath, resolveDocsRobotsConfig, resolveDocsRobotsRequest, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolveDocsSkillFormat, resolveDocsTelemetryConfig, resolveOGImage, resolvePageReadingTime, resolvePageSidebarFolderIndexBehavior, resolveReadingTimeFromContent, resolveReadingTimeFromSource, resolveReadingTimeOptions, resolveSearchRequestConfig, resolveSidebarFolderIndexBehavior, resolveSidebarFolderIndexBehaviorForPath, resolveTitle, runDocsAgentConformance, selectDocsLlmsTxtContent, serializeGeneratedAgentDocument, stripGeneratedAgentProvenance, stripGeneratedPageAgentContractMarkdown, toDocsMarkdownUrl, toDocsSitemapMarkdownUrl, upsertDocsRobotsGeneratedBlock, upsertPageAgentContractMarkdown, validateDocsAgentFeedbackPayload };
1021
+ export { type AIConfig, type AgentFeedbackConfig, type AlgoliaDocsSearchConfig, type ApiReferenceConfig, type ApiReferenceRenderer, type BreadcrumbConfig, type ChangelogConfig, type ChangelogEntrySummary, type ChangelogFrontmatter, type CodeBlockCopyData, type CopyMarkdownConfig, type CopyMarkdownFormat, type CustomDocsSearchConfig, DEFAULT_AGENTS_MD_ROUTE, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA, DEFAULT_AGENT_FEEDBACK_ROUTE, DEFAULT_AGENT_MD_ROUTE, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_SPEC_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS, DEFAULT_DOCS_API_ROUTE, DEFAULT_DOCS_CONFIG_FORMAT, DEFAULT_DOCS_CONFIG_ROUTE, DEFAULT_DOCS_DIAGNOSTICS_FORMAT, DEFAULT_DOCS_DIAGNOSTICS_ROUTE, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, DEFAULT_LLMS_TXT_MAX_CHARS, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE, DEFAULT_OPENAPI_SCHEMA_ROUTE, DEFAULT_ROBOTS_TXT_ROUTE, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DEFAULT_SKILL_MD_ROUTE, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, DOCS_AGENT_CONTRACT_VERSION, DOCS_AGENT_TRACE_EVENT_TYPES, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, DOCS_ROBOTS_GENERATED_BLOCK_END, DOCS_ROBOTS_GENERATED_BLOCK_START, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, type DocsAgentAdapter, type DocsAgentCompactConfig, type DocsAgentConfig, type DocsAgentConformanceCaseResult, type DocsAgentConformanceReport, type DocsAgentContractCase, type DocsAgentContractExpectation, type DocsAgentContractMcpTools, type DocsAgentContractRequest, type DocsAgentContractSurface, type DocsAgentDiscoverySpecOptions, type DocsAgentEvaluationsConfig, type DocsAgentFeedbackContext, type DocsAgentFeedbackData, type DocsAgentFeedbackDiscoveryConfig, type DocsAgentFeedbackRequest, type DocsAgentFeedbackResolvedConfig, type DocsAgentGoldenExpectedExample, type DocsAgentGoldenTask, type DocsAgentGoldenTaskExpectation, type DocsAgentGoldenTaskFilters, type DocsAgentTraceContext, type DocsAgentTraceEventInput, type DocsAgentTraceEventType, type DocsAgentTraceStatus, type DocsAgentsDocumentOptions, type DocsAnalyticsConfig, type DocsAnalyticsEvent, type DocsAnalyticsEventInput, type DocsAnalyticsEventType, type DocsAnalyticsInput, type DocsAnalyticsSource, type DocsAskAIActionData, type DocsAskAIActionType, type DocsAskAIFeedbackConfig, type DocsAskAIFeedbackData, type DocsAskAIFeedbackMessage, type DocsAskAIFeedbackValue, type DocsAskAIMcpConfig, type DocsAudienceMdxIssue, type DocsCloudApiKeyConfig, type DocsCloudConfig, type DocsCloudFeatureConfig, type DocsCloudPreviewConfig, type DocsCloudPublishConfig, type DocsCodeBlocksConfig, type DocsCodeBlocksPlannerConfig, type DocsCodeBlocksPlannerProvider, type DocsCodeBlocksRunnerConfig, type DocsCodeBlocksRunnerProvider, type DocsCodeBlocksValidateConfig, type DocsCodeBlocksValidationMode, type DocsCodeBlocksValidationPolicy, type DocsConfig, type DocsConfigMap, type DocsConfigMapJsonValue, type DocsConfigMapPointer, type DocsContentAudience, type DocsDiagnostics, type DocsDiagnosticsFeature, type DocsDiagnosticsIssue, type DocsDiagnosticsIssueSeverity, type DocsDiagnosticsOptions, type DocsDiagnosticsStatus, type DocsFeedbackData, type DocsFeedbackValue, type DocsI18nConfig, type DocsLlmsDiscoveryConfig, type DocsLlmsTxtGeneratedContent, type DocsLlmsTxtGeneratedSection, type DocsLlmsTxtMaxCharsIssue, type DocsLlmsTxtPageInput, type DocsLlmsTxtRequest, type DocsLlmsTxtResolvedMaxChars, type DocsLlmsTxtResolvedSection, type DocsLlmsTxtSelectedContent, type DocsMarkdownAgentDetection, type DocsMarkdownPage, type DocsMarkdownRecoveryMatch, type DocsMarkdownRecoveryResult, type DocsMarkdownResponseOptions, type DocsMcpAllowedOrigins, type DocsMcpAuthPrincipal, type DocsMcpAuthenticate, type DocsMcpAuthenticateContext, type DocsMcpAuthenticateResult, type DocsMcpConfig, type DocsMcpCorsConfig, type DocsMcpEndpointCandidate, type DocsMcpEndpointCandidateOptions, type DocsMcpOriginContext, type DocsMcpSecurityConfig, type DocsMcpToolsConfig, type DocsMetadata, type DocsNav, type DocsObservabilityConfig, type DocsObservabilityEvent, type DocsObservabilityEventInput, type DocsOpenApiDiscoveryConfig, type DocsOpenApiResolvedDiscoveryConfig, type DocsPageStructuredDataInput, type DocsPathMatch, type DocsRelatedItem, type DocsReviewCiConfig, type DocsReviewCiMode, type DocsReviewConfig, type DocsReviewRulesConfig, type DocsReviewScoreConfig, type DocsReviewSeverity, type DocsRobotsConfig, type DocsRobotsRenderOptions, type DocsRobotsResolvedConfig, type DocsRobotsRule, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchChunkingConfig, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchEmbeddingsConfig, type DocsSearchQuery, type DocsSearchResult, type DocsSearchResultType, type DocsSearchSourcePage, type DocsSitemapConfig, type DocsSitemapFormat, type DocsSitemapManifest, type DocsSitemapManifestPage, type DocsSitemapPageInput, type DocsSitemapResolvedConfig, type DocsSkillDocumentOptions, type DocsStructuredDataBreadcrumb, type DocsTelemetryAgentSurface, type DocsTelemetryAgentSurfaceContext, type DocsTelemetryAgentSurfaceRequestOptions, type DocsTelemetryConfig, type DocsTelemetryContext, type DocsTelemetryEvent, type DocsTelemetryEventInput, type DocsTelemetryEventType, type DocsTelemetryFeatures, type DocsTelemetryFramework, type DocsTheme, type FeedbackConfig, type FontStyle, GENERATED_AGENT_PROVENANCE_MARKER, GENERATED_AGENT_PROVENANCE_VERSION, type GeneratedAgentProvenance, type GeneratedAgentSourceKind, type GithubConfig, type LastUpdatedConfig, type LlmsTxtConfig, type LlmsTxtMaxCharsConfig, type LlmsTxtMaxCharsMode, type LlmsTxtSectionConfig, type McpDocsSearchConfig, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, type OpenDocsProviderConfig, type OpenDocsProviderId, type OpenDocsTarget, type OpenGraphImage, type OrderingItem, PAGE_AGENT_CONTRACT_END_MARKER, PAGE_AGENT_CONTRACT_FIELDS, PAGE_AGENT_CONTRACT_FIELD_SCHEMA, PAGE_AGENT_CONTRACT_START_MARKER, PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS, type PageActionsConfig, type PageAgentAppliesTo, type PageAgentCommand, type PageAgentFailureMode, type PageAgentFrontmatter, type PageAgentFrontmatterIssue, type PageAgentVerification, type PageFrontmatter, type PageOpenGraph, type PageSidebarFrontmatter, type PageTwitter, type PromptAction, type PromptProviderChoice, type ReadingTimeConfig, type ReadingTimeFormat, type ResolvedChangelogConfig, type ResolvedDocsAnalyticsConfig, type ResolvedDocsI18n, type ResolvedDocsObservabilityConfig, type ResolvedDocsRelatedLink, type ResolvedDocsTelemetryConfig, type RunDocsAgentConformanceOptions, type SerializeOpenDocsProviderOptions, type SerializedOpenDocsProvider, type SidebarComponentProps, type SidebarConfig, type SidebarFolderIndexBehavior, type SidebarFolderNode, type SidebarNode, type SidebarPageNode, type SidebarTree, type SimpleDocsSearchConfig, type ThemeToggleConfig, type TypesenseDocsSearchConfig, type TypographyConfig, type UIConfig, acceptsDocsMarkdown, analyzeDocsRobotsTxt, applySidebarFolderIndexBehavior, buildDocsAgentDiscoverySpec, buildDocsAgentFeedbackSchema, buildDocsAskAIContext, buildDocsConfigMap, buildDocsDiagnostics, buildDocsMcpEndpointCandidates, buildDocsPageStructuredData, buildDocsSearchDocuments, buildDocsSitemapManifest, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentContractCases, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, detectDocsMarkdownAgentRequest, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryEvent, emitDocsTelemetryMcpToolEvent, emitDocsTelemetryProjectEvent, estimateReadingTimeMinutes, extendTheme, findDocsAudienceMdxIssues, findDocsMarkdownPage, formatDocsAskAIPackageHints, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownCanonicalLinkHeader, getDocsMarkdownVaryHeader, getDocsRequestAnalyticsProperties, getDocsRobotsAllowRoutes, getDocsTelemetryFeatures, getPageAgentFrontmatterIssues, hasDocsMarkdownSignatureAgent, hasStructuredPageAgentContract, hashGeneratedAgentContent, inferDocsAskAIPackageHints, inferDocsTelemetryAgentSurface, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsConfigRequest, isDocsDiagnosticsRequest, isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsSkillRequest, isLocalDocsTelemetryOrigin, matchesDocsLlmsTxtSection, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsTelemetryOrigin, normalizeDocsUrlPath, normalizeGeneratedAgentContent, normalizePageAgentFrontmatter, parseDocsAgentFeedbackData, parseGeneratedAgentDocument, performDocsSearch, readDocsSitemapManifestFromContentMap, renderDocsAgentsDocument, renderDocsLlmsTxt, renderDocsMarkdownDocument, renderDocsMarkdownNotFound, renderDocsPageStructuredDataJson, renderDocsRelatedMarkdownLines, renderDocsRobotsGeneratedBlock, renderDocsRobotsTxt, renderDocsSitemapMarkdown, renderDocsSitemapXml, renderDocsSkillDocument, renderPageAgentContractMarkdown, renderPageAgentFrontmatterYamlLines, resolveAskAISearchRequestConfig, resolveChangelogConfig, resolveDocsAgentContractMcpTools, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolveDocsAgentMdxContent, resolveDocsAgentsFormat, resolveDocsAnalyticsConfig, resolveDocsAudienceExposure, resolveDocsAudienceMdxContent, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLlmsTxtRequest, resolveDocsLlmsTxtSections, resolveDocsLocale, resolveDocsMarkdownCanonicalUrl, resolveDocsMarkdownRecovery, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsObservabilityConfig, resolveDocsOpenApiDiscoveryConfig, resolveDocsPath, resolveDocsRobotsConfig, resolveDocsRobotsRequest, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolveDocsSkillFormat, resolveDocsTelemetryConfig, resolveOGImage, resolvePageReadingTime, resolvePageSidebarFolderIndexBehavior, resolveReadingTimeFromContent, resolveReadingTimeFromSource, resolveReadingTimeOptions, resolveSearchRequestConfig, resolveSidebarFolderIndexBehavior, resolveSidebarFolderIndexBehaviorForPath, resolveTitle, runDocsAgentConformance, selectDocsLlmsTxtContent, serializeGeneratedAgentDocument, stripGeneratedAgentProvenance, stripGeneratedPageAgentContractMarkdown, toDocsMarkdownUrl, toDocsSitemapMarkdownUrl, upsertDocsRobotsGeneratedBlock, upsertPageAgentContractMarkdown, validateDocsAgentFeedbackPayload };
package/dist/index.mjs CHANGED
@@ -1,8 +1,8 @@
1
- import { _ as extendTheme, a as resolveReadingTimeOptions, b as defineDocs, c as buildPageTwitter, d as resolveOGImage, f as resolveTitle, g as createTheme, h as runDocsAgentConformance, i as resolveReadingTimeFromSource, l as renderDocsPageStructuredDataJson, m as createDocsAgentContractCases, n as resolvePageReadingTime, o as buildDocsPageStructuredData, p as DOCS_AGENT_CONTRACT_VERSION, r as resolveReadingTimeFromContent, s as buildPageOpenGraph, t as estimateReadingTimeMinutes, u as resolveDocsMetadataBaseUrl, v as deepMerge, y as resolveChangelogConfig } from "./reading-time-BrTd3DIh.mjs";
1
+ import { _ as extendTheme, a as resolveReadingTimeOptions, b as defineDocs, c as buildPageTwitter, d as resolveOGImage, f as resolveTitle, g as createTheme, h as runDocsAgentConformance, i as resolveReadingTimeFromSource, l as renderDocsPageStructuredDataJson, m as createDocsAgentContractCases, n as resolvePageReadingTime, o as buildDocsPageStructuredData, p as DOCS_AGENT_CONTRACT_VERSION, r as resolveReadingTimeFromContent, s as buildPageOpenGraph, t as estimateReadingTimeMinutes, u as resolveDocsMetadataBaseUrl, v as deepMerge, y as resolveChangelogConfig } from "./reading-time-W_Id2ayC.mjs";
2
2
  import { a as emitDocsAnalyticsEvent, c as resolveDocsAnalyticsConfig, i as emitDocsAgentTraceEvent, l as resolveDocsObservabilityConfig, n as createDocsAgentTraceContext, o as emitDocsObservabilityEvent, r as createDocsAgentTraceId, s as getDocsRequestAnalyticsProperties, t as DOCS_AGENT_TRACE_EVENT_TYPES } from "./analytics-Bx44lg6d.mjs";
3
- import { $ as normalizeDocsPathSegment, A as DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, At as readDocsSitemapManifestFromContentMap, B as getDocsLlmsTxtMaxCharsIssue, Bt as PAGE_AGENT_CONTRACT_FIELDS, C as DEFAULT_OPENAPI_SCHEMA_ROUTE, Ct as DEFAULT_SITEMAP_MANIFEST_PATH, D as DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, Dt as DEFAULT_SITEMAP_XML_ROUTE, E as DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, Et as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, F as buildDocsDiagnostics, Ft as resolveDocsSitemapRequest, G as isDocsAgentsRequest, Gt as hasStructuredPageAgentContract, H as getDocsMarkdownVaryHeader, Ht as PAGE_AGENT_CONTRACT_START_MARKER, I as buildDocsMcpEndpointCandidates, It as toDocsSitemapMarkdownUrl, J as isDocsLlmsTxtPublicRequest, Jt as renderPageAgentFrontmatterYamlLines, K as isDocsConfigRequest, Kt as normalizePageAgentFrontmatter, L as createDocsMarkdownResponse, Lt as normalizeDocsRelated, M as buildDocsAgentDiscoverySpec, Mt as renderDocsSitemapXml, N as buildDocsAgentFeedbackSchema, Nt as resolveDocsSitemapConfig, Ot as buildDocsSitemapManifest, P as buildDocsConfigMap, Pt as resolveDocsSitemapPageLastmod, Q as matchesDocsLlmsTxtSection, R as detectDocsMarkdownAgentRequest, Rt as renderDocsRelatedMarkdownLines, S as DEFAULT_MCP_WELL_KNOWN_ROUTE, St as validateDocsAgentFeedbackPayload, T as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Tt as DEFAULT_SITEMAP_MD_ROUTE, U as hasDocsMarkdownSignatureAgent, Ut as PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS, V as getDocsMarkdownCanonicalLinkHeader, Vt as PAGE_AGENT_CONTRACT_FIELD_SCHEMA, W as isDocsAgentDiscoveryRequest, Wt as getPageAgentFrontmatterIssues, X as isDocsPublicGetRequest, Xt as upsertPageAgentContractMarkdown, Y as isDocsMcpRequest, Yt as stripGeneratedPageAgentContractMarkdown, Z as isDocsSkillRequest, _ as DEFAULT_LLMS_TXT_MAX_CHARS, _t as resolveDocsMarkdownRequest, a as DEFAULT_AGENT_MD_ROUTE, at as renderDocsMarkdownNotFound, b as DEFAULT_MCP_PUBLIC_ROUTE, bt as selectDocsLlmsTxtContent, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, ct as resolveDocsAgentFeedbackConfig, d as DEFAULT_DOCS_CONFIG_FORMAT, dt as resolveDocsAgentsFormat, et as normalizeDocsUrlPath, f as DEFAULT_DOCS_CONFIG_ROUTE, ft as resolveDocsLlmsTxtFormat, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, gt as resolveDocsMarkdownRecovery, h as DEFAULT_LLMS_FULL_TXT_ROUTE, ht as resolveDocsMarkdownCanonicalUrl, i as DEFAULT_AGENT_FEEDBACK_ROUTE, it as renderDocsMarkdownDocument, j as acceptsDocsMarkdown, jt as renderDocsSitemapMarkdown, k as DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, kt as createDocsSitemapResponse, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, lt as resolveDocsAgentFeedbackRequest, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, mt as resolveDocsLlmsTxtSections, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nt as renderDocsAgentsDocument, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, ot as renderDocsSkillDocument, p as DEFAULT_DOCS_DIAGNOSTICS_FORMAT, pt as resolveDocsLlmsTxtRequest, q as isDocsDiagnosticsRequest, qt as renderPageAgentContractMarkdown, r as DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA, rt as renderDocsLlmsTxt, s as DEFAULT_AGENT_SPEC_ROUTE, st as resolveDocsAgentContractMcpTools, t as DEFAULT_AGENTS_MD_ROUTE, tt as parseDocsAgentFeedbackData, u as DEFAULT_DOCS_API_ROUTE, ut as resolveDocsAgentMdxContent, v as DEFAULT_LLMS_TXT_ROUTE, vt as resolveDocsOpenApiDiscoveryConfig, w as DEFAULT_SKILL_MD_ROUTE, wt as DEFAULT_SITEMAP_MD_DOCS_ROUTE, x as DEFAULT_MCP_ROUTE, xt as toDocsMarkdownUrl, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, yt as resolveDocsSkillFormat, z as findDocsMarkdownPage, zt as PAGE_AGENT_CONTRACT_END_MARKER } from "./agent-DXkXi-pS.mjs";
4
- import { A as getDocsTelemetryFeatures, C as resolvePageSidebarFolderIndexBehavior, D as emitDocsTelemetryEvent, E as emitDocsTelemetryAgentSurfaceEvent, M as resolveDocsTelemetryConfig, O as emitDocsTelemetryMcpToolEvent, S as applySidebarFolderIndexBehavior, T as resolveSidebarFolderIndexBehaviorForPath, _ as hashGeneratedAgentContent, a as createMcpSearchAdapter, b as serializeGeneratedAgentDocument, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, g as GENERATED_AGENT_PROVENANCE_VERSION, h as GENERATED_AGENT_PROVENANCE_MARKER, i as createCustomSearchAdapter, j as inferDocsTelemetryAgentSurface, k as emitDocsTelemetryProjectEvent, l as inferDocsAskAIPackageHints, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch, v as normalizeGeneratedAgentContent, w as resolveSidebarFolderIndexBehavior, x as stripGeneratedAgentProvenance, y as parseGeneratedAgentDocument } from "./search-CJIC1Cqo.mjs";
3
+ import { $ as normalizeDocsPathSegment, $t as stripGeneratedPageAgentContractMarkdown, A as DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, At as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, B as getDocsLlmsTxtMaxCharsIssue, Bt as toDocsSitemapMarkdownUrl, C as DEFAULT_OPENAPI_SCHEMA_ROUTE, D as DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, Dt as DEFAULT_SITEMAP_MANIFEST_PATH, E as DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, Et as resolveDocsAudienceMdxContent, F as buildDocsDiagnostics, Ft as renderDocsSitemapMarkdown, G as isDocsAgentsRequest, Gt as PAGE_AGENT_CONTRACT_FIELD_SCHEMA, H as getDocsMarkdownVaryHeader, Ht as renderDocsRelatedMarkdownLines, I as buildDocsMcpEndpointCandidates, It as renderDocsSitemapXml, J as isDocsLlmsTxtPublicRequest, Jt as getPageAgentFrontmatterIssues, K as isDocsConfigRequest, Kt as PAGE_AGENT_CONTRACT_START_MARKER, L as createDocsMarkdownResponse, Lt as resolveDocsSitemapConfig, M as buildDocsAgentDiscoverySpec, Mt as buildDocsSitemapManifest, N as buildDocsAgentFeedbackSchema, Nt as createDocsSitemapResponse, Ot as DEFAULT_SITEMAP_MD_DOCS_ROUTE, P as buildDocsConfigMap, Pt as readDocsSitemapManifestFromContentMap, Q as matchesDocsLlmsTxtSection, Qt as renderPageAgentFrontmatterYamlLines, R as detectDocsMarkdownAgentRequest, Rt as resolveDocsSitemapPageLastmod, S as DEFAULT_MCP_WELL_KNOWN_ROUTE, St as findDocsAudienceMdxIssues, T as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Tt as resolveDocsAudienceExposure, U as hasDocsMarkdownSignatureAgent, Ut as PAGE_AGENT_CONTRACT_END_MARKER, V as getDocsMarkdownCanonicalLinkHeader, Vt as normalizeDocsRelated, W as isDocsAgentDiscoveryRequest, Wt as PAGE_AGENT_CONTRACT_FIELDS, X as isDocsPublicGetRequest, Xt as normalizePageAgentFrontmatter, Y as isDocsMcpRequest, Yt as hasStructuredPageAgentContract, Z as isDocsSkillRequest, Zt as renderPageAgentContractMarkdown, _ as DEFAULT_LLMS_TXT_MAX_CHARS, _t as resolveDocsOpenApiDiscoveryConfig, a as DEFAULT_AGENT_MD_ROUTE, at as renderDocsMarkdownNotFound, b as DEFAULT_MCP_PUBLIC_ROUTE, bt as toDocsMarkdownUrl, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, ct as resolveDocsAgentFeedbackConfig, d as DEFAULT_DOCS_CONFIG_FORMAT, dt as resolveDocsLlmsTxtFormat, en as upsertPageAgentContractMarkdown, et as normalizeDocsUrlPath, f as DEFAULT_DOCS_CONFIG_ROUTE, ft as resolveDocsLlmsTxtRequest, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, gt as resolveDocsMarkdownRequest, h as DEFAULT_LLMS_FULL_TXT_ROUTE, ht as resolveDocsMarkdownRecovery, i as DEFAULT_AGENT_FEEDBACK_ROUTE, it as renderDocsMarkdownDocument, j as acceptsDocsMarkdown, jt as DEFAULT_SITEMAP_XML_ROUTE, k as DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, kt as DEFAULT_SITEMAP_MD_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, lt as resolveDocsAgentFeedbackRequest, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, mt as resolveDocsMarkdownCanonicalUrl, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nt as renderDocsAgentsDocument, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, ot as renderDocsSkillDocument, p as DEFAULT_DOCS_DIAGNOSTICS_FORMAT, pt as resolveDocsLlmsTxtSections, q as isDocsDiagnosticsRequest, qt as PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS, r as DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA, rt as renderDocsLlmsTxt, s as DEFAULT_AGENT_SPEC_ROUTE, st as resolveDocsAgentContractMcpTools, t as DEFAULT_AGENTS_MD_ROUTE, tt as parseDocsAgentFeedbackData, u as DEFAULT_DOCS_API_ROUTE, ut as resolveDocsAgentsFormat, v as DEFAULT_LLMS_TXT_ROUTE, vt as resolveDocsSkillFormat, w as DEFAULT_SKILL_MD_ROUTE, wt as resolveDocsAgentMdxContent, x as DEFAULT_MCP_ROUTE, xt as validateDocsAgentFeedbackPayload, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, yt as selectDocsLlmsTxtContent, z as findDocsMarkdownPage, zt as resolveDocsSitemapRequest } from "./agent-CxDzPqtl.mjs";
4
+ import { A as getDocsTelemetryFeatures, C as resolvePageSidebarFolderIndexBehavior, D as emitDocsTelemetryEvent, E as emitDocsTelemetryAgentSurfaceEvent, M as isLocalDocsTelemetryOrigin, N as normalizeDocsTelemetryOrigin, O as emitDocsTelemetryMcpToolEvent, P as resolveDocsTelemetryConfig, S as applySidebarFolderIndexBehavior, T as resolveSidebarFolderIndexBehaviorForPath, _ as hashGeneratedAgentContent, a as createMcpSearchAdapter, b as serializeGeneratedAgentDocument, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, g as GENERATED_AGENT_PROVENANCE_VERSION, h as GENERATED_AGENT_PROVENANCE_MARKER, i as createCustomSearchAdapter, j as inferDocsTelemetryAgentSurface, k as emitDocsTelemetryProjectEvent, l as inferDocsAskAIPackageHints, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch, v as normalizeGeneratedAgentContent, w as resolveSidebarFolderIndexBehavior, x as stripGeneratedAgentProvenance, y as parseGeneratedAgentDocument } from "./search-OHp36znm.mjs";
5
5
  import { n as resolveDocsLocale, r as resolveDocsPath, t as resolveDocsI18n } from "./i18n-CAlj1ADU.mjs";
6
- import { a as analyzeDocsRobotsTxt, c as renderDocsRobotsGeneratedBlock, d as resolveDocsRobotsRequest, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, l as renderDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, o as createDocsRobotsResponse, r as DOCS_ROBOTS_GENERATED_BLOCK_END, s as getDocsRobotsAllowRoutes, t as DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS, u as resolveDocsRobotsConfig } from "./robots-DAptQnkx.mjs";
6
+ import { a as analyzeDocsRobotsTxt, c as renderDocsRobotsGeneratedBlock, d as resolveDocsRobotsRequest, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, l as renderDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, o as createDocsRobotsResponse, r as DOCS_ROBOTS_GENERATED_BLOCK_END, s as getDocsRobotsAllowRoutes, t as DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS, u as resolveDocsRobotsConfig } from "./robots-DRpoiYAV.mjs";
7
7
 
8
- export { DEFAULT_AGENTS_MD_ROUTE, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA, DEFAULT_AGENT_FEEDBACK_ROUTE, DEFAULT_AGENT_MD_ROUTE, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_SPEC_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS, DEFAULT_DOCS_API_ROUTE, DEFAULT_DOCS_CONFIG_FORMAT, DEFAULT_DOCS_CONFIG_ROUTE, DEFAULT_DOCS_DIAGNOSTICS_FORMAT, DEFAULT_DOCS_DIAGNOSTICS_ROUTE, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, DEFAULT_LLMS_TXT_MAX_CHARS, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE, DEFAULT_OPENAPI_SCHEMA_ROUTE, DEFAULT_ROBOTS_TXT_ROUTE, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DEFAULT_SKILL_MD_ROUTE, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, DOCS_AGENT_CONTRACT_VERSION, DOCS_AGENT_TRACE_EVENT_TYPES, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, DOCS_ROBOTS_GENERATED_BLOCK_END, DOCS_ROBOTS_GENERATED_BLOCK_START, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, GENERATED_AGENT_PROVENANCE_MARKER, GENERATED_AGENT_PROVENANCE_VERSION, PAGE_AGENT_CONTRACT_END_MARKER, PAGE_AGENT_CONTRACT_FIELDS, PAGE_AGENT_CONTRACT_FIELD_SCHEMA, PAGE_AGENT_CONTRACT_START_MARKER, PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS, acceptsDocsMarkdown, analyzeDocsRobotsTxt, applySidebarFolderIndexBehavior, buildDocsAgentDiscoverySpec, buildDocsAgentFeedbackSchema, buildDocsAskAIContext, buildDocsConfigMap, buildDocsDiagnostics, buildDocsMcpEndpointCandidates, buildDocsPageStructuredData, buildDocsSearchDocuments, buildDocsSitemapManifest, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentContractCases, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, detectDocsMarkdownAgentRequest, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryEvent, emitDocsTelemetryMcpToolEvent, emitDocsTelemetryProjectEvent, estimateReadingTimeMinutes, extendTheme, findDocsMarkdownPage, formatDocsAskAIPackageHints, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownCanonicalLinkHeader, getDocsMarkdownVaryHeader, getDocsRequestAnalyticsProperties, getDocsRobotsAllowRoutes, getDocsTelemetryFeatures, getPageAgentFrontmatterIssues, hasDocsMarkdownSignatureAgent, hasStructuredPageAgentContract, hashGeneratedAgentContent, inferDocsAskAIPackageHints, inferDocsTelemetryAgentSurface, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsConfigRequest, isDocsDiagnosticsRequest, isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsSkillRequest, matchesDocsLlmsTxtSection, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsUrlPath, normalizeGeneratedAgentContent, normalizePageAgentFrontmatter, parseDocsAgentFeedbackData, parseGeneratedAgentDocument, performDocsSearch, readDocsSitemapManifestFromContentMap, renderDocsAgentsDocument, renderDocsLlmsTxt, renderDocsMarkdownDocument, renderDocsMarkdownNotFound, renderDocsPageStructuredDataJson, renderDocsRelatedMarkdownLines, renderDocsRobotsGeneratedBlock, renderDocsRobotsTxt, renderDocsSitemapMarkdown, renderDocsSitemapXml, renderDocsSkillDocument, renderPageAgentContractMarkdown, renderPageAgentFrontmatterYamlLines, resolveAskAISearchRequestConfig, resolveChangelogConfig, resolveDocsAgentContractMcpTools, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolveDocsAgentMdxContent, resolveDocsAgentsFormat, resolveDocsAnalyticsConfig, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLlmsTxtRequest, resolveDocsLlmsTxtSections, resolveDocsLocale, resolveDocsMarkdownCanonicalUrl, resolveDocsMarkdownRecovery, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsObservabilityConfig, resolveDocsOpenApiDiscoveryConfig, resolveDocsPath, resolveDocsRobotsConfig, resolveDocsRobotsRequest, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolveDocsSkillFormat, resolveDocsTelemetryConfig, resolveOGImage, resolvePageReadingTime, resolvePageSidebarFolderIndexBehavior, resolveReadingTimeFromContent, resolveReadingTimeFromSource, resolveReadingTimeOptions, resolveSearchRequestConfig, resolveSidebarFolderIndexBehavior, resolveSidebarFolderIndexBehaviorForPath, resolveTitle, runDocsAgentConformance, selectDocsLlmsTxtContent, serializeGeneratedAgentDocument, stripGeneratedAgentProvenance, stripGeneratedPageAgentContractMarkdown, toDocsMarkdownUrl, toDocsSitemapMarkdownUrl, upsertDocsRobotsGeneratedBlock, upsertPageAgentContractMarkdown, validateDocsAgentFeedbackPayload };
8
+ export { DEFAULT_AGENTS_MD_ROUTE, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA, DEFAULT_AGENT_FEEDBACK_ROUTE, DEFAULT_AGENT_MD_ROUTE, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_SPEC_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS, DEFAULT_DOCS_API_ROUTE, DEFAULT_DOCS_CONFIG_FORMAT, DEFAULT_DOCS_CONFIG_ROUTE, DEFAULT_DOCS_DIAGNOSTICS_FORMAT, DEFAULT_DOCS_DIAGNOSTICS_ROUTE, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, DEFAULT_LLMS_TXT_MAX_CHARS, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE, DEFAULT_OPENAPI_SCHEMA_ROUTE, DEFAULT_ROBOTS_TXT_ROUTE, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DEFAULT_SKILL_MD_ROUTE, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, DOCS_AGENT_CONTRACT_VERSION, DOCS_AGENT_TRACE_EVENT_TYPES, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, DOCS_ROBOTS_GENERATED_BLOCK_END, DOCS_ROBOTS_GENERATED_BLOCK_START, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, GENERATED_AGENT_PROVENANCE_MARKER, GENERATED_AGENT_PROVENANCE_VERSION, PAGE_AGENT_CONTRACT_END_MARKER, PAGE_AGENT_CONTRACT_FIELDS, PAGE_AGENT_CONTRACT_FIELD_SCHEMA, PAGE_AGENT_CONTRACT_START_MARKER, PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS, acceptsDocsMarkdown, analyzeDocsRobotsTxt, applySidebarFolderIndexBehavior, buildDocsAgentDiscoverySpec, buildDocsAgentFeedbackSchema, buildDocsAskAIContext, buildDocsConfigMap, buildDocsDiagnostics, buildDocsMcpEndpointCandidates, buildDocsPageStructuredData, buildDocsSearchDocuments, buildDocsSitemapManifest, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentContractCases, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, detectDocsMarkdownAgentRequest, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryEvent, emitDocsTelemetryMcpToolEvent, emitDocsTelemetryProjectEvent, estimateReadingTimeMinutes, extendTheme, findDocsAudienceMdxIssues, findDocsMarkdownPage, formatDocsAskAIPackageHints, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownCanonicalLinkHeader, getDocsMarkdownVaryHeader, getDocsRequestAnalyticsProperties, getDocsRobotsAllowRoutes, getDocsTelemetryFeatures, getPageAgentFrontmatterIssues, hasDocsMarkdownSignatureAgent, hasStructuredPageAgentContract, hashGeneratedAgentContent, inferDocsAskAIPackageHints, inferDocsTelemetryAgentSurface, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsConfigRequest, isDocsDiagnosticsRequest, isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsSkillRequest, isLocalDocsTelemetryOrigin, matchesDocsLlmsTxtSection, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsTelemetryOrigin, normalizeDocsUrlPath, normalizeGeneratedAgentContent, normalizePageAgentFrontmatter, parseDocsAgentFeedbackData, parseGeneratedAgentDocument, performDocsSearch, readDocsSitemapManifestFromContentMap, renderDocsAgentsDocument, renderDocsLlmsTxt, renderDocsMarkdownDocument, renderDocsMarkdownNotFound, renderDocsPageStructuredDataJson, renderDocsRelatedMarkdownLines, renderDocsRobotsGeneratedBlock, renderDocsRobotsTxt, renderDocsSitemapMarkdown, renderDocsSitemapXml, renderDocsSkillDocument, renderPageAgentContractMarkdown, renderPageAgentFrontmatterYamlLines, resolveAskAISearchRequestConfig, resolveChangelogConfig, resolveDocsAgentContractMcpTools, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolveDocsAgentMdxContent, resolveDocsAgentsFormat, resolveDocsAnalyticsConfig, resolveDocsAudienceExposure, resolveDocsAudienceMdxContent, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLlmsTxtRequest, resolveDocsLlmsTxtSections, resolveDocsLocale, resolveDocsMarkdownCanonicalUrl, resolveDocsMarkdownRecovery, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsObservabilityConfig, resolveDocsOpenApiDiscoveryConfig, resolveDocsPath, resolveDocsRobotsConfig, resolveDocsRobotsRequest, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolveDocsSkillFormat, resolveDocsTelemetryConfig, resolveOGImage, resolvePageReadingTime, resolvePageSidebarFolderIndexBehavior, resolveReadingTimeFromContent, resolveReadingTimeFromSource, resolveReadingTimeOptions, resolveSearchRequestConfig, resolveSidebarFolderIndexBehavior, resolveSidebarFolderIndexBehaviorForPath, resolveTitle, runDocsAgentConformance, selectDocsLlmsTxtContent, serializeGeneratedAgentDocument, stripGeneratedAgentProvenance, stripGeneratedPageAgentContractMarkdown, toDocsMarkdownUrl, toDocsSitemapMarkdownUrl, upsertDocsRobotsGeneratedBlock, upsertPageAgentContractMarkdown, validateDocsAgentFeedbackPayload };