ponzu 1.71.0 → 1.71.2

package/dist/index.js

@@ -6978,7 +6978,7 @@ var require_dist = __commonJS(function(exports, module) {
 // apps/cli/src/index.ts
 import { existsSync as existsSync13 } from "fs";
 import { networkInterfaces } from "os";
-import { dirname as dirname12, isAbsolute as isAbsolute4, join as join20, resolve as resolve5 } from "path";
+import { dirname as dirname13, isAbsolute as isAbsolute4, join as join21, resolve as resolve5 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { parseArgs } from "util";
 
@@ -33328,7 +33328,7 @@ When to watch: whenever the person might react to the work on the canvas. That's
 
 Watching doesn't cut you off from chat. A message the person types reaches you as soon as the current wait returns, within a minute. To tell them something (here's the link, which option you'd pick), write it in chat, then keep watching.
 
-1. listen: wait_for_activity with the cursor from your last call. Start with types comment.created, comment.replied, comment.edited, file.changed. An edit replaces what the comment asks; work from the new text. If the wait says Ponzu restarted or lost track, it lists the open threads waiting on you instead: work through those, then carry on with the cursor it gives. The wait hears from every file you've worked in this session and names the file for any event outside the one you passed: pass that file when you act on it.
+1. listen: wait_for_activity with the cursor from your last call. Start with types comment.created, comment.replied, comment.edited, file.changed. An edit replaces what the comment asks; work from the new text. If the wait says Ponzu restarted or lost track, it lists the open threads waiting on you instead: work through those, then carry on with the cursor it gives. If it says Ponzu stopped and isn't back yet, nothing was checked: wait again with the cursor it gives, as Ponzu is most likely restarting into an update. The wait hears from every file you've worked in this session and names the file for any event outside the one you passed: pass that file when you act on it.
 2. triage each comment:
    - change ("make this bigger", "try blue"): do it.
    - question ("why this font?"): reply with an answer, leave it open.
@@ -33422,6 +33422,7 @@ See it
 
 What the person sees
 - On their canvas, the load plays once when the artboard appears: when they open its page, and each time you edit it. Then a finite animation holds its end. Hovering or clicking the artboard doesn't replay it, so never tell them it will.
+- Their canvas plays what record shows. It holds motion still on purpose: while its window is in the background on battery, while they pan across a crowded page, for parts too small to see at their zoom, and for loops longer than 20 s on an artboard zoomed far out. If record shows the motion working and they say it doesn't play, tell the Ponzu team with send_feedback instead of reworking the design.
 - A hint that fades out ends hidden, so the canvas shows nothing once it has played.
 - When they need to watch the motion (an entrance to review, a hint that leaves), put a looping copy on an artboard beside the real one: animation-iteration-count: infinite, with a beat of about a second held at the end of the keyframes so each cycle reads as one play. Keep the real one finite, and say which is which in a note.
 - If the motion answers something the person does, put it on :hover or :focus, so they can set it off themselves.
@@ -33541,7 +33542,7 @@ var listenTools = [
     title: "Wait for activity",
     group: "listen",
     readOnly: true,
-    description: "Watch the canvas. Call this instead of ending your turn whenever the person might react to your work there: after you put something up for review, or while you design together. Calling it again and again is the loop (get_guide('watch')). Long-polls for what people do in the canvas: new comments and replies, edits made in a text editor, other agents' changes, in this file and the others you've worked in this session, saying which file each is in. Returns immediately if anything happened after `since`; otherwise waits up to `timeout` seconds. Pass back the returned cursor next time so nothing is missed. If Ponzu restarted or lost track since then, it returns at once with the open threads waiting on you. The person's chat messages still reach you between waits.",
+    description: "Watch the canvas. Call this instead of ending your turn whenever the person might react to your work there: after you put something up for review, or while you design together. Calling it again and again is the loop (get_guide('watch')). Long-polls for what people do in the canvas: new comments and replies, edits made in a text editor, other agents' changes, in this file and the others you've worked in this session, saying which file each is in. Returns immediately if anything happened after `since`; otherwise waits up to `timeout` seconds. Pass back the returned cursor next time so nothing is missed. If Ponzu restarts during the wait, the wait carries on once it's back. If it restarted or lost track before you waited, it returns at once with the open threads waiting on you: handle those, then keep watching with the cursor it gives. The person's chat messages still reach you between waits.",
     input: {
       file: fileArg,
       since: number2().int().min(0).optional().describe("Cursor from the last call. Omit to start from now."),
@@ -33570,7 +33571,7 @@ var listenTools = [
         const waiting = waitingText(files, all);
         return {
           text: `${GAP_NOTE[gap]} ${waiting.text}
-Wait again with cursor=${next}.`,
+Keep watching: wait again with cursor=${next}.`,
           data: { cursor: next, events: [], gap, waiting: waiting.ids },
           metrics: { cursor: gap, events: 0, scope_files: files.length }
         };
@@ -36772,6 +36773,7 @@ data:
 
 // packages/mcp/src/index.ts
 var FILES_META = "ponzu.design/files";
+var WAIT_META = "ponzu.design/wait";
 function clientKind(name = "") {
   const n = name.toLowerCase();
   if (n.includes("claude"))
@@ -36840,7 +36842,7 @@ function createMcpServer(ws, opts = {}) {
         destructiveHint: def.destructive ?? false,
         openWorldHint: false
       }
-    }, async (args, extra) => toMcp(await runTool(def, args, { ws, caller: getCaller(), signal: extra.signal, session }), session));
+    }, async (args, extra) => toMcp(await runTool(def, args, { ws, caller: getCaller(), signal: extra.signal, session }), session, def.name));
   }
   for (const [topic, text] of Object.entries(GUIDES)) {
     server.registerResource(`guide-${topic}`, `ponzu://guide/${topic}`, { title: `Ponzu guide: ${topic}`, mimeType: "text/markdown" }, async (uri) => ({ contents: [{ uri: uri.href, mimeType: "text/markdown", text }] }));
@@ -36879,13 +36881,19 @@ Read get_guide('basics'). Write the brief and your direction to a note, set toke
   }));
   return server;
 }
-function toMcp(r, session) {
+function toMcp(r, session, tool) {
   const content = [];
   for (const img of r.images ?? [])
     content.push({ type: "image", data: img.data, mimeType: img.mime });
   content.push({ type: "text", text: r.text });
-  const files = session.files?.length ? { _meta: { [FILES_META]: session.files } } : {};
-  return { content, isError: r.isError, ...files };
+  const meta = {};
+  if (session.files?.length)
+    meta[FILES_META] = session.files;
+  if (tool === "wait_for_activity" && r.data) {
+    const { cursor, gap, waiting } = r.data;
+    meta[WAIT_META] = { cursor, ...gap ? { gap, waiting: waiting?.length ?? 0 } : {} };
+  }
+  return { content, isError: r.isError, ...Object.keys(meta).length ? { _meta: meta } : {} };
 }
 function createHttpHandler(ws, opts = {}) {
   const sessions = new Map;
@@ -37084,6 +37092,7 @@ function onBodyDone(res, done) {
 
 // packages/mcp/src/bridge.ts
 var CALL_TIMEOUT = 15 * 60000;
+var RESTART_GRACE = 1e4;
 var readOnly = new Set(tools.filter((t) => t.readOnly).map((t) => t.name));
 async function serveBridge(opts, transport = new StdioServerTransport) {
   const server = new Server({ name: opts.name ?? "ponzu", version: opts.version ?? "0.1.0", title: "Ponzu" }, {
@@ -37213,19 +37222,70 @@ async function serveBridge(opts, transport = new StdioServerTransport) {
       return fn(await localClient(), extra.signal);
     }
   };
-  server.setRequestHandler(CallToolRequestSchema, async (req, extra) => {
-    const name = req.params.name;
-    const args = req.params.arguments ?? {};
-    const params = { ...req.params, arguments: opts.mapArgs ? opts.mapArgs(name, args) : args };
-    const options = { signal: extra.signal, timeout: CALL_TIMEOUT };
+  const hostBack = async (until, signal) => {
+    const giveUp = Math.min(until, Date.now() + (opts.restartGrace ?? RESTART_GRACE));
+    while (!signal.aborted) {
+      if (await opts.findHost(false).catch(() => null))
+        return true;
+      if (Date.now() >= giveUp)
+        return false;
+      await new Promise((r) => setTimeout(r, 250));
+    }
+    return false;
+  };
+  const waitThrough = async (params, signal) => {
+    const { since, timeout } = params.arguments ?? {};
+    const deadline = Date.now() + (typeof timeout === "number" ? timeout : 60) * 1000;
+    const left = () => Math.max(0, Math.ceil((deadline - Date.now()) / 1000));
+    const withArgs = (more) => ({
+      ...params,
+      arguments: { ...params.arguments, ...more }
+    });
+    let cutOff = false;
+    const result = await call(params, signal, async () => {
+      cutOff = true;
+      if (!await hostBack(deadline, signal) && Date.now() >= deadline)
+        return null;
+      return withArgs({ timeout: left() });
+    });
+    if (!result) {
+      const again = typeof since === "number" ? `Wait again with cursor=${since}` : "Wait again";
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Ponzu stopped while you waited and isn't back yet, so nothing was checked. ${again}: it's most likely restarting into an update.`
+          }
+        ]
+      };
+    }
+    const wait = result._meta?.[WAIT_META];
+    if (!cutOff || wait?.gap !== "restart" || wait.waiting || !left())
+      return result;
+    const again = await call(withArgs({ since: wait.cursor, timeout: left() }), signal);
+    const first = again.content.findIndex((c) => c.type === "text");
+    return {
+      ...again,
+      content: again.content.map((c, i) => i === first && c.type === "text" ? {
+        ...c,
+        text: `Ponzu restarted while you waited, with nothing waiting on you.
+${c.text}`
+      } : c)
+    };
+  };
+  const call = async (params, signal, cutOff) => {
+    const name = params.name;
+    let sent = params;
+    let ridden = cutOff;
+    const options = { signal, timeout: CALL_TIMEOUT };
     for (let attempt = 0;attempt < 2; attempt++) {
       const client = await hostClient();
       if (!client)
         break;
       try {
-        return remember(await using(client, () => client.request({ method: "tools/call", params }, CallToolResultSchema, options)));
+        return remember(await using(client, () => client.request({ method: "tools/call", params: sent }, CallToolResultSchema, options)));
       } catch (err) {
-        if (extra.signal.aborted || err instanceof McpError && err.code !== ErrorCode.ConnectionClosed)
+        if (signal.aborted || err instanceof McpError && err.code !== ErrorCode.ConnectionClosed)
           throw err;
         await dropHost(client);
         if (!neverArrived(err) && !readOnly.has(name)) {
@@ -37239,10 +37299,27 @@ async function serveBridge(opts, transport = new StdioServerTransport) {
             isError: true
           };
         }
+        if (ridden && !neverArrived(err)) {
+          const next = await ridden();
+          if (!next)
+            return null;
+          sent = next;
+          ridden = undefined;
+        }
       }
     }
+    if (sent !== params)
+      return null;
     await opts.prepareLocal?.();
-    return remember(await (await localClient()).request({ method: "tools/call", params }, CallToolResultSchema, options));
+    return remember(await (await localClient()).request({ method: "tools/call", params: sent }, CallToolResultSchema, options));
+  };
+  server.setRequestHandler(CallToolRequestSchema, async (req, extra) => {
+    const name = req.params.name;
+    const args = req.params.arguments ?? {};
+    const params = { ...req.params, arguments: opts.mapArgs ? opts.mapArgs(name, args) : args };
+    if (name === "wait_for_activity")
+      return waitThrough(params, extra.signal);
+    return await call(params, extra.signal);
   });
   server.setRequestHandler(ListToolsRequestSchema, (req, extra) => list((c, signal) => c.listTools(req.params, { signal }))(req, extra));
   server.setRequestHandler(ListResourcesRequestSchema, (req, extra) => list((c, signal) => c.listResources(req.params, { signal }))(req, extra));
@@ -47639,7 +47716,7 @@ function remoteUpdater(endpoint, token) {
 // apps/cli/package.json
 var package_default = {
   name: "ponzu",
-  version: "1.71.0",
+  version: "1.71.2",
   description: "The open source canvas your agent draws on in HTML and CSS.",
   type: "module",
   license: "MIT",
@@ -47662,17 +47739,40 @@ var package_default = {
 
 // apps/cli/src/host.ts
 import { spawn as spawn6 } from "child_process";
-import { existsSync as existsSync9, readFileSync as readFileSync2, statSync as statSync3 } from "fs";
+import { existsSync as existsSync9, readFileSync as readFileSync3, statSync as statSync3 } from "fs";
 import { chmod, copyFile, mkdir as mkdir11, rename as rename9, rm as rm5, utimes as utimes3, writeFile as writeFile9 } from "fs/promises";
+import { homedir as homedir6 } from "os";
+import { dirname as dirname7, join as join15, posix, win32 } from "path";
+
+// packages/server/src/updating.ts
+import { mkdirSync as mkdirSync2, readFileSync as readFileSync2, renameSync as renameSync2, rmSync, writeFileSync } from "fs";
 import { homedir as homedir5 } from "os";
-import { dirname as dirname6, join as join14, posix, win32 } from "path";
-var ponzuHome = () => process.env.PONZU_HOME ?? join14(homedir5(), ".ponzu");
-var hostFile = () => join14(ponzuHome(), "host.json");
+import { dirname as dirname6, join as join14 } from "path";
+var UPDATING_WITHIN = 2 * 60000;
+var updatingFile = () => join14(process.env.PONZU_HOME ?? join14(homedir5(), ".ponzu"), "updating.json");
+function read() {
+  try {
+    const u = JSON.parse(readFileSync2(updatingFile(), "utf8"));
+    if (typeof u.from !== "string" || typeof u.to !== "string" || typeof u.at !== "number")
+      return null;
+    return { from: u.from, to: u.to, at: u.at, ...u.told ? { told: true } : {} };
+  } catch {
+    return null;
+  }
+}
+function updating(now = Date.now()) {
+  const u = read();
+  return u && now - u.at < UPDATING_WITHIN ? u : null;
+}
+
+// apps/cli/src/host.ts
+var ponzuHome = () => process.env.PONZU_HOME ?? join15(homedir6(), ".ponzu");
+var hostFile = () => join15(ponzuHome(), "host.json");
 async function announceHost(url, opts = {}) {
   if (!opts.takeOver && await runningHost())
     return async () => {};
   const path = hostFile();
-  await mkdir11(dirname6(path), { recursive: true });
+  await mkdir11(dirname7(path), { recursive: true });
   const me = { url, mcp: `${url}/mcp`, pid: process.pid };
   await writeFile9(path, `${JSON.stringify(me)}
 `);
@@ -47683,7 +47783,7 @@ async function announceHost(url, opts = {}) {
 }
 function readHost() {
   try {
-    return JSON.parse(readFileSync2(hostFile(), "utf8"));
+    return JSON.parse(readFileSync3(hostFile(), "utf8"));
   } catch {
     return null;
   }
@@ -47702,11 +47802,11 @@ async function runningHost() {
 }
 var SERVER = "Contents/Resources/server/ponzu";
 var pathFor = (os) => os === "win32" ? win32 : posix;
-var appImageServer = () => join14(ponzuHome(), "app/ponzu");
-var appImageRecord = () => join14(ponzuHome(), "app/appimage");
+var appImageServer = () => join15(ponzuHome(), "app/ponzu");
+var appImageRecord = () => join15(ponzuHome(), "app/appimage");
 function recordedAppImage() {
   try {
-    const path = readFileSync2(appImageRecord(), "utf8").trim();
+    const path = readFileSync3(appImageRecord(), "utf8").trim();
     return path && existsSync9(path) ? path : null;
   } catch {
     return null;
@@ -47721,7 +47821,7 @@ function isFolder(app) {
 }
 function appServer(app, os = process.platform) {
   if (os === "darwin")
-    return join14(app, SERVER);
+    return join15(app, SERVER);
   const path = pathFor(os);
   if (os === "linux" && !isFolder(app))
     return appImageServer();
@@ -47754,7 +47854,7 @@ function ownBundle(execPath = process.execPath, os = process.platform, env = pro
 }
 function installedApps(os = process.platform, env = process.env) {
   if (os === "darwin")
-    return ["/Applications/Ponzu.app", join14(homedir5(), "Applications/Ponzu.app")];
+    return ["/Applications/Ponzu.app", join15(homedir6(), "Applications/Ponzu.app")];
   if (os === "win32") {
     return [
       env.LOCALAPPDATA && win32.join(env.LOCALAPPDATA, "Programs", "ponzu"),
@@ -47787,7 +47887,7 @@ async function adoptAppImage(execPath = process.execPath, os = process.platform,
   const from = statSync3(execPath);
   const to = statSync3(copy, { throwIfNoEntry: false });
   if (!to || to.size !== from.size || Math.trunc(to.mtimeMs) !== Math.trunc(from.mtimeMs)) {
-    await mkdir11(dirname6(copy), { recursive: true });
+    await mkdir11(dirname7(copy), { recursive: true });
     const temp = `${copy}.${process.pid}`;
     await copyFile(execPath, temp);
     await chmod(temp, 493);
@@ -47802,7 +47902,7 @@ async function adoptAppImage(execPath = process.execPath, os = process.platform,
 async function launchApp(app, timeoutMs = 30000) {
   const deadline = Date.now() + timeoutMs;
   for (let tick = 0;Date.now() < deadline; tick++) {
-    if (tick % 40 === 0)
+    if (tick % 40 === 0 && !updating())
       startApp(app);
     const url = await runningHost();
     if (url)
@@ -47851,7 +47951,7 @@ async function findHost(launch) {
     lastFailed = Date.now();
   return url;
 }
-var shimPath = (os = process.platform) => join14(ponzuHome(), os === "win32" ? "bin/ponzu.cmd" : "bin/ponzu");
+var shimPath = (os = process.platform) => join15(ponzuHome(), os === "win32" ? "bin/ponzu.cmd" : "bin/ponzu");
 function shimScript(app, os = process.platform) {
   if (os === "win32") {
     const candidates = [
@@ -47896,7 +47996,7 @@ exit 1
 }
 async function writeShim(app) {
   const path = shimPath();
-  await mkdir11(dirname6(path), { recursive: true });
+  await mkdir11(dirname7(path), { recursive: true });
   await writeFile9(path, shimScript(app));
   await chmod(path, 493);
   return path;
@@ -47904,28 +48004,28 @@ async function writeShim(app) {
 
 // apps/cli/src/install.ts
 import { spawnSync as spawnSync2 } from "child_process";
-import { existsSync as existsSync11, readFileSync as readFileSync4 } from "fs";
+import { existsSync as existsSync11, readFileSync as readFileSync5 } from "fs";
 import { mkdir as mkdir13, writeFile as writeFile11 } from "fs/promises";
-import { homedir as homedir7 } from "os";
-import { delimiter as delimiter2, dirname as dirname8, join as join16 } from "path";
+import { homedir as homedir8 } from "os";
+import { delimiter as delimiter2, dirname as dirname9, join as join17 } from "path";
 
 // apps/cli/src/command.ts
 import { spawnSync } from "child_process";
-import { accessSync, constants, existsSync as existsSync10, lstatSync, readFileSync as readFileSync3, realpathSync as realpathSync3 } from "fs";
+import { accessSync, constants, existsSync as existsSync10, lstatSync, readFileSync as readFileSync4, realpathSync as realpathSync3 } from "fs";
 import { mkdir as mkdir12, symlink, writeFile as writeFile10 } from "fs/promises";
-import { homedir as homedir6 } from "os";
-import { delimiter, dirname as dirname7, join as join15 } from "path";
-function commandDirs(home = homedir6()) {
-  return [join15(home, ".local/bin"), join15(home, "bin"), "/usr/local/bin"];
+import { homedir as homedir7 } from "os";
+import { delimiter, dirname as dirname8, join as join16 } from "path";
+function commandDirs(home = homedir7()) {
+  return [join16(home, ".local/bin"), join16(home, "bin"), "/usr/local/bin"];
 }
-var stateFile = () => join15(ponzuHome(), "command.json");
+var stateFile = () => join16(ponzuHome(), "command.json");
 async function linkCommand(shim, opts) {
   const say = (s) => {
     if (!opts.auto)
       console.log(s);
   };
   if (process.platform === "win32")
-    return addToUserPath(dirname7(shim), opts.auto, say);
+    return addToUserPath(dirname8(shim), opts.auto, say);
   const found = Bun.which("ponzu", { PATH: opts.path.join(delimiter) });
   const app = found && opensApp(found) ? found : null;
   if (found && !app) {
@@ -47936,16 +48036,16 @@ async function linkCommand(shim, opts) {
   const state = readState();
   if (opts.auto && state.linked)
     return;
-  const before = app ? opts.path.indexOf(dirname7(app)) : -1;
+  const before = app ? opts.path.indexOf(dirname8(app)) : -1;
   const dir = commandDirs(opts.home).find((d) => {
     const at = opts.path.indexOf(d);
     return at >= 0 && (before < 0 || at < before) && canLink(d, opts.home);
   });
   if (!dir) {
-    say(process.platform === "darwin" ? `To run ponzu from a terminal, add ${dirname7(shim)} to your PATH, or choose Install Terminal Command in Ponzu's app menu.` : `To run ponzu from a terminal, add ${dirname7(shim)} to your PATH.`);
+    say(process.platform === "darwin" ? `To run ponzu from a terminal, add ${dirname8(shim)} to your PATH, or choose Install Terminal Command in Ponzu's app menu.` : `To run ponzu from a terminal, add ${dirname8(shim)} to your PATH.`);
     return;
   }
-  const link = join15(dir, "ponzu");
+  const link = join16(dir, "ponzu");
   try {
     await mkdir12(dir, { recursive: true });
     await symlink(shim, link);
@@ -47953,7 +48053,7 @@ async function linkCommand(shim, opts) {
     say(`Couldn't link ponzu into ${dir}.`);
     return;
   }
-  await mkdir12(dirname7(stateFile()), { recursive: true });
+  await mkdir12(dirname8(stateFile()), { recursive: true });
   await writeFile10(stateFile(), `${JSON.stringify({ linked: link }, null, 2)}
 `);
   say(`Linked ${link}, so ponzu runs from a terminal.`);
@@ -47992,21 +48092,21 @@ async function addToUserPath(dir, auto, say) {
     return;
   if (userPath(dir, true) !== "added")
     return say(`Couldn't add ${dir} to your PATH. Add it yourself to run ponzu from a terminal.`);
-  await mkdir12(dirname7(stateFile()), { recursive: true });
+  await mkdir12(dirname8(stateFile()), { recursive: true });
   await writeFile10(stateFile(), `${JSON.stringify({ linked: dir }, null, 2)}
 `);
   say(`Added ${dir} to your PATH. Open a new terminal and run ponzu.`);
 }
 function readState() {
   try {
-    return JSON.parse(readFileSync3(stateFile(), "utf8"));
+    return JSON.parse(readFileSync4(stateFile(), "utf8"));
   } catch {
     return {};
   }
 }
-function canLink(dir, home = homedir6()) {
+function canLink(dir, home = homedir7()) {
   try {
-    lstatSync(join15(dir, "ponzu"));
+    lstatSync(join16(dir, "ponzu"));
     return false;
   } catch {}
   if (!existsSync10(dir))
@@ -48020,7 +48120,7 @@ function canLink(dir, home = homedir6()) {
 }
 function opensApp(file) {
   try {
-    return existsSync10(join15(dirname7(realpathSync3(file)), "resources/server/ponzu"));
+    return existsSync10(join16(dirname8(realpathSync3(file)), "resources/server/ponzu"));
   } catch {
     return false;
   }
@@ -48040,7 +48140,7 @@ var AGENTS = [
     label: "Claude Code",
     detect: () => Boolean(which("claude")),
     current: () => {
-      const config = readJson(join16(homedir7(), ".claude.json"));
+      const config = readJson(join17(homedir8(), ".claude.json"));
       return toEntry(config?.mcpServers?.ponzu);
     },
     register(entry) {
@@ -48090,7 +48190,7 @@ var AGENTS = [
   {
     id: "cursor",
     label: "Cursor",
-    detect: () => existsSync11(join16(homedir7(), ".cursor")),
+    detect: () => existsSync11(join17(homedir8(), ".cursor")),
     current: () => {
       const config = readJson(cursorConfig());
       return toEntry(config?.mcpServers?.ponzu);
@@ -48108,7 +48208,7 @@ var AGENTS = [
         config = parsed;
       }
       config.mcpServers = { ...config.mcpServers, ponzu: entry };
-      await mkdir13(dirname8(path), { recursive: true });
+      await mkdir13(dirname9(path), { recursive: true });
       await writeFile11(path, `${JSON.stringify(config, null, 2)}
 `);
       return true;
@@ -48177,7 +48277,7 @@ function agentStatus() {
 }
 function codexConfigured() {
   try {
-    return /^\[mcp_servers\.ponzu\]/m.test(readFileSync4(join16(process.env.CODEX_HOME ?? join16(homedir7(), ".codex"), "config.toml"), "utf8"));
+    return /^\[mcp_servers\.ponzu\]/m.test(readFileSync5(join17(process.env.CODEX_HOME ?? join17(homedir8(), ".codex"), "config.toml"), "utf8"));
   } catch {
     return false;
   }
@@ -48221,22 +48321,22 @@ function shouldAutoRegister(current, setUpBefore) {
 function isLegacy(e) {
   return "url" in e && /^http:\/\/(127\.0\.0\.1|localhost):7777\/mcp\/?$/.test(e.url);
 }
-var doneFile = () => join16(ponzuHome(), "agents.json");
+var doneFile = () => join17(ponzuHome(), "agents.json");
 function readDone() {
   const raw = readJson(doneFile());
   return new Set(raw?.configured ?? []);
 }
 async function writeDone(done) {
-  await mkdir13(dirname8(doneFile()), { recursive: true });
+  await mkdir13(dirname9(doneFile()), { recursive: true });
   await writeFile11(doneFile(), `${JSON.stringify({ configured: [...done].sort() }, null, 2)}
 `);
 }
 function cursorConfig() {
-  return join16(homedir7(), ".cursor", "mcp.json");
+  return join17(homedir8(), ".cursor", "mcp.json");
 }
 function readJson(path) {
   try {
-    return JSON.parse(readFileSync4(path, "utf8"));
+    return JSON.parse(readFileSync5(path, "utf8"));
   } catch {
     return null;
   }
@@ -48245,13 +48345,13 @@ var searchPath;
 function agentPath() {
   if (searchPath !== undefined)
     return searchPath;
-  const home = homedir7();
+  const home = homedir8();
   const dirs = [
     ...(process.env.PATH ?? "").split(delimiter2),
-    join16(home, ".local/bin"),
-    join16(home, ".claude/local"),
-    join16(home, ".bun/bin"),
-    join16(home, ".npm-global/bin"),
+    join17(home, ".local/bin"),
+    join17(home, ".claude/local"),
+    join17(home, ".bun/bin"),
+    join17(home, ".npm-global/bin"),
     "/opt/homebrew/bin",
     "/usr/local/bin",
     ...loginPath()
@@ -48311,13 +48411,13 @@ function run(cmd, quiet = false) {
 // apps/cli/src/source.ts
 import { createHash as createHash5 } from "crypto";
 import { existsSync as existsSync12 } from "fs";
-import { dirname as dirname9, join as join17, sep as sep4 } from "path";
+import { dirname as dirname10, join as join18, sep as sep4 } from "path";
 import { fileURLToPath } from "url";
 function sourceCheckout(file = fileURLToPath(import.meta.url)) {
   if (file.startsWith("/$bunfs/") || file.split(sep4).includes("node_modules"))
     return null;
-  for (let dir = dirname9(file);dir !== dirname9(dir); dir = dirname9(dir))
-    if (existsSync12(join17(dir, ".git")))
+  for (let dir = dirname10(file);dir !== dirname10(dir); dir = dirname10(dir))
+    if (existsSync12(join18(dir, ".git")))
       return dir;
   return null;
 }
@@ -48355,13 +48455,13 @@ function firstFree(ports, hostname) {
 
 // apps/cli/src/telemetry.ts
 import { createHash as createHash6, randomUUID } from "crypto";
-import { readFileSync as readFileSync5 } from "fs";
+import { readFileSync as readFileSync6 } from "fs";
 import { mkdir as mkdir14, rename as rename10, writeFile as writeFile12 } from "fs/promises";
 import { arch, platform as platform2 } from "os";
-import { dirname as dirname11, join as join18 } from "path";
+import { dirname as dirname12, join as join19 } from "path";
 
 // node_modules/.bun/posthog-node@5.56.2/node_modules/posthog-node/dist/extensions/error-tracking/modifiers/module.node.mjs
-import { dirname as dirname10, posix as posix2, sep as sep5 } from "path";
+import { dirname as dirname11, posix as posix2, sep as sep5 } from "path";
 function createModulerModifier() {
   const getModuleFromFileName = createGetModuleFromFilename();
   return async (frames) => {
@@ -48370,7 +48470,7 @@ function createModulerModifier() {
     return frames;
   };
 }
-function createGetModuleFromFilename(basePath = process.argv[1] ? dirname10(process.argv[1]) : process.cwd(), isWindows = sep5 === "\\") {
+function createGetModuleFromFilename(basePath = process.argv[1] ? dirname11(process.argv[1]) : process.cwd(), isWindows = sep5 === "\\") {
   const normalizedBase = isWindows ? normalizeWindowsPath(basePath) : basePath;
   return (filename) => {
     if (!filename)
@@ -57650,17 +57750,17 @@ var CATEGORY = {
   praise: "Praise",
   other: "Other"
 };
-var settingsFile = () => join18(ponzuHome(), "telemetry.json");
+var settingsFile = () => join19(ponzuHome(), "telemetry.json");
 function readSettings() {
   try {
-    return JSON.parse(readFileSync5(settingsFile(), "utf8"));
+    return JSON.parse(readFileSync6(settingsFile(), "utf8"));
   } catch (err) {
     return err.code === "ENOENT" ? {} : null;
   }
 }
 async function writeSettings(settings) {
   const path = settingsFile();
-  await mkdir14(dirname11(path), { recursive: true });
+  await mkdir14(dirname12(path), { recursive: true });
   const tmp = `${path}.${process.pid}.tmp`;
   await writeFile12(tmp, `${JSON.stringify(settings, null, 2)}
 `);
@@ -57836,14 +57936,14 @@ async function telemetryCommand(arg = "status") {
 // apps/cli/src/wake.ts
 import { dlopen, FFIType, ptr } from "bun:ffi";
 import { spawnSync as spawnSync3 } from "child_process";
-import { fstatSync, readFileSync as readFileSync6 } from "fs";
+import { fstatSync, readFileSync as readFileSync7 } from "fs";
 import { mkdir as mkdir15, rm as rm6, writeFile as writeFile13 } from "fs/promises";
-import { homedir as homedir8 } from "os";
-import { join as join19 } from "path";
+import { homedir as homedir9 } from "os";
+import { join as join20 } from "path";
 var WAKE_LABEL = "design.ponzu.app.wake";
 var WAKE_PORT = 7778;
-var agentsDir = () => process.env.PONZU_LAUNCH_AGENTS ?? join19(homedir8(), "Library/LaunchAgents");
-var wakePlistPath = () => join19(agentsDir(), `${WAKE_LABEL}.plist`);
+var agentsDir = () => process.env.PONZU_LAUNCH_AGENTS ?? join20(homedir9(), "Library/LaunchAgents");
+var wakePlistPath = () => join20(agentsDir(), `${WAKE_LABEL}.plist`);
 var xml = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 function wakePlist(program, port = WAKE_PORT) {
   return `<?xml version="1.0" encoding="UTF-8"?>
@@ -57885,7 +57985,7 @@ async function installWake(program, run = launchctl) {
   const plist = wakePlist(program);
   let current = null;
   try {
-    current = readFileSync6(path, "utf8");
+    current = readFileSync7(path, "utf8");
   } catch {}
   if (current === plist && run(["print", `${domain()}/${WAKE_LABEL}`]))
     return false;
@@ -57899,7 +57999,7 @@ async function uninstallWake(run = launchctl) {
   run(["bootout", `${domain()}/${WAKE_LABEL}`]);
   await rm6(wakePlistPath(), { force: true });
 }
-var systemdDir = () => process.env.PONZU_SYSTEMD_USER ?? join19(process.env.XDG_CONFIG_HOME || join19(homedir8(), ".config"), "systemd/user");
+var systemdDir = () => process.env.PONZU_SYSTEMD_USER ?? join20(process.env.XDG_CONFIG_HOME || join20(homedir9(), ".config"), "systemd/user");
 var WAKE_SOCKET = "ponzu-wake.socket";
 var WAKE_SERVICE = "ponzu-wake@.service";
 var systemdWord = (s) => `"${s.replace(/[\\"]/g, "\\$&").replace(/%/g, "%%").replace(/\$/g, "$$$$")}"`;
@@ -57933,7 +58033,7 @@ async function installSystemdWake(program, run = systemctl) {
   const units = wakeUnits(program);
   const current = Object.entries(units).every(([name, text]) => {
     try {
-      return readFileSync6(join19(systemdDir(), name), "utf8") === text;
+      return readFileSync7(join20(systemdDir(), name), "utf8") === text;
     } catch {
       return false;
     }
@@ -57942,7 +58042,7 @@ async function installSystemdWake(program, run = systemctl) {
     return false;
   await mkdir15(systemdDir(), { recursive: true });
   for (const [name, text] of Object.entries(units))
-    await writeFile13(join19(systemdDir(), name), text);
+    await writeFile13(join20(systemdDir(), name), text);
   run(["daemon-reload"]);
   run(["enable", WAKE_SOCKET]);
   run(["restart", WAKE_SOCKET]);
@@ -57951,7 +58051,7 @@ async function installSystemdWake(program, run = systemctl) {
 async function uninstallSystemdWake(run = systemctl) {
   run(["disable", "--now", WAKE_SOCKET]);
   for (const name of [WAKE_SOCKET, WAKE_SERVICE])
-    await rm6(join19(systemdDir(), name), { force: true });
+    await rm6(join20(systemdDir(), name), { force: true });
   run(["daemon-reload"]);
 }
 function peerKind(ip) {
@@ -58116,7 +58216,7 @@ function lsofPeer() {
 
 // apps/cli/src/index.ts
 var VERSION2 = package_default.version;
-var here = dirname12(fileURLToPath2(import.meta.url));
+var here = dirname13(fileURLToPath2(import.meta.url));
 var HELP = `Ponzu ${VERSION2}: the open source canvas your agent draws on in HTML and CSS.
 
 Usage
@@ -58241,7 +58341,7 @@ async function openWorkspace(files, log) {
   const paths = files.length ? files.map((f) => resolve5(f)) : await findDesigns(process.cwd());
   const named = [];
   for (const p of paths) {
-    if (!existsSync13(join20(p, "design.json")) && existsSync13(p) === false && files.length) {
+    if (!existsSync13(join21(p, "design.json")) && existsSync13(p) === false && files.length) {
       log(`Creating ${p}`);
     }
     const { key } = await ws.open(p);
@@ -58253,7 +58353,8 @@ async function openWorkspace(files, log) {
   telemetry?.capture("host started", {
     launched_by: process.env.PONZU_LAUNCHED_BY ?? "person",
     designs: ws.designs().length,
-    renderer: Boolean(renderer)
+    renderer: Boolean(renderer),
+    ...process.env.PONZU_UPDATE ? { update: process.env.PONZU_UPDATE } : {}
   });
   return { ws, telemetry, named };
 }
@@ -58267,14 +58368,14 @@ async function runServe(files, o) {
     root: process.cwd(),
     tailnet: o.tailnet,
     tailnetPort: 7777,
-    dbFile: join20(ponzuHome(), "ponzu.db"),
-    stateFile: join20(ponzuHome(), "catalog.json"),
+    dbFile: join21(ponzuHome(), "ponzu.db"),
+    stateFile: join21(ponzuHome(), "catalog.json"),
     spotlight: process.env.PONZU_SPOTLIGHT === "0" ? false : undefined,
     agents: async () => agents(),
     suggest: {
       bin: (agent) => agentCli(agent),
       env: agentEnv(),
-      file: join20(ponzuHome(), "suggestions.json")
+      file: join21(ponzuHome(), "suggestions.json")
     },
     opened: named,
     version: VERSION2,
@@ -58381,7 +58482,7 @@ function absolutePaths(args, cwd) {
 }
 async function runInit(target = "design/untitled.design") {
   const path = resolve5(target.endsWith(".design") ? target : `${target}.design`);
-  if (existsSync13(join20(path, "design.json"))) {
+  if (existsSync13(join21(path, "design.json"))) {
     console.error(`${path} already exists.`);
     process.exit(1);
   }
@@ -58403,11 +58504,11 @@ Next: ponzu serve ${target}`);
 }
 function findStudio() {
   const candidates = [
-    join20(here, "../studio"),
-    join20(here, "../../studio/dist"),
-    join20(here, "../../../apps/studio/dist")
+    join21(here, "../studio"),
+    join21(here, "../../studio/dist"),
+    join21(here, "../../../apps/studio/dist")
   ];
-  return candidates.find((c) => existsSync13(join20(c, "index.html")));
+  return candidates.find((c) => existsSync13(join21(c, "index.html")));
 }
 function lanAddresses() {
   const out = [];