@artyfacts/claude 1.3.13 → 1.3.14

package/dist/chunk-CSODKZR3.mjs

@@ -0,0 +1,1005 @@
+// 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 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
+   */
+  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",
+  "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.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);
+}
+
+// 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} already configured - treating as success`);
+      return { success: true, alreadyExists: true };
+    }
+    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] OAuth will prompt on first use (one-time login)`);
+      } 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

@@ -909,7 +909,7 @@ var McpHandler = class {
           throw new Error(`Failed to add ${platform} MCP: ${result.error}`);
         }
         console.log(`[MCP] Added ${serverName} \u2192 ${oauthServer.url}`);
-        console.log(`[MCP] OAuth will prompt when you use ${platform} tools`);
+        console.log(`[MCP] OAuth will prompt on first use (one-time login)`);
       } else {
         const configBuilder = CREDENTIAL_MCP_CONFIGS[platform];
         if (!configBuilder) {
@@ -1293,7 +1293,7 @@ async function runAgent(options) {
     onConfigured: (connectionId, platform) => {
       console.log(`
 \u{1F527} [MCP] Configured ${platform} connection: ${connectionId}`);
-      console.log("   \u{1F4A1} Try using the tools now - OAuth will prompt when needed");
+      console.log("   \u{1F4A1} Try using the tools now - OAuth prompts once on first use");
     },
     onError: (error, connectionId) => {
       console.error(`

package/dist/cli.mjs

@@ -7,7 +7,7 @@ import {
   getCredentials,
   loadCredentials,
   promptForApiKey
-} from "./chunk-4L6FPX5K.mjs";
+} from "./chunk-CSODKZR3.mjs";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -287,7 +287,7 @@ async function runAgent(options) {
     onConfigured: (connectionId, platform) => {
       console.log(`
 \u{1F527} [MCP] Configured ${platform} connection: ${connectionId}`);
-      console.log("   \u{1F4A1} Try using the tools now - OAuth will prompt when needed");
+      console.log("   \u{1F4A1} Try using the tools now - OAuth prompts once on first use");
     },
     onError: (error, connectionId) => {
       console.error(`

package/dist/index.js

@@ -6102,7 +6102,7 @@ var McpHandler = class {
           throw new Error(`Failed to add ${platform} MCP: ${result.error}`);
         }
         console.log(`[MCP] Added ${serverName} \u2192 ${oauthServer.url}`);
-        console.log(`[MCP] OAuth will prompt when you use ${platform} tools`);
+        console.log(`[MCP] OAuth will prompt on first use (one-time login)`);
       } else {
         const configBuilder = CREDENTIAL_MCP_CONFIGS[platform];
         if (!configBuilder) {

package/dist/index.mjs

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

package/src/cli.ts

@@ -438,7 +438,7 @@ async function runAgent(options: {
     baseUrl: options.baseUrl,
     onConfigured: (connectionId, platform) => {
       console.log(`\n🔧 [MCP] Configured ${platform} connection: ${connectionId}`);
-      console.log('   💡 Try using the tools now - OAuth will prompt when needed');
+      console.log('   💡 Try using the tools now - OAuth prompts once on first use');
     },
     onError: (error, connectionId) => {
       console.error(`\n❌ [MCP] Failed to configure connection ${connectionId}:`, error.message);

package/src/mcp.ts

@@ -186,7 +186,7 @@ export class McpHandler {
         }
         
         console.log(`[MCP] Added ${serverName} → ${oauthServer.url}`);
-        console.log(`[MCP] OAuth will prompt when you use ${platform} tools`);
+        console.log(`[MCP] OAuth will prompt on first use (one-time login)`);
       } else {
         // Command-based MCP server - needs credentials
         const configBuilder = CREDENTIAL_MCP_CONFIGS[platform];