@farm.js/core 0.1.61 → 0.1.62

package/dist/chunk-QAS7KE7J.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 _chunkMEQN6DDAcjs = require('./chunk-MEQN6DDA.cjs');
+
+
+
+var _chunkLT4VAF5Zcjs = require('./chunk-LT4VAF5Z.cjs');
+
+
+
+var _chunkLRB5OVRTcjs = require('./chunk-LRB5OVRT.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 (!_chunkLT4VAF5Zcjs.isFarmMarkdownMirrorExposed.call(void 0, options.markdown, source.pattern)) continue;
+    readable.push({ pattern: source.pattern, metadata: _optionalChain([module, 'optionalAccess', _2 => _2.metadata]) });
+  }
+  return _chunkMEQN6DDAcjs.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, 
+      _chunkLT4VAF5Zcjs.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 (_chunkLRB5OVRTcjs._listFarmMCPCatalogs.call(void 0, ).length > 0 || _chunkLRB5OVRTcjs._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-QDWMCFTH.mjs

@@ -0,0 +1,434 @@
+import {
+  copyRequestContext
+} from "./chunk-D2LCAV6L.mjs";
+import {
+  assertBrowserStableRoutePath
+} from "./chunk-AYP2YFVN.mjs";
+
+// src/server-http.ts
+function createFarmNodeRequestAbortSignal(req, res) {
+  const controller = new AbortController();
+  let disposed = false;
+  const dispose = () => {
+    if (disposed) return;
+    disposed = true;
+    req.off("aborted", abort);
+    res.off("close", abortOnEarlyClose);
+    res.off("finish", dispose);
+    controller.signal.removeEventListener("abort", dispose);
+  };
+  const abort = () => controller.abort();
+  const abortOnEarlyClose = () => {
+    if (!res.writableEnded) abort();
+    dispose();
+  };
+  if (req.aborted) {
+    controller.abort();
+    return controller.signal;
+  }
+  req.once("aborted", abort);
+  res.once("close", abortOnEarlyClose);
+  res.once("finish", dispose);
+  controller.signal.addEventListener("abort", dispose, { once: true });
+  return controller.signal;
+}
+var DEFAULT_FARM_SERVER_BODY_SIZE_LIMIT = 1e7;
+var DEFAULT_FARM_SERVER_HEADERS_TIMEOUT = 6e4;
+var DEFAULT_FARM_SERVER_REQUEST_TIMEOUT = 3e5;
+var DEFAULT_FARM_SERVER_KEEP_ALIVE_TIMEOUT = 5e3;
+var DEFAULT_FARM_SERVER_GRACEFUL_SHUTDOWN_TIMEOUT = 3e4;
+var MAX_FARM_SERVER_TIMEOUT = 2147483647;
+function createFarmWeakETag(body) {
+  let hash = 2166136261;
+  for (let index = 0; index < body.length; index++) {
+    hash ^= body.charCodeAt(index);
+    hash = Math.imul(hash, 16777619);
+  }
+  return `W/"${(hash >>> 0).toString(16).padStart(8, "0")}"`;
+}
+function matchesFarmIfNoneMatch(value, etag) {
+  const expected = parseEntityTag(trimOptionalWhitespace(etag));
+  if (!expected) return false;
+  const values = Array.isArray(value) ? value : [value];
+  const combined = values.filter((header) => typeof header === "string").join(",");
+  const fieldValue = trimOptionalWhitespace(combined);
+  if (!fieldValue) return false;
+  if (fieldValue === "*") return true;
+  let matched = false;
+  let hasEntityTag = false;
+  for (const candidate of splitEntityTags(fieldValue)) {
+    const token = trimOptionalWhitespace(candidate);
+    if (!token) continue;
+    const parsed = parseEntityTag(token);
+    if (!parsed) return false;
+    hasEntityTag = true;
+    if (parsed === expected) matched = true;
+  }
+  return hasEntityTag && matched;
+}
+function trimOptionalWhitespace(value) {
+  return value.replace(/^[\t ]+|[\t ]+$/g, "");
+}
+function parseEntityTag(value) {
+  const opaqueTag = value.startsWith("W/") ? value.slice(2) : value;
+  if (opaqueTag.length < 2 || opaqueTag[0] !== '"' || opaqueTag.at(-1) !== '"') return null;
+  for (let index = 1; index < opaqueTag.length - 1; index++) {
+    const code = opaqueTag.charCodeAt(index);
+    if (code === 33 || code >= 35 && code <= 126 || code >= 128) continue;
+    return null;
+  }
+  return opaqueTag;
+}
+function splitEntityTags(value) {
+  const tags = [];
+  let start = 0;
+  let quoted = false;
+  for (let index = 0; index < value.length; index++) {
+    const character = value[index];
+    if (character === '"') {
+      quoted = !quoted;
+    } else if (character === "," && !quoted) {
+      tags.push(value.slice(start, index));
+      start = index + 1;
+    }
+  }
+  tags.push(value.slice(start));
+  return tags;
+}
+var FarmRequestBodyError = class extends Error {
+  constructor(code, status, message) {
+    super(message);
+    this.name = "FarmRequestBodyError";
+    this.code = code;
+    this.status = status;
+  }
+};
+function resolveFarmServerConfig(config) {
+  const headersTimeout = parseFarmServerDuration(
+    config?.headersTimeout ?? DEFAULT_FARM_SERVER_HEADERS_TIMEOUT,
+    "server.headersTimeout"
+  );
+  const requestTimeout = parseFarmServerDuration(
+    config?.requestTimeout ?? DEFAULT_FARM_SERVER_REQUEST_TIMEOUT,
+    "server.requestTimeout"
+  );
+  if (headersTimeout > requestTimeout) {
+    throw new TypeError("server.headersTimeout must not exceed server.requestTimeout");
+  }
+  return Object.freeze({
+    bodySizeLimit: parseBodySizeLimit(
+      config?.bodySizeLimit ?? DEFAULT_FARM_SERVER_BODY_SIZE_LIMIT,
+      "server.bodySizeLimit"
+    ),
+    trustProxy: config?.trustProxy === true,
+    headersTimeout,
+    requestTimeout,
+    keepAliveTimeout: parseFarmServerDuration(
+      config?.keepAliveTimeout ?? DEFAULT_FARM_SERVER_KEEP_ALIVE_TIMEOUT,
+      "server.keepAliveTimeout"
+    ),
+    gracefulShutdownTimeout: parseFarmServerDuration(
+      config?.gracefulShutdownTimeout ?? DEFAULT_FARM_SERVER_GRACEFUL_SHUTDOWN_TIMEOUT,
+      "server.gracefulShutdownTimeout"
+    ),
+    health: resolveFarmServerHealthConfig(config?.health)
+  });
+}
+function parseFarmServerDuration(value, optionName = "duration") {
+  if (typeof value === "number") {
+    if (!Number.isSafeInteger(value) || value <= 0) {
+      throw new TypeError(`${optionName} must be a positive safe integer`);
+    }
+    if (value > MAX_FARM_SERVER_TIMEOUT) {
+      throw new TypeError(`${optionName} must not exceed ${MAX_FARM_SERVER_TIMEOUT} milliseconds`);
+    }
+    return value;
+  }
+  const match = value.trim().toLowerCase().match(/^(\d+(?:\.\d+)?)\s*(ms|s|m|h)$/);
+  if (!match) {
+    throw new TypeError(`${optionName} must be milliseconds or a duration such as "30s" or "2m"`);
+  }
+  const amount = Number(match[1]);
+  const unit = match[2];
+  const multiplier = unit === "ms" ? 1 : unit === "s" ? 1e3 : unit === "m" ? 6e4 : 36e5;
+  const milliseconds = Math.floor(amount * multiplier);
+  if (!Number.isSafeInteger(milliseconds) || milliseconds <= 0) {
+    throw new TypeError(`${optionName} must resolve to a positive safe integer`);
+  }
+  if (milliseconds > MAX_FARM_SERVER_TIMEOUT) {
+    throw new TypeError(`${optionName} must not exceed ${MAX_FARM_SERVER_TIMEOUT} milliseconds`);
+  }
+  return milliseconds;
+}
+function resolveFarmServerHealthConfig(config) {
+  if (config === false || config && "enabled" in config && config.enabled === false) {
+    return Object.freeze({
+      enabled: false,
+      livenessPath: "/_farm/health/live",
+      readinessPath: "/_farm/health/ready"
+    });
+  }
+  const livenessPath = normalizeHealthPath(
+    config?.livenessPath ?? "/_farm/health/live",
+    "server.health.livenessPath"
+  );
+  const readinessPath = normalizeHealthPath(
+    config?.readinessPath ?? "/_farm/health/ready",
+    "server.health.readinessPath"
+  );
+  if (livenessPath === readinessPath) {
+    throw new TypeError("server.health livenessPath and readinessPath must be different");
+  }
+  return Object.freeze({ enabled: true, livenessPath, readinessPath });
+}
+function normalizeHealthPath(value, optionName) {
+  const path = value.trim();
+  if (!path.startsWith("/") || path.includes("?") || path.includes("#") || path.includes("*")) {
+    throw new TypeError(`${optionName} must be an absolute pathname without a query or wildcard`);
+  }
+  const normalized = path.length > 1 ? path.replace(/\/+$/, "") || "/" : path;
+  assertBrowserStableRoutePath(normalized);
+  return normalized;
+}
+function parseBodySizeLimit(value, optionName = "bodySizeLimit") {
+  if (typeof value === "number") {
+    if (!Number.isSafeInteger(value) || value <= 0) {
+      throw new TypeError(`${optionName} must be a positive safe integer`);
+    }
+    return value;
+  }
+  const match = value.trim().toLowerCase().match(/^(\d+(?:\.\d+)?)\s*(b|kb|mb|gb|kib|mib|gib)?$/);
+  if (!match) {
+    throw new TypeError(`${optionName} must be bytes or a size string such as "500kb" or "10mb"`);
+  }
+  const amount = Number(match[1]);
+  const unit = match[2] ?? "b";
+  const multiplier = {
+    b: 1,
+    kb: 1e3,
+    mb: 1e6,
+    gb: 1e9,
+    kib: 1024,
+    mib: 1048576,
+    gib: 1073741824
+  };
+  const bytes = Math.floor(amount * multiplier[unit]);
+  if (!Number.isSafeInteger(bytes) || bytes <= 0) {
+    throw new TypeError(`${optionName} must resolve to a positive safe integer`);
+  }
+  return bytes;
+}
+function withFarmRequestClientAddress(request, trustProxy, clientAddress) {
+  const requestWithShape = request;
+  if (!requestWithShape.socket) {
+    const forwardedFor = trustProxy ? request.headers.get("x-forwarded-for")?.split(",").at(-1)?.trim() : void 0;
+    try {
+      requestWithShape.socket = { remoteAddress: forwardedFor || clientAddress || void 0 };
+    } catch {
+    }
+  }
+  return requestWithShape;
+}
+var liveRequestClones = /* @__PURE__ */ new WeakMap();
+function cloneFarmRequest(request) {
+  const cloned = request.clone();
+  if (request.body) {
+    const clones = liveRequestClones.get(request);
+    if (clones) clones.push(cloned);
+    else liveRequestClones.set(request, [cloned]);
+  }
+  return cloned;
+}
+function cloneFarmRequestWithContext(request) {
+  const cloned = cloneFarmRequest(request);
+  copyRequestContext(request, cloned);
+  return cloned;
+}
+async function bufferFarmRequestBody(request, limit) {
+  if (request.method === "GET" || request.method === "HEAD" || request.body === null) {
+    return request;
+  }
+  const bytes = await readFarmRequestBody(request, limit);
+  const body = new Uint8Array(bytes.byteLength);
+  body.set(bytes);
+  const buffered = new Request(request, {
+    // oxlint-disable-next-line unicorn/no-invalid-fetch-options -- GET and HEAD return above.
+    body: body.buffer
+  });
+  copyRequestContext(request, buffered);
+  return buffered;
+}
+async function readFarmRequestBody(request, limit) {
+  try {
+    validateContentLength(request.headers.get("content-length"), limit);
+  } catch (error) {
+    void request.body?.cancel(error).catch(() => {
+    });
+    throw error;
+  }
+  throwIfAborted(request.signal);
+  if (!request.body) return new Uint8Array();
+  const reader = request.body.getReader();
+  const chunks = [];
+  let total = 0;
+  const cancelBodyRead = () => {
+    void reader.cancel(request.signal.reason).catch(() => {
+    });
+  };
+  request.signal.addEventListener("abort", cancelBodyRead, { once: true });
+  try {
+    while (true) {
+      throwIfAborted(request.signal);
+      const { done, value } = await reader.read();
+      throwIfAborted(request.signal);
+      if (done) break;
+      if (!value) continue;
+      total += value.byteLength;
+      if (total > limit) {
+        const error = new FarmRequestBodyError("BODY_TOO_LARGE", 413, "Request body is too large");
+        void reader.cancel(error).catch(() => {
+        });
+        throw error;
+      }
+      chunks.push(value);
+    }
+  } catch (error) {
+    if (request.signal.aborted) throwIfAborted(request.signal);
+    throw error;
+  } finally {
+    request.signal.removeEventListener("abort", cancelBodyRead);
+    reader.releaseLock();
+  }
+  const body = new Uint8Array(total);
+  let offset = 0;
+  for (const chunk of chunks) {
+    body.set(chunk, offset);
+    offset += chunk.byteLength;
+  }
+  return body;
+}
+var nodeRequestBodies = /* @__PURE__ */ new WeakMap();
+async function readNodeRequestBody(request, limit) {
+  let body = nodeRequestBodies.get(request);
+  if (!body) {
+    body = readNodeRequestBodyOnce(request, limit);
+    nodeRequestBodies.set(request, body);
+  }
+  const bytes = await body;
+  if (bytes.byteLength > limit) {
+    throw new FarmRequestBodyError("BODY_TOO_LARGE", 413, "Request body is too large");
+  }
+  return bytes;
+}
+async function readNodeRequestBodyOnce(request, limit) {
+  const rawContentLength = request.headers["content-length"];
+  const contentLength = Array.isArray(rawContentLength) ? rawContentLength[0] : rawContentLength;
+  try {
+    validateContentLength(contentLength, limit);
+  } catch (error) {
+    request.resume?.();
+    throw error;
+  }
+  return await new Promise((resolve, reject) => {
+    const chunks = [];
+    let total = 0;
+    let settled = false;
+    const cleanup = () => {
+      request.removeListener?.("data", onData);
+      request.removeListener?.("end", onEnd);
+      request.removeListener?.("error", onError);
+    };
+    const rejectOnce = (error) => {
+      if (settled) return;
+      settled = true;
+      cleanup();
+      request.resume?.();
+      reject(error);
+    };
+    const onData = (chunk) => {
+      const bytes = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+      total += bytes.byteLength;
+      if (total > limit) {
+        rejectOnce(new FarmRequestBodyError("BODY_TOO_LARGE", 413, "Request body is too large"));
+        return;
+      }
+      chunks.push(bytes);
+    };
+    const onEnd = () => {
+      if (settled) return;
+      settled = true;
+      cleanup();
+      resolve(Buffer.concat(chunks, total));
+    };
+    const onError = (error) => rejectOnce(error);
+    request.on("data", onData);
+    request.on("end", onEnd);
+    request.on("error", onError);
+  });
+}
+function createFarmNodeRequestBodyStream(request) {
+  let iterator;
+  return new ReadableStream(
+    {
+      async pull(controller) {
+        iterator ?? (iterator = request[Symbol.asyncIterator]());
+        const { value, done } = await iterator.next();
+        if (done) {
+          controller.close();
+          return;
+        }
+        controller.enqueue(
+          value instanceof Uint8Array ? value : new TextEncoder().encode(String(value))
+        );
+      },
+      async cancel(reason) {
+        await iterator?.return?.(reason);
+      }
+    },
+    // No eager pull: the request stays untouched until the handler reads it.
+    { highWaterMark: 0 }
+  );
+}
+function createFarmRequestBodyErrorResponse(error) {
+  if (!(error instanceof FarmRequestBodyError)) return null;
+  return new Response(error.status === 413 ? "Payload Too Large" : "Bad Request", {
+    status: error.status,
+    headers: {
+      "cache-control": "no-store",
+      "content-type": "text/plain; charset=utf-8",
+      "x-content-type-options": "nosniff"
+    }
+  });
+}
+function validateContentLength(value, limit) {
+  const contentLength = value?.trim();
+  if (!contentLength) return;
+  if (!/^\d+$/.test(contentLength)) {
+    throw new FarmRequestBodyError("INVALID_CONTENT_LENGTH", 400, "Invalid content-length header");
+  }
+  if (Number(contentLength) > limit) {
+    throw new FarmRequestBodyError("BODY_TOO_LARGE", 413, "Request body is too large");
+  }
+}
+function throwIfAborted(signal) {
+  if (!signal.aborted) return;
+  if (signal.reason !== void 0) throw signal.reason;
+  throw new DOMException("The operation was aborted", "AbortError");
+}
+
+export {
+  createFarmNodeRequestAbortSignal,
+  DEFAULT_FARM_SERVER_BODY_SIZE_LIMIT,
+  createFarmWeakETag,
+  matchesFarmIfNoneMatch,
+  resolveFarmServerConfig,
+  parseBodySizeLimit,
+  withFarmRequestClientAddress,
+  cloneFarmRequest,
+  cloneFarmRequestWithContext,
+  bufferFarmRequestBody,
+  readFarmRequestBody,
+  readNodeRequestBody,
+  createFarmNodeRequestBodyStream,
+  createFarmRequestBodyErrorResponse
+};