editmamei 1.6.0 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -15,6 +15,12 @@ It serves photographers and retouchers who want to edit by conversation just as
15
15
 
16
16
  **[editmamei.com](https://editmamei.com)** · [Docs](docs/getting-started.md) · [Report a bug](https://github.com/editmamei/editmamei/issues)
17
17
 
18
+ <p align="center">
19
+ <a href="https://editmamei.com"><img src="https://raw.githubusercontent.com/editmamei/editmamei/dev/docs/media/batch-flip.webp" width="540" alt="Seventy-three travel photos graded in Photoshop from one sentence: the prompt, the grading calls three photos at a time, and the finished set."></a>
20
+ <br>
21
+ <sub>A real run: 73 travel photos, one sentence, graded in Photoshop.</sub>
22
+ </p>
23
+
18
24
  ## How it works
19
25
 
20
26
  Editmamei is a pure MCP **stdio** server written in Node. Your AI client launches it as a subprocess and calls its tools over stdio. Each tool builds a small Photoshop script and runs it in your local Photoshop over the platform's native automation channel:
@@ -75,7 +81,7 @@ These are the choices that shape the surface, and the reason an AI assistant can
75
81
 
76
82
  ## Tool surface
77
83
 
78
- **103 tools total.** The Photoshop surface is **87 tools across 16 capability groups** (62 Community, 25 Pro), every one namespaced `ps_*` and discoverable at runtime via `tools/list`. Community tools ship in both editions; Pro tools unlock with a license. Alongside it, a second, independent editor surface drives headless GIMP: **16 `gimp_*` tools, Community, currently in beta**, see [GIMP (beta)](#gimp-beta) below. Pro's additions are Photoshop-only; GIMP has no Pro tier.
84
+ **111 tools total.** The Photoshop surface is **87 tools across 16 capability groups** (62 Community, 25 Pro), every one namespaced `ps_*` and discoverable at runtime via `tools/list`. Community tools ship in both editions; Pro tools unlock with a license. Alongside it, a second, independent editor surface drives headless GIMP: **24 `gimp_*` tools, Community, currently in beta**, see [GIMP (beta)](#gimp-beta) below. Pro's additions are Photoshop-only; GIMP has no Pro tier.
79
85
 
80
86
  | Group | Edition | Tools |
81
87
  | --- | --- | --- |
@@ -105,7 +111,7 @@ These are the choices that shape the surface, and the reason an AI assistant can
105
111
 
106
112
  | Group | Edition | Tools |
107
113
  | --- | --- | --- |
108
- | **GIMP** | Community (beta) | `gimp_ping` · `gimp_overview` · `gimp_open_document` · `gimp_close_document` · `gimp_save_xcf` · `gimp_export` · `gimp_inspect` · `gimp_add_adjustment` · `gimp_filter` · `gimp_crop_document` · `gimp_resize_image` · `gimp_transform_canvas` · `gimp_create_mask` · `gimp_get_preview` · `gimp_get_histogram` · `gimp_compare` |
114
+ | **GIMP** | Community (beta) | `gimp_ping` · `gimp_overview` · `gimp_open_document` · `gimp_close_document` · `gimp_save_xcf` · `gimp_export` · `gimp_inspect` · `gimp_add_adjustment` · `gimp_add_effect` · `gimp_filter` · `gimp_bake` · `gimp_layer` · `gimp_create_document` · `gimp_place_image` · `gimp_canvas` · `gimp_convert_image_mode` · `gimp_crop_document` · `gimp_resize_image` · `gimp_transform_canvas` · `gimp_create_mask` · `gimp_checkpoint` · `gimp_get_preview` · `gimp_get_histogram` · `gimp_compare` |
109
115
 
110
116
  ## Editions
111
117
 
@@ -122,7 +128,7 @@ This repository holds the Community source. Pro is a separately licensed module
122
128
 
123
129
  Editmamei can also drive GIMP, headless, as a second editor alongside (or instead of) Photoshop. When GIMP 3.2+ is detected on your machine, a `gimp_*` tool set registers next to the `ps_*` one; use it when you ask for GIMP, or when Photoshop isn't available. There's no visible window: edits happen in a background `gimp-console` process, and you follow along through rendered previews in the conversation instead of watching a window change.
124
130
 
125
- The beta covers documents (open, save `.xcf`, export), 13 non-destructive adjustment types, geometric masks, crop/resize/rotate/flip, and the same preview/histogram/compare verification primitives the Photoshop side has. It doesn't yet cover heal/clone, AI subject or sky selection, text, or undo for geometry changes. Full details, requirements, and troubleshooting: [docs/gimp.md](docs/gimp.md).
131
+ The beta covers documents (open, create, save `.xcf`, export), layers and groups, placing one photo into another, 13 non-destructive adjustment types and six effects (vignette, black and white, motion and lens blur, noise, drop shadow), geometric masks, crop/resize/rotate/flip, canvas extension, colour/grayscale conversion, checkpoints you can restore, and the same preview/histogram/compare verification primitives the Photoshop side has. It doesn't yet cover heal/clone, AI subject or sky selection, or text. Full details, requirements, and troubleshooting: [docs/gimp.md](docs/gimp.md).
126
132
 
127
133
  ## Build from source
128
134
 
@@ -37,6 +37,9 @@ export class GimpBackend {
37
37
  get startOrigin() {
38
38
  return this.session?.lastStartOrigin;
39
39
  }
40
+ get generation() {
41
+ return this.session?.generation;
42
+ }
40
43
  ensureSession() {
41
44
  if (this.closed) {
42
45
  throw new GimpError('gimp_session_restarted', 'session closed');