@sentry/warden 0.22.0 → 0.24.0

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

@@ -1 +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,CAiEpB"}
+{"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,CAoEpB"}

package/dist/sdk/prepare.js

@@ -67,7 +67,10 @@ export function prepareFiles(context, options = {}) {
                 maxChunkSize: chunking?.coalesce?.maxChunkSize,
             })
             : splitHunks;
-        const hunksWithContext = expandDiffContext(context.repoPath, { ...diff, hunks }, contextLines);
+        const hunksWithContext = expandDiffContext(context.repoPath, { ...diff, hunks }, {
+            contextLines,
+            contentSource: context.diffContextSource,
+        });
         allHunks.push(...hunksWithContext);
     }
     return {

package/dist/sdk/prepare.js.map

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

package/dist/sdk/pricing.d.ts

@@ -1,4 +1,15 @@
 import type { UsageStats } from '../types/index.js';
+export interface UsageCostBreakdown {
+    freshInputUSD: number;
+    outputUSD: number;
+    cacheReadUSD: number;
+    cacheCreationUSD: number;
+    cacheCreation5mUSD: number;
+    cacheCreation1hUSD: number;
+    webSearchUSD: number;
+    totalUSD: number;
+}
+export declare function estimateUsageCostBreakdown(model: string | undefined, usage: UsageStats): UsageCostBreakdown | undefined;
 /**
  * Usage shape returned by the Anthropic Messages API.
  */
@@ -7,6 +18,13 @@ interface ApiUsage {
     output_tokens: number;
     cache_read_input_tokens?: number | null;
     cache_creation_input_tokens?: number | null;
+    cache_creation?: {
+        ephemeral_1h_input_tokens?: number | null;
+        ephemeral_5m_input_tokens?: number | null;
+    } | null;
+    server_tool_use?: {
+        web_search_requests?: number | null;
+    } | null;
 }
 /**
  * Convert Anthropic API usage to our UsageStats format.

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

@@ -1 +1 @@
-{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../../src/sdk/pricing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AA+BpD;;GAEG;AACH,UAAU,QAAQ;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,2BAA2B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,UAAU,CA6B1E"}
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../../src/sdk/pricing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAiBpD,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AA+ED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,KAAK,EAAE,UAAU,GAChB,kBAAkB,GAAG,SAAS,CA+ChC;AAED;;GAEG;AACH,UAAU,QAAQ;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,2BAA2B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,cAAc,CAAC,EAAE;QACf,yBAAyB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1C,yBAAyB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3C,GAAG,IAAI,CAAC;IACT,eAAe,CAAC,EAAE;QAChB,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACrC,GAAG,IAAI,CAAC;CACV;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,UAAU,CA8C1E"}

package/dist/sdk/pricing.js

@@ -10,8 +10,98 @@ const MODEL_PRICING = Object.fromEntries(Object.entries(rawPricing).map(([id, p]
         outputPerToken: p.outputPerMTok / 1_000_000,
         cacheReadPerToken: p.cacheReadPerMTok / 1_000_000,
         cacheCreationPerToken: p.cacheWritePerMTok / 1_000_000,
+        cacheCreation1hPerToken: p.cacheWrite1hPerMTok / 1_000_000,
+        webSearchPerRequest: p.webSearchPer1K / 1_000,
     },
 ]));
+const MODEL_ALIASES = {
+    'claude-sonnet-4': 'claude-sonnet-4-0',
+    'claude-4-sonnet': 'claude-sonnet-4-0',
+    'claude-sonnet-4-6': 'claude-sonnet-4-5',
+    'claude-opus-4': 'claude-opus-4-0',
+    'claude-4-opus': 'claude-opus-4-0',
+    'claude-opus-4-6': 'claude-opus-4-5',
+};
+function hasModelPricing(pricing) {
+    return pricing !== undefined && (pricing.inputPerToken > 0 ||
+        pricing.outputPerToken > 0 ||
+        pricing.cacheReadPerToken > 0 ||
+        pricing.cacheCreationPerToken > 0 ||
+        pricing.cacheCreation1hPerToken > 0);
+}
+function lookupModelPricing(model) {
+    const pricing = MODEL_PRICING[model];
+    return hasModelPricing(pricing) ? pricing : undefined;
+}
+function normalizeModelId(model) {
+    const undated = model.replace(/-\d{8}$/, '');
+    if (lookupModelPricing(undated))
+        return undated;
+    return MODEL_ALIASES[undated] ?? undated;
+}
+function applyLongContextPricing(model, pricing, inputTokens) {
+    const canonical = normalizeModelId(model);
+    const sonnetLongContext = inputTokens > 200_000 &&
+        (canonical === 'claude-sonnet-4-0' || canonical === 'claude-sonnet-4-5');
+    if (!sonnetLongContext) {
+        return pricing;
+    }
+    const inputPerToken = pricing.inputPerToken * 2;
+    return {
+        ...pricing,
+        inputPerToken,
+        outputPerToken: pricing.outputPerToken * 1.5,
+        cacheReadPerToken: inputPerToken * 0.1,
+        cacheCreationPerToken: inputPerToken * 1.25,
+        cacheCreation1hPerToken: inputPerToken * 2,
+    };
+}
+function getModelPricing(model, inputTokens = 0) {
+    const exact = lookupModelPricing(model);
+    if (exact)
+        return applyLongContextPricing(model, exact, inputTokens);
+    const canonical = normalizeModelId(model);
+    const pricing = lookupModelPricing(canonical) ?? lookupModelPricing(`${canonical}-latest`);
+    return pricing ? applyLongContextPricing(model, pricing, inputTokens) : undefined;
+}
+export function estimateUsageCostBreakdown(model, usage) {
+    if (!model)
+        return undefined;
+    const cacheReadInputTokens = usage.cacheReadInputTokens ?? 0;
+    const cacheCreation5mInputTokens = usage.cacheCreation5mInputTokens ?? 0;
+    const cacheCreation1hInputTokens = usage.cacheCreation1hInputTokens ?? 0;
+    const cacheCreationInputTokens = Math.max(usage.cacheCreationInputTokens ?? 0, cacheCreation5mInputTokens + cacheCreation1hInputTokens);
+    const cacheCreationInputTokensByTier = cacheCreation5mInputTokens + cacheCreation1hInputTokens;
+    const uncategorizedCacheCreationInputTokens = Math.max(0, cacheCreationInputTokens - cacheCreationInputTokensByTier);
+    const freshInputTokens = Math.max(0, usage.inputTokens - cacheReadInputTokens - cacheCreationInputTokens);
+    const webSearchRequests = usage.webSearchRequests ?? 0;
+    const pricing = getModelPricing(model, usage.inputTokens);
+    if (!pricing)
+        return undefined;
+    const freshInputUSD = freshInputTokens * pricing.inputPerToken;
+    const outputUSD = usage.outputTokens * pricing.outputPerToken;
+    const cacheReadUSD = cacheReadInputTokens * pricing.cacheReadPerToken;
+    const cacheCreationUSD = uncategorizedCacheCreationInputTokens * pricing.cacheCreationPerToken;
+    const cacheCreation5mUSD = cacheCreation5mInputTokens * pricing.cacheCreationPerToken;
+    const cacheCreation1hUSD = cacheCreation1hInputTokens * pricing.cacheCreation1hPerToken;
+    const webSearchUSD = webSearchRequests * pricing.webSearchPerRequest;
+    return {
+        freshInputUSD,
+        outputUSD,
+        cacheReadUSD,
+        cacheCreationUSD,
+        cacheCreation5mUSD,
+        cacheCreation1hUSD,
+        webSearchUSD,
+        totalUSD: freshInputUSD +
+            outputUSD +
+            cacheReadUSD +
+            cacheCreationUSD +
+            cacheCreation5mUSD +
+            cacheCreation1hUSD +
+            webSearchUSD,
+    };
+}
 /**
  * Convert Anthropic API usage to our UsageStats format.
  * Calculates cost from token counts using model pricing.
@@ -22,12 +112,22 @@ const MODEL_PRICING = Object.fromEntries(Object.entries(rawPricing).map(([id, p]
  * being subsets of that total.
  */
 export function apiUsageToStats(model, usage) {
-    const pricing = MODEL_PRICING[model];
     const outputTokens = usage.output_tokens;
     const cacheReadInputTokens = usage.cache_read_input_tokens ?? 0;
-    const cacheCreationInputTokens = usage.cache_creation_input_tokens ?? 0;
+    const rawCacheCreationInputTokens = usage.cache_creation_input_tokens ?? 0;
+    const tieredCacheCreation5mInputTokens = usage.cache_creation?.ephemeral_5m_input_tokens ?? 0;
+    const cacheCreation1hInputTokens = usage.cache_creation?.ephemeral_1h_input_tokens ?? 0;
+    const hasTieredCacheCreation = usage.cache_creation !== undefined && usage.cache_creation !== null;
+    const tieredCacheCreationInputTokens = tieredCacheCreation5mInputTokens + cacheCreation1hInputTokens;
+    const cacheCreationInputTokens = Math.max(rawCacheCreationInputTokens, tieredCacheCreationInputTokens);
+    const cacheCreation5mInputTokens = hasTieredCacheCreation
+        ? tieredCacheCreation5mInputTokens
+        : rawCacheCreationInputTokens;
+    const uncategorizedCacheCreationInputTokens = Math.max(0, cacheCreationInputTokens - cacheCreation5mInputTokens - cacheCreation1hInputTokens);
+    const webSearchRequests = usage.server_tool_use?.web_search_requests ?? 0;
     // inputTokens is the total: raw API input_tokens + cache subsets.
     const inputTokens = usage.input_tokens + cacheReadInputTokens + cacheCreationInputTokens;
+    const pricing = getModelPricing(model, inputTokens);
     // Cost: deduct cache subsets from total to get the non-cached portion,
     // then charge each category at its respective rate.
     let costUSD = 0;
@@ -37,13 +137,18 @@ export function apiUsageToStats(model, usage) {
             freshInputTokens * pricing.inputPerToken +
                 outputTokens * pricing.outputPerToken +
                 cacheReadInputTokens * pricing.cacheReadPerToken +
-                cacheCreationInputTokens * pricing.cacheCreationPerToken;
+                (cacheCreation5mInputTokens + uncategorizedCacheCreationInputTokens) * pricing.cacheCreationPerToken +
+                cacheCreation1hInputTokens * pricing.cacheCreation1hPerToken +
+                webSearchRequests * pricing.webSearchPerRequest;
     }
     return {
         inputTokens,
         outputTokens,
         cacheReadInputTokens,
         cacheCreationInputTokens,
+        cacheCreation5mInputTokens: cacheCreation5mInputTokens + uncategorizedCacheCreationInputTokens,
+        cacheCreation1hInputTokens,
+        webSearchRequests,
         costUSD,
     };
 }

package/dist/sdk/pricing.js.map

@@ -1 +1 @@
-{"version":3,"file":"pricing.js","sourceRoot":"","sources":["../../src/sdk/pricing.ts"],"names":[],"mappings":"AACA,OAAO,UAAU,MAAM,sBAAsB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAcpE;;;GAGG;AACH,MAAM,aAAa,GAAiC,MAAM,CAAC,WAAW,CACpE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;IAC1C,EAAE;IACF;QACE,aAAa,EAAE,CAAC,CAAC,YAAY,GAAG,SAAS;QACzC,cAAc,EAAE,CAAC,CAAC,aAAa,GAAG,SAAS;QAC3C,iBAAiB,EAAE,CAAC,CAAC,gBAAgB,GAAG,SAAS;QACjD,qBAAqB,EAAE,CAAC,CAAC,iBAAiB,GAAG,SAAS;KACvD;CACF,CAAC,CACH,CAAC;AAYF;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,KAAe;IAC5D,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAErC,MAAM,YAAY,GAAG,KAAK,CAAC,aAAa,CAAC;IACzC,MAAM,oBAAoB,GAAG,KAAK,CAAC,uBAAuB,IAAI,CAAC,CAAC;IAChE,MAAM,wBAAwB,GAAG,KAAK,CAAC,2BAA2B,IAAI,CAAC,CAAC;IAExE,kEAAkE;IAClE,MAAM,WAAW,GAAG,KAAK,CAAC,YAAY,GAAG,oBAAoB,GAAG,wBAAwB,CAAC;IAEzF,uEAAuE;IACvE,oDAAoD;IACpD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,gBAAgB,GAAG,WAAW,GAAG,oBAAoB,GAAG,wBAAwB,CAAC;QACvF,OAAO;YACL,gBAAgB,GAAG,OAAO,CAAC,aAAa;gBACxC,YAAY,GAAG,OAAO,CAAC,cAAc;gBACrC,oBAAoB,GAAG,OAAO,CAAC,iBAAiB;gBAChD,wBAAwB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAC7D,CAAC;IAED,OAAO;QACL,WAAW;QACX,YAAY;QACZ,oBAAoB;QACpB,wBAAwB;QACxB,OAAO;KACR,CAAC;AACJ,CAAC"}
+{"version":3,"file":"pricing.js","sourceRoot":"","sources":["../../src/sdk/pricing.ts"],"names":[],"mappings":"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"}

package/dist/sdk/prompt-sections.d.ts

@@ -0,0 +1,56 @@
+import { type Finding } from '../types/index.js';
+export interface PromptPRContext {
+    /** 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;
+    /** Max number of changed files to list. 0 disables the section. Default: 50. */
+    maxContextFiles?: number;
+}
+/**
+ * Build a tagged prompt section, omitting empty content.
+ */
+export declare function buildTaggedSection(tag: string, content: string | string[]): string | undefined;
+/**
+ * Join prompt sections with consistent spacing, skipping omitted sections.
+ */
+export declare function joinPromptSections(sections: (string | undefined)[]): string;
+/**
+ * Build a tagged JSON-only output contract.
+ */
+export declare function buildJsonOutputSection(instructions: string): string;
+/**
+ * Build tagged pull request context shared by Warden agents.
+ */
+export declare function buildPullRequestContextSection(prContext?: PromptPRContext): string | undefined;
+export interface FileListSectionOptions {
+    currentFile?: string;
+    maxFiles?: number;
+}
+/**
+ * Build a tagged file list section with optional current-file exclusion.
+ */
+export declare function buildFileListSection(tag: string, files: string[], options?: FileListSectionOptions): string | undefined;
+/**
+ * Build tagged changed-file context shared by Warden agents.
+ */
+export declare function buildChangedFilesSection(prContext: PromptPRContext | undefined, currentFile?: string): string | undefined;
+interface PromptFindingFormatOptions {
+    includeSeverity?: boolean;
+    includeConfidence?: boolean;
+    includeVerification?: boolean;
+    locationStyle?: 'line' | 'range';
+    snippet?: (finding: Finding) => string | undefined;
+}
+/**
+ * Format one finding for prompt lists shared by auxiliary agents.
+ */
+export declare function formatFindingForPrompt(finding: Finding, options?: PromptFindingFormatOptions): string;
+/**
+ * Format findings as a stable 1-based prompt list.
+ */
+export declare function formatIndexedFindingsForPrompt(findings: Finding[], options?: PromptFindingFormatOptions): string;
+export {};
+//# sourceMappingURL=prompt-sections.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-sections.d.ts","sourceRoot":"","sources":["../../src/sdk/prompt-sections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE9D,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;IACrB,gFAAgF;IAChF,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAID;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAO9F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,MAAM,CAE3E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAWnE;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,SAAS,CAAC,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CAa9F;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,GAAE,sBAA2B,GACnC,MAAM,GAAG,SAAS,CAepB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,eAAe,GAAG,SAAS,EACtC,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,GAAG,SAAS,CAMpB;AAED,UAAU,0BAA0B;IAClC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;CACpD;AAaD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,0BAA+B,GACvC,MAAM,CAqBR;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,GAAE,0BAA+B,GACvC,MAAM,CAIR"}

package/dist/sdk/prompt-sections.js

@@ -0,0 +1,118 @@
+import { findingLine } from '../types/index.js';
+const MAX_BODY_LENGTH = 1000;
+/**
+ * Build a tagged prompt section, omitting empty content.
+ */
+export function buildTaggedSection(tag, content) {
+    const body = Array.isArray(content) ? content.join('\n') : content;
+    if (body.trim().length === 0)
+        return undefined;
+    return `<${tag}>
+${body}
+</${tag}>`;
+}
+/**
+ * Join prompt sections with consistent spacing, skipping omitted sections.
+ */
+export function joinPromptSections(sections) {
+    return sections.filter((section) => Boolean(section)).join('\n\n');
+}
+/**
+ * Build a tagged JSON-only output contract.
+ */
+export function buildJsonOutputSection(instructions) {
+    const lines = [
+        'Return only valid JSON. Do not include markdown, prose, code fences, or explanations.',
+    ];
+    const trimmedInstructions = instructions.trim();
+    if (trimmedInstructions.length > 0) {
+        lines.push('', trimmedInstructions);
+    }
+    return `<output_format>
+${lines.join('\n')}
+</output_format>`;
+}
+/**
+ * Build tagged pull request context shared by Warden agents.
+ */
+export function buildPullRequestContextSection(prContext) {
+    if (!prContext?.title)
+        return undefined;
+    const lines = [`<title>${prContext.title}</title>`];
+    if (prContext.body) {
+        const body = prContext.body.length > MAX_BODY_LENGTH
+            ? `${prContext.body.slice(0, MAX_BODY_LENGTH)}...`
+            : prContext.body;
+        lines.push('<body>', body, '</body>');
+    }
+    return buildTaggedSection('pull_request_context', lines);
+}
+/**
+ * Build a tagged file list section with optional current-file exclusion.
+ */
+export function buildFileListSection(tag, files, options = {}) {
+    const maxFiles = options.maxFiles ?? 50;
+    const visibleFiles = options.currentFile
+        ? files.filter((f) => f !== options.currentFile)
+        : files;
+    if (visibleFiles.length === 0 || maxFiles === 0)
+        return undefined;
+    const displayFiles = visibleFiles.slice(0, maxFiles);
+    const remaining = visibleFiles.length - displayFiles.length;
+    const lines = displayFiles.map((f) => `- ${f}`);
+    if (remaining > 0) {
+        lines.push(`- ... and ${remaining} more`);
+    }
+    return buildTaggedSection(tag, lines);
+}
+/**
+ * Build tagged changed-file context shared by Warden agents.
+ */
+export function buildChangedFilesSection(prContext, currentFile) {
+    if (!prContext)
+        return undefined;
+    return buildFileListSection('changed_files', prContext.changedFiles, {
+        currentFile,
+        maxFiles: prContext.maxContextFiles ?? 50,
+    });
+}
+function formatFindingLocation(finding, style) {
+    const loc = finding.location;
+    if (!loc)
+        return 'general';
+    if (style === 'range' && loc.endLine) {
+        return `${loc.path}:${loc.startLine}-${loc.endLine}`;
+    }
+    return `${loc.path}:${findingLine(finding)}`;
+}
+/**
+ * Format one finding for prompt lists shared by auxiliary agents.
+ */
+export function formatFindingForPrompt(finding, options = {}) {
+    const details = [];
+    if (options.includeSeverity)
+        details.push(`(${finding.severity})`);
+    if (options.includeConfidence && finding.confidence) {
+        details.push(`[confidence: ${finding.confidence}]`);
+    }
+    const prefix = details.length > 0 ? `${details.join(' ')} ` : '';
+    const location = formatFindingLocation(finding, options.locationStyle ?? 'line');
+    let text = `[${location}] ${prefix}"${finding.title}" - ${finding.description}`;
+    if (options.includeVerification && finding.verification) {
+        text += ` Verification: ${finding.verification}`;
+    }
+    const snippet = options.snippet?.(finding);
+    if (snippet) {
+        text += `\n   Code: ${snippet.split('\n').join('\n   ')}`;
+    }
+    return text;
+}
+/**
+ * Format findings as a stable 1-based prompt list.
+ */
+export function formatIndexedFindingsForPrompt(findings, options = {}) {
+    return findings.map((finding, index) => {
+        return `${index + 1}. ${formatFindingForPrompt(finding, options)}`;
+    }).join('\n');
+}
+//# sourceMappingURL=prompt-sections.js.map

package/dist/sdk/prompt-sections.js.map

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

package/dist/sdk/prompt.d.ts

@@ -1,22 +1,7 @@
 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;
-    /** Max number of "other files" to list in the prompt. 0 disables the section. Default: 50. */
-    maxContextFiles?: number;
-}
+import { type PromptPRContext } from './prompt-sections.js';
+export type PRPromptContext = PromptPRContext;
 /**
  * Builds the system prompt for hunk-based analysis.
  *

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

@@ -1 +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;IACrB,8FAA8F;IAC9F,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CA+EpE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,eAAe,EACxB,SAAS,CAAC,EAAE,eAAe,GAC1B,MAAM,CAyCR"}
+{"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;AAC/E,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,eAAe,GAAG,eAAe,CAAC;AAE9C;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CA6EpE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,eAAe,EACxB,SAAS,CAAC,EAAE,eAAe,GAC1B,MAAM,CAYR"}

package/dist/sdk/prompt.js

@@ -1,6 +1,7 @@
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { formatHunkForAnalysis } from '../diff/index.js';
+import { buildChangedFilesSection, buildJsonOutputSection, buildPullRequestContextSection, joinPromptSections, } from './prompt-sections.js';
 /**
  * Builds the system prompt for hunk-based analysis.
  *
@@ -26,9 +27,7 @@ The following defines the ONLY criteria you should evaluate. Do not report findi
 
 ${skill.prompt}
 </skill_instructions>`,
-        `<output_format>
-IMPORTANT: Your response must be ONLY a valid JSON object. No markdown, no explanation, no code fences.
-
+        buildJsonOutputSection(`
 Example response format:
 {"findings": [{"id": "example-1", "severity": "medium", "confidence": "high", "title": "Issue title", "description": "Description", "location": {"path": "file.ts", "startLine": 10}}]}
 
@@ -56,7 +55,7 @@ Full schema:
 }
 
 Requirements:
-- Return ONLY valid JSON starting with {"findings":
+- Return 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.
 - "location.startLine" MUST be within the hunk line range (shown in the "## Hunk" header). If the issue originates in surrounding code, anchor to the nearest changed line in the hunk and note the actual location in the description.
@@ -66,7 +65,7 @@ Requirements:
   - The fix requires changes to a different file or a new file (describe the fix in the description field instead)
 - Keep descriptions concise (2-4 sentences). Start with the root cause, end with the user-visible consequence.
 - Focus your analysis on the code changes in the hunk. Surrounding context and tool results are for understanding only -- all findings must reference lines within the hunk range.
-</output_format>`,
+`),
     ];
     const { rootDir } = skill;
     if (rootDir) {
@@ -85,37 +84,16 @@ You can read files from ${dirList} subdirectories using the Read tool with the f
  * 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 maxContextFiles = prContext?.maxContextFiles ?? 50;
-    const otherFiles = prContext?.changedFiles.filter((f) => f !== hunkCtx.filename) ?? [];
-    if (otherFiles.length > 0 && maxContextFiles > 0) {
-        const displayFiles = otherFiles.slice(0, maxContextFiles);
-        const remaining = otherFiles.length - displayFiles.length;
-        let fileList = displayFiles.map((f) => `- ${f}`).join('\n');
-        if (remaining > 0) {
-            fileList += `\n- ... and ${remaining} more`;
-        }
-        sections.push(`## Other Files in This PR
-The following files are also being changed in this PR (may provide useful context):
-${fileList}`);
-    }
-    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');
+    return joinPromptSections([
+        `<task>
+Analyze this code change according to the "${skill.name}" skill criteria.
+</task>`,
+        buildPullRequestContextSection(prContext),
+        buildChangedFilesSection(prContext, hunkCtx.filename),
+        formatHunkForAnalysis(hunkCtx),
+        `<scope_reminder>
+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.
+</scope_reminder>`,
+    ]);
 }
 //# sourceMappingURL=prompt.js.map

package/dist/sdk/prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/sdk/prompt.ts"],"names":[],"mappings":"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"}
+{"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;AAC/E,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,8BAA8B,EAC9B,kBAAkB,GAEnB,MAAM,sBAAsB,CAAC;AAI9B;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAsB;IAC1D,MAAM,QAAQ,GAAG;QACf;;QAEI;QAEJ;;;;;;;gBAOY;QAEZ;;;EAGF,KAAK,CAAC,MAAM;sBACQ;QAElB,sBAAsB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsC1B,CAAC;KACC,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,OAAO,kBAAkB,CAAC;QACxB;6CACyC,KAAK,CAAC,IAAI;QAC/C;QACJ,8BAA8B,CAAC,SAAS,CAAC;QACzC,wBAAwB,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC;QACrD,qBAAqB,CAAC,OAAO,CAAC;QAC9B;;kBAEc;KACf,CAAC,CAAC;AACL,CAAC"}

package/dist/sdk/report-files.d.ts

@@ -0,0 +1,15 @@
+import type { FileReport, Finding, UsageStats } from '../types/index.js';
+export interface FileReportInput {
+    filename: string;
+    durationMs?: number;
+    usage?: UsageStats;
+}
+/**
+ * Return whether a final finding should be counted against a file.
+ */
+export declare function findingAppliesToFile(finding: Finding, filename: string): boolean;
+/**
+ * Count final findings per file while preserving timing and usage metadata.
+ */
+export declare function buildFileReports(files: FileReportInput[], findings: Finding[]): FileReport[];
+//# sourceMappingURL=report-files.d.ts.map

