mulmoterminal 4.6.1 → 4.7.0

package/README.md

@@ -1205,7 +1205,7 @@ it came from — `mcp__<id>__presentChart` in Claude Code, `mcp-<id>-presentChar
 also rewrites `-` in the id to `_`). So the id you register under is repeated on every tool, in
 every listing, for the life of the session.
 
-MulmoTerminal delivers the GUI MCP by **two different routes**, and they do not share an id:
+MulmoTerminal delivers the GUI MCP by **three different routes**, and they do not share an id:
 
 | | Workspace cell / single view | Project-directory grid cell |
 |---|---|---|
@@ -1214,14 +1214,39 @@ MulmoTerminal delivers the GUI MCP by **two different routes**, and they do not
 | Tools carried | all of them, on one URL | only the groups that directory registered |
 | Tool name looks like | `mcp__mt__presentChart` | `mcp__mulmoterminal-render__presentChart` |
 
+The third is **Muse**, which reads neither a flag nor a file in the directory: its MCP servers are
+declared by an installed **plugin**, and `muse plugins install` records one per MACHINE. So
+MulmoTerminal registers a single `mulmoterminal` plugin holding all four group servers, and each
+session is narrowed back to what its own directory switched on — the bridge asks the server which
+session it belongs to (by its process tree) and is told which groups that session may reach. The
+servers are named by group alone, because Muse composes the tool name out of both ids:
+
+| | Muse cell (anywhere) |
+|---|---|
+| How it arrives | a `mulmoterminal` plugin installed for the machine, re-registered whenever the bridge path or port changes |
+| Server id | **`render`**, `data`, `media`, `external` — inside the `mulmoterminal` plugin |
+| Tools carried | only the groups that directory registered; the rest serve an empty toolset |
+| Tool name looks like | `mcp__plugin_mulmoterminal_render__presentChart` |
+
+Muse's plugin support is behind its own experimental flag (`MUSE_EXPERIMENTAL_PLUGINS`), which
+MulmoTerminal sets on the sessions it starts. A Muse build without it simply has no GUI tools —
+the registration fails with one warning and the session starts anyway.
+
+**A Muse session picks its plugins up when its own process starts, and MulmoTerminal's sessions
+outlive the server.** So a Muse cell that was already running when you switched a group on — or
+when you first upgraded to a version that has this — keeps no tools until that CELL is started
+again. Restarting the server is not enough: the session is still there in tmux and gets reattached,
+exactly as it was. Close the cell and open a new one (or `Stop` it in Settings → Surviving sessions),
+and it comes back with the tools its directory registered.
+
 Which route a session takes is decided by `carriesFullGuiMcp()` in
 `server/session/mcp-config.ts` — the single view, a cell-less chat, or anything whose cwd **is**
 the workspace take the first; anything in a project directory takes the second.
 
 **The workspace is agent-agnostic for the agents that can RECEIVE a per-spawn config** — claude and
 codex ask the same predicate, so two terminals in the workspace reach the same tools no matter which
-of the two started them. **Antigravity and Grok cannot, and that is the exception you will meet
-first:**
+of the two started them. **Antigravity, Grok and Muse cannot, and that is the exception you will
+meet first:**
 
 | Started as | In the workspace | In a project directory |
 |---|---|---|
@@ -1229,11 +1254,13 @@ first:**
 | codex cell | `mt`, every tool | the directory's registered groups |
 | antigravity cell | **the directory's registered groups** — nothing registered means **no GUI tools at all** | the directory's registered groups |
 | grok cell | **the directory's registered groups** — nothing registered means **no GUI tools at all** | the directory's registered groups |
+| muse cell | **the directory's registered groups** — nothing registered means **no GUI tools at all** | the directory's registered groups |
 | any launcher chip | untouched | untouched |
 
-Neither takes an MCP flag: `agy` reads `.agents/mcp_config.json` and `grok` reads `.grok/config.toml`
-in the working directory, and a file shared by every session in a directory cannot be handed to one
-session and not another — so there is nothing for "this cwd is the workspace" to change. The
+None of the three takes an MCP flag: `agy` reads `.agents/mcp_config.json`, `grok` reads
+`.grok/config.toml` in the working directory, and `muse` reads a plugin installed for the whole
+machine — and neither a file shared by every session in a directory nor a machine-wide plugin can be
+handed to one session and not another — so there is nothing for "this cwd is the workspace" to change. The
 membership is `FULL_GUI_MCP_AGENTS` in `common/guiMcpAgents.ts`, in `common/` precisely so the
 launcher form and the spawn cannot disagree about it
 ([#1423](https://github.com/receptron/mulmoterminal/issues/1423)).

package/common/agentSessionList.ts

@@ -18,6 +18,7 @@ export const AGENT_SESSION_LIST_PATHS: Record<TerminalAgent, string> = {
   codex: "/api/codex/sessions",
   antigravity: "/api/antigravity/sessions",
   grok: "/api/grok/sessions",
+  muse: "/api/muse/sessions",
 };
 
 /** The listing URL for one agent's conversations in one directory. */

package/common/guiMcpAgents.ts

@@ -19,6 +19,16 @@
 // `~/.grok/config.toml` or `./.grok/config.toml` (server/agents/grok-mcp.ts). So a grok session in
 // the workspace gets the groups its DIRECTORY registered, and the launcher form offers it the four
 // per-group toggles — which is the truthful answer, and the one #1423 failed to give.
+//
+// Muse is out for the same reason and reaches its tools a third way. It has no `--mcp-config` and
+// no per-directory config file either: MCP servers are declared by an installed PLUGIN, which
+// `muse plugins install` records per MACHINE (server/agents/muse-mcp.ts). So MulmoTerminal
+// registers one plugin holding all four group servers, and each SESSION is narrowed back to what
+// its directory switched on — by a lookup, not by the environment: a plugin's MCP server is started
+// with a curated environment that carries nothing of ours, so the bridge resolves which session it
+// belongs to (by its process tree) and is told the groups with the answer. Do not add a bridge
+// environment variable; it is dropped on the way and the failure is silent. The launcher form offers muse the same four per-group
+// toggles as grok and agy, which is the truthful answer for the same reason it is theirs.
 import { type SessionAgent } from "./sessionAgent.js";
 import { isLaunchAgent } from "./launchAgent.js";
 import { customAgentFor, type AgentPick, type CustomAgent } from "./customAgents.js";

package/common/launchAgent.ts

@@ -4,7 +4,7 @@
 // Deliberately NOT the configured `launchers` list: those are arbitrary user commands, and
 // the phone picks from a fixed set the host can name. "shell" is the OS default shell, the
 // same thing the header's new-terminal button opens.
-export const LAUNCH_AGENTS = ["shell", "claude", "codex", "antigravity", "grok"] as const;
+export const LAUNCH_AGENTS = ["shell", "claude", "codex", "antigravity", "grok", "muse"] as const;
 
 export type LaunchAgent = (typeof LAUNCH_AGENTS)[number];
 

package/common/modelPresets.ts

@@ -260,6 +260,16 @@ export const MODEL_PRESETS: readonly ModelPreset[] = [
     trials: measured(3, 3, 38),
   },
 
+  // ── Muse (Meta) ────────────────────────────────────────────────────────────────
+  {
+    provider: "meta",
+    id: "muse-spark-1.2-contributor",
+    label: "Muse Spark 1.2",
+    contextLength: 1_000_000,
+    pricePerMTok: { input: 1, output: 3 },
+    trials: { status: "unmeasured" },
+  },
+
   // ── Reached fine, never drove the tool loop ──────────────────────────────────
   // Kept so the list answers "what about X?" with a measurement instead of silence.
   {

package/common/sessionAgent.ts

@@ -1,7 +1,7 @@
 // What a remote-host session is running. The server decides it (from the PtyEntry, or from
 // what tmux says is in the pane) and the settings UI offers it as the scope for a quick
 // command, so the list of kinds is a value both sides read.
-export const SESSION_AGENTS = ["claude", "codex", "antigravity", "grok", "shell"] as const;
+export const SESSION_AGENTS = ["claude", "codex", "antigravity", "grok", "muse", "shell"] as const;
 
 // Null anywhere this appears means the host cannot tell — a session that outlived a restart
 // exists only in tmux, and nothing recorded what launched it. That is distinct from "shell".
@@ -9,7 +9,7 @@ export type SessionAgent = (typeof SESSION_AGENTS)[number];
 
 // The agents a terminal can be LAUNCHED as, which is the session kinds minus "shell" (a shell is
 // a launcher, not an agent). Claude is first because it is the default everywhere below.
-export const TERMINAL_AGENTS = ["claude", "codex", "antigravity", "grok"] as const;
+export const TERMINAL_AGENTS = ["claude", "codex", "antigravity", "grok", "muse"] as const;
 
 export type TerminalAgent = (typeof TERMINAL_AGENTS)[number];
 
@@ -47,6 +47,7 @@ const AGENT_BADGES: Partial<Record<TerminalAgent, AgentBadge>> = {
   codex: { full: "codex", short: "cx" },
   antigravity: { full: "agy", short: "agy" },
   grok: { full: "grok", short: "gk" },
+  muse: { full: "muse", short: "mu" },
 };
 
 /** How a session row announces which agent it is running, or null when it wears no badge. The one

package/dist/assets/{abnfDiagram-VRR7QNED-WSmThe6b-CBO7sBGR.js → abnfDiagram-VRR7QNED-WSmThe6b-D7o5fw1r.js}

@@ -1 +1 @@
-import{n as e}from"./chunk-Y2CYZVJY-Bdt8pFDJ-DsF7k-Jl.js";import{f as t}from"./src-CvsWqFln-Tc7ZSrRz.js";import{_ as n,g as r}from"./mermaid-parser.core-C1baW7NG-B11a01NO.js";import"./chunk-WYO6CB5R-nS6zX9ct-Dttxo6Qs.js";import"./chunk-VAUOI2AC-BKx35BBi-Bi2sMyOB.js";import{n as i,r as a,t as o}from"./chunk-MOJQB5TN-CorQ_Pl1-C9s38qkp.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-CvsWqFln-Tc7ZSrRz.js";import{_ as n,g as r}from"./mermaid-parser.core-C1baW7NG-D6V0bamn.js";import"./chunk-WYO6CB5R-nS6zX9ct-CEyECF4F.js";import"./chunk-VAUOI2AC-BKx35BBi-DF4roMbC.js";import{n as i,r as a,t as o}from"./chunk-MOJQB5TN-CorQ_Pl1-Bo-W29fw.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-Cqhmai3f-R3ZCNmlM.js

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