editmamei 1.2.1 → 1.3.0

package/dist/cli/repair.js

@@ -26,11 +26,19 @@ export async function runRepair(opts = {}) {
         out(`  Installed ${m.sku} module v${m.version}.\n`);
     for (const s of prov.skipped)
         out(`  Skipped ${s.sku} v${s.version}: ${s.reason}.\n`);
-    for (const e of prov.errors) {
+    const tooNew = prov.errors.filter((e) => e.code === 'abi_too_new');
+    const failures = prov.errors.filter((e) => e.code !== 'abi_too_new');
+    for (const e of tooNew) {
+        out(`  The published ${e.sku} module needs a newer Editmamei than this one — ` +
+            `update Editmamei to load it. Your installed module is unchanged.\n`);
+    }
+    for (const e of failures) {
         err(`  Error: could not provision the ${e.sku} module: ${e.message}\n`);
     }
-    if (prov.errors.length > 0) {
+    if (failures.length > 0) {
         throw new Error('module re-provisioning failed');
     }
-    out('\nRestart your MCP client (Claude Desktop / Claude Code) to load Pro tools.\n');
+    if (prov.installed.length > 0 || tooNew.length === 0) {
+        out('\nRestart your MCP client (Claude Desktop / Claude Code) to load Pro tools.\n');
+    }
 }

package/dist/core/tool-tiers.js

@@ -8,7 +8,7 @@ export const TOOL_TIERS = {
     ps_batch: 'pro',
     ps_add_adjustment_layer: 'community',
     ps_apply_adjustment: 'community',
-    ps_document: 'dev',
+    ps_document: 'community',
     ps_create_document: 'community',
     ps_close_document: 'community',
     ps_open_document: 'community',
@@ -69,7 +69,7 @@ export const TOOL_TIERS = {
     ps_select_subject_instance: 'pro',
     ps_select_object: 'pro',
     ps_select_focus_area: 'dev',
-    ps_replace_sky: 'dev',
+    ps_replace_sky: 'community',
     ps_modify_selection: 'community',
     ps_get_selection_preview: 'community',
     ps_selection_channel: 'community',

package/dist/delivery/provision.js

@@ -2,6 +2,7 @@ import { DeliveryClient, DeliveryError } from './client.js';
 import { sha256Hex } from './crypto.js';
 import { verifyModuleSignature, verifyModuleSignatureV2, digestsRootSha256Hex, isModuleFileDigestArray, } from './signing.js';
 import { installModule, readInstalledModule } from './store.js';
+import { KERNEL_ABI } from '../kernel/host-api.js';
 import { Logger } from '../utils/logger.js';
 const logger = new Logger('Modules');
 const SKU_RE = /^[a-z0-9-]{2,32}$/;
@@ -52,6 +53,23 @@ export async function provisionModules(key, opts = {}) {
                 });
                 continue;
             }
+            const abi = entry.abi;
+            if (!Number.isInteger(abi) || abi < 1) {
+                result.errors.push({
+                    sku,
+                    code: 'abi_invalid',
+                    message: `the manifest entry for ${sku} declares an invalid abi '${String(abi)}' (expected a whole number of at least 1) — refusing to install it`,
+                });
+                continue;
+            }
+            if (abi > KERNEL_ABI) {
+                result.errors.push({
+                    sku,
+                    code: 'abi_too_new',
+                    message: `the published ${sku} module needs a newer Editmamei than this one (module abi ${abi}, this host runs up to abi ${KERNEL_ABI}) — update Editmamei; the installed module is left as it is`,
+                });
+                continue;
+            }
             const installed = readInstalledModule(sku, opts);
             if (installed && installed.version === latest && !opts.force) {
                 result.skipped.push({ sku, version: latest, reason: 'up-to-date' });
@@ -119,7 +137,7 @@ export async function provisionModules(key, opts = {}) {
             installModule({
                 sku,
                 version: latest,
-                abi: entry.abi,
+                abi,
                 sha256: digest,
                 alg: contentKey.alg,
                 content_key: contentKey.key,

package/dist/kernel/kernel.js

@@ -73,9 +73,10 @@ export class Kernel {
             throw new Error('downloaded module export is not an EditmameiModule (expected a default export with a manifest + register())');
         }
         if (this.abiTooNew(mod.manifest))
-            return;
+            return 'abi-too-new';
         const before = this.registry.count();
         await mod.register(this.hostApiFor(mod.manifest));
         this.logger.info(`Loaded downloaded module '${mod.manifest.id}' (${mod.manifest.name}) — ${this.registry.count() - before} tools.`);
+        return 'loaded';
     }
 }

package/dist/kernel/module-lifecycle.js

@@ -7,7 +7,7 @@ import { isProEntitled } from '../license/entitlement.js';
 import { loadVerifiedModule, readInstalledModule, installedPath, PRO_SKU, } from '../delivery/store.js';
 import { provisionModules, compareVersions, VERSION_RE, } from '../delivery/provision.js';
 import { readLicense } from '../license/store.js';
-import { HOST_MIN_ABI } from './host-api.js';
+import { HOST_MIN_ABI, KERNEL_ABI } from './host-api.js';
 import { VERSION } from '../version.js';
 export function classifyModuleOutcome(inputs) {
     if (inputs.proModuleLoaded && inputs.skipReason === null)
@@ -79,9 +79,21 @@ export class ModuleLifecycle {
             this._moduleSkipReason = 'incompatible';
             return;
         }
+        if (this._proModule.abi !== null && this._proModule.abi > KERNEL_ABI) {
+            this.deps.logger.warn(`Pro module (abi ${this._proModule.abi}) needs a newer host than this build ` +
+                `(kernel abi ${KERNEL_ABI}) — booting Community; update Editmamei to load it.`);
+            this._moduleSkipReason = 'incompatible';
+            return;
+        }
         const snapshot = this.deps.toolRegistry.snapshot();
         try {
-            await this.kernel.loadDownloaded(this._proModule.importer);
+            const outcome = await this.kernel.loadDownloaded(this._proModule.importer);
+            if (outcome === 'abi-too-new') {
+                this.deps.logger.warn(`The installed Pro module needs a newer host than this build (kernel abi ` +
+                    `${KERNEL_ABI}) — booting Community; update Editmamei to load it.`);
+                this._moduleSkipReason = 'incompatible';
+                return;
+            }
             if (this._proModule.version !== null &&
                 VERSION_RE.test(this._proModule.version) &&
                 compareVersions(this._proModule.version, VERSION) > 0) {
@@ -159,11 +171,14 @@ export class ModuleLifecycle {
                 this.deps.logger.warn('Module delivery is not configured — staying Community.');
                 return;
             }
+            const abiTooNew = prov.errors.some((e) => e.code === 'abi_too_new');
             for (const e of prov.errors) {
+                if (e.code === 'abi_too_new')
+                    continue;
                 this.deps.logger.warn(`Could not re-provision the ${e.sku} module (staying Community): ${e.message}`);
             }
-            if (prov.errors.length === 0) {
-                if (reason === 'incompatible') {
+            if (prov.errors.length === 0 || abiTooNew) {
+                if (reason === 'incompatible' || abiTooNew) {
                     this.deps.logger.warn('The published Pro module does not yet support this host version — staying ' +
                         'Community. Update Editmamei when a compatible release ships; ' +
                         '`editmamei report` files a diagnostic.');
@@ -201,6 +216,11 @@ export class ModuleLifecycle {
                 this.deps.logger.info(`Pro module updated to v${m.version} — restart to load.`);
             }
             for (const e of prov.errors) {
+                if (e.code === 'abi_too_new') {
+                    this.deps.logger.info(`A newer Pro module is published but needs a newer Editmamei than this ` +
+                        `one — staying on the installed version, which works. Update Editmamei to get it.`);
+                    continue;
+                }
                 this.deps.logger.warn(`Pro-module freshness check could not provision the ${e.sku} module ` +
                     `(staying on the installed version): ${e.message}`);
             }

package/dist/modules/ce/index.js

@@ -30,7 +30,7 @@ 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 = [
+export const ceFactories = [
     createDocumentTools,
     createLayerTools,
     createGroupTools,

package/dist/perception/grounding-locate.js

@@ -254,17 +254,19 @@ export const PLACEMENT_SCHEMA = {
     type: 'object',
     description: 'ANCHOR-RELATIONAL placement (preferred over guessing pixels): name anchors + a relation and the ' +
         'spatial-grounding resolver computes the geometry, verified by an objective gate; the action runs ONLY if the ' +
-        'gate PASSES. For a HARD or ambiguous placement, first concur on ps_resolve_placement (review_crop: true) — a ' +
-        'read-only zoomed crop with a marker at the resolved spot — then pass the SAME anchors + relation here. See ' +
-        'ps_resolve_placement for the full anchors + relation vocabulary.',
+        'gate PASSES. For a HARD or ambiguous placement, first concur with the placement-resolver tool — when this ' +
+        'build has one, it appears in tools/list — by calling it with review_crop: true for a read-only zoomed crop ' +
+        'with a marker at the resolved spot, then pass the SAME anchors + relation here. The full anchors + relation ' +
+        'vocabulary is documented on that tool.',
     properties: {
         anchors: {
             type: 'array',
-            description: 'Named anchors, same vocabulary as ps_resolve_placement (face/object/grid/extremum/corner/edge/landmark).',
+            description: 'Named anchors, same vocabulary as the placement-resolver tool, when this build has one ' +
+                '(face/object/grid/extremum/corner/edge/landmark).',
         },
         relation: {
             type: 'object',
-            description: 'The relation, same vocabulary as ps_resolve_placement.',
+            description: 'The relation, same vocabulary as the placement-resolver tool, when this build has one.',
         },
         max_dimension: {
             type: 'number',

package/dist/tools/document-tools.js

@@ -246,7 +246,6 @@ export function createDocumentTools(connection, snippetClient) {
                 },
                 annotations: {
                     title: 'List / Activate Documents',
-                    readOnlyHint: true,
                     idempotentHint: true,
                 },
             },

package/dist/tools/image-tools.js

@@ -29,7 +29,8 @@ const cropDocumentSchema = {
             ...PLACEMENT_SCHEMA,
             description: 'ANCHOR-RELATIONAL crop (preferred over guessing pixels): a REGION relation (inside/gap) → the crop is the ' +
                 'resolved region bounding box, verified by the gate. Crops ONLY if the gate PASSES. When set, ' +
-                'left/top/right/bottom are ignored. See ps_resolve_placement for the anchors + relation vocabulary.',
+                'left/top/right/bottom are ignored. See the placement-resolver tool, when this build has one, for the ' +
+                'anchors + relation vocabulary.',
         },
         left: {
             type: 'integer',

package/dist/tools/layer-transform-tools.js

@@ -82,7 +82,8 @@ const moveLayerSchema = {
             description: 'ANCHOR-RELATIONAL move (preferred over guessing a pixel): a POINT relation (centroid/midpoint/offset) → ' +
                 'the layer\'s CENTER is moved to the resolved, gate-verified point (e.g. "center this layer on the detected ' +
                 'subject" / "…in the gap between the two people"). Moves ONLY if the gate PASSES. When set, delta_*/' +
-                'absolute_*/center_on_* are ignored. See ps_resolve_placement for the anchors + relation vocabulary.',
+                'absolute_*/center_on_* are ignored. See the placement-resolver tool, when this build has one, for the ' +
+                'anchors + relation vocabulary.',
         },
     },
 };

package/dist/tools/path-tools.js

@@ -73,7 +73,7 @@ const pathInputSchema = {
         tool: {
             type: 'string',
             enum: SUPPORTED_BRUSH_TOOLS,
-            description: "stroke only: which brush-family tool paints the path. Default 'brush'. Same 16-tool set as ps_apply_brush_stroke.",
+            description: "stroke only: which brush-family tool paints the path (see this field's own enum for the full supported set). Default 'brush'.",
             default: 'brush',
         },
         color: {

package/dist/tools/selection-tools.js

@@ -466,7 +466,7 @@ const SELECT_INPUT_SCHEMA = {
         ...selectPolygonSchema.properties,
         placement: {
             ...PLACEMENT_SCHEMA,
-            description: 'Grounded coordinates (rectangle/ellipse/magic_wand): NAME anchors + a relation instead of guessing pixels. rectangle/ellipse ← a REGION relation (inside/gap) → the selection bounding box; magic_wand ← a POINT relation (centroid/extremum/grid) → the click. Verified by the objective gate; wins over the raw edges/x-y. See ps_resolve_placement for the vocabulary.',
+            description: 'Grounded coordinates (rectangle/ellipse/magic_wand): NAME anchors + a relation instead of guessing pixels. rectangle/ellipse ← a REGION relation (inside/gap) → the selection bounding box; magic_wand ← a POINT relation (centroid/extremum/grid) → the click. Verified by the objective gate; wins over the raw edges/x-y. See the placement-resolver tool, when this build has one, for the vocabulary.',
         },
     },
     required: ['mode'],

package/dist/tools/shape-tools.js

@@ -31,7 +31,7 @@ const shapeInputSchema = {
                 'edge or a Pro face-mesh landmark curve) → a straight line between the resolved curve endpoints. The shape ' +
                 'is created ONLY if the gate PASSES (otherwise an error and no layer). When set, left/top/right/bottom and ' +
                 'start_x/start_y/end_x/end_y are ignored, but styling (fill_color/stroke/weight/corner_radius) still ' +
-                'applies. See ps_resolve_placement for the anchors + relation vocabulary.',
+                'applies. See the placement-resolver tool, when this build has one, for the anchors + relation vocabulary.',
         },
         left: {
             type: 'number',

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '1.2.1';
+export const VERSION = '1.3.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "editmamei",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Photoshop MCP server: natural-language AI photo editing with your own Photoshop (Community Edition)",
   "mcpName": "io.github.editmamei/editmamei",
   "editmamei": {