wp-studio 1.7.10 → 1.7.11

package/dist/cli/{_events-BcapW3eh.mjs → _events-B8xQ_baD.mjs}

@@ -1,11 +1,10 @@
 import fs__default from "fs";
-import { o as socketEventSchema, j as SITE_EVENTS, S as SNAPSHOT_EVENTS, A as AUTH_EVENTS, r as readCliConfig, p as siteDetailsSchema } from "./certificate-manager-SVYcCL_i.mjs";
-import { v as isEmptyDir } from "./rewrite-wp-cli-post-content-2zlfFnKT.mjs";
+import { L as LoggerError, c as Logger, x as socketEventSchema, S as SITE_EVENTS, f as SNAPSHOT_EVENTS, A as AUTH_EVENTS, r as readCliConfig, y as siteDetailsSchema } from "./certificate-manager-v-yNLDFJ.mjs";
+import { o as isEmptyDir } from "./rewrite-wp-cli-post-content-Beo5_Ojo.mjs";
 import { s as sequential } from "./sequential-BQFuixXz.mjs";
-import { M as SITE_EVENTS_SOCKET_PATH, w as SiteCommandLoggerAction, B as connectToDaemon, N as getDaemonBus, O as SITE_PROCESS_PREFIX, J as disconnectFromDaemon, Q as removeSiteFromConfig, m as getSiteUrl, l as isSiteRunning } from "./index-DRQnCQvM.mjs";
+import { M as SITE_EVENTS_SOCKET_PATH, w as SiteCommandLoggerAction, B as connectToDaemon, N as getDaemonBus, O as SITE_PROCESS_PREFIX, J as disconnectFromDaemon, Q as removeSiteFromConfig, m as getSiteUrl, l as isSiteRunning } from "./index-ul3DeWvy.mjs";
 import { __ } from "@wordpress/i18n";
