@farm.js/core 0.1.35 → 0.1.37

package/dist/chunk-CI6E3UOH.cjs

@@ -0,0 +1,314 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); 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 _chunkPTZ2TVNEcjs = require('./chunk-PTZ2TVNE.cjs');
+
+
+var _chunkI57LW5VZcjs = require('./chunk-I57LW5VZ.cjs');
+
+
+var _chunkS3JO3N4Hcjs = require('./chunk-S3JO3N4H.cjs');
+
+// src/agent-mcp-handler.ts
+var INSTRUCTIONS = "This server reads the site's public pages. Call list_pages or search_pages to find a page, then read_page with its path to get the page as Markdown. It cannot change anything.";
+var MAX_BODY_BYTES = 64 * 1024;
+var MAX_BATCH = 16;
+var READ_TIMEOUT_MS = 3e4;
+var _FarmMCPRequestError = class _FarmMCPRequestError extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+  }
+};
+_chunkS3JO3N4Hcjs.__name.call(void 0, _FarmMCPRequestError, "FarmMCPRequestError");
+var FarmMCPRequestError = _FarmMCPRequestError;
+var PARSE_ERROR = -32700;
+var INVALID_REQUEST = -32600;
+var METHOD_NOT_FOUND = -32601;
+var INVALID_PARAMS = -32602;
+var INTERNAL_ERROR = -32603;
+var TRANSPORT_ERROR = -32e3;
+async function handleFarmDefaultMCPRequest(request, context) {
+  const method = request.method.toUpperCase();
+  if (method !== "POST") {
+    return transportError(405, "Method not allowed. Send MCP requests with POST.", {
+      Allow: "POST"
+    });
+  }
+  const origin = request.headers.get("origin");
+  if (origin && !isSameOrigin(origin, request.url)) {
+    return transportError(403, "Cross-origin requests are not allowed.");
+  }
+  const protocolHeader = request.headers.get("mcp-protocol-version");
+  if (protocolHeader && !_chunkPTZ2TVNEcjs.FARM_DEFAULT_MCP_PROTOCOL_VERSIONS.includes(protocolHeader.trim())) {
+    return transportError(
+      400,
+      `Unsupported MCP-Protocol-Version: ${protocolHeader.slice(0, 32)}. Supported: ${_chunkPTZ2TVNEcjs.FARM_DEFAULT_MCP_PROTOCOL_VERSIONS.join(", ")}.`
+    );
+  }
+  const contentType = _nullishCoalesce(request.headers.get("content-type"), () => ( ""));
+  if (!/^application\/json\s*(?:;|$)/i.test(contentType.trim())) {
+    return transportError(415, "Content-Type must be application/json.");
+  }
+  const text = await readBody(request);
+  if (text === null) return transportError(413, "The request body is too large.");
+  let message;
+  try {
+    message = JSON.parse(text);
+  } catch (e) {
+    return json(400, rpcError(null, { code: PARSE_ERROR, message: "Parse error." }));
+  }
+  if (Array.isArray(message)) {
+    if (message.length === 0 || message.length > MAX_BATCH) {
+      return json(
+        400,
+        rpcError(null, { code: INVALID_REQUEST, message: "Invalid batch of JSON-RPC messages." })
+      );
+    }
+    const replies = (await Promise.all(message.map((item) => answerMessage(item, request, context)))).filter((reply2) => reply2 !== void 0);
+    return replies.length ? json(200, replies) : new Response(null, { status: 202 });
+  }
+  const reply = await answerMessage(message, request, context);
+  return reply === void 0 ? new Response(null, { status: 202 }) : json(200, reply);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, handleFarmDefaultMCPRequest, "handleFarmDefaultMCPRequest");
+async function answerMessage(message, request, context) {
+  if (!isRecord(message) || message.jsonrpc !== "2.0") {
+    return rpcError(readId(message), { code: INVALID_REQUEST, message: "Invalid Request." });
+  }
+  const hasId = "id" in message;
+  if (typeof message.method !== "string") {
+    if (hasId && ("result" in message || "error" in message)) return void 0;
+    return rpcError(readId(message), { code: INVALID_REQUEST, message: "Invalid Request." });
+  }
+  if (!hasId) return void 0;
+  const id = readId(message);
+  if (id === void 0) {
+    return rpcError(null, { code: INVALID_REQUEST, message: "Invalid Request id." });
+  }
+  try {
+    const result = await dispatch(message.method, message.params, request, context);
+    return { jsonrpc: "2.0", id, result };
+  } catch (error) {
+    if (error instanceof FarmMCPRequestError) {
+      return rpcError(id, { code: error.code, message: error.message });
+    }
+    return rpcError(id, { code: INTERNAL_ERROR, message: "Internal error." });
+  }
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, answerMessage, "answerMessage");
+async function dispatch(method, params, request, context) {
+  switch (method) {
+    case "initialize": {
+      const requested = isRecord(params) ? params.protocolVersion : void 0;
+      const protocolVersion = typeof requested === "string" && _chunkPTZ2TVNEcjs.FARM_DEFAULT_MCP_PROTOCOL_VERSIONS.includes(requested) ? requested : _chunkPTZ2TVNEcjs.FARM_DEFAULT_MCP_PROTOCOL_VERSIONS[0];
+      return {
+        protocolVersion,
+        capabilities: { tools: { listChanged: false } },
+        serverInfo: {
+          name: context.server.name,
+          version: context.server.version,
+          ...context.server.title ? { title: context.server.title } : {},
+          description: _chunkPTZ2TVNEcjs.FARM_DEFAULT_MCP_DESCRIPTION
+        },
+        instructions: INSTRUCTIONS
+      };
+    }
+    case "ping":
+      return {};
+    case "tools/list":
+      return { tools: _chunkPTZ2TVNEcjs.FARM_DEFAULT_MCP_TOOLS };
+    case "tools/call":
+      return callTool(params, request, context);
+    default:
+      throw new FarmMCPRequestError(METHOD_NOT_FOUND, `Method not found: ${method.slice(0, 64)}`);
+  }
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, dispatch, "dispatch");
+async function callTool(params, request, context) {
+  if (!isRecord(params) || typeof params.name !== "string") {
+    throw new FarmMCPRequestError(INVALID_PARAMS, "tools/call needs a tool name.");
+  }
+  const tool = _chunkPTZ2TVNEcjs.FARM_DEFAULT_MCP_TOOLS.find(({ name }) => name === params.name);
+  if (!tool) {
+    throw new FarmMCPRequestError(INVALID_PARAMS, `Unknown tool: ${params.name.slice(0, 64)}`);
+  }
+  const args = _nullishCoalesce(params.arguments, () => ( {}));
+  if (!isRecord(args)) return toolError("Arguments must be an object.");
+  const allowed = new Set(Object.keys(tool.inputSchema.properties));
+  const unknown = Object.keys(args).find((key) => !allowed.has(key));
+  if (unknown) return toolError(`Unknown argument: ${unknown.slice(0, 64)}.`);
+  if (tool.name === "list_pages") return pagesResult(await context.listPages());
+  if (tool.name === "search_pages") {
+    const query = args.query;
+    if (typeof query !== "string" || !query.trim() || query.length > 200) {
+      return toolError("query must be a non-empty string of at most 200 characters.");
+    }
+    const limit = _nullishCoalesce(args.limit, () => ( 10));
+    if (typeof limit !== "number" || !Number.isInteger(limit) || limit < 1 || limit > 50) {
+      return toolError("limit must be a whole number from 1 to 50.");
+    }
+    return pagesResult(searchPages(await context.listPages(), query, limit));
+  }
+  const path = args.path;
+  if (typeof path !== "string" || !path.trim() || path.length > 2048) {
+    return toolError('path must be a page path such as "/about".');
+  }
+  const pagePath = toPagePath(path, request.url, context.basePath);
+  const pages = await context.listPages();
+  const page = pagePath ? pages.find((candidate) => candidate.path === pagePath) : void 0;
+  if (!page) {
+    return toolError(
+      `No public page at ${JSON.stringify(path.slice(0, 200))}. Call list_pages for the pages this server can read.`
+    );
+  }
+  const markdown = await readWithTimeout(context.readMarkdown, page.markdownUrl);
+  if (markdown === null) {
+    return toolError(`${page.path} did not answer with Markdown. Try again later.`);
+  }
+  return { content: [{ type: "text", text: markdown }] };
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, callTool, "callTool");
+function pagesResult(pages) {
+  const structured = {
+    pages: pages.map(({ path, title, url, description }) => ({
+      path,
+      title,
+      url,
+      ...description ? { description } : {}
+    }))
+  };
+  return {
+    content: [{ type: "text", text: JSON.stringify(structured) }],
+    structuredContent: structured
+  };
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, pagesResult, "pagesResult");
+function toolError(text) {
+  return { content: [{ type: "text", text }], isError: true };
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, toolError, "toolError");
+function searchPages(pages, query, limit) {
+  const terms = query.toLowerCase().split(/\s+/).filter(Boolean).slice(0, 16);
+  return pages.map((page) => {
+    const title = page.title.toLowerCase();
+    const rest = `${_nullishCoalesce(page.description, () => ( ""))} ${page.path}`.toLowerCase();
+    let score = 0;
+    for (const term of terms) {
+      if (title.includes(term)) score += 2;
+      else if (rest.includes(term)) score += 1;
+      else return null;
+    }
+    return { page, score };
+  }).filter((match) => match !== null).sort(
+    (left, right) => right.score - left.score || left.page.path.localeCompare(right.page.path)
+  ).slice(0, limit).map(({ page }) => page);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, searchPages, "searchPages");
+function toPagePath(input, requestUrl, basePath) {
+  let url;
+  try {
+    url = new URL(input.trim(), requestUrl);
+  } catch (e2) {
+    return null;
+  }
+  if (url.origin !== new URL(requestUrl).origin) return null;
+  let path = url.pathname;
+  try {
+    path = decodeURI(path);
+  } catch (e3) {
+    return null;
+  }
+  path = _chunkI57LW5VZcjs.stripFarmBasePath.call(void 0, path, basePath);
+  if (path === "/index.md") return "/";
+  if (path.toLowerCase().endsWith(".md")) path = path.slice(0, -3) || "/";
+  return path.length > 1 ? path.replace(/\/+$/, "") || "/" : path;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, toPagePath, "toPagePath");
+async function readWithTimeout(read, url) {
+  let timer;
+  const timedOut = new Promise((resolve) => {
+    timer = setTimeout(resolve, READ_TIMEOUT_MS, null);
+  });
+  try {
+    return await Promise.race([read(url), timedOut]);
+  } finally {
+    clearTimeout(timer);
+  }
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, readWithTimeout, "readWithTimeout");
+async function readBody(request) {
+  const declared = Number(request.headers.get("content-length"));
+  if (Number.isFinite(declared) && declared > MAX_BODY_BYTES) {
+    await _optionalChain([request, 'access', _ => _.body, 'optionalAccess', _2 => _2.cancel, 'call', _3 => _3(), 'access', _4 => _4.catch, 'call', _5 => _5(() => {
+    })]);
+    return null;
+  }
+  if (!request.body) return "";
+  const reader = request.body.getReader();
+  const chunks = [];
+  let size = 0;
+  for (; ; ) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    size += value.byteLength;
+    if (size > MAX_BODY_BYTES) {
+      await reader.cancel().catch(() => {
+      });
+      return null;
+    }
+    chunks.push(value);
+  }
+  const body = new Uint8Array(size);
+  let offset = 0;
+  for (const chunk of chunks) {
+    body.set(chunk, offset);
+    offset += chunk.byteLength;
+  }
+  return new TextDecoder().decode(body);
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, readBody, "readBody");
+function isSameOrigin(origin, requestUrl) {
+  try {
+    return new URL(origin).host === new URL(requestUrl).host;
+  } catch (e4) {
+    return false;
+  }
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, isSameOrigin, "isSameOrigin");
+function readId(message) {
+  if (!isRecord(message)) return null;
+  const { id } = message;
+  return typeof id === "string" || typeof id === "number" && Number.isFinite(id) || id === null ? id : void 0;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, readId, "readId");
+function rpcError(id, error) {
+  return { jsonrpc: "2.0", id: _nullishCoalesce(id, () => ( null)), error };
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, rpcError, "rpcError");
+function json(status, body) {
+  return new Response(JSON.stringify(body), {
+    status,
+    headers: {
+      "Content-Type": "application/json; charset=utf-8",
+      "Cache-Control": "no-store",
+      "X-Content-Type-Options": "nosniff"
+    }
+  });
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, json, "json");
+function transportError(status, message, headers = {}) {
+  const response = json(status, rpcError(null, { code: TRANSPORT_ERROR, message }));
+  for (const [name, value] of Object.entries(headers)) response.headers.set(name, value);
+  return response;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, transportError, "transportError");
+function isRecord(value) {
+  return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, isRecord, "isRecord");
+
+
+
+exports.handleFarmDefaultMCPRequest = handleFarmDefaultMCPRequest;

