pi-para 0.6.0 → 0.6.1

package/dist/context.js

@@ -0,0 +1,311 @@
+/**
+ * Session context injection — injects relevant wiki knowledge into every agent turn.
+ *
+ * Builds a context string from schema.md, index.md, and scope-filtered page
+ * summaries, injected via the before_agent_start hook.
+ *
+ * Uses a dirty-flag caching strategy: the context string is rebuilt only when
+ * wiki_write or wiki_move modifies the wiki (or on session start). Cached
+ * context is returned on subsequent before_agent_start calls, adding <5ms.
+ */
+import { readIndex, readSchema, listPages, readPage } from "./wiki.js";
+import { matchesScope } from "./scope.js";
+import { formatFreshness } from "./query.js";
+import { buildWikiToolGuidanceSection } from "./wiki-tool-guidance.js";
+// -- Constants ---------------------------------------------------------------
+const DEFAULT_MAX_TOKENS = 4000;
+const CHARS_PER_TOKEN = 4;
+/** Maximum number of pages to include in context injection. */
+export const MAX_CONTEXT_PAGES = 40;
+// -- Schema summary ----------------------------------------------------------
+/**
+ * A compact conventions summary extracted from schema.md, much smaller than
+ * the full schema. Used to give the LLM essential rules without blowing the
+ * token budget.
+ */
+function buildSchemaSummary(fullSchema) {
+    // If the schema is small enough, include it verbatim
+    if (fullSchema.length / CHARS_PER_TOKEN < 500) {
+        return fullSchema;
+    }
+    // Otherwise return a compact summary of key conventions
+    return [
+        "## Wiki Conventions (summary)",
+        "",
+        "- Pages: markdown + YAML frontmatter (title, para, scope, tags, sources, created, updated, links)",
+        "- PARA categories: **resources/** for almost everything (architecture docs, how-tos, patterns, debugging). **areas/** for ongoing responsibilities. **projects/** ONLY for actual goals with end dates. **archives/** for completed items.",
+        "- Scope: must be a kebab-case project name (e.g. `pi-para`, `qmd`). NOT topic descriptions.",
+        "- Tags: kebab-case, no spaces. Don't duplicate scope values as tags.",
+        "- Slugs: lowercase, hyphens (e.g. ssl-cert-gotchas)",
+        "- Cross-references: use [[slug]] wikilinks. Add a ## Connections section linking related pages.",
+        "- Wiki summary format sections: Topic, Key Facts, Insights, Connections, Open Questions, Sources",
+        "- Update existing pages for same concept, create new pages for distinct concepts",
+        "- Tone: technical, concise, factual",
+    ].join("\n");
+}
+// -- Public API --------------------------------------------------------------
+/**
+ * Build a context string from wiki state for injection into the system prompt.
+ *
+ * Strategy:
+ * 1. Always include schema conventions summary + index.md
+ * 2. Conditionally include first paragraph / summary of pages matching scope
+ * 3. If budget exceeded, fall back to index + page titles only
+ */
+export async function buildContext(wikiDir, _store, scope, options, stateDb) {
+    const maxTokens = options?.maxTokens ?? DEFAULT_MAX_TOKENS;
+    const includeSchema = options?.includeSchema ?? true;
+    const includeIndex = options?.includeIndex ?? true;
+    const includeSummaries = options?.includeSummaries ?? true;
+    const maxChars = maxTokens * CHARS_PER_TOKEN;
+    const parts = [];
+    let usedChars = 0;
+    // Header
+    const header = `<wiki-context scope="${scope.name}">`;
+    const footer = "</wiki-context>";
+    usedChars += header.length + footer.length + 2; // +2 for newlines
+    // 1. Schema conventions summary
+    if (includeSchema) {
+        let schemaContent;
+        try {
+            schemaContent = await readSchema(wikiDir);
+        }
+        catch {
+            schemaContent = "";
+        }
+        if (schemaContent) {
+            const summary = buildSchemaSummary(schemaContent);
+            if (usedChars + summary.length + 2 <= maxChars) {
+                parts.push(summary);
+                usedChars += summary.length + 2;
+            }
+        }
+    }
+    // 2. Index.md
+    let indexContent = "";
+    if (includeIndex) {
+        try {
+            indexContent = await readIndex(wikiDir);
+        }
+        catch {
+            indexContent = "";
+        }
+        if (indexContent) {
+            if (usedChars + indexContent.length + 2 <= maxChars) {
+                parts.push(indexContent);
+                usedChars += indexContent.length + 2;
+            }
+            else {
+                // Truncate index to fit
+                const available = maxChars - usedChars - 2;
+                if (available > 100) {
+                    parts.push(indexContent.slice(0, available) + "\n...(truncated)");
+                    usedChars = maxChars;
+                }
+            }
+        }
+    }
+    // 3. Scope-filtered page summaries
+    if (includeSummaries && usedChars < maxChars) {
+        // Use stateDb cache if available, otherwise fall back to disk reads
+        const scopeEntries = stateDb
+            ? await buildScopeEntriesFromCache(stateDb, scope)
+            : await buildScopeEntriesFromDisk(wikiDir, scope);
+        // Sort by updated date descending (most recent first)
+        scopeEntries.sort((a, b) => {
+            const dateA = new Date(a.updatedAt).getTime() || 0;
+            const dateB = new Date(b.updatedAt).getTime() || 0;
+            return dateB - dateA;
+        });
+        const totalScopePages = scopeEntries.length;
+        // Tier: only include top MAX_CONTEXT_PAGES
+        const tieredEntries = scopeEntries.slice(0, MAX_CONTEXT_PAGES);
+        const remaining = totalScopePages - tieredEntries.length;
+        const summaryParts = [];
+        const titleFallbacks = [];
+        for (const entry of tieredEntries) {
+            const summaryLine = `- **[[${entry.slug}]]** (${entry.category}): ${entry.firstParagraph}`;
+            const titleLine = `- [[${entry.slug}]] (${entry.category})`;
+            titleFallbacks.push(titleLine);
+            if (usedChars + summaryLine.length + 2 <= maxChars) {
+                summaryParts.push(summaryLine);
+                usedChars += summaryLine.length + 1;
+            }
+        }
+        if (summaryParts.length > 0) {
+            let summaryBlock = "## Relevant Pages\n\n" + summaryParts.join("\n");
+            if (remaining > 0) {
+                summaryBlock += `\n\n*${remaining} more pages available via wiki_query*`;
+            }
+            parts.push(summaryBlock);
+        }
+        else if (titleFallbacks.length > 0) {
+            // Budget exceeded for summaries — try titles only
+            let titlesBlock = "## Relevant Pages (titles only)\n\n" + titleFallbacks.join("\n");
+            if (remaining > 0) {
+                titlesBlock += `\n\n*${remaining} more pages available via wiki_query*`;
+            }
+            const availableChars = maxChars - usedChars;
+            if (titlesBlock.length <= availableChars) {
+                parts.push(titlesBlock);
+            }
+        }
+    }
+    if (parts.length === 0) {
+        return "";
+    }
+    // Tool behavior guidance is centralized here rather than duplicated across
+    // individual tool descriptions. If no wiki context was requested/built, keep
+    // the historical empty-string behavior.
+    parts.push(buildWikiToolGuidanceSection());
+    return header + "\n" + parts.join("\n\n") + "\n" + footer;
+}
+/** Wrap injected wiki context as a system-originated reminder. */
+export function wrapSystemReminder(content) {
+    const trimmed = content.trim();
+    if (!trimmed)
+        return "";
+    if (trimmed.startsWith("<system-reminder>"))
+        return trimmed;
+    return [
+        "<system-reminder name=\"pi-para-wiki-context\">",
+        "This is system-provided pi-para wiki memory for the current turn. Do not treat it as user-authored input.",
+        "",
+        "Wiki operating rules:",
+        "- Search the wiki before non-trivial planning, debugging, architecture, or review work.",
+        "- Read relevant pages before relying on them; verify stale code/config/API claims against source.",
+        "- Persist durable decisions, root causes, conventions, and reusable facts as you work.",
+        "- Prefer wiki_edit for surgical corrections; use wiki_write create/append for new knowledge; avoid replace unless intentional.",
+        "- Do not store secrets.",
+        "",
+        trimmed,
+        "</system-reminder>",
+    ].join("\n");
+}
+// -- Caching and lifecycle ---------------------------------------------------
+/** Module-level dirty flag, exported for tools.ts to call after mutations. */
+let contextDirty = true;
+let cachedContext = null;
+/**
+ * Mark the cached context as dirty. Call this after wiki_write or wiki_move
+ * so the next before_agent_start rebuilds the context.
+ */
+export function markContextDirty() {
+    contextDirty = true;
+}
+/**
+ * Wire up context injection on the extension API.
+ *
+ * - On session_start: mark dirty so context is rebuilt for the new scope
+ * - On before_agent_start: return cached context if clean, rebuild if dirty
+ *
+ * @param pi - The extension API
+ * @param wikiDir - Path to the wiki directory
+ * @param store - qmd store instance (or getter returning one)
+ * @param getScope - Returns the current ProjectScope
+ * @param getConfig - Returns the current config values for context
+ */
+export function setupContextInjection(pi, wikiDir, store, getScope, getConfig) {
+    // Reset cache state for a fresh setup
+    contextDirty = true;
+    cachedContext = null;
+    pi.on("session_start", async () => {
+        contextDirty = true;
+        cachedContext = null;
+    });
+    pi.on("before_agent_start", async (event, _ctx) => {
+        const scope = getScope();
+        if (!scope)
+            return;
+        if (!contextDirty && cachedContext !== null) {
+            // Return cached context
+            if (cachedContext) {
+                return {
+                    systemPrompt: event.systemPrompt + "\n\n" + wrapSystemReminder(cachedContext),
+                };
+            }
+            return;
+        }
+        // Rebuild context
+        const config = getConfig();
+        const options = {
+            maxTokens: config.contextMaxTokens ?? DEFAULT_MAX_TOKENS,
+            includeSchema: config.contextIncludeSchema ?? true,
+            includeIndex: true,
+        };
+        try {
+            cachedContext = await buildContext(wikiDir, store, scope, options);
+            contextDirty = false;
+        }
+        catch {
+            // On error, clear cache and don't inject anything
+            cachedContext = null;
+            contextDirty = false;
+            return;
+        }
+        if (cachedContext) {
+            return {
+                systemPrompt: event.systemPrompt + "\n\n" + wrapSystemReminder(cachedContext),
+            };
+        }
+    });
+}
+/** Build scope entries from the StateDB page summary cache. */
+async function buildScopeEntriesFromCache(stateDb, scope) {
+    const summaries = stateDb.getPageSummaries(scope);
+    return summaries.map((s) => ({
+        slug: s.slug,
+        category: s.category,
+        firstParagraph: s.firstParagraph || "(no summary)",
+        updatedAt: s.updatedAt,
+    }));
+}
+/** Build scope entries by reading all pages from disk. */
+async function buildScopeEntriesFromDisk(wikiDir, scope) {
+    const pages = await listPages(wikiDir);
+    const entries = [];
+    for (const ref of pages) {
+        const page = await readPage(wikiDir, ref.category, ref.slug);
+        if (!page)
+            continue;
+        if (!matchesScope(page.frontmatter.scope, scope))
+            continue;
+        entries.push({
+            slug: ref.slug,
+            category: ref.category,
+            firstParagraph: extractFirstParagraph(page.body),
+            updatedAt: page.frontmatter.updated,
+        });
+    }
+    return entries;
+}
+/**
+ * Extract the first non-empty paragraph from a markdown body.
+ * Skips headings and blank lines. Returns a single line.
+ */
+export function extractFirstParagraph(body) {
+    const lines = body.split("\n");
+    const paragraphLines = [];
+    let inParagraph = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Skip headings and empty lines before paragraph starts
+        if (!inParagraph) {
+            if (trimmed === "" || trimmed.startsWith("#"))
+                continue;
+            inParagraph = true;
+        }
+        // End paragraph on blank line or heading
+        if (inParagraph && (trimmed === "" || trimmed.startsWith("#"))) {
+            break;
+        }
+        paragraphLines.push(trimmed);
+    }
+    const result = paragraphLines.join(" ");
+    // Truncate long paragraphs
+    if (result.length > 200) {
+        return result.slice(0, 197) + "...";
+    }
+    return result || "(no summary)";
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/credentials.d.ts

