mulmoterminal 2.5.3 → 2.6.0

package/README.md

@@ -24,7 +24,7 @@ color-coded so you see at a glance which are **working**, which **need you**, an
 ping to your phone when a task finishes. One `npx` command, no Electron, no config.
 
 ```bash
-npx mulmoterminal        # starts on http://localhost:34567 and opens your browser
+npx mulmoterminal@latest        # starts on http://localhost:34567 and opens your browser
 ```
 
 > **Something looks wrong?** Type `/mulmoterminal-bug-report` in any MulmoTerminal session. The
@@ -146,17 +146,17 @@ Needs **Node ≥ 22.9**, plus these CLIs on your `PATH`:
 
 The server starts without any of the non-required rows; you just lose that row's feature,
 and the header/panel for it says so. `git` and `gh` are marked required because losing them
-costs whole views rather than one button. `npx mulmoterminal init` (below) reports which of
+costs whole views rather than one button. `npx mulmoterminal@latest init` (below) reports which of
 these it can find.
 
 ```bash
-npx mulmoterminal           # start on http://localhost:34567 and open the browser
+npx mulmoterminal@latest           # start on http://localhost:34567 and open the browser
 # or install globally:
 npm install -g mulmoterminal
 mulmoterminal
 ```
 
-**First-run setup (optional).** `npx mulmoterminal init` checks your environment (Node ≥ 22.9
+**First-run setup (optional).** `npx mulmoterminal@latest init` checks your environment (Node ≥ 22.9
 and every CLI in the table above), seeds the launcher's **directory
 presets** from the projects in your Claude Code history, and writes `~/.mulmoterminal/config.json`.
 It's **idempotent** — re-run it any time to refresh the presets; it overwrites the managed parts
@@ -166,7 +166,7 @@ and keeps your other settings. When `claude` is installed it can hand off to the
 **Google account (optional).** Link a Google account to enable the chat's `google` tool and the
 phone's `google.calendar.*` commands: read/create events on any calendar (not just your primary),
 list the calendars you've subscribed to, and read the colour palettes. Sign in from
-**Settings → Google account**, or run `npx mulmoterminal google login` — the CLI is the fallback
+**Settings → Google account**, or run `npx mulmoterminal@latest google login` — the CLI is the fallback
 for when you're driving MulmoTerminal from another machine, since consent finishes on a loopback
 listener and needs a browser **on the host**. Either way it needs a Desktop OAuth client JSON saved
 as `~/.secrets/client_secret_*.json`; the refresh token lands in `~/.config/mulmo/google-token.json`
@@ -200,11 +200,11 @@ directory you run the command from), `--port <n>` (default 34567), `--no-open`,
 `--version`, `--help`.
 
 ```bash
-npx mulmoterminal --cwd ./my-project   # work in a specific directory
+npx mulmoterminal@latest --cwd ./my-project   # work in a specific directory
 ```
 
 The published package ships the server (run via `tsx`) plus the pre-built web UI;