package/dist/{chunk-2G2NNLE2.mjs → chunk-CQMVIOYP.mjs}

@@ -1,12 +1,12 @@
+import {
+  APITypeGenerator
+} from "./chunk-F3VB7ONA.mjs";
 import {
   readSchemaTables
 } from "./chunk-HALDNTIV.mjs";
 import {
   resolveSchemaModels
 } from "./chunk-ZMSZZXOR.mjs";
-import {
-  APITypeGenerator
-} from "./chunk-F3VB7ONA.mjs";
 import {
   mergeRouteRenderingDirectiveConfig
 } from "./chunk-DAO7JGTS.mjs";
@@ -20,7 +20,7 @@ import {
 import {
   getFarmAppDirectories,
   getFarmSourceRoots
-} from "./chunk-JHWOVJ3M.mjs";
+} from "./chunk-BUGNQIHC.mjs";
 import {
   resolveFarmComponentExtensions
 } from "./chunk-DAATZTKJ.mjs";
@@ -29,7 +29,7 @@ import {
 } from "./chunk-RHAZ22ZN.mjs";
 import {
   discoverProgrammaticRoutePaths
-} from "./chunk-UDNPLXW7.mjs";
+} from "./chunk-MYIZXDZA.mjs";
 import {
   readFarmI18nCatalogs
 } from "./chunk-QCFBDFRS.mjs";

