drafted 1.11.37 → 1.12.0

package/mcp/server.mjs

@@ -215,6 +215,9 @@ const TOOL_ANNOTATIONS = {
   // Auth — initiates external browser / email flows
   auth:                { title: 'Sign in',             readOnlyHint: false, destructiveHint: false, openWorldHint: true,  description: 'Sign in to Drafted. `action=get_link` returns a URL immediately and starts background approval polling; after the user opens the link, later Drafted tool calls also auto-consume the approved login. `action=login` opens a browser when needed and explicitly waits/polls for approval.' },
 
+  // Identity — read-only introspection of THIS agent's session
+  whoami:              { title: 'Session identity',    readOnlyHint: true,  destructiveHint: false, openWorldHint: false, description: 'Return THIS agent session\'s identity: its server-assigned human-readable name + emoji (the correlation key between an agent window and its web-app session tab), sessionId, userId, orgId, active projectId, editor label, server URL, and surfaced/alive state. Read-only. Use this — not guesses from the host environment — to report which session you are.' },
+
   // Projects
   project:             { title: 'Projects',            readOnlyHint: false, destructiveHint: false, openWorldHint: false, widgetUri: 'ui://widget/drafted-canvas-overview.html', description: 'Manage projects: list (start here), open (switch active project), create, update, move to another org.' },
   get_org:             { title: 'Organization',        readOnlyHint: false, destructiveHint: false, openWorldHint: false, description: 'Get the active organization (action="get", default), Google Drive availability, or switch to a different org (action="switch", orgId=...). Use switch when you need wiki/skill work in an org that has no projects — opening a project also switches, but is unavailable in empty orgs. When googleDrive.connected is true, strongly prefer Google Workspace frames for documents, sheets, and slides.' },
@@ -515,26 +518,89 @@ function mcpMode() {
   return process.argv.includes('--http') ? 'http' : 'stdio';
 }
 
+// ponytail: reports that fail to send (e.g. server unreachable) queue here on disk
+// instead of dropping silently, and get retried on the next tool call.
+const PENDING_REPORTS_PATH = () => join(homedir(), '.drafted', 'pending-reports.jsonl');
+const MAX_PENDING_REPORTS = 50;
+
+function readPendingReports() {
+  try {
+    return readFileSync(PENDING_REPORTS_PATH(), 'utf8')
+      .split('\n')
+      .filter(Boolean)
+      .map((line) => { try { return JSON.parse(line); } catch { return null; } })
+      .filter(Boolean);
+  } catch {
+    return [];
+  }
+}
+
+function writePendingReports(reports) {
+  const reportsPath = PENDING_REPORTS_PATH();
+  if (!reports.length) {
+    try { unlinkSync(reportsPath); } catch { /* nothing to remove */ }
+    return;
+  }
+  try {
+    mkdirSync(dirname(reportsPath), { recursive: true });
+    writeFileSync(reportsPath, reports.slice(-MAX_PENDING_REPORTS).map((r) => JSON.stringify(r)).join('\n') + '\n', { mode: 0o600 });
+  } catch { /* best effort */ }
+}
+
+async function flushPendingReports(serverUrl) {
+  const pending = readPendingReports();
+  if (!pending.length) return;
+  const stillPending = [];
+  for (const body of pending) {
+    try {
+      await fetch(`${serverUrl}/api/installations/report`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', 'User-Agent': `Drafted MCP/${PACKAGE_VERSION}` },
+        body: JSON.stringify(body),
+      });
+    } catch {
+      stillPending.push(body);
+    }
+  }
+  writePendingReports(stillPending);
+}
+
+// Serializes all report sends/flushes so rapid back-to-back tool calls (the common
+// case during an outage, when a client retries repeatedly) don't race on a
+// read-modify-write of the same pending-reports file and drop queued events.
+let installReportChain = Promise.resolve();
+
+async function sendInstallationReport(serverUrl, body) {
+  await flushPendingReports(serverUrl);
+  try {
+    await fetch(`${serverUrl}/api/installations/report`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json', 'User-Agent': `Drafted MCP/${PACKAGE_VERSION}` },
+      body: JSON.stringify(body),
+    });
+  } catch {
+    writePendingReports([...readPendingReports(), body]);
+  }
+}
+
 function reportInstallationEvent(event, extra = {}) {
   const info = getInstallInfo();
   if (!info) return;
-  fetch(`${getServerUrl()}/api/installations/report`, {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json', 'User-Agent': `Drafted MCP/${PACKAGE_VERSION}` },
-    body: JSON.stringify({
-      installId: info.installId,
-      event,
-      schemaVersion: 1,
-      cliVersion: PACKAGE_VERSION,
-      osFamily: osFamily(),
-      osVersion: osRelease().slice(0, 60),
-      arch: normalizedArch(),
-      nodeVersion: process.version,
-      mcpMode: mcpMode(),
-      source: 'mcp',
-      ...extra,
-    }),
-  }).catch(() => {});
+  const serverUrl = getServerUrl();
+  const body = {
+    installId: info.installId,
+    event,
+    schemaVersion: 1,
+    cliVersion: PACKAGE_VERSION,
+    osFamily: osFamily(),
+    osVersion: osRelease().slice(0, 60),
+    arch: normalizedArch(),
+    nodeVersion: process.version,
+    mcpMode: mcpMode(),
+    source: 'mcp',
+    ...extra,
+  };
+  installReportChain = installReportChain.then(() => sendInstallationReport(serverUrl, body)).catch(() => {});
 }
 
 function classifyMcpError(error) {
@@ -1001,6 +1067,10 @@ function withProjectBreadcrumb(result) {
 
 let agentWs = null;
 let agentWsReconnectTimer = null;
+// Cached agent-hello-ack: this agent's own surface identity (name/emoji/alive) as
+// assigned by the server. The playful name is the correlation key between an agent
+// window and its web-app session tab; whoami reads it from here.
+let agentSurface = null;
 
 function setMcpActiveProject(projectId, meta = null) {
   const s = getState();
@@ -1052,6 +1122,21 @@ async function connectAgentWs() {
     }
   });
 
+  agentWs.on('message', (raw) => {
+    // agent-hello-ack carries this agent's server-assigned surface identity back on the
+    // owning connection. Cache it so whoami can report the name without a prod WS probe.
+    try {
+      const m = JSON.parse(raw.toString());
+      if (m.type === 'agent-hello-ack') {
+        agentSurface = {
+          sessionId: m.sessionId, userId: m.userId, orgId: m.orgId, projectId: m.projectId,
+          name: m.name, emoji: m.emoji, alive: m.alive, surfaced: true,
+          capturedAt: Date.now(),
+        };
+      }
+    } catch { /* ignore non-JSON / unexpected */ }
+  });
+
   agentWs.on('close', () => {
     console.error('[MCP-WS] Disconnected, reconnecting in 5s...');
     agentWs = null;
@@ -1426,6 +1511,53 @@ if (!isRemote) tool('auth', 'Sign in to Drafted. `action=get_link` returns a ver
   } catch (error) { return err(error); }
 });
 
+// Identity: report THIS agent session's own surface identity. The name/emoji come from
+// the agent-hello-ack cached on the WS; falls back to /auth/me for userId/org if the WS
+// ack hasn't landed yet. Read-only — no state changed.
+tool('whoami', 'Return THIS agent session\'s identity: its server-assigned human-readable name + emoji (the correlation key between an agent window and its web-app session tab), sessionId, userId, orgId, active projectId, editor label, server URL, and surfaced/alive state. Read-only.', {}, async () => {
+  try {
+    const server = getServerUrl();
+    const editor = (process.env.DRAFTED_AGENT_NAME || '').trim() || null;
+    const base = {
+      server,
+      editor,
+      agentLabel: getAgentLabel(),
+      sessionId: agentSurface?.sessionId || getState().sessionId || null,
+    };
+    if (agentSurface) {
+      return ok({
+        ...base,
+        userId: agentSurface.userId ?? null,
+        orgId: agentSurface.orgId ?? null,
+        projectId: agentSurface.projectId ?? null,
+        name: agentSurface.name,
+        emoji: agentSurface.emoji,
+        surfaced: true,
+        alive: !!agentSurface.alive,
+      });
+    }
+    // No WS ack yet — best-effort identity from /auth/me so callers still get a userId/org.
+    const sid = base.sessionId || getBootstrapSessionId();
+    let me = null;
+    if (sid) {
+      try {
+        const res = await fetch(`${server}/auth/me`, { headers: { Cookie: `gc_session=${sid}` } });
+        if (res.ok) me = await res.json();
+      } catch { /* not yet authenticated */ }
+    }
+    return ok({
+      ...base,
+      userId: me?.userId ?? null,
+      orgId: me?.currentOrg?.id ?? null,
+      projectId: getState().projectId ?? null,
+      name: null,
+      emoji: null,
+      surfaced: false,
+      alive: false,
+    });
+  } catch (error) { return err(error); }
+});
+
 // ── Project management tools (direct HTTP) ────────────────────────
 
 tool('project', 'START HERE for project management. Dispatch by `action`: list (lists all projects across all orgs — always call first), open (switch the active project; required before reading/writing frames), create (new project, optionally from a template), update (change name/folder/description/layers), move (transfer to another org). Opening a project auto-switches the org. To change orgs WITHOUT a project (for wiki/skill work in an empty org), use get_org(action="switch", orgId=...). **Skill gate:** projects with attached skills will REJECT all mutations (write, edit, mv, rm, shape, group, connector, layout, layer, asset upload) until you have loaded each attached skill via skill(action="load"). Skills tell you HOW to do the work — they\'re not optional. Open returns the attached skill list and auto-inlines content for projects with ≤3 skills.', {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drafted",
-  "version": "1.11.37",
+  "version": "1.12.0",
   "description": "Drafted — visual thinking surface for humans and AI agents. Renders HTML, markdown, images, and code as frames on a zoomable canvas, with MCP tools for AI agents and real-time sync for humans.",
   "type": "module",
   "files": [