Feat/edit options quick reply buttons

.gitignore

@@ -1,2 +1,4 @@
 node_modules
 .DS_Store
+.superpowers
+.env

data/express-templates.json

@@ -0,0 +1,3 @@
+[
+  { "id": "img_1", "name": "Croma Diwali offer", "docId": "urn:aaid:sc:AP:4b4b25bb-0949-588e-bd7b-76d0e9a113bd" }
+]

data/onam-design.json

@@ -0,0 +1,21 @@
+{
+  "_comment": "Template used by the create_design tool for brand-new (source: 'local') creatives. Swap the placeholder image URLs below with your hosted PNG URLs. See README / actions.js for how they map to edit state.",
+  "images": {
+    "base": "http://s7ap1.scene7.com/is/image/varunAEM/onam-base?cache=off",
+    "final": "http://s7ap1.scene7.com/is/image/varunAEM/onam-final?cache=off",
+    "malayalam": "http://s7ap1.scene7.com/is/image/varunAEM/onam-malyalam?cache=off"
+  },
+  "palette": [
+    { "name": "Marigold", "hex": "#F4A300" },
+    { "name": "Maroon", "hex": "#800020" },
+    { "name": "Deep Green", "hex": "#1B5E20" }
+  ],
+  "slots": {
+    "editable": [
+      { "name": "headline", "type": "text", "aliases": ["heading", "title", "header", "banner_text", "text"] },
+      { "name": "background", "type": "color", "aliases": ["background_color", "bg", "colour", "color", "background_colour"] },
+      { "name": "address", "type": "text", "aliases": ["store_address", "location", "store"] }
+    ],
+    "locked": ["logo", "product", "background_image"]
+  }
+}

docs/diagrams/flow-express-catalog-edit.mmd

@@ -0,0 +1,26 @@
+%% Flow A — Rajesh: edit an existing catalog design (image.source = "express")
+%% Backed by the real Adobe Express API, with interactive quick-reply buttons.
+%% Render: https://mermaid.live  or any Mermaid-capable viewer.
+flowchart TD
+  R1["User: 'what can I change?'"] --> CAE["tool: check_allowed_edits"]
+  CAE --> CAEa["actionCheckAllowedEdits<br/>image.source = express"]
+  CAEa --> EX1["expressApi.getTaggedDocument(docId)<br/>collectTaggedElements"]
+  EX1 --> BTN["buildEditOptions<br/>returns {edit_options, historyText}"]
+  BTN --> SEND1["sendEditOptions() → reply buttons<br/>id = 'edit:img_1:heading'"]
+
+  SEND1 -.->|"user taps a button"| TAP["webhook: messageTextForInteractiveReply()<br/>parse id → I'd like to change heading on image img_1"]
+  TAP --> ASK["tool: ask_for_more_information<br/>what would you like to change it to?"]
+  ASK -.->|"user replies with a value"| EG
+
+  R2["User: 'change the offer to 7500'"] --> EG["tool: edit_graphic"]
+  EG --> RT{"actionEditGraphic<br/>image.source?"}
+  RT -->|"express"| EXE["editExpressDesign"]
+  EXE --> V{"field is a tagged element?<br/>discount ≤ MAX_DISCOUNT?"}
+  V -->|"ok"| GEN["expressApi.generateVariation<br/>→ pollJobStatus → thumbnailUrl"]
+  GEN --> REC["recordEdits + sendImage(thumbnail)"]
+  V -->|"no"| REJ["reply: can't edit that field / discount capped"]
+
+  R3["User: 'change the product to a TV'"] --> STV["tool: select_tv_model"]
+  STV --> STVa["actionSelectTvModel → 3 model buttons<br/>id encodes full edits (buildValueEditId)"]
+  STVa -.->|"user taps e.g. LG UA82 AI"| TAP2["parse id → edits JSON → sentence → GPT"]
+  TAP2 --> EG

docs/diagrams/flow-local-create-design.mmd

@@ -0,0 +1,24 @@
+%% Flow B — Anjali: create + edit a brand-new design (image.source = "local")
+%% No Express calls — resolves to canned image URLs in data/onam-design.json.
+%% Render: https://mermaid.live  or any Mermaid-capable viewer.
+flowchart TD
+  A1["User: 'create a new design for Onam,<br/>LG washing machine + dishwasher, 20% off'"] --> CD["tool: create_design"]
+  CD --> CDa["actionCreateDesign<br/>loadOnamDesign + imageStore.createDesign<br/>(source = local, id = local_1)"]
+  CDa --> S1["sendImage(images.base)"]
+
+  A2["User: 'add my store address Princess Street Kochi'"] --> EG2["tool: edit_graphic"]
+  A3["User: 'translate the banner to Malayalam'"] --> EG3["tool: edit_graphic"]
+  EG2 --> RT{"actionEditGraphic<br/>image.source?"}
+  EG3 --> RT
+  RT -->|"local"| EL["editLocalDesign"]
+
+  EL --> M{"Malayalam request?<br/>(Malayalam script OR the word<br/>'Malayalam' in ANY key/value)"}
+  M -->|"yes"| MAL["short-circuit:<br/>appliedEdits = {language: 'Malayalam'}<br/>skip locked/palette guards"]
+  M -->|"no"| CANON["canonicalizeEdits (aliases)"]
+  CANON --> GUARD{"unknown key? → 'locked by HQ'<br/>background off-palette? → reject"}
+  GUARD -->|"ok"| RES["resolveLocalImage:<br/>address/background set → images.final<br/>else → images.base"]
+  MAL --> RESM["resolveLocalImage → images.malayalam"]
+  RES --> S2["recordEdits + sendImage(url)"]
+  RESM --> S2
+
+  RT -->|"express"| EXE["editExpressDesign<br/>(Adobe Express API — see other diagram)"]