@posthog/agent 1.0.0

package/CLAUDE.md

@@ -0,0 +1,296 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Overview
+
+This is a TypeScript-based agent framework that wraps the Anthropic Claude Agent SDK, providing plan-and-execute capabilities for PostHog's Array desktop app and future backend services. It uses a Git-based workflow with file system storage for task artifacts. The project uses Bun runtime for execution.
+
+## Essential Commands
+
+```bash
+# Install dependencies
+bun install
+
+# Run example usage (demonstrates all features)
+bun run example-usage.ts
+```
+
+Note: No test, lint, or build scripts are currently defined in package.json.
+
+## Architecture
+
+### Core Components
+
+1. **Agent Class** (`src/agent.ts`):
+   - Main interface to Claude API using `@anthropic-ai/claude-agent-sdk`
+   - Supports three execution modes: PLAN_AND_BUILD, PLAN_ONLY, BUILD_ONLY
+   - Git-based workflow with branch creation and commits
+   - Event streaming with Array-compatible event format
+   - Default model: claude-4-5-sonnet
+
+2. **PostHog API Client** (`src/posthog-api.ts`):
+   - Fetches existing tasks from PostHog Django backend
+   - Authenticates using API keys and team resolution
+   - Does not create tasks - only reads existing ones
+
+3. **File Manager** (`src/file-manager.ts`):
+   - Manages .posthog/{taskId}/ folder structure
+   - Stores plans, context files, and supporting documents
+   - Handles gitignore configuration for PostHog folders
+
+4. **Git Manager** (`src/git-manager.ts`):
+   - Creates task-specific branches for planning and implementation
+   - Commits plans and implementations with descriptive messages
+   - Branch naming: posthog/task-{id}-planning, posthog/task-{id}-implementation
+
+5. **Template Manager** (`src/template-manager.ts`):
+   - Generates standardized plan and context files from templates
+   - Supports variable substitution in markdown templates
+   - Creates consistent .posthog/ folder structures
+
+6. **Task Manager** (`src/task-manager.ts`):
+   - Tracks execution state (running, completed, failed, canceled)
+   - Manages timeouts and cancellation
+   - Does not store task data - only execution state
+
+3. **Event System** (`src/event-transformer.ts`):
+   - Maps Claude SDK events to Array's expected format
+   - Supports: token, status, tool_call, tool_result, diff, file_write, metric, artifact, error, done
+
+4. **System Prompts** (`src/agents/` directory):
+   - `planning.ts`: System prompt for planning mode (read-only analysis)
+   - `execution.ts`: System prompt for execution mode (implementation)
+   - `ENGINEER.md`: Legacy prompt template (kept for reference)
+
+5. **Entry Point** (`index.ts`):
+   - Re-exports all public APIs from src
+   - Clean import interface for consumers
+
+### Key Patterns
+
+- **Git-Based Workflow**: Plans and implementations are committed to separate branches
+- **Plan-and-Execute Workflow**: Planning phase generates plans stored in .posthog/ folders
+- **File System Storage**: Task artifacts stored in .posthog/{taskId}/ directories
+- **PostHog Integration**: Fetches existing tasks from PostHog API, doesn't create new ones
+- **Event Streaming**: Real-time event streaming compatible with Array app
+- **Permission Modes**: Support for plan, default, acceptEdits, bypassPermissions
+
+### Project Structure
+
+```
+/
+├── example-usage.ts            # Comprehensive usage examples
+├── tsconfig.json               # TypeScript configuration
+└── src/                        # Source code
+    ├── agent.ts                # Main Agent class
+    ├── types.ts                # TypeScript interfaces and enums
+    ├── posthog-api.ts          # PostHog API client
+    ├── file-manager.ts         # .posthog/ folder management
+    ├── git-manager.ts          # Git operations and branch management
+    ├── template-manager.ts     # Plan and context templates
+    ├── task-manager.ts         # Execution state tracking
+    ├── event-transformer.ts    # Event mapping logic
+    ├── agents/                 # System prompts
+    │   ├── planning.ts         # Planning mode system prompt
+    │   └── execution.ts        # Execution mode system prompt
+    └── templates/              # Template files
+        ├── plan-template.md    # Plan generation template
+        └── context-template.md # Context file template
+```
+
+## Usage Patterns
+
+### Basic Task Execution with PostHog
+```typescript
+const agent = new Agent({ 
+    workingDirectory: "/path/to/repo",
+    posthogApiUrl: "https://app.posthog.com",
+    posthogApiKey: process.env.POSTHOG_API_KEY
+});
+
+// Fetch existing PostHog task
+const task = await agent.fetchTask("task_abc123");
+const result = await agent.runTask(task, ExecutionMode.PLAN_AND_BUILD);
+```
+
+### Array App Integration
+```typescript
+// Fetch task from PostHog and run with selected mode
+const result = await agent.runTask(taskId, userSelectedMode, {
+    repositoryPath: selectedRepoPath,
+    permissionMode: PermissionMode.DEFAULT,
+    onEvent: (event) => updateUI(event)
+});
+
+// Plan is stored in .posthog/{taskId}/plan.md and committed to Git
+```
+
+### Working with Task Files
+```typescript
+// Add context files to task folder
+await agent.writeTaskFile(taskId, "requirements.md", 
+    "Must be backwards compatible...", "context");
+
+// Read plan after planning phase
+const plan = await agent.readPlan(taskId);
+
+// All files are in .posthog/{taskId}/ and version controlled
+```
+
+### Git Workflow
+```typescript
+// Plan-only mode creates planning branch and commits plan
+const planResult = await agent.runTask(taskId, ExecutionMode.PLAN_ONLY);
+// Creates branch: posthog/task-{id}-planning
+// Commits: .posthog/{taskId}/plan.md
+
+// Build-only mode creates implementation branch
+const buildResult = await agent.runTask(taskId, ExecutionMode.BUILD_ONLY);
+// Creates branch: posthog/task-{id}-implementation  
+// Commits: all implementation changes
+```
+
+## Development Notes
+
+- Replaces the previous `@posthog/code-agent` package  
+- Designed for both Array app and future backend integration
+- Uses Claude SDK's native plan mode for proper planning workflow
+- Git-based artifact storage replaces database-backed supporting files
+- All task artifacts (.posthog/ folders) are version controlled alongside code
+- PostHog tasks are read-only - SDK doesn't create tasks, only executes existing ones
+- Event system compatible with existing Array app expectations
+
+## File System Layout
+
+When working with tasks, the agent creates this structure:
+
+```
+your-repo/
+├── .posthog/
+│   ├── README.md              # Auto-generated documentation
+│   ├── .gitignore             # Controls what gets committed
+│   └── {task-id}/             # Per-task folder
+│       ├── plan.md            # Generated implementation plan
+│       ├── context.md         # Additional context (optional)
+│       └── *.md               # Other supporting files
+└── (your regular code)
+```
+
+## Git Workflow
+
+Each task execution creates specific Git branches:
+
+1. **Planning Phase**: `posthog/task-{id}-planning`
+   - Contains .posthog/{id}/ folder with plan files
+   - Committed after plan generation
+   - Ready for review before implementation
+
+2. **Implementation Phase**: `posthog/task-{id}-implementation`  
+   - Contains actual code changes
+   - Includes updated .posthog/ files if needed
+   - Ready for PR creation and code review
+
+## Workflow Examples
+
+### Complete Task Execution Flow
+
+```typescript
+// 1. Initialize agent with PostHog credentials
+const agent = new Agent({
+    workingDirectory: "/path/to/repo",
+    posthogApiUrl: "https://app.posthog.com",
+    posthogApiKey: process.env.POSTHOG_API_KEY
+});
+
+// 2. Fetch existing task from PostHog
+const task = await agent.fetchTask("task_abc123");
+
+// 3. Add context files before execution (optional)
+await agent.writeTaskFile(task.id, "requirements.md", 
+    "- Maintain backwards compatibility\n- Add comprehensive tests", 
+    "context"
+);
+
+// 4. Execute with PLAN_AND_BUILD mode
+const result = await agent.runTask(task, ExecutionMode.PLAN_AND_BUILD, {
+    permissionMode: PermissionMode.DEFAULT,
+    onEvent: (event) => console.log(event)
+});
+
+// 5. Review results
+console.log("Planning branch:", `posthog/task-${task.id}-planning`);
+console.log("Implementation branch:", `posthog/task-${task.id}-implementation`);
+console.log("Plan location:", `.posthog/${task.id}/plan.md`);
+```
+
+### Array App Integration Pattern
+
+```typescript
+// How Array app uses the SDK
+class ArrayTaskExecution {
+    async executeTask(taskId: string, mode: ExecutionMode, repoPath: string) {
+        const result = await this.agent.runTask(taskId, mode, {
+            repositoryPath: repoPath,
+            permissionMode: PermissionMode.DEFAULT,
+            onEvent: (event) => this.updateUI(event)
+        });
+        
+        // Show branches created for user review
+        this.showBranchesForReview(taskId, mode);
+        return result;
+    }
+    
+    private updateUI(event: any) {
+        switch (event.type) {
+            case 'status':
+                this.updateProgressBar(event.data?.status);
+                break;
+            case 'file_write':
+                this.showFileChange(event.data);
+                break;
+            case 'done':
+                this.showCompletion();
+                break;
+        }
+    }
+}
+```
+
+### File System Operations
+
+```typescript
+// Working with task files
+await agent.writeTaskFile(taskId, "context.md", contextContent, "context");
+await agent.writeTaskFile(taskId, "requirements.md", requirements, "reference");
+
+// Reading files
+const plan = await agent.readPlan(taskId);
+const files = await agent.getTaskFiles(taskId);
+
+// Files are stored in .posthog/{taskId}/ and committed to Git
+```
+
+## Error Handling Patterns
+
+```typescript
+try {
+    const result = await agent.runTask(taskId, ExecutionMode.PLAN_AND_BUILD);
+} catch (error) {
+    if (error.message.includes('Git command failed')) {
+        // Handle Git-related errors (branch conflicts, etc.)
+    } else if (error.message.includes('PostHog API')) {
+        // Handle API-related errors (authentication, task not found)
+    } else if (error.message.includes('File system')) {
+        // Handle file permission or disk space issues
+    }
+}
+```
+
+## Performance Considerations
+
+- **Branch Creation**: Fast Git operations using local commands
+- **File I/O**: Efficient `.posthog/` folder management with minimal disk usage
+- **API Calls**: Cached PostHog task data to minimize network requests
+- **Event Streaming**: Real-time updates without blocking execution
+- **Template Processing**: Lazy-loaded templates with variable substitution

