@artyfacts/claude 1.1.2 → 1.2.1

package/dist/chunk-EROV5RIA.mjs

@@ -0,0 +1,741 @@
+// 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.
+
+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
+- 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:"`);
+  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. 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
+- 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:"`;
+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 artyfactsEvent = {
+        type: eventType || data.type || "unknown",
+        timestamp: data.timestamp || (/* @__PURE__ */ new Date()).toISOString(),
+        data: data.data || data
+      };
+      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
+};