-import { g as SocketServer } from "./process-manager-ipc-BisO0qtU.mjs";
-import { L as LoggerError, d as Logger } from "./well-known-paths-BYA1Bw5o.mjs";
+import { g as SocketServer } from "./process-manager-ipc-GCdebuBH.mjs";
 const logger = new Logger();
 function toSiteDetails(site) {
   return siteDetailsSchema.parse({

package/dist/cli/appdata-D-luHxJU.mjs

@@ -0,0 +1,19 @@
+import os from "os";
+import path__default from "path";
+import { __ } from "@wordpress/i18n";
+import { L as LoggerError } from "./certificate-manager-v-yNLDFJ.mjs";
+function getAppdataDirectory() {
+  if (process.env.E2E && process.env.E2E_APP_DATA_PATH) {
+    return path__default.join(process.env.E2E_APP_DATA_PATH, "Studio");
+  }
+  if (process.platform === "win32") {
+    if (!process.env.APPDATA) {
+      throw new LoggerError(__("Studio config file path not found."));
+    }
+    return path__default.join(process.env.APPDATA, "Studio");
+  }
+  return path__default.join(os.homedir(), "Library", "Application Support", "Studio");
+}
+export {
+  getAppdataDirectory as g
+};

package/dist/cli/{certificate-manager-SVYcCL_i.mjs → certificate-manager-v-yNLDFJ.mjs}

@@ -1,6 +1,6 @@
 import fs__default from "fs";
 import path__default from "path";
-import { i as commonjsGlobal, g as getDefaultExportFromCjs, k as getConfigDirectory, C as CLI_CONFIG_LOCKFILE_NAME, u as getCliConfigPath, L as LoggerError, a as LOCKFILE_STALE_TIME, b as LOCKFILE_WAIT_TIME, v as getCertificatesPath, w as CERT_UNTRUSTED_ROOT, x as SERVER_AUTH_OID } from "./well-known-paths-BYA1Bw5o.mjs";
+import { f as getConfigDirectory, C as CLI_CONFIG_LOCKFILE_NAME, n as getCliConfigPath, L as LOCKFILE_STALE_TIME, a as LOCKFILE_WAIT_TIME, o as getCertificatesPath, p as CERT_UNTRUSTED_ROOT, q as SERVER_AUTH_OID } from "./well-known-paths-QcSJNi_l.mjs";
 import { z } from "zod";
 import { execFile } from "child_process";
 import require$$1 from "constants";
@@ -10,6 +10,7 @@ import require$$0 from "assert";
 import require$$2 from "events";
 import { __ } from "@wordpress/i18n";
 import { readFile, writeFile } from "atomically";
+import { Spinner } from "picospinner";
 import { execFile as execFile$1 } from "node:child_process";
 import crypto from "node:crypto";
 import fs from "node:fs";
@@ -18,6 +19,113 @@ import { domainToASCII } from "node:url";
 import { promisify } from "node:util";
 import sudo from "@vscode/sudo-prompt";
 import forge from "node-forge";
+const isIpcMode = Boolean(process.send);
+let progressCallback = null;
+function setProgressCallback(callback) {
+  progressCallback = callback;
+}
+function getProgressCallback() {
+  return progressCallback;
+}
+function emitProgress(message) {
+  progressCallback?.(message);
+}
+function canSend() {
+  return isIpcMode && !!process.send && process.connected;
+}
+class LoggerError extends Error {
+  constructor(message, previousError) {
+    super();
+    this.name = "LoggerError";
+    this.errorMessage = message;
+    if (previousError instanceof Error) {
+      this.previousError = previousError;
+    }
+  }
+  get message() {
+    if (this.previousError) {
+      return `${this.errorMessage}: ${this.previousError.message}`;
+    }
+    return this.errorMessage;
+  }
+}
+class Logger {
+  constructor() {
+    this.currentAction = null;
+    this.spinner = new Spinner();
+  }
+  reportStart(action, message) {
+    this.currentAction = action;
+    if (canSend()) {
+      process.send({ action, status: "inprogress", message });
+    } else if (progressCallback) {
+      progressCallback(message);
+    } else {
+      this.spinner.setText(message);
+      if (!this.spinner.running) {
+        this.spinner.start();
+      }
+    }
+  }
+  reportProgress(message) {
+    if (canSend()) {
+      process.send({ action: this.currentAction, status: "inprogress", message });
+    } else if (progressCallback) {
+      progressCallback(message, true);
+    } else {
+      if (!this.spinner.running) {
+        this.spinner.start();
+      }
+      this.spinner.setText(message);
+    }
+  }
+  reportSuccess(message) {
+    if (canSend()) {
+      process.send({ action: this.currentAction, status: "success", message });
+    } else if (progressCallback) {
+      progressCallback(message);
+    } else {
+      if (!this.spinner.running) {
+        this.spinner.start();
+      }
+      this.spinner.succeed(message);
+    }
+    this.currentAction = null;
+  }
+  reportWarning(message) {
+    if (canSend()) {
+      process.send({ action: this.currentAction, status: "warning", message });
+    } else if (progressCallback) {
+      progressCallback(message);
+    } else {
+      if (!this.spinner.running) {
+        this.spinner.start();
+      }
+      this.spinner.warn(message);
+    }
+  }
+  reportError(error, isFatal = true) {
+    if (isFatal) {
+      process.exitCode = 1;
+    }
+    if (canSend()) {
+      process.send({ action: this.currentAction, status: "fail", message: error.message });
+    } else if (progressCallback) {
+      progressCallback(error.message);
+    } else {
+      if (!this.spinner.running) {
+        this.spinner.start();
+      }
+      this.spinner.fail(error.message);
+    }
+    this.currentAction = null;
+  }
+  reportKeyValuePair(key, value) {
+    if (canSend()) {
+      process.send({ action: "keyValuePair", key, value });
+    }
+  }
+}
 const authTokenSchema = z.object({
   accessToken: z.string(),
   expiresIn: z.number(),
@@ -171,6 +279,10 @@ async function isDirectoryHiddenOnWindows(dirPath) {
     });
   });
 }
+var commonjsGlobal = typeof globalThis !== "undefined" ? globalThis : typeof window !== "undefined" ? window : typeof global !== "undefined" ? global : typeof self !== "undefined" ? self : {};
+function getDefaultExportFromCjs(x) {
+  return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, "default") ? x["default"] : x;
+}
 var lockfile$1 = {};
 var signalExit = { exports: {} };
 var signals = { exports: {} };
