@farming-labs/docs 0.2.104 → 0.2.106

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 (78) hide show
  1. package/dist/{agent-NerpHcQB.mjs → agent-CaCWThBY.mjs} +4 -4
  2. package/dist/{agent-PSrgiJD8.mjs → agent-DCTGj6J7.mjs} +48 -12
  3. package/dist/{agent-evals-U9d_db2u.mjs → agent-evals-D-sPJfXz.mjs} +5 -5
  4. package/dist/{agent-export-DlBUKkTt.mjs → agent-export-GcTZPLfB.mjs} +19 -17
  5. package/dist/agent-feedback-evaluations-DQCTFegz.mjs +240 -0
  6. package/dist/agent-maintenance-CuZ7iAKq.mjs +289 -0
  7. package/dist/agent-skills-bundle.d.mts +1 -1
  8. package/dist/{agent-skills-progressive-disclosure-CfIsq4Ew.mjs → agent-skills-progressive-disclosure-DL-q4JZo.mjs} +1 -1
  9. package/dist/{agent-skills-server-CIoL58X7.d.mts → agent-skills-server-D34054x5.d.mts} +2 -2
  10. package/dist/{agent-skills-server-DFqQyO_V.mjs → agent-skills-server-Ddbf15pY.mjs} +1 -1
  11. package/dist/agent-skills-vite.d.mts +3 -3
  12. package/dist/agent-skills-vite.mjs +2 -2
  13. package/dist/{agents-D3SLnQet.mjs → agents-e1SYT64z.mjs} +11 -11
  14. package/dist/{analytics-Bx44lg6d.mjs → analytics-CqfcIBdg.mjs} +1 -1
  15. package/dist/{analytics-B-jz7re8.d.mts → analytics-aeXwEvQX.d.mts} +1 -1
  16. package/dist/{authoring-BsWXMH43.mjs → authoring-Do87QzBd.mjs} +6 -6
  17. package/dist/{authoring-mcp-BCM5CJbJ.mjs → authoring-mcp-Be7quE5R.mjs} +2 -2
  18. package/dist/browser.d.mts +3 -3
  19. package/dist/browser.mjs +2 -2
  20. package/dist/cli/index.mjs +71 -35
  21. package/dist/client/react.d.mts +1 -1
  22. package/dist/client/react.mjs +1 -1
  23. package/dist/{cloud-BLxt_HYO.mjs → cloud-Bvof6mET.mjs} +3 -3
  24. package/dist/{cloud-ask-ai-19G2HJ62.d.mts → cloud-ask-ai-BqfiQaNZ.d.mts} +1 -1
  25. package/dist/{cloud-ask-ai-DeojA5lB.mjs → cloud-ask-ai-CK2qlNns.mjs} +1 -1
  26. package/dist/{codeblocks-qHdKGVaE.mjs → codeblocks-C911CdyJ.mjs} +2 -2
  27. package/dist/{agent-C9IdC__R.d.mts → content-change-hydration-CoYRs3pC.d.mts} +704 -678
  28. package/dist/{dev-B0iHJjTz.mjs → dev-Bx0JNglW.mjs} +2 -2
  29. package/dist/docs-cloud-server.d.mts +2 -2
  30. package/dist/docs-cloud-server.mjs +2 -2
  31. package/dist/{doctor-x3k6aE2I.mjs → doctor-CtK1CRPj.mjs} +17 -17
  32. package/dist/{downgrade-Dd3vvVdD.mjs → downgrade-BXmQMkMy.mjs} +2 -2
  33. package/dist/{feedback-DdWc33oO.mjs → feedback-DWVUMrxy.mjs} +1 -1
  34. package/dist/feedback-evals-k0sFDdms.mjs +146 -0
  35. package/dist/{golden-evaluations-7k7Akp3R.mjs → golden-evaluations-De4KwoYr.mjs} +3 -3
  36. package/dist/index.d.mts +174 -9
  37. package/dist/index.mjs +14 -11
  38. package/dist/{init-DKukQdOQ.mjs → init-CCV2eRNB.mjs} +3 -3
  39. package/dist/markdown-rendering.mjs +1 -1
  40. package/dist/{markdown-sections-7OoA7ylx.mjs → markdown-sections-BKy4labo.mjs} +110 -2
  41. package/dist/{mcp-B6ZZdp6F.mjs → mcp-DsjWxF7g.mjs} +11 -11
  42. package/dist/mcp.d.mts +5 -3
  43. package/dist/mcp.mjs +92 -29
  44. package/dist/{metadata-D4v_R1t5.mjs → metadata-7htr-Xj_.mjs} +1 -1
  45. package/dist/{openapi-mcp-B7u7Y0gB.mjs → openapi-mcp-DQ3xptKo.mjs} +68 -4
  46. package/dist/openapi-mcp-node-vO3IXVGI.mjs +43 -0
  47. package/dist/{package-version-P4TT_9IO.mjs → package-version-Ci99L0yo.mjs} +1 -1
  48. package/dist/{prompt-references-Ca2Rcrpw.mjs → prompt-references-1Wce71c7.mjs} +3 -3
  49. package/dist/propose-DJOiHu9Y.mjs +73 -0
  50. package/dist/retrieval-digest-B-SgtXKK.mjs +177 -0
  51. package/dist/retrieval-digest-DyNRD-mt.d.mts +467 -0
  52. package/dist/{review-DgaNTtP0.mjs → review-XI9FXeos.mjs} +12 -12
  53. package/dist/{robots-DNod0XKB.mjs → robots-BOjWB1ky.mjs} +2 -2
  54. package/dist/{robots-msD1xoH5.mjs → robots-CzKesbdX.mjs} +6 -6
  55. package/dist/{search-CNzq9S5S.mjs → search-DwAoC9X7.mjs} +12 -12
  56. package/dist/server.d.mts +6 -308
  57. package/dist/server.mjs +13 -12
  58. package/dist/{sidebar-DmXRpAAK.d.mts → sidebar-CJze8SBi.d.mts} +1 -1
  59. package/dist/{sitemap-CHvips7o.mjs → sitemap-DOaJIKJf.mjs} +11 -11
  60. package/dist/{sitemap-server-C2TauhKa.mjs → sitemap-server-NeVu8W38.mjs} +1 -1
  61. package/dist/{skills-aaE5L1go.mjs → skills-BILSESek.mjs} +11 -11
  62. package/dist/{standards-discovery-Ckx0tN7B.mjs → standards-discovery-Bpz90VYq.mjs} +2 -177
  63. package/dist/{standards-discovery-Cqq8QmlH.d.mts → standards-discovery-Xm84bS4M.d.mts} +1 -1
  64. package/dist/{types-BthCiAD9.d.mts → types-QhYMnKvb.d.mts} +35 -2
  65. package/dist/{upgrade-B0OA_7jE.mjs → upgrade-B92U83xo.mjs} +2 -2
  66. package/package.json +1 -1
  67. package/styles/themes/shadcn.css +232 -38
  68. package/dist/retrieval-digest-DT9Ktc4C.d.mts +0 -164
  69. /package/dist/{agent-feedback-loop-CGrc-gDW.mjs → agent-feedback-loop-vaC-M1sx.mjs} +0 -0
  70. /package/dist/{audience-exposure-BW13cI2O.d.mts → audience-exposure-CkNZNeVX.d.mts} +0 -0
  71. /package/dist/{cloud-analytics-CSyFE6SS.mjs → cloud-analytics-Ci1yiwD8.mjs} +0 -0
  72. /package/dist/{code-blocks-c3nIrWOM.mjs → code-blocks-D90CCJFs.mjs} +0 -0
  73. /package/dist/{config-BhF6J2N4.mjs → config-DrZ3fXgf.mjs} +0 -0
  74. /package/dist/{errors-B5KTe1Xo.mjs → errors-BDmra6mz.mjs} +0 -0
  75. /package/dist/{i18n-B3BIxShC.mjs → i18n-B1gJ9EW0.mjs} +0 -0
  76. /package/dist/{sidebar-IcpElOVH.mjs → sidebar-3W51s2sF.mjs} +0 -0
  77. /package/dist/{templates-m_j4ARnu.mjs → templates-DdB4BBGq.mjs} +0 -0
  78. /package/dist/{utils-DcCUwxqS.mjs → utils-Cc1SrVza.mjs} +0 -0
