@farm.js/core 0.1.47 → 0.1.48

package/dist/chunk-SBABQKPT.cjs

@@ -0,0 +1,169 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); 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 _chunkHIFIG6HLcjs = require('./chunk-HIFIG6HL.cjs');
+
+
+
+var _chunkWJFFPXCVcjs = require('./chunk-WJFFPXCV.cjs');
+
+
+
+var _chunk6ONBZGVHcjs = require('./chunk-6ONBZGVH.cjs');
+
+
+
+var _chunkD22BUQKWcjs = require('./chunk-D22BUQKW.cjs');
+
+// src/agent-mcp.ts
+var FARM_DEFAULT_MCP_PATH = "/mcp";
+var FARM_DEFAULT_MCP_PROTOCOL_VERSIONS = [
+  "2025-11-25",
+  "2025-06-18",
+  "2025-03-26",
+  "2024-11-05"
+];
+var FARM_DEFAULT_MCP_DESCRIPTION = "Read-only access to this site's public pages: list, search, and read them as Markdown.";
+var READ_ONLY = {
+  readOnlyHint: true,
+  destructiveHint: false,
+  idempotentHint: true,
+  openWorldHint: false
+};
+var PAGE_SCHEMA = {
+  type: "object",
+  properties: {
+    path: { type: "string", description: `The page's path, such as "/about".` },
+    title: { type: "string" },
+    url: { type: "string", description: "The page's absolute URL." },
+    description: { type: "string" }
+  },
+  required: ["path", "title", "url"]
+};
+var PAGES_OUTPUT_SCHEMA = {
+  type: "object",
+  properties: { pages: { type: "array", items: PAGE_SCHEMA } },
+  required: ["pages"]
+};
+var FARM_DEFAULT_MCP_TOOLS = [
+  {
+    name: "list_pages",
+    title: "List pages",
+    description: "List this site's public pages with each page's path, title, URL, and description. Pass a page's path to read_page to read it as Markdown.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false },
+    outputSchema: PAGES_OUTPUT_SCHEMA,
+    annotations: READ_ONLY
+  },
+  {
+    name: "search_pages",
+    title: "Search pages",
+    description: "Search this site's public pages by title, description, and path. Every word of the query must match. Returns the matching pages, best match first.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: {
+          type: "string",
+          minLength: 1,
+          maxLength: 200,
+          description: 'Words to look for, such as "pricing" or "getting started".'
+        },
+        limit: {
+          type: "integer",
+          minimum: 1,
+          maximum: 50,
+          default: 10,
+          description: "The most pages to return."
+        }
+      },
+      required: ["query"],
+      additionalProperties: false
+    },
+    outputSchema: PAGES_OUTPUT_SCHEMA,
+    annotations: READ_ONLY
+  },
+  {
+    name: "read_page",
+    title: "Read a page",
+    description: `Read one of this site's public pages as Markdown. Takes a path from list_pages or search_pages, such as "/" or "/about".`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: {
+          type: "string",
+          minLength: 1,
+          maxLength: 2048,
+          description: `The page's path, such as "/about", or its full URL on this site.`
+        }
+      },
+      required: ["path"],
+      additionalProperties: false
+    },
+    annotations: READ_ONLY
+  }
+];
+function collectFarmDefaultMCPPages(sources, options) {
+  const readable = [];
+  for (const source of sources) {
+    const module = isRecord(source.module) ? source.module : void 0;
+    if (_optionalChain([module, 'optionalAccess', _ => _.__farmRouteGuard])) continue;
+    if (!_chunkWJFFPXCVcjs.isFarmMarkdownMirrorExposed.call(void 0, options.markdown, source.pattern)) continue;
+    readable.push({ pattern: source.pattern, metadata: _optionalChain([module, 'optionalAccess', _2 => _2.metadata]) });
+  }
+  return _chunkHIFIG6HLcjs.collectFarmLlmsTxtPages.call(void 0, readable, {
+    origin: options.origin,
+    basePath: options.basePath,
+    markdown: options.markdown
+  }).map((page) => ({
+    path: page.path,
+    title: page.title,
+    url: `${options.origin}${_chunkD22BUQKWcjs.applyFarmBasePath.call(void 0, page.path, options.basePath)}`,
+    ...page.description ? { description: page.description } : {},
+    markdownUrl: `${options.origin}${_chunkD22BUQKWcjs.applyFarmBasePath.call(void 0, 
+      _chunkWJFFPXCVcjs.getFarmMarkdownMirrorPath.call(void 0, page.path),
+      options.basePath
+    )}`
+  }));
+}
+function createFarmDefaultMCPServer(app, farmVersion) {
+  const name = typeof _optionalChain([app, 'optionalAccess', _3 => _3.name]) === "string" && app.name.trim() ? app.name.trim() : "farm-app";
+  const version = typeof _optionalChain([app, 'optionalAccess', _4 => _4.version]) === "string" && app.version.trim() ? app.version.trim() : farmVersion;
+  return {
+    name,
+    version,
+    description: FARM_DEFAULT_MCP_DESCRIPTION,
+    protocolVersions: [...FARM_DEFAULT_MCP_PROTOCOL_VERSIONS],
+    path: FARM_DEFAULT_MCP_PATH
+  };
+}
+function resolveFarmDefaultMCPServer(server) {
+  if (!server) return void 0;
+  if (_chunk6ONBZGVHcjs._listFarmMCPCatalogs.call(void 0, ).length > 0 || _chunk6ONBZGVHcjs._listFarmRegisteredMCPServers.call(void 0, ).length > 0) {
+    return void 0;
+  }
+  return server;
+}
+function isFarmDefaultMCPPathname(pathname, basePath) {
+  const path = _chunkD22BUQKWcjs.stripFarmBasePath.call(void 0, pathname, basePath);
+  return path === FARM_DEFAULT_MCP_PATH || path === `${FARM_DEFAULT_MCP_PATH}/`;
+}
+function farmConfigMountsMCP(config) {
+  const { mcp } = config;
+  if (isRecord(mcp) && mcp.enabled !== false) return true;
+  return Boolean(
+    _optionalChain([config, 'access', _5 => _5.plugins, 'optionalAccess', _6 => _6.some, 'call', _7 => _7((plugin) => isRecord(plugin) && plugin.name === "farm:api-mcp")])
+  );
+}
+function isRecord(value) {
+  return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+
+
+
+
+
+
+
+
+
+
+
+exports.FARM_DEFAULT_MCP_PATH = FARM_DEFAULT_MCP_PATH; exports.FARM_DEFAULT_MCP_PROTOCOL_VERSIONS = FARM_DEFAULT_MCP_PROTOCOL_VERSIONS; exports.FARM_DEFAULT_MCP_DESCRIPTION = FARM_DEFAULT_MCP_DESCRIPTION; exports.FARM_DEFAULT_MCP_TOOLS = FARM_DEFAULT_MCP_TOOLS; exports.collectFarmDefaultMCPPages = collectFarmDefaultMCPPages; exports.createFarmDefaultMCPServer = createFarmDefaultMCPServer; exports.resolveFarmDefaultMCPServer = resolveFarmDefaultMCPServer; exports.isFarmDefaultMCPPathname = isFarmDefaultMCPPathname; exports.farmConfigMountsMCP = farmConfigMountsMCP;

package/dist/chunk-SBDWCDS6.cjs

@@ -0,0 +1,8 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/api/route-files.ts
+function isFarmAPIRouteFileName(fileName) {
+  return /^route\.(?:ts|tsx|js|jsx)$/.test(fileName);
+}
+
+
+
+exports.isFarmAPIRouteFileName = isFarmAPIRouteFileName;

package/dist/chunk-SF3JB56B.mjs

@@ -0,0 +1,82 @@
+// src/base-path.ts
+var FARM_BASE_PATH = /* @__PURE__ */ Symbol.for("farm.basePath");
+function getFarmGlobalState() {
+  return globalThis;
+}
+function setFarmBasePath(basePath) {
+  getFarmGlobalState()[FARM_BASE_PATH] = normalizeFarmBasePath(basePath);
+}
+function getFarmBasePath() {
+  return getFarmGlobalState()[FARM_BASE_PATH] ?? "";
+}
+function applyFarmBasePath(href, basePath = getFarmBasePath()) {
+  const normalizedBasePath = normalizeFarmBasePath(basePath);
+  if (!normalizedBasePath || !href.startsWith("/") || href.startsWith("//")) return href;
+  const canonicalHref = canonicalizeAppRelativeHref(href);
+  if (canonicalHref === normalizedBasePath || canonicalHref.startsWith(`${normalizedBasePath}/`) || canonicalHref.startsWith(`${normalizedBasePath}?`) || canonicalHref.startsWith(`${normalizedBasePath}#`)) {
+    return canonicalHref;
+  }
+  return `${normalizedBasePath}${canonicalHref}`;
+}
+function canonicalizeAppRelativeHref(href) {
+  const origin = "http://farm.local";
+  const resolved = new URL(href, origin);
+  if (resolved.origin !== origin) {
+    throw new Error("Farm app-relative href cannot change the URL origin.");
+  }
+  return `${resolved.pathname}${resolved.search}${resolved.hash}`;
+}
+function stripFarmBasePath(pathname, basePath = getFarmBasePath()) {
+  const normalizedBasePath = normalizeFarmBasePath(basePath);
+  if (!normalizedBasePath) return pathname || "/";
+  if (pathname === normalizedBasePath) return "/";
+  if (!pathname.startsWith(`${normalizedBasePath}/`)) return pathname || "/";
+  return pathname.slice(normalizedBasePath.length) || "/";
+}
+function normalizeFarmBasePath(basePath) {
+  if (!basePath || basePath === "/") return "";
+  const hasUnstableCharacters = (candidate) => candidate.includes("\\") || Array.from(candidate).some((character) => {
+    const code = character.charCodeAt(0);
+    return code <= 31 || code >= 127 && code <= 159;
+  });
+  if (hasUnstableCharacters(basePath)) {
+    throw new Error("Farm basePath cannot contain backslashes or control characters.");
+  }
+  const pathname = basePath.trim();
+  if (!pathname || pathname === "/") return "";
+  if (pathname.includes("?") || pathname.includes("#")) {
+    throw new Error("Farm basePath cannot contain a query string or hash.");
+  }
+  if (pathname.startsWith("//") || /^[a-z][a-z\d+.-]*:\/\//i.test(pathname)) {
+    throw new Error('Farm basePath must be a pathname such as "/docs", not a URL.');
+  }
+  for (const segment of pathname.split("/")) {
+    let decoded = segment;
+    try {
+      decoded = decodeURIComponent(segment);
+    } catch {
+    }
+    if (hasUnstableCharacters(decoded)) {
+      throw new Error("Farm basePath cannot contain backslashes or control characters.");
+    }
+    if (decoded.includes("/")) {
+      throw new Error("Farm basePath cannot contain percent-encoded path separators.");
+    }
+    if (decoded === "." || decoded === "..") {
+      throw new Error('Farm basePath cannot contain "." or ".." path segments.');
+    }
+  }
+  return `/${pathname}`.replace(/\/{2,}/g, "/").replace(/\/+$/, "");
+}
+function normalizeFarmConfigBasePath(basePath) {
+  return normalizeFarmBasePath(basePath) || "/";
+}
+
+export {
+  setFarmBasePath,
+  getFarmBasePath,
+  applyFarmBasePath,
+  stripFarmBasePath,
+  normalizeFarmBasePath,
+  normalizeFarmConfigBasePath
+};

package/dist/chunk-SG57PX7K.cjs

@@ -0,0 +1,65 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }// src/app-manifest-config.ts
+var NAME = "agent.manifest";
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function checkKeys(value, keys, name) {
+  for (const key of Object.keys(value)) {
+    if (!keys.includes(key)) {
+      throw new TypeError(`${name} has an unknown option "${key}"; expected ${keys.join(", ")}.`);
+    }
+  }
+}
+function readBoolean(value, name, fallback = true) {
+  if (value === void 0) return fallback;
+  if (typeof value !== "boolean") throw new TypeError(`${name} must be a boolean.`);
+  return value;
+}
+function readHide(value, name) {
+  if (value === void 0) return [];
+  if (!Array.isArray(value) || value.some((entry) => typeof entry !== "string" || !entry.trim())) {
+    throw new TypeError(`${name} must be an array of non-empty strings.`);
+  }
+  return [...new Set(value.map((entry) => entry.trim()))];
+}
+function readSection(value, name, keys, read) {
+  if (value === false) return false;
+  if (value === void 0 || value === true) return read({});
+  if (!isObject(value)) throw new TypeError(`${name} must be true, false, or an options object.`);
+  checkKeys(value, keys, name);
+  return read(value);
+}
+function resolveFarmAppManifestConfig(input) {
+  if (input === false) return false;
+  if (input !== void 0 && input !== true && !isObject(input)) {
+    throw new TypeError(`${NAME} must be true, false, or an options object.`);
+  }
+  const config = isObject(input) ? input : {};
+  checkKeys(config, ["app", "packages", "mcp", "webmcp", "integrations", "agent", "plugins"], NAME);
+  const packages = config.packages;
+  if (packages !== void 0 && typeof packages !== "boolean" && packages !== "names") {
+    throw new TypeError(`${NAME}.packages must be true, false, or "names".`);
+  }
+  return {
+    app: readSection(config.app, `${NAME}.app`, ["version", "renderer", "build"], (app) => ({
+      version: readBoolean(app.version, `${NAME}.app.version`),
+      renderer: readBoolean(app.renderer, `${NAME}.app.renderer`),
+      build: readBoolean(app.build, `${NAME}.app.build`)
+    })),
+    packages: _nullishCoalesce(packages, () => ( true)),
+    mcp: readSection(config.mcp, `${NAME}.mcp`, ["schemas", "hide"], (mcp) => ({
+      schemas: readBoolean(mcp.schemas, `${NAME}.mcp.schemas`),
+      hide: readHide(mcp.hide, `${NAME}.mcp.hide`)
+    })),
+    webmcp: readSection(config.webmcp, `${NAME}.webmcp`, ["hide"], (webmcp) => ({
+      hide: readHide(webmcp.hide, `${NAME}.webmcp.hide`)
+    })),
+    integrations: readBoolean(config.integrations, `${NAME}.integrations`),
+    agent: readBoolean(config.agent, `${NAME}.agent`),
+    plugins: readBoolean(config.plugins, `${NAME}.plugins`)
+  };
+}
+
+
+
+exports.resolveFarmAppManifestConfig = resolveFarmAppManifestConfig;

