letagents 0.11.0 → 0.12.0

package/dist/mcp/codenames.js

@@ -135,7 +135,7 @@ export function normalizeAgentBaseName(input) {
 // ---------------------------------------------------------------------------
 export function hashStringToIndex(value, modulo) {
     const digest = createHash("sha256").update(value).digest();
-    return digest.readUInt16BE(0) % modulo;
+    return digest.readUInt32BE(0) % modulo;
 }
 export function codenameFromIndex(index) {
     const normalizedIndex = ((index % AGENT_CODENAME_SPACE) + AGENT_CODENAME_SPACE) % AGENT_CODENAME_SPACE;

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

@@ -18,6 +18,30 @@ let currentRoom = null;
 let currentAgentIdentityKey = "";
 let currentAgentIdentity = null;
 let currentAuthenticatedAccount = undefined;
+// ---------------------------------------------------------------------------
+// Conversation-scoped identity (Option C: per-conversation hints)
+// ---------------------------------------------------------------------------
+const MAX_CONVERSATION_IDENTITIES = 20;
+const conversationIdentities = new Map();
+/**
+ * Get or set a conversation-scoped identity override.
+ * Falls back to the global `currentAgentIdentity` when conversationId is absent.
+ */
+function getConversationIdentity(conversationId) {
+    if (!conversationId)
+        return currentAgentIdentity;
+    return conversationIdentities.get(conversationId) ?? currentAgentIdentity;
+}
+function setConversationIdentity(conversationId, identity) {
+    // LRU-style eviction: if at cap, remove oldest entry
+    if (!conversationIdentities.has(conversationId) &&
+        conversationIdentities.size >= MAX_CONVERSATION_IDENTITIES) {
+        const oldestKey = conversationIdentities.keys().next().value;
+        if (oldestKey !== undefined)
+            conversationIdentities.delete(oldestKey);
+    }
+    conversationIdentities.set(conversationId, identity);
+}
 let currentAuthenticatedAccountSource = null;
 let currentAuthenticatedEnvToken = null;
 // ---------------------------------------------------------------------------
@@ -996,7 +1020,12 @@ server.tool("join_room", "Join a named room on Let Agents Chat. Creates the room
     }
 });
 // -- get_current_room -------------------------------------------------------
