@sentry/warden 0.1.1 → 0.3.0

package/dist/sdk/extract.js

@@ -0,0 +1,224 @@
+import Anthropic from '@anthropic-ai/sdk';
+import { FindingSchema } from '../types/index.js';
+/** Pattern to match the start of findings JSON (allows whitespace after brace) */
+export const FINDINGS_JSON_START = /\{\s*"findings"/;
+/**
+ * Extract JSON object from text, handling nested braces correctly.
+ * Starts from the given position and returns the balanced JSON object.
+ */
+export function extractBalancedJson(text, startIndex) {
+    let depth = 0;
+    let inString = false;
+    let escape = false;
+    for (let i = startIndex; i < text.length; i++) {
+        const char = text[i];
+        if (escape) {
+            escape = false;
+            continue;
+        }
+        if (char === '\\' && inString) {
+            escape = true;
+            continue;
+        }
+        if (char === '"') {
+            inString = !inString;
+            continue;
+        }
+        if (inString)
+            continue;
+        if (char === '{')
+            depth++;
+        if (char === '}') {
+            depth--;
+            if (depth === 0) {
+                return text.slice(startIndex, i + 1);
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Extract findings JSON from model output text.
+ * Handles markdown code fences, prose before JSON, and nested objects.
+ */
+export function extractFindingsJson(rawText) {
+    let text = rawText.trim();
+    // Strip markdown code fences if present (handles any language tag: ```json, ```typescript, ```c++, etc.)
+    const codeBlockMatch = text.match(/```[\w+#-]*\s*([\s\S]*?)```/);
+    if (codeBlockMatch?.[1]) {
+        text = codeBlockMatch[1].trim();
+    }
+    // Find the start of the findings JSON object
+    const findingsMatch = text.match(FINDINGS_JSON_START);
+    if (!findingsMatch || findingsMatch.index === undefined) {
+        return {
+            success: false,
+            error: 'no_findings_json',
+            preview: text.slice(0, 200),
+        };
+    }
+    const findingsStart = findingsMatch.index;
+    // Extract the balanced JSON object
+    const jsonStr = extractBalancedJson(text, findingsStart);
+    if (!jsonStr) {
+        return {
+            success: false,
+            error: 'unbalanced_json',
+            preview: text.slice(findingsStart, findingsStart + 200),
+        };
+    }
+    // Parse the JSON
+    let parsed;
+    try {
+        parsed = JSON.parse(jsonStr);
+    }
+    catch {
+        return {
+            success: false,
+            error: 'invalid_json',
+            preview: jsonStr.slice(0, 200),
+        };
+    }
+    // Validate structure
+    if (typeof parsed !== 'object' || parsed === null || !('findings' in parsed)) {
+        return {
+            success: false,
+            error: 'missing_findings_key',
+            preview: jsonStr.slice(0, 200),
+        };
+    }
+    const findings = parsed.findings;
+    if (!Array.isArray(findings)) {
+        return {
+            success: false,
+            error: 'findings_not_array',
+            preview: jsonStr.slice(0, 200),
+        };
+    }
+    return { success: true, findings };
+}
+/** Max characters to send to LLM fallback (roughly ~8k tokens) */
+const LLM_FALLBACK_MAX_CHARS = 32000;
+/** Timeout for LLM fallback API calls in milliseconds */
+const LLM_FALLBACK_TIMEOUT_MS = 30000;
+/**
+ * Truncate text for LLM fallback while preserving the findings JSON.
+ *
+ * Caller must ensure findings JSON exists in the text before calling.
+ */
+export function truncateForLLMFallback(rawText, maxChars) {
+    if (rawText.length <= maxChars) {
+        return rawText;
+    }
+    const findingsIndex = rawText.match(FINDINGS_JSON_START)?.index ?? -1;
+    // If findings starts within our budget, simple truncation from start preserves it
+    if (findingsIndex < maxChars - 20) {
+        return rawText.slice(0, maxChars) + '\n[... truncated]';
+    }
+    // Findings is beyond our budget - skip to just before it
+    // Keep minimal context (10% of budget or 200 chars, whichever is smaller)
+    const markerOverhead = 40;
+    const usableBudget = maxChars - markerOverhead;
+    const contextBefore = Math.min(200, Math.floor(usableBudget * 0.1), findingsIndex);
+    const startIndex = findingsIndex - contextBefore;
+    const endIndex = startIndex + usableBudget;
+    const truncatedContent = rawText.slice(startIndex, endIndex);
+    const suffix = endIndex < rawText.length ? '\n[... truncated]' : '';
+    return '[... truncated ...]\n' + truncatedContent + suffix;
+}
+/**
+ * Extract findings from malformed output using LLM as a fallback.
+ * Uses claude-haiku-4-5 for lightweight, fast extraction.
+ */
+export async function extractFindingsWithLLM(rawText, apiKey) {
+    if (!apiKey) {
+        return {
+            success: false,
+            error: 'no_api_key_for_fallback',
+            preview: rawText.slice(0, 200),
+        };
+    }
+    // If no findings anchor exists, there's nothing to extract
+    if (!FINDINGS_JSON_START.test(rawText)) {
+        return {
+            success: false,
+            error: 'no_findings_to_extract',
+            preview: rawText.slice(0, 200),
+        };
+    }
+    // Truncate input while preserving JSON boundaries
+    const truncatedText = truncateForLLMFallback(rawText, LLM_FALLBACK_MAX_CHARS);
+    try {
+        const client = new Anthropic({ apiKey, timeout: LLM_FALLBACK_TIMEOUT_MS });
+        const response = await client.messages.create({
+            model: 'claude-haiku-4-5',
+            max_tokens: 4096,
+            messages: [
+                {
+                    role: 'user',
+                    content: `Extract the findings JSON from this model output.
+Return ONLY valid JSON in format: {"findings": [...]}
+If no findings exist, return: {"findings": []}
+
+Model output:
+${truncatedText}`,
+                },
+            ],
+        });
+        const content = response.content[0];
+        if (!content || content.type !== 'text') {
+            return {
+                success: false,
+                error: 'llm_unexpected_response',
+                preview: rawText.slice(0, 200),
+            };
+        }
+        // Parse the LLM response as JSON
+        return extractFindingsJson(content.text);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            error: `llm_extraction_failed: ${errorMessage}`,
+            preview: rawText.slice(0, 200),
+        };
+    }
+}
+/**
+ * Validate and normalize findings from extracted JSON.
+ */
+export function validateFindings(findings, filename) {
+    const validated = [];
+    for (const f of findings) {
+        // Normalize location path before validation
+        if (typeof f === 'object' && f !== null && 'location' in f) {
+            const loc = f['location'];
+            if (loc && typeof loc === 'object') {
+                loc['path'] = filename;
+            }
+        }
+        const result = FindingSchema.safeParse(f);
+        if (result.success) {
+            validated.push({
+                ...result.data,
+                location: result.data.location ? { ...result.data.location, path: filename } : undefined,
+            });
+        }
+    }
+    return validated;
+}
+/**
+ * Deduplicate findings by id and location.
+ */
+export function deduplicateFindings(findings) {
+    const seen = new Set();
+    return findings.filter((f) => {
+        const key = `${f.id}:${f.location?.path}:${f.location?.startLine}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+//# sourceMappingURL=extract.js.map

package/dist/sdk/extract.js.map

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

package/dist/sdk/prepare.d.ts

@@ -0,0 +1,13 @@
+import type { EventContext } from '../types/index.js';
+import { type HunkWithContext } from '../diff/index.js';
+import type { PreparedFile, PrepareFilesOptions, PrepareFilesResult } from './types.js';
+/**
+ * Group hunks by filename into PreparedFile entries.
+ */
+export declare function groupHunksByFile(hunks: HunkWithContext[]): PreparedFile[];
+/**
+ * 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;
+//# sourceMappingURL=prepare.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../src/sdk/prepare.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAML,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAExF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,YAAY,EAAE,CAazE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,mBAAwB,GAChC,kBAAkB,CA2DpB"}

package/dist/sdk/prepare.js

@@ -0,0 +1,73 @@
+import { parseFileDiff, expandDiffContext, classifyFile, coalesceHunks, splitLargeHunks, } from '../diff/index.js';
+/**
+ * Group hunks by filename into PreparedFile entries.
+ */
+export function groupHunksByFile(hunks) {
+    const fileMap = new Map();
+    for (const hunk of hunks) {
+        const existing = fileMap.get(hunk.filename);
+        if (existing) {
+            existing.push(hunk);
+        }
+        else {
+            fileMap.set(hunk.filename, [hunk]);
+        }
+    }
+    return Array.from(fileMap, ([filename, fileHunks]) => ({ filename, hunks: fileHunks }));
+}
+/**
+ * Prepare files for analysis by parsing patches into hunks with context.
+ * Returns files that have changes to analyze and files that were skipped.
+ */
+export function prepareFiles(context, options = {}) {
+    const { contextLines = 20, chunking } = options;
+    if (!context.pullRequest) {
+        return { files: [], skippedFiles: [] };
+    }
+    const pr = context.pullRequest;
+    const allHunks = [];
+    const skippedFiles = [];
+    for (const file of pr.files) {
+        if (!file.patch)
+            continue;
+        // Check if this file should be skipped based on chunking patterns
+        const mode = classifyFile(file.filename, chunking?.filePatterns);
+        if (mode === 'skip') {
+            skippedFiles.push({
+                filename: file.filename,
+                reason: 'builtin', // Could be enhanced to track which pattern matched
+            });
+            continue;
+        }
+        const statusMap = {
+            added: 'added',
+            removed: 'removed',
+            modified: 'modified',
+            renamed: 'renamed',
+            copied: 'added',
+            changed: 'modified',
+            unchanged: 'modified',
+        };
+        const status = statusMap[file.status] ?? 'modified';
+        const diff = parseFileDiff(file.filename, file.patch, status);
+        // Split large hunks first (handles large files becoming single hunks)
+        const splitHunks = splitLargeHunks(diff.hunks, {
+            maxChunkSize: chunking?.coalesce?.maxChunkSize,
+        });
+        // Then coalesce nearby small ones if enabled (default: enabled)
+        const coalesceEnabled = chunking?.coalesce?.enabled !== false;
+        const hunks = coalesceEnabled
+            ? coalesceHunks(splitHunks, {
+                maxGapLines: chunking?.coalesce?.maxGapLines,
+                maxChunkSize: chunking?.coalesce?.maxChunkSize,
+            })
+            : splitHunks;
+        const hunksWithContext = expandDiffContext(context.repoPath, { ...diff, hunks }, contextLines);
+        allHunks.push(...hunksWithContext);
+    }
+    return {
+        files: groupHunksByFile(allHunks),
+        skippedFiles,
+    };
+}
+//# sourceMappingURL=prepare.js.map

package/dist/sdk/prepare.js.map

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

package/dist/sdk/prompt.d.ts

@@ -0,0 +1,30 @@
+import type { SkillDefinition } from '../config/schema.js';
+import { type HunkWithContext } from '../diff/index.js';
+/**
+ * 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;
+}
+/**
+ * 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.
+ */
+export declare function buildHunkSystemPrompt(skill: SkillDefinition): string;
+/**
+ * Builds the user prompt for a single hunk.
+ */
+export declare function buildHunkUserPrompt(skill: SkillDefinition, hunkCtx: HunkWithContext, prContext?: PRPromptContext): string;
+//# sourceMappingURL=prompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/sdk/prompt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE/E;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CA0EpE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,eAAe,EACxB,SAAS,CAAC,EAAE,eAAe,GAC1B,MAAM,CAkCR"}

package/dist/sdk/prompt.js

@@ -0,0 +1,109 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { formatHunkForAnalysis } from '../diff/index.js';
+/**
+ * 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.
+ */
+export function buildHunkSystemPrompt(skill) {
+    const sections = [
+        `<role>
+You are a code analysis agent for Warden. You evaluate code changes against specific skill criteria and report findings ONLY when the code violates or conflicts with those criteria. You do not perform general code review or report issues outside the skill's scope.
+</role>`,
+        `<tools>
+You have access to these tools to gather context:
+- **Read**: Check related files to understand context
+- **Grep**: Search for patterns to trace data flow or find related code
+</tools>`,
+        `<skill_instructions>
+The following defines the ONLY criteria you should evaluate. Do not report findings outside this scope:
+
+${skill.prompt}
+</skill_instructions>`,
+        `<output_format>
+IMPORTANT: Your response must be ONLY a valid JSON object. No markdown, no explanation, no code fences.
+
+Example response format:
+{"findings": [{"id": "example-1", "severity": "medium", "confidence": "high", "title": "Issue title", "description": "Description", "location": {"path": "file.ts", "startLine": 10}}]}
+
+Full schema:
+{
+  "findings": [
+    {
+      "id": "unique-identifier",
+      "severity": "critical|high|medium|low|info",
+      "confidence": "high|medium|low",
+      "title": "Short descriptive title",
+      "description": "Detailed explanation of the issue",
+      "location": {
+        "path": "path/to/file.ts",
+        "startLine": 10,
+        "endLine": 15
+      },
+      "suggestedFix": {
+        "description": "How to fix this issue",
+        "diff": "unified diff format"
+      }
+    }
+  ]
+}
+
+Requirements:
+- Return ONLY valid JSON starting with {"findings":
+- "findings" array can be empty if no issues found
+- "location.path" is auto-filled from context - just provide startLine (and optionally endLine). Omit location entirely for general findings not about a specific line.
+- "confidence" reflects how certain you are this is a real issue given the codebase context
+- "suggestedFix" is optional - only include when you can provide a complete, correct fix **to the file being analyzed**. Omit suggestedFix if:
+  - The fix would be incomplete or you're uncertain about the correct solution
+  - The fix requires changes to a different file or a new file (describe the fix in the description field instead)
+- Keep descriptions SHORT (1-2 sentences max) - avoid lengthy explanations
+- Be concise - focus only on the changes shown
+</output_format>`,
+    ];
+    const { rootDir } = skill;
+    if (rootDir) {
+        const resourceDirs = ['scripts', 'references', 'assets'].filter((dir) => existsSync(join(rootDir, dir)));
+        if (resourceDirs.length > 0) {
+            const dirList = resourceDirs.map((d) => `${d}/`).join(', ');
+            sections.push(`<skill_resources>
+This skill is located at: ${rootDir}
+You can read files from ${dirList} subdirectories using the Read tool with the full path.
+</skill_resources>`);
+        }
+    }
+    return sections.join('\n\n');
+}
+/**
+ * Builds the user prompt for a single hunk.
+ */
+export function buildHunkUserPrompt(skill, hunkCtx, prContext) {
+    const sections = [];
+    sections.push(`Analyze this code change according to the "${skill.name}" skill criteria.`);
+    // Include PR title and description for context on intent
+    if (prContext?.title) {
+        let prSection = `## Pull Request Context\n**Title:** ${prContext.title}`;
+        if (prContext.body) {
+            // Truncate very long PR descriptions to avoid bloating prompts
+            const maxBodyLength = 1000;
+            const body = prContext.body.length > maxBodyLength
+                ? prContext.body.slice(0, maxBodyLength) + '...'
+                : prContext.body;
+            prSection += `\n\n**Description:**\n${body}`;
+        }
+        sections.push(prSection);
+    }
+    // Include list of other files being changed in the PR for context
+    const otherFiles = prContext?.changedFiles.filter((f) => f !== hunkCtx.filename) ?? [];
+    if (otherFiles.length > 0) {
+        sections.push(`## Other Files in This PR
+The following files are also being changed in this PR (may provide useful context):
+${otherFiles.map((f) => `- ${f}`).join('\n')}`);
+    }
+    sections.push(formatHunkForAnalysis(hunkCtx));
+    sections.push(`IMPORTANT: Only report findings that are explicitly covered by the skill instructions. Do not report general code quality issues, bugs, or improvements unless the skill specifically asks for them. Return an empty findings array if no issues match the skill's criteria.`);
+    return sections.join('\n\n');
+}
+//# sourceMappingURL=prompt.js.map

package/dist/sdk/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/sdk/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,qBAAqB,EAAwB,MAAM,kBAAkB,CAAC;AAkB/E;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAsB;IAC1D,MAAM,QAAQ,GAAG;QACf;;QAEI;QAEJ;;;;SAIK;QAEL;;;EAGF,KAAK,CAAC,MAAM;sBACQ;QAElB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsCa;KACd,CAAC;IAEF,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAC1B,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,YAAY,GAAG,CAAC,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CACtE,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAC/B,CAAC;QACF,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5D,QAAQ,CAAC,IAAI,CAAC;4BACQ,OAAO;0BACT,OAAO;mBACd,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAsB,EACtB,OAAwB,EACxB,SAA2B;IAE3B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,QAAQ,CAAC,IAAI,CAAC,8CAA8C,KAAK,CAAC,IAAI,mBAAmB,CAAC,CAAC;IAE3F,yDAAyD;IACzD,IAAI,SAAS,EAAE,KAAK,EAAE,CAAC;QACrB,IAAI,SAAS,GAAG,uCAAuC,SAAS,CAAC,KAAK,EAAE,CAAC;QACzE,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;YACnB,+DAA+D;YAC/D,MAAM,aAAa,GAAG,IAAI,CAAC;YAC3B,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,GAAG,aAAa;gBAChD,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,GAAG,KAAK;gBAChD,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC;YACnB,SAAS,IAAI,yBAAyB,IAAI,EAAE,CAAC;QAC/C,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC;IAED,kEAAkE;IAClE,MAAM,UAAU,GAAG,SAAS,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACvF,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC;;EAEhB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IAE9C,QAAQ,CAAC,IAAI,CACX,8QAA8Q,CAC/Q,CAAC;IAEF,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/sdk/retry.d.ts

@@ -0,0 +1,12 @@
+import type { RetryConfig } from '../types/index.js';
+/** Default retry configuration */
+export declare const DEFAULT_RETRY_CONFIG: Required<RetryConfig>;
+/**
+ * Calculate delay for a retry attempt using exponential backoff.
+ */
+export declare function calculateRetryDelay(attempt: number, config: Required<RetryConfig>): number;
+/**
+ * Sleep for a specified duration, respecting abort signal.
+ */
+export declare function sleep(ms: number, abortSignal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=retry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/sdk/retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,kCAAkC;AAClC,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,WAAW,CAKtD,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,MAAM,CAGR;AAED;;GAEG;AACH,wBAAsB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAchF"}

package/dist/sdk/retry.js

@@ -0,0 +1,31 @@
+/** Default retry configuration */
+export const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    initialDelayMs: 1000,
+    backoffMultiplier: 2,
+    maxDelayMs: 30000,
+};
+/**
+ * Calculate delay for a retry attempt using exponential backoff.
+ */
+export function calculateRetryDelay(attempt, config) {
+    const delay = config.initialDelayMs * Math.pow(config.backoffMultiplier, attempt);
+    return Math.min(delay, config.maxDelayMs);
+}
+/**
+ * Sleep for a specified duration, respecting abort signal.
+ */
+export async function sleep(ms, abortSignal) {
+    return new Promise((resolve, reject) => {
+        if (abortSignal?.aborted) {
+            reject(new Error('Aborted'));
+            return;
+        }
+        const timeout = setTimeout(resolve, ms);
+        abortSignal?.addEventListener('abort', () => {
+            clearTimeout(timeout);
+            reject(new Error('Aborted'));
+        }, { once: true });
+    });
+}
+//# sourceMappingURL=retry.js.map

package/dist/sdk/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/sdk/retry.ts"],"names":[],"mappings":"AAEA,kCAAkC;AAClC,MAAM,CAAC,MAAM,oBAAoB,GAA0B;IACzD,UAAU,EAAE,CAAC;IACb,cAAc,EAAE,IAAI;IACpB,iBAAiB,EAAE,CAAC;IACpB,UAAU,EAAE,KAAK;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,MAA6B;IAE7B,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;IAClF,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,EAAU,EAAE,WAAyB;IAC/D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAExC,WAAW,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YAC1C,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/B,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACrB,CAAC,CAAC,CAAC;AACL,CAAC"}