@sentry/warden 0.1.1 → 0.2.0

package/dist/sdk/runner.d.ts

@@ -1,202 +1,25 @@
-import type { SkillDefinition, ChunkingConfig } from '../config/schema.js';
-import type { EventContext, SkillReport, Finding, UsageStats, SkippedFile, RetryConfig } from '../types/index.js';
-import { type HunkWithContext } from '../diff/index.js';
-export declare class SkillRunnerError extends Error {
-    constructor(message: string, options?: {
-        cause?: unknown;
-    });
-}
 /**
- * Estimate token count from character count.
- * Uses chars/4 as a rough approximation for English text.
- */
-export declare function estimateTokens(chars: number): number;
-/**
- * Aggregate multiple usage stats into one.
- */
-export declare function aggregateUsage(usages: UsageStats[]): UsageStats;
-/**
- * Check if an error is retryable.
- * Retries on: rate limits (429), server errors (5xx), connection errors, timeouts.
- */
-export declare function isRetryableError(error: unknown): boolean;
-/**
- * Check if an error is an authentication failure.
- * These require user action (login or API key) and should not be retried.
- */
-export declare function isAuthenticationError(error: unknown): boolean;
-export declare class WardenAuthenticationError extends Error {
-    constructor();
-}
-/**
- * Calculate delay for a retry attempt using exponential backoff.
- */
-export declare function calculateRetryDelay(attempt: number, config: Required<RetryConfig>): number;
-/**
- * Callbacks for progress reporting during skill execution.
- */
-export interface SkillRunnerCallbacks {
-    /** Start time of the skill execution (for elapsed time calculations) */
-    skillStartTime?: number;
-    onFileStart?: (file: string, index: number, total: number) => void;
-    onHunkStart?: (file: string, hunkNum: number, totalHunks: number, lineRange: string) => void;
-    onHunkComplete?: (file: string, hunkNum: number, findings: Finding[]) => void;
-    onFileComplete?: (file: string, index: number, total: number) => void;
-    /** Called when a prompt exceeds the large prompt threshold */
-    onLargePrompt?: (file: string, lineRange: string, chars: number, estimatedTokens: number) => void;
-    /** Called with prompt size info in debug mode */
-    onPromptSize?: (file: string, lineRange: string, systemChars: number, userChars: number, totalChars: number, estimatedTokens: number) => void;
-    /** Called when a retry attempt is made (verbose mode) */
-    onRetry?: (file: string, lineRange: string, attempt: number, maxRetries: number, error: string, delayMs: number) => void;
-}
-export interface SkillRunnerOptions {
-    apiKey?: string;
-    maxTurns?: number;
-    /** Lines of context to include around each hunk */
-    contextLines?: number;
-    /** Process files in parallel (default: true) */
-    parallel?: boolean;
-    /** Max concurrent file analyses when parallel=true (default: 5) */
-    concurrency?: number;
-    /** Delay in milliseconds between batch starts when parallel=true (default: 0) */
-    batchDelayMs?: number;
-    /** Model to use for analysis (e.g., 'claude-sonnet-4-20250514'). Uses SDK default if not specified. */
-    model?: string;
-    /** Progress callbacks */
-    callbacks?: SkillRunnerCallbacks;
-    /** Abort controller for cancellation on SIGINT */
-    abortController?: AbortController;
-    /** Path to Claude Code CLI executable. Required in CI environments. */
-    pathToClaudeCodeExecutable?: string;
-    /** Retry configuration for transient API failures */
-    retry?: RetryConfig;
-    /** Enable verbose logging for retry attempts */
-    verbose?: boolean;
-}
-/**
- * Builds the system prompt for hunk-based analysis.
- *
- * Future enhancement: Could have the agent output a structured `contextAssessment`
- * (applicationType, trustBoundaries, filesChecked) to cache across hunks, allow
- * user overrides, or build analytics. Not implemented since we don't consume it yet.
- */
-declare function buildHunkSystemPrompt(skill: SkillDefinition): string;
-/**
- * Context about the PR being analyzed, for inclusion in prompts.
- *
- * The title and body (like a commit message) help explain the _intent_ of the
- * changes to the agent, enabling it to better understand what the author was
- * trying to accomplish and identify issues that conflict with that intent.
- */
-export interface PRPromptContext {
-    /** All files being changed in the PR */
-    changedFiles: string[];
-    /** PR title - explains what the change does */
-    title?: string;
-    /** PR description/body - explains why and provides additional context */
-    body?: string | null;
-}
-/**
- * Result from extracting findings JSON from text.
- */
-export type ExtractFindingsResult = {
-    success: true;
-    findings: unknown[];
-} | {
-    success: false;
-    error: string;
-    preview: string;
-};
-/**
- * Extract JSON object from text, handling nested braces correctly.
- * Starts from the given position and returns the balanced JSON object.
- */
-export declare function extractBalancedJson(text: string, startIndex: number): string | null;
-/**
- * Extract findings JSON from model output text.
- * Handles markdown code fences, prose before JSON, and nested objects.
- */
-export declare function extractFindingsJson(rawText: string): ExtractFindingsResult;
-/**
- * Truncate text for LLM fallback while preserving the findings JSON.
+ * SDK Runner - Main orchestration for skill execution.
  *
- * Caller must ensure findings JSON exists in the text before calling.
- */
-export declare function truncateForLLMFallback(rawText: string, maxChars: number): string;
-/**
- * Extract findings from malformed output using LLM as a fallback.
- * Uses claude-haiku-4-5 for lightweight, fast extraction.
- */
-export declare function extractFindingsWithLLM(rawText: string, apiKey?: string): Promise<ExtractFindingsResult>;
-/**
- * Deduplicate findings by id and location.
- */
-export declare function deduplicateFindings(findings: Finding[]): Finding[];
-/**
- * A file prepared for analysis with its hunks.
- */
-export interface PreparedFile {
-    filename: string;
-    hunks: HunkWithContext[];
-}
-/**
- * Options for preparing files for analysis.
- */
-export interface PrepareFilesOptions {
-    /** Lines of context to include around each hunk */
-    contextLines?: number;
-    /** Chunking configuration for file patterns and coalescing */
-    chunking?: ChunkingConfig;
-}
-/**
- * Result from preparing files for analysis.
- */
-export interface PrepareFilesResult {
-    /** Files prepared for analysis */
-    files: PreparedFile[];
-    /** Files that were skipped due to chunking patterns */
-    skippedFiles: SkippedFile[];
-}
-/**
- * Prepare files for analysis by parsing patches into hunks with context.
- * Returns files that have changes to analyze and files that were skipped.
- */
-export declare function prepareFiles(context: EventContext, options?: PrepareFilesOptions): PrepareFilesResult;
-/**
- * Callbacks for per-file analysis progress.
- */
-export interface FileAnalysisCallbacks {
-    skillStartTime?: number;
-    onHunkStart?: (hunkNum: number, totalHunks: number, lineRange: string) => void;
-    onHunkComplete?: (hunkNum: number, findings: Finding[]) => void;
-    /** Called when a prompt exceeds the large prompt threshold */
-    onLargePrompt?: (lineRange: string, chars: number, estimatedTokens: number) => void;
-    /** Called with prompt size info in debug mode */
-    onPromptSize?: (lineRange: string, systemChars: number, userChars: number, totalChars: number, estimatedTokens: number) => void;
-    /** Called when a retry attempt is made (verbose mode) */
-    onRetry?: (lineRange: string, attempt: number, maxRetries: number, error: string, delayMs: number) => void;
-}
-/**
- * Result from analyzing a single file.
- */
-export interface FileAnalysisResult {
-    filename: string;
-    findings: Finding[];
-    usage: UsageStats;
-    /** Number of hunks that failed to analyze */
-    failedHunks: number;
-}
-/**
- * Analyze a single prepared file's hunks.
- */
-export declare function analyzeFile(skill: SkillDefinition, file: PreparedFile, repoPath: string, options?: SkillRunnerOptions, callbacks?: FileAnalysisCallbacks, prContext?: PRPromptContext): Promise<FileAnalysisResult>;
-/**
- * Run a skill on a PR, analyzing each hunk separately.
- */
-export declare function runSkill(skill: SkillDefinition, context: EventContext, options?: SkillRunnerOptions): Promise<SkillReport>;
-/**
- * Generate a summary of findings.
- */
-export declare function generateSummary(skillName: string, findings: Finding[]): string;
-export { buildHunkSystemPrompt as buildSystemPrompt };
+ * This module re-exports functionality from focused submodules:
+ * - errors.ts: Error classes and classification (SkillRunnerError, WardenAuthenticationError)
+ * - retry.ts: Retry logic with exponential backoff
+ * - usage.ts: Usage stats extraction and aggregation
+ * - prompt.ts: Prompt building for skills
+ * - extract.ts: JSON extraction from model output
+ * - prepare.ts: File preparation for analysis
+ * - analyze.ts: Hunk and file analysis orchestration
+ * - types.ts: Shared interfaces
+ */
+export { SkillRunnerError, WardenAuthenticationError, isRetryableError, isAuthenticationError, isAuthenticationErrorMessage } from './errors.js';
+export { calculateRetryDelay } from './retry.js';
+export { aggregateUsage, estimateTokens } from './usage.js';
+export { buildHunkSystemPrompt, buildHunkUserPrompt } from './prompt.js';
+export type { PRPromptContext } from './prompt.js';
+export { buildHunkSystemPrompt as buildSystemPrompt } from './prompt.js';
+export { extractFindingsJson, extractBalancedJson, extractFindingsWithLLM, truncateForLLMFallback, deduplicateFindings, } from './extract.js';
+export type { ExtractFindingsResult } from './extract.js';
+export { prepareFiles } from './prepare.js';
+export { analyzeFile, runSkill, generateSummary } from './analyze.js';
+export type { SkillRunnerCallbacks, SkillRunnerOptions, PreparedFile, PrepareFilesOptions, PrepareFilesResult, FileAnalysisCallbacks, FileAnalysisResult, } from './types.js';
 //# sourceMappingURL=runner.d.ts.map

package/dist/sdk/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/sdk/runner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/sdk/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAGjJ,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5D,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACzE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,qBAAqB,IAAI,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGzE,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAG1D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGtE,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}