@artyfacts/mcp-server 1.0.4 → 1.1.0

package/dist/index.cjs

@@ -238,6 +238,23 @@ var ARTYFACTS_TOOLS = [
       required: ["task_id", "reason"]
     }
   },
+  {
+    name: "create_task",
+    description: "Create a new task under a goal. Use this to create actionable tasks \u2014 NOT create_artifact or create_section.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        goal_id: { type: "string", description: "The goal UUID this task belongs to (required)" },
+        title: { type: "string", description: "Task title" },
+        description: { type: "string", description: "Task description / what needs to be done" },
+        priority: { type: "string", description: "Priority: low, medium, high, urgent" },
+        assigned_to: { type: "string", description: "Agent UUID to assign the task to" },
+        depends_on: { type: "array", items: { type: "string" }, description: "List of task UUIDs this task depends on" },
+        estimated_minutes: { type: "number", description: "Estimated time in minutes" }
+      },
+      required: ["goal_id", "title"]
+    }
+  },
   // Agent tools
   {
     name: "list_agents",
@@ -300,46 +317,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
@@ -479,6 +500,10 @@ var toolHandlers = {
     const { task_id, ...body } = args;
     return client.post(`/tasks/${task_id}/block`, body);
   },
+  create_task: (client, args) => {
+    const { goal_id, title, description, priority, assigned_to, depends_on, estimated_minutes } = args;
+    return client.post("/tasks", { goal_id, title, description, priority, assigned_to, depends_on, estimated_minutes });
+  },
   // Agents
   list_agents: (client, args) => {
     const params = new URLSearchParams();
@@ -505,20 +530,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-MO7NJ56L.js";
+} from "./chunk-XLUIPOCO.js";
 export {
   ArtyfactsMcpServer,
   createMcpServer,

package/dist/server.cjs

@@ -236,6 +236,23 @@ var ARTYFACTS_TOOLS = [
       required: ["task_id", "reason"]
     }
   },
+  {
+    name: "create_task",
+    description: "Create a new task under a goal. Use this to create actionable tasks \u2014 NOT create_artifact or create_section.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        goal_id: { type: "string", description: "The goal UUID this task belongs to (required)" },
+        title: { type: "string", description: "Task title" },
+        description: { type: "string", description: "Task description / what needs to be done" },
+        priority: { type: "string", description: "Priority: low, medium, high, urgent" },
+        assigned_to: { type: "string", description: "Agent UUID to assign the task to" },
+        depends_on: { type: "array", items: { type: "string" }, description: "List of task UUIDs this task depends on" },
+        estimated_minutes: { type: "number", description: "Estimated time in minutes" }
+      },
+      required: ["goal_id", "title"]
+    }
+  },
   // Agent tools
   {
     name: "list_agents",
@@ -298,46 +315,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
@@ -477,6 +498,10 @@ var toolHandlers = {
     const { task_id, ...body } = args;
     return client.post(`/tasks/${task_id}/block`, body);
   },
+  create_task: (client, args) => {
+    const { goal_id, title, description, priority, assigned_to, depends_on, estimated_minutes } = args;
+    return client.post("/tasks", { goal_id, title, description, priority, assigned_to, depends_on, estimated_minutes });
+  },
   // Agents
   list_agents: (client, args) => {
     const params = new URLSearchParams();
@@ -503,20 +528,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-MO7NJ56L.js";
+} from "./chunk-XLUIPOCO.js";
 export {
   ArtyfactsMcpServer,
   createMcpServer,

package/package.json

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

package/src/server.ts

@@ -244,7 +244,24 @@ const ARTYFACTS_TOOLS: Tool[] = [
       required: ['task_id', 'reason'],
     },
   },
-  
+  {
+    name: 'create_task',
+    description: 'Create a new task under a goal. Use this to create actionable tasks — NOT create_artifact or create_section.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        goal_id: { type: 'string', description: 'The goal UUID this task belongs to (required)' },
+        title: { type: 'string', description: 'Task title' },
+        description: { type: 'string', description: 'Task description / what needs to be done' },
+        priority: { type: 'string', description: 'Priority: low, medium, high, urgent' },
+        assigned_to: { type: 'string', description: 'Agent UUID to assign the task to' },
+        depends_on: { type: 'array', items: { type: 'string' }, description: 'List of task UUIDs this task depends on' },
+        estimated_minutes: { type: 'number', description: 'Estimated time in minutes' },
+      },
+      required: ['goal_id', 'title'],
+    },
+  },
+
   // Agent tools
   {
     name: 'list_agents',
@@ -308,46 +325,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'],
     },
   },
   
@@ -504,7 +525,11 @@ const toolHandlers: Record<string, ToolHandler> = {
     const { task_id, ...body } = args;
     return client.post(`/tasks/${task_id}/block`, body);
   },
-  
+  create_task: (client, args) => {
+    const { goal_id, title, description, priority, assigned_to, depends_on, estimated_minutes } = args;
+    return client.post('/tasks', { goal_id, title, description, priority, assigned_to, depends_on, estimated_minutes });
+  },
+
   // Agents
   list_agents: (client, args) => {
     const params = new URLSearchParams();
@@ -533,20 +558,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