@artyfacts/claude 1.0.0

package/dist/index.d.mts

@@ -0,0 +1,312 @@
+import { EventEmitter } from 'events';
+import { ChildProcess } from 'child_process';
+
+/**
+ * Artyfacts API Client (Simplified)
+ *
+ * Handles communication with the Artyfacts API for task management.
+ */
+interface ArtyfactsConfig {
+    apiKey: string;
+    baseUrl?: string;
+    agentId?: string;
+}
+interface Task {
+    id: string;
+    sectionId: string;
+    heading: string;
+    content: string;
+    artifactId: string;
+    artifactTitle: string;
+    artifactUrl: string;
+    priority: 1 | 2 | 3;
+    dependsOn: string[];
+    createdAt: string;
+}
+interface ClaimResult {
+    success: boolean;
+    task: Task & {
+        claimedAt: string;
+        claimedBy: string;
+    };
+}
+interface CompleteResult {
+    success: boolean;
+    unblockedTasks: string[];
+}
+declare class ArtyfactsClient {
+    private config;
+    constructor(config: ArtyfactsConfig);
+    private fetch;
+    /**
+     * Get claimable tasks from the queue
+     */
+    getTaskQueue(options?: {
+        limit?: number;
+    }): Promise<Task[]>;
+    /**
+     * Claim a task
+     */
+    claimTask(taskId: string): Promise<ClaimResult>;
+    /**
+     * Complete a task
+     */
+    completeTask(taskId: string, options?: {
+        outputUrl?: string;
+        summary?: string;
+    }): Promise<CompleteResult>;
+    /**
+     * Report task as blocked
+     */
+    blockTask(taskId: string, reason: string): Promise<void>;
+    /**
+     * Get current user/org info
+     */
+    getMe(): Promise<{
+        id: string;
+        name: string;
+        orgId: string;
+    }>;
+}
+
+/**
+ * Claude Code Runner
+ *
+ * Spawns and manages Claude Code CLI processes for task execution.
+ */
+
+interface ClaudeRunnerConfig {
+    /** Path to claude CLI (default: 'claude') */
+    claudePath?: string;
+    /** Model to use (default: 'sonnet') */
+    model?: string;
+    /** Working directory for Claude */
+    cwd?: string;
+    /** Timeout in ms (default: 5 minutes) */
+    timeoutMs?: number;
+}
+interface TaskResult {
+    success: boolean;
+    output: string;
+    error?: string;
+    exitCode: number | null;
+    durationMs: number;
+}
+interface RunningTask {
+    taskId: string;
+    process: ChildProcess;
+    startedAt: Date;
+    promise: Promise<TaskResult>;
+}
+declare class ClaudeRunner extends EventEmitter {
+    private config;
+    private runningTasks;
+    constructor(config?: ClaudeRunnerConfig);
+    /**
+     * Check if Claude Code is installed and authenticated
+     */
+    checkInstalled(): Promise<{
+        installed: boolean;
+        authenticated: boolean;
+        version?: string;
+        error?: string;
+    }>;
+    /**
+     * Run a task with Claude Code
+     */
+    runTask(taskId: string, prompt: string, options?: {
+        cwd?: string;
+        model?: string;
+        timeoutMs?: number;
+    }): Promise<TaskResult>;
+    /**
+     * Run a raw claude command
+     */
+    private runCommand;
+    /**
+     * Cancel a running task
+     */
+    cancelTask(taskId: string): boolean;
+    /**
+     * Get count of running tasks
+     */
+    getRunningCount(): number;
+    /**
+     * Cancel all running tasks
+     */
+    cancelAll(): void;
+}
+
+/**
+ * Claude Adapter
+ *
+ * Main orchestration class that:
+ * 1. Polls Artyfacts for claimable tasks
+ * 2. Spawns Claude Code to execute them
+ * 3. Reports results back to Artyfacts
+ */
+
+interface AdapterConfig {
+    /** Artyfacts API key */
+    apiKey: string;
+    /** Artyfacts base URL */
+    baseUrl?: string;
+    /** Agent ID for attribution */
+    agentId?: string;
+    /** Poll interval in ms (default: 30s) */
+    pollIntervalMs?: number;
+    /** Max concurrent tasks (default: 1) */
+    maxConcurrent?: number;
+    /** Claude model to use (default: 'sonnet') */
+    model?: string;
+    /** Working directory for Claude */
+    cwd?: string;
+}
+interface AdapterEvents {
+    'started': () => void;
+    'stopped': () => void;
+    'poll': (tasks: Task[]) => void;
+    'task:claimed': (task: Task) => void;
+    'task:running': (task: Task) => void;
+    'task:completed': (task: Task, result: TaskResult) => void;
+    'task:failed': (task: Task, error: string) => void;
+    'error': (error: Error) => void;
+}
+declare class ClaudeAdapter extends EventEmitter {
+    private config;
+    private client;
+    private runner;
+    private running;
+    private pollTimer;
+    private activeTasks;
+    constructor(config: AdapterConfig);
+    /**
+     * Check if Claude Code is ready
+     */
+    checkReady(): Promise<{
+        ready: boolean;
+        error?: string;
+    }>;
+    /**
+     * Start the adapter
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the adapter
+     */
+    stop(): Promise<void>;
+    /**
+     * Poll for and execute tasks
+     */
+    private poll;
+    /**
+     * Execute a single task
+     */
+    private executeTask;
+    /**
+     * Build a prompt for Claude from the task
+     */
+    private buildPrompt;
+    /**
+     * Extract a summary from Claude's output
+     */
+    private extractSummary;
+    /**
+     * Check if running
+     */
+    isRunning(): boolean;
+    /**
+     * Get stats
+     */
+    getStats(): {
+        running: boolean;
+        activeTasks: number;
+        maxConcurrent: number;
+    };
+}
+
+/**
+ * Device Authorization Flow
+ *
+ * Handles browser-based authentication for the CLI.
+ * No API keys to copy — just run the CLI and click authorize.
+ */
+interface DeviceCodeResponse {
+    deviceCode: string;
+    userCode: string;
+    verificationUri: string;
+    expiresIn: number;
+    interval: number;
+}
+interface TokenResponse {
+    accessToken: string;
+    refreshToken?: string;
+    expiresAt?: number;
+    user: {
+        id: string;
+        email: string;
+        name?: string;
+        orgId: string;
+    };
+}
+interface StoredCredentials {
+    accessToken: string;
+    refreshToken?: string;
+    expiresAt?: number;
+    user: {
+        id: string;
+        email: string;
+        name?: string;
+        orgId: string;
+    };
+    savedAt: string;
+}
+declare class DeviceAuth {
+    private baseUrl;
+    private credentialsPath;
+    constructor(options?: {
+        baseUrl?: string;
+    });
+    /**
+     * Check if we have stored credentials
+     */
+    hasCredentials(): boolean;
+    /**
+     * Get stored credentials
+     */
+    getCredentials(): StoredCredentials | null;
+    /**
+     * Get access token (for API calls)
+     */
+    getAccessToken(): string | null;
+    /**
+     * Clear stored credentials (logout)
+     */
+    logout(): void;
+    /**
+     * Start device authorization flow
+     */
+    startDeviceFlow(): Promise<DeviceCodeResponse>;
+    /**
+     * Poll for token after user authorizes
+     */
+    pollForToken(deviceCode: string, interval: number, expiresIn: number): Promise<TokenResponse>;
+    /**
+     * Save credentials to disk
+     */
+    saveCredentials(token: TokenResponse): void;
+    /**
+     * Open URL in browser
+     */
+    openBrowser(url: string): void;
+    /**
+     * Full login flow
+     */
+    login(options?: {
+        onDeviceCode?: (response: DeviceCodeResponse) => void;
+        onWaiting?: () => void;
+    }): Promise<TokenResponse>;
+    private sleep;
+}
+
+export { type AdapterConfig, type AdapterEvents, ArtyfactsClient, type ArtyfactsConfig, type ClaimResult, ClaudeAdapter, ClaudeRunner, type ClaudeRunnerConfig, type CompleteResult, DeviceAuth, type DeviceCodeResponse, type RunningTask, type StoredCredentials, type Task, type TaskResult, type TokenResponse };