package/dist/chunk-SGBNF56S.cjs

@@ -0,0 +1,44 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); 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; }// src/deployment-environment.ts
+function isFarmProductionDeploymentEnvironment(env = process.env) {
+  const environment = normalizeEnvironment(env.VERCEL_ENV);
+  const targetEnvironment = normalizeEnvironment(env.VERCEL_TARGET_ENV);
+  if (environment && environment !== "production") return false;
+  if (targetEnvironment && targetEnvironment !== "production") return false;
+  if (isTrue(env.NETLIFY)) {
+    const context = normalizeEnvironment(env.CONTEXT);
+    if (context && context !== "production") return false;
+  }
+  if (isTrue(env.IS_PULL_REQUEST)) return false;
+  return true;
+}
+function isFarmPreviewDeploymentEnvironment(env) {
+  return resolveFarmPreviewDeployment(env, false);
+}
+function resolveFarmPreviewDeployment(env, builtAsPreview) {
+  const explicit = _optionalChain([env, 'optionalAccess', _ => _.FARM_PREVIEW]);
+  if (isTrue(explicit)) return true;
+  if (isFalse(explicit)) return false;
+  if (builtAsPreview || !env) return builtAsPreview;
+  if (normalizeEnvironment(env.VERCEL_ENV) === "preview") return true;
+  if (isTrue(env.NETLIFY)) {
+    const context = normalizeEnvironment(env.CONTEXT);
+    if (context === "deploy-preview" || context === "branch-deploy") return true;
+  }
+  return isTrue(env.IS_PULL_REQUEST);
+}
+function normalizeEnvironment(value) {
+  const normalized = _optionalChain([value, 'optionalAccess', _2 => _2.trim, 'call', _3 => _3(), 'access', _4 => _4.toLowerCase, 'call', _5 => _5()]);
+  return normalized || void 0;
+}
+function isTrue(value) {
+  return value !== void 0 && ["1", "true", "yes", "on"].includes(value.toLowerCase());
+}
+function isFalse(value) {
+  return value !== void 0 && ["0", "false", "no", "off"].includes(value.toLowerCase());
+}
+
+
+
+
+
+exports.isFarmProductionDeploymentEnvironment = isFarmProductionDeploymentEnvironment; exports.isFarmPreviewDeploymentEnvironment = isFarmPreviewDeploymentEnvironment; exports.resolveFarmPreviewDeployment = resolveFarmPreviewDeployment;

