@alisaitteke/photoshop-mcp 1.6.1 → 1.7.3

package/AGENTS.md

@@ -0,0 +1,117 @@
+# AGENTS.md — photoshop-mcp
+
+> **Navigation map, not a reference manual.**
+> Start with [llms.txt](llms.txt) or the site index [llms.txt](https://alisaitteke.github.io/photoshop-mcp/llms.txt), then follow links as needed.
+
+## Entry strategy
+
+| Scenario | Path |
+| -------- | ---- |
+| Cursor / Claude Desktop / VS Code | Configure `mcpServers` → `npx -y @alisaitteke/photoshop-mcp` (stdio) |
+| Claude Code | `claude mcp add photoshop -- npx -y @alisaitteke/photoshop-mcp` |
+| Standalone chat UI (no IDE) | `npx -p @alisaitteke/photoshop-mcp photoshop-mcp-ui` |
+| Local development | `npm install && npm run build && node dist/index.js` — see [docs/development.md](docs/development.md) |
+
+**Prerequisites:** Photoshop running on Windows or macOS, Node.js 18+. This is unofficial and not affiliated with Adobe.
+
+## Architecture (agent view)
+
+```
+AI host (Cursor / Claude / UI)
+  │  MCP stdio
+  ▼
+PhotoshopMCPServer (Node.js)
+  │  ExtendScript via AppleScript (macOS) or COM (Windows)
+  ▼
+Adobe Photoshop
+
+Optional: UXP bridge plugin (uxp-plugin/) on 127.0.0.1:38452 for Neural Filters only.
+```
+
+Deep dive: [docs/architecture.md](docs/architecture.md).
+
+## Recommended workflow
+
+Follow the server `instructions` advertised on MCP `initialize` ([src/prompts/instructions.ts](src/prompts/instructions.ts)):
+
+```
+1. DISCOVER: tools/list + prompts/list (or get_capabilities once per session)
+2. STATE:    photoshop_get_state before mutating; photoshop_get_preview after major steps
+3. ACT:      prefer photoshop_recipe_* for multi-step outcomes (single undo step)
+4. RECOVER:  on error, read structured envelope (code, suggested_next_tool) → get_state → retry one step
+```
+
+### Tool selection
+
+| Need | Use |
+| ---- | --- |
+| Multi-step outcome (remove BG, export for web, portrait enhance) | `photoshop_recipe_*` |
+| Single precise edit | atomic `photoshop_*` |
+| Vague user intent | MCP prompt `prompts/get` (e.g. `ps.remove_background`) then call linked recipe/tool |
+| Generative AI (Fill, Remove, Expand) | `photoshop_generative_*` — requires Adobe account + credits |
+| Neural Filters (skin smooth, colorize, …) | `photoshop_neural_filter` — requires UXP bridge loaded |
+| Version / feature check | `photoshop_get_capabilities` |
+
+Full catalog: [docs/available-tools.md](docs/available-tools.md). Prompt layer: [docs/prompt-layer.md](docs/prompt-layer.md).
+
+## MCP client configuration
+
+```json
+{
+  "mcpServers": {
+    "photoshop": {
+      "command": "npx",
+      "args": ["-y", "@alisaitteke/photoshop-mcp"],
+      "env": { "LOG_LEVEL": "1" }
+    }
+  }
+}
+```
+
+Examples: [examples/cursor-config.json](examples/cursor-config.json), [examples/claude-desktop-config.json](examples/claude-desktop-config.json).
+
+### Environment variables
+
+| Variable | Purpose |
+| -------- | ------- |
+| `LOG_LEVEL` | `0`=DEBUG, `1`=INFO, `2`=WARN, `3`=ERROR |
+| `PHOTOSHOP_PATH` | Optional custom Photoshop install path |
+| `PSMCP_UI_TOKEN` | Pin standalone UI API token (see README) |
+
+## Troubleshooting (common agent blockers)
+
+| Symptom | Fix |
+| ------- | --- |
+| Photoshop not found | Start Photoshop; set `PHOTOSHOP_PATH` if non-standard install |
+| Tool times out | Large operations may need retries; check `get_state` for partial progress |
+| `generative_unavailable` / `version_unsupported` | Call `get_capabilities`; feature may need newer Photoshop or Adobe login |
+| Neural filter fails | **Add Plugin** → `uxp-plugin/manifest.json` → **Load** in UXP Developer Tools — see [docs/development.md](docs/development.md#uxp-bridge-plugin-neural-filters) |
+| No active document | Ask user to open/create a document, then `get_state` |
+
+More: [docs/troubleshooting.md](docs/troubleshooting.md).
+
+## Distribution
+
+| Channel | Identifier |
+| ------- | ---------- |
+| npm | `@alisaitteke/photoshop-mcp` |
+| MCP Registry | `io.github.alisaitteke/photoshop-mcp` |
+| GitHub | https://github.com/alisaitteke/photoshop-mcp |
+
+## Key files
+
+| File | Purpose |
+| ---- | ------- |
+| [llms.txt](llms.txt) | LLM-oriented project summary |
+| [README.md](README.md) | Human docs, install, example prompts |
+| [server.json](server.json) | MCP Registry metadata |
+| [src/core/server.ts](src/core/server.ts) | MCP server entry |
+| [src/tools/](src/tools/) | Tool implementations |
+| [src/prompts/](src/prompts/) | MCP prompt templates |
+| [CONTRIBUTING.md](CONTRIBUTING.md) | PR and release workflow |
+
+## Contributing (agents editing this repo)
+
+- Canonical language for code, comments, commits, and PRs: **English**.
+- Before PR: `npm run lint`, `npm run build:server`, `npm run verify:photoshop-prompts`.
+- Do not add AI-attribution footers to commits or PR descriptions.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ali Sait Teke
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS 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.

package/README.de.md

@@ -6,7 +6,7 @@
   </a>
 </p>
 
-**Sprachen:** [English](README.md) · [简体中文](README.zh-CN.md) · [Español](README.es.md) · Deutsch · [日本語](README.ja.md) · [Türkçe](README.tr.md)
+**Sprachen:** [English](README.md) · [简体中文](README.zh-CN.md) · [Español](README.es.md) · Deutsch · [日本語](README.ja.md) · [Türkçe](README.tr.md) · **[Website](https://alisaitteke.github.io/photoshop-mcp/)**
 
 *v1.1+ — Rezept-Workflows, weniger Round-Trips, flinkere Sitzungen. Die eigenständige UI liefert **Action Plan (Beta)** für Plan-dann-Ausführen-Abläufe.*
 
@@ -640,12 +640,9 @@ Zur Claude Desktop-Konfiguration hinzufügen (`~/Library/Application Support/Cla
 - `LOG_LEVEL`: Protokollierungsstufe (0=DEBUG, 1=INFO, 2=WARN, 3=ERROR)
 - `ANALYTICS_DISABLED`: Auf `1` oder `true` setzen, um anonyme Nutzungsanalysen vollständig zu deaktivieren
 - `POSTHOG_DISABLED`: Veralteter Alias für `ANALYTICS_DISABLED`
-- `ANALYTICS_PROVIDER`: Analytics-Backend — `mixpanel` (Standard) oder `posthog` (rollback)
-- `MIXPANEL_TOKEN`: (Optional) Mixpanel-Projekt-Token überschreiben
-- `MIXPANEL_API_HOST`: (Optional) Mixpanel-Ingest-Host (Standard: `https://api-eu.mixpanel.com`)
-- `POSTHOG_KEY`: (Optional, veraltet) PostHog-Projekt-Schlüssel — nur verwendet, wenn `ANALYTICS_PROVIDER=posthog`
-- `POSTHOG_API_HOST`: (Optional, veraltet) PostHog-Ingest-Host (Standard: `https://a.alisait.com`)
-- `POSTHOG_UI_HOST`: (Optional, veraltet) PostHog-UI-Host (Standard: `https://eu.posthog.com`)
+- `POSTHOG_KEY`: (Optional) PostHog-Projekt-Schlüssel — Standard ist eingebettet; für Forks oder Staging überschreiben
+- `POSTHOG_API_HOST`: (Optional) PostHog-Ingest-Host (Standard: `https://a.alisait.com`)
+- `POSTHOG_UI_HOST`: (Optional) PostHog-UI-Host (Standard: `https://eu.posthog.com`)
 
 ## Verfügbare Werkzeuge
 

package/README.es.md

@@ -6,7 +6,7 @@
   </a>
 </p>
 
-**Idiomas:** [English](README.md) · [简体中文](README.zh-CN.md) · Español · [Deutsch](README.de.md) · [日本語](README.ja.md) · [Türkçe](README.tr.md)
+**Idiomas:** [English](README.md) · [简体中文](README.zh-CN.md) · Español · [Deutsch](README.de.md) · [日本語](README.ja.md) · [Türkçe](README.tr.md) · **[Sitio web](https://alisaitteke.github.io/photoshop-mcp/)**
 
 *v1.1+ — flujos de trabajo con recetas, menos intercambios, sesiones más ágiles. La UI independiente incluye **Action Plan (beta)** para ejecuciones de planificar-y-ejecutar.*
 
@@ -595,12 +595,9 @@ Añada a su configuración de Claude Desktop (`~/Library/Application Support/Cla
 - `LOG_LEVEL`: Nivel de registro (0=DEBUG, 1=INFO, 2=WARN, 3=ERROR)
 - `ANALYTICS_DISABLED`: Establezca en `1` o `true` para deshabilitar completamente el análisis de uso anónimo
 - `POSTHOG_DISABLED`: Alias heredado de `ANALYTICS_DISABLED`
-- `ANALYTICS_PROVIDER`: Backend de análisis — `mixpanel` (predeterminado) o `posthog` (rollback)
-- `MIXPANEL_TOKEN`: (Opcional) Anule el token del proyecto Mixpanel
-- `MIXPANEL_API_HOST`: (Opcional) Host de ingesta de Mixpanel (predeterminado: `https://api-eu.mixpanel.com`)
-- `POSTHOG_KEY`: (Opcional, heredado) Clave del proyecto PostHog — se usa solo cuando `ANALYTICS_PROVIDER=posthog`
-- `POSTHOG_API_HOST`: (Opcional, heredado) Host de ingesta de PostHog (predeterminado: `https://a.alisait.com`)
-- `POSTHOG_UI_HOST`: (Opcional, heredado) Host de UI de PostHog (predeterminado: `https://eu.posthog.com`)
+- `POSTHOG_KEY`: (Opcional) Clave del proyecto PostHog — hay una predeterminada integrada; anule para forks o staging
+- `POSTHOG_API_HOST`: (Opcional) Host de ingesta de PostHog (predeterminado: `https://a.alisait.com`)
+- `POSTHOG_UI_HOST`: (Opcional) Host de UI de PostHog (predeterminado: `https://eu.posthog.com`)
 
 ## Herramientas disponibles
 

package/README.ja.md

@@ -6,7 +6,7 @@
   </a>
 </p>
 
-**言語：** [English](README.md) · [简体中文](README.zh-CN.md) · [Español](README.es.md) · [Deutsch](README.de.md) · [日本語](README.ja.md) · [Türkçe](README.tr.md)
+**言語：** [English](README.md) · [简体中文](README.zh-CN.md) · [Español](README.es.md) · [Deutsch](README.de.md) · [日本語](README.ja.md) · [Türkçe](README.tr.md) · **[ウェブサイト](https://alisaitteke.github.io/photoshop-mcp/)**
 
 *v1.1+ — レシピワークフロー、ラウンドトリップ削減、軽快なセッション。スタンドアロンUIには計画→実行を担う **Action Plan（ベータ）** が付属しています。*
 
@@ -597,12 +597,9 @@ Claude Desktopの設定に追加してください（macOSは`~/Library/Applicat
 - `LOG_LEVEL`：ログレベル（0=DEBUG、1=INFO、2=WARN、3=ERROR）
 - `ANALYTICS_DISABLED`：`1`または`true`に設定して匿名使用状況の解析を完全に無効化
 - `POSTHOG_DISABLED`：`ANALYTICS_DISABLED`の旧エイリアス
-- `ANALYTICS_PROVIDER`：解析バックエンド — `mixpanel`（デフォルト）または`posthog`（ロールバック）
-- `MIXPANEL_TOKEN`：（オプション）Mixpanelプロジェクトトークンを上書き
-- `MIXPANEL_API_HOST`：（オプション）Mixpanelインジェストホスト（デフォルト：`https://api-eu.mixpanel.com`）
-- `POSTHOG_KEY`：（オプション、旧仕様）PostHogプロジェクトキー — `ANALYTICS_PROVIDER=posthog`の場合のみ使用
-- `POSTHOG_API_HOST`：（オプション、旧仕様）PostHogインジェストホスト（デフォルト：`https://a.alisait.com`）
-- `POSTHOG_UI_HOST`：（オプション、旧仕様）PostHog UIホスト（デフォルト：`https://eu.posthog.com`）
+- `POSTHOG_KEY`：（オプション）PostHogプロジェクトキー — デフォルトが組み込まれています。フォークやステージング用に上書き可能
+- `POSTHOG_API_HOST`：（オプション）PostHogインジェストホスト（デフォルト：`https://a.alisait.com`）
+- `POSTHOG_UI_HOST`：（オプション）PostHog UIホスト（デフォルト：`https://eu.posthog.com`）
 
 ## 利用可能なツール
 

package/README.md

@@ -6,7 +6,7 @@
   </a>
 </p>
 
-**Languages:** English · [简体中文](README.zh-CN.md) · [Español](README.es.md) · [Deutsch](README.de.md) · [日本語](README.ja.md) · [Türkçe](README.tr.md)
+**Languages:** English · [简体中文](README.zh-CN.md) · [Español](README.es.md) · [Deutsch](README.de.md) · [日本語](README.ja.md) · [Türkçe](README.tr.md) · **[Website](https://alisaitteke.github.io/photoshop-mcp/)**
 
 *v1.1+ — recipe workflows, fewer round-trips, snappier sessions. Standalone UI ships **Action Plan (beta)** for plan-then-execute runs.*
 
@@ -19,6 +19,8 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue.svg)](https://www.typescriptlang.org/)
 [![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS-lightgrey.svg)]()
 [![MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.github.alisaitteke%2Fphotoshop--mcp-purple.svg)](https://registry.modelcontextprotocol.io)
+[![MCP Toplist](https://mcptoplist.com/badge/io.github.alisaitteke%2Fphotoshop-mcp.svg)](https://mcptoplist.com/server/io.github.alisaitteke%2Fphotoshop-mcp)
+[![Website](https://img.shields.io/badge/website-photoshop--mcp-cyan.svg)](https://alisaitteke.github.io/photoshop-mcp/)
 
 A Model Context Protocol (MCP) server that enables AI assistants like Claude and Cursor to control Adobe Photoshop programmatically. This allows you to create designs, manipulate images, and automate Photoshop workflows through natural language commands while working in your IDE — or through the bundled **standalone web UI**, which supports both API keys and CLI subscription accounts (Claude Code / Gemini CLI). The UI also offers an opt-in **Action Plan (beta)** mode that plans every Photoshop step in one LLM call, then runs them in a single pass.
 
@@ -732,12 +734,9 @@ const q = query({
 - `LOG_LEVEL`: Logging level (0=DEBUG, 1=INFO, 2=WARN, 3=ERROR)
 - `ANALYTICS_DISABLED`: Set to `1` or `true` to disable anonymous usage analytics entirely
 - `POSTHOG_DISABLED`: Legacy alias for `ANALYTICS_DISABLED`
-- `ANALYTICS_PROVIDER`: Analytics backend — `mixpanel` (default) or `posthog` (rollback)
-- `MIXPANEL_TOKEN`: (Optional) Override the Mixpanel project token
-- `MIXPANEL_API_HOST`: (Optional) Mixpanel ingest host (default: `https://api-eu.mixpanel.com`)
-- `POSTHOG_KEY`: (Optional, legacy) PostHog project key — used only when `ANALYTICS_PROVIDER=posthog`
-- `POSTHOG_API_HOST`: (Optional, legacy) PostHog ingest host (default: `https://a.alisait.com`)
-- `POSTHOG_UI_HOST`: (Optional, legacy) PostHog UI host (default: `https://eu.posthog.com`)
+- `POSTHOG_KEY`: (Optional) PostHog project key — a default is embedded; override for forks or staging
+- `POSTHOG_API_HOST`: (Optional) PostHog ingest host (default: `https://a.alisait.com`)
+- `POSTHOG_UI_HOST`: (Optional) PostHog UI host (default: `https://eu.posthog.com`)
 
 ## Available Tools
 

package/README.tr.md

@@ -6,7 +6,7 @@
   </a>
 </p>
 
-**Diller:** [English](README.md) · [简体中文](README.zh-CN.md) · [Español](README.es.md) · [Deutsch](README.de.md) · [日本語](README.ja.md) · Türkçe
+**Diller:** [English](README.md) · [简体中文](README.zh-CN.md) · [Español](README.es.md) · [Deutsch](README.de.md) · [日本語](README.ja.md) · Türkçe · **[Website](https://alisaitteke.github.io/photoshop-mcp/)**
 
 *v1.1+ — tarif iş akışları, daha az gidiş-dönüş, daha hızlı oturumlar. Bağımsız UI, plan-sonra-uygula çalıştırmaları için **Action Plan (beta)** sunar.*
 
@@ -683,13 +683,9 @@ const q = query({
 - `ANALYTICS_DISABLED`: Anonim kullanım analizlerini tamamen devre dışı bırakmak için `1` veya `true`
   olarak ayarlayın
 - `POSTHOG_DISABLED`: `ANALYTICS_DISABLED` için eski takma ad
-- `ANALYTICS_PROVIDER`: Analiz arka ucu — `mixpanel` (varsayılan) veya `posthog` (geri alma)
-- `MIXPANEL_TOKEN`: (İsteğe bağlı) Mixpanel proje tokenını geçersiz kılın
-- `MIXPANEL_API_HOST`: (İsteğe bağlı) Mixpanel ingest host'u (varsayılan: `https://api-eu.mixpanel.com`)
-- `POSTHOG_KEY`: (İsteğe bağlı, eski) PostHog proje anahtarı — yalnızca `ANALYTICS_PROVIDER=posthog`
-  olduğunda kullanılır
-- `POSTHOG_API_HOST`: (İsteğe bağlı, eski) PostHog ingest host'u (varsayılan: `https://a.alisait.com`)
-- `POSTHOG_UI_HOST`: (İsteğe bağlı, eski) PostHog UI host'u (varsayılan: `https://eu.posthog.com`)
+- `POSTHOG_KEY`: (İsteğe bağlı) PostHog proje anahtarı — varsayılan gömülüdür; fork veya staging için geçersiz kılın
+- `POSTHOG_API_HOST`: (İsteğe bağlı) PostHog ingest host'u (varsayılan: `https://a.alisait.com`)
+- `POSTHOG_UI_HOST`: (İsteğe bağlı) PostHog UI host'u (varsayılan: `https://eu.posthog.com`)
 
 ## Mevcut Araçlar
 

package/README.zh-CN.md

@@ -6,7 +6,7 @@
   </a>
 </p>
 
-**语言：** [English](README.md) · 简体中文 · [Español](README.es.md) · [Deutsch](README.de.md) · [日本語](README.ja.md) · [Türkçe](README.tr.md)
+**语言：** [English](README.md) · 简体中文 · [Español](README.es.md) · [Deutsch](README.de.md) · [日本語](README.ja.md) · [Türkçe](README.tr.md) · **[网站](https://alisaitteke.github.io/photoshop-mcp/)**
 
 *v1.1+ — 配方工作流、更少的往返调用、更流畅的会话。独立 UI 附带 **Action Plan（测试版）**，支持先规划后执行的运行模式。*
 
@@ -592,12 +592,9 @@ npx @alisaitteke/photoshop-mcp
 - `LOG_LEVEL`：日志级别（0=DEBUG，1=INFO，2=WARN，3=ERROR）
 - `ANALYTICS_DISABLED`：设置为 `1` 或 `true` 可完全禁用匿名使用分析
 - `POSTHOG_DISABLED`：`ANALYTICS_DISABLED` 的旧版别名
-- `ANALYTICS_PROVIDER`：分析后端 — `mixpanel`（默认）或 `posthog`（回滚）
-- `MIXPANEL_TOKEN`：（可选）覆盖 Mixpanel 项目令牌
-- `MIXPANEL_API_HOST`：（可选）Mixpanel 数据采集主机（默认：`https://api-eu.mixpanel.com`）
-- `POSTHOG_KEY`：（可选，旧版）PostHog 项目密钥 — 仅在 `ANALYTICS_PROVIDER=posthog` 时使用
-- `POSTHOG_API_HOST`：（可选，旧版）PostHog 数据采集主机（默认：`https://a.alisait.com`）
-- `POSTHOG_UI_HOST`：（可选，旧版）PostHog UI 主机（默认：`https://eu.posthog.com`）
+- `POSTHOG_KEY`：（可选）PostHog 项目密钥 — 已内置默认值；可用于 fork 或预发布环境覆盖
+- `POSTHOG_API_HOST`：（可选）PostHog 数据采集主机（默认：`https://a.alisait.com`）
+- `POSTHOG_UI_HOST`：（可选）PostHog UI 主机（默认：`https://eu.posthog.com`）
 
 ## 可用工具
 

package/dist/analytics/config.d.ts

@@ -1,10 +1,5 @@
-export type AnalyticsProviderName = 'mixpanel' | 'posthog';
 export declare function isPostHogDisabledByEnv(): boolean;
 export declare function isAnalyticsDisabledByEnv(): boolean;
-export declare function resolveAnalyticsProvider(): AnalyticsProviderName;
-export declare function resolveMixpanelToken(): string;
-export declare function resolveMixpanelApiHost(): string;
-export declare function resolveMixpanelNodeHost(): string;
 export declare function resolvePostHogKey(): string;
 export declare function resolvePostHogApiHost(): string;
 export declare function resolvePostHogUiHost(): string;

package/dist/analytics/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/analytics/config.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,SAAS,CAAC;AAO3D,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED,wBAAgB,wBAAwB,IAAI,qBAAqB,CAIhE;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,wBAAgB,eAAe,IAAI,OAAO,CAKzC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/analytics/config.ts"],"names":[],"mappings":"AASA,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,wBAAgB,eAAe,IAAI,OAAO,CAEzC"}

package/dist/analytics/config.js

@@ -1,9 +1,6 @@
 const DEFAULT_POSTHOG_KEY = 'phc_mejq4ZZ8jTNZPiusjh7vHyPzWYinzsDwVJW43SM5FEcg';
 const DEFAULT_API_HOST = 'https://a.alisait.com';
 const DEFAULT_UI_HOST = 'https://eu.posthog.com';
-const DEFAULT_MIXPANEL_TOKEN = 'b7df8a8fde7156da7b9c99ecbb7e9862';
-const DEFAULT_MIXPANEL_API_HOST = 'https://api-eu.mixpanel.com';
-const DEFAULT_MIXPANEL_NODE_HOST = 'api-eu.mixpanel.com';
 function envTruthy(name) {
     const value = process.env[name]?.trim().toLowerCase();
     return value === '1' || value === 'true' || value === 'yes';
@@ -14,21 +11,6 @@ export function isPostHogDisabledByEnv() {
 export function isAnalyticsDisabledByEnv() {
     return envTruthy('ANALYTICS_DISABLED') || isPostHogDisabledByEnv();
 }
-export function resolveAnalyticsProvider() {
-    const value = process.env.ANALYTICS_PROVIDER?.trim().toLowerCase();
-    if (value === 'posthog')
-        return 'posthog';
-    return 'mixpanel';
-}
-export function resolveMixpanelToken() {
-    return process.env.MIXPANEL_TOKEN?.trim() || DEFAULT_MIXPANEL_TOKEN;
-}
-export function resolveMixpanelApiHost() {
-    return process.env.MIXPANEL_API_HOST?.trim() || DEFAULT_MIXPANEL_API_HOST;
-}
-export function resolveMixpanelNodeHost() {
-    return process.env.MIXPANEL_NODE_HOST?.trim() || DEFAULT_MIXPANEL_NODE_HOST;
-}
 export function resolvePostHogKey() {
     return process.env.POSTHOG_KEY?.trim() || DEFAULT_POSTHOG_KEY;
 }
@@ -42,9 +24,6 @@ export function hasPostHogKey() {
     return resolvePostHogKey().length > 0;
 }
 export function hasAnalyticsKey() {
-    if (resolveAnalyticsProvider() === 'posthog') {
-        return hasPostHogKey();
-    }
-    return resolveMixpanelToken().length > 0;
+    return hasPostHogKey();
 }
 //# sourceMappingURL=config.js.map

package/dist/analytics/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/analytics/config.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAAG,kDAAkD,CAAC;AAC/E,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AACjD,MAAM,eAAe,GAAG,wBAAwB,CAAC;AAEjD,MAAM,sBAAsB,GAAG,kCAAkC,CAAC;AAClE,MAAM,yBAAyB,GAAG,6BAA6B,CAAC;AAChE,MAAM,0BAA0B,GAAG,qBAAqB,CAAC;AAIzD,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACtD,OAAO,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,KAAK,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,SAAS,CAAC,kBAAkB,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,SAAS,CAAC,oBAAoB,CAAC,IAAI,sBAAsB,EAAE,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,sBAAsB,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,IAAI,yBAAyB,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,IAAI,EAAE,IAAI,0BAA0B,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,mBAAmB,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,gBAAgB,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,IAAI,eAAe,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,iBAAiB,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,wBAAwB,EAAE,KAAK,SAAS,EAAE,CAAC;QAC7C,OAAO,aAAa,EAAE,CAAC;IACzB,CAAC;IACD,OAAO,oBAAoB,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/analytics/config.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAAG,kDAAkD,CAAC;AAC/E,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AACjD,MAAM,eAAe,GAAG,wBAAwB,CAAC;AAEjD,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACtD,OAAO,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,KAAK,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,SAAS,CAAC,kBAAkB,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,SAAS,CAAC,oBAAoB,CAAC,IAAI,sBAAsB,EAAE,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,mBAAmB,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,gBAAgB,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,IAAI,eAAe,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,iBAAiB,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,aAAa,EAAE,CAAC;AACzB,CAAC"}

package/dist/analytics/ga4-node.d.ts

@@ -0,0 +1,20 @@
+import type { AnalyticsEvent, AnalyticsProvider } from './types.js';
+export declare class Ga4NodeProvider implements AnalyticsProvider {
+    private logger;
+    private clientId;
+    private measurementId;
+    private apiSecret;
+    private enabled;
+    private userProperties;
+    private pending;
+    constructor();
+    private trackPending;
+    private identifyPerson;
+    identify(properties?: Record<string, unknown>): void;
+    setPersonOnce(properties: Record<string, unknown>): void;
+    capture(event: AnalyticsEvent): void;
+    private send;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=ga4-node.d.ts.map

package/dist/analytics/ga4-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ga4-node.d.ts","sourceRoot":"","sources":["../../src/analytics/ga4-node.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAepE,qBAAa,eAAgB,YAAW,iBAAiB;IACvD,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,cAAc,CAAyC;IAC/D,OAAO,CAAC,OAAO,CAA4B;;IAmB3C,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,cAAc;IAItB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IASpD,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAsBxD,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAuBpC,OAAO,CAAC,IAAI;IAiBN,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC"}

package/dist/analytics/ga4-node.js

@@ -0,0 +1,117 @@
+/**
+ * GA4 Measurement Protocol analytics provider (Node/server + MCP surfaces).
+ * Reference: https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference
+ *
+ * GA4 MP has no standalone identify or set_once call: user properties ride
+ * along with events. We accumulate them locally and attach them to each event.
+ */
+import { randomUUID } from 'node:crypto';
+import { Logger } from '../utils/logger.js';
+import { hasGa4ApiSecret, resolveGa4ApiSecret, resolveGa4MeasurementId } from './config.js';
+import { buildPersonIdentifyProperties, sanitizePersonOnceProperties } from './events.js';
+import { getOrCreateDistinctId, hasPersonOnceProperty, markPersonOnceProperty, } from './identity.js';
+import { mapGa4EventName, sanitizeGa4EventParams, sanitizeGa4UserProperties, } from './ga4-shared.js';
+const GA4_COLLECT_ENDPOINT = 'https://www.google-analytics.com/mp/collect';
+export class Ga4NodeProvider {
+    logger = new Logger('Analytics');
+    clientId;
+    measurementId;
+    apiSecret;
+    enabled;
+    userProperties = {};
+    pending = new Set();
+    constructor() {
+        this.clientId = getOrCreateDistinctId();
+        this.measurementId = resolveGa4MeasurementId();
+        this.apiSecret = resolveGa4ApiSecret();
+        this.enabled = hasGa4ApiSecret();
+        if (!this.enabled) {
+            // Provider still constructs (browser can send with the measurement ID
+            // alone), but the server surface cannot send without an API secret.
+            this.logger.debug('GA4_API_SECRET missing; GA4 node analytics disabled (no-op)');
+            return;
+        }
+        this.identifyPerson();
+        this.setPersonOnce({ first_install_at: new Date().toISOString() });
+    }
+    trackPending(promise) {
+        this.pending.add(promise);
+        void promise.finally(() => {
+            this.pending.delete(promise);
+        });
+    }
+    identifyPerson() {
+        this.identify({ event_source: 'server' });
+    }
+    identify(properties) {
+        if (!this.enabled) {
+            this.logger.debug('GA4 identify skipped (no API secret)');
+            return;
+        }
+        const props = buildPersonIdentifyProperties(properties);
+        Object.assign(this.userProperties, sanitizeGa4UserProperties(props));
+    }
+    setPersonOnce(properties) {
+        if (!this.enabled) {
+            this.logger.debug('GA4 setPersonOnce skipped (no API secret)');
+            return;
+        }
+        const props = sanitizePersonOnceProperties(properties);
+        // Emulate set_once: only apply keys that have not been persisted before.
+        const fresh = {};
+        for (const [key, value] of Object.entries(props)) {
+            if (hasPersonOnceProperty(key))
+                continue;
+            fresh[key] = value;
+        }
+        if (Object.keys(fresh).length === 0)
+            return;
+        const userProps = sanitizeGa4UserProperties(fresh);
+        Object.assign(this.userProperties, userProps);
+        for (const key of Object.keys(userProps)) {
+            markPersonOnceProperty(key);
+        }
+    }
+    capture(event) {
+        if (!this.enabled) {
+            this.logger.debug('GA4 capture skipped (no API secret)');
+            return;
+        }
+        const params = sanitizeGa4EventParams(event.properties);
+        // Required so MP events surface in Realtime reports.
+        params.engagement_time_msec = 1;
+        // Dedup key: GA4 event_id.
+        params.event_id = event.insertId ?? randomUUID();
+        const payload = {
+            client_id: this.clientId,
+            events: [{ name: mapGa4EventName(event.name), params }],
+        };
+        if (Object.keys(this.userProperties).length > 0) {
+            payload.user_properties = { ...this.userProperties };
+        }
+        this.send(payload);
+    }
+    send(payload) {
+        const url = `${GA4_COLLECT_ENDPOINT}?measurement_id=${encodeURIComponent(this.measurementId)}` +
+            `&api_secret=${encodeURIComponent(this.apiSecret)}`;
+        const promise = fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(payload),
+        })
+            .then(() => undefined)
+            .catch((err) => {
+            this.logger.debug('Failed to send GA4 analytics event', err);
+        });
+        this.trackPending(promise);
+    }
+    async flush() {
+        if (this.pending.size === 0)
+            return;
+        await Promise.allSettled([...this.pending]);
+    }
+    async shutdown() {
+        await this.flush();
+    }
+}
+//# sourceMappingURL=ga4-node.js.map

package/dist/analytics/ga4-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ga4-node.js","sourceRoot":"","sources":["../../src/analytics/ga4-node.ts"],"names":[],"mappings":"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"}

package/dist/analytics/ga4-shared.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shared GA4 Measurement Protocol sanitization.
+ * Reused by the Node provider (Phase 2) and the browser provider (Phase 3).
+ * Reference: https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference
+ */
+import type { AnalyticsPropertyValue } from './types.js';
+/** Map internal event names onto GA4 event names (lowercased, `$` stripped). */
+export declare function mapGa4EventName(name: string): string;
+/** Enforce GA4 event-param limits, map page fields, and stringify arrays. */
+export declare function sanitizeGa4EventParams(params: Record<string, AnalyticsPropertyValue> | undefined): Record<string, string | number>;
+/** Format person properties as GA4 user_properties, enforcing name/value limits. */
+export declare function sanitizeGa4UserProperties(props: Record<string, unknown> | undefined): Record<string, {
+    value: string;
+}>;
+//# sourceMappingURL=ga4-shared.d.ts.map

package/dist/analytics/ga4-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ga4-shared.d.ts","sourceRoot":"","sources":["../../src/analytics/ga4-shared.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAwCzD,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMpD;AAkBD,6EAA6E;AAC7E,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,GAAG,SAAS,GACzD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAoBjC;AAED,oFAAoF;AACpF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACzC,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAyBnC"}