drafted 1.11.38 → 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.' },
@@ -1064,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();
@@ -1115,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;
@@ -1489,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.38",
+  "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": [