drafted 1.12.1 → 1.12.3

package/install-mcp.sh

@@ -207,9 +207,50 @@ fi
 
 init_telemetry
 
-mkdir -p "$HOME/.drafted/npm-global"
-npm config set prefix "$HOME/.drafted/npm-global" >/dev/null
-export PATH="$HOME/.drafted/npm-global/bin:$PATH"
+NPM_GLOBAL_PREFIX="$HOME/.drafted/npm-global"
+mkdir -p "$NPM_GLOBAL_PREFIX"
+
+# A `drafted` resolved elsewhere on PATH (a leftover install from before this
+# fixed-prefix scheme, or a manual `npm i -g` under the default prefix) would
+# permanently shadow the fixed-prefix copy: the updater keeps this prefix
+# current, but the shell keeps running the stale one. Remove it at its source.
+STALE_DRAFTED_BIN="$(command -v drafted 2>/dev/null || true)"
+if [ -n "$STALE_DRAFTED_BIN" ]; then
+  # Derived from where the resolved binary actually sits (bin's grandparent),
+  # not `npm config get prefix` — that reflects our own target prefix once
+  # it's already been set on a prior run, which would make this a no-op on
+  # every machine that's already installed once (i.e. every real machine).
+  CANDIDATE_PREFIX="$(dirname "$(dirname "$STALE_DRAFTED_BIN")")"
+  if [ "$CANDIDATE_PREFIX" != "$NPM_GLOBAL_PREFIX" ] && [ -d "$CANDIDATE_PREFIX/lib/node_modules/drafted" ]; then
+    echo -e "    ${YELLOW}Found a stale Drafted install at $CANDIDATE_PREFIX — removing it so it can't shadow the current one.${RESET}"
+    npm uninstall -g drafted --prefix "$CANDIDATE_PREFIX" >/dev/null 2>&1 || true
+  fi
+fi
+
+npm config set prefix "$NPM_GLOBAL_PREFIX" >/dev/null
+export PATH="$NPM_GLOBAL_PREFIX/bin:$PATH"
+
+# Persist the prefix's bin dir at the FRONT of PATH for future shells — without
+# this, npm's prefix config makes `npm install -g` land in the right place, but
+# a bare `drafted` in a new terminal keeps resolving through whatever was
+# already on PATH (see the installedVersion() comment on the login-shell PATH
+# gap below). Idempotent guarded block, same pattern as the agent-instructions
+# markers further down.
+persist_npm_global_path() {
+  local marker_begin="# BEGIN drafted-path"
+  local marker_end="# END drafted-path"
+  local line="export PATH=\"$NPM_GLOBAL_PREFIX/bin:\$PATH\""
+  local rc
+  case "$(basename "${SHELL:-}")" in
+    zsh) rc="$HOME/.zshrc" ;;
+    bash) rc="$HOME/.bash_profile" ;;
+    *) rc="$HOME/.profile" ;;
+  esac
+  [ -f "$rc" ] || : > "$rc"
+  grep -qF "$marker_begin" "$rc" 2>/dev/null && return 0
+  { echo ""; echo "$marker_begin"; echo "$line"; echo "$marker_end"; } >> "$rc"
+}
+persist_npm_global_path
 
 # ── Install ───────────────────────────────────────────────────────
 

package/mcp/server.mjs

@@ -200,7 +200,7 @@ IMPORTANT: Any URL containing /f/{uuid} is a Drafted frame link — ALWAYS use r
 }, {
   // Initialize instructions: the agent-identity contract, so an agent learns its own
   // tab name + the right way to read it WITHOUT having to "think to" call a tool.
-  instructions: `SESSION IDENTITY — read this first: you run as a NAMED session tab visible to the user on their Drafted surface. Your session has a human-readable name + emoji (e.g. "Sly Owl") — that name is how the user matches YOUR window to the tab they see, so identify yourself by it when it matters which agent you are. Read it from get_org (response field "session.name") or from the whoami tool; call whoami to refresh after a reconnect.`,
+  instructions: `SESSION IDENTITY — read this first: you run as a NAMED session tab visible to the user on their Drafted surface. Your session has a human-readable name (a Greek term, e.g. "Nous") — that name is how the user matches YOUR window to the tab they see, so identify yourself by it when it matters which agent you are. Read it from get_org (response field "session.name") or from the whoami tool; call whoami to refresh after a reconnect.`,
 });
 
 const layerKeys = Object.keys(LAYERS);
@@ -220,7 +220,7 @@ const TOOL_ANNOTATIONS = {
   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.' },
+  whoami:              { title: 'Session identity',    readOnlyHint: true,  destructiveHint: false, openWorldHint: false, description: 'Return THIS agent session\'s identity: its server-assigned human-readable name (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.' },
@@ -1071,7 +1071,7 @@ function withProjectBreadcrumb(result) {
 
 let agentWs = null;
 let agentWsReconnectTimer = null;
-// Cached agent-hello-ack: this agent's own surface identity (name/emoji/alive) as
+// Cached agent-hello-ack: this agent's own surface identity (name/capital/color/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;
@@ -1134,7 +1134,7 @@ async function connectAgentWs() {
       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,
+          name: m.name, capital: m.capital, color: m.color, alive: m.alive, surfaced: true,
           capturedAt: Date.now(),
         };
       }
@@ -1517,7 +1517,7 @@ if (!isRemote) tool('auth', 'Sign in to Drafted. `action=get_link` returns a ver
   } catch (error) { return err(error); }
 });
 
-// THIS-session surface identity: the playful name + emoji (correlation key between an
+// THIS-session surface identity: the session name + capital/color tile (correlation key between an
 // agent window and its web-app session tab), ids, and surfaced/alive state. Built from
 // the cached agent-hello-ack; falls back to /auth/me for userId/org before the first ack.
 // Shared by `whoami` AND surfaced in `get_org`'s response so an agent learns its name
@@ -1531,7 +1531,8 @@ async function sessionSurfaceBlock() {
       orgId: agentSurface.orgId ?? null,
       projectId: agentSurface.projectId ?? null,
       name: agentSurface.name,
-      emoji: agentSurface.emoji,
+      capital: agentSurface.capital,
+      color: agentSurface.color,
       surfaced: true,
       alive: !!agentSurface.alive,
     };
@@ -1551,14 +1552,15 @@ async function sessionSurfaceBlock() {
     orgId: me?.currentOrg?.id ?? null,
     projectId: getState().projectId ?? null,
     name: null,
-    emoji: null,
+    capital: null,
+    color: null,
     surfaced: false,
     alive: false,
   };
 }
 
 // Identity: report THIS agent session's own surface identity. 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 () => {
+tool('whoami', 'Return THIS agent session\'s identity: its server-assigned human-readable name (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 {
     return ok({
       server: getServerUrl(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drafted",
-  "version": "1.12.1",
+  "version": "1.12.3",
   "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": [