letagents 0.10.0 → 0.11.1

package/dist/mcp/codenames.js

@@ -0,0 +1,154 @@
+/**
+ * Agent codenames — extracted from server.ts per Emmy's directive.
+ *
+ * Each agent instance gets a two-word codename (e.g. "River Valley")
+ * deterministically derived from its runtime key via SHA-256 hashing.
+ */
+import { createHash } from "crypto";
+import { toTitleCaseCodename } from "../shared/agent-identity.js";
+// ---------------------------------------------------------------------------
+// Codenames
+// ---------------------------------------------------------------------------
+export const AGENT_CODENAMES = [
+    "amber",
+    "anchor",
+    "autumn",
+    "badger",
+    "bay",
+    "bear",
+    "brook",
+    "calm",
+    "canyon",
+    "cedar",
+    "clear",
+    "cloud",
+    "comet",
+    "copper",
+    "creek",
+    "crisp",
+    "crest",
+    "dawn",
+    "delta",
+    "dune",
+    "ember",
+    "falcon",
+    "fern",
+    "field",
+    "firefly",
+    "fjord",
+    "forest",
+    "fox",
+    "garden",
+    "glade",
+    "golden",
+    "granite",
+    "grove",
+    "harbor",
+    "hawk",
+    "hollow",
+    "indigo",
+    "ivory",
+    "jade",
+    "juniper",
+    "lagoon",
+    "lake",
+    "lantern",
+    "leaf",
+    "lively",
+    "lunar",
+    "lynx",
+    "maple",
+    "marsh",
+    "meadow",
+    "mesa",
+    "misty",
+    "moon",
+    "morrow",
+    "moss",
+    "noble",
+    "oak",
+    "olive",
+    "opal",
+    "otter",
+    "owl",
+    "peak",
+    "pearl",
+    "pine",
+    "quiet",
+    "raven",
+    "reef",
+    "ridge",
+    "river",
+    "rook",
+    "sage",
+    "scarlet",
+    "shore",
+    "silver",
+    "sky",
+    "solar",
+    "sparrow",
+    "spring",
+    "star",
+    "stone",
+    "storm",
+    "summit",
+    "sun",
+    "sunlit",
+    "swift",
+    "thicket",
+    "tidal",
+    "timber",
+    "trail",
+    "valley",
+    "verdant",
+    "vista",
+    "warm",
+    "wave",
+    "west",
+    "wild",
+    "willow",
+    "wind",
+    "winter",
+    "wolf",
+    "wood",
+    "wren",
+];
+export const AGENT_CODENAME_SPACE = AGENT_CODENAMES.length * AGENT_CODENAMES.length;
+// ---------------------------------------------------------------------------
+// Slug helpers
+// ---------------------------------------------------------------------------
+export function normalizeSlugSegment(input, fallback) {
+    const normalized = input
+        .normalize("NFKD")
+        .replace(/[^\x00-\x7F]/g, "")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .replace(/-{2,}/g, "-");
+    return normalized || fallback;
+}
+export function normalizeAgentBaseName(input) {
+    return normalizeSlugSegment(input, "agent").replace(/-agent$/, "") || "agent";
+}
+// ---------------------------------------------------------------------------
+// Codename derivation
+// ---------------------------------------------------------------------------
+export function hashStringToIndex(value, modulo) {
+    const digest = createHash("sha256").update(value).digest();
+    return digest.readUInt32BE(0) % modulo;
+}
+export function codenameFromIndex(index) {
+    const normalizedIndex = ((index % AGENT_CODENAME_SPACE) + AGENT_CODENAME_SPACE) % AGENT_CODENAME_SPACE;
+    const firstIndex = Math.floor(normalizedIndex / AGENT_CODENAMES.length);
+    const secondIndex = normalizedIndex % AGENT_CODENAMES.length;
+    const first = AGENT_CODENAMES[firstIndex];
+    const second = AGENT_CODENAMES[secondIndex];
+    return {
+        name: normalizeAgentBaseName(`${first}-${second}`),
+        display_name: `${toTitleCaseCodename(first)} ${toTitleCaseCodename(second)}`,
+    };
+}
+export function pickLocalCodename(runtimeKey, offset = 0) {
+    const index = hashStringToIndex(runtimeKey, AGENT_CODENAME_SPACE) + offset;
+    return codenameFromIndex(index);
+}

