letagents 0.7.0 → 0.8.0

package/dist/mcp/server.js

@@ -115,6 +115,36 @@ function toRoomState(input) {
         joined_via: input.joined_via,
     };
 }
+function toPublicRoomState(state) {
+    if (!state) {
+        return null;
+    }
+    return {
+        room_id: state.room_id,
+        code: state.code ?? null,
+        joined_via: state.joined_via,
+    };
+}
+function toPublicStoredRoomSession(session) {
+    if (!session) {
+        return null;
+    }
+    return {
+        room_id: session.room_id,
+        code: session.code ?? null,
+        joined_via: session.joined_via,
+        joined_at: session.joined_at,
+        last_seen_at: session.last_seen_at,
+        last_message_id: session.last_message_id ?? null,
+    };
+}
+function toPublicRoomResponse(response, fallbackRoomId) {
+    const { id: _legacyId, project_id: _legacyProjectId, ...rest } = response;
+    return {
+        ...rest,
+        room_id: typeof rest.room_id === "string" ? rest.room_id : fallbackRoomId,
+    };
+}
 function rememberRoom(state, lastMessageId) {
     currentRoom = state;
     saveRoomSession({
@@ -143,8 +173,8 @@ function touchCurrentRoom(lastMessageId) {
 function getTargetRoomId(roomId) {
     return roomId || currentRoom?.room_id || null;
 }
-function getTargetProjectId(projectId) {
-    return projectId || currentRoom?.project_id || null;
+function getFallbackProjectId() {
+    return currentRoom?.project_id ?? null;
 }
 function getLastMessageId(payload) {
     if (!payload || typeof payload !== "object") {
@@ -168,7 +198,7 @@ async function roomScopedApiCall(input) {
         }
     }
     if (!input.project_id) {
-        throw new Error("No room_id or project_id is available for this request.");
+        throw new Error("No room is available for this request.");
     }
     const result = await apiCall(input.project_path(input.project_id), input.options);
     if (input.room_id) {
@@ -248,6 +278,41 @@ async function joinRoomIdentifier(identifier, joinedVia) {
         },
     };
 }
+async function createInviteRoom() {
+    const project = await apiCall("/projects", { method: "POST" });
+    const roomId = typeof project.code === "string"
+        ? project.code
+        : typeof project.id === "string"
+            ? project.id
+            : "unknown-room";
+    const room = rememberRoom(toRoomState({
+        room_id: roomId,
+        project_id: typeof project.id === "string" ? project.id : null,
+        code: typeof project.code === "string" ? project.code : roomId,
+        joined_via: "join_code",
+    }));
+    await autoRegisterAgentIdentity();
+    return {
+        room,
+        response: toPublicRoomResponse(project, roomId),
+    };
+}
+async function joinInviteCode(code) {
+    const joined = await joinRoomIdentifier(code, "join_code");
+    await autoRegisterAgentIdentity();
+    return {
+        ...toPublicRoomResponse(joined.response, joined.room.room_id),
+        joined_via: "join_code",
+    };
+}
+async function joinNamedRoom(name) {
+    const joined = await joinRoomIdentifier(name, "join_room");
+    await autoRegisterAgentIdentity();
+    return {
+        ...toPublicRoomResponse(joined.response, joined.room.room_id),
+        joined_via: "join_room",
+    };
+}
 async function autoRegisterAgentIdentity() {
     if (!AGENT_NAME || !currentRoom) {
         return;
@@ -299,55 +364,52 @@ server.resource("room_messages", new ResourceTemplate("letagents://rooms/{room_i
         ],
     };
 });
-server.resource("project_messages", new ResourceTemplate("letagents://projects/{project_id}/messages", {
-    list: undefined,
-}), async (uri, { project_id }) => {
-    const result = await apiCall(`/projects/${encodeURIComponent(project_id)}/messages`);
+// -- create_room ------------------------------------------------------------
+server.tool("create_room", "Create a new invite room on Let Agents Chat. Returns the room ID and join code.", {}, async () => {
+    const created = await createInviteRoom();
     return {
-        contents: [
+        content: [
             {
-                uri: uri.href,
-                mimeType: "application/json",
-                text: JSON.stringify(result, null, 2),
+                type: "text",
+                text: JSON.stringify(created.response, null, 2),
             },
         ],
     };
 });
 // -- create_project ---------------------------------------------------------
-server.tool("create_project", "Create a new project on Let Agents Chat. Returns a project ID and a join code that other agents can use to join.", {}, async () => {
-    const project = await apiCall("/projects", { method: "POST" });
-    const roomId = typeof project.code === "string"
-        ? project.code
-        : typeof project.id === "string"
-            ? project.id
-            : "unknown-room";
-    rememberRoom(toRoomState({
-        room_id: roomId,
-        project_id: typeof project.id === "string" ? project.id : null,
-        code: typeof project.code === "string" ? project.code : roomId,
-        joined_via: "join_code",
-    }));
-    await autoRegisterAgentIdentity();
+server.tool("create_project", "Legacy alias for create_room. Creates a new invite room and returns its join code.", {}, async () => {
+    const created = await createInviteRoom();
     return {
         content: [
             {
                 type: "text",
-                text: JSON.stringify({ ...project, room_id: roomId }, null, 2),
+                text: JSON.stringify(created.response, null, 2),
+            },
+        ],
+    };
+});
+// -- join_code --------------------------------------------------------------
+server.tool("join_code", "Join an existing room using an invite code.", {
+    code: z.string().describe("The invite code shared for the room (e.g. 'ABCX-7291')"),
+}, async ({ code }) => {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(await joinInviteCode(code), null, 2),
             },
         ],
     };
 });
 // -- join_project -----------------------------------------------------------
-server.tool("join_project", "Join an existing Let Agents Chat project using a join code.", {
-    code: z.string().describe("The join code shared by the project creator (e.g. 'ABCX-7291')"),
+server.tool("join_project", "Legacy alias for join_code. Join an existing room using an invite code.", {
+    code: z.string().describe("The invite code shared for the room (e.g. 'ABCX-7291')"),
 }, async ({ code }) => {
-    const joined = await joinRoomIdentifier(code, "join_code");
-    await autoRegisterAgentIdentity();
     return {
         content: [
             {
                 type: "text",
-                text: JSON.stringify({ ...joined.response, joined_via: "join_code" }, null, 2),
+                text: JSON.stringify(await joinInviteCode(code), null, 2),
             },
         ],
     };
@@ -356,13 +418,11 @@ server.tool("join_project", "Join an existing Let Agents Chat project using a jo
 server.tool("join_room", "Join a named room on Let Agents Chat. Creates the room if it doesn't exist. Use this for repo-based room joining.", {
     name: z.string().describe("The room name to join (e.g. 'github.com/owner/repo')"),
 }, async ({ name }) => {
-    const joined = await joinRoomIdentifier(name, "join_room");
-    await autoRegisterAgentIdentity();
     return {
         content: [
             {
                 type: "text",
-                text: JSON.stringify({ ...joined.response, joined_via: "join_room" }, null, 2),
+                text: JSON.stringify(await joinNamedRoom(name), null, 2),
             },
         ],
     };
@@ -385,7 +445,7 @@ server.tool("get_current_room", "Get information about the currently joined room
                 type: "text",
                 text: JSON.stringify({
                     connected: true,
-                    ...currentRoom,
+                    ...toPublicRoomState(currentRoom),
                     auth: getStoredAuth()
                         ? {
                             source: process.env.LETAGENTS_TOKEN ? "env" : "local_state",
@@ -432,11 +492,11 @@ server.tool("check_repo", "Inspect the current repository context for Let Agents
                     config_file: configPath ?? null,
                     config_contents: configContents,
                     derived_room_from_git: derivedRoom ?? null,
-                    current_room: currentRoom ?? null,
+                    current_room: toPublicRoomState(currentRoom),
                     join_hint: !currentRoom
                         ? repoRoot
-                            ? "Run initialize_repo to set up .letagents.json, or join_room/join_project to connect."
-                            : "Not inside a git repo. Use join_project or join_room to connect manually."
+                            ? "Run initialize_repo to set up .letagents.json, or use join_room/join_code to connect."
+                            : "Not inside a git repo. Use create_room, join_code, or join_room to connect manually."
                         : null,
                 }, null, 2),
             },
@@ -454,13 +514,9 @@ server.tool("post_status", "Broadcast a lightweight status update to the current
         .string()
         .optional()
         .describe("Canonical room ID. Defaults to the current room."),
-    project_id: z
-        .string()
-        .optional()
-        .describe("Legacy project ID. Defaults to the current room if joined."),
-}, async ({ sender, status, room_id, project_id }) => {
+}, async ({ sender, status, room_id }) => {
     const targetRoomId = getTargetRoomId(room_id);
-    const targetProjectId = getTargetProjectId(project_id);
+    const targetProjectId = getFallbackProjectId();
     if (!targetRoomId && !targetProjectId) {
         return {
             content: [
@@ -468,8 +524,8 @@ server.tool("post_status", "Broadcast a lightweight status update to the current
                     type: "text",
                     text: JSON.stringify({
                         success: false,
-                        error: "No room_id or project_id provided and not currently in a room.",
-                        hint: "Join a room first with join_project or join_room, or pass room_id explicitly.",
+                        error: "No room_id provided and not currently in a room.",
+                        hint: "Join or create a room first, or pass room_id explicitly.",
                     }, null, 2),
                 },
             ],
@@ -509,7 +565,7 @@ const TASK_STATUSES = [
     "proposed", "accepted", "assigned", "in_progress",
     "blocked", "in_review", "merged", "done", "cancelled",
 ];
-server.tool("add_task", "Add a new task to the project board. Tasks normally start as 'proposed' and must be " +
+server.tool("add_task", "Add a new task to the room board. Tasks normally start as 'proposed' and must be " +
     "accepted before an agent can claim them, but tasks created by trusted agents already " +
     "active in the room may be auto-accepted. Use this when a human or agent identifies " +
     "work that needs to be done.", {
@@ -518,10 +574,9 @@ server.tool("add_task", "Add a new task to the project board. Tasks normally sta
     created_by: z.string().describe("Name of the agent or human creating the task"),
     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."),
-    project_id: z.string().optional().describe("Legacy project ID. Defaults to current room."),
-}, async ({ title, description, created_by, source_message_id, room_id, project_id }) => {
+}, async ({ title, description, created_by, source_message_id, room_id }) => {
     const targetRoomId = getTargetRoomId(room_id);
-    const targetProjectId = getTargetProjectId(project_id);
+    const targetProjectId = getFallbackProjectId();
     if (!targetRoomId && !targetProjectId) {
         return {
             content: [{ type: "text", text: JSON.stringify({ success: false, error: "Not in a room. Join one first." }) }],
@@ -541,16 +596,15 @@ server.tool("add_task", "Add a new task to the project board. Tasks normally sta
         content: [{ type: "text", text: JSON.stringify({ success: true, task }, null, 2) }],
     };
 });
-server.tool("get_board", "Get the current task board for the project. By default shows only open tasks " +
+server.tool("get_board", "Get the current task board for the room. By default shows only open tasks " +
     "(not done/cancelled). Agents should check this on startup and when idle to " +
     "see if there is unassigned work to claim.", {
     status: z.enum(TASK_STATUSES).optional().describe("Filter by specific status"),
     open_only: z.boolean().optional().describe("If true (default), only show tasks not done/cancelled"),
     room_id: z.string().optional().describe("Canonical room ID. Defaults to current room."),
-    project_id: z.string().optional().describe("Legacy project ID. Defaults to current room."),
-}, async ({ status, open_only, room_id, project_id }) => {
+}, async ({ status, open_only, room_id }) => {
     const targetRoomId = getTargetRoomId(room_id);
-    const targetProjectId = getTargetProjectId(project_id);
+    const targetProjectId = getFallbackProjectId();
     if (!targetRoomId && !targetProjectId) {
         return {
             content: [{ type: "text", text: JSON.stringify({ success: false, error: "Not in a room. Join one first." }) }],
@@ -578,10 +632,9 @@ server.tool("claim_task", "Claim an accepted task. The task must be in 'accepted
     task_id: z.string().describe("The task ID to claim, e.g. 'task_1'"),
     assignee: z.string().describe("Your agent name, e.g. 'antigravity'"),
     room_id: z.string().optional().describe("Canonical room ID. Defaults to current room."),
-    project_id: z.string().optional().describe("Legacy project ID. Defaults to current room."),
-}, async ({ task_id, assignee, room_id, project_id }) => {
+}, async ({ task_id, assignee, room_id }) => {
     const targetRoomId = getTargetRoomId(room_id);
-    const targetProjectId = getTargetProjectId(project_id);
+    const targetProjectId = getFallbackProjectId();
     if (!targetRoomId && !targetProjectId) {
         return {
             content: [{ type: "text", text: JSON.stringify({ success: false, error: "Not in a room." }) }],
@@ -616,10 +669,9 @@ server.tool("update_task", "Update a task's status or assignee. Status transitio
     assignee: z.string().optional().describe("New assignee for the task"),
     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."),
-    project_id: z.string().optional().describe("Legacy project ID. Defaults to current room."),
-}, async ({ task_id, status, assignee, pr_url, room_id, project_id }) => {
+}, async ({ task_id, status, assignee, pr_url, room_id }) => {
     const targetRoomId = getTargetRoomId(room_id);
-    const targetProjectId = getTargetProjectId(project_id);
+    const targetProjectId = getFallbackProjectId();
     if (!targetRoomId && !targetProjectId) {
         return {
             content: [{ type: "text", text: JSON.stringify({ success: false, error: "Not in a room." }) }],
@@ -652,10 +704,9 @@ 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."),
-    project_id: z.string().optional().describe("Legacy project ID. Defaults to current room."),
-}, async ({ task_id, pr_url, room_id, project_id }) => {
+}, async ({ task_id, pr_url, room_id }) => {
     const targetRoomId = getTargetRoomId(room_id);
-    const targetProjectId = getTargetProjectId(project_id);
+    const targetProjectId = getFallbackProjectId();
     if (!targetRoomId && !targetProjectId) {
         return {
             content: [{ type: "text", text: JSON.stringify({ success: false, error: "Not in a room." }) }],
@@ -799,7 +850,6 @@ server.tool("initialize_repo", "Initialize the current repo for Let Agents Chat
                         success: true,
                         created: configPath,
                         room_id: joined.room.room_id,
-                        project_id: joined.room.project_id ?? null,
                         code: joined.room.code ?? null,
                         joined: true,
                         hint: "Consider adding .letagents.json to git so other contributors auto-join the same room.",
@@ -830,12 +880,11 @@ server.tool("initialize_repo", "Initialize the current repo for Let Agents Chat
 // -- send_message -----------------------------------------------------------
 server.tool("send_message", "Send a message to a Let Agents Chat room.", {
     room_id: z.string().optional().describe("Canonical room ID. Defaults to the current room."),
-    project_id: z.string().optional().describe("Legacy project ID. Defaults to the current room."),
     sender: z.string().describe("Name identifying the sending agent (e.g. 'antigravity-agent')"),
     text: z.string().describe("The message text to send"),
-}, async ({ room_id, project_id, sender, text }) => {
+}, async ({ room_id, sender, text }) => {
     const targetRoomId = getTargetRoomId(room_id);
-    const targetProjectId = getTargetProjectId(project_id);
+    const targetProjectId = getFallbackProjectId();
     if (!targetRoomId && !targetProjectId) {
         throw new Error("No room is currently selected. Join a room first or pass room_id.");
     }
@@ -862,10 +911,9 @@ server.tool("send_message", "Send a message to a Let Agents Chat room.", {
 // -- read_messages ----------------------------------------------------------
 server.tool("read_messages", "Read all messages from a Let Agents Chat room.", {
     room_id: z.string().optional().describe("Canonical room ID. Defaults to the current room."),
-    project_id: z.string().optional().describe("Legacy project ID. Defaults to the current room."),
-}, async ({ room_id, project_id }) => {
+}, async ({ room_id }) => {
     const targetRoomId = getTargetRoomId(room_id);
-    const targetProjectId = getTargetProjectId(project_id);
+    const targetProjectId = getFallbackProjectId();
     const result = await roomScopedApiCall({
         room_id: targetRoomId,
         project_id: targetProjectId,
@@ -886,7 +934,6 @@ const MAX_POLL_TIMEOUT_MS = 180000; // 3 minutes
 const DEFAULT_POLL_TIMEOUT_MS = 30000; // 30 seconds
 server.tool("wait_for_messages", "Wait for new messages in a Let Agents Chat room. Blocks until new messages arrive or 30 seconds elapse. Use the after_message_id parameter to only receive messages newer than a specific message.", {
     room_id: z.string().optional().describe("Canonical room ID. Defaults to the current room."),
-    project_id: z.string().optional().describe("Legacy project ID. Defaults to the current room."),
     after_message_id: z
         .string()
         .optional()
@@ -895,9 +942,9 @@ server.tool("wait_for_messages", "Wait for new messages in a Let Agents Chat roo
         .number()
         .optional()
         .describe("Maximum wait time in milliseconds. If set to 0, the default timeout will be used."),
-}, async ({ room_id, project_id, after_message_id, timeout }) => {
+}, async ({ room_id, after_message_id, timeout }) => {
     const targetRoomId = getTargetRoomId(room_id);
-    const targetProjectId = getTargetProjectId(project_id);
+    const targetProjectId = getFallbackProjectId();
     const serverTimeout = Math.min(Math.max(timeout || DEFAULT_POLL_TIMEOUT_MS, 1000), MAX_POLL_TIMEOUT_MS);
     const clientTimeout = serverTimeout + 5000; // 5s buffer over server timeout
     const params = new URLSearchParams();
@@ -962,8 +1009,8 @@ server.tool("get_onboarding_status", "Inspect local Let Agents MCP auth and room
                     account: storedAuth?.account ?? null,
                     token_expires_at: storedAuth?.expires_at ?? null,
                     pending_device_auth: pendingAuth,
-                    current_room: currentRoom,
-                    saved_current_room: savedCurrentRoom,
+                    current_room: toPublicRoomState(currentRoom),
+                    saved_current_room: toPublicStoredRoomSession(savedCurrentRoom),
                     detected_room_from_context: detectedRoom,
                     repo_root: repoRoot,
                     next_step: nextStep,
@@ -1197,7 +1244,7 @@ server.tool("check_repo_visibility", "Auto-detect the current repo's git remote
                     type: "text",
                     text: JSON.stringify({
                         error: "Not in a git repository or no remote configured",
-                        suggestion: "Use create_project to create an invite room instead",
+                        suggestion: "Use create_room to create an invite room instead",
                     }, null, 2),
                 },
             ],
@@ -1243,7 +1290,7 @@ async function main() {
             return;
         }
         // 4. No context found
-        console.error("ℹ️ No .letagents.json, git remote, or saved room found — use join_project or join_room to connect.");
+        console.error("ℹ️ No .letagents.json, git remote, or saved room found — use create_room, join_code, or join_room to connect.");
     }
     catch (err) {
         // Auto-join failure should never block the MCP server

package/package.json

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