letagents 0.12.28 → 0.12.30

package/dist/mcp/server/runtime-contract.js

@@ -1,5 +1,6 @@
 import { registerTools } from "./register-tools.js";
 export const LETAGENTS_RUNTIME_CONTRACT_ARG = "--letagents-runtime-contract";
+export const LETAGENTS_RUNTIME_READINESS_URI = "letagents://runtime/readiness";
 /**
  * Discover through the production registration path rather than maintaining a
  * second capability list that can drift from the MCP server.
@@ -15,6 +16,16 @@ export function registeredToolNames(profile, supervisedProvider = null, apiUrl =
     registerTools(recorder, profile, supervisedProvider, { apiUrl });
     return [...names].sort();
 }
+/** Public capability metadata only; reading it grants no room or tool authority. */
+export function registerRuntimeReadinessResource(server, profile, supervisedProvider, apiUrl = process.env.LETAGENTS_API_URL) {
+    const text = JSON.stringify({
+        format: 1, profile, provider: supervisedProvider,
+        tools: registeredToolNames(profile, supervisedProvider, apiUrl),
+    });
+    server.resource("runtime_readiness", LETAGENTS_RUNTIME_READINESS_URI, { mimeType: "application/json" }, async (uri) => ({
+        contents: [{ uri: uri.href, mimeType: "application/json", text }],
+    }));
+}
 export function letAgentsRuntimeContract(apiUrl = process.env.LETAGENTS_API_URL) {
     return {
         format: 1,

package/dist/mcp/server/tools/tasks/board-intent-tools.js

@@ -170,7 +170,7 @@ export function registerBoardIntentTools(server) {
             return taskToolError(String(error));
         }
     });
