@farming-labs/docs 0.1.124 → 0.1.125

package/dist/{agent-BtZrMCt8.mjs → agent-CBhuGaVu.mjs}

@@ -4,6 +4,6 @@ import "./agent-BS39vnhS.mjs";
 import "./robots-B2BfoyVM.mjs";
 import "./sitemap-server-BZHoJHqC.mjs";
 import "./config-B8wA38OC.mjs";
-import { a as readPageTokenBudget, i as printAgentCompactHelp, n as inspectAgentCompactionState, o as scanDocsPageTargets, r as parseAgentCompactArgs, t as compactAgentDocs } from "./codeblocks-RacO12_K.mjs";
+import { a as readPageTokenBudget, i as printAgentCompactHelp, n as inspectAgentCompactionState, o as scanDocsPageTargets, r as parseAgentCompactArgs, t as compactAgentDocs } from "./codeblocks-B4QzFqNC.mjs";
 
 export { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp };

package/dist/cli/index.mjs

@@ -86,7 +86,7 @@ async function main() {
 		const { runMcp } = await import("../mcp-BvERlrP_.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
-		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-BtZrMCt8.mjs");
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-CBhuGaVu.mjs");
 		const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
 		if (agentCompactOptions.help) {
 			printAgentCompactHelp();
@@ -96,7 +96,7 @@ async function main() {
 	} else if (parsedCommand.command === "agent") {
 		console.error(pc.red(`Unknown agent subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printAgentCompactHelp } = await import("../agent-BtZrMCt8.mjs");
+		const { printAgentCompactHelp } = await import("../agent-CBhuGaVu.mjs");
 		printAgentCompactHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "agents" && subcommand === "generate") {
@@ -114,7 +114,7 @@ async function main() {
 		printAgentsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-B0nFg8oM.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-lV9lhqGA.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();
@@ -130,7 +130,7 @@ async function main() {
 		}
 		await runReview(reviewOptions);
 	} else if ((parsedCommand.command === "codeblocks" || parsedCommand.command === "code-blocks") && subcommand === "validate") {
-		const { parseCodeBlocksValidateArgs, printCodeBlocksValidateHelp, runCodeBlocksValidate } = await import("../codeblocks-RacO12_K.mjs");
+		const { parseCodeBlocksValidateArgs, printCodeBlocksValidateHelp, runCodeBlocksValidate } = await import("../codeblocks-B4QzFqNC.mjs");
 		const codeBlocksOptions = parseCodeBlocksValidateArgs(args.slice(2));
 		if (codeBlocksOptions.help) {
 			printCodeBlocksValidateHelp();
@@ -140,7 +140,7 @@ async function main() {
 	} else if (parsedCommand.command === "codeblocks" || parsedCommand.command === "code-blocks") {
 		console.error(pc.red(`Unknown codeblocks subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printCodeBlocksValidateHelp } = await import("../codeblocks-RacO12_K.mjs");
+		const { printCodeBlocksValidateHelp } = await import("../codeblocks-B4QzFqNC.mjs");
 		printCodeBlocksValidateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {

package/dist/{codeblocks-RacO12_K.mjs → codeblocks-B4QzFqNC.mjs}

@@ -614,6 +614,8 @@ function resolveDocsCodeBlocksValidateConfig(input) {
 			teamIdEnv: "VERCEL_TEAM_ID",
 			projectJson: ".vercel/project.json",
 			runtime: "node24",
+			apiUrlEnv: "DAYTONA_API_URL",
+			targetEnv: "DAYTONA_TARGET",
 			timeoutMs: DEFAULT_COMMAND_TIMEOUT_MS
 		},
 		envFile: DEFAULT_ENV_FILES,
@@ -724,7 +726,7 @@ async function validateCodeBlockPlans(input) {
 	const skippedOrFailed = preflight.filter((result) => result.status === "SKIP" || result.reason);
 	const plansToRun = runnable.map((result) => result.plan);
 	if (plansToRun.length === 0) return skippedOrFailed;
-	const runResults = input.config.runner.provider === "vercel-sandbox" ? await runPlansInVercelSandbox(plansToRun, input.rootDir, input.config, validationEnv.env) : await runPlansLocally(plansToRun, input.config, validationEnv.env);
+	const runResults = await runPlansWithConfiguredRunner(plansToRun, input.rootDir, input.config, validationEnv.env);
 	return [...skippedOrFailed, ...runResults].sort((a, b) => a.id.localeCompare(b.id));
 }
 async function validateCodeBlocks(input) {
@@ -775,16 +777,24 @@ function normalizePlannerConfig(input) {
 }
 function normalizeRunnerConfig(input) {
 	const config = typeof input === "string" ? { provider: input } : input ?? {};
+	const provider = config.provider ?? "local";
 	return {
-		provider: config.provider ?? "local",
-		tokenEnv: config.tokenEnv ?? "VERCEL_TOKEN",
+		provider,
+		tokenEnv: config.tokenEnv ?? defaultRunnerTokenEnv(provider),
 		projectIdEnv: config.projectIdEnv ?? "VERCEL_PROJECT_ID",
 		teamIdEnv: config.teamIdEnv ?? "VERCEL_TEAM_ID",
 		projectJson: config.projectJson === void 0 ? ".vercel/project.json" : config.projectJson,
 		runtime: config.runtime ?? "node24",
+		apiUrlEnv: config.apiUrlEnv ?? "DAYTONA_API_URL",
+		targetEnv: config.targetEnv ?? "DAYTONA_TARGET",
 		timeoutMs: config.timeoutMs ?? DEFAULT_COMMAND_TIMEOUT_MS
 	};
 }
+function defaultRunnerTokenEnv(provider) {
+	if (provider === "e2b") return "E2B_API_KEY";
+	if (provider === "daytona") return "DAYTONA_API_KEY";
+	return "VERCEL_TOKEN";
+}
 function buildMetadataExecutionPlan(target, config) {
 	const language = normalizeLanguage(target.language);
 	const template = target.framework ?? templateFromLanguage(language);
@@ -1029,6 +1039,15 @@ async function runPlansLocally(plans, config, env) {
 		});
 	}
 }
+async function runPlansWithConfiguredRunner(plans, rootDir, config, env) {
+	switch (config.runner.provider) {
+		case "local": return runPlansLocally(plans, config, env);
+		case "vercel-sandbox": return runPlansInVercelSandbox(plans, rootDir, config, env);
+		case "e2b": return runPlansInE2B(plans, config, env);
+		case "daytona": return runPlansInDaytona(plans, config, env);
+		case "cloud": return plans.map((plan) => skippedResult(plan, "cloud runner is not available in this package yet"));
+	}
+}
 async function runPlansInVercelSandbox(plans, rootDir, config, env) {
 	const credentials = await resolveVercelSandboxCredentials(rootDir, config);
 	if (credentials.missing.length > 0) return plans.map((plan) => skippedResult(plan, `missing ${credentials.missing.join(", ")}`));
@@ -1075,6 +1094,79 @@ async function runPlansInVercelSandbox(plans, rootDir, config, env) {
 		return plans.map((plan) => skippedResult(plan, `vercel-sandbox unavailable: ${message}`));
 	}
 }
+async function runPlansInE2B(plans, config, env) {
+	const token = process.env[config.runner.tokenEnv];
+	if (!token) return plans.map((plan) => skippedResult(plan, `missing ${config.runner.tokenEnv}`));
+	const module = await importOptionalModule("e2b");
+	if (!module) return plans.map((plan) => skippedResult(plan, "e2b unavailable: install the \"e2b\" package"));
+	try {
+		const E2BSandbox = readProviderExport(module, "default") ?? readProviderExport(module, "Sandbox");
+		if (!hasCreateMethod(E2BSandbox)) return plans.map((plan) => skippedResult(plan, "e2b unavailable: missing Sandbox.create"));
+		const sandbox = await withTemporaryEnv("E2B_API_KEY", token, () => E2BSandbox.create());
+		try {
+			return await Promise.all(plans.map(async (plan) => {
+				if (!plan.command || !plan.filePath) return skippedResult(plan, "no executable command in plan");
+				const command = buildSandboxShellCommand(plan);
+				const runner = readObject(sandbox).commands;
+				if (!hasRunMethod(runner)) return skippedResult(plan, "e2b unavailable: missing commands.run");
+				try {
+					return sandboxCommandResult(plan, await runner.run(command, {
+						envs: env,
+						timeoutMs: config.runner.timeoutMs
+					}));
+				} catch (error) {
+					return failedSandboxResult(plan, error);
+				}
+			}));
+		} finally {
+			await cleanupProviderSandbox(sandbox);
+		}
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		return plans.map((plan) => skippedResult(plan, `e2b unavailable: ${message}`));
+	}
+}
+async function runPlansInDaytona(plans, config, env) {
+	const token = process.env[config.runner.tokenEnv];
+	if (!token) return plans.map((plan) => skippedResult(plan, `missing ${config.runner.tokenEnv}`));
+	const module = await importOptionalModule("@daytona/sdk");
+	if (!module) return plans.map((plan) => skippedResult(plan, "daytona unavailable: install the \"@daytona/sdk\" package"));
+	try {
+		const Daytona = readProviderExport(module, "Daytona");
+		if (!hasConstructor(Daytona)) return plans.map((plan) => skippedResult(plan, "daytona unavailable: missing Daytona SDK"));
+		const apiUrl = process.env[config.runner.apiUrlEnv];
+		const target = process.env[config.runner.targetEnv];
+		const daytona = new Daytona({
+			apiKey: token,
+			...apiUrl ? { apiUrl } : {},
+			...target ? { target } : {}
+		});
+		if (!hasCreateMethod(daytona)) return plans.map((plan) => skippedResult(plan, "daytona unavailable: missing create"));
+		const sandbox = await daytona.create({
+			ephemeral: true,
+			language: "typescript",
+			...Object.keys(env).length > 0 ? { envVars: env } : {}
+		});
+		try {
+			return await Promise.all(plans.map(async (plan) => {
+				if (!plan.command || !plan.filePath) return skippedResult(plan, "no executable command in plan");
+				const processApi = readObject(sandbox).process;
+				if (!hasExecuteCommandMethod(processApi)) return skippedResult(plan, "daytona unavailable: missing process.executeCommand");
+				try {
+					return sandboxCommandResult(plan, await processApi.executeCommand(buildSandboxShellCommand(plan)));
+				} catch (error) {
+					return failedSandboxResult(plan, error);
+				}
+			}));
+		} finally {
+			await cleanupProviderSandbox(sandbox);
+			await cleanupProviderSandbox(daytona);
+		}
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		return plans.map((plan) => skippedResult(plan, `daytona unavailable: ${message}`));
+	}
+}
 async function resolveVercelSandboxCredentials(rootDir, config) {
 	const projectJson = readVercelProjectJson(rootDir, config.runner.projectJson);
 	const token = process.env[config.runner.tokenEnv];
@@ -1120,6 +1212,122 @@ function readVercelProjectJson(rootDir, projectJson) {
 		return;
 	}
 }
+async function importOptionalModule(specifier) {
+	const importer = globalThis.__DOCS_CODE_BLOCKS_MODULE_IMPORTER__ ?? ((id) => import(id));
+	try {
+		return await importer(specifier);
+	} catch {
+		return;
+	}
+}
+function buildSandboxShellCommand(plan) {
+	const command = plan.command;
+	const filePath = plan.filePath;
+	if (!command || !filePath) return "";
+	const sandboxDir = "/tmp/docs-codeblocks";
+	const writeFileCommand = [
+		"printf",
+		"%s",
+		Buffer.from(plan.target.code, "utf-8").toString("base64"),
+		"|",
+		"base64",
+		"-d",
+		">",
+		filePath
+	].map((part) => part === "|" || part === ">" ? part : shellEscape(part)).join(" ");
+	return [
+		`mkdir -p ${shellEscape(sandboxDir)}`,
+		`cd ${shellEscape(sandboxDir)}`,
+		writeFileCommand,
+		shellJoin([command.cmd, ...command.args])
+	].join(" && ");
+}
+function shellJoin(parts) {
+	return parts.map(shellEscape).join(" ");
+}
+function shellEscape(value) {
+	return `'${value.replace(/'/g, "'\\''")}'`;
+}
+async function withTemporaryEnv(key, value, callback) {
+	const previous = process.env[key];
+	process.env[key] = value;
+	try {
+		return await callback();
+	} finally {
+		if (previous === void 0) delete process.env[key];
+		else process.env[key] = previous;
+	}
+}
+function sandboxCommandResult(plan, result) {
+	const record = readObject(result);
+	const error = readStringValue(record.error);
+	const exitCode = readNumberValue(record.exitCode) ?? readNumberValue(record.code) ?? readNumberValue(record.exit_code) ?? (error ? 1 : 0);
+	const stdout = readStringValue(record.stdout) ?? readStringValue(record.result) ?? readStringValue(record.text) ?? "";
+	const stderr = readStringValue(record.stderr) ?? error ?? "";
+	return {
+		id: plan.id,
+		target: plan.target,
+		plan,
+		status: exitCode === 0 ? "PASS" : "FAIL",
+		stdout,
+		stderr,
+		exitCode,
+		reason: exitCode === 0 ? void 0 : `exit code ${exitCode}`
+	};
+}
+function failedSandboxResult(plan, error) {
+	const record = readObject(error);
+	return {
+		id: plan.id,
+		target: plan.target,
+		plan,
+		status: "FAIL",
+		stdout: readStringValue(record.stdout),
+		stderr: readStringValue(record.stderr),
+		exitCode: readNumberValue(record.exitCode) ?? readNumberValue(record.code) ?? null,
+		reason: error instanceof Error ? error.message : String(error)
+	};
+}
+async function cleanupProviderSandbox(value) {
+	const record = readObject(value);
+	for (const methodName of [
+		"kill",
+		"close",
+		"stop",
+		"delete",
+		"remove",
+		"destroy"
+	]) {
+		const method = record[methodName];
+		if (typeof method !== "function") continue;
+		await Promise.resolve(method.call(value)).catch(() => {});
+		return;
+	}
+}
+function readProviderExport(module, name) {
+	return readObject(module)[name];
+}
+function readObject(value) {
+	return value !== null && (typeof value === "object" || typeof value === "function") ? value : {};
+}
+function readStringValue(value) {
+	return typeof value === "string" ? value : void 0;
+}
+function readNumberValue(value) {
+	return typeof value === "number" ? value : void 0;
+}
+function hasCreateMethod(value) {
+	return typeof readObject(value).create === "function";
+}
+function hasRunMethod(value) {
+	return typeof readObject(value).run === "function";
+}
+function hasExecuteCommandMethod(value) {
+	return typeof readObject(value).executeCommand === "function";
+}
+function hasConstructor(value) {
+	return typeof value === "function";
+}
 function loadValidationEnv(rootDir, config) {
 	const fileEnv = {};
 	for (const file of config.envFile) {
@@ -1420,8 +1628,10 @@ function readStaticRunnerConfig(block) {
 	const teamIdEnv = readStringProperty(block, "teamIdEnv");
 	const projectJson = readStringProperty(block, "projectJson");
 	const runtime = readStringProperty(block, "runtime");
+	const apiUrlEnv = readStringProperty(block, "apiUrlEnv");
+	const targetEnv = readStringProperty(block, "targetEnv");
 	const timeoutMs = readNumberProperty(block, "timeoutMs");
-	if (provider !== "local" && provider !== "vercel-sandbox" && provider !== "cloud") return;
+	if (provider !== "local" && provider !== "vercel-sandbox" && provider !== "e2b" && provider !== "daytona" && provider !== "cloud") return;
 	return {
 		provider,
 		...tokenEnv ? { tokenEnv } : {},
@@ -1429,6 +1639,8 @@ function readStaticRunnerConfig(block) {
 		...teamIdEnv ? { teamIdEnv } : {},
 		...projectJson ? { projectJson } : {},
 		...runtime === "node24" || runtime === "node22" || runtime === "python3.13" ? { runtime } : {},
+		...apiUrlEnv ? { apiUrlEnv } : {},
+		...targetEnv ? { targetEnv } : {},
 		...timeoutMs !== void 0 ? { timeoutMs } : {}
 	};
 }

package/dist/{doctor-B0nFg8oM.mjs → doctor-lV9lhqGA.mjs}

@@ -8,7 +8,7 @@ import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./server.mjs";
 import { a as loadProjectEnv, c as readNavTitle, d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, o as readBooleanProperty, p as resolveDocsContentDir, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-B8wA38OC.mjs";
 import { t as detectFramework } from "./utils-x5EtYWjC.mjs";
-import { n as inspectAgentCompactionState, o as scanDocsPageTargets } from "./codeblocks-RacO12_K.mjs";
+import { n as inspectAgentCompactionState, o as scanDocsPageTargets } from "./codeblocks-B4QzFqNC.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";
 import { LATEST_PROTOCOL_VERSION } from "@modelcontextprotocol/sdk/types.js";

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { $ as DocsReviewRulesConfig, A as DocsCodeBlocksConfig, At as OpenDocsProviderId, B as DocsFeedbackValue, Bt as ResolvedDocsRelatedLink, C as DocsAskAIActionData, Ct as LlmsTxtMaxCharsMode, D as DocsAskAIFeedbackMessage, Dt as OpenDocsConfig, E as DocsAskAIFeedbackData, Et as OGConfig, F as DocsCodeBlocksValidateConfig, Ft as PageFrontmatter, G as DocsNav, Gt as SidebarNode, H as DocsMcpConfig, Ht as SidebarConfig, I as DocsCodeBlocksValidationMode, It as PageOpenGraph, J as DocsObservabilityEventInput, Jt as SimpleDocsSearchConfig, K as DocsObservabilityConfig, Kt as SidebarPageNode, L as DocsCodeBlocksValidationPolicy, Lt as PageSidebarFrontmatter, M as DocsCodeBlocksPlannerProvider, Mt as OpenGraphImage, N as DocsCodeBlocksRunnerConfig, Nt as OrderingItem, O as DocsAskAIFeedbackValue, Ot as OpenDocsProvider, P as DocsCodeBlocksRunnerProvider, Pt as PageActionsConfig, Q as DocsReviewConfig, Qt as UIConfig, R as DocsConfig, Rt as PageTwitter, S as DocsAnalyticsSource, St as LlmsTxtMaxCharsConfig, T as DocsAskAIFeedbackConfig, Tt as McpDocsSearchConfig, U as DocsMcpToolsConfig, Ut as SidebarFolderIndexBehavior, V as DocsI18nConfig, Vt as SidebarComponentProps, W as DocsMetadata, Wt as SidebarFolderNode, X as DocsReviewCiConfig, Xt as TypesenseDocsSearchConfig, Y as DocsRelatedItem, Yt as ThemeToggleConfig, Z as DocsReviewCiMode, Zt as TypographyConfig, _ as DocsAnalyticsConfig, _t as FeedbackConfig, a as ApiReferenceRenderer, at as DocsSearchAdapterContext, b as DocsAnalyticsEventType, bt as LastUpdatedConfig, c as ChangelogFrontmatter, ct as DocsSearchConfig, d as CustomDocsSearchConfig, dt as DocsSearchQuery, et as DocsReviewScoreConfig, f as DocsAgentFeedbackContext, ft as DocsSearchResult, g as DocsAgentTraceStatus, gt as DocsTheme, h as DocsAgentTraceEventType, ht as DocsSitemapConfig, i as ApiReferenceConfig, it as DocsSearchAdapter, j as DocsCodeBlocksPlannerConfig, jt as OpenDocsTarget, k as DocsAskAIMcpConfig, kt as OpenDocsProviderConfig, l as CodeBlockCopyData, lt as DocsSearchDocument, m as DocsAgentTraceEventInput, mt as DocsSearchSourcePage, n as AgentFeedbackConfig, nt as DocsRobotsConfig, o as BreadcrumbConfig, ot as DocsSearchAdapterFactory, p as DocsAgentFeedbackData, pt as DocsSearchResultType, q as DocsObservabilityEvent, qt as SidebarTree, r as AlgoliaDocsSearchConfig, rt as DocsRobotsRule, s as ChangelogConfig, st as DocsSearchChunkingConfig, t as AIConfig, tt as DocsReviewSeverity, u as CopyMarkdownConfig, ut as DocsSearchEmbeddingsConfig, v as DocsAnalyticsEvent, vt as FontStyle, w as DocsAskAIActionType, wt as LlmsTxtSectionConfig, x as DocsAnalyticsInput, xt as LlmsTxtConfig, y as DocsAnalyticsEventInput, yt as GithubConfig, z as DocsFeedbackData, zt as ReadingTimeConfig } from "./types-hDUu4K7W.mjs";
-import { $ as createDocsAgentTraceId, A as resolveDocsSitemapRequest, C as buildDocsSitemapManifest, D as renderDocsSitemapXml, E as renderDocsSitemapMarkdown, I as PromptAction, J as DOCS_AGENT_TRACE_EVENT_TYPES, L as PromptProviderChoice, O as resolveDocsSitemapConfig, Q as createDocsAgentTraceContext, R as SerializeOpenDocsProviderOptions, S as DocsSitemapResolvedConfig, T as readDocsSitemapManifestFromContentMap, X as ResolvedDocsAnalyticsConfig, Y as DocsAgentTraceContext, Z as ResolvedDocsObservabilityConfig, _ as DEFAULT_SITEMAP_XML_ROUTE, a as createMcpSearchAdapter, at as DocsCloudAnalyticsOptions, b as DocsSitemapManifestPage, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, et as emitDocsAgentTraceEvent, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, h as DEFAULT_SITEMAP_MD_ROUTE, i as createCustomSearchAdapter, it as resolveDocsObservabilityConfig, j as toDocsSitemapMarkdownUrl, k as resolveDocsSitemapPageLastmod, l as inferDocsAskAIPackageHints, m as DEFAULT_SITEMAP_MD_DOCS_ROUTE, n as buildDocsSearchDocuments, nt as emitDocsObservabilityEvent, o as createSimpleSearchAdapter, ot as createDocsCloudAnalytics, p as DEFAULT_SITEMAP_MANIFEST_PATH, r as createAlgoliaSearchAdapter, rt as resolveDocsAnalyticsConfig, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, tt as emitDocsAnalyticsEvent, u as performDocsSearch, v as DocsSitemapFormat, w as createDocsSitemapResponse, x as DocsSitemapPageInput, y as DocsSitemapManifest, z as SerializedOpenDocsProvider } from "./search-mF8wT9LQ.mjs";
+import { $ as DocsReviewRulesConfig, A as DocsCodeBlocksConfig, At as OpenDocsProviderId, B as DocsFeedbackValue, Bt as ResolvedDocsRelatedLink, C as DocsAskAIActionData, Ct as LlmsTxtMaxCharsMode, D as DocsAskAIFeedbackMessage, Dt as OpenDocsConfig, E as DocsAskAIFeedbackData, Et as OGConfig, F as DocsCodeBlocksValidateConfig, Ft as PageFrontmatter, G as DocsNav, Gt as SidebarNode, H as DocsMcpConfig, Ht as SidebarConfig, I as DocsCodeBlocksValidationMode, It as PageOpenGraph, J as DocsObservabilityEventInput, Jt as SimpleDocsSearchConfig, K as DocsObservabilityConfig, Kt as SidebarPageNode, L as DocsCodeBlocksValidationPolicy, Lt as PageSidebarFrontmatter, M as DocsCodeBlocksPlannerProvider, Mt as OpenGraphImage, N as DocsCodeBlocksRunnerConfig, Nt as OrderingItem, O as DocsAskAIFeedbackValue, Ot as OpenDocsProvider, P as DocsCodeBlocksRunnerProvider, Pt as PageActionsConfig, Q as DocsReviewConfig, Qt as UIConfig, R as DocsConfig, Rt as PageTwitter, S as DocsAnalyticsSource, St as LlmsTxtMaxCharsConfig, T as DocsAskAIFeedbackConfig, Tt as McpDocsSearchConfig, U as DocsMcpToolsConfig, Ut as SidebarFolderIndexBehavior, V as DocsI18nConfig, Vt as SidebarComponentProps, W as DocsMetadata, Wt as SidebarFolderNode, X as DocsReviewCiConfig, Xt as TypesenseDocsSearchConfig, Y as DocsRelatedItem, Yt as ThemeToggleConfig, Z as DocsReviewCiMode, Zt as TypographyConfig, _ as DocsAnalyticsConfig, _t as FeedbackConfig, a as ApiReferenceRenderer, at as DocsSearchAdapterContext, b as DocsAnalyticsEventType, bt as LastUpdatedConfig, c as ChangelogFrontmatter, ct as DocsSearchConfig, d as CustomDocsSearchConfig, dt as DocsSearchQuery, et as DocsReviewScoreConfig, f as DocsAgentFeedbackContext, ft as DocsSearchResult, g as DocsAgentTraceStatus, gt as DocsTheme, h as DocsAgentTraceEventType, ht as DocsSitemapConfig, i as ApiReferenceConfig, it as DocsSearchAdapter, j as DocsCodeBlocksPlannerConfig, jt as OpenDocsTarget, k as DocsAskAIMcpConfig, kt as OpenDocsProviderConfig, l as CodeBlockCopyData, lt as DocsSearchDocument, m as DocsAgentTraceEventInput, mt as DocsSearchSourcePage, n as AgentFeedbackConfig, nt as DocsRobotsConfig, o as BreadcrumbConfig, ot as DocsSearchAdapterFactory, p as DocsAgentFeedbackData, pt as DocsSearchResultType, q as DocsObservabilityEvent, qt as SidebarTree, r as AlgoliaDocsSearchConfig, rt as DocsRobotsRule, s as ChangelogConfig, st as DocsSearchChunkingConfig, t as AIConfig, tt as DocsReviewSeverity, u as CopyMarkdownConfig, ut as DocsSearchEmbeddingsConfig, v as DocsAnalyticsEvent, vt as FontStyle, w as DocsAskAIActionType, wt as LlmsTxtSectionConfig, x as DocsAnalyticsInput, xt as LlmsTxtConfig, y as DocsAnalyticsEventInput, yt as GithubConfig, z as DocsFeedbackData, zt as ReadingTimeConfig } from "./types-Dg82p0Fm.mjs";
+import { $ as createDocsAgentTraceId, A as resolveDocsSitemapRequest, C as buildDocsSitemapManifest, D as renderDocsSitemapXml, E as renderDocsSitemapMarkdown, I as PromptAction, J as DOCS_AGENT_TRACE_EVENT_TYPES, L as PromptProviderChoice, O as resolveDocsSitemapConfig, Q as createDocsAgentTraceContext, R as SerializeOpenDocsProviderOptions, S as DocsSitemapResolvedConfig, T as readDocsSitemapManifestFromContentMap, X as ResolvedDocsAnalyticsConfig, Y as DocsAgentTraceContext, Z as ResolvedDocsObservabilityConfig, _ as DEFAULT_SITEMAP_XML_ROUTE, a as createMcpSearchAdapter, at as DocsCloudAnalyticsOptions, b as DocsSitemapManifestPage, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, et as emitDocsAgentTraceEvent, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, h as DEFAULT_SITEMAP_MD_ROUTE, i as createCustomSearchAdapter, it as resolveDocsObservabilityConfig, j as toDocsSitemapMarkdownUrl, k as resolveDocsSitemapPageLastmod, l as inferDocsAskAIPackageHints, m as DEFAULT_SITEMAP_MD_DOCS_ROUTE, n as buildDocsSearchDocuments, nt as emitDocsObservabilityEvent, o as createSimpleSearchAdapter, ot as createDocsCloudAnalytics, p as DEFAULT_SITEMAP_MANIFEST_PATH, r as createAlgoliaSearchAdapter, rt as resolveDocsAnalyticsConfig, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, tt as emitDocsAnalyticsEvent, u as performDocsSearch, v as DocsSitemapFormat, w as createDocsSitemapResponse, x as DocsSitemapPageInput, y as DocsSitemapManifest, z as SerializedOpenDocsProvider } from "./search-G0otDMfP.mjs";
 import { DocsMcpPage, DocsMcpResolvedConfig } from "./mcp.mjs";
 
 //#region src/define-docs.d.ts

package/dist/mcp.d.mts

@@ -1,4 +1,4 @@
-import { H as DocsMcpConfig, K as DocsObservabilityConfig, Nt as OrderingItem, _ as DocsAnalyticsConfig, ct as DocsSearchConfig, mt as DocsSearchSourcePage } from "./types-hDUu4K7W.mjs";
+import { H as DocsMcpConfig, K as DocsObservabilityConfig, Nt as OrderingItem, _ as DocsAnalyticsConfig, ct as DocsSearchConfig, mt as DocsSearchSourcePage } from "./types-Dg82p0Fm.mjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 //#region src/mcp.d.ts

package/dist/mcp.mjs

@@ -394,9 +394,9 @@ const DOCS_CONFIG_SCHEMA_OPTIONS = [
 			{
 				path: "codeBlocks.validate.runner",
 				name: "runner",
-				type: "\"local\" | \"vercel-sandbox\" | \"cloud\" | DocsCodeBlocksRunnerConfig",
+				type: "\"local\" | \"vercel-sandbox\" | \"e2b\" | \"daytona\" | \"cloud\" | DocsCodeBlocksRunnerConfig",
 				default: "local",
-				description: "Runner used to execute planned snippets. The Vercel Sandbox runner can work from `VERCEL_TOKEN` alone by auto-discovering an accessible project."
+				description: "Runner used to execute planned snippets. Vercel Sandbox, E2B, and Daytona use provider tokens from env vars."
 			},
 			{
 				path: "codeBlocks.validate.env",

package/dist/{search-mF8wT9LQ.d.mts → search-G0otDMfP.d.mts}

@@ -1,4 +1,4 @@
-import { Bt as ResolvedDocsRelatedLink, J as DocsObservabilityEventInput, K as DocsObservabilityConfig, Ot as OpenDocsProvider, Tt as McpDocsSearchConfig, Xt as TypesenseDocsSearchConfig, _ as DocsAnalyticsConfig, ct as DocsSearchConfig, d as CustomDocsSearchConfig, ft as DocsSearchResult, ht as DocsSitemapConfig, it as DocsSearchAdapter, jt as OpenDocsTarget, k as DocsAskAIMcpConfig, lt as DocsSearchDocument, m as DocsAgentTraceEventInput, mt as DocsSearchSourcePage, ot as DocsSearchAdapterFactory, q as DocsObservabilityEvent, r as AlgoliaDocsSearchConfig, st as DocsSearchChunkingConfig, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput } from "./types-hDUu4K7W.mjs";
+import { Bt as ResolvedDocsRelatedLink, J as DocsObservabilityEventInput, K as DocsObservabilityConfig, Ot as OpenDocsProvider, Tt as McpDocsSearchConfig, Xt as TypesenseDocsSearchConfig, _ as DocsAnalyticsConfig, ct as DocsSearchConfig, d as CustomDocsSearchConfig, ft as DocsSearchResult, ht as DocsSitemapConfig, it as DocsSearchAdapter, jt as OpenDocsTarget, k as DocsAskAIMcpConfig, lt as DocsSearchDocument, m as DocsAgentTraceEventInput, mt as DocsSearchSourcePage, ot as DocsSearchAdapterFactory, q as DocsObservabilityEvent, r as AlgoliaDocsSearchConfig, st as DocsSearchChunkingConfig, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput } from "./types-Dg82p0Fm.mjs";
 
 //#region src/cloud-analytics.d.ts
 interface DocsCloudAnalyticsOptions {

package/dist/server.d.mts

@@ -1,5 +1,5 @@
-import { $ as DocsReviewRulesConfig, D as DocsAskAIFeedbackMessage, E as DocsAskAIFeedbackData, J as DocsObservabilityEventInput, K as DocsObservabilityConfig, O as DocsAskAIFeedbackValue, Q as DocsReviewConfig, R as DocsConfig, T as DocsAskAIFeedbackConfig, Tt as McpDocsSearchConfig, Z as DocsReviewCiMode, _ as DocsAnalyticsConfig, a as ApiReferenceRenderer, at as DocsSearchAdapterContext, ct as DocsSearchConfig, dt as DocsSearchQuery, ft as DocsSearchResult, g as DocsAgentTraceStatus, h as DocsAgentTraceEventType, ht as DocsSitemapConfig, it as DocsSearchAdapter, k as DocsAskAIMcpConfig, lt as DocsSearchDocument, m as DocsAgentTraceEventInput, mt as DocsSearchSourcePage, ot as DocsSearchAdapterFactory, q as DocsObservabilityEvent, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput } from "./types-hDUu4K7W.mjs";
-import { $ as createDocsAgentTraceId, A as resolveDocsSitemapRequest, B as normalizePromptProviderName, C as buildDocsSitemapManifest, D as renderDocsSitemapXml, E as renderDocsSitemapMarkdown, F as DEFAULT_PROMPT_PROVIDER_TEMPLATES, G as serializeDocsIconRegistry, H as resolvePromptProviderChoices, I as PromptAction, J as DOCS_AGENT_TRACE_EVENT_TYPES, K as serializeOpenDocsProvider, L as PromptProviderChoice, M as DEFAULT_OPEN_DOCS_PROMPT, N as DEFAULT_OPEN_DOCS_PROVIDER_IDS, O as resolveDocsSitemapConfig, P as DEFAULT_OPEN_DOCS_TARGET, Q as createDocsAgentTraceContext, R as SerializeOpenDocsProviderOptions, S as DocsSitemapResolvedConfig, T as readDocsSitemapManifestFromContentMap, U as sanitizePromptText, V as parsePromptStringArray, W as serializeDocsIcon, X as ResolvedDocsAnalyticsConfig, Y as DocsAgentTraceContext, Z as ResolvedDocsObservabilityConfig, _ as DEFAULT_SITEMAP_XML_ROUTE, a as createMcpSearchAdapter, at as DocsCloudAnalyticsOptions, b as DocsSitemapManifestPage, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, et as emitDocsAgentTraceEvent, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, h as DEFAULT_SITEMAP_MD_ROUTE, i as createCustomSearchAdapter, it as resolveDocsObservabilityConfig, j as toDocsSitemapMarkdownUrl, k as resolveDocsSitemapPageLastmod, l as inferDocsAskAIPackageHints, m as DEFAULT_SITEMAP_MD_DOCS_ROUTE, n as buildDocsSearchDocuments, nt as emitDocsObservabilityEvent, o as createSimpleSearchAdapter, ot as createDocsCloudAnalytics, p as DEFAULT_SITEMAP_MANIFEST_PATH, q as serializeOpenDocsProviders, r as createAlgoliaSearchAdapter, rt as resolveDocsAnalyticsConfig, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, tt as emitDocsAnalyticsEvent, u as performDocsSearch, v as DocsSitemapFormat, w as createDocsSitemapResponse, x as DocsSitemapPageInput, y as DocsSitemapManifest, z as SerializedOpenDocsProvider } from "./search-mF8wT9LQ.mjs";
+import { $ as DocsReviewRulesConfig, D as DocsAskAIFeedbackMessage, E as DocsAskAIFeedbackData, J as DocsObservabilityEventInput, K as DocsObservabilityConfig, O as DocsAskAIFeedbackValue, Q as DocsReviewConfig, R as DocsConfig, T as DocsAskAIFeedbackConfig, Tt as McpDocsSearchConfig, Z as DocsReviewCiMode, _ as DocsAnalyticsConfig, a as ApiReferenceRenderer, at as DocsSearchAdapterContext, ct as DocsSearchConfig, dt as DocsSearchQuery, ft as DocsSearchResult, g as DocsAgentTraceStatus, h as DocsAgentTraceEventType, ht as DocsSitemapConfig, it as DocsSearchAdapter, k as DocsAskAIMcpConfig, lt as DocsSearchDocument, m as DocsAgentTraceEventInput, mt as DocsSearchSourcePage, ot as DocsSearchAdapterFactory, q as DocsObservabilityEvent, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput } from "./types-Dg82p0Fm.mjs";
+import { $ as createDocsAgentTraceId, A as resolveDocsSitemapRequest, B as normalizePromptProviderName, C as buildDocsSitemapManifest, D as renderDocsSitemapXml, E as renderDocsSitemapMarkdown, F as DEFAULT_PROMPT_PROVIDER_TEMPLATES, G as serializeDocsIconRegistry, H as resolvePromptProviderChoices, I as PromptAction, J as DOCS_AGENT_TRACE_EVENT_TYPES, K as serializeOpenDocsProvider, L as PromptProviderChoice, M as DEFAULT_OPEN_DOCS_PROMPT, N as DEFAULT_OPEN_DOCS_PROVIDER_IDS, O as resolveDocsSitemapConfig, P as DEFAULT_OPEN_DOCS_TARGET, Q as createDocsAgentTraceContext, R as SerializeOpenDocsProviderOptions, S as DocsSitemapResolvedConfig, T as readDocsSitemapManifestFromContentMap, U as sanitizePromptText, V as parsePromptStringArray, W as serializeDocsIcon, X as ResolvedDocsAnalyticsConfig, Y as DocsAgentTraceContext, Z as ResolvedDocsObservabilityConfig, _ as DEFAULT_SITEMAP_XML_ROUTE, a as createMcpSearchAdapter, at as DocsCloudAnalyticsOptions, b as DocsSitemapManifestPage, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, et as emitDocsAgentTraceEvent, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, h as DEFAULT_SITEMAP_MD_ROUTE, i as createCustomSearchAdapter, it as resolveDocsObservabilityConfig, j as toDocsSitemapMarkdownUrl, k as resolveDocsSitemapPageLastmod, l as inferDocsAskAIPackageHints, m as DEFAULT_SITEMAP_MD_DOCS_ROUTE, n as buildDocsSearchDocuments, nt as emitDocsObservabilityEvent, o as createSimpleSearchAdapter, ot as createDocsCloudAnalytics, p as DEFAULT_SITEMAP_MANIFEST_PATH, q as serializeOpenDocsProviders, r as createAlgoliaSearchAdapter, rt as resolveDocsAnalyticsConfig, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, tt as emitDocsAnalyticsEvent, u as performDocsSearch, v as DocsSitemapFormat, w as createDocsSitemapResponse, x as DocsSitemapPageInput, y as DocsSitemapManifest, z as SerializedOpenDocsProvider } from "./search-G0otDMfP.mjs";
 import { DocsMcpCodeExample, DocsMcpConfigSchema, DocsMcpConfigSchemaOption, DocsMcpDocsList, DocsMcpDocsPageSummary, DocsMcpDocsSection, DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpResolvedConfig, DocsMcpSource, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 
 //#region src/api-reference.d.ts

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

@@ -2121,7 +2121,7 @@ interface DocsReviewConfig {
   rules?: DocsReviewRulesConfig;
 }
 type DocsCodeBlocksPlannerProvider = "metadata" | "openai" | "openai-compatible" | "cloud";
-type DocsCodeBlocksRunnerProvider = "local" | "vercel-sandbox" | "cloud";
+type DocsCodeBlocksRunnerProvider = "local" | "vercel-sandbox" | "e2b" | "daytona" | "cloud";
 type DocsCodeBlocksValidationMode = "plan" | "report";
 type DocsCodeBlocksValidationPolicy = "skip" | "warn" | "error";
 interface DocsCodeBlocksPlannerConfig {
@@ -2154,7 +2154,7 @@ interface DocsCodeBlocksRunnerConfig {
    * @default "local"
    */
   provider?: DocsCodeBlocksRunnerProvider;
-  /** Environment variable containing the Vercel token for `provider: "vercel-sandbox"`. */
+  /** Environment variable containing the sandbox provider token. */
   tokenEnv?: string;
   /** Advanced override for the Vercel project id env var used by `provider: "vercel-sandbox"`. */
   projectIdEnv?: string;
@@ -2171,6 +2171,10 @@ interface DocsCodeBlocksRunnerConfig {
   projectJson?: string | false;
   /** Vercel Sandbox runtime. */
   runtime?: "node24" | "node22" | "python3.13";
+  /** Daytona API URL env var used by `provider: "daytona"`. */
+  apiUrlEnv?: string;
+  /** Daytona target/region env var used by `provider: "daytona"`. */
+  targetEnv?: string;
   /** Per-command timeout in milliseconds. */
   timeoutMs?: number;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.1.124",
+  "version": "0.1.125",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",