package/dist/sdk/report-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-files.d.ts","sourceRoot":"","sources":["../../src/sdk/report-files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEzE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,UAAU,EAAE,CAO5F"}

package/dist/sdk/report-files.js

@@ -0,0 +1,20 @@
+/**
+ * Return whether a final finding should be counted against a file.
+ */
+export function findingAppliesToFile(finding, filename) {
+    if (finding.location?.path === filename)
+        return true;
+    return finding.additionalLocations?.some((location) => location.path === filename) ?? false;
+}
+/**
+ * Count final findings per file while preserving timing and usage metadata.
+ */
+export function buildFileReports(files, findings) {
+    return files.map((file) => ({
+        filename: file.filename,
+        findings: findings.filter((finding) => findingAppliesToFile(finding, file.filename)).length,
+        durationMs: file.durationMs,
+        usage: file.usage,
+    }));
+}
+//# sourceMappingURL=report-files.js.map

package/dist/sdk/report-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-files.js","sourceRoot":"","sources":["../../src/sdk/report-files.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgB,EAAE,QAAgB;IACrE,IAAI,OAAO,CAAC,QAAQ,EAAE,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACrD,OAAO,OAAO,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,KAAK,CAAC;AAC9F,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAwB,EAAE,QAAmB;IAC5E,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM;QAC3F,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/sdk/runner.d.ts