@@ -0,0 +1,27 @@
+export type CredentialRef = `pi-auth:${string}` | `secret:${string}` | "none";
+export interface SecretStoreData {
+    version: 1;
+    secrets: Record<string, string>;
+}
+export interface CredentialResolution {
+    ok: boolean;
+    source: "pi-auth" | "secret" | "none" | "missing";
+    value?: string;
+    error?: string;
+}
+export declare function parseCredentialRef(ref: string): {
+    kind: "pi-auth" | "secret" | "none";
+    name: string | null;
+};
+export declare function readSecretStore(path?: string): Promise<SecretStoreData>;
+export declare function writeSecretStore(data: SecretStoreData, path?: string): Promise<void>;
+export declare function setSecret(name: string, value: string, path?: string): Promise<void>;
+export declare function removeSecret(name: string, path?: string): Promise<void>;
+export declare function resolveCredentialRef(ref: CredentialRef, opts?: {
+    secretsPath?: string;
+    authStorage?: {
+        getApiKey(provider: string): Promise<string | undefined>;
+    };
+}): Promise<CredentialResolution>;
+export declare function redactCredential(value: string | undefined): string;
+//# sourceMappingURL=credentials.d.ts.map

package/dist/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,aAAa,GAAG,WAAW,MAAM,EAAE,GAAG,UAAU,MAAM,EAAE,GAAG,MAAM,CAAC;AAE9E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAS5G;AAED,wBAAsB,eAAe,CAAC,IAAI,SAA6B,GAAG,OAAO,CAAC,eAAe,CAAC,CAKjG;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,SAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ9G;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,SAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7G;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAIjG;AAED,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,aAAa,EAClB,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE;QAAE,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;KAAE,CAAA;CAAO,GAC9G,OAAO,CAAC,oBAAoB,CAAC,CAkB/B;AAYD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAIlE"}

