@farm.js/core 0.1.17 → 0.1.18

package/dist/chunk-B4CH33IG.cjs

@@ -0,0 +1,644 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+
+
+var _chunkGNEO2XOFcjs = require('./chunk-GNEO2XOF.cjs');
+
+
+var _chunkNV3A5DXMcjs = require('./chunk-NV3A5DXM.cjs');
+
+
+var _chunkS3JO3N4Hcjs = require('./chunk-S3JO3N4H.cjs');
+
+// src/docs/adapter.ts
+var _module = require('module');
+var _path = require('path'); var _path2 = _interopRequireDefault(_path);
+var _url = require('url');
+function hasFarmDocsRuntimeAdapter(docs) {
+  return Boolean(_optionalChain([docs, 'optionalAccess', _ => _.enabled]) && _optionalChain([docs, 'access', _2 => _2.adapter, 'optionalAccess', _3 => _3.server]) && docs.adapter.react);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, hasFarmDocsRuntimeAdapter, "hasFarmDocsRuntimeAdapter");
+function createFarmDocsAdapterRuntimeConfig(docs, options) {
+  return {
+    ...docs.config,
+    entry: docs.config.entry || docs.entry.replace(/^\/+|\/+$/g, "") || "docs",
+    docsPath: docs.entry,
+    contentDir: _chunkGNEO2XOFcjs.resolveFarmDocsContentDir.call(void 0, docs, options)
+  };
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, createFarmDocsAdapterRuntimeConfig, "createFarmDocsAdapterRuntimeConfig");
+function getFarmDocsAdapterStylesheets(options) {
+  return [options.fontStylesheetHref, options.globalStylesheetHref].filter(
+    (value) => typeof value === "string" && value.length > 0
+  );
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, getFarmDocsAdapterStylesheets, "getFarmDocsAdapterStylesheets");
+async function compileFarmDocsAdapterEdgeManifest(docs, options) {
+  if (!hasFarmDocsRuntimeAdapter(docs)) {
+    throw new Error("Farm docs adapter requires server and react runtime entrypoints.");
+  }
+  const compilerEntry = docs.adapter.edgeCompiler;
+  if (!compilerEntry) {
+    throw new Error(
+      `Farm docs adapter ${JSON.stringify(docs.adapter.id)} does not declare the edge compiler required for this deployment.`
+    );
+  }
+  const requireFromApp = _module.createRequire.call(void 0, _path2.default.join(options.root, "package.json"));
+  let compilerPath;
+  try {
+    compilerPath = requireFromApp.resolve(compilerEntry);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(
+      `Farm docs adapter ${JSON.stringify(docs.adapter.id)} edge compiler ${JSON.stringify(compilerEntry)} could not be resolved from the application: ${message}`
+    );
+  }
+  const compilerModule = await import(
+    /* @vite-ignore */
+    _url.pathToFileURL.call(void 0, compilerPath).href
+  );
+  if (typeof compilerModule.compileFarmDocsEdgeManifest !== "function") {
+    throw new Error(
+      `Farm docs adapter ${JSON.stringify(docs.adapter.id)} does not export compileFarmDocsEdgeManifest from ${JSON.stringify(compilerEntry)}.`
+    );
+  }
+  const manifest = await compilerModule.compileFarmDocsEdgeManifest(
+    createFarmDocsAdapterRuntimeConfig(docs, options),
+    {
+      rootDir: options.root,
+      clientEntry: options.clientEntry,
+      stylesheets: getFarmDocsAdapterStylesheets(options)
+    }
+  );
+  if (!manifest || manifest.protocol !== 1 || !manifest.routes || typeof manifest.routes !== "object" || !manifest.api || typeof manifest.api !== "object") {
+    throw new Error(
+      `Farm docs adapter ${JSON.stringify(docs.adapter.id)} returned an invalid edge manifest.`
+    );
+  }
+  return manifest;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, compileFarmDocsAdapterEdgeManifest, "compileFarmDocsAdapterEdgeManifest");
+async function createFarmDocsAdapterHandler(docs, options) {
+  if (!hasFarmDocsRuntimeAdapter(docs)) {
+    throw new Error("Farm docs adapter requires server and react runtime entrypoints.");
+  }
+  const serverModule = await options.loadModule(
+    docs.adapter.server
+  );
+  if (typeof serverModule.createFarmDocsRuntimeHandler !== "function") {
+    const adapterId = JSON.stringify(docs.adapter.id);
+    const serverEntry = JSON.stringify(docs.adapter.server);
+    throw new Error(
+      `Farm docs adapter ${adapterId} does not export createFarmDocsRuntimeHandler from ${serverEntry}. Upgrade the adapter to a runtime-enabled release.`
+    );
+  }
+  const runtimeConfig = createFarmDocsAdapterRuntimeConfig(docs, options);
+  return serverModule.createFarmDocsRuntimeHandler(runtimeConfig, {
+    rootDir: options.root,
+    clientEntry: options.clientEntry,
+    stylesheets: getFarmDocsAdapterStylesheets(options),
+    resolveLayoutFonts: options.resolveLayoutFonts,
+    loadReactModule: /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, () => options.loadModule(docs.adapter.react), "loadReactModule")
+  });
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, createFarmDocsAdapterHandler, "createFarmDocsAdapterHandler");
+
+// src/docs/api.ts
+
+
+
+
+
+
+
+
+
+
+
+
+
+var _docs = require('@farming-labs/docs');
+var _server = require('@farming-labs/docs/server');
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, isRecord, "isRecord");
+function isResolvedDocsConfig(value) {
+  return isRecord(value) && typeof value.enabled === "boolean" && typeof value.entry === "string" && isRecord(value.config);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, isResolvedDocsConfig, "isResolvedDocsConfig");
+function isFarmDocsAPIRequest(requestOrPathname) {
+  const pathname = typeof requestOrPathname === "string" ? requestOrPathname : new URL(requestOrPathname.url).pathname;
+  return pathname === "/api/docs" || pathname.startsWith("/api/docs/");
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, isFarmDocsAPIRequest, "isFarmDocsAPIRequest");
+function json(data, init = {}) {
+  const headers = new Headers(init.headers);
+  if (!headers.has("Content-Type")) {
+    headers.set("Content-Type", "application/json");
+  }
+  return new Response(JSON.stringify(data), { ...init, headers });
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, json, "json");
+function text(content, contentType, init = {}) {
+  const headers = new Headers(init.headers);
+  headers.set("Content-Type", contentType);
+  return new Response(content, { ...init, headers });
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, text, "text");
+function omitHeadBody(response) {
+  return new Response(null, {
+    status: response.status,
+    statusText: response.statusText,
+    headers: response.headers
+  });
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, omitHeadBody, "omitHeadBody");
+function normalizeAction(value) {
+  return _optionalChain([value, 'optionalAccess', _4 => _4.trim, 'call', _5 => _5(), 'access', _6 => _6.toLowerCase, 'call', _7 => _7(), 'access', _8 => _8.replace, 'call', _9 => _9(/_/g, "-")]) || void 0;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, normalizeAction, "normalizeAction");
+function getDocsTitle(docs) {
+  return typeof docs.config.nav === "object" && docs.config.nav && "title" in docs.config.nav ? String(docs.config.nav.title || "Documentation") : "Documentation";
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, getDocsTitle, "getDocsTitle");
+function isDocsCloudServer(value) {
+  return isRecord(value) && typeof value.handleRequest === "function";
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, isDocsCloudServer, "isDocsCloudServer");
+function resolveDocsCloudIntegration(integration) {
+  if (!integration) return void 0;
+  if (isDocsCloudServer(integration)) {
+    return { docsCloud: integration, routeOptions: {} };
+  }
+  if (!integration.docsCloud) return void 0;
+  return {
+    docsCloud: integration.docsCloud,
+    routeOptions: {
+      locale: integration.locale,
+      publicBaseUrl: integration.publicBaseUrl
+    }
+  };
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, resolveDocsCloudIntegration, "resolveDocsCloudIntegration");
+function isDocsCloudGetRequest(request) {
+  const url = new URL(request.url);
+  const cloud = normalizeAction(url.searchParams.get("cloud"));
+  const action = normalizeAction(url.searchParams.get("action"));
+  const format = normalizeAction(url.searchParams.get("format"));
+  return cloud === "config" || cloud === "public-config" || action === "cloud-config" || action === "docs-cloud-config" || format === "cloud-config" || format === "docs-cloud-config";
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, isDocsCloudGetRequest, "isDocsCloudGetRequest");
+function isDocsCloudAction(action) {
+  return Boolean(
+    action && ["analytics", "track", "track-event", "event", "ask-ai", "ai", "chat", "docs-cloud"].includes(
+      action
+    )
+  );
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, isDocsCloudAction, "isDocsCloudAction");
+async function readJson(request) {
+  try {
+    return await request.clone().json();
+  } catch (e) {
+    return void 0;
+  }
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, readJson, "readJson");
+async function isDocsCloudPostRequest(request) {
+  const url = new URL(request.url);
+  const cloud = normalizeAction(url.searchParams.get("cloud"));
+  const action = normalizeAction(url.searchParams.get("action"));
+  if (isDocsCloudAction(cloud) || isDocsCloudAction(action)) return true;
+  const body = await readJson(request);
+  if (!isRecord(body)) return false;
+  const bodyAction = normalizeAction(typeof body.action === "string" ? body.action : void 0);
+  if (isDocsCloudAction(bodyAction)) return true;
+  if (typeof body.type === "string") return true;
+  if (isRecord(body.event) && typeof body.event.type === "string") return true;
+  if (isRecord(body.payload) && typeof body.payload.type === "string") return true;
+  return false;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, isDocsCloudPostRequest, "isDocsCloudPostRequest");
+function normalizeDocsApiSlug(value, docs) {
+  const entry = docs.entry.replace(/^\/+|\/+$/g, "");
+  let slug = (value || "").trim().replace(/^\/+|\/+$/g, "");
+  if (entry && slug === entry) return "";
+  if (entry && slug.startsWith(`${entry}/`)) {
+    slug = slug.slice(entry.length + 1);
+  }
+  let decoded = slug;
+  try {
+    decoded = decodeURIComponent(slug);
+  } catch (e2) {
+  }
+  return decoded.replace(/\.(mdx?|markdown)$/i, "");
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, normalizeDocsApiSlug, "normalizeDocsApiSlug");
+function getDocsAPIPathTarget(request) {
+  const pathname = new URL(request.url).pathname.replace(/\/+$/, "") || "/";
+  const prefix = "/api/docs";
+  if (pathname !== prefix && !pathname.startsWith(`${prefix}/`)) return {};
+  const rawValue = pathname === prefix ? "" : pathname.slice(prefix.length + 1);
+  const value = rawValue.replace(/^\/+|\/+$/g, "");
+  const normalizedValue = normalizeAction(value);
+  if (!value) return {};
+  if (normalizedValue === "agent" || normalizedValue === "agent.json" || normalizedValue === "agent/spec") {
+    return { format: "agent-spec" };
+  }
+  if (normalizedValue === "agents" || normalizedValue === "agents.md" || normalizedValue === "agent.md") {
+    return { format: "agents" };
+  }
+  if (normalizedValue === "skill" || normalizedValue === "skill.md") return { format: "skill" };
+  if (normalizedValue === "llms.txt") return { format: "llms" };
+  if (normalizedValue === "llms-full.txt") return { format: "llms-full" };
+  if (normalizedValue === "sitemap.md") return { format: "sitemap-md" };
+  if (normalizedValue === "sitemap.xml") return { format: "sitemap-xml" };
+  if (normalizedValue === "robots.txt") return { format: "robots" };
+  if (/\.(mdx?|markdown)$/i.test(value)) return { format: "markdown", slug: value };
+  return { slug: value };
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, getDocsAPIPathTarget, "getDocsAPIPathTarget");
+function getDocsAPIFormat(request) {
+  const url = new URL(request.url);
+  return normalizeAction(url.searchParams.get("format") || url.searchParams.get("type")) || getDocsAPIPathTarget(request).format;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, getDocsAPIFormat, "getDocsAPIFormat");
+function getDocsDescription(docs) {
+  return _optionalChain([docs, 'access', _10 => _10.config, 'access', _11 => _11.metadata, 'optionalAccess', _12 => _12.description]);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, getDocsDescription, "getDocsDescription");
+function getLoadedDocsPages(context) {
+  return _chunkGNEO2XOFcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs).map((page) => _chunkGNEO2XOFcjs.loadFarmDocsPage.call(void 0, context.contentDir, context.docs, page.slug)).filter((page) => Boolean(page));
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, getLoadedDocsPages, "getLoadedDocsPages");
+function toDocsSourcePage(page) {
+  return {
+    ..._chunkGNEO2XOFcjs.toFarmDocsMarkdownPage.call(void 0, page),
+    sourcePath: page.sourcePath
+  };
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, toDocsSourcePage, "toDocsSourcePage");
+function toDocsSitemapPage(page) {
+  return {
+    ..._chunkGNEO2XOFcjs.toFarmDocsMarkdownPage.call(void 0, page),
+    sourcePath: page.sourcePath
+  };
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, toDocsSitemapPage, "toDocsSitemapPage");
+function toDocsLlmsPage(page) {
+  return _chunkGNEO2XOFcjs.toFarmDocsMarkdownPage.call(void 0, page);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, toDocsLlmsPage, "toDocsLlmsPage");
+function getDocsLlmsOptions(context, request) {
+  const configured = isRecord(context.docs.config.llmsTxt) ? context.docs.config.llmsTxt : {};
+  return {
+    enabled: true,
+    baseUrl: new URL(request.url).origin,
+    siteTitle: getDocsTitle(context.docs),
+    siteDescription: getDocsDescription(context.docs),
+    ...configured
+  };
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, getDocsLlmsOptions, "getDocsLlmsOptions");
+function getDocsDiscoveryOptions(context, request) {
+  const origin = new URL(request.url).origin;
+  return {
+    origin,
+    entry: context.docs.entry,
+    i18n: null,
+    search: _nullishCoalesce(context.docs.config.search, () => ( true)),
+    mcp: {
+      enabled: false,
+      route: "/api/docs/mcp",
+      name: `${getDocsTitle(context.docs)} MCP`,
+      version: "1",
+      tools: {
+        listDocs: false,
+        listPages: false,
+        readPage: false,
+        searchDocs: false,
+        getNavigation: false,
+        getCodeExamples: false,
+        getConfigSchema: false,
+        getContext: false
+      }
+    },
+    feedback: void 0,
+    llms: getDocsLlmsOptions(context, request),
+    sitemap: _nullishCoalesce(context.docs.config.sitemap, () => ( true)),
+    robots: _nullishCoalesce(context.docs.config.robots, () => ( true)),
+    openapi: _server.resolveApiReferenceOpenApiDiscovery.call(void 0, context.docs.config.apiReference),
+    markdown: {
+      acceptHeader: true,
+      signatureAgentHeader: true
+    }
+  };
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, getDocsDiscoveryOptions, "getDocsDiscoveryOptions");
+function buildSitemapManifest(context, request) {
+  const origin = new URL(request.url).origin;
+  return _docs.buildDocsSitemapManifest.call(void 0, {
+    pages: getLoadedDocsPages(context).map(toDocsSitemapPage),
+    entry: context.docs.entry,
+    siteTitle: getDocsTitle(context.docs),
+    baseUrl: origin
+  });
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, buildSitemapManifest, "buildSitemapManifest");
+function renderLlmsTxt(context, request, full) {
+  const generated = _docs.renderDocsLlmsTxt.call(void 0, 
+    getLoadedDocsPages(context).map(toDocsLlmsPage),
+    getDocsLlmsOptions(context, request)
+  );
+  return full ? generated.llmsFullTxt : generated.llmsTxt;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, renderLlmsTxt, "renderLlmsTxt");
+function renderSkillDocument(context, request) {
+  const farmAliases = [
+    "## Farm API Route Aliases",
+    "",
+    "- Search JSON: /api/docs?query=<term>",
+    "- Config JSON: /api/docs?format=config",
+    "- Markdown by query: /api/docs?format=markdown&path=<slug>",
+    "- Markdown by path: /api/docs/<slug>.md",
+    "- LLM summary: /api/docs?format=llms",
+    "- Full LLM document: /api/docs?format=llms-full",
+    "- Sitemap XML: /api/docs?format=sitemap-xml",
+    "- Agent spec JSON: /api/docs/agent/spec"
+  ].join("\n");
+  return `${_docs.renderDocsSkillDocument.call(void 0, getDocsDiscoveryOptions(context, request)).trim()}
+
+${farmAliases}
+`;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, renderSkillDocument, "renderSkillDocument");
+function renderAgentsDocument(context, request) {
+  return `${_docs.renderDocsAgentsDocument.call(void 0, getDocsDiscoveryOptions(context, request)).trim()}
+`;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, renderAgentsDocument, "renderAgentsDocument");
+function buildAgentSpec(context, request) {
+  const url = new URL(request.url);
+  const origin = url.origin;
+  const pages = _chunkGNEO2XOFcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs);
+  const spec = _docs.buildDocsAgentDiscoverySpec.call(void 0, getDocsDiscoveryOptions(context, request));
+  const title = getDocsTitle(context.docs);
+  return {
+    ...spec,
+    name: title,
+    site: {
+      ...spec.site,
+      title,
+      description: getDocsDescription(context.docs),
+      entry: context.docs.entry
+    },
+    entry: context.docs.entry,
+    routes: {
+      docs: `${origin}${context.docs.entry}`,
+      config: `${origin}/api/docs?format=config`,
+      search: `${origin}/api/docs?query=<term>`,
+      markdown: `${origin}/api/docs/<slug>.md`,
+      markdownQuery: `${origin}/api/docs?format=markdown&path=<slug>`,
+      llms: `${origin}/api/docs?format=llms`,
+      llmsFull: `${origin}/api/docs?format=llms-full`,
+      sitemapXml: `${origin}/api/docs?format=sitemap-xml`,
+      sitemapMarkdown: `${origin}/api/docs?format=sitemap-md`,
+      robots: `${origin}/api/docs?format=robots`,
+      skill: `${origin}/api/docs?format=skill`,
+      agents: `${origin}/api/docs?format=agents`,
+      agentSpec: `${origin}/api/docs/agent/spec`
+    },
+    capabilities: {
+      ...spec.capabilities,
+      search: spec.capabilities.search,
+      markdown: spec.capabilities.markdownRoutes,
+      llms: spec.capabilities.llms,
+      sitemap: spec.capabilities.sitemap,
+      robots: spec.capabilities.robots,
+      post: false
+    },
+    pages
+  };
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, buildAgentSpec, "buildAgentSpec");
+function buildDiagnostics(context) {
+  const pages = _chunkGNEO2XOFcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs);
+  const diagnostics = _docs.buildDocsDiagnostics.call(void 0, context.docs.config, {
+    entry: context.docs.entry,
+    mcp: {
+      enabled: false,
+      route: "/api/docs/mcp",
+      name: `${getDocsTitle(context.docs)} MCP`,
+      version: "1",
+      tools: {
+        listDocs: false,
+        listPages: false,
+        readPage: false,
+        searchDocs: false,
+        getNavigation: false,
+        getCodeExamples: false,
+        getConfigSchema: false,
+        getContext: false
+      }
+    }
+  });
+  return {
+    ...diagnostics,
+    enabled: context.docs.enabled,
+    entry: context.docs.entry,
+    root: context.root,
+    srcDir: context.srcDir,
+    contentDir: context.contentDir,
+    configPath: context.docs.configPath || null,
+    pageCount: pages.length,
+    pages
+  };
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, buildDiagnostics, "buildDiagnostics");
+async function searchDocs(context, request, query) {
+  const loadedPages = getLoadedDocsPages(context);
+  const sourcePages = loadedPages.map(toDocsSourcePage);
+  const sourcePageByUrl = new Map(sourcePages.map((page) => [page.url, page]));
+  const resultLimit = isRecord(context.docs.config.search) && typeof context.docs.config.search.maxResults === "number" ? context.docs.config.search.maxResults : void 0;
+  const results = await _docs.performDocsSearch.call(void 0, {
+    pages: sourcePages,
+    query,
+    search: _nullishCoalesce(context.docs.config.search, () => ( true)),
+    pathname: new URL(request.url).pathname,
+    siteTitle: getDocsTitle(context.docs),
+    limit: resultLimit
+  });
+  return results.map((result) => {
+    const pageUrl = result.url.split("#")[0];
+    const page = sourcePageByUrl.get(pageUrl);
+    return {
+      ...result,
+      title: _optionalChain([page, 'optionalAccess', _13 => _13.title]) || result.content,
+      href: _optionalChain([page, 'optionalAccess', _14 => _14.url]) || pageUrl,
+      description: result.description || _optionalChain([page, 'optionalAccess', _15 => _15.description])
+    };
+  });
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, searchDocs, "searchDocs");
+async function resolveAPIContext(options) {
+  const runtimeConfig = globalThis.__FARM_DOCS_RUNTIME_CONFIG__;
+  const root = options.rootDir || options.root || _optionalChain([runtimeConfig, 'optionalAccess', _16 => _16.root]) || process.cwd();
+  const srcDir = options.srcDir || _optionalChain([runtimeConfig, 'optionalAccess', _17 => _17.srcDir]) || "src";
+  const canUseRuntimeDocs = options.docs === void 0 && options.config === void 0 && options.configPath === void 0 && options.entry === void 0 && options.docsPath === void 0 && options.contentDir === void 0 && options.root === void 0 && options.rootDir === void 0 && options.srcDir === void 0;
+  const docsInput = _nullishCoalesce(_nullishCoalesce(options.docs, () => ( (canUseRuntimeDocs ? _optionalChain([runtimeConfig, 'optionalAccess', _18 => _18.docs]) : void 0))), () => ( {
+    enabled: true,
+    entry: options.entry,
+    docsPath: options.docsPath,
+    contentDir: options.contentDir,
+    config: options.config,
+    configPath: options.configPath
+  }));
+  const docs = isResolvedDocsConfig(docsInput) ? docsInput : await _chunkNV3A5DXMcjs.resolveDocsConfig.call(void 0, docsInput, { root, srcDir });
+  return {
+    root,
+    srcDir,
+    docs,
+    contentDir: _chunkGNEO2XOFcjs.resolveFarmDocsContentDir.call(void 0, docs, { root, srcDir })
+  };
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, resolveAPIContext, "resolveAPIContext");
+async function handleDocsAPIGet(request, context) {
+  if (!context.docs.enabled) {
+    return json({ error: "Docs are disabled" }, { status: 404 });
+  }
+  const url = new URL(request.url);
+  const format = getDocsAPIFormat(request);
+  const pathTarget = getDocsAPIPathTarget(request);
+  if (format === "config" || format === "docs-config") {
+    return json({
+      entry: context.docs.entry,
+      contentDir: context.docs.contentDir || context.docs.config.contentDir || null,
+      config: context.docs.config,
+      map: _docs.buildDocsConfigMap.call(void 0, context.docs.config, {
+        file: context.docs.configPath || "farm.config.ts"
+      })
+    });
+  }
+  if (format === "skill")
+    return text(renderSkillDocument(context, request), "text/markdown; charset=utf-8");
+  if (format === "agents")
+    return text(renderAgentsDocument(context, request), "text/markdown; charset=utf-8");
+  if (format === "agent" || format === "agent-spec") return json(buildAgentSpec(context, request));
+  if (format === "diagnostics") return json(buildDiagnostics(context));
+  if (format === "llms")
+    return text(renderLlmsTxt(context, request, false), "text/plain; charset=utf-8");
+  if (format === "llms-full")
+    return text(renderLlmsTxt(context, request, true), "text/plain; charset=utf-8");
+  if (format === "sitemap-md") {
+    return text(
+      _docs.renderDocsSitemapMarkdown.call(void 0, buildSitemapManifest(context, request), {
+        includeDescriptions: true
+      }),
+      "text/markdown; charset=utf-8"
+    );
+  }
+  if (format === "sitemap-xml" || format === "sitemap") {
+    const origin = new URL(request.url).origin;
+    return text(
+      _docs.renderDocsSitemapXml.call(void 0, buildSitemapManifest(context, request), {
+        baseUrl: origin,
+        includeLastmod: true
+      }),
+      "application/xml; charset=utf-8"
+    );
+  }
+  if (format === "robots") {
+    return text(
+      _docs.renderDocsRobotsTxt.call(void 0, {
+        entry: context.docs.entry,
+        sitemap: _nullishCoalesce(context.docs.config.sitemap, () => ( true)),
+        robots: _nullishCoalesce(context.docs.config.robots, () => ( true)),
+        baseUrl: new URL(request.url).origin
+      }),
+      "text/plain; charset=utf-8"
+    );
+  }
+  if (format === "markdown" || url.pathname.endsWith(".md")) {
+    const pathParam = url.searchParams.get("path") || url.searchParams.get("slug");
+    const slug = normalizeDocsApiSlug(_nullishCoalesce(_nullishCoalesce(pathParam, () => ( pathTarget.slug)), () => ( "")), context.docs);
+    const page = _chunkGNEO2XOFcjs.loadFarmDocsPage.call(void 0, context.contentDir, context.docs, slug);
+    if (!page) return text("Docs page not found\n", "text/plain; charset=utf-8", { status: 404 });
+    return text(
+      _docs.renderDocsMarkdownDocument.call(void 0, _chunkGNEO2XOFcjs.toFarmDocsMarkdownPage.call(void 0, page), {
+        origin: new URL(request.url).origin,
+        llms: getDocsLlmsOptions(context, request),
+        sitemap: context.docs.config.sitemap
+      }),
+      "text/markdown; charset=utf-8"
+    );
+  }
+  const query = url.searchParams.get("query") || url.searchParams.get("q") || "";
+  if (!query.trim()) return json([]);
+  return json(await searchDocs(context, request, query));
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, handleDocsAPIGet, "handleDocsAPIGet");
+function createDocsAPI(options = {}, cloudIntegration) {
+  let contextPromise;
+  const getContext = /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, () => {
+    _nullishCoalesce(contextPromise, () => ( (contextPromise = resolveAPIContext(options))));
+    return contextPromise;
+  }, "getContext");
+  const integration = resolveDocsCloudIntegration(cloudIntegration);
+  return {
+    async GET(request) {
+      if (integration && isDocsCloudGetRequest(request)) {
+        return integration.docsCloud.handleRequest(request, integration.routeOptions);
+      }
+      return handleDocsAPIGet(request, await getContext());
+    },
+    async POST(request) {
+      if (integration && await isDocsCloudPostRequest(request)) {
+        return integration.docsCloud.handleRequest(request, integration.routeOptions);
+      }
+      return json(
+        {
+          error: "AI is not enabled for this Farm docs API route yet."
+        },
+        { status: 501 }
+      );
+    }
+  };
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, createDocsAPI, "createDocsAPI");
+function createFarmDocsAPIHandler(options = {}, cloudIntegration) {
+  const handlers = createDocsAPI(options, cloudIntegration);
+  return /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, async function handleFarmDocsAPIRequest(request) {
+    if (!isFarmDocsAPIRequest(request)) return null;
+    const method = request.method.toUpperCase();
+    if (method === "GET" || method === "HEAD") {
+      const response = await handlers.GET(request);
+      return method === "HEAD" ? omitHeadBody(response) : response;
+    }
+    if (method === "POST") {
+      return handlers.POST(request);
+    }
+    return json(
+      {
+        error: "Method Not Allowed"
+      },
+      {
+        status: 405,
+        headers: {
+          Allow: "GET, HEAD, POST"
+        }
+      }
+    );
+  }, "handleFarmDocsAPIRequest");
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, createFarmDocsAPIHandler, "createFarmDocsAPIHandler");
+
+
+
+
+
+
+
+
+exports.hasFarmDocsRuntimeAdapter = hasFarmDocsRuntimeAdapter; exports.compileFarmDocsAdapterEdgeManifest = compileFarmDocsAdapterEdgeManifest; exports.createFarmDocsAdapterHandler = createFarmDocsAdapterHandler; exports.isFarmDocsAPIRequest = isFarmDocsAPIRequest; exports.createDocsAPI = createDocsAPI; exports.createFarmDocsAPIHandler = createFarmDocsAPIHandler;