@artyfacts/claude 1.0.0 → 1.1.0

package/README.md

@@ -1,134 +1,215 @@
 # @artyfacts/claude
 
-Run AI agents locally using Claude Code, orchestrated by Artyfacts.
+Claude adapter for Artyfacts - Execute tasks using the Anthropic Claude API.
 
-## Quick Start
+## Installation
 
 ```bash
+npm install @artyfacts/claude
+# or
 npx @artyfacts/claude
 ```
 
-That's it. The CLI will:
-1. Open your browser to log in (first time only)
-2. Check Claude Code is installed
-3. Start polling for tasks from artyfacts.dev
-4. Execute tasks locally with Claude Code
-
-## Prerequisites
-
-**Claude Code** must be installed:
+## Quick Start
 
 ```bash
-npm install -g @anthropic-ai/claude-code
-claude login
+# 1. Set your Anthropic API key
+export ANTHROPIC_API_KEY=sk-ant-...
+
+# 2. Start listening for tasks
+npx @artyfacts/claude
 ```
 
-## How It Works
+## CLI Commands
 
-```
-artyfacts.dev                Your Machine
-─────────────                ────────────
-Create goal          
-Create tasks    ──────────>  npx @artyfacts/claude
-                             │
-                             ├─ Polls for tasks
-                             ├─ Claims task
-                             ├─ Runs: claude -p "task..."
-                             ├─ Reports completion
-                             │
-Task complete!  <──────────  Next task...
-```
+### Run (default)
 
-## Commands
+Start listening for and executing tasks:
 
 ```bash
-# Start the adapter (default)
 npx @artyfacts/claude
+npx @artyfacts/claude run
 
-# Check status
-npx @artyfacts/claude status
+# Options
+npx @artyfacts/claude run --model claude-sonnet-4-20250514  # Use different model
+npx @artyfacts/claude run --dry-run                   # Print tasks without executing
+```
 
-# Log in manually
-npx @artyfacts/claude login
+### Login
 
-# Log out
-npx @artyfacts/claude logout
+Authenticate with Artyfacts:
 
-# Show current user
-npx @artyfacts/claude whoami
+```bash
+npx @artyfacts/claude login          # Device auth flow
+npx @artyfacts/claude login --manual # Enter credentials manually
 ```
 
-## Options
+### Status
 
-```bash
-npx @artyfacts/claude [options]
+Check authentication and connection status:
 
-  -i, --interval <sec>    Poll interval in seconds (default: 30)
-  -c, --concurrent <n>    Max concurrent tasks (default: 1)
-  -m, --model <model>     Claude model: sonnet, opus (default: sonnet)
-  -d, --cwd <dir>         Working directory
+```bash
+npx @artyfacts/claude status
 ```
 
-## Example Session
+### Logout
+
+Clear stored credentials:
 
+```bash
+npx @artyfacts/claude logout
 ```
+
+## User Experience
+
+```bash
 $ npx @artyfacts/claude
+🔗 Connecting to Artyfacts...
+✅ Claude API connected (model: claude-sonnet-4-20250514)
+✅ Connected as engineering-agent
+👂 Listening for tasks...
+
+[Task received] Break down initiative into subtasks
+  → Executing with Claude...
+  → ✅ Completed! Created 4 subtasks.
+     (1234 in / 567 out tokens)
+
+^C
+👋 Disconnecting...
+```
 
-🚀 Artyfacts + Claude Code
+## Programmatic Usage
 
-🔗 Opening browser to log in...
+```typescript
+import { 
+  ClaudeExecutor, 
+  ArtyfactsListener, 
+  getCredentials 
+} from '@artyfacts/claude';
+
+// Get credentials (runs device auth if needed)
+const credentials = await getCredentials();
+
+// Create executor
+const executor = new ClaudeExecutor({
+  apiKey: process.env.ANTHROPIC_API_KEY!,
+  model: 'claude-sonnet-4-20250514',
+});
 
-  https://artyfacts.dev/auth/device?code=ABCD-1234
+// Create listener
+const listener = new ArtyfactsListener({
+  apiKey: credentials.apiKey,
+  agentId: credentials.agentId,
+});
 
-  Your code: ABCD-1234
+// Handle task assignments
+listener.on('task_assigned', async (event) => {
+  const result = await executor.execute({
+    taskId: event.data.taskId,
+    heading: event.data.heading,
+    content: event.data.content,
+    artifactId: event.data.artifactId,
+  });
+  
+  if (result.success) {
+    console.log('Task completed:', result.summary);
+  } else {
+    console.error('Task failed:', result.error);
+  }
+});
 