package/dist/index.d.ts

@@ -0,0 +1,312 @@
+import { EventEmitter } from 'events';
+import { ChildProcess } from 'child_process';
+
+/**
+ * Artyfacts API Client (Simplified)
+ *
+ * Handles communication with the Artyfacts API for task management.
+ */
+interface ArtyfactsConfig {
+    apiKey: string;
+    baseUrl?: string;
+    agentId?: string;
+}
+interface Task {
+    id: string;
+    sectionId: string;
+    heading: string;
+    content: string;
+    artifactId: string;
+    artifactTitle: string;
+    artifactUrl: string;
+    priority: 1 | 2 | 3;
+    dependsOn: string[];
+    createdAt: string;
+}
+interface ClaimResult {
+    success: boolean;
+    task: Task & {
+        claimedAt: string;
+        claimedBy: string;
+    };
+}
+interface CompleteResult {
+    success: boolean;
+    unblockedTasks: string[];
+}
+declare class ArtyfactsClient {
+    private config;
+    constructor(config: ArtyfactsConfig);
+    private fetch;
+    /**
+     * Get claimable tasks from the queue
+     */
+    getTaskQueue(options?: {
+        limit?: number;
+    }): Promise<Task[]>;
+    /**
+     * Claim a task
+     */
+    claimTask(taskId: string): Promise<ClaimResult>;
+    /**
+     * Complete a task
+     */
+    completeTask(taskId: string, options?: {
+        outputUrl?: string;
+        summary?: string;
+    }): Promise<CompleteResult>;
+    /**
+     * Report task as blocked
+     */
+    blockTask(taskId: string, reason: string): Promise<void>;
+    /**
+     * Get current user/org info
+     */
+    getMe(): Promise<{
+        id: string;
+        name: string;
+        orgId: string;
+    }>;
+}
+
+/**
+ * Claude Code Runner
+ *
+ * Spawns and manages Claude Code CLI processes for task execution.
+ */
+
+interface ClaudeRunnerConfig {
+    /** Path to claude CLI (default: 'claude') */
+    claudePath?: string;
+    /** Model to use (default: 'sonnet') */
+    model?: string;
+    /** Working directory for Claude */
+    cwd?: string;
+    /** Timeout in ms (default: 5 minutes) */
+    timeoutMs?: number;
+}
+interface TaskResult {
+    success: boolean;
+    output: string;
+    error?: string;
+    exitCode: number | null;
+    durationMs: number;
+}
+interface RunningTask {
+    taskId: string;
+    process: ChildProcess;
+    startedAt: Date;
+    promise: Promise<TaskResult>;
+}
+declare class ClaudeRunner extends EventEmitter {
+    private config;
+    private runningTasks;
+    constructor(config?: ClaudeRunnerConfig);
+    /**
+     * Check if Claude Code is installed and authenticated
+     */
+    checkInstalled(): Promise<{
+        installed: boolean;
+        authenticated: boolean;
+        version?: string;
+        error?: string;
+    }>;
+    /**
+     * Run a task with Claude Code
+     */
+    runTask(taskId: string, prompt: string, options?: {
+        cwd?: string;
+        model?: string;
+        timeoutMs?: number;
+    }): Promise<TaskResult>;
+    /**
+     * Run a raw claude command
+     */
+    private runCommand;
+    /**
+     * Cancel a running task
+     */
+    cancelTask(taskId: string): boolean;
+    /**
+     * Get count of running tasks
+     */
+    getRunningCount(): number;
+    /**
+     * Cancel all running tasks
+     */
+    cancelAll(): void;
+}
+
+/**
+ * Claude Adapter
+ *
+ * Main orchestration class that:
+ * 1. Polls Artyfacts for claimable tasks
+ * 2. Spawns Claude Code to execute them
+ * 3. Reports results back to Artyfacts
+ */
+
+interface AdapterConfig {
+    /** Artyfacts API key */
+    apiKey: string;
+    /** Artyfacts base URL */
+    baseUrl?: string;
+    /** Agent ID for attribution */
+    agentId?: string;
+    /** Poll interval in ms (default: 30s) */
+    pollIntervalMs?: number;
+    /** Max concurrent tasks (default: 1) */
+    maxConcurrent?: number;
+    /** Claude model to use (default: 'sonnet') */
+    model?: string;
+    /** Working directory for Claude */
+    cwd?: string;
+}
+interface AdapterEvents {
+    'started': () => void;
+    'stopped': () => void;
+    'poll': (tasks: Task[]) => void;
+    'task:claimed': (task: Task) => void;
+    'task:running': (task: Task) => void;
+    'task:completed': (task: Task, result: TaskResult) => void;
+    'task:failed': (task: Task, error: string) => void;
+    'error': (error: Error) => void;
+}
+declare class ClaudeAdapter extends EventEmitter {
+    private config;
+    private client;
+    private runner;
+    private running;
+    private pollTimer;
+    private activeTasks;
+    constructor(config: AdapterConfig);
+    /**
+     * Check if Claude Code is ready
+     */
+    checkReady(): Promise<{
+        ready: boolean;
+        error?: string;
+    }>;
+    /**
+     * Start the adapter
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the adapter
+     */
+    stop(): Promise<void>;
+    /**
+     * Poll for and execute tasks
+     */
+    private poll;
+    /**
+     * Execute a single task
+     */
+    private executeTask;
+    /**
+     * Build a prompt for Claude from the task
+     */
+    private buildPrompt;
+    /**
+     * Extract a summary from Claude's output
+     */
+    private extractSummary;
+    /**
+     * Check if running
+     */
+    isRunning(): boolean;
+    /**
+     * Get stats
+     */
+    getStats(): {
+        running: boolean;
+        activeTasks: number;
+        maxConcurrent: number;
+    };
+}
+
+/**
+ * Device Authorization Flow
+ *
+ * Handles browser-based authentication for the CLI.
+ * No API keys to copy — just run the CLI and click authorize.
+ */
+interface DeviceCodeResponse {
+    deviceCode: string;
+    userCode: string;
+    verificationUri: string;
+    expiresIn: number;
+    interval: number;
+}
+interface TokenResponse {
+    accessToken: string;
+    refreshToken?: string;
+    expiresAt?: number;
+    user: {
+        id: string;
+        email: string;
+        name?: string;
+        orgId: string;
+    };
+}
+interface StoredCredentials {
+    accessToken: string;
+    refreshToken?: string;
+    expiresAt?: number;
+    user: {
+        id: string;
+        email: string;
+        name?: string;
+        orgId: string;
+    };
+    savedAt: string;
+}
+declare class DeviceAuth {
+    private baseUrl;
+    private credentialsPath;
+    constructor(options?: {
+        baseUrl?: string;
+    });
+    /**
+     * Check if we have stored credentials
+     */
+    hasCredentials(): boolean;
+    /**
+     * Get stored credentials
+     */
+    getCredentials(): StoredCredentials | null;
+    /**
+     * Get access token (for API calls)
+     */
+    getAccessToken(): string | null;
+    /**
+     * Clear stored credentials (logout)
+     */
+    logout(): void;
+    /**
+     * Start device authorization flow
+     */
+    startDeviceFlow(): Promise<DeviceCodeResponse>;
+    /**
+     * Poll for token after user authorizes
+     */
+    pollForToken(deviceCode: string, interval: number, expiresIn: number): Promise<TokenResponse>;
+    /**
+     * Save credentials to disk
+     */
+    saveCredentials(token: TokenResponse): void;
+    /**
+     * Open URL in browser
+     */
+    openBrowser(url: string): void;
+    /**
+     * Full login flow
+     */
+    login(options?: {
+        onDeviceCode?: (response: DeviceCodeResponse) => void;
+        onWaiting?: () => void;
+    }): Promise<TokenResponse>;
+    private sleep;
+}
+
+export { type AdapterConfig, type AdapterEvents, ArtyfactsClient, type ArtyfactsConfig, type ClaimResult, ClaudeAdapter, ClaudeRunner, type ClaudeRunnerConfig, type CompleteResult, DeviceAuth, type DeviceCodeResponse, type RunningTask, type StoredCredentials, type Task, type TaskResult, type TokenResponse };