@farming-labs/docs 0.1.122 → 0.1.124

package/dist/{sitemap-CnqcTdQg.mjs → sitemap-CMNj0Pt3.mjs}

@@ -1,6 +1,7 @@
 //#region src/sitemap.ts
 const DEFAULT_SITEMAP_XML_ROUTE = "/sitemap.xml";
 const DEFAULT_SITEMAP_MD_ROUTE = "/sitemap.md";
+const DEFAULT_SITEMAP_MD_DOCS_ROUTE = "/docs/sitemap.md";
 const DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE = "/.well-known/sitemap.md";
 const DEFAULT_SITEMAP_MANIFEST_PATH = ".farming-labs/sitemap-manifest.json";
 function normalizeUrlPath(value) {
@@ -59,6 +60,7 @@ function resolveDocsSitemapConfig(sitemap, defaults = {}) {
 			includeLastmod: typeof markdownConfig === "object" ? markdownConfig.includeLastmod ?? true : true,
 			linkTarget: typeof markdownConfig === "object" ? markdownConfig.linkTarget ?? "both" : "both",
 			route: joinRoute(routePrefix, DEFAULT_SITEMAP_MD_ROUTE),
+			docsRoute: routePrefix ? void 0 : DEFAULT_SITEMAP_MD_DOCS_ROUTE,
 			wellKnownRoute: joinRoute(routePrefix, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE)
 		}
 	};