package/dist/chunk-SHD265HW.cjs

@@ -0,0 +1,19 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/schema-capabilities.ts
+function assertNoSchemaListField(field, fieldPath, target) {
+  if (!field.list) {
+    return;
+  }
+  throw new Error(
+    `Schema field "${fieldPath}" declares list: true, but ${target} does not support list fields. Use type: "json" for an array value or model the values in a related table.`
+  );
+}
+
+// src/schema-reference.ts
+function isDatabaseEnforcedReference(reference) {
+  return reference.enforced === void 0 || reference.enforced === "db";
+}
+
+
+
+
+exports.assertNoSchemaListField = assertNoSchemaListField; exports.isDatabaseEnforcedReference = isDatabaseEnforcedReference;

package/dist/chunk-SHIWRBFI.cjs

@@ -0,0 +1,17 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/secret-compare.ts
+function farmSecretsMatch(provided, expected) {
+  if (typeof provided !== "string" || typeof expected !== "string") return false;
+  if (expected.length === 0) return false;
+  let mismatch = provided.length ^ expected.length;
+  const length = Math.max(provided.length, expected.length);
+  for (let index = 0; index < length; index += 1) {
+    const providedCode = index < provided.length ? provided.charCodeAt(index) : 0;
+    const expectedCode = index < expected.length ? expected.charCodeAt(index) : 0;
+    mismatch |= providedCode ^ expectedCode;
+  }
+  return mismatch === 0;
+}
+
+
+
+exports.farmSecretsMatch = farmSecretsMatch;

