@artyfacts/mcp-server 1.0.5 → 1.1.1

package/dist/index.cjs

@@ -219,8 +219,9 @@ var ARTYFACTS_TOOLS = [
       type: "object",
       properties: {
         task_id: { type: "string", description: "Task ID" },
+        output_text: { type: "string", description: "Completion summary / what was done" },
         output_url: { type: "string", description: "URL to deliverable (PR, doc, etc.)" },
-        summary: { type: "string", description: "Completion summary" }
+        output_artifact_id: { type: "string", description: "UUID of artifact produced by this task" }
       },
       required: ["task_id"]
     }
@@ -317,46 +318,50 @@ var ARTYFACTS_TOOLS = [
       required: ["agent_id"]
     }
   },
-  // Blocker tools
+  // Inbox tools (human-in-the-loop)
   {
-    name: "list_blockers",
-    description: "List blockers (decisions, dependencies needing resolution)",
+    name: "create_inbox_item",
+    description: "Request human approval, a decision, or an answer before proceeding. Automatically blocks the task. Use for agent creation, risky actions, or anything requiring human sign-off.",
     inputSchema: {
       type: "object",
       properties: {
-        artifact_id: { type: "string", description: "Filter by artifact" },
-        status: { type: "string", description: "Filter by status: open, resolved" }
+        task_id: { type: "string", description: "UUID of the task being blocked (required)" },
+        type: { type: "string", description: "Type: approval, decision, question" },
+        title: { type: "string", description: "Short summary shown to the human in the inbox" },
+        content: { type: "string", description: "Full context and details for the human" },
+        action: { type: "string", description: "Action to auto-execute if approved (e.g. agent.create)" },
+        action_payload: { type: "object", description: "Data for the action (e.g. full agent spec for agent.create)" },
+        options: { type: "array", description: "Options for decision type: [{id, label, description}]" }
       },
-      required: []
+      required: ["task_id", "type", "title"]
     }
   },
   {
-    name: "create_blocker",
-    description: "Create a blocker (decision request, dependency, etc.)",
+    name: "list_inbox",
+    description: "List pending inbox items (approvals, decisions, questions) waiting for human resolution.",
     inputSchema: {
       type: "object",
       properties: {
-        artifact_id: { type: "string", description: "Artifact ID" },
-        kind: { type: "string", description: "Kind: decision, dependency, resource, external" },
-        title: { type: "string", description: "Blocker title" },
-        description: { type: "string", description: "Details" },
-        options: { type: "array", description: "Options for decisions" },
-        blocked_tasks: { type: "array", items: { type: "string" }, description: "Task IDs blocked by this" }
+        status: { type: "string", description: "Filter by status: pending (default), resolved" },
+        type: { type: "string", description: "Filter by type: approval, decision, question" },
+        limit: { type: "number", description: "Max results (default 50)" }
       },
-      required: ["artifact_id", "kind", "title"]
+      required: []
     }
   },
   {
-    name: "resolve_blocker",
-    description: "Resolve a blocker",
+    name: "resolve_inbox",
+    description: "Resolve an inbox item from the agent side. Humans resolve via the UI \u2014 only use this for automated resolution.",
     inputSchema: {
       type: "object",
       properties: {
-        blocker_id: { type: "string", description: "Blocker ID" },
-        resolution: { type: "string", description: "How it was resolved" },
-        selected_option: { type: "string", description: "Selected option (for decisions)" }
+        item_id: { type: "string", description: "Inbox item UUID" },
+        approved: { type: "boolean", description: "For approvals: true to approve, false to deny" },
+        chosen_option: { type: "string", description: "For decisions: the selected option ID" },
+        answer: { type: "string", description: "For questions: the answer text" },
+        notes: { type: "string", description: "Optional notes" }
       },
-      required: ["blocker_id", "resolution"]
+      required: ["item_id"]
     }
   },
   // Search tools
@@ -526,20 +531,21 @@ var toolHandlers = {
     const { agent_id, ...body } = args;
     return client.patch(`/agents/${agent_id}`, body);
   },
