@posthog/agent 1.13.0 → 1.15.0

package/dist/src/prompt-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-builder.js","sources":["../../src/prompt-builder.ts"],"sourcesContent":["import type { Task, UrlMention, PostHogResource } from './types.js';\nimport type { TemplateVariables } from './template-manager.js';\nimport { Logger } from './utils/logger.js';\nimport { promises as fs } from 'fs';\nimport { join } from 'path';\n\nexport interface PromptBuilderDeps {\n  getTaskFiles: (taskId: string) => Promise<any[]>;\n  generatePlanTemplate: (vars: TemplateVariables) => Promise<string>;\n  posthogClient?: { fetchResourceByUrl: (mention: UrlMention) => Promise<PostHogResource> };\n  logger?: Logger;\n}\n\nexport class PromptBuilder {\n  private getTaskFiles: PromptBuilderDeps['getTaskFiles'];\n  private generatePlanTemplate: PromptBuilderDeps['generatePlanTemplate'];\n  private posthogClient?: PromptBuilderDeps['posthogClient'];\n  private logger: Logger;\n\n  constructor(deps: PromptBuilderDeps) {\n    this.getTaskFiles = deps.getTaskFiles;\n    this.generatePlanTemplate = deps.generatePlanTemplate;\n    this.posthogClient = deps.posthogClient;\n    this.logger = deps.logger || new Logger({ debug: false, prefix: '[PromptBuilder]' });\n  }\n\n  /**\n   * Extract file paths from XML tags in description\n   * Format: <file path=\"relative/path.ts\" />\n   */\n  private extractFilePaths(description: string): string[] {\n    const fileTagRegex = /<file\\s+path=\"([^\"]+)\"\\s*\\/>/g;\n    const paths: string[] = [];\n    let match: RegExpExecArray | null;\n\n    while ((match = fileTagRegex.exec(description)) !== null) {\n      paths.push(match[1]);\n    }\n\n    return paths;\n  }\n\n  /**\n   * Read file contents from repository\n   */\n  private async readFileContent(repositoryPath: string, filePath: string): Promise<string | null> {\n    try {\n      const fullPath = join(repositoryPath, filePath);\n      const content = await fs.readFile(fullPath, 'utf8');\n      return content;\n    } catch (error) {\n      this.logger.warn(`Failed to read referenced file: ${filePath}`, { error });\n      return null;\n    }\n  }\n\n  /**\n   * Extract URL mentions from XML tags in description\n   * Formats: <error id=\"...\" />, <experiment id=\"...\" />, <url href=\"...\" />\n   */\n  private extractUrlMentions(description: string): UrlMention[] {\n    const mentions: UrlMention[] = [];\n    \n    // PostHog resource mentions: <error id=\"...\" />, <experiment id=\"...\" />, etc.\n    const resourceRegex = /<(error|experiment|insight|feature_flag)\\s+id=\"([^\"]+)\"\\s*\\/>/g;\n    let match: RegExpExecArray | null;\n\n    while ((match = resourceRegex.exec(description)) !== null) {\n      const [, type, id] = match;\n      mentions.push({\n        url: '', // Will be reconstructed if needed\n        type: type as any,\n        id,\n        label: this.generateUrlLabel('', type as any),\n      });\n    }\n\n    // Generic URL mentions: <url href=\"...\" />\n    const urlRegex = /<url\\s+href=\"([^\"]+)\"\\s*\\/>/g;\n    while ((match = urlRegex.exec(description)) !== null) {\n      const [, url] = match;\n      mentions.push({\n        url,\n        type: 'generic',\n        label: this.generateUrlLabel(url, 'generic'),\n      });\n    }\n\n    return mentions;\n  }\n\n  /**\n   * Generate a display label for a URL mention\n   */\n  private generateUrlLabel(url: string, type: string): string {\n    try {\n      const urlObj = new URL(url);\n      switch (type) {\n        case 'error':\n          const errorMatch = url.match(/error_tracking\\/([a-f0-9-]+)/);\n          return errorMatch ? `Error ${errorMatch[1].slice(0, 8)}...` : 'Error';\n        case 'experiment':\n          const expMatch = url.match(/experiments\\/(\\d+)/);\n          return expMatch ? `Experiment #${expMatch[1]}` : 'Experiment';\n        case 'insight':\n          return 'Insight';\n        case 'feature_flag':\n          return 'Feature Flag';\n        default:\n          return urlObj.hostname;\n      }\n    } catch {\n      return 'URL';\n    }\n  }\n\n  /**\n   * Process URL references and fetch their content\n   */\n  private async processUrlReferences(\n    description: string\n  ): Promise<{ description: string; referencedResources: PostHogResource[] }> {\n    const urlMentions = this.extractUrlMentions(description);\n    const referencedResources: PostHogResource[] = [];\n\n    if (urlMentions.length === 0 || !this.posthogClient) {\n      return { description, referencedResources };\n    }\n\n    // Fetch all referenced resources\n    for (const mention of urlMentions) {\n      try {\n        const resource = await this.posthogClient.fetchResourceByUrl(mention);\n        referencedResources.push(resource);\n      } catch (error) {\n        this.logger.warn(`Failed to fetch resource from URL: ${mention.url}`, { error });\n        // Add a placeholder resource for failed fetches\n        referencedResources.push({\n          type: mention.type,\n          id: mention.id || '',\n          url: mention.url,\n          title: mention.label || 'Unknown Resource',\n          content: `Failed to fetch resource from ${mention.url}: ${error}`,\n          metadata: {},\n        });\n      }\n    }\n\n    // Replace URL tags with just the label for readability\n    let processedDescription = description;\n    for (const mention of urlMentions) {\n      if (mention.type === 'generic') {\n        // Generic URLs: <url href=\"...\" />\n        const escapedUrl = mention.url.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n        processedDescription = processedDescription.replace(\n          new RegExp(`<url\\\\s+href=\"${escapedUrl}\"\\\\s*/>`, 'g'),\n          `@${mention.label}`\n        );\n      } else {\n        // PostHog resources: <error id=\"...\" />, <experiment id=\"...\" />, etc.\n        const escapedType = mention.type.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n        const escapedId = mention.id ? mention.id.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&') : '';\n        processedDescription = processedDescription.replace(\n          new RegExp(`<${escapedType}\\\\s+id=\"${escapedId}\"\\\\s*/>`, 'g'),\n          `@${mention.label}`\n        );\n      }\n    }\n\n    return { description: processedDescription, referencedResources };\n  }\n\n  /**\n   * Process description to extract file tags and read contents\n   * Returns processed description and referenced file contents\n   */\n  private async processFileReferences(\n    description: string,\n    repositoryPath?: string\n  ): Promise<{ description: string; referencedFiles: Array<{ path: string; content: string }> }> {\n    const filePaths = this.extractFilePaths(description);\n    const referencedFiles: Array<{ path: string; content: string }> = [];\n\n    if (filePaths.length === 0 || !repositoryPath) {\n      return { description, referencedFiles };\n    }\n\n    // Read all referenced files\n    for (const filePath of filePaths) {\n      const content = await this.readFileContent(repositoryPath, filePath);\n      if (content !== null) {\n        referencedFiles.push({ path: filePath, content });\n      }\n    }\n\n    // Replace file tags with just the filename for readability\n    let processedDescription = description;\n    for (const filePath of filePaths) {\n      const fileName = filePath.split('/').pop() || filePath;\n      processedDescription = processedDescription.replace(\n        new RegExp(`<file\\\\s+path=\"${filePath.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')}\"\\\\s*/>`, 'g'),\n        `@${fileName}`\n      );\n    }\n\n    return { description: processedDescription, referencedFiles };\n  }\n\n  async buildResearchPrompt(task: Task, repositoryPath?: string): Promise<string> {\n    // Process file references in description\n    const { description: descriptionAfterFiles, referencedFiles } = await this.processFileReferences(\n      task.description,\n      repositoryPath\n    );\n\n    // Process URL references in description  \n    const { description: processedDescription, referencedResources } = await this.processUrlReferences(\n      descriptionAfterFiles\n    );\n\n    let prompt = '';\n    prompt += `## Current Task\\n\\n**Task**: ${task.title}\\n**Description**: ${processedDescription}`;\n\n    if ((task as any).primary_repository) {\n      prompt += `\\n**Repository**: ${(task as any).primary_repository}`;\n    }\n\n    // Add referenced files from @ mentions\n    if (referencedFiles.length > 0) {\n      prompt += `\\n\\n## Referenced Files\\n\\n`;\n      for (const file of referencedFiles) {\n        prompt += `### ${file.path}\\n\\`\\`\\`\\n${file.content}\\n\\`\\`\\`\\n\\n`;\n      }\n    }\n\n    // Add referenced resources from URL mentions\n    if (referencedResources.length > 0) {\n      prompt += `\\n\\n## Referenced Resources\\n\\n`;\n      for (const resource of referencedResources) {\n        prompt += `### ${resource.title} (${resource.type})\\n**URL**: ${resource.url}\\n\\n${resource.content}\\n\\n`;\n      }\n    }\n\n    try {\n      const taskFiles = await this.getTaskFiles(task.id);\n      const contextFiles = taskFiles.filter((f: any) => f.type === 'context' || f.type === 'reference');\n      if (contextFiles.length > 0) {\n        prompt += `\\n\\n## Supporting Files`;\n        for (const file of contextFiles) {\n          prompt += `\\n\\n### ${file.name} (${file.type})\\n${file.content}`;\n        }\n      }\n    } catch (error) {\n      this.logger.debug('No existing task files found for research', { taskId: task.id });\n    }\n\n    return prompt;\n  }\n\n  async buildPlanningPrompt(task: Task, repositoryPath?: string): Promise<string> {\n    // Process file references in description\n    const { description: descriptionAfterFiles, referencedFiles } = await this.processFileReferences(\n      task.description,\n      repositoryPath\n    );\n\n    // Process URL references in description  \n    const { description: processedDescription, referencedResources } = await this.processUrlReferences(\n      descriptionAfterFiles\n    );\n\n    let prompt = '';\n    prompt += `## Current Task\\n\\n**Task**: ${task.title}\\n**Description**: ${processedDescription}`;\n\n    if ((task as any).primary_repository) {\n      prompt += `\\n**Repository**: ${(task as any).primary_repository}`;\n    }\n\n    // Add referenced files from @ mentions\n    if (referencedFiles.length > 0) {\n      prompt += `\\n\\n## Referenced Files\\n\\n`;\n      for (const file of referencedFiles) {\n        prompt += `### ${file.path}\\n\\`\\`\\`\\n${file.content}\\n\\`\\`\\`\\n\\n`;\n      }\n    }\n\n    // Add referenced resources from URL mentions\n    if (referencedResources.length > 0) {\n      prompt += `\\n\\n## Referenced Resources\\n\\n`;\n      for (const resource of referencedResources) {\n        prompt += `### ${resource.title} (${resource.type})\\n**URL**: ${resource.url}\\n\\n${resource.content}\\n\\n`;\n      }\n    }\n\n    try {\n      const taskFiles = await this.getTaskFiles(task.id);\n      const contextFiles = taskFiles.filter((f: any) => f.type === 'context' || f.type === 'reference');\n      if (contextFiles.length > 0) {\n        prompt += `\\n\\n## Supporting Files`;\n        for (const file of contextFiles) {\n          prompt += `\\n\\n### ${file.name} (${file.type})\\n${file.content}`;\n        }\n      }\n    } catch (error) {\n      this.logger.debug('No existing task files found for planning', { taskId: task.id });\n    }\n\n    const templateVariables = {\n      task_id: task.id,\n      task_title: task.title,\n      task_description: processedDescription,\n      date: new Date().toISOString().split('T')[0],\n      repository: ((task as any).primary_repository || '') as string,\n    };\n\n    const planTemplate = await this.generatePlanTemplate(templateVariables);\n\n    prompt += `\\n\\nPlease analyze the codebase and create a detailed implementation plan for this task. Use the following template structure for your plan:\\n\\n${planTemplate}\\n\\nFill in each section with specific, actionable information based on your analysis. Replace all placeholder content with actual details about this task.`;\n\n    return prompt;\n  }\n\n  async buildExecutionPrompt(task: Task, repositoryPath?: string): Promise<string> {\n    // Process file references in description\n    const { description: descriptionAfterFiles, referencedFiles } = await this.processFileReferences(\n      task.description,\n      repositoryPath\n    );\n\n    // Process URL references in description  \n    const { description: processedDescription, referencedResources } = await this.processUrlReferences(\n      descriptionAfterFiles\n    );\n\n    let prompt = '';\n    prompt += `## Current Task\\n\\n**Task**: ${task.title}\\n**Description**: ${processedDescription}`;\n\n    if ((task as any).primary_repository) {\n      prompt += `\\n**Repository**: ${(task as any).primary_repository}`;\n    }\n\n    // Add referenced files from @ mentions\n    if (referencedFiles.length > 0) {\n      prompt += `\\n\\n## Referenced Files\\n\\n`;\n      for (const file of referencedFiles) {\n        prompt += `### ${file.path}\\n\\`\\`\\`\\n${file.content}\\n\\`\\`\\`\\n\\n`;\n      }\n    }\n\n    // Add referenced resources from URL mentions\n    if (referencedResources.length > 0) {\n      prompt += `\\n\\n## Referenced Resources\\n\\n`;\n      for (const resource of referencedResources) {\n        prompt += `### ${resource.title} (${resource.type})\\n**URL**: ${resource.url}\\n\\n${resource.content}\\n\\n`;\n      }\n    }\n\n    try {\n      const taskFiles = await this.getTaskFiles(task.id);\n      const hasPlan = taskFiles.some((f: any) => f.type === 'plan');\n      if (taskFiles.length > 0) {\n        prompt += `\\n\\n## Context and Supporting Information`;\n        for (const file of taskFiles) {\n          if (file.type === 'plan') {\n            prompt += `\\n\\n### Execution Plan\\n${file.content}`;\n          } else {\n            prompt += `\\n\\n### ${file.name} (${file.type})\\n${file.content}`;\n          }\n        }\n      }\n      if (hasPlan) {\n        prompt += `\\n\\nPlease implement the changes described in the execution plan above. Follow the plan step-by-step and make the necessary file modifications. You must actually edit files and make changes - do not just analyze or review.`;\n      } else {\n        prompt += `\\n\\nPlease implement the changes described in the task above. You must actually edit files and make changes - do not just analyze or review.`;\n      }\n    } catch (error) {\n      this.logger.debug('No supporting files found for execution', { taskId: task.id });\n      prompt += `\\n\\nPlease implement the changes described in the task above.`;\n    }\n    return prompt;\n  }\n}\n\n\n"],"names":["fs"],"mappings":"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"}
+{"version":3,"file":"prompt-builder.js","sources":["../../src/prompt-builder.ts"],"sourcesContent":["import type { Task, UrlMention, PostHogResource } from './types.js';\nimport type { TemplateVariables } from './template-manager.js';\nimport { Logger } from './utils/logger.js';\nimport { promises as fs } from 'fs';\nimport { join } from 'path';\n\nexport interface PromptBuilderDeps {\n  getTaskFiles: (taskId: string) => Promise<any[]>;\n  generatePlanTemplate: (vars: TemplateVariables) => Promise<string>;\n  posthogClient?: { fetchResourceByUrl: (mention: UrlMention) => Promise<PostHogResource> };\n  logger?: Logger;\n}\n\nexport class PromptBuilder {\n  private getTaskFiles: PromptBuilderDeps['getTaskFiles'];\n  private generatePlanTemplate: PromptBuilderDeps['generatePlanTemplate'];\n  private posthogClient?: PromptBuilderDeps['posthogClient'];\n  private logger: Logger;\n\n  constructor(deps: PromptBuilderDeps) {\n    this.getTaskFiles = deps.getTaskFiles;\n    this.generatePlanTemplate = deps.generatePlanTemplate;\n    this.posthogClient = deps.posthogClient;\n    this.logger = deps.logger || new Logger({ debug: false, prefix: '[PromptBuilder]' });\n  }\n\n  /**\n   * Extract file paths from XML tags in description\n   * Format: <file path=\"relative/path.ts\" />\n   */\n  private extractFilePaths(description: string): string[] {\n    const fileTagRegex = /<file\\s+path=\"([^\"]+)\"\\s*\\/>/g;\n    const paths: string[] = [];\n    let match: RegExpExecArray | null;\n\n    while ((match = fileTagRegex.exec(description)) !== null) {\n      paths.push(match[1]);\n    }\n\n    return paths;\n  }\n\n  /**\n   * Read file contents from repository\n   */\n  private async readFileContent(repositoryPath: string, filePath: string): Promise<string | null> {\n    try {\n      const fullPath = join(repositoryPath, filePath);\n      const content = await fs.readFile(fullPath, 'utf8');\n      return content;\n    } catch (error) {\n      this.logger.warn(`Failed to read referenced file: ${filePath}`, { error });\n      return null;\n    }\n  }\n\n  /**\n   * Extract URL mentions from XML tags in description\n   * Formats: <error id=\"...\" />, <experiment id=\"...\" />, <url href=\"...\" />\n   */\n  private extractUrlMentions(description: string): UrlMention[] {\n    const mentions: UrlMention[] = [];\n    \n    // PostHog resource mentions: <error id=\"...\" />, <experiment id=\"...\" />, etc.\n    const resourceRegex = /<(error|experiment|insight|feature_flag)\\s+id=\"([^\"]+)\"\\s*\\/>/g;\n    let match: RegExpExecArray | null;\n\n    while ((match = resourceRegex.exec(description)) !== null) {\n      const [, type, id] = match;\n      mentions.push({\n        url: '', // Will be reconstructed if needed\n        type: type as any,\n        id,\n        label: this.generateUrlLabel('', type as any),\n      });\n    }\n\n    // Generic URL mentions: <url href=\"...\" />\n    const urlRegex = /<url\\s+href=\"([^\"]+)\"\\s*\\/>/g;\n    while ((match = urlRegex.exec(description)) !== null) {\n      const [, url] = match;\n      mentions.push({\n        url,\n        type: 'generic',\n        label: this.generateUrlLabel(url, 'generic'),\n      });\n    }\n\n    return mentions;\n  }\n\n  /**\n   * Generate a display label for a URL mention\n   */\n  private generateUrlLabel(url: string, type: string): string {\n    try {\n      const urlObj = new URL(url);\n      switch (type) {\n        case 'error':\n          const errorMatch = url.match(/error_tracking\\/([a-f0-9-]+)/);\n          return errorMatch ? `Error ${errorMatch[1].slice(0, 8)}...` : 'Error';\n        case 'experiment':\n          const expMatch = url.match(/experiments\\/(\\d+)/);\n          return expMatch ? `Experiment #${expMatch[1]}` : 'Experiment';\n        case 'insight':\n          return 'Insight';\n        case 'feature_flag':\n          return 'Feature Flag';\n        default:\n          return urlObj.hostname;\n      }\n    } catch {\n      return 'URL';\n    }\n  }\n\n  /**\n   * Process URL references and fetch their content\n   */\n  private async processUrlReferences(\n    description: string\n  ): Promise<{ description: string; referencedResources: PostHogResource[] }> {\n    const urlMentions = this.extractUrlMentions(description);\n    const referencedResources: PostHogResource[] = [];\n\n    if (urlMentions.length === 0 || !this.posthogClient) {\n      return { description, referencedResources };\n    }\n\n    // Fetch all referenced resources\n    for (const mention of urlMentions) {\n      try {\n        const resource = await this.posthogClient.fetchResourceByUrl(mention);\n        referencedResources.push(resource);\n      } catch (error) {\n        this.logger.warn(`Failed to fetch resource from URL: ${mention.url}`, { error });\n        // Add a placeholder resource for failed fetches\n        referencedResources.push({\n          type: mention.type,\n          id: mention.id || '',\n          url: mention.url,\n          title: mention.label || 'Unknown Resource',\n          content: `Failed to fetch resource from ${mention.url}: ${error}`,\n          metadata: {},\n        });\n      }\n    }\n\n    // Replace URL tags with just the label for readability\n    let processedDescription = description;\n    for (const mention of urlMentions) {\n      if (mention.type === 'generic') {\n        // Generic URLs: <url href=\"...\" />\n        const escapedUrl = mention.url.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n        processedDescription = processedDescription.replace(\n          new RegExp(`<url\\\\s+href=\"${escapedUrl}\"\\\\s*/>`, 'g'),\n          `@${mention.label}`\n        );\n      } else {\n        // PostHog resources: <error id=\"...\" />, <experiment id=\"...\" />, etc.\n        const escapedType = mention.type.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n        const escapedId = mention.id ? mention.id.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&') : '';\n        processedDescription = processedDescription.replace(\n          new RegExp(`<${escapedType}\\\\s+id=\"${escapedId}\"\\\\s*/>`, 'g'),\n          `@${mention.label}`\n        );\n      }\n    }\n\n    return { description: processedDescription, referencedResources };\n  }\n\n  /**\n   * Process description to extract file tags and read contents\n   * Returns processed description and referenced file contents\n   */\n  private async processFileReferences(\n    description: string,\n    repositoryPath?: string\n  ): Promise<{ description: string; referencedFiles: Array<{ path: string; content: string }> }> {\n    const filePaths = this.extractFilePaths(description);\n    const referencedFiles: Array<{ path: string; content: string }> = [];\n\n    if (filePaths.length === 0 || !repositoryPath) {\n      return { description, referencedFiles };\n    }\n\n    // Read all referenced files\n    for (const filePath of filePaths) {\n      const content = await this.readFileContent(repositoryPath, filePath);\n      if (content !== null) {\n        referencedFiles.push({ path: filePath, content });\n      }\n    }\n\n    // Replace file tags with just the filename for readability\n    let processedDescription = description;\n    for (const filePath of filePaths) {\n      const fileName = filePath.split('/').pop() || filePath;\n      processedDescription = processedDescription.replace(\n        new RegExp(`<file\\\\s+path=\"${filePath.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')}\"\\\\s*/>`, 'g'),\n        `@${fileName}`\n      );\n    }\n\n    return { description: processedDescription, referencedFiles };\n  }\n\n  async buildResearchPrompt(task: Task, repositoryPath?: string): Promise<string> {\n    // Process file references in description\n    const { description: descriptionAfterFiles, referencedFiles } = await this.processFileReferences(\n      task.description,\n      repositoryPath\n    );\n\n    // Process URL references in description\n    const { description: processedDescription, referencedResources } = await this.processUrlReferences(\n      descriptionAfterFiles\n    );\n\n    let prompt = '<task>\\n';\n    prompt += `<title>${task.title}</title>\\n`;\n    prompt += `<description>${processedDescription}</description>\\n`;\n\n    if ((task as any).primary_repository) {\n      prompt += `<repository>${(task as any).primary_repository}</repository>\\n`;\n    }\n    prompt += '</task>\\n';\n\n    // Add referenced files from @ mentions\n    if (referencedFiles.length > 0) {\n      prompt += '\\n<referenced_files>\\n';\n      for (const file of referencedFiles) {\n        prompt += `<file path=\"${file.path}\">\\n\\`\\`\\`\\n${file.content}\\n\\`\\`\\`\\n</file>\\n`;\n      }\n      prompt += '</referenced_files>\\n';\n    }\n\n    // Add referenced resources from URL mentions\n    if (referencedResources.length > 0) {\n      prompt += '\\n<referenced_resources>\\n';\n      for (const resource of referencedResources) {\n        prompt += `<resource type=\"${resource.type}\" url=\"${resource.url}\">\\n`;\n        prompt += `<title>${resource.title}</title>\\n`;\n        prompt += `<content>${resource.content}</content>\\n`;\n        prompt += '</resource>\\n';\n      }\n      prompt += '</referenced_resources>\\n';\n    }\n\n    try {\n      const taskFiles = await this.getTaskFiles(task.id);\n      const contextFiles = taskFiles.filter((f: any) => f.type === 'context' || f.type === 'reference');\n      if (contextFiles.length > 0) {\n        prompt += '\\n<supporting_files>\\n';\n        for (const file of contextFiles) {\n          prompt += `<file name=\"${file.name}\" type=\"${file.type}\">\\n${file.content}\\n</file>\\n`;\n        }\n        prompt += '</supporting_files>\\n';\n      }\n    } catch (error) {\n      this.logger.debug('No existing task files found for research', { taskId: task.id });\n    }\n\n    return prompt;\n  }\n\n  async buildPlanningPrompt(task: Task, repositoryPath?: string): Promise<string> {\n    // Process file references in description\n    const { description: descriptionAfterFiles, referencedFiles } = await this.processFileReferences(\n      task.description,\n      repositoryPath\n    );\n\n    // Process URL references in description\n    const { description: processedDescription, referencedResources } = await this.processUrlReferences(\n      descriptionAfterFiles\n    );\n\n    let prompt = '<task>\\n';\n    prompt += `<title>${task.title}</title>\\n`;\n    prompt += `<description>${processedDescription}</description>\\n`;\n\n    if ((task as any).primary_repository) {\n      prompt += `<repository>${(task as any).primary_repository}</repository>\\n`;\n    }\n    prompt += '</task>\\n';\n\n    // Add referenced files from @ mentions\n    if (referencedFiles.length > 0) {\n      prompt += '\\n<referenced_files>\\n';\n      for (const file of referencedFiles) {\n        prompt += `<file path=\"${file.path}\">\\n\\`\\`\\`\\n${file.content}\\n\\`\\`\\`\\n</file>\\n`;\n      }\n      prompt += '</referenced_files>\\n';\n    }\n\n    // Add referenced resources from URL mentions\n    if (referencedResources.length > 0) {\n      prompt += '\\n<referenced_resources>\\n';\n      for (const resource of referencedResources) {\n        prompt += `<resource type=\"${resource.type}\" url=\"${resource.url}\">\\n`;\n        prompt += `<title>${resource.title}</title>\\n`;\n        prompt += `<content>${resource.content}</content>\\n`;\n        prompt += '</resource>\\n';\n      }\n      prompt += '</referenced_resources>\\n';\n    }\n\n    try {\n      const taskFiles = await this.getTaskFiles(task.id);\n      const contextFiles = taskFiles.filter((f: any) => f.type === 'context' || f.type === 'reference');\n      if (contextFiles.length > 0) {\n        prompt += '\\n<supporting_files>\\n';\n        for (const file of contextFiles) {\n          prompt += `<file name=\"${file.name}\" type=\"${file.type}\">\\n${file.content}\\n</file>\\n`;\n        }\n        prompt += '</supporting_files>\\n';\n      }\n    } catch (error) {\n      this.logger.debug('No existing task files found for planning', { taskId: task.id });\n    }\n\n    const templateVariables = {\n      task_id: task.id,\n      task_title: task.title,\n      task_description: processedDescription,\n      date: new Date().toISOString().split('T')[0],\n      repository: ((task as any).primary_repository || '') as string,\n    };\n\n    const planTemplate = await this.generatePlanTemplate(templateVariables);\n\n    prompt += '\\n<instructions>\\n';\n    prompt += 'Analyze the codebase and create a detailed implementation plan. Use the template structure below, filling each section with specific, actionable information.\\n';\n    prompt += '</instructions>\\n\\n';\n    prompt += '<plan_template>\\n';\n    prompt += planTemplate;\n    prompt += '\\n</plan_template>';\n\n    return prompt;\n  }\n\n  async buildExecutionPrompt(task: Task, repositoryPath?: string): Promise<string> {\n    // Process file references in description\n    const { description: descriptionAfterFiles, referencedFiles } = await this.processFileReferences(\n      task.description,\n      repositoryPath\n    );\n\n    // Process URL references in description\n    const { description: processedDescription, referencedResources } = await this.processUrlReferences(\n      descriptionAfterFiles\n    );\n\n    let prompt = '<task>\\n';\n    prompt += `<title>${task.title}</title>\\n`;\n    prompt += `<description>${processedDescription}</description>\\n`;\n\n    if ((task as any).primary_repository) {\n      prompt += `<repository>${(task as any).primary_repository}</repository>\\n`;\n    }\n    prompt += '</task>\\n';\n\n    // Add referenced files from @ mentions\n    if (referencedFiles.length > 0) {\n      prompt += '\\n<referenced_files>\\n';\n      for (const file of referencedFiles) {\n        prompt += `<file path=\"${file.path}\">\\n\\`\\`\\`\\n${file.content}\\n\\`\\`\\`\\n</file>\\n`;\n      }\n      prompt += '</referenced_files>\\n';\n    }\n\n    // Add referenced resources from URL mentions\n    if (referencedResources.length > 0) {\n      prompt += '\\n<referenced_resources>\\n';\n      for (const resource of referencedResources) {\n        prompt += `<resource type=\"${resource.type}\" url=\"${resource.url}\">\\n`;\n        prompt += `<title>${resource.title}</title>\\n`;\n        prompt += `<content>${resource.content}</content>\\n`;\n        prompt += '</resource>\\n';\n      }\n      prompt += '</referenced_resources>\\n';\n    }\n\n    try {\n      const taskFiles = await this.getTaskFiles(task.id);\n      const hasPlan = taskFiles.some((f: any) => f.type === 'plan');\n\n      if (taskFiles.length > 0) {\n        prompt += '\\n<context>\\n';\n        for (const file of taskFiles) {\n          if (file.type === 'plan') {\n            prompt += `<plan>\\n${file.content}\\n</plan>\\n`;\n          } else {\n            prompt += `<file name=\"${file.name}\" type=\"${file.type}\">\\n${file.content}\\n</file>\\n`;\n          }\n        }\n        prompt += '</context>\\n';\n      }\n\n      prompt += '\\n<instructions>\\n';\n      if (hasPlan) {\n        prompt += 'Implement the changes described in the execution plan. Follow the plan step-by-step and make the necessary file modifications.\\n';\n      } else {\n        prompt += 'Implement the changes described in the task. Make the necessary file modifications to complete the task.\\n';\n      }\n      prompt += '</instructions>';\n    } catch (error) {\n      this.logger.debug('No supporting files found for execution', { taskId: task.id });\n      prompt += '\\n<instructions>\\n';\n      prompt += 'Implement the changes described in the task.\\n';\n      prompt += '</instructions>';\n    }\n\n    return prompt;\n  }\n}\n\n\n"],"names":["fs"],"mappings":"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"}