@@ -1005,24 +1117,31 @@ function deleteSiteCertificate(domain) {
 }
 export {
   AUTH_EVENTS as A,
-  SNAPSHOT_EVENTS as S,
+  LoggerError as L,
+  SITE_EVENTS as S,
   lockFileAsync as a,
   unlockFileAsync as b,
-  authTokenSchema as c,
-  requireSignalExit as d,
-  StatsMetric as e,
-  StatsGroup as f,
-  updateCliConfigWithPartial as g,
+  Logger as c,
+  commonjsGlobal as d,
+  authTokenSchema as e,
+  SNAPSHOT_EVENTS as f,
+  getDefaultExportFromCjs as g,
   hideDirectoryOnWindows as h,
-  generateSiteCertificate as i,
-  SITE_EVENTS as j,
-  deleteSiteCertificate as k,
+  requireSignalExit as i,
+  StatsMetric as j,
+  StatsGroup as k,
   lockCliConfig as l,
-  updateCheckSchema as m,
-  isDirectoryHiddenOnWindows as n,
-  socketEventSchema as o,
-  siteDetailsSchema as p,
+  updateCliConfigWithPartial as m,
+  generateSiteCertificate as n,
+  deleteSiteCertificate as o,
+  emitProgress as p,
+  setProgressCallback as q,
   readCliConfig as r,
   saveCliConfig as s,
-  unlockCliConfig as u
+  getProgressCallback as t,
+  unlockCliConfig as u,
+  updateCheckSchema as v,
+  isDirectoryHiddenOnWindows as w,
+  socketEventSchema as x,
+  siteDetailsSchema as y
 };

package/dist/cli/{delete-D1924O3o.mjs → delete-BG-E-HsW.mjs}

@@ -1,7 +1,7 @@
-import { l as listAiSessions, g as getAiSessionsRootDirectory, d as deleteAiSession } from "./paths-CqXGLB7R.mjs";
+import { l as listAiSessions, g as getAiSessionsRootDirectory, d as deleteAiSession } from "./paths-D7DniT1Q.mjs";
 import { __ } from "@wordpress/i18n";
