editmamei 0.23.0 → 1.0.0

package/NOTICES.md

@@ -72,36 +72,12 @@ above.
   terms (Apache-2.0 §4(d)) are preserved by reference to that source.
 - Used to detect the 80 COCO object classes.
 
-### MediaPipe FaceMesh (`models/pro/face_mesh_468.onnx`) — facial landmarks (Pro)
-
-- **Upstream:** Google MediaPipe Face Landmark / FaceMesh model (the
-  `face_landmarks_detector` weight from `face_landmarker.task`), trained by Google
-  on its own data. Converted to ONNX (468-point variant) and redistributed via the
-  Hugging Face `Heliosoph/mediapipe-face-onnx` repository.
-- **License:** Apache-2.0 (the model is permissively licensed by Google;
-  commercial-safe — see `docs/product/pro-vision-models.md` for the weights-license
-  diligence). Any upstream `NOTICE`/attribution terms (Apache-2.0 §4(d)) are
-  preserved by reference to those sources.
-- Runs on-device via the same `onnxruntime-web` backend; the image never leaves the
-  machine. Used by the Pro `ps_detect_landmarks` tool to locate the 468-point
-  face mesh (eyes, brows, lips, nose, jaw). Ships in the **Pro module**
-  (`models/pro/`), not the CE tarball.
-
-### MobileSAM (`models/pro/mobile_sam_{encoder,decoder}.onnx`) — promptable segmentation (Pro)
-
-- **Upstream:** MobileSAM ("Faster Segment Anything: Towards Lightweight SAM for
-  Mobile Applications", Zhang et al.; `ChaoningZhang/MobileSAM`) — a distilled
-  TinyViT image encoder paired with the Segment Anything prompt-mask decoder,
-  exported to ONNX (encoder + decoder). Redistributed here as an **FP16** build
-  converted from the FP32 ONNX export (halves the download; INT8 dynamic
-  quantization was evaluated and rejected — it collapsed the encoder to
-  whole-frame masks).
-- **License:** Apache-2.0. Any upstream `NOTICE`/attribution terms (Apache-2.0
-  §4(d)) are preserved by reference to that source.
-- Runs on-device via the same `onnxruntime-web` backend; the image never leaves the
-  machine. Used by the Pro `ps_select_object` tool to turn a box/point prompt into a
-  pixel-accurate organic selection. Ships in the **Pro module** (`models/pro/`), not
-  the CE tarball.
+### Separately licensed modules
+
+The Pro module is delivered as its own artifact and bundles additional third-party
+models. Redistribution obligations follow the artifact that carries the files, so
+those notices and their full license texts ship **inside the Pro module**, beside
+its manifest, rather than being enumerated here.
 
 ---
 

package/README.md

@@ -2,12 +2,10 @@
 
 **Unlock Photoshop with natural-language photo editing.** AI orchestration, not generation.
 
-(Pronounced like _edamame_. Yes, the snack.)
-
 > Independent project, not affiliated with or endorsed by Adobe Inc.
 
 [![npm version](https://img.shields.io/npm/v/editmamei.svg)](https://www.npmjs.com/package/editmamei)
-[![License](https://img.shields.io/badge/License-Proprietary-blue.svg)](https://editmamei.com/license)
+[![License](https://img.shields.io/badge/License-FSL--1.1--MIT-blue.svg)](LICENSE.md)
 [![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS-lightgrey.svg)]()
 
 Editmamei is a Model Context Protocol (MCP) server that drives the Adobe Photoshop you already have. You describe the edit in plain words, your AI assistant plans the steps, and your own copy of Photoshop carries them out with its standard adjustment layers, masks, selections, and filters. The AI directs and Photoshop edits. No generative model touches your pixels, and no image is uploaded to perform an edit.
@@ -76,11 +74,11 @@ These are the choices that shape the surface, and the reason an AI assistant can
 
 ## Tool surface
 
-**75 tools across 16 capability groups** (58 Community, 17 Pro). Every tool is namespaced `photoshop_*` and discoverable at runtime via `tools/list`. Community tools ship in both editions; Pro tools unlock with a license.
+**87 tools across 16 capability groups** (64 Community, 23 Pro). Every tool is namespaced `ps_*` and discoverable at runtime via `tools/list`. Community tools ship in both editions; Pro tools unlock with a license.
 
 | Group | Edition | Tools |
 | --- | --- | --- |
-| **Core** | Community | `ping` · `overview` · `list_capabilities` · `undo` · `redo` |
+| **Core** | Community | `ping` · `overview` · `list_capabilities` · `undo` · `redo` · `report_problem` |
 | **Inspect** | Community | `inspect` · `get_preview` |
 | **Verify** | Community | `get_histogram` · `compare_regions` · `get_layer_bounds_diff` · `get_selection_preview` |
 | **Document & canvas** | Community | `create_document` · `open_document` · `close_document` · `save_psd` · `export` · `place_image` · `resize_image` · `crop_document` · `convert_image_mode` · `transform_canvas` · `guides` |
@@ -88,13 +86,15 @@ These are the choices that shape the surface, and the reason an AI assistant can
 | **Adjustments** | Community | `add_adjustment_layer` · `apply_adjustment` |
 | **Filters** | Community | `apply_filter` |
 | **Retouch** | Community | `retouch` |
-| **Layers** | Community | `create_layer` · `delete_layer` · `fill_layer` · `add_fill_layer` · `select_layer` · `move_layer_to_position` · `duplicate_layer` · `layer_via_copy` · `convert_to_smart_object` · `rasterize_layer` · `set_layer` · `merge` · `bake_layer` · `add_layer_style` · `transform_layer` · `create_group` · `move_layer_to_group` · `set_group_blend_mode` · `ungroup` · `delete_group` |
+| **Layers** | Community | `create_layer` · `delete_layer` · `fill_layer` · `add_fill_layer` · `select_layer` · `move_layer_to_position` · `duplicate_layer` · `copy_to_new_layer` · `convert_to_smart_object` · `rasterize_layer` · `set_layer` · `merge` · `bake_layer` · `add_layer_style` · `transform_layer` · `shape` · `create_group` · `move_layer_to_group` · `set_group_blend_mode` · `ungroup` · `delete_group` |
 | **Masks & paths** | Community | `layer_mask` · `create_clipping_mask` · `path` · `vector_mask` · `apply_image` · `calculations` |
 | **Type** | Community | `create_text_layer` · `set_text` |
-| **Perception** | Community | `detect` · `scene` · `select_by_reference` |
+| **Perception** | Community | `detect` · `read_scene` · `select_by_reference` |
 | **AI selection** | Community | `select_subject` · `select_sky` |
-| **AI selection** | Pro | `select_subject_instance` |
-| **Layers (warp)** | Pro | `warp_layer` · `warp_layer_mesh` |
+| **AI selection** | Pro | `select_subject_instance` · `select_object` |
+| **Filters** | Pro | `apply_camera_raw` |
+| **Layers (warp)** | Pro | `warp_layer` · `warp_layer_mesh` · `warp_layer_along` · `warp_layer_region` · `warp_layer_to` |
+| **Perception** | Pro | `edit_object` · `add_text_to_object` · `resolve_placement` |
 | **Face mesh** | Pro | `detect_landmarks` · `select_face_feature` |
 | **Templates** | Pro | `template_create_evidence` · `template_save` · `template_list` · `template_apply` · `template_verify` · `template_recall` · `template_delete` |
 | **Automation** | Pro | `list_actions` · `play_action` · `execute_script` |
@@ -106,6 +106,24 @@ These are the choices that shape the surface, and the reason an AI assistant can
 
 The split is detailed in [pro-features.md](https://github.com/editmamei/editmamei-wiki/blob/main/docs/pro-features.md). Pricing is at [editmamei.com](https://editmamei.com).
 
+This repository holds the Community source. Pro is a separately licensed module and its source is not published here; Community never imports it, so this tree builds and runs on its own.
+
+## Build from source
+
+```bash
+git clone https://github.com/editmamei/editmamei.git
+cd editmamei
+npm install
+npm run build
+npm test
+```
+
+You need Node.js 20+ and a Go toolchain (the build compiles the `editmamei-core` binary that generates Photoshop scripts). The build warns instead of failing when Go is missing, so you can still run the test suite; set `EDITMAMEI_CORE_BIN` to a prebuilt binary if you would rather not install Go.
+
+The test suite runs without Photoshop. It verifies the ExtendScript Editmamei generates, never that Photoshop accepted it, so live verification against a real Photoshop is a separate step.
+
+Contributions are welcome. Start with [CONTRIBUTING.md](CONTRIBUTING.md), which covers the CLA, the branch and pull-request flow, and what to include in a bug report.
+
 ## Configuration
 
 Settings live in `~/.editmamei/settings.json`, managed by the `editmamei config` CLI:
@@ -122,17 +140,33 @@ editmamei config set ps_path "/path/to/Photoshop"
 
 Editmamei runs on your computer and edits in your own Photoshop. No image content, document data, or file paths are sent to Editmamei's servers. It reports anonymous, content-free usage telemetry (on by default, turn it off with `editmamei config set telemetry.usage false`). When your AI assistant needs to see a result, Editmamei sends it a downscaled preview, the same as dropping a photo into a chat with that assistant. Every field is documented in [privacy.md](https://github.com/editmamei/editmamei-wiki/blob/main/docs/privacy.md).
 
+The source in this repository is the same code published to npm, so none of the above has to be taken on trust.
+
 ## Docs and support
 
 - **Features and pricing:** [editmamei.com](https://editmamei.com)
 - **Install, getting started, FAQ, Pro features:** [the wiki](https://github.com/editmamei/editmamei-wiki)
 - **Bugs and feature requests:** [the issue tracker](https://github.com/editmamei/editmamei-wiki/issues). If something's broken, ask your assistant to "report a problem" (or run `editmamei report`) to drop an anonymized diagnostic bundle in your Downloads folder, then attach it to the issue.
-- **Security:** see [editmamei.com/security](https://editmamei.com/security) (don't file security issues publicly)
+- **Security:** see [SECURITY.md](SECURITY.md) (don't file security issues publicly)
 
 ## License
 
-Proprietary, free to install and use. See [the license](https://editmamei.com/license). Third-party dependencies keep their own licenses, listed in the bundled `NOTICES.md`.
+Editmamei CE is [Fair Source](https://fair.io) software under the
+[Functional Source License, v1.1, MIT Future License](LICENSE.md) (FSL-1.1-MIT).
+
+You can read, run, modify, and redistribute the code for almost anything: commercial photo
+editing, internal tools, education, research, security review. The one thing the license
+holds back, for two years per release, is offering the code to others in a commercial
+product or service that competes with Editmamei CE or Pro. If you redistribute the code,
+keep the license and copyright notices with it. Two years after each version ships, that
+version automatically becomes available under plain [MIT](LICENSE.md).
+
+This section is a plain-English summary. The [LICENSE](LICENSE.md) file is the license;
+where they differ, the LICENSE file controls.
+
+Editmamei is not open source under the OSI definition, and we don't call it that. It is
+source-available, with the full CE stack developed in the open.
 
----
+Editmamei Pro is a separate, commercially licensed module; its source is not published.
 
-_Pairs well with: a layered PSD, a willing AI, and a small bowl of edamame._
+Third-party dependencies keep their own licenses, listed in [NOTICES.md](NOTICES.md).

package/dist/api/extendscript/_helpers.js

@@ -3,18 +3,6 @@ export const helperFunctions = `
 function cTID(s) { return app.charIDToTypeID(s); }
 function sTID(s) { return app.stringIDToTypeID(s); }
 `;
-export const bitsPerChannelHelper = `
-function getBitsPerChannelInt(doc) {
-  try {
-    var bpc = doc.bitsPerChannel;
-    if (bpc === BitsPerChannelType.ONE) return 1;
-    if (bpc === BitsPerChannelType.EIGHT) return 8;
-    if (bpc === BitsPerChannelType.SIXTEEN) return 16;
-    if (bpc === BitsPerChannelType.THIRTYTWO) return 32;
-  } catch (e) {}
-  return 0;
-}
-`;
 export const normNameHelper = `
 function normName(s) {
   if (s === null || s === undefined) return '';
@@ -194,7 +182,7 @@ export function duplicateForOp(opName, applyToActiveLayer) {
     `;
     }
     return `
-    // Bundle O auto-duplicate-first: the destructive op below will act on
+    // Auto-duplicate-first: the destructive op below will act on
     // a fresh copy of the active layer so the original is preserved.
     // Undoing the op is as simple as deleting the copy.
     var __opOriginal = doc.activeLayer;
@@ -398,91 +386,3 @@ function __hoistFromActiveGroupIfNeeded(doc, preMkActive, newLayer, intoActiveGr
   return false;
 }
 `;
-export const layerResolveHelpers = `
-function __safeGet(fn, fallback) {
-  try { var v = fn(); return (v === undefined ? fallback : v); }
-  catch (e) { return fallback; }
-}
-
-function __findLayerPath(layers, target, prefix) {
-  var n = __safeGet(function () { return layers.length; }, 0);
-  for (var i = 0; i < n; i++) {
-    var candidate = __safeGet(function () { return layers[i]; }, null);
-    if (!candidate) continue;
-    if (candidate === target) return prefix.concat([i]);
-    var isGroup = false;
-    try { isGroup = (candidate instanceof LayerSet); } catch (eG) {}
-    if (isGroup) {
-      var childLayers = __safeGet(function () { return candidate.layers; }, null);
-      if (childLayers) {
-        var found = __findLayerPath(childLayers, target, prefix.concat([i]));
-        if (found) return found;
-      }
-    }
-  }
-  return null;
-}
-
-function __findLayerById(layers, id) {
-  var n = __safeGet(function () { return layers.length; }, 0);
-  for (var i = 0; i < n; i++) {
-    var candidate = __safeGet(function () { return layers[i]; }, null);
-    if (!candidate) continue;
-    var cid = __safeGet(function () { return candidate.id; }, null);
-    if (cid === id) return candidate;
-    var isGroup = false;
-    try { isGroup = (candidate instanceof LayerSet); } catch (eG) {}
-    if (isGroup) {
-      var childLayers = __safeGet(function () { return candidate.layers; }, null);
-      if (childLayers) {
-        var found = __findLayerById(childLayers, id);
-        if (found) return found;
-      }
-    }
-  }
-  return null;
-}
-
-function __resolvePath(doc, path) {
-  var current = doc;
-  for (var i = 0; i < path.length; i++) {
-    var idx = path[i];
-    current = __safeGet(function () { return current.layers[idx]; }, null);
-    if (!current) return null;
-  }
-  return current;
-}
-
-function __captureLayerIdentity(doc, layer) {
-  var id = null;
-  try { if (typeof layer.id !== 'undefined') { id = layer.id; } } catch (eId) {}
-  var path = null;
-  if (id === null) {
-    path = __findLayerPath(doc.layers, layer, []);
-  }
-  return { id: id, path: path };
-}
-
-function __resolveLayerFresh(doc, identity) {
-  if (identity.id !== null) {
-    var byId = __findLayerById(doc.layers, identity.id);
-    if (byId) return byId;
-  }
-  if (identity.path) {
-    return __resolvePath(doc, identity.path);
-  }
-  return null;
-}
-
-function __resolveLayerFreshOrActive(doc, identity) {
-  var resolved = __resolveLayerFresh(doc, identity);
-  if (resolved) return resolved;
-  // Identity resolution came up empty even though the write may have
-  // landed — e.g. Photoshop auto-promoting a Background layer as a side
-  // effect of the property write. Fall back to the current active layer
-  // (these setters always operate on doc.activeLayer, and Photoshop keeps
-  // it pointed at the promoted layer) rather than treating an unresolved
-  // identity as proof the write failed.
-  return __safeGet(function () { return doc.activeLayer; }, null);
-}
-`;

package/dist/api/photoshop-api.js

@@ -7,11 +7,12 @@ export class PhotoshopAPIFactory {
         this.connection = connection;
     }
     async createAPI() {
-        const info = this.connection.getPhotoshopInfo();
+        const info = await this.connection.ensureDetected();
         if (!info) {
-            throw new Error('Photoshop info not available. Please detect Photoshop first.');
+            throw new Error('Photoshop info not available — the local install could not be detected. ' +
+                'Check that Photoshop is installed (set PHOTOSHOP_PATH to override detection).');
         }
-        this.logger.info(`Creating ExtendScript API for Photoshop version ${info.version}`);
+        this.logger.debug(`Photoshop ${info.version} ready for scripting`);
         return new ExtendScriptPhotoshopAPI(this.connection);
     }
 }
@@ -119,17 +120,26 @@ class ExtendScriptPhotoshopAPI {
       } catch (e) {}
     }
 
-    if (typeof result === 'object' && result !== null) {
-      return __mcpJsonEncode(result);
-    }
-    if (typeof result === 'string') {
-      // Plain string return — wrap as a JSON string so the Node-side parser
-      // sees valid JSON. Handlers that expect a string still receive one.
-      return __mcpJsonEncode(result);
-    }
-    return String(result);
+    // Every outcome leaves inside an envelope, so the value a script returned
+    // is never confused with how it ended. A script that legitimately returns
+    // a string beginning with the failure marker used to come back as a thrown
+    // error; inside an envelope it round-trips untouched.
+    return __mcpJsonEncode({ __em: 1, ok: true, value: result });
   } catch (error) {
-    return 'ERROR: ' + (error.message || String(error) || ('code ' + error.number) || 'no error message');
+    // Photoshop's error carries more than a message. Passing the number and
+    // line through means a failure can be identified rather than string-matched
+    // on prose that changes between releases and locales.
+    var __message = '';
+    try { __message = (error && error.message) ? String(error.message) : String(error); } catch (e) { __message = 'unreadable error'; }
+    var __number = null;
+    try { if (error && typeof error.number === 'number') __number = error.number; } catch (e) {}
+    var __line = null;
+    try { if (error && typeof error.line === 'number') __line = error.line; } catch (e) {}
+    return __mcpJsonEncode({
+      __em: 1,
+      ok: false,
+      error: { message: __message, number: __number, line: __line }
+    });
   } finally {
     try { if (__originalRulerUnits !== null) app.preferences.rulerUnits = __originalRulerUnits; } catch (e) {}
     try { if (__originalTypeUnits !== null) app.preferences.typeUnits = __originalTypeUnits; } catch (e) {}
@@ -138,7 +148,4 @@ class ExtendScriptPhotoshopAPI {
 })();
     `.trim();
     }
-    getAPIType() {
-        return 'ExtendScript';
-    }
 }

package/dist/api/snippet-client.js

@@ -52,21 +52,49 @@ export class CompositeSnippetClient {
         return target.build(name, params);
     }
 }
+const SNIPPET_CACHE_MAX_ENTRIES = 256;
 export class GoSnippetClient {
     binaryPath;
     timeoutMs;
     extraEnv;
+    cache = new Map();
+    cachedBinaryMtimeMs = null;
     constructor(opts = {}) {
         this.binaryPath = opts.binaryPath ?? resolveCoreBinaryPath();
         this.timeoutMs = opts.timeoutMs ?? 10_000;
-        this.extraEnv = opts.env ?? {};
+        this.extraEnv = { ...(opts.env ?? {}) };
+    }
+    refreshCacheValidity() {
+        let mtimeMs;
+        try {
+            mtimeMs = statSync(this.binaryPath).mtimeMs;
+        }
+        catch {
+            return false;
+        }
+        if (mtimeMs !== this.cachedBinaryMtimeMs) {
+            this.cache.clear();
+            this.cachedBinaryMtimeMs = mtimeMs;
+        }
+        return true;
     }
     async build(name, params = {}) {
         ensureExecutable(this.binaryPath);
+        const paramsJson = JSON.stringify(params);
+        const cacheUsable = this.refreshCacheValidity();
+        const cacheKey = name + '\u0000' + paramsJson;
+        if (cacheUsable) {
+            const cached = this.cache.get(cacheKey);
+            if (cached !== undefined) {
+                this.cache.delete(cacheKey);
+                this.cache.set(cacheKey, cached);
+                return cached;
+            }
+        }
         const env = Object.keys(this.extraEnv).length > 0 ? { ...process.env, ...this.extraEnv } : undefined;
         const result = await runChildWithTimeout(this.binaryPath, ['build', name], {
             timeout: this.timeoutMs,
-            input: JSON.stringify(params),
+            input: paramsJson,
             diagLabel: `editmamei-core build ${name}`,
             env,
         });
@@ -74,6 +102,14 @@ export class GoSnippetClient {
             throw new Error(`editmamei-core build "${name}" failed (exit ${result.exitCode}): ` +
                 `${result.stderr.trim() || '(no stderr)'}`);
         }
+        if (cacheUsable) {
+            this.cache.set(cacheKey, result.stdout);
+            if (this.cache.size > SNIPPET_CACHE_MAX_ENTRIES) {
+                const oldestKey = this.cache.keys().next().value;
+                if (oldestKey !== undefined)
+                    this.cache.delete(oldestKey);
+            }
+        }
         return result.stdout;
     }
 }