package/README.md

@@ -0,0 +1,142 @@
+# PostHog Agent SDK
+
+TypeScript agent framework that wraps the Claude Agent SDK for PostHog's Array desktop app. Features a Git-based workflow that stores task artifacts alongside your code.
+
+## Quick Start
+
+```bash
+bun install
+bun run example
+```
+
+## Key Features
+
+- **Git-Based Workflow**: Plans and artifacts stored in `.posthog/` folders and committed to Git
+- **PostHog Integration**: Fetches existing tasks from PostHog API
+- **Configurable Workflows**: Execute tasks via PostHog-defined or local workflows
+- **Branch Management**: Automatic branch creation for planning and implementation
+- **Event Streaming**: Real-time events for UI integration
+
+## Usage
+
+```typescript
+import { Agent, PermissionMode } from '@posthog/agent';
+
+const agent = new Agent({
+    workingDirectory: "/path/to/repo",
+    posthogApiUrl: "https://app.posthog.com",
+    posthogApiKey: process.env.POSTHOG_API_KEY
+});
+
+// Run by workflow
+const taskId = "task_abc123";
+const workflowId = "workflow_123";
+await agent.runWorkflow(taskId, workflowId, {
+  repositoryPath: "/path/to/repo",
+  permissionMode: PermissionMode.ACCEPT_EDITS,
+  autoProgress: true,
+});
+```
+
+## Workflow
+
+Each task execution creates Git branches:
+
+1. **Planning**: `posthog/task-{id}-planning` - Contains plan in `.posthog/{id}/plan.md`
+2. **Implementation**: `posthog/task-{id}-implementation` - Contains code changes
+
+## Manual Stages and Resume
+
+- Manual stages (no agent, or `is_manual_only`) are stop-points: the SDK will not auto-advance.
+- On manual stages, a PR is opened by default for human review (configurable per stage with `openPullRequest`).
+
+Resume from the current stage:
+
+```typescript
+await agent.runWorkflow(taskId, workflowId, {
+  repositoryPath: "/path/to/repo",
+  permissionMode: PermissionMode.ACCEPT_EDITS,
+  resumeFromCurrentStage: true,
+  autoProgress: true, // ignored on manual stages
+});
+
+// Or explicitly progress via API then resume
+await agent.progressToNextStage(taskId);
+await agent.runWorkflow(taskId, workflowId, { resumeFromCurrentStage: true });
+```
+
+## File System
+
+```
+your-repo/
+├── .posthog/
+│   ├── README.md
+│   ├── .gitignore
+│   └── {task-id}/
+│       ├── plan.md
+│       └── context.md (optional)
+└── (your code)
+```
+
+## Array App Integration
+
+```typescript
+const result = await agent.runTask(taskId, userSelectedMode, {
+    repositoryPath: selectedRepo,
+    onEvent: (event) => {
+        // Update UI based on event type
+        switch (event.type) {
+            case 'status': updateProgress(event.data); break;
+            case 'file_write': showFileChange(event.data); break;
+            case 'done': showCompletion(); break;
+        }
+    }
+});
+```
+
+## Requirements
+
+- Bun runtime
+- Git repository 
+- PostHog API access
+- Claude API access via `@anthropic-ai/claude-agent-sdk`
+
+
+## Stage overrides and query overrides
+
+You can customize behavior per workflow stage using `stageOverrides`, and pass low-level model options using `queryOverrides`.
+
+```ts
+await agent.runWorkflow(taskId, workflowId, {
+  repositoryPath: "/path/to/repo",
+  // Global defaults for this run
+  permissionMode: PermissionMode.ACCEPT_EDITS,
+  queryOverrides: { model: 'claude-3-7-sonnet' },
+
+  // Per-stage overrides (keys must match your workflow's stage keys)
+  stageOverrides: {
+    plan: {
+      permissionMode: PermissionMode.PLAN,
+      createPlanningBranch: true,
+      // Only applied during the planning stage
+      queryOverrides: { temperature: 0.2 }
+    },
+    build: {
+      createImplementationBranch: true,
+      openPullRequest: false,
+      // Inject custom MCP servers or any other query option
+      queryOverrides: {
+        mcpServers: {
+          // example: override or add servers
+        }
+      }
+    },
+    complete: {
+      // ensure a PR is opened at the end regardless of edits
+      openPullRequest: true
+    }
+  }
+});
+```
+
+Precedence for query options: base defaults in the SDK < global `queryOverrides` < per-stage `stageOverrides[stageKey].queryOverrides`.

package/dist/example.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../example.ts"],"names":[],"mappings":""}

package/dist/example.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env bun
+import { config } from "dotenv";
+config();
+import { Agent, PermissionMode } from './src/agent';
+async function testAgent() {
+    const REPO_PATH = process.argv[2] || process.cwd();
+    const TASK_ID = process.argv[3];
+    if (!process.env.POSTHOG_API_KEY) {
+        console.error("❌ POSTHOG_API_KEY required");
+        process.exit(1);
+    }
+    console.log(`📁 Working in: ${REPO_PATH}`);
+    const agent = new Agent({
+        workingDirectory: REPO_PATH,
+        posthogApiUrl: process.env.POSTHOG_API_URL || "http://localhost:8010",
+        posthogApiKey: process.env.POSTHOG_API_KEY,
+        onEvent: (event) => {
+            console.log(`[${event.type}]`, event);
+        },
+        debug: true,
+    });
+    if (TASK_ID) {
+        console.log(`🎯 Running task: ${TASK_ID}`);
+        try {
+            // Example: list and run a workflow
+            await agent['workflowRegistry'].loadWorkflows();
+            const workflows = agent['workflowRegistry'].listWorkflows();
+            if (workflows.length === 0) {
+                throw new Error('No workflows available');
+            }
+            const selectedWorkflow = workflows[0];
+            const options = {
+                repositoryPath: REPO_PATH,
+                permissionMode: PermissionMode.ACCEPT_EDITS,
+                autoProgress: true,
+            };
+            const result = await agent.runWorkflow(TASK_ID, selectedWorkflow.id, options);
+            console.log("✅ Done!");
+            console.log(`📁 Plan stored in: .posthog/${TASK_ID}/plan.md`);
+        }
+        finally {
+        }
+    }
+    else {
+        console.log("❌ Please provide a task ID");
+    }
+}
+testAgent().catch(console.error);
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","sourceRoot":"","sources":["../example.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,MAAM,EAAE,CAAC;AAET,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGpD,KAAK,UAAU,SAAS;IACpB,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACnD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEhC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QAC/B,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,kBAAkB,SAAS,EAAE,CAAC,CAAC;IAE3C,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC;QACpB,gBAAgB,EAAE,SAAS;QAC3B,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,uBAAuB;QACrE,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe;QAC1C,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACf,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;QACD,KAAK,EAAE,IAAI;KACd,CAAC,CAAC;IAEH,IAAI,OAAO,EAAE,CAAC;QACV,OAAO,CAAC,GAAG,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC;YACD,mCAAmC;YACnC,MAAM,KAAK,CAAC,kBAAkB,CAAC,CAAC,aAAa,EAAE,CAAC;YAChD,MAAM,SAAS,GAAG,KAAK,CAAC,kBAAkB,CAAC,CAAC,aAAa,EAAE,CAAC;YAC5D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAC9C,CAAC;YACD,MAAM,gBAAgB,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YACtC,MAAM,OAAO,GAA6B;gBACtC,cAAc,EAAE,SAAS;gBACzB,cAAc,EAAE,cAAc,CAAC,YAAY;gBAC3C,YAAY,EAAE,IAAI;aACrB,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,gBAAgB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YAC9E,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,+BAA+B,OAAO,UAAU,CAAC,CAAC;QAClE,CAAC;gBAAS,CAAC;QACX,CAAC;IACL,CAAC;SAAM,CAAC;QACJ,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAC9C,CAAC;AACL,CAAC;AAED,SAAS,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { Agent, } from './src/agent';
+export { PermissionMode, } from './src/types';
+export type { Task, SupportingFile, ExecutionResult, AgentConfig } from './src/types';
+export type { WorkflowDefinition, WorkflowStage, WorkflowExecutionOptions, AgentDefinition } from './src/workflow-types';
+export { Logger, LogLevel, } from './src/utils/logger';
+export type { LoggerConfig } from './src/utils/logger';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AACA,OAAO,EACH,KAAK,GACR,MAAM,aAAa,CAAC;AAErB,OAAO,EACH,cAAc,GACjB,MAAM,aAAa,CAAC;AAErB,YAAY,EACR,IAAI,EACJ,cAAc,EACd,eAAe,EACf,WAAW,EACd,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,wBAAwB,EACxB,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACH,MAAM,EACN,QAAQ,GACX,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACR,YAAY,EACf,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+// Main entry point - re-exports from src
+export { Agent, } from './src/agent';
+export { PermissionMode, } from './src/types';
+export { Logger, LogLevel, } from './src/utils/logger';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,OAAO,EACH,KAAK,GACR,MAAM,aAAa,CAAC;AAErB,OAAO,EACH,cAAc,GACjB,MAAM,aAAa,CAAC;AAgBrB,OAAO,EACH,MAAM,EACN,QAAQ,GACX,MAAM,oBAAoB,CAAC"}

package/dist/src/agent-registry.d.ts

@@ -0,0 +1,16 @@
+import type { AgentDefinition, AgentType } from './workflow-types';
+export declare class AgentRegistry {
+    private agentsByName;
+    constructor(definitions?: AgentDefinition[]);
+    static getDefaultAgents(): AgentDefinition[];
+    register(def: AgentDefinition): void;
+    getAgent(name: string): AgentDefinition | undefined;
+    listAgents(): AgentDefinition[];
+    exportForPostHog(): {
+        id: string;
+        name: string;
+        agent_type: AgentType;
+        description?: string;
+    }[];
+}
+//# sourceMappingURL=agent-registry.d.ts.map

package/dist/src/agent-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.d.ts","sourceRoot":"","sources":["../../src/agent-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEnE,qBAAa,aAAa;IACxB,OAAO,CAAC,YAAY,CAA2C;gBAEnD,WAAW,CAAC,EAAE,eAAe,EAAE;IAQ3C,MAAM,CAAC,gBAAgB,IAAI,eAAe,EAAE;IA6B5C,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAIpC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAInD,UAAU,IAAI,eAAe,EAAE;IAI/B,gBAAgB,IAAI;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,SAAS,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE;CAGhG"}

package/dist/src/agent-registry.js

@@ -0,0 +1,54 @@
+export class AgentRegistry {
+    agentsByName = new Map();
+    constructor(definitions) {
+        if (definitions) {
+            for (const def of definitions)
+                this.register(def);
+        }
+        else {
+            for (const def of AgentRegistry.getDefaultAgents())
+                this.register(def);
+        }
+    }
+    static getDefaultAgents() {
+        return [
+            {
+                id: 'planning_basic',
+                name: 'planning_basic',
+                agent_type: 'planning',
+                description: 'Analyze repo and produce implementation plan',
+            },
+            {
+                id: 'code_generation',
+                name: 'code_generation',
+                agent_type: 'execution',
+                description: 'Implements code changes using Claude SDK',
+            },
+            {
+                id: 'review_basic',
+                name: 'review_basic',
+                agent_type: 'review',
+                description: 'Reviews changes and suggests fixes',
+            },
+            {
+                id: 'testing_basic',
+                name: 'testing_basic',
+                agent_type: 'testing',
+                description: 'Runs tests and reports results',
+            },
+        ];
+    }
+    register(def) {
+        this.agentsByName.set(def.name, def);
+    }
+    getAgent(name) {
+        return this.agentsByName.get(name);
+    }
+    listAgents() {
+        return Array.from(this.agentsByName.values());
+    }
+    exportForPostHog() {
+        return this.listAgents().map(({ id, name, agent_type, description }) => ({ id, name, agent_type, description }));
+    }
+}
+//# sourceMappingURL=agent-registry.js.map

