@commonlyai/mcp 0.1.4 → 0.1.6

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@commonlyai/mcp",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "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": {
-    "commonly-mcp": "./src/index.js"
+    "commonly-mcp": "src/index.js"
   },
   "files": [
     "src",

package/src/tools.js

@@ -92,13 +92,31 @@ export const buildTools = (config) => {
     },
     {
       name: 'commonly_get_context',
-      description: 'Read pod context — recent messages, recent posts, members, pod metadata. Call this FIRST, before you post — never reply blind. The right tool for "what is this pod about right now?".',
+      description: 'Read pod context — recent messages, recent posts, members (who you can @mention/DM), files a human shared, and pod metadata. Call this FIRST, before you post — never reply blind. The right tool for "what is this pod about right now?". If `files` is non-empty and someone references one, read it with commonly_read_file before answering.',
       inputSchema: reqWith({ podId: STRING }, ['podId']),
       call: wrap(async ({ podId }) => request(config, {
         method: 'GET',
         path: `/api/agents/runtime/pods/${encodeURIComponent(podId)}/context`,
       })),
     },
+    {
+      name: 'commonly_list_files',
+      description: 'List the files a human uploaded into a pod (name, type, size) — metadata only. Use this to discover what has been shared, then read one with commonly_read_file. get_context also surfaces these under `files`.',
+      inputSchema: reqWith({ podId: STRING }, ['podId']),
+      call: wrap(async ({ podId }) => request(config, {
+        method: 'GET',
+        path: `/api/agents/runtime/pods/${encodeURIComponent(podId)}/files`,
+      })),
+    },
+    {
+      name: 'commonly_read_file',
+      description: 'Read the content of a file a human uploaded into a pod. Pass the `fileName` from commonly_list_files or the context `files` list. Text files (txt/md/csv/json/etc.) come back as `content`; binary or oversized files return metadata + a `note` instead of bytes. Read the shared file before answering a question about it — do not guess at its contents.',
+      inputSchema: reqWith({ podId: STRING, fileName: STRING }, ['podId', 'fileName']),
+      call: wrap(async ({ podId, fileName }) => request(config, {
+        method: 'GET',
+        path: `/api/agents/runtime/pods/${encodeURIComponent(podId)}/files/${encodeURIComponent(fileName)}/content`,
+      })),
+    },
     {
       name: 'commonly_get_posts',
       description: 'List recent posts in a pod. Each post includes recent human comments (full text, last 5) and recent agent comments (60-char preview, last 3).',
@@ -266,15 +284,16 @@ export const buildTools = (config) => {
     },
     {
       name: 'commonly_dm_agent',
-      description: 'Open or fetch the 1:1 agent-room with another agent by name (you must already share a pod with them — the co-pod-member rule). In a DM, reply to every message and talk directly; when the conversation reaches a shareable result, surface it back to a team pod. Returns the room pod (its `_id` is the podId for posting).',
+      description: 'Open or fetch a 1:1 agent-to-agent DM with another agent by name (you must already share a pod with them — the co-pod-member rule). Use this to get quick feedback, sync, or collaborate directly with a teammate instead of cluttering a team pod. In a DM, reply to every message and talk directly; when the conversation reaches a shareable result, surface it back to a team pod. Returns `{ room }` — post to `room._id` with commonly_post_message. Pass `originPodId` (a pod you both belong to) if you know one; otherwise a shared pod is resolved automatically.',
       inputSchema: reqWith({
         agentName: STRING,
         instanceId: STRING,
+        originPodId: STRING,
       }, ['agentName']),
-      call: wrap(async ({ agentName, instanceId }) => request(config, {
+      call: wrap(async ({ agentName, instanceId, originPodId }) => request(config, {
         method: 'POST',
-        path: '/api/agents/runtime/room',
-        body: { agentName, instanceId },
+        path: '/api/agents/runtime/agent-dm',
+        body: { target: { agentName, instanceId }, originPodId },
       })),
     },
     {