-`npx mulmoterminal` checks for the `claude` CLI, picks a free port, starts the
+`npx mulmoterminal@latest` checks for the `claude` CLI, picks a free port, starts the
 server, and opens the browser. For local development from a clone, see
 [Running](#running).
 
@@ -426,7 +426,7 @@ Requires **Node ≥ 22.9** (uses `node --env-file-if-exists`) and the `claude` C
 ## Configuration
 
 The server is configured entirely through environment variables, optionally
-loaded from a `.env` file. `npx mulmoterminal` reads the `.env` **in the
+loaded from a `.env` file. `npx mulmoterminal@latest` reads the `.env` **in the
 directory you run it from**; the npm scripts read the one in the repo root. The
 `.env` is optional — every variable below has a default, so the server runs
 without one.
@@ -441,7 +441,7 @@ the `claude` / `codex` sessions themselves.
 | `PORT`        | `34567`        | Backend HTTP/WebSocket port (prod: the URL you open). |
 | `CLIENT_PORT` | `6856`         | Vite dev-server port (dev only: the URL you open with `yarn dev`). |
 | `CLAUDE_BIN` | `claude`       | The Claude Code binary to spawn. On Windows a bare name is resolved on `PATH` before it reaches the PTY layer (which matches file names exactly): to the `.exe` when there is one, otherwise to the `.cmd` shim an npm-global install leaves, run through `cmd.exe`. |
-| `CLAUDE_CWD` | current dir    | Working directory each `claude` PTY runs in; determines which project's sessions the sidebar lists. Via `npx mulmoterminal` it defaults to the directory you ran the command from (override with `--cwd <dir>`, relative allowed); when the server is run directly it falls back to `~/mulmoclaude`. A value read from `.env` must be an absolute path (`~` is not expanded). |
+| `CLAUDE_CWD` | current dir    | Working directory each `claude` PTY runs in; determines which project's sessions the sidebar lists. Via `npx mulmoterminal@latest` it defaults to the directory you ran the command from (override with `--cwd <dir>`, relative allowed); when the server is run directly it falls back to `~/mulmoclaude`. A value read from `.env` must be an absolute path (`~` is not expanded). |
 | `CLAUDE_PERMISSION_MODE` | `auto` | Permission mode passed to each `claude` spawn. |
 | `MT_TITLE_MODEL` | `haiku` | Model used for the cell header's AI title (a cheap/fast model summarizing the recent turns). Accepts a `--model` alias or a full model id. |
 | `CODEX_BIN`  | `codex`        | The Codex CLI binary to spawn. |

package/bin/mulmoterminal.js

@@ -155,7 +155,10 @@ async function runInit(initArgs) {
     return;
   }
   if (hasClaude) log("Later: run `claude` in any project and use  /mulmoterminal-config");
-  log("Setup done. Start MulmoTerminal:  npx mulmoterminal");
+  // Pinned to @latest: an unpinned `npx` reuses whatever it already has cached, so the very
+  // command printed for someone to type next would start an older version than the one they
+  // just set up with.
+  log("Setup done. Start MulmoTerminal:  npx mulmoterminal@latest");
 }
 
 // `npx mulmoterminal google <command>` — Google account linking. Consent needs a

package/common/toolGroups.ts

@@ -18,11 +18,24 @@ export type ToolGroup = (typeof TOOL_GROUPS)[number];
 
 export const isToolGroup = (value: unknown): value is ToolGroup => TOOL_GROUPS.some((group) => group === value);
 
-// The group the Canvas pane is made of. The launcher switch registers it, the panel's
-// availability is decided by it, and the server routes on it — named here rather than written
-// as `"render"` at each of those sites, so a rename cannot leave one of them silently pointing
-// at a group that no longer exists.
-export const CANVAS_TOOL_GROUP: ToolGroup = "render";
+// The groups the Canvas pane is made of. The launcher offers a switch per group, the panel's
+// availability is decided by them, and the server routes on them — named here rather than
+// written as `"render"` / `"media"` at each of those sites, so a rename cannot leave one of them
+// silently pointing at a group that no longer exists.
+//
+// `media` is in because its tools DRAW: generateImage and presentMulmoScript land in the same
+// panel a render tool does. It is a separate switch rather than part of one because the two
+// differ in what a call costs — render stops at the pane, media is slow, paid and writes files —
+// and that is exactly the line the grouping exists to draw. Neither media tool is in
+// AUTO_ALLOWED_TOOLS, so enabling the group still leaves Claude Code's permission prompt in
+// front of the spend (same reasoning as presentDocument below).
+export const CANVAS_TOOL_GROUPS: readonly ToolGroup[] = ["render", "media"];
+
+// Does a session/directory reach the Canvas at all? Asked of the group list the server reports,
+// whose members arrive as plain strings — validated rather than cast, since an unknown name from
+// a newer server must not count as a canvas group.
+export const hasCanvasGroup = (groups: unknown): boolean =>
+  Array.isArray(groups) && groups.some((group) => isToolGroup(group) && CANVAS_TOOL_GROUPS.includes(group));
 
 // Which group each GUI tool belongs to.
 //