package/dist/{chunk-X6W5FFH6.cjs → chunk-CVH2BXPY.cjs}

@@ -4,13 +4,13 @@
 
 
 
-var _chunkGFHLGIYCcjs = require('./chunk-GFHLGIYC.cjs');
+var _chunk6LGFV2CQcjs = require('./chunk-6LGFV2CQ.cjs');
 
 
 var _chunkSK35NQKKcjs = require('./chunk-SK35NQKK.cjs');
 
 
-var _chunkZXGAFZDOcjs = require('./chunk-ZXGAFZDO.cjs');
+var _chunkT5OJPTVNcjs = require('./chunk-T5OJPTVN.cjs');
 
 
 
@@ -35,7 +35,7 @@ function createServerQuery(options) {
     throw new TypeError("createServerQuery requires a key function");
   }
   const staleTime = normalizeServerQueryStaleTime(options.staleTime);
-  const execute = _chunkGFHLGIYCcjs.createServerFn.call(void 0, {
+  const execute = _chunk6LGFV2CQcjs.createServerFn.call(void 0, {
     input: options.input,
     middleware: options.middleware,
     handler: /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, async (context) => {
@@ -45,7 +45,7 @@ function createServerQuery(options) {
       const cacheKey = _chunkNYJMY3JAcjs.createFarmCacheKey.call(void 0, ["route-data", routeKey]);
       const producer = /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, async () => {
         const value = await options.handler(context);
-        return _chunkGFHLGIYCcjs._parseServerFnSchema.call(void 0, options.output, value, "output", "createServerQuery");
+        return _chunk6LGFV2CQcjs._parseServerFnSchema.call(void 0, options.output, value, "output", "createServerQuery");
       }, "producer");
       let data;
       let updatedAt;
@@ -70,7 +70,7 @@ function createServerQuery(options) {
   });
   const query = /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, async (input) => {
     const result = await execute(input);
-    return _chunkZXGAFZDOcjs.getServerActionExecutionContext.call(void 0, ) ? result : result.data;
+    return _chunkT5OJPTVNcjs.getServerActionExecutionContext.call(void 0, ) ? result : result.data;
   }, "query");
   Object.defineProperties(query, {
     [FARM_SERVER_QUERY_SYMBOL]: {
@@ -90,10 +90,10 @@ function createServerQuery(options) {
       enumerable: false
     }
   });
-  _chunkGFHLGIYCcjs._attachServerFunctionDescriptor.call(void 0, 
+  _chunk6LGFV2CQcjs._attachServerFunctionDescriptor.call(void 0, 
     query,
-    _chunkGFHLGIYCcjs.createServerFunctionDescriptor.call(void 0, "query", options, async (value) => {
-      const result = await _chunkGFHLGIYCcjs._runServerFunctionForCaller.call(void 0, 
+    _chunk6LGFV2CQcjs.createServerFunctionDescriptor.call(void 0, "query", options, async (value) => {
+      const result = await _chunk6LGFV2CQcjs._runServerFunctionForCaller.call(void 0, 
         execute,
         value
       );

package/dist/{chunk-TKSCR644.cjs → chunk-D3C5LBQY.cjs}

@@ -6,7 +6,7 @@ var _chunkJ63ZH5OQcjs = require('./chunk-J63ZH5OQ.cjs');
 var _chunkE3UK5IIBcjs = require('./chunk-E3UK5IIB.cjs');
 
 
-var _chunkUXFQ3UDAcjs = require('./chunk-UXFQ3UDA.cjs');
+var _chunkNICDYKBScjs = require('./chunk-NICDYKBS.cjs');
 
 
 var _chunkS3JO3N4Hcjs = require('./chunk-S3JO3N4H.cjs');
@@ -299,7 +299,7 @@ function farmInfraAnalyticsPlugin(options, send) {
         context.state.unsubscribe = _chunkE3UK5IIBcjs.onFarmEvent.call(void 0, 
           (event) => {
             if (!isToolEvent(event)) return;
-            const request = _chunkUXFQ3UDAcjs.getCurrentRequestOrNull.call(void 0, );
+            const request = _chunkNICDYKBScjs.getCurrentRequestOrNull.call(void 0, );
             if (!request) return;
             const metadata = context.requestContext.get(request, contextKey);
             if (!metadata) return;

package/dist/{chunk-PZNL3WEG.mjs → chunk-DMEPTZTI.mjs}

@@ -569,6 +569,10 @@ async function resolveProgrammaticRouteData(route, dataHooks, context) {
   if (routeDataKey == null) {
     return dataHooks.main(context);
   }
+  const revalidate = normalizeProgrammaticRouteStaleTime(dataHooks.staleTime, route.path);
+  if (revalidate === 0) {
+    return dataHooks.main(context);
+  }
   const cacheKey = createFarmCacheKey(["route-data", routeDataKey]);
   const cacheOptions = {
     tags: [
@@ -579,7 +583,7 @@ async function resolveProgrammaticRouteData(route, dataHooks, context) {
       ...typeof context.path === "string" ? [context.path] : [],
       ...await resolveProgrammaticRouteDataKeys(dataHooks.paths, context)
     ],
-    revalidate: normalizeProgrammaticRouteStaleTime(dataHooks.staleTime)
+    revalidate
   };
   return getFarmDataCache().getOrSet(cacheKey, () => dataHooks.main(context), cacheOptions);
 }
@@ -590,20 +594,26 @@ async function resolveProgrammaticRouteDataKeys(input, context) {
   return value.filter((item) => typeof item === "string" && item.trim().length > 0);
 }
 __name(resolveProgrammaticRouteDataKeys, "resolveProgrammaticRouteDataKeys");
-function normalizeProgrammaticRouteStaleTime(staleTime) {
+function normalizeProgrammaticRouteStaleTime(staleTime, routePath) {
   if (staleTime === void 0) return void 0;
   if (staleTime === false) return false;
+  let milliseconds;
   if (typeof staleTime === "number") {
-    if (!Number.isFinite(staleTime) || staleTime <= 0) return void 0;
-    return Math.max(1, Math.ceil(staleTime / 1e3));
+    milliseconds = staleTime;
+  } else {
+    const match = typeof staleTime === "string" && staleTime.match(/^(\d+(?:\.\d+)?)(ms|s|m|h)$/);
+    if (!match) {
+      throw new TypeError(
+        `Route "${routePath}" data.staleTime must be milliseconds or a duration like "250ms", "30s", "5m", or "1h".`
+      );
+    }
+    const unit = match[2];
+    milliseconds = Number(match[1]) * (unit === "ms" ? 1 : unit === "s" ? 1e3 : unit === "m" ? 6e4 : 36e5);
+  }
+  if (!Number.isFinite(milliseconds) || milliseconds < 0) {
+    throw new TypeError(`Route "${routePath}" data.staleTime must be a non-negative duration.`);
   }
-  const match = staleTime.match(/^(\d+(?:\.\d+)?)(ms|s|m|h)$/);
-  if (!match) return void 0;
-  const value = Number(match[1]);
-  if (!Number.isFinite(value) || value <= 0) return void 0;
-  const unit = match[2];
-  const milliseconds = unit === "ms" ? value : unit === "s" ? value * 1e3 : unit === "m" ? value * 6e4 : value * 36e5;
-  return Math.max(1, Math.ceil(milliseconds / 1e3));
+  return milliseconds === 0 ? 0 : Math.max(1, Math.ceil(milliseconds / 1e3));
 }
 __name(normalizeProgrammaticRouteStaleTime, "normalizeProgrammaticRouteStaleTime");
 function isProgrammaticRoutePropsResolved(value) {
@@ -662,6 +672,7 @@ function normalizeProgrammaticRoute(route) {
     };
   }
   const routeActions = route.kind === "page" ? normalizeProgrammaticRouteActions(route) : void 0;
+  normalizeProgrammaticRouteStaleTime(route.data?.staleTime, route.path);
   return {
     ...route,
     ...routeActions,