pi-harness-runtime 0.5.0 → 0.6.3-beta.13

package/packages/context-compiler/dist/cache.js

@@ -0,0 +1,99 @@
+/**
+ * Context Compiler - Cache & Invalidation
+ *
+ * Generates deterministic cache keys from selected source hashes.
+ * Tracks invalidation triggers.
+ */
+/**
+ * Generate a deterministic cache key from compiled context items.
+ * Includes source file hashes for content invalidation.
+ */
+export function generateCacheKey(taskId, items, taskObjective) {
+    // Sort by source path for determinism
+    const hashes = items
+        .filter((item) => item.contentHash)
+        .map((item) => `${item.source}:${item.contentHash}`)
+        .sort();
+    const objectiveHash = simpleHash(taskObjective);
+    const combined = `${taskId}:${objectiveHash}:${hashes.join(",")}`;
+    return `ctx:${simpleHash(combined)}`;
+}
+/**
+ * Check if a compiled context should be invalidated.
+ *
+ * Invalidation triggers:
+ * - A selected source file hash changed
+ * - A project rule changed
+ * - A required OKF concept changed
+ * - The task objective changed
+ * - A test failure superseded an old one
+ * - Worktree branch/HEAD changed
+ */
+export function shouldInvalidate(previous, invalidation, currentItemHashes) {
+    switch (invalidation.reason) {
+        case "source_hash_changed": {
+            const changed = invalidation.details?.sourcePath;
+            if (!changed)
+                return true;
+            const item = previous.items.find((i) => i.source === changed);
+            if (!item)
+                return false;
+            const currentHash = currentItemHashes.get(changed);
+            return currentHash !== item.contentHash;
+        }
+        case "project_rule_changed": {
+            const rulePath = invalidation.details?.rulePath;
+            const ruleItem = previous.items.find((i) => i.kind === "project_rule" &&
+                (i.source === rulePath || i.filePath === rulePath));
+            return ruleItem !== undefined;
+        }
+        case "required_okf_changed": {
+            const okfId = invalidation.details?.okfId;
+            return (previous.items.find((i) => i.kind === "okf_concept" && i.id === okfId && i.required) !== undefined);
+        }
+        case "task_objective_changed": {
+            return true; // Always invalidate on objective change
+        }
+        case "test_failure_superseded": {
+            const oldFailure = invalidation.details?.oldFailureId;
+            if (!oldFailure)
+                return false;
+            const existingFailure = previous.items.find((i) => i.kind === "test_failure" && i.id === oldFailure);
+            return existingFailure !== undefined;
+        }
+        case "worktree_branch_changed": {
+            const oldBranch = invalidation.details?.oldBranch;
+            const newBranch = invalidation.details?.newBranch;
+            // Invalidate if any source file changed or if branch changed
+            return oldBranch !== newBranch;
+        }
+        default:
+            return false;
+    }
+}
+/**
+ * Generate current item hashes from a compiled context.
+ */
+export function extractItemHashes(items) {
+    const map = new Map();
+    for (const item of items) {
+        if (item.contentHash) {
+            map.set(item.source, item.contentHash);
+        }
+    }
+    return map;
+}
+/**
+ * Simple deterministic hash for strings.
+ * Used for cache keys when crypto is unavailable.
+ */
+export function simpleHash(text) {
+    let hash = 0;
+    for (let i = 0; i < text.length; i++) {
+        const char = text.charCodeAt(i);
+        hash = (hash << 5) - hash + char;
+        hash |= 0;
+    }
+    return Math.abs(hash).toString(16).padStart(8, "0");
+}
+//# sourceMappingURL=cache.js.map

package/packages/context-compiler/dist/cache.js.map

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

