editmamei 1.0.2 → 1.1.0

package/README.md

@@ -47,7 +47,7 @@ Then restart your AI client and ask it: _"Is Photoshop connected?"_
 
 Prefer not to use a terminal? Claude Desktop users can install the one-click [`.mcpb` extension](https://github.com/editmamei/editmamei/releases/latest/download/editmamei.mcpb) directly (no system Node required, Claude Desktop ships its own runtime). Full walkthrough in the [install guide](docs/installation.md).
 
-**Requirements:** Adobe Photoshop 2026 (v27.x), Windows 10/11 or macOS 12+, Node.js 20+ (for the npm path), and an MCP-compatible AI client (Claude Desktop, Cursor, Claude Code).
+**Requirements:** Adobe Photoshop 2026 (v27.x), Windows 10/11 or macOS 12+, Node.js 22+ (for the npm path), and an MCP-compatible AI client (Claude Desktop, Cursor, Claude Code).
 
 ## A session, end to end
 
@@ -75,7 +75,7 @@ These are the choices that shape the surface, and the reason an AI assistant can
 
 ## Tool surface
 
-**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.
+**82 tools across 16 capability groups** (59 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. `tools/list` reports eight more than the table below: the names superseded by `filter`, `group`, and `text` (`apply_filter`, `create_group`, `move_layer_to_group`, `set_group_blend_mode`, `ungroup`, `delete_group`, `create_text_layer`, `set_text`) stay registered as deprecated aliases for one release, so existing calls keep working.
 
 | Group | Edition | Tools |
 | --- | --- | --- |
@@ -85,11 +85,11 @@ These are the choices that shape the surface, and the reason an AI assistant can
 | **Document & canvas** | Community | `create_document` · `open_document` · `close_document` · `save_psd` · `export` · `place_image` · `resize_image` · `crop_document` · `convert_image_mode` · `transform_canvas` · `guides` |
 | **Selection** | Community | `select` · `modify_selection` · `selection_channel` |
 | **Adjustments** | Community | `add_adjustment_layer` · `apply_adjustment` |
-| **Filters** | Community | `apply_filter` |
+| **Filters** | Community | `filter` |
 | **Retouch** | Community | `retouch` |
-| **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` |
+| **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` · `group` |
+| **Masks & paths** | Community | `layer_mask` · `clipping_mask` · `path` · `vector_mask` · `apply_image` · `calculations` |
+| **Type** | Community | `text` |
 | **Perception** | Community | `detect` · `read_scene` · `select_by_reference` |
 | **AI selection** | Community | `select_subject` · `select_sky` |
 | **AI selection** | Pro | `select_subject_instance` · `select_object` |
@@ -119,7 +119,7 @@ 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.
+You need Node.js 22+ 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.
 

package/dist/api/extendscript/_helpers.js

@@ -18,6 +18,69 @@ function normName(s) {
   return result.replace(/\\s+/g, ' ').replace(/^\\s+|\\s+$/g, '').toLowerCase();
 }
 `;
+export const notFoundMessageHelper = `
+function __notFoundMessage(label, requested, groupsOnly) {
+  var kept = [];
+  var total = 0;
+  var walkBroke = false;
+  function __nfEsc(s) {
+    var out = '';
+    for (var c = 0; c < s.length; c++) {
+      var code = s.charCodeAt(c);
+      if (code >= 32 && code <= 126 && code !== 92) {
+        out += s.charAt(c);
+      } else {
+        var hex = code.toString(16);
+        while (hex.length < 4) hex = '0' + hex;
+        out += '\\\\u' + hex;
+      }
+    }
+    return out;
+  }
+  function consider(layer) {
+    var nm = '';
+    try { nm = String(layer.name); } catch (eN) { walkBroke = true; return; }
+    total++;
+    if (kept.length >= 8) return;
+    nm = __nfEsc(nm);
+    if (nm.length > 40) {
+      nm = nm.substring(0, 40);
+      var cut = nm.lastIndexOf('\\\\u');
+      if (cut > 34) nm = nm.substring(0, cut);
+      nm = nm + '...';
+    }
+    kept.push(nm);
+  }
+  function walk(layers, depth) {
+    var n = 0;
+    try { n = layers.length; } catch (eL) { walkBroke = true; return; }
+    for (var i = 0; i < n; i++) {
+      var l = null;
+      try { l = layers[i]; } catch (eI) { walkBroke = true; continue; }
+      if (!l) continue;
+      var isGroup = false;
+      try { isGroup = (l instanceof LayerSet); } catch (eG) {}
+      if (isGroup || !groupsOnly) consider(l);
+      if (isGroup && depth < 32) {
+        try { walk(l.layers, depth + 1); } catch (eD) { walkBroke = true; }
+      }
+    }
+  }
+  try { walk(app.activeDocument.layers, 0); } catch (eW) { walkBroke = true; }
+  if (walkBroke && total === 0) {
+    return label + ' not found: ' + __nfEsc(String(requested));
+  }
+  var have;
+  if (total === 0) {
+    have = groupsOnly ? '(no groups)' : '(none)';
+  } else {
+    have = kept.join(', ');
+    if (total > kept.length) have += ' (+' + (total - kept.length) + ' more)';
+    if (walkBroke) have += ' (list may be incomplete)';
+  }
+  return label + ' not found: ' + __nfEsc(String(requested)) + '. Have: ' + have;
+}
+`;
 export const selectionTypeHelpers = `
 function mapSelType(s) {
   if (s === 'add' || s === 'extend') return SelectionType.EXTEND;
@@ -222,8 +285,7 @@ function getContextInfo() {
   // during the context probe should NOT make the op look failed to the
   // caller. On any unexpected throw we return a degraded context with
   // an error_reading field so the caller can see something happened
-  // but the structured result still arrives. T05 P1-4 in the
-  // launch-readiness review.
+  // but the structured result still arrives.
   try {
     var context = {
       hasDocument: app.documents.length > 0

package/dist/api/photoshop-api.js

@@ -33,7 +33,7 @@ class ExtendScriptPhotoshopAPI {
                     'This usually means PS is in a stuck/modal state (a leaked preview duplicate ' +
                     'or a pending dialog from a prior timeout), or there is no active document. ' +
                     'Check that a document is open and try once more; if it persists, dismiss any ' +
-                    'open Photoshop dialog.');
+                    'open Photoshop dialog.', { cause: err });
             }
             throw err instanceof Error ? err : new Error(msg);
         }

package/dist/cli/activate.js

@@ -33,7 +33,7 @@ export async function runActivate(opts = {}) {
     catch (e) {
         if (e instanceof PolarLicenseError) {
             err(`Activation failed: ${e.message}\n`);
-            throw new Error(e.code);
+            throw new Error(e.code, { cause: e });
         }
         throw e;
     }

package/dist/cli/config.js

@@ -98,7 +98,7 @@ export function runConfig(args, io = {}) {
         }
         catch (e) {
             err(`Invalid value for ${key}: ${e instanceof Error ? e.message : String(e)}\n`);
-            throw new Error('config set: bad value');
+            throw new Error('config set: bad value', { cause: e });
         }
         const { settings } = loadSettings(io);
         spec.set(settings, coerced);

package/dist/cli/deactivate.js

@@ -12,7 +12,7 @@ export async function runDeactivate(opts = {}) {
     catch (e) {
         if (e instanceof PolarLicenseError) {
             err(`Deactivate failed: ${e.message}\n`);
-            throw new Error(e.code);
+            throw new Error(e.code, { cause: e });
         }
         throw e;
     }

package/dist/core/raw-develop-state.js

@@ -0,0 +1,13 @@
+let pending = null;
+export function markRawOpened(documentName, filePath) {
+    pending = { documentName, filePath };
+}
+export function clearPendingRawDevelop() {
+    pending = null;
+}
+export function getPendingRawDevelop() {
+    return pending;
+}
+export function __clearRawDevelopState() {
+    pending = null;
+}

package/dist/core/server.js

@@ -21,6 +21,7 @@ import { runScript } from '../utils/run-script.js';
 import { listTemplates } from '../utils/template-storage.js';
 import { toolErrorResult } from '../utils/tool-helpers.js';
 import { Kernel } from '../kernel/kernel.js';
+import { markRawOpened, clearPendingRawDevelop } from './raw-develop-state.js';
 import { ceModule } from '../modules/ce/index.js';
 import { hostDetectionRuntime } from '../detection/runtime.js';
 import { ModuleLifecycle, classifyModuleOutcome } from '../kernel/module-lifecycle.js';
@@ -45,6 +46,7 @@ const FIRST_RUN_DISCLOSURE = 'First run: Editmamei collects anonymous, content-f
     'It never sends image content, file paths, or personal data. Opt out anytime: ' +
     '`editmamei config set telemetry.usage false` (or edit ~/.editmamei/settings.json). ' +
     'Opt in to sanitized diagnostics: `editmamei config set telemetry.diagnostics true`.';
+export const BACKGROUND_VERSION_PROBE_TIMEOUT_MS = 3_000;
 export class EditmameiServer {
     server;
     logger;
@@ -58,6 +60,8 @@ export class EditmameiServer {
         return this.moduleLifecycle.moduleSkipReason;
     }
     psVersion = null;
+    lastPingReachedPs = null;
+    liveVersionResolutionAttempted = false;
     updateInfo = null;
     snippetClient = new GoSnippetClient();
     refreshLicenseOnPing = createPingLicenseRefresher();
@@ -85,6 +89,11 @@ export class EditmameiServer {
         warnLogScriptOnErrorOnce(this.logger);
         this.toolRegistry = new ToolRegistry({
             onCall: (entry) => {
+                if (entry.success && entry.tool !== 'ps_ping' && this.psVersion === null) {
+                    if (this.session.getConnection().hasReachedPhotoshop()) {
+                        this.resolveLiveVersionInBackground();
+                    }
+                }
                 void this.sessionLog.append({
                     tool: entry.tool,
                     args: entry.args,
@@ -92,10 +101,11 @@ export class EditmameiServer {
                     duration_ms: entry.duration_ms,
                     ...(entry.error ? { error: entry.error } : {}),
                 }, entry.result);
+                const telemetrySuccess = entry.tool === 'ps_ping' && this.lastPingReachedPs === false ? false : entry.success;
                 const errorClass = classifyError(entry.error);
                 this.telemetry.recordCall({
                     tool: entry.tool,
-                    success: entry.success,
+                    success: telemetrySuccess,
                     duration_ms: entry.duration_ms,
                     error_class: errorClass,
                 });
@@ -284,6 +294,7 @@ export class EditmameiServer {
         try {
             const result = await this.toolRegistry.execute(name, args);
             this.session.updateActivity();
+            this.trackRawDevelopState(name, result);
             return result;
         }
         catch (error) {
@@ -291,13 +302,56 @@ export class EditmameiServer {
             return toolErrorResult('Error', error);
         }
     }
+    trackRawDevelopState(name, result) {
+        if (result.isError)
+            return;
+        if (name === 'ps_open_document') {
+            const sc = result.structuredContent;
+            if (sc?.is_raw_source === true && this.toolRegistry.get('ps_apply_camera_raw')) {
+                const opened = sc;
+                markRawOpened(String(opened.document_name ?? ''), String(opened.file_path ?? ''));
+            }
+            else {
+                clearPendingRawDevelop();
+            }
+        }
+        else if (name === 'ps_apply_camera_raw' || name === 'ps_close_document') {
+            clearPendingRawDevelop();
+        }
+    }
+    resolveLiveVersionInBackground() {
+        if (this.liveVersionResolutionAttempted || this.psVersion !== null)
+            return;
+        void (async () => {
+            try {
+                const connection = this.session.getConnection();
+                const snippet = await this.snippetClient.build('pingState');
+                if (!(await connection.isCurrentlyRunning()))
+                    return;
+                if (this.liveVersionResolutionAttempted || this.psVersion !== null)
+                    return;
+                this.liveVersionResolutionAttempted = true;
+                const state = (await runScript(connection, snippet, BACKGROUND_VERSION_PROBE_TIMEOUT_MS));
+                if (state.version && state.version !== 'Unknown' && this.psVersion === null) {
+                    this.psVersion = state.version;
+                    void this.sessionLog.setPsVersion(state.version);
+                    this.telemetry.onPsVersionResolved();
+                }
+            }
+            catch (err) {
+                this.logger.debug(`background ps_version resolution failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        })();
+    }
     async pingPhotoshop() {
+        this.lastPingReachedPs = null;
         this.refreshLicenseOnPing();
         const connection = this.session.getConnection();
         let version = 'Unknown';
         let actionSetsCount = 0;
         let openDocuments = [];
         const degraded = [];
+        let versionIsLive = false;
         try {
             const detected = await connection.getVersion();
             if (detected)
@@ -314,6 +368,7 @@ export class EditmameiServer {
             const alive = await connection.ping().catch(() => false);
             if (!alive) {
                 const reason = unsupportedHostReason();
+                this.lastPingReachedPs = false;
                 return {
                     content: [
                         {
@@ -333,6 +388,7 @@ export class EditmameiServer {
             }
             catch (err) {
                 this.logger.warn(`pingState snippet failed: ${err instanceof Error ? err.message : String(err)}`);
+                this.lastPingReachedPs = false;
                 return {
                     content: [
                         { type: 'text', text: 'Photoshop did not respond' + this.updateNote() },
@@ -340,8 +396,10 @@ export class EditmameiServer {
                     structuredContent: { connected: false, update_available: this.updateInfo },
                 };
             }
-            if (state.version)
+            if (state.version) {
                 version = state.version;
+                versionIsLive = true;
+            }
             if (typeof state.action_sets_count === 'number')
                 actionSetsCount = state.action_sets_count;
             if (Array.isArray(state.open_documents))
@@ -357,10 +415,13 @@ export class EditmameiServer {
             degraded.push('templates');
         }
         if (version !== 'Unknown') {
-            this.psVersion = version;
             void this.sessionLog.setPsVersion(version);
+        }
+        if (versionIsLive && version !== 'Unknown') {
+            this.psVersion = version;
             this.telemetry.onPsVersionResolved();
         }
+        this.lastPingReachedPs = true;
         const degradedNote = degraded.length ? ` (degraded: ${degraded.join(', ')})` : '';
         return {
             content: [

package/dist/core/tool-groups.js

@@ -7,12 +7,12 @@ export const GROUPS = {
     inspect: {
         id: 'inspect',
         label: 'Inspect',
-        purpose: 'Read document/layer/selection/history state and render previews.',
+        purpose: 'Read document/layer/selection/history/smart-object state and render previews.',
     },
     verify: {
         id: 'verify',
         label: 'Verify',
-        purpose: 'Measurement primitives — histogram, region compare, bounds diff — to check work instead of eyeballing.',
+        purpose: 'Measurement primitives — histogram, region compare, bounds diff, selection preview — to check work instead of eyeballing.',
     },
     document: {
         id: 'document',
@@ -22,12 +22,12 @@ export const GROUPS = {
     select: {
         id: 'select',
         label: 'Selection',
-        purpose: 'Manual selections, selection edits, and alpha-channel save/load.',
+        purpose: 'Manual selections, selection edits, and alpha-channel save/load/duplicate/delete.',
     },
     select_ai: {
         id: 'select_ai',
         label: 'AI selection',
-        purpose: 'Sensei/CV-backed subject & sky selection (Pro).',
+        purpose: 'Sensei/CV-backed selection: select_subject and select_sky (community), plus subject-instance selection and named-object selection (Pro).',
     },
     adjust: {
         id: 'adjust',
@@ -37,12 +37,12 @@ export const GROUPS = {
     filter: {
         id: 'filter',
         label: 'Filters',
-        purpose: 'Blur/sharpen/noise/stylize filters (auto-duplicate-first by default).',
+        purpose: 'Blur/sharpen/noise/stylize filters (auto-duplicate-first by default) and the Camera Raw develop surface, plus managing the re-editable Smart Filter stack on a Smart Object.',
     },
     retouch: {
         id: 'retouch',
         label: 'Retouch',
-        purpose: 'Content-aware fill/patch/move and brush strokes.',
+        purpose: 'Content-aware fill, patch, and move.',
     },
     layers: {
         id: 'layers',
@@ -52,7 +52,7 @@ export const GROUPS = {
     masks: {
         id: 'masks',
         label: 'Masks & paths',
-        purpose: 'Layer masks, clipping masks, vector masks, and work paths.',
+        purpose: 'Layer masks, clipping masks, vector masks, work paths, and channel compositing (apply image / calculations).',
     },
     type: {
         id: 'type',
@@ -66,8 +66,8 @@ export const GROUPS = {
     },
     face: {
         id: 'face',
-        label: 'Face mesh (Pro)',
-        purpose: 'Face-landmark perception and mesh-aimed feature selection / contour strokes (Pro).',
+        label: 'Face mesh',
+        purpose: 'Face-landmark perception and mesh-aimed feature selection / contour strokes. Pro in shipped builds.',
     },
     templates: {
         id: 'templates',
@@ -113,6 +113,7 @@ export const TOOL_GROUPS = {
     ps_select_object: 'select_ai',
     ps_add_adjustment_layer: 'adjust',
     ps_apply_adjustment: 'adjust',
+    ps_filter: 'filter',
     ps_apply_filter: 'filter',
     ps_apply_camera_raw: 'filter',
     ps_retouch: 'retouch',
@@ -137,19 +138,20 @@ export const TOOL_GROUPS = {
     ps_warp_layer_along: 'layers',
     ps_warp_layer_region: 'layers',
     ps_warp_layer_to: 'layers',
+    ps_group: 'layers',
     ps_create_group: 'layers',
     ps_move_layer_to_group: 'layers',
     ps_set_group_blend_mode: 'layers',
     ps_ungroup: 'layers',
     ps_delete_group: 'layers',
+    ps_shape: 'layers',
     ps_layer_mask: 'masks',
-    ps_create_clipping_mask: 'masks',
-    ps_release_clipping_mask: 'masks',
+    ps_clipping_mask: 'masks',
     ps_path: 'masks',
     ps_vector_mask: 'masks',
     ps_apply_image: 'masks',
     ps_calculations: 'masks',
-    ps_shape: 'layers',
+    ps_text: 'type',
     ps_create_text_layer: 'type',
     ps_set_text: 'type',
     ps_detect: 'perception',

package/dist/core/tool-tiers.js

@@ -12,14 +12,15 @@ export const TOOL_TIERS = {
     ps_open_document: 'community',
     ps_save_psd: 'community',
     ps_export: 'community',
+    ps_filter: 'community',
     ps_apply_filter: 'community',
+    ps_group: 'community',
     ps_create_group: 'community',
     ps_move_layer_to_group: 'community',
     ps_set_group_blend_mode: 'community',
     ps_ungroup: 'community',
     ps_delete_group: 'community',
-    ps_create_clipping_mask: 'community',
-    ps_release_clipping_mask: 'dev',
+    ps_clipping_mask: 'community',
     ps_undo: 'community',
     ps_redo: 'community',
     ps_place_image: 'community',
@@ -89,6 +90,7 @@ export const TOOL_TIERS = {
     ps_template_verify: 'pro',
     ps_template_recall: 'pro',
     ps_template_delete: 'pro',
+    ps_text: 'community',
     ps_set_text: 'community',
 };
 export function tierOf(toolName) {

package/dist/detection/runtime.js

@@ -67,7 +67,7 @@ export function decodeJpegBuffer(bytes) {
     }
     catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
-        throw new Error(`failed to decode JPEG buffer: ${msg}`);
+        throw new Error(`failed to decode JPEG buffer: ${msg}`, { cause: err });
     }
 }
 export function decodeJpeg(path) {
@@ -76,6 +76,6 @@ export function decodeJpeg(path) {
     }
     catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
-        throw new Error(`failed to decode JPEG at ${path}: ${msg}`);
+        throw new Error(`failed to decode JPEG at ${path}: ${msg}`, { cause: err });
     }
 }

package/dist/perception/region-scorer.js

@@ -81,7 +81,7 @@ export function scoreRegion(kind, signals, ctx) {
             signals,
         };
     }
-    let confidence = 0;
+    let confidence;
     switch (kind) {
         case 'sky': {
             const upper = rampDown(signals.centroidY, 0.35, 0.65);

package/dist/platform/connection.js

@@ -13,6 +13,7 @@ export class PhotoshopConnection {
     photoshopInfo = null;
     detectInFlight = null;
     runningLatchUntil = 0;
+    everReachedPhotoshop = false;
     constructor(opts = {}) {
         this.logger = new Logger('PhotoshopConnection');
         this.now = opts.now ?? Date.now;
@@ -71,6 +72,7 @@ export class PhotoshopConnection {
             }
             const result = await this.host.adapter.run(script, timeout);
             this.runningLatchUntil = this.now() + RUNNING_LATCH_TTL_MS;
+            this.everReachedPhotoshop = true;
             return result;
         }
         catch (error) {
@@ -99,4 +101,17 @@ export class PhotoshopConnection {
     getPhotoshopInfo() {
         return this.photoshopInfo;
     }
+    hasReachedPhotoshop() {
+        return this.everReachedPhotoshop;
+    }
+    async isCurrentlyRunning() {
+        if (!this.photoshopInfo)
+            return false;
+        try {
+            return await this.host.adapter.isRunning();
+        }
+        catch {
+            return false;
+        }
+    }
 }

package/dist/telemetry/client.js

@@ -118,6 +118,19 @@ export class TelemetryClient {
             ...(diag.stderr_tail ? { stderr_tail: sanitizeStderrTail(diag.stderr_tail) } : {}),
         }, this.now()));
     }
+    restampPsVersion(events) {
+        const resolved = this.dims.getPsVersion();
+        if (!resolved)
+            return events;
+        for (const event of events) {
+            if (event.type === 'session_summary')
+                continue;
+            if ('ps_version' in event && event.ps_version === PS_VERSION_UNKNOWN) {
+                event.ps_version = resolved;
+            }
+        }
+        return events;
+    }
     enqueue(event) {
         this.queue.push(event);
         if (this.queue.length > MAX_QUEUE_SIZE) {
@@ -129,7 +142,7 @@ export class TelemetryClient {
     async flush() {
         if (!this.active || this.queue.length === 0)
             return;
-        const batch = this.queue.splice(0, this.maxBatchSize).filter(isContentSafe);
+        const batch = this.restampPsVersion(this.queue.splice(0, this.maxBatchSize)).filter(isContentSafe);
         if (batch.length === 0)
             return;
         try {
@@ -160,7 +173,7 @@ export class TelemetryClient {
             }, this.now()));
         }
         if (this.queue.length > 0) {
-            appendOutboxSync(this.queue.splice(0).filter(isContentSafe), this.outboxOpts);
+            appendOutboxSync(this.restampPsVersion(this.queue.splice(0)).filter(isContentSafe), this.outboxOpts);
         }
         clearSessionState(this.outboxOpts);
     }

package/dist/telemetry/sanitize.js

@@ -45,6 +45,7 @@ export function sanitizeMessage(input, maxLen = MAX_MESSAGE_LEN) {
     }
     out = redactGenericUserDirs(out);
     out = basenamePaths(out);
+    out = out.replace(/\bnot found: [^\n]*/gi, 'not found: [redacted]');
     out = out.replace(/\\/g, '/');
     out = out.replace(/^[/]+/, '');
     if (out.length > maxLen)

package/dist/tools/adjustment-tools.js

@@ -1,6 +1,7 @@
 import { runScript } from '../utils/run-script.js';
 import { validateArgs } from '../utils/validate.js';
 import { toolErrorResult, runSnippetTool, applyToActiveLayerProp } from '../utils/tool-helpers.js';
+import { getPendingRawDevelop } from '../core/raw-develop-state.js';
 const addAdjustmentLayerSchema = {
     type: 'object',
     properties: {
@@ -669,7 +670,7 @@ export function createAdjustmentTools(connection, snippetClient) {
         {
             tool: {
                 name: 'ps_add_adjustment_layer',
-                description: "Create a non-destructive adjustment layer above the active layer — hoisted out of the active layer's group by default even though Photoshop's own Mk-AdjL placement rule would otherwise nest it INSIDE that group (pass into_active_group:true to keep that native nesting). Supports the full real-Photoshop tonal/color surface: Curves (with S-curve presets), Levels, Hue/Saturation, Brightness/Contrast, Black & White (with optional tint), Color Balance, Photo Filter (preset or custom color), Vibrance, Channel Mixer, Selective Color, Gradient Map (preset), Exposure (stops + offset + gamma), Color Lookup (3DLUT presets or custom file path), and Invert. Values are editable, maskable, and removable. This is the canonical entry point for ALL tonal/color adjustments; the old destructive bake tools (auto_levels / auto_contrast / desaturate / invert) were removed on 2026-05-31 — if you genuinely need a pixel bake, follow this call with `ps_merge` (mode=visible). Optionally clips the adjustment to only affect the layer directly below it. If a selection is active at call time, the new layer is automatically masked by it (toggle with mask_from_selection / mask_inverted). For destructive ops that don't have an adjustment-layer equivalent in Photoshop (Shadows/Highlights — single-pass shadow/highlight recovery), use `ps_apply_adjustment` (type=shadows_highlights) which auto-duplicates the active layer to keep the original intact. Returns context (the new adjustment layer becomes active) plus parent_path — the actual containing-group chain, so placement is never silent.",
+                description: "Create a non-destructive adjustment layer above the active layer — hoisted out of the active layer's group by default even though Photoshop's own Mk-AdjL placement rule would otherwise nest it INSIDE that group (pass into_active_group:true to keep that native nesting). Supports the full real-Photoshop tonal/color surface: Curves (with S-curve presets), Levels, Hue/Saturation, Brightness/Contrast, Black & White (with optional tint), Color Balance, Photo Filter (preset or custom color), Vibrance, Channel Mixer, Selective Color, Gradient Map (preset), Exposure (stops + offset + gamma), Color Lookup (3DLUT presets or custom file path), and Invert. Values are editable, maskable, and removable. This is the canonical entry point for tonal/color adjustments — EXCEPT global tone/color on raw-sourced documents, which starts with a Camera Raw develop pass when a camera-raw develop tool is registered (see ps_open_document's is_raw_source); the old destructive bake tools (auto_levels / auto_contrast / desaturate / invert) were removed on 2026-05-31 — if you genuinely need a pixel bake, follow this call with `ps_merge` (mode=visible). Optionally clips the adjustment to only affect the layer directly below it. If a selection is active at call time, the new layer is automatically masked by it (toggle with mask_from_selection / mask_inverted). For destructive ops that don't have an adjustment-layer equivalent in Photoshop (Shadows/Highlights — single-pass shadow/highlight recovery), use `ps_apply_adjustment` (type=shadows_highlights) which auto-duplicates the active layer to keep the original intact. Returns context (the new adjustment layer becomes active) plus parent_path — the actual containing-group chain, so placement is never silent.",
                 inputSchema: addAdjustmentLayerSchema,
                 outputSchema: {
                     type: 'object',
@@ -695,6 +696,10 @@ export function createAdjustmentTools(connection, snippetClient) {
                             items: { type: 'string' },
                             description: 'The containing-group name chain (outermost first), empty array at the document root.',
                         },
+                        raw_develop_pending: {
+                            type: 'string',
+                            description: 'Advisory, present only when the active document was opened from a raw source this session and no Camera Raw develop pass has run yet. Nothing failed — the layer was created. Global tone/color on raw sources normally starts with the camera-raw develop pass; ignore if the user prescribed this exact layer or the file was already developed elsewhere.',
+                        },
                         context: { type: 'object' },
                     },
                 },
@@ -833,14 +838,27 @@ async function addAdjustmentLayer(connection, snippetClient, rawArgs) {
             buildParams.name = name;
         const script = await snippetClient.build('addAdjustmentLayer', buildParams);
         const result = await runScript(connection, script);
+        const structured = result;
+        let advisory = '';
+        const pendingRaw = getPendingRawDevelop();
+        if (pendingRaw) {
+            const source = pendingRaw.documentName || pendingRaw.filePath || 'a raw source';
+            const note = `This document was opened from raw source ${source} with no Camera Raw develop pass yet — ` +
+                'consider ps_apply_camera_raw first for global tone/color. Nothing failed; ignore if the ' +
+                'user prescribed this exact layer or the file was already developed elsewhere.';
+            if (typeof result === 'object' && result !== null) {
+                structured.raw_develop_pending = note;
+            }
+            advisory = `\nNote: ${note}`;
+        }
         return {
             content: [
                 {
                     type: 'text',
-                    text: `Adjustment layer added:\n${JSON.stringify(result, null, 2)}`,
+                    text: `Adjustment layer added:\n${JSON.stringify(result, null, 2)}${advisory}`,
                 },
             ],
-            structuredContent: result,
+            structuredContent: structured,
         };
     }
     catch (error) {

package/dist/tools/detection-tools.js

@@ -174,7 +174,7 @@ export function createDetectionTools(connection, _snippetClient, client = new On
         {
             tool: {
                 name: 'ps_detect',
-                description: 'Locate faces and/or COCO-80 objects (person, dog, car, chair, sofa, …) in the active document using LOCAL on-device computer vision — the image is never sent anywhere. Returns labeled bounding boxes in DOCUMENT-pixel space plus an annotated preview for visual confirmation. Use this to gain semantic scene awareness ("there are 2 people and a dog") and real coordinates before any spatially-targeted edit — far more reliable than estimating positions from a preview. `target` selects faces / objects / both. Read-only: renders a throwaway duplicate, never modifies the working document. Boxes are [x1, y1, x2, y2]. Validate surprising results against the annotated image before acting on them.',
+                description: 'The cheap, narrow read: labeled bounding boxes only — faces and/or COCO-80 objects (person, dog, car, chair, sofa, …) in DOCUMENT-pixel space, plus an annotated preview for visual confirmation. LOCAL on-device computer vision; the image is never sent anywhere. Use this for real coordinates before a spatially-targeted edit when boxes are all you need — far more reliable than estimating positions from a preview. For the full scene model (regions, horizon, tonal zones, composition, and a menu of selectable named regions), use ps_read_scene instead. `target` selects faces / objects / both. Read-only: renders a throwaway duplicate, never modifies the working document. Boxes are [x1, y1, x2, y2]. Validate surprising results against the annotated image before acting on them.',
                 inputSchema: detectSchema,
                 outputSchema: {
                     type: 'object',