package/dist/src/types.d.ts

@@ -1,3 +1,5 @@
+import type { CanUseTool, PermissionResult } from '@anthropic-ai/claude-agent-sdk/sdkTypes.js';
+export type { CanUseTool, PermissionResult };
 export interface Task {
     id: string;
     title: string;
@@ -56,6 +58,7 @@ export interface TaskExecutionOptions {
     isCloudMode?: boolean;
     autoProgress?: boolean;
     queryOverrides?: Record<string, any>;
+    canUseTool?: CanUseTool;
 }
 interface BaseEvent {
     ts: number;
@@ -233,6 +236,7 @@ export interface AgentConfig {
     posthogMcpUrl?: string;
     mcpServers?: Record<string, McpServerConfig>;
     debug?: boolean;
+    canUseTool?: CanUseTool;
 }
 export interface PostHogAPIConfig {
     apiUrl: string;
@@ -253,5 +257,4 @@ export interface UrlMention {
     id?: string;
     label?: string;
 }
-export {};
 //# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../../src/types.ts"],"sourcesContent":["// 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\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: LogEntry[]; // Array of log entry objects\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  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: 'plan' | 'context' | 'reference' | 'output';\n  created_at: 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  autoProgress?: boolean;\n  queryOverrides?: Record<string, any>;\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\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}\n\nexport interface PostHogAPIConfig {\n  apiUrl: string;\n  apiKey: string;\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}"],"names":[],"mappings":"IAoDY;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":["\n// import and export to keep a single type file\nimport type { CanUseTool, PermissionResult } from '@anthropic-ai/claude-agent-sdk/sdkTypes.js';\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\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: LogEntry[]; // Array of log entry objects\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  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: 'plan' | 'context' | 'reference' | 'output';\n  created_at: 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  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\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\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}\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}"],"names":[],"mappings":"IAyDY;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/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;AAGtD,eAAO,MAAM,SAAS,EAAE,kBAgFvB,CAAC"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../../src/workflow/steps/build.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGtD,eAAO,MAAM,SAAS,EAAE,kBAuGvB,CAAC"}

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

@@ -29,7 +29,29 @@ const buildStep = async ({ step, context }) => {
         permissionMode: configuredPermissionMode,
         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',
+        ],
     };
+    // Add fine-grained permission hook if provided
+    if (options.canUseTool) {
+        baseOptions.canUseTool = options.canUseTool;
+    }
     const response = query({
         prompt: fullPrompt,
         options: { ...baseOptions, ...(options.queryOverrides || {}) },

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';\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    };\n\n    const response = query({\n        prompt: fullPrompt,\n        options: { ...baseOptions, ...(options.queryOverrides || {}) },\n    });\n\n    for await (const message of response) {\n        emitEvent(adapter.createRawSDKEvent(message));\n        const transformed = adapter.transform(message);\n        if (transformed) {\n            emitEvent(transformed);\n        }\n    }\n\n    const hasChanges = await gitManager.hasChanges();\n    context.stepResults[step.id] = { commitCreated: false };\n    if (!hasChanges) {\n        stepLogger.warn('No changes to commit in build phase', { taskId: task.id });\n        emitEvent(adapter.createStatusEvent('phase_complete', { phase: 'build' }));\n        return { status: 'completed' };\n    }\n\n    await gitManager.addFiles(['.']);\n    const commitCreated = await finalizeStepGitActions(context, step, {\n        commitMessage: `Implementation for ${task.title}`,\n    });\n    context.stepResults[step.id] = { commitCreated };\n\n    if (!commitCreated) {\n        stepLogger.warn('No commit created during build step', { taskId: task.id });\n    }\n\n    emitEvent(adapter.createStatusEvent('phase_complete', { phase: 'build' }));\n    return { status: 'completed' };\n};\n"],"names":[],"mappings":";;;;;AAMO,MAAM,SAAS,GAAuB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAI;IACrE,MAAM,EACF,IAAI,EACJ,GAAG,EACH,OAAO,EACP,MAAM,EACN,aAAa,EACb,OAAO,EACP,UAAU,EACV,UAAU,EACV,SAAS,GACZ,GAAG,OAAO;IAEX,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC;AAE5C,IAAA,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU;IACjC,MAAM,QAAQ,GACV,SAAS,EAAE,MAAM,IAAI,OAAO,SAAS,CAAC,MAAM,KAAK;AAC7C,UAAG,SAAS,CAAC,MAAc,CAAC;UAC1B,IAAI;IAEd,IAAI,QAAQ,EAAE;AACV,QAAA,UAAU,CAAC,IAAI,CAAC,yCAAyC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;AAC/E,QAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE;IAChC;AAEA,IAAA,UAAU,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;AAC5D,IAAA,SAAS,CAAC,OAAO,CAAC,iBAAiB,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAEvE,MAAM,eAAe,GAAG,MAAM,aAAa,CAAC,oBAAoB,CAAC,IAAI,EAAE,GAAG,CAAC;AAC3E,IAAA,MAAM,UAAU,GAAG,CAAA,EAAG,uBAAuB,CAAA,IAAA,EAAO,eAAe,EAAE;AAErE,IAAA,MAAM,wBAAwB,GAC1B,OAAO,CAAC,cAAc;AACtB,SAAC,OAAO,IAAI,CAAC,cAAc,KAAK;cACzB,IAAI,CAAC;AACR,cAAE,IAAI,CAAC,cAAc,CAAC;QAC1B,cAAc,CAAC,YAAY;AAE/B,IAAA,MAAM,WAAW,GAAwB;QACrC,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG;AACH,QAAA,cAAc,EAAE,wBAAwB;QACxC,cAAc,EAAE,CAAC,OAAO,CAAC;QACzB,UAAU;KACb;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC;AACnB,QAAA,MAAM,EAAE,UAAU;AAClB,QAAA,OAAO,EAAE,EAAE,GAAG,WAAW,EAAE,IAAI,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC,EAAE;AACjE,KAAA,CAAC;AAEF,IAAA,WAAW,MAAM,OAAO,IAAI,QAAQ,EAAE;QAClC,SAAS,CAAC,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC;QAC9C,IAAI,WAAW,EAAE;YACb,SAAS,CAAC,WAAW,CAAC;QAC1B;IACJ;AAEA,IAAA,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE;AAChD,IAAA,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE;IACvD,IAAI,CAAC,UAAU,EAAE;AACb,QAAA,UAAU,CAAC,IAAI,CAAC,qCAAqC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;AAC3E,QAAA,SAAS,CAAC,OAAO,CAAC,iBAAiB,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AAC1E,QAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE;IAClC;IAEA,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,aAAa,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,IAAI,EAAE;AAC9D,QAAA,aAAa,EAAE,CAAA,mBAAA,EAAsB,IAAI,CAAC,KAAK,CAAA,CAAE;AACpD,KAAA,CAAC;IACF,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE;IAEhD,IAAI,CAAC,aAAa,EAAE;AAChB,QAAA,UAAU,CAAC,IAAI,CAAC,qCAAqC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;IAC/E;AAEA,IAAA,SAAS,CAAC,OAAO,CAAC,iBAAiB,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AAC1E,IAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE;AAClC;;;;"}
+{"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';\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    for await (const message of response) {\n        emitEvent(adapter.createRawSDKEvent(message));\n        const transformed = adapter.transform(message);\n        if (transformed) {\n            emitEvent(transformed);\n        }\n    }\n\n    const hasChanges = await gitManager.hasChanges();\n    context.stepResults[step.id] = { commitCreated: false };\n    if (!hasChanges) {\n        stepLogger.warn('No changes to commit in build phase', { taskId: task.id });\n        emitEvent(adapter.createStatusEvent('phase_complete', { phase: 'build' }));\n        return { status: 'completed' };\n    }\n\n    await gitManager.addFiles(['.']);\n    const commitCreated = await finalizeStepGitActions(context, step, {\n        commitMessage: `Implementation for ${task.title}`,\n    });\n    context.stepResults[step.id] = { commitCreated };\n\n    if (!commitCreated) {\n        stepLogger.warn('No commit created during build step', { taskId: task.id });\n    }\n\n    emitEvent(adapter.createStatusEvent('phase_complete', { phase: 'build' }));\n    return { status: 'completed' };\n};\n"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../../src/workflow/steps/plan.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGtD,eAAO,MAAM,QAAQ,EAAE,kBA0GtB,CAAC"}
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../../src/workflow/steps/plan.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGtD,eAAO,MAAM,QAAQ,EAAE,kBAuHtB,CAAC"}

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

@@ -46,6 +46,19 @@ const planStep = async ({ step, context }) => {
         permissionMode: 'plan',
         settingSources: ['local'],
         mcpServers,
+        // Allow research tools: read-only operations, web search, MCP resources, and ExitPlanMode
+        allowedTools: [
+            'Read',
+            'Glob',
+            'Grep',
+            'WebFetch',
+            'WebSearch',
+            'ListMcpResources',
+            'ReadMcpResource',
+            'ExitPlanMode',
+            'TodoWrite',
+            'BashOutput',
+        ],
     };
     const response = query({
         prompt: fullPrompt,

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

@@ -1 +1 @@
-{"version":3,"file":"plan.js","sources":["../../../../src/workflow/steps/plan.ts"],"sourcesContent":["import { query } from '@anthropic-ai/claude-agent-sdk';\nimport { PLANNING_SYSTEM_PROMPT } from '../../agents/planning.js';\nimport type { WorkflowStepRunner } from '../types.js';\nimport { finalizeStepGitActions } from '../utils.js';\n\nexport const planStep: WorkflowStepRunner = async ({ step, context }) => {\n    const {\n        task,\n        cwd,\n        isCloudMode,\n        options,\n        logger,\n        fileManager,\n        gitManager,\n        promptBuilder,\n        adapter,\n        mcpServers,\n        emitEvent,\n    } = context;\n\n    const stepLogger = logger.child('PlanStep');\n\n    const existingPlan = await fileManager.readPlan(task.id);\n    if (existingPlan) {\n        stepLogger.info('Plan already exists, skipping step', { taskId: task.id });\n        return { status: 'skipped' };\n    }\n\n    const questionsData = await fileManager.readQuestions(task.id);\n    if (!questionsData || !questionsData.answered) {\n        stepLogger.info('Waiting for answered research questions', { taskId: task.id });\n        emitEvent(adapter.createStatusEvent('phase_complete', { phase: 'research_questions' }));\n        return { status: 'skipped', halt: true };\n    }\n\n    stepLogger.info('Starting planning phase', { taskId: task.id });\n    emitEvent(adapter.createStatusEvent('phase_start', { phase: 'planning' }));\n\n    const researchContent = await fileManager.readResearch(task.id);\n    let researchContext = '';\n    if (researchContent) {\n        researchContext += `## Research Analysis\\n\\n${researchContent}\\n\\n`;\n    }\n\n    researchContext += `## Implementation Decisions\\n\\n`;\n    for (const question of questionsData.questions) {\n        const answer = questionsData.answers?.find(\n            (a: any) => a.questionId === question.id\n        );\n\n        researchContext += `### ${question.question}\\n\\n`;\n        if (answer) {\n            researchContext += `**Selected:** ${answer.selectedOption}\\n`;\n            if (answer.customInput) {\n                researchContext += `**Details:** ${answer.customInput}\\n`;\n            }\n        } else {\n            researchContext += `**Selected:** Not answered\\n`;\n        }\n        researchContext += `\\n`;\n    }\n\n    const planningPrompt = await promptBuilder.buildPlanningPrompt(task, cwd);\n    const fullPrompt = `${PLANNING_SYSTEM_PROMPT}\\n\\n${planningPrompt}\\n\\n${researchContext}`;\n\n    const baseOptions: Record<string, any> = {\n        model: step.model,\n        cwd,\n        permissionMode: 'plan',\n        settingSources: ['local'],\n        mcpServers,\n    };\n\n    const response = query({\n        prompt: fullPrompt,\n        options: { ...baseOptions, ...(options.queryOverrides || {}) },\n    });\n\n    let planContent = '';\n    for await (const message of response) {\n        emitEvent(adapter.createRawSDKEvent(message));\n        const transformed = adapter.transform(message);\n        if (transformed) {\n            emitEvent(transformed);\n        }\n        if (message.type === 'assistant' && message.message?.content) {\n            for (const c of message.message.content) {\n                if (c.type === 'text' && c.text) {\n                    planContent += `${c.text}\\n`;\n                }\n            }\n        }\n    }\n\n    if (planContent.trim()) {\n        await fileManager.writePlan(task.id, planContent.trim());\n        stepLogger.info('Plan completed', { taskId: task.id });\n    }\n\n    await gitManager.addAllPostHogFiles();\n    await finalizeStepGitActions(context, step, {\n        commitMessage: `Planning phase for ${task.title}`,\n    });\n\n    if (!isCloudMode) {\n        emitEvent(adapter.createStatusEvent('phase_complete', { phase: 'planning' }));\n        return { status: 'completed', halt: true };\n    }\n\n    emitEvent(adapter.createStatusEvent('phase_complete', { phase: 'planning' }));\n    return { status: 'completed' };\n};\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"plan.js","sources":["../../../../src/workflow/steps/plan.ts"],"sourcesContent":["import { query } from '@anthropic-ai/claude-agent-sdk';\nimport { PLANNING_SYSTEM_PROMPT } from '../../agents/planning.js';\nimport type { WorkflowStepRunner } from '../types.js';\nimport { finalizeStepGitActions } from '../utils.js';\n\nexport const planStep: WorkflowStepRunner = async ({ step, context }) => {\n    const {\n        task,\n        cwd,\n        isCloudMode,\n        options,\n        logger,\n        fileManager,\n        gitManager,\n        promptBuilder,\n        adapter,\n        mcpServers,\n        emitEvent,\n    } = context;\n\n    const stepLogger = logger.child('PlanStep');\n\n    const existingPlan = await fileManager.readPlan(task.id);\n    if (existingPlan) {\n        stepLogger.info('Plan already exists, skipping step', { taskId: task.id });\n        return { status: 'skipped' };\n    }\n\n    const questionsData = await fileManager.readQuestions(task.id);\n    if (!questionsData || !questionsData.answered) {\n        stepLogger.info('Waiting for answered research questions', { taskId: task.id });\n        emitEvent(adapter.createStatusEvent('phase_complete', { phase: 'research_questions' }));\n        return { status: 'skipped', halt: true };\n    }\n\n    stepLogger.info('Starting planning phase', { taskId: task.id });\n    emitEvent(adapter.createStatusEvent('phase_start', { phase: 'planning' }));\n\n    const researchContent = await fileManager.readResearch(task.id);\n    let researchContext = '';\n    if (researchContent) {\n        researchContext += `## Research Analysis\\n\\n${researchContent}\\n\\n`;\n    }\n\n    researchContext += `## Implementation Decisions\\n\\n`;\n    for (const question of questionsData.questions) {\n        const answer = questionsData.answers?.find(\n            (a: any) => a.questionId === question.id\n        );\n\n        researchContext += `### ${question.question}\\n\\n`;\n        if (answer) {\n            researchContext += `**Selected:** ${answer.selectedOption}\\n`;\n            if (answer.customInput) {\n                researchContext += `**Details:** ${answer.customInput}\\n`;\n            }\n        } else {\n            researchContext += `**Selected:** Not answered\\n`;\n        }\n        researchContext += `\\n`;\n    }\n\n    const planningPrompt = await promptBuilder.buildPlanningPrompt(task, cwd);\n    const fullPrompt = `${PLANNING_SYSTEM_PROMPT}\\n\\n${planningPrompt}\\n\\n${researchContext}`;\n\n    const baseOptions: Record<string, any> = {\n        model: step.model,\n        cwd,\n        permissionMode: 'plan',\n        settingSources: ['local'],\n        mcpServers,\n        // Allow research tools: read-only operations, web search, MCP resources, and ExitPlanMode\n        allowedTools: [\n            'Read',\n            'Glob',\n            'Grep',\n            'WebFetch',\n            'WebSearch',\n            'ListMcpResources',\n            'ReadMcpResource',\n            'ExitPlanMode',\n            'TodoWrite',\n            'BashOutput',\n        ],\n    };\n\n    const response = query({\n        prompt: fullPrompt,\n        options: { ...baseOptions, ...(options.queryOverrides || {}) },\n    });\n\n    let planContent = '';\n    for await (const message of response) {\n        emitEvent(adapter.createRawSDKEvent(message));\n        const transformed = adapter.transform(message);\n        if (transformed) {\n            emitEvent(transformed);\n        }\n        if (message.type === 'assistant' && message.message?.content) {\n            for (const c of message.message.content) {\n                if (c.type === 'text' && c.text) {\n                    planContent += `${c.text}\\n`;\n                }\n            }\n        }\n    }\n\n    if (planContent.trim()) {\n        await fileManager.writePlan(task.id, planContent.trim());\n        stepLogger.info('Plan completed', { taskId: task.id });\n    }\n\n    await gitManager.addAllPostHogFiles();\n    await finalizeStepGitActions(context, step, {\n        commitMessage: `Planning phase for ${task.title}`,\n    });\n\n    if (!isCloudMode) {\n        emitEvent(adapter.createStatusEvent('phase_complete', { phase: 'planning' }));\n        return { status: 'completed', halt: true };\n    }\n\n    emitEvent(adapter.createStatusEvent('phase_complete', { phase: 'planning' }));\n    return { status: 'completed' };\n};\n"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../../../src/workflow/steps/research.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGtD,eAAO,MAAM,YAAY,EAAE,kBAqJ1B,CAAC"}
+{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../../../src/workflow/steps/research.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGtD,eAAO,MAAM,YAAY,EAAE,kBAiK1B,CAAC"}

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

@@ -20,6 +20,18 @@ const researchStep = async ({ step, context }) => {
         permissionMode: 'plan',
         settingSources: ['local'],
         mcpServers,
+        // Allow research tools: read-only operations, web search, and MCP resources
+        allowedTools: [
+            'Read',
+            'Glob',
+            'Grep',
+            'WebFetch',
+            'WebSearch',
+            'ListMcpResources',
+            'ReadMcpResource',
+            'TodoWrite',
+            'BashOutput',
+        ],
     };
     const response = query({
         prompt: fullPrompt,

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

@@ -1 +1 @@
-{"version":3,"file":"research.js","sources":["../../../../src/workflow/steps/research.ts"],"sourcesContent":["import { query } from '@anthropic-ai/claude-agent-sdk';\nimport { RESEARCH_SYSTEM_PROMPT } from '../../agents/research.js';\nimport type { ExtractedQuestionWithAnswer } from '../../structured-extraction.js';\nimport type { WorkflowStepRunner } from '../types.js';\nimport { finalizeStepGitActions } from '../utils.js';\n\nexport const researchStep: WorkflowStepRunner = async ({ step, context }) => {\n    const {\n        task,\n        cwd,\n        isCloudMode,\n        options,\n        logger,\n        fileManager,\n        gitManager,\n        promptBuilder,\n        adapter,\n        mcpServers,\n        extractor,\n        emitEvent,\n    } = context;\n\n    const stepLogger = logger.child('ResearchStep');\n\n    const existingResearch = await fileManager.readResearch(task.id);\n    if (existingResearch) {\n        stepLogger.info('Research already exists, skipping step', { taskId: task.id });\n        return { status: 'skipped' };\n    }\n\n    stepLogger.info('Starting research phase', { taskId: task.id });\n    emitEvent(adapter.createStatusEvent('phase_start', { phase: 'research' }));\n\n    const researchPrompt = await promptBuilder.buildResearchPrompt(task, cwd);\n    const fullPrompt = `${RESEARCH_SYSTEM_PROMPT}\\n\\n${researchPrompt}`;\n\n    const baseOptions: Record<string, any> = {\n        model: step.model,\n        cwd,\n        permissionMode: 'plan',\n        settingSources: ['local'],\n        mcpServers,\n    };\n\n    const response = query({\n        prompt: fullPrompt,\n        options: { ...baseOptions, ...(options.queryOverrides || {}) },\n    });\n\n    let researchContent = '';\n    for await (const message of response) {\n        emitEvent(adapter.createRawSDKEvent(message));\n        const transformed = adapter.transform(message);\n        if (transformed) {\n            emitEvent(transformed);\n        }\n        if (message.type === 'assistant' && message.message?.content) {\n            for (const c of message.message.content) {\n                if (c.type === 'text' && c.text) {\n                    researchContent += `${c.text}\\n`;\n                }\n            }\n        }\n    }\n\n    if (researchContent.trim()) {\n        await fileManager.writeResearch(task.id, researchContent.trim());\n        stepLogger.info('Research completed', { taskId: task.id });\n    }\n\n    await gitManager.addAllPostHogFiles();\n    await finalizeStepGitActions(context, step, {\n        commitMessage: `Research phase for ${task.title}`,\n    });\n\n    if (extractor && researchContent.trim()) {\n        try {\n            stepLogger.info('Extracting questions from research.md', { taskId: task.id });\n            const parsedQuestions = await extractor.extractQuestions(researchContent);\n\n            await fileManager.writeQuestions(task.id, {\n                questions: parsedQuestions,\n                answered: false,\n                answers: null,\n            });\n\n            emitEvent({\n                type: 'artifact',\n                ts: Date.now(),\n                kind: 'research_questions',\n                content: parsedQuestions,\n            });\n\n            stepLogger.info('Questions extracted successfully', {\n                taskId: task.id,\n                count: parsedQuestions.length,\n            });\n        } catch (error) {\n            stepLogger.error('Failed to extract questions', {\n                taskId: task.id,\n                error: error instanceof Error ? error.message : String(error),\n            });\n            emitEvent({\n                type: 'error',\n                ts: Date.now(),\n                message: `Failed to extract questions: ${\n                    error instanceof Error ? error.message : String(error)\n                }`,\n            });\n        }\n    } else if (!extractor) {\n        stepLogger.warn(\n            'Question extractor not available, skipping question extraction. Ensure LLM gateway is configured.'\n        );\n        emitEvent({\n            type: 'status',\n            ts: Date.now(),\n            phase: 'extraction_skipped',\n            message: 'Question extraction skipped - extractor not configured',\n        });\n    }\n\n    if (!isCloudMode) {\n        emitEvent(adapter.createStatusEvent('phase_complete', { phase: 'research' }));\n        return { status: 'completed', halt: true };\n    }\n\n    const questionsData = await fileManager.readQuestions(task.id);\n    if (questionsData && !questionsData.answered && extractor && researchContent.trim()) {\n        const researchQuestions = await extractor.extractQuestionsWithAnswers(researchContent);\n        const answers = (researchQuestions as ExtractedQuestionWithAnswer[]).map((qa) => ({\n            questionId: qa.id,\n            selectedOption: qa.recommendedAnswer,\n            customInput: qa.justification,\n        }));\n\n        await fileManager.writeQuestions(task.id, {\n            questions: researchQuestions.map((qa) => ({\n                id: qa.id,\n                question: qa.question,\n                options: qa.options,\n            })),\n            answered: true,\n            answers,\n        });\n\n        await gitManager.addAllPostHogFiles();\n        await finalizeStepGitActions(context, step, {\n            commitMessage: `Answer research questions for ${task.title}`,\n        });\n        stepLogger.info('Auto-answered research questions', { taskId: task.id });\n    }\n\n    emitEvent(adapter.createStatusEvent('phase_complete', { phase: 'research' }));\n    return { status: 'completed' };\n};\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"research.js","sources":["../../../../src/workflow/steps/research.ts"],"sourcesContent":["import { query } from '@anthropic-ai/claude-agent-sdk';\nimport { RESEARCH_SYSTEM_PROMPT } from '../../agents/research.js';\nimport type { ExtractedQuestionWithAnswer } from '../../structured-extraction.js';\nimport type { WorkflowStepRunner } from '../types.js';\nimport { finalizeStepGitActions } from '../utils.js';\n\nexport const researchStep: WorkflowStepRunner = async ({ step, context }) => {\n    const {\n        task,\n        cwd,\n        isCloudMode,\n        options,\n        logger,\n        fileManager,\n        gitManager,\n        promptBuilder,\n        adapter,\n        mcpServers,\n        extractor,\n        emitEvent,\n    } = context;\n\n    const stepLogger = logger.child('ResearchStep');\n\n    const existingResearch = await fileManager.readResearch(task.id);\n    if (existingResearch) {\n        stepLogger.info('Research already exists, skipping step', { taskId: task.id });\n        return { status: 'skipped' };\n    }\n\n    stepLogger.info('Starting research phase', { taskId: task.id });\n    emitEvent(adapter.createStatusEvent('phase_start', { phase: 'research' }));\n\n    const researchPrompt = await promptBuilder.buildResearchPrompt(task, cwd);\n    const fullPrompt = `${RESEARCH_SYSTEM_PROMPT}\\n\\n${researchPrompt}`;\n\n    const baseOptions: Record<string, any> = {\n        model: step.model,\n        cwd,\n        permissionMode: 'plan',\n        settingSources: ['local'],\n        mcpServers,\n        // Allow research tools: read-only operations, web search, and MCP resources\n        allowedTools: [\n            'Read',\n            'Glob',\n            'Grep',\n            'WebFetch',\n            'WebSearch',\n            'ListMcpResources',\n            'ReadMcpResource',\n            'TodoWrite',\n            'BashOutput',\n        ],\n    };\n\n    const response = query({\n        prompt: fullPrompt,\n        options: { ...baseOptions, ...(options.queryOverrides || {}) },\n    });\n\n    let researchContent = '';\n    for await (const message of response) {\n        emitEvent(adapter.createRawSDKEvent(message));\n        const transformed = adapter.transform(message);\n        if (transformed) {\n            emitEvent(transformed);\n        }\n        if (message.type === 'assistant' && message.message?.content) {\n            for (const c of message.message.content) {\n                if (c.type === 'text' && c.text) {\n                    researchContent += `${c.text}\\n`;\n                }\n            }\n        }\n    }\n\n    if (researchContent.trim()) {\n        await fileManager.writeResearch(task.id, researchContent.trim());\n        stepLogger.info('Research completed', { taskId: task.id });\n    }\n\n    await gitManager.addAllPostHogFiles();\n    await finalizeStepGitActions(context, step, {\n        commitMessage: `Research phase for ${task.title}`,\n    });\n\n    if (extractor && researchContent.trim()) {\n        try {\n            stepLogger.info('Extracting questions from research.md', { taskId: task.id });\n            const parsedQuestions = await extractor.extractQuestions(researchContent);\n\n            await fileManager.writeQuestions(task.id, {\n                questions: parsedQuestions,\n                answered: false,\n                answers: null,\n            });\n\n            emitEvent({\n                type: 'artifact',\n                ts: Date.now(),\n                kind: 'research_questions',\n                content: parsedQuestions,\n            });\n\n            stepLogger.info('Questions extracted successfully', {\n                taskId: task.id,\n                count: parsedQuestions.length,\n            });\n        } catch (error) {\n            stepLogger.error('Failed to extract questions', {\n                taskId: task.id,\n                error: error instanceof Error ? error.message : String(error),\n            });\n            emitEvent({\n                type: 'error',\n                ts: Date.now(),\n                message: `Failed to extract questions: ${\n                    error instanceof Error ? error.message : String(error)\n                }`,\n            });\n        }\n    } else if (!extractor) {\n        stepLogger.warn(\n            'Question extractor not available, skipping question extraction. Ensure LLM gateway is configured.'\n        );\n        emitEvent({\n            type: 'status',\n            ts: Date.now(),\n            phase: 'extraction_skipped',\n            message: 'Question extraction skipped - extractor not configured',\n        });\n    }\n\n    if (!isCloudMode) {\n        emitEvent(adapter.createStatusEvent('phase_complete', { phase: 'research' }));\n        return { status: 'completed', halt: true };\n    }\n\n    const questionsData = await fileManager.readQuestions(task.id);\n    if (questionsData && !questionsData.answered && extractor && researchContent.trim()) {\n        const researchQuestions = await extractor.extractQuestionsWithAnswers(researchContent);\n        const answers = (researchQuestions as ExtractedQuestionWithAnswer[]).map((qa) => ({\n            questionId: qa.id,\n            selectedOption: qa.recommendedAnswer,\n            customInput: qa.justification,\n        }));\n\n        await fileManager.writeQuestions(task.id, {\n            questions: researchQuestions.map((qa) => ({\n                id: qa.id,\n                question: qa.question,\n                options: qa.options,\n            })),\n            answered: true,\n            answers,\n        });\n\n        await gitManager.addAllPostHogFiles();\n        await finalizeStepGitActions(context, step, {\n            commitMessage: `Answer research questions for ${task.title}`,\n        });\n        stepLogger.info('Auto-answered research questions', { taskId: task.id });\n    }\n\n    emitEvent(adapter.createStatusEvent('phase_complete', { phase: 'research' }));\n    return { status: 'completed' };\n};\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posthog/agent",
-  "version": "1.13.0",
+  "version": "1.15.0",
   "description": "TypeScript agent framework wrapping Claude Agent SDK with Git-based task execution for PostHog",
   "main": "./dist/index.js",
   "module": "./dist/index.js",

package/src/agent.ts

@@ -1,5 +1,5 @@
 import { query } from "@anthropic-ai/claude-agent-sdk";
-import type { Task, ExecutionResult, AgentConfig } from './types.js';
+import type { Task, ExecutionResult, AgentConfig, CanUseTool } from './types.js';
 import { TaskManager } from './task-manager.js';
 import { PostHogAPIClient } from './posthog-api.js';
 import { PostHogFileManager } from './file-manager.js';
@@ -28,11 +28,13 @@ export class Agent {
     private promptBuilder: PromptBuilder;
     private extractor?: StructuredExtractor;
     private mcpServers?: Record<string, any>;
+    private canUseTool?: CanUseTool;
     public debug: boolean;
 
     constructor(config: AgentConfig = {}) {
         this.workingDirectory = config.workingDirectory || process.cwd();
         this.onEvent = config.onEvent;
+        this.canUseTool = config.canUseTool;
         this.debug = config.debug || false;
 
         // Build default PostHog MCP server configuration
@@ -181,7 +183,7 @@ export class Agent {
     }
 
     // Direct prompt execution - still supported for low-level usage
-    async run(prompt: string, options: { repositoryPath?: string; permissionMode?: import('./types.js').PermissionMode; queryOverrides?: Record<string, any> } = {}): Promise<ExecutionResult> {
+    async run(prompt: string, options: { repositoryPath?: string; permissionMode?: import('./types.js').PermissionMode; queryOverrides?: Record<string, any>; canUseTool?: CanUseTool } = {}): Promise<ExecutionResult> {
         await this._configureLlmGateway();
         const baseOptions: Record<string, any> = {
             model: "claude-sonnet-4-5-20250929",
@@ -191,6 +193,12 @@ export class Agent {
             mcpServers: this.mcpServers,
         };
 
+        // Add canUseTool hook if provided (options take precedence over instance config)
+        const canUseTool = options.canUseTool || this.canUseTool;
+        if (canUseTool) {
+            baseOptions.canUseTool = canUseTool;
+        }
+
         const response = query({
             prompt,
             options: { ...baseOptions, ...(options.queryOverrides || {}) },

package/src/agents/execution.ts

@@ -1,53 +1,37 @@
-export const EXECUTION_SYSTEM_PROMPT = `<context>
-  You have access to the local repository files for fast read/write operations.
-  You also have access to GitHub via the GitHub MCP server for additional repository operations.
-  Work with local files for your main implementation, and use GitHub MCP for any additional repository queries.
-  Commit changes to the repository regularly.
-</context>
-
-<role>
-  PostHog AI Coding Agent — autonomously transform a ticket into a merge-ready pull request that follows existing project conventions.
+export const EXECUTION_SYSTEM_PROMPT = `<role>
+PostHog AI Execution Agent — autonomously implement tasks as merge-ready code following project conventions.
 </role>
 
-<tools>
-  Local file system (for main implementation work)
-  PostHog MCP server (for PostHog operations)
-</tools>
+<context>
+You have access to local repository files and PostHog MCP server. Work primarily with local files for implementation. Commit changes regularly.
+</context>
 
 <constraints>
-  - Follow existing style and patterns you discover in the repo.
-  - Try not to add new external dependencies, only if needed.
-  - Implement structured logging and error handling; never log secrets.
-  - Avoid destructive shell commands.
-  - ALWAYS create appropriate .gitignore files to exclude build artifacts, dependencies, and temporary files.
+- Follow existing code style, patterns, and conventions found in the repository
+- Minimize new external dependencies — only add when necessary
+- Implement structured logging and error handling (never log secrets)
+- Avoid destructive shell commands
+- Create/update .gitignore to exclude build artifacts, dependencies, and temp files
 </constraints>
 
-<checklist>
-  - Created or updated .gitignore file with appropriate exclusions
-  - Created dependency files (requirements.txt, package.json, etc.) with exact versions
-  - Added clear setup/installation instructions to README.md
-  - Code compiles and tests pass.
-  - Added or updated tests.
-  - Captured meaningful events with PostHog SDK.
-  - Wrapped new logic in an PostHog feature flag.
-  - Updated docs, readme or type hints if needed.
-  - Verified no build artifacts or dependencies are being committed
-</checklist>
-
 <approach>
-- first make a plan and create a todo list
-- execute the todo list one by one
-- test the changes
+1. Review the implementation plan if provided, or create your own todo list
+2. Execute changes step by step
+3. Test thoroughly and verify functionality
+4. Commit changes with clear messages
 </approach>
 
-<output_format>
-  Once finished respond with a summary of changes made
-</output_format>
-
-<thinking>
-  Use this area as a private scratch-pad for step-by-step reasoning; erase before final output.
-</thinking>
+<checklist>
+Before completing the task, verify:
+- .gitignore includes build artifacts, node_modules, __pycache__, etc.
+- Dependency files (package.json, requirements.txt) use exact versions
+- Code compiles and tests pass
+- Added or updated relevant tests
+- Captured meaningful events with PostHog SDK where appropriate
+- Wrapped new logic in PostHog feature flags where appropriate
+- Updated documentation, README, or type hints as needed
+</checklist>
 
-<task>
-  Complete the ticket in a thoughtful step by step manner. Plan thoroughly and make sure to add logging and error handling as well as cover edge cases.
-</task>`;
+<output_format>
+Provide a concise summary of changes made when finished.
+</output_format>`;