@artyfacts/mcp-server 1.1.3 → 1.1.5

package/dist/index.cjs

@@ -100,6 +100,7 @@ var ARTYFACTS_TOOLS = [
         title: { type: "string", description: "Artifact title" },
         type: { type: "string", description: "Artifact type: goal, spec, research, report, experiment, decision, doc" },
         content: { type: "string", description: "Markdown content" },
+        goal_id: { type: "string", description: "The goal UUID this artifact belongs to \u2014 always pass this when working on a task" },
         parent_id: { type: "string", description: "Parent artifact ID for nested artifacts" },
         tags: { type: "array", items: { type: "string" }, description: "Tags for categorization" }
       },
@@ -313,7 +314,8 @@ var ARTYFACTS_TOOLS = [
             delegate_tasks: { type: "boolean", description: "Can assign tasks to other agents" }
           }
         },
-        systemPrompt: { type: "string", description: "System prompt for the agent" }
+        systemPrompt: { type: "string", description: "System prompt for the agent" },
+        reportsToAgentId: { type: "string", description: 'Agent ID or UUID of the parent agent this agent reports to. Use agent slugs like "chief-of-staff" for readability.' }
       },
       required: ["agentId", "name", "role", "description"]
     }
@@ -406,18 +408,23 @@ var ARTYFACTS_TOOLS = [
   }
 ];
 var ArtyfactsApiClient = class {
-  constructor(baseUrl, apiKey) {
+  constructor(baseUrl, apiKey, agentId) {
     this.baseUrl = baseUrl;
     this.apiKey = apiKey;
+    this.agentId = agentId;
   }
   async request(method, path, body) {
     const url = `${this.baseUrl}${path}`;
+    const headers = {
+      "Authorization": `Bearer ${this.apiKey}`,
+      "Content-Type": "application/json"
+    };
+    if (this.agentId) {
+      headers["X-Agent-Id"] = this.agentId;
+    }
     const response = await fetch(url, {
       method,
-      headers: {
-        "Authorization": `Bearer ${this.apiKey}`,
-        "Content-Type": "application/json"
-      },
+      headers,
       body: body ? JSON.stringify(body) : void 0
     });
     if (!response.ok) {
@@ -429,6 +436,9 @@ var ArtyfactsApiClient = class {
   get(path) {
     return this.request("GET", path);
   }
+  getAgentId() {
+    return this.agentId;
+  }
   post(path, body) {
     return this.request("POST", path, body);
   }
@@ -468,6 +478,7 @@ var toolHandlers = {
         title: args.title,
         type: args.type || "document/sectioned",
         artifact_type: args.artifact_type || args.type || "doc",
+        goal_id: args.goal_id,
         parent_id: args.parent_id,
         tags: args.tags
       },
@@ -476,7 +487,7 @@ var toolHandlers = {
         body: args.content
       } : void 0,
       source: {
-        agent_id: "mcp-agent"
+        agent_id: client.getAgentId() || "mcp-agent"
       }
     };
     return client.post("/artifacts", envelope);
@@ -532,6 +543,7 @@ var toolHandlers = {
       name: args.name,
       role: args.role,
       description: args.description,
+      reportsToAgentId: args.reportsToAgentId,
       permissions: args.permissions || { write: true, delete: false, delegate_tasks: false },
       metadata: {
         capabilities: args.capabilities || [],
@@ -580,7 +592,8 @@ var ArtyfactsMcpServer = class {
     this.config = config;
     this.client = new ArtyfactsApiClient(
       config.baseUrl || "https://artyfacts.dev/api/v1",
-      config.apiKey
+      config.apiKey,
+      config.agentId
     );
     this.server = new import_server.Server(
       {

package/dist/index.js

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

package/dist/server.cjs

@@ -98,6 +98,7 @@ var ARTYFACTS_TOOLS = [
         title: { type: "string", description: "Artifact title" },
         type: { type: "string", description: "Artifact type: goal, spec, research, report, experiment, decision, doc" },
         content: { type: "string", description: "Markdown content" },
+        goal_id: { type: "string", description: "The goal UUID this artifact belongs to \u2014 always pass this when working on a task" },
         parent_id: { type: "string", description: "Parent artifact ID for nested artifacts" },
         tags: { type: "array", items: { type: "string" }, description: "Tags for categorization" }
       },
@@ -311,7 +312,8 @@ var ARTYFACTS_TOOLS = [
             delegate_tasks: { type: "boolean", description: "Can assign tasks to other agents" }
           }
         },
-        systemPrompt: { type: "string", description: "System prompt for the agent" }
+        systemPrompt: { type: "string", description: "System prompt for the agent" },
+        reportsToAgentId: { type: "string", description: 'Agent ID or UUID of the parent agent this agent reports to. Use agent slugs like "chief-of-staff" for readability.' }
       },
       required: ["agentId", "name", "role", "description"]
     }
@@ -404,18 +406,23 @@ var ARTYFACTS_TOOLS = [
   }
 ];
 var ArtyfactsApiClient = class {
-  constructor(baseUrl, apiKey) {
+  constructor(baseUrl, apiKey, agentId) {
     this.baseUrl = baseUrl;
     this.apiKey = apiKey;
+    this.agentId = agentId;
   }
   async request(method, path, body) {
     const url = `${this.baseUrl}${path}`;
+    const headers = {
+      "Authorization": `Bearer ${this.apiKey}`,
+      "Content-Type": "application/json"
+    };
+    if (this.agentId) {
+      headers["X-Agent-Id"] = this.agentId;
+    }
     const response = await fetch(url, {
       method,
-      headers: {
-        "Authorization": `Bearer ${this.apiKey}`,
-        "Content-Type": "application/json"
-      },
+      headers,
       body: body ? JSON.stringify(body) : void 0
     });
     if (!response.ok) {
@@ -427,6 +434,9 @@ var ArtyfactsApiClient = class {
   get(path) {
     return this.request("GET", path);
   }
+  getAgentId() {
+    return this.agentId;
+  }
   post(path, body) {
     return this.request("POST", path, body);
   }
@@ -466,6 +476,7 @@ var toolHandlers = {
         title: args.title,
         type: args.type || "document/sectioned",
         artifact_type: args.artifact_type || args.type || "doc",
+        goal_id: args.goal_id,
         parent_id: args.parent_id,
         tags: args.tags
       },
@@ -474,7 +485,7 @@ var toolHandlers = {
         body: args.content
       } : void 0,
       source: {
-        agent_id: "mcp-agent"
+        agent_id: client.getAgentId() || "mcp-agent"
       }
     };
     return client.post("/artifacts", envelope);
@@ -530,6 +541,7 @@ var toolHandlers = {
       name: args.name,
       role: args.role,
       description: args.description,
+      reportsToAgentId: args.reportsToAgentId,
       permissions: args.permissions || { write: true, delete: false, delegate_tasks: false },
       metadata: {
         capabilities: args.capabilities || [],
@@ -578,7 +590,8 @@ var ArtyfactsMcpServer = class {
     this.config = config;
     this.client = new ArtyfactsApiClient(
       config.baseUrl || "https://artyfacts.dev/api/v1",
-      config.apiKey
+      config.apiKey,
+      config.agentId
     );
     this.server = new import_server.Server(
       {

package/dist/server.d.cts

@@ -12,6 +12,8 @@ interface McpServerConfig {
     apiKey: string;
     /** Artyfacts API base URL */
     baseUrl?: string;
+    /** Agent slug (e.g. 'chief-of-staff') — used to attribute writes to the correct agent */
+    agentId?: string;
     /** Server name */
     name?: string;
     /** Server version */

package/dist/server.d.ts

@@ -12,6 +12,8 @@ interface McpServerConfig {
     apiKey: string;
     /** Artyfacts API base URL */
     baseUrl?: string;
+    /** Agent slug (e.g. 'chief-of-staff') — used to attribute writes to the correct agent */
+    agentId?: string;
     /** Server name */
     name?: string;
     /** Server version */

package/dist/server.js

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

package/package.json

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

package/src/server.ts

@@ -22,6 +22,8 @@ export interface McpServerConfig {
   apiKey: string;
   /** Artyfacts API base URL */
   baseUrl?: string;
+  /** Agent slug (e.g. 'chief-of-staff') — used to attribute writes to the correct agent */
+  agentId?: string;
   /** Server name */
   name?: string;
   /** Server version */
@@ -104,6 +106,7 @@ const ARTYFACTS_TOOLS: Tool[] = [
         title: { type: 'string', description: 'Artifact title' },
         type: { type: 'string', description: 'Artifact type: goal, spec, research, report, experiment, decision, doc' },
         content: { type: 'string', description: 'Markdown content' },
+        goal_id: { type: 'string', description: 'The goal UUID this artifact belongs to — always pass this when working on a task' },
         parent_id: { type: 'string', description: 'Parent artifact ID for nested artifacts' },
         tags: { type: 'array', items: { type: 'string' }, description: 'Tags for categorization' },
       },
@@ -321,6 +324,7 @@ const ARTYFACTS_TOOLS: Tool[] = [
           }
         },
         systemPrompt: { type: 'string', description: 'System prompt for the agent' },
+        reportsToAgentId: { type: 'string', description: 'Agent ID or UUID of the parent agent this agent reports to. Use agent slugs like "chief-of-staff" for readability.' },
       },
       required: ['agentId', 'name', 'role', 'description'],
     },
@@ -423,18 +427,24 @@ const ARTYFACTS_TOOLS: Tool[] = [
 class ArtyfactsApiClient {
   constructor(
     private baseUrl: string,
-    private apiKey: string
+    private apiKey: string,
+    private agentId?: string
   ) {}
 
   async request(method: string, path: string, body?: unknown): Promise<unknown> {
     const url = `${this.baseUrl}${path}`;
-    
+
+    const headers: Record<string, string> = {
+      'Authorization': `Bearer ${this.apiKey}`,
+      'Content-Type': 'application/json',
+    };
+    if (this.agentId) {
+      headers['X-Agent-Id'] = this.agentId;
+    }
+
     const response = await fetch(url, {
       method,
-      headers: {
-        'Authorization': `Bearer ${this.apiKey}`,
-        'Content-Type': 'application/json',
-      },
+      headers,
       body: body ? JSON.stringify(body) : undefined,
     });
 
@@ -447,6 +457,7 @@ class ArtyfactsApiClient {
   }
 
   get(path: string) { return this.request('GET', path); }
+  getAgentId() { return this.agentId; }
   post(path: string, body?: unknown) { return this.request('POST', path, body); }
   patch(path: string, body?: unknown) { return this.request('PATCH', path, body); }
   delete(path: string) { return this.request('DELETE', path); }
@@ -490,6 +501,7 @@ const toolHandlers: Record<string, ToolHandler> = {
         title: args.title,
         type: args.type || 'document/sectioned',
         artifact_type: args.artifact_type || args.type || 'doc',
+        goal_id: args.goal_id,
         parent_id: args.parent_id,
         tags: args.tags,
       },
@@ -498,7 +510,7 @@ const toolHandlers: Record<string, ToolHandler> = {
         body: args.content,
       } : undefined,
       source: {
-        agent_id: 'mcp-agent',
+        agent_id: client.getAgentId() || 'mcp-agent',
       },
     };
     return client.post('/artifacts', envelope);
@@ -559,6 +571,7 @@ const toolHandlers: Record<string, ToolHandler> = {
       name: args.name,
       role: args.role,
       description: args.description,
+      reportsToAgentId: args.reportsToAgentId,
       permissions: args.permissions || { write: true, delete: false, delegate_tasks: false },
       metadata: {
         capabilities: args.capabilities || [],
@@ -616,7 +629,8 @@ export class ArtyfactsMcpServer {
     this.config = config;
     this.client = new ArtyfactsApiClient(
       config.baseUrl || 'https://artyfacts.dev/api/v1',
-      config.apiKey
+      config.apiKey,
+      config.agentId
     );
 
     this.server = new Server(