@runcore-sh/runcore 0.1.2

package/dist/search/classify.js

@@ -0,0 +1,132 @@
+/**
+ * Search-need classifier for Core.
+ * Determines whether a user message needs a web search and extracts the query.
+ *
+ * Three-tier approach:
+ * 1. Regex fast-path — explicit commands like "search for ...", "google ..."
+ * 2. Heuristic skip — short messages, greetings, obvious non-search patterns
+ * 3. LLM classifier — cheap model decides if web info would help
+ *
+ * Never throws — defaults to { needsSearch: false } on any error.
+ */
+import { completeChat } from "../llm/complete.js";
+// --- Tier 1: Regex fast-path (explicit commands) ---
+const EXPLICIT_PATTERNS = [
+    /^search\s+(?:for\s+)?(.+)/i,
+    /^google\s+(.+)/i,
+    /^look\s*up\s+(.+)/i,
+    /^find\s+(?:info|information)\s+(?:on|about)\s+(.+)/i,
+    /^what(?:'s| is)\s+the\s+latest\s+(.+)/i,
+];
+function matchExplicit(message) {
+    for (const pattern of EXPLICIT_PATTERNS) {
+        const match = message.match(pattern);
+        if (match?.[1])
+            return match[1].trim();
+    }
+    return null;
+}
+// --- Tier 2: Heuristic skip ---
+const SKIP_PATTERNS = [
+    /^(hi|hey|hello|yo|sup|thanks|thank you|ok|okay|sure|yes|no|bye|goodbye|good morning|good night)\b/i,
+    /^(how are you|what's up|how's it going)\??$/i,
+    /^learn\s+/i, // "learn <path>" is a file command, not a search
+    /https?:\/\/\S+/, // URLs are handled by browse module, not search
+    // Retry/re-examine cues — user wants the agent to look at conversation/context, not the web
+    /^(again|look again|try again|check again|re-?read|re-?check|look back|look harder)\b/i,
+];
+function shouldSkip(message) {
+    if (message.length < 10)
+        return true;
+    return SKIP_PATTERNS.some((p) => p.test(message));
+}
+// --- Tier 3: LLM classifier ---
+const CLASSIFY_PROMPT = `You are a classifier. Given a user message, decide if it requires a web search to answer well.
+
+Answer YES if the message asks about:
+- Current events, news, recent happenings
+- Latest versions, releases, or updates of software/products
+- Sports scores, election results, or other time-sensitive facts
+- Prices, stock values, or market data
+- People, companies, or organizations (current info)
+- Weather or real-time conditions
+- "Who won", "what happened", "when is" style questions about recent events
+
+Answer NO if the message is:
+- Personal conversation, greetings, emotional support
+- Requests about the user's own files, projects, or data
+- Questions the AI can answer from general knowledge (math, definitions, basic facts)
+- Creative writing, brainstorming, or opinion requests
+- Instructions or commands for the AI itself
+- Retry or re-examine cues like "again", "look again", "try again", "check again" — these mean the user wants you to re-read conversation context or local files, NOT search the web
+
+Respond with ONLY a JSON object: {"needsSearch": true, "query": "search query"} or {"needsSearch": false}
+No markdown fences. No explanation.`;
+async function classifyWithLlm(message, provider, model) {
+    const raw = await completeChat({
+        messages: [
+            { role: "system", content: CLASSIFY_PROMPT },
+            { role: "user", content: message },
+        ],
+        provider,
+        model,
+    });
+    // Parse response
+    let cleaned = raw.trim();
+    cleaned = cleaned.replace(/^```(?:json)?\s*/i, "").replace(/\s*```$/, "");
+    const parsed = JSON.parse(cleaned);
+    if (parsed.needsSearch && typeof parsed.query === "string") {
+        return { needsSearch: true, query: parsed.query, trigger: "auto" };
+    }
+    return { needsSearch: false, query: "", trigger: "none" };
+}
+// --- Query enhancement ---
+const TIME_SENSITIVE_PATTERNS = [
+    /\b(latest|recent|current|last|new|newest|this year|today|now|20\d{2})\b/i,
+    /\b(who won|who is|what happened|score|results|winner)\b/i,
+    /\b(super bowl|world cup|election|oscars|grammy|championship)\b/i,
+    /\b(version|release|update|price|stock)\b/i,
+];
+/**
+ * Append the current year to queries that seem time-sensitive,
+ * so DuckDuckGo returns fresher results.
+ */
+function enhanceQuery(query) {
+    const year = new Date().getFullYear();
+    const yearStr = String(year);
+    // Don't add if query already contains a recent year
+    if (/20\d{2}/.test(query))
+        return query;
+    const isTimeSensitive = TIME_SENSITIVE_PATTERNS.some((p) => p.test(query));
+    if (isTimeSensitive)
+        return `${query} ${yearStr}`;
+    return query;
+}
+// --- Public API ---
+/**
+ * Classify whether a user message needs a web search.
+ * Never throws — returns { needsSearch: false } on any error.
+ */
+export async function classifySearchNeed(message, provider, model) {
+    try {
+        // Tier 1: explicit command
+        const explicit = matchExplicit(message);
+        if (explicit) {
+            return { needsSearch: true, query: enhanceQuery(explicit), trigger: "explicit" };
+        }
+        // Tier 2: heuristic skip
+        if (shouldSkip(message)) {
+            return { needsSearch: false, query: "", trigger: "none" };
+        }
+        // Tier 3: LLM classifier
+        const result = await classifyWithLlm(message, provider, model);
+        if (result.needsSearch) {
+            result.query = enhanceQuery(result.query);
+        }
+        return result;
+    }
+    catch {
+        return { needsSearch: false, query: "", trigger: "none" };
+    }
+}
+//# sourceMappingURL=classify.js.map

package/dist/search/classify.js.map

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

package/dist/search/client.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Search client — unified entry point for web search.
+ * Prefers Perplexity Sonar API when PERPLEXITY_API_KEY is set,
+ * falls back to DuckDuckGo via the Python sidecar.
+ * All functions are safe — they return null on any failure.
+ */
+export interface SearchResult {
+    results: string;
+    query: string;
+}
+/**
+ * Health probe — checks if the sidecar is running.
+ * 2-second timeout, returns false on any failure.
+ */
+export declare function checkSearchSidecar(): Promise<boolean>;
+/**
+ * Run a web search via the sidecar.
+ * 15-second timeout, returns null on any failure.
+ */
+export declare function webSearch(query: string): Promise<SearchResult | null>;
+/**
+ * Is any search backend available?
+ * True if Perplexity API key is set OR the sidecar is running.
+ */
+export declare function isSearchAvailable(): boolean;
+/**
+ * Unified search entry point.
+ * Tries Perplexity first (when key is set), falls back to sidecar.
+ * Returns null if no backend is available or both fail.
+ */
+export declare function search(query: string): Promise<SearchResult | null>;
+//# sourceMappingURL=client.d.ts.map

package/dist/search/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/search/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAW3D;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAa3E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAWxE"}

package/dist/search/client.js

@@ -0,0 +1,72 @@
+/**
+ * Search client — unified entry point for web search.
+ * Prefers Perplexity Sonar API when PERPLEXITY_API_KEY is set,
+ * falls back to DuckDuckGo via the Python sidecar.
+ * All functions are safe — they return null on any failure.
+ */
+import { isSidecarAvailable } from "./sidecar.js";
+import { perplexitySearch } from "./perplexity.js";
+import { resolveEnv } from "../instance.js";
+const SIDECAR_URL = `http://127.0.0.1:${resolveEnv("SEARCH_PORT") ?? "3578"}`;
+/**
+ * Health probe — checks if the sidecar is running.
+ * 2-second timeout, returns false on any failure.
+ */
+export async function checkSearchSidecar() {
+    try {
+        const res = await fetch(`${SIDECAR_URL}/health`, {
+            signal: AbortSignal.timeout(2000),
+        });
+        if (!res.ok)
+            return false;
+        const data = (await res.json());
+        return data.status === "ok";
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Run a web search via the sidecar.
+ * 15-second timeout, returns null on any failure.
+ */
+export async function webSearch(query) {
+    try {
+        const res = await fetch(`${SIDECAR_URL}/search`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ query, max_results: 5 }),
+            signal: AbortSignal.timeout(15_000),
+        });
+        if (!res.ok)
+            return null;
+        return (await res.json());
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Is any search backend available?
+ * True if Perplexity API key is set OR the sidecar is running.
+ */
+export function isSearchAvailable() {
+    return !!process.env.PERPLEXITY_API_KEY || isSidecarAvailable();
+}
+/**
+ * Unified search entry point.
+ * Tries Perplexity first (when key is set), falls back to sidecar.
+ * Returns null if no backend is available or both fail.
+ */
+export async function search(query) {
+    if (process.env.PERPLEXITY_API_KEY) {
+        const result = await perplexitySearch(query);
+        if (result)
+            return result;
+    }
+    if (isSidecarAvailable()) {
+        return webSearch(query);
+    }
+    return null;
+}
+//# sourceMappingURL=client.js.map

package/dist/search/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/search/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,MAAM,WAAW,GAAG,oBAAoB,UAAU,CAAC,aAAa,CAAC,IAAI,MAAM,EAAE,CAAC;AAO9E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,WAAW,SAAS,EAAE;YAC/C,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;SAClC,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,KAAK,CAAC;QAC1B,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAwB,CAAC;QACvD,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAa;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,WAAW,SAAS,EAAE;YAC/C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;YAC/C,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;SACpC,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACzB,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAiB,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,kBAAkB,EAAE,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,KAAa;IACxC,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC7C,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;IAC5B,CAAC;IAED,IAAI,kBAAkB,EAAE,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/search/perplexity.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Perplexity Sonar API client.
+ * Uses the chat completions endpoint with model "sonar" for web search.
+ * Safe: never throws, returns null on any error.
+ */
+import type { SearchResult } from "./client.js";
+/**
+ * Search the web via Perplexity Sonar.
+ * Requires PERPLEXITY_API_KEY in process.env (hydrated by vault).
+ * 15-second timeout. Returns null on any failure.
+ */
+export declare function perplexitySearch(query: string): Promise<SearchResult | null>;
+//# sourceMappingURL=perplexity.d.ts.map

package/dist/search/perplexity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perplexity.d.ts","sourceRoot":"","sources":["../../src/search/perplexity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA+BlF"}

package/dist/search/perplexity.js

@@ -0,0 +1,41 @@
+/**
+ * Perplexity Sonar API client.
+ * Uses the chat completions endpoint with model "sonar" for web search.
+ * Safe: never throws, returns null on any error.
+ */
+const PERPLEXITY_URL = "https://api.perplexity.ai/chat/completions";
+/**
+ * Search the web via Perplexity Sonar.
+ * Requires PERPLEXITY_API_KEY in process.env (hydrated by vault).
+ * 15-second timeout. Returns null on any failure.
+ */
+export async function perplexitySearch(query) {
+    const apiKey = process.env.PERPLEXITY_API_KEY;
+    if (!apiKey)
+        return null;
+    try {
+        const res = await fetch(PERPLEXITY_URL, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${apiKey}`,
+            },
+            body: JSON.stringify({
+                model: "sonar",
+                messages: [{ role: "user", content: query }],
+            }),
+            signal: AbortSignal.timeout(15_000),
+        });
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        const content = data.choices?.[0]?.message?.content;
+        if (!content)
+            return null;
+        return { results: content, query };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=perplexity.js.map

package/dist/search/perplexity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"perplexity.js","sourceRoot":"","sources":["../../src/search/perplexity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,cAAc,GAAG,4CAA4C,CAAC;AAEpE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAa;IAClD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC9C,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE;YACtC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,MAAM,EAAE;aAClC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,OAAO;gBACd,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;aAC7C,CAAC;YACF,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;SACpC,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAEzB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAE7B,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC;QACpD,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAE1B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/search/sidecar.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Search sidecar lifecycle manager.
+ * Spawns the Python FastAPI sidecar process and monitors its health.
+ * Graceful degradation — if Python or sidecar isn't available, the instance works normally.
+ */
+/**
+ * Start the search sidecar.
+ * First checks if one is already running externally, then spawns if not.
+ * Returns true if sidecar is available after startup.
+ */
+export declare function startSidecar(): Promise<boolean>;
+/**
+ * Check if the sidecar is currently available.
+ */
+export declare function isSidecarAvailable(): boolean;
+/**
+ * Stop the sidecar process.
+ */
+export declare function stopSidecar(): void;
+//# sourceMappingURL=sidecar.d.ts.map

package/dist/search/sidecar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../../src/search/sidecar.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyBH;;;;GAIG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAyDrD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAUlC"}

package/dist/search/sidecar.js

@@ -0,0 +1,103 @@
+/**
+ * Search sidecar lifecycle manager.
+ * Spawns the Python FastAPI sidecar process and monitors its health.
+ * Graceful degradation — if Python or sidecar isn't available, the instance works normally.
+ */
+import { spawn } from "node:child_process";
+import { join } from "node:path";
+import { checkSearchSidecar } from "./client.js";
+import { createLogger } from "../utils/logger.js";
+import { resolveEnv } from "../instance.js";
+const log = createLogger("search-sidecar");
+const SIDECAR_PORT = resolveEnv("SEARCH_PORT") ?? "3578";
+const SIDECAR_DIR = join(process.cwd(), "sidecar", "search");
+const HEALTH_POLL_INTERVAL = 500; // ms
+const HEALTH_POLL_TIMEOUT = 10_000; // ms
+let sidecarProcess = null;
+let available = false;
+/**
+ * Get the right Python command for the current platform.
+ */
+function pythonCommand() {
+    return process.platform === "win32" ? "python" : "python3";
+}
+/**
+ * Start the search sidecar.
+ * First checks if one is already running externally, then spawns if not.
+ * Returns true if sidecar is available after startup.
+ */
+export async function startSidecar() {
+    // Check if already running (e.g. started externally)
+    if (await checkSearchSidecar()) {
+        available = true;
+        return true;
+    }
+    // Spawn the sidecar process
+    const python = pythonCommand();
+    const script = join(SIDECAR_DIR, "server.py");
+    try {
+        sidecarProcess = spawn(python, [script, "--port", SIDECAR_PORT], {
+            cwd: SIDECAR_DIR,
+            stdio: ["ignore", "pipe", "pipe"],
+            detached: false,
+        });
+        // Log stderr for debugging
+        sidecarProcess.stderr?.on("data", (data) => {
+            const msg = data.toString().trim();
+            if (msg)
+                log.info(` ${msg}`);
+        });
+        sidecarProcess.on("error", (err) => {
+            log.info(` Failed to start: ${err.message}`);
+            available = false;
+            sidecarProcess = null;
+        });
+        sidecarProcess.on("exit", (code) => {
+            if (code !== null && code !== 0) {
+                log.info(` Exited with code ${code}`);
+            }
+            available = false;
+            sidecarProcess = null;
+        });
+        // Poll /health until ready or timeout
+        const start = Date.now();
+        while (Date.now() - start < HEALTH_POLL_TIMEOUT) {
+            if (await checkSearchSidecar()) {
+                available = true;
+                return true;
+            }
+            await new Promise((r) => setTimeout(r, HEALTH_POLL_INTERVAL));
+        }
+        // Timeout — sidecar didn't come up
+        log.info(" Timed out waiting for health check");
+        stopSidecar();
+        return false;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log.info(` Spawn failed: ${msg}`);
+        return false;
+    }
+}
+/**
+ * Check if the sidecar is currently available.
+ */
+export function isSidecarAvailable() {
+    return available;
+}
+/**
+ * Stop the sidecar process.
+ */
+export function stopSidecar() {
+    if (sidecarProcess) {
+        try {
+            sidecarProcess.kill();
+        }
+        catch {
+            // Already dead
+        }
+        sidecarProcess = null;
+    }
+    available = false;
+}
+//# sourceMappingURL=sidecar.js.map

package/dist/search/sidecar.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Core local chat server.
+ * Hono app: serves static UI, handles pairing/auth, streams chat via Ollama (local) or OpenRouter (cloud).
+ */
+export declare function getStartupToken(): string | null;
+declare function start(): Promise<void>;
+export { start };
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2SH,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAE/C;AA+6ID,iBAAe,KAAK,kBAicnB;AAED,OAAO,EAAE,KAAK,EAAE,CAAC"}