package/dist/chunk-SM2SYWAR.cjs

@@ -0,0 +1,49 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); 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; }// src/docs/adapter-client.ts
+function getFarmDocsAdapterConfigModule(docs) {
+  if (!_optionalChain([docs, 'optionalAccess', _ => _.enabled]) || !_optionalChain([docs, 'access', _2 => _2.adapter, 'optionalAccess', _3 => _3.react]) || !docs.configPath) return void 0;
+  return docs.configPath.endsWith(".json") ? void 0 : docs.configPath.replace(/\\/g, "/");
+}
+function generateFarmDocsAdapterClientRuntime(reactModule, configModule) {
+  if (!reactModule) {
+    return `
+async function hydrateFarmDocsAdapterRuntime() {
+  return false;
+}
+`;
+  }
+  return `
+async function hydrateFarmDocsAdapterRuntime() {
+  const runtime = window.__FARM_DOCS_ADAPTER__;
+  if (!runtime) return false;
+  // The docs server flags pages whose config holds what its JSON copy cannot (icons,
+  // MDX components, callbacks); the adapter restores those from the module itself.
+  // Fetch it alongside the adapter rather than after it: they don't depend on each other.
+  const [FarmDocsAdapterReact, configModule] = await Promise.all([
+    import(${JSON.stringify(reactModule)}),
+    runtime.configModule ? ${configModule ? `import(${JSON.stringify(configModule)})` : "undefined"} : undefined,
+  ]);
+  if (typeof FarmDocsAdapterReact.hydrateFarmDocs !== "function") {
+    throw new Error("The configured Farm docs adapter does not export hydrateFarmDocs().");
+  }
+  FarmDocsAdapterReact.hydrateFarmDocs({
+    config: runtime.config || {},
+    data: runtime.data,
+    ...(configModule ? { configModule: configModule.default ?? configModule } : {}),
+  });
+  return true;
+}
+`;
+}
+
+// src/docs/config-secrets.ts
+function isSecretDocsConfigKey(key) {
+  const normalized = key.replace(/[-_]/g, "").toLowerCase();
+  if (!normalized || normalized.endsWith("env")) return false;
+  return /apikey|token|secret|password|authorization|credential/.test(normalized);
+}
+
+
+
+
+
+exports.getFarmDocsAdapterConfigModule = getFarmDocsAdapterConfigModule; exports.generateFarmDocsAdapterClientRuntime = generateFarmDocsAdapterClientRuntime; exports.isSecretDocsConfigKey = isSecretDocsConfigKey;

package/dist/chunk-SNP33A33.cjs

@@ -0,0 +1,9 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/utils/file-module.ts
+var _url = require('url');
+function toFileModuleUrl(filePath) {
+  return _url.pathToFileURL.call(void 0, filePath).href;
+}
+
+
+
+exports.toFileModuleUrl = toFileModuleUrl;