package/dist/mcp/local-state.js

@@ -157,6 +157,12 @@ export function getStoredAgentIdentity(identityKey) {
         if (scoped) {
             return scoped;
         }
+        // For UUID-based identity keys, do NOT fall back to the shared global
+        // agent_identity — that would cause different processes to inherit each
+        // other's identity. Only legacy (non-UUID) keys use the global fallback.
+        if (identityKey.startsWith("instance:")) {
+            return null;
+        }
     }
     return state.agent_identity ?? null;
 }

package/dist/mcp/server.js

@@ -2,7 +2,7 @@
 import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
-import { createHash } from "crypto";
+import { createHash, randomUUID } from "crypto";
 import { writeFileSync, existsSync } from "fs";
 import { userInfo } from "os";
 import { join, dirname } from "path";
@@ -10,6 +10,7 @@ import { execSync } from "child_process";
 import { SseClient } from "./sse-client.js";
 import { getRoomFromConfig } from "./config-reader.js";
 import { getGitRemoteIdentity } from "./git-remote.js";
+import { AGENT_CODENAME_SPACE, normalizeSlugSegment, normalizeAgentBaseName, pickLocalCodename, } from "./codenames.js";
 import { clearPendingDeviceAuth, clearStoredAuth, getLocalStatePath, getPendingDeviceAuth, getStoredAgentIdentity, getStoredAuth, getStoredCurrentRoom, getStoredRoomSession, saveRoomSession, setStoredAgentIdentity, setPendingDeviceAuth, setStoredAuth, touchRoomSession, updateLocalState, } from "./local-state.js";
 import { encodeRoomIdPath, getCanonicalRoomWebPath, looksLikeInviteCode, normalizeInviteCode, } from "./room-id.js";
 import { buildAgentActorLabel, formatOwnerAttribution, inferAgentIdeLabel, toTitleCaseCodename, } from "../shared/agent-identity.js";
@@ -28,8 +29,9 @@ const AGENT_DISPLAY_NAME = (process.env.LETAGENTS_AGENT_DISPLAY_NAME || "").trim
 const AGENT_IDE_LABEL = (process.env.LETAGENTS_AGENT_IDE || process.env.AGENT_IDE || "").trim();
 const AGENT_OWNER_LABEL = (process.env.LETAGENTS_AGENT_OWNER_LABEL || "").trim();
 const EXPLICIT_AGENT_IDENTITY_KEY = getExplicitAgentIdentityStorageKey();
+const AGENT_INSTANCE_UUID = randomUUID();
 currentAgentIdentityKey =
-    EXPLICIT_AGENT_IDENTITY_KEY ?? getFallbackAgentIdentityNamespaceKey(detectAgentIdeLabel());
+    EXPLICIT_AGENT_IDENTITY_KEY ?? `instance:${AGENT_INSTANCE_UUID}`;
 currentAgentIdentity = getStoredAgentIdentity(currentAgentIdentityKey);
 // ---------------------------------------------------------------------------
 // Helpers
@@ -47,130 +49,15 @@ function readCommandOutput(command, cwd = process.cwd()) {
         return null;
     }
 }
-function normalizeSlugSegment(input, fallback) {
-    const normalized = input
-        .normalize("NFKD")
-        .replace(/[^\x00-\x7F]/g, "")
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, "-")
-        .replace(/^-+|-+$/g, "")
-        .replace(/-{2,}/g, "-");
-    return normalized || fallback;
-}
-function normalizeAgentBaseName(input) {
-    return normalizeSlugSegment(input, "agent").replace(/-agent$/, "") || "agent";
-}
+// normalizeSlugSegment, normalizeAgentBaseName, AGENT_CODENAMES,
+// AGENT_CODENAME_SPACE, hashStringToIndex, codenameFromIndex,
+// pickLocalCodename — all imported from ./codenames.js
 function isCodexRuntime() {
     return Boolean(process.env.CODEX_THREAD_ID ||
         process.env.CODEX_SHELL ||
         process.env.CODEX_CI ||
         process.env.CODEX_INTERNAL_ORIGINATOR_OVERRIDE);
 }