package/packages/context-compiler/dist/compiler.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Context Compiler - Compiler
+ *
+ * Main entry point for context compilation.
+ * Pipeline: collect → policy filter → score → deduplicate → fit budget → source graph.
+ */
+import type { ContextCompileRequest, ContextSourceEdge, OmittedItem } from "./types.js";
+import { toCompiledItems } from "./budget.js";
+/**
+ * Default clock for generating timestamps.
+ */
+export declare function createClock(): {
+    now: () => Date;
+};
+export interface Clock {
+    now: () => Date;
+}
+/**
+ * Compile context from candidates.
+ *
+ * Pipeline:
+ * 1. Apply policy filter (deny patterns, size limits)
+ * 2. Score optional candidates
+ * 3. Merge file slices
+ * 4. Deduplicate
+ * 5. Fit to token budget
+ * 6. Generate source graph
+ * 7. Return CompiledContext
+ */
+export declare function compileContext(request: ContextCompileRequest, clock?: Clock): Promise<CompiledContextOutput>;
+/**
+ * Compiled context output (extended with cache key).
+ */
+export interface CompiledContextOutput {
+    taskId: string;
+    items: ReturnType<typeof toCompiledItems>[number][];
+    omitted: OmittedItem[];
+    estimatedTokens: number;
+    sourceGraph: ContextSourceEdge[];
+    generatedAt: string;
+    mapping: Record<string, string>;
+    cacheKey: string;
+}
+/**
+ * Enrich context candidates with OKF concepts from ~/.pi/okf/.
+ *
+ * This is optional - if the OKF directory doesn't exist,
+ * candidates remain unchanged.
+ *
+ * Usage:
+ * ```ts
+ * const enriched = enrichWithOkf(candidates);
+ * const result = await compileContext({ ...request, candidates: enriched });
+ * ```
+ */
+export declare function enrichWithOkf(candidates: ContextCompileRequest["candidates"], okfPath?: string): ContextCompileRequest["candidates"];
+//# sourceMappingURL=compiler.d.ts.map

package/packages/context-compiler/dist/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,qBAAqB,EACrB,iBAAiB,EAEjB,WAAW,EACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EAA+B,eAAe,EAAE,MAAM,aAAa,CAAC;AAW3E;;GAEG;AACH,wBAAgB,WAAW;;EAE1B;AAED,MAAM,WAAW,KAAK;IACrB,GAAG,EAAE,MAAM,IAAI,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CACnC,OAAO,EAAE,qBAAqB,EAC9B,KAAK,GAAE,KAAqB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CAgHhC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACpD,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;CACjB;AAoGD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC5B,UAAU,EAAE,qBAAqB,CAAC,YAAY,CAAC,EAC/C,OAAO,CAAC,EAAE,MAAM,GACd,qBAAqB,CAAC,YAAY,CAAC,CAoBrC"}

package/packages/context-compiler/dist/compiler.js

