@farming-labs/docs 0.2.60 → 0.2.62

package/dist/search-o4Ud6OXv.mjs

@@ -1,102 +0,0 @@
-import "./agent-BFqyqEnC.mjs";
-import { n as buildDocsSearchDocuments, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter } from "./search-D57JXQLj.mjs";
-import "./sitemap-server-C1ibVKOy.mjs";
-import "./agent-evals-kJs2Y9xR.mjs";
-import { createFilesystemDocsMcpSource } from "./mcp.mjs";
-import "./code-blocks-qe0T8-xe.mjs";
-import "./server.mjs";
-import { h as resolveDocsContentDir, m as resolveDocsConfigPath, o as loadProjectEnv, p as readTopLevelStringProperty } from "./config-DASewQ0x.mjs";
-import { readFileSync } from "node:fs";
-import pc from "picocolors";
-
-//#region src/cli/search.ts
-function getEnvValue(loadedEnv, key) {
-	return process.env[key] ?? loadedEnv[key];
-}
-function resolveSearchSyncProvider(options, loadedEnv) {
-	if (options.typesense && options.algolia) throw new Error("Use only one provider flag: --typesense or --algolia.");
-	if (options.typesense) return "typesense";
-	if (options.algolia) return "algolia";
-	if (options.provider === "typesense" || options.provider === "algolia") return options.provider;
-	if (options.provider) throw new Error(`Unsupported search provider: ${options.provider}.`);
-	if (options.baseUrl || getEnvValue(loadedEnv, "TYPESENSE_URL")) return "typesense";
-	if (options.appId || getEnvValue(loadedEnv, "ALGOLIA_APP_ID")) return "algolia";
-	throw new Error("Could not determine a search provider. Use --typesense, --algolia, or --provider <name>.");
-}
-function resolveTypesenseSyncConfig(options, loadedEnv) {
-	const baseUrl = options.baseUrl ?? getEnvValue(loadedEnv, "TYPESENSE_URL") ?? getEnvValue(loadedEnv, "TYPESENSE_BASE_URL");
-	const collection = options.collection ?? getEnvValue(loadedEnv, "TYPESENSE_COLLECTION") ?? "docs";
-	const apiKey = options.apiKey ?? getEnvValue(loadedEnv, "TYPESENSE_SEARCH_API_KEY") ?? getEnvValue(loadedEnv, "TYPESENSE_API_KEY");
-	const adminApiKey = options.adminApiKey ?? getEnvValue(loadedEnv, "TYPESENSE_ADMIN_API_KEY") ?? getEnvValue(loadedEnv, "TYPESENSE_API_KEY");
-	const mode = options.mode === "hybrid" ? "hybrid" : "keyword";
-	const ollamaModel = options.ollamaModel ?? getEnvValue(loadedEnv, "TYPESENSE_OLLAMA_MODEL");
-	const ollamaBaseUrl = options.ollamaBaseUrl ?? getEnvValue(loadedEnv, "TYPESENSE_OLLAMA_BASE_URL");
-	if (!baseUrl) throw new Error("Missing Typesense base URL. Set TYPESENSE_URL or pass --base-url.");
-	if (!apiKey) throw new Error("Missing Typesense API key. Set TYPESENSE_API_KEY or pass --api-key.");
-	if (!adminApiKey) throw new Error("Missing Typesense admin-capable key for sync. Set TYPESENSE_ADMIN_API_KEY or pass --admin-api-key.");
-	return {
-		provider: "typesense",
-		baseUrl,
-		collection,
-		apiKey,
-		adminApiKey,
-		mode,
-		...mode === "hybrid" ? ollamaModel ? { embeddings: {
-			provider: "ollama",
-			model: ollamaModel,
-			baseUrl: ollamaBaseUrl
-		} } : (() => {
-			throw new Error("Typesense hybrid sync needs an embeddings model. Set TYPESENSE_OLLAMA_MODEL or pass --ollama-model.");
-		})() : {}
-	};
-}
-function resolveAlgoliaSyncConfig(options, loadedEnv) {
-	const appId = options.appId ?? getEnvValue(loadedEnv, "ALGOLIA_APP_ID");
-	const indexName = options.indexName ?? getEnvValue(loadedEnv, "ALGOLIA_INDEX_NAME") ?? "docs";
-	const adminApiKey = options.adminApiKey ?? getEnvValue(loadedEnv, "ALGOLIA_ADMIN_API_KEY");
-	const searchApiKey = options.searchApiKey ?? getEnvValue(loadedEnv, "ALGOLIA_SEARCH_API_KEY") ?? adminApiKey;
-	if (!appId) throw new Error("Missing Algolia app id. Set ALGOLIA_APP_ID or pass --app-id.");
-	if (!adminApiKey) throw new Error("Missing Algolia admin API key for sync. Set ALGOLIA_ADMIN_API_KEY or pass --admin-api-key.");
-	if (!searchApiKey) throw new Error("Missing Algolia search API key. Set ALGOLIA_SEARCH_API_KEY or pass --search-api-key.");
-	return {
-		provider: "algolia",
-		appId,
-		indexName,
-		searchApiKey,
-		adminApiKey
-	};
-}
-async function syncSearch(options = {}) {
-	const rootDir = process.cwd();
-	const configContent = readFileSync(resolveDocsConfigPath(rootDir, options.configPath), "utf-8");
-	const loadedEnv = loadProjectEnv(rootDir);
-	const provider = resolveSearchSyncProvider(options, loadedEnv);
-	const entry = readTopLevelStringProperty(configContent, "entry") ?? "docs";
-	const contentDir = resolveDocsContentDir(rootDir, configContent, entry);
-	const source = createFilesystemDocsMcpSource({
-		rootDir,
-		entry,
-		contentDir,
-		siteTitle: "Documentation"
-	});
-	const pages = await source.getPages();
-	const documents = buildDocsSearchDocuments(pages);
-	const context = {
-		pages,
-		documents,
-		siteTitle: source.siteTitle
-	};
-	if (documents.length === 0) throw new Error(`No docs content was found under ${contentDir}.`);
-	if (provider === "typesense") {
-		const config = resolveTypesenseSyncConfig(options, loadedEnv);
-		await createTypesenseSearchAdapter(config).index?.(context);
-		console.log(pc.green(`Synced ${documents.length} docs search documents to Typesense collection "${config.collection}".`));
-		return;
-	}
-	const config = resolveAlgoliaSyncConfig(options, loadedEnv);
-	await createAlgoliaSearchAdapter(config).index?.(context);
-	console.log(pc.green(`Synced ${documents.length} docs search documents to Algolia index "${config.indexName}".`));
-}
-
-//#endregion
-export { syncSearch };