-const AGENT_CODENAMES = [
-    "amber",
-    "anchor",
-    "autumn",
-    "badger",
-    "bay",
-    "bear",
-    "brook",
-    "calm",
-    "canyon",
-    "cedar",
-    "clear",
-    "cloud",
-    "comet",
-    "copper",
-    "creek",
-    "crisp",
-    "crest",
-    "dawn",
-    "delta",
-    "dune",
-    "ember",
-    "falcon",
-    "fern",
-    "field",
-    "firefly",
-    "fjord",
-    "forest",
-    "fox",
-    "garden",
-    "glade",
-    "golden",
-    "granite",
-    "grove",
-    "harbor",
-    "hawk",
-    "hollow",
-    "indigo",
-    "ivory",
-    "jade",
-    "juniper",
-    "lagoon",
-    "lake",
-    "lantern",
-    "leaf",
-    "lively",
-    "lunar",
-    "lynx",
-    "maple",
-    "marsh",
-    "meadow",
-    "mesa",
-    "misty",
-    "moon",
-    "morrow",
-    "moss",
-    "noble",
-    "oak",
-    "olive",
-    "opal",
-    "otter",
-    "owl",
-    "peak",
-    "pearl",
-    "pine",
-    "quiet",
-    "raven",
-    "reef",
-    "ridge",
-    "river",
-    "rook",
-    "sage",
-    "scarlet",
-    "shore",
-    "silver",
-    "sky",
-    "solar",
-    "sparrow",
-    "spring",
-    "star",
-    "stone",
-    "storm",
-    "summit",
-    "sun",
-    "sunlit",
-    "swift",
-    "thicket",
-    "tidal",
-    "timber",
-    "trail",
-    "valley",
-    "verdant",
-    "vista",
-    "warm",
-    "wave",
-    "west",
-    "wild",
-    "willow",
-    "wind",
-    "winter",
-    "wolf",
-    "wood",
-    "wren",
-];
-const AGENT_CODENAME_SPACE = AGENT_CODENAMES.length * AGENT_CODENAMES.length;
 const AGENT_IDENTITY_SLOT_SUFFIX = ":slot:";
 function getExplicitAgentIdentityStorageKey() {
     const runtimeSignals = [
@@ -188,21 +75,6 @@ function getExplicitAgentIdentityStorageKey() {
 function getFallbackAgentIdentityNamespaceKey(ideLabel) {
     return `cwd:${process.cwd()}:ide:${normalizeAgentBaseName(ideLabel)}`;
 }
-function hashStringToIndex(value, modulo) {
-    const digest = createHash("sha256").update(value).digest();
-    return digest.readUInt16BE(0) % modulo;
-}
-function codenameFromIndex(index) {
-    const normalizedIndex = ((index % AGENT_CODENAME_SPACE) + AGENT_CODENAME_SPACE) % AGENT_CODENAME_SPACE;
-    const firstIndex = Math.floor(normalizedIndex / AGENT_CODENAMES.length);
-    const secondIndex = normalizedIndex % AGENT_CODENAMES.length;
-    const first = AGENT_CODENAMES[firstIndex];
-    const second = AGENT_CODENAMES[secondIndex];
-    return {
-        name: normalizeAgentBaseName(`${first}-${second}`),
-        display_name: `${toTitleCaseCodename(first)} ${toTitleCaseCodename(second)}`,
-    };
-}
 function detectAgentIdeLabel() {
     if (AGENT_IDE_LABEL) {
         return toTitleCaseCodename(AGENT_IDE_LABEL);
@@ -325,9 +197,12 @@ function ensureAgentIdentityKey(ideLabel) {
         currentAgentIdentity = getStoredAgentIdentity(currentAgentIdentityKey);
         return currentAgentIdentityKey;
     }
-    const claimed = claimFallbackIdentityKey(getFallbackAgentIdentityNamespaceKey(ideLabel));
-    currentAgentIdentityKey = claimed.identityKey;
-    currentAgentIdentity = claimed.identity;
+    // v1: Use per-instance UUID for guaranteed distinct identity.
+    // Each MCP process gets a unique UUID — no slot/PID coordination needed.
+    // Trade-off: process restart = new identity (accepted for v1).
+    const uuidKey = `instance:${AGENT_INSTANCE_UUID}`;
+    currentAgentIdentityKey = uuidKey;
+    currentAgentIdentity = getStoredAgentIdentity(currentAgentIdentityKey);
     return currentAgentIdentityKey;
 }
 async function getAuthenticatedAgentDirectory() {
@@ -372,10 +247,7 @@ function resolveExplicitAgentIdentity() {
     }
     return null;
 }
-function pickLocalCodename(runtimeKey, offset = 0) {
-    const index = hashStringToIndex(runtimeKey, AGENT_CODENAME_SPACE) + offset;
-    return codenameFromIndex(index);
-}
+// pickLocalCodename — imported from ./codenames.js
 async function resolveAgentName(authAvailable, identityKey) {
     const explicit = resolveExplicitAgentIdentity();
     if (explicit) {
@@ -509,6 +381,7 @@ function toPublicAgentIdentity(identity) {
         actor_label: identity.actor_label,
         canonical_key: identity.canonical_key ?? null,
         runtime_key: identity.runtime_key ?? null,
+        agent_instance_id: AGENT_INSTANCE_UUID,
         source: identity.source,
     };
 }
@@ -1991,7 +1864,11 @@ server.tool("poll_device_auth", "Poll a pending GitHub Device Flow request. On s
                     account: storedAuth.account ?? null,
                     expires_at: storedAuth.expires_at ?? null,
                     auto_joined_room: joinedRoom,
+                    ...(joinedRoom?.room_id
+                        ? withCanonicalRoomLink(joinedRoom.room_id, {})
+                        : {}),
                     agent_identity: toPublicAgentIdentity(agentIdentity),
+                    hint: "You can change your agent's display name anytime using the set_agent_name tool.",
                 }, null, 2),
             },
         ],
@@ -2015,6 +1892,95 @@ server.tool("clear_saved_auth", "Clear any locally saved LetAgents auth token an
         ],
     };
 });
