@artyfacts/claude 1.3.4 → 1.3.6

package/dist/chunk-CNJCMX2D.mjs

@@ -0,0 +1,787 @@
+// 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:
+
+- **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 with the tools.
+
+## 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 the task requires 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. 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("");
+  }
+  parts.push(`## Artifact: ${context.artifact.title}`);
+  if (context.artifact.summary) {
+    parts.push(context.artifact.summary);
+  }
+  if (context.artifact.description) {
+    parts.push("");
+    parts.push(context.artifact.description);
+  }
+  parts.push("");
+  const relatedSections = context.artifact.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("");
+  parts.push(`## Your Task: ${context.task.heading}`);
+  if (context.task.priority) {
+    const priorityLabels = ["\u{1F534} High", "\u{1F7E1} Medium", "\u{1F7E2} Low"];
+    parts.push(`**Priority:** ${priorityLabels[context.task.priority - 1] || "Medium"}`);
+  }
+  parts.push("");
+  parts.push("### Description");
+  parts.push(context.task.content || "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 {
+          fullContext = await this.contextFetcher.fetchTaskContext(task.taskId);
+          prompt = buildPromptWithContext(fullContext);
+          console.log("  \u{1F4DA} Using full context (org, project, artifact, related sections)");
+        } 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 { content, summary } = this.parseResponse(output, task.heading);
+      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 proc = spawn(claudePath, ["--print"], {
+        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
+   */
+  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("");
+    parts.push(`# Task: ${task.heading}`);
+    parts.push("");
+    if (task.artifactTitle) {
+      parts.push(`**Artifact:** ${task.artifactTitle}`);
+    }
+    if (task.priority) {
+      const priorityLabels = ["High", "Medium", "Low"];
+      parts.push(`**Priority:** ${priorityLabels[task.priority - 1] || "Medium"}`);
+    }
+    parts.push("");
+    parts.push("## Description");
+    parts.push(task.content || "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"
+];
+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.task_id ? {
+        taskId: rawData.task_id,
+        sectionId: rawData.section_id,
+        artifactId: rawData.artifact_id,
+        artifactTitle: rawData.artifact_title,
+        heading: rawData.heading,
+        content: rawData.content,
+        assignedTo: rawData.assigned_to,
+        assignedAt: rawData.assigned_at,
+        priority: rawData.priority,
+        ...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);
+}
+
+export {
+  loadCredentials,
+  saveCredentials,
+  clearCredentials,
+  runDeviceAuth,
+  promptForApiKey,
+  getCredentials,
+  ContextFetcher,
+  buildPromptWithContext,
+  createContextFetcher,
+  ClaudeExecutor,
+  createExecutor,
+  ArtyfactsListener,
+  createListener
+};

package/dist/cli.js

@@ -251,16 +251,34 @@ function buildPromptWithContext(context) {
 
 Your job is to complete the assigned task. You have full context about the organization, project, and related work.
 
-Guidelines:
+## 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 with the tools.
+
+## Guidelines
+
 - Be thorough but concise
-- If the task requires code, provide working code
-- If the task requires analysis, provide structured findings
-- If the task requires a decision, explain your reasoning
+- USE THE TOOLS to take action, don't just analyze
+- If the task requires creating something, use create_artifact or create_section
+- If the task requires creating agents, use create_agent
 - If you cannot complete the task, explain why
 
 Format your response as follows:
-1. First, provide your main output (the task deliverable)
-2. End with a brief summary line starting with "SUMMARY:"`);
+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("");
@@ -367,21 +385,35 @@ function createContextFetcher(config) {
 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. For each task:
-1. Understand the requirements from the task heading and content
-2. Complete the task to the best of your ability
-3. Provide a clear, actionable output
+Your job is to complete tasks assigned to you using the available tools.
 
-Guidelines:
-- Be thorough but concise
-- If the task requires code, provide working code
-- If the task requires analysis, provide structured findings
-- If the task requires a decision, explain your reasoning
+## 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, provide your main output (the task deliverable)
-2. End with a brief summary line starting with "SUMMARY:"`;
+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;
@@ -897,7 +929,7 @@ async function checkAndClaimTasks(baseUrl, apiKey, agentId, activeTasks, executo
     }
     console.log(`\u{1F4EC} Found ${tasks.length} claimable task(s)`);
     for (const task of tasks) {
-      if (activeTasks.has(task.section_id)) {
+      if (activeTasks.has(task.id)) {
         continue;
       }
       console.log(`
@@ -920,11 +952,11 @@ async function checkAndClaimTasks(baseUrl, apiKey, agentId, activeTasks, executo
       });
       const taskUuid = claimData.task?.id || task.id;
       console.log(`  \u{1F4CE} Using task UUID: ${taskUuid} (from queue: ${task.id})`);
-      activeTasks.add(task.section_id);
+      activeTasks.add(task.id);
       console.log("  \u2713 Claimed!");
       if (dryRun) {
         console.log("  \u{1F4CB} Dry run - not executing");
-        activeTasks.delete(task.section_id);
+        activeTasks.delete(task.id);
         continue;
       }
       console.log("  \u2192 Executing with Claude...");
@@ -961,7 +993,7 @@ async function checkAndClaimTasks(baseUrl, apiKey, agentId, activeTasks, executo
       } catch (error) {
         console.error(`  \u2192 \u274C Error:`, error instanceof Error ? error.message : error);
       } finally {
-        activeTasks.delete(task.section_id);
+        activeTasks.delete(task.id);
       }
       break;
     }

package/dist/cli.mjs

@@ -6,7 +6,7 @@ import {
   getCredentials,
   loadCredentials,
   promptForApiKey
-} from "./chunk-7ULDABOE.mjs";
+} from "./chunk-CNJCMX2D.mjs";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -138,7 +138,7 @@ async function checkAndClaimTasks(baseUrl, apiKey, agentId, activeTasks, executo
     }
     console.log(`\u{1F4EC} Found ${tasks.length} claimable task(s)`);
     for (const task of tasks) {
-      if (activeTasks.has(task.section_id)) {
+      if (activeTasks.has(task.id)) {
         continue;
       }
       console.log(`
@@ -161,11 +161,11 @@ async function checkAndClaimTasks(baseUrl, apiKey, agentId, activeTasks, executo
       });
       const taskUuid = claimData.task?.id || task.id;
       console.log(`  \u{1F4CE} Using task UUID: ${taskUuid} (from queue: ${task.id})`);
-      activeTasks.add(task.section_id);
+      activeTasks.add(task.id);
       console.log("  \u2713 Claimed!");
       if (dryRun) {
         console.log("  \u{1F4CB} Dry run - not executing");
-        activeTasks.delete(task.section_id);
+        activeTasks.delete(task.id);
         continue;
       }
       console.log("  \u2192 Executing with Claude...");
@@ -202,7 +202,7 @@ async function checkAndClaimTasks(baseUrl, apiKey, agentId, activeTasks, executo
       } catch (error) {
         console.error(`  \u2192 \u274C Error:`, error instanceof Error ? error.message : error);
       } finally {
-        activeTasks.delete(task.section_id);
+        activeTasks.delete(task.id);
       }
       break;
     }

package/dist/index.js

@@ -281,16 +281,34 @@ function buildPromptWithContext(context) {
 
 Your job is to complete the assigned task. You have full context about the organization, project, and related work.
 
-Guidelines:
+## 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 with the tools.
+
+## Guidelines
+
 - Be thorough but concise
-- If the task requires code, provide working code
-- If the task requires analysis, provide structured findings
-- If the task requires a decision, explain your reasoning
+- USE THE TOOLS to take action, don't just analyze
+- If the task requires creating something, use create_artifact or create_section
+- If the task requires creating agents, use create_agent
 - If you cannot complete the task, explain why
 
 Format your response as follows:
-1. First, provide your main output (the task deliverable)
-2. End with a brief summary line starting with "SUMMARY:"`);
+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("");
@@ -397,21 +415,35 @@ function createContextFetcher(config) {
 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. For each task:
-1. Understand the requirements from the task heading and content
-2. Complete the task to the best of your ability
-3. Provide a clear, actionable output
+Your job is to complete tasks assigned to you using the available tools.
 
-Guidelines:
-- Be thorough but concise
-- If the task requires code, provide working code
-- If the task requires analysis, provide structured findings
-- If the task requires a decision, explain your reasoning
+## 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, provide your main output (the task deliverable)
-2. End with a brief summary line starting with "SUMMARY:"`;
+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;

package/dist/index.mjs

@@ -12,7 +12,7 @@ import {
   promptForApiKey,
   runDeviceAuth,
   saveCredentials
-} from "./chunk-7ULDABOE.mjs";
+} from "./chunk-CNJCMX2D.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.4",
+  "version": "1.3.6",
   "description": "Claude adapter for Artyfacts - Execute tasks using Claude Code CLI",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/cli.ts

@@ -245,7 +245,8 @@ async function checkAndClaimTasks(
 
     // Process first available task
     for (const task of tasks) {
-      if (activeTasks.has(task.section_id)) {
+      // Use task.id (UUID) for deduplication - matches SSE taskId
+      if (activeTasks.has(task.id)) {
         continue; // Already processing
       }
 
@@ -281,12 +282,12 @@ async function checkAndClaimTasks(
       console.log(`  📎 Using task UUID: ${taskUuid} (from queue: ${task.id})`);  // DEBUG
 
       // Successfully claimed - now execute
-      activeTasks.add(task.section_id);
+      activeTasks.add(task.id);
       console.log('  ✓ Claimed!');
 
       if (dryRun) {
         console.log('  📋 Dry run - not executing');
-        activeTasks.delete(task.section_id);
+        activeTasks.delete(task.id);
         continue;
       }
 
@@ -324,7 +325,7 @@ async function checkAndClaimTasks(
       } catch (error) {
         console.error(`  → ❌ Error:`, error instanceof Error ? error.message : error);
       } finally {
-        activeTasks.delete(task.section_id);
+        activeTasks.delete(task.id);
       }
 
       // Only process one task at a time for now

package/src/context.ts

@@ -108,16 +108,34 @@ export function buildPromptWithContext(context: TaskFullContext): string {
 
 Your job is to complete the assigned task. You have full context about the organization, project, and related work.
 
-Guidelines:
+## 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 with the tools.
+
+## Guidelines
+
 - Be thorough but concise
-- If the task requires code, provide working code
-- If the task requires analysis, provide structured findings
-- If the task requires a decision, explain your reasoning
+- USE THE TOOLS to take action, don't just analyze
+- If the task requires creating something, use create_artifact or create_section
+- If the task requires creating agents, use create_agent
 - If you cannot complete the task, explain why
 
 Format your response as follows:
-1. First, provide your main output (the task deliverable)
-2. End with a brief summary line starting with "SUMMARY:"`);
+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('---');

package/src/executor.ts

@@ -68,21 +68,35 @@ const DEFAULT_TIMEOUT = 5 * 60 * 1000; // 5 minutes
 
 const DEFAULT_SYSTEM_PROMPT = `You are an AI agent working within the Artyfacts task management system.
 
-Your job is to complete tasks assigned to you. For each task:
-1. Understand the requirements from the task heading and content
-2. Complete the task to the best of your ability
-3. Provide a clear, actionable output
-
-Guidelines:
-- Be thorough but concise
-- If the task requires code, provide working code
-- If the task requires analysis, provide structured findings
-- If the task requires a decision, explain your reasoning
+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, provide your main output (the task deliverable)
-2. End with a brief summary line starting with "SUMMARY:"`;
+1. First, use the tools to complete the task
+2. Summarize what you accomplished
+3. End with a brief summary line starting with "SUMMARY:"`;
 
 // ============================================================================
 // Executor Class