symposium-mcp 0.3.0 → 0.3.1

package/dist/mcp.js

@@ -3231,8 +3231,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path4) {
-      let input2 = path4;
+    function removeDotSegments(path5) {
+      let input2 = path5;
       const output2 = [];
       let nextSlash = -1;
       let len = 0;
@@ -3324,9 +3324,9 @@ var require_utils = __commonJS({
           const hex3 = input2.slice(i + 1, i + 3);
           if (isHexPair(hex3)) {
             const normalizedHex = hex3.toUpperCase();
-            const decoded = String.fromCharCode(parseInt(normalizedHex, 16));
-            if (decodeUnreserved && isUnreserved(decoded)) {
-              output2 += decoded;
+            const decoded2 = String.fromCharCode(parseInt(normalizedHex, 16));
+            if (decodeUnreserved && isUnreserved(decoded2)) {
+              output2 += decoded2;
             } else {
               output2 += "%" + normalizedHex;
             }
@@ -3345,9 +3345,9 @@ var require_utils = __commonJS({
           const hex3 = input2.slice(i + 1, i + 3);
           if (isHexPair(hex3)) {
             const normalizedHex = hex3.toUpperCase();
-            const decoded = String.fromCharCode(parseInt(normalizedHex, 16));
-            if (decoded !== "." && isUnreserved(decoded)) {
-              output2 += decoded;
+            const decoded2 = String.fromCharCode(parseInt(normalizedHex, 16));
+            if (decoded2 !== "." && isUnreserved(decoded2)) {
+              output2 += decoded2;
             } else {
               output2 += "%" + normalizedHex;
             }
@@ -3484,8 +3484,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path4, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path4 && path4 !== "/" ? path4 : void 0;
+        const [path5, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path5 && path5 !== "/" ? path5 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -6269,7 +6269,7 @@ var require_discriminator = __commonJS({
       error: error62,
       code(cxt) {
         const { gen, data, schema, parentSchema, it } = cxt;
-        const { oneOf } = parentSchema;
+        const { oneOf: oneOf2 } = parentSchema;
         if (!it.opts.discriminator) {
           throw new Error("discriminator: requires discriminator option");
         }
@@ -6278,7 +6278,7 @@ var require_discriminator = __commonJS({
           throw new Error("discriminator: requires propertyName");
         if (schema.mapping)
           throw new Error("discriminator: mapping is not supported");
-        if (!oneOf)
+        if (!oneOf2)
           throw new Error("discriminator: requires oneOf keyword");
         const valid = gen.let("valid", false);
         const tag = gen.const("tag", (0, codegen_1._)`${data}${(0, codegen_1.getProperty)(tagName)}`);
@@ -6306,8 +6306,8 @@ var require_discriminator = __commonJS({
           const oneOfMapping = {};
           const topRequired = hasRequired(parentSchema);
           let tagRequired = true;
-          for (let i = 0; i < oneOf.length; i++) {
-            let sch = oneOf[i];
+          for (let i = 0; i < oneOf2.length; i++) {
+            let sch = oneOf2[i];
             if ((sch === null || sch === void 0 ? void 0 : sch.$ref) && !(0, util_1.schemaHasRulesButRef)(sch, it.self.RULES)) {
               const ref = sch.$ref;
               sch = compile_1.resolveRef.call(it.self, it.schemaEnv.root, it.baseId, ref);
@@ -7274,8 +7274,8 @@ function getErrorMap() {
 
 // ../node_modules/.pnpm/zod@4.6.7/node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path4, errorMaps, issueData } = params;
-  const fullPath = [...path4, ...issueData.path || []];
+  const { data, path: path5, errorMaps, issueData } = params;
+  const fullPath = [...path5, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -7390,11 +7390,11 @@ var errorUtil;
 
 // ../node_modules/.pnpm/zod@4.6.7/node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path4, key) {
+  constructor(parent, value, path5, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path4;
+    this._path = path5;
     this._key = key;
   }
   get path() {
@@ -7790,14 +7790,14 @@ function isValidJWT(jwt2, alg) {
     if (!header)
       return false;
     const base643 = header.replace(/-/g, "+").replace(/_/g, "/").padEnd(header.length + (4 - header.length % 4) % 4, "=");
-    const decoded = JSON.parse(atob(base643));
-    if (typeof decoded !== "object" || decoded === null)
+    const decoded2 = JSON.parse(atob(base643));
+    if (typeof decoded2 !== "object" || decoded2 === null)
       return false;
-    if ("typ" in decoded && decoded?.typ !== "JWT")
+    if ("typ" in decoded2 && decoded2?.typ !== "JWT")
       return false;
-    if (!decoded.alg)
+    if (!decoded2.alg)
       return false;
-    if (alg && decoded.alg !== alg)
+    if (alg && decoded2.alg !== alg)
       return false;
     return true;
   } catch {
@@ -11349,10 +11349,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path4) {
-  if (!path4)
+function getElementAtPath(obj, path5) {
+  if (!path5)
     return obj;
-  return path4.reduce((acc, key) => acc?.[key], obj);
+  return path5.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -11692,11 +11692,11 @@ function explicitlyAborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path4, issues) {
+function prefixIssues(path5, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path4);
+    iss.path.unshift(path5);
     return iss;
   });
 }
@@ -12158,16 +12158,16 @@ function flattenError(error62, mapper = (issue2) => issue2.message) {
 }
 function formatError(error62, mapper = (issue2) => issue2.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error63, path4 = []) => {
+  const processError = (error63, path5 = []) => {
     for (const issue2 of error63.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path4, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path5, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path4, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path5, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path4, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path5, ...issue2.path]);
       } else {
-        const fullpath = [...path4, ...issue2.path];
+        const fullpath = [...path5, ...issue2.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue2));
         } else {
@@ -12206,17 +12206,17 @@ function formatError(error62, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error62, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error63, path4 = []) => {
+  const processError = (error63, path5 = []) => {
     var _a3;
     for (const issue2 of error63.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path4, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path5, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path4, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path5, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path4, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path5, ...issue2.path]);
       } else {
-        const fullpath = [...path4, ...issue2.path];
+        const fullpath = [...path5, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -12255,8 +12255,8 @@ function treeifyError(error62, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path4 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path4) {
+  const path5 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path5) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -27807,11 +27807,11 @@ function normalizeObjectSchema(schema) {
   }
   return void 0;
 }
-function getDotPath(path4) {
-  if (path4.length === 0) {
+function getDotPath(path5) {
+  if (path5.length === 0) {
     return "object root";
   }
-  return path4.reduce((acc, seg, index) => {
+  return path5.reduce((acc, seg, index) => {
     if (index === 0) {
       return String(seg);
     }
@@ -30038,13 +30038,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path4 = ref.slice(1).split("/").filter(Boolean);
-  if (path4.length === 0) {
+  const path5 = ref.slice(1).split("/").filter(Boolean);
+  if (path5.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path4[0] === defsKey) {
-    const key = path4[1] === void 0 ? void 0 : decodeJSONPointerSegment(path4[1]);
+  if (path5[0] === defsKey) {
+    const key = path5[1] === void 0 ? void 0 : decodeJSONPointerSegment(path5[1]);
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -36301,6 +36301,7 @@ var StdioServerTransport = class {
 
 // ../lib/meeting/protocol.ts
 var MAX_DOC_PACKET_BYTES = 12 * 1024;
+var MAIN_DOC_ID = "main";
 var DOC_EDIT_OPS = ["append", "replace_section", "replace_all"];
 var MAX_WAIT_SECONDS = 50;
 var MAX_SURFACE_HTML_BYTES = 512 * 1024;
@@ -36315,6 +36316,15 @@ function agentIdOfKey(key) {
 }
 var PROPOSAL_PROGRESS = ["working", "done", "failed"];
 var REQUEST_STATUSES = ["acknowledged", "working", "done", "failed"];
+var WORK_KINDS = [
+  "thinking",
+  "searching",
+  "writing",
+  "drawing",
+  "charting",
+  "building"
+];
+var AGENT_WORK_TTL_MS = 3 * 6e4;
 var PRESENCE_IDLE_AFTER_MS = 5 * 6e4;
 var SPACE_EVENT_TYPES = [
   "speech",
@@ -36324,6 +36334,7 @@ var SPACE_EVENT_TYPES = [
   "proposal",
   "proposal_decided",
   "doc_changed",
+  "doc_removed",
   "ui_event",
   "state_changed",
   "surface_changed",
@@ -36675,8 +36686,8 @@ var SpaceClient = class {
     this.api = api.replace(/\/$/, "");
     this.base = `${this.api}/spaces/${encodeURIComponent(space2)}`;
   }
-  async request(method, path4, body, timeoutMs = 3e4) {
-    const resp = await fetch(this.base + path4, {
+  async request(method, path5, body, timeoutMs = 3e4) {
+    const resp = await fetch(this.base + path5, {
       method,
       headers: {
         Authorization: `Bearer ${this.key}`,
@@ -36693,7 +36704,7 @@ var SpaceClient = class {
     if (!resp.ok) {
       const detail = await resp.json().catch(() => null);
       throw new Error(
-        `${method} ${path4} failed (${resp.status}): ${detail?.error ?? resp.statusText}`
+        `${method} ${path5} failed (${resp.status}): ${detail?.error ?? resp.statusText}`
       );
     }
     return resp.status === 204 ? void 0 : await resp.json();
@@ -36742,18 +36753,41 @@ var SpaceClient = class {
   postMessage(text2) {
     return this.request("POST", "/timeline", { text: text2 });
   }
-  // --- shared document -------------------------------------------------------------
-  /** The space's shared document, as Markdown. */
-  async readDocument() {
-    return (await this.request("GET", "/doc")).markdown;
+  // --- shared documents ------------------------------------------------------------
+  /** The space's shared documents, the one it started with (`main`) first. */
+  async listDocuments() {
+    return (await this.request("GET", "/docs")).docs;
+  }
+  /** Add a document to the space, optionally with its first text in Markdown. */
+  createDocument(input2) {
+    return this.request("POST", "/docs", input2);
   }
   /**
-   * Edit the shared document. People may be typing in it at the same time, so prefer
+   * One of the shared documents, as Markdown (`main` unless you name another). People see
+   * this agent on the document's tab for a little while afterwards.
+   */
+  async readDocument(id = MAIN_DOC_ID) {
+    return (await this.request("GET", `/docs/${encodeURIComponent(id)}`)).markdown;
+  }
+  /**
+   * Edit a shared document. People may be typing in it at the same time, so prefer
    * `append` or `replace_section` (which only touch part of it) to `replace_all`.
-   * Returns the document after the edit, as Markdown.
+   * What the edit adds or changes is shown to everyone as written by this agent, until a
+   * person edits it. Returns the document after the edit, as Markdown.
    */
-  async editDocument(edit) {
-    return (await this.request("POST", "/doc/edits", edit)).markdown;
+  async editDocument(edit, id = MAIN_DOC_ID) {
+    return (await this.request(
+      "POST",
+      `/docs/${encodeURIComponent(id)}/edits`,
+      edit
+    )).markdown;
+  }
+  renameDocument(id, title) {
+    return this.request("PATCH", `/docs/${encodeURIComponent(id)}`, { title });
+  }
+  /** Remove a document this agent made. The first document (`main`) cannot be removed. */
+  removeDocument(id) {
+    return this.request("DELETE", `/docs/${encodeURIComponent(id)}`);
   }
   // --- proposals -------------------------------------------------------------------
   /**
@@ -36770,14 +36804,16 @@ var SpaceClient = class {
   }
   // --- attention -------------------------------------------------------------------
   /**
-   * Bring everyone's stage to one tab: a surface (yours or anyone's), the document or
+   * Bring everyone's stage to one tab: a surface (yours or anyone's), a document or
    * Agents. People are switched to it, with a note saying you did it and a way to go
    * back. Use it when you have put up something everyone should look at now. The
    * conversation is a column beside the stage, not a tab: that target opens it for
-   * anyone who has closed it.
+   * anyone who has closed it. `size` asks for it large: `expanded` gives the stage the
+   * screen, `alone` opens a surface on its own instead of as a tile among the others.
+   * Nobody's stage is made smaller.
    */
-  bringEveryoneTo(target) {
-    return this.request("POST", "/focus", { target });
+  bringEveryoneTo(target, size) {
+    return this.request("POST", "/focus", { target, size });
   }
   // --- requests --------------------------------------------------------------------
   /** This agent's id, as it appears in `request` events' `to` list. */
@@ -36788,10 +36824,23 @@ var SpaceClient = class {
    * Tell everyone in the space how you are getting on with a request addressed to you
    * (a `request` event; its `seq` is the request id). People see this next to the
    * request: `acknowledged` as soon as you have seen it, `working` (with a short note
-   * on what you are doing) while you act, then `done` or `failed`.
+   * on what you are doing) while you act, then `done` or `failed`. `surfaceId` says
+   * which surface the work is on: people see this agent on that tab meanwhile. `doing`
+   * says what kind of work it is, which the agent's figure shows. `doc` says which shared
+   * document the work is in, and under which heading: people see this agent on that
+   * document's tab, and beside that section in the text.
    */
-  updateRequest(id, status, note) {
-    return this.request("PATCH", `/requests/${id}`, { status, note });
+  updateRequest(id, status, note, surfaceId, doing, doc) {
+    return this.request("PATCH", `/requests/${id}`, { status, note, surfaceId, doing, ...doc });
+  }
+  /**
+   * Show the space what this agent is working on when it is not an answer to a request.
+   * Its figure plays the matching animation for everyone, on the surface's or the
+   * document's tab if one is named. Say it again to renew or change it (it lapses after a few minutes), and
+   * pass `done` when finished. `key` tells several pieces of work apart.
+   */
+  setWork(work) {
+    return this.request("PUT", "/work", work);
   }
   // --- events ----------------------------------------------------------------------
   /** How far through the event log this client has read: save it to carry on later. */
@@ -36893,22 +36942,71 @@ function agentName(client2, configured = process.env.SYMPOSIUM_AGENT_NAME) {
 
 // src/setup.ts
 import { spawn, spawnSync } from "node:child_process";
-import { existsSync, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
+import { copyFileSync, existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
 import { homedir as homedir2, hostname as hostname3 } from "node:os";
-import path2 from "node:path";
+import path3 from "node:path";
 import { createInterface } from "node:readline/promises";
 import { fileURLToPath } from "node:url";
 
+// src/command.ts
+import { existsSync } from "node:fs";
+import path from "node:path";
+function whereIs(command, env = process.env, exists = existsSync) {
+  const extensions = (env.PATHEXT || ".COM;.EXE;.BAT;.CMD").split(";").filter(Boolean);
+  for (const dir of (env.PATH ?? env.Path ?? "").split(";")) {
+    if (!dir) continue;
+    for (const extension of extensions) {
+      const file3 = path.win32.join(dir, command + extension.toLowerCase());
+      if (exists(file3)) return file3;
+    }
+  }
+  return void 0;
+}
+var quoted = (arg) => /^[\w\-./:\\=@]+$/.test(arg) ? arg : `"${arg.replace(/["%]/g, "")}"`;
+function starting(command, args, platform = process.platform, find = whereIs) {
+  if (platform !== "win32") return { file: command, args, shell: false };
+  const file3 = find(command);
+  if (!file3) return void 0;
+  if (!/\.(cmd|bat)$/i.test(file3)) return { file: file3, args, shell: false };
+  return { file: [file3, ...args].map(quoted).join(" "), args: [], shell: true };
+}
+function relaxed(text2) {
+  let out = "";
+  for (let i = 0; i < text2.length; i++) {
+    const c = text2[i];
+    if (c === '"') {
+      const start2 = i;
+      for (i++; i < text2.length && text2[i] !== '"'; i++) if (text2[i] === "\\") i++;
+      out += text2.slice(start2, i + 1);
+    } else if (c === "/" && text2[i + 1] === "/") {
+      while (i < text2.length && text2[i] !== "\n") i++;
+      out += "\n";
+    } else if (c === "/" && text2[i + 1] === "*") {
+      const end = text2.indexOf("*/", i + 2);
+      i = end < 0 ? text2.length : end + 1;
+    } else if (c === "}" || c === "]") {
+      out = out.replace(/,\s*$/, "") + c;
+    } else {
+      out += c;
+    }
+  }
+  return out;
+}
+function decoded(bytes) {
+  if (bytes[0] === 255 && bytes[1] === 254) return bytes.subarray(2).toString("utf16le");
+  return bytes.toString("utf8").replace(/^/, "");
+}
+
 // src/remembered.ts
 import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
-import path from "node:path";
+import path2 from "node:path";
 var FIRST_AGENT = "Claude";
 function stateFile(agent2, home = homedir(), override = process.env.SYMPOSIUM_STATE_FILE) {
   if (override) return override;
   const slug = agent2.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
   const name = slug === FIRST_AGENT.toLowerCase() ? "mcp.json" : `mcp.${slug || "agent"}.json`;
-  return path.join(home, ".symposium", name);
+  return path2.join(home, ".symposium", name);
 }
 var agent = FIRST_AGENT;
 function rememberAs(name) {
@@ -36926,7 +37024,7 @@ function load() {
 function save(next) {
   try {
     const target = file2();
-    mkdirSync(path.dirname(target), { recursive: true, mode: 448 });
+    mkdirSync(path2.dirname(target), { recursive: true, mode: 448 });
     const temp = `${target}.${process.pid}.tmp`;
     writeFileSync(temp, JSON.stringify(next), { mode: 384 });
     renameSync(temp, target);
@@ -36969,12 +37067,19 @@ function rememberAccount(account2) {
 var SERVER = "symposium";
 var realHost = {
   run(command, args) {
-    const done = spawnSync(command, args, {
-      stdio: "ignore",
-      shell: process.platform === "win32",
+    const how = starting(command, args);
+    if (!how) return void 0;
+    const done = spawnSync(how.file, how.args, {
+      stdio: ["ignore", "ignore", "pipe"],
+      encoding: "utf8",
+      shell: how.shell,
       timeout: 6e4
     });
-    return done.error ? void 0 : done.status ?? 1;
+    if (done.error) {
+      const missing = done.error.code === "ENOENT";
+      return missing ? void 0 : { status: 1, said: done.error.message };
+    }
+    return { status: done.status ?? 1, said: lastLine(done.stderr ?? "") };
   },
   redeem: redeemConnectFor,
   join: (account2, space2) => new AccountClient(account2.api, account2.token).join(space2),
@@ -36996,13 +37101,12 @@ var realHost = {
   },
   open(command, args) {
     return new Promise((resolve) => {
+      const how = starting(command, args);
+      if (!how) return resolve();
       const ignore = () => {
       };
       process.on("SIGINT", ignore);
-      const child = spawn(command, args, {
-        stdio: "inherit",
-        shell: process.platform === "win32"
-      });
+      const child = spawn(how.file, how.args, { stdio: "inherit", shell: how.shell });
       const done = () => {
         process.off("SIGINT", ignore);
         resolve();
@@ -37012,55 +37116,78 @@ var realHost = {
     });
   }
 };
-function serverCommand(self = fileURLToPath(import.meta.url)) {
-  return self.endsWith(".ts") ? ["npx", "-y", "tsx", path2.join(path2.dirname(self), "mcp.ts")] : ["npx", "-y", "symposium-mcp"];
+function lastLine(output2) {
+  const lines = output2.replace(/\x1b\[[0-9;]*m/g, "").split("\n").map((line) => line.trim()).filter(Boolean);
+  return (lines.at(-1) ?? "").slice(0, 200);
+}
+function serverCommand(self = fileURLToPath(import.meta.url), platform = process.platform) {
+  const npx = self.endsWith(".ts") ? ["npx", "-y", "tsx", path3.join(path3.dirname(self), "mcp.ts")] : ["npx", "-y", "symposium-mcp"];
+  return platform === "win32" ? ["cmd", "/c", ...npx] : npx;
 }
 var withCommand = (label, agent2, bin, add) => ({
   label,
   agent: agent2,
-  found: (host) => host.run(bin, ["--version"]) !== void 0,
+  // Installed and working: a command that cannot say its version cannot be set up either.
+  found: (host) => host.run(bin, ["--version"])?.status === 0,
   register(host, command) {
-    if (host.run(bin, ["mcp", "get", SERVER]) === 0) return "present";
-    if (host.run(bin, add(command)) !== 0) throw new Error(`\`${bin} mcp add\` failed`);
-    return "added";
+    if (host.run(bin, ["mcp", "get", SERVER])?.status === 0) return { tools: "present" };
+    const added = host.run(bin, add(command));
+    if (added?.status !== 0) {
+      throw new Error(`\`${bin} mcp add\` failed${added?.said ? ` (${added.said})` : ""}`);
+    }
+    return { tools: "added" };
   },
   start: (prompt) => [bin, prompt]
 });
-var withConfigFile = (label, agent2, dir, file3) => ({
-  label,
-  agent: agent2,
-  found: () => existsSync(path2.join(homedir2(), ...dir)),
-  register(_host, command) {
-    const target = path2.join(homedir2(), ...dir, file3);
-    let settings = {};
-    if (existsSync(target)) {
-      let parsed;
-      try {
-        parsed = JSON.parse(readFileSync2(target, "utf8"));
-      } catch {
-        parsed = null;
-      }
-      if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-        throw new Error(`${target} is not plain JSON; add the server to it by hand`);
-      }
-      settings = parsed;
-    }
-    const servers = settings.mcpServers;
-    const existing = typeof servers === "object" && servers !== null && !Array.isArray(servers) ? servers : {};
-    if (SERVER in existing) return "present";
-    settings.mcpServers = {
-      ...existing,
-      [SERVER]: {
-        command: command[0],
-        args: command.slice(1),
-        env: { SYMPOSIUM_AGENT_NAME: agent2 }
+var withConfigFile = (label, agent2, dir, file3) => {
+  const entry = (command) => ({
+    command: command[0],
+    args: command.slice(1),
+    env: { SYMPOSIUM_AGENT_NAME: agent2 }
+  });
+  const target = () => path3.join(homedir2(), ...dir, file3);
+  return {
+    label,
+    agent: agent2,
+    found: () => existsSync2(path3.join(homedir2(), ...dir)),
+    register(_host, command) {
+      let settings = {};
+      let loose = false;
+      const text2 = existsSync2(target()) ? decoded(readFileSync2(target())) : "";
+      if (text2.trim()) {
+        let parsed;
+        try {
+          parsed = JSON.parse(text2);
+        } catch {
+          loose = true;
+          try {
+            parsed = JSON.parse(relaxed(text2));
+          } catch {
+            parsed = null;
+          }
+        }
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+          throw new Error(`${target()} could not be read as JSON`);
+        }
+        settings = parsed;
       }
-    };
-    writeFileSync2(target, `${JSON.stringify(settings, null, 2)}
+      const servers = settings.mcpServers;
+      const existing = typeof servers === "object" && servers !== null && !Array.isArray(servers) ? servers : {};
+      if (SERVER in existing) return { tools: "present" };
+      const kept = `${target()}.before-symposium`;
+      if (loose) copyFileSync(target(), kept);
+      settings.mcpServers = { ...existing, [SERVER]: entry(command) };
+      writeFileSync2(target(), `${JSON.stringify(settings, null, 2)}
 `);
-    return "added";
-  }
-});
+      return {
+        tools: "added",
+        note: loose ? `the file's comments are kept in ${path3.basename(kept)}` : void 0
+      };
+    },
+    byHand: (command) => `${label}: add this inside "mcpServers" in ${target()}
+    "${SERVER}": ${JSON.stringify(entry(command))}`
+  };
+};
 var TARGETS = [
   withCommand("Claude Code", "Claude", "claude", (command) => [
     "mcp",
@@ -37096,7 +37223,7 @@ async function setup(argv, host = realHost) {
   }
   const rows = found.map((target) => {
     try {
-      return { target, tools: target.register(host, command), note: "" };
+      return { target, note: "", ...target.register(host, command) };
     } catch (e) {
       return { target, tools: "failed", note: reason(e) };
     }
@@ -37150,30 +37277,49 @@ async function setup(argv, host = realHost) {
   for (const row of rows) {
     const tools = row.tools === "added" ? "tools added" : row.tools === "present" ? "tools already there" : `could not add the tools: ${row.note}`;
     const link = row.tools === "failed" ? void 0 : connection.get(row.target.agent);
-    host.say(`  ${row.target.label.padEnd(width)}  ${[tools, link].filter(Boolean).join(", ")}`);
+    const note = row.tools !== "failed" && row.note ? `(${row.note})` : void 0;
+    host.say(
+      `  ${row.target.label.padEnd(width)}  ${[tools, link].filter(Boolean).join(", ")}${note ? ` ${note}` : ""}`
+    );
   }
   host.say("");
+  const byHand = rows.filter((row) => row.tools === "failed" && row.target.byHand);
+  for (const row of byHand) host.say(row.target.byHand(command));
+  if (byHand.length) host.say("");
+  const working = rows.filter((row) => row.tools !== "failed");
   if (!code) {
-    host.say('To connect them: press "Connect your agent" in Symposium and run the line it shows.');
+    if (working.length) {
+      host.say(
+        'To connect them: press "Connect your agent" in Symposium and run the line it shows.'
+      );
+    }
     return failed ? 1 : 0;
   }
-  const ready = rows.filter(
-    (row) => row.tools !== "failed" && row.target.start && paired(row.target.agent)
-  );
+  const connected = working.filter((row) => paired(row.target.agent));
+  if (connected.length === 0) {
+    host.say(
+      'No agent was connected. Once the above is sorted out, press "Connect your agent" in Symposium again and run the new line.'
+    );
+    return 1;
+  }
+  const ready = connected.filter((row) => row.target.start);
   const chosen = ready.length ? await choose(
     host,
     ready.map((row) => row.target)
   ) : void 0;
   if (!chosen) {
-    host.say('Start a new session in any of them and say "join my meeting".');
+    host.say(
+      `Start a new session in ${oneOf(connected.map((row) => row.target.label))} and say "join my meeting".`
+    );
     return failed ? 1 : 0;
   }
   const [bin, ...args] = chosen.start(
-    code.space ? `Join my Symposium meeting in the space ${code.space}.` : "Join my Symposium meeting."
+    code.space && /^[\w .-]+$/.test(code.space) ? `Join my Symposium meeting in the space ${code.space}.` : "Join my Symposium meeting."
   );
   await host.open(bin, args);
   return failed ? 1 : 0;
 }
+var oneOf = (names) => names.length < 2 ? names.join("") : `${names.slice(0, -1).join(", ")} or ${names.at(-1)}`;
 async function choose(host, targets) {
   const question = targets.length === 1 ? `Open ${targets[0].label} in the meeting now? [Y/n] ` : `Open one in the meeting now? ${targets.map((t, i) => `${i + 1}) ${t.label}`).join("  ")}  [1, or n for none] `;
   const answer = (await host.ask(question))?.trim().toLowerCase();
@@ -37184,7 +37330,7 @@ async function choose(host, targets) {
 
 // src/wake.ts
 import { mkdirSync as mkdirSync2, readFileSync as readFileSync3, renameSync as renameSync2, writeFileSync as writeFileSync3 } from "node:fs";
-import path3 from "node:path";
+import path4 from "node:path";
 import { pathToFileURL } from "node:url";
 function wakeEvents(events, agentId, now, maxAgeMs) {
   return events.filter(
@@ -37201,8 +37347,8 @@ var minutes = (name, fallback) => {
 };
 function positionFile(client2) {
   const safe = (s) => s.replace(/[^\w-]/g, "_");
-  return path3.join(
-    path3.dirname(stateFile("")),
+  return path4.join(
+    path4.dirname(stateFile("")),
     `wake-${safe(client2.space)}-${safe(client2.agentId)}`
   );
 }
@@ -37217,7 +37363,7 @@ function readPosition(file3) {
 function savePosition(file3, position) {
   if (position === void 0) return;
   try {
-    mkdirSync2(path3.dirname(file3), { recursive: true, mode: 448 });
+    mkdirSync2(path4.dirname(file3), { recursive: true, mode: 448 });
     const temp = `${file3}.${process.pid}.tmp`;
     writeFileSync3(temp, String(position), { mode: 384 });
     renameSync2(temp, file3);
@@ -37290,7 +37436,7 @@ async function main() {
   console.error("Nothing arrived in time; start it again.");
   return 3;
 }
-if (process.argv[1] && path3.basename(process.argv[1]).startsWith("wake.") && import.meta.url === pathToFileURL(process.argv[1]).href) {
+if (process.argv[1] && path4.basename(process.argv[1]).startsWith("wake.") && import.meta.url === pathToFileURL(process.argv[1]).href) {
   main().then(
     (code) => process.exit(code),
     (e) => {
@@ -37376,6 +37522,10 @@ exits when a request arrives: if you can run background commands, start it whene
 stop calling wait_for_events (before ending your turn, or before a long piece of other
 work), and start it again after handling what it printed.
 
+Everyone in the space sees you as a small figure that shows what you are doing. Keep it
+true: pass \`doing\` (and \`surfaceId\` once there is one) to update_request while you
+work on a request, and call working_on for anything else you do in the space.
+
 When the user pastes a connect code \u2014 a line like "Connect to my Symposium: symc_\u2026" \u2014
 call connect with what they pasted, straight away. It links you to their account for
 good (and joins the space it was made in, if any).
@@ -37461,8 +37611,8 @@ async function enter(next, invite) {
     space: snap.id,
     ...snap.name ? { name: snap.name } : {},
     you: snap.agents.find((a) => a.id === target.agentId)?.name ?? target.agentId,
-    liveParticipants: snap.participants,
-    presence: snap.presence,
+    liveParticipants: withoutPhotos(snap.participants),
+    presence: withoutPhotos(snap.presence),
     surfaces: snap.surfaces.map((s) => ({ id: s.id, title: s.title })),
     ...unanswered.length ? {
       unansweredRequests: unanswered,
@@ -37475,6 +37625,7 @@ async function enter(next, invite) {
     remembered: remembered ? "Later sessions start in this space. No configuration change is needed." : "Could not save this space; later sessions will need to join again."
   };
 }
+var withoutPhotos = (people) => people.map((person) => ({ ...person, picture: void 0 }));
 var text = (value) => ({
   content: [
     {
@@ -37490,6 +37641,13 @@ var LINE_LABELS = {
   request: " (request to agents)",
   proposal: " (agent proposal)"
 };
+var DOING = 'The kind of work, which your figure in the room shows: "thinking" (working something out), "searching" (looking things up, reading), "writing" (text, the shared document), "drawing" (making an image or illustration), "charting" (charts, numbers, dashboards), "building" (putting a surface or other UI together).';
+var WORK_DOCUMENT = external_exports.string().optional().describe(
+  `The shared document this work is in, if any: its id from list_documents ("main" for the first). You are shown on that document's tab while you work.`
+);
+var WORK_SECTION = external_exports.string().max(200).optional().describe(
+  "With documentId: the text of the heading you are writing under. People see you beside that section in the document, which tells them not to type there while you work."
+);
 var fmtTime = (ts) => new Date(ts).toISOString().slice(0, 19).replace("T", " ");
 var server = new McpServer(
   { name: "symposium", version: "0.2.0" },
@@ -37654,14 +37812,15 @@ server.registerTool(
     const snap = await space().snapshot();
     return text({
       space: snap.id,
-      liveParticipants: snap.participants,
-      presence: snap.presence,
+      liveParticipants: withoutPhotos(snap.participants),
+      presence: withoutPhotos(snap.presence),
       surfaces: snap.surfaces.map((s) => ({
         id: s.id,
         title: s.title,
         by: s.agentName,
         state: s.state
       })),
+      documents: (snap.docs ?? []).map((d) => ({ id: d.id, title: d.title })),
       you: space().agentId,
       agents: snap.agents.map((a) => ({ id: a.id, name: a.name, owner: a.owner })),
       latestSeq: snap.seq
@@ -37823,7 +37982,7 @@ server.registerTool(
       "- request: someone asked agents to do something. `to` lists the agent ids it is for and `seq` is its id; if yours is in `to`, call update_request right away.",
       '- proposal_decided: a person approved or dismissed a proposal. If `agentId` is yours and `decision` is "approved", go ahead and report with update_proposal.',
       "- proposal: another agent offered to do something.",
-      "- doc_changed: the shared document changed (at most every 30 seconds); call read_document to see it.",
+      "- doc_changed: a shared document (`docId`, `title`) was edited (at most every 30 seconds per document), renamed or, with `created`, made; call read_document with that id to see it. doc_removed: one was removed.",
       "- speech, chat, message: what people said, what they typed, what other agents posted.",
       "- ui_event (meeting.emit from a surface), state_changed (surface state), surface_changed / surface_removed (another agent edited the stage).",
       'When you are connected to their account, it can instead return a `summons`: the user pressed "Bring my agent" in a space; join_space there.'
@@ -37888,38 +38047,73 @@ server.registerTool(
 server.registerTool(
   "bring_everyone_to",
   {
-    description: "Switch everyone's stage to one tab so they are all looking at the same thing: one surface (pass its id; it can be yours or another agent's) or the shared document. Each person sees a note saying you brought them there and can go back. With neither, it opens the conversation column for anyone who has closed it; the conversation is beside the stage, not a tab on it, so this is rarely needed. Use it sparingly: when you have just put up or updated something the whole room should look at now, or someone asked you to show something. Do not use it for every small update.",
+    description: "Switch everyone's stage to one tab so they are all looking at the same thing: one surface (pass its id; it can be yours or another agent's) or one shared document. Each person sees a note saying you brought them there and can go back. With neither, it opens the conversation column for anyone who has closed it; the conversation is beside the stage, not a tab on it, so this is rarely needed. Use it sparingly: when you have just put up or updated something the whole room should look at now, or someone asked you to show something. Do not use it for every small update.",
     inputSchema: {
       surfaceId: external_exports.string().optional().describe("Surface to show; omit to open the conversation"),
-      document: external_exports.boolean().optional().describe("Set true to show the shared document instead")
+      documentId: external_exports.string().optional().describe("A shared document to show instead: its id from list_documents"),
+      document: external_exports.boolean().optional().describe('Set true to show the first shared document ("main") instead')
     }
   },
-  async ({ surfaceId, document }) => {
+  async ({ surfaceId, documentId, document }) => {
     const result = await space().bringEveryoneTo(
-      document ? { kind: "document" } : surfaceId ? { kind: "surface", id: surfaceId } : { kind: "conversation" }
+      documentId || document ? { kind: "document", id: documentId || MAIN_DOC_ID } : surfaceId ? { kind: "surface", id: surfaceId } : { kind: "conversation" }
     );
     return text({ showing: result.target });
   }
 );
+var DOCUMENT = external_exports.string().optional().describe(
+  `Which document: its id from list_documents. Omit for the first one ("main"), the space's notes.`
+);
 server.registerTool(
-  "read_document",
+  "list_documents",
   {
-    description: "Read the space's shared document as Markdown. Everyone in the space can edit it together, in a meeting or between meetings; it is where notes, agendas, decisions and drafts live. Read it before editing so you know its headings.",
+    description: `List the shared documents in the space: each one's id and title, who made it, when it last changed, and which agent last wrote in it. Every space has the document "main" (its notes); people and agents add others beside it, each on its own tab of the stage.`,
     inputSchema: {}
   },
-  async () => text(await space().readDocument() || "(the document is empty)")
+  async () => text(
+    (await space().listDocuments()).map((d) => ({
+      id: d.id,
+      title: d.title,
+      ...d.createdBy ? { madeBy: d.createdBy.name } : {},
+      ...d.updatedAt ? { changed: fmtTime(d.updatedAt) } : {},
+      ...d.agentEdit ? { lastAgentEdit: d.agentEdit.name } : {}
+    }))
+  )
+);
+server.registerTool(
+  "create_document",
+  {
+    description: 'Add a shared document to the space, on a tab of its own, optionally with its first text in Markdown. Use it for a piece of writing that stands by itself (a draft, a brief, a write-up, minutes of one meeting) instead of putting it into the notes people are keeping in "main". Returns its id, which read_document, edit_document and bring_everyone_to take.',
+    inputSchema: {
+      title: external_exports.string().max(80).describe('Short tab title, e.g. "Launch brief"'),
+      markdown: external_exports.string().optional().describe("Its first text")
+    }
+  },
+  async ({ title, markdown }) => {
+    const doc = await space().createDocument({ title, markdown });
+    return text({ id: doc.id, title: doc.title });
+  }
+);
+server.registerTool(
+  "read_document",
+  {
+    description: "Read one of the space's shared documents as Markdown. Everyone in the space can edit them together, in a meeting or between meetings; they are where notes, agendas, decisions and drafts live. Read a document before editing it so you know its headings. People see you on the document's tab for a little while after you read it.",
+    inputSchema: { document: DOCUMENT }
+  },
+  async ({ document }) => text(await space().readDocument(document) || "(the document is empty)")
 );
 server.registerTool(
   "edit_document",
   {
-    description: 'Edit the shared document, in Markdown (headings, lists, bold, italic, links, quotes, code blocks). People may be typing in it at the same moment, so make the narrowest edit that does the job: "append" adds to the end; "replace_section" replaces everything under one heading, keeping the heading, and creates the section at the end if the heading does not exist yet; "replace_all" rewrites the whole document and should be used only when asked to. Returns the document after your edit.',
+    description: 'Edit a shared document, in Markdown (headings, lists, bold, italic, links, quotes, code blocks). People may be typing in it at the same moment, so make the narrowest edit that does the job: "append" adds to the end; "replace_section" replaces everything under one heading, keeping the heading, and creates the section at the end if the heading does not exist yet; "replace_all" rewrites the whole document and should be used only when asked to. Everyone sees what you added or changed marked as written by you until a person edits it; text you send back unchanged is not marked, so send the rest of a section back exactly as it was. Before you start composing anything that takes more than a moment, say where you are about to write with update_request (or working_on): doing "writing", `documentId` and, for replace_section, `section`. People then see you beside that section and know not to type in it. Returns the document after your edit.',
     inputSchema: {
+      document: DOCUMENT,
       op: external_exports.enum(DOC_EDIT_OPS),
       heading: external_exports.string().optional().describe("For replace_section: the text of the heading whose section to replace"),
       markdown: external_exports.string().describe("The new content")
     }
   },
-  async ({ op, heading, markdown }) => {
+  async ({ document, op, heading, markdown }) => {
     if (op === "replace_section" && !heading) {
       throw new Error(
         "replace_section needs `heading`: the text of the heading whose section to replace."
@@ -37927,11 +38121,23 @@ server.registerTool(
     }
     return text(
       await space().editDocument(
-        op === "replace_section" ? { op, heading, markdown } : { op, markdown }
+        op === "replace_section" ? { op, heading, markdown } : { op, markdown },
+        document
       )
     );
   }
 );
+server.registerTool(
+  "remove_document",
+  {
+    description: 'Remove a shared document you made, for good. You cannot remove documents other people or agents made, nor the first one ("main").',
+    inputSchema: { document: external_exports.string().describe("Its id from list_documents") }
+  },
+  async ({ document }) => {
+    await space().removeDocument(document);
+    return text({ removed: document });
+  }
+);
 server.registerTool(
   "propose",
   {
@@ -37967,18 +38173,59 @@ server.registerTool(
 server.registerTool(
   "update_request",
   {
-    description: 'Report progress on a request that was addressed to you (a `request` event from wait_for_events whose `to` includes your agent id; its `seq` is the id). Everyone in the meeting sees the status next to the request, so keep it current: call with "acknowledged" the moment you receive the request, "working" with a short note on what you are doing before each slow step, and finish with "done" (note: what you did or where to look) or "failed" (note: why). A request left without a final status keeps showing as in progress.',
+    description: 'Report progress on a request that was addressed to you (a `request` event from wait_for_events whose `to` includes your agent id; its `seq` is the id). Everyone in the meeting sees the status next to the request, and sees your figure in the room busy with it (several at once, if you are working on several), so keep it current: call with "acknowledged" the moment you receive the request, "working" with a short note on what you are doing before each slow step, and finish with "done" (note: what you did or where to look) or "failed" (note: why). A request left without a final status keeps showing as in progress.',
     inputSchema: {
       id: external_exports.number().int().describe("The request id: `seq` of the request event"),
       status: external_exports.enum(REQUEST_STATUSES),
-      note: external_exports.string().max(200).optional().describe("One short line shown next to the status")
+      note: external_exports.string().max(200).optional().describe("One short line shown next to the status"),
+      surfaceId: external_exports.string().optional().describe(
+        "The surface this work is on, if any. You are shown on that tab while you work, so people see where to look. Pass it once you have created or picked the surface."
+      ),
+      doing: external_exports.enum(WORK_KINDS).optional().describe(DOING),
+      documentId: WORK_DOCUMENT,
+      section: WORK_SECTION
     }
   },
-  async ({ id, status, note }) => {
-    const entry = await space().updateRequest(id, status, note);
+  async ({ id, status, note, surfaceId, doing, documentId, section }) => {
+    const entry = await space().updateRequest(
+      id,
+      status,
+      note,
+      surfaceId,
+      doing,
+      documentId ? { docId: documentId, section } : void 0
+    );
     return text({ request: entry.seq, status, to: entry.request?.to });
   }
 );
+server.registerTool(
+  "working_on",
+  {
+    description: "Show everyone in the space what you are doing right now, when it is not an answer to a request (for a request, update_request takes the same `doing`). Your figure in the room plays the matching animation, on the surface's tab if you name one. Call it before any piece of work that takes more than a few seconds (your person asked you for something in your own conversation, say), again when what you are doing changes, and with `done: true` when you finish; it lapses by itself after three minutes. To show several things at once, give each its own `key`.",
+    inputSchema: {
+      doing: external_exports.enum(WORK_KINDS).optional().describe(DOING),
+      note: external_exports.string().max(200).optional().describe("A few words on what it is"),
+      surfaceId: external_exports.string().optional().describe("The surface it is happening on, if any"),
+      documentId: WORK_DOCUMENT,
+      section: WORK_SECTION,
+      key: external_exports.string().max(40).optional().describe('Names this piece of work, when you have several at once (default "main")'),
+      done: external_exports.boolean().optional().describe("Set true when this piece of work is finished")
+    }
+  },
+  async ({ doing, note, surfaceId, documentId, section, key, done }) => {
+    if (done) return text(await space().setWork({ key, done: true }));
+    if (!doing) throw new Error(`working_on needs \`doing\`: one of ${WORK_KINDS.join(", ")}.`);
+    return text(
+      await space().setWork({
+        key,
+        doing,
+        note,
+        surfaceId,
+        ...documentId ? { docId: documentId, section } : {}
+      })
+    );
+  }
+);
 if (process.argv[2] === "setup") {
   process.exit(
     await setup(process.argv.slice(3)).catch((e) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "symposium-mcp",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "MCP server for Symposium: lets an agent join a meeting space and put interactive UI on its shared stage.",
   "license": "Apache-2.0",
   "type": "module",