+server.tool("set_agent_name", "Set or change the agent's display name. The agent will be known by this name in the room. Use this to pick a custom name instead of the auto-generated codename.", {
+    name: z
+        .string()
+        .min(2)
+        .max(64)
+        .describe("The desired display name for this agent (2-64 characters)."),
+}, async ({ name: desiredName }) => {
+    const trimmedName = desiredName.trim();
+    if (trimmedName.length < 2 || trimmedName.length > 64) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ success: false, error: "Name must be between 2 and 64 characters." }, null, 2),
+                },
+            ],
+        };
+    }
+    const authAvailable = Boolean(getLetagentsToken());
+    if (!authAvailable) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ success: false, error: "Authentication required. Run start_device_auth first." }, null, 2),
+                },
+            ],
+        };
+    }
+    const slugName = normalizeAgentBaseName(trimmedName);
+    try {
+        const owner = await resolveOwnerContext();
+        const registered = await apiCall("/agents", {
+            method: "POST",
+            body: JSON.stringify({
+                name: slugName,
+                display_name: trimmedName,
+                owner_label: owner.label,
+            }),
+        });
+        const ideLabel = detectAgentIdeLabel();
+        const ownerAttribution = formatOwnerAttribution(owner.label);
+        const actorLabel = buildAgentActorLabel({
+            display_name: trimmedName,
+            owner_label: owner.label,
+            ide_label: ideLabel,
+        });
+        const updatedIdentity = {
+            name: slugName,
+            display_name: trimmedName,
+            owner_label: owner.label,
+            owner_attribution: ownerAttribution,
+            ide_label: ideLabel,
+            actor_label: actorLabel,
+            canonical_key: typeof registered.canonical_key === "string"
+                ? registered.canonical_key
+                : owner.login ? `${owner.login}/${slugName}` : null,
+            runtime_key: currentAgentIdentityKey,
+            source: "api",
+            resolved_at: new Date().toISOString(),
+        };
+        currentAgentIdentity = setStoredAgentIdentity(updatedIdentity, currentAgentIdentityKey);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: true,
+                        message: `Agent name changed to "${trimmedName}".`,
+                        agent_identity: toPublicAgentIdentity(currentAgentIdentity),
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: false,
+                        error: `Failed to set name: ${error instanceof Error ? error.message : String(error)}`,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+});
 server.tool("resume_room_session", "Rejoin the last locally saved room context, or a specific saved room, after a restart. This recreates participation in the room; it does not preserve a prior server-side session ID.", {
     room_id: z
         .string()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "letagents",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "description": "Let Agents Chat — MCP server for AI agent communication",
   "type": "module",
   "main": "dist/mcp/server.js",