@farming-labs/docs 0.2.80 → 0.2.81
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.
- package/dist/{agent-aWl_O6xn.mjs → agent-Biyd8A98.mjs} +2 -2
- package/dist/{agent-DGALg9hQ.d.mts → agent-DEjfHgU-.d.mts} +88 -3
- package/dist/{agent-Cj50nyeV.mjs → agent-Dze2Cy5B.mjs} +1 -1
- package/dist/{agent-evals-DvQQtN62.mjs → agent-evals-CGOA7jJ0.mjs} +1 -1
- package/dist/{agent-export-BISSb83U.mjs → agent-export-BYWO6fES.mjs} +5 -5
- package/dist/agent-skills-bundle.d.mts +1 -1
- package/dist/{agent-skills-server-Daq-FOay.d.mts → agent-skills-server-CclBBz1M.d.mts} +2 -2
- package/dist/agent-skills-vite.d.mts +3 -3
- package/dist/{agents-DLNUgcgU.mjs → agents-CDs7ZFdb.mjs} +4 -4
- package/dist/cli/index.mjs +14 -14
- package/dist/client/react.d.mts +1 -1
- package/dist/{cloud-ask-ai-o41WfOTk.d.mts → cloud-ask-ai-AUhHTMe6.d.mts} +1 -1
- package/dist/{agent-provenance-C_jgqNTW.mjs → content-change-hydration-DpQ0KdAD.mjs} +218 -2
- package/dist/docs-cloud-server.d.mts +2 -2
- package/dist/{doctor-BxP-UHaE.mjs → doctor-CALb10jP.mjs} +8 -8
- package/dist/{golden-evaluations-Bk8MBi3Z.mjs → golden-evaluations-I9yRlYJy.mjs} +1 -1
- package/dist/index.d.mts +5 -5
- package/dist/index.mjs +5 -5
- package/dist/{mcp-BU63wzaM.mjs → mcp-DUxk8lGS.mjs} +4 -4
- package/dist/mcp.d.mts +6 -5
- package/dist/mcp.mjs +135 -13
- package/dist/{prompt-references-CMMoF6AY.mjs → prompt-references-embiJdYt.mjs} +2 -2
- package/dist/{retrieval-digest-DIbiu0TW.d.mts → retrieval-digest-D0pnOmQ8.d.mts} +2 -2
- package/dist/{review-D14mUw5D.mjs → review-CaDaE4Pq.mjs} +4 -4
- package/dist/{robots-DmczzidR.mjs → robots-BIySk2gE.mjs} +2 -2
- package/dist/{robots-BukukxNm.mjs → robots-D96X6eVX.mjs} +1 -1
- package/dist/{search-DP96dV3e.mjs → search-D7s_gagx.mjs} +4 -4
- package/dist/server.d.mts +6 -6
- package/dist/server.mjs +5 -5
- package/dist/{sitemap-DuosRvmn.mjs → sitemap-BMRfmpEp.mjs} +4 -4
- package/dist/{sitemap-server-DzlV1NOB.mjs → sitemap-server-BefXEox6.mjs} +1 -1
- package/dist/{standards-discovery-C2cUIQzW.d.mts → standards-discovery-BWz35hS6.d.mts} +1 -1
- package/dist/{types-o-ULHPK6.d.mts → types-CoohpxFz.d.mts} +5 -0
- package/package.json +1 -1
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import { B as findDocsMarkdownPage, at as renderDocsMarkdownDocument } from "./agent-
|
|
1
|
+
import { B as findDocsMarkdownPage, at as renderDocsMarkdownDocument } from "./agent-Dze2Cy5B.mjs";
|
|
2
2
|
import { v as normalizePageAgentFrontmatter, x as stripGeneratedPageAgentContractMarkdown } from "./markdown-sections-7OoA7ylx.mjs";
|
|
3
|
-
import {
|
|
3
|
+
import { c as hashGeneratedAgentContent, d as serializeGeneratedAgentDocument, s as GENERATED_AGENT_PROVENANCE_VERSION, u as parseGeneratedAgentDocument } from "./content-change-hydration-DpQ0KdAD.mjs";
|
|
4
4
|
import { createFilesystemDocsMcpSource } from "./mcp.mjs";
|
|
5
5
|
import { _ as resolveDocsContentDir, a as loadDocsConfigModule, c as loadProjectEnv, d as readNavTitle, f as readNumberProperty, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral, u as readEnvReferenceProperty } from "./config-Wcdj-D0a.mjs";
|
|
6
6
|
import { createRequire } from "node:module";
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { $n as LlmsTxtMaxCharsMode, At as DocsConfig, Dn as DocsSearchFilterField, En as DocsSearchFacetsResponse, F as DocsAgentContentChangesConfig, Fn as DocsSearchSourcePage, It as DocsContentChangesResponse, K as DocsAgentFeedbackData, Lt as DocsContentSnapshot, Mr as TypesenseDocsSearchConfig, Nn as DocsSearchResult, On as DocsSearchFilterInput, Qn as LlmsTxtMaxCharsConfig, Rn as DocsSitemapConfig, Sn as DocsSearchDocument, Sr as ResolvedDocsRelatedLink, Vt as DocsI18nConfig, Zn as LlmsTxtConfig, bn as DocsSearchChunkingConfig, er as LlmsTxtSectionConfig, f as CustomDocsSearchConfig, gn as DocsSearchAdapter, gt as DocsAskAIMcpConfig, in as DocsPaginatedSearchResponse, jn as DocsSearchRequest, kn as DocsSearchFilters, mn as DocsRobotsConfig, mr as PageAgentFrontmatter, qn as FeedbackConfig, qt as DocsMcpConfig, r as AlgoliaDocsSearchConfig, tr as McpDocsSearchConfig, vn as DocsSearchAdapterFactory, xn as DocsSearchConfig } from "./types-
|
|
2
|
-
import { O as DocsA2AAgentCardOptions, R as DocsDiscoveryApiRouteOptions, z as DocsPublishedAgentSkill } from "./standards-discovery-
|
|
1
|
+
import { $n as LlmsTxtMaxCharsMode, At as DocsConfig, Dn as DocsSearchFilterField, En as DocsSearchFacetsResponse, F as DocsAgentContentChangesConfig, Fn as DocsSearchSourcePage, It as DocsContentChangesResponse, K as DocsAgentFeedbackData, Lt as DocsContentSnapshot, Mr as TypesenseDocsSearchConfig, Nn as DocsSearchResult, On as DocsSearchFilterInput, Qn as LlmsTxtMaxCharsConfig, Rn as DocsSitemapConfig, Sn as DocsSearchDocument, Sr as ResolvedDocsRelatedLink, Vt as DocsI18nConfig, Zn as LlmsTxtConfig, bn as DocsSearchChunkingConfig, er as LlmsTxtSectionConfig, f as CustomDocsSearchConfig, gn as DocsSearchAdapter, gt as DocsAskAIMcpConfig, in as DocsPaginatedSearchResponse, jn as DocsSearchRequest, kn as DocsSearchFilters, mn as DocsRobotsConfig, mr as PageAgentFrontmatter, qn as FeedbackConfig, qt as DocsMcpConfig, r as AlgoliaDocsSearchConfig, tr as McpDocsSearchConfig, vn as DocsSearchAdapterFactory, xn as DocsSearchConfig } from "./types-CoohpxFz.mjs";
|
|
2
|
+
import { O as DocsA2AAgentCardOptions, R as DocsDiscoveryApiRouteOptions, z as DocsPublishedAgentSkill } from "./standards-discovery-BWz35hS6.mjs";
|
|
3
3
|
import { DocsMcpPage, DocsMcpResolvedConfig } from "./mcp.mjs";
|
|
4
4
|
|
|
5
5
|
//#region src/i18n.d.ts
|
|
@@ -303,6 +303,90 @@ declare function createDocsContentChangesHttpResponse(options: {
|
|
|
303
303
|
baseUrl?: string;
|
|
304
304
|
}): Promise<Response>;
|
|
305
305
|
//#endregion
|
|
306
|
+
//#region src/content-change-hydration.d.ts
|
|
307
|
+
declare const DOCS_CONTENT_CHANGE_HYDRATION_FORMAT = "docs-content-change-hydration.v1";
|
|
308
|
+
declare const DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET = 5000;
|
|
309
|
+
declare const MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET = 4;
|
|
310
|
+
declare const MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET = 32000;
|
|
311
|
+
interface DocsContentChangeHydrationSection {
|
|
312
|
+
id: string;
|
|
313
|
+
heading: string;
|
|
314
|
+
level: number;
|
|
315
|
+
}
|
|
316
|
+
interface DocsContentChangeHydrationContent {
|
|
317
|
+
type: "content";
|
|
318
|
+
change: "added" | "changed";
|
|
319
|
+
url: string;
|
|
320
|
+
canonicalUrl: string;
|
|
321
|
+
/** Digest from the body-free document change feed. */
|
|
322
|
+
digest: string;
|
|
323
|
+
previousDigest?: string;
|
|
324
|
+
lastModified?: string;
|
|
325
|
+
previousLastModified?: string;
|
|
326
|
+
section: DocsContentChangeHydrationSection;
|
|
327
|
+
/** Digest of the complete, non-overlapping section before chunking. */
|
|
328
|
+
sectionDigest: string;
|
|
329
|
+
/** Digest of the content bytes returned in this chunk. */
|
|
330
|
+
chunkDigest: string;
|
|
331
|
+
chunk: {
|
|
332
|
+
index: number;
|
|
333
|
+
count: number;
|
|
334
|
+
};
|
|
335
|
+
content: string;
|
|
336
|
+
utf8Bytes: number;
|
|
337
|
+
}
|
|
338
|
+
interface DocsContentChangeHydrationTombstone {
|
|
339
|
+
type: "tombstone";
|
|
340
|
+
change: "deleted";
|
|
341
|
+
url: string;
|
|
342
|
+
canonicalUrl: string;
|
|
343
|
+
/** Last known digest for the deleted document. */
|
|
344
|
+
digest: string;
|
|
345
|
+
lastModified?: string;
|
|
346
|
+
}
|
|
347
|
+
interface DocsContentChangeHydrationBudget {
|
|
348
|
+
requestedTokens: number;
|
|
349
|
+
strategy: "utf8-bytes";
|
|
350
|
+
maxUtf8Bytes: number;
|
|
351
|
+
usedUtf8Bytes: number;
|
|
352
|
+
conservativeTokenUpperBound: number;
|
|
353
|
+
remainingUtf8Bytes: number;
|
|
354
|
+
}
|
|
355
|
+
interface DocsContentChangeHydrationResponse {
|
|
356
|
+
format: typeof DOCS_CONTENT_CHANGE_HYDRATION_FORMAT;
|
|
357
|
+
audience: "agent";
|
|
358
|
+
locale?: string;
|
|
359
|
+
since: string;
|
|
360
|
+
indexGeneration: string;
|
|
361
|
+
mode: DocsContentChangesResponse["mode"];
|
|
362
|
+
resetRequired: boolean;
|
|
363
|
+
documentCount: number;
|
|
364
|
+
counts: DocsContentChangesResponse["counts"];
|
|
365
|
+
budget: DocsContentChangeHydrationBudget;
|
|
366
|
+
resultCount: number;
|
|
367
|
+
total: number;
|
|
368
|
+
hasMore: boolean;
|
|
369
|
+
nextCursor?: string;
|
|
370
|
+
content: DocsContentChangeHydrationContent[];
|
|
371
|
+
tombstones: DocsContentChangeHydrationTombstone[];
|
|
372
|
+
}
|
|
373
|
+
interface HydrateDocsContentChangesOptions {
|
|
374
|
+
changes: DocsContentChangesResponse;
|
|
375
|
+
pages: readonly DocsSearchSourcePage[];
|
|
376
|
+
since: string;
|
|
377
|
+
tokenBudget?: number;
|
|
378
|
+
cursor?: string;
|
|
379
|
+
/** Stable MCP server identity mixed into opaque continuation cursors. */
|
|
380
|
+
cursorScope: string;
|
|
381
|
+
}
|
|
382
|
+
/**
|
|
383
|
+
* Hydrate only the current bodies named by a content-change delta.
|
|
384
|
+
*
|
|
385
|
+
* The conservative budget treats one UTF-8 byte as at most one token. Cursors are
|
|
386
|
+
* bound to the requested generation, current generation, locale, and budget.
|
|
387
|
+
*/
|
|
388
|
+
declare function hydrateDocsContentChanges(options: HydrateDocsContentChangesOptions): DocsContentChangeHydrationResponse;
|
|
389
|
+
//#endregion
|
|
306
390
|
//#region src/mcp-auth.d.ts
|
|
307
391
|
declare const DEFAULT_MCP_ROUTE = "/api/docs/mcp";
|
|
308
392
|
declare const DEFAULT_MCP_PUBLIC_ROUTE = "/mcp";
|
|
@@ -1195,6 +1279,7 @@ declare function buildDocsAgentDiscoverySpec({
|
|
|
1195
1279
|
searchDocs: boolean;
|
|
1196
1280
|
searchFacets?: boolean;
|
|
1197
1281
|
listContentChanges?: boolean;
|
|
1282
|
+
hydrateContentChanges?: boolean;
|
|
1198
1283
|
getNavigation: boolean;
|
|
1199
1284
|
getCodeExamples: boolean;
|
|
1200
1285
|
getConfigSchema: boolean;
|
|
@@ -1219,4 +1304,4 @@ declare function buildDocsAgentDiscoverySpec({
|
|
|
1219
1304
|
declare function acceptsDocsMarkdown(request: Request): boolean;
|
|
1220
1305
|
declare function resolveDocsOpenApiDiscoveryConfig(openapi?: boolean | DocsOpenApiDiscoveryConfig): DocsOpenApiResolvedDiscoveryConfig;
|
|
1221
1306
|
//#endregion
|
|
1222
|
-
export { DocsMarkdownPage as $,
|
|
1307
|
+
export { DocsMarkdownPage as $, PerformDocsSearchOptions as $n, resolveDocsLlmsTxtRequest as $t, DocsAgentFeedbackDiscoveryConfig as A, MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET as An, resolveDocsAgentMdxContent as Ar, hasDocsMarkdownSignatureAgent as At, DocsDiagnosticsIssueSeverity as B, createDocsContentChangeFeed as Bn, normalizeDocsPathSegment as Bt, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as C, DocsContentChangeHydrationBudget as Cn, resolveSearchRequestConfig as Cr, createDocsMarkdownResponse as Ct, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as D, DocsContentChangeHydrationTombstone as Dn, ExtractedDocsMarkdownPromptBlocks as Dr, getDocsLlmsTxtMaxCharsIssue as Dt, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as E, DocsContentChangeHydrationSection as En, DocsMarkdownPromptBlock as Er, findDocsMarkdownPage as Et, DocsConfigMapJsonValue as F, DocsContentChangeFeed as Fn, resolveDocsI18n as Fr, isDocsLlmsTxtPublicRequest as Ft, DocsLlmsTxtGeneratedSection as G, resolveDocsContentChangesRequest as Gn, renderDocsMarkdownDocument as Gt, DocsDiagnosticsStatus as H, isDocsContentChangeGeneration as Hn, parseDocsAgentFeedbackData as Ht, DocsConfigMapPointer as I, DocsContentChangesRequest as In, resolveDocsLocale as Ir, isDocsMarkdownSectionIndexRequest as It, DocsLlmsTxtRequest as J, DocsLocalMcpSearchRuntimeConfig as Jn, resolveDocsAgentContractMcpTools as Jt, DocsLlmsTxtMaxCharsIssue as K, BuildDocsContentSnapshotOptions as Kn, renderDocsMarkdownNotFound as Kt, DocsDiagnostics as L, DocsContentChangesRequestError as Ln, resolveDocsPath as Lr, isDocsPublicGetRequest as Lt, DocsAgentFeedbackResolvedConfig as M, DOCS_CONTENT_CHANGES_FORMAT as Mn, resolveDocsAudienceMdxContent as Mr, isDocsAgentsRequest as Mt, DocsAgentsDocumentOptions as N, DOCS_CONTENT_CHANGES_RESPONSE_VALUE as Nn, DocsPathMatch as Nr, isDocsConfigRequest as Nt, DocsAgentContractMcpTools as O, HydrateDocsContentChangesOptions as On, extractDocsMarkdownPromptBlocks as Or, getDocsMarkdownCanonicalLinkHeader as Ot, DocsConfigMap as P, DOCS_CONTENT_SNAPSHOT_FORMAT as Pn, ResolvedDocsI18n as Pr, isDocsDiagnosticsRequest as Pt, DocsMarkdownAgentDetection as Q, EnrichDocsSearchDocumentsWithProvenanceOptions as Qn, resolveDocsLlmsTxtFormat as Qt, DocsDiagnosticsFeature as R, DocsResolvedContentChangesConfig as Rn, isDocsSkillRequest as Rt, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as S, DOCS_CONTENT_CHANGE_HYDRATION_FORMAT as Sn, resolveLocalDocsMcpSearchConfig as Sr, collectDocsMarkdownSections as St, DOCS_MARKDOWN_SECTION_INDEX_FORMAT as T, DocsContentChangeHydrationResponse as Tn, DocsContentAudience as Tr, detectDocsMarkdownAgentRequest as Tt, DocsLlmsDiscoveryConfig as U, isDocsContentChangesRequest as Un, renderDocsAgentsDocument as Ut, DocsDiagnosticsOptions as V, createDocsContentChangesHttpResponse as Vn, normalizeDocsUrlPath as Vt, DocsLlmsTxtGeneratedContent as W, resolveDocsContentChangesConfig as Wn, renderDocsLlmsTxt as Wt, DocsLlmsTxtResolvedSection as X, DocsSearchRequestError as Xn, resolveDocsAgentFeedbackRequest as Xt, DocsLlmsTxtResolvedMaxChars as Y, DocsLocalMcpSearchRuntimeInput as Yn, resolveDocsAgentFeedbackConfig as Yt, DocsLlmsTxtSelectedContent as Z, DocsSearchRequestResolutionOptions as Zn, resolveDocsAgentsFormat as Zt, DEFAULT_LLMS_TXT_MAX_CHARS as _, getDocsMcpProtectedResourceMetadataRoutes as _n, resolveDocsRetrievalLastModified as _r, buildDocsAgentFeedbackSchema as _t, DEFAULT_AGENT_MD_ROUTE as a, resolveDocsOpenApiDiscoveryConfig as an, createAlgoliaSearchAdapter as ar, DocsMarkdownSectionIndexOptions as at, DEFAULT_OPENAPI_SCHEMA_ROUTE as b, isDocsMcpRequest as bn, resolveDocsSearchFilters as br, buildDocsMarkdownSectionIndex as bt, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as c, selectDocsLlmsTxtContent as cn, createSimpleSearchAdapter as cr, DocsMarkdownSectionResult as ct, DEFAULT_DOCS_CONFIG_FORMAT as d, validateDocsAgentFeedbackPayload as dn, formatDocsAskAIPackageHints as dr, DocsOpenApiDiscoveryConfig as dt, resolveDocsLlmsTxtSections as en, buildDocsAskAIContext as er, DocsMarkdownRecoveryMatch as et, DEFAULT_DOCS_CONFIG_ROUTE as f, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE as fn, inferDocsAskAIPackageHints as fr, DocsOpenApiResolvedDiscoveryConfig as ft, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as g, buildDocsMcpProtectedResourceMetadataRoute as gn, resolveAskAISearchRequestConfig as gr, buildDocsAgentDiscoverySpec as gt, DEFAULT_LLMS_FULL_TXT_ROUTE as h, DEFAULT_MCP_WELL_KNOWN_ROUTE as hn, performDocsSearchWithMetadata as hr, acceptsDocsMarkdown as ht, DEFAULT_AGENT_FEEDBACK_ROUTE as i, resolveDocsMarkdownSectionRequest as in, buildDocsSearchFacets as ir, DocsMarkdownSectionIndex as it, DocsAgentFeedbackRequest as j, hydrateDocsContentChanges as jn, resolveDocsAudienceExposure as jr, isDocsAgentDiscoveryRequest as jt, DocsAgentDiscoverySpecOptions as k, MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET as kn, findDocsAudienceMdxIssues as kr, getDocsMarkdownVaryHeader as kt, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as l, selectDocsMarkdownSection as ln, createTypesenseSearchAdapter as lr, DocsMcpEndpointCandidate as lt, DEFAULT_DOCS_DIAGNOSTICS_ROUTE as m, DEFAULT_MCP_ROUTE as mn, performDocsSearch as mr, DocsStandardsDiscoveryResponseOptions as mt, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE as n, resolveDocsMarkdownRecovery as nn, buildDocsRetrievalDigestProjection as nr, DocsMarkdownResponseOptions as nt, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE as o, resolveDocsRequestApiRoute as on, createCustomSearchAdapter as or, DocsMarkdownSectionMetadata as ot, DEFAULT_DOCS_DIAGNOSTICS_FORMAT as p, DEFAULT_MCP_PUBLIC_ROUTE as pn, normalizeDocsSearchFilters as pr, DocsSkillDocumentOptions as pt, DocsLlmsTxtPageInput as q, BuildDocsSearchFacetsOptions as qn, renderDocsSkillDocument as qt, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as r, resolveDocsMarkdownRequest as rn, buildDocsSearchDocuments as rr, DocsMarkdownSection as rt, DEFAULT_AGENT_SPEC_ROUTE as s, resolveDocsSkillFormat as sn, createMcpSearchAdapter as sr, DocsMarkdownSectionRequest as st, DEFAULT_AGENTS_MD_ROUTE as t, resolveDocsMarkdownCanonicalUrl as tn, buildDocsContentSnapshot as tr, DocsMarkdownRecoveryResult as tt, DEFAULT_DOCS_API_ROUTE as u, toDocsMarkdownUrl as un, enrichDocsSearchDocumentsWithProvenance as ur, DocsMcpEndpointCandidateOptions as ut, DEFAULT_LLMS_TXT_ROUTE as v, getDocsMcpResourcePaths as vn, resolveDocsSearchAudience as vr, buildDocsConfigMap as vt, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as w, DocsContentChangeHydrationContent as wn, DocsAudienceMdxIssue as wr, createDocsStandardsDiscoveryResponse as wt, DEFAULT_SKILL_MD_ROUTE as x, DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET as xn, resolveDocsSearchRequest as xr, buildDocsMcpEndpointCandidates as xt, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as y, hasDocsMcpProtectedResourceConfig as yn, resolveDocsSearchError as yr, buildDocsDiagnostics as yt, DocsDiagnosticsIssue as z, ResolveDocsContentChangesOptions as zn, matchesDocsLlmsTxtSection as zt };
|
|
@@ -8715,4 +8715,4 @@ function toYamlString(value) {
|
|
|
8715
8715
|
}
|
|
8716
8716
|
|
|
8717
8717
|
//#endregion
|
|
8718
|
-
export { matchesDocsLlmsTxtSection as $,
|
|
8718
|
+
export { matchesDocsLlmsTxtSection as $, isDocsMcpResourcePath as $n, buildDocsRetrievalDigestProjection as $t, buildDocsAgentDiscoverySpec as A, normalizeAgentFramework as An, DEFAULT_SITEMAP_XML_ROUTE as At, findDocsMarkdownPage as B, normalizeDocsRelated as Bn, DOCS_CONTENT_CHANGES_FORMAT as Bt, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as C, findDocsAudienceMdxTags as Cn, selectDocsMarkdownSection as Ct, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as D, agentVersionConstraintGroupsOverlap as Dn, DEFAULT_SITEMAP_MD_DOCS_ROUTE as Dt, DOCS_MARKDOWN_SECTION_INDEX_FORMAT as E, resolveDocsAudienceMdxContent as En, DEFAULT_SITEMAP_MANIFEST_PATH as Et, buildDocsMcpEndpointCandidates as F, createDocsPaginationCursor as Fn, renderDocsSitemapXml as Ft, isDocsAgentDiscoveryRequest as G, DEFAULT_MCP_WELL_KNOWN_ROUTE as Gn, createDocsContentChangesHttpResponse as Gt, getDocsMarkdownCanonicalLinkHeader as H, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE as Hn, DOCS_CONTENT_SNAPSHOT_FORMAT as Ht, collectDocsMarkdownSections as I, paginateDocsItems as In, resolveDocsSitemapConfig as It, isDocsDiagnosticsRequest as J, getDocsMcpResourcePaths as Jn, resolveDocsContentChangesConfig as Jt, isDocsAgentsRequest as K, buildDocsMcpProtectedResourceMetadataRoute as Kn, isDocsContentChangeGeneration as Kt, createDocsMarkdownResponse as L, resolveDocsPaginationOffset as Ln, resolveDocsSitemapPageLastmod as Lt, buildDocsConfigMap as M, normalizeAgentScopeValues as Mn, createDocsSitemapResponse as Mt, buildDocsDiagnostics as N, normalizeAgentVersion as Nn, readDocsSitemapManifestFromContentMap as Nt, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as O, agentVersionConstraintMatches as On, DEFAULT_SITEMAP_MD_ROUTE as Ot, buildDocsMarkdownSectionIndex as P, DocsPaginationCursorError as Pn, renderDocsSitemapMarkdown as Pt, isDocsSkillRequest as Q, isDocsMcpRequest as Qn, buildDocsContentSnapshot as Qt, createDocsStandardsDiscoveryResponse as R, digestDocsRetrievalContent as Rn, resolveDocsSitemapRequest as Rt, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as S, findDocsAudienceMdxIssues as Sn, selectDocsLlmsTxtContent as St, DOCS_CONFIG_MAP_TOP_LEVEL_KEYS as T, resolveDocsAudienceExposure as Tn, validateDocsAgentFeedbackPayload as Tt, getDocsMarkdownVaryHeader as U, DEFAULT_MCP_PUBLIC_ROUTE as Un, DocsContentChangesRequestError as Ut, getDocsLlmsTxtMaxCharsIssue as V, renderDocsRelatedMarkdownLines as Vn, DOCS_CONTENT_CHANGES_RESPONSE_VALUE as Vt, hasDocsMarkdownSignatureAgent as W, DEFAULT_MCP_ROUTE as Wn, createDocsContentChangeFeed as Wt, isDocsMarkdownSectionIndexRequest as X, isDocsMcpOAuthScopeToken as Xn, DocsSearchRequestError as Xt, isDocsLlmsTxtPublicRequest as Y, hasDocsMcpProtectedResourceConfig as Yn, resolveDocsContentChangesRequest as Yt, isDocsPublicGetRequest as Z, isDocsMcpProtectedResourceMetadataPath as Zn, buildDocsAskAIContext as Zt, DEFAULT_LLMS_TXT_MAX_CHARS as _, resolveDocsSearchFilters as _n, resolveDocsMarkdownRequest as _t, DEFAULT_AGENT_MD_ROUTE as a, createSimpleSearchAdapter as an, renderDocsMarkdownDocument as at, DEFAULT_OPENAPI_SCHEMA_ROUTE as b, resolveSearchRequestConfig as bn, resolveDocsRequestApiRoute as bt, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as c, formatDocsAskAIPackageHints as cn, resolveDocsAgentContractMcpTools as ct, DEFAULT_DOCS_CONFIG_FORMAT as d, performDocsSearch as dn, resolveDocsAgentsFormat as dt, buildDocsSearchDocuments as en, normalizeDocsMcpAuthorizationServerUrls as er, normalizeDocsPathSegment as et, DEFAULT_DOCS_CONFIG_ROUTE as f, performDocsSearchWithMetadata as fn, resolveDocsLlmsTxtFormat as ft, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as g, resolveDocsSearchError as gn, resolveDocsMarkdownRecovery as gt, DEFAULT_LLMS_FULL_TXT_ROUTE as h, resolveDocsSearchAudience as hn, resolveDocsMarkdownCanonicalUrl as ht, DEFAULT_AGENT_FEEDBACK_ROUTE as i, createMcpSearchAdapter as in, renderDocsLlmsTxt as it, buildDocsAgentFeedbackSchema as j, normalizeAgentLocale as jn, buildDocsSitemapManifest as jt, acceptsDocsMarkdown as k, agentVersionConstraintsOverlap as kn, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as kt, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as l, inferDocsAskAIPackageHints as ln, resolveDocsAgentFeedbackConfig as lt, DEFAULT_DOCS_DIAGNOSTICS_ROUTE as m, resolveDocsRetrievalLastModified as mn, resolveDocsLlmsTxtSections as mt, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE as n, createAlgoliaSearchAdapter as nn, resolveDocsMcpProtectedResourceMetadataLocation as nr, parseDocsAgentFeedbackData as nt, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE as o, createTypesenseSearchAdapter as on, renderDocsMarkdownNotFound as ot, DEFAULT_DOCS_DIAGNOSTICS_FORMAT as p, resolveAskAISearchRequestConfig as pn, resolveDocsLlmsTxtRequest as pt, isDocsConfigRequest as q, getDocsMcpProtectedResourceMetadataRoutes as qn, isDocsContentChangesRequest as qt, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as r, createCustomSearchAdapter as rn, resolveDocsMcpResourceLocation as rr, renderDocsAgentsDocument as rt, DEFAULT_AGENT_SPEC_ROUTE as s, enrichDocsSearchDocumentsWithProvenance as sn, renderDocsSkillDocument as st, DEFAULT_AGENTS_MD_ROUTE as t, buildDocsSearchFacets as tn, normalizeDocsMcpEndpointPath as tr, normalizeDocsUrlPath as tt, DEFAULT_DOCS_API_ROUTE as u, normalizeDocsSearchFilters as un, resolveDocsAgentFeedbackRequest as ut, DEFAULT_LLMS_TXT_ROUTE as v, resolveDocsSearchRequest as vn, resolveDocsMarkdownSectionRequest as vt, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as w, resolveDocsAgentMdxContent as wn, toDocsMarkdownUrl as wt, DEFAULT_SKILL_MD_ROUTE as x, extractDocsMarkdownPromptBlocks as xn, resolveDocsSkillFormat as xt, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as y, resolveLocalDocsMcpSearchConfig as yn, resolveDocsOpenApiDiscoveryConfig as yt, detectDocsMarkdownAgentRequest as z, isDocsRetrievalCanonicalUrl as zn, toDocsSitemapMarkdownUrl as zt };
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { An as normalizeAgentFramework, Dn as agentVersionConstraintGroupsOverlap, Mn as normalizeAgentScopeValues, Nn as normalizeAgentVersion, On as agentVersionConstraintMatches, Zt as buildDocsAskAIContext, bn as resolveSearchRequestConfig, dn as performDocsSearch, jn as normalizeAgentLocale, kn as agentVersionConstraintsOverlap, un as normalizeDocsSearchFilters } from "./agent-
|
|
1
|
+
import { An as normalizeAgentFramework, Dn as agentVersionConstraintGroupsOverlap, Mn as normalizeAgentScopeValues, Nn as normalizeAgentVersion, On as agentVersionConstraintMatches, Zt as buildDocsAskAIContext, bn as resolveSearchRequestConfig, dn as performDocsSearch, jn as normalizeAgentLocale, kn as agentVersionConstraintsOverlap, un as normalizeDocsSearchFilters } from "./agent-Dze2Cy5B.mjs";
|
|
2
2
|
import { S as upsertPageAgentContractMarkdown, l as stripDocsGeneratedAgentContractMarkers, o as findDocsMarkdownSection } from "./markdown-sections-7OoA7ylx.mjs";
|
|
3
3
|
import { buildDocsMcpContext } from "./mcp.mjs";
|
|
4
4
|
import { i as validateCodeBlockPlans, n as planCodeBlockTargets, r as resolveDocsCodeBlocksValidateConfig, t as extractCodeBlocksFromMarkdown } from "./code-blocks-DnNVNK2M.mjs";
|
|
@@ -1,11 +1,11 @@
|
|
|
1
|
-
import { A as buildDocsAgentDiscoverySpec, Ft as renderDocsSitemapXml, It as resolveDocsSitemapConfig, Pt as renderDocsSitemapMarkdown, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, at as renderDocsMarkdownDocument, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, it as renderDocsLlmsTxt, jt as buildDocsSitemapManifest, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, lt as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, rt as renderDocsAgentsDocument, st as renderDocsSkillDocument, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, wt as toDocsMarkdownUrl, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-
|
|
1
|
+
import { A as buildDocsAgentDiscoverySpec, Ft as renderDocsSitemapXml, It as resolveDocsSitemapConfig, Pt as renderDocsSitemapMarkdown, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, at as renderDocsMarkdownDocument, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, it as renderDocsLlmsTxt, jt as buildDocsSitemapManifest, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, lt as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, rt as renderDocsAgentsDocument, st as renderDocsSkillDocument, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, wt as toDocsMarkdownUrl, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-Dze2Cy5B.mjs";
|
|
2
2
|
import "./markdown-sections-7OoA7ylx.mjs";
|
|
3
3
|
import { A as buildDocsLegacySkillsIndex, D as buildDocsA2AAgentCard, L as resolveDocsPublishedAgentSkill, O as buildDocsAgentSkillsIndex, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-BKlEnK_H.mjs";
|
|
4
|
-
import "./
|
|
4
|
+
import "./content-change-hydration-DpQ0KdAD.mjs";
|
|
5
5
|
import { t as resolveDocsI18n } from "./i18n-hHVWcflJ.mjs";
|
|
6
|
-
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-
|
|
7
|
-
import "./sitemap-server-
|
|
8
|
-
import "./agent-evals-
|
|
6
|
+
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-D96X6eVX.mjs";
|
|
7
|
+
import "./sitemap-server-BefXEox6.mjs";
|
|
8
|
+
import "./agent-evals-CGOA7jJ0.mjs";
|
|
9
9
|
import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
|
|
10
10
|
import "./code-blocks-DnNVNK2M.mjs";
|
|
11
11
|
import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-B2EXn2QD.mjs";
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { et as DocsAgentSkillsInput } from "./types-
|
|
2
|
-
import { z as DocsPublishedAgentSkill } from "./standards-discovery-
|
|
1
|
+
import { et as DocsAgentSkillsInput } from "./types-CoohpxFz.mjs";
|
|
2
|
+
import { z as DocsPublishedAgentSkill } from "./standards-discovery-BWz35hS6.mjs";
|
|
3
3
|
|
|
4
4
|
//#region src/agent-skills-server.d.ts
|
|
5
5
|
interface ResolveConfiguredAgentSkillsOptions {
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import { et as DocsAgentSkillsInput } from "./types-
|
|
2
|
-
import { z as DocsPublishedAgentSkill } from "./standards-discovery-
|
|
3
|
-
import { t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-
|
|
1
|
+
import { et as DocsAgentSkillsInput } from "./types-CoohpxFz.mjs";
|
|
2
|
+
import { z as DocsPublishedAgentSkill } from "./standards-discovery-BWz35hS6.mjs";
|
|
3
|
+
import { t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-CclBBz1M.mjs";
|
|
4
4
|
|
|
5
5
|
//#region src/agent-skills-vite.d.ts
|
|
6
6
|
declare const DOCS_AGENT_SKILLS_BUNDLE_MODULE = "@farming-labs/docs/agent-skills-bundle";
|
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
import { a as DEFAULT_AGENT_MD_ROUTE, lt as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, rt as renderDocsAgentsDocument, t as DEFAULT_AGENTS_MD_ROUTE } from "./agent-
|
|
1
|
+
import { a as DEFAULT_AGENT_MD_ROUTE, lt as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, rt as renderDocsAgentsDocument, t as DEFAULT_AGENTS_MD_ROUTE } from "./agent-Dze2Cy5B.mjs";
|
|
2
2
|
import "./markdown-sections-7OoA7ylx.mjs";
|
|
3
3
|
import "./standards-discovery-BKlEnK_H.mjs";
|
|
4
|
-
import "./
|
|
5
|
-
import { C as resolveApiReferenceOpenApiDiscovery } from "./sitemap-server-
|
|
6
|
-
import "./agent-evals-
|
|
4
|
+
import "./content-change-hydration-DpQ0KdAD.mjs";
|
|
5
|
+
import { C as resolveApiReferenceOpenApiDiscovery } from "./sitemap-server-BefXEox6.mjs";
|
|
6
|
+
import "./agent-evals-CGOA7jJ0.mjs";
|
|
7
7
|
import { resolveDocsMcpConfig } from "./mcp.mjs";
|
|
8
8
|
import "./code-blocks-DnNVNK2M.mjs";
|
|
9
9
|
import "./agent-skills-server-B2EXn2QD.mjs";
|
package/dist/cli/index.mjs
CHANGED
|
@@ -141,10 +141,10 @@ async function main() {
|
|
|
141
141
|
printCloudHelp();
|
|
142
142
|
process.exit(1);
|
|
143
143
|
} else if (parsedCommand.command === "mcp") {
|
|
144
|
-
const { runMcp } = await import("../mcp-
|
|
144
|
+
const { runMcp } = await import("../mcp-DUxk8lGS.mjs");
|
|
145
145
|
await runMcp(mcpOptions);
|
|
146
146
|
} else if (parsedCommand.command === "agent" && subcommand === "compact") {
|
|
147
|
-
const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-
|
|
147
|
+
const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-Biyd8A98.mjs").then((n) => n.t);
|
|
148
148
|
const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
|
|
149
149
|
if (agentCompactOptions.help) {
|
|
150
150
|
printAgentCompactHelp();
|
|
@@ -152,7 +152,7 @@ async function main() {
|
|
|
152
152
|
}
|
|
153
153
|
await compactAgentDocs(agentCompactOptions);
|
|
154
154
|
} else if (parsedCommand.command === "agent" && subcommand === "export") {
|
|
155
|
-
const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-
|
|
155
|
+
const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-BYWO6fES.mjs");
|
|
156
156
|
const agentExportOptions = parseAgentExportArgs(args.slice(2));
|
|
157
157
|
if (agentExportOptions.help) {
|
|
158
158
|
printAgentExportHelp();
|
|
@@ -162,13 +162,13 @@ async function main() {
|
|
|
162
162
|
} else if (parsedCommand.command === "agent") {
|
|
163
163
|
console.error(pc.red(`Unknown agent subcommand: ${subcommand ?? "(missing)"}`));
|
|
164
164
|
console.error();
|
|
165
|
-
const { printAgentCompactHelp } = await import("../agent-
|
|
166
|
-
const { printAgentExportHelp } = await import("../agent-export-
|
|
165
|
+
const { printAgentCompactHelp } = await import("../agent-Biyd8A98.mjs").then((n) => n.t);
|
|
166
|
+
const { printAgentExportHelp } = await import("../agent-export-BYWO6fES.mjs");
|
|
167
167
|
printAgentCompactHelp();
|
|
168
168
|
printAgentExportHelp();
|
|
169
169
|
process.exit(1);
|
|
170
170
|
} else if (parsedCommand.command === "agents" && subcommand === "generate") {
|
|
171
|
-
const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-
|
|
171
|
+
const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-CDs7ZFdb.mjs");
|
|
172
172
|
const agentsOptions = parseAgentsGenerateArgs(args.slice(2));
|
|
173
173
|
if (agentsOptions.help) {
|
|
174
174
|
printAgentsGenerateHelp();
|
|
@@ -178,11 +178,11 @@ async function main() {
|
|
|
178
178
|
} else if (parsedCommand.command === "agents") {
|
|
179
179
|
console.error(pc.red(`Unknown agents subcommand: ${subcommand ?? "(missing)"}`));
|
|
180
180
|
console.error();
|
|
181
|
-
const { printAgentsGenerateHelp } = await import("../agents-
|
|
181
|
+
const { printAgentsGenerateHelp } = await import("../agents-CDs7ZFdb.mjs");
|
|
182
182
|
printAgentsGenerateHelp();
|
|
183
183
|
process.exit(1);
|
|
184
184
|
} else if (parsedCommand.command === "doctor") {
|
|
185
|
-
const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-
|
|
185
|
+
const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-CALb10jP.mjs");
|
|
186
186
|
const doctorOptions = parseDoctorArgs(args.slice(1));
|
|
187
187
|
if (doctorOptions.help) {
|
|
188
188
|
printDoctorHelp();
|
|
@@ -190,7 +190,7 @@ async function main() {
|
|
|
190
190
|
}
|
|
191
191
|
await runDoctor(doctorOptions);
|
|
192
192
|
} else if (parsedCommand.command === "review") {
|
|
193
|
-
const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-
|
|
193
|
+
const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-CaDaE4Pq.mjs");
|
|
194
194
|
const reviewOptions = parseReviewArgs(args.slice(1));
|
|
195
195
|
if (reviewOptions.help) {
|
|
196
196
|
printReviewHelp();
|
|
@@ -212,7 +212,7 @@ async function main() {
|
|
|
212
212
|
printCodeBlocksValidateHelp();
|
|
213
213
|
process.exit(1);
|
|
214
214
|
} else if (parsedCommand.command === "search" && subcommand === "sync") {
|
|
215
|
-
const { syncSearch } = await import("../search-
|
|
215
|
+
const { syncSearch } = await import("../search-D7s_gagx.mjs");
|
|
216
216
|
await syncSearch(searchSyncOptions);
|
|
217
217
|
} else if (parsedCommand.command === "search") {
|
|
218
218
|
console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
|
|
@@ -220,7 +220,7 @@ async function main() {
|
|
|
220
220
|
printHelp();
|
|
221
221
|
process.exit(1);
|
|
222
222
|
} else if (parsedCommand.command === "sitemap" && subcommand === "generate") {
|
|
223
|
-
const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-
|
|
223
|
+
const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-BMRfmpEp.mjs");
|
|
224
224
|
const sitemapOptions = parseSitemapGenerateArgs(args.slice(2));
|
|
225
225
|
if (sitemapOptions.help) {
|
|
226
226
|
printSitemapGenerateHelp();
|
|
@@ -230,11 +230,11 @@ async function main() {
|
|
|
230
230
|
} else if (parsedCommand.command === "sitemap") {
|
|
231
231
|
console.error(pc.red(`Unknown sitemap subcommand: ${subcommand ?? "(missing)"}`));
|
|
232
232
|
console.error();
|
|
233
|
-
const { printSitemapGenerateHelp } = await import("../sitemap-
|
|
233
|
+
const { printSitemapGenerateHelp } = await import("../sitemap-BMRfmpEp.mjs");
|
|
234
234
|
printSitemapGenerateHelp();
|
|
235
235
|
process.exit(1);
|
|
236
236
|
} else if (parsedCommand.command === "robots" && subcommand === "generate") {
|
|
237
|
-
const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-
|
|
237
|
+
const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-BIySk2gE.mjs");
|
|
238
238
|
const robotsOptions = parseRobotsGenerateArgs(args.slice(2));
|
|
239
239
|
if (robotsOptions.help) {
|
|
240
240
|
printRobotsGenerateHelp();
|
|
@@ -244,7 +244,7 @@ async function main() {
|
|
|
244
244
|
} else if (parsedCommand.command === "robots") {
|
|
245
245
|
console.error(pc.red(`Unknown robots subcommand: ${subcommand ?? "(missing)"}`));
|
|
246
246
|
console.error();
|
|
247
|
-
const { printRobotsGenerateHelp } = await import("../robots-
|
|
247
|
+
const { printRobotsGenerateHelp } = await import("../robots-BIySk2gE.mjs");
|
|
248
248
|
printRobotsGenerateHelp();
|
|
249
249
|
process.exit(1);
|
|
250
250
|
} else if (parsedCommand.command === "downgrade") {
|
package/dist/client/react.d.mts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { it as DocsAnalyticsConfig, t as AIConfig, vt as DocsCloudConfig } from "./types-
|
|
1
|
+
import { it as DocsAnalyticsConfig, t as AIConfig, vt as DocsCloudConfig } from "./types-CoohpxFz.mjs";
|
|
2
2
|
|
|
3
3
|
//#region src/cloud-ask-ai.d.ts
|
|
4
4
|
interface DocsCloudAskAIConfig {
|
|
@@ -1,4 +1,6 @@
|
|
|
1
|
-
import { G as isDocsAgentDiscoveryRequest, Jt as resolveDocsContentChangesConfig, K as isDocsAgentsRequest, Q as isDocsSkillRequest, _t as resolveDocsMarkdownRequest, dt as resolveDocsAgentsFormat, lt as resolveDocsAgentFeedbackConfig, pt as resolveDocsLlmsTxtRequest, qt as isDocsContentChangesRequest, ut as resolveDocsAgentFeedbackRequest, xt as resolveDocsSkillFormat } from "./agent-
|
|
1
|
+
import { $t as buildDocsRetrievalDigestProjection, Fn as createDocsPaginationCursor, G as isDocsAgentDiscoveryRequest, Jt as resolveDocsContentChangesConfig, K as isDocsAgentsRequest, Ln as resolveDocsPaginationOffset, Pn as DocsPaginationCursorError, Q as isDocsSkillRequest, Rn as digestDocsRetrievalContent, _t as resolveDocsMarkdownRequest, dt as resolveDocsAgentsFormat, lt as resolveDocsAgentFeedbackConfig, pt as resolveDocsLlmsTxtRequest, qt as isDocsContentChangesRequest, ut as resolveDocsAgentFeedbackRequest, xt as resolveDocsSkillFormat } from "./agent-Dze2Cy5B.mjs";
|
|
2
|
+
import { s as parseDocsMarkdownSections } from "./markdown-sections-7OoA7ylx.mjs";
|
|
3
|
+
import matter from "gray-matter";
|
|
2
4
|
|
|
3
5
|
//#region src/telemetry.ts
|
|
4
6
|
const DOCS_PACKAGE_NAME = "@farming-labs/docs";
|
|
@@ -460,4 +462,218 @@ function serializeGeneratedAgentDocument(content, provenance) {
|
|
|
460
462
|
}
|
|
461
463
|
|
|
462
464
|
//#endregion
|
|
463
|
-
|
|
465
|
+
//#region src/content-change-hydration.ts
|
|
466
|
+
const DOCS_CONTENT_CHANGE_HYDRATION_FORMAT = "docs-content-change-hydration.v1";
|
|
467
|
+
const DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET = 5e3;
|
|
468
|
+
const MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET = 4;
|
|
469
|
+
const MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET = 32e3;
|
|
470
|
+
const DOCS_CONTENT_CHANGE_HYDRATION_PAGE_SIZE = 25;
|
|
471
|
+
const DOCS_CONTENT_CHANGE_HYDRATION_CURSOR_KIND = "mcp.tool/hydrate_content_changes";
|
|
472
|
+
function docsHydrationUtf8Bytes(value) {
|
|
473
|
+
return new TextEncoder().encode(value).byteLength;
|
|
474
|
+
}
|
|
475
|
+
function appendDocsHydrationLocale(url, locale) {
|
|
476
|
+
if (!locale) return url;
|
|
477
|
+
const hashIndex = url.indexOf("#");
|
|
478
|
+
const withoutHash = hashIndex >= 0 ? url.slice(0, hashIndex) : url;
|
|
479
|
+
const hash = hashIndex >= 0 ? url.slice(hashIndex) : "";
|
|
480
|
+
const queryIndex = withoutHash.indexOf("?");
|
|
481
|
+
const rawQuery = queryIndex >= 0 ? withoutHash.slice(queryIndex + 1) : "";
|
|
482
|
+
if (new URLSearchParams(rawQuery).has("lang")) return url;
|
|
483
|
+
return `${withoutHash}${queryIndex >= 0 ? "&" : "?"}lang=${encodeURIComponent(locale)}${hash}`;
|
|
484
|
+
}
|
|
485
|
+
function splitDocsHydrationChunk(value, maxUtf8Bytes) {
|
|
486
|
+
if (docsHydrationUtf8Bytes(value) <= maxUtf8Bytes) return [value, ""];
|
|
487
|
+
const encoder = new TextEncoder();
|
|
488
|
+
let usedUtf8Bytes = 0;
|
|
489
|
+
let endOffset = 0;
|
|
490
|
+
let paragraphOffset = -1;
|
|
491
|
+
let lineOffset = -1;
|
|
492
|
+
for (const character of value) {
|
|
493
|
+
const characterUtf8Bytes = encoder.encode(character).byteLength;
|
|
494
|
+
if (usedUtf8Bytes + characterUtf8Bytes > maxUtf8Bytes) break;
|
|
495
|
+
usedUtf8Bytes += characterUtf8Bytes;
|
|
496
|
+
endOffset += character.length;
|
|
497
|
+
if (value.slice(Math.max(0, endOffset - 2), endOffset) === "\n\n") paragraphOffset = endOffset;
|
|
498
|
+
else if (character === "\n") lineOffset = endOffset;
|
|
499
|
+
}
|
|
500
|
+
const minimumUsefulBoundary = Math.floor(endOffset * .5);
|
|
501
|
+
const boundary = paragraphOffset >= minimumUsefulBoundary ? paragraphOffset : lineOffset >= minimumUsefulBoundary ? lineOffset : endOffset;
|
|
502
|
+
return [value.slice(0, boundary), value.slice(boundary)];
|
|
503
|
+
}
|
|
504
|
+
function splitDocsHydrationContent(value, maxUtf8Bytes) {
|
|
505
|
+
if (!value) return [""];
|
|
506
|
+
const chunks = [];
|
|
507
|
+
let remaining = value;
|
|
508
|
+
while (remaining) {
|
|
509
|
+
const [chunk, next] = splitDocsHydrationChunk(remaining, maxUtf8Bytes);
|
|
510
|
+
if (!chunk && next === remaining) throw new TypeError("Unable to split changed content within the requested token budget.");
|
|
511
|
+
chunks.push(chunk);
|
|
512
|
+
remaining = next;
|
|
513
|
+
}
|
|
514
|
+
return chunks;
|
|
515
|
+
}
|
|
516
|
+
function partitionDocsHydrationSections(document, page) {
|
|
517
|
+
const body = matter(document).content.trim();
|
|
518
|
+
const parsed = parseDocsMarkdownSections(body);
|
|
519
|
+
if (parsed.length === 0) return [{
|
|
520
|
+
id: "document",
|
|
521
|
+
heading: page.title,
|
|
522
|
+
level: 1,
|
|
523
|
+
content: body
|
|
524
|
+
}];
|
|
525
|
+
const lines = body.split(/\r?\n/u);
|
|
526
|
+
return parsed.map((section, index) => {
|
|
527
|
+
const startLine = index === 0 ? 0 : Math.max(0, section.startLine - 1);
|
|
528
|
+
const nextStartLine = parsed[index + 1]?.startLine;
|
|
529
|
+
const endLine = nextStartLine ? Math.max(startLine, nextStartLine - 1) : lines.length;
|
|
530
|
+
return {
|
|
531
|
+
id: section.anchor,
|
|
532
|
+
heading: section.title,
|
|
533
|
+
level: section.level,
|
|
534
|
+
content: lines.slice(startLine, endLine).join("\n").trim()
|
|
535
|
+
};
|
|
536
|
+
});
|
|
537
|
+
}
|
|
538
|
+
function toHydrationContentUnits(change, kind, page, maxUtf8Bytes) {
|
|
539
|
+
return partitionDocsHydrationSections(buildDocsRetrievalDigestProjection(page, "agent"), page).flatMap((section) => {
|
|
540
|
+
const sectionDigest = digestDocsRetrievalContent(section.content);
|
|
541
|
+
const chunks = splitDocsHydrationContent(section.content, maxUtf8Bytes);
|
|
542
|
+
return chunks.map((content, index) => ({
|
|
543
|
+
type: "content",
|
|
544
|
+
change: kind,
|
|
545
|
+
url: change.url,
|
|
546
|
+
canonicalUrl: change.canonicalUrl,
|
|
547
|
+
digest: change.digest,
|
|
548
|
+
..."previousDigest" in change ? { previousDigest: change.previousDigest } : {},
|
|
549
|
+
...change.lastModified ? { lastModified: change.lastModified } : {},
|
|
550
|
+
..."previousLastModified" in change && change.previousLastModified ? { previousLastModified: change.previousLastModified } : {},
|
|
551
|
+
section: {
|
|
552
|
+
id: section.id,
|
|
553
|
+
heading: section.heading,
|
|
554
|
+
level: section.level
|
|
555
|
+
},
|
|
556
|
+
sectionDigest,
|
|
557
|
+
chunkDigest: digestDocsRetrievalContent(content),
|
|
558
|
+
chunk: {
|
|
559
|
+
index,
|
|
560
|
+
count: chunks.length
|
|
561
|
+
},
|
|
562
|
+
content,
|
|
563
|
+
utf8Bytes: docsHydrationUtf8Bytes(content)
|
|
564
|
+
}));
|
|
565
|
+
});
|
|
566
|
+
}
|
|
567
|
+
function buildDocsHydrationUnits(changes, pages, maxUtf8Bytes) {
|
|
568
|
+
const pagesByUrl = /* @__PURE__ */ new Map();
|
|
569
|
+
for (const page of pages) {
|
|
570
|
+
pagesByUrl.set(page.url, page);
|
|
571
|
+
pagesByUrl.set(appendDocsHydrationLocale(page.url, changes.locale), page);
|
|
572
|
+
}
|
|
573
|
+
const currentUnits = [...changes.added.map((change) => [change, "added"]), ...changes.changed.map((change) => [change, "changed"])].flatMap(([change, kind]) => {
|
|
574
|
+
const page = pagesByUrl.get(change.url);
|
|
575
|
+
if (!page) throw new TypeError(`Unable to hydrate changed documentation content for ${change.url}.`);
|
|
576
|
+
return toHydrationContentUnits(change, kind, page, maxUtf8Bytes);
|
|
577
|
+
});
|
|
578
|
+
const tombstones = changes.deleted.map((change) => ({
|
|
579
|
+
type: "tombstone",
|
|
580
|
+
change: "deleted",
|
|
581
|
+
url: change.url,
|
|
582
|
+
canonicalUrl: change.canonicalUrl,
|
|
583
|
+
digest: change.digest,
|
|
584
|
+
...change.lastModified ? { lastModified: change.lastModified } : {}
|
|
585
|
+
}));
|
|
586
|
+
return [...currentUnits, ...tombstones];
|
|
587
|
+
}
|
|
588
|
+
function resolveDocsHydrationTokenBudget(value) {
|
|
589
|
+
const tokenBudget = value ?? DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET;
|
|
590
|
+
if (!Number.isSafeInteger(tokenBudget) || tokenBudget < MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET || tokenBudget > MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET) throw new TypeError(`Content-change hydration tokenBudget must be between ${MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET} and ${MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET}.`);
|
|
591
|
+
return tokenBudget;
|
|
592
|
+
}
|
|
593
|
+
/**
|
|
594
|
+
* Hydrate only the current bodies named by a content-change delta.
|
|
595
|
+
*
|
|
596
|
+
* The conservative budget treats one UTF-8 byte as at most one token. Cursors are
|
|
597
|
+
* bound to the requested generation, current generation, locale, and budget.
|
|
598
|
+
*/
|
|
599
|
+
function hydrateDocsContentChanges(options) {
|
|
600
|
+
if (options.changes.audience !== "agent") throw new TypeError("MCP content-change hydration requires the agent audience.");
|
|
601
|
+
if (options.changes.since !== options.since) throw new TypeError("Content-change hydration must use the resolved delta generation.");
|
|
602
|
+
const tokenBudget = resolveDocsHydrationTokenBudget(options.tokenBudget);
|
|
603
|
+
const units = buildDocsHydrationUnits(options.changes, options.pages, tokenBudget);
|
|
604
|
+
const hydrationSnapshot = digestDocsRetrievalContent(JSON.stringify({
|
|
605
|
+
format: DOCS_CONTENT_CHANGE_HYDRATION_FORMAT,
|
|
606
|
+
since: options.since,
|
|
607
|
+
indexGeneration: options.changes.indexGeneration,
|
|
608
|
+
mode: options.changes.mode,
|
|
609
|
+
resetRequired: options.changes.resetRequired,
|
|
610
|
+
units: units.map((unit) => unit.type === "content" ? {
|
|
611
|
+
type: unit.type,
|
|
612
|
+
change: unit.change,
|
|
613
|
+
canonicalUrl: unit.canonicalUrl,
|
|
614
|
+
digest: unit.digest,
|
|
615
|
+
section: unit.section.id,
|
|
616
|
+
sectionDigest: unit.sectionDigest,
|
|
617
|
+
chunk: unit.chunk.index,
|
|
618
|
+
chunkDigest: unit.chunkDigest
|
|
619
|
+
} : {
|
|
620
|
+
type: unit.type,
|
|
621
|
+
canonicalUrl: unit.canonicalUrl,
|
|
622
|
+
digest: unit.digest
|
|
623
|
+
})
|
|
624
|
+
}));
|
|
625
|
+
const paginationOptions = {
|
|
626
|
+
kind: DOCS_CONTENT_CHANGE_HYDRATION_CURSOR_KIND,
|
|
627
|
+
scope: JSON.stringify({
|
|
628
|
+
server: options.cursorScope,
|
|
629
|
+
since: options.since,
|
|
630
|
+
locale: options.changes.locale ?? null,
|
|
631
|
+
tokenBudget
|
|
632
|
+
}),
|
|
633
|
+
snapshot: hydrationSnapshot
|
|
634
|
+
};
|
|
635
|
+
const offset = resolveDocsPaginationOffset(options.cursor, paginationOptions);
|
|
636
|
+
if (options.cursor !== void 0 && offset >= units.length) throw new DocsPaginationCursorError();
|
|
637
|
+
const selected = [];
|
|
638
|
+
let usedUtf8Bytes = 0;
|
|
639
|
+
for (let index = offset; index < units.length && selected.length < DOCS_CONTENT_CHANGE_HYDRATION_PAGE_SIZE; index += 1) {
|
|
640
|
+
const unit = units[index];
|
|
641
|
+
const unitUtf8Bytes = unit.type === "content" ? unit.utf8Bytes : 0;
|
|
642
|
+
if (unitUtf8Bytes > 0 && usedUtf8Bytes + unitUtf8Bytes > tokenBudget) break;
|
|
643
|
+
selected.push(unit);
|
|
644
|
+
usedUtf8Bytes += unitUtf8Bytes;
|
|
645
|
+
}
|
|
646
|
+
const nextOffset = offset + selected.length;
|
|
647
|
+
const hasMore = nextOffset < units.length;
|
|
648
|
+
const nextCursor = hasMore ? createDocsPaginationCursor(nextOffset, paginationOptions) : void 0;
|
|
649
|
+
const content = selected.filter((unit) => unit.type === "content");
|
|
650
|
+
const tombstones = selected.filter((unit) => unit.type === "tombstone");
|
|
651
|
+
return {
|
|
652
|
+
format: DOCS_CONTENT_CHANGE_HYDRATION_FORMAT,
|
|
653
|
+
audience: "agent",
|
|
654
|
+
...options.changes.locale ? { locale: options.changes.locale } : {},
|
|
655
|
+
since: options.since,
|
|
656
|
+
indexGeneration: options.changes.indexGeneration,
|
|
657
|
+
mode: options.changes.mode,
|
|
658
|
+
resetRequired: options.changes.resetRequired,
|
|
659
|
+
documentCount: options.changes.documentCount,
|
|
660
|
+
counts: { ...options.changes.counts },
|
|
661
|
+
budget: {
|
|
662
|
+
requestedTokens: tokenBudget,
|
|
663
|
+
strategy: "utf8-bytes",
|
|
664
|
+
maxUtf8Bytes: tokenBudget,
|
|
665
|
+
usedUtf8Bytes,
|
|
666
|
+
conservativeTokenUpperBound: usedUtf8Bytes,
|
|
667
|
+
remainingUtf8Bytes: Math.max(0, tokenBudget - usedUtf8Bytes)
|
|
668
|
+
},
|
|
669
|
+
resultCount: selected.length,
|
|
670
|
+
total: units.length,
|
|
671
|
+
hasMore,
|
|
672
|
+
...nextCursor ? { nextCursor } : {},
|
|
673
|
+
content,
|
|
674
|
+
tombstones
|
|
675
|
+
};
|
|
676
|
+
}
|
|
677
|
+
|
|
678
|
+
//#endregion
|
|
679
|
+
export { isLocalDocsTelemetryOrigin as C, inferDocsTelemetryAgentSurface as S, resolveDocsTelemetryConfig as T, emitDocsTelemetryAgentSurfaceEvent as _, hydrateDocsContentChanges as a, emitDocsTelemetryProjectEvent as b, hashGeneratedAgentContent as c, serializeGeneratedAgentDocument as d, stripGeneratedAgentProvenance as f, resolveSidebarFolderIndexBehaviorForPath as g, resolveSidebarFolderIndexBehavior as h, MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET as i, normalizeGeneratedAgentContent as l, resolvePageSidebarFolderIndexBehavior as m, DOCS_CONTENT_CHANGE_HYDRATION_FORMAT as n, GENERATED_AGENT_PROVENANCE_MARKER as o, applySidebarFolderIndexBehavior as p, MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET as r, GENERATED_AGENT_PROVENANCE_VERSION as s, DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET as t, parseGeneratedAgentDocument as u, emitDocsTelemetryEvent as v, normalizeDocsTelemetryOrigin as w, getDocsTelemetryFeatures as x, emitDocsTelemetryMcpToolEvent as y };
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { at as DocsAnalyticsEvent, it as DocsAnalyticsConfig, ot as DocsAnalyticsEventInput } from "./types-
|
|
2
|
-
import { n as DocsCloudAskAIResponseOptions, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-
|
|
1
|
+
import { at as DocsAnalyticsEvent, it as DocsAnalyticsConfig, ot as DocsAnalyticsEventInput } from "./types-CoohpxFz.mjs";
|
|
2
|
+
import { n as DocsCloudAskAIResponseOptions, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-AUhHTMe6.mjs";
|
|
3
3
|
|
|
4
4
|
//#region src/docs-cloud-server.d.ts
|
|
5
5
|
type DocsCloudRuntimeValue<T = string> = T | undefined | null | (() => T | undefined | null);
|