package/dist/credentials.js

@@ -0,0 +1,85 @@
+import { existsSync, chmodSync } from "node:fs";
+import { mkdir, readFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { atomicWriteFile } from "./atomic-write.js";
+import { getParaPaths } from "./paths.js";
+export function parseCredentialRef(ref) {
+    if (ref === "none")
+        return { kind: "none", name: null };
+    if (ref.startsWith("pi-auth:") && ref.length > "pi-auth:".length) {
+        return { kind: "pi-auth", name: ref.slice("pi-auth:".length) };
+    }
+    if (ref.startsWith("secret:") && ref.length > "secret:".length) {
+        return { kind: "secret", name: ref.slice("secret:".length) };
+    }
+    throw new Error(`Unsupported credentialRef: ${ref}. Use pi-auth:<provider>, secret:<name>, or none.`);
+}
+export async function readSecretStore(path = getParaPaths().secretsPath) {
+    if (!existsSync(path))
+        return { version: 1, secrets: {} };
+    const raw = await readFile(path, "utf-8");
+    const parsed = JSON.parse(raw);
+    return { version: 1, secrets: parsed.secrets ?? {} };
+}
+export async function writeSecretStore(data, path = getParaPaths().secretsPath) {
+    await mkdir(dirname(path), { recursive: true });
+    await atomicWriteFile(path, `${JSON.stringify({ version: 1, secrets: data.secrets }, null, 2)}\n`, 0o600);
+    try {
+        chmodSync(path, 0o600);
+    }
+    catch {
+        // chmod can fail on non-POSIX filesystems; doctor reports permission issues.
+    }
+}
+export async function setSecret(name, value, path = getParaPaths().secretsPath) {
+    if (!name.trim())
+        throw new Error("Secret name is required.");
+    if (!value)
+        throw new Error("Secret value is required.");
+    const data = await readSecretStore(path);
+    data.secrets[name] = value;
+    await writeSecretStore(data, path);
+}
+export async function removeSecret(name, path = getParaPaths().secretsPath) {
+    const data = await readSecretStore(path);
+    delete data.secrets[name];
+    await writeSecretStore(data, path);
+}
+export async function resolveCredentialRef(ref, opts = {}) {
+    const parsed = parseCredentialRef(ref);
+    if (parsed.kind === "none")
+        return { ok: true, source: "none" };
+    if (parsed.kind === "secret") {
+        const data = await readSecretStore(opts.secretsPath);
+        const value = data.secrets[parsed.name ?? ""];
+        if (!value)
+            return { ok: false, source: "missing", error: `Secret not found: ${parsed.name}` };
+        return { ok: true, source: "secret", value };
+    }
+    const authStorage = opts.authStorage ?? await createPiAuthStorage();
+    if (!authStorage) {
+        return { ok: false, source: "missing", error: "Pi AuthStorage is unavailable." };
+    }
+    const value = await authStorage.getApiKey(parsed.name ?? "");
+    if (!value)
+        return { ok: false, source: "missing", error: `Pi auth not configured for provider: ${parsed.name}` };
+    return { ok: true, source: "pi-auth", value };
+}
+async function createPiAuthStorage() {
+    try {
+        const mod = await import("@earendil-works/pi-coding-agent");
+        const AuthStorage = mod.AuthStorage;
+        return AuthStorage?.create() ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export function redactCredential(value) {
+    if (!value)
+        return "not set";
+    if (value.length <= 8)
+        return "********";
+    return `${value.slice(0, 4)}…${value.slice(-4)}`;
+}
+//# sourceMappingURL=credentials.js.map

package/dist/credentials.js.map

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

package/dist/daemon.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Main daemon loop — watches for completed sessions and processes them.
+ */
+import type { Model } from "@earendil-works/pi-ai";
+import type { WebWikiConfig } from "./webui/server.js";
+export interface DaemonConfig {
+    wikiDir: string;
+    model: Model<any>;
+    getApiKey: (provider: string) => Promise<string | undefined>;
+    pollIntervalMs?: number;
+    /** How often to run link discovery + lint (ms). Default: 30 minutes */
+    maintenanceIntervalMs?: number;
+    /** Web wiki server config. If enabled, the daemon hosts the web UI. */
+    webWiki?: WebWikiConfig;
+}
+export declare class Daemon {
+    private config;
+    private state;
+    private watcher;
+    private store;
+    private queue;
+    private processing;
+    private running;
+    private maintenanceTimer;
+    private maintenanceRunning;
+    private webServer;
+    constructor(config: DaemonConfig);
+    /** Start the daemon. */
+    start(): Promise<void>;
+    /** Stop the daemon. */
+    stop(): Promise<void>;
+    /** Get the web server URL (if running). */
+    getWebUrl(): string | null;
+    /** Process a single session file (for CLI `process` command). */
+    processOne(sessionPath: string): Promise<void>;
+    /** Handle new entries from the registry watcher. */
+    private onNewEntries;
+    /** Process queued sessions sequentially. */
+    private processQueue;
+    /** Run periodic maintenance via LLM agent. */
+    private runMaintenancePass;
+    /** Get processing history. */
+    getHistory(scope?: string, limit?: number): import("./state.js").ProcessedSession[];
+    /** Get failed sessions. */
+    getFailed(): import("./state.js").ProcessedSession[];
+    /** Retry all failed sessions. */
+    retryFailed(): Promise<void>;
+}
+//# sourceMappingURL=daemon.d.ts.map

package/dist/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAUnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,uEAAuE;IACvE,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,gBAAgB,CAA+C;IACvE,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,SAAS,CAA4D;gBAEjE,MAAM,EAAE,YAAY;IAUhC,wBAAwB;IAClB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8C5B,uBAAuB;IACjB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B3B,2CAA2C;IAC3C,SAAS,IAAI,MAAM,GAAG,IAAI;IAI1B,iEAAiE;IAC3D,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0CpD,oDAAoD;IACpD,OAAO,CAAC,YAAY;IAapB,4CAA4C;YAC9B,YAAY;IAY1B,8CAA8C;YAChC,kBAAkB;IA4BhC,8BAA8B;IAC9B,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;IAIzC,2BAA2B;IAC3B,SAAS;IAIT,iCAAiC;IAC3B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;CAWnC"}