@farming-labs/docs 0.2.83 → 0.2.85
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-WS4GXGh6.d.mts → agent-2MWvWpJf.d.mts} +18 -3
- package/dist/{agent-Dze2Cy5B.mjs → agent-CTOUI2BK.mjs} +338 -296
- package/dist/{agent-Biyd8A98.mjs → agent-FyPQ2AZ4.mjs} +2 -2
- package/dist/{agent-evals-Burrzyam.mjs → agent-evals-DCptRrdP.mjs} +2 -2
- package/dist/{agent-export-whKAZQUI.mjs → agent-export-Di1Ofstb.mjs} +41 -25
- package/dist/agent-skills-bundle.d.mts +1 -1
- package/dist/{agent-skills-server-D5qYU19g.mjs → agent-skills-server-CwmzAzf_.mjs} +1 -1
- package/dist/{agent-skills-server-q4B9kRGg.d.mts → agent-skills-server-DNtmvTkv.d.mts} +2 -2
- package/dist/agent-skills-vite.d.mts +3 -3
- package/dist/agent-skills-vite.mjs +2 -2
- package/dist/{agents-B_980VCs.mjs → agents-DjUz5voa.mjs} +6 -6
- package/dist/cli/index.mjs +14 -14
- package/dist/client/react.d.mts +1 -1
- package/dist/{cloud-ask-ai-BQAeHkpZ.d.mts → cloud-ask-ai-Bx-qtqHL.d.mts} +1 -1
- package/dist/{content-change-hydration-DpQ0KdAD.mjs → content-change-hydration-DLBinuFR.mjs} +2 -1
- package/dist/docs-cloud-server.d.mts +2 -2
- package/dist/{doctor-WjuyRWYT.mjs → doctor-BPx6iAzQ.mjs} +10 -10
- package/dist/{golden-evaluations-B2GHnoFa.mjs → golden-evaluations-CQuiglEv.mjs} +8 -2
- package/dist/index.d.mts +29 -5
- package/dist/index.mjs +6 -6
- package/dist/{mcp-bhIsgqxy.mjs → mcp-lSrFDtwr.mjs} +6 -6
- package/dist/mcp.d.mts +3 -3
- package/dist/mcp.mjs +96 -6
- package/dist/{prompt-references-embiJdYt.mjs → prompt-references-B6gxePm8.mjs} +3 -3
- package/dist/{retrieval-digest-DRRHA1B3.d.mts → retrieval-digest-CfNbL70a.d.mts} +10 -7
- package/dist/{review-2e4TXoGS.mjs → review-CG2UApoQ.mjs} +6 -6
- package/dist/{robots-BIySk2gE.mjs → robots-BsOTGWiY.mjs} +3 -3
- package/dist/{robots-D96X6eVX.mjs → robots-DaU38DZw.mjs} +2 -2
- package/dist/{search-DfB3LQ4s.mjs → search-DEz_28y1.mjs} +6 -6
- package/dist/server.d.mts +6 -6
- package/dist/server.mjs +6 -6
- package/dist/{sitemap-server-BefXEox6.mjs → sitemap-server-Ds5z4WQB.mjs} +1 -1
- package/dist/{sitemap-AcwP8jIo.mjs → sitemap-vQbO76Vo.mjs} +6 -6
- package/dist/{standards-discovery-BKlEnK_H.mjs → standards-discovery-Ckx0tN7B.mjs} +342 -41
- package/dist/{standards-discovery-DPUEcUmb.d.mts → standards-discovery-CthpcXx2.d.mts} +5 -2
- package/dist/{types-lGEHcx_6.d.mts → types-DQl2dvDl.d.mts} +66 -1
- package/package.json +1 -1
|
@@ -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-
|
|
1
|
+
import { A as DocsAgentA2ASecurityScheme, M as DocsAgentA2ASkill, O as DocsAgentA2AProtocolBinding, h as DocsAgentA2AConfig, k as DocsAgentA2ASecurityRequirement, m as DocsAgentA2ACapabilities } from "./types-DQl2dvDl.mjs";
|
|
2
2
|
|
|
3
3
|
//#region src/standards-discovery.d.ts
|
|
4
4
|
declare const DEFAULT_API_CATALOG_ROUTE = "/.well-known/api-catalog";
|
|
@@ -200,6 +200,8 @@ interface CreateDocsStandardsResponseOptions {
|
|
|
200
200
|
publishedSkills?: readonly DocsPublishedAgentSkill[];
|
|
201
201
|
/** Identity used to publish the optional A2A Agent Card. */
|
|
202
202
|
agentCard?: DocsA2AAgentCardOptions;
|
|
203
|
+
/** Stable representation generation or source modification time. */
|
|
204
|
+
lastModified?: string | Date | null;
|
|
203
205
|
}
|
|
204
206
|
/** Resolve the same-origin Docs API pathname used by query-form discovery routes. */
|
|
205
207
|
declare function resolveDocsDiscoveryApiRoute(apiRoute?: string): string;
|
|
@@ -242,7 +244,8 @@ declare function createDocsStandardsResponse({
|
|
|
242
244
|
preferredSkillDocument,
|
|
243
245
|
fallbackSkillDocument,
|
|
244
246
|
publishedSkills,
|
|
245
|
-
agentCard
|
|
247
|
+
agentCard,
|
|
248
|
+
lastModified
|
|
246
249
|
}: CreateDocsStandardsResponseOptions): Promise<Response | null>;
|
|
247
250
|
//#endregion
|
|
248
251
|
export { resolveDocsDiscoveryApiRoute as $, DocsAgentSkillIndexEntry as A, DocsPublishedAgentSkillFile as B, DOCS_AGENT_MANIFEST_FORMAT as C, DocsA2AAgentCard as D, DOCS_AGENT_MANIFEST_VERSION as E, DocsApiCatalogLinkTarget as F, buildDocsA2AAgentCard as G, DocsStandardsDiscoveryRequest as H, DocsApiCatalogOpenApiDefinition as I, buildDocsLegacySkillsIndex as J, buildDocsAgentSkillsIndex as K, DocsApiCatalogOptions as L, DocsApiCatalog as M, DocsApiCatalogApiTarget as N, DocsA2AAgentCardOptions as O, DocsApiCatalogLinkContext as P, isDocsStandardsDiscoveryRequest as Q, DocsDiscoveryApiRouteOptions as R, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX as S, DOCS_AGENT_MANIFEST_SCHEMA_URI as T, DocsStandardsDiscoveryRouteOptions as U, DocsPublishedAgentSkillOptions as V, appendDocsDiscoveryLinkHeader as W, getDocsAgentManifestLinkHeader as X, createDocsStandardsResponse as Y, getDocsDiscoveryLinkHeader as Z, DEFAULT_AGENT_SKILL_RESOURCE_FORMAT as _, DEFAULT_A2A_AGENT_CARD_FORMAT as a, DEFAULT_LEGACY_SKILLS_INDEX_FORMAT as b, DEFAULT_A2A_PROTOCOL_VERSION as c, DEFAULT_AGENT_SKILLS_INDEX_ROUTE as d, resolveDocsPublishedAgentSkill as et, DEFAULT_AGENT_SKILLS_ROUTE_PATTERN as f, DEFAULT_AGENT_SKILL_FORMAT as g, DEFAULT_AGENT_SKILL_FILE_FORMAT as h, CreateDocsStandardsResponseOptions as i, DocsAgentSkillsIndex as j, DocsA2AAgentInterface as k, DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN as l, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT as m, API_CATALOG_MEDIA_TYPE as n, sha256DocsDiscoveryContent as nt, DEFAULT_A2A_AGENT_CARD_ROUTE as o, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX as p, buildDocsApiCatalog as q, API_CATALOG_PROFILE_URI as r, DEFAULT_A2A_PROTOCOL_BINDING as s, AGENT_SKILLS_DISCOVERY_SCHEMA_URI as t, resolveDocsStandardsDiscoveryRequest as tt, DEFAULT_AGENT_SKILLS_INDEX_FORMAT as u, DEFAULT_API_CATALOG_FORMAT as v, DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE as w, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE as x, DEFAULT_API_CATALOG_ROUTE as y, DocsPublishedAgentSkill as z };
|
|
@@ -1467,6 +1467,65 @@ interface DocsSearchDocument {
|
|
|
1467
1467
|
/** Source metadata persisted with hosted search records. */
|
|
1468
1468
|
source?: DocsRetrievalSourceProvenance;
|
|
1469
1469
|
}
|
|
1470
|
+
/** Search fields that can contribute lexical evidence for one result. */
|
|
1471
|
+
type DocsSearchMatchField = "title" | "section" | "description" | "content" | "url";
|
|
1472
|
+
/** One normalized query term and the result fields in which it was found. */
|
|
1473
|
+
interface DocsSearchMatchedTerm {
|
|
1474
|
+
term: string;
|
|
1475
|
+
fields: DocsSearchMatchField[];
|
|
1476
|
+
}
|
|
1477
|
+
type DocsSearchFilterDecisionOutcome = "not_requested" | "matched" | "not_verifiable";
|
|
1478
|
+
/** How one scope filter affected an included result. */
|
|
1479
|
+
interface DocsSearchFilterDecision {
|
|
1480
|
+
field: DocsSearchFilterField;
|
|
1481
|
+
requestedValues: string[];
|
|
1482
|
+
selectedValues: string[];
|
|
1483
|
+
matchedValues: string[];
|
|
1484
|
+
outcome: DocsSearchFilterDecisionOutcome;
|
|
1485
|
+
}
|
|
1486
|
+
type DocsSearchAmbiguityDecisionStatus = "unambiguous" | "resolved_by_filter" | "requires_filter" | "not_verifiable";
|
|
1487
|
+
/** How one ambiguity-prone scope field was resolved for the result set. */
|
|
1488
|
+
interface DocsSearchAmbiguityDecision {
|
|
1489
|
+
field: Exclude<DocsSearchFilterField, "tags">;
|
|
1490
|
+
status: DocsSearchAmbiguityDecisionStatus;
|
|
1491
|
+
selectedValues: string[];
|
|
1492
|
+
candidateValues?: string[];
|
|
1493
|
+
reason: string;
|
|
1494
|
+
}
|
|
1495
|
+
/** Summary of scope ambiguity after applying the requested filters. */
|
|
1496
|
+
interface DocsSearchAmbiguityResolution {
|
|
1497
|
+
status: "unambiguous" | "resolved" | "unresolved" | "not_verifiable";
|
|
1498
|
+
decisions: DocsSearchAmbiguityDecision[];
|
|
1499
|
+
}
|
|
1500
|
+
type DocsSearchRankingStrategy = "lexical" | "exact" | "provider";
|
|
1501
|
+
type DocsSearchRankingReasonCode = "literal_match" | "title_phrase" | "section_phrase" | "title_section_phrase" | "url_phrase" | "description_phrase" | "content_phrase" | "title_terms" | "section_terms" | "description_terms" | "content_terms" | "all_terms_in_section" | "all_terms_in_title" | "all_query_terms" | "heading_boost" | "exact_page_boost" | "provider_order" | "literal_result_priority" | "stable_url_tiebreak";
|
|
1502
|
+
/** One deterministic reason that contributed to, or controlled, final result ordering. */
|
|
1503
|
+
interface DocsSearchRankingReason {
|
|
1504
|
+
code: DocsSearchRankingReasonCode;
|
|
1505
|
+
description: string;
|
|
1506
|
+
/** Numeric contribution to the built-in lexical score, when applicable. */
|
|
1507
|
+
contribution?: number;
|
|
1508
|
+
}
|
|
1509
|
+
/**
|
|
1510
|
+
* Optional, bounded explanation generated after final ranking and provenance validation.
|
|
1511
|
+
*
|
|
1512
|
+
* Explanations describe the result that was actually returned. Provider ordering is
|
|
1513
|
+
* identified explicitly rather than being presented as a framework-computed lexical score.
|
|
1514
|
+
*/
|
|
1515
|
+
interface DocsSearchExplanation {
|
|
1516
|
+
format: "docs-search-explanation.v1";
|
|
1517
|
+
/** One-based rank in the complete cursor-bound result set. */
|
|
1518
|
+
rank: number;
|
|
1519
|
+
rankingStrategy: DocsSearchRankingStrategy;
|
|
1520
|
+
matchedTerms: DocsSearchMatchedTerm[];
|
|
1521
|
+
/** Whether additional terms or term characters were omitted from this bounded payload. */
|
|
1522
|
+
matchedTermsTruncated: boolean;
|
|
1523
|
+
/** Final selected provenance scope, or null when a remote provider did not supply one. */
|
|
1524
|
+
selectedScope: DocsRetrievalSourceScope | null;
|
|
1525
|
+
filterDecisions: DocsSearchFilterDecision[];
|
|
1526
|
+
ambiguityResolution: DocsSearchAmbiguityResolution;
|
|
1527
|
+
rankingReasons: DocsSearchRankingReason[];
|
|
1528
|
+
}
|
|
1470
1529
|
interface DocsSearchResult {
|
|
1471
1530
|
id: string;
|
|
1472
1531
|
url: string;
|
|
@@ -1477,6 +1536,8 @@ interface DocsSearchResult {
|
|
|
1477
1536
|
section?: string;
|
|
1478
1537
|
/** Canonical, scope-aware provenance when supplied or recoverable locally. */
|
|
1479
1538
|
source?: DocsRetrievalSourceProvenance;
|
|
1539
|
+
/** Present only when the caller opts into retrieval explanations. */
|
|
1540
|
+
explanation?: DocsSearchExplanation;
|
|
1480
1541
|
}
|
|
1481
1542
|
type DocsSearchFilterField = "framework" | "version" | "package" | "tags";
|
|
1482
1543
|
interface DocsSearchFilterInput {
|
|
@@ -1576,6 +1637,8 @@ interface DocsPaginatedSearchResponse extends DocsSearchResponse {
|
|
|
1576
1637
|
interface DocsSearchRequest {
|
|
1577
1638
|
filters: DocsSearchFilters;
|
|
1578
1639
|
structured: boolean;
|
|
1640
|
+
/** Whether search results should include bounded retrieval explanations. */
|
|
1641
|
+
explain?: boolean;
|
|
1579
1642
|
/** Whether the caller requested the body-free search facet response. */
|
|
1580
1643
|
facets?: boolean;
|
|
1581
1644
|
/** Facet field selected for cursor continuation. */
|
|
@@ -1598,6 +1661,8 @@ interface DocsSearchQuery {
|
|
|
1598
1661
|
audience?: "human" | "agent";
|
|
1599
1662
|
/** Normalized framework, version, package, and tag constraints. */
|
|
1600
1663
|
filters?: DocsSearchFilters;
|
|
1664
|
+
/** Whether the shared pipeline should explain the final ranked results. */
|
|
1665
|
+
explain?: boolean;
|
|
1601
1666
|
}
|
|
1602
1667
|
interface DocsSearchAdapterContext {
|
|
1603
1668
|
pages: DocsSearchSourcePage[];
|
|
@@ -3851,4 +3916,4 @@ interface DocsConfig {
|
|
|
3851
3916
|
og?: OGConfig;
|
|
3852
3917
|
}
|
|
3853
3918
|
//#endregion
|
|
3854
|
-
export { DocsAgentSkillsCompatibilityPolicy as $,
|
|
3919
|
+
export { DocsAgentSkillsCompatibilityPolicy as $, DocsTelemetryConfig as $n, DocsMcpSecurityConfig as $t, DocsAgentA2ASecurityScheme as A, DocsSearchFacet as An, PageOpenGraph as Ar, DocsCodeBlocksValidationMode as At, DocsAgentEvaluationAnswerRunner as B, DocsSearchQuery as Bn, SidebarNode as Br, DocsContentSnapshotDocument as Bt, DocsAgentA2AOAuthDeviceCodeFlow as C, DocsSearchAmbiguityDecisionStatus as Cn, PageActionsConfig as Cr, DocsCloudPublishConfig as Ct, DocsAgentA2AOpenIdConnectSecurityScheme as D, DocsSearchDocument as Dn, PageAgentFrontmatter as Dr, DocsCodeBlocksRunnerConfig as Dt, DocsAgentA2AOAuthPasswordFlow as E, DocsSearchConfig as En, PageAgentFailureMode as Er, DocsCodeBlocksPlannerProvider as Et, DocsAgentContentChangesConfig as F, DocsSearchFilterField as Fn, ResolvedDocsRelatedLink as Fr, DocsContentChangeSnapshotLoader as Ft, DocsAgentFeedbackContext as G, DocsSearchResponse as Gn, TypesenseDocsSearchConfig as Gr, DocsMcpAuthPrincipal as Gt, DocsAgentEvaluationSurface as H, DocsSearchRankingReasonCode as Hn, SidebarTree as Hr, DocsFeedbackValue as Ht, DocsAgentEvaluationAnswerInput as I, DocsSearchFilterInput as In, SidebarComponentProps as Ir, DocsContentChangeSnapshotSaver as It, DocsAgentGoldenExampleVerification as J, DocsSearchSourcePage as Jn, DocsMcpAuthenticateResult as Jt, DocsAgentFeedbackData as K, DocsSearchResult as Kn, TypographyConfig as Kr, DocsMcpAuthenticate as Kt, DocsAgentEvaluationAnswerProvider as L, DocsSearchFilters as Ln, SidebarConfig as Lr, DocsContentChangedDocument as Lt, DocsAgentA2ASkill as M, DocsSearchFacetsResponse as Mn, PageTwitter as Mr, DocsConfig as Mt, DocsAgentCompactConfig as N, DocsSearchFilterDecision as Nn, ReadingTimeConfig as Nr, DocsContentChangeDocument as Nt, DocsAgentA2AProtocolBinding as O, DocsSearchEmbeddingsConfig as On, PageAgentVerification as Or, DocsCodeBlocksRunnerProvider as Ot, DocsAgentConfig as P, DocsSearchFilterDecisionOutcome as Pn, ReadingTimeFormat as Pr, DocsContentChangeSnapshotContext as Pt, DocsAgentGoldenTaskFilters as Q, DocsTelemetryAgentSurface as Qn, DocsMcpProtectedResourceConfig as Qt, DocsAgentEvaluationAnswerRequest as R, DocsSearchMatchField as Rn, SidebarFolderIndexBehavior as Rr, DocsContentChangesResponse as Rt, DocsAgentA2AOAuthClientCredentialsFlow as S, DocsSearchAmbiguityDecision as Sn, OrderingItem as Sr, DocsCloudPreviewConfig as St, DocsAgentA2AOAuthImplicitFlow as T, DocsSearchChunkingConfig as Tn, PageAgentCommand as Tr, DocsCodeBlocksPlannerConfig as Tt, DocsAgentEvaluationTaskInput as U, DocsSearchRankingStrategy as Un, SimpleDocsSearchConfig as Ur, DocsI18nConfig as Ut, DocsAgentEvaluationSourceReference as V, DocsSearchRankingReason as Vn, SidebarPageNode as Vr, DocsFeedbackData as Vt, DocsAgentEvaluationsConfig as W, DocsSearchRequest as Wn, ThemeToggleConfig as Wr, DocsMcpAllowedOrigins as Wt, DocsAgentGoldenTask as X, DocsSearchWarningCode as Xn, DocsMcpCorsConfig as Xt, DocsAgentGoldenExpectedExample as Y, DocsSearchWarning as Yn, DocsMcpConfig as Yt, DocsAgentGoldenTaskExpectation as Z, DocsSitemapConfig as Zn, DocsMcpOriginContext as Zt, DocsAgentA2AHttpAuthSecurityScheme as _, DocsRobotsRule as _n, OpenDocsProvider as _r, DocsAskAIFeedbackValue as _t, ApiReferenceRenderer as a, DocsObservabilityEventInput as an, DocsTheme as ar, DocsAgentTraceStatus as at, DocsAgentA2AOAuth2SecurityScheme as b, DocsSearchAdapterFactory as bn, OpenDocsTarget as br, DocsCloudConfig as bt, ChangelogFrontmatter as c, DocsRetrievalSourceProvenance as cn, GithubConfig as cr, DocsAnalyticsEventInput as ct, CopyMarkdownFormat as d, DocsReviewCiMode as dn, LlmsTxtMaxCharsConfig as dr, DocsAnalyticsSource as dt, DocsMcpToolsConfig as en, DocsTelemetryEvent as er, DocsAgentSkillsConfig as et, CustomDocsSearchConfig as f, DocsReviewConfig as fn, LlmsTxtMaxCharsMode as fr, DocsAskAIActionData as ft, DocsAgentA2AExtension as g, DocsRobotsConfig as gn, OpenDocsConfig as gr, DocsAskAIFeedbackMessage as gt, DocsAgentA2AConfig as h, DocsReviewSeverity as hn, OGConfig as hr, DocsAskAIFeedbackData as ht, ApiReferenceConfig as i, DocsObservabilityEvent as in, DocsTelemetryFramework as ir, DocsAgentTraceEventType as it, DocsAgentA2ASecurityScopeList as j, DocsSearchFacetValue as jn, PageSidebarFrontmatter as jr, DocsCodeBlocksValidationPolicy as jt, DocsAgentA2ASecurityRequirement as k, DocsSearchExplanation as kn, PageFrontmatter as kr, DocsCodeBlocksValidateConfig as kt, CodeBlockCopyData as l, DocsRetrievalSourceScope as ln, LastUpdatedConfig as lr, DocsAnalyticsEventType as lt, DocsAgentA2ACapabilities as m, DocsReviewScoreConfig as mn, McpDocsSearchConfig as mr, DocsAskAIFeedbackConfig as mt, AgentFeedbackConfig as n, DocsNav as nn, DocsTelemetryEventType as nr, DocsAgentSkillsProgressiveDisclosureConfig as nt, BreadcrumbConfig as o, DocsPaginatedSearchResponse as on, FeedbackConfig as or, DocsAnalyticsConfig as ot, DocsAgentA2AApiKeySecurityScheme as p, DocsReviewRulesConfig as pn, LlmsTxtSectionConfig as pr, DocsAskAIActionType as pt, DocsAgentGoldenAnswerExpectation as q, DocsSearchResultType as qn, UIConfig as qr, DocsMcpAuthenticateContext as qt, AlgoliaDocsSearchConfig as r, DocsObservabilityConfig as rn, DocsTelemetryFeatures as rr, DocsAgentTraceEventInput as rt, ChangelogConfig as s, DocsRelatedItem as sn, FontStyle as sr, DocsAnalyticsEvent as st, AIConfig as t, DocsMetadata as tn, DocsTelemetryEventInput as tr, DocsAgentSkillsInput as tt, CopyMarkdownConfig as u, DocsReviewCiConfig as un, LlmsTxtConfig as ur, DocsAnalyticsInput as ut, DocsAgentA2AInterfaceConfig as v, DocsSearchAdapter as vn, OpenDocsProviderConfig as vr, DocsAskAIMcpConfig as vt, DocsAgentA2AOAuthFlows as w, DocsSearchAmbiguityResolution as wn, PageAgentAppliesTo as wr, DocsCodeBlocksConfig as wt, DocsAgentA2AOAuthAuthorizationCodeFlow as x, DocsSearchAdapterPage as xn, OpenGraphImage as xr, DocsCloudFeatureConfig as xt, DocsAgentA2AMutualTlsSecurityScheme as y, DocsSearchAdapterContext as yn, OpenDocsProviderId as yr, DocsCloudApiKeyConfig as yt, DocsAgentEvaluationAnswerResult as z, DocsSearchMatchedTerm as zn, SidebarFolderNode as zr, DocsContentSnapshot as zt };
|