letagents 0.7.0 → 0.8.1

package/dist/mcp/local-state.js

@@ -103,6 +103,7 @@ export function saveRoomSession(input) {
         room_id: input.room_id,
         project_id: input.project_id ?? existing?.project_id ?? null,
         code: input.code ?? existing?.code ?? null,
+        display_name: input.display_name ?? existing?.display_name ?? null,
         joined_via: input.joined_via,
         joined_at: existing?.joined_at ?? now,
         last_seen_at: now,

package/dist/mcp/server.js

@@ -64,6 +64,16 @@ class ApiError extends Error {
         this.body = body;
     }
 }
+class RepoRoomAuthRequiredError extends Error {
+    roomId;
+    pendingAuth;
+    constructor(roomId, pendingAuth) {
+        super(`Repo room '${roomId}' requires authentication. Device flow started: open ${pendingAuth.verification_uri} and enter code ${pendingAuth.user_code}, then run poll_device_auth.`);
+        this.name = "RepoRoomAuthRequiredError";
+        this.roomId = roomId;
+        this.pendingAuth = pendingAuth;
+    }
+}
 function getLetagentsToken() {
     return process.env.LETAGENTS_TOKEN || getStoredAuth()?.token || "";
 }
@@ -79,6 +89,34 @@ function isMissingRouteError(error) {
         (error.status === 404 || error.status === 405) &&
         /Cannot (GET|POST|PATCH)|Not Found|Cannot GET \/rooms|Cannot POST \/rooms/i.test(error.body));
 }
+function parseApiErrorPayload(error) {
+    if (!(error instanceof ApiError)) {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(error.body);
+        return parsed && typeof parsed === "object" ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function resolveApiPath(urlOrPath) {
+    if (!urlOrPath) {
+        return "/auth/device/start";
+    }
+    try {
+        const parsed = new URL(urlOrPath, `${API_URL}/`);
+        const apiBase = new URL(`${API_URL}/`);
+        if (parsed.origin !== apiBase.origin) {
+            return "/auth/device/start";
+        }
+        return `${parsed.pathname}${parsed.search}`;
+    }
+    catch {
+        return "/auth/device/start";
+    }
+}
 async function apiCall(path, options) {
     const headers = {
         "Content-Type": "application/json",
@@ -107,20 +145,90 @@ async function apiCall(path, options) {
     }
     return JSON.parse(body);
 }
+async function startPendingDeviceAuth(roomId, deviceFlowUrl) {
+    const existing = getPendingDeviceAuth();
+    if (existing?.suggested_room_id === roomId) {
+        return existing;
+    }
+    const response = await apiCall(resolveApiPath(deviceFlowUrl), {
+        method: "POST",
+    });
+    return setPendingDeviceAuth({
+        request_id: response.request_id,
+        user_code: response.user_code,
+        verification_uri: response.verification_uri,
+        interval_seconds: response.interval,
+        expires_at: new Date(Date.now() + response.expires_in * 1000).toISOString(),
+        started_at: new Date().toISOString(),
+        suggested_room_id: roomId,
+    });
+}
+async function maybeHandleRepoRoomAuthRequired(error, roomId) {
+    const payload = parseApiErrorPayload(error);
+    if (!(error instanceof ApiError) || error.status !== 401 || payload?.error !== "auth_required") {
+        return;
+    }
+    const pendingAuth = await startPendingDeviceAuth(roomId, typeof payload.device_flow_url === "string" ? payload.device_flow_url : undefined);
+    throw new RepoRoomAuthRequiredError(roomId, pendingAuth);
+}
+function toRepoRoomAuthRequiredResult(error) {
+    return {
+        success: false,
+        error: "auth_required",
+        room_id: error.roomId,
+        next_step: "poll_device_auth",
+        pending_device_auth: error.pendingAuth,
+        message: error.message,
+    };
+}
 function toRoomState(input) {
     return {
         room_id: input.room_id,
         project_id: input.project_id ?? null,
         code: input.code ?? null,
+        display_name: input.display_name ?? null,
         joined_via: input.joined_via,
     };
 }
+function toPublicRoomState(state) {
+    if (!state) {
+        return null;
+    }
+    return {
+        room_id: state.room_id,
+        code: state.code ?? null,
+        display_name: state.display_name ?? null,
+        joined_via: state.joined_via,
+    };
+}
+function toPublicStoredRoomSession(session) {
+    if (!session) {
+        return null;
+    }
+    return {
+        room_id: session.room_id,
+        code: session.code ?? null,
+        display_name: session.display_name ?? 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({
         room_id: state.room_id,
         project_id: state.project_id ?? null,
         code: state.code ?? null,
+        display_name: state.display_name ?? null,
         joined_via: state.joined_via,
         last_message_id: lastMessageId,
     });
@@ -143,8 +251,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") {
@@ -162,13 +270,14 @@ async function roomScopedApiCall(input) {
             return result;
         }
         catch (error) {
+            await maybeHandleRepoRoomAuthRequired(error, input.room_id);
             if (!input.project_id || !isMissingRouteError(error)) {
                 throw error;
             }
         }
     }
     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) {
@@ -191,6 +300,7 @@ async function joinRoomIdentifier(identifier, joinedVia) {
                 : looksLikeInviteCode(joinedRoomId)
                     ? joinedRoomId
                     : null,
+            display_name: typeof response.display_name === "string" ? response.display_name : null,
             joined_via: joinedVia,
         }));
         return {
@@ -199,6 +309,7 @@ async function joinRoomIdentifier(identifier, joinedVia) {
         };
     }
     catch (error) {
+        await maybeHandleRepoRoomAuthRequired(error, roomId);
         if (!isMissingRouteError(error)) {
             throw error;
         }
@@ -212,6 +323,7 @@ async function joinRoomIdentifier(identifier, joinedVia) {
             room_id: legacyRoomId,
             project_id: typeof project.id === "string" ? project.id : null,
             code: typeof project.code === "string" ? project.code : legacyRoomId,
+            display_name: typeof project.display_name === "string" ? project.display_name : null,
             joined_via: joinedVia,
         }));
         return {
@@ -237,6 +349,7 @@ async function joinRoomIdentifier(identifier, joinedVia) {
             : looksLikeInviteCode(legacyRoomId)
                 ? legacyRoomId
                 : null,
+        display_name: typeof project.display_name === "string" ? project.display_name : null,
         joined_via: joinedVia,
     }));
     return {
@@ -248,6 +361,42 @@ 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,
+        display_name: typeof project.display_name === "string" ? project.display_name : null,
+        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,101 +448,103 @@ 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_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')"),
+// -- 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 }) => {
-    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),
             },
         ],
     };
 });
