wotann 0.5.0

package/dist/middleware/layers.js

@@ -0,0 +1,529 @@
+/**
+ * All 16 middleware layers (except IntentGate and TTSR which have own files).
+ * Each layer implements the Middleware interface with before/after hooks.
+ * Per spec §9: every cross-cutting concern is a composable layer.
+ */
+import { existsSync, mkdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { runSandboxedCommandSync } from "../sandbox/executor.js";
+import { getMaxDocumentedContext } from "../context/limits.js";
+import { createTrifectaGuard, } from "./trifecta-guard.js";
+// ── Layer 2: Thread Data — create isolated thread directory ──
+export const threadDataMiddleware = {
+    name: "ThreadData",
+    order: 2,
+    before(ctx) {
+        const threadDir = join(ctx.workingDir, ".wotann", "threads", ctx.sessionId);
+        if (!existsSync(threadDir)) {
+            mkdirSync(threadDir, { recursive: true });
+        }
+        return { ...ctx, threadDir };
+    },
+};
+// ── Layer 3: Uploads — inject uploaded file context ──────────
+export const uploadsMiddleware = {
+    name: "Uploads",
+    order: 3,
+    before(ctx) {
+        // Parse @file references in user message and inject file contents
+        const fileRefPattern = /@([\w./-]+)/g;
+        let enrichedMessage = ctx.userMessage;
+        const matches = ctx.userMessage.matchAll(fileRefPattern);
+        const injectedFiles = [];
+        for (const match of matches) {
+            const filePath = match[1];
+            if (filePath && existsSync(join(ctx.workingDir, filePath))) {
+                injectedFiles.push(filePath);
+            }
+        }
+        if (injectedFiles.length > 0) {
+            enrichedMessage = `${ctx.userMessage}\n\n[Files referenced: ${injectedFiles.join(", ")}]`;
+        }
+        return { ...ctx, userMessage: enrichedMessage, injectedFiles };
+    },
+};
+// ── Layer 4: Sandbox — verify working dir is within allowed scope ──
+export const sandboxMiddleware = {
+    name: "Sandbox",
+    order: 4,
+    before(ctx) {
+        // Ensure workingDir is resolved and exists
+        const resolved = ctx.workingDir;
+        if (!existsSync(resolved)) {
+            return { ...ctx, sandboxError: "Working directory does not exist" };
+        }
+        return { ...ctx, sandboxActive: true };
+    },
+};
+// ── Layer 5: Guardrail — pre-execution hook authorization ────
+export const guardrailMiddleware = {
+    name: "Guardrail",
+    order: 5,
+    before(ctx) {
+        // Flag requests that mention destructive operations for the hook engine
+        const destructiveKeywords = /\b(delete|remove|drop|truncate|reset|force.?push|rm\s+-rf)\b/i;
+        const needsGuardrail = destructiveKeywords.test(ctx.userMessage);
+        return { ...ctx, guardrailTriggered: needsGuardrail };
+    },
+};
+// ── Layer 6: Tool Error — standardize error formatting ───────
+export const toolErrorMiddleware = {
+    name: "ToolError",
+    order: 6,
+    after(_ctx, result) {
+        if (!result.success && result.content) {
+            // Normalize error format for consistent agent processing
+            const normalizedContent = result.content.startsWith("Error:")
+                ? result.content
+                : `Error: ${result.content}`;
+            return { ...result, content: normalizedContent };
+        }
+        return result;
+    },
+};
+// ── Layer 7: Summarization — manage token limits ─────────────
+//
+// Round 33 — context limit is now derived from the detected
+// provider set, not a hardcoded 200K. Previously a Gemma-4-only
+// session (8K context) saw "0% utilization" for a 16K-token
+// history because the comparison used 200K. Now uses
+// getMaxDocumentedContext() over detected providers, which falls
+// back to 128K when no providers are detected (matches the
+// existing helper's contract). This means: power-user with all
+// providers configured sees 1M-context-aware utilization; CI
+// runner with only an OpenAI key sees 128K-aware utilization.
+export const summarizationMiddleware = {
+    name: "Summarization",
+    order: 7,
+    before(ctx) {
+        const historyTokens = ctx.recentHistory.reduce((sum, msg) => sum + Math.ceil(msg.content.length / 4), 0);
+        // Cache the limit detection per-process — provider env doesn't
+        // change mid-session, and the 4-env-var probe is wasted work
+        // every middleware call. Lazy compute on first use.
+        const contextLimit = getCachedContextLimit();
+        // Round 31 + 33: clamp display percentage to [0, 100] for the
+        // same prompt-injection-misfire reason; threshold logic still
+        // reads the raw count.
+        const rawPct = Math.round((historyTokens / contextLimit) * 100);
+        const utilizationPercent = Math.max(0, Math.min(100, rawPct));
+        const needsSummarization = rawPct > 75;
+        return { ...ctx, contextUtilization: utilizationPercent, needsSummarization };
+    },
+};
+/**
+ * Round 33 — provider-aware context limit detection. Caches the
+ * result per-process (lazy on first call) since the detected
+ * provider set doesn't change mid-session. Falls back to 128K
+ * when no providers are detected (matches getMaxDocumentedContext's
+ * contract).
+ */
+let cachedContextLimit = null;
+function getCachedContextLimit() {
+    if (cachedContextLimit !== null)
+        return cachedContextLimit;
+    // Synchronous probe of the providers we know how to detect.
+    const providers = new Set();
+    if (process.env["ANTHROPIC_API_KEY"] || process.env["CLAUDE_CODE_OAUTH_TOKEN"])
+        providers.add("anthropic");
+    if (process.env["OPENAI_API_KEY"])
+        providers.add("openai");
+    if (process.env["GEMINI_API_KEY"] || process.env["GOOGLE_AI_API_KEY"])
+        providers.add("gemini");
+    if (process.env["OPENROUTER_API_KEY"])
+        providers.add("openrouter");
+    if (process.env["OLLAMA_HOST"] || process.env["OLLAMA_URL"])
+        providers.add("ollama");
+    if (process.env["GH_TOKEN"] || process.env["GITHUB_TOKEN"])
+        providers.add("copilot");
+    if (process.env["CODEX_API_KEY"])
+        providers.add("codex");
+    cachedContextLimit = getMaxDocumentedContext(providers);
+    return cachedContextLimit;
+}
+/** Test/diagnostic accessor — clears the cache so tests can rerun
+ *  the detection with different env values. Not exported as part of
+ *  the public API; only consumed by the layer's own test file. */
+export function _resetContextLimitCacheForTests() {
+    cachedContextLimit = null;
+}
+// ── Layer 8: Memory — queue memory extraction ────────────────
+export const memoryMiddleware = {
+    name: "Memory",
+    order: 8,
+    after(ctx, result) {
+        // After each tool use, flag observations worth capturing
+        if (result.success && result.toolName) {
+            const memoryCandidate = {
+                tool: result.toolName,
+                file: result.filePath,
+                sessionId: ctx.sessionId,
+                timestamp: Date.now(),
+            };
+            // Attach memory extraction hint to result
+            return { ...result, memoryCandidate };
+        }
+        return result;
+    },
+};
+// ── Layer 10: Clarification — detect when user input is ambiguous ──
+const AMBIGUITY_SIGNALS = [
+    /\b(something|stuff|things|it|this|that)\b/i,
+    /\b(maybe|perhaps|possibly|or something)\b/i,
+    /\?{2,}/,
+];
+export const clarificationMiddleware = {
+    name: "Clarification",
+    order: 10,
+    before(ctx) {
+        // Only flag ambiguity if the message is short (longer messages self-contextualize)
+        if (ctx.userMessage.length > 100)
+            return ctx;
+        const ambiguityScore = AMBIGUITY_SIGNALS.reduce((score, pattern) => score + (pattern.test(ctx.userMessage) ? 1 : 0), 0);
+        return { ...ctx, ambiguityScore, needsClarification: ambiguityScore >= 2 };
+    },
+};
+// ── Layer 11: Cache — track prompt cache hit rates ───────────
+const cacheStats = { hits: 0, misses: 0, totalRequests: 0 };
+export const cacheMiddleware = {
+    name: "Cache",
+    order: 11,
+    before(ctx) {
+        cacheStats.totalRequests++;
+        const hitRate = cacheStats.totalRequests > 0 ? cacheStats.hits / cacheStats.totalRequests : 0;
+        return { ...ctx, cacheHitRate: hitRate };
+    },
+    after(_ctx, result) {
+        // Track whether the response used cached prompt prefix
+        if (result.cacheHit) {
+            cacheStats.hits++;
+        }
+        else {
+            cacheStats.misses++;
+        }
+        return result;
+    },
+};
+export function getCacheStats() {
+    return {
+        ...cacheStats,
+        hitRate: cacheStats.totalRequests > 0 ? cacheStats.hits / cacheStats.totalRequests : 0,
+    };
+}
+// ── Layer 12: Autonomy — 3-tier risk classification ──────────
+export function classifyRisk(tool, _input) {
+    if (["Read", "Glob", "Grep", "LSP", "WebSearch"].includes(tool))
+        return "low";
+    if (["Write", "Edit"].includes(tool))
+        return "medium";
+    if (["Bash", "ComputerUse"].includes(tool))
+        return "high";
+    return "medium";
+}
+export const autonomyMiddleware = {
+    name: "Autonomy",
+    order: 12,
+    before(ctx) {
+        // Classify risk based on intent and complexity
+        const risk = ctx.complexity === "high" ? "high" : "medium";
+        return { ...ctx, riskLevel: risk };
+    },
+};
+// ── Layer 14: File Track — record files the agent touched ────
+export const fileTrackMiddleware = {
+    name: "FileTrack",
+    order: 14,
+    before(ctx) {
+        // Initialize trackedFiles immutably on first pass so after() never mutates ctx
+        if (!ctx.trackedFiles) {
+            return { ...ctx, trackedFiles: new Set() };
+        }
+        return ctx;
+    },
+    after(ctx, result) {
+        if (result.filePath && ctx.trackedFiles) {
+            // Set.add is the Set's own API — ctx property reference is unchanged
+            ctx.trackedFiles.add(result.filePath);
+        }
+        return result;
+    },
+};
+// ── Layer 15: Forced Verification — auto-verify after writes ─
+export const forcedVerificationMiddleware = {
+    name: "ForcedVerification",
+    order: 15,
+    async after(ctx, result) {
+        if (!result.toolName || !["Write", "Edit"].includes(result.toolName)) {
+            return result;
+        }
+        // Run typecheck if the file is TypeScript
+        if (result.filePath?.endsWith(".ts") || result.filePath?.endsWith(".tsx")) {
+            const [binary, ...args] = detectTypecheckCommand(ctx.workingDir);
+            const verification = runSandboxedCommandSync(binary, args, {
+                workingDir: ctx.workingDir,
+                timeoutMs: 30_000,
+                allowNetwork: false,
+            });
+            if (!verification.success) {
+                const stderr = verification.output || "Type check failed";
+                return {
+                    ...result,
+                    followUp: `Verification failed (typecheck):\n${stderr.slice(0, 500)}\nFix before continuing.`,
+                };
+            }
+        }
+        return result;
+    },
+};
+function detectTypecheckCommand(workingDir) {
+    const packagePath = join(workingDir, "package.json");
+    if (!existsSync(packagePath)) {
+        return ["npx", "tsc", "--noEmit"];
+    }
+    try {
+        const pkg = JSON.parse(readFileSync(packagePath, "utf-8"));
+        if (pkg.scripts?.["typecheck"]) {
+            return [detectRunner(workingDir), "run", "typecheck"];
+        }
+    }
+    catch {
+        // Fall through to the generic compiler check.
+    }
+    return ["npx", "tsc", "--noEmit"];
+}
+function detectRunner(workingDir) {
+    if (existsSync(join(workingDir, "pnpm-lock.yaml")))
+        return "pnpm";
+    if (existsSync(join(workingDir, "yarn.lock")))
+        return "yarn";
+    return "npm";
+}
+// ── Layer 16: Frustration Detection — 21 regex patterns, <5ms ─
+const FRUSTRATION_PATTERNS = [
+    /\bwtf\b/i,
+    /\bwhy (won't|doesn't|can't|isn't)\b/i,
+    /\bstill (broken|failing|wrong|not working)\b/i,
+    /\bagain\?/i,
+    /\bthis (doesn't|won't|can't) work\b/i,
+    /\bi (already|just) (told|said|asked)\b/i,
+    /\bstop (doing|making|repeating)\b/i,
+    /\bthat's (wrong|incorrect|not what)\b/i,
+    /\bno,?\s+(that's|you)\b/i,
+    /!{3,}/,
+    /\bugh\b/i,
+    /\bfrustrat/i,
+    /\bannoy/i,
+    /\bfor the (nth|100th|tenth) time\b/i,
+    /\byou keep\b/i,
+    /\bsame (mistake|error|issue|problem)\b/i,
+    /\bnot what I (asked|wanted|meant)\b/i,
+    /\bplease (just|actually|really)\b/i,
+    /\bi said\b.*\bnot\b/i,
+    /\bdo(n't| not) (understand|get it|listen)\b/i,
+    /\bworse\b/i,
+];
+export function detectFrustration(message) {
+    const matched = [];
+    for (const pattern of FRUSTRATION_PATTERNS) {
+        if (pattern.test(message)) {
+            const match = message.match(pattern);
+            if (match?.[0])
+                matched.push(match[0]);
+        }
+    }
+    return { detected: matched.length >= 1, patterns: matched };
+}
+export const frustrationMiddleware = {
+    name: "Frustration",
+    order: 16,
+    before(ctx) {
+        const result = detectFrustration(ctx.userMessage);
+        return {
+            ...ctx,
+            frustrationDetected: result.detected,
+            frustrationPatterns: result.patterns,
+        };
+    },
+};
+// ── Layer 17B: Self-Reflection — post-response quality check ──
+/**
+ * Patterns that indicate a response may contain hallucinated file paths.
+ * Matches absolute paths that look plausible but are commonly fabricated.
+ */
+const HALLUCINATED_PATH_PATTERNS = [
+    /(?:\/usr\/local\/lib|\/home\/user|\/Users\/username|\/var\/lib)\/[\w./-]+/,
+    /[A-Z]:\\(?:Users|Program Files)\\[\w\\.-]+/,
+    /(?:~\/|\.\.\/){2,}[\w./-]+/,
+];
+/**
+ * Phrases that indicate an incomplete or hedging response.
+ */
+const INCOMPLETE_INDICATORS = [
+    /\bI (?:can't|cannot|don't have|am unable to) (?:actually |really )?(?:access|read|see|check|verify|run|execute)\b/i,
+    /\bI would need (?:to|more|additional)\b/i,
+    /\bI('m| am) not (?:sure|certain|able)\b/i,
+    /\bthis (?:may|might|could|should) work\b/i,
+    /\buntested\b/i,
+    /\bI'll leave (?:that|this|it) (?:to|for|as)\b/i,
+    /\bTODO\b/,
+    /\bFIXME\b/,
+    /\.{3,}\s*$/m, // trailing ellipsis suggesting truncation
+];
+/**
+ * Patterns that indicate internal contradictions within a response.
+ * Each pair detects opposing claims appearing in the same text.
+ */
+const CONTRADICTION_PAIRS = [
+    [
+        /\bfile (?:exists|is present|was found)\b/i,
+        /\bfile (?:does not exist|not found|is missing)\b/i,
+    ],
+    [/\bsucceeded|success(?:ful(?:ly)?)\b/i, /\bfailed|failure|error occurred\b/i],
+    [/\bis (?:enabled|active|on|running)\b/i, /\bis (?:disabled|inactive|off|stopped)\b/i],
+    [/\bno (?:errors?|issues?|problems?)\b/i, /\berror|issue|problem/i],
+];
+/**
+ * Analyze a model response for common quality issues.
+ * Returns an array of detected issues (empty if the response looks clean).
+ */
+export function analyzeResponseQuality(response, _originalQuery) {
+    const issues = [];
+    // Check for hallucinated file paths
+    for (const pattern of HALLUCINATED_PATH_PATTERNS) {
+        const match = response.match(pattern);
+        if (match?.[0]) {
+            issues.push({
+                type: "hallucinated-path",
+                evidence: match[0],
+                severity: "medium",
+            });
+        }
+    }
+    // Check for incomplete/hedging indicators
+    const incompleteMatches = [];
+    for (const pattern of INCOMPLETE_INDICATORS) {
+        const match = response.match(pattern);
+        if (match?.[0]) {
+            incompleteMatches.push(match[0]);
+        }
+    }
+    // Only flag as incomplete if multiple indicators are present (single hedges are normal)
+    if (incompleteMatches.length >= 2) {
+        issues.push({
+            type: "incomplete",
+            evidence: incompleteMatches.slice(0, 3).join("; "),
+            severity: "high",
+        });
+    }
+    // Check for contradictions
+    for (const [positive, negative] of CONTRADICTION_PAIRS) {
+        if (positive.test(response) && negative.test(response)) {
+            const posMatch = response.match(positive)?.[0] ?? "";
+            const negMatch = response.match(negative)?.[0] ?? "";
+            issues.push({
+                type: "contradiction",
+                evidence: `"${posMatch}" vs "${negMatch}"`,
+                severity: "high",
+            });
+        }
+    }
+    return issues;
+}
+/**
+ * Format detected issues into a system notification string.
+ * Returns null if no issues were found.
+ */
+function formatReflectionNotice(issues) {
+    if (issues.length === 0)
+        return null;
+    const lines = [
+        "\n--- SELF-REFLECTION NOTICE ---",
+        "The following potential issues were detected in the response:",
+    ];
+    for (const issue of issues) {
+        const severity = issue.severity === "high" ? "(!)" : "(*)";
+        switch (issue.type) {
+            case "hallucinated-path":
+                lines.push(`  ${severity} Possibly hallucinated path: ${issue.evidence} — verify this path exists`);
+                break;
+            case "incomplete":
+                lines.push(`  ${severity} Response may be incomplete: ${issue.evidence} — consider providing a concrete answer`);
+                break;
+            case "contradiction":
+                lines.push(`  ${severity} Contradictory statements detected: ${issue.evidence} — re-check for consistency`);
+                break;
+        }
+    }
+    lines.push("--- END SELF-REFLECTION ---");
+    return lines.join("\n");
+}
+/**
+ * Self-Reflection middleware layer.
+ *
+ * Runs AFTER the model responds. Inspects the response for common quality
+ * issues: incomplete answers, hallucinated file paths, and contradictions.
+ * If issues are found, a follow-up notification is attached suggesting
+ * the model re-check its output.
+ *
+ * This is a post-processing hook — it does NOT re-query the model.
+ */
+export const selfReflectionMiddleware = {
+    name: "SelfReflection",
+    order: 17,
+    after(ctx, result) {
+        // Only analyze text responses (not tool results)
+        if (!result.content || result.toolName)
+            return result;
+        const issues = analyzeResponseQuality(result.content, ctx.userMessage);
+        const notice = formatReflectionNotice(issues);
+        if (!notice)
+            return result;
+        // Attach the self-reflection notice as a followUp for the agent to consider
+        const existingFollowUp = result.followUp ? `${result.followUp}\n` : "";
+        return { ...result, followUp: `${existingFollowUp}${notice}` };
+    },
+};
+// ── Layer 5.7: Trifecta Guard — Simon Willison's lethal-trifecta gate ────
+//
+// T10.4 registration. The underlying factory + classifier live in
+// `./trifecta-guard.ts`; this file simply EXPOSES the middleware adapter so
+// the pipeline can slot it in next to the other layers. Position is AFTER
+// approval-queue (layer 5.5 GuardrailProvider) so the guard runs BEFORE the
+// tool executes but can itself invoke the approval queue when the lethal
+// trifecta fires. Keeping the adapter here preserves the single-file
+// registry convention established by the other 30 layers.
+//
+// Wiring: production callers supply an `ApprovalHandler` (typically the
+// ApprovalQueue's enqueue+await pattern). Tests pass a stub handler so they
+// can assert on classification/evaluation without spinning up the queue.
+export const TRIFECTA_GUARD_NAME = "TrifectaGuard";
+/**
+ * Adapt the trifecta-guard into the standard Middleware interface. Callers
+ * inject an `ApprovalHandler` (the production queue; tests pass a stub) and
+ * optional `contextProvider` that turns the in-flight `MiddlewareContext`
+ * into a `TrifectaContext`. When no toolName is resolvable, the layer is a
+ * no-op — that preserves QB #6 (honest failures: don't invent tool-call
+ * signals from thin air).
+ */
+export function createTrifectaGuardMiddleware(options) {
+    const guard = createTrifectaGuard({
+        approvalHandler: options.approvalHandler,
+        ...(options.strictMode !== undefined ? { strictMode: options.strictMode } : {}),
+    });
+    return {
+        name: TRIFECTA_GUARD_NAME,
+        order: 5.7,
+        async before(ctx) {
+            const trifectaCtx = options.contextProvider?.(ctx);
+            if (!trifectaCtx)
+                return ctx;
+            const verdict = await guard.inspect(trifectaCtx);
+            // Attach the verdict to the ctx via a typed extension so downstream
+            // layers + the runtime can surface the decision in audit logs.
+            return {
+                ...ctx,
+                trifectaVerdict: verdict,
+            };
+        },
+    };
+}
+//# sourceMappingURL=layers.js.map

package/dist/middleware/layers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layers.js","sourceRoot":"","sources":["../../src/middleware/layers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EACL,mBAAmB,GAGpB,MAAM,qBAAqB,CAAC;AAM7B,gEAAgE;AAEhE,MAAM,CAAC,MAAM,oBAAoB,GAAe;IAC9C,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE,CAAC;IACR,MAAM,CAAC,GAAsB;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;QAC5E,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,EAAE,GAAG,GAAG,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;CACF,CAAC;AAEF,gEAAgE;AAEhE,MAAM,CAAC,MAAM,iBAAiB,GAAe;IAC3C,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,CAAC;IACR,MAAM,CAAC,GAAsB;QAC3B,kEAAkE;QAClE,MAAM,cAAc,GAAG,cAAc,CAAC;QACtC,IAAI,eAAe,GAAG,GAAG,CAAC,WAAW,CAAC;QACtC,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QACzD,MAAM,aAAa,GAAa,EAAE,CAAC;QAEnC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC;gBAC3D,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QAED,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,eAAe,GAAG,GAAG,GAAG,CAAC,WAAW,0BAA0B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QAC5F,CAAC;QAED,OAAO,EAAE,GAAG,GAAG,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC;IACjE,CAAC;CACF,CAAC;AAEF,sEAAsE;AAEtE,MAAM,CAAC,MAAM,iBAAiB,GAAe;IAC3C,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,CAAC;IACR,MAAM,CAAC,GAAsB;QAC3B,2CAA2C;QAC3C,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC;QAChC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,GAAG,GAAG,EAAE,YAAY,EAAE,kCAAkC,EAAE,CAAC;QACtE,CAAC;QACD,OAAO,EAAE,GAAG,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC;CACF,CAAC;AAEF,gEAAgE;AAEhE,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,CAAC;IACR,MAAM,CAAC,GAAsB;QAC3B,wEAAwE;QACxE,MAAM,mBAAmB,GAAG,+DAA+D,CAAC;QAC5F,MAAM,cAAc,GAAG,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACjE,OAAO,EAAE,GAAG,GAAG,EAAE,kBAAkB,EAAE,cAAc,EAAE,CAAC;IACxD,CAAC;CACF,CAAC;AAEF,gEAAgE;AAEhE,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,CAAC;IACR,KAAK,CAAC,IAAuB,EAAE,MAAmB;QAChD,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACtC,yDAAyD;YACzD,MAAM,iBAAiB,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAC3D,CAAC,CAAC,MAAM,CAAC,OAAO;gBAChB,CAAC,CAAC,UAAU,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/B,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;QACnD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC;AAEF,gEAAgE;AAChE,EAAE;AACF,4DAA4D;AAC5D,gEAAgE;AAChE,4DAA4D;AAC5D,qDAAqD;AACrD,iEAAiE;AACjE,2DAA2D;AAC3D,+DAA+D;AAC/D,6DAA6D;AAC7D,8DAA8D;AAE9D,MAAM,CAAC,MAAM,uBAAuB,GAAe;IACjD,IAAI,EAAE,eAAe;IACrB,KAAK,EAAE,CAAC;IACR,MAAM,CAAC,GAAsB;QAC3B,MAAM,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC,MAAM,CAC5C,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,EACrD,CAAC,CACF,CAAC;QACF,+DAA+D;QAC/D,6DAA6D;QAC7D,oDAAoD;QACpD,MAAM,YAAY,GAAG,qBAAqB,EAAE,CAAC;QAC7C,8DAA8D;QAC9D,8DAA8D;QAC9D,uBAAuB;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,aAAa,GAAG,YAAY,CAAC,GAAG,GAAG,CAAC,CAAC;QAChE,MAAM,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QAC9D,MAAM,kBAAkB,GAAG,MAAM,GAAG,EAAE,CAAC;QAEvC,OAAO,EAAE,GAAG,GAAG,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,CAAC;IAChF,CAAC;CACF,CAAC;AAEF;;;;;;GAMG;AACH,IAAI,kBAAkB,GAAkB,IAAI,CAAC;AAC7C,SAAS,qBAAqB;IAC5B,IAAI,kBAAkB,KAAK,IAAI;QAAE,OAAO,kBAAkB,CAAC;IAC3D,4DAA4D;IAC5D,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;QAC5E,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC7B,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;QAAE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3D,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QAAE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/F,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;QAAE,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACnE,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QAAE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrF,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAAE,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACrF,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QAAE,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACzD,kBAAkB,GAAG,uBAAuB,CAAC,SAAS,CAAC,CAAC;IACxD,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED;;kEAEkE;AAClE,MAAM,UAAU,+BAA+B;IAC7C,kBAAkB,GAAG,IAAI,CAAC;AAC5B,CAAC;AAED,gEAAgE;AAEhE,MAAM,CAAC,MAAM,gBAAgB,GAAe;IAC1C,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,CAAC;IACR,KAAK,CAAC,GAAsB,EAAE,MAAmB;QAC/C,yDAAyD;QACzD,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,MAAM,eAAe,GAAG;gBACtB,IAAI,EAAE,MAAM,CAAC,QAAQ;gBACrB,IAAI,EAAE,MAAM,CAAC,QAAQ;gBACrB,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC;YACF,0CAA0C;YAC1C,OAAO,EAAE,GAAG,MAAM,EAAE,eAAe,EAAE,CAAC;QACxC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC;AAEF,sEAAsE;AAEtE,MAAM,iBAAiB,GAAsB;IAC3C,4CAA4C;IAC5C,4CAA4C;IAC5C,QAAQ;CACT,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAe;IACjD,IAAI,EAAE,eAAe;IACrB,KAAK,EAAE,EAAE;IACT,MAAM,CAAC,GAAsB;QAC3B,mFAAmF;QACnF,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,GAAG;YAAE,OAAO,GAAG,CAAC;QAE7C,MAAM,cAAc,GAAG,iBAAiB,CAAC,MAAM,CAC7C,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EACnE,CAAC,CACF,CAAC;QACF,OAAO,EAAE,GAAG,GAAG,EAAE,cAAc,EAAE,kBAAkB,EAAE,cAAc,IAAI,CAAC,EAAE,CAAC;IAC7E,CAAC;CACF,CAAC;AAEF,gEAAgE;AAEhE,MAAM,UAAU,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;AAE5D,MAAM,CAAC,MAAM,eAAe,GAAe;IACzC,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,EAAE;IACT,MAAM,CAAC,GAAsB;QAC3B,UAAU,CAAC,aAAa,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,UAAU,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9F,OAAO,EAAE,GAAG,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;IAC3C,CAAC;IACD,KAAK,CAAC,IAAuB,EAAE,MAAmB;QAChD,uDAAuD;QACvD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,UAAU,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,MAAM,EAAE,CAAC;QACtB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC;AAEF,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,GAAG,UAAU;QACb,OAAO,EAAE,UAAU,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;KACvF,CAAC;AACJ,CAAC;AAED,gEAAgE;AAEhE,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,MAAgB;IACzD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IACtD,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IAC1D,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAe;IAC5C,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,EAAE;IACT,MAAM,CAAC,GAAsB;QAC3B,+CAA+C;QAC/C,MAAM,IAAI,GAAc,GAAG,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QACtE,OAAO,EAAE,GAAG,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACrC,CAAC;CACF,CAAC;AAEF,gEAAgE;AAEhE,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,EAAE;IACT,MAAM,CAAC,GAAsB;QAC3B,+EAA+E;QAC/E,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO,EAAE,GAAG,GAAG,EAAE,YAAY,EAAE,IAAI,GAAG,EAAU,EAAE,CAAC;QACrD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,KAAK,CAAC,GAAsB,EAAE,MAAmB;QAC/C,IAAI,MAAM,CAAC,QAAQ,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;YACxC,qEAAqE;YACrE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC;AAEF,gEAAgE;AAEhE,MAAM,CAAC,MAAM,4BAA4B,GAAe;IACtD,IAAI,EAAE,oBAAoB;IAC1B,KAAK,EAAE,EAAE;IACT,KAAK,CAAC,KAAK,CAAC,GAAsB,EAAE,MAAmB;QACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrE,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,0CAA0C;QAC1C,IAAI,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1E,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,sBAAsB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACjE,MAAM,YAAY,GAAG,uBAAuB,CAAC,MAAO,EAAE,IAAI,EAAE;gBAC1D,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,SAAS,EAAE,MAAM;gBACjB,YAAY,EAAE,KAAK;aACpB,CAAC,CAAC;YAEH,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;gBAC1B,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,IAAI,mBAAmB,CAAC;gBAC1D,OAAO;oBACL,GAAG,MAAM;oBACT,QAAQ,EAAE,qCAAqC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,0BAA0B;iBAC9F,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC;AAEF,SAAS,sBAAsB,CAAC,UAAkB;IAChD,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IACrD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAgB,CAAC;QAC1E,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,8CAA8C;IAChD,CAAC;IAED,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,YAAY,CAAC,UAAkB;IACtC,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IAClE,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IAC7D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,iEAAiE;AAEjE,MAAM,oBAAoB,GAAsB;IAC9C,UAAU;IACV,sCAAsC;IACtC,+CAA+C;IAC/C,YAAY;IACZ,sCAAsC;IACtC,yCAAyC;IACzC,oCAAoC;IACpC,wCAAwC;IACxC,0BAA0B;IAC1B,OAAO;IACP,UAAU;IACV,aAAa;IACb,UAAU;IACV,qCAAqC;IACrC,eAAe;IACf,yCAAyC;IACzC,sCAAsC;IACtC,oCAAoC;IACpC,sBAAsB;IACtB,8CAA8C;IAC9C,YAAY;CACb,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,OAAO,IAAI,oBAAoB,EAAE,CAAC;QAC3C,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACrC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAe;IAC/C,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,EAAE;IACT,MAAM,CAAC,GAAsB;QAC3B,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAClD,OAAO;YACL,GAAG,GAAG;YACN,mBAAmB,EAAE,MAAM,CAAC,QAAQ;YACpC,mBAAmB,EAAE,MAAM,CAAC,QAAQ;SACrC,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,iEAAiE;AAEjE;;;GAGG;AACH,MAAM,0BAA0B,GAAsB;IACpD,2EAA2E;IAC3E,4CAA4C;IAC5C,4BAA4B;CAC7B,CAAC;AAEF;;GAEG;AACH,MAAM,qBAAqB,GAAsB;IAC/C,oHAAoH;IACpH,0CAA0C;IAC1C,0CAA0C;IAC1C,2CAA2C;IAC3C,eAAe;IACf,gDAAgD;IAChD,UAAU;IACV,WAAW;IACX,aAAa,EAAE,0CAA0C;CAC1D,CAAC;AAEF;;;GAGG;AACH,MAAM,mBAAmB,GAAgC;IACvD;QACE,2CAA2C;QAC3C,mDAAmD;KACpD;IACD,CAAC,sCAAsC,EAAE,oCAAoC,CAAC;IAC9E,CAAC,uCAAuC,EAAE,2CAA2C,CAAC;IACtF,CAAC,uCAAuC,EAAE,wBAAwB,CAAC;CACpE,CAAC;AAQF;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAAgB,EAChB,cAAsB;IAEtB,MAAM,MAAM,GAA0B,EAAE,CAAC;IAEzC,oCAAoC;IACpC,KAAK,MAAM,OAAO,IAAI,0BAA0B,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,mBAAmB;gBACzB,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;gBAClB,QAAQ,EAAE,QAAQ;aACnB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,MAAM,iBAAiB,GAAa,EAAE,CAAC;IACvC,KAAK,MAAM,OAAO,IAAI,qBAAqB,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACf,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IACD,wFAAwF;IACxF,IAAI,iBAAiB,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAClD,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAC;IACL,CAAC;IAED,2BAA2B;IAC3B,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,mBAAmB,EAAE,CAAC;QACvD,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvD,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACrD,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACrD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,eAAe;gBACrB,QAAQ,EAAE,IAAI,QAAQ,SAAS,QAAQ,GAAG;gBAC1C,QAAQ,EAAE,MAAM;aACjB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,sBAAsB,CAAC,MAAsC;IACpE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAErC,MAAM,KAAK,GAAa;QACtB,kCAAkC;QAClC,+DAA+D;KAChE,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;QAC3D,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,mBAAmB;gBACtB,KAAK,CAAC,IAAI,CACR,KAAK,QAAQ,gCAAgC,KAAK,CAAC,QAAQ,4BAA4B,CACxF,CAAC;gBACF,MAAM;YACR,KAAK,YAAY;gBACf,KAAK,CAAC,IAAI,CACR,KAAK,QAAQ,gCAAgC,KAAK,CAAC,QAAQ,yCAAyC,CACrG,CAAC;gBACF,MAAM;YACR,KAAK,eAAe;gBAClB,KAAK,CAAC,IAAI,CACR,KAAK,QAAQ,uCAAuC,KAAK,CAAC,QAAQ,6BAA6B,CAChG,CAAC;gBACF,MAAM;QACV,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAe;IAClD,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,EAAE;IACT,KAAK,CAAC,GAAsB,EAAE,MAAmB;QAC/C,iDAAiD;QACjD,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,QAAQ;YAAE,OAAO,MAAM,CAAC;QAEtD,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAE9C,IAAI,CAAC,MAAM;YAAE,OAAO,MAAM,CAAC;QAE3B,4EAA4E;QAC5E,MAAM,gBAAgB,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,GAAG,gBAAgB,GAAG,MAAM,EAAE,EAAE,CAAC;IACjE,CAAC;CACF,CAAC;AAEF,4EAA4E;AAC5E,EAAE;AACF,kEAAkE;AAClE,4EAA4E;AAC5E,0EAA0E;AAC1E,4EAA4E;AAC5E,yEAAyE;AACzE,qEAAqE;AACrE,0DAA0D;AAC1D,EAAE;AACF,wEAAwE;AACxE,4EAA4E;AAC5E,yEAAyE;AAEzE,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAwB,CAAC;AAE5D;;;;;;;GAOG;AACH,MAAM,UAAU,6BAA6B,CAAC,OAI7C;IACC,MAAM,KAAK,GAAG,mBAAmB,CAAC;QAChC,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChF,CAAC,CAAC;IACH,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE,GAAG;QACV,KAAK,CAAC,MAAM,CAAC,GAAsB;YACjC,MAAM,WAAW,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,CAAC;YACnD,IAAI,CAAC,WAAW;gBAAE,OAAO,GAAG,CAAC;YAC7B,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YACjD,oEAAoE;YACpE,+DAA+D;YAC/D,OAAO;gBACL,GAAG,GAAG;gBACN,eAAe,EAAE,OAAO;aACzB,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/middleware/llm-error-handling.d.ts

@@ -0,0 +1,98 @@
+/**
+ * LLMErrorHandlingMiddleware — canonical provider-error envelope with
+ * retry policy and circuit breaker.
+ *
+ * Ported from deer-flow (bytedance/deer-flow) Lane 2:
+ *   packages/harness/deerflow/agents/middlewares/llm_error_handling_middleware.py
+ *
+ * WOTANN's provider-router retries at the transport layer but never
+ * surfaces persistent provider failures as ToolMessages the agent can
+ * observe. Without that, a 500 loop kills the graph; with it, the agent
+ * sees the error on its next turn and can adapt.
+ *
+ * Canonical error categories (5):
+ *   - rate_limit      — 429, `Retry-After` / backoff
+ *   - context_exceeded — 413 / "context length"/"too many tokens"
+ *   - invalid_request  — 400 auth / quota / schema errors (NOT retriable)
+ *   - content_filter   — provider-side content policy rejection
+ *   - server_error     — 5xx / transient network / timeouts
+ *
+ * Retry semantics:
+ *   - rate_limit + server_error: retry up to `maxRetries` with exponential
+ *     backoff (base 1000ms, cap 8000ms). Respects `Retry-After` when
+ *     the error exposes it.
+ *   - invalid_request + context_exceeded + content_filter: NOT retried —
+ *     repeating the request will not succeed.
+ */
+import type { Middleware } from "./types.js";
+export type LLMErrorCategory = "rate_limit" | "context_exceeded" | "invalid_request" | "content_filter" | "server_error" | "unknown";
+export interface LLMErrorEnvelope {
+    readonly category: LLMErrorCategory;
+    readonly retriable: boolean;
+    readonly message: string;
+    readonly httpStatus?: number;
+    readonly retryAfterMs?: number;
+    readonly provider?: string;
+}
+/**
+ * Classify an arbitrary provider error into one of the 5 canonical
+ * categories. Always returns — never throws.
+ */
+export declare function classifyLLMError(err: unknown, provider?: string): LLMErrorEnvelope;
+export interface LLMErrorOptions {
+    readonly maxRetries?: number;
+    readonly baseDelayMs?: number;
+    readonly capDelayMs?: number;
+}
+export interface LLMErrorStats {
+    readonly totalClassified: number;
+    readonly totalRetries: number;
+    readonly totalGivenUp: number;
+    readonly perCategory: Readonly<Record<LLMErrorCategory, number>>;
+}
+/**
+ * LLMErrorHandlingMiddleware normalizes provider failures and decides
+ * whether to retry. Per-session state (stats, retry counters) lives on
+ * the instance — no module globals.
+ */
+export declare class LLMErrorHandlingMiddleware {
+    private readonly maxRetries;
+    private readonly baseDelayMs;
+    private readonly capDelayMs;
+    private totalClassified;
+    private totalRetries;
+    private totalGivenUp;
+    private perCategory;
+    constructor(options?: LLMErrorOptions);
+    /**
+     * Compute the delay before retry attempt `attempt` (1-indexed). Honors
+     * `retryAfterMs` on the envelope when present, else exponential backoff
+     * capped at `capDelayMs`.
+     */
+    computeRetryDelayMs(attempt: number, envelope: LLMErrorEnvelope): number;
+    /**
+     * Classify an error and return the envelope, tracking stats.
+     */
+    classify(err: unknown, provider?: string): LLMErrorEnvelope;
+    /**
+     * Decide whether a retry should be attempted for the given error and
+     * attempt count. Returns the delay to wait (ms) if retriable, or null
+     * if the caller should give up.
+     */
+    shouldRetry(envelope: LLMErrorEnvelope, attempt: number): number | null;
+    /**
+     * Produce a user-facing message for the agent's next turn, describing
+     * the error in a way the agent can reason about.
+     */
+    buildUserMessage(envelope: LLMErrorEnvelope): string;
+    getStats(): LLMErrorStats;
+    reset(): void;
+}
+/**
+ * Create a Middleware adapter. Operates in the `after` phase: if the
+ * AgentResult carries an error flag (`success === false`) and the content
+ * looks like a raw provider error string, classify it and rewrite the
+ * follow-up with a canonical message the agent can reason about.
+ */
+export declare function createLLMErrorHandlingMiddleware(instance: LLMErrorHandlingMiddleware): Middleware;
+//# sourceMappingURL=llm-error-handling.d.ts.map

package/dist/middleware/llm-error-handling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-error-handling.d.ts","sourceRoot":"","sources":["../../src/middleware/llm-error-handling.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAkC,MAAM,YAAY,CAAC;AAI7E,MAAM,MAAM,gBAAgB,GACxB,YAAY,GACZ,kBAAkB,GAClB,iBAAiB,GACjB,gBAAgB,GAChB,cAAc,GACd,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAwGD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAiFlF;AAID,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC;CAClE;AAWD;;;;GAIG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,WAAW,CAA+D;gBAEtE,OAAO,GAAE,eAAoB;IAMzC;;;;OAIG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,MAAM;IAQxE;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,gBAAgB;IAU3D;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAavE;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM;IAiBpD,QAAQ,IAAI,aAAa;IASzB,KAAK,IAAI,IAAI;CAMd;AAID;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,0BAA0B,GAAG,UAAU,CAuBjG"}