package/dist/src/agent-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.js","sourceRoot":"","sources":["../../src/agent-registry.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;IAChB,YAAY,GAAiC,IAAI,GAAG,EAAE,CAAC;IAE/D,YAAY,WAA+B;QACzC,IAAI,WAAW,EAAE,CAAC;YAChB,KAAK,MAAM,GAAG,IAAI,WAAW;gBAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,GAAG,IAAI,aAAa,CAAC,gBAAgB,EAAE;gBAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,MAAM,CAAC,gBAAgB;QACrB,OAAO;YACL;gBACE,EAAE,EAAE,gBAAgB;gBACpB,IAAI,EAAE,gBAAgB;gBACtB,UAAU,EAAE,UAAU;gBACtB,WAAW,EAAE,8CAA8C;aAC5D;YACD;gBACE,EAAE,EAAE,iBAAiB;gBACrB,IAAI,EAAE,iBAAiB;gBACvB,UAAU,EAAE,WAAW;gBACvB,WAAW,EAAE,0CAA0C;aACxD;YACD;gBACE,EAAE,EAAE,cAAc;gBAClB,IAAI,EAAE,cAAc;gBACpB,UAAU,EAAE,QAAQ;gBACpB,WAAW,EAAE,oCAAoC;aAClD;YACD;gBACE,EAAE,EAAE,eAAe;gBACnB,IAAI,EAAE,eAAe;gBACrB,UAAU,EAAE,SAAS;gBACrB,WAAW,EAAE,gCAAgC;aAC9C;SACF,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,GAAoB;QAC3B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACvC,CAAC;IAED,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;IACnH,CAAC;CACF"}