@@ -0,0 +1,219 @@
+/**
+ * Context Compiler - Compiler
+ *
+ * Main entry point for context compilation.
+ * Pipeline: collect → policy filter → score → deduplicate → fit budget → source graph.
+ */
+import { ContextCompileError } from "./types.js";
+import { estimateTokens, fitToBudget, toCompiledItems } from "./budget.js";
+import { generateCacheKey } from "./cache.js";
+import { deduplicateCandidates, mergeFileSlices } from "./deduplicate.js";
+import { applyPolicyFilter, mergePolicy } from "./filter.js";
+import { mergeWeights, rankCandidates } from "./score.js";
+import { loadOkfConcepts, okfDirectoryExists, getOkfPath, } from "./okf-loader.js";
+/**
+ * Default clock for generating timestamps.
+ */
+export function createClock() {
+    return { now: () => new Date() };
+}
+/**
+ * Compile context from candidates.
+ *
+ * Pipeline:
+ * 1. Apply policy filter (deny patterns, size limits)
+ * 2. Score optional candidates
+ * 3. Merge file slices
+ * 4. Deduplicate
+ * 5. Fit to token budget
+ * 6. Generate source graph
+ * 7. Return CompiledContext
+ */
+export async function compileContext(request, clock = createClock()) {
+    const { taskId, taskObjective, maximumTokens, candidates, scoringWeights, policy, } = request;
+    // 0. Validate required sources exist
+    const missingRequired = candidates
+        .filter((c) => c.required)
+        .filter((c) => !c.content.trim());
+    if (missingRequired.length > 0) {
+        const first = missingRequired[0];
+        if (!first)
+            throw new Error("Internal: missingRequired should not be empty");
+        throw new ContextCompileError("MISSING_REQUIRED_SOURCE", `Required source "${first.source}" has no content`, {
+            missingSources: missingRequired.map((c) => c.source),
+        });
+    }
+    // 1. Apply policy filter
+    const resolvedPolicy = mergePolicy(policy);
+    const { passed: policyPassed, denied: policyDenied } = applyPolicyFilter(candidates, resolvedPolicy);
+    const policyOmitted = policyDenied.map(({ candidate, reason }) => ({
+        id: candidate.id,
+        kind: candidate.kind,
+        reason: "policy_denied",
+        reasonDetail: reason,
+        estimatedTokens: estimateTokens(candidate.content),
+        deniedBy: reason,
+    }));
+    // 2. Score optional candidates
+    const weights = mergeWeights(scoringWeights);
+    const scoreContext = {
+        directFileReferences: extractDirectReferences(taskObjective),
+        taskDependencies: extractDependencies(taskObjective),
+    };
+    // 3. Merge file slices (before scoring)
+    const merged = mergeFileSlices(policyPassed);
+    // 4. Deduplicate
+    const { unique: deduped, duplicates: dupIds } = deduplicateCandidates(merged);
+    const dedupOmitted = dupIds.map((id) => {
+        const c = candidates.find((x) => x.id === id);
+        return {
+            id,
+            kind: c?.kind ?? "source_file",
+            reason: "duplicate",
+            reasonDetail: `duplicate of ${c?.source ?? id}`,
+            estimatedTokens: estimateTokens(c?.content ?? ""),
+        };
+    });
+    // 5. Rank by score
+    const ranked = rankCandidates(deduped, weights, scoreContext);
+    // 6. Fit to budget
+    const { included, omitted: budgetOmitted } = fitToBudget(ranked, maximumTokens);
+    // 7. Convert to compiled items
+    const compiledItems = toCompiledItems(included);
+    // 8. Generate source graph
+    const sourceGraph = buildSourceGraph(compiledItems);
+    // 9. Generate cache key
+    const cacheKey = generateCacheKey(taskId, compiledItems, taskObjective);
+    // 10. Build mapping
+    const mapping = {};
+    for (const c of candidates) {
+        const compiled = compiledItems.find((i) => i.id === c.id);
+        if (compiled) {
+            mapping[c.id] = compiled.id;
+        }
+    }
+    const totalOmitted = [...policyOmitted, ...dedupOmitted, ...budgetOmitted];
+    return {
+        taskId,
+        items: compiledItems,
+        omitted: totalOmitted,
+        estimatedTokens: compiledItems.reduce((sum, item) => sum + item.estimatedTokens, 0),
+        sourceGraph,
+        generatedAt: clock.now().toISOString(),
+        mapping,
+        cacheKey,
+    };
+}
+/**
+ * Extract direct file references from task objective.
+ * Looks for quoted paths, file patterns.
+ */
+function extractDirectReferences(objective) {
+    const refs = new Set();
+    // Match quoted paths
+    const quotedMatches = objective.matchAll(/(["'`])([^`1]+)\1/g);
+    for (const match of quotedMatches) {
+        const path = match[2];
+        if (path)
+            refs.add(path);
+    }
+    // Match common file patterns
+    const filePattern = /[a-zA-Z][a-zA-Z0-9_/-]*\.(ts|tsx|js|jsx|py|go|rs|java|cpp|h|c|md|json|yaml|yml|toml)\b/g;
+    for (const match of objective.matchAll(filePattern)) {
+        const path = match[0];
+        if (path)
+            refs.add(path);
+    }
+    return refs;
+}
+/**
+ * Extract dependency references from task objective.
+ */
+function extractDependencies(objective) {
+    const deps = [];
+    // Match "depends on X", "related to Y"
+    const depPatterns = [
+        /(?:depends on|related to|imports from)\s+([A-Za-z][A-Za-z0-9_.-]*)/gi,
+    ];
+    for (const pattern of depPatterns) {
+        for (const match of objective.matchAll(pattern)) {
+            const name = match[1];
+            if (name)
+                deps.push(name);
+        }
+    }
+    return [...new Set(deps)];
+}
+/**
+ * Build source graph edges between related items.
+ */
+function buildSourceGraph(items) {
+    const edges = [];
+    const okfItems = items.filter((i) => i.kind === "okf_concept");
+    const sourceItems = items.filter((i) => i.kind === "source_file");
+    const testItems = items.filter((i) => i.kind === "test_failure");
+    // OKF concepts → source files they reference
+    for (const okf of okfItems) {
+        for (const src of sourceItems) {
+            if (okf.content.includes(src.source) ||
+                (src.filePath && okf.content.includes(src.filePath))) {
+                edges.push({
+                    from: okf.id,
+                    to: src.id,
+                    label: "references",
+                    weight: 3,
+                });
+            }
+        }
+    }
+    // Source files → test failures they relate to
+    for (const src of sourceItems) {
+        for (const test of testItems) {
+            if (test.content.includes(src.source) ||
+                (src.filePath && test.content.includes(src.filePath))) {
+                edges.push({
+                    from: src.id,
+                    to: test.id,
+                    label: "causes_failure",
+                    weight: 5,
+                });
+            }
+        }
+    }
+    // Sort edges deterministically
+    edges.sort((a, b) => {
+        const keyA = `${a.from}:${a.to}:${a.label}`;
+        const keyB = `${b.from}:${b.to}:${b.label}`;
+        return keyA.localeCompare(keyB);
+    });
+    return edges;
+}
+// ─── OKF Integration ────────────────────────────────────────────────────────
+/**
+ * Enrich context candidates with OKF concepts from ~/.pi/okf/.
+ *
+ * This is optional - if the OKF directory doesn't exist,
+ * candidates remain unchanged.
+ *
+ * Usage:
+ * ```ts
+ * const enriched = enrichWithOkf(candidates);
+ * const result = await compileContext({ ...request, candidates: enriched });
+ * ```
+ */
+export function enrichWithOkf(candidates, okfPath) {
+    const okfConcepts = loadOkfConcepts(okfPath);
+    if (okfConcepts.length === 0) {
+        return candidates;
+    }
+    // Log for debugging (can be removed in production)
+    if (okfDirectoryExists(okfPath)) {
+        console.log(`[OKF] Loaded ${okfConcepts.length} concepts from ${getOkfPath()}`);
+    }
+    // Merge OKF concepts with existing candidates
+    // Existing candidates take precedence (won't be overwritten)
+    const existingIds = new Set(candidates.map((c) => c.id));
+    const newConcepts = okfConcepts.filter((c) => !existingIds.has(c.id));
+    return [...candidates, ...newConcepts];
+}
+//# sourceMappingURL=compiler.js.map

package/packages/context-compiler/dist/compiler.js.map

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

package/packages/context-compiler/dist/deduplicate.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Context Compiler - Deduplication
+ *
+ * Removes duplicate candidates and merges overlapping source file slices.
+ * Uses content normalization for deduplication (same as RFC-0041).
+ */
+import type { ContextCandidate } from "./types.js";
+/**
+ * Deduplicate candidates by normalized content.
+ * Required candidates are never deduplicated (preserved).
+ *
+ * For source files with overlapping ranges, merge into a single slice.
+ *
+ * @returns [uniqueCandidates, duplicateIds]
+ */
+export declare function deduplicateCandidates(candidates: ContextCandidate[]): {
+    unique: ContextCandidate[];
+    duplicates: string[];
+};
+/**
+ * Merge overlapping file slices from the same file.
+ * Merges adjacent/overlapping line ranges and deduplicates symbols.
+ */
+export declare function mergeFileSlices(candidates: ContextCandidate[]): ContextCandidate[];
+//# sourceMappingURL=deduplicate.d.ts.map

package/packages/context-compiler/dist/deduplicate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deduplicate.d.ts","sourceRoot":"","sources":["../src/deduplicate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,gBAAgB,EAAE,GAAG;IACtE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,EAAE,CAAC;CACrB,CAwBA;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,UAAU,EAAE,gBAAgB,EAAE,GAC5B,gBAAgB,EAAE,CAoCpB"}

package/packages/context-compiler/dist/deduplicate.js

@@ -0,0 +1,146 @@
+/**
+ * Context Compiler - Deduplication
+ *
+ * Removes duplicate candidates and merges overlapping source file slices.
+ * Uses content normalization for deduplication (same as RFC-0041).
+ */
+/**
+ * Deduplicate candidates by normalized content.
+ * Required candidates are never deduplicated (preserved).
+ *
+ * For source files with overlapping ranges, merge into a single slice.
+ *
+ * @returns [uniqueCandidates, duplicateIds]
+ */
+export function deduplicateCandidates(candidates) {
+    const seen = new Map();
+    const duplicates = [];
+    for (const candidate of candidates) {
+        // Required items are never deduplicated
+        if (candidate.required) {
+            seen.set(candidate.id, candidate);
+            continue;
+        }
+        const normalized = normalizeContent(candidate.content);
+        if (seen.has(normalized)) {
+            duplicates.push(candidate.id);
+        }
+        else {
+            seen.set(normalized, candidate);
+        }
+    }
+    return {
+        unique: [...seen.values()],
+        duplicates,
+    };
+}
+/**
+ * Merge overlapping file slices from the same file.
+ * Merges adjacent/overlapping line ranges and deduplicates symbols.
+ */
+export function mergeFileSlices(candidates) {
+    // Group by file path
+    const byFile = new Map();
+    for (const c of candidates) {
+        if (c.kind === "source_file" && c.filePath) {
+            const existing = byFile.get(c.filePath);
+            if (existing) {
+                existing.push(c);
+            }
+            else {
+                byFile.set(c.filePath, [c]);
+            }
+        }
+        else {
+            // Non-source-file candidates pass through
+        }
+    }
+    const result = [];
+    for (const candidate of candidates) {
+        if (candidate.kind === "source_file" && candidate.filePath) {
+            // Only process once (first candidate for each file)
+            const slices = byFile.get(candidate.filePath) ?? [];
+            if (slices[0] !== candidate)
+                continue;
+            if (slices.length === 1) {
+                result.push(candidate);
+            }
+            else {
+                // Merge multiple slices
+                result.push(mergeSlicesForFile(candidate.filePath, slices));
+            }
+        }
+        else {
+            result.push(candidate);
+        }
+    }
+    return result;
+}
+/**
+ * Merge multiple slices from the same file.
+ */
+function mergeSlicesForFile(filePath, slices) {
+    // Sort by startLine
+    const sorted = [...slices].sort((a, b) => (a.startLine ?? 0) - (b.startLine ?? 0));
+    const first = sorted[0] ?? {
+        id: "",
+        kind: "source_file",
+        content: "",
+        source: "",
+        priority: 0,
+        required: false,
+        trust: "unverified",
+    };
+    let endLine = first.endLine ?? 0;
+    const allSymbols = new Set();
+    const allSources = new Set();
+    for (const slice of sorted) {
+        if (slice.endLine && slice.endLine > endLine) {
+            endLine = slice.endLine;
+        }
+        for (const sym of slice.symbols ?? []) {
+            allSymbols.add(sym);
+        }
+        allSources.add(slice.source);
+    }
+    // Combine content from all slices
+    const combinedContent = sorted.map((s) => s.content).join("\n...\n");
+    return {
+        id: first.id,
+        kind: "source_file",
+        content: combinedContent,
+        source: [...allSources].join("; "),
+        priority: Math.max(...sorted.map((s) => s.priority)),
+        required: sorted.some((s) => s.required),
+        trust: sorted.find((s) => s.trust === "authoritative")
+            ? "authoritative"
+            : sorted.find((s) => s.trust === "generated")
+                ? "generated"
+                : "unverified",
+        filePath,
+        startLine: first.startLine,
+        endLine,
+        symbols: [...allSymbols],
+        contentHash: sorted[0]?.contentHash,
+    };
+}
+/**
+ * Normalize content for deduplication comparison.
+ * Matches the RFC-0041 deduplication formula.
+ */
+function normalizeContent(text) {
+    return collapseWhitespace(stripMarkdownDecoration(text.toLowerCase()));
+}
+function collapseWhitespace(text) {
+    return text.replace(/\s+/g, " ").trim();
+}
+function stripMarkdownDecoration(text) {
+    return text
+        .replace(/\[([^\]]+)\]\(([^)]*)\)/g, "$1")
+        .replace(/!\[([^\]]*)\]\(([^)]*)\)/g, "$1")
+        .replace(/[#*_`~>[\]]/g, "")
+        .replace(/```[\s\S]*?```/g, "")
+        .replace(/`([^`]+)`/g, "$1")
+        .trim();
+}
+//# sourceMappingURL=deduplicate.js.map

package/packages/context-compiler/dist/deduplicate.js.map

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

package/packages/context-compiler/dist/filter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Context Compiler - Policy Filter
+ *
+ * Enforces deny patterns and size limits before any other processing.
+ * This runs first so denied content never reaches the cache.
+ */
+import type { ContextCandidate, ContextPolicy } from "./types.js";
+/**
+ * Merge user policy with defaults.
+ */
+export declare function mergePolicy(user?: Partial<ContextPolicy>): ContextPolicy;
+/**
+ * Apply policy filters to candidates.
+ * Denied and oversized candidates are marked as omitted.
+ * This is the first stage — nothing else runs before this.
+ *
+ * @returns [passed, denied] - denied candidates with policy_denied reason
+ */
+export declare function applyPolicyFilter(candidates: ContextCandidate[], policy: ContextPolicy): {
+    passed: ContextCandidate[];
+    denied: Array<{
+        candidate: ContextCandidate;
+        reason: string;
+    }>;
+};
+//# sourceMappingURL=filter.d.ts.map

package/packages/context-compiler/dist/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../src/filter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGlE;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAQxE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAChC,UAAU,EAAE,gBAAgB,EAAE,EAC9B,MAAM,EAAE,aAAa,GACnB;IACF,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,MAAM,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,gBAAgB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/D,CAuCA"}