@@ -73,7 +75,7 @@ function resolveDocsSitemapRequest(url, sitemap) {
 	const resolved = resolveDocsSitemapConfig(sitemap);
 	if (!resolved.enabled) return null;
 	if (resolved.xml.enabled && pathname === resolved.xml.route) return "xml";
-	if (resolved.markdown.enabled && (pathname === resolved.markdown.route || pathname === resolved.markdown.wellKnownRoute)) return "markdown";
+	if (resolved.markdown.enabled && (pathname === resolved.markdown.route || pathname === resolved.markdown.docsRoute || pathname === resolved.markdown.wellKnownRoute)) return "markdown";
 	return null;
 }
 function toDocsSitemapMarkdownUrl(url) {
@@ -247,4 +249,4 @@ function createDocsSitemapResponse({ request, sitemap, entry = "docs", siteTitle
 }
 
 //#endregion
-export { buildDocsSitemapManifest as a, renderDocsSitemapMarkdown as c, resolveDocsSitemapPageLastmod as d, resolveDocsSitemapRequest as f, DEFAULT_SITEMAP_XML_ROUTE as i, renderDocsSitemapXml as l, DEFAULT_SITEMAP_MD_ROUTE as n, createDocsSitemapResponse as o, toDocsSitemapMarkdownUrl as p, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as r, readDocsSitemapManifestFromContentMap as s, DEFAULT_SITEMAP_MANIFEST_PATH as t, resolveDocsSitemapConfig as u };
+export { DEFAULT_SITEMAP_XML_ROUTE as a, readDocsSitemapManifestFromContentMap as c, resolveDocsSitemapConfig as d, resolveDocsSitemapPageLastmod as f, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as i, renderDocsSitemapMarkdown as l, toDocsSitemapMarkdownUrl as m, DEFAULT_SITEMAP_MD_DOCS_ROUTE as n, buildDocsSitemapManifest as o, resolveDocsSitemapRequest as p, DEFAULT_SITEMAP_MD_ROUTE as r, createDocsSitemapResponse as s, DEFAULT_SITEMAP_MANIFEST_PATH as t, renderDocsSitemapXml as u };

package/dist/{sitemap-server-DdHzJorR.mjs → sitemap-server-BZHoJHqC.mjs}

@@ -1,4 +1,4 @@
-import { u as resolveDocsSitemapConfig } from "./sitemap-CnqcTdQg.mjs";
+import { d as resolveDocsSitemapConfig } from "./sitemap-CMNj0Pt3.mjs";
 import { createRequire } from "node:module";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import path, { basename, join, relative } from "node:path";

package/dist/{types-CHD7M60f.d.mts → types-hDUu4K7W.d.mts}

@@ -899,7 +899,7 @@ interface SitemapMarkdownConfig {
   linkTarget?: "html" | "markdown" | "both";
 }
 /**
- * Configuration for generated `/sitemap.xml`, `/sitemap.md`, and
+ * Configuration for generated `/sitemap.xml`, `/sitemap.md`, `/docs/sitemap.md`, and
  * `/.well-known/sitemap.md` routes.
  */
 interface DocsSitemapConfig {
@@ -2120,6 +2120,133 @@ interface DocsReviewConfig {
   /** Optional rule severity overrides. */
   rules?: DocsReviewRulesConfig;
 }
+type DocsCodeBlocksPlannerProvider = "metadata" | "openai" | "openai-compatible" | "cloud";
+type DocsCodeBlocksRunnerProvider = "local" | "vercel-sandbox" | "cloud";
+type DocsCodeBlocksValidationMode = "plan" | "report";
+type DocsCodeBlocksValidationPolicy = "skip" | "warn" | "error";
+interface DocsCodeBlocksPlannerConfig {
+  /**
+   * Planner used to turn code fence metadata into an execution plan.
+   *
+   * - `"metadata"` reads the fence language and metadata locally.
+   * - `"openai"` calls OpenAI's chat completions API.
+   * - `"openai-compatible"` calls an OpenAI-compatible chat completions endpoint.
+   * - `"cloud"` is reserved for the hosted Farming Labs planner.
+   *
+   * @default "metadata"
+   */
+  provider?: DocsCodeBlocksPlannerProvider;
+  /** Model name for LLM-backed planners. */
+  model?: string;
+  /** OpenAI-compatible base URL. Defaults to `https://api.openai.com/v1` for `provider: "openai"`. */
+  baseUrl?: string;
+  /** Environment variable containing the OpenAI-compatible base URL. */
+  baseUrlEnv?: string;
+  /** API key value. Prefer `apiKeyEnv` so secrets stay out of docs.config. */
+  apiKey?: string;
+  /** Environment variable containing the planner API key. */
+  apiKeyEnv?: string;
+}
+interface DocsCodeBlocksRunnerConfig {
+  /**
+   * Runner used to execute planned code blocks.
+   *
+   * @default "local"
+   */
+  provider?: DocsCodeBlocksRunnerProvider;
+  /** Environment variable containing the Vercel token for `provider: "vercel-sandbox"`. */
+  tokenEnv?: string;
+  /** Advanced override for the Vercel project id env var used by `provider: "vercel-sandbox"`. */
+  projectIdEnv?: string;
+  /** Advanced override for the Vercel team/org id env var used by `provider: "vercel-sandbox"`. */
+  teamIdEnv?: string;
+  /**
+   * Path to a Vercel project metadata file. When enabled, the runner reads
+   * `projectId` and `orgId` from `.vercel/project.json`. If those are not
+   * available, the runner can auto-discover an accessible project from
+   * `VERCEL_TOKEN`.
+   *
+   * @default ".vercel/project.json"
+   */
+  projectJson?: string | false;
+  /** Vercel Sandbox runtime. */
+  runtime?: "node24" | "node22" | "python3.13";
+  /** Per-command timeout in milliseconds. */
+  timeoutMs?: number;
+}
+interface DocsCodeBlocksValidateConfig {
+  /**
+   * Enable code block validation.
+   *
+   * @default true when `codeBlocks.validate` is an object or `true`
+   */
+  enabled?: boolean;
+  /** Planner config. Use `"metadata"` for local deterministic planning. */
+  planner?: DocsCodeBlocksPlannerProvider | DocsCodeBlocksPlannerConfig;
+  /** Runner config. Use `"vercel-sandbox"` for isolated runtime checks. */
+  runner?: DocsCodeBlocksRunnerProvider | DocsCodeBlocksRunnerConfig;
+  /**
+   * Env files loaded for validation. These are read locally and never committed.
+   *
+   * @default [".env.local", ".env.test", ".env"]
+   */
+  envFile?: string | string[];
+  /**
+   * Runtime env mapping.
+   *
+   * The key is the env var used by the docs code block. The value is the local
+   * env var to read from. For example, `{ OPENAI_API_KEY: "OPENAI_TEST_API_KEY" }`
+   * injects `OPENAI_API_KEY` into the runner from `OPENAI_TEST_API_KEY`.
+   */
+  env?: Record<string, string>;
+  /**
+   * Behavior when a runnable block declares an env var that cannot be resolved.
+   *
+   * @default "skip"
+   */
+  missingEnv?: DocsCodeBlocksValidationPolicy;
+  /**
+   * Behavior when a language cannot be executed by the selected runner.
+   *
+   * @default "skip"
+   */
+  unsupportedLanguage?: DocsCodeBlocksValidationPolicy;
+  /**
+   * Default command mode.
+   *
+   * - `"plan"` builds execution plans without running them.
+   * - `"report"` runs executable plans and reports pass/skip/fail.
+   *
+   * @default "report"
+   */
+  mode?: DocsCodeBlocksValidationMode;
+}
+interface DocsCodeBlocksConfig {
+  /**
+   * Validate fenced code blocks from MD/MDX docs.
+   *
+   * @example
+   * ```ts
+   * codeBlocks: {
+   *   validate: {
+   *     planner: {
+   *       provider: "openai",
+   *       model: "gpt-4.1-mini",
+   *       apiKeyEnv: "OPENAI_API_KEY",
+   *     },
+   *     runner: {
+   *       provider: "vercel-sandbox",
+   *       tokenEnv: "VERCEL_TOKEN",
+   *     },
+   *     env: {
+   *       OPENAI_API_KEY: "OPENAI_TEST_API_KEY",
+   *     },
+   *   },
+   * }
+   * ```
+   */
+  validate?: boolean | DocsCodeBlocksValidateConfig;
+}
 interface DocsConfig {
   /** Entry folder for docs (e.g. "docs" → /docs) */
   entry: string;
@@ -2271,6 +2398,11 @@ interface DocsConfig {
    * ```
    */
   onCopyClick?: (data: CodeBlockCopyData) => void;
+  /**
+   * Code block intelligence for MD/MDX fences, including validation planning
+   * and optional sandboxed execution.
+   */
+  codeBlocks?: DocsCodeBlocksConfig;
   /**
    * Built-in page feedback prompt shown at the end of a docs page.
    *
@@ -2586,4 +2718,4 @@ interface DocsConfig {
   og?: OGConfig;
 }
 //#endregion
-export { DocsSearchChunkingConfig as $, DocsConfig as A, PageTwitter as At, DocsObservabilityEventInput as B, SimpleDocsSearchConfig as Bt, DocsAskAIActionData as C, OpenDocsTarget as Ct, DocsAskAIFeedbackMessage as D, PageFrontmatter as Dt, DocsAskAIFeedbackData as E, PageActionsConfig as Et, DocsMcpToolsConfig as F, SidebarFolderIndexBehavior as Ft, DocsReviewRulesConfig as G, DocsReviewCiConfig as H, TypesenseDocsSearchConfig as Ht, DocsMetadata as I, SidebarFolderNode as It, DocsRobotsConfig as J, DocsReviewScoreConfig as K, DocsNav as L, SidebarNode as Lt, DocsFeedbackValue as M, ResolvedDocsRelatedLink as Mt, DocsI18nConfig as N, SidebarComponentProps as Nt, DocsAskAIFeedbackValue as O, PageOpenGraph as Ot, DocsMcpConfig as P, SidebarConfig as Pt, DocsSearchAdapterFactory as Q, DocsObservabilityConfig as R, SidebarPageNode as Rt, DocsAnalyticsSource as S, OpenDocsProviderId as St, DocsAskAIFeedbackConfig as T, OrderingItem as Tt, DocsReviewCiMode as U, TypographyConfig as Ut, DocsRelatedItem as V, ThemeToggleConfig as Vt, DocsReviewConfig as W, UIConfig as Wt, DocsSearchAdapter as X, DocsRobotsRule as Y, DocsSearchAdapterContext as Z, DocsAnalyticsConfig as _, McpDocsSearchConfig as _t, ApiReferenceRenderer as a, DocsSearchResultType as at, DocsAnalyticsEventType as b, OpenDocsProvider as bt, ChangelogFrontmatter as c, DocsTheme as ct, CustomDocsSearchConfig as d, GithubConfig as dt, DocsSearchConfig as et, DocsAgentFeedbackContext as f, LastUpdatedConfig as ft, DocsAgentTraceStatus as g, LlmsTxtSectionConfig as gt, DocsAgentTraceEventType as h, LlmsTxtMaxCharsMode as ht, ApiReferenceConfig as i, DocsSearchResult as it, DocsFeedbackData as j, ReadingTimeConfig as jt, DocsAskAIMcpConfig as k, PageSidebarFrontmatter as kt, CodeBlockCopyData as l, FeedbackConfig as lt, DocsAgentTraceEventInput as m, LlmsTxtMaxCharsConfig as mt, AgentFeedbackConfig as n, DocsSearchEmbeddingsConfig as nt, BreadcrumbConfig as o, DocsSearchSourcePage as ot, DocsAgentFeedbackData as p, LlmsTxtConfig as pt, DocsReviewSeverity as q, AlgoliaDocsSearchConfig as r, DocsSearchQuery as rt, ChangelogConfig as s, DocsSitemapConfig as st, AIConfig as t, DocsSearchDocument as tt, CopyMarkdownConfig as u, FontStyle as ut, DocsAnalyticsEvent as v, OGConfig as vt, DocsAskAIActionType as w, OpenGraphImage as wt, DocsAnalyticsInput as x, OpenDocsProviderConfig as xt, DocsAnalyticsEventInput as y, OpenDocsConfig as yt, DocsObservabilityEvent as z, SidebarTree as zt };
+export { DocsReviewRulesConfig as $, DocsCodeBlocksConfig as A, OpenDocsProviderId as At, DocsFeedbackValue as B, ResolvedDocsRelatedLink as Bt, DocsAskAIActionData as C, LlmsTxtMaxCharsMode as Ct, DocsAskAIFeedbackMessage as D, OpenDocsConfig as Dt, DocsAskAIFeedbackData as E, OGConfig as Et, DocsCodeBlocksValidateConfig as F, PageFrontmatter as Ft, DocsNav as G, SidebarNode as Gt, DocsMcpConfig as H, SidebarConfig as Ht, DocsCodeBlocksValidationMode as I, PageOpenGraph as It, DocsObservabilityEventInput as J, SimpleDocsSearchConfig as Jt, DocsObservabilityConfig as K, SidebarPageNode as Kt, DocsCodeBlocksValidationPolicy as L, PageSidebarFrontmatter as Lt, DocsCodeBlocksPlannerProvider as M, OpenGraphImage as Mt, DocsCodeBlocksRunnerConfig as N, OrderingItem as Nt, DocsAskAIFeedbackValue as O, OpenDocsProvider as Ot, DocsCodeBlocksRunnerProvider as P, PageActionsConfig as Pt, DocsReviewConfig as Q, UIConfig as Qt, DocsConfig as R, PageTwitter as Rt, DocsAnalyticsSource as S, LlmsTxtMaxCharsConfig as St, DocsAskAIFeedbackConfig as T, McpDocsSearchConfig as Tt, DocsMcpToolsConfig as U, SidebarFolderIndexBehavior as Ut, DocsI18nConfig as V, SidebarComponentProps as Vt, DocsMetadata as W, SidebarFolderNode as Wt, DocsReviewCiConfig as X, TypesenseDocsSearchConfig as Xt, DocsRelatedItem as Y, ThemeToggleConfig as Yt, DocsReviewCiMode as Z, TypographyConfig as Zt, DocsAnalyticsConfig as _, FeedbackConfig as _t, ApiReferenceRenderer as a, DocsSearchAdapterContext as at, DocsAnalyticsEventType as b, LastUpdatedConfig as bt, ChangelogFrontmatter as c, DocsSearchConfig as ct, CustomDocsSearchConfig as d, DocsSearchQuery as dt, DocsReviewScoreConfig as et, DocsAgentFeedbackContext as f, DocsSearchResult as ft, DocsAgentTraceStatus as g, DocsTheme as gt, DocsAgentTraceEventType as h, DocsSitemapConfig as ht, ApiReferenceConfig as i, DocsSearchAdapter as it, DocsCodeBlocksPlannerConfig as j, OpenDocsTarget as jt, DocsAskAIMcpConfig as k, OpenDocsProviderConfig as kt, CodeBlockCopyData as l, DocsSearchDocument as lt, DocsAgentTraceEventInput as m, DocsSearchSourcePage as mt, AgentFeedbackConfig as n, DocsRobotsConfig as nt, BreadcrumbConfig as o, DocsSearchAdapterFactory as ot, DocsAgentFeedbackData as p, DocsSearchResultType as pt, DocsObservabilityEvent as q, SidebarTree as qt, AlgoliaDocsSearchConfig as r, DocsRobotsRule as rt, ChangelogConfig as s, DocsSearchChunkingConfig as st, AIConfig as t, DocsReviewSeverity as tt, CopyMarkdownConfig as u, DocsSearchEmbeddingsConfig as ut, DocsAnalyticsEvent as v, FontStyle as vt, DocsAskAIActionType as w, LlmsTxtSectionConfig as wt, DocsAnalyticsInput as x, LlmsTxtConfig as xt, DocsAnalyticsEventInput as y, GithubConfig as yt, DocsFeedbackData as z, ReadingTimeConfig as zt };

package/dist/{upgrade-DrOWQIKI.mjs → upgrade-C7DvvfTR.mjs}

@@ -1,5 +1,5 @@
 import { c as fileExists, o as exec } from "./utils-x5EtYWjC.mjs";
-import { a as getPackagesForFramework, c as resolveDocsPackageManager, i as frameworkFromPreset, l as validateUpgradeVersion, n as PRESETS, o as presetFromFramework, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework, t as PACKAGES_BY_FRAMEWORK } from "./package-version-L4GZowaF.mjs";
+import { a as getPackagesForFramework, c as resolveDocsPackageManager, i as frameworkFromPreset, l as validateUpgradeVersion, n as PRESETS, o as presetFromFramework, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework, t as PACKAGES_BY_FRAMEWORK } from "./package-version-OrjpmqoR.mjs";
 import path from "node:path";
 import pc from "picocolors";
 import * as p from "@clack/prompts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.1.122",
+  "version": "0.1.124",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",
@@ -40,6 +40,7 @@
     "@clack/prompts": "^0.9.1",
     "@modelcontextprotocol/sdk": "1.29.0",
     "@scalar/core": "^0.4.3",
+    "@vercel/sandbox": "^2.0.0",
     "gray-matter": "^4.0.3",
     "jiti": "^2.6.1",
     "picocolors": "^1.1.1",

package/dist/agent-ByXnegrS.mjs

@@ -1,9 +0,0 @@
-import "./reading-time-Io7iRZ7S.mjs";
-import "./search-BL7o2rXk.mjs";
-import "./agent-Dt6kdGqw.mjs";
-import "./robots-tohhTNbU.mjs";
-import "./sitemap-server-DdHzJorR.mjs";
-import "./config-BHRL4R2v.mjs";
-import { a as readPageTokenBudget, i as printAgentCompactHelp, n as inspectAgentCompactionState, o as scanDocsPageTargets, r as parseAgentCompactArgs, t as compactAgentDocs } from "./agents-CpTNRbsh.mjs";
-
-export { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp };