@posthog/agent 1.24.2 → 1.25.0

package/dist/src/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../../src/types.ts"],"sourcesContent":["\n// import and export to keep a single type file\nimport type { CanUseTool, PermissionResult } from '@anthropic-ai/claude-agent-sdk';\nexport type { CanUseTool, PermissionResult };\n\n// PostHog Task model (matches Array's OpenAPI schema)\nexport interface Task {\n  id: string;\n  title: string;\n  description: string;\n  origin_product: 'error_tracking' | 'eval_clusters' | 'user_created' | 'support_queue' | 'session_summaries';\n  position?: number;\n  github_integration?: number | null;\n  repository_config?: unknown; // JSONField\n  repository_list: string;\n  primary_repository: string;\n  created_at: string;\n  updated_at: string;\n\n  // DEPRECATED: These fields have been moved to TaskRun\n  // Use task.latest_run instead\n  current_stage?: string | null;\n  github_branch?: string | null;\n  github_pr_url?: string | null;\n  latest_run?: TaskRun;\n}\n\n// Log entry structure for TaskRun.log\nexport interface LogEntry {\n  type: string; // e.g., \"info\", \"warning\", \"error\", \"success\", \"debug\"\n  message: string;\n  [key: string]: unknown; // Allow additional fields\n}\n\nexport type ArtifactType = 'plan' | 'context' | 'reference' | 'output' | 'artifact';\n\nexport interface TaskRunArtifact {\n  name: string;\n  type: ArtifactType;\n  size?: number;\n  content_type?: string;\n  storage_path?: string;\n  uploaded_at?: string;\n}\n\n// TaskRun model - represents individual execution runs of tasks\nexport interface TaskRun {\n  id: string;\n  task: string; // Task ID\n  team: number;\n  branch: string | null;\n  status: 'started' | 'in_progress' | 'completed' | 'failed';\n  log_url?: string; // Presigned S3 URL for log access (valid for 1 hour)\n  error_message: string | null;\n  output: Record<string, unknown> | null; // Structured output (PR URL, commit SHA, etc.)\n  state: Record<string, unknown>; // Intermediate run state (defaults to {}, never null)\n  artifacts?: TaskRunArtifact[];\n  created_at: string;\n  updated_at: string;\n  completed_at: string | null;\n}\n\nexport interface SupportingFile {\n  name: string;\n  content: string;\n  type: ArtifactType;\n  created_at: string;\n}\n\nexport interface TaskArtifactUploadPayload {\n  name: string;\n  type: ArtifactType;\n  content: string;\n  content_type?: string;\n}\n\nexport enum PermissionMode {\n  PLAN = \"plan\",\n  DEFAULT = \"default\",\n  ACCEPT_EDITS = \"acceptEdits\",\n  BYPASS = \"bypassPermissions\"\n}\n\nexport interface ExecutionOptions {\n  repositoryPath?: string;\n  permissionMode?: PermissionMode;\n}\n\nexport interface TaskExecutionOptions {\n  repositoryPath?: string;\n  permissionMode?: PermissionMode;\n  isCloudMode?: boolean; // Determines local vs cloud behavior (local pauses after each phase)\n  createPR?: boolean; // Whether to create PR after build (defaults to false if local. This setting has no effect if isCloudMode is true.)\n  autoProgress?: boolean;\n  queryOverrides?: Record<string, any>;\n  // Fine-grained permission control (only applied to build phase)\n  // See: https://docs.claude.com/en/api/agent-sdk/permissions\n  canUseTool?: CanUseTool;\n}\n\n// Base event with timestamp\ninterface BaseEvent {\n  ts: number;\n}\n\n// Streaming content events\nexport interface TokenEvent extends BaseEvent {\n  type: 'token';\n  content: string;\n  contentType?: 'text' | 'thinking' | 'tool_input';\n}\n\nexport interface ContentBlockStartEvent extends BaseEvent {\n  type: 'content_block_start';\n  index: number;\n  contentType: 'text' | 'tool_use' | 'thinking';\n  toolName?: string;\n  toolId?: string;\n}\n\nexport interface ContentBlockStopEvent extends BaseEvent {\n  type: 'content_block_stop';\n  index: number;\n}\n\n// Tool events\nexport interface ToolCallEvent extends BaseEvent {\n  type: 'tool_call';\n  toolName: string;\n  callId: string;\n  args: Record<string, any>;\n  parentToolUseId?: string | null;  // For nested tool calls (subagents)\n  // Tool metadata (enriched by adapter for UI consumption)\n  tool?: import('./tools/types.js').Tool;\n  category?: import('./tools/types.js').ToolCategory;\n}\n\nexport interface ToolResultEvent extends BaseEvent {\n  type: 'tool_result';\n  toolName: string;\n  callId: string;\n  result: any;\n  isError?: boolean;                // Whether the tool execution failed\n  parentToolUseId?: string | null;  // For nested tool calls (subagents)\n  // Tool metadata (enriched by adapter for UI consumption)\n  tool?: import('./tools/types.js').Tool;\n  category?: import('./tools/types.js').ToolCategory;\n}\n\n// Message lifecycle events\nexport interface MessageStartEvent extends BaseEvent {\n  type: 'message_start';\n  messageId?: string;\n  model?: string;\n}\n\nexport interface MessageDeltaEvent extends BaseEvent {\n  type: 'message_delta';\n  stopReason?: string;\n  stopSequence?: string;\n  usage?: {\n    outputTokens: number;\n  };\n}\n\nexport interface MessageStopEvent extends BaseEvent {\n  type: 'message_stop';\n}\n\n// User message events\nexport interface UserMessageEvent extends BaseEvent {\n  type: 'user_message';\n  content: string;\n  isSynthetic?: boolean;\n}\n\n// System events\nexport interface StatusEvent extends BaseEvent {\n  type: 'status';\n  phase: string;\n  // Common optional fields (varies by phase):\n  kind?: string;            // Kind of status (plan, implementation)\n  branch?: string;          // Git branch name\n  prUrl?: string;           // Pull request URL\n  taskId?: string;          // Task identifier\n  messageId?: string;       // Claude message ID\n  model?: string;           // Model name\n  [key: string]: any;       // Allow additional fields\n}\n\nexport interface InitEvent extends BaseEvent {\n  type: 'init';\n  model: string;\n  tools: string[];\n  permissionMode: string;\n  cwd: string;\n  apiKeySource: string;\n  agents?: string[];\n  slashCommands?: string[];\n  outputStyle?: string;\n  mcpServers?: Array<{ name: string; status: string }>;\n}\n\nexport interface CompactBoundaryEvent extends BaseEvent {\n  type: 'compact_boundary';\n  trigger: 'manual' | 'auto';\n  preTokens: number;\n}\n\n// Result events\nexport interface DoneEvent extends BaseEvent {\n  type: 'done';\n  result?: string;              // Final summary text from Claude\n  durationMs?: number;\n  durationApiMs?: number;       // API-only duration (excluding local processing)\n  numTurns?: number;\n  totalCostUsd?: number;\n  usage?: any;\n  modelUsage?: {                // Per-model usage breakdown\n    [modelName: string]: {\n      inputTokens: number;\n      outputTokens: number;\n      cacheReadInputTokens: number;\n      cacheCreationInputTokens: number;\n      webSearchRequests: number;\n      costUSD: number;\n      contextWindow: number;\n    };\n  };\n  permissionDenials?: Array<{   // Tools that were denied by permissions\n    tool_name: string;\n    tool_use_id: string;\n    tool_input: Record<string, unknown>;\n  }>;\n}\n\nexport interface ErrorEvent extends BaseEvent {\n  type: 'error';\n  message: string;\n  error?: any;\n  errorType?: string;\n  context?: Record<string, any>; // Partial error context for debugging\n  sdkError?: any; // Original SDK error object\n}\n\n// Metric and artifact events (general purpose, not tool-specific)\nexport interface MetricEvent extends BaseEvent {\n  type: 'metric';\n  key: string;\n  value: number;\n  unit?: string;\n}\n\nexport interface ArtifactEvent extends BaseEvent {\n  type: 'artifact';\n  kind: string;\n  content: any;\n}\n\nexport interface RawSDKEvent extends BaseEvent {\n  type: 'raw_sdk_event';\n  sdkMessage: any; // Full SDK message for debugging\n}\n\nexport type AgentEvent =\n  | TokenEvent\n  | ContentBlockStartEvent\n  | ContentBlockStopEvent\n  | ToolCallEvent\n  | ToolResultEvent\n  | MessageStartEvent\n  | MessageDeltaEvent\n  | MessageStopEvent\n  | UserMessageEvent\n  | StatusEvent\n  | InitEvent\n  | CompactBoundaryEvent\n  | DoneEvent\n  | ErrorEvent\n  | MetricEvent\n  | ArtifactEvent\n  | RawSDKEvent;\n\nexport interface ExecutionResult {\n  results: any[];\n}\n\nexport interface PlanResult {\n  plan: string;\n}\n\nexport interface TaskExecutionResult {\n  task: Task;\n  plan?: string;\n  executionResult?: ExecutionResult;\n}\n\n// MCP Server configuration types (re-exported from Claude SDK for convenience)\nexport type McpServerConfig = {\n  type?: 'stdio';\n  command: string;\n  args?: string[];\n  env?: Record<string, string>;\n} | {\n  type: 'sse';\n  url: string;\n  headers?: Record<string, string>;\n} | {\n  type: 'http';\n  url: string;\n  headers?: Record<string, string>;\n} | {\n  type: 'sdk';\n  name: string;\n  instance?: any; // McpServer instance\n};\n\nexport interface AgentConfig {\n  workingDirectory?: string;\n  onEvent?: (event: AgentEvent) => void;\n\n  // PostHog API configuration\n  posthogApiUrl: string;\n  posthogApiKey: string;\n  posthogProjectId: number;\n\n  // PostHog MCP configuration\n  posthogMcpUrl?: string;\n\n\n  // MCP Server configuration\n  // Additional MCP servers (PostHog MCP is always included by default)\n  // You can override the PostHog MCP config by providing mcpServers.posthog\n  mcpServers?: Record<string, McpServerConfig>;\n\n  // Logging configuration\n  debug?: boolean;\n\n  // Fine-grained permission control for direct run() calls\n  // See: https://docs.claude.com/en/api/agent-sdk/permissions\n  canUseTool?: CanUseTool;\n}\n\nexport interface PostHogAPIConfig {\n  apiUrl: string;\n  apiKey: string;\n  projectId: number;\n}\n\n// URL mention types\nexport type ResourceType = 'error' | 'experiment' | 'insight' | 'feature_flag' | 'generic';\n\nexport interface PostHogResource {\n  type: ResourceType;\n  id: string;\n  url: string;\n  title?: string;\n  content: string;\n  metadata?: Record<string, any>;\n}\n\nexport interface UrlMention {\n  url: string;\n  type: ResourceType;\n  id?: string;\n  label?: string;\n}\n\n// Research evaluation types\nexport interface ResearchQuestion {\n  id: string;\n  question: string;\n  options: string[];\n}\n\nexport interface ResearchAnswer {\n  questionId: string;\n  selectedOption: string;\n  customInput?: string;\n}\n\nexport interface ResearchEvaluation {\n  actionabilityScore: number;    // 0-1 confidence score\n  context: string;               // brief summary for planning\n  keyFiles: string[];            // files needing modification\n  blockers?: string[];           // what's preventing full confidence\n  questions?: ResearchQuestion[]; // only if score < 0.7\n  answered?: boolean;            // whether questions have been answered\n  answers?: ResearchAnswer[];    // user's answers to questions\n}"],"names":[],"mappings":"IA4EY;AAAZ,CAAA,UAAY,cAAc,EAAA;AACxB,IAAA,cAAA,CAAA,MAAA,CAAA,GAAA,MAAa;AACb,IAAA,cAAA,CAAA,SAAA,CAAA,GAAA,SAAmB;AACnB,IAAA,cAAA,CAAA,cAAA,CAAA,GAAA,aAA4B;AAC5B,IAAA,cAAA,CAAA,QAAA,CAAA,GAAA,mBAA4B;AAC9B,CAAC,EALW,cAAc,KAAd,cAAc,GAAA,EAAA,CAAA,CAAA;;;;"}
+{"version":3,"file":"types.js","sources":["../../src/types.ts"],"sourcesContent":["// import and export to keep a single type file\n\nimport type { SessionNotification } from \"@agentclientprotocol/sdk\";\nimport type {\n  CanUseTool,\n  PermissionResult,\n} from \"@anthropic-ai/claude-agent-sdk\";\nexport type { CanUseTool, PermissionResult, SessionNotification };\n\n/**\n * Stored custom notification following ACP extensibility model.\n * Custom notifications use underscore-prefixed methods (e.g., `_posthog/phase_start`).\n * See: https://agentclientprotocol.com/docs/extensibility\n */\nexport interface StoredNotification {\n  type: \"notification\";\n  /** When this notification was stored */\n  timestamp: string;\n  /** JSON-RPC 2.0 notification (no id field = notification, not request) */\n  notification: {\n    jsonrpc: \"2.0\";\n    method: string;\n    params?: Record<string, unknown>;\n  };\n}\n\n/**\n * Type alias for stored log entries.\n */\nexport type StoredEntry = StoredNotification;\n\n// PostHog Task model (matches Array's OpenAPI schema)\nexport interface Task {\n  id: string;\n  task_number?: number;\n  slug?: string;\n  title: string;\n  description: string;\n  origin_product:\n    | \"error_tracking\"\n    | \"eval_clusters\"\n    | \"user_created\"\n    | \"support_queue\"\n    | \"session_summaries\";\n  github_integration?: number | null;\n  repository: string; // Format: \"organization/repository\" (e.g., \"posthog/posthog-js\")\n  json_schema?: Record<string, unknown> | null; // JSON schema for task output validation\n  created_at: string;\n  updated_at: string;\n  created_by?: {\n    id: number;\n    uuid: string;\n    distinct_id: string;\n    first_name: string;\n    email: string;\n  };\n  latest_run?: TaskRun;\n}\n\n// Log entry structure for TaskRun.log\n\nexport type ArtifactType =\n  | \"plan\"\n  | \"context\"\n  | \"reference\"\n  | \"output\"\n  | \"artifact\";\n\nexport interface TaskRunArtifact {\n  name: string;\n  type: ArtifactType;\n  size?: number;\n  content_type?: string;\n  storage_path?: string;\n  uploaded_at?: string;\n}\n\nexport type TaskRunStatus =\n  | \"not_started\"\n  | \"queued\"\n  | \"in_progress\"\n  | \"completed\"\n  | \"failed\"\n  | \"cancelled\";\n\nexport type TaskRunEnvironment = \"local\" | \"cloud\";\n\n// TaskRun model - represents individual execution runs of tasks\nexport interface TaskRun {\n  id: string;\n  task: string; // Task ID\n  team: number;\n  branch: string | null;\n  stage: string | null; // Current stage (e.g., 'research', 'plan', 'build')\n  environment: TaskRunEnvironment;\n  status: TaskRunStatus;\n  log_url: string;\n  error_message: string | null;\n  output: Record<string, unknown> | null; // Structured output (PR URL, commit SHA, etc.)\n  state: Record<string, unknown>; // Intermediate run state (defaults to {}, never null)\n  artifacts?: TaskRunArtifact[];\n  created_at: string;\n  updated_at: string;\n  completed_at: string | null;\n}\n\nexport interface SupportingFile {\n  name: string;\n  content: string;\n  type: ArtifactType;\n  created_at: string;\n}\n\nexport interface TaskArtifactUploadPayload {\n  name: string;\n  type: ArtifactType;\n  content: string;\n  content_type?: string;\n}\n\nexport enum PermissionMode {\n  PLAN = \"plan\",\n  DEFAULT = \"default\",\n  ACCEPT_EDITS = \"acceptEdits\",\n  BYPASS = \"bypassPermissions\",\n}\n\nexport interface ExecutionOptions {\n  repositoryPath?: string;\n  permissionMode?: PermissionMode;\n}\n\nexport interface TaskExecutionOptions {\n  repositoryPath?: string;\n  permissionMode?: PermissionMode;\n  isCloudMode?: boolean; // Determines local vs cloud behavior (local pauses after each phase)\n  createPR?: boolean; // Whether to create PR after build (defaults to false if local. This setting has no effect if isCloudMode is true.)\n  autoProgress?: boolean;\n  queryOverrides?: Record<string, unknown>;\n  // Fine-grained permission control (only applied to build phase)\n  // See: https://docs.claude.com/en/api/agent-sdk/permissions\n  canUseTool?: CanUseTool;\n  skipGitBranch?: boolean; // Skip creating a task-specific git branch\n}\n\nexport interface ExecutionResult {\n  // biome-ignore lint/suspicious/noExplicitAny: Results array contains varying SDK response types\n  results: any[];\n}\n\nexport interface PlanResult {\n  plan: string;\n}\n\nexport interface TaskExecutionResult {\n  task: Task;\n  plan?: string;\n  executionResult?: ExecutionResult;\n}\n\n// MCP Server configuration types (re-exported from Claude SDK for convenience)\nexport type McpServerConfig =\n  | {\n      type?: \"stdio\";\n      command: string;\n      args?: string[];\n      env?: Record<string, string>;\n    }\n  | {\n      type: \"sse\";\n      url: string;\n      headers?: Record<string, string>;\n    }\n  | {\n      type: \"http\";\n      url: string;\n      headers?: Record<string, string>;\n    }\n  | {\n      type: \"sdk\";\n      name: string;\n      // biome-ignore lint/suspicious/noExplicitAny: McpServer instance type from external SDK\n      instance?: any;\n    };\n\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\nexport type OnLogCallback = (\n  level: LogLevel,\n  scope: string,\n  message: string,\n  data?: unknown,\n) => void;\n\nexport interface AgentConfig {\n  workingDirectory?: string;\n\n  // PostHog API configuration (optional - enables PostHog integration when provided)\n  posthogApiUrl?: string;\n  posthogApiKey?: string;\n  posthogProjectId?: number;\n\n  // PostHog MCP configuration\n  posthogMcpUrl?: string;\n\n  // MCP Server configuration\n  // Additional MCP servers (PostHog MCP is always included by default)\n  // You can override the PostHog MCP config by providing mcpServers.posthog\n  mcpServers?: Record<string, McpServerConfig>;\n\n  // Logging configuration\n  debug?: boolean;\n  onLog?: OnLogCallback;\n\n  // Fine-grained permission control for direct run() calls\n  // See: https://docs.claude.com/en/api/agent-sdk/permissions\n  canUseTool?: CanUseTool;\n}\n\nexport interface PostHogAPIConfig {\n  apiUrl: string;\n  apiKey: string;\n  projectId: number;\n}\n\n// URL mention types\nexport type ResourceType =\n  | \"error\"\n  | \"experiment\"\n  | \"insight\"\n  | \"feature_flag\"\n  | \"generic\";\n\nexport interface PostHogResource {\n  type: ResourceType;\n  id: string;\n  url: string;\n  title?: string;\n  content: string;\n  // biome-ignore lint/suspicious/noExplicitAny: Metadata contains varying resource-specific fields\n  metadata?: Record<string, any>;\n}\n\nexport interface UrlMention {\n  url: string;\n  type: ResourceType;\n  id?: string;\n  label?: string;\n}\n\n// Research evaluation types\nexport interface ResearchQuestion {\n  id: string;\n  question: string;\n  options: string[];\n}\n\nexport interface ResearchAnswer {\n  questionId: string;\n  selectedOption: string;\n  customInput?: string;\n}\n\nexport interface ResearchEvaluation {\n  actionabilityScore: number; // 0-1 confidence score\n  context: string; // brief summary for planning\n  keyFiles: string[]; // files needing modification\n  blockers?: string[]; // what's preventing full confidence\n  questions?: ResearchQuestion[]; // only if score < 0.7\n  answered?: boolean; // whether questions have been answered\n  answers?: ResearchAnswer[]; // user's answers to questions\n}\n\n// Worktree types for parallel task development\nexport interface WorktreeInfo {\n  worktreePath: string;\n  worktreeName: string;\n  branchName: string;\n  baseBranch: string;\n  createdAt: string;\n}\n"],"names":[],"mappings":"AAAA;IAwHY;AAAZ,CAAA,UAAY,cAAc,EAAA;AACxB,IAAA,cAAA,CAAA,MAAA,CAAA,GAAA,MAAa;AACb,IAAA,cAAA,CAAA,SAAA,CAAA,GAAA,SAAmB;AACnB,IAAA,cAAA,CAAA,cAAA,CAAA,GAAA,aAA4B;AAC5B,IAAA,cAAA,CAAA,QAAA,CAAA,GAAA,mBAA4B;AAC9B,CAAC,EALW,cAAc,KAAd,cAAc,GAAA,EAAA,CAAA,CAAA;;;;"}

