@valbuild/mcp 0.126.0 → 0.128.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @valbuild/mcp
 
+## 0.128.0
+
+### Patch Changes
+
+- Updated dependencies [[`8b52b33`](https://github.com/valbuild/val/commit/8b52b33e1f629f14f66cc71dcc7cf415d210c7d4), [`362fb49`](https://github.com/valbuild/val/commit/362fb49f30d2b04c4ff78d54dca2bf5ad978a05c), [`c595799`](https://github.com/valbuild/val/commit/c59579977a436ec530c6c69f2b340ab9829d97ab)]:
+  - @valbuild/core@0.128.0
+  - @valbuild/server@0.128.0
+  - @valbuild/shared@0.128.0
+
+## 0.127.0
+
+### Patch Changes
+
+- Updated dependencies [[`7fa8699`](https://github.com/valbuild/val/commit/7fa869974bc895af992a7d5c18b76253636d7d65), [`5b7fe05`](https://github.com/valbuild/val/commit/5b7fe05cec6365f9cd1de9ba31e65ed4a87edb63), [`88262ac`](https://github.com/valbuild/val/commit/88262ac8db068650a664981ef73556457d87741a), [`7072e07`](https://github.com/valbuild/val/commit/7072e07623c953a09ac14388ae22dada0b431ce3), [`29811c3`](https://github.com/valbuild/val/commit/29811c3f8c7e001a950e6f4833af6888e6a4efea)]:
+  - @valbuild/core@0.127.0
+  - @valbuild/shared@0.127.0
+  - @valbuild/server@0.127.0
+
 ## 0.126.0
 
 ### Patch Changes

package/README.md

@@ -39,7 +39,7 @@ Writing:
 | `create_patch`               | change a value at a path                            |
 | `duplicate_source`           | copy an array item or record entry                  |
 | `empty_at_path`              | build an empty value the schema accepts, to fill in |
-| `remove_image_gallery_entry` | drop an image from an `s.images()` gallery          |
+| `remove_image_gallery_entry` | drop an image from an `s.imageset()` gallery        |
 | `upload_image`               | add one — see below                                 |
 
 Every write is validated against the schema before it is stored, and refused
@@ -70,7 +70,7 @@ const { valMcpAuthorize, valMcpTools } = initValMcp(valModules, config, {
 Leave `extraTools` out and everything else still works — an agent can then read,
 validate and edit content, but not add an image.
 
-Remotely stored images (`s.images({ remote: true })`) work through the same tool.
+Remotely stored images (`s.imageset({...}).remote()`) work through the same tool.
 Adding one uploads nothing to Val's content host — the bytes go into the patch
 store, and the push happens at publish — so the only thing it needs is the
 project's bucket list, read with your app's own credential (its API key, or the

package/dist/valbuild-mcp.cjs.dev.js

@@ -1630,7 +1630,12 @@ function writeTools() {
           case 1:
             built = internal.buildEmptyAtPathPatch({
               destinationPath: destinationPath
-            }, schema, deps.state.sources[modulePath]);
+            }, schema, deps.state.sources[modulePath], {
+              locales: internal.declaredLocales({
+                schemas: deps.state.serializedSchemas,
+                sources: deps.state.sources
+              })
+            });
             if (!(built.kind !== "ok")) {
               _context3.n = 2;
               break;
@@ -1651,7 +1656,7 @@ function writeTools() {
     title: "Remove an image gallery entry",
     description: "Remove one image from an image gallery module by its file path. This deletes the entry and the file it refers to.",
     inputSchema: zod.z.object({
-      moduleFilePath: ModuleFilePathSchema$1.describe("The gallery module, i.e. one declared with s.images() or s.files()."),
+      moduleFilePath: ModuleFilePathSchema$1.describe("The gallery module, i.e. one declared with s.imageset() or s.fileset()."),
       filePath: zod.z.string().describe('The gallery key to remove, e.g. "/public/val/photo_a1b2c.jpg".')
     }),
     // Destructive: it removes content and the underlying file, so a host
@@ -2312,7 +2317,7 @@ function _load() {
             _context.n = 1;
             break;
           }
-          return _context.a(2, err("unsupported", "This Val project is not connected to Val Build, so there is nowhere to upload a remote image to. Set `project` in val.config (or the VAL_PROJECT environment variable), or use a schema without `remote: true`."));
+          return _context.a(2, err("unsupported", "This Val project is not connected to Val Build, so there is nowhere to upload a remote image to. Set `project` in val.config (or the VAL_PROJECT environment variable), or use a schema without `.remote()`."));
         case 1:
           _context.n = 2;
           return server.resolveRemoteFileAuth(options);
@@ -2439,7 +2444,7 @@ function buildRemoteRef(input) {
  * that installs Val. So the host builds this one and hands it in — see
  * `createValTools`'s `extraTools`, and `@valbuild/mcp/sharp`.
  *
- * What it deliberately does NOT do: remote files. `s.image({ remote: true })`
+ * What it deliberately does NOT do: remote files. `s.image().remote()`
  * uploads straight to Val's content host through a presigned nonce, which is
  * the one path in local mode that needs a personal access token
  * (`docs/plans/mcp.md` D.1). Refused with a message that says so rather than
@@ -2484,7 +2489,7 @@ function createValImageTools(processor, options) {
   return [defineTool({
     name: "upload_image",
     title: "Upload an image",
-    description: "Upload an image file and put it in an image field, or add it to an image gallery module (one declared with s.images()). Give it either imageFilePath — a path to a file on the machine this app runs on — or imageBase64. The image is re-encoded first if the schema asks for that. Works for remotely stored images too (s.image({ remote: true })), which need the project to be connected to Val Build.",
+    description: "Upload an image file and put it in an image field, or add it to an image gallery module (one declared with s.imageset()). Give it either imageFilePath — a path to a file on the machine this app runs on — or imageBase64. The image is re-encoded first if the schema asks for that. Works for remotely stored images too (s.image().remote()), which need the project to be connected to Val Build.",
     inputSchema: zod.z.object({
       moduleFilePath: ModuleFilePathSchema,
       path: zod.z.array(zod.z.string())["default"]([]).describe('Path of the image field within the module, e.g. ["hero","image"]. Leave empty when the module itself is an image gallery — the image is then added to it under a generated key.'),
@@ -2562,7 +2567,7 @@ function createValImageTools(processor, options) {
             // Where the bytes live, always: a `/public/...` path in the patch
             // store. For a remote image the CONTENT points somewhere else, but the
             // bytes still land here and stay here until publish pushes them.
-            storedPath = "".concat(target.directory, "/").concat(generated);
+            storedPath = "".concat(target.dir, "/").concat(generated);
             _context.n = 9;
             return resolveRef(target, settingsFor(deps.config), {
               bytes: prepared.bytes,
@@ -2690,7 +2695,7 @@ function _resolveRef() {
             _context3.n = 2;
             break;
           }
-          return _context3.a(2, err("invalid-args", "A remote image has to be stored under /public, and this schema's directory is ".concat(JSON.stringify(target.directory), ".")));
+          return _context3.a(2, err("invalid-args", "A remote image has to be stored under /public, and this schema's directory is ".concat(JSON.stringify(target.dir), ".")));
         case 2:
           _context3.n = 3;
           return resolveRemoteUploadTarget(loadSettings);
@@ -2729,9 +2734,9 @@ function _resolveRef() {
 /** The default in `createFilePatch`, and the same default here. */
 var DEFAULT_DIRECTORY = "/public/val";
 function resolveTarget(deps, moduleSchema, fieldPath) {
-  var _ref2, _schema$options$direc, _schema$options, _schema$options$accep, _schema$options2, _schema$options3;
+  var _ref2, _schema$options$dir, _schema$options, _schema$options$accep, _schema$options2, _schema$options3;
   if (fieldPath.length === 0) {
-    var _moduleSchema$directo;
+    var _moduleSchema$dir;
     if (moduleSchema.type !== "record" || moduleSchema.mediaType !== "images") {
       return {
         status: "error",
@@ -2742,7 +2747,7 @@ function resolveTarget(deps, moduleSchema, fieldPath) {
       status: "ok",
       kind: "gallery",
       gallerySchema: moduleSchema,
-      directory: (_moduleSchema$directo = moduleSchema.directory) !== null && _moduleSchema$directo !== void 0 ? _moduleSchema$directo : DEFAULT_DIRECTORY,
+      dir: (_moduleSchema$dir = moduleSchema.dir) !== null && _moduleSchema$dir !== void 0 ? _moduleSchema$dir : DEFAULT_DIRECTORY,
       accept: moduleSchema.accept,
       encode: internal.resolveEncodeSettings(undefined, moduleSchema.encode),
       altRequired: altIsRequired(moduleSchema),
@@ -2795,7 +2800,7 @@ function resolveTarget(deps, moduleSchema, fieldPath) {
     kind: "field",
     referencedModule: referencedModule,
     galleryBacked: referencedModule !== undefined,
-    directory: (_ref2 = (_schema$options$direc = (_schema$options = schema.options) === null || _schema$options === void 0 ? void 0 : _schema$options.directory) !== null && _schema$options$direc !== void 0 ? _schema$options$direc : galleryRecord === null || galleryRecord === void 0 ? void 0 : galleryRecord.directory) !== null && _ref2 !== void 0 ? _ref2 : DEFAULT_DIRECTORY,
+    dir: (_ref2 = (_schema$options$dir = (_schema$options = schema.options) === null || _schema$options === void 0 ? void 0 : _schema$options.dir) !== null && _schema$options$dir !== void 0 ? _schema$options$dir : galleryRecord === null || galleryRecord === void 0 ? void 0 : galleryRecord.dir) !== null && _ref2 !== void 0 ? _ref2 : DEFAULT_DIRECTORY,
     accept: (_schema$options$accep = (_schema$options2 = schema.options) === null || _schema$options2 === void 0 ? void 0 : _schema$options2.accept) !== null && _schema$options$accep !== void 0 ? _schema$options$accep : galleryRecord === null || galleryRecord === void 0 ? void 0 : galleryRecord.accept,
     encode: internal.resolveEncodeSettings((_schema$options3 = schema.options) === null || _schema$options3 === void 0 ? void 0 : _schema$options3.encode, galleryRecord === null || galleryRecord === void 0 ? void 0 : galleryRecord.encode),
     // Only a gallery has an alt schema to satisfy. A plain `s.image()` field
@@ -2822,8 +2827,8 @@ function galleryEntryImageSchema(gallery) {
     opt: false,
     options: _objectSpread2(_objectSpread2({}, gallery.accept ? {
       accept: gallery.accept
-    } : {}), gallery.directory ? {
-      directory: gallery.directory
+    } : {}), gallery.dir ? {
+      dir: gallery.dir
     } : {})
   };
 }
@@ -2831,8 +2836,8 @@ function galleryEntryImageSchema(gallery) {
 /**
  * Does this gallery insist on alt text?
  *
- * `s.images()` gives `alt` a nullable string by default, and an entry written
- * without one stores `null`. A gallery that passed its own — `s.images({ alt:
+ * `s.imageset()` gives `alt` a nullable string by default, and an entry written
+ * without one stores `null`. A gallery that passed its own — `s.imageset({ alt:
  * s.string().minLength(4) })`, which the example app does — has made it
  * required, and an upload with no `alt` cannot satisfy it however it is
  * written. Asked here so the caller is told what to pass, rather than shown a
@@ -3360,7 +3365,7 @@ var packageJson = {
 		"./package.json": "./package.json"
 	},
 	types: "dist/valbuild-mcp.cjs.d.ts",
-	version: "0.126.0",
+	version: "0.128.0",
 	scripts: {
 		typecheck: "tsc --noEmit",
 		test: "jest",

package/dist/valbuild-mcp.cjs.prod.js

@@ -1630,7 +1630,12 @@ function writeTools() {
           case 1:
             built = internal.buildEmptyAtPathPatch({
               destinationPath: destinationPath
-            }, schema, deps.state.sources[modulePath]);
+            }, schema, deps.state.sources[modulePath], {
+              locales: internal.declaredLocales({
+                schemas: deps.state.serializedSchemas,
+                sources: deps.state.sources
+              })
+            });
             if (!(built.kind !== "ok")) {
               _context3.n = 2;
               break;
@@ -1651,7 +1656,7 @@ function writeTools() {
     title: "Remove an image gallery entry",
     description: "Remove one image from an image gallery module by its file path. This deletes the entry and the file it refers to.",
     inputSchema: zod.z.object({
-      moduleFilePath: ModuleFilePathSchema$1.describe("The gallery module, i.e. one declared with s.images() or s.files()."),
+      moduleFilePath: ModuleFilePathSchema$1.describe("The gallery module, i.e. one declared with s.imageset() or s.fileset()."),
       filePath: zod.z.string().describe('The gallery key to remove, e.g. "/public/val/photo_a1b2c.jpg".')
     }),
     // Destructive: it removes content and the underlying file, so a host
@@ -2312,7 +2317,7 @@ function _load() {
             _context.n = 1;
             break;
           }
-          return _context.a(2, err("unsupported", "This Val project is not connected to Val Build, so there is nowhere to upload a remote image to. Set `project` in val.config (or the VAL_PROJECT environment variable), or use a schema without `remote: true`."));
+          return _context.a(2, err("unsupported", "This Val project is not connected to Val Build, so there is nowhere to upload a remote image to. Set `project` in val.config (or the VAL_PROJECT environment variable), or use a schema without `.remote()`."));
         case 1:
           _context.n = 2;
           return server.resolveRemoteFileAuth(options);
@@ -2439,7 +2444,7 @@ function buildRemoteRef(input) {
  * that installs Val. So the host builds this one and hands it in — see
  * `createValTools`'s `extraTools`, and `@valbuild/mcp/sharp`.
  *
- * What it deliberately does NOT do: remote files. `s.image({ remote: true })`
+ * What it deliberately does NOT do: remote files. `s.image().remote()`
  * uploads straight to Val's content host through a presigned nonce, which is
  * the one path in local mode that needs a personal access token
  * (`docs/plans/mcp.md` D.1). Refused with a message that says so rather than
@@ -2484,7 +2489,7 @@ function createValImageTools(processor, options) {
   return [defineTool({
     name: "upload_image",
     title: "Upload an image",
-    description: "Upload an image file and put it in an image field, or add it to an image gallery module (one declared with s.images()). Give it either imageFilePath — a path to a file on the machine this app runs on — or imageBase64. The image is re-encoded first if the schema asks for that. Works for remotely stored images too (s.image({ remote: true })), which need the project to be connected to Val Build.",
+    description: "Upload an image file and put it in an image field, or add it to an image gallery module (one declared with s.imageset()). Give it either imageFilePath — a path to a file on the machine this app runs on — or imageBase64. The image is re-encoded first if the schema asks for that. Works for remotely stored images too (s.image().remote()), which need the project to be connected to Val Build.",
     inputSchema: zod.z.object({
       moduleFilePath: ModuleFilePathSchema,
       path: zod.z.array(zod.z.string())["default"]([]).describe('Path of the image field within the module, e.g. ["hero","image"]. Leave empty when the module itself is an image gallery — the image is then added to it under a generated key.'),
@@ -2562,7 +2567,7 @@ function createValImageTools(processor, options) {
             // Where the bytes live, always: a `/public/...` path in the patch
             // store. For a remote image the CONTENT points somewhere else, but the
             // bytes still land here and stay here until publish pushes them.
-            storedPath = "".concat(target.directory, "/").concat(generated);
+            storedPath = "".concat(target.dir, "/").concat(generated);
             _context.n = 9;
             return resolveRef(target, settingsFor(deps.config), {
               bytes: prepared.bytes,
@@ -2690,7 +2695,7 @@ function _resolveRef() {
             _context3.n = 2;
             break;
           }
-          return _context3.a(2, err("invalid-args", "A remote image has to be stored under /public, and this schema's directory is ".concat(JSON.stringify(target.directory), ".")));
+          return _context3.a(2, err("invalid-args", "A remote image has to be stored under /public, and this schema's directory is ".concat(JSON.stringify(target.dir), ".")));
         case 2:
           _context3.n = 3;
           return resolveRemoteUploadTarget(loadSettings);
@@ -2729,9 +2734,9 @@ function _resolveRef() {
 /** The default in `createFilePatch`, and the same default here. */
 var DEFAULT_DIRECTORY = "/public/val";
 function resolveTarget(deps, moduleSchema, fieldPath) {
-  var _ref2, _schema$options$direc, _schema$options, _schema$options$accep, _schema$options2, _schema$options3;
+  var _ref2, _schema$options$dir, _schema$options, _schema$options$accep, _schema$options2, _schema$options3;
   if (fieldPath.length === 0) {
-    var _moduleSchema$directo;
+    var _moduleSchema$dir;
     if (moduleSchema.type !== "record" || moduleSchema.mediaType !== "images") {
       return {
         status: "error",
@@ -2742,7 +2747,7 @@ function resolveTarget(deps, moduleSchema, fieldPath) {
       status: "ok",
       kind: "gallery",
       gallerySchema: moduleSchema,
-      directory: (_moduleSchema$directo = moduleSchema.directory) !== null && _moduleSchema$directo !== void 0 ? _moduleSchema$directo : DEFAULT_DIRECTORY,
+      dir: (_moduleSchema$dir = moduleSchema.dir) !== null && _moduleSchema$dir !== void 0 ? _moduleSchema$dir : DEFAULT_DIRECTORY,
       accept: moduleSchema.accept,
       encode: internal.resolveEncodeSettings(undefined, moduleSchema.encode),
       altRequired: altIsRequired(moduleSchema),
@@ -2795,7 +2800,7 @@ function resolveTarget(deps, moduleSchema, fieldPath) {
     kind: "field",
     referencedModule: referencedModule,
     galleryBacked: referencedModule !== undefined,
-    directory: (_ref2 = (_schema$options$direc = (_schema$options = schema.options) === null || _schema$options === void 0 ? void 0 : _schema$options.directory) !== null && _schema$options$direc !== void 0 ? _schema$options$direc : galleryRecord === null || galleryRecord === void 0 ? void 0 : galleryRecord.directory) !== null && _ref2 !== void 0 ? _ref2 : DEFAULT_DIRECTORY,
+    dir: (_ref2 = (_schema$options$dir = (_schema$options = schema.options) === null || _schema$options === void 0 ? void 0 : _schema$options.dir) !== null && _schema$options$dir !== void 0 ? _schema$options$dir : galleryRecord === null || galleryRecord === void 0 ? void 0 : galleryRecord.dir) !== null && _ref2 !== void 0 ? _ref2 : DEFAULT_DIRECTORY,
     accept: (_schema$options$accep = (_schema$options2 = schema.options) === null || _schema$options2 === void 0 ? void 0 : _schema$options2.accept) !== null && _schema$options$accep !== void 0 ? _schema$options$accep : galleryRecord === null || galleryRecord === void 0 ? void 0 : galleryRecord.accept,
     encode: internal.resolveEncodeSettings((_schema$options3 = schema.options) === null || _schema$options3 === void 0 ? void 0 : _schema$options3.encode, galleryRecord === null || galleryRecord === void 0 ? void 0 : galleryRecord.encode),
     // Only a gallery has an alt schema to satisfy. A plain `s.image()` field
@@ -2822,8 +2827,8 @@ function galleryEntryImageSchema(gallery) {
     opt: false,
     options: _objectSpread2(_objectSpread2({}, gallery.accept ? {
       accept: gallery.accept
-    } : {}), gallery.directory ? {
-      directory: gallery.directory
+    } : {}), gallery.dir ? {
+      dir: gallery.dir
     } : {})
   };
 }
@@ -2831,8 +2836,8 @@ function galleryEntryImageSchema(gallery) {
 /**
  * Does this gallery insist on alt text?
  *
- * `s.images()` gives `alt` a nullable string by default, and an entry written
- * without one stores `null`. A gallery that passed its own — `s.images({ alt:
+ * `s.imageset()` gives `alt` a nullable string by default, and an entry written
+ * without one stores `null`. A gallery that passed its own — `s.imageset({ alt:
  * s.string().minLength(4) })`, which the example app does — has made it
  * required, and an upload with no `alt` cannot satisfy it however it is
  * written. Asked here so the caller is told what to pass, rather than shown a
@@ -3360,7 +3365,7 @@ var packageJson = {
 		"./package.json": "./package.json"
 	},
 	types: "dist/valbuild-mcp.cjs.d.ts",
-	version: "0.126.0",
+	version: "0.128.0",
 	scripts: {
 		typecheck: "tsc --noEmit",
 		test: "jest",

package/dist/valbuild-mcp.esm.js

@@ -2,7 +2,7 @@ import { _ as _asyncToGenerator, a as _regenerator } from './asyncToGenerator-50
 import { z } from 'zod';
 import { createValOps, getSettings, resolveRemoteFileAuth, getFileExt, initHandlerOptions } from '@valbuild/server';
 import { Internal, getSourcePathFromRoute, DEFAULT_VAL_REMOTE_HOST } from '@valbuild/core';
-import { performSearch, createSearchIndex, indexModule, filterBlockingValidationErrors, describeContainerAtPath, safeParsePatch, buildDuplicatePatch, buildEmptyAtPathPatch, buildRemoveImageGalleryEntryPatch, resolveEncodeSettings, resolveSerializedSchemaAtPath, withExtension, fitWithin, isSkippedSource, ENCODE_MIME_TYPE_OF, isMimeTypeAccepted, chooseEncoded, buildImageGalleryPatch } from '@valbuild/shared/internal';
+import { performSearch, createSearchIndex, indexModule, filterBlockingValidationErrors, describeContainerAtPath, safeParsePatch, buildDuplicatePatch, buildEmptyAtPathPatch, declaredLocales, buildRemoveImageGalleryEntryPatch, resolveEncodeSettings, resolveSerializedSchemaAtPath, withExtension, fitWithin, isSkippedSource, ENCODE_MIME_TYPE_OF, isMimeTypeAccepted, chooseEncoded, buildImageGalleryPatch } from '@valbuild/shared/internal';
 import { minimatch } from 'minimatch';
 import { randomUUID, createPublicKey, verify } from 'node:crypto';
 import { JSONOps, applyPatch, deepClone } from '@valbuild/core/patch';
@@ -1621,7 +1621,12 @@ function writeTools() {
           case 1:
             built = buildEmptyAtPathPatch({
               destinationPath: destinationPath
-            }, schema, deps.state.sources[modulePath]);
+            }, schema, deps.state.sources[modulePath], {
+              locales: declaredLocales({
+                schemas: deps.state.serializedSchemas,
+                sources: deps.state.sources
+              })
+            });
             if (!(built.kind !== "ok")) {
               _context3.n = 2;
               break;
@@ -1642,7 +1647,7 @@ function writeTools() {
     title: "Remove an image gallery entry",
     description: "Remove one image from an image gallery module by its file path. This deletes the entry and the file it refers to.",
     inputSchema: z.object({
-      moduleFilePath: ModuleFilePathSchema$1.describe("The gallery module, i.e. one declared with s.images() or s.files()."),
+      moduleFilePath: ModuleFilePathSchema$1.describe("The gallery module, i.e. one declared with s.imageset() or s.fileset()."),
       filePath: z.string().describe('The gallery key to remove, e.g. "/public/val/photo_a1b2c.jpg".')
     }),
     // Destructive: it removes content and the underlying file, so a host
@@ -2303,7 +2308,7 @@ function _load() {
             _context.n = 1;
             break;
           }
-          return _context.a(2, err("unsupported", "This Val project is not connected to Val Build, so there is nowhere to upload a remote image to. Set `project` in val.config (or the VAL_PROJECT environment variable), or use a schema without `remote: true`."));
+          return _context.a(2, err("unsupported", "This Val project is not connected to Val Build, so there is nowhere to upload a remote image to. Set `project` in val.config (or the VAL_PROJECT environment variable), or use a schema without `.remote()`."));
         case 1:
           _context.n = 2;
           return resolveRemoteFileAuth(options);
@@ -2430,7 +2435,7 @@ function buildRemoteRef(input) {
  * that installs Val. So the host builds this one and hands it in — see
  * `createValTools`'s `extraTools`, and `@valbuild/mcp/sharp`.
  *
- * What it deliberately does NOT do: remote files. `s.image({ remote: true })`
+ * What it deliberately does NOT do: remote files. `s.image().remote()`
  * uploads straight to Val's content host through a presigned nonce, which is
  * the one path in local mode that needs a personal access token
  * (`docs/plans/mcp.md` D.1). Refused with a message that says so rather than
@@ -2475,7 +2480,7 @@ function createValImageTools(processor, options) {
   return [defineTool({
     name: "upload_image",
     title: "Upload an image",
-    description: "Upload an image file and put it in an image field, or add it to an image gallery module (one declared with s.images()). Give it either imageFilePath — a path to a file on the machine this app runs on — or imageBase64. The image is re-encoded first if the schema asks for that. Works for remotely stored images too (s.image({ remote: true })), which need the project to be connected to Val Build.",
+    description: "Upload an image file and put it in an image field, or add it to an image gallery module (one declared with s.imageset()). Give it either imageFilePath — a path to a file on the machine this app runs on — or imageBase64. The image is re-encoded first if the schema asks for that. Works for remotely stored images too (s.image().remote()), which need the project to be connected to Val Build.",
     inputSchema: z.object({
       moduleFilePath: ModuleFilePathSchema,
       path: z.array(z.string())["default"]([]).describe('Path of the image field within the module, e.g. ["hero","image"]. Leave empty when the module itself is an image gallery — the image is then added to it under a generated key.'),
@@ -2553,7 +2558,7 @@ function createValImageTools(processor, options) {
             // Where the bytes live, always: a `/public/...` path in the patch
             // store. For a remote image the CONTENT points somewhere else, but the
             // bytes still land here and stay here until publish pushes them.
-            storedPath = "".concat(target.directory, "/").concat(generated);
+            storedPath = "".concat(target.dir, "/").concat(generated);
             _context.n = 9;
             return resolveRef(target, settingsFor(deps.config), {
               bytes: prepared.bytes,
@@ -2681,7 +2686,7 @@ function _resolveRef() {
             _context3.n = 2;
             break;
           }
-          return _context3.a(2, err("invalid-args", "A remote image has to be stored under /public, and this schema's directory is ".concat(JSON.stringify(target.directory), ".")));
+          return _context3.a(2, err("invalid-args", "A remote image has to be stored under /public, and this schema's directory is ".concat(JSON.stringify(target.dir), ".")));
         case 2:
           _context3.n = 3;
           return resolveRemoteUploadTarget(loadSettings);
@@ -2720,9 +2725,9 @@ function _resolveRef() {
 /** The default in `createFilePatch`, and the same default here. */
 var DEFAULT_DIRECTORY = "/public/val";
 function resolveTarget(deps, moduleSchema, fieldPath) {
-  var _ref2, _schema$options$direc, _schema$options, _schema$options$accep, _schema$options2, _schema$options3;
+  var _ref2, _schema$options$dir, _schema$options, _schema$options$accep, _schema$options2, _schema$options3;
   if (fieldPath.length === 0) {
-    var _moduleSchema$directo;
+    var _moduleSchema$dir;
     if (moduleSchema.type !== "record" || moduleSchema.mediaType !== "images") {
       return {
         status: "error",
@@ -2733,7 +2738,7 @@ function resolveTarget(deps, moduleSchema, fieldPath) {
       status: "ok",
       kind: "gallery",
       gallerySchema: moduleSchema,
-      directory: (_moduleSchema$directo = moduleSchema.directory) !== null && _moduleSchema$directo !== void 0 ? _moduleSchema$directo : DEFAULT_DIRECTORY,
+      dir: (_moduleSchema$dir = moduleSchema.dir) !== null && _moduleSchema$dir !== void 0 ? _moduleSchema$dir : DEFAULT_DIRECTORY,
       accept: moduleSchema.accept,
       encode: resolveEncodeSettings(undefined, moduleSchema.encode),
       altRequired: altIsRequired(moduleSchema),
@@ -2786,7 +2791,7 @@ function resolveTarget(deps, moduleSchema, fieldPath) {
     kind: "field",
     referencedModule: referencedModule,
     galleryBacked: referencedModule !== undefined,
-    directory: (_ref2 = (_schema$options$direc = (_schema$options = schema.options) === null || _schema$options === void 0 ? void 0 : _schema$options.directory) !== null && _schema$options$direc !== void 0 ? _schema$options$direc : galleryRecord === null || galleryRecord === void 0 ? void 0 : galleryRecord.directory) !== null && _ref2 !== void 0 ? _ref2 : DEFAULT_DIRECTORY,
+    dir: (_ref2 = (_schema$options$dir = (_schema$options = schema.options) === null || _schema$options === void 0 ? void 0 : _schema$options.dir) !== null && _schema$options$dir !== void 0 ? _schema$options$dir : galleryRecord === null || galleryRecord === void 0 ? void 0 : galleryRecord.dir) !== null && _ref2 !== void 0 ? _ref2 : DEFAULT_DIRECTORY,
     accept: (_schema$options$accep = (_schema$options2 = schema.options) === null || _schema$options2 === void 0 ? void 0 : _schema$options2.accept) !== null && _schema$options$accep !== void 0 ? _schema$options$accep : galleryRecord === null || galleryRecord === void 0 ? void 0 : galleryRecord.accept,
     encode: resolveEncodeSettings((_schema$options3 = schema.options) === null || _schema$options3 === void 0 ? void 0 : _schema$options3.encode, galleryRecord === null || galleryRecord === void 0 ? void 0 : galleryRecord.encode),
     // Only a gallery has an alt schema to satisfy. A plain `s.image()` field
@@ -2813,8 +2818,8 @@ function galleryEntryImageSchema(gallery) {
     opt: false,
     options: _objectSpread2(_objectSpread2({}, gallery.accept ? {
       accept: gallery.accept
-    } : {}), gallery.directory ? {
-      directory: gallery.directory
+    } : {}), gallery.dir ? {
+      dir: gallery.dir
     } : {})
   };
 }
@@ -2822,8 +2827,8 @@ function galleryEntryImageSchema(gallery) {
 /**
  * Does this gallery insist on alt text?
  *
- * `s.images()` gives `alt` a nullable string by default, and an entry written
- * without one stores `null`. A gallery that passed its own — `s.images({ alt:
+ * `s.imageset()` gives `alt` a nullable string by default, and an entry written
+ * without one stores `null`. A gallery that passed its own — `s.imageset({ alt:
  * s.string().minLength(4) })`, which the example app does — has made it
  * required, and an upload with no `alt` cannot satisfy it however it is
  * written. Asked here so the caller is told what to pass, rather than shown a
@@ -3351,7 +3356,7 @@ var packageJson = {
 		"./package.json": "./package.json"
 	},
 	types: "dist/valbuild-mcp.cjs.d.ts",
-	version: "0.126.0",
+	version: "0.128.0",
 	scripts: {
 		typecheck: "tsc --noEmit",
 		test: "jest",

package/package.json

@@ -20,7 +20,7 @@
     "./package.json": "./package.json"
   },
   "types": "dist/valbuild-mcp.cjs.d.ts",
-  "version": "0.126.0",
+  "version": "0.128.0",
   "preconstruct": {
     "entrypoints": [
       "./index.ts",
@@ -31,9 +31,9 @@
   "dependencies": {
     "minimatch": "^10.2.6",
     "zod": "^4.4.3",
-    "@valbuild/core": "0.126.0",
-    "@valbuild/shared": "0.126.0",
-    "@valbuild/server": "0.126.0"
+    "@valbuild/core": "0.128.0",
+    "@valbuild/shared": "0.128.0",
+    "@valbuild/server": "0.128.0"
   },
   "devDependencies": {
     "@prettier/sync": "^0.6.1",