-server.tool("get_current_room", "Get information about the currently joined room, including how it was joined.", {}, async () => {
+server.tool("get_current_room", "Get information about the currently joined room, including how it was joined.", {
+    conversation_id: z
+        .string()
+        .optional()
+        .describe("Optional conversation ID to report the conversation-scoped identity instead of the global one."),
+}, async ({ conversation_id }) => {
     return {
         content: [
             {
@@ -1005,7 +1034,9 @@ server.tool("get_current_room", "Get information about the currently joined room
                     ? {
                         connected: true,
                         ...toPublicRoomState(currentRoom),
-                        agent_identity: toPublicAgentIdentity(currentAgentIdentity ?? getStoredAgentIdentity(currentAgentIdentityKey)),
+                        agent_identity: toPublicAgentIdentity(getConversationIdentity(conversation_id)
+                            ?? currentAgentIdentity
+                            ?? getStoredAgentIdentity(currentAgentIdentityKey)),
                         auth: getStoredAuth()
                             ? {
                                 source: process.env.LETAGENTS_TOKEN ? "env" : "local_state",
@@ -1078,7 +1109,11 @@ server.tool("post_status", "Broadcast a lightweight status update to the current
         .string()
         .optional()
         .describe("Canonical room ID. Defaults to the current room."),
-}, async ({ sender: _sender, status, room_id }) => {
+    conversation_id: z
+        .string()
+        .optional()
+        .describe("Optional conversation ID for per-conversation identity scoping."),
+}, async ({ sender: _sender, status, room_id, conversation_id }) => {
     const targetRoomId = getTargetRoomId(room_id);
     const targetProjectId = getFallbackProjectId();
     if (!targetRoomId && !targetProjectId) {
@@ -1097,7 +1132,7 @@ server.tool("post_status", "Broadcast a lightweight status update to the current
     }
     // Status messages use a reserved prefix so the UI (and agents) can distinguish
     // them from normal chat messages without changing the data model.
-    const identity = await ensureAgentIdentity();
+    const identity = getConversationIdentity(conversation_id) ?? await ensureAgentIdentity();
     const sender = identity.actor_label;
     const statusText = `[status] ${status}`;
     const message = await roomScopedApiCall({
@@ -1144,7 +1179,8 @@ server.tool("add_task", "Add a new task to the room board. Tasks normally start
         .describe("Deprecated override. Agent identity is resolved automatically on room entry."),
     source_message_id: z.string().optional().describe("Optional message ID where task was agreed, e.g. 'msg_42'"),
     room_id: z.string().optional().describe("Canonical room ID. Defaults to current room."),
-}, async ({ title, description, created_by: _createdBy, source_message_id, room_id }) => {
+    conversation_id: z.string().optional().describe("Optional conversation ID for per-conversation identity scoping."),
+}, async ({ title, description, created_by: _createdBy, source_message_id, room_id, conversation_id }) => {
     const targetRoomId = getTargetRoomId(room_id);
     const targetProjectId = getFallbackProjectId();
     if (!targetRoomId && !targetProjectId) {
@@ -1152,7 +1188,7 @@ server.tool("add_task", "Add a new task to the room board. Tasks normally start
             content: [{ type: "text", text: JSON.stringify({ success: false, error: "Not in a room. Join one first." }) }],
         };
     }
-    const identity = await ensureAgentIdentity();
+    const identity = getConversationIdentity(conversation_id) ?? await ensureAgentIdentity();
     const task = await roomScopedApiCall({
         room_id: targetRoomId,
         project_id: targetProjectId,
@@ -1232,7 +1268,8 @@ server.tool("claim_task", "Claim an accepted task. The task must be in 'accepted
         .optional()
         .describe("Deprecated override. Agent identity is resolved automatically on room entry."),
     room_id: z.string().optional().describe("Canonical room ID. Defaults to current room."),
-}, async ({ task_id, assignee: _assignee, room_id }) => {
+    conversation_id: z.string().optional().describe("Optional conversation ID for per-conversation identity scoping."),
+}, async ({ task_id, assignee: _assignee, room_id, conversation_id }) => {
     const targetRoomId = getTargetRoomId(room_id);
     const targetProjectId = getFallbackProjectId();
     if (!targetRoomId && !targetProjectId) {
@@ -1241,7 +1278,7 @@ server.tool("claim_task", "Claim an accepted task. The task must be in 'accepted
         };
     }
     try {
-        const identity = await ensureAgentIdentity();
+        const identity = getConversationIdentity(conversation_id) ?? await ensureAgentIdentity();
         const updated = await roomScopedApiCall({
             room_id: targetRoomId,
             project_id: targetProjectId,
@@ -1278,7 +1315,8 @@ server.tool("update_task", "Update a task's status or assignee. Status transitio
         .describe("New assignee for the task. Defaults to the current agent when status=assigned."),
     pr_url: z.string().optional().describe("PR URL to link to the task"),
     room_id: z.string().optional().describe("Canonical room ID. Defaults to current room."),
-}, async ({ task_id, status, assignee, pr_url, room_id }) => {
+    conversation_id: z.string().optional().describe("Optional conversation ID for per-conversation identity scoping."),
+}, async ({ task_id, status, assignee, pr_url, room_id, conversation_id }) => {
     const targetRoomId = getTargetRoomId(room_id);
     const targetProjectId = getFallbackProjectId();
     if (!targetRoomId && !targetProjectId) {
@@ -1288,7 +1326,7 @@ server.tool("update_task", "Update a task's status or assignee. Status transitio
     }
     try {
         const identity = status === "assigned" && !assignee
-            ? await ensureAgentIdentity()
+            ? (getConversationIdentity(conversation_id) ?? await ensureAgentIdentity())
             : null;
         const updated = await roomScopedApiCall({
             room_id: targetRoomId,
@@ -1329,7 +1367,8 @@ server.tool("complete_task", "Submit a task for review. Moves the task to 'in_re
     task_id: z.string().describe("The task ID to submit for review"),
     pr_url: z.string().optional().describe("GitHub PR URL for the work"),
     room_id: z.string().optional().describe("Canonical room ID. Defaults to current room."),
-}, async ({ task_id, pr_url, room_id }) => {
+    conversation_id: z.string().optional().describe("Optional conversation ID for per-conversation identity scoping."),
+}, async ({ task_id, pr_url, room_id, conversation_id: _conversationId }) => {
     const targetRoomId = getTargetRoomId(room_id);
     const targetProjectId = getFallbackProjectId();
     if (!targetRoomId && !targetProjectId) {
@@ -1510,13 +1549,17 @@ server.tool("send_message", "Send a message to a Let Agents Chat room.", {
         .optional()
         .describe("Deprecated override. Agent identity is resolved automatically on room entry."),
     text: z.string().describe("The message text to send"),
-}, async ({ room_id, sender: _sender, text }) => {
+    conversation_id: z
+        .string()
+        .optional()
+        .describe("Optional conversation ID for per-conversation identity scoping."),
+}, async ({ room_id, sender: _sender, text, conversation_id }) => {
     const targetRoomId = getTargetRoomId(room_id);
     const targetProjectId = getFallbackProjectId();
     if (!targetRoomId && !targetProjectId) {
         throw new Error("No room is currently selected. Join a room first or pass room_id.");
     }
-    const identity = await ensureAgentIdentity();
+    const identity = getConversationIdentity(conversation_id) ?? await ensureAgentIdentity();
     const message = await roomScopedApiCall({
         room_id: targetRoomId,
         project_id: targetProjectId,
@@ -1898,7 +1941,11 @@ server.tool("set_agent_name", "Set or change the agent's display name. The agent
         .min(2)
         .max(64)
         .describe("The desired display name for this agent (2-64 characters)."),
-}, async ({ name: desiredName }) => {
+    conversation_id: z
+        .string()
+        .optional()
+        .describe("Optional conversation ID to scope this name change. When provided, only this conversation uses the new name; other conversations keep their own identity."),
+}, async ({ name: desiredName, conversation_id }) => {
     const trimmedName = desiredName.trim();
     if (trimmedName.length < 2 || trimmedName.length > 64) {
         return {
@@ -1924,14 +1971,6 @@ server.tool("set_agent_name", "Set or change the agent's display name. The agent
     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({
@@ -1939,6 +1978,22 @@ server.tool("set_agent_name", "Set or change the agent's display name. The agent
             owner_label: owner.label,
             ide_label: ideLabel,
         });
+        // When conversation_id is provided, skip server-side /agents registration
+        // to avoid creating stranded durable agent records from ephemeral renames.
+        let canonicalKey = owner.login ? `${owner.login}/${slugName}` : null;
+        if (!conversation_id) {
+            const registered = await apiCall("/agents", {
+                method: "POST",
+                body: JSON.stringify({
+                    name: slugName,
+                    display_name: trimmedName,
+                    owner_label: owner.label,
+                }),
+            });
+            if (typeof registered.canonical_key === "string") {
+                canonicalKey = registered.canonical_key;
+            }
+        }
         const updatedIdentity = {
             name: slugName,
             display_name: trimmedName,
@@ -1946,14 +2001,19 @@ server.tool("set_agent_name", "Set or change the agent's display name. The agent
             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,
+            canonical_key: canonicalKey,
             runtime_key: currentAgentIdentityKey,
-            source: "api",
+            source: conversation_id ? "local" : "api",
             resolved_at: new Date().toISOString(),
         };
-        currentAgentIdentity = setStoredAgentIdentity(updatedIdentity, currentAgentIdentityKey);
+        if (conversation_id) {
+            // Scope to this conversation only
+            setConversationIdentity(conversation_id, updatedIdentity);
+        }
+        else {
+            // Global rename (backward compatible)
+            currentAgentIdentity = setStoredAgentIdentity(updatedIdentity, currentAgentIdentityKey);
+        }
         return {
             content: [
                 {
@@ -1961,7 +2021,9 @@ server.tool("set_agent_name", "Set or change the agent's display name. The agent
                     text: JSON.stringify({
                         success: true,
                         message: `Agent name changed to "${trimmedName}".`,
-                        agent_identity: toPublicAgentIdentity(currentAgentIdentity),
+                        agent_identity: toPublicAgentIdentity(conversation_id
+                            ? getConversationIdentity(conversation_id)
+                            : currentAgentIdentity),
                     }, null, 2),
                 },
             ],

package/package.json

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