@@ -60,6 +73,11 @@ const GROUP_BY_TOOL = new Map<string, ToolGroup>([
 
 export const groupOfTool = (toolName: string): ToolGroup | null => GROUP_BY_TOOL.get(toolName) ?? null;
 
+// Every tool in a group, in the order declared above. The Canvas panel's empty state names them,
+// so a tool added to a group here reaches that list without a second edit — the list had been
+// written out by hand and named two of the four.
+export const toolsInGroup = (group: ToolGroup): string[] => [...GROUP_BY_TOOL].filter(([, g]) => g === group).map(([name]) => name);
+
 // The MCP server id a group is expected to be registered under. `--allowedTools` matches on
 // `mcp__<server id>__<tool>`, and the id comes from the USER's config key — so this is a
 // convention the enable-it-for-this-folder affordance has to write, and a user who registers

package/dist/assets/{abnfDiagram-VRR7QNED-RjiYivmv-CkfTvNiT.js → abnfDiagram-VRR7QNED-RjiYivmv-2UuooAL1.js}

@@ -1 +1 @@
-import{n as e}from"./chunk-Y2CYZVJY-Bdt8pFDJ-DsF7k-Jl.js";import{f as t}from"./src-Brzfja-q-ch1VcTiG.js";import{_ as n,g as r}from"./mermaid-parser.core-DxEa8E3F-CscC8Qqr.js";import"./chunk-WYO6CB5R-BlzOfotS-CgOwOaF2.js";import"./chunk-VAUOI2AC-CS9QJ4yz-C1PM97Ei.js";import{n as i,r as a,t as o}from"./chunk-MOJQB5TN-CMZRaeqt-CC-mdXDP.js";import{t as s}from"./chunk-JWPE2WC7-BQ3zXr2k-DSd3Ct95.js";var c=r().RailroadAbnf.parser.LangiumParser,l=e(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=e(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=e(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=e(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=e(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=e(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=e(e=>{s(e,a),e.title&&a.setTitle(e.title),e.rules.map(e=>a.addRule(m(e)))},`populateDb`),g={parser:{parse:e(e=>{a.clear(),t.debug(`[ABNF Parser] Starting Langium parse`);let r=c.parse(e);if(r.lexerErrors.length>0||r.parserErrors.length>0)throw new n(r);let i=r.value;t.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),t.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:a}},db:a,renderer:o,styles:i};export{g as diagram};
+import{n as e}from"./chunk-Y2CYZVJY-Bdt8pFDJ-DsF7k-Jl.js";import{f as t}from"./src-Brzfja-q-ch1VcTiG.js";import{_ as n,g as r}from"./mermaid-parser.core-DxEa8E3F-3f1dQMCy.js";import"./chunk-WYO6CB5R-BlzOfotS-cPQQuq_p.js";import"./chunk-VAUOI2AC-CS9QJ4yz-xhVI0AT_.js";import{n as i,r as a,t as o}from"./chunk-MOJQB5TN-CMZRaeqt-DvOpObYg.js";import{t as s}from"./chunk-JWPE2WC7-BQ3zXr2k-DSd3Ct95.js";var c=r().RailroadAbnf.parser.LangiumParser,l=e(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=e(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=e(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=e(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=e(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=e(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=e(e=>{s(e,a),e.title&&a.setTitle(e.title),e.rules.map(e=>a.addRule(m(e)))},`populateDb`),g={parser:{parse:e(e=>{a.clear(),t.debug(`[ABNF Parser] Starting Langium parse`);let r=c.parse(e);if(r.lexerErrors.length>0||r.parserErrors.length>0)throw new n(r);let i=r.value;t.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),t.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:a}},db:a,renderer:o,styles:i};export{g as diagram};

package/dist/assets/architecture-TIHT7OUA-0NsD2xW1-BgkdTJQE.js

@@ -0,0 +1 @@
+import{f as e}from"./mermaid-parser.core-DxEa8E3F-3f1dQMCy.js";export{e as createArchitectureServices};