@artyfacts/mcp-server 1.0.3 → 1.0.5

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",
@@ -261,18 +278,27 @@ var ARTYFACTS_TOOLS = [
   },
   {
     name: "create_agent",
-    description: "Register a new agent",
+    description: "Register a new AI agent with role, capabilities, and permissions",
     inputSchema: {
       type: "object",
       properties: {
         agentId: { type: "string", description: 'Unique agent ID (e.g., "engineering-agent", "qa-agent")' },
         name: { type: "string", description: "Agent display name" },
-        type: { type: "string", description: "Type: pm, engineering, qa, research, content, design" },
-        description: { type: "string", description: "What this agent does" },
-        capabilities: { type: "array", items: { type: "string" }, description: "Agent capabilities" },
-        config: { type: "object", description: "Agent configuration" }
+        role: { type: "string", description: "Role: pm, engineering, qa, research, content, design" },
+        description: { type: "string", description: "What this agent does - detailed description" },
+        capabilities: { type: "array", items: { type: "string" }, description: 'List of capabilities (e.g., ["code-review", "testing", "debugging"])' },
+        permissions: {
+          type: "object",
+          description: "Permission settings",
+          properties: {
+            write: { type: "boolean", description: "Can create/edit artifacts" },
+            delete: { type: "boolean", description: "Can delete artifacts" },
+            delegate_tasks: { type: "boolean", description: "Can assign tasks to other agents" }
+          }
+        },
+        systemPrompt: { type: "string", description: "System prompt for the agent" }
       },
-      required: ["agentId", "name", "type"]
+      required: ["agentId", "name", "role", "description"]
     }
   },
   {
@@ -468,6 +494,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();
@@ -475,7 +505,21 @@ var toolHandlers = {
     return client.get(`/agents?${params}`);
   },
   get_agent: (client, args) => client.get(`/agents/${args.agent_id}`),
-  create_agent: (client, args) => client.post("/agents", args),
+  create_agent: (client, args) => {
+    const body = {
+      agentId: args.agentId,
+      name: args.name,
+      role: args.role,
+      description: args.description,
+      permissions: args.permissions || { write: true, delete: false, delegate_tasks: false },
+      metadata: {
+        capabilities: args.capabilities || [],
+        systemPrompt: args.systemPrompt,
+        createdVia: "mcp"
+      }
+    };
+    return client.post("/agents", body);
+  },
   update_agent: (client, args) => {
     const { agent_id, ...body } = args;
     return client.patch(`/agents/${agent_id}`, body);

package/dist/server.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artyfacts/mcp-server",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "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',
@@ -270,18 +287,27 @@ const ARTYFACTS_TOOLS: Tool[] = [
   },
   {
     name: 'create_agent',
-    description: 'Register a new agent',
+    description: 'Register a new AI agent with role, capabilities, and permissions',
     inputSchema: {
       type: 'object',
       properties: {
         agentId: { type: 'string', description: 'Unique agent ID (e.g., "engineering-agent", "qa-agent")' },
         name: { type: 'string', description: 'Agent display name' },
-        type: { type: 'string', description: 'Type: pm, engineering, qa, research, content, design' },
-        description: { type: 'string', description: 'What this agent does' },
-        capabilities: { type: 'array', items: { type: 'string' }, description: 'Agent capabilities' },
-        config: { type: 'object', description: 'Agent configuration' },
+        role: { type: 'string', description: 'Role: pm, engineering, qa, research, content, design' },
+        description: { type: 'string', description: 'What this agent does - detailed description' },
+        capabilities: { type: 'array', items: { type: 'string' }, description: 'List of capabilities (e.g., ["code-review", "testing", "debugging"])' },
+        permissions: { 
+          type: 'object', 
+          description: 'Permission settings',
+          properties: {
+            write: { type: 'boolean', description: 'Can create/edit artifacts' },
+            delete: { type: 'boolean', description: 'Can delete artifacts' },
+            delegate_tasks: { type: 'boolean', description: 'Can assign tasks to other agents' },
+          }
+        },
+        systemPrompt: { type: 'string', description: 'System prompt for the agent' },
       },
-      required: ['agentId', 'name', 'type'],
+      required: ['agentId', 'name', 'role', 'description'],
     },
   },
   {
@@ -495,7 +521,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();
@@ -503,7 +533,22 @@ const toolHandlers: Record<string, ToolHandler> = {
     return client.get(`/agents?${params}`);
   },
   get_agent: (client, args) => client.get(`/agents/${args.agent_id}`),
-  create_agent: (client, args) => client.post('/agents', args),
+  create_agent: (client, args) => {
+    // Map MCP fields to API fields
+    const body = {
+      agentId: args.agentId,
+      name: args.name,
+      role: args.role,
+      description: args.description,
+      permissions: args.permissions || { write: true, delete: false, delegate_tasks: false },
+      metadata: {
+        capabilities: args.capabilities || [],
+        systemPrompt: args.systemPrompt,
+        createdVia: 'mcp',
+      },
+    };
+    return client.post('/agents', body);
+  },
   update_agent: (client, args) => {
     const { agent_id, ...body } = args;
     return client.patch(`/agents/${agent_id}`, body);