@formfeed/mcp 0.1.0 → 0.2.0

package/bin/formfeed-mcp.mjs

@@ -1155,16 +1155,16 @@ var require_numeric_data = __commonJS({
       return NumericData.getBitsLength(this.data.length);
     };
     NumericData.prototype.write = function write(bitBuffer) {
-      let i, group, value;
+      let i, group2, value;
       for (i = 0; i + 3 <= this.data.length; i += 3) {
-        group = this.data.substr(i, 3);
-        value = parseInt(group, 10);
+        group2 = this.data.substr(i, 3);
+        value = parseInt(group2, 10);
         bitBuffer.put(value, 10);
       }
       const remainingNum = this.data.length - i;
       if (remainingNum > 0) {
-        group = this.data.substr(i);
-        value = parseInt(group, 10);
+        group2 = this.data.substr(i);
+        value = parseInt(group2, 10);
         bitBuffer.put(value, remainingNum * 3 + 1);
       }
     };
@@ -20735,14 +20735,14 @@ var require_liquid_node = __commonJS({
       constructor(token, remainTokens, liquid) {
         super(token, remainTokens, liquid);
         this.candidates = [];
-        const group = this.tokenizer.readValue();
+        const group2 = this.tokenizer.readValue();
         this.tokenizer.skipBlank();
-        if (group) {
+        if (group2) {
           if (this.tokenizer.peek() === ":") {
-            this.group = group;
+            this.group = group2;
             this.tokenizer.advance();
           } else
-            this.candidates.push(group);
+            this.candidates.push(group2);
         }
         while (!this.tokenizer.end()) {
           const value = this.tokenizer.readValue();
@@ -20753,8 +20753,8 @@ var require_liquid_node = __commonJS({
         this.tokenizer.assert(this.candidates.length, () => `empty candidates: "${token.getText()}"`);
       }
       *render(ctx, emitter) {
-        const group = yield evalToken(this.group, ctx);
-        const fingerprint = `cycle:${group}:` + this.candidates.join(",");
+        const group2 = yield evalToken(this.group, ctx);
+        const fingerprint = `cycle:${group2}:` + this.candidates.join(",");
         const groups = ctx.getRegister("cycle", {});
         let idx = groups[fingerprint];
         if (idx === void 0) {
@@ -77815,7 +77815,7 @@ var formatHelpers = [
     name: "asset",
     doc: {
       signature: "asset(name)",
-      description: "URL of a workspace asset (logo, background) on the CDN.",
+      description: "URL of a file in the workspace library (logo, background) on the CDN. Upload it on the Files page or with `POST /files` and use the name it has there; relative image paths resolve against the same library.",
       example: `<img src="{{ asset('logo.png') }}">`,
       category: "document"
     },
@@ -78308,6 +78308,12 @@ function defaultHelpers() {
 // packages/engine/src/lib/engines/handlebars.ts
 var import_handlebars = __toESM(require_lib2());
 
+// packages/engine/src/lib/unavailable.ts
+var UNAVAILABLE = {};
+function unavailableHelper(name) {
+  return UNAVAILABLE[name];
+}
+
 // packages/engine/src/lib/analysis/tags.ts
 function rangeAt(line, column, length) {
   return {
@@ -78487,7 +78493,10 @@ function missingPathDiagnostics(variables, sampleData, loopSources, builtinRoots
     const root = v2.path[0];
     if (!root || builtinRoots4.has(root)) continue;
     let path = v2.path;
-    if (loopSources.has(root)) {
+    if (v2.source !== void 0) {
+      if (!v2.source) continue;
+      path = [...v2.source, ...v2.path.slice(1)];
+    } else if (loopSources.has(root)) {
       const source = loopSources.get(root);
       if (!source) continue;
       path = [...source, ...v2.path.slice(1)];
@@ -78746,6 +78755,13 @@ function analyzeHandlebars(source, opts = {}) {
         range: f2.range,
         fix: { title: `Rename to ${preferred}`, replacement: preferred }
       });
+    } else if (unavailableHelper(f2.name)) {
+      diagnostics.push({
+        severity: "warning",
+        code: "unavailable-helper",
+        message: unavailableHelper(f2.name),
+        range: f2.range
+      });
     } else if (!f2.known) {
       diagnostics.push({
         severity: "error",
@@ -78854,6 +78870,151 @@ var handlebarsEngine = {
 
 // packages/engine/src/lib/engines/jinja2.ts
 var import_nunjucks = __toESM(require_nunjucks());
+
+// packages/engine/src/lib/engines/python-format.ts
+var SPEC = /^(?:([\s\S])?([<>=^]))?([+\- ])?(#)?(0)?(\d+)?([,_])?(?:\.(\d+))?([bcdeEfFgGnosxX%])?$/;
+function group(digits, separator) {
+  return digits.replace(/\B(?=(\d{3})+(?!\d))/g, separator);
+}
+function pythonExponent(text2) {
+  return text2.replace(/e([+-])(\d)$/i, (m2, sign, digit) => `${m2[0]}${sign}0${digit}`);
+}
+function formatNumber(value, type, precision, alternate) {
+  if (!Number.isFinite(value)) return Number.isNaN(value) ? "nan" : "inf";
+  const abs = Math.abs(value);
+  switch (type) {
+    case "f":
+    case "F":
+      return abs.toFixed(precision ?? 6);
+    case "%":
+      return `${(abs * 100).toFixed(precision ?? 6)}%`;
+    case "e":
+    case "E": {
+      const text2 = pythonExponent(abs.toExponential(precision ?? 6));
+      return type === "E" ? text2.toUpperCase() : text2;
+    }
+    case "g":
+    case "G": {
+      const p = precision === 0 ? 1 : precision ?? 6;
+      const exp = abs === 0 ? 0 : Math.floor(Math.log10(abs));
+      let text2 = exp < -4 || exp >= p ? pythonExponent(abs.toExponential(p - 1)) : abs.toFixed(Math.max(0, p - 1 - exp));
+      if (!alternate) {
+        const [mantissa = "", exponent] = text2.split("e");
+        const trimmed = mantissa.includes(".") ? mantissa.replace(/0+$/, "").replace(/\.$/, "") : mantissa;
+        text2 = exponent === void 0 ? trimmed : `${trimmed}e${exponent}`;
+      }
+      return type === "G" ? text2.toUpperCase() : text2;
+    }
+    case "d":
+    case "n":
+      return String(Math.trunc(abs));
+    case "b":
+      return (alternate ? "0b" : "") + Math.trunc(abs).toString(2);
+    case "o":
+      return (alternate ? "0o" : "") + Math.trunc(abs).toString(8);
+    case "x":
+      return (alternate ? "0x" : "") + Math.trunc(abs).toString(16);
+    case "X":
+      return (alternate ? "0X" : "") + Math.trunc(abs).toString(16).toUpperCase();
+    default:
+      return precision === void 0 ? String(abs) : formatNumber(abs, "g", precision, alternate);
+  }
+}
+function formatValue(value, spec) {
+  const m2 = SPEC.exec(spec);
+  if (!m2) return String(value ?? "");
+  const [, fillChar, alignChar, sign, alt, zero, widthText, grouping, precisionText, type = ""] = m2;
+  const precision = precisionText === void 0 ? void 0 : Number(precisionText);
+  const width = widthText === void 0 ? 0 : Number(widthText);
+  const numericType = /[bdeEfFgGnoxX%]/.test(type);
+  const asNumber = typeof value === "number" ? value : typeof value === "boolean" ? Number(value) : numericType && value !== null && value !== void 0 && String(value).trim() !== "" && Number.isFinite(Number(value)) ? Number(value) : void 0;
+  let body;
+  let prefix = "";
+  if (asNumber !== void 0 && type !== "s" && type !== "c") {
+    body = formatNumber(asNumber, type, precision, Boolean(alt));
+    if (grouping) {
+      const [int = "", ...rest] = body.split(".");
+      const radix = /^0[box]/i.exec(int)?.[0] ?? "";
+      body = radix + group(int.slice(radix.length), grouping) + (rest.length ? `.${rest.join(".")}` : "");
+    }
+    const negative = asNumber < 0 || Object.is(asNumber, -0);
+    prefix = negative ? "-" : sign === "+" ? "+" : sign === " " ? " " : "";
+  } else if (type === "c" && asNumber !== void 0) {
+    body = String.fromCodePoint(asNumber);
+  } else {
+    body = String(value ?? "None");
+    if (precision !== void 0 && !numericType) body = body.slice(0, precision);
+  }
+  const isNumber = asNumber !== void 0 && type !== "s";
+  const align = alignChar ?? (zero && isNumber ? "=" : isNumber ? ">" : "<");
+  const fill = fillChar ?? (zero && !alignChar ? "0" : " ");
+  const pad = Math.max(0, width - prefix.length - body.length);
+  switch (align) {
+    case "<":
+      return prefix + body + fill.repeat(pad);
+    case "^":
+      return fill.repeat(Math.floor(pad / 2)) + prefix + body + fill.repeat(Math.ceil(pad / 2));
+    case "=":
+      return prefix + fill.repeat(pad) + body;
+    default:
+      return fill.repeat(pad) + prefix + body;
+  }
+}
+function lookupField(name, positional, named, next) {
+  const [head = "", ...rest] = name.split(/(?=[.[])/);
+  let value = head === "" ? positional[next()] : /^\d+$/.test(head) ? positional[Number(head)] : named[head];
+  for (const part of rest) {
+    const key = part.startsWith("[") ? part.slice(1, -1) : part.slice(1);
+    value = value !== null && typeof value === "object" ? value[Array.isArray(value) && /^\d+$/.test(key) ? Number(key) : key] : void 0;
+  }
+  return value;
+}
+function pythonFormat(template, positional, named = {}) {
+  let auto = 0;
+  const next = () => auto++;
+  const render = (text2) => {
+    let out = "";
+    for (let i = 0; i < text2.length; i++) {
+      const ch = text2[i];
+      if (ch === "}") {
+        out += "}";
+        if (text2[i + 1] === "}") i++;
+        continue;
+      }
+      if (ch !== "{") {
+        out += ch;
+        continue;
+      }
+      if (text2[i + 1] === "{") {
+        out += "{";
+        i++;
+        continue;
+      }
+      let depth = 1;
+      let j2 = i + 1;
+      for (; j2 < text2.length && depth > 0; j2++) {
+        if (text2[j2] === "{") depth++;
+        else if (text2[j2] === "}") depth--;
+      }
+      if (depth > 0) {
+        out += text2.slice(i);
+        break;
+      }
+      const field = text2.slice(i + 1, j2 - 1);
+      const colon = field.indexOf(":");
+      const head = colon < 0 ? field : field.slice(0, colon);
+      const name = head.replace(/![rsa]$/, "");
+      const value = lookupField(name, positional, named, next);
+      const spec = colon < 0 ? "" : render(field.slice(colon + 1));
+      out += value === void 0 ? "" : formatValue(value, spec);
+      i = j2 - 1;
+    }
+    return out;
+  };
+  return render(template);
+}
+
+// packages/engine/src/lib/engines/jinja2.ts
 var nunjucksBuiltinFilters = /* @__PURE__ */ new Set([
   "abs",
   "batch",
@@ -78908,7 +79069,12 @@ var builtinRoots2 = /* @__PURE__ */ new Set([
   "joiner",
   "lipsum",
   "varargs",
-  "kwargs"
+  "kwargs",
+  "namespace",
+  // Jinja2's spelling of the literals, which the compat layer resolves at runtime
+  "True",
+  "False",
+  "None"
 ]);
 var stringMethods = {
   upper: (s) => s.toUpperCase(),
@@ -78937,12 +79103,8 @@ var stringMethods = {
   split: (s, sep, max) => sep === void 0 || sep === null ? s.trim().split(/\s+/) : s.split(String(sep), max === void 0 ? void 0 : Number(max) + 1),
   join: (s, list2) => Array.isArray(list2) ? list2.join(s) : String(list2),
   format: (s, ...args2) => {
-    let i = 0;
-    const named = args2.at(-1) && typeof args2.at(-1) === "object" ? args2.at(-1) : {};
-    return s.replace(
-      /\{(\w*)\}/g,
-      (_2, key) => String(key ? named[key] ?? "" : args2[i++] ?? "")
-    );
+    const named = keywordArgs(args2);
+    return pythonFormat(s, named ? args2.slice(0, -1) : args2, named ?? {});
   },
   zfill: (s, width) => s.padStart(Number(width), "0"),
   count: (s, sub) => s.split(String(sub)).length - 1,
@@ -78957,6 +79119,92 @@ var stringMethods = {
     return f2.repeat(left) + s + f2.repeat(total - left);
   }
 };
+function keywordArgs(args2) {
+  const last = args2.at(-1);
+  if (!last || typeof last !== "object" || !Object.prototype.hasOwnProperty.call(last, "__keywords")) return void 0;
+  const { __keywords: _marker, ...named } = last;
+  return named;
+}
+var JinjaNamespace = class {
+};
+function namespace(...args2) {
+  const ns = new JinjaNamespace();
+  const named = keywordArgs(args2);
+  for (const arg of named ? [...args2.slice(0, -1), named] : args2)
+    if (arg && typeof arg === "object") Object.assign(ns, arg);
+  return ns;
+}
+function setNamespaceAttribute(target, key, value) {
+  if (!(target instanceof JinjaNamespace)) throw new Error("Cannot assign attribute on non-namespace object");
+  target[String(key)] = value;
+}
+var toList = (v2) => Array.isArray(v2) ? v2 : v2 === void 0 || v2 === null ? [] : typeof v2 === "string" ? [...v2] : [v2];
+var attributeOf = (item, path) => String(path ?? "").split(".").reduce((acc, key) => acc !== null && typeof acc === "object" ? acc[key] : void 0, item);
+var jinjaTests = {
+  none: (v2) => v2 === null,
+  true: (v2) => v2 === true,
+  false: (v2) => v2 === false,
+  in: (v2, container) => typeof container === "string" ? container.includes(String(v2)) : Array.isArray(container) ? container.includes(v2) : !!container && typeof container === "object" && String(v2) in container,
+  "==": (v2, a) => v2 === a,
+  "!=": (v2, a) => v2 !== a,
+  ">": (v2, a) => v2 > a,
+  ">=": (v2, a) => v2 >= a,
+  "<": (v2, a) => v2 < a,
+  "<=": (v2, a) => v2 <= a
+};
+function runTest(self2, name, value, arg) {
+  const own = jinjaTests[name];
+  if (own) return own(value, arg);
+  return self2.env.getTest(name).call(self2, value, arg) === true;
+}
+function installJinjaFilters(env) {
+  const lookup = env;
+  const helperTruncate = lookup.getFilter("truncate");
+  lookup.addFilter("truncate", function(value, ...args2) {
+    const named = keywordArgs(args2);
+    const p = named ? args2.slice(0, -1) : args2;
+    if (!named && typeof p[1] !== "boolean" && p.length < 3) return helperTruncate.call(this, value, ...args2);
+    const s = String(value ?? "");
+    const length = Number(p[0] ?? named?.["length"] ?? 255);
+    const killwords = Boolean(p[1] ?? named?.["killwords"] ?? false);
+    const end = String(p[2] ?? named?.["end"] ?? "...");
+    const leeway = Number(p[3] ?? named?.["leeway"] ?? 5);
+    if (s.length <= length + leeway) return s;
+    const cut = s.slice(0, Math.max(0, length - end.length));
+    if (killwords) return cut + end;
+    const space = cut.lastIndexOf(" ");
+    return (space >= 0 ? cut.slice(0, space) : cut) + end;
+  });
+  const helperMap = lookup.getFilter("map");
+  lookup.addFilter("map", function(value, ...args2) {
+    const named = keywordArgs(args2);
+    const p = named ? args2.slice(0, -1) : args2;
+    if (named && "attribute" in named)
+      return toList(value).map((item) => {
+        const v2 = attributeOf(item, named["attribute"]);
+        return v2 === void 0 && "default" in named ? named["default"] : v2;
+      });
+    const items = toList(value);
+    if (typeof p[0] === "string" && !items.some((item) => item !== null && typeof item === "object")) {
+      let filter;
+      try {
+        filter = lookup.getFilter(p[0]);
+      } catch {
+        filter = void 0;
+      }
+      if (filter) return items.map((item) => filter.call(this, item, ...p.slice(1)));
+    }
+    return helperMap.call(this, value, ...args2);
+  });
+  const byAttribute = (keep) => function(value, attribute, test, arg) {
+    return toList(value).filter((item) => {
+      const v2 = attributeOf(item, attribute);
+      return (test === void 0 ? Boolean(v2) : runTest(this, String(test), v2, arg)) === keep;
+    });
+  };
+  lookup.addFilter("selectattr", byAttribute(true));
+  lookup.addFilter("rejectattr", byAttribute(false));
+}
 function trimChars(s, chars, side) {
   if (chars === void 0 || chars === null)
     return side === "both" ? s.trim() : side === "left" ? s.trimStart() : s.trimEnd();
@@ -78977,6 +79225,20 @@ function installCompat() {
     this.compile(node.target, frame);
     this._emit(")");
   };
+  const compileSet = import_nunjucks.default.compiler.Compiler.prototype.compileSet;
+  import_nunjucks.default.runtime["formfeedSetAttribute"] = setNamespaceAttribute;
+  import_nunjucks.default.compiler.Compiler.prototype.compileSet = function(node, frame) {
+    const [target, ...more] = node.targets;
+    if (!target || more.length || target.typename !== "LookupVal") return compileSet.call(this, node, frame);
+    this._emit("runtime.formfeedSetAttribute(");
+    this._compileExpression(target["target"], frame);
+    this._emit(", ");
+    this._compileExpression(target["val"], frame);
+    this._emit(", ");
+    if (node.value) this._compileExpression(node.value, frame);
+    else this.compile(node.body, frame);
+    this._emitLine(");");
+  };
   const original = import_nunjucks.default.runtime.memberLookup;
   import_nunjucks.default.runtime.memberLookup = (obj, val2, ...rest) => {
     if (typeof obj === "string" && typeof val2 === "string" && Object.prototype.hasOwnProperty.call(stringMethods, val2)) {
@@ -79023,6 +79285,8 @@ function createEnvironment(ctx) {
     env.addFilter(name, wrapped);
     env.addGlobal(name, wrapped);
   }
+  env.addGlobal("namespace", namespace);
+  installJinjaFilters(env);
   return env;
 }
 var validationContext2 = {
@@ -79063,6 +79327,13 @@ function pathOf(node) {
 function inScope(w, name) {
   return w.scopes.some((s) => s.has(name));
 }
+function sourceOf(w, name) {
+  for (let i = w.scopes.length - 1; i >= 0; i--) {
+    const scope = w.scopes[i];
+    if (scope?.has(name)) return scope.get(name) ?? null;
+  }
+  return null;
+}
 function walk2(node, w) {
   if (!node || typeof node !== "object") return;
   switch (node.typename) {
@@ -79071,10 +79342,12 @@ function walk2(node, w) {
       const p = pathOf(node);
       if (p) {
         const root = p.path[0] ?? "";
+        const bound = inScope(w, root);
         w.variables.push({
           path: p.path,
           range: nodeRange(p.root, p.path.join(".").length),
-          kind: inScope(w, root) ? "loop-var" : "read"
+          kind: bound ? "loop-var" : "read",
+          ...bound ? { source: sourceOf(w, root) } : {}
         });
       }
       if (node.typename === "LookupVal" && !p) {
@@ -79120,18 +79393,18 @@ function walk2(node, w) {
       const source = pathOf(arr);
       const nameNode = node["name"];
       const names = nameNode.typename === "Array" ? nameNode.children ?? [] : [nameNode];
-      const scope = /* @__PURE__ */ new Set();
+      const root = source?.path[0] ?? "";
+      const items = !source ? null : inScope(w, root) ? ((s) => s ? [...s, ...source.path.slice(1)] : null)(sourceOf(w, root)) : source.path;
+      const scope = /* @__PURE__ */ new Map();
       for (const n of names) {
         const name = String(n.value);
-        scope.add(name);
-        w.loopSources.set(
-          name,
-          names.length === 1 && source && !inScope(w, source.path[0] ?? "") ? source.path : names.length === 1 && source ? resolveLoopSource(w, source.path) : null
-        );
+        const bound = names.length === 1 ? items : null;
+        scope.set(name, bound);
         w.variables.push({
           path: [name],
           range: nodeRange(n, name.length),
-          kind: "loop-var"
+          kind: "loop-var",
+          source: bound
         });
       }
       w.scopes.push(scope);
@@ -79149,8 +79422,7 @@ function walk2(node, w) {
             range: nodeRange(p.root, p.path.join(".").length),
             kind: "assigned"
           });
-          w.scopes[0]?.add(p.path[0] ?? "");
-          w.loopSources.set(p.path[0] ?? "", null);
+          if (p.path.length === 1 || !inScope(w, p.path[0] ?? "")) w.scopes[0]?.set(p.path[0] ?? "", null);
         }
       }
       walk2(node["value"], w);
@@ -79159,17 +79431,27 @@ function walk2(node, w) {
     }
     case "Macro": {
       const args2 = node["args"];
-      const scope = /* @__PURE__ */ new Set();
-      for (const child of args2.children ?? [])
-        if (child.typename === "Symbol") scope.add(String(child.value));
+      const scope = /* @__PURE__ */ new Map();
+      for (const child of args2.children ?? []) {
+        if (child.typename === "Symbol") scope.set(String(child.value), null);
+        if (child.typename === "KeywordArgs")
+          for (const pair of child.children ?? []) {
+            const key = pair["key"];
+            if (key) scope.set(String(key.value), null);
+            walk2(pair["value"], w);
+          }
+      }
       const nameNode = node["name"];
-      w.scopes[0]?.add(String(nameNode.value));
-      w.loopSources.set(String(nameNode.value), null);
+      w.scopes[0]?.set(String(nameNode.value), null);
       w.scopes.push(scope);
       walk2(node["body"], w);
       w.scopes.pop();
       return;
     }
+    case "Pair": {
+      walk2(node["value"], w);
+      return;
+    }
     case "Include":
     case "Extends":
     case "Import":
@@ -79182,15 +79464,17 @@ function walk2(node, w) {
         });
       else walk2(tpl, w);
       if (node.typename === "Import")
-        w.scopes[0]?.add(
-          String(node["target"]?.value ?? "")
+        w.scopes[0]?.set(
+          String(node["target"]?.value ?? ""),
+          null
         );
       if (node.typename === "FromImport")
         for (const n of node["names"].children ?? [])
-          w.scopes[0]?.add(
+          w.scopes[0]?.set(
             String(
               n.typename === "Pair" ? n["value"].value : n.value
-            )
+            ),
+            null
           );
       return;
     }
@@ -79208,12 +79492,6 @@ function walk2(node, w) {
       walk2(value, w);
   }
 }
-function resolveLoopSource(w, path) {
-  const root = path[0] ?? "";
-  if (!w.loopSources.has(root)) return path;
-  const source = w.loopSources.get(root);
-  return source ? [...source, ...path.slice(1)] : null;
-}
 function analyzeJinja2(source, opts = {}) {
   const helpers = opts.helpers ?? defaultHelpers();
   const { blocks, diagnostics } = scanBlocks(source, jinjaTags);
@@ -79221,8 +79499,7 @@ function analyzeJinja2(source, opts = {}) {
     variables: [],
     filters: [],
     includes: [],
-    loopSources: /* @__PURE__ */ new Map(),
-    scopes: [/* @__PURE__ */ new Set()],
+    scopes: [/* @__PURE__ */ new Map()],
     helpers
   };
   try {
@@ -79251,6 +79528,13 @@ function analyzeJinja2(source, opts = {}) {
         range: f2.range,
         fix: { title: `Rename to ${preferred}`, replacement: preferred }
       });
+    } else if (unavailableHelper(f2.name)) {
+      diagnostics.push({
+        severity: "warning",
+        code: "unavailable-helper",
+        message: unavailableHelper(f2.name),
+        range: f2.range
+      });
     } else if (!f2.known) {
       diagnostics.push({
         severity: "error",
@@ -79264,7 +79548,7 @@ function analyzeJinja2(source, opts = {}) {
   const dataDiagnostics = missingPathDiagnostics(
     w.variables,
     opts.sampleData,
-    w.loopSources,
+    /* @__PURE__ */ new Map(),
     builtin
   );
   return {
@@ -79397,6 +79681,10 @@ var liquidBuiltinFilters = /* @__PURE__ */ new Set([
   "url_decode",
   "url_encode",
   "where",
+  "where_exp",
+  "find_exp",
+  "reject_exp",
+  "group_by_exp",
   "raw",
   "sum",
   "group_by",
@@ -79651,6 +79939,13 @@ function analyzeLiquid(source, opts = {}) {
         range: f2.range,
         fix: { title: `Rename to ${preferred}`, replacement: preferred }
       });
+    } else if (unavailableHelper(f2.name)) {
+      diagnostics.push({
+        severity: "warning",
+        code: "unavailable-helper",
+        message: unavailableHelper(f2.name),
+        range: f2.range
+      });
     } else if (!f2.known) {
       diagnostics.push({
         severity: "error",
@@ -80069,6 +80364,11 @@ ${loop(e, "line", "invoice.lines", `    <tr><td>${val(e, "line.description")}</t
   }
 ];
 
+// packages/api-types/src/lib/assets.ts
+var SEGMENT = "[A-Za-z0-9][A-Za-z0-9._-]*";
+var ASSET_NAME_PATTERN = new RegExp(`^${SEGMENT}(?:/${SEGMENT})*$`);
+var ASSET_MAX_BYTES = 10 * 1024 * 1024;
+
 // packages/sdk-ts/src/lib/client.ts
 var FormfeedError = class extends Error {
   constructor(code, message2, status, problem = null, requestId = null) {
@@ -80096,6 +80396,8 @@ function randomKey() {
   if (c?.randomUUID) return c.randomUUID();
   return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
 }
+var withKey = (options) => ({ ...options, idempotencyKey: options.idempotencyKey ?? randomKey() });
+var idOf = (source) => typeof source === "string" ? source : source.id;
 var Formfeed = class {
   baseUrl;
   apiKey;
@@ -80164,6 +80466,54 @@ var Formfeed = class {
       idempotencyKey: options.idempotencyKey ?? randomKey()
     })
   };
+  /**
+   * PDF tools on the outputs of earlier renders (a `Render` or its id) and on PDFs of the file library
+   * (a `LibraryFile`, its id or its name). merge, protect and watermark return a new render and cost
+   * 0.5 units each on live keys; info is free.
+   */
+  pdf = {
+    merge: (sources, output = {}, options = {}) => this.request("POST", "/pdf/merge", { ...output, sources: sources.map(idOf) }, withKey(options)),
+    protect: (source, protect, options = {}) => this.request("POST", "/pdf/protect", { ...protect, source: idOf(source) }, withKey(options)),
+    watermark: (source, watermark, options = {}) => this.request("POST", "/pdf/watermark", { ...watermark, source: idOf(source) }, withKey(options)),
+    info: (source, options = {}) => this.request("POST", "/pdf/info", { source: idOf(source) }, options)
+  };
+  /**
+   * The workspace file library (`/files`): images and PDFs a template references by name with
+   * `asset('logo.png')`, and the sources of image watermarks and merges. Needs `file:read`,
+   * `file:write` or `file:delete`. Files are served without a signature, so keep confidential
+   * documents out of it.
+   */
+  files = {
+    /** Uploads a file; the same name replaces the existing file in place and keeps its URL. */
+    upload: (file, options = {}) => {
+      const blob = file.data instanceof Blob ? file.data : new Blob([file.data], file.contentType ? { type: file.contentType } : {});
+      const form = new FormData();
+      form.set("file", blob, file.name);
+      form.set("name", file.name);
+      return this.request("POST", "/files", form, options);
+    },
+    /** Page of files, newest first. */
+    list: (query = {}, options = {}) => {
+      const params = new URLSearchParams();
+      for (const [k2, v2] of Object.entries(query)) if (v2 !== void 0 && v2 !== null && v2 !== "") params.set(k2, String(v2));
+      const qs = params.toString();
+      return this.request("GET", `/files${qs ? `?${qs}` : ""}`, void 0, options);
+    },
+    /** Every file matching the query, following the cursor. */
+    all: async (query = {}, options = {}) => {
+      const out = [];
+      let cursor = null;
+      do {
+        const page = await this.files.list({ ...query, cursor }, options);
+        out.push(...page.data);
+        cursor = page.next_cursor;
+      } while (cursor);
+      return out;
+    },
+    get: (id, options = {}) => this.request("GET", `/files/${encodeURIComponent(id)}`, void 0, options),
+    /** Removes the file and its bytes; templates that name it render a missing image afterwards. */
+    delete: (file, options = {}) => this.request("DELETE", `/files/${encodeURIComponent(idOf(file))}`, void 0, options)
+  };
   jobs = {
     get: (id, options = {}) => this.request("GET", `/jobs/${encodeURIComponent(id)}`, void 0, options),
     waitFor: async (id, options = {}) => {
@@ -80214,7 +80564,13 @@ var Formfeed = class {
       create: (idOrSlug, input, options = {}) => this.request("POST", `/templates/${encodeURIComponent(idOrSlug)}/versions`, input, options),
       publish: (idOrSlug, number, options = {}) => this.request("POST", `/templates/${encodeURIComponent(idOrSlug)}/versions/${number}/publish`, void 0, options)
     },
-    schema: (idOrSlug, options = {}) => this.request("GET", `/templates/${encodeURIComponent(idOrSlug)}/schema`, void 0, options)
+    schema: (idOrSlug, options = {}) => this.request("GET", `/templates/${encodeURIComponent(idOrSlug)}/schema`, void 0, options),
+    /**
+     * Checks a version with data without rendering: syntax, header and footer, missing partials,
+     * runtime errors and the data against the stored schema. Free. Without `data`, the version's
+     * sample data is checked.
+     */
+    validate: (idOrSlug, input = {}, options = {}) => this.request("POST", `/templates/${encodeURIComponent(idOrSlug)}/validate`, input, options)
   };
   account = {
     get: (options = {}) => this.request("GET", "/account", void 0, options),
@@ -80227,9 +80583,10 @@ var Formfeed = class {
     const headers = {
       authorization: `Bearer ${this.apiKey}`,
       accept: "application/json",
-      "user-agent": "formfeed-sdk-ts/0.1"
+      "user-agent": "formfeed-sdk-ts/0.2"
     };
-    if (body !== void 0) headers["content-type"] = "application/json";
+    const isForm = typeof FormData !== "undefined" && body instanceof FormData;
+    if (body !== void 0 && !isForm) headers["content-type"] = "application/json";
     if (options.idempotencyKey) headers["idempotency-key"] = options.idempotencyKey;
     let attempt = 0;
     for (; ; ) {
@@ -80241,7 +80598,7 @@ var Formfeed = class {
         res = await this.fetchImpl(url, {
           method,
           headers,
-          body: body === void 0 ? void 0 : JSON.stringify(body),
+          body: body === void 0 ? void 0 : isForm ? body : JSON.stringify(body),
           signal: controller.signal
         });
       } catch (e) {
@@ -80287,7 +80644,7 @@ var encoder2 = new TextEncoder();
 
 // packages/mcp/src/lib/server.ts
 import { z as z2 } from "zod";
-var SERVER_INFO = { name: "formfeed", version: "0.1.0" };
+var SERVER_INFO = { name: "formfeed", version: "0.2.0" };
 var engineSchema = z2.enum(["jinja2", "liquid", "handlebars"]);
 var outputSchema = z2.enum(["pdf", "png", "jpg"]);
 var templateSummary = (t) => ({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formfeed/mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Model Context Protocol server for Formfeed: list templates, read data schemas, validate and render documents from AI agents.",
   "license": "MIT",
   "author": {