@@ -1,181 +1,6 @@
1
+ import { i as sha256DocsContent } from "./retrieval-digest-B-SgtXKK.mjs";
1
2
  import { parseDocsAgentSkillFrontmatter, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
2
3
 
3
- //#region src/retrieval-digest.ts
4
- const SHA256_INITIAL_STATE = [
5
- 1779033703,
6
- 3144134277,
7
- 1013904242,
8
- 2773480762,
9
- 1359893119,
10
- 2600822924,
11
- 528734635,
12
- 1541459225
13
- ];
14
- const SHA256_ROUND_CONSTANTS = [
15
- 1116352408,
16
- 1899447441,
17
- 3049323471,
18
- 3921009573,
19
- 961987163,
20
- 1508970993,
21
- 2453635748,
22
- 2870763221,
23
- 3624381080,
24
- 310598401,
25
- 607225278,
26
- 1426881987,
27
- 1925078388,
28
- 2162078206,
29
- 2614888103,
30
- 3248222580,
31
- 3835390401,
32
- 4022224774,
33
- 264347078,
34
- 604807628,
35
- 770255983,
36
- 1249150122,
37
- 1555081692,
38
- 1996064986,
39
- 2554220882,
40
- 2821834349,
41
- 2952996808,
42
- 3210313671,
43
- 3336571891,
44
- 3584528711,
45
- 113926993,
46
- 338241895,
47
- 666307205,
48
- 773529912,
49
- 1294757372,
50
- 1396182291,
51
- 1695183700,
52
- 1986661051,
53
- 2177026350,
54
- 2456956037,
55
- 2730485921,
56
- 2820302411,
57
- 3259730800,
58
- 3345764771,
59
- 3516065817,
60
- 3600352804,
61
- 4094571909,
62
- 275423344,
63
- 430227734,
64
- 506948616,
65
- 659060556,
66
- 883997877,
67
- 958139571,
68
- 1322822218,
69
- 1537002063,
70
- 1747873779,
71
- 1955562222,
72
- 2024104815,
73
- 2227730452,
74
- 2361852424,
75
- 2428436474,
76
- 2756734187,
77
- 3204031479,
78
- 3329325298
79
- ];
80
- function rotateRight(value, bits) {
81
- return value >>> bits | value << 32 - bits;
82
- }
83
- function normalizeDigestContent(value) {
84
- return value.replace(/\r\n?/gu, "\n").replace(/^\uFEFF/u, "").trimEnd();
85
- }
86
- function toSha256Bytes(value) {
87
- return typeof value === "string" ? new TextEncoder().encode(value) : value;
88
- }
89
- /** Validate the bounded HTTP(S) URL or root-relative URI reference used by provenance. */
90
- function isDocsRetrievalCanonicalUrl(value) {
91
- const hasUnsafeCharacter = value.includes("\\") || Array.from(value).some((character) => {
92
- const codePoint = character.codePointAt(0) ?? 0;
93
- return codePoint <= 31 || codePoint === 127;
94
- });
95
- if (!value || value !== value.trim() || value.length > 4096 || hasUnsafeCharacter) return false;
96
- if (/^\/(?!\/)/u.test(value)) try {
97
- new URL(value, "https://docs.local");
98
- return true;
99
- } catch {
100
- return false;
101
- }
102
- try {
103
- const url = new URL(value);
104
- return (url.protocol === "http:" || url.protocol === "https:") && !url.username && !url.password;
105
- } catch {
106
- return false;
107
- }
108
- }
109
- /** Hash exact bytes with portable SHA-256 in Node, edge, and browser runtimes. */
110
- function sha256DocsContent(value) {
111
- const input = toSha256Bytes(value);
112
- const paddedLength = Math.ceil((input.length + 9) / 64) * 64;
113
- const padded = new Uint8Array(paddedLength);
114
- padded.set(input);
115
- padded[input.length] = 128;
116
- const bitLength = input.length * 8;
117
- const dataView = new DataView(padded.buffer);
118
- dataView.setUint32(paddedLength - 8, Math.floor(bitLength / 4294967296), false);
119
- dataView.setUint32(paddedLength - 4, bitLength >>> 0, false);
120
- const state = Uint32Array.from(SHA256_INITIAL_STATE);
121
- const words = new Uint32Array(64);
122
- for (let offset = 0; offset < padded.length; offset += 64) {
123
- for (let index = 0; index < 16; index += 1) words[index] = dataView.getUint32(offset + index * 4, false);
124
- for (let index = 16; index < 64; index += 1) {
125
- const previous15 = words[index - 15];
126
- const previous2 = words[index - 2];
127
- const sigma0 = rotateRight(previous15, 7) ^ rotateRight(previous15, 18) ^ previous15 >>> 3;
128
- const sigma1 = rotateRight(previous2, 17) ^ rotateRight(previous2, 19) ^ previous2 >>> 10;
129
- words[index] = words[index - 16] + sigma0 + words[index - 7] + sigma1 >>> 0;
130
- }
131
- let a = state[0];
132
- let b = state[1];
133
- let c = state[2];
134
- let d = state[3];
135
- let e = state[4];
136
- let f = state[5];
137
- let g = state[6];
138
- let h = state[7];
139
- for (let index = 0; index < 64; index += 1) {
140
- const sum1 = rotateRight(e, 6) ^ rotateRight(e, 11) ^ rotateRight(e, 25);
141
- const choice = e & f ^ ~e & g;
142
- const temporary1 = h + sum1 + choice + SHA256_ROUND_CONSTANTS[index] + words[index] >>> 0;
143
- const temporary2 = (rotateRight(a, 2) ^ rotateRight(a, 13) ^ rotateRight(a, 22)) + (a & b ^ a & c ^ b & c) >>> 0;
144
- h = g;
145
- g = f;
146
- f = e;
147
- e = d + temporary1 >>> 0;
148
- d = c;
149
- c = b;
150
- b = a;
151
- a = temporary1 + temporary2 >>> 0;
152
- }
153
- state[0] = state[0] + a >>> 0;
154
- state[1] = state[1] + b >>> 0;
155
- state[2] = state[2] + c >>> 0;
156
- state[3] = state[3] + d >>> 0;
157
- state[4] = state[4] + e >>> 0;
158
- state[5] = state[5] + f >>> 0;
159
- state[6] = state[6] + g >>> 0;
160
- state[7] = state[7] + h >>> 0;
161
- }
162
- return Array.from(state, (word) => word.toString(16).padStart(8, "0")).join("");
163
- }
164
- /** Hash exact message-content bytes with portable SHA-256. */
165
- function digestDocsContent(value) {
166
- return `sha256:${sha256DocsContent(value)}`;
167
- }
168
- /**
169
- * Hash the normalized retrieval projection used by search provenance.
170
- *
171
- * The projection removes one leading BOM, normalizes line endings to LF, and trims
172
- * trailing whitespace. This deliberately differs from HTTP digests over exact bytes.
173
- */
174
- function digestDocsRetrievalContent(value) {
175
- return digestDocsContent(normalizeDigestContent(value));
176
- }
177
-
178
- //#endregion
179
4
  //#region src/http-cache.ts
180
5
  const BASE64_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
181
6
  const MAX_CACHED_TEXT_REPRESENTATIONS = 64;
@@ -1115,4 +940,4 @@ async function createDocsStandardsResponse({ request, apiCatalog, apiCatalogEnab
1115
940
  }
1116
941
 
1117
942
  //#endregion
1118
- export { buildDocsLegacySkillsIndex as A, createDocsCacheableResponse as B, DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE as C, buildDocsA2AAgentCard as D, appendDocsDiscoveryLinkHeader as E, isDocsStandardsDiscoveryRequest as F, digestDocsContent as G, requestHasFreshDocsDate as H, resolveDocsDiscoveryApiRoute as I, sha256DocsContent as J, digestDocsRetrievalContent as K, resolveDocsPublishedAgentSkill as L, createDocsStandardsResponse as M, getDocsAgentManifestLinkHeader as N, buildDocsAgentSkillsIndex as O, getDocsDiscoveryLinkHeader as P, resolveDocsStandardsDiscoveryRequest as R, DOCS_AGENT_MANIFEST_FORMAT as S, DOCS_AGENT_MANIFEST_VERSION as T, requestMatchesDocsEtag as U, formatDocsContentDigest as V, resolveDocsHttpDate as W, DEFAULT_API_CATALOG_FORMAT as _, DEFAULT_A2A_AGENT_CARD_ROUTE as a, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE as b, DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN as c, DEFAULT_AGENT_SKILLS_ROUTE_PATTERN as d, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX as f, DEFAULT_AGENT_SKILL_RESOURCE_FORMAT as g, DEFAULT_AGENT_SKILL_FORMAT as h, DEFAULT_A2A_AGENT_CARD_FORMAT as i, buildDocsPublishedAgentSkill as j, buildDocsApiCatalog as k, DEFAULT_AGENT_SKILLS_INDEX_FORMAT as l, DEFAULT_AGENT_SKILL_FILE_FORMAT as m, API_CATALOG_MEDIA_TYPE as n, DEFAULT_A2A_PROTOCOL_BINDING as o, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT as p, isDocsRetrievalCanonicalUrl as q, API_CATALOG_PROFILE_URI as r, DEFAULT_A2A_PROTOCOL_VERSION as s, AGENT_SKILLS_DISCOVERY_SCHEMA_URI as t, DEFAULT_AGENT_SKILLS_INDEX_ROUTE as u, DEFAULT_API_CATALOG_ROUTE as v, DOCS_AGENT_MANIFEST_SCHEMA_URI as w, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX as x, DEFAULT_LEGACY_SKILLS_INDEX_FORMAT as y, sha256DocsDiscoveryContent as z };
943
+ export { buildDocsLegacySkillsIndex as A, createDocsCacheableResponse as B, DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE as C, buildDocsA2AAgentCard as D, appendDocsDiscoveryLinkHeader as E, isDocsStandardsDiscoveryRequest as F, requestHasFreshDocsDate as H, resolveDocsDiscoveryApiRoute as I, resolveDocsPublishedAgentSkill as L, createDocsStandardsResponse as M, getDocsAgentManifestLinkHeader as N, buildDocsAgentSkillsIndex as O, getDocsDiscoveryLinkHeader as P, resolveDocsStandardsDiscoveryRequest as R, DOCS_AGENT_MANIFEST_FORMAT as S, DOCS_AGENT_MANIFEST_VERSION as T, requestMatchesDocsEtag as U, formatDocsContentDigest as V, resolveDocsHttpDate as W, DEFAULT_API_CATALOG_FORMAT as _, DEFAULT_A2A_AGENT_CARD_ROUTE as a, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE as b, DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN as c, DEFAULT_AGENT_SKILLS_ROUTE_PATTERN as d, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX as f, DEFAULT_AGENT_SKILL_RESOURCE_FORMAT as g, DEFAULT_AGENT_SKILL_FORMAT as h, DEFAULT_A2A_AGENT_CARD_FORMAT as i, buildDocsPublishedAgentSkill as j, buildDocsApiCatalog as k, DEFAULT_AGENT_SKILLS_INDEX_FORMAT as l, DEFAULT_AGENT_SKILL_FILE_FORMAT as m, API_CATALOG_MEDIA_TYPE as n, DEFAULT_A2A_PROTOCOL_BINDING as o, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT as p, API_CATALOG_PROFILE_URI as r, DEFAULT_A2A_PROTOCOL_VERSION as s, AGENT_SKILLS_DISCOVERY_SCHEMA_URI as t, DEFAULT_AGENT_SKILLS_INDEX_ROUTE as u, DEFAULT_API_CATALOG_ROUTE as v, DOCS_AGENT_MANIFEST_SCHEMA_URI as w, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX as x, DEFAULT_LEGACY_SKILLS_INDEX_FORMAT as y, sha256DocsDiscoveryContent as z };
@@ -1,4 +1,4 @@
1
- import { A as DocsAgentA2ASecurityScheme, M as DocsAgentA2ASkill, O as DocsAgentA2AProtocolBinding, h as DocsAgentA2AConfig, k as DocsAgentA2ASecurityRequirement, m as DocsAgentA2ACapabilities } from "./types-BthCiAD9.mjs";
1
+ import { A as DocsAgentA2AProtocolBinding, M as DocsAgentA2ASecurityScheme, P as DocsAgentA2ASkill, _ as DocsAgentA2AConfig, g as DocsAgentA2ACapabilities, j as DocsAgentA2ASecurityRequirement } from "./types-QhYMnKvb.mjs";
2
2
 
3
3
  //#region src/standards-discovery.d.ts
4
4
  declare const DEFAULT_API_CATALOG_ROUTE = "/.well-known/api-catalog";
@@ -276,12 +276,30 @@ interface PageAgentFailureMode {
276
276
  /** Recovery guidance for the symptom. */
277
277
  resolution?: string;
278
278
  }
279
+ type DocsAccessClaimValue = string | number | boolean | readonly string[];
280
+ /** Declarative, deny-by-default authorization requirements for agent-facing page surfaces. */
281
+ interface DocsPageAccessPolicy {
282
+ /** Require an authenticated principal even when no scopes or claims are listed. */
283
+ visibility?: "public" | "authenticated";
284
+ /** Every listed scope must be present on the principal. */
285
+ scopes?: readonly string[];
286
+ /** Every listed claim must match; arrays match when at least one value overlaps. */
287
+ claims?: Readonly<Record<string, DocsAccessClaimValue>>;
288
+ }
289
+ /** Identity used when evaluating page access outside the MCP transport. */
290
+ interface DocsAccessPrincipal {
291
+ id: string;
292
+ scopes?: readonly string[];
293
+ claims?: Readonly<Record<string, unknown>>;
294
+ }
279
295
  interface PageAgentFrontmatter {
280
296
  /**
281
297
  * Approximate output token target for machine-readable compaction on this page.
282
298
  * Used by `docs agent compact` as a per-page override.
283
299
  */
284
300
  tokenBudget?: number;
301
+ /** Authorization requirements shared by Markdown, search, llms.txt, sync, export, and MCP. */
302
+ access?: DocsPageAccessPolicy;
285
303
  /** Concrete task the page helps an agent complete. */
286
304
  task?: string;
287
305
  /** Observable end state the agent should reach. */
@@ -1312,7 +1330,7 @@ interface DocsMcpPromptsConfig {
1312
1330
  goldenTasks?: readonly string[];
1313
1331
  }
1314
1332
  /** Authenticated identity returned by an MCP authentication callback. */
1315
- interface DocsMcpAuthPrincipal {
1333
+ interface DocsMcpAuthPrincipal extends DocsAccessPrincipal {
1316
1334
  /** Stable identifier for the authenticated user, service, or agent. */
1317
1335
  id: string;
1318
1336
  /** Optional authorization scopes that source adapters can inspect. */
@@ -2728,6 +2746,7 @@ interface DocsOpenApiMcpCredentialContext {
2728
2746
  security: readonly Record<string, readonly string[]>[];
2729
2747
  }
2730
2748
  type DocsOpenApiMcpHeaders = Readonly<Record<string, string>> | ((context: DocsOpenApiMcpCredentialContext) => Readonly<Record<string, string>> | Promise<Readonly<Record<string, string>>>);
2749
+ type DocsOpenApiMcpHostResolver = (hostname: string) => readonly string[] | Promise<readonly string[]>;
2731
2750
  /** Explicit, deny-by-default projection of OpenAPI operations into MCP tools. */
2732
2751
  interface DocsOpenApiMcpConfig {
2733
2752
  /** Enable operation projection. No tools are exposed until an operation is explicitly allowed. */
@@ -2742,6 +2761,20 @@ interface DocsOpenApiMcpConfig {
2742
2761
  headers?: DocsOpenApiMcpHeaders;
2743
2762
  /** Per-operation request timeout. @default 10000 */
2744
2763
  timeoutMs?: number;
2764
+ /** Permit plain HTTP destinations. Disabled by default. */
2765
+ allowInsecureHttp?: boolean;
2766
+ /** Permit loopback, private, link-local, and reserved network destinations. Disabled by default. */
2767
+ allowPrivateNetwork?: boolean;
2768
+ /** Server-owned DNS resolver used before every request and redirect. */
2769
+ resolveHost?: DocsOpenApiMcpHostResolver;
2770
+ /** Number of validated redirects to follow. @default 0 */
2771
+ maxRedirects?: number;
2772
+ /** Maximum downstream response bytes buffered into an MCP result. @default 1000000 */
2773
+ maxResponseBytes?: number;
2774
+ /** Per-principal operation calls allowed in a rolling minute. @default 60 */
2775
+ requestsPerMinute?: number;
2776
+ /** Concurrent downstream operation calls allowed per principal. @default 4 */
2777
+ maxConcurrentRequests?: number;
2745
2778
  }
2746
2779
  interface ApiReferenceConfig {
2747
2780
  /**
@@ -4100,4 +4133,4 @@ interface DocsConfig {
4100
4133
  og?: OGConfig;
4101
4134
  }
4102
4135
  //#endregion
4103
- export { DocsAgentGoldenQueryVariant as $, DocsSearchFilterInput as $n, ReadingTimeConfig as $r, DocsMcpAuthenticateContext as $t, DocsAgentA2ASecurityScheme as A, DocsReviewRulesConfig as An, LlmsTxtSectionConfig as Ar, DocsCodeBlocksConfig as At, DocsAgentEvaluationAnswerRunner as B, DocsSearchAmbiguityDecisionStatus as Bn, PageActionConnectMcpConfig as Br, DocsContentChangeSnapshotContext as Bt, DocsAgentA2AOAuthDeviceCodeFlow as C, DocsPaginatedSearchResponse as Cn, FeedbackConfig as Cr, DocsAskAIFeedbackValue as Ct, DocsAgentA2AOpenIdConnectSecurityScheme as D, DocsReviewCiConfig as Dn, LlmsTxtConfig as Dr, DocsCloudFeatureConfig as Dt, DocsAgentA2AOAuthPasswordFlow as E, DocsRetrievalSourceScope as En, LastUpdatedConfig as Er, DocsCloudConfig as Et, DocsAgentContentChangesConfig as F, DocsSearchAdapter as Fn, OpenDocsProviderConfig as Fr, DocsCodeBlocksValidateConfig as Ft, DocsAgentFeedbackContext as G, DocsSearchEmbeddingsConfig as Gn, PageAgentCommand as Gr, DocsContentSnapshot as Gt, DocsAgentEvaluationSurface as H, DocsSearchChunkingConfig as Hn, PageActionMcpProvider as Hr, DocsContentChangeSnapshotSaver as Ht, DocsAgentEvaluationAnswerInput as I, DocsSearchAdapterContext as In, OpenDocsProviderId as Ir, DocsCodeBlocksValidationMode as It, DocsAgentGoldenAuthenticatedContentExpectation as J, DocsSearchFacetValue as Jn, PageAgentVerification as Jr, DocsFeedbackValue as Jt, DocsAgentFeedbackData as K, DocsSearchExplanation as Kn, PageAgentFailureMode as Kr, DocsContentSnapshotDocument as Kt, DocsAgentEvaluationAnswerProvider as L, DocsSearchAdapterFactory as Ln, OpenDocsTarget as Lr, DocsCodeBlocksValidationPolicy as Lt, DocsAgentA2ASkill as M, DocsReviewSeverity as Mn, OGConfig as Mr, DocsCodeBlocksPlannerProvider as Mt, DocsAgentCompactConfig as N, DocsRobotsConfig as Nn, OpenDocsConfig as Nr, DocsCodeBlocksRunnerConfig as Nt, DocsAgentA2AProtocolBinding as O, DocsReviewCiMode as On, LlmsTxtMaxCharsConfig as Or, DocsCloudPreviewConfig as Ot, DocsAgentConfig as P, DocsRobotsRule as Pn, OpenDocsProvider as Pr, DocsCodeBlocksRunnerProvider as Pt, DocsAgentGoldenPromptInjectionExpectation as Q, DocsSearchFilterField as Qn, PageTwitter as Qr, DocsMcpAuthenticate as Qt, DocsAgentEvaluationAnswerRequest as R, DocsSearchAdapterPage as Rn, OpenGraphImage as Rr, DocsConfig as Rt, DocsAgentA2AOAuthClientCredentialsFlow as S, DocsOpenApiMcpHeaders as Sn, DocsTheme as Sr, DocsAskAIFeedbackMessage as St, DocsAgentA2AOAuthImplicitFlow as T, DocsRetrievalSourceProvenance as Tn, GithubConfig as Tr, DocsCloudApiKeyConfig as Tt, DocsAgentEvaluationTaskInput as U, DocsSearchConfig as Un, PageActionsConfig as Ur, DocsContentChangedDocument as Ut, DocsAgentEvaluationSourceReference as V, DocsSearchAmbiguityResolution as Vn, PageActionInstallSkillsConfig as Vr, DocsContentChangeSnapshotLoader as Vt, DocsAgentEvaluationsConfig as W, DocsSearchDocument as Wn, PageAgentAppliesTo as Wr, DocsContentChangesResponse as Wt, DocsAgentGoldenExpectedExample as X, DocsSearchFilterDecision as Xn, PageOpenGraph as Xr, DocsMcpAllowedOrigins as Xt, DocsAgentGoldenExampleVerification as Y, DocsSearchFacetsResponse as Yn, PageFrontmatter as Yr, DocsI18nConfig as Yt, DocsAgentGoldenFreshnessExpectation as Z, DocsSearchFilterDecisionOutcome as Zn, PageSidebarFrontmatter as Zr, DocsMcpAuthPrincipal as Zt, DocsAgentA2AHttpAuthSecurityScheme as _, DocsOkfTrustMetadata as _n, DocsTelemetryEvent as _r, DocsAnalyticsSource as _t, ApiReferenceRenderer as a, SidebarFolderNode as ai, DocsMcpProtectedResourceConfig as an, DocsSearchRankingReasonCode as ar, DocsAgentSkillsCompatibilityPolicy as at, DocsAgentA2AOAuth2SecurityScheme as b, DocsOpenApiMcpConfig as bn, DocsTelemetryFeatures as br, DocsAskAIFeedbackConfig as bt, ChangelogFrontmatter as c, SidebarTree as ci, DocsMetadata as cn, DocsSearchResponse as cr, DocsAgentSkillsProgressiveDisclosureConfig as ct, CopyMarkdownFormat as d, TypesenseDocsSearchConfig as di, DocsObservabilityEvent as dn, DocsSearchSourcePage as dr, DocsAgentTraceStatus as dt, ReadingTimeFormat as ei, DocsMcpAuthenticateResult as en, DocsSearchFilters as er, DocsAgentGoldenQueryVariantKind as et, CustomDocsSearchConfig as f, TypographyConfig as fi, DocsObservabilityEventInput as fn, DocsSearchWarning as fr, DocsAnalyticsConfig as ft, DocsAgentA2AExtension as g, DocsOkfStatus as gn, DocsTelemetryConfig as gr, DocsAnalyticsInput as gt, DocsAgentA2AConfig as h, DocsOkfSource as hn, DocsTelemetryAgentSurface as hr, DocsAnalyticsEventType as ht, ApiReferenceConfig as i, SidebarFolderIndexBehavior as ii, DocsMcpPromptsConfig as in, DocsSearchRankingReason as ir, DocsAgentGoldenTaskFilters as it, DocsAgentA2ASecurityScopeList as j, DocsReviewScoreConfig as jn, McpDocsSearchConfig as jr, DocsCodeBlocksPlannerConfig as jt, DocsAgentA2ASecurityRequirement as k, DocsReviewConfig as kn, LlmsTxtMaxCharsMode as kr, DocsCloudPublishConfig as kt, CodeBlockCopyData as l, SimpleDocsSearchConfig as li, DocsNav as ln, DocsSearchResult as lr, DocsAgentTraceEventInput as lt, DocsAgentA2ACapabilities as m, DocsOkfConfig as mn, DocsSitemapConfig as mr, DocsAnalyticsEventInput as mt, AgentFeedbackConfig as n, SidebarComponentProps as ni, DocsMcpCorsConfig as nn, DocsSearchMatchedTerm as nr, DocsAgentGoldenTask as nt, BreadcrumbConfig as o, SidebarNode as oi, DocsMcpSecurityConfig as on, DocsSearchRankingStrategy as or, DocsAgentSkillsConfig as ot, DocsAgentA2AApiKeySecurityScheme as p, UIConfig as pi, DocsOkfActorTimestamp as pn, DocsSearchWarningCode as pr, DocsAnalyticsEvent as pt, DocsAgentGoldenAnswerExpectation as q, DocsSearchFacet as qn, PageAgentFrontmatter as qr, DocsFeedbackData as qt, AlgoliaDocsSearchConfig as r, SidebarConfig as ri, DocsMcpOriginContext as rn, DocsSearchQuery as rr, DocsAgentGoldenTaskExpectation as rt, ChangelogConfig as s, SidebarPageNode as si, DocsMcpToolsConfig as sn, DocsSearchRequest as sr, DocsAgentSkillsInput as st, AIConfig as t, ResolvedDocsRelatedLink as ti, DocsMcpConfig as tn, DocsSearchMatchField as tr, DocsAgentGoldenSafetyExpectation as tt, CopyMarkdownConfig as u, ThemeToggleConfig as ui, DocsObservabilityConfig as un, DocsSearchResultType as ur, DocsAgentTraceEventType as ut, DocsAgentA2AInterfaceConfig as v, DocsOkfTrustMetadataInput as vn, DocsTelemetryEventInput as vr, DocsAskAIActionData as vt, DocsAgentA2AOAuthFlows as w, DocsRelatedItem as wn, FontStyle as wr, DocsAskAIMcpConfig as wt, DocsAgentA2AOAuthAuthorizationCodeFlow as x, DocsOpenApiMcpCredentialContext as xn, DocsTelemetryFramework as xr, DocsAskAIFeedbackData as xt, DocsAgentA2AMutualTlsSecurityScheme as y, DocsOkfTrustTier as yn, DocsTelemetryEventType as yr, DocsAskAIActionType as yt, DocsAgentEvaluationAnswerResult as z, DocsSearchAmbiguityDecision as zn, OrderingItem as zr, DocsContentChangeDocument as zt };
4136
+ export { DocsAgentGoldenFreshnessExpectation as $, DocsSearchFilterDecision as $n, PageOpenGraph as $r, DocsMcpAuthPrincipal as $t, DocsAgentA2AProtocolBinding as A, DocsReviewCiConfig as An, LlmsTxtConfig as Ar, DocsCloudPreviewConfig as At, DocsAgentEvaluationAnswerRequest as B, DocsSearchAdapterFactory as Bn, OpenDocsTarget as Br, DocsConfig as Bt, DocsAgentA2AOAuthAuthorizationCodeFlow as C, DocsOpenApiMcpCredentialContext as Cn, DocsTelemetryFeatures as Cr, DocsAskAIFeedbackData as Ct, DocsAgentA2AOAuthImplicitFlow as D, DocsRelatedItem as Dn, FontStyle as Dr, DocsCloudApiKeyConfig as Dt, DocsAgentA2AOAuthFlows as E, DocsPaginatedSearchResponse as En, FeedbackConfig as Er, DocsAskAIMcpConfig as Et, DocsAgentCompactConfig as F, DocsReviewSeverity as Fn, OGConfig as Fr, DocsCodeBlocksRunnerConfig as Ft, DocsAgentEvaluationTaskInput as G, DocsSearchChunkingConfig as Gn, PageActionMcpProvider as Gr, DocsContentChangedDocument as Gt, DocsAgentEvaluationAnswerRunner as H, DocsSearchAmbiguityDecision as Hn, OrderingItem as Hr, DocsContentChangeSnapshotContext as Ht, DocsAgentConfig as I, DocsRobotsConfig as In, OpenDocsConfig as Ir, DocsCodeBlocksRunnerProvider as It, DocsAgentFeedbackData as J, DocsSearchEmbeddingsConfig as Jn, PageAgentCommand as Jr, DocsContentSnapshotDocument as Jt, DocsAgentEvaluationsConfig as K, DocsSearchConfig as Kn, PageActionsConfig as Kr, DocsContentChangesResponse as Kt, DocsAgentContentChangesConfig as L, DocsRobotsRule as Ln, OpenDocsProvider as Lr, DocsCodeBlocksValidateConfig as Lt, DocsAgentA2ASecurityScheme as M, DocsReviewConfig as Mn, LlmsTxtMaxCharsMode as Mr, DocsCodeBlocksConfig as Mt, DocsAgentA2ASecurityScopeList as N, DocsReviewRulesConfig as Nn, LlmsTxtSectionConfig as Nr, DocsCodeBlocksPlannerConfig as Nt, DocsAgentA2AOAuthPasswordFlow as O, DocsRetrievalSourceProvenance as On, GithubConfig as Or, DocsCloudConfig as Ot, DocsAgentA2ASkill as P, DocsReviewScoreConfig as Pn, McpDocsSearchConfig as Pr, DocsCodeBlocksPlannerProvider as Pt, DocsAgentGoldenExpectedExample as Q, DocsSearchFacetsResponse as Qn, PageFrontmatter as Qr, DocsMcpAllowedOrigins as Qt, DocsAgentEvaluationAnswerInput as R, DocsSearchAdapter as Rn, OpenDocsProviderConfig as Rr, DocsCodeBlocksValidationMode as Rt, DocsAgentA2AOAuth2SecurityScheme as S, DocsOpenApiMcpConfig as Sn, DocsTelemetryEventType as Sr, DocsAskAIFeedbackConfig as St, DocsAgentA2AOAuthDeviceCodeFlow as T, DocsPageAccessPolicy as Tn, DocsTheme as Tr, DocsAskAIFeedbackValue as Tt, DocsAgentEvaluationSourceReference as U, DocsSearchAmbiguityDecisionStatus as Un, PageActionConnectMcpConfig as Ur, DocsContentChangeSnapshotLoader as Ut, DocsAgentEvaluationAnswerResult as V, DocsSearchAdapterPage as Vn, OpenGraphImage as Vr, DocsContentChangeDocument as Vt, DocsAgentEvaluationSurface as W, DocsSearchAmbiguityResolution as Wn, PageActionInstallSkillsConfig as Wr, DocsContentChangeSnapshotSaver as Wt, DocsAgentGoldenAuthenticatedContentExpectation as X, DocsSearchFacet as Xn, PageAgentFrontmatter as Xr, DocsFeedbackValue as Xt, DocsAgentGoldenAnswerExpectation as Y, DocsSearchExplanation as Yn, PageAgentFailureMode as Yr, DocsFeedbackData as Yt, DocsAgentGoldenExampleVerification as Z, DocsSearchFacetValue as Zn, PageAgentVerification as Zr, DocsI18nConfig as Zt, DocsAgentA2AConfig as _, DocsOkfSource as _n, DocsSitemapConfig as _r, DocsAnalyticsEventType as _t, ApiReferenceRenderer as a, SidebarComponentProps as ai, DocsMcpOriginContext as an, DocsSearchMatchedTerm as ar, DocsAgentGoldenTaskExpectation as at, DocsAgentA2AInterfaceConfig as b, DocsOkfTrustMetadataInput as bn, DocsTelemetryEvent as br, DocsAskAIActionData as bt, ChangelogFrontmatter as c, SidebarFolderNode as ci, DocsMcpSecurityConfig as cn, DocsSearchRankingReasonCode as cr, DocsAgentSkillsConfig as ct, CopyMarkdownFormat as d, SidebarTree as di, DocsNav as dn, DocsSearchResponse as dr, DocsAgentTraceEventInput as dt, PageSidebarFrontmatter as ei, DocsMcpAuthenticate as en, DocsSearchFilterDecisionOutcome as er, DocsAgentGoldenPromptInjectionExpectation as et, CustomDocsSearchConfig as f, SimpleDocsSearchConfig as fi, DocsObservabilityConfig as fn, DocsSearchResult as fr, DocsAgentTraceEventType as ft, DocsAgentA2ACapabilities as g, UIConfig as gi, DocsOkfConfig as gn, DocsSearchWarningCode as gr, DocsAnalyticsEventInput as gt, DocsAgentA2AApiKeySecurityScheme as h, TypographyConfig as hi, DocsOkfActorTimestamp as hn, DocsSearchWarning as hr, DocsAnalyticsEvent as ht, ApiReferenceConfig as i, ResolvedDocsRelatedLink as ii, DocsMcpCorsConfig as in, DocsSearchMatchField as ir, DocsAgentGoldenTask as it, DocsAgentA2ASecurityRequirement as j, DocsReviewCiMode as jn, LlmsTxtMaxCharsConfig as jr, DocsCloudPublishConfig as jt, DocsAgentA2AOpenIdConnectSecurityScheme as k, DocsRetrievalSourceScope as kn, LastUpdatedConfig as kr, DocsCloudFeatureConfig as kt, CodeBlockCopyData as l, SidebarNode as li, DocsMcpToolsConfig as ln, DocsSearchRankingStrategy as lr, DocsAgentSkillsInput as lt, DocsAccessPrincipal as m, TypesenseDocsSearchConfig as mi, DocsObservabilityEventInput as mn, DocsSearchSourcePage as mr, DocsAnalyticsConfig as mt, AgentFeedbackConfig as n, ReadingTimeConfig as ni, DocsMcpAuthenticateResult as nn, DocsSearchFilterInput as nr, DocsAgentGoldenQueryVariantKind as nt, BreadcrumbConfig as o, SidebarConfig as oi, DocsMcpPromptsConfig as on, DocsSearchQuery as or, DocsAgentGoldenTaskFilters as ot, DocsAccessClaimValue as p, ThemeToggleConfig as pi, DocsObservabilityEvent as pn, DocsSearchResultType as pr, DocsAgentTraceStatus as pt, DocsAgentFeedbackContext as q, DocsSearchDocument as qn, PageAgentAppliesTo as qr, DocsContentSnapshot as qt, AlgoliaDocsSearchConfig as r, ReadingTimeFormat as ri, DocsMcpConfig as rn, DocsSearchFilters as rr, DocsAgentGoldenSafetyExpectation as rt, ChangelogConfig as s, SidebarFolderIndexBehavior as si, DocsMcpProtectedResourceConfig as sn, DocsSearchRankingReason as sr, DocsAgentSkillsCompatibilityPolicy as st, AIConfig as t, PageTwitter as ti, DocsMcpAuthenticateContext as tn, DocsSearchFilterField as tr, DocsAgentGoldenQueryVariant as tt, CopyMarkdownConfig as u, SidebarPageNode as ui, DocsMetadata as un, DocsSearchRequest as ur, DocsAgentSkillsProgressiveDisclosureConfig as ut, DocsAgentA2AExtension as v, DocsOkfStatus as vn, DocsTelemetryAgentSurface as vr, DocsAnalyticsInput as vt, DocsAgentA2AOAuthClientCredentialsFlow as w, DocsOpenApiMcpHeaders as wn, DocsTelemetryFramework as wr, DocsAskAIFeedbackMessage as wt, DocsAgentA2AMutualTlsSecurityScheme as x, DocsOkfTrustTier as xn, DocsTelemetryEventInput as xr, DocsAskAIActionType as xt, DocsAgentA2AHttpAuthSecurityScheme as y, DocsOkfTrustMetadata as yn, DocsTelemetryConfig as yr, DocsAnalyticsSource as yt, DocsAgentEvaluationAnswerProvider as z, DocsSearchAdapterContext as zn, OpenDocsProviderId as zr, DocsCodeBlocksValidationPolicy as zt };
@@ -1,5 +1,5 @@
1
- import { c as fileExists, o as exec } from "./utils-DcCUwxqS.mjs";
2
- import { a as getPackagesForFramework, c as resolveDocsPackageManager, i as frameworkFromPreset, l as validateUpgradeVersion, n as PRESETS, o as presetFromFramework, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework, t as PACKAGES_BY_FRAMEWORK } from "./package-version-P4TT_9IO.mjs";
1
+ import { c as fileExists, o as exec } from "./utils-Cc1SrVza.mjs";
2
+ import { a as getPackagesForFramework, c as resolveDocsPackageManager, i as frameworkFromPreset, l as validateUpgradeVersion, n as PRESETS, o as presetFromFramework, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework, t as PACKAGES_BY_FRAMEWORK } from "./package-version-Ci99L0yo.mjs";
3
3
  import path from "node:path";
4
4
  import pc from "picocolors";
5
5
  import * as p from "@clack/prompts";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@farming-labs/docs",
3
- "version": "0.2.104",
3
+ "version": "0.2.106",
4
4
  "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
5
5
  "keywords": [
6
6
  "docs",