package/dist/server.d.mts

@@ -1,341 +0,0 @@
-import { A as DocsAgentGoldenTaskExpectation, At as DocsReviewRulesConfig, Bt as DocsSearchDocument, Ct as DocsObservabilityConfig, D as DocsAgentGoldenExampleVerification, E as DocsAgentGoldenAnswerExpectation, F as DocsAnalyticsConfig, Ft as DocsSearchAdapter, G as DocsAskAIFeedbackMessage, Gt as DocsSearchSourcePage, Ht as DocsSearchQuery, I as DocsAnalyticsEvent, It as DocsSearchAdapterContext, K as DocsAskAIFeedbackValue, Kt as DocsSitemapConfig, L as DocsAnalyticsEventInput, Lt as DocsSearchAdapterFactory, M as DocsAgentTraceEventInput, N as DocsAgentTraceEventType, O as DocsAgentGoldenExpectedExample, Ot as DocsReviewCiMode, P as DocsAgentTraceStatus, S as DocsAgentEvaluationTaskInput, Tt as DocsObservabilityEventInput, U as DocsAskAIFeedbackConfig, Ut as DocsSearchResult, W as DocsAskAIFeedbackData, _ as DocsAgentEvaluationAnswerRequest, a as ApiReferenceRenderer, b as DocsAgentEvaluationSourceReference, g as DocsAgentEvaluationAnswerProvider, h as DocsAgentEvaluationAnswerInput, it as DocsCodeBlocksValidateConfig, j as DocsAgentGoldenTaskFilters, k as DocsAgentGoldenTask, kt as DocsReviewConfig, ln as McpDocsSearchConfig, q as DocsAskAIMcpConfig, st as DocsConfig, tt as DocsCodeBlocksPlannerProvider, v as DocsAgentEvaluationAnswerResult, wt as DocsObservabilityEvent, x as DocsAgentEvaluationSurface, y as DocsAgentEvaluationAnswerRunner, zt as DocsSearchConfig } from "./types-XHABMh_f.mjs";
-import { i as isDocsCloudAskAIProvider, n as DocsCloudAskAIResponseOptions, r as createDocsCloudAskAIResponse, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-B2WnG4fF.mjs";
-import { DocsCloudAskAIOptions, DocsCloudPublicConfig, DocsCloudRouteHandlerOptions, DocsCloudRouteHandlers, DocsCloudRuntimeEnv, DocsCloudRuntimeValue, DocsCloudServer, DocsCloudServerOptions, DocsCloudTrackEventOptions, createDocsCloudRouteHandler, createDocsCloudServer } from "./docs-cloud-server.mjs";
-import { A as resolveDocsSitemapRequest, B as normalizePromptProviderName, Bt as emitDocsObservabilityEvent, C as buildDocsSitemapManifest, D as renderDocsSitemapXml, E as renderDocsSitemapMarkdown, F as DEFAULT_PROMPT_PROVIDER_TEMPLATES, Ft as ResolvedDocsObservabilityConfig, G as serializeDocsIconRegistry, H as resolvePromptProviderChoices, Ht as resolveDocsAnalyticsConfig, I as PromptAction, It as createDocsAgentTraceContext, K as serializeOpenDocsProvider, L as PromptProviderChoice, Lt as createDocsAgentTraceId, M as DEFAULT_OPEN_DOCS_PROMPT, Mt as DOCS_AGENT_TRACE_EVENT_TYPES, N as DEFAULT_OPEN_DOCS_PROVIDER_IDS, Nt as DocsAgentTraceContext, O as resolveDocsSitemapConfig, P as DEFAULT_OPEN_DOCS_TARGET, Pt as ResolvedDocsAnalyticsConfig, R as SerializeOpenDocsProviderOptions, Rt as emitDocsAgentTraceEvent, S as DocsSitemapResolvedConfig, T as readDocsSitemapManifestFromContentMap, U as sanitizePromptText, Ut as resolveDocsObservabilityConfig, V as parsePromptStringArray, Vt as getDocsRequestAnalyticsProperties, W as serializeDocsIcon, _ as DEFAULT_SITEMAP_XML_ROUTE, a as createMcpSearchAdapter, b as DocsSitemapManifestPage, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, h as DEFAULT_SITEMAP_MD_ROUTE, i as createCustomSearchAdapter, j as toDocsSitemapMarkdownUrl, k as resolveDocsSitemapPageLastmod, l as inferDocsAskAIPackageHints, m as DEFAULT_SITEMAP_MD_DOCS_ROUTE, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, p as DEFAULT_SITEMAP_MANIFEST_PATH, q as serializeOpenDocsProviders, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch, v as DocsSitemapFormat, w as createDocsSitemapResponse, x as DocsSitemapPageInput, y as DocsSitemapManifest, z as SerializedOpenDocsProvider, zt as emitDocsAnalyticsEvent } from "./search-C1JitPwi.mjs";
-import { CreateDocsMcpServerOptions, DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DOCS_CONFIG_SCHEMA_OPTIONS, DocsMcpAgentContractSummary, DocsMcpCodeExample, DocsMcpConfigSchema, DocsMcpConfigSchemaOption, DocsMcpContextResult, DocsMcpContextSource, DocsMcpDocsList, DocsMcpDocsPageSummary, DocsMcpDocsSection, DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpRequestContext, DocsMcpResolvedConfig, DocsMcpResolvedCorsConfig, DocsMcpResolvedSecurityConfig, DocsMcpSource, DocsMcpTaskSummary, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, getDocsConfigSchema, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
-
-//#region src/code-group-mdx.d.ts
-interface MarkdownNode {
-  type: string;
-  name?: string;
-  children?: MarkdownNode[];
-  lang?: string | null;
-  meta?: string | null;
-}
-declare function remarkCodeGroup(): (tree: MarkdownNode) => void;
-//#endregion
-//#region src/api-reference.d.ts
-type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD";
-type ApiReferenceFramework = "next" | "tanstack-start" | "sveltekit" | "astro" | "nuxt";
-interface ApiReferenceRoute {
-  title: string;
-  summary: string;
-  description?: string;
-  routePath: string;
-  sourceFile: string;
-  methods: HttpMethod[];
-  tag: string;
-  parameters: Array<Record<string, unknown>>;
-}
-interface ResolvedApiReferenceConfig {
-  enabled: boolean;
-  path: string;
-  specUrl?: string;
-  renderer?: ApiReferenceRenderer;
-  routeRoot: string;
-  exclude: string[];
-}
-interface ApiReferenceOpenApiDiscovery {
-  enabled: boolean;
-  url?: string;
-  urlSource?: "default" | "configured";
-  source?: "generated" | "configured";
-  specUrl?: string;
-  apiReferencePath?: string;
-}
-interface BuildApiReferenceOptions {
-  framework: ApiReferenceFramework;
-  rootDir?: string;
-  baseUrl?: string;
-}
-interface BuildApiReferenceHtmlOptions extends BuildApiReferenceOptions {
-  title?: string;
-}
-declare const DEFAULT_API_REFERENCE_OPENAPI_ROUTE = "/api/docs?format=openapi";
-declare function resolveApiReferenceConfig(value: DocsConfig["apiReference"]): ResolvedApiReferenceConfig;
-declare function resolveApiReferenceRenderer(value: DocsConfig["apiReference"], framework: ApiReferenceFramework): ApiReferenceRenderer;
-declare function resolveApiReferenceOpenApiDiscovery(value: DocsConfig["apiReference"], options?: {
-  route?: string;
-}): ApiReferenceOpenApiDiscovery;
-declare function isApiReferenceOpenApiRequest(url: URL): boolean;
-declare function buildApiReferencePageTitle(config: DocsConfig, title?: string): string;
-declare function buildApiReferenceScalarCss(config: DocsConfig): string;
-declare function buildApiReferenceOpenApiDocument(config: DocsConfig, options: BuildApiReferenceOptions): Record<string, unknown>;
-declare function buildApiReferenceOpenApiDocumentAsync(config: DocsConfig, options: BuildApiReferenceOptions): Promise<Record<string, unknown>>;
-declare function buildApiReferenceHtmlDocument(config: DocsConfig, options: BuildApiReferenceHtmlOptions): string;
-declare function buildApiReferenceHtmlDocumentAsync(config: DocsConfig, options: BuildApiReferenceHtmlOptions): Promise<string>;
-//#endregion
-//#region src/review.d.ts
-declare const DEFAULT_DOCS_REVIEW_WORKFLOW_PATH = ".github/workflows/docs-review.yml";
-declare const DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD = 80;
-interface ResolvedDocsReviewConfig {
-  enabled: boolean;
-  ci: {
-    enabled: boolean;
-    name: string;
-    mode: DocsReviewCiMode;
-    annotations: boolean;
-    comment: boolean;
-  };
-  score: {
-    threshold: number;
-    weights: {
-      error: number;
-      warn: number;
-      suggestion: number;
-    };
-  };
-  rules: Required<DocsReviewRulesConfig>;
-}
-interface DocsReviewWorkflowOptions {
-  packageManager?: "npm" | "pnpm" | "yarn" | "bun";
-  ciName?: string;
-  reusableWorkflow?: string;
-  pnpmVersion?: string;
-  projectDir?: string;
-  configPath?: string;
-  buildCommand?: string;
-  reviewCommand?: string;
-  pathFilters?: string[];
-}
-interface EnsureDocsReviewWorkflowOptions {
-  rootDir: string;
-  config?: DocsConfig;
-  configPath?: string;
-  configContent?: string;
-  workflowPath?: string;
-  log?: (message: string) => void;
-}
-type EnsureDocsReviewWorkflowResult = {
-  status: "created";
-  path: string;
-  relativePath: string;
-} | {
-  status: "exists";
-  path: string;
-  relativePath: string;
-} | {
-  status: "disabled";
-  path: string;
-  relativePath: string;
-};
-declare function resolveDocsReviewConfig(review?: boolean | DocsReviewConfig): ResolvedDocsReviewConfig;
-declare function buildDocsReviewWorkflow(options?: DocsReviewWorkflowOptions): string;
-declare function ensureDocsReviewWorkflow(options: EnsureDocsReviewWorkflowOptions): EnsureDocsReviewWorkflowResult;
-declare function readDocsReviewConfigFromSource(content?: string): boolean | DocsReviewConfig | undefined;
-declare function buildDocsReviewWorkflowPathFilters(options: {
-  rootDir: string;
-  repoRoot?: string;
-  config?: DocsConfig;
-  configPath?: string;
-  configContent?: string;
-}): string[];
-//#endregion
-//#region src/code-blocks.d.ts
-interface DocsCodeBlockTarget {
-  id: string;
-  filePath: string;
-  relativePath: string;
-  lineStart: number;
-  lineEnd: number;
-  language?: string;
-  title?: string;
-  framework?: string;
-  packageManager?: string;
-  runnable: boolean;
-  env: string[];
-  meta: Record<string, string | boolean>;
-  code: string;
-}
-interface DocsCodeBlockCommand {
-  cmd: string;
-  args: string[];
-}
-interface DocsCodeBlockExecutionPlan {
-  id: string;
-  target: DocsCodeBlockTarget;
-  action: "execute" | "validate-syntax" | "skip";
-  template: string;
-  runtime?: string;
-  filePath?: string;
-  command?: DocsCodeBlockCommand;
-  requiredEnv: string[];
-  reason?: string;
-  planner: DocsCodeBlocksPlannerProvider;
-}
-type DocsCodeBlockValidationStatus = "PLAN" | "PASS" | "SKIP" | "FAIL";
-interface DocsCodeBlockValidationResult {
-  id: string;
-  target: DocsCodeBlockTarget;
-  plan: DocsCodeBlockExecutionPlan;
-  status: DocsCodeBlockValidationStatus;
-  stdout?: string;
-  stderr?: string;
-  exitCode?: number | null;
-  reason?: string;
-}
-type OptionalModuleImporter = (specifier: string) => Promise<unknown>;
-declare global {
-  var __DOCS_CODE_BLOCKS_MODULE_IMPORTER__: OptionalModuleImporter | undefined;
-}
-//#endregion
-//#region src/agent-evals.d.ts
-type DocsGoldenEvaluationStatus = "unmeasured" | "passed" | "failed";
-type DocsGoldenTaskFilters = DocsAgentGoldenTaskFilters;
-type DocsGoldenExpectedExample = DocsAgentGoldenExpectedExample;
-type DocsGoldenTaskExpectation = DocsAgentGoldenTaskExpectation;
-type DocsGoldenTask = DocsAgentGoldenTask;
-interface DocsGoldenRetrievedSource {
-  rank: number;
-  url: string;
-  title: string;
-  framework?: string;
-  version?: string;
-  utf8Bytes: number;
-  relevant: boolean;
-  truncated: boolean;
-}
-interface DocsGoldenRetrievalMetrics {
-  expectedRelevant: number;
-  retrievedRelevant: number;
-  recallAtK: number;
-  firstRelevantRank: number | null;
-  reciprocalRank: number;
-  forbiddenSources: string[];
-  passed: boolean;
-}
-interface DocsGoldenCitationMetrics {
-  /** Where the citation evidence came from. Context/results are not model-answer citations. */
-  evidence: "context" | "results";
-  expected: string[];
-  actual: string[];
-  missing: string[];
-  unexpected: string[];
-  precision: number;
-  recall: number;
-  /** True when every rendered Source line maps one-to-one to a returned source record. */
-  integrity: boolean;
-  passed: boolean;
-}
-interface DocsGoldenSelectionMetrics {
-  requestedFramework?: string;
-  requestedVersion?: string;
-  requestedLocale?: string;
-  expectedFramework?: string;
-  expectedVersion?: string;
-  expectedLocale?: string;
-  firstFrameworkMatchRank: number | null;
-  firstVersionMatchRank: number | null;
-  firstLocaleMatchRank: number | null;
-  conflictingSources: string[];
-  ambiguousSources: string[];
-  passed: boolean;
-}
-interface DocsGoldenExampleResult {
-  expected: DocsGoldenExpectedExample;
-  matchedId?: string;
-  source?: string;
-  verification: "present" | "syntax" | "execute";
-  status: "passed" | "failed" | "skipped";
-  reason?: string;
-  syntaxValid: boolean;
-  executed: boolean;
-  executionStatus?: DocsCodeBlockValidationResult["status"];
-  /** @deprecated Static/planner executability signal retained for report compatibility. */
-  executable: boolean;
-  passed: boolean;
-}
-interface DocsGoldenExampleMetrics {
-  expected: number;
-  matched: number;
-  syntaxValid: number;
-  executed: number;
-  /** @deprecated Count of statically/planner-executable examples retained for compatibility. */
-  executable: number;
-  results: DocsGoldenExampleResult[];
-  passed: boolean;
-}
-interface DocsGoldenUsageMetrics {
-  budgetUnit: "utf8-bytes";
-  tokenBudget: number;
-  usedUtf8Bytes: number;
-  remainingUtf8Bytes: number;
-  estimatedTokens: number;
-  /** Exact conservative upper bound: one token per UTF-8 byte. */
-  conservativeTokenUpperBound: number;
-  usefulUtf8Bytes: number;
-  usefulByteRatio: number;
-  truncated: boolean;
-  withinBudget: boolean;
-  passed: boolean;
-}
-interface DocsGoldenAnswerMetrics {
-  evidence: "answer";
-  expected: boolean;
-  provided: boolean;
-  textIncludesMissing: string[];
-  textExcludesPresent: string[];
-  citations: string[];
-  requiredCitations: string[];
-  missingCitations: string[];
-  unexpectedCitations: string[];
-  forbiddenCitations: string[];
-  passed: boolean;
-}
-interface DocsGoldenTaskReport {
-  id: string;
-  query: string;
-  surface: DocsAgentEvaluationSurface;
-  provider: string;
-  status: "passed" | "failed";
-  passed: boolean;
-  score: number;
-  context: string;
-  sources: DocsGoldenRetrievedSource[];
-  retrieval: DocsGoldenRetrievalMetrics;
-  citations: DocsGoldenCitationMetrics;
-  answer: DocsGoldenAnswerMetrics;
-  selection: DocsGoldenSelectionMetrics;
-  examples: DocsGoldenExampleMetrics;
-  usage: DocsGoldenUsageMetrics;
-  issues: string[];
-}
-interface DocsGoldenTasksReport {
-  status: DocsGoldenEvaluationStatus;
-  passed: boolean | null;
-  score: number | null;
-  taskCount: number;
-  passedTaskCount: number;
-  failedTaskCount: number;
-  tasks: DocsGoldenTaskReport[];
-}
-interface RunDocsGoldenTasksOptions {
-  /** Default evaluation surface. Tasks may override this with `task.surface`. */
-  surface?: DocsAgentEvaluationSurface;
-  /** Search configuration used by configured-search and ask-ai-context. */
-  search?: boolean | DocsSearchConfig;
-  /** Production-resolved Ask AI retrieval config, including `ai.useMcp`. */
-  askAISearch?: boolean | DocsSearchConfig;
-  siteTitle?: string;
-  baseUrl?: string;
-  rootDir?: string;
-  /** Permit external configured search or HTTP answer calls. @default false */
-  allowNetwork?: boolean;
-  /** Per-task configured-search/Ask-AI retrieval timeout in milliseconds. @default 30000 */
-  searchTimeoutMs?: number;
-  /** Project code-block validation config used only by explicit execute expectations. */
-  codeBlocksValidate?: boolean | DocsCodeBlocksValidateConfig;
-  /** Optional actual-answer runner. No model or HTTP request is made when omitted. */
-  answer?: DocsAgentEvaluationAnswerProvider;
-}
-/**
- * Run offline-by-default golden-task evaluations against MCP-ready docs pages.
- * Configured external retrieval, HTTP answers, and runtime execution require explicit opt-in.
- * An empty task list is intentionally unmeasured so CI cannot turn absent coverage into a pass.
- */
-declare function runDocsGoldenTasks(pages: readonly DocsMcpPage[], tasks: readonly DocsGoldenTask[] | undefined, options?: RunDocsGoldenTasksOptions): Promise<DocsGoldenTasksReport>;
-//#endregion
-//#region src/sitemap-server.d.ts
-declare function readDocsSitemapManifest(rootDir: string, sitemap?: boolean | DocsSitemapConfig): DocsSitemapManifest | null;
-//#endregion
-export { type ApiReferenceFramework, type ApiReferenceOpenApiDiscovery, type ApiReferenceRenderer, type ApiReferenceRoute, type CreateDocsMcpServerOptions, DEFAULT_API_REFERENCE_OPENAPI_ROUTE, DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, DEFAULT_OPEN_DOCS_PROMPT, DEFAULT_OPEN_DOCS_PROVIDER_IDS, DEFAULT_OPEN_DOCS_TARGET, DEFAULT_PROMPT_PROVIDER_TEMPLATES, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DOCS_AGENT_TRACE_EVENT_TYPES, DOCS_CONFIG_SCHEMA_OPTIONS, type DocsAgentEvaluationAnswerInput, type DocsAgentEvaluationAnswerProvider, type DocsAgentEvaluationAnswerRequest, type DocsAgentEvaluationAnswerResult, type DocsAgentEvaluationAnswerRunner, type DocsAgentEvaluationSourceReference, type DocsAgentEvaluationSurface, type DocsAgentEvaluationTaskInput, type DocsAgentGoldenAnswerExpectation, type DocsAgentGoldenExampleVerification, type DocsAgentTraceContext, type DocsAgentTraceEventInput, type DocsAgentTraceEventType, type DocsAgentTraceStatus, type DocsAnalyticsConfig, type DocsAnalyticsEvent, type DocsAnalyticsEventInput, type DocsAskAIFeedbackConfig, type DocsAskAIFeedbackData, type DocsAskAIFeedbackMessage, type DocsAskAIFeedbackValue, type DocsAskAIMcpConfig, type DocsCloudAskAIConfig, type DocsCloudAskAIOptions, type DocsCloudAskAIResponseOptions, type DocsCloudPublicConfig, type DocsCloudRouteHandlerOptions, type DocsCloudRouteHandlers, type DocsCloudRuntimeEnv, type DocsCloudRuntimeValue, type DocsCloudServer, type DocsCloudServerOptions, type DocsCloudTrackEventOptions, type DocsGoldenAnswerMetrics, type DocsGoldenCitationMetrics, type DocsGoldenEvaluationStatus, type DocsGoldenExampleMetrics, type DocsGoldenExampleResult, type DocsGoldenExpectedExample, type DocsGoldenRetrievalMetrics, type DocsGoldenRetrievedSource, type DocsGoldenSelectionMetrics, type DocsGoldenTask, type DocsGoldenTaskExpectation, type DocsGoldenTaskFilters, type DocsGoldenTaskReport, type DocsGoldenTasksReport, type DocsGoldenUsageMetrics, type DocsMcpAgentContractSummary, type DocsMcpCodeExample, type DocsMcpConfigSchema, type DocsMcpConfigSchemaOption, type DocsMcpContextResult, type DocsMcpContextSource, type DocsMcpDocsList, type DocsMcpDocsPageSummary, type DocsMcpDocsSection, type DocsMcpHttpHandlers, type DocsMcpNavigationNode, type DocsMcpNavigationTree, type DocsMcpPage, type DocsMcpRequestContext, type DocsMcpResolvedConfig, type DocsMcpResolvedCorsConfig, type DocsMcpResolvedSecurityConfig, type DocsMcpSource, type DocsMcpTaskSummary, type DocsObservabilityConfig, type DocsObservabilityEvent, type DocsObservabilityEventInput, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchQuery, type DocsSearchResult, type DocsSearchSourcePage, type DocsSitemapFormat, type DocsSitemapManifest, type DocsSitemapManifestPage, type DocsSitemapPageInput, type DocsSitemapResolvedConfig, type McpDocsSearchConfig, type PromptAction, type PromptProviderChoice, type ResolvedApiReferenceConfig, type ResolvedDocsAnalyticsConfig, type ResolvedDocsObservabilityConfig, type ResolvedDocsReviewConfig, type RunDocsGoldenTasksOptions, type SerializeOpenDocsProviderOptions, type SerializedOpenDocsProvider, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsAskAIContext, buildDocsReviewWorkflow, buildDocsReviewWorkflowPathFilters, buildDocsSearchDocuments, buildDocsSitemapManifest, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAskAIResponse, createDocsCloudRouteHandler, createDocsCloudServer, createDocsMcpHttpHandler, createDocsMcpServer, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, ensureDocsReviewWorkflow, formatDocsAskAIPackageHints, getDocsConfigSchema, getDocsRequestAnalyticsProperties, inferDocsAskAIPackageHints, isApiReferenceOpenApiRequest, isDocsCloudAskAIProvider, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, readDocsReviewConfigFromSource, readDocsSitemapManifest, readDocsSitemapManifestFromContentMap, remarkCodeGroup, renderDocsSitemapMarkdown, renderDocsSitemapXml, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveAskAISearchRequestConfig, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolveDocsReviewConfig, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsGoldenTasks, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProvider, serializeOpenDocsProviders, toDocsSitemapMarkdownUrl };

package/dist/server.mjs

@@ -1,11 +0,0 @@
-import { a as emitDocsAnalyticsEvent, c as resolveDocsAnalyticsConfig, i as emitDocsAgentTraceEvent, l as resolveDocsObservabilityConfig, n as createDocsAgentTraceContext, o as emitDocsObservabilityEvent, r as createDocsAgentTraceId, s as getDocsRequestAnalyticsProperties, t as DOCS_AGENT_TRACE_EVENT_TYPES } from "./analytics-Bx44lg6d.mjs";
-import { At as DEFAULT_SITEMAP_MD_DOCS_ROUTE, Bt as resolveDocsSitemapPageLastmod, Ft as createDocsSitemapResponse, Ht as toDocsSitemapMarkdownUrl, It as readDocsSitemapManifestFromContentMap, Lt as renderDocsSitemapMarkdown, Mt as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, Nt as DEFAULT_SITEMAP_XML_ROUTE, Pt as buildDocsSitemapManifest, Rt as renderDocsSitemapXml, Vt as resolveDocsSitemapRequest, jt as DEFAULT_SITEMAP_MD_ROUTE, kt as DEFAULT_SITEMAP_MANIFEST_PATH, zt as resolveDocsSitemapConfig } from "./agent-BFqyqEnC.mjs";
-import { a as createMcpSearchAdapter, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, i as createCustomSearchAdapter, l as inferDocsAskAIPackageHints, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch } from "./search-D57JXQLj.mjs";
-import { C as resolveApiReferenceOpenApiDiscovery, S as resolveApiReferenceConfig, T as remarkCodeGroup, _ as buildApiReferenceOpenApiDocument, a as DEFAULT_PROMPT_PROVIDER_TEMPLATES, b as buildApiReferenceScalarCss, c as resolvePromptProviderChoices, d as serializeDocsIconRegistry, f as serializeOpenDocsProvider, g as buildApiReferenceHtmlDocumentAsync, h as buildApiReferenceHtmlDocument, i as DEFAULT_OPEN_DOCS_TARGET, l as sanitizePromptText, m as DEFAULT_API_REFERENCE_OPENAPI_ROUTE, n as DEFAULT_OPEN_DOCS_PROMPT, o as normalizePromptProviderName, p as serializeOpenDocsProviders, r as DEFAULT_OPEN_DOCS_PROVIDER_IDS, s as parsePromptStringArray, t as readDocsSitemapManifest, u as serializeDocsIcon, v as buildApiReferenceOpenApiDocumentAsync, w as resolveApiReferenceRenderer, x as isApiReferenceOpenApiRequest, y as buildApiReferencePageTitle } from "./sitemap-server-C1ibVKOy.mjs";
-import { a as buildDocsReviewWorkflowPathFilters, c as resolveDocsReviewConfig, i as buildDocsReviewWorkflow, n as DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, o as ensureDocsReviewWorkflow, r as DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-kJs2Y9xR.mjs";
-import { DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DOCS_CONFIG_SCHEMA_OPTIONS, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, getDocsConfigSchema, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
-import { n as isDocsCloudAskAIProvider, t as createDocsCloudAskAIResponse } from "./cloud-ask-ai-hnJfj8-X.mjs";
-import { createDocsCloudRouteHandler, createDocsCloudServer } from "./docs-cloud-server.mjs";
-import "./code-blocks-qe0T8-xe.mjs";
-
-export { DEFAULT_API_REFERENCE_OPENAPI_ROUTE, DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, DEFAULT_OPEN_DOCS_PROMPT, DEFAULT_OPEN_DOCS_PROVIDER_IDS, DEFAULT_OPEN_DOCS_TARGET, DEFAULT_PROMPT_PROVIDER_TEMPLATES, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DOCS_AGENT_TRACE_EVENT_TYPES, DOCS_CONFIG_SCHEMA_OPTIONS, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsAskAIContext, buildDocsReviewWorkflow, buildDocsReviewWorkflowPathFilters, buildDocsSearchDocuments, buildDocsSitemapManifest, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAskAIResponse, createDocsCloudRouteHandler, createDocsCloudServer, createDocsMcpHttpHandler, createDocsMcpServer, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, ensureDocsReviewWorkflow, formatDocsAskAIPackageHints, getDocsConfigSchema, getDocsRequestAnalyticsProperties, inferDocsAskAIPackageHints, isApiReferenceOpenApiRequest, isDocsCloudAskAIProvider, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, readDocsReviewConfigFromSource, readDocsSitemapManifest, readDocsSitemapManifestFromContentMap, remarkCodeGroup, renderDocsSitemapMarkdown, renderDocsSitemapXml, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveAskAISearchRequestConfig, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolveDocsReviewConfig, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsGoldenTasks, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProvider, serializeOpenDocsProviders, toDocsSitemapMarkdownUrl };