editmamei 1.0.3 → 1.2.0

package/dist/core/tool-tiers.js

@@ -5,6 +5,7 @@ export const TOOL_TIERS = {
     ps_list_actions: 'pro',
     ps_play_action: 'pro',
     ps_execute_script: 'pro',
+    ps_batch: 'pro',
     ps_add_adjustment_layer: 'community',
     ps_apply_adjustment: 'community',
     ps_create_document: 'community',
@@ -12,14 +13,9 @@ export const TOOL_TIERS = {
     ps_open_document: 'community',
     ps_save_psd: 'community',
     ps_export: 'community',
-    ps_apply_filter: '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_filter: 'community',
+    ps_group: 'community',
+    ps_clipping_mask: 'community',
     ps_undo: 'community',
     ps_redo: 'community',
     ps_place_image: 'community',
@@ -37,7 +33,6 @@ export const TOOL_TIERS = {
     ps_add_layer_style: 'community',
     ps_create_layer: 'community',
     ps_delete_layer: 'community',
-    ps_create_text_layer: 'community',
     ps_fill_layer: 'community',
     ps_add_fill_layer: 'community',
     ps_select_layer: 'community',
@@ -72,6 +67,8 @@ export const TOOL_TIERS = {
     ps_select_sky: 'community',
     ps_select_subject_instance: 'pro',
     ps_select_object: 'pro',
+    ps_select_focus_area: 'dev',
+    ps_replace_sky: 'dev',
     ps_modify_selection: 'community',
     ps_get_selection_preview: 'community',
     ps_selection_channel: 'community',
@@ -89,7 +86,7 @@ export const TOOL_TIERS = {
     ps_template_verify: 'pro',
     ps_template_recall: 'pro',
     ps_template_delete: 'pro',
-    ps_set_text: 'community',
+    ps_text: 'community',
 };
 export function tierOf(toolName) {
     const tier = TOOL_TIERS[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/modules/ce/index.js

@@ -29,6 +29,7 @@ import { createPathTools } from '../../tools/path-tools.js';
 import { createVectorMaskTools } from '../../tools/vector-mask-tools.js';
 import { createChannelComposeTools } from '../../tools/channel-compose-tools.js';
 import { createShapeTools } from '../../tools/shape-tools.js';
+import { createSkyTools } from '../../tools/sky-tools.js';
 const ceFactories = [
     createDocumentTools,
     createLayerTools,
@@ -57,6 +58,7 @@ const ceFactories = [
     createVectorMaskTools,
     createChannelComposeTools,
     createShapeTools,
+    createSkyTools,
 ];
 export const ceModule = {
     manifest: { id: 'ce', name: 'Editmamei Community Tools', abi: KERNEL_ABI },

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',

package/dist/tools/document-tools.js

@@ -205,7 +205,7 @@ export function createDocumentTools(connection, snippetClient) {
         {
             tool: {
                 name: 'ps_open_document',
-                description: 'Open a file from disk into Photoshop with all dialogs suppressed (uses last-used Camera Raw settings for raw/HEIC). Returns document name, dimensions, color mode, and whether the source was a raw format. Use this in the pipeline to load Inbox files for editing. If the file is ALREADY open, its existing document is activated rather than opened a second time — `already_open: true` says so, and any edits made to it are still there (Photoshop would otherwise open a duplicate with a fresh Background, which silently strands prior work).',
+                description: 'Open a file from disk into Photoshop with all dialogs suppressed (uses last-used Camera Raw settings for raw/HEIC). Returns document name, dimensions, color mode, and whether the source was a raw format. `is_raw_source` is workflow-critical, not a passive status field: when true, the first edit should be a Camera Raw develop pass on the base smart object (via a camera-raw develop tool, if one is registered in tools/list) — NOT stacked tonal adjustment layers. Use this in the pipeline to load Inbox files for editing. If the file is ALREADY open, its existing document is activated rather than opened a second time — `already_open: true` says so, and any edits made to it are still there (Photoshop would otherwise open a duplicate with a fresh Background, which silently strands prior work).',
                 inputSchema: openDocumentSchema,
                 outputSchema: {
                     type: 'object',
@@ -217,7 +217,10 @@ export function createDocumentTools(connection, snippetClient) {
                         resolution: { type: 'number' },
                         color_mode: { type: 'string' },
                         bits_per_channel: { type: 'number' },
-                        is_raw_source: { type: 'boolean' },
+                        is_raw_source: {
+                            type: 'boolean',
+                            description: 'True when the source file was a raw capture (DNG/NEF/CR3/ARW/…). Workflow-critical: the open used last-used/default Camera Raw settings, so no deliberate develop has happened yet. When true, run the Camera Raw develop pass FIRST (via a camera-raw develop tool, if registered) for global tone/color — before any tonal adjustment layers — unless the user explicitly directs otherwise.',
+                        },
                         already_open: { type: 'boolean' },
                         file_path: { type: 'string' },
                         context: { type: 'object' },