package/dist/src/agent.d.ts

@@ -0,0 +1,60 @@
+import type { Task, ExecutionResult, AgentConfig } from './types';
+import type { WorkflowDefinition, WorkflowStage, WorkflowExecutionOptions } from './workflow-types';
+export declare class Agent {
+    private workingDirectory;
+    private onEvent?;
+    private taskManager;
+    private posthogAPI?;
+    private fileManager;
+    private gitManager;
+    private templateManager;
+    private eventTransformer;
+    private logger;
+    private agentRegistry;
+    private workflowRegistry;
+    private stageExecutor;
+    debug: boolean;
+    constructor(config?: AgentConfig);
+    /**
+     * Enable or disable debug logging
+     */
+    setDebug(enabled: boolean): void;
+    runWorkflow(taskOrId: Task | string, workflowId: string, options?: WorkflowExecutionOptions): Promise<{
+        task: Task;
+        workflow: WorkflowDefinition;
+    }>;
+    executeStage(task: Task, stage: WorkflowStage, options?: WorkflowExecutionOptions): Promise<void>;
+    progressToNextStage(taskId: string): Promise<void>;
+    run(prompt: string, options?: {
+        repositoryPath?: string;
+        permissionMode?: import('./types').PermissionMode;
+        queryOverrides?: Record<string, any>;
+    }): Promise<ExecutionResult>;
+    fetchTask(taskId: string): Promise<Task>;
+    listTasks(filters?: {
+        repository?: string;
+        organization?: string;
+        origin_product?: string;
+        workflow?: string;
+        current_stage?: string;
+    }): Promise<Task[]>;
+    writeTaskFile(taskId: string, fileName: string, content: string, type?: 'plan' | 'context' | 'reference' | 'output'): Promise<void>;
+    readTaskFile(taskId: string, fileName: string): Promise<string | null>;
+    getTaskFiles(taskId: string): Promise<any[]>;
+    writePlan(taskId: string, plan: string): Promise<void>;
+    readPlan(taskId: string): Promise<string | null>;
+    createPlanningBranch(taskId: string): Promise<string>;
+    commitPlan(taskId: string, taskTitle: string): Promise<string>;
+    createImplementationBranch(taskId: string, planningBranchName?: string): Promise<string>;
+    commitImplementation(taskId: string, taskTitle: string, planSummary?: string): Promise<string>;
+    createPullRequest(taskId: string, branchName: string, taskTitle: string, taskDescription: string): Promise<string>;
+    attachPullRequestToTask(taskId: string, prUrl: string): Promise<void>;
+    updateTaskBranch(taskId: string, branchName: string): Promise<void>;
+    cancelTask(taskId: string): void;
+    getTaskExecutionStatus(taskId: string): string | null;
+    private emitEvent;
+}
+export { PermissionMode } from './types';
+export type { Task, SupportingFile, ExecutionResult, AgentConfig } from './types';
+export type { WorkflowDefinition, WorkflowStage, WorkflowExecutionOptions } from './workflow-types';
+//# sourceMappingURL=agent.d.ts.map

package/dist/src/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agent.ts"],"names":[],"mappings":"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"}