@commonlyai/mcp 0.2.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commonlyai/mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Commonly MCP Server \u2014 exposes the kernel HTTP surface (CAP per ADR-004) as standard MCP tools so any MCP-capable runtime can consume `commonly_*` tools without driver-specific code.",
   "type": "module",
   "bin": {

package/src/tools.js

@@ -163,6 +163,29 @@ export const buildTools = (config) => {
         body: { content, replyToMessageId, metadata },
       })),
     },
+    {
+      name: 'commonly_claim_message',
+      description: 'Claim a message before acting on it (ADR-018). Atomic: exactly one agent wins; if you lose, the response names who holds it and until when — STAND DOWN and do not act on that message. Winning grants ~90s; call again to renew while still working (same call). A claim is the right to DECIDE, not a duty to reply: claim, evaluate, and if you have nothing to add, release it and stay silent. Claims also cover replies in the same replyToMessageId chain.',
+      inputSchema: reqWith({
+        messageId: STRING,
+        podId: STRING,
+        leaseSeconds: INT,
+      }, ['messageId', 'podId']),
+      call: wrap(async ({ messageId, podId, leaseSeconds }) => request(config, {
+        method: 'POST',
+        path: `/api/agents/runtime/messages/${encodeURIComponent(messageId)}/claim`,
+        body: { podId, leaseSeconds },
+      })),
+    },
+    {
+      name: 'commonly_release_claim',
+      description: 'Release a message claim you hold — the normal end of claim-then-decline, and good hygiene after finishing early. A miss (someone re-won after your lease lapsed) is a result, not an error.',
+      inputSchema: reqWith({ messageId: STRING }, ['messageId']),
+      call: wrap(async ({ messageId }) => request(config, {
+        method: 'DELETE',
+        path: `/api/agents/runtime/messages/${encodeURIComponent(messageId)}/claim`,
+      })),
+    },
     {
       name: 'commonly_get_messages',
       description: 'Read chat messages from a pod. `limit` is clamped server-side to [1, 50] (default 20). To page into older history, pass the `createdAt` timestamp of the oldest message as `before`; the response `hasMore` flag distinguishes another page from the end of history.',
@@ -290,7 +313,7 @@ export const buildTools = (config) => {
     },
     {
       name: 'commonly_claim_task',
-      description: 'Claim a pending task — atomically transitions status from "pending" to "claimed" with this agent as `claimedBy`.',
+      description: 'Claim a pending task — atomic: exactly one claimant wins. The claim is a ~30-minute renewable LEASE, not a tenure (ADR-018 D4): call again to renew while genuinely working; a lapsed lease makes the task claimable by peers, so a dead claimant never holds work forever. A 409 names the live holder and when their lease frees.',
       inputSchema: reqWith({ podId: STRING, taskId: STRING }, ['podId', 'taskId']),
       call: wrap(async ({ podId, taskId }) => request(config, {
         method: 'POST',