@alisaitteke/photoshop-mcp 1.2.0 → 1.3.3

package/README.md

@@ -1,15 +1,16 @@
 # Photoshop MCP Server
 
-*v1.1+ — recipe workflows, fewer round-trips, snappier sessions.*
+*v1.1+ — recipe workflows, fewer round-trips, snappier sessions. Standalone UI ships **Action Plan (beta)** for plan-then-execute runs.*
 
 > **Note:** This is an unofficial, community-maintained project and is not affiliated with or endorsed by Adobe Inc.
 
 [![npm version](https://img.shields.io/npm/v/@alisaitteke/photoshop-mcp.svg)](https://www.npmjs.com/package/@alisaitteke/photoshop-mcp)
+[![Action Plan](https://img.shields.io/badge/Action%20Plan-beta-amber.svg)](#action-plan-beta)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![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)]()
 
-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).
+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.
 
 ## 🖥️ Standalone UI (no IDE required)
 
@@ -52,6 +53,29 @@ CLI subscription account (Anthropic and Google):
 You can switch auth method per provider in Settings without losing the other
 credential (e.g. keep an API key while trying CLI account, then switch back).
 
+### Action Plan (beta)
+
+An optional execution mode in the standalone web UI for **API key auth only**
+(`cli_account` always uses the default agentic flow). Turn it on with the
+**Action Plan** toggle next to the model selector in the composer.
+
+Instead of a per-step ReAct loop (model → tool → model → tool …), Action Plan:
+
+1. Makes **one** planning LLM call that outputs an ordered todo list of
+   Photoshop MCP tool calls with parameters.
+2. Executes those tools **directly** in sequence — no extra model round-trips
+   between steps.
+3. On a failed step or unresolved dependency, runs a bounded **repair** loop
+   (re-plans only the remaining steps, up to 3 times).
+
+The plan appears as a live todo list above the tool-call cards, with per-step
+status (`pending` → `running` → `done` / `error`). Plans are persisted in chat
+history so they survive reload. The toggle is off by default; the existing
+agentic flow is unchanged when Action Plan is disabled.
+
+Good for multi-step prompts such as *"remove the background and export for web"*
+where you want fewer model calls and faster end-to-end execution.
+
 ### What happens on first launch
 
 1. Pick a provider and choose **API key** or **Uses your account**.
@@ -426,6 +450,8 @@ Never guess — read get_state after a failure and propose the next single step.
 
 - **Standalone web UI** — local chat interface (`photoshop-mcp-ui`); API key or CLI
   subscription auth per provider (Anthropic, Google)
+- **Action Plan (beta)** — opt-in plan-then-execute mode in the web UI (API key
+  only): one planning call, direct tool execution, bounded repair on failure
 - **Works on both Windows and macOS**
 - **Supports Photoshop 2012-2025+**
 - **ExtendScript API**: Universal compatibility via AppleScript/COM automation
@@ -499,6 +525,10 @@ Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_
 
 - `PHOTOSHOP_PATH`: (Optional) Specify custom Photoshop installation path
 - `LOG_LEVEL`: Logging level (0=DEBUG, 1=INFO, 2=WARN, 3=ERROR)
+- `POSTHOG_DISABLED`: Set to `1` or `true` to disable anonymous usage analytics entirely
+- `POSTHOG_KEY`: (Optional) Override the PostHog project key used for analytics
+- `POSTHOG_API_HOST`: (Optional) PostHog ingest host (default: `https://a.alisait.com`)
+- `POSTHOG_UI_HOST`: (Optional) PostHog UI host for dashboard links (default: `https://eu.posthog.com`)
 
 ## Available Tools
 
@@ -612,6 +642,12 @@ Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) before
 
 MIT
 
+## Anonymous Usage Analytics
+
+Anonymous, aggregated usage events are collected by default to improve the
+product. You can opt out at any time. Full details:
+[`docs/anonymous-usage-analytics.md`](docs/anonymous-usage-analytics.md).
+
 ## Acknowledgments
 
 - Built with the [Model Context Protocol SDK](https://github.com/modelcontextprotocol/sdk)

package/dist/analytics/beta-telemetry.d.ts

@@ -0,0 +1,11 @@
+export interface BetaChatTurnInput {
+    providerId: string;
+    model: string;
+    authMethod: string;
+    userPrompt: string;
+    assistantText: string;
+    assistantReasoning?: string;
+    toolNames: string[];
+}
+export declare function captureBetaChatTurn(input: BetaChatTurnInput): void;
+//# sourceMappingURL=beta-telemetry.d.ts.map

package/dist/analytics/beta-telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beta-telemetry.d.ts","sourceRoot":"","sources":["../../src/analytics/beta-telemetry.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAYD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAgClE"}

package/dist/analytics/beta-telemetry.js

@@ -0,0 +1,47 @@
+import { isAnalyticsEnabled, isBetaTelemetryOptIn } from './identity.js';
+import { getLaunchMethod } from './launch-method.js';
+import { getAnalytics } from './provider.js';
+const MAX_TEXT_LENGTH = 16_000;
+const TRUNCATION_SUFFIX = '…[truncated]';
+function truncateText(value) {
+    if (!value)
+        return undefined;
+    if (value.length <= MAX_TEXT_LENGTH)
+        return value;
+    return `${value.slice(0, MAX_TEXT_LENGTH)}${TRUNCATION_SUFFIX}`;
+}
+function uniqueToolNames(names) {
+    return [...new Set(names.map((name) => name.trim()).filter(Boolean))];
+}
+export function captureBetaChatTurn(input) {
+    if (!isAnalyticsEnabled() || !isBetaTelemetryOptIn())
+        return;
+    const assistantText = input.assistantText.trim();
+    const assistantReasoning = input.assistantReasoning?.trim() ?? '';
+    const hasAssistantContent = assistantText.length > 0 ||
+        assistantReasoning.length > 0 ||
+        input.toolNames.length > 0;
+    if (!hasAssistantContent)
+        return;
+    const toolNames = uniqueToolNames(input.toolNames);
+    getAnalytics().capture({
+        name: 'beta_chat_turn',
+        properties: {
+            os: process.platform,
+            arch: process.arch,
+            node_version: process.version,
+            launch_method: getLaunchMethod(),
+            event_source: 'server',
+            provider_id: input.providerId,
+            auth_method: input.authMethod,
+            model: input.model,
+            user_prompt: truncateText(input.userPrompt.trim()) ?? '',
+            assistant_text: truncateText(assistantText) ?? '',
+            ...(assistantReasoning
+                ? { assistant_reasoning: truncateText(assistantReasoning) }
+                : {}),
+            ...(toolNames.length > 0 ? { tool_names: toolNames.join(',') } : {}),
+        },
+    });
+}
+//# sourceMappingURL=beta-telemetry.js.map

package/dist/analytics/beta-telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"beta-telemetry.js","sourceRoot":"","sources":["../../src/analytics/beta-telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,eAAe,GAAG,MAAM,CAAC;AAC/B,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAYzC,SAAS,YAAY,CAAC,KAAyB;IAC7C,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,IAAI,KAAK,CAAC,MAAM,IAAI,eAAe;QAAE,OAAO,KAAK,CAAC;IAClD,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,GAAG,iBAAiB,EAAE,CAAC;AAClE,CAAC;AAED,SAAS,eAAe,CAAC,KAAe;IACtC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAwB;IAC1D,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,oBAAoB,EAAE;QAAE,OAAO;IAE7D,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;IACjD,MAAM,kBAAkB,GAAG,KAAK,CAAC,kBAAkB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAClE,MAAM,mBAAmB,GACvB,aAAa,CAAC,MAAM,GAAG,CAAC;QACxB,kBAAkB,CAAC,MAAM,GAAG,CAAC;QAC7B,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,mBAAmB;QAAE,OAAO;IAEjC,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAEnD,YAAY,EAAE,CAAC,OAAO,CAAC;QACrB,IAAI,EAAE,gBAAgB;QACtB,UAAU,EAAE;YACV,EAAE,EAAE,OAAO,CAAC,QAAQ;YACpB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,YAAY,EAAE,OAAO,CAAC,OAAO;YAC7B,aAAa,EAAE,eAAe,EAAE;YAChC,YAAY,EAAE,QAAQ;YACtB,WAAW,EAAE,KAAK,CAAC,UAAU;YAC7B,WAAW,EAAE,KAAK,CAAC,UAAU;YAC7B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,WAAW,EAAE,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE;YACxD,cAAc,EAAE,YAAY,CAAC,aAAa,CAAC,IAAI,EAAE;YACjD,GAAG,CAAC,kBAAkB;gBACpB,CAAC,CAAC,EAAE,mBAAmB,EAAE,YAAY,CAAC,kBAAkB,CAAC,EAAE;gBAC3D,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrE;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/analytics/client-ip.d.ts

@@ -0,0 +1,5 @@
+/** Best-effort client IP from an incoming HTTP request (may be loopback for local UI). */
+export declare function resolveClientIp(headers: Headers): string | undefined;
+/** GeoIP enrichment only makes sense for a routable public client address. */
+export declare function isPublicClientIp(ip: string | undefined): boolean;
+//# sourceMappingURL=client-ip.d.ts.map

package/dist/analytics/client-ip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-ip.d.ts","sourceRoot":"","sources":["../../src/analytics/client-ip.ts"],"names":[],"mappings":"AAYA,0FAA0F;AAC1F,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAapE;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAGhE"}

package/dist/analytics/client-ip.js

@@ -0,0 +1,39 @@
+function isLoopbackOrPrivateIp(ip) {
+    const normalized = ip.trim().toLowerCase();
+    if (!normalized)
+        return true;
+    if (normalized === '::1' || normalized === 'localhost')
+        return true;
+    if (normalized.startsWith('127.'))
+        return true;
+    if (normalized.startsWith('10.'))
+        return true;
+    if (normalized.startsWith('192.168.'))
+        return true;
+    if (/^172\.(1[6-9]|2\d|3[01])\./.test(normalized))
+        return true;
+    if (normalized.startsWith('fc') || normalized.startsWith('fd'))
+        return true;
+    return false;
+}
+/** Best-effort client IP from an incoming HTTP request (may be loopback for local UI). */
+export function resolveClientIp(headers) {
+    const candidates = [
+        headers.get('cf-connecting-ip'),
+        headers.get('x-real-ip'),
+        ...(headers.get('x-forwarded-for')?.split(',') ?? []),
+    ];
+    for (const raw of candidates) {
+        const ip = raw?.trim();
+        if (ip)
+            return ip;
+    }
+    return undefined;
+}
+/** GeoIP enrichment only makes sense for a routable public client address. */
+export function isPublicClientIp(ip) {
+    if (!ip)
+        return false;
+    return !isLoopbackOrPrivateIp(ip);
+}
+//# sourceMappingURL=client-ip.js.map

package/dist/analytics/client-ip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-ip.js","sourceRoot":"","sources":["../../src/analytics/client-ip.ts"],"names":[],"mappings":"AAAA,SAAS,qBAAqB,CAAC,EAAU;IACvC,MAAM,UAAU,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,UAAU,KAAK,KAAK,IAAI,UAAU,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IACpE,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,IAAI,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,4BAA4B,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/D,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,MAAM,UAAU,GAAG;QACjB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;QACxB,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;KACtD,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC;QACvB,IAAI,EAAE;YAAE,OAAO,EAAE,CAAC;IACpB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,gBAAgB,CAAC,EAAsB;IACrD,IAAI,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC;IACtB,OAAO,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;AACpC,CAAC"}

package/dist/analytics/config.d.ts

@@ -0,0 +1,6 @@
+export declare function isPostHogDisabledByEnv(): boolean;
+export declare function resolvePostHogKey(): string;
+export declare function resolvePostHogApiHost(): string;
+export declare function resolvePostHogUiHost(): string;
+export declare function hasPostHogKey(): boolean;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/analytics/config.ts"],"names":[],"mappings":"AASA,wBAAgB,sBAAsB,IAAI,OAAO,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"}

package/dist/analytics/config.js

@@ -0,0 +1,23 @@
+const DEFAULT_POSTHOG_KEY = 'phc_mejq4ZZ8jTNZPiusjh7vHyPzWYinzsDwVJW43SM5FEcg';
+const DEFAULT_API_HOST = 'https://a.alisait.com';
+const DEFAULT_UI_HOST = 'https://eu.posthog.com';
+function envTruthy(name) {
+    const value = process.env[name]?.trim().toLowerCase();
+    return value === '1' || value === 'true' || value === 'yes';
+}
+export function isPostHogDisabledByEnv() {
+    return envTruthy('POSTHOG_DISABLED');
+}
+export function resolvePostHogKey() {
+    return process.env.POSTHOG_KEY?.trim() || DEFAULT_POSTHOG_KEY;
+}
+export function resolvePostHogApiHost() {
+    return process.env.POSTHOG_API_HOST?.trim() || DEFAULT_API_HOST;
+}
+export function resolvePostHogUiHost() {
+    return process.env.POSTHOG_UI_HOST?.trim() || DEFAULT_UI_HOST;
+}
+export function hasPostHogKey() {
+    return resolvePostHogKey().length > 0;
+}
+//# sourceMappingURL=config.js.map

package/dist/analytics/config.js.map

@@ -0,0 +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,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,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"}

package/dist/analytics/context.d.ts

@@ -0,0 +1,2 @@
+export declare function getServerAnalyticsContext(): Record<string, boolean>;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/analytics/context.ts"],"names":[],"mappings":"AAGA,wBAAgB,yBAAyB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASnE"}

package/dist/analytics/context.js

@@ -0,0 +1,13 @@
+import { loadConfig } from '../ui/config.js';
+import { isAnalyticsEnabled, isBetaTelemetryOptIn } from './identity.js';
+export function getServerAnalyticsContext() {
+    const config = loadConfig();
+    const analyticsEnabled = isAnalyticsEnabled();
+    return {
+        privacy_mode: !analyticsEnabled,
+        analytics_enabled: analyticsEnabled,
+        beta_telemetry_opt_in: isBetaTelemetryOptIn(),
+        action_plan_enabled: Boolean(config.actionPlanBeta),
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/analytics/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/analytics/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAEzE,MAAM,UAAU,yBAAyB;IACvC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,gBAAgB,GAAG,kBAAkB,EAAE,CAAC;IAC9C,OAAO;QACL,YAAY,EAAE,CAAC,gBAAgB;QAC/B,iBAAiB,EAAE,gBAAgB;QACnC,qBAAqB,EAAE,oBAAoB,EAAE;QAC7C,mBAAmB,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;KACpD,CAAC;AACJ,CAAC"}

package/dist/analytics/events.d.ts

@@ -0,0 +1,3 @@
+export declare function sanitizeAnalyticsProperties(properties: Record<string, unknown> | undefined): Record<string, string | number | boolean>;
+export declare function buildRuntimeProperties(properties: Record<string, unknown> | undefined): Record<string, string | number | boolean>;
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/analytics/events.ts"],"names":[],"mappings":"AAuDA,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC9C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAc3C;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC9C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAa3C"}

package/dist/analytics/events.js

@@ -0,0 +1,85 @@
+import { getServerAnalyticsContext } from './context.js';
+import { getLaunchMethod } from './launch-method.js';
+import { getSystemLocale, resolveLocaleRegion } from './locale.js';
+const BLOCKED_PROPERTY_KEYS = new Set([
+    'api_key',
+    'apikey',
+    'key',
+    'token',
+    'secret',
+    'password',
+    'email',
+    'account_label',
+    'cli_path',
+    'path',
+    'file_path',
+    'filepath',
+    'message',
+    'content',
+    'prompt',
+    'chat_id',
+    'session_id',
+]);
+const ALLOWED_PROPERTY_KEYS = new Set([
+    'app_version',
+    'os',
+    'arch',
+    'node_version',
+    'provider_id',
+    'auth_method',
+    'ok',
+    'error_code',
+    'photoshop_detected',
+    'action_plan_enabled',
+    'event_source',
+    'port',
+    'host',
+    'no_open',
+    'has_auth',
+    'has_custom_path',
+    'opted_out',
+    'opted_in',
+    'privacy_mode',
+    'analytics_enabled',
+    'beta_telemetry_opt_in',
+    'theme',
+    'launch_method',
+    'browser_language',
+    'browser_timezone',
+    'browser_locale_region',
+    'system_locale',
+    'system_locale_region',
+]);
+export function sanitizeAnalyticsProperties(properties) {
+    if (!properties)
+        return {};
+    const out = {};
+    for (const [key, value] of Object.entries(properties)) {
+        const normalized = key.toLowerCase();
+        if (BLOCKED_PROPERTY_KEYS.has(normalized))
+            continue;
+        if (!ALLOWED_PROPERTY_KEYS.has(normalized))
+            continue;
+        if (value === null || value === undefined)
+            continue;
+        if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+            out[normalized] = value;
+        }
+    }
+    return out;
+}
+export function buildRuntimeProperties(properties) {
+    const systemLocale = getSystemLocale();
+    const systemLocaleRegion = resolveLocaleRegion(systemLocale);
+    return {
+        os: process.platform,
+        arch: process.arch,
+        node_version: process.version,
+        launch_method: getLaunchMethod(),
+        system_locale: systemLocale,
+        ...(systemLocaleRegion ? { system_locale_region: systemLocaleRegion } : {}),
+        ...getServerAnalyticsContext(),
+        ...sanitizeAnalyticsProperties(properties),
+    };
+}
+//# sourceMappingURL=events.js.map

package/dist/analytics/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/analytics/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,SAAS;IACT,QAAQ;IACR,KAAK;IACL,OAAO;IACP,QAAQ;IACR,UAAU;IACV,OAAO;IACP,eAAe;IACf,UAAU;IACV,MAAM;IACN,WAAW;IACX,UAAU;IACV,SAAS;IACT,SAAS;IACT,QAAQ;IACR,SAAS;IACT,YAAY;CACb,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,aAAa;IACb,IAAI;IACJ,MAAM;IACN,cAAc;IACd,aAAa;IACb,aAAa;IACb,IAAI;IACJ,YAAY;IACZ,oBAAoB;IACpB,qBAAqB;IACrB,cAAc;IACd,MAAM;IACN,MAAM;IACN,SAAS;IACT,UAAU;IACV,iBAAiB;IACjB,WAAW;IACX,UAAU;IACV,cAAc;IACd,mBAAmB;IACnB,uBAAuB;IACvB,OAAO;IACP,eAAe;IACf,kBAAkB;IAClB,kBAAkB;IAClB,uBAAuB;IACvB,eAAe;IACf,sBAAsB;CACvB,CAAC,CAAC;AAEH,MAAM,UAAU,2BAA2B,CACzC,UAA+C;IAE/C,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAE3B,MAAM,GAAG,GAA8C,EAAE,CAAC;IAC1D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACtD,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QACrC,IAAI,qBAAqB,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAS;QACpD,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAS;QACrD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YACzF,GAAG,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,UAA+C;IAE/C,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;IACvC,MAAM,kBAAkB,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAC;IAC7D,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,QAAQ;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,YAAY,EAAE,OAAO,CAAC,OAAO;QAC7B,aAAa,EAAE,eAAe,EAAE;QAChC,aAAa,EAAE,YAAY;QAC3B,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,GAAG,yBAAyB,EAAE;QAC9B,GAAG,2BAA2B,CAAC,UAAU,CAAC;KAC3C,CAAC;AACJ,CAAC"}

package/dist/analytics/identity.d.ts

@@ -0,0 +1,9 @@
+import type { BetaTelemetryState } from './types.js';
+export declare function getOrCreateDistinctId(): string;
+export declare function isAnalyticsOptedOut(): boolean;
+export declare function setAnalyticsOptOut(optedOut: boolean): void;
+export declare function isAnalyticsEnabled(): boolean;
+export declare function getBetaTelemetryState(): BetaTelemetryState;
+export declare function isBetaTelemetryOptIn(): boolean;
+export declare function setBetaTelemetryChoice(optedIn: boolean): void;
+//# sourceMappingURL=identity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/analytics/identity.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAwFrD,wBAAgB,qBAAqB,IAAI,MAAM,CAsB9C;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CAO7C;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAI1D;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAqBD,wBAAgB,qBAAqB,IAAI,kBAAkB,CAW1D;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAS7D"}

package/dist/analytics/identity.js

@@ -0,0 +1,166 @@
+import { randomUUID } from 'node:crypto';
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getPhotoshopMcpHomeDir } from '../lib/export-paths.js';
+import { kvGet, kvSet } from '../ui/store/kv.js';
+import { isPostHogDisabledByEnv } from './config.js';
+const DISTINCT_ID_KEY = 'analytics_distinct_id';
+const OPT_OUT_KEY = 'analytics_opt_out';
+const BETA_TELEMETRY_OPT_IN_KEY = 'beta_telemetry_opt_in';
+const BETA_TELEMETRY_PROMPT_ANSWERED_KEY = 'beta_telemetry_prompt_answered';
+const STORE_FILE = 'analytics-store.json';
+let memoryDistinctId = null;
+let dbAvailable = null;
+function getStorePath() {
+    return join(getPhotoshopMcpHomeDir(), STORE_FILE);
+}
+function readFileStore() {
+    try {
+        const raw = readFileSync(getStorePath(), 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+function writeFileStore(store) {
+    const dir = getPhotoshopMcpHomeDir();
+    mkdirSync(dir, { recursive: true, mode: 0o700 });
+    writeFileSync(getStorePath(), JSON.stringify(store), { mode: 0o600 });
+}
+function canUseKv() {
+    if (dbAvailable === false)
+        return false;
+    try {
+        kvGet('__analytics_probe__');
+        dbAvailable = true;
+        return true;
+    }
+    catch {
+        dbAvailable = false;
+        return false;
+    }
+}
+function readDistinctIdFromKv() {
+    if (!canUseKv())
+        return undefined;
+    try {
+        return kvGet(DISTINCT_ID_KEY);
+    }
+    catch {
+        dbAvailable = false;
+        return undefined;
+    }
+}
+function writeDistinctIdToKv(id) {
+    if (!canUseKv())
+        return;
+    try {
+        kvSet(DISTINCT_ID_KEY, id);
+    }
+    catch {
+        dbAvailable = false;
+    }
+}
+function readOptOutFromKv() {
+    if (!canUseKv())
+        return undefined;
+    try {
+        return kvGet(OPT_OUT_KEY);
+    }
+    catch {
+        dbAvailable = false;
+        return undefined;
+    }
+}
+function writeOptOutToKv(optedOut) {
+    if (!canUseKv())
+        return;
+    try {
+        kvSet(OPT_OUT_KEY, optedOut);
+    }
+    catch {
+        dbAvailable = false;
+    }
+}
+export function getOrCreateDistinctId() {
+    if (memoryDistinctId)
+        return memoryDistinctId;
+    const fromKv = readDistinctIdFromKv();
+    if (fromKv) {
+        memoryDistinctId = fromKv;
+        return fromKv;
+    }
+    const fromFile = readFileStore().distinctId;
+    if (fromFile) {
+        memoryDistinctId = fromFile;
+        writeDistinctIdToKv(fromFile);
+        return fromFile;
+    }
+    const id = randomUUID();
+    memoryDistinctId = id;
+    writeDistinctIdToKv(id);
+    const store = readFileStore();
+    writeFileStore({ ...store, distinctId: id });
+    return id;
+}
+export function isAnalyticsOptedOut() {
+    if (isPostHogDisabledByEnv())
+        return true;
+    const fromKv = readOptOutFromKv();
+    if (fromKv !== undefined)
+        return fromKv;
+    return readFileStore().optedOut === true;
+}
+export function setAnalyticsOptOut(optedOut) {
+    writeOptOutToKv(optedOut);
+    const store = readFileStore();
+    writeFileStore({ ...store, optedOut });
+}
+export function isAnalyticsEnabled() {
+    return !isAnalyticsOptedOut();
+}
+function readBooleanFromKv(key) {
+    if (!canUseKv())
+        return undefined;
+    try {
+        return kvGet(key);
+    }
+    catch {
+        dbAvailable = false;
+        return undefined;
+    }
+}
+function writeBooleanToKv(key, value) {
+    if (!canUseKv())
+        return;
+    try {
+        kvSet(key, value);
+    }
+    catch {
+        dbAvailable = false;
+    }
+}
+export function getBetaTelemetryState() {
+    const fromKvOptIn = readBooleanFromKv(BETA_TELEMETRY_OPT_IN_KEY);
+    const fromKvAnswered = readBooleanFromKv(BETA_TELEMETRY_PROMPT_ANSWERED_KEY);
+    const fileStore = readFileStore();
+    return {
+        betaTelemetryOptIn: fromKvOptIn ?? fileStore.betaTelemetryOptIn ?? false,
+        betaTelemetryPromptAnswered: fromKvAnswered ?? fileStore.betaTelemetryPromptAnswered ?? false,
+    };
+}
+export function isBetaTelemetryOptIn() {
+    return getBetaTelemetryState().betaTelemetryOptIn;
+}
+export function setBetaTelemetryChoice(optedIn) {
+    writeBooleanToKv(BETA_TELEMETRY_OPT_IN_KEY, optedIn);
+    writeBooleanToKv(BETA_TELEMETRY_PROMPT_ANSWERED_KEY, true);
+    const store = readFileStore();
+    writeFileStore({
+        ...store,
+        betaTelemetryOptIn: optedIn,
+        betaTelemetryPromptAnswered: true,
+    });
+}
+//# sourceMappingURL=identity.js.map

package/dist/analytics/identity.js.map

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

package/dist/analytics/index.d.ts

@@ -0,0 +1,12 @@
+import { captureBetaChatTurn } from './beta-telemetry.js';
+import { getBetaTelemetryState, setBetaTelemetryChoice } from './identity.js';
+import { getAnalytics, resetAnalyticsProvider } from './provider.js';
+import type { AnalyticsEvent, AnalyticsProvider, AnalyticsRuntimeConfig, BetaTelemetryState } from './types.js';
+/** Persist the install ID and register one anonymous PostHog person per process. */
+export declare function ensureAnalyticsIdentity(): void;
+export declare function capture(name: string, properties?: Record<string, unknown>): void;
+export declare function shutdownAnalytics(): Promise<void>;
+export declare function getAnalyticsRuntimeConfig(): AnalyticsRuntimeConfig;
+export { captureBetaChatTurn, getAnalytics, getBetaTelemetryState, resetAnalyticsProvider, setBetaTelemetryChoice, };
+export type { AnalyticsEvent, AnalyticsProvider, AnalyticsRuntimeConfig, BetaTelemetryState };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAQ1D,OAAO,EACL,qBAAqB,EAGrB,sBAAsB,EACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAA2B,MAAM,eAAe,CAAC;AAC9F,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,oFAAoF;AACpF,wBAAgB,uBAAuB,IAAI,IAAI,CAI9C;AAED,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,IAAI,CAMN;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEvD;AAED,wBAAgB,yBAAyB,IAAI,sBAAsB,CAYlE;AAED,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,GACvB,CAAC;AACF,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/analytics/index.js

@@ -0,0 +1,38 @@
+import { captureBetaChatTurn } from './beta-telemetry.js';
+import { hasPostHogKey, resolvePostHogApiHost, resolvePostHogKey, resolvePostHogUiHost, } from './config.js';
+import { buildRuntimeProperties } from './events.js';
+import { getBetaTelemetryState, getOrCreateDistinctId, isAnalyticsEnabled, setBetaTelemetryChoice, } from './identity.js';
+import { getAnalytics, resetAnalyticsProvider, shutdownAnalyticsClient } from './provider.js';
+/** Persist the install ID and register one anonymous PostHog person per process. */
+export function ensureAnalyticsIdentity() {
+    if (!isAnalyticsEnabled() || !hasPostHogKey())
+        return;
+    getOrCreateDistinctId();
+    getAnalytics();
+}
+export function capture(name, properties) {
+    if (!isAnalyticsEnabled() || !hasPostHogKey())
+        return;
+    getAnalytics().capture({
+        name,
+        properties: buildRuntimeProperties(properties),
+    });
+}
+export async function shutdownAnalytics() {
+    await shutdownAnalyticsClient();
+}
+export function getAnalyticsRuntimeConfig() {
+    const enabled = isAnalyticsEnabled() && hasPostHogKey();
+    const beta = getBetaTelemetryState();
+    return {
+        enabled,
+        key: resolvePostHogKey(),
+        apiHost: resolvePostHogApiHost(),
+        uiHost: resolvePostHogUiHost(),
+        distinctId: getOrCreateDistinctId(),
+        betaTelemetryOptIn: beta.betaTelemetryOptIn,
+        betaTelemetryPromptAnswered: beta.betaTelemetryPromptAnswered,
+    };
+}
+export { captureBetaChatTurn, getAnalytics, getBetaTelemetryState, resetAnalyticsProvider, setBetaTelemetryChoice, };
+//# sourceMappingURL=index.js.map

package/dist/analytics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAQ9F,oFAAoF;AACpF,MAAM,UAAU,uBAAuB;IACrC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,aAAa,EAAE;QAAE,OAAO;IACtD,qBAAqB,EAAE,CAAC;IACxB,YAAY,EAAE,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,IAAY,EACZ,UAAoC;IAEpC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,aAAa,EAAE;QAAE,OAAO;IACtD,YAAY,EAAE,CAAC,OAAO,CAAC;QACrB,IAAI;QACJ,UAAU,EAAE,sBAAsB,CAAC,UAAU,CAAC;KAC/C,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,uBAAuB,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,MAAM,OAAO,GAAG,kBAAkB,EAAE,IAAI,aAAa,EAAE,CAAC;IACxD,MAAM,IAAI,GAAG,qBAAqB,EAAE,CAAC;IACrC,OAAO;QACL,OAAO;QACP,GAAG,EAAE,iBAAiB,EAAE;QACxB,OAAO,EAAE,qBAAqB,EAAE;QAChC,MAAM,EAAE,oBAAoB,EAAE;QAC9B,UAAU,EAAE,qBAAqB,EAAE;QACnC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;QAC3C,2BAA2B,EAAE,IAAI,CAAC,2BAA2B;KAC9D,CAAC;AACJ,CAAC;AAED,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,GACvB,CAAC"}

package/dist/analytics/launch-method.d.ts

@@ -0,0 +1,4 @@
+export type LaunchMethod = 'npx' | 'npm' | 'node' | 'unknown';
+export declare function resolveLaunchMethod(env?: NodeJS.ProcessEnv, argv?: string[]): LaunchMethod;
+export declare function getLaunchMethod(): LaunchMethod;
+//# sourceMappingURL=launch-method.d.ts.map

package/dist/analytics/launch-method.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-method.d.ts","sourceRoot":"","sources":["../../src/analytics/launch-method.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;AAuB9D,wBAAgB,mBAAmB,CACjC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,IAAI,GAAE,MAAM,EAAiB,GAC5B,YAAY,CAWd;AAED,wBAAgB,eAAe,IAAI,YAAY,CAK9C"}