@artyfacts/claude 1.3.30 → 1.3.31

package/dist/chunk-UYZCEPPU.mjs

@@ -0,0 +1,1104 @@
+// src/auth.ts
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+import * as readline from "readline";
+var CREDENTIALS_DIR = path.join(os.homedir(), ".artyfacts");
+var CREDENTIALS_FILE = path.join(CREDENTIALS_DIR, "credentials.json");
+var DEFAULT_BASE_URL = "https://artyfacts.dev/api/v1";
+function loadCredentials() {
+  try {
+    if (!fs.existsSync(CREDENTIALS_FILE)) {
+      return null;
+    }
+    const data = fs.readFileSync(CREDENTIALS_FILE, "utf-8");
+    const credentials = JSON.parse(data);
+    if (credentials.expiresAt) {
+      const expiresAt = new Date(credentials.expiresAt);
+      if (expiresAt < /* @__PURE__ */ new Date()) {
+        console.log("\u26A0\uFE0F  Credentials have expired");
+        return null;
+      }
+    }
+    return credentials;
+  } catch (error) {
+    console.error("Failed to load credentials:", error);
+    return null;
+  }
+}
+function saveCredentials(credentials) {
+  try {
+    if (!fs.existsSync(CREDENTIALS_DIR)) {
+      fs.mkdirSync(CREDENTIALS_DIR, { mode: 448, recursive: true });
+    }
+    fs.writeFileSync(
+      CREDENTIALS_FILE,
+      JSON.stringify(credentials, null, 2),
+      { mode: 384 }
+    );
+  } catch (error) {
+    throw new Error(`Failed to save credentials: ${error}`);
+  }
+}
+function clearCredentials() {
+  try {
+    if (fs.existsSync(CREDENTIALS_FILE)) {
+      fs.unlinkSync(CREDENTIALS_FILE);
+    }
+  } catch (error) {
+    console.error("Failed to clear credentials:", error);
+  }
+}
+async function runDeviceAuth(baseUrl = DEFAULT_BASE_URL) {
+  console.log("\u{1F510} Starting device authentication...\n");
+  const deviceAuth = await requestDeviceCode(baseUrl);
+  console.log("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
+  console.log("\u{1F4CB} To authenticate, visit:");
+  console.log(`   ${deviceAuth.verificationUri}`);
+  console.log("");
+  console.log("\u{1F511} Enter this code:");
+  console.log(`   ${deviceAuth.userCode}`);
+  console.log("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n");
+  console.log("\u23F3 Waiting for authentication...\n");
+  const credentials = await pollForToken(
+    baseUrl,
+    deviceAuth.deviceCode,
+    deviceAuth.interval,
+    deviceAuth.expiresIn
+  );
+  saveCredentials(credentials);
+  console.log("\u2705 Authentication successful!");
+  console.log(`   Agent ID: ${credentials.agentId}`);
+  if (credentials.agentName) {
+    console.log(`   Agent Name: ${credentials.agentName}`);
+  }
+  console.log("");
+  return credentials;
+}
+async function requestDeviceCode(baseUrl) {
+  const response = await fetch(`${baseUrl}/auth/device`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({
+      client_id: "artyfacts-claude",
+      scope: "agent:execute"
+    })
+  });
+  if (!response.ok) {
+    const error = await response.text();
+    throw new Error(`Failed to start device auth: ${error}`);
+  }
+  const data = await response.json();
+  return {
+    deviceCode: data.deviceCode || data.device_code || "",
+    userCode: data.userCode || data.user_code || "",
+    verificationUri: data.verificationUri || data.verification_uri || `https://artyfacts.dev/auth/device`,
+    expiresIn: data.expiresIn || data.expires_in || 600,
+    interval: data.interval || 5
+  };
+}
+async function pollForToken(baseUrl, deviceCode, interval, expiresIn) {
+  const startTime = Date.now();
+  const timeoutMs = expiresIn * 1e3;
+  while (true) {
+    if (Date.now() - startTime > timeoutMs) {
+      throw new Error("Device authentication timed out");
+    }
+    await sleep(interval * 1e3);
+    const response = await fetch(`${baseUrl}/auth/device/token`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        device_code: deviceCode,
+        client_id: "artyfacts-claude"
+      })
+    });
+    if (response.ok) {
+      const data = await response.json();
+      return {
+        apiKey: data.apiKey,
+        agentId: data.agentId,
+        agentName: data.agentName,
+        expiresAt: data.expiresAt
+      };
+    }
+    const errorData = await response.json().catch(() => ({}));
+    const errorCode = errorData.error || errorData.code;
+    if (errorCode === "authorization_pending") {
+      process.stdout.write(".");
+      continue;
+    }
+    if (errorCode === "slow_down") {
+      interval = Math.min(interval * 2, 30);
+      continue;
+    }
+    if (errorCode === "expired_token") {
+      throw new Error("Device code expired. Please try again.");
+    }
+    if (errorCode === "access_denied") {
+      throw new Error("Authorization was denied.");
+    }
+    throw new Error(`Authentication failed: ${errorData.message || errorCode || response.statusText}`);
+  }
+}
+async function promptForApiKey() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  const question = (prompt) => {
+    return new Promise((resolve) => {
+      rl.question(prompt, resolve);
+    });
+  };
+  console.log("\u{1F511} Manual Configuration\n");
+  console.log("Enter your Artyfacts credentials:\n");
+  const apiKey = await question("API Key: ");
+  const agentId = await question("Agent ID: ");
+  const agentName = await question("Agent Name (optional): ");
+  rl.close();
+  if (!apiKey || !agentId) {
+    throw new Error("API Key and Agent ID are required");
+  }
+  const credentials = {
+    apiKey: apiKey.trim(),
+    agentId: agentId.trim(),
+    agentName: agentName.trim() || void 0
+  };
+  saveCredentials(credentials);
+  console.log("\n\u2705 Credentials saved!");
+  return credentials;
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function getCredentials(options) {
+  if (!options?.forceAuth) {
+    const existing = loadCredentials();
+    if (existing) {
+      return existing;
+    }
+  }
+  return runDeviceAuth(options?.baseUrl);
+}
+
+// src/context.ts
+var ContextFetcher = class {
+  config;
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Fetch full context for a task
+   */
+  async fetchTaskContext(taskId) {
+    const response = await fetch(
+      `${this.config.baseUrl}/tasks/${taskId}/context`,
+      {
+        headers: {
+          "Authorization": `Bearer ${this.config.apiKey}`,
+          "Accept": "application/json"
+        }
+      }
+    );
+    if (!response.ok) {
+      const errorText = await response.text().catch(() => "Unknown error");
+      throw new Error(`Failed to fetch task context: ${response.status} - ${errorText}`);
+    }
+    const data = await response.json();
+    return data;
+  }
+};
+function buildPromptWithContext(context) {
+  const parts = [];
+  parts.push(`You are an AI agent working within the Artyfacts task management system.
+
+Your job is to complete the assigned task. You have full context about the organization, project, and related work.
+
+## Available Tools
+
+You have access to Artyfacts MCP tools. USE THEM to complete your task:
+
+- **list_agents** - List all agents in the organization (call this FIRST when creating tasks)
+- **create_task** - Create a new task under a goal (requires goal_id, should include assigned_to)
+- **create_goal** - Create a new goal (top-level objective)
+- **create_artifact** - Create a new artifact (document output \u2014 use for any written content, specs, reports, copy, frameworks, research)
+- **create_section** - Add a chapter/section to an artifact (use to add the actual content body)
+- **claim_task** - Claim a task for execution
+- **complete_task** - Mark a task as complete (returns unblocked tasks)
+- **block_task** - Block a task with a reason
+- **list_tasks** - Query tasks from the queue
+- **list_inbox** - Check pending decisions/approvals
+- **resolve_inbox** - Resolve an inbox item
+
+## When to create an artifact
+
+If the task involves producing ANY written content \u2014 copy, documentation, a framework, a spec, a report, research, a plan, a strategy, or any other document \u2014 you MUST:
+1. Call **create_artifact** to create the document (use an appropriate type: 'doc', 'spec', 'report', 'research', 'runbook')
+2. Call **create_section** one or more times to write the actual content into the artifact
+3. When calling **complete_task**, pass the artifact's ID as 'output_artifact_id' so it is linked to this task
+
+Do NOT just summarize what you did in the completion note. The artifact IS the deliverable.
+
+## Task type decision guide
+
+- Task asks to **write, draft, create, document, design, research, analyze, plan** \u2192 create an artifact with sections containing the full content
+- Task asks to **generate tasks, break down, plan work** \u2192 call list_agents then create_task for each subtask (do NOT create an artifact)
+- Task asks to **validate, test, verify** \u2192 complete the work directly, report findings in the completion note
+
+## Other rules
+
+- Tasks and goals are SEPARATE from artifacts. Use **create_task** to create tasks, **create_goal** to create goals.
+- When asked to generate tasks for a goal, FIRST call **list_agents** to see available agents, then use **create_task** with the goal's ID and assign each task to the most appropriate agent based on their role.
+- Always assign tasks to an agent using the agent's UUID in the **assigned_to** field. Match tasks to agents by their role description.
+- **CRITICAL: Only use 'create_task' when the task explicitly asks you to generate, plan, or decompose work into subtasks.** Do NOT create new tasks as a way to demonstrate, test, or validate your work \u2014 that causes infinite loops.
+- USE THE TOOLS to take action \u2014 don't just describe what you would do.
+
+Format your response as follows:
+1. First, use the tools to complete the task
+2. Then summarize what you did
+3. End with a brief summary line starting with "SUMMARY:"`);
+  parts.push("");
+  parts.push("---");
+  parts.push("");
+  parts.push("## Organization Context");
+  parts.push(`**${context.organization.name}**`);
+  if (context.organization.context) {
+    parts.push("");
+    parts.push(formatOrgContext(context.organization.context));
+  }
+  parts.push("");
+  if (context.project) {
+    parts.push(`## Project: ${context.project.name}`);
+    if (context.project.description) {
+      parts.push(context.project.description);
+    }
+    parts.push("");
+  }
+  const goal = context.goal || context.artifact;
+  if (goal) {
+    parts.push(`## Goal: ${goal.title}`);
+    parts.push(`**Goal ID:** ${goal.id}`);
+    if (goal.objective) {
+      parts.push(`**Objective:** ${goal.objective}`);
+    }
+    if (goal.summary) {
+      parts.push(goal.summary);
+    }
+    if (goal.description) {
+      parts.push("");
+      parts.push(goal.description);
+    }
+    parts.push("");
+    if (goal.tasks && goal.tasks.length > 0) {
+      const relatedTasks = goal.tasks.filter((t) => t.id !== context.task.id);
+      if (relatedTasks.length > 0) {
+        parts.push("### Related Tasks:");
+        for (const task of relatedTasks) {
+          const statusEmoji = {
+            pending: "\u23F3",
+            in_progress: "\u{1F504}",
+            blocked: "\u{1F6AB}",
+            done: "\u2705"
+          }[task.status] || "\u2753";
+          const priorityBadge = task.priority ? ` [${task.priority}]` : "";
+          parts.push(`- ${statusEmoji} **${task.title}**${priorityBadge}`);
+        }
+        parts.push("");
+      }
+    }
+    if (goal.sections && goal.sections.length > 0) {
+      const relatedSections = goal.sections.filter((s) => s.id !== context.task.id);
+      if (relatedSections.length > 0) {
+        parts.push("### Related Sections:");
+        for (const section of relatedSections) {
+          const preview = section.content ? section.content.substring(0, 200) + (section.content.length > 200 ? "..." : "") : "No content";
+          const statusBadge = section.task_status ? ` [${section.task_status}]` : "";
+          parts.push(`- **${section.heading}**${statusBadge}: ${preview}`);
+        }
+        parts.push("");
+      }
+    }
+  }
+  parts.push("---");
+  parts.push("");
+  const taskTitle = context.task.title || context.task.heading;
+  parts.push(`## Your Task: ${taskTitle}`);
+  if (context.task.priority) {
+    const priorityEmoji = {
+      high: "\u{1F534} High",
+      medium: "\u{1F7E1} Medium",
+      low: "\u{1F7E2} Low"
+    }[context.task.priority] || "\u{1F7E1} Medium";
+    parts.push(`**Priority:** ${priorityEmoji}`);
+  }
+  if (context.task.depends_on && context.task.depends_on.length > 0) {
+    parts.push(`**Dependencies:** ${context.task.depends_on.length} task(s)`);
+  }
+  parts.push("");
+  parts.push("### Description");
+  const taskDescription = context.task.description || context.task.content;
+  parts.push(taskDescription || "No additional description provided.");
+  parts.push("");
+  if (context.task.expected_output) {
+    parts.push("### Expected Output");
+    if (context.task.expected_output.format) {
+      parts.push(`**Format:** ${context.task.expected_output.format}`);
+    }
+    if (context.task.expected_output.requirements && context.task.expected_output.requirements.length > 0) {
+      parts.push("**Requirements:**");
+      for (const req of context.task.expected_output.requirements) {
+        parts.push(`- ${req}`);
+      }
+    }
+    parts.push("");
+  }
+  parts.push("---");
+  parts.push("");
+  parts.push("Complete this task and provide your output below.");
+  return parts.join("\n");
+}
+function formatOrgContext(context) {
+  const trimmed = context.trim();
+  if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
+    try {
+      const parsed = JSON.parse(trimmed);
+      return formatContextObject(parsed);
+    } catch {
+      return context;
+    }
+  }
+  return context;
+}
+function formatContextObject(obj, indent = "") {
+  if (typeof obj !== "object" || obj === null) {
+    return String(obj);
+  }
+  if (Array.isArray(obj)) {
+    return obj.map((item) => `${indent}- ${formatContextObject(item, indent + "  ")}`).join("\n");
+  }
+  const lines = [];
+  for (const [key, value] of Object.entries(obj)) {
+    const label = key.replace(/_/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+    if (typeof value === "object" && value !== null) {
+      lines.push(`${indent}**${label}:**`);
+      lines.push(formatContextObject(value, indent + "  "));
+    } else {
+      lines.push(`${indent}- **${label}:** ${value}`);
+    }
+  }
+  return lines.join("\n");
+}
+function createContextFetcher(config) {
+  return new ContextFetcher(config);
+}
+
+// src/executor.ts
+import { spawn } from "child_process";
+var DEFAULT_TIMEOUT = 5 * 60 * 1e3;
+var DEFAULT_SYSTEM_PROMPT = `You are an AI agent working within the Artyfacts task management system.
+
+Your job is to complete tasks assigned to you using the available tools.
+
+## Available Tools
+
+You have access to Artyfacts MCP tools. USE THEM to complete your task:
+
+- **create_artifact** - Create new artifacts (documents, specs, reports)
+- **create_section** - Add sections to artifacts (content, tasks, decisions)
+- **update_section** - Update existing sections
+- **create_agent** - Create new AI agents with specific roles
+- **list_artifacts** - Query existing artifacts
+- **list_sections** - Query sections within an artifact
+- **complete_task** - Mark a task as complete
+- **block_task** - Block a task with a reason
+- **create_blocker** - Create a decision blocker
+
+IMPORTANT: When asked to create agents or update artifacts, USE THE TOOLS. Don't just describe what you would do - actually do it.
+
+## Guidelines
+
+- USE THE TOOLS to take action
+- If creating something, use create_artifact or create_section
+- If creating agents, use create_agent
+- If you cannot complete the task, explain why
+
+Format your response as follows:
+1. First, use the tools to complete the task
+2. Summarize what you accomplished
+3. End with a brief summary line starting with "SUMMARY:"`;
+var ClaudeExecutor = class {
+  config;
+  contextFetcher = null;
+  constructor(config = {}) {
+    this.config = {
+      ...config,
+      timeout: config.timeout || DEFAULT_TIMEOUT,
+      claudePath: config.claudePath || "claude"
+    };
+    if (config.baseUrl && config.apiKey) {
+      this.contextFetcher = createContextFetcher({
+        baseUrl: config.baseUrl,
+        apiKey: config.apiKey
+      });
+    }
+  }
+  /**
+   * Execute a task using Claude Code CLI
+   * 
+   * If full context is available (baseUrl + apiKey configured), fetches
+   * organization, project, artifact, and related sections for a rich prompt.
+   */
+  async execute(task) {
+    try {
+      let prompt;
+      let fullContext = null;
+      const useFullContext = this.config.useFullContext !== false && this.contextFetcher;
+      if (useFullContext) {
+        try {
+          const taskId = task.id || task.taskId;
+          if (!taskId) {
+            throw new Error("Task ID required for context fetch");
+          }
+          fullContext = await this.contextFetcher.fetchTaskContext(taskId);
+          prompt = buildPromptWithContext(fullContext);
+          console.log("  \u{1F4DA} Using full context (org, project, goal, related tasks)");
+        } catch (contextError) {
+          console.warn("  \u26A0\uFE0F  Could not fetch full context, using minimal prompt");
+          console.warn(`     ${contextError instanceof Error ? contextError.message : contextError}`);
+          prompt = this.buildTaskPrompt(task);
+        }
+      } else {
+        prompt = this.buildTaskPrompt(task);
+      }
+      const output = await this.runClaude(prompt);
+      const taskTitle = task.title || task.heading || "Task";
+      const { content, summary } = this.parseResponse(output, taskTitle);
+      return {
+        success: true,
+        output: content,
+        summary,
+        promptUsed: prompt
+      };
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      return {
+        success: false,
+        output: "",
+        summary: `Failed: ${errorMessage}`,
+        error: errorMessage
+      };
+    }
+  }
+  /**
+   * Run Claude Code CLI with the given prompt
+   */
+  runClaude(prompt) {
+    return new Promise((resolve, reject) => {
+      const claudePath = this.config.claudePath || "claude";
+      const mcpConfig = {
+        mcpServers: {
+          artyfacts: {
+            command: "npx",
+            args: ["-y", "@artyfacts/mcp-server"],
+            env: {
+              ARTYFACTS_API_KEY: this.config.apiKey || process.env.ARTYFACTS_API_KEY || "",
+              ARTYFACTS_BASE_URL: this.config.baseUrl || "https://artyfacts.dev/api/v1"
+            }
+          }
+        }
+      };
+      const args = [
+        "--print",
+        "--mcp-config",
+        JSON.stringify(mcpConfig),
+        "--permission-mode",
+        "bypassPermissions"
+      ];
+      const proc = spawn(claudePath, args, {
+        stdio: ["pipe", "pipe", "pipe"],
+        timeout: this.config.timeout
+      });
+      let stdout = "";
+      let stderr = "";
+      proc.stdout.on("data", (data) => {
+        stdout += data.toString();
+      });
+      proc.stderr.on("data", (data) => {
+        stderr += data.toString();
+      });
+      proc.on("close", (code) => {
+        if (code === 0) {
+          resolve(stdout.trim());
+        } else {
+          reject(new Error(stderr || `Claude exited with code ${code}`));
+        }
+      });
+      proc.on("error", (err) => {
+        if (err.code === "ENOENT") {
+          reject(new Error(
+            "Claude Code CLI not found. Please install it:\n  npm install -g @anthropic-ai/claude-code"
+          ));
+        } else {
+          reject(err);
+        }
+      });
+      proc.stdin.write(prompt);
+      proc.stdin.end();
+    });
+  }
+  /**
+   * Build the task prompt (v2)
+   */
+  buildTaskPrompt(task) {
+    const parts = [];
+    const systemPrompt = this.config.systemPromptPrefix ? `${this.config.systemPromptPrefix}
+
+${DEFAULT_SYSTEM_PROMPT}` : DEFAULT_SYSTEM_PROMPT;
+    parts.push(systemPrompt);
+    parts.push("");
+    parts.push("---");
+    parts.push("");
+    const taskTitle = task.title || task.heading;
+    parts.push(`# Task: ${taskTitle}`);
+    parts.push("");
+    const goalTitle = task.goalTitle || task.artifactTitle;
+    const goalId = task.goalId || task.artifactId;
+    if (goalTitle) {
+      parts.push(`**Goal:** ${goalTitle}`);
+    }
+    if (goalId) {
+      parts.push(`**Goal ID:** ${goalId}`);
+    }
+    if (task.priority) {
+      const priorityEmoji = {
+        high: "\u{1F534} High",
+        medium: "\u{1F7E1} Medium",
+        low: "\u{1F7E2} Low"
+      }[task.priority] || "\u{1F7E1} Medium";
+      parts.push(`**Priority:** ${priorityEmoji}`);
+    }
+    parts.push("");
+    parts.push("## Description");
+    const taskDescription = task.description || task.content;
+    parts.push(taskDescription || "No additional description provided.");
+    parts.push("");
+    if (task.context && Object.keys(task.context).length > 0) {
+      parts.push("## Additional Context");
+      parts.push("```json");
+      parts.push(JSON.stringify(task.context, null, 2));
+      parts.push("```");
+      parts.push("");
+    }
+    parts.push("## Instructions");
+    parts.push("Complete this task and provide your output below.");
+    return parts.join("\n");
+  }
+  /**
+   * Parse the response to extract output and summary
+   */
+  parseResponse(fullOutput, taskHeading) {
+    const summaryMatch = fullOutput.match(/SUMMARY:\s*(.+?)(?:\n|$)/i);
+    if (summaryMatch) {
+      const summary2 = summaryMatch[1].trim();
+      const content = fullOutput.replace(/SUMMARY:\s*.+?(?:\n|$)/i, "").trim();
+      return { content, summary: summary2 };
+    }
+    const lines = fullOutput.split("\n").filter((l) => l.trim());
+    const firstLine = lines[0] || "";
+    const summary = firstLine.length > 100 ? `${firstLine.substring(0, 97)}...` : firstLine || `Completed: ${taskHeading}`;
+    return { content: fullOutput, summary };
+  }
+  /**
+   * Test that Claude Code CLI is available and working
+   */
+  async testConnection() {
+    try {
+      const output = await this.runClaude('Say "connected" and nothing else.');
+      return output.toLowerCase().includes("connected");
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Check if Claude Code CLI is installed
+   */
+  async isInstalled() {
+    return new Promise((resolve) => {
+      const proc = spawn(this.config.claudePath || "claude", ["--version"], {
+        stdio: ["ignore", "pipe", "pipe"]
+      });
+      proc.on("close", (code) => {
+        resolve(code === 0);
+      });
+      proc.on("error", () => {
+        resolve(false);
+      });
+    });
+  }
+};
+function createExecutor(config) {
+  return new ClaudeExecutor(config);
+}
+
+// src/listener.ts
+import EventSource from "eventsource";
+var DEFAULT_BASE_URL2 = "https://artyfacts.dev/api/v1";
+var EVENT_TYPES = [
+  "connected",
+  "heartbeat",
+  "task_assigned",
+  "task_unblocked",
+  "blocker_resolved",
+  "notification",
+  "mcp_connect_request",
+  "connection_status"
+];
+var ArtyfactsListener = class {
+  config;
+  eventSource = null;
+  callbacks = /* @__PURE__ */ new Map();
+  allCallbacks = /* @__PURE__ */ new Set();
+  state = "disconnected";
+  reconnectAttempts = 0;
+  maxReconnectAttempts = 10;
+  reconnectDelay = 1e3;
+  constructor(config) {
+    if (!config.apiKey) {
+      throw new Error("API key is required");
+    }
+    if (!config.agentId) {
+      throw new Error("Agent ID is required");
+    }
+    this.config = {
+      ...config,
+      baseUrl: config.baseUrl || DEFAULT_BASE_URL2
+    };
+  }
+  /**
+   * Get current connection state
+   */
+  get connectionState() {
+    return this.state;
+  }
+  /**
+   * Check if connected
+   */
+  get isConnected() {
+    return this.state === "connected";
+  }
+  /**
+   * Subscribe to all events
+   */
+  subscribe(callback) {
+    this.allCallbacks.add(callback);
+    return () => {
+      this.allCallbacks.delete(callback);
+    };
+  }
+  /**
+   * Subscribe to a specific event type
+   */
+  on(type, callback) {
+    if (!this.callbacks.has(type)) {
+      this.callbacks.set(type, /* @__PURE__ */ new Set());
+    }
+    this.callbacks.get(type).add(callback);
+    return () => {
+      const typeCallbacks = this.callbacks.get(type);
+      if (typeCallbacks) {
+        typeCallbacks.delete(callback);
+        if (typeCallbacks.size === 0) {
+          this.callbacks.delete(type);
+        }
+      }
+    };
+  }
+  /**
+   * Connect to the SSE stream
+   */
+  connect() {
+    if (this.eventSource) {
+      return;
+    }
+    this.setState("connecting");
+    const url = new URL(`${this.config.baseUrl}/events/stream`);
+    url.searchParams.set("apiKey", this.config.apiKey);
+    url.searchParams.set("agentId", this.config.agentId);
+    this.eventSource = new EventSource(url.toString(), {
+      headers: {
+        "Authorization": `Bearer ${this.config.apiKey}`
+      }
+    });
+    this.eventSource.onopen = () => {
+      this.reconnectAttempts = 0;
+      this.reconnectDelay = 1e3;
+      this.setState("connected");
+    };
+    this.eventSource.onmessage = (event) => {
+      this.handleMessage(event);
+    };
+    this.eventSource.onerror = (event) => {
+      this.handleError(event);
+    };
+    for (const eventType of EVENT_TYPES) {
+      this.eventSource.addEventListener(eventType, (event) => {
+        this.handleMessage(event, eventType);
+      });
+    }
+  }
+  /**
+   * Disconnect from the SSE stream
+   */
+  disconnect() {
+    if (this.eventSource) {
+      this.eventSource.close();
+      this.eventSource = null;
+    }
+    this.setState("disconnected");
+  }
+  /**
+   * Reconnect to the SSE stream
+   */
+  reconnect() {
+    this.disconnect();
+    this.connect();
+  }
+  /**
+   * Handle incoming SSE message
+   */
+  handleMessage(event, eventType) {
+    try {
+      const data = JSON.parse(event.data);
+      const rawData = data.data || data;
+      const normalizedData = rawData.id || rawData.task_id ? {
+        // v2 fields (primary)
+        id: rawData.id || rawData.task_id,
+        goalId: rawData.goal_id || rawData.artifact_id,
+        goalTitle: rawData.goal_title || rawData.artifact_title,
+        title: rawData.title || rawData.heading,
+        description: rawData.description || rawData.content,
+        priority: rawData.priority,
+        assignedTo: rawData.assigned_to,
+        assignedAt: rawData.assigned_at,
+        // Deprecated fields for backwards compatibility
+        taskId: rawData.id || rawData.task_id,
+        artifactId: rawData.goal_id || rawData.artifact_id,
+        artifactTitle: rawData.goal_title || rawData.artifact_title,
+        heading: rawData.title || rawData.heading,
+        content: rawData.description || rawData.content,
+        ...rawData
+        // Keep original fields too
+      } : rawData;
+      const artyfactsEvent = {
+        type: eventType || data.type || "unknown",
+        timestamp: data.timestamp || (/* @__PURE__ */ new Date()).toISOString(),
+        data: normalizedData
+      };
+      const typeCallbacks = this.callbacks.get(artyfactsEvent.type);
+      if (typeCallbacks) {
+        for (const callback of typeCallbacks) {
+          this.safeCallCallback(callback, artyfactsEvent);
+        }
+      }
+      for (const callback of this.allCallbacks) {
+        this.safeCallCallback(callback, artyfactsEvent);
+      }
+    } catch (err) {
+      console.error("[Listener] Failed to parse SSE message:", event.data, err);
+    }
+  }
+  /**
+   * Safely call a callback, handling async and errors
+   */
+  async safeCallCallback(callback, event) {
+    try {
+      await callback(event);
+    } catch (err) {
+      console.error(`[Listener] Error in event callback for '${event.type}':`, err);
+    }
+  }
+  /**
+   * Handle SSE error
+   */
+  handleError(event) {
+    if (this.eventSource?.readyState === EventSource.CONNECTING) {
+      this.setState("reconnecting");
+    } else if (this.eventSource?.readyState === EventSource.CLOSED) {
+      this.setState("disconnected");
+      if (this.reconnectAttempts < this.maxReconnectAttempts) {
+        this.reconnectAttempts++;
+        this.reconnectDelay = Math.min(this.reconnectDelay * 2, 3e4);
+        console.log(
+          `[Listener] Connection lost, reconnecting in ${this.reconnectDelay / 1e3}s (attempt ${this.reconnectAttempts}/${this.maxReconnectAttempts})`
+        );
+        setTimeout(() => {
+          if (this.state === "disconnected") {
+            this.connect();
+          }
+        }, this.reconnectDelay);
+      } else {
+        const error = new Error("Max reconnection attempts reached");
+        this.config.onError?.(error);
+      }
+    }
+  }
+  /**
+   * Update connection state
+   */
+  setState(state) {
+    if (this.state !== state) {
+      this.state = state;
+      this.config.onStateChange?.(state);
+    }
+  }
+};
+function createListener(config) {
+  return new ArtyfactsListener(config);
+}
+
+// src/mcp.ts
+import { spawnSync } from "child_process";
+var DEFAULT_BASE_URL3 = "https://artyfacts.dev/api/v1";
+var OAUTH_MCP_SERVERS = {
+  supabase: {
+    url: "https://mcp.supabase.com/mcp",
+    name: "supabase"
+  },
+  figma: {
+    url: "https://mcp.figma.com/mcp",
+    name: "figma"
+  }
+};
+var CREDENTIAL_MCP_CONFIGS = {
+  postgres: (config) => ({
+    command: "npx",
+    args: ["-y", "@modelcontextprotocol/server-postgres", config.connection_string]
+  }),
+  github: (config) => ({
+    command: "npx",
+    args: ["-y", "@modelcontextprotocol/server-github"],
+    env: {
+      GITHUB_PERSONAL_ACCESS_TOKEN: config.api_key
+    }
+  }),
+  filesystem: (config) => ({
+    command: "npx",
+    args: ["-y", "@modelcontextprotocol/server-filesystem", ...config.paths || []]
+  })
+};
+function addMcpServer(options) {
+  const { name, transport, url, command, args = [], env = {}, scope = "user" } = options;
+  const cliArgs = ["mcp", "add", "-s", scope, "-t", transport];
+  for (const [key, value] of Object.entries(env)) {
+    cliArgs.push("-e", `${key}=${value}`);
+  }
+  cliArgs.push(name);
+  if (transport === "http" && url) {
+    cliArgs.push(url);
+  } else if (transport === "stdio" && command) {
+    cliArgs.push("--", command, ...args);
+  } else {
+    return { success: false, error: "Invalid configuration: missing url or command" };
+  }
+  console.log(`[MCP] Running: claude ${cliArgs.join(" ")}`);
+  const result = spawnSync("claude", cliArgs, {
+    encoding: "utf-8",
+    stdio: ["pipe", "pipe", "pipe"]
+  });
+  if (result.status === 0) {
+    return { success: true };
+  } else {
+    const error = result.stderr || result.stdout || `Exit code ${result.status}`;
+    if (error.includes("already exists")) {
+      console.log(`[MCP] Server ${name} exists - removing old config...`);
+      spawnSync("claude", ["mcp", "remove", name], { encoding: "utf-8" });
+      const retryResult = spawnSync("claude", cliArgs, {
+        encoding: "utf-8",
+        stdio: ["pipe", "pipe", "pipe"]
+      });
+      if (retryResult.status === 0) {
+        return { success: true, replaced: true };
+      } else {
+        return { success: false, error: retryResult.stderr || retryResult.stdout || "Failed after removing old config" };
+      }
+    }
+    return { success: false, error };
+  }
+}
+var McpHandler = class {
+  config;
+  constructor(config) {
+    this.config = {
+      ...config,
+      baseUrl: config.baseUrl || DEFAULT_BASE_URL3
+    };
+  }
+  /**
+   * Handle an MCP connect request event
+   * Uses `claude mcp add` to configure the server dynamically
+   */
+  async handleConnectRequest(event) {
+    const { connection_id, platform, config: mcpConfig } = event.data;
+    try {
+      const serverName = mcpConfig?.server_name || platform;
+      const oauthServer = OAUTH_MCP_SERVERS[platform];
+      if (oauthServer) {
+        const result = addMcpServer({
+          name: serverName,
+          transport: "http",
+          url: oauthServer.url
+        });
+        if (!result.success) {
+          throw new Error(`Failed to add ${platform} MCP: ${result.error}`);
+        }
+        console.log(`[MCP] Added ${serverName} \u2192 ${oauthServer.url}`);
+        console.log(`[MCP] Starting ${platform} OAuth...`);
+        console.log(`[MCP] Claude will open - authenticate in browser, then type "done" to continue`);
+        console.log("");
+        const oauthProcess = spawnSync("claude", [
+          "--allowedTools",
+          `mcp__${serverName}__*`,
+          "--permission-mode",
+          "bypassPermissions",
+          `Authenticate with ${serverName} MCP now. Call the authenticate tool immediately.`
+        ], {
+          encoding: "utf-8",
+          stdio: "inherit",
+          // Interactive - user can see and respond
+          timeout: 3e5
+          // 5 minute timeout for OAuth
+        });
+        if (oauthProcess.status === 0) {
+          console.log(`[MCP] ${platform} OAuth completed!`);
+        } else {
+          console.log(`[MCP] OAuth session ended`);
+        }
+      } else {
+        const configBuilder = CREDENTIAL_MCP_CONFIGS[platform];
+        if (!configBuilder) {
+          throw new Error(`Unsupported MCP platform: ${platform}. Supported: ${[...Object.keys(OAUTH_MCP_SERVERS), ...Object.keys(CREDENTIAL_MCP_CONFIGS)].join(", ")}`);
+        }
+        if (!mcpConfig) {
+          throw new Error(`Platform ${platform} requires configuration (connection_string or api_key)`);
+        }
+        const serverConfig = configBuilder(mcpConfig);
+        const result = addMcpServer({
+          name: serverName,
+          transport: "stdio",
+          command: serverConfig.command,
+          args: serverConfig.args,
+          env: serverConfig.env
+        });
+        if (!result.success) {
+          throw new Error(`Failed to add ${platform} MCP: ${result.error}`);
+        }
+        console.log(`[MCP] Added ${serverName} for ${platform}`);
+      }
+      await this.updateConnectionStatus(connection_id, {
+        status: "active",
+        mcp_configured: true
+      });
+      this.config.onConfigured?.(connection_id, platform);
+    } catch (err) {
+      console.error(`[MCP] Failed to configure ${platform}:`, err);
+      await this.updateConnectionStatus(connection_id, {
+        status: "error",
+        mcp_configured: false,
+        error_message: err.message
+      });
+      this.config.onError?.(err, connection_id);
+    }
+  }
+  /**
+   * Check if a platform supports OAuth (no credentials needed)
+   */
+  static supportsOAuth(platform) {
+    return platform in OAUTH_MCP_SERVERS;
+  }
+  /**
+   * Get list of platforms with OAuth support
+   */
+  static getOAuthPlatforms() {
+    return Object.keys(OAUTH_MCP_SERVERS);
+  }
+  /**
+   * Update connection status in Artyfacts
+   */
+  async updateConnectionStatus(connectionId, update) {
+    const url = `${this.config.baseUrl}/connections/${connectionId}`;
+    console.log(`[MCP] Updating connection ${connectionId} to status: ${update.status}`);
+    try {
+      const response = await fetch(url, {
+        method: "PATCH",
+        headers: {
+          "Authorization": `Bearer ${this.config.apiKey}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify(update)
+      });
+      if (!response.ok) {
+        const body = await response.text();
+        console.error(`[MCP] Failed to update connection status: ${response.status} - ${body}`);
+      } else {
+        console.log(`[MCP] Connection ${connectionId} updated to ${update.status}`);
+      }
+    } catch (err) {
+      console.error("[MCP] Failed to update connection status:", err);
+    }
+  }
+  /**
+   * List configured MCP servers using `claude mcp list`
+   */
+  listServers() {
+    const result = spawnSync("claude", ["mcp", "list"], {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    if (result.status === 0 && result.stdout) {
+      return result.stdout.trim().split("\n").filter(Boolean);
+    }
+    return [];
+  }
+  /**
+   * Remove an MCP server using `claude mcp remove`
+   */
+  removeServer(serverName) {
+    const result = spawnSync("claude", ["mcp", "remove", serverName], {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    if (result.status === 0) {
+      console.log(`[MCP] Removed server: ${serverName}`);
+      return true;
+    } else {
+      console.error(`[MCP] Failed to remove ${serverName}: ${result.stderr || result.stdout}`);
+      return false;
+    }
+  }
+};
+function createMcpHandler(config) {
+  return new McpHandler(config);
+}
+
+export {
+  loadCredentials,
+  saveCredentials,
+  clearCredentials,
+  runDeviceAuth,
+  promptForApiKey,
+  getCredentials,
+  ContextFetcher,
+  buildPromptWithContext,
+  createContextFetcher,
+  ClaudeExecutor,
+  createExecutor,
+  ArtyfactsListener,
+  createListener,
+  McpHandler,
+  createMcpHandler
+};

package/dist/cli.js

@@ -258,8 +258,8 @@ You have access to Artyfacts MCP tools. USE THEM to complete your task:
 - **list_agents** - List all agents in the organization (call this FIRST when creating tasks)
 - **create_task** - Create a new task under a goal (requires goal_id, should include assigned_to)
 - **create_goal** - Create a new goal (top-level objective)
-- **create_artifact** - Create a new artifact (document output linked to a task, NOT a goal or task itself)
-- **create_section** - Add a chapter/section to an artifact document
+- **create_artifact** - Create a new artifact (document output \u2014 use for any written content, specs, reports, copy, frameworks, research)
+- **create_section** - Add a chapter/section to an artifact (use to add the actual content body)
 - **claim_task** - Claim a task for execution
 - **complete_task** - Mark a task as complete (returns unblocked tasks)
 - **block_task** - Block a task with a reason
@@ -267,22 +267,29 @@ You have access to Artyfacts MCP tools. USE THEM to complete your task:
 - **list_inbox** - Check pending decisions/approvals
 - **resolve_inbox** - Resolve an inbox item
 
-IMPORTANT:
+## When to create an artifact
+
+If the task involves producing ANY written content \u2014 copy, documentation, a framework, a spec, a report, research, a plan, a strategy, or any other document \u2014 you MUST:
+1. Call **create_artifact** to create the document (use an appropriate type: 'doc', 'spec', 'report', 'research', 'runbook')
+2. Call **create_section** one or more times to write the actual content into the artifact
+3. When calling **complete_task**, pass the artifact's ID as 'output_artifact_id' so it is linked to this task
+
+Do NOT just summarize what you did in the completion note. The artifact IS the deliverable.
+
+## Task type decision guide
+
+- Task asks to **write, draft, create, document, design, research, analyze, plan** \u2192 create an artifact with sections containing the full content
+- Task asks to **generate tasks, break down, plan work** \u2192 call list_agents then create_task for each subtask (do NOT create an artifact)
+- Task asks to **validate, test, verify** \u2192 complete the work directly, report findings in the completion note
+
+## Other rules
+
 - Tasks and goals are SEPARATE from artifacts. Use **create_task** to create tasks, **create_goal** to create goals.
-- Use **create_artifact** only for document outputs (specs, reports, research) \u2014 never to represent a goal or task.
-- When asked to generate tasks for a goal, FIRST call **list_agents** to see available agents, then use **create_task** with the goal's ID and assign each task to the most appropriate agent based on their role. Do NOT create an artifact.
+- When asked to generate tasks for a goal, FIRST call **list_agents** to see available agents, then use **create_task** with the goal's ID and assign each task to the most appropriate agent based on their role.
 - Always assign tasks to an agent using the agent's UUID in the **assigned_to** field. Match tasks to agents by their role description.
-- **CRITICAL: Only use 'create_task' when the task explicitly asks you to generate, plan, or decompose work into subtasks.** For all other tasks, complete the work directly and call 'complete_task'. Do NOT create new tasks as a way to demonstrate, test, or validate your work \u2014 that causes infinite loops.
+- **CRITICAL: Only use 'create_task' when the task explicitly asks you to generate, plan, or decompose work into subtasks.** Do NOT create new tasks as a way to demonstrate, test, or validate your work \u2014 that causes infinite loops.
 - USE THE TOOLS to take action \u2014 don't just describe what you would do.
 
-## Guidelines
-
-- Be thorough but concise
-- USE THE TOOLS to take action, don't just analyze
-- If the task requires creating something, use create_artifact or create_section
-- If you complete a task, check the response for unblocked_tasks to see follow-up work
-- If you cannot complete the task, explain why
-
 Format your response as follows:
 1. First, use the tools to complete the task
 2. Then summarize what you did

package/dist/cli.mjs

@@ -7,7 +7,7 @@ import {
   getCredentials,
   loadCredentials,
   promptForApiKey
-} from "./chunk-OAMZVDDD.mjs";
+} from "./chunk-UYZCEPPU.mjs";
 
 // src/cli.ts
 import { Command } from "commander";

package/dist/index.js

@@ -290,8 +290,8 @@ You have access to Artyfacts MCP tools. USE THEM to complete your task:
 - **list_agents** - List all agents in the organization (call this FIRST when creating tasks)
 - **create_task** - Create a new task under a goal (requires goal_id, should include assigned_to)
 - **create_goal** - Create a new goal (top-level objective)
-- **create_artifact** - Create a new artifact (document output linked to a task, NOT a goal or task itself)
-- **create_section** - Add a chapter/section to an artifact document
+- **create_artifact** - Create a new artifact (document output \u2014 use for any written content, specs, reports, copy, frameworks, research)
+- **create_section** - Add a chapter/section to an artifact (use to add the actual content body)
 - **claim_task** - Claim a task for execution
 - **complete_task** - Mark a task as complete (returns unblocked tasks)
 - **block_task** - Block a task with a reason
@@ -299,22 +299,29 @@ You have access to Artyfacts MCP tools. USE THEM to complete your task:
 - **list_inbox** - Check pending decisions/approvals
 - **resolve_inbox** - Resolve an inbox item
 
-IMPORTANT:
+## When to create an artifact
+
+If the task involves producing ANY written content \u2014 copy, documentation, a framework, a spec, a report, research, a plan, a strategy, or any other document \u2014 you MUST:
+1. Call **create_artifact** to create the document (use an appropriate type: 'doc', 'spec', 'report', 'research', 'runbook')
+2. Call **create_section** one or more times to write the actual content into the artifact
+3. When calling **complete_task**, pass the artifact's ID as 'output_artifact_id' so it is linked to this task
+
+Do NOT just summarize what you did in the completion note. The artifact IS the deliverable.
+
+## Task type decision guide
+
+- Task asks to **write, draft, create, document, design, research, analyze, plan** \u2192 create an artifact with sections containing the full content
+- Task asks to **generate tasks, break down, plan work** \u2192 call list_agents then create_task for each subtask (do NOT create an artifact)
+- Task asks to **validate, test, verify** \u2192 complete the work directly, report findings in the completion note
+
+## Other rules
+
 - Tasks and goals are SEPARATE from artifacts. Use **create_task** to create tasks, **create_goal** to create goals.
-- Use **create_artifact** only for document outputs (specs, reports, research) \u2014 never to represent a goal or task.
-- When asked to generate tasks for a goal, FIRST call **list_agents** to see available agents, then use **create_task** with the goal's ID and assign each task to the most appropriate agent based on their role. Do NOT create an artifact.
+- When asked to generate tasks for a goal, FIRST call **list_agents** to see available agents, then use **create_task** with the goal's ID and assign each task to the most appropriate agent based on their role.
 - Always assign tasks to an agent using the agent's UUID in the **assigned_to** field. Match tasks to agents by their role description.
-- **CRITICAL: Only use 'create_task' when the task explicitly asks you to generate, plan, or decompose work into subtasks.** For all other tasks, complete the work directly and call 'complete_task'. Do NOT create new tasks as a way to demonstrate, test, or validate your work \u2014 that causes infinite loops.
+- **CRITICAL: Only use 'create_task' when the task explicitly asks you to generate, plan, or decompose work into subtasks.** Do NOT create new tasks as a way to demonstrate, test, or validate your work \u2014 that causes infinite loops.
 - USE THE TOOLS to take action \u2014 don't just describe what you would do.
 
-## Guidelines
-
-- Be thorough but concise
-- USE THE TOOLS to take action, don't just analyze
-- If the task requires creating something, use create_artifact or create_section
-- If you complete a task, check the response for unblocked_tasks to see follow-up work
-- If you cannot complete the task, explain why
-
 Format your response as follows:
 1. First, use the tools to complete the task
 2. Then summarize what you did

package/dist/index.mjs

@@ -14,7 +14,7 @@ import {
   promptForApiKey,
   runDeviceAuth,
   saveCredentials
-} from "./chunk-OAMZVDDD.mjs";
+} from "./chunk-UYZCEPPU.mjs";
 
 // node_modules/@anthropic-ai/sdk/internal/tslib.mjs
 function __classPrivateFieldSet(receiver, state, value, kind, f) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artyfacts/claude",
-  "version": "1.3.30",
+  "version": "1.3.31",
   "description": "Claude adapter for Artyfacts - Execute tasks using Claude Code CLI",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/context.ts

@@ -156,8 +156,8 @@ You have access to Artyfacts MCP tools. USE THEM to complete your task:
 - **list_agents** - List all agents in the organization (call this FIRST when creating tasks)
 - **create_task** - Create a new task under a goal (requires goal_id, should include assigned_to)
 - **create_goal** - Create a new goal (top-level objective)
-- **create_artifact** - Create a new artifact (document output linked to a task, NOT a goal or task itself)
-- **create_section** - Add a chapter/section to an artifact document
+- **create_artifact** - Create a new artifact (document output — use for any written content, specs, reports, copy, frameworks, research)
+- **create_section** - Add a chapter/section to an artifact (use to add the actual content body)
 - **claim_task** - Claim a task for execution
 - **complete_task** - Mark a task as complete (returns unblocked tasks)
 - **block_task** - Block a task with a reason
@@ -165,22 +165,29 @@ You have access to Artyfacts MCP tools. USE THEM to complete your task:
 - **list_inbox** - Check pending decisions/approvals
 - **resolve_inbox** - Resolve an inbox item
 
-IMPORTANT:
+## When to create an artifact
+
+If the task involves producing ANY written content — copy, documentation, a framework, a spec, a report, research, a plan, a strategy, or any other document — you MUST:
+1. Call **create_artifact** to create the document (use an appropriate type: 'doc', 'spec', 'report', 'research', 'runbook')
+2. Call **create_section** one or more times to write the actual content into the artifact
+3. When calling **complete_task**, pass the artifact's ID as 'output_artifact_id' so it is linked to this task
+
+Do NOT just summarize what you did in the completion note. The artifact IS the deliverable.
+
+## Task type decision guide
+
+- Task asks to **write, draft, create, document, design, research, analyze, plan** → create an artifact with sections containing the full content
+- Task asks to **generate tasks, break down, plan work** → call list_agents then create_task for each subtask (do NOT create an artifact)
+- Task asks to **validate, test, verify** → complete the work directly, report findings in the completion note
+
+## Other rules
+
 - Tasks and goals are SEPARATE from artifacts. Use **create_task** to create tasks, **create_goal** to create goals.
-- Use **create_artifact** only for document outputs (specs, reports, research) — never to represent a goal or task.
-- When asked to generate tasks for a goal, FIRST call **list_agents** to see available agents, then use **create_task** with the goal's ID and assign each task to the most appropriate agent based on their role. Do NOT create an artifact.
+- When asked to generate tasks for a goal, FIRST call **list_agents** to see available agents, then use **create_task** with the goal's ID and assign each task to the most appropriate agent based on their role.
 - Always assign tasks to an agent using the agent's UUID in the **assigned_to** field. Match tasks to agents by their role description.
-- **CRITICAL: Only use 'create_task' when the task explicitly asks you to generate, plan, or decompose work into subtasks.** For all other tasks, complete the work directly and call 'complete_task'. Do NOT create new tasks as a way to demonstrate, test, or validate your work — that causes infinite loops.
+- **CRITICAL: Only use 'create_task' when the task explicitly asks you to generate, plan, or decompose work into subtasks.** Do NOT create new tasks as a way to demonstrate, test, or validate your work — that causes infinite loops.
 - USE THE TOOLS to take action — don't just describe what you would do.
 
-## Guidelines
-
-- Be thorough but concise
-- USE THE TOOLS to take action, don't just analyze
-- If the task requires creating something, use create_artifact or create_section
-- If you complete a task, check the response for unblocked_tasks to see follow-up work
-- If you cannot complete the task, explain why
-
 Format your response as follows:
 1. First, use the tools to complete the task
 2. Then summarize what you did