-// -- join_room --------------------------------------------------------------
-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();
+// -- join_project -----------------------------------------------------------
+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 }) => {
     return {
         content: [
             {
                 type: "text",
-                text: JSON.stringify({ ...joined.response, joined_via: "join_room" }, null, 2),
+                text: JSON.stringify(await joinInviteCode(code), null, 2),
             },
         ],
     };
 });
-// -- get_current_room -------------------------------------------------------
-server.tool("get_current_room", "Get information about the currently joined room, including how it was joined.", {}, async () => {
-    if (!currentRoom) {
+// -- join_room --------------------------------------------------------------
+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 }) => {
+    try {
         return {
             content: [
                 {
                     type: "text",
-                    text: JSON.stringify({ connected: false, message: "Not currently in any room" }, null, 2),
+                    text: JSON.stringify(await joinNamedRoom(name), null, 2),
                 },
             ],
         };
     }
+    catch (error) {
+        if (error instanceof RepoRoomAuthRequiredError) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(toRepoRoomAuthRequiredResult(error), null, 2),
+                    },
+                ],
+            };
+        }
+        throw error;
+    }
+});
+// -- get_current_room -------------------------------------------------------
+server.tool("get_current_room", "Get information about the currently joined room, including how it was joined.", {}, async () => {
     return {
         content: [
             {
                 type: "text",
-                text: JSON.stringify({
-                    connected: true,
-                    ...currentRoom,
-                    auth: getStoredAuth()
-                        ? {
-                            source: process.env.LETAGENTS_TOKEN ? "env" : "local_state",
-                            expires_at: getStoredAuth()?.expires_at ?? null,
-                            account: getStoredAuth()?.account ?? null,
-                        }
-                        : null,
-                }, null, 2),
+                text: JSON.stringify(currentRoom
+                    ? {
+                        connected: true,
+                        ...toPublicRoomState(currentRoom),
+                        auth: getStoredAuth()
+                            ? {
+                                source: process.env.LETAGENTS_TOKEN ? "env" : "local_state",
+                                expires_at: getStoredAuth()?.expires_at ?? null,
+                                account: getStoredAuth()?.account ?? null,
+                            }
+                            : null,
+                    }
+                    : { connected: false, message: "Not currently in any room" }, null, 2),
             },
         ],
     };
@@ -432,11 +583,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 +605,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 +615,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 +656,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 +665,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 +687,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 +723,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 +760,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 +795,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 +941,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 +971,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 +1002,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 +1025,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 +1033,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 +1100,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,
@@ -1164,22 +1302,37 @@ server.tool("resume_room_session", "Rejoin the last locally saved room context,
             ],
         };
     }
-    const joined = await joinRoomIdentifier(savedRoom.room_id, savedRoom.joined_via);
-    await autoRegisterAgentIdentity();
-    return {
-        content: [
-            {
-                type: "text",
-                text: JSON.stringify({
-                    success: true,
-                    rejoined_from_local_state: true,
-                    server_session_resumed: false,
-                    last_message_id_before_restart: savedRoom.last_message_id ?? null,
-                    room: joined.room,
-                }, null, 2),
-            },
-        ],
-    };
+    try {
+        const joined = await joinRoomIdentifier(savedRoom.room_id, savedRoom.joined_via);
+        await autoRegisterAgentIdentity();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: true,
+                        rejoined_from_local_state: true,
+                        server_session_resumed: false,
+                        last_message_id_before_restart: savedRoom.last_message_id ?? null,
+                        room: joined.room,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        if (error instanceof RepoRoomAuthRequiredError) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(toRepoRoomAuthRequiredResult(error), null, 2),
+                    },
+                ],
+            };
+        }
+        throw error;
+    }
 });
 // -- check_repo_visibility --------------------------------------------------
 server.tool("check_repo_visibility", "Auto-detect the current repo's git remote and check if it's public or private. Returns the canonical key, provider, visibility, and suggested room type (discoverable for public, invite for private/unknown). Useful for deciding whether to auto-join a discoverable room or create an invite room.", {
@@ -1197,7 +1350,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,9 +1396,13 @@ 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) {
+        if (err instanceof RepoRoomAuthRequiredError) {
+            console.error(`🔐 Repo room auth required for '${err.roomId}'. Open ${err.pendingAuth.verification_uri} and enter code ${err.pendingAuth.user_code}, then run poll_device_auth.`);
+            return;
+        }
         // Auto-join failure should never block the MCP server
         console.error("⚠️ Auto-join failed (server still running):", err instanceof Error ? err.message : err);
     }

package/package.json

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