-  Waiting for authorization...
+// Start listening
+listener.connect();
 
-✓ Logged in as gracie@example.com
+// Cleanup
+process.on('SIGINT', () => {
+  listener.disconnect();
+  process.exit(0);
+});
+```
 
-Checking Claude Code...
-✓ Claude Code 2.1.22
+## Configuration
 
-✓ Started
-  Polling every 30s
-  Model: sonnet
+### Credentials
 
-Waiting for tasks from artyfacts.dev...
-Create goals and tasks at https://artyfacts.dev
+Credentials are stored in `~/.artyfacts/credentials.json`:
 
-▶ Research competitor pricing
-  From: Q2 Growth Strategy
-  Running with Claude...
-✓ Completed
-  Duration: 45.2s
+```json
+{
+  "apiKey": "af_xxx",
+  "agentId": "engineering-agent",
+  "agentName": "Engineering Agent"
+}
 ```
 
-## Programmatic Usage
+### Environment Variables
 
-```typescript
-import { ClaudeAdapter, DeviceAuth } from '@artyfacts/claude';
+- `ANTHROPIC_API_KEY` - Your Anthropic API key (required)
+- `ARTYFACTS_API_KEY` - Alternative to device auth
+- `ARTYFACTS_AGENT_ID` - Agent ID when using API key directly
 
-const auth = new DeviceAuth();
+## API Reference
 
-// Ensure logged in
-if (!auth.hasCredentials()) {
-  await auth.login();
-}
+### ClaudeExecutor
 
-const adapter = new ClaudeAdapter({
-  apiKey: auth.getAccessToken()!,
+Execute tasks using Claude API:
+
+```typescript
+const executor = new ClaudeExecutor({
+  apiKey: string;            // Anthropic API key
+  model?: string;            // Model (default: claude-sonnet-4-20250514)
+  maxTokens?: number;        // Max response tokens (default: 4096)
+  systemPromptPrefix?: string; // Prepend to system prompt
 });
 
-adapter.on('task:completed', (task) => {
-  console.log(`Done: ${task.heading}`);
+const result = await executor.execute({
+  taskId: string;
+  heading: string;
+  content: string;
+  artifactId: string;
+  artifactTitle?: string;
+  priority?: number;
+  context?: Record<string, unknown>;
 });
+// Returns: { success, output, summary, error?, usage? }
+```
 
-await adapter.start();
+### ArtyfactsListener
+
+Listen for SSE events from Artyfacts:
+
+```typescript
+const listener = new ArtyfactsListener({
+  apiKey: string;
+  agentId: string;
+  baseUrl?: string;         // API base URL
+  onStateChange?: (state) => void;
+  onError?: (error) => void;
+});
+
+// Subscribe to events
+listener.on('task_assigned', (event) => { ... });
+listener.on('blocker_resolved', (event) => { ... });
+listener.subscribe((event) => { ... }); // All events
+
+// Connection management
+listener.connect();
+listener.disconnect();
+listener.reconnect();
 ```
 
-## Credentials
+### Authentication
 
-Stored in `~/.artyfacts/credentials.json` with 600 permissions (user read/write only).
+```typescript
+import { 
+  getCredentials,    // Get or run device auth
+  loadCredentials,   // Load from disk
+  saveCredentials,   // Save to disk
+  clearCredentials,  // Delete from disk
+  runDeviceAuth,     // Manual device auth
+  promptForApiKey,   // Manual input
+} from '@artyfacts/claude';
+```
 
 ## License
 

package/bin/artyfacts-claude.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+
+/**
+ * CLI entry point for @artyfacts/claude
+ * 
+ * This file bootstraps the TypeScript CLI.
+ * After build, it loads the compiled version from dist/.
+ */
+
+const path = require('path');
+const fs = require('fs');
+
+// Check if we're running from source or dist
+const distCli = path.join(__dirname, '..', 'dist', 'cli.js');
+const srcCli = path.join(__dirname, '..', 'src', 'cli.ts');
+
+if (fs.existsSync(distCli)) {
+  // Run compiled version
+  require(distCli);
+} else if (fs.existsSync(srcCli)) {
+  // Development: run with ts-node or tsx
+  try {
+    require('tsx/cjs');
+    require(srcCli);
+  } catch {
+    try {
+      require('ts-node/register');
+      require(srcCli);
+    } catch {
+      console.error('Error: Package not built. Run `npm run build` first.');
+      console.error('Or install tsx/ts-node for development: npm install -D tsx');
+      process.exit(1);
+    }
+  }
+} else {
+  console.error('Error: CLI source not found. Package may be corrupted.');
+  process.exit(1);
+}