@artyfacts/mcp-server 1.0.2 → 1.0.4

package/dist/server.cjs

@@ -91,18 +91,17 @@ var ARTYFACTS_TOOLS = [
   },
   {
     name: "create_artifact",
-    description: "Create a new artifact",
+    description: "Create a new artifact (document, goal, spec, etc.)",
     inputSchema: {
       type: "object",
       properties: {
         title: { type: "string", description: "Artifact title" },
-        type: { type: "string", description: "Type: goal, spec, research, report, experiment, decision" },
+        type: { type: "string", description: "Artifact type: goal, spec, research, report, experiment, decision, doc" },
         content: { type: "string", description: "Markdown content" },
-        project_id: { type: "string", description: "Project ID" },
-        parent_id: { type: "string", description: "Parent artifact ID" },
-        tags: { type: "array", items: { type: "string" }, description: "Tags" }
+        parent_id: { type: "string", description: "Parent artifact ID for nested artifacts" },
+        tags: { type: "array", items: { type: "string" }, description: "Tags for categorization" }
       },
-      required: ["title"]
+      required: ["title", "type"]
     }
   },
   {
@@ -156,7 +155,7 @@ var ARTYFACTS_TOOLS = [
         type: { type: "string", description: "Type: content, task, decision, blocker" },
         position: { type: "number", description: "Order position" }
       },
-      required: ["artifact_id", "section_id", "heading"]
+      required: ["artifact_id", "section_id", "heading", "content"]
     }
   },
   {
@@ -262,18 +261,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"]
     }
   },
   {
@@ -414,7 +422,27 @@ var toolHandlers = {
     return client.get(`/artifacts?${params}`);
   },
   get_artifact: (client, args) => client.get(`/artifacts/${args.artifact_id}`),
-  create_artifact: (client, args) => client.post("/artifacts", args),
+  create_artifact: (client, args) => {
+    const envelope = {
+      aah_version: "0.3",
+      artifact: {
+        id: args.id || `artifact-${Date.now()}`,
+        title: args.title,
+        type: args.type || "document/sectioned",
+        artifact_type: args.artifact_type || args.type || "doc",
+        parent_id: args.parent_id,
+        tags: args.tags
+      },
+      content: args.content ? {
+        media_type: "text/markdown",
+        body: args.content
+      } : void 0,
+      source: {
+        agent_id: "mcp-agent"
+      }
+    };
+    return client.post("/artifacts", envelope);
+  },
   update_artifact: (client, args) => {
     const { artifact_id, ...body } = args;
     return client.patch(`/artifacts/${artifact_id}`, body);
@@ -423,7 +451,8 @@ var toolHandlers = {
   list_sections: (client, args) => client.get(`/artifacts/${args.artifact_id}/sections`),
   get_section: (client, args) => client.get(`/artifacts/${args.artifact_id}/sections/${args.section_id}`),
   create_section: (client, args) => {
-    const { artifact_id, ...body } = args;
+    const { artifact_id, section_id, ...rest } = args;
+    const body = { id: section_id, ...rest };
     return client.post(`/artifacts/${artifact_id}/sections`, body);
   },
   update_section: (client, args) => {
@@ -455,7 +484,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-OZZ4SOPK.js";
+} from "./chunk-MO7NJ56L.js";
 export {
   ArtyfactsMcpServer,
   createMcpServer,

package/package.json

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

package/src/server.ts

@@ -97,18 +97,17 @@ const ARTYFACTS_TOOLS: Tool[] = [
   },
   {
     name: 'create_artifact',
-    description: 'Create a new artifact',
+    description: 'Create a new artifact (document, goal, spec, etc.)',
     inputSchema: {
       type: 'object',
       properties: {
         title: { type: 'string', description: 'Artifact title' },
-        type: { type: 'string', description: 'Type: goal, spec, research, report, experiment, decision' },
+        type: { type: 'string', description: 'Artifact type: goal, spec, research, report, experiment, decision, doc' },
         content: { type: 'string', description: 'Markdown content' },
-        project_id: { type: 'string', description: 'Project ID' },
-        parent_id: { type: 'string', description: 'Parent artifact ID' },
-        tags: { type: 'array', items: { type: 'string' }, description: 'Tags' },
+        parent_id: { type: 'string', description: 'Parent artifact ID for nested artifacts' },
+        tags: { type: 'array', items: { type: 'string' }, description: 'Tags for categorization' },
       },
-      required: ['title'],
+      required: ['title', 'type'],
     },
   },
   {
@@ -163,7 +162,7 @@ const ARTYFACTS_TOOLS: Tool[] = [
         type: { type: 'string', description: 'Type: content, task, decision, blocker' },
         position: { type: 'number', description: 'Order position' },
       },
-      required: ['artifact_id', 'section_id', 'heading'],
+      required: ['artifact_id', 'section_id', 'heading', 'content'],
     },
   },
   {
@@ -271,18 +270,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'],
     },
   },
   {
@@ -437,7 +445,28 @@ const toolHandlers: Record<string, ToolHandler> = {
     return client.get(`/artifacts?${params}`);
   },
   get_artifact: (client, args) => client.get(`/artifacts/${args.artifact_id}`),
-  create_artifact: (client, args) => client.post('/artifacts', args),
+  create_artifact: (client, args) => {
+    // API expects AAH envelope format
+    const envelope = {
+      aah_version: '0.3',
+      artifact: {
+        id: args.id || `artifact-${Date.now()}`,
+        title: args.title,
+        type: args.type || 'document/sectioned',
+        artifact_type: args.artifact_type || args.type || 'doc',
+        parent_id: args.parent_id,
+        tags: args.tags,
+      },
+      content: args.content ? {
+        media_type: 'text/markdown',
+        body: args.content,
+      } : undefined,
+      source: {
+        agent_id: 'mcp-agent',
+      },
+    };
+    return client.post('/artifacts', envelope);
+  },
   update_artifact: (client, args) => {
     const { artifact_id, ...body } = args;
     return client.patch(`/artifacts/${artifact_id}`, body);
@@ -447,7 +476,9 @@ const toolHandlers: Record<string, ToolHandler> = {
   list_sections: (client, args) => client.get(`/artifacts/${args.artifact_id}/sections`),
   get_section: (client, args) => client.get(`/artifacts/${args.artifact_id}/sections/${args.section_id}`),
   create_section: (client, args) => {
-    const { artifact_id, ...body } = args;
+    const { artifact_id, section_id, ...rest } = args;
+    // API expects 'id' not 'section_id'
+    const body = { id: section_id, ...rest };
     return client.post(`/artifacts/${artifact_id}/sections`, body);
   },
   update_section: (client, args) => {
@@ -481,7 +512,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);