-import { c as chooseSessionForAction } from "./helpers-oQuItT8n.mjs";
-import { L as LoggerError, d as Logger } from "./well-known-paths-BYA1Bw5o.mjs";
+import { c as chooseSessionForAction } from "./helpers-CIAgfdq8.mjs";
+import { L as LoggerError, c as Logger } from "./certificate-manager-v-yNLDFJ.mjs";
 const logger = new Logger();
 async function runCommand(sessionIdOrPrefix) {
   let resolvedSessionIdOrPrefix = sessionIdOrPrefix?.trim();

package/dist/cli/{helpers-oQuItT8n.mjs → helpers-CIAgfdq8.mjs}

@@ -1,7 +1,7 @@
 import { select } from "@inquirer/prompts";
 import { visibleWidth, truncateToWidth } from "@mariozechner/pi-tui";
-import { l as listAiSessions, g as getAiSessionsRootDirectory } from "./paths-CqXGLB7R.mjs";
-import { h as chalk } from "./index-DRQnCQvM.mjs";
+import { l as listAiSessions, g as getAiSessionsRootDirectory } from "./paths-D7DniT1Q.mjs";
+import { h as chalk } from "./index-ul3DeWvy.mjs";
 import { __ } from "@wordpress/i18n";
 function formatSessionTimestamp(timestamp) {
   const parsed = Date.parse(timestamp);

package/dist/cli/{index-4lan3TI_.mjs → index-Bej4fL6n.mjs}

@@ -2,11 +2,11 @@ import { execFile } from "child_process";
 import fs__default from "fs";
 import path__default from "path";
 import { confirm } from "@inquirer/prompts";
-import { y as getAppConfigPath, k as getConfigDirectory } from "./well-known-paths-BYA1Bw5o.mjs";
+import { r as getAppConfigPath, f as getConfigDirectory, g as getServerFilesPath } from "./well-known-paths-QcSJNi_l.mjs";
 import { __ } from "@wordpress/i18n";
-import { G as getAppdataDirectory } from "./rewrite-wp-cli-post-content-2zlfFnKT.mjs";
+import { g as getAppdataDirectory } from "./appdata-D-luHxJU.mjs";
 import fs from "node:fs";
-import { h as hideDirectoryOnWindows, n as isDirectoryHiddenOnWindows } from "./certificate-manager-SVYcCL_i.mjs";
+import { h as hideDirectoryOnWindows, w as isDirectoryHiddenOnWindows } from "./certificate-manager-v-yNLDFJ.mjs";
 import os from "node:os";
 import path from "node:path";
 function isInstalledOnMacOs() {
@@ -134,10 +134,37 @@ const renameProcessManagerHome = {
     fs.renameSync(getLegacyPmHome(), getNewPmHome());
   }
 };
+function getObsoletePaths() {
+  const serverFilesPath = getServerFilesPath();
+  return [
+    path.join(serverFilesPath, "skills"),
+    path.join(serverFilesPath, "sqlite-database-integration"),
+    path.join(serverFilesPath, "sqlite-command"),
+    path.join(serverFilesPath, "phpmyadmin"),
+    path.join(serverFilesPath, "wp-cli.phar"),
+    path.join(
+      serverFilesPath,
+      "wordpress-versions",
+      "latest",
+      "available-site-translations.json"
+    )
+  ];
+}
+const cleanupObsoleteServerFiles = {
+  needsToRun: async () => {
+    return getObsoletePaths().some((p) => fs.existsSync(p));
+  },
+  run: async () => {
+    for (const p of getObsoletePaths()) {
+      await fs.promises.rm(p, { recursive: true, force: true });
+    }
+  }
+};
 const migrations = [
   checkStudioCompatibilityForInitialMigration,
   hideStudioDirWindows,
-  renameProcessManagerHome
+  renameProcessManagerHome,
+  cleanupObsoleteServerFiles
 ];
 export {
   migrations

package/dist/cli/{index-BjzOJKPi.mjs → index-Dhun0W1n.mjs}

@@ -1,17 +1,16 @@
-import { b as getAiSessionsDirectoryForDate, c as buildAiSessionFileName, l as listAiSessions, g as getAiSessionsRootDirectory } from "./paths-CqXGLB7R.mjs";
-import { S as STUDIO_SITES_ROOT, c as createRemoteSiteTools, a as createStudioTools, r as readAuthToken, b as getSnapshotsFromConfig, i as isSnapshotExpired, d as captureCommandOutput, e as runCommand$3, f as runCommand$4, h as chalk, j as getSitesRunningStatus, k as getWpComSites, l as isSiteRunning, o as openBrowser, m as getSiteUrl, n as closeSharedBrowser } from "./index-DRQnCQvM.mjs";
+import { b as getAiSessionsDirectoryForDate, c as buildAiSessionFileName, l as listAiSessions, g as getAiSessionsRootDirectory } from "./paths-D7DniT1Q.mjs";
+import { S as STUDIO_SITES_ROOT, c as createRemoteSiteTools, a as createStudioTools, r as readAuthToken, b as getSnapshotsFromConfig, i as isSnapshotExpired, d as captureCommandOutput, e as runCommand$3, f as runCommand$4, h as chalk, j as getSitesRunningStatus, k as getWpComSites, l as isSiteRunning, o as openBrowser, m as getSiteUrl, n as closeSharedBrowser } from "./index-ul3DeWvy.mjs";
 import { __, sprintf, _n } from "@wordpress/i18n";
 import fs__default from "fs";
 import path__default from "path";
 import { query } from "@anthropic-ai/claude-agent-sdk";
 import os from "os";
-import { l as lockCliConfig, r as readCliConfig, s as saveCliConfig, u as unlockCliConfig, g as updateCliConfigWithPartial } from "./certificate-manager-SVYcCL_i.mjs";
+import { l as lockCliConfig, r as readCliConfig, s as saveCliConfig, u as unlockCliConfig, L as LoggerError, m as updateCliConfigWithPartial, c as Logger, q as setProgressCallback } from "./certificate-manager-v-yNLDFJ.mjs";
 import { password } from "@inquirer/prompts";
-import { L as LoggerError, d as Logger, s as setProgressCallback } from "./well-known-paths-BYA1Bw5o.mjs";
 import crypto from "crypto";
 import fs from "fs/promises";
-import { runCommand as runCommand$1 } from "./login-BtPZeZ4G.mjs";
-import { runCommand as runCommand$2 } from "./logout-Cr631QzG.mjs";
+import { runCommand as runCommand$1 } from "./login-Dz63Zdfn.mjs";
+import { runCommand as runCommand$2 } from "./logout-CLUKQeZh.mjs";
 import { ProcessTerminal, TUI, Container, Loader, CombinedAutocompleteProvider, isKeyRelease, matchesKey, Text, SelectList, Input, Markdown, Editor, visibleWidth, CURSOR_MARKER, truncateToWidth } from "@mariozechner/pi-tui";
 const AI_MODELS = {
   "claude-sonnet-4-6": "Sonnet 4.6",
@@ -357,6 +356,17 @@ Then continue with:
 5. **Check the misuse of HTML blocks**: Verify if HTML blocks were used as sections or not. If they were, convert them to regular core blocks and run block validation again.
 6. **Check the result**: Use take_screenshot to capture the site's landing page on desktop and mobile and verify the design visually on both viewports, check for wrong spacing, alignment, colors, contrast, borders, hover styles and other visual issues. Fix any issues found. Pay particular attention to the navigation menu and the CTA buttons. The design needs to match your original expectations.
 
+## Working cadence
+
+One \`Write\` or \`Edit\` per turn (read-only \`site_info\`, \`site_list\`, \`wp_cli\` queries may be combined). Short prose between tools — no long design-plan essays. The CLI only renders complete assistant messages, so a turn that batches files or emits >~200 lines spins silently for minutes and can hit gateway timeouts. Cadence is also a quality lever: the screenshot-fix loop only works after small visible increments.
+
+**After \`site_create\`** (or "redesign"/"rebuild"/"start over" triggers), the next turn MUST be small: \`site_info\` or a single ≤50-line \`Write\`. Never scaffold a whole theme in one turn.
+
+**Long files (>~200 lines): skeleton first, then fill across Edits.**
+
+- \`style.css\`: skeleton = \`:root { ... }\` custom properties + 6–10 anchor comments \`/* === <concern> === */\` (e.g. \`reset\`, \`typography\`, \`hero\`, \`features\`, \`cta\`, \`footer\`, \`responsive\`), <2KB total. Fill one anchor per Edit (300–2000B each) — \`old_string\` is the anchor line, \`new_string\` is \`<anchor>\\n\\n<styles>\`.
+- Page content: create the page empty (\`wp_cli post create --post_content=""\`), write \`<theme>/page-content.html\` with \`<!-- section:<concern> -->\` anchors (<1KB), fill one anchor per Edit using only core blocks (never wrap in \`core/html\`), then apply once with \`wp_cli post update <id> --post_content-file=<absolute path>\`.
+
 ## Available Studio Tools (prefixed with mcp__studio__)
 
 - site_create: Create a new WordPress site (name only — handles everything automatically)
@@ -373,6 +383,7 @@ Then continue with:
 - validate_blocks: Validate block content for correctness on a running site (runs each block through its save() function in a real browser). Requires a site name or path. Call after every file write/edit that contains block content.
 - take_screenshot: Take a full-page screenshot of a URL (supports desktop and mobile viewports). Use this to visually check the site after building it.
 - need_for_speed: Measure frontend performance metrics (TTFB, FCP, LCP, CLS, page weight, DOM size, JS/CSS/image/font asset breakdown) for a running site. Use this to identify performance bottlenecks and guide optimization.
+- rank_me_up: Run an on-page SEO audit (title/meta tags, headings, image alt text, OpenGraph/Twitter cards, JSON-LD structured data, robots.txt and sitemap.xml availability) for a running site. Use this to identify on-page SEO issues and guide fixes.
 - site_push: Push a local site to a WordPress.com site. Requires authentication (studio auth login). Specify the remote site URL or ID and sync options (all, sqls, uploads, plugins, themes, contents).
 - site_pull: Pull a WordPress.com site to a local site. Requires authentication. Specify the remote site URL or ID and sync options.
 - site_import: Import a backup file (.zip, .tar.gz, .sql, .wpress) into a local site.
@@ -464,7 +475,7 @@ function startAiAgent(config) {
     prompt,
     env,
     model = DEFAULT_MODEL,
-    maxTurns = 50,
+    maxTurns = 75,
     resume,
     autoApprove,
     activeSite,
@@ -579,6 +590,7 @@ function createBaseEnvironment() {
   delete env.ANTHROPIC_BASE_URL;
   delete env.ANTHROPIC_CUSTOM_HEADERS;
   delete env.CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS;
+  delete env.CLAUDE_CODE_MAX_RETRIES;
   if (!env.CLAUDE_CODE_MAX_RETRIES) {
     env.CLAUDE_CODE_MAX_RETRIES = "1";
   }
@@ -596,7 +608,7 @@ const AI_PROVIDER_DEFINITIONS = {
       }
       throw new LoggerError(__("WordPress.com login required. Use /login to authenticate."));
     },
-    resolveEnv: async () => {
+    resolveEnv: async (options) => {
       const inlineToken = readInlineWpcomToken();
       const accessToken = inlineToken ?? (await readAuthToken())?.accessToken;
       if (!accessToken) {
@@ -605,10 +617,15 @@ const AI_PROVIDER_DEFINITIONS = {
       const env = createBaseEnvironment();
       env.ANTHROPIC_BASE_URL = getWpcomAiGatewayBaseUrl();
       env.ANTHROPIC_AUTH_TOKEN = accessToken;
-      env.ANTHROPIC_CUSTOM_HEADERS = buildAnthropicCustomHeaders({
+      const customHeaders = {
         "X-WPCOM-AI-Feature": WPCOM_AI_FEATURE_HEADER
-      });
+      };
+      if (options?.sessionId) {
+        customHeaders["X-WPCOM-Session-ID"] = options.sessionId;
+      }
+      env.ANTHROPIC_CUSTOM_HEADERS = buildAnthropicCustomHeaders(customHeaders);
       env.CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS = "1";
+      env.CLAUDE_CODE_MAX_RETRIES = "0";
       return env;
     }
   },
@@ -698,8 +715,8 @@ async function saveSelectedAiProvider(provider) {
 async function prepareAiProvider(provider, options) {
   await getAiProviderDefinition(provider).prepare(options);
 }
-async function resolveAiEnvironment(provider) {
-  return getAiProviderDefinition(provider).resolveEnv();
+async function resolveAiEnvironment(provider, options) {
+  return getAiProviderDefinition(provider).resolveEnv(options);
 }
 function emitEvent(event) {
   if (typeof process.send === "function") {
@@ -938,15 +955,6 @@ class AiSessionRecorder {
       wpcomSiteId: site.wpcomSiteId
     });
   }
-  async recordEnvironmentSelected(payload) {
-    await this.appendEvent({
-      type: "environment.selected",
-      timestamp: toIsoTimestamp(),
-      environment: payload.environment,
-      url: payload.url,
-      wpcomSiteId: payload.wpcomSiteId
-    });
-  }
   async recordUserMessage(options) {
     await this.appendEvent({
       type: "user.message",
@@ -1033,25 +1041,6 @@ function replaySessionHistory(ui, events) {
         );
         continue;
       }
-      if (event.type === "environment.selected") {
-        const current = ui.activeSite;
-        if (!current) {
-          continue;
-        }
-        const isLive = event.environment === "live";
-        ui.setActiveSite(
-          {
-            name: current.name,
-            path: current.path,
-            running: current.running,
-            remote: isLive,
-            url: isLive ? event.url : void 0,
-            wpcomSiteId: isLive ? event.wpcomSiteId : void 0
-          },
-          { announce: true, emitEvent: false }
-        );
-        continue;
-      }
       if (event.type === "user.message") {
         if (!isVisibleUserMessage(event)) {
           continue;
@@ -1328,7 +1317,8 @@ const AI_CHAT_SLASH_COMMANDS = [
     handler: async () => "break"
   },
   { name: "taxonomist", description: __("Optimize category taxonomy with AI") },
-  { name: "need-for-speed", description: __("Run a performance audit on a site") }
+  { name: "need-for-speed", description: __("Run a performance audit on a site") },
+  { name: "rank-me-up", description: __("Run an on-page SEO audit on a site") }
 ];
 const THINKING_MESSAGES = [
   "Thinking…",
@@ -1792,6 +1782,7 @@ class AiChatUI {
     this.editorVisible = false;
     this.interruptCallback = null;
     this.wasInterrupted = false;
+    this.usageCapReached = false;
     this.hasShownResponseMarker = false;
     this.turnStartTime = 0;
     this.toolStartTime = null;
@@ -2217,15 +2208,16 @@ ${chalk.dim(message)}
     this.refreshPromptChrome();
     const label = site.remote ? sprintf(
       /* translators: %s: site name */
-      __(" ✻ Selected site: %s (WordPress.com)"),
+      __(" Selected site: %s (WordPress.com)"),
       site.name
     ) : sprintf(
       /* translators: %s: site name */
-      __(" ✻ Selected site: %s"),
+      __(" Selected site: %s"),
       site.name
     );
     if (announce) {
-      this.messages.addChild(new Text(`${chalk.hex("#5b8db8")(label)}
+      this.messages.addChild(new Text(`
+${chalk.hex("#8839ef")(label)}
 `, 0, 0));
     }
     if (emitEvent2) {
@@ -2448,7 +2440,7 @@ ${chalk.dim(message)}
     this.tui.start();
   }
   showWelcome() {
-    const version = "1.7.10";
+    const version = "1.7.11";
     const cwd = process.cwd();
     const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
     const displayCwd = home && cwd.startsWith(home) ? "~" + cwd.slice(home.length) : cwd;
@@ -2622,6 +2614,7 @@ ${chalk.dim(message)}
     this.currentResponseText = "";
     this.hasShownResponseMarker = false;
     this.wasInterrupted = false;
+    this.usageCapReached = false;
     this.turnStartTime = this.nowMs();
     this.todoSnapshot = [];
     this.latestTodoSnapshot = [];
@@ -2648,6 +2641,15 @@ ${chalk.dim(message)}
     this.pendingTodoRenders.clear();
     this.pendingTodoRenderOrder = [];
   }
+  /**
+   * Returns true when the current/last turn surfaced the AI usage cap
+   * message to the user. Lets callers suppress redundant downstream
+   * errors (e.g. the SDK's "process exited with code 1" that follows
+   * the upstream 429).
+   */
+  hasErrorBeenSurfaced() {
+    return this.usageCapReached;
+  }
   showOnboarding() {
     const text = " " + chalk.blue("⏺") + " " + sprintf(
       /* translators: %s: product name (WordPress Studio) */
@@ -3113,6 +3115,30 @@ ${chalk.dim(message)}
   handleMessage(message) {
     switch (message.type) {
       case "assistant": {
+        let isCapMessage = false;
+        if (message.error && this.currentProvider === "wpcom") {
+          for (const block of message.message.content) {
+            if (block.type === "text" && /API Error:\s*429/i.test(block.text ?? "")) {
+              isCapMessage = true;
+              break;
+            }
+          }
+        }
+        if (isCapMessage) {
+          this.hideLoader();
+          this.usageCapReached = true;
+          this.showError(
+            __(
+              "AI usage cap reached. You can continue using Studio Code by switching to your own Anthropic API key."
+            )
+          );
+          this.showInfo(
+            __("Use /provider to switch to Anthropic · API key, or try again later.")
+          );
+          this.currentMarkdown = null;
+          this.currentResponseText = "";
+          return void 0;
+        }
         for (const block of message.message.content) {
           if (block.type === "text") {
             this.hideLoader();
@@ -3195,6 +3221,9 @@ ${chalk.dim(message)}
             numTurns: message.num_turns
           };
         }
+        if (this.usageCapReached) {
+          return { type: "result", sessionId: message.session_id, success: false };
+        }
         if (this.wasInterrupted) {
           const thinkingSec2 = Math.round((this.nowMs() - this.turnStartTime) / 1e3);
           this.messages.addChild(
@@ -3466,6 +3495,9 @@ async function runCommand(options) {
   }
   function handleAgentTurnError(error) {
     sessionId = void 0;
+    if (ui instanceof AiChatUI && ui.hasErrorBeenSurfaced()) {
+      return;
+    }
     if (error instanceof LoggerError) {
       ui.showError(error.message);
     } else if (error instanceof Error) {
@@ -3588,7 +3620,10 @@ async function runCommand(options) {
   const MAX_RETRY_ATTEMPTS = 4;
   async function runAgentTurn(prompt, retryAttempt = 0) {
     await maybeAutoSwitchProvider();
-    const env = await resolveAiEnvironment(currentProvider);
+    const recorder = await ensureSessionRecorder();
+    const env = await resolveAiEnvironment(currentProvider, {
+      sessionId: recorder?.sessionId
+    });
     ui.beginAgentTurn();
     let enrichedPrompt = prompt;
     const site = ui.activeSite;
@@ -3608,7 +3643,7 @@ ${prompt}`;
     }
     await persistSessionContext();
     await persist(
-      (recorder) => recorder.recordUserMessage({
+      (recorder2) => recorder2.recordUserMessage({
         text: prompt,
         source: "prompt",
         sitePath: site?.path
@@ -3633,10 +3668,10 @@ ${prompt}`;
       for await (const message of agentQuery) {
         const timestamp = (/* @__PURE__ */ new Date()).toISOString();
         const result = ui.handleMessage(message);
-        await persist((recorder) => recorder.recordSdkMessage(message, timestamp));
+        await persist((recorder2) => recorder2.recordSdkMessage(message, timestamp));
         if (result) {
           sessionId = result.sessionId;
-          await persist((recorder) => recorder.recordAgentSessionId(result.sessionId));
+          await persist((recorder2) => recorder2.recordAgentSessionId(result.sessionId));
           if (result.type === "max_turns") {
             maxTurnsResult = {
               numTurns: result.numTurns
@@ -3654,9 +3689,11 @@ ${prompt}`;
       if (isJsonMode) {
         throw error;
       }
-      ui.showError(getErrorMessage(error));
+      if (!(ui instanceof AiChatUI && ui.hasErrorBeenSurfaced())) {
+        ui.showError(getErrorMessage(error));
+      }
     } finally {
-      await persist((recorder) => recorder.recordTurnClosed(turnStatus));
+      await persist((recorder2) => recorder2.recordTurnClosed(turnStatus));
       ui.endAgentTurn();
     }
     if (maxTurnsResult) {
@@ -3682,7 +3719,8 @@ ${prompt}`;
         return runAgentTurn("Continue from where you left off.");
       }
     }
-    if (turnStatus === "error" && !isJsonMode) {
+    const hasTerminalError = ui instanceof AiChatUI && ui.hasErrorBeenSurfaced();
+    if (turnStatus === "error" && !isJsonMode && !hasTerminalError) {
       if (retryAttempt >= MAX_RETRY_ATTEMPTS) {
         ui.showInfo(
           __("The server has not recovered after multiple attempts. Please try again later.")