@farming-labs/docs 0.2.83 → 0.2.85

package/dist/{agent-WS4GXGh6.d.mts → agent-2MWvWpJf.d.mts}

@@ -1,5 +1,5 @@
-import { $n as LlmsTxtConfig, An as DocsSearchFilterInput, Bn as DocsSitemapConfig, Cn as DocsSearchConfig, F as DocsAgentContentChangesConfig, Fn as DocsSearchResult, K as DocsAgentFeedbackData, Ln as DocsSearchSourcePage, Mt as DocsConfig, Nn as DocsSearchRequest, On as DocsSearchFacetsResponse, Pr as TypesenseDocsSearchConfig, Rt as DocsContentChangesResponse, Sn as DocsSearchChunkingConfig, Ut as DocsI18nConfig, Yn as FeedbackConfig, Yt as DocsMcpConfig, bn as DocsSearchAdapterFactory, er as LlmsTxtMaxCharsConfig, f as CustomDocsSearchConfig, gn as DocsRobotsConfig, gr as PageAgentFrontmatter, jn as DocsSearchFilters, kn as DocsSearchFilterField, nr as LlmsTxtSectionConfig, on as DocsPaginatedSearchResponse, r as AlgoliaDocsSearchConfig, rr as McpDocsSearchConfig, tr as LlmsTxtMaxCharsMode, vn as DocsSearchAdapter, vt as DocsAskAIMcpConfig, wn as DocsSearchDocument, wr as ResolvedDocsRelatedLink, zt as DocsContentSnapshot } from "./types-lGEHcx_6.mjs";
-import { O as DocsA2AAgentCardOptions, R as DocsDiscoveryApiRouteOptions, z as DocsPublishedAgentSkill } from "./standards-discovery-DPUEcUmb.mjs";
+import { Dn as DocsSearchDocument, Dr as PageAgentFrontmatter, En as DocsSearchConfig, F as DocsAgentContentChangesConfig, Fn as DocsSearchFilterField, Fr as ResolvedDocsRelatedLink, Gr as TypesenseDocsSearchConfig, In as DocsSearchFilterInput, Jn as DocsSearchSourcePage, K as DocsAgentFeedbackData, Kn as DocsSearchResult, Ln as DocsSearchFilters, Mn as DocsSearchFacetsResponse, Mt as DocsConfig, Rt as DocsContentChangesResponse, Tn as DocsSearchChunkingConfig, Ut as DocsI18nConfig, Wn as DocsSearchRequest, Yt as DocsMcpConfig, Zn as DocsSitemapConfig, bn as DocsSearchAdapterFactory, dr as LlmsTxtMaxCharsConfig, f as CustomDocsSearchConfig, fr as LlmsTxtMaxCharsMode, gn as DocsRobotsConfig, mr as McpDocsSearchConfig, on as DocsPaginatedSearchResponse, or as FeedbackConfig, pr as LlmsTxtSectionConfig, r as AlgoliaDocsSearchConfig, ur as LlmsTxtConfig, vn as DocsSearchAdapter, vt as DocsAskAIMcpConfig, zt as DocsContentSnapshot } from "./types-DQl2dvDl.mjs";
+import { O as DocsA2AAgentCardOptions, R as DocsDiscoveryApiRouteOptions, z as DocsPublishedAgentSkill } from "./standards-discovery-CthpcXx2.mjs";
 import { DocsMcpPage, DocsMcpResolvedConfig } from "./mcp.mjs";
 
 //#region src/i18n.d.ts
@@ -197,6 +197,8 @@ interface PerformDocsSearchOptions {
   cursor?: string;
   /** Optional framework, version, package, and tag constraints. */
   filters?: DocsSearchFilterInput;
+  /** Include bounded explanations for the final ranked results. Defaults to false. */
+  explain?: boolean;
   /**
    * Controls provider failures. Runtime search keeps the resilient `fallback` default;
    * diagnostics can request `throw` so a broken configured provider cannot be scored as
@@ -529,6 +531,7 @@ interface DocsDiagnosticsFeature {
   routes?: Record<string, string | null>;
   agentEndpoint?: string | null;
   structuredAgentEndpoint?: string | null;
+  explainedAgentEndpoint?: string | null;
   facetsEndpoint?: string | null;
   audienceParam?: string;
   defaultAudience?: "human" | "agent";
@@ -540,6 +543,10 @@ interface DocsDiagnosticsFeature {
     tags: "tags";
   };
   responseFormat?: "docs-search.v1";
+  explainParam?: "explain";
+  explainValue?: "true";
+  explanationField?: "explanation";
+  explanationFormat?: "docs-search-explanation.v1";
   facetsResponseFormat?: "docs-search-facets.v1";
   format?: string;
   sinceParam?: string;
@@ -730,6 +737,8 @@ interface DocsStandardsDiscoveryResponseOptions extends DocsAgentDiscoverySpecOp
   request: Request;
   preferredSkillDocument?: string | null;
   fallbackSkillDocument: string;
+  /** Stable representation generation or source modification time. */
+  lastModified?: string | Date | null;
 }
 interface DocsAgentContractMcpTools {
   list?: "list_tasks";
@@ -911,7 +920,8 @@ declare function createDocsStandardsDiscoveryResponse({
   openapi,
   markdown: _markdown,
   publishedSkills,
-  agentCard
+  agentCard,
+  lastModified
 }: DocsStandardsDiscoveryResponseOptions): Promise<Response | null>;
 declare function isDocsAgentDiscoveryRequest(url: URL, options?: DocsDiscoveryApiRouteOptions): boolean;
 declare function buildDocsMcpEndpointCandidates(baseUrl: string, routes?: readonly string[], options?: DocsMcpEndpointCandidateOptions): DocsMcpEndpointCandidate[];
@@ -1162,6 +1172,7 @@ declare function buildDocsAgentDiscoverySpec({
     endpoint: string;
     agentEndpoint: string;
     structuredAgentEndpoint: string;
+    explainedAgentEndpoint: string;
     facetsEndpoint: string;
     method: string;
     queryParam: string;
@@ -1173,6 +1184,10 @@ declare function buildDocsAgentDiscoverySpec({
     structuredResponseValue: string;
     facetsResponseValue: string;
     responseFormat: string;
+    explainParam: string;
+    explainValue: string;
+    explanationField: string;
+    explanationFormat: string;
     facetsResponseFormat: string;
     filterParams: {
       framework: string;