-  // Blockers
-  list_blockers: (client, args) => {
+  // Inbox (human-in-the-loop)
+  create_inbox_item: (client, args) => {
+    const { task_id, type, title, content, action, action_payload, options } = args;
+    return client.post("/inbox", { task_id, type, title, content, action, action_payload, options });
+  },
+  list_inbox: (client, args) => {
     const params = new URLSearchParams();
-    if (args.artifact_id) params.set("artifact_id", String(args.artifact_id));
     if (args.status) params.set("status", String(args.status));
-    return client.get(`/blockers?${params}`);
-  },
-  create_blocker: (client, args) => {
-    const { artifact_id, ...body } = args;
-    return client.post(`/artifacts/${artifact_id}/blockers`, body);
+    if (args.type) params.set("type", String(args.type));
+    if (args.limit) params.set("limit", String(args.limit));
+    return client.get(`/inbox?${params}`);
   },
-  resolve_blocker: (client, args) => {
-    const { blocker_id, ...body } = args;
-    return client.post(`/blockers/${blocker_id}/resolve`, body);
+  resolve_inbox: (client, args) => {
+    const { item_id, ...body } = args;
+    return client.post(`/inbox/${item_id}/resolve`, body);
   },
   // Search
   search_artifacts: (client, args) => {

package/dist/index.js

@@ -2,7 +2,7 @@ import {
   ArtyfactsMcpServer,
   createMcpServer,
   startServer
-} from "./chunk-NUVCJMET.js";
+} from "./chunk-XJM3QWEZ.js";
 export {
   ArtyfactsMcpServer,
   createMcpServer,

package/dist/server.cjs

@@ -217,8 +217,9 @@ var ARTYFACTS_TOOLS = [
       type: "object",
       properties: {
         task_id: { type: "string", description: "Task ID" },
+        output_text: { type: "string", description: "Completion summary / what was done" },
         output_url: { type: "string", description: "URL to deliverable (PR, doc, etc.)" },
-        summary: { type: "string", description: "Completion summary" }
+        output_artifact_id: { type: "string", description: "UUID of artifact produced by this task" }
       },
       required: ["task_id"]
     }
@@ -315,46 +316,50 @@ var ARTYFACTS_TOOLS = [
       required: ["agent_id"]
     }
   },
-  // Blocker tools
+  // Inbox tools (human-in-the-loop)
   {
-    name: "list_blockers",
-    description: "List blockers (decisions, dependencies needing resolution)",
+    name: "create_inbox_item",
+    description: "Request human approval, a decision, or an answer before proceeding. Automatically blocks the task. Use for agent creation, risky actions, or anything requiring human sign-off.",
     inputSchema: {
       type: "object",
       properties: {
-        artifact_id: { type: "string", description: "Filter by artifact" },
-        status: { type: "string", description: "Filter by status: open, resolved" }
+        task_id: { type: "string", description: "UUID of the task being blocked (required)" },
+        type: { type: "string", description: "Type: approval, decision, question" },
+        title: { type: "string", description: "Short summary shown to the human in the inbox" },
+        content: { type: "string", description: "Full context and details for the human" },
+        action: { type: "string", description: "Action to auto-execute if approved (e.g. agent.create)" },
+        action_payload: { type: "object", description: "Data for the action (e.g. full agent spec for agent.create)" },
+        options: { type: "array", description: "Options for decision type: [{id, label, description}]" }
       },
-      required: []
+      required: ["task_id", "type", "title"]
     }
   },
   {
-    name: "create_blocker",
-    description: "Create a blocker (decision request, dependency, etc.)",
+    name: "list_inbox",
+    description: "List pending inbox items (approvals, decisions, questions) waiting for human resolution.",
     inputSchema: {
       type: "object",
       properties: {
-        artifact_id: { type: "string", description: "Artifact ID" },
-        kind: { type: "string", description: "Kind: decision, dependency, resource, external" },
-        title: { type: "string", description: "Blocker title" },
-        description: { type: "string", description: "Details" },
-        options: { type: "array", description: "Options for decisions" },
-        blocked_tasks: { type: "array", items: { type: "string" }, description: "Task IDs blocked by this" }
+        status: { type: "string", description: "Filter by status: pending (default), resolved" },
+        type: { type: "string", description: "Filter by type: approval, decision, question" },
+        limit: { type: "number", description: "Max results (default 50)" }
       },
-      required: ["artifact_id", "kind", "title"]
+      required: []
     }
   },
   {
-    name: "resolve_blocker",
-    description: "Resolve a blocker",
+    name: "resolve_inbox",
+    description: "Resolve an inbox item from the agent side. Humans resolve via the UI \u2014 only use this for automated resolution.",
     inputSchema: {
       type: "object",
       properties: {
-        blocker_id: { type: "string", description: "Blocker ID" },
-        resolution: { type: "string", description: "How it was resolved" },
-        selected_option: { type: "string", description: "Selected option (for decisions)" }
+        item_id: { type: "string", description: "Inbox item UUID" },
+        approved: { type: "boolean", description: "For approvals: true to approve, false to deny" },
+        chosen_option: { type: "string", description: "For decisions: the selected option ID" },
+        answer: { type: "string", description: "For questions: the answer text" },
+        notes: { type: "string", description: "Optional notes" }
       },
-      required: ["blocker_id", "resolution"]
+      required: ["item_id"]
     }
   },
   // Search tools
@@ -524,20 +529,21 @@ var toolHandlers = {
     const { agent_id, ...body } = args;
     return client.patch(`/agents/${agent_id}`, body);
   },
-  // Blockers
-  list_blockers: (client, args) => {
+  // Inbox (human-in-the-loop)
+  create_inbox_item: (client, args) => {
+    const { task_id, type, title, content, action, action_payload, options } = args;
+    return client.post("/inbox", { task_id, type, title, content, action, action_payload, options });
+  },
+  list_inbox: (client, args) => {
     const params = new URLSearchParams();
-    if (args.artifact_id) params.set("artifact_id", String(args.artifact_id));
     if (args.status) params.set("status", String(args.status));
-    return client.get(`/blockers?${params}`);
-  },
-  create_blocker: (client, args) => {
-    const { artifact_id, ...body } = args;
-    return client.post(`/artifacts/${artifact_id}/blockers`, body);
+    if (args.type) params.set("type", String(args.type));
+    if (args.limit) params.set("limit", String(args.limit));
+    return client.get(`/inbox?${params}`);
   },
-  resolve_blocker: (client, args) => {
-    const { blocker_id, ...body } = args;
-    return client.post(`/blockers/${blocker_id}/resolve`, body);
+  resolve_inbox: (client, args) => {
+    const { item_id, ...body } = args;
+    return client.post(`/inbox/${item_id}/resolve`, body);
   },
   // Search
   search_artifacts: (client, args) => {

package/dist/server.js

@@ -2,7 +2,7 @@ import {
   ArtyfactsMcpServer,
   createMcpServer,
   startServer
-} from "./chunk-NUVCJMET.js";
+} from "./chunk-XJM3QWEZ.js";
 export {
   ArtyfactsMcpServer,
   createMcpServer,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artyfacts/mcp-server",
-  "version": "1.0.5",
+  "version": "1.1.1",
   "description": "MCP server exposing Artyfacts tools for Claude Code",
   "type": "module",
   "main": "dist/index.js",

package/src/server.ts

@@ -225,8 +225,9 @@ const ARTYFACTS_TOOLS: Tool[] = [
       type: 'object',
       properties: {
         task_id: { type: 'string', description: 'Task ID' },
+        output_text: { type: 'string', description: 'Completion summary / what was done' },
         output_url: { type: 'string', description: 'URL to deliverable (PR, doc, etc.)' },
-        summary: { type: 'string', description: 'Completion summary' },
+        output_artifact_id: { type: 'string', description: 'UUID of artifact produced by this task' },
       },
       required: ['task_id'],
     },
@@ -325,46 +326,50 @@ const ARTYFACTS_TOOLS: Tool[] = [
     },
   },
   
-  // Blocker tools
+  // Inbox tools (human-in-the-loop)
   {
-    name: 'list_blockers',
-    description: 'List blockers (decisions, dependencies needing resolution)',
+    name: 'create_inbox_item',
+    description: 'Request human approval, a decision, or an answer before proceeding. Automatically blocks the task. Use for agent creation, risky actions, or anything requiring human sign-off.',
     inputSchema: {
       type: 'object',
       properties: {
-        artifact_id: { type: 'string', description: 'Filter by artifact' },
-        status: { type: 'string', description: 'Filter by status: open, resolved' },
+        task_id: { type: 'string', description: 'UUID of the task being blocked (required)' },
+        type: { type: 'string', description: 'Type: approval, decision, question' },
+        title: { type: 'string', description: 'Short summary shown to the human in the inbox' },
+        content: { type: 'string', description: 'Full context and details for the human' },
+        action: { type: 'string', description: 'Action to auto-execute if approved (e.g. agent.create)' },
+        action_payload: { type: 'object', description: 'Data for the action (e.g. full agent spec for agent.create)' },
+        options: { type: 'array', description: 'Options for decision type: [{id, label, description}]' },
       },
-      required: [],
+      required: ['task_id', 'type', 'title'],
     },
   },
   {
-    name: 'create_blocker',
-    description: 'Create a blocker (decision request, dependency, etc.)',
+    name: 'list_inbox',
+    description: 'List pending inbox items (approvals, decisions, questions) waiting for human resolution.',
     inputSchema: {
       type: 'object',
       properties: {
-        artifact_id: { type: 'string', description: 'Artifact ID' },
-        kind: { type: 'string', description: 'Kind: decision, dependency, resource, external' },
-        title: { type: 'string', description: 'Blocker title' },
-        description: { type: 'string', description: 'Details' },
-        options: { type: 'array', description: 'Options for decisions' },
-        blocked_tasks: { type: 'array', items: { type: 'string' }, description: 'Task IDs blocked by this' },
+        status: { type: 'string', description: 'Filter by status: pending (default), resolved' },
+        type: { type: 'string', description: 'Filter by type: approval, decision, question' },
+        limit: { type: 'number', description: 'Max results (default 50)' },
       },
-      required: ['artifact_id', 'kind', 'title'],
+      required: [],
     },
   },
   {
-    name: 'resolve_blocker',
-    description: 'Resolve a blocker',
+    name: 'resolve_inbox',
+    description: 'Resolve an inbox item from the agent side. Humans resolve via the UI — only use this for automated resolution.',
     inputSchema: {
       type: 'object',
       properties: {
-        blocker_id: { type: 'string', description: 'Blocker ID' },
-        resolution: { type: 'string', description: 'How it was resolved' },
-        selected_option: { type: 'string', description: 'Selected option (for decisions)' },
+        item_id: { type: 'string', description: 'Inbox item UUID' },
+        approved: { type: 'boolean', description: 'For approvals: true to approve, false to deny' },
+        chosen_option: { type: 'string', description: 'For decisions: the selected option ID' },
+        answer: { type: 'string', description: 'For questions: the answer text' },
+        notes: { type: 'string', description: 'Optional notes' },
       },
-      required: ['blocker_id', 'resolution'],
+      required: ['item_id'],
     },
   },
   
@@ -554,20 +559,21 @@ const toolHandlers: Record<string, ToolHandler> = {
     return client.patch(`/agents/${agent_id}`, body);
   },
   
-  // Blockers
-  list_blockers: (client, args) => {
+  // Inbox (human-in-the-loop)
+  create_inbox_item: (client, args) => {
+    const { task_id, type, title, content, action, action_payload, options } = args;
+    return client.post('/inbox', { task_id, type, title, content, action, action_payload, options });
+  },
+  list_inbox: (client, args) => {
     const params = new URLSearchParams();
-    if (args.artifact_id) params.set('artifact_id', String(args.artifact_id));
     if (args.status) params.set('status', String(args.status));
-    return client.get(`/blockers?${params}`);
-  },
-  create_blocker: (client, args) => {
-    const { artifact_id, ...body } = args;
-    return client.post(`/artifacts/${artifact_id}/blockers`, body);
+    if (args.type) params.set('type', String(args.type));
+    if (args.limit) params.set('limit', String(args.limit));
+    return client.get(`/inbox?${params}`);
   },
-  resolve_blocker: (client, args) => {
-    const { blocker_id, ...body } = args;
-    return client.post(`/blockers/${blocker_id}/resolve`, body);
+  resolve_inbox: (client, args) => {
+    const { item_id, ...body } = args;
+    return client.post(`/inbox/${item_id}/resolve`, body);
   },
   
   // Search