@elitedcs/ghl-mcp 3.1.1 → 3.2.0

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## 3.2.0 — Deep trigger typing
+
+**173 tools across 36 modules. Bundle: 248.4 KB.**
+
+v3.1.0 made all 57 native trigger types READ cleanly via a permissive fallback. v3.2.0 deeply types 9 more of the most common ones — `form_submission`, `opportunity_created`, `opportunity_changed`, `opportunity_status_changed`, `payment_received`, `inbound_webhook`, `mailgun_email_event`, `note_add`, `task_added` — bringing typed coverage from **4 / 57 (7%) to 13 / 57 (23%)**.
+
+For Claude that means: when you ask it to read, build, or edit a workflow using one of these triggers, it now knows the discriminated trigger type AND the field paths each one supports (e.g., `opportunity.pipelineId`, `opportunity.monetaryValue`, `form.id`, `mailgun.event`, etc.). Less guessing, fewer rejected payloads.
+
+### Shared trigger-schema module
+- `src/trigger-schemas.ts` (NEW): single source of truth for `WorkflowTriggerSchema`. Both the read path (`workflow-builder-client.ts`) and the write path (`tools/workflow-builder.ts`) now import from this module instead of duplicating definitions.
+- Bundle shrank from 249.7 KB → 248.4 KB thanks to the dedup.
+
+### Field paths documented per trigger
+- Each typed trigger's `field` is `z.string()` with a `.describe()` listing the known field paths (extracted from `templates/trigger-schemas.json`, captured 2026-05-14). Permissive enough that new GHL fields don't crash reads, structured enough that the LLM knows what fields exist.
+
+### Coverage delta
+| State | Typed | Reachable-but-untyped | Total |
+|---|---:|---:|---:|
+| Before v3.1.0 | 4 | 0 (reads crashed) | 57 |
+| v3.1.0 | 4 | 53 | 57 |
+| v3.2.0 | **13** | **44** | 57 |
+
+### Round-trip verified
+- Real `form_submission` workflow from QA Test Clinic v3 parses cleanly through the new typed variant.
+- 8 synthetic typed-trigger samples match their respective variants and are correctly rejected by sibling variants (discrimination works as expected).
+
+### Files changed
+- `src/trigger-schemas.ts` — NEW: 13 typed trigger variants + `UnknownTriggerSchema` fallback in a single module.
+- `src/workflow-builder-client.ts` — removed inline trigger schemas, imports from shared module.
+- `src/tools/workflow-builder.ts` — removed inline trigger schemas, imports from shared module.
+
 ## 3.1.1 — Auto-update visibility
 
 **173 tools across 36 modules. Bundle: 249.7 KB.**

package/README.md

@@ -350,7 +350,7 @@ Re-run setup_ghl_mcp with workflow builder:
 
 **Supported action types:** `sms`, `email`, `add_contact_tag`, `remove_contact_tag`, `update_contact_field`, `wait`, `if_else`, `webhook`, `create_opportunity`, `custom_code`, `add_notes`, `internal_notification`, `task-notification`, `remove_from_workflow`, and more.
 
-**Supported trigger types:** All 57 native GHL trigger types read cleanly (form_submission, payment_received, opportunity_created/changed/status_changed, inbound_webhook, contact_tag, appointment, customer_reply, and 50 more). 4 are deeply typed; the rest pass through a permissive schema so workflows never fail to read regardless of trigger type. Plus 434 marketplace trigger entries across 85 third-party apps — query them via `get_trigger_registry`.
+**Supported trigger types:** All 57 native GHL trigger types read cleanly. **13 are deeply typed** with documented field paths (contact_tag, customer_reply, appointment, pipeline_stage_updated, form_submission, opportunity_created, opportunity_changed, opportunity_status_changed, payment_received, inbound_webhook, mailgun_email_event, note_add, task_added). The other 44 pass through a permissive schema so workflows never fail to read regardless of trigger type. Plus 434 marketplace trigger entries across 85 third-party apps — query them via `get_trigger_registry`.
 
 ### Pipeline Builder (5 tools) — Internal API