package/dist/src/utils/logger.d.ts

@@ -1,5 +1,6 @@
+import type { LogLevel as LogLevelType, OnLogCallback } from "../types.js";
 /**
- * Simple logger utility with configurable debug mode
+ * Simple logger utility with configurable debug mode and external log forwarding
  */
 export declare enum LogLevel {
     ERROR = 0,
@@ -10,19 +11,26 @@ export declare enum LogLevel {
 export interface LoggerConfig {
     debug?: boolean;
     prefix?: string;
+    scope?: string;
+    onLog?: OnLogCallback;
 }
 export declare class Logger {
     private debugEnabled;
     private prefix;
+    private scope;
+    private onLog?;
     constructor(config?: LoggerConfig);
     setDebug(enabled: boolean): void;
+    setOnLog(onLog: OnLogCallback | undefined): void;
     private formatMessage;
-    error(message: string, error?: Error | any): void;
-    warn(message: string, data?: any): void;
-    info(message: string, data?: any): void;
-    debug(message: string, data?: any): void;
+    private emitLog;
+    error(message: string, error?: Error | unknown): void;
+    warn(message: string, data?: unknown): void;
+    info(message: string, data?: unknown): void;
+    debug(message: string, data?: unknown): void;
+    log(level: LogLevelType, message: string, data?: unknown, scope?: string): void;
     /**
-     * Create a child logger with additional prefix
+     * Create a child logger with additional prefix and scope
      */
     child(childPrefix: string): Logger;
 }

package/dist/src/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,QAAQ;IAChB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACZ;AAED,MAAM,WAAW,YAAY;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,MAAM;IACf,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,GAAE,YAAiB;IAKrC,QAAQ,CAAC,OAAO,EAAE,OAAO;IAIzB,OAAO,CAAC,aAAa;IAWrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,GAAG;IAY1C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;IAMhC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;IAMhC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;IAMjC;;OAEG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;CAMrC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE3E;;GAEG;AACH,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACV;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAC,CAAgB;gBAElB,MAAM,GAAE,YAAiB;IAOrC,QAAQ,CAAC,OAAO,EAAE,OAAO;IAIzB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS;IAIzC,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,OAAO;IAaf,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO;IAS9C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;IAIpC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;IAIpC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;IAIrC,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM;IASxE;;OAEG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;CAQnC"}

package/dist/src/utils/logger.js

@@ -1,5 +1,5 @@
 /**
- * Simple logger utility with configurable debug mode
+ * Simple logger utility with configurable debug mode and external log forwarding
  */
 var LogLevel;
 (function (LogLevel) {
@@ -11,55 +11,70 @@ var LogLevel;
 class Logger {
     debugEnabled;
     prefix;
+    scope;
+    onLog;
     constructor(config = {}) {
         this.debugEnabled = config.debug ?? false;
-        this.prefix = config.prefix ?? '[PostHog Agent]';
+        this.prefix = config.prefix ?? "[PostHog Agent]";
+        this.scope = config.scope ?? "agent";
+        this.onLog = config.onLog;
     }
     setDebug(enabled) {
         this.debugEnabled = enabled;
     }
+    setOnLog(onLog) {
+        this.onLog = onLog;
+    }
     formatMessage(level, message, data) {
         const timestamp = new Date().toISOString();
-        const base = `${timestamp} ${this.prefix} ${level} ${message}`;
+        const base = `${timestamp} ${this.prefix} [${level}] ${message}`;
         if (data !== undefined) {
             return `${base} ${JSON.stringify(data, null, 2)}`;
         }
         return base;
     }
-    error(message, error) {
-        // Always log errors
-        if (error instanceof Error) {
-            console.error(this.formatMessage('[ERROR]', message, {
-                message: error.message,
-                stack: error.stack
-            }));
+    emitLog(level, message, data) {
+        if (this.onLog) {
+            this.onLog(level, this.scope, message, data);
+            return;
         }
-        else {
-            console.error(this.formatMessage('[ERROR]', message, error));
+        const shouldLog = this.debugEnabled || level === "error";
+        if (shouldLog) {
+            console[level](this.formatMessage(level.toLowerCase(), message, data));
         }
     }
+    error(message, error) {
+        const data = error instanceof Error
+            ? { message: error.message, stack: error.stack }
+            : error;
+        this.emitLog("error", message, data);
+    }
     warn(message, data) {
-        if (this.debugEnabled) {
-            console.warn(this.formatMessage('[WARN]', message, data));
-        }
+        this.emitLog("warn", message, data);
     }
     info(message, data) {
-        if (this.debugEnabled) {
-            console.log(this.formatMessage('[INFO]', message, data));
-        }
+        this.emitLog("info", message, data);
     }
     debug(message, data) {
-        if (this.debugEnabled) {
-            console.log(this.formatMessage('[DEBUG]', message, data));
+        this.emitLog("debug", message, data);
+    }
+    log(level, message, data, scope) {
+        const originalScope = this.scope;
+        if (scope) {
+            this.scope = scope;
         }
+        this.emitLog(level, message, data);
+        this.scope = originalScope;
     }
     /**
-     * Create a child logger with additional prefix
+     * Create a child logger with additional prefix and scope
      */
     child(childPrefix) {
         return new Logger({
             debug: this.debugEnabled,
-            prefix: `${this.prefix} [${childPrefix}]`
+            prefix: `${this.prefix} [${childPrefix}]`,
+            scope: `${this.scope}:${childPrefix}`,
+            onLog: this.onLog,
         });
     }
 }

package/dist/src/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sources":["../../../src/utils/logger.ts"],"sourcesContent":["/**\n * Simple logger utility with configurable debug mode\n */\nexport enum LogLevel {\n    ERROR = 0,\n    WARN = 1,\n    INFO = 2,\n    DEBUG = 3\n}\n\nexport interface LoggerConfig {\n    debug?: boolean;\n    prefix?: string;\n}\n\nexport class Logger {\n    private debugEnabled: boolean;\n    private prefix: string;\n\n    constructor(config: LoggerConfig = {}) {\n        this.debugEnabled = config.debug ?? false;\n        this.prefix = config.prefix ?? '[PostHog Agent]';\n    }\n\n    setDebug(enabled: boolean) {\n        this.debugEnabled = enabled;\n    }\n\n    private formatMessage(level: string, message: string, data?: any): string {\n        const timestamp = new Date().toISOString();\n        const base = `${timestamp} ${this.prefix} ${level} ${message}`;\n        \n        if (data !== undefined) {\n            return `${base} ${JSON.stringify(data, null, 2)}`;\n        }\n        \n        return base;\n    }\n\n    error(message: string, error?: Error | any) {\n        // Always log errors\n        if (error instanceof Error) {\n            console.error(this.formatMessage('[ERROR]', message, {\n                message: error.message,\n                stack: error.stack\n            }));\n        } else {\n            console.error(this.formatMessage('[ERROR]', message, error));\n        }\n    }\n\n    warn(message: string, data?: any) {\n        if (this.debugEnabled) {\n            console.warn(this.formatMessage('[WARN]', message, data));\n        }\n    }\n\n    info(message: string, data?: any) {\n        if (this.debugEnabled) {\n            console.log(this.formatMessage('[INFO]', message, data));\n        }\n    }\n\n    debug(message: string, data?: any) {\n        if (this.debugEnabled) {\n            console.log(this.formatMessage('[DEBUG]', message, data));\n        }\n    }\n\n    /**\n     * Create a child logger with additional prefix\n     */\n    child(childPrefix: string): Logger {\n        return new Logger({\n            debug: this.debugEnabled,\n            prefix: `${this.prefix} [${childPrefix}]`\n        });\n    }\n}"],"names":[],"mappings":"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"}
+{"version":3,"file":"logger.js","sources":["../../../src/utils/logger.ts"],"sourcesContent":["import type { LogLevel as LogLevelType, OnLogCallback } from \"../types.js\";\n\n/**\n * Simple logger utility with configurable debug mode and external log forwarding\n */\nexport enum LogLevel {\n  ERROR = 0,\n  WARN = 1,\n  INFO = 2,\n  DEBUG = 3,\n}\n\nexport interface LoggerConfig {\n  debug?: boolean;\n  prefix?: string;\n  scope?: string;\n  onLog?: OnLogCallback;\n}\n\nexport class Logger {\n  private debugEnabled: boolean;\n  private prefix: string;\n  private scope: string;\n  private onLog?: OnLogCallback;\n\n  constructor(config: LoggerConfig = {}) {\n    this.debugEnabled = config.debug ?? false;\n    this.prefix = config.prefix ?? \"[PostHog Agent]\";\n    this.scope = config.scope ?? \"agent\";\n    this.onLog = config.onLog;\n  }\n\n  setDebug(enabled: boolean) {\n    this.debugEnabled = enabled;\n  }\n\n  setOnLog(onLog: OnLogCallback | undefined) {\n    this.onLog = onLog;\n  }\n\n  private formatMessage(\n    level: string,\n    message: string,\n    data?: unknown,\n  ): string {\n    const timestamp = new Date().toISOString();\n    const base = `${timestamp} ${this.prefix} [${level}] ${message}`;\n\n    if (data !== undefined) {\n      return `${base} ${JSON.stringify(data, null, 2)}`;\n    }\n\n    return base;\n  }\n\n  private emitLog(level: LogLevelType, message: string, data?: unknown) {\n    if (this.onLog) {\n      this.onLog(level, this.scope, message, data);\n      return;\n    }\n\n    const shouldLog = this.debugEnabled || level === \"error\";\n\n    if (shouldLog) {\n      console[level](this.formatMessage(level.toLowerCase(), message, data));\n    }\n  }\n\n  error(message: string, error?: Error | unknown) {\n    const data =\n      error instanceof Error\n        ? { message: error.message, stack: error.stack }\n        : error;\n\n    this.emitLog(\"error\", message, data);\n  }\n\n  warn(message: string, data?: unknown) {\n    this.emitLog(\"warn\", message, data);\n  }\n\n  info(message: string, data?: unknown) {\n    this.emitLog(\"info\", message, data);\n  }\n\n  debug(message: string, data?: unknown) {\n    this.emitLog(\"debug\", message, data);\n  }\n\n  log(level: LogLevelType, message: string, data?: unknown, scope?: string) {\n    const originalScope = this.scope;\n    if (scope) {\n      this.scope = scope;\n    }\n    this.emitLog(level, message, data);\n    this.scope = originalScope;\n  }\n\n  /**\n   * Create a child logger with additional prefix and scope\n   */\n  child(childPrefix: string): Logger {\n    return new Logger({\n      debug: this.debugEnabled,\n      prefix: `${this.prefix} [${childPrefix}]`,\n      scope: `${this.scope}:${childPrefix}`,\n      onLog: this.onLog,\n    });\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/src/utils/tapped-stream.d.ts

@@ -0,0 +1,17 @@
+import type { Logger } from "./logger.js";
+type MessageCallback = (line: string) => void;
+export interface TappedStreamOptions {
+    onMessage: MessageCallback;
+    logger?: Logger;
+}
+/**
+ * Creates a WritableStream wrapper that taps all newline-delimited messages,
+ * forwarding each complete line for persistence.
+ *
+ * This aligns with ACP's transport model - all messages flow through
+ * newline-delimited JSON-RPC streams, so we intercept at the transport layer
+ * and persist everything.
+ */
+export declare function createTappedWritableStream(underlying: WritableStream<Uint8Array>, options: TappedStreamOptions): WritableStream<Uint8Array>;
+export {};
+//# sourceMappingURL=tapped-stream.d.ts.map

package/dist/src/utils/tapped-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tapped-stream.d.ts","sourceRoot":"","sources":["../../../src/utils/tapped-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,KAAK,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAE9C,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,eAAe,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,cAAc,CAAC,UAAU,CAAC,EACtC,OAAO,EAAE,mBAAmB,GAC3B,cAAc,CAAC,UAAU,CAAC,CAuC5B"}

package/dist/src/utils/tapped-stream.js

@@ -0,0 +1,45 @@
+/**
+ * Creates a WritableStream wrapper that taps all newline-delimited messages,
+ * forwarding each complete line for persistence.
+ *
+ * This aligns with ACP's transport model - all messages flow through
+ * newline-delimited JSON-RPC streams, so we intercept at the transport layer
+ * and persist everything.
+ */
+function createTappedWritableStream(underlying, options) {
+    const { onMessage, logger } = options;
+    const decoder = new TextDecoder();
+    let buffer = "";
+    return new WritableStream({
+        async write(chunk) {
+            // Decode and buffer
+            buffer += decoder.decode(chunk, { stream: true });
+            // Process complete lines (newline-delimited)
+            const lines = buffer.split("\n");
+            buffer = lines.pop() ?? "";
+            for (const line of lines) {
+                if (!line.trim())
+                    continue;
+                onMessage(line);
+            }
+            // Forward to underlying stream
+            const writer = underlying.getWriter();
+            await writer.write(chunk);
+            writer.releaseLock();
+        },
+        async close() {
+            const writer = underlying.getWriter();
+            await writer.close();
+            writer.releaseLock();
+        },
+        async abort(reason) {
+            logger?.warn("Tapped stream aborted", { reason });
+            const writer = underlying.getWriter();
+            await writer.abort(reason);
+            writer.releaseLock();
+        },
+    });
+}
+
+export { createTappedWritableStream };
+//# sourceMappingURL=tapped-stream.js.map

package/dist/src/utils/tapped-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tapped-stream.js","sources":["../../../src/utils/tapped-stream.ts"],"sourcesContent":["import type { Logger } from \"./logger.js\";\n\ntype MessageCallback = (line: string) => void;\n\nexport interface TappedStreamOptions {\n  onMessage: MessageCallback;\n  logger?: Logger;\n}\n\n/**\n * Creates a WritableStream wrapper that taps all newline-delimited messages,\n * forwarding each complete line for persistence.\n *\n * This aligns with ACP's transport model - all messages flow through\n * newline-delimited JSON-RPC streams, so we intercept at the transport layer\n * and persist everything.\n */\nexport function createTappedWritableStream(\n  underlying: WritableStream<Uint8Array>,\n  options: TappedStreamOptions,\n): WritableStream<Uint8Array> {\n  const { onMessage, logger } = options;\n  const decoder = new TextDecoder();\n  let buffer = \"\";\n  let _messageCount = 0;\n\n  return new WritableStream({\n    async write(chunk: Uint8Array) {\n      // Decode and buffer\n      buffer += decoder.decode(chunk, { stream: true });\n\n      // Process complete lines (newline-delimited)\n      const lines = buffer.split(\"\\n\");\n      buffer = lines.pop() ?? \"\";\n\n      for (const line of lines) {\n        if (!line.trim()) continue;\n        _messageCount++;\n\n        onMessage(line);\n      }\n\n      // Forward to underlying stream\n      const writer = underlying.getWriter();\n      await writer.write(chunk);\n      writer.releaseLock();\n    },\n    async close() {\n      const writer = underlying.getWriter();\n      await writer.close();\n      writer.releaseLock();\n    },\n    async abort(reason: unknown) {\n      logger?.warn(\"Tapped stream aborted\", { reason });\n      const writer = underlying.getWriter();\n      await writer.abort(reason);\n      writer.releaseLock();\n    },\n  });\n}\n"],"names":[],"mappings":"AASA;;;;;;;AAOG;AACG,SAAU,0BAA0B,CACxC,UAAsC,EACtC,OAA4B,EAAA;AAE5B,IAAA,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO;AACrC,IAAA,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE;IACjC,IAAI,MAAM,GAAG,EAAE;IAGf,OAAO,IAAI,cAAc,CAAC;QACxB,MAAM,KAAK,CAAC,KAAiB,EAAA;;AAE3B,YAAA,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;;YAGjD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;AAChC,YAAA,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE;AAE1B,YAAA,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;AACxB,gBAAA,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;oBAAE;gBAGlB,SAAS,CAAC,IAAI,CAAC;YACjB;;AAGA,YAAA,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,EAAE;AACrC,YAAA,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;YACzB,MAAM,CAAC,WAAW,EAAE;QACtB,CAAC;AACD,QAAA,MAAM,KAAK,GAAA;AACT,YAAA,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,EAAE;AACrC,YAAA,MAAM,MAAM,CAAC,KAAK,EAAE;YACpB,MAAM,CAAC,WAAW,EAAE;QACtB,CAAC;QACD,MAAM,KAAK,CAAC,MAAe,EAAA;YACzB,MAAM,EAAE,IAAI,CAAC,uBAAuB,EAAE,EAAE,MAAM,EAAE,CAAC;AACjD,YAAA,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,EAAE;AACrC,YAAA,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;YAC1B,MAAM,CAAC,WAAW,EAAE;QACtB,CAAC;AACF,KAAA,CAAC;AACJ;;;;"}

package/dist/src/workflow/config.d.ts

@@ -1,3 +1,3 @@
-import type { WorkflowDefinition } from './types.js';
+import type { WorkflowDefinition } from "./types.js";
 export declare const TASK_WORKFLOW: WorkflowDefinition;
 //# sourceMappingURL=config.d.ts.map

package/dist/src/workflow/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/workflow/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAWrD,eAAO,MAAM,aAAa,EAAE,kBAyC3B,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/workflow/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAOrD,eAAO,MAAM,aAAa,EAAE,kBAyC3B,CAAC"}

package/dist/src/workflow/config.js

@@ -1,7 +1,7 @@
-import { researchStep } from './steps/research.js';
-import { planStep } from './steps/plan.js';
 import { buildStep } from './steps/build.js';
 import { finalizeStep } from './steps/finalize.js';
+import { planStep } from './steps/plan.js';
+import { researchStep } from './steps/research.js';
 
 const MODELS = {
     SONNET: "claude-sonnet-4-5",
@@ -9,41 +9,41 @@ const MODELS = {
 };
 const TASK_WORKFLOW = [
     {
-        id: 'research',
-        name: 'Research',
-        agent: 'research',
+        id: "research",
+        name: "Research",
+        agent: "research",
         model: MODELS.HAIKU,
-        permissionMode: 'plan',
+        permissionMode: "plan",
         commit: true,
         push: true,
         run: researchStep,
     },
     {
-        id: 'plan',
-        name: 'Plan',
-        agent: 'planning',
+        id: "plan",
+        name: "Plan",
+        agent: "planning",
         model: MODELS.SONNET,
-        permissionMode: 'plan',
+        permissionMode: "plan",
         commit: true,
         push: true,
         run: planStep,
     },
     {
-        id: 'build',
-        name: 'Build',
-        agent: 'execution',
+        id: "build",
+        name: "Build",
+        agent: "execution",
         model: MODELS.SONNET,
-        permissionMode: 'acceptEdits',
+        permissionMode: "acceptEdits",
         commit: true,
         push: true,
         run: buildStep,
     },
     {
-        id: 'finalize',
-        name: 'Finalize',
-        agent: 'system', // not used
+        id: "finalize",
+        name: "Finalize",
+        agent: "system", // not used
         model: MODELS.HAIKU, // not used
-        permissionMode: 'plan', // not used
+        permissionMode: "plan", // not used
         commit: true,
         push: true,
         run: finalizeStep,

package/dist/src/workflow/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sources":["../../../src/workflow/config.ts"],"sourcesContent":["import type { WorkflowDefinition } from './types.js';\nimport { researchStep } from './steps/research.js';\nimport { planStep } from './steps/plan.js';\nimport { buildStep } from './steps/build.js';\nimport { finalizeStep } from './steps/finalize.js';\n\nconst MODELS = {\n    SONNET: \"claude-sonnet-4-5\",\n    HAIKU: \"claude-haiku-4-5\",\n}\n\nexport const TASK_WORKFLOW: WorkflowDefinition = [\n    {\n        id: 'research',\n        name: 'Research',\n        agent: 'research',\n        model: MODELS.HAIKU,\n        permissionMode: 'plan',\n        commit: true,\n        push: true,\n        run: researchStep,\n    },\n    {\n        id: 'plan',\n        name: 'Plan',\n        agent: 'planning',\n        model: MODELS.SONNET,\n        permissionMode: 'plan',\n        commit: true,\n        push: true,\n        run: planStep,\n    },\n    {\n        id: 'build',\n        name: 'Build',\n        agent: 'execution',\n        model: MODELS.SONNET,\n        permissionMode: 'acceptEdits',\n        commit: true,\n        push: true,\n        run: buildStep,\n    },\n    {\n        id: 'finalize',\n        name: 'Finalize',\n        agent: 'system', // not used\n        model: MODELS.HAIKU, // not used\n        permissionMode: 'plan', // not used\n        commit: true,\n        push: true,\n        run: finalizeStep,\n    },\n];\n"],"names":[],"mappings":";;;;;AAMA,MAAM,MAAM,GAAG;AACX,IAAA,MAAM,EAAE,mBAAmB;AAC3B,IAAA,KAAK,EAAE,kBAAkB;CAC5B;AAEM,MAAM,aAAa,GAAuB;AAC7C,IAAA;AACI,QAAA,EAAE,EAAE,UAAU;AACd,QAAA,IAAI,EAAE,UAAU;AAChB,QAAA,KAAK,EAAE,UAAU;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;AACnB,QAAA,cAAc,EAAE,MAAM;AACtB,QAAA,MAAM,EAAE,IAAI;AACZ,QAAA,IAAI,EAAE,IAAI;AACV,QAAA,GAAG,EAAE,YAAY;AACpB,KAAA;AACD,IAAA;AACI,QAAA,EAAE,EAAE,MAAM;AACV,QAAA,IAAI,EAAE,MAAM;AACZ,QAAA,KAAK,EAAE,UAAU;QACjB,KAAK,EAAE,MAAM,CAAC,MAAM;AACpB,QAAA,cAAc,EAAE,MAAM;AACtB,QAAA,MAAM,EAAE,IAAI;AACZ,QAAA,IAAI,EAAE,IAAI;AACV,QAAA,GAAG,EAAE,QAAQ;AAChB,KAAA;AACD,IAAA;AACI,QAAA,EAAE,EAAE,OAAO;AACX,QAAA,IAAI,EAAE,OAAO;AACb,QAAA,KAAK,EAAE,WAAW;QAClB,KAAK,EAAE,MAAM,CAAC,MAAM;AACpB,QAAA,cAAc,EAAE,aAAa;AAC7B,QAAA,MAAM,EAAE,IAAI;AACZ,QAAA,IAAI,EAAE,IAAI;AACV,QAAA,GAAG,EAAE,SAAS;AACjB,KAAA;AACD,IAAA;AACI,QAAA,EAAE,EAAE,UAAU;AACd,QAAA,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,QAAQ;AACf,QAAA,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,cAAc,EAAE,MAAM;AACtB,QAAA,MAAM,EAAE,IAAI;AACZ,QAAA,IAAI,EAAE,IAAI;AACV,QAAA,GAAG,EAAE,YAAY;AACpB,KAAA;;;;;"}
+{"version":3,"file":"config.js","sources":["../../../src/workflow/config.ts"],"sourcesContent":["import { buildStep } from \"./steps/build.js\";\nimport { finalizeStep } from \"./steps/finalize.js\";\nimport { planStep } from \"./steps/plan.js\";\nimport { researchStep } from \"./steps/research.js\";\nimport type { WorkflowDefinition } from \"./types.js\";\n\nconst MODELS = {\n  SONNET: \"claude-sonnet-4-5\",\n  HAIKU: \"claude-haiku-4-5\",\n};\n\nexport const TASK_WORKFLOW: WorkflowDefinition = [\n  {\n    id: \"research\",\n    name: \"Research\",\n    agent: \"research\",\n    model: MODELS.HAIKU,\n    permissionMode: \"plan\",\n    commit: true,\n    push: true,\n    run: researchStep,\n  },\n  {\n    id: \"plan\",\n    name: \"Plan\",\n    agent: \"planning\",\n    model: MODELS.SONNET,\n    permissionMode: \"plan\",\n    commit: true,\n    push: true,\n    run: planStep,\n  },\n  {\n    id: \"build\",\n    name: \"Build\",\n    agent: \"execution\",\n    model: MODELS.SONNET,\n    permissionMode: \"acceptEdits\",\n    commit: true,\n    push: true,\n    run: buildStep,\n  },\n  {\n    id: \"finalize\",\n    name: \"Finalize\",\n    agent: \"system\", // not used\n    model: MODELS.HAIKU, // not used\n    permissionMode: \"plan\", // not used\n    commit: true,\n    push: true,\n    run: finalizeStep,\n  },\n];\n"],"names":[],"mappings":";;;;;AAMA,MAAM,MAAM,GAAG;AACb,IAAA,MAAM,EAAE,mBAAmB;AAC3B,IAAA,KAAK,EAAE,kBAAkB;CAC1B;AAEM,MAAM,aAAa,GAAuB;AAC/C,IAAA;AACE,QAAA,EAAE,EAAE,UAAU;AACd,QAAA,IAAI,EAAE,UAAU;AAChB,QAAA,KAAK,EAAE,UAAU;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;AACnB,QAAA,cAAc,EAAE,MAAM;AACtB,QAAA,MAAM,EAAE,IAAI;AACZ,QAAA,IAAI,EAAE,IAAI;AACV,QAAA,GAAG,EAAE,YAAY;AAClB,KAAA;AACD,IAAA;AACE,QAAA,EAAE,EAAE,MAAM;AACV,QAAA,IAAI,EAAE,MAAM;AACZ,QAAA,KAAK,EAAE,UAAU;QACjB,KAAK,EAAE,MAAM,CAAC,MAAM;AACpB,QAAA,cAAc,EAAE,MAAM;AACtB,QAAA,MAAM,EAAE,IAAI;AACZ,QAAA,IAAI,EAAE,IAAI;AACV,QAAA,GAAG,EAAE,QAAQ;AACd,KAAA;AACD,IAAA;AACE,QAAA,EAAE,EAAE,OAAO;AACX,QAAA,IAAI,EAAE,OAAO;AACb,QAAA,KAAK,EAAE,WAAW;QAClB,KAAK,EAAE,MAAM,CAAC,MAAM;AACpB,QAAA,cAAc,EAAE,aAAa;AAC7B,QAAA,MAAM,EAAE,IAAI;AACZ,QAAA,IAAI,EAAE,IAAI;AACV,QAAA,GAAG,EAAE,SAAS;AACf,KAAA;AACD,IAAA;AACE,QAAA,EAAE,EAAE,UAAU;AACd,QAAA,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,QAAQ;AACf,QAAA,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,cAAc,EAAE,MAAM;AACtB,QAAA,MAAM,EAAE,IAAI;AACZ,QAAA,IAAI,EAAE,IAAI;AACV,QAAA,GAAG,EAAE,YAAY;AAClB,KAAA;;;;;"}

package/dist/src/workflow/steps/build.d.ts

@@ -1,3 +1,3 @@
-import type { WorkflowStepRunner } from '../types.js';
+import type { WorkflowStepRunner } from "../types.js";
 export declare const buildStep: WorkflowStepRunner;
 //# sourceMappingURL=build.d.ts.map

package/dist/src/workflow/steps/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../../src/workflow/steps/build.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAItD,eAAO,MAAM,SAAS,EAAE,kBAiHvB,CAAC"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../../src/workflow/steps/build.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,eAAO,MAAM,SAAS,EAAE,kBA+HvB,CAAC"}

package/dist/src/workflow/steps/build.js

@@ -1,25 +1,31 @@
 import { query } from '@anthropic-ai/claude-agent-sdk';
+import { POSTHOG_NOTIFICATIONS } from '../../acp-extensions.js';
 import { EXECUTION_SYSTEM_PROMPT } from '../../agents/execution.js';
-import { PermissionMode } from '../../types.js';
 import { TodoManager } from '../../todo-manager.js';
+import { PermissionMode } from '../../types.js';
 
 const buildStep = async ({ step, context }) => {
-    const { task, cwd, options, logger, promptBuilder, adapter, mcpServers, gitManager, emitEvent, } = context;
-    const stepLogger = logger.child('BuildStep');
+    const { task, cwd, options, logger, promptBuilder, sessionId, mcpServers, gitManager, sendNotification, } = context;
+    const stepLogger = logger.child("BuildStep");
     const latestRun = task.latest_run;
-    const prExists = latestRun?.output && typeof latestRun.output === 'object'
+    const prExists = latestRun?.output && typeof latestRun.output === "object"
         ? latestRun.output.pr_url
         : null;
     if (prExists) {
-        stepLogger.info('PR already exists, skipping build phase', { taskId: task.id });
-        return { status: 'skipped' };
+        stepLogger.info("PR already exists, skipping build phase", {
+            taskId: task.id,
+        });
+        return { status: "skipped" };
     }
-    stepLogger.info('Starting build phase', { taskId: task.id });
-    emitEvent(adapter.createStatusEvent('phase_start', { phase: 'build' }));
+    stepLogger.info("Starting build phase", { taskId: task.id });
+    await sendNotification(POSTHOG_NOTIFICATIONS.PHASE_START, {
+        sessionId,
+        phase: "build",
+    });
     const executionPrompt = await promptBuilder.buildExecutionPrompt(task, cwd);
     const fullPrompt = `${EXECUTION_SYSTEM_PROMPT}\n\n${executionPrompt}`;
     const configuredPermissionMode = options.permissionMode ??
-        (typeof step.permissionMode === 'string'
+        (typeof step.permissionMode === "string"
             ? step.permissionMode
             : step.permissionMode) ??
         PermissionMode.ACCEPT_EDITS;
@@ -27,25 +33,25 @@ const buildStep = async ({ step, context }) => {
         model: step.model,
         cwd,
         permissionMode: configuredPermissionMode,
-        settingSources: ['local'],
+        settingSources: ["local"],
         mcpServers,
         // Allow all tools for build phase - full read/write access needed for implementation
         allowedTools: [
-            'Task',
-            'Bash',
-            'BashOutput',
-            'KillBash',
-            'Edit',
-            'Read',
-            'Write',
-            'Glob',
-            'Grep',
-            'NotebookEdit',
-            'WebFetch',
-            'WebSearch',
-            'ListMcpResources',
-            'ReadMcpResource',
-            'TodoWrite',
+            "Task",
+            "Bash",
+            "BashOutput",
+            "KillBash",
+            "Edit",
+            "Read",
+            "Write",
+            "Glob",
+            "Grep",
+            "NotebookEdit",
+            "WebFetch",
+            "WebSearch",
+            "ListMcpResources",
+            "ReadMcpResource",
+            "TodoWrite",
         ],
     };
     // Add fine-grained permission hook if provided
@@ -60,17 +66,22 @@ const buildStep = async ({ step, context }) => {
     const commitTracker = await gitManager.trackCommitsDuring();
     // Track todos from TodoWrite tool calls
     const todoManager = new TodoManager(context.fileManager, stepLogger);
-    for await (const message of response) {
-        emitEvent(adapter.createRawSDKEvent(message));
-        const transformedEvents = adapter.transform(message);
-        for (const event of transformedEvents) {
-            emitEvent(event);
-        }
-        const todoList = await todoManager.checkAndPersistFromMessage(message, task.id);
-        if (todoList) {
-            emitEvent(adapter.createArtifactEvent('todos', todoList));
+    try {
+        for await (const message of response) {
+            const todoList = await todoManager.checkAndPersistFromMessage(message, task.id);
+            if (todoList) {
+                await sendNotification(POSTHOG_NOTIFICATIONS.ARTIFACT, {
+                    sessionId,
+                    kind: "todos",
+                    content: todoList,
+                });
+            }
         }
     }
+    catch (error) {
+        stepLogger.error("Error during build step query", error);
+        throw error;
+    }
     // Finalize: commit any remaining changes and optionally push
     const { commitCreated, pushedBranch } = await commitTracker.finalize({
         commitMessage: `Implementation for ${task.title}`,
@@ -78,16 +89,19 @@ const buildStep = async ({ step, context }) => {
     });
     context.stepResults[step.id] = { commitCreated };
     if (!commitCreated) {
-        stepLogger.warn('No changes to commit in build phase', { taskId: task.id });
+        stepLogger.warn("No changes to commit in build phase", { taskId: task.id });
     }
     else {
-        stepLogger.info('Build commits finalized', {
+        stepLogger.info("Build commits finalized", {
             taskId: task.id,
-            pushedBranch
+            pushedBranch,
         });
     }
-    emitEvent(adapter.createStatusEvent('phase_complete', { phase: 'build' }));
-    return { status: 'completed' };
+    await sendNotification(POSTHOG_NOTIFICATIONS.PHASE_COMPLETE, {
+        sessionId,
+        phase: "build",
+    });
+    return { status: "completed" };
 };
 
 export { buildStep };

package/dist/src/workflow/steps/build.js.map

@@ -1 +1 @@
-{"version":3,"file":"build.js","sources":["../../../../src/workflow/steps/build.ts"],"sourcesContent":["import { query } from '@anthropic-ai/claude-agent-sdk';\nimport { EXECUTION_SYSTEM_PROMPT } from '../../agents/execution.js';\nimport { PermissionMode } from '../../types.js';\nimport type { WorkflowStepRunner } from '../types.js';\nimport { finalizeStepGitActions } from '../utils.js';\nimport { TodoManager } from '../../todo-manager.js';\n\nexport const buildStep: WorkflowStepRunner = async ({ step, context }) => {\n    const {\n        task,\n        cwd,\n        options,\n        logger,\n        promptBuilder,\n        adapter,\n        mcpServers,\n        gitManager,\n        emitEvent,\n    } = context;\n\n    const stepLogger = logger.child('BuildStep');\n\n    const latestRun = task.latest_run;\n    const prExists =\n        latestRun?.output && typeof latestRun.output === 'object'\n            ? (latestRun.output as any).pr_url\n            : null;\n\n    if (prExists) {\n        stepLogger.info('PR already exists, skipping build phase', { taskId: task.id });\n        return { status: 'skipped' };\n    }\n\n    stepLogger.info('Starting build phase', { taskId: task.id });\n    emitEvent(adapter.createStatusEvent('phase_start', { phase: 'build' }));\n\n    const executionPrompt = await promptBuilder.buildExecutionPrompt(task, cwd);\n    const fullPrompt = `${EXECUTION_SYSTEM_PROMPT}\\n\\n${executionPrompt}`;\n\n    const configuredPermissionMode =\n        options.permissionMode ??\n        (typeof step.permissionMode === 'string'\n            ? (step.permissionMode as PermissionMode)\n            : step.permissionMode) ??\n        PermissionMode.ACCEPT_EDITS;\n\n    const baseOptions: Record<string, any> = {\n        model: step.model,\n        cwd,\n        permissionMode: configuredPermissionMode,\n        settingSources: ['local'],\n        mcpServers,\n        // Allow all tools for build phase - full read/write access needed for implementation\n        allowedTools: [\n            'Task',\n            'Bash',\n            'BashOutput',\n            'KillBash',\n            'Edit',\n            'Read',\n            'Write',\n            'Glob',\n            'Grep',\n            'NotebookEdit',\n            'WebFetch',\n            'WebSearch',\n            'ListMcpResources',\n            'ReadMcpResource',\n            'TodoWrite',\n        ],\n    };\n\n    // Add fine-grained permission hook if provided\n    if (options.canUseTool) {\n        baseOptions.canUseTool = options.canUseTool;\n    }\n\n    const response = query({\n        prompt: fullPrompt,\n        options: { ...baseOptions, ...(options.queryOverrides || {}) },\n    });\n\n    // Track commits made during Claude Code execution\n    const commitTracker = await gitManager.trackCommitsDuring();\n\n    // Track todos from TodoWrite tool calls\n    const todoManager = new TodoManager(context.fileManager, stepLogger);\n\n    for await (const message of response) {\n        emitEvent(adapter.createRawSDKEvent(message));\n        const transformedEvents = adapter.transform(message);\n        for (const event of transformedEvents) {\n            emitEvent(event);\n        }\n\n        const todoList = await todoManager.checkAndPersistFromMessage(message, task.id);\n        if (todoList) {\n            emitEvent(adapter.createArtifactEvent('todos', todoList));\n        }\n    }\n\n    // Finalize: commit any remaining changes and optionally push\n    const { commitCreated, pushedBranch } = await commitTracker.finalize({\n        commitMessage: `Implementation for ${task.title}`,\n        push: step.push,\n    });\n\n    context.stepResults[step.id] = { commitCreated };\n\n    if (!commitCreated) {\n        stepLogger.warn('No changes to commit in build phase', { taskId: task.id });\n    } else {\n        stepLogger.info('Build commits finalized', {\n            taskId: task.id,\n            pushedBranch\n        });\n    }\n\n    emitEvent(adapter.createStatusEvent('phase_complete', { phase: 'build' }));\n    return { status: 'completed' };\n};\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"build.js","sources":["../../../../src/workflow/steps/build.ts"],"sourcesContent":["import { query } from \"@anthropic-ai/claude-agent-sdk\";\nimport { POSTHOG_NOTIFICATIONS } from \"../../acp-extensions.js\";\nimport { EXECUTION_SYSTEM_PROMPT } from \"../../agents/execution.js\";\nimport { TodoManager } from \"../../todo-manager.js\";\nimport { PermissionMode } from \"../../types.js\";\nimport type { WorkflowStepRunner } from \"../types.js\";\n\nexport const buildStep: WorkflowStepRunner = async ({ step, context }) => {\n  const {\n    task,\n    cwd,\n    options,\n    logger,\n    promptBuilder,\n    sessionId,\n    mcpServers,\n    gitManager,\n    sendNotification,\n  } = context;\n\n  const stepLogger = logger.child(\"BuildStep\");\n\n  const latestRun = task.latest_run;\n  const prExists =\n    latestRun?.output && typeof latestRun.output === \"object\"\n      ? (latestRun.output as Record<string, unknown>).pr_url\n      : null;\n\n  if (prExists) {\n    stepLogger.info(\"PR already exists, skipping build phase\", {\n      taskId: task.id,\n    });\n    return { status: \"skipped\" };\n  }\n\n  stepLogger.info(\"Starting build phase\", { taskId: task.id });\n  await sendNotification(POSTHOG_NOTIFICATIONS.PHASE_START, {\n    sessionId,\n    phase: \"build\",\n  });\n\n  const executionPrompt = await promptBuilder.buildExecutionPrompt(task, cwd);\n  const fullPrompt = `${EXECUTION_SYSTEM_PROMPT}\\n\\n${executionPrompt}`;\n\n  const configuredPermissionMode =\n    options.permissionMode ??\n    (typeof step.permissionMode === \"string\"\n      ? (step.permissionMode as PermissionMode)\n      : step.permissionMode) ??\n    PermissionMode.ACCEPT_EDITS;\n\n  const baseOptions: Record<string, unknown> = {\n    model: step.model,\n    cwd,\n    permissionMode: configuredPermissionMode,\n    settingSources: [\"local\"],\n    mcpServers,\n    // Allow all tools for build phase - full read/write access needed for implementation\n    allowedTools: [\n      \"Task\",\n      \"Bash\",\n      \"BashOutput\",\n      \"KillBash\",\n      \"Edit\",\n      \"Read\",\n      \"Write\",\n      \"Glob\",\n      \"Grep\",\n      \"NotebookEdit\",\n      \"WebFetch\",\n      \"WebSearch\",\n      \"ListMcpResources\",\n      \"ReadMcpResource\",\n      \"TodoWrite\",\n    ],\n  };\n\n  // Add fine-grained permission hook if provided\n  if (options.canUseTool) {\n    baseOptions.canUseTool = options.canUseTool;\n  }\n\n  const response = query({\n    prompt: fullPrompt,\n    options: { ...baseOptions, ...(options.queryOverrides || {}) },\n  });\n\n  // Track commits made during Claude Code execution\n  const commitTracker = await gitManager.trackCommitsDuring();\n\n  // Track todos from TodoWrite tool calls\n  const todoManager = new TodoManager(context.fileManager, stepLogger);\n\n  try {\n    for await (const message of response) {\n      const todoList = await todoManager.checkAndPersistFromMessage(\n        message,\n        task.id,\n      );\n      if (todoList) {\n        await sendNotification(POSTHOG_NOTIFICATIONS.ARTIFACT, {\n          sessionId,\n          kind: \"todos\",\n          content: todoList,\n        });\n      }\n    }\n  } catch (error) {\n    stepLogger.error(\"Error during build step query\", error);\n    throw error;\n  }\n\n  // Finalize: commit any remaining changes and optionally push\n  const { commitCreated, pushedBranch } = await commitTracker.finalize({\n    commitMessage: `Implementation for ${task.title}`,\n    push: step.push,\n  });\n\n  context.stepResults[step.id] = { commitCreated };\n\n  if (!commitCreated) {\n    stepLogger.warn(\"No changes to commit in build phase\", { taskId: task.id });\n  } else {\n    stepLogger.info(\"Build commits finalized\", {\n      taskId: task.id,\n      pushedBranch,\n    });\n  }\n\n  await sendNotification(POSTHOG_NOTIFICATIONS.PHASE_COMPLETE, {\n    sessionId,\n    phase: \"build\",\n  });\n  return { status: \"completed\" };\n};\n"],"names":[],"mappings":"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"}

package/dist/src/workflow/steps/finalize.d.ts

@@ -1,3 +1,3 @@
-import type { WorkflowStepRunner } from '../types.js';
+import type { WorkflowStepRunner } from "../types.js";
 export declare const finalizeStep: WorkflowStepRunner;
 //# sourceMappingURL=finalize.d.ts.map

package/dist/src/workflow/steps/finalize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"finalize.d.ts","sourceRoot":"","sources":["../../../../src/workflow/steps/finalize.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAKtD,eAAO,MAAM,YAAY,EAAE,kBA0D1B,CAAC"}
+{"version":3,"file":"finalize.d.ts","sourceRoot":"","sources":["../../../../src/workflow/steps/finalize.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAKtD,eAAO,MAAM,YAAY,EAAE,kBAuD1B,CAAC"}