editmamei 0.24.1 → 1.0.0

package/dist/utils/logger.js

@@ -1,20 +1,20 @@
 import { recordLogLine } from './log-buffer.js';
-export var LogLevel;
-(function (LogLevel) {
-    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
-    LogLevel[LogLevel["INFO"] = 1] = "INFO";
-    LogLevel[LogLevel["WARN"] = 2] = "WARN";
-    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
-})(LogLevel || (LogLevel = {}));
-function serializeLogArg(arg) {
-    if (arg instanceof Error) {
-        const parts = [`${arg.name}: ${arg.message}`];
-        if (arg.stack)
-            parts.push(arg.stack);
+export const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+const LEVEL_LABELS = ['DEBUG', 'INFO', 'WARN', 'ERROR'];
+function describeLogValue(value) {
+    if (value instanceof Error) {
+        const parts = [`${value.name}: ${value.message}`];
+        if (value.stack)
+            parts.push(value.stack);
         const extras = {};
-        for (const key of Object.keys(arg)) {
+        for (const key of Object.keys(value)) {
             if (key !== 'name' && key !== 'message' && key !== 'stack') {
-                extras[key] = arg[key];
+                extras[key] = value[key];
             }
         }
         if (Object.keys(extras).length > 0) {
@@ -26,35 +26,40 @@ function serializeLogArg(arg) {
         }
         return parts.join('\n');
     }
-    if (arg === null || arg === undefined)
-        return String(arg);
-    if (typeof arg === 'object') {
+    if (value === null || value === undefined)
+        return String(value);
+    if (typeof value === 'object') {
         try {
-            return JSON.stringify(arg);
+            return JSON.stringify(value);
         }
         catch {
-            return String(arg);
+            return String(value);
         }
     }
-    return String(arg);
+    return String(value);
+}
+function formatRecord(record) {
+    const prefix = `[${record.at.toISOString()}] [${LEVEL_LABELS[record.level]}] [${record.scope}]`;
+    const details = record.details.map(describeLogValue).join(' ');
+    return `${prefix} ${record.message} ${details}`.trim();
 }
 export function parseLogLevel(raw, fallback) {
     if (raw === undefined || raw === '')
         return fallback;
     const asNum = Number(raw);
-    if (Number.isFinite(asNum) && asNum >= LogLevel.DEBUG && asNum <= LogLevel.ERROR) {
+    if (Number.isFinite(asNum) && asNum >= LOG_LEVELS.debug && asNum <= LOG_LEVELS.error) {
         return asNum;
     }
     switch (raw.toUpperCase()) {
         case 'DEBUG':
-            return LogLevel.DEBUG;
+            return LOG_LEVELS.debug;
         case 'INFO':
-            return LogLevel.INFO;
+            return LOG_LEVELS.info;
         case 'WARN':
         case 'WARNING':
-            return LogLevel.WARN;
+            return LOG_LEVELS.warn;
         case 'ERROR':
-            return LogLevel.ERROR;
+            return LOG_LEVELS.error;
         default:
             return fallback;
     }
@@ -66,39 +71,41 @@ function isVerboseEnabled(v) {
     return s === 'true' || s === '1';
 }
 export class Logger {
-    context;
+    scope;
     logLevel;
-    constructor(context, logLevel = LogLevel.INFO) {
-        this.context = context;
+    constructor(scope, logLevel = LOG_LEVELS.info) {
+        this.scope = scope;
         const fallback = isVerboseEnabled(process.env.EDITMAMEI_VERBOSE_LOGGING)
-            ? LogLevel.DEBUG
+            ? LOG_LEVELS.debug
             : logLevel;
         this.logLevel = parseLogLevel(process.env.LOG_LEVEL, fallback);
     }
-    log(level, message, ...args) {
+    log(level, message, ...details) {
         if (level < this.logLevel)
             return;
-        const timestamp = new Date().toISOString();
-        const levelStr = LogLevel[level];
-        const prefix = `[${timestamp}] [${levelStr}] [${this.context}]`;
-        const formattedArgs = args.map(serializeLogArg).join(' ');
-        const logMessage = `${prefix} ${message} ${formattedArgs}`.trim();
-        process.stderr.write(logMessage + '\n');
-        recordLogLine(logMessage);
+        const line = formatRecord({
+            at: new Date(),
+            level,
+            scope: this.scope,
+            message,
+            details,
+        });
+        process.stderr.write(line + '\n');
+        recordLogLine(line);
     }
     isDebugEnabled() {
-        return this.logLevel <= LogLevel.DEBUG;
+        return this.logLevel <= LOG_LEVELS.debug;
     }
-    debug(message, ...args) {
-        this.log(LogLevel.DEBUG, message, ...args);
+    debug(message, ...details) {
+        this.log(LOG_LEVELS.debug, message, ...details);
     }
-    info(message, ...args) {
-        this.log(LogLevel.INFO, message, ...args);
+    info(message, ...details) {
+        this.log(LOG_LEVELS.info, message, ...details);
     }
-    warn(message, ...args) {
-        this.log(LogLevel.WARN, message, ...args);
+    warn(message, ...details) {
+        this.log(LOG_LEVELS.warn, message, ...details);
     }
-    error(message, ...args) {
-        this.log(LogLevel.ERROR, message, ...args);
+    error(message, ...details) {
+        this.log(LOG_LEVELS.error, message, ...details);
     }
 }

package/dist/utils/session-log.js

@@ -197,8 +197,8 @@ export class SessionLog {
         };
     }
     async emitMeta() {
-        await this.writeLine(JSON.stringify(this.buildMetaEntry()));
         this.metaEmitted = true;
+        await this.writeLine(JSON.stringify(this.buildMetaEntry()));
     }
     async append(entry, result) {
         if (!this.metaEmitted) {

package/dist/utils/tool-helpers.js

@@ -1,13 +1,19 @@
 import { runScript } from './run-script.js';
 import { validateArgs } from './validate.js';
 const PENDING_STATE_HINT = ' This usually means an operation is pending in Photoshop (active transform, open dialog, uncommitted text edit). Commit or cancel it in Photoshop and retry.';
-const PENDING_STATE_RE = /pending|in progress|modal|currently in|is open/i;
+const PENDING_STATE_RE = /pending|in progress|modal|currently in|(?:dialog|window|panel) is open/i;
 const HAS_OWN_ADVICE_RE = /dismiss any open Photoshop dialog/i;
 export function toolErrorResult(prefix, error) {
     const msg = error instanceof Error ? error.message : String(error);
-    const hint = PENDING_STATE_RE.test(msg) && !HAS_OWN_ADVICE_RE.test(msg) ? PENDING_STATE_HINT : '';
+    const wantsHint = PENDING_STATE_RE.test(msg) && !HAS_OWN_ADVICE_RE.test(msg);
+    const separator = wantsHint && !/[.!?]$/.test(msg.trimEnd()) ? '.' : '';
     return {
-        content: [{ type: 'text', text: `${prefix}: ${msg}${hint}` }],
+        content: [
+            {
+                type: 'text',
+                text: `${prefix}: ${msg}${separator}${wantsHint ? PENDING_STATE_HINT : ''}`,
+            },
+        ],
         isError: true,
     };
 }

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.24.1';
+export const VERSION = '1.0.0';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "editmamei",
-  "version": "0.24.1",
-  "description": "Editmamei — Unlock Photoshop with natural-language photo editing (Community Edition)",
+  "version": "1.0.0",
+  "description": "Photoshop MCP server: natural-language AI photo editing with your own Photoshop (Community Edition)",
   "main": "dist/index.js",
   "type": "module",
   "bin": {
@@ -18,16 +18,23 @@
   },
   "keywords": [
     "mcp",
+    "mcp-server",
     "photoshop",
+    "photoshop-mcp",
     "adobe",
     "automation",
+    "photoshop-automation",
     "ai",
+    "ai-photo-editing",
+    "photoshop-assistant",
     "model-context-protocol",
     "image-editing",
+    "batch-editing",
+    "claude",
     "editmamei"
   ],
   "author": "Editmamei (https://editmamei.com)",
-  "license": "SEE LICENSE IN LICENSE",
+  "license": "FSL-1.1-MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/editmamei/editmamei.git"

package/LICENSE

@@ -1,81 +0,0 @@
-Editmamei License Agreement
-
-Copyright (c) 2026 EMBD Artifacts LLC. All rights reserved.
-
-This License Agreement (the "Agreement") governs your use of the Editmamei
-software distributed in this package — including the command-line interface,
-the Model Context Protocol (MCP) server, the bundled engine binaries, and all
-accompanying files (collectively, the "Software"). By installing, copying, or
-using the Software, you agree to be bound by this Agreement. If you do not
-agree, do not install or use the Software.
-
-1. License grant.
-   Subject to your compliance with this Agreement, EMBD Artifacts LLC grants
-   you a personal, worldwide, royalty-free, non-exclusive, non-transferable,
-   and revocable license to install and use the Software, at no charge, on
-   devices you own or control, for your own personal or commercial
-   photo-editing work.
-
-2. Paid features.
-   Some features (the "Pro" features) are not included in the no-charge license
-   granted above and require a separate paid license. Access to Pro features is
-   governed by the additional terms presented at the time of purchase. Nothing
-   in this Agreement grants any right to Pro features without a valid paid
-   license.
-
-3. Restrictions.
-   Except as expressly permitted in Section 1, or to the extent a restriction
-   below is prohibited by applicable law, you may not:
-   (a) copy (other than a reasonable number of backup copies), publish,
-       distribute, sublicense, rent, lease, lend, or sell the Software;
-   (b) modify, adapt, translate, or create derivative works of the Software;
-   (c) reverse engineer, decompile, or disassemble the Software, or otherwise
-       attempt to derive its source code or underlying ideas;
-   (d) remove, obscure, or alter any copyright, trademark, or other proprietary
-       notice in the Software or this Agreement; or
-   (e) circumvent, disable, or interfere with any licensing, entitlement, or
-       technical protection measure, including to access Pro features without a
-       valid paid license.
-
-4. Ownership.
-   The Software is licensed, not sold. EMBD Artifacts LLC and its licensors
-   retain all right, title, and interest in and to the Software, including all
-   intellectual property rights. All rights not expressly granted in this
-   Agreement are reserved.
-
-5. Third-party components.
-   The Software incorporates components provided by third parties under their
-   own licenses. Those licenses continue to apply to the corresponding
-   components and, in the event of a conflict, govern those components only.
-   Required attributions and notices are reproduced in the accompanying
-   NOTICES.md file; the full license text for each dependency ships with that
-   dependency through the npm package manager (see node_modules/<package>/
-   after install).
-
-6. Term and termination.
-   This Agreement is effective until terminated. The license granted in
-   Section 1 terminates automatically, without notice, if you breach any term
-   of this Agreement. Upon termination you must cease all use of the Software
-   and delete all copies in your possession or control. Sections 3 through 9
-   survive termination.
-
-7. Disclaimer of warranty.
-   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-   IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-   FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT.
-
-8. Limitation of liability.
-   IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES, OR
-   OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE,
-   ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
-   DEALINGS IN THE SOFTWARE.
-
-9. General.
-   This Agreement is the entire agreement between you and EMBD Artifacts LLC
-   regarding the Software and supersedes any prior or contemporaneous
-   understanding. If any provision is held unenforceable, the remaining
-   provisions remain in full force and effect. A failure to enforce any
-   provision is not a waiver of it.
-
-For commercial licensing, redistribution rights, or other inquiries, contact:
-support@editmamei.com

package/dist/platform/detector.js

@@ -1,32 +0,0 @@
-import { platform } from 'os';
-import { Logger } from '../utils/logger.js';
-import { WindowsDetector } from './windows-detector.js';
-import { MacOSDetector } from './macos-detector.js';
-export class PhotoshopDetector {
-    logger;
-    platformType;
-    windowsDetector;
-    macosDetector;
-    constructor() {
-        this.logger = new Logger('PhotoshopDetector');
-        this.platformType = platform();
-        if (this.platformType === 'win32') {
-            this.windowsDetector = new WindowsDetector();
-        }
-        else if (this.platformType === 'darwin') {
-            this.macosDetector = new MacOSDetector();
-        }
-    }
-    async detect() {
-        this.logger.info(`Detecting Photoshop on ${this.platformType}...`);
-        if (this.platformType === 'win32' && this.windowsDetector) {
-            return await this.windowsDetector.detect();
-        }
-        else if (this.platformType === 'darwin' && this.macosDetector) {
-            return await this.macosDetector.detect();
-        }
-        else {
-            throw new Error(`Unsupported platform: ${this.platformType}`);
-        }
-    }
-}

package/dist/platform/macos-executor.js

@@ -1,96 +0,0 @@
-import { exec, spawn } from 'child_process';
-import { promisify } from 'util';
-import { Logger } from '../utils/logger.js';
-import { TempDir } from '../utils/temp.js';
-import { runChildWithTimeout } from './run-child.js';
-import { ScriptQueue } from './executor-queue.js';
-const execAsync = promisify(exec);
-export class MacOSExecutor {
-    logger;
-    queue;
-    appName = 'Adobe Photoshop 2025';
-    constructor() {
-        this.logger = new Logger('MacOSExecutor');
-        this.queue = new ScriptQueue(this.logger);
-    }
-    setAppName(appName) {
-        if (/["\\\r\n\t]/.test(appName)) {
-            throw new Error('appName contains a character that would break AppleScript interpolation');
-        }
-        this.appName = appName;
-        this.logger.debug(`App name set to: ${appName}`);
-    }
-    async execute(script, timeout = 30000) {
-        return this.queue.enqueue(() => this.executeScript(script, timeout), timeout);
-    }
-    async executeScript(script, timeout) {
-        const dir = await TempDir.create('editmamei-mac-');
-        try {
-            const jsxPath = await dir.write('script.jsx', script);
-            const wrapperPath = await dir.write('wrapper.scpt', this.createAppleScriptWrapper(jsxPath, timeout));
-            const { stdout, stderr, exitCode } = await runChildWithTimeout('osascript', [wrapperPath], {
-                timeout,
-                diagLabel: 'osascript wrapper.scpt',
-            });
-            if (stderr) {
-                this.logger.warn('Script execution warning:', stderr);
-            }
-            if (exitCode !== 0) {
-                throw new Error(`osascript exited with code ${exitCode}: ${stderr.trim() || '(no stderr)'}`);
-            }
-            return this.parseResult(stdout);
-        }
-        finally {
-            await dir.cleanup();
-        }
-    }
-    createAppleScriptWrapper(jsxPath, timeoutMs = 30000) {
-        const posixPath = jsxPath.replace(/\\/g, '/');
-        if (posixPath.includes('"') || posixPath.includes('\n')) {
-            throw new Error('jsxPath contains a character that would break AppleScript interpolation');
-        }
-        const timeoutSeconds = Number.isFinite(timeoutMs) && timeoutMs > 0 ? Math.max(1, Math.ceil(timeoutMs / 1000)) : 1;
-        const encodedPath = encodeURI(posixPath).replace(/'/g, '%27');
-        return `with timeout of ${timeoutSeconds} seconds
-\ttell application "${this.appName}"
-\t\tdo javascript "$.evalFile(decodeURI('${encodedPath}'))"
-\tend tell
-end timeout`;
-    }
-    parseResult(output) {
-        const trimmed = output.trim();
-        if (trimmed.startsWith('ERROR:')) {
-            throw new Error(trimmed.substring(6).trim());
-        }
-        try {
-            return JSON.parse(trimmed);
-        }
-        catch {
-            return trimmed;
-        }
-    }
-    async isPhotoshopRunning() {
-        try {
-            const { stdout } = await execAsync('pgrep -f "Adobe Photoshop"');
-            return stdout.trim().length > 0;
-        }
-        catch {
-            return false;
-        }
-    }
-    async launchPhotoshop(photoshopPath) {
-        return new Promise((resolve, reject) => {
-            this.logger.info(`Launching Photoshop: ${photoshopPath}`);
-            const child = spawn('open', ['-a', photoshopPath], { detached: true, stdio: 'ignore' });
-            child.unref();
-            const ready = setTimeout(() => {
-                ready.unref();
-                resolve();
-            }, 5000);
-            child.on('error', (error) => {
-                clearTimeout(ready);
-                reject(new Error(`Failed to launch Photoshop: ${error.message}`));
-            });
-        });
-    }
-}

package/dist/platform/windows-executor.js

@@ -1,105 +0,0 @@
-import { spawn } from 'child_process';
-import { promisify } from 'util';
-import { exec } from 'child_process';
-import { Logger } from '../utils/logger.js';
-import { TempDir } from '../utils/temp.js';
-import { runChildWithTimeout } from './run-child.js';
-import { ScriptQueue } from './executor-queue.js';
-const execAsync = promisify(exec);
-export class WindowsExecutor {
-    logger;
-    queue;
-    constructor() {
-        this.logger = new Logger('WindowsExecutor');
-        this.queue = new ScriptQueue(this.logger);
-    }
-    async execute(script, timeout = 30000) {
-        return this.queue.enqueue(() => this.executeScript(script, timeout), timeout);
-    }
-    async executeScript(script, timeout) {
-        const dir = await TempDir.create('editmamei-win-');
-        try {
-            const jsxPath = await dir.write('script.jsx', script);
-            const vbsPath = await dir.write('wrapper.vbs', this.createVBSWrapper(jsxPath));
-            const { stdout, stderr } = await runChildWithTimeout('cscript', ['//nologo', vbsPath], {
-                timeout,
-                diagLabel: 'cscript wrapper.vbs',
-            });
-            if (stderr) {
-                this.logger.warn('Script execution warning:', stderr);
-            }
-            return this.parseResult(stdout);
-        }
-        finally {
-            await dir.cleanup();
-        }
-    }
-    createVBSWrapper(jsxPath) {
-        if (jsxPath.includes('"')) {
-            throw new Error('jsxPath contains a double-quote — refusing to compose VBS');
-        }
-        return `
-On Error Resume Next
-Dim photoshopApp
-Set photoshopApp = CreateObject("Photoshop.Application")
-
-If Err.Number <> 0 Then
-    WScript.Echo "ERROR: Failed to connect to Photoshop - " & Err.Description
-    WScript.Quit 1
-End If
-
-' Execute the JSX script. The path is the mkdtemp temp file (double-quote-free
-' by the guard above; apostrophes are fine here), but its single backslashes
-' must be DOUBLED here: this string is
-' handed to DoJavaScript as ExtendScript SOURCE, and a backslash inside a quoted
-' path there is a JS string-literal escape (a Users/Temp segment would be parsed
-' as an escape sequence and corrupt the path). The VBS Replace doubles each
-' backslash so ExtendScript resolves it back. Load-bearing — NOT a no-op.
-Dim result
-result = photoshopApp.DoJavaScript("$.evalFile(""" & Replace("${jsxPath}", "\\", "\\\\") & """);")
-
-If Err.Number <> 0 Then
-    WScript.Echo "ERROR: " & Err.Description
-    WScript.Quit 1
-Else
-    WScript.Echo result
-End If
-`.trim();
-    }
-    parseResult(output) {
-        const trimmed = output.trim();
-        if (trimmed.startsWith('ERROR:')) {
-            throw new Error(trimmed.substring(6).trim());
-        }
-        try {
-            return JSON.parse(trimmed);
-        }
-        catch {
-            return trimmed;
-        }
-    }
-    async isPhotoshopRunning() {
-        try {
-            const { stdout } = await execAsync('tasklist /FI "IMAGENAME eq Photoshop.exe"');
-            return stdout.toLowerCase().includes('photoshop.exe');
-        }
-        catch {
-            return false;
-        }
-    }
-    async launchPhotoshop(photoshopPath) {
-        return new Promise((resolve, reject) => {
-            this.logger.info(`Launching Photoshop: ${photoshopPath}`);
-            const child = spawn(photoshopPath, [], { detached: true, stdio: 'ignore' });
-            child.unref();
-            const ready = setTimeout(() => {
-                ready.unref();
-                resolve();
-            }, 5000);
-            child.on('error', (error) => {
-                clearTimeout(ready);
-                reject(new Error(`Failed to launch Photoshop: ${error.message}`));
-            });
-        });
-    }
-}