@@ -21,7 +21,15 @@ export type { PRPromptContext } from './prompt.js';
 export { buildHunkSystemPrompt as buildSystemPrompt } from './prompt.js';
 export { extractFindingsJson, extractBalancedJson, extractFindingsWithLLM, truncateForLLMFallback, deduplicateFindings, mergeGroupLocations, applyMergeGroups, mergeCrossLocationFindings, validateFindings, generateShortId, } from './extract.js';
 export type { ExtractFindingsResult, MergeResult } from './extract.js';
+export { parseJsonFromOutput } from './json-output.js';
+export type { JsonOutputRepairOptions, ParseJsonFromOutputOptions, ParseJsonFromOutputResult, } from './json-output.js';
 export { prepareFiles } from './prepare.js';
+export { verifyFindings } from './verify.js';
+export { postProcessFindings } from './post-process.js';
+export type { PostProcessFindingsOptions, PostProcessFindingsResult, } from './post-process.js';
 export { analyzeFile, runSkill, generateSummary } from './analyze.js';
-export type { AuxiliaryUsageEntry, SkillRunnerCallbacks, SkillRunnerOptions, PreparedFile, PrepareFilesOptions, PrepareFilesResult, FileAnalysisCallbacks, FileAnalysisResult, ChunkAnalysisResult, } from './types.js';
+export { claudeRuntime, getRuntimeProviderOptions, getRuntime, } from './runtimes/index.js';
+export type { Runtime, RuntimeName } from './runtimes/index.js';
+export type { AuxiliaryRunRequest, AuxiliaryRunResult, AuxiliaryTask, AuxiliaryTool, SynthesisRunRequest, SynthesisTask, SkillRunOptions, SkillRunRequest, SkillRunResponse, SkillRunResult, SkillRunStatus, } from './runtimes/index.js';
+export type { AuxiliaryUsageEntry, FindingProcessingEvent, SkillRunnerCallbacks, SkillRunnerOptions, PreparedFile, PrepareFilesOptions, PrepareFilesResult, FileAnalysisCallbacks, FileAnalysisResult, ChunkAnalysisResult, } 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":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGpK,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG1G,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,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,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,0BAA0B,EAC1B,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGvE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGtE,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}
+{"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,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGpK,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG1G,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,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,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,0BAA0B,EAC1B,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EACV,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGtE,OAAO,EACL,aAAa,EACb,yBAAyB,EACzB,UAAU,GACX,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAChE,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,cAAc,GACf,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EACV,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}