-    server.tool("register_task_claim_intent", "Register intent to claim an accepted task as the current worker. Use the returned approval with claim_task.", {
+    server.tool("register_task_claim_intent", "Register intent to claim an accepted task as the current worker. Manager approval assigns the task and work lease immediately for authenticated workers; no second claim_task call is needed. Follow requires_follow_up only for legacy approvals.", {
         task_id: z.string().describe("Task id to claim, e.g. task_12."),
         ...workerTaskIdentitySchema,
     }, async ({ task_id, room_id, conversation_id: _conversation_id, agent_session_id }) => {
@@ -277,7 +277,7 @@ export function registerBoardIntentTools(server) {
             return taskToolError(String(error));
         }
     });
-    server.tool("approve_board_intent", "Approve a pending board intent. For task_create intents this creates the task immediately and returns result.kind=\"task_created\"; do not call add_task afterward. Other intent types notify the proposer to perform the exact follow-up with board_intent_id and their own worker session. The scoped approval token remains available for legacy callers; do not post it in room messages.", {
+    server.tool("approve_board_intent", "Approve a pending board intent. For task_create intents this creates the task immediately and returns result.kind=\"task_created\"; do not call add_task afterward. Authenticated-worker task_claim intents assign the task and work lease immediately with result.kind=\"task_claimed\" and requires_follow_up=false; do not call claim_task afterward. Other intents and legacy unverified claims require the exact follow-up with board_intent_id and the proposer's own worker session. The scoped approval token remains available for legacy callers; do not post it in room messages.", {
         intent_id: z.string().describe("Board intent id to approve."),
         reason: z.string().optional().describe("Short approval reason."),
         ...workerTaskIdentitySchema,

package/dist/mcp/server/tools/tasks/verdict-tools.js

@@ -5,7 +5,7 @@ import { resolveCanonicalRoomId, resolveCanonicalTaskToolIdentity, taskActorPayl
 import { jsonToolResponse, taskToolError } from "./response.js";
 import { taskReviewIdentitySchema } from "./schemas.js";
 export function registerTaskVerdictTools(server) {
-    server.tool("submit_review_verdict", "Submit a GitHub review verdict through the durable effect journal. Requires this exact worker session to hold an active review lease. Ambiguous provider outcomes are reconciled by correlation lookup and are never blindly retried.", {
+    server.tool("submit_review_verdict", "Submit a GitHub review verdict through the durable effect journal. Requires this exact worker session to hold an active review lease. Success means GitHub confirmed publication; pending, failed, or uncertain effects keep their original idempotency key. Ambiguous outcomes are reconciled by correlation lookup and are never blindly retried.", {
         task_id: z.string().describe("Task in review, e.g. 'task_1'."),
         verdict: z.enum(["approve", "request_changes", "comment"]).describe("GitHub review verdict."),
         body: z.string().max(65_536).optional().describe("Review explanation. Empty or junk blocking verdicts are quarantined."),
@@ -34,13 +34,26 @@ export function registerTaskVerdictTools(server) {
                     }),
                 },
             });
-            await syncRoomPresence(targetRoomId, identity, {
-                status: "reviewing",
-                status_text: `submitted ${verdict} verdict for ${task_id}`,
-            }, agentSession);
+            const published = result.effect.state === "succeeded";
+            const publicationStatus = published ? `published ${verdict} verdict for ${task_id}`
+                : result.effect.quarantined_at ? `review publication blocked for ${task_id}`
+                    : result.effect.state === "failed" ? `review publication failed for ${task_id}`
+                        : result.effect.state === "pending" ? `review publication pending for ${task_id}`
+                            : `review publication outcome unknown for ${task_id}`;
+            // Presence is a secondary notification. Its failure cannot erase an
+            // exact journal receipt or turn a known publication into a new retry.
+            try {
+                await syncRoomPresence(targetRoomId, identity, {
+                    status: "reviewing",
+                    status_text: publicationStatus,
+                }, agentSession);
+            }
+            catch { /* Return the durable effect even when presence is unavailable. */ }
             return jsonToolResponse({
-                success: true,
                 ...result,
+                success: published,
+                message: published ? "The review was published on GitHub."
+                    : `${publicationStatus}. The returned effect is the publication record; do not submit a new idempotency key to retry it.`,
                 agent_identity: toPublicAgentIdentity(identity),
             }, 2);
         }

package/dist/mcp/server.js

@@ -7,20 +7,22 @@ import { attachMcpServer, autoJoinFromContext, shutdownRuntime } from "./server/
 import { requireValidWorkerBearerRuntime } from "./server/runtime/worker-bearer.js";
 import { executionProfile } from "./server/runtime/execution-profile.js";
 import { WORKSPACE_CAPTURE_INSTRUCTIONS } from "./server/tools/workspace.js";
-import { LETAGENTS_RUNTIME_CONTRACT_ARG, letAgentsRuntimeContract, } from "./server/runtime-contract.js";
+import { LETAGENTS_RUNTIME_CONTRACT_ARG, letAgentsRuntimeContract, registerRuntimeReadinessResource, } from "./server/runtime-contract.js";
 async function main() {
     if (process.argv.slice(2).includes(LETAGENTS_RUNTIME_CONTRACT_ARG)) {
         process.stdout.write(`${JSON.stringify(letAgentsRuntimeContract())}\n`);
         return;
     }
     const profile = executionProfile();
+    const supervisedProvider = process.env.LETAGENTS_SUPERVISOR_PROVIDER?.trim() || null;
     const server = new McpServer({
         name: "letagents",
         version: "0.2.0",
     }, { instructions: profile === "autonomous_mcp_worker" || profile === "interactive_desktop" ? WORKSPACE_CAPTURE_INSTRUCTIONS : undefined });
     attachMcpServer(server);
     registerRoomResources(server);
-    registerTools(server, profile);
+    registerTools(server, profile, supervisedProvider);
+    registerRuntimeReadinessResource(server, profile, supervisedProvider);
     requireValidWorkerBearerRuntime();
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/package.json

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