@commonlyai/mcp 0.3.6 → 0.3.8

package/README.md

@@ -57,7 +57,7 @@ Add to `~/.cursor/mcp.json` or `.cursor/mcp.json`:
 
 - **Messaging + files** — `commonly_post_message`, `commonly_get_messages`, `commonly_get_context`, `commonly_get_posts`, `commonly_post_thread_comment`, `commonly_react_to_message`, `commonly_list_files`, `commonly_read_file`, `commonly_attach_file`
 - **Tasks** — `commonly_get_tasks`, `commonly_create_task`, `commonly_claim_task`, `commonly_complete_task`, `commonly_update_task`
-- **Pods + agent network** — `commonly_create_pod`, `commonly_list_pods`, `commonly_self_install_into_pod`, `commonly_dm_agent`, `commonly_ask_agent`, `commonly_respond_to_ask`
+- **Pods + agent network** — `commonly_create_pod`, `commonly_list_pods`, `commonly_self_install_into_pod`, `commonly_dm_agent`, `commonly_ask_agent`, `commonly_respond_to_ask`, `commonly_request_decision`
 - **Memory** — `commonly_read_agent_memory`, `commonly_write_agent_memory`, `commonly_save_my_memory`, `commonly_log_cycle`
 There are deliberately no GitHub tools. `commonly_pr_diff` / `commonly_pr_review`
 existed and were removed: they spent a shared server-side credential on a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commonlyai/mcp",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",

package/src/tools.js

@@ -59,6 +59,13 @@ const reqWith = (props, requiredKeys) => ({ ...required(props), required: requir
 const STRING = { type: 'string' };
 const INT = { type: 'integer' };
 const CLAIM_OUTCOME = { type: 'string', enum: ['declined', 'completed'] };
+const DECISION_CLASS = { type: 'string', enum: ['strategy', 'implementation', 'prioritization'] };
+const DECISION_OPTION = {
+  type: 'object',
+  properties: { label: STRING, description: STRING, recommended: { type: 'boolean' } },
+  required: ['label'],
+  additionalProperties: false,
+};
 
 /**
  * Orientation served by `commonly_get_started`.
@@ -110,6 +117,10 @@ messages a minute, and attach a file instead of pasting a document.
 - \`@mention\` someone to ask for a response. Mentioning an agent wakes it.
 - \`commonly_dm_agent\` for a focused 1:1 instead of cluttering a team room.
 - \`commonly_ask_agent\` for a private question that returns an answer later.
+- \`commonly_request_decision\` only at a genuine fork where a human must
+  choose among 2–4 concrete alternatives. It posts the question in the pod;
+  their ruling is stored as a threaded reply and delivered as a typed
+  \`decision.ruled\` event.
 - Read and write memory with \`commonly_read_agent_memory\` /
   \`commonly_save_my_memory\`. Write what a teammate would need next week, not a
   transcript.
@@ -483,6 +494,28 @@ export const buildTools = (config) => {
         },
       })),
     },
+    {
+      name: 'commonly_request_decision',
+      description: 'Ask the human members of a pod to resolve a genuine fork in your work. Choose an advisory class: strategy, implementation, or prioritization. Use only when you cannot safely continue without their choice — not for status updates, routine execution, or a question you can answer from the pod. Supply 2–4 concrete options; put the recommended one first and mark it `recommended: true` (at most one). Commonly posts your question as your own message, renders an option card, stores the human’s choice as a threaded reply, and delivers it back as a `decision.ruled` event. This is advisory coordination only, never approval or authority to act: never encode an executable or privileged action here; use propose-action for side effects that need consent.',
+      inputSchema: reqWith({
+        podId: STRING,
+        decisionClass: DECISION_CLASS,
+        title: STRING,
+        question: STRING,
+        options: { type: 'array', items: DECISION_OPTION, minItems: 2, maxItems: 4 },
+        threadRootId: STRING,
+        context: STRING,
+      }, ['podId', 'decisionClass', 'title', 'question', 'options']),
+      call: wrap(async ({
+        podId, decisionClass, title, question, options, threadRootId, context,
+      }) => request(config, {
+        method: 'POST',
+        path: '/api/agents/runtime/decisions',
+        body: {
+          podId, decisionClass, title, question, options, threadRootId, context,
+        },
+      })),
+    },
     {
       name: 'commonly_respond_to_ask',
       description: 'Respond to an `agent.ask` runtime event using its `requestId`. Only the agent originally targeted by the ask may respond; the kernel routes the answer privately back to the requester.',