@cleocode/core 2026.6.12 → 2026.6.13

package/dist/tools/web-agent-tools.js

@@ -0,0 +1,393 @@
+/**
+ * Web + browser agent-tool FAMILY — registration (T1742 · epic T11456 · SG-TOOLS).
+ *
+ * Registers the `web` toolset into the {@link ./agent-registry.js |
+ * AgentToolRegistry}, on top of the terminal/file/search/git families
+ * ({@link ./agent-tool-families.js}):
+ *
+ *   - **AC1** `web_search` — pluggable, backend-agnostic search
+ *     ({@link ./web-search-backends.js}); graceful `unavailable` result when no
+ *     backend can answer. NO hard paid-API dependency.
+ *   - **AC2** `web_extract` — fetch a URL + convert HTML to markdown.
+ *   - **AC3** `browser_navigate` — Playwright (lazily, optionally loaded).
+ *   - **AC4** `browser_click` / `browser_type` / `browser_press`.
+ *   - **AC5** `browser_snapshot` — accessibility tree.
+ *   - **AC6** `browser_vision` — screenshot + AI analysis routed THROUGH the E9
+ *     `resolveLLMForSystem` chokepoint + sealed-credential handle (never a raw
+ *     provider call).
+ *   - **AC7** `browser_scroll` up / down.
+ *   - **AC8** all registered; the browser tools' `available()` returns `false`
+ *     (with an install hint) when Playwright is absent.
+ *
+ * Browser tools share ONE lazily-launched {@link BrowserSession} per registration
+ * (a closure cell), so the optional Playwright load happens at most once per run.
+ * The web tools' network egress flows through an injectable {@link HttpFetch}; the
+ * vision AI call flows through the single E9 chokepoint — neither bypasses the
+ * resolver / credential layer. Import-time side-effect-free (NO top-level
+ * playwright import).
+ *
+ * @epic T11456
+ * @task T1742
+ * @see ./browser-driver.js — the optional-Playwright lazy-load backend
+ * @see ./web-search-backends.js — the pluggable search backends + HTML→markdown
+ */
+import { z } from 'zod';
+import { getLogger } from '../logger.js';
+import { BrowserSession, PLAYWRIGHT_INSTALL_HINT } from './browser-driver.js';
+import { defaultHttpFetch, fetchAndExtract, resolveSearchBackends, runSearch, } from './web-search-backends.js';
+const log = getLogger('tool-web-agent');
+/**
+ * Available only when outbound network egress is permitted. When the context
+ * does not declare egress (`networkEgressAllowed === undefined`) the tool is
+ * permitted — the registry default is permissive; a context that explicitly sets
+ * `false` hides it (AC5/availability).
+ */
+const networkAvailable = (ctx) => ctx.networkEgressAllowed !== false;
+/**
+ * Available only when the optional Playwright capability is present in the
+ * context. The browser tools are ALWAYS registered (AC8), but report unavailable
+ * — surfacing {@link PLAYWRIGHT_INSTALL_HINT} in their description — until a
+ * context advertises `capabilities.playwright === true`. The registration helper
+ * probes Playwright once and stamps that flag, so an absent optional dep simply
+ * leaves the browser tools hidden rather than crashing.
+ */
+const playwrightAvailable = (ctx) => ctx.capabilities?.playwright === true && ctx.networkEgressAllowed !== false;
+/**
+ * Run the `browser_vision` AI analysis: capture a screenshot, then resolve an
+ * LLM through the SINGLE E9 chokepoint (`resolveLLMForSystem`) and send the
+ * screenshot as a multimodal user turn. The plaintext credential is materialized
+ * from the sealed handle ONLY at the wire (inside `ModelRunner.build`), never
+ * surfaced up the stack — and there is NO raw provider/transport construction
+ * here (Gate-13). Returns `aiUnavailable: true` (with the screenshot still
+ * captured) when no credential resolves — graceful degradation, not an error.
+ *
+ * @param browser - The shared browser session.
+ * @param prompt - The analysis instruction.
+ * @param fullPage - Capture the full page rather than the viewport.
+ * @param projectRoot - Project root for the resolver.
+ * @returns The {@link BrowserVisionResult}.
+ */
+async function runBrowserVision(browser, prompt, fullPage, projectRoot) {
+    const shot = await browser.screenshot(fullPage);
+    const base = { url: shot.url, title: shot.title };
+    // E9 resolution chokepoint — the ONLY route to an LLM credential. Never throws.
+    const { resolveLLMForSystem } = await import('../llm/system-resolver.js');
+    const resolved = await resolveLLMForSystem('task-executor', {
+        ...(projectRoot !== undefined ? { projectRoot } : {}),
+    });
+    if (!resolved.sealedCredential) {
+        // No credential reachable — return the screenshot-only result (graceful).
+        return { ...base, analysis: null, aiUnavailable: true };
+    }
+    try {
+        // Build the wire surfaces via the single SSoT ModelRunner (Gate-13: no raw
+        // transport / provider construction at this call-site). The descriptor's
+        // token is materialized from the sealed handle inside ModelRunner only.
+        const { ModelRunner } = await import('../llm/model-runner.js');
+        const apiKey = (await resolved.sealedCredential.fetch()).value;
+        const built = await ModelRunner.build({
+            provider: resolved.provider,
+            model: resolved.model,
+            credential: resolved.credential
+                ? {
+                    provider: resolved.credential.provider,
+                    apiKey,
+                    source: resolved.credential.source,
+                    authType: resolved.credential.authType,
+                }
+                : null,
+            source: resolved.source,
+            ...(resolved.credentialLabel !== undefined
+                ? { credentialLabel: resolved.credentialLabel }
+                : {}),
+            apiMode: resolved.apiMode,
+            baseUrl: resolved.baseUrl,
+            authType: resolved.authType,
+            ...(resolved.capabilities !== undefined ? { capabilities: resolved.capabilities } : {}),
+        });
+        // A single multimodal user turn: the instruction text + the screenshot as a
+        // native image block (transports that cannot do images degrade per imageMode).
+        const messages = [
+            {
+                role: 'user',
+                content: [
+                    { type: 'text', text: prompt },
+                    {
+                        type: 'image',
+                        source: { type: 'base64', data: shot.base64Png, mediaType: 'image/png' },
+                    },
+                ],
+            },
+        ];
+        const response = await built.session.send(messages);
+        return {
+            ...base,
+            analysis: response.content,
+            model: resolved.model,
+            aiUnavailable: false,
+        };
+    }
+    catch (err) {
+        log.warn({ err }, 'browser_vision: AI analysis failed — returning screenshot-only result');
+        return { ...base, analysis: null, model: resolved.model, aiUnavailable: true };
+    }
+}
+/**
+ * Register the web + browser agent-tool family into `registry`. Pure
+ * registration — no network, no browser launch, no scan; side effects happen
+ * later through the injected {@link HttpFetch} / {@link BrowserSession}.
+ *
+ * The browser tools are registered with a `playwright`-gated availability
+ * predicate (AC8): present in the registry but hidden by `available()` until a
+ * context advertises the optional Playwright capability.
+ *
+ * @param registry - The registry to populate.
+ * @param options - Injectable backends (HTTP fetch, browser session, searxng URL).
+ */
+export function registerWebAgentTools(registry, options = {}) {
+    const http = options.http ?? defaultHttpFetch;
+    // ONE browser session shared by every browser tool in this registration — the
+    // optional Playwright load happens at most once. Constructing it is free (no
+    // import until the first navigation).
+    const browser = options.browser ?? new BrowserSession();
+    const searxngUrl = options.searxngUrl ?? process.env.SEARXNG_URL;
+    const projectRoot = options.projectRoot;
+    // --- AC1: web_search (pluggable backends, graceful when unconfigured) ----
+    registry.register({
+        name: 'web_search',
+        class: 'net',
+        description: 'Search the web via a pluggable backend (DuckDuckGo / SearXNG — no API key required). ' +
+            'Returns ranked results, or an `unavailable` result when no backend can answer.',
+        toolset: 'web',
+        stateless: true,
+        available: networkAvailable,
+        parameters: z.object({
+            query: z.string().describe('Free-text search query.'),
+            maxResults: z.number().int().positive().optional().describe('Max results (default 10).'),
+            backend: z
+                .enum(['duckduckgo', 'searxng', 'auto'])
+                .optional()
+                .describe("Preferred backend: 'duckduckgo', 'searxng', or 'auto' (default)."),
+        }),
+        execute: async (rawArgs) => {
+            const backend = rawArgs.backend === 'duckduckgo' ||
+                rawArgs.backend === 'searxng' ||
+                rawArgs.backend === 'auto'
+                ? rawArgs.backend
+                : undefined;
+            const input = {
+                query: String(rawArgs.query),
+                maxResults: typeof rawArgs.maxResults === 'number' ? rawArgs.maxResults : undefined,
+                backend,
+            };
+            const backends = resolveSearchBackends(input, searxngUrl);
+            if (backends.length === 0) {
+                return {
+                    query: input.query,
+                    results: [],
+                    backend: null,
+                    unavailable: true,
+                    reason: 'no configured web-search backend',
+                };
+            }
+            const outcome = await runSearch(input, backends, http);
+            if (outcome === null) {
+                return {
+                    query: input.query,
+                    results: [],
+                    backend: null,
+                    unavailable: true,
+                    reason: 'every web-search backend failed',
+                };
+            }
+            return {
+                query: input.query,
+                results: outcome.results,
+                backend: outcome.backend,
+                unavailable: false,
+            };
+        },
+    });
+    // --- AC2: web_extract (URL → markdown) ----------------------------------
+    registry.register({
+        name: 'web_extract',
+        class: 'net',
+        description: 'Fetch a URL and convert its HTML content to markdown.',
+        toolset: 'web',
+        stateless: true,
+        available: networkAvailable,
+        parameters: z.object({
+            url: z.string().describe('Absolute URL to fetch and convert.'),
+            timeoutMs: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe('Fetch timeout in ms (default 30000).'),
+            maxChars: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe('Cap on markdown length in characters (default 100000).'),
+        }),
+        execute: async (rawArgs) => {
+            const url = String(rawArgs.url);
+            return fetchAndExtract(url, http, {
+                timeoutMs: typeof rawArgs.timeoutMs === 'number' ? rawArgs.timeoutMs : undefined,
+                maxChars: typeof rawArgs.maxChars === 'number' ? rawArgs.maxChars : undefined,
+            });
+        },
+    });
+    // --- AC3: browser_navigate ----------------------------------------------
+    registry.register({
+        name: 'browser_navigate',
+        class: 'shell',
+        description: `Navigate a headless browser to a URL (Playwright). ${PLAYWRIGHT_INSTALL_HINT}`,
+        toolset: 'web',
+        stateless: false,
+        available: playwrightAvailable,
+        parameters: z.object({
+            url: z.string().describe('Absolute URL to navigate to.'),
+            waitUntil: z
+                .enum(['load', 'domcontentloaded', 'networkidle'])
+                .optional()
+                .describe("When navigation is complete (default 'load')."),
+            timeoutMs: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe('Navigation timeout in ms (default 30000).'),
+        }),
+        execute: async (rawArgs) => browser.navigate({
+            url: String(rawArgs.url),
+            waitUntil: rawArgs.waitUntil === 'load' ||
+                rawArgs.waitUntil === 'domcontentloaded' ||
+                rawArgs.waitUntil === 'networkidle'
+                ? rawArgs.waitUntil
+                : undefined,
+            timeoutMs: typeof rawArgs.timeoutMs === 'number' ? rawArgs.timeoutMs : undefined,
+        }),
+    });
+    // --- AC4: browser_click / browser_type / browser_press ------------------
+    registry.register({
+        name: 'browser_click',
+        class: 'shell',
+        description: `Click an element by selector in the browser. ${PLAYWRIGHT_INSTALL_HINT}`,
+        toolset: 'web',
+        stateless: false,
+        available: playwrightAvailable,
+        parameters: z.object({
+            selector: z.string().describe('CSS / Playwright selector for the element to click.'),
+            timeoutMs: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe('Action timeout in ms (default 15000).'),
+        }),
+        execute: async (rawArgs) => {
+            const state = await browser.click(String(rawArgs.selector), typeof rawArgs.timeoutMs === 'number' ? rawArgs.timeoutMs : undefined);
+            return { ...state, action: 'click' };
+        },
+    });
+    registry.register({
+        name: 'browser_type',
+        class: 'shell',
+        description: `Type text into an input element by selector. ${PLAYWRIGHT_INSTALL_HINT}`,
+        toolset: 'web',
+        stateless: false,
+        available: playwrightAvailable,
+        parameters: z.object({
+            selector: z.string().describe('CSS / Playwright selector for the input element.'),
+            text: z.string().describe('Text to type into the element.'),
+            clear: z.boolean().optional().describe('Clear the field before typing (default true).'),
+            timeoutMs: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe('Action timeout in ms (default 15000).'),
+        }),
+        execute: async (rawArgs) => {
+            const state = await browser.type(String(rawArgs.selector), String(rawArgs.text), typeof rawArgs.timeoutMs === 'number' ? rawArgs.timeoutMs : undefined);
+            return { ...state, action: 'type' };
+        },
+    });
+    registry.register({
+        name: 'browser_press',
+        class: 'shell',
+        description: `Press a key or chord (e.g. Enter, Control+A) in the browser. ${PLAYWRIGHT_INSTALL_HINT}`,
+        toolset: 'web',
+        stateless: false,
+        available: playwrightAvailable,
+        parameters: z.object({
+            key: z.string().describe('Key or chord in Playwright syntax (e.g. Enter, Control+A).'),
+            selector: z.string().optional().describe('Optional selector to focus before pressing.'),
+            timeoutMs: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe('Focus timeout in ms (default 15000).'),
+        }),
+        execute: async (rawArgs) => {
+            const state = await browser.press(String(rawArgs.key), rawArgs.selector === undefined ? undefined : String(rawArgs.selector), typeof rawArgs.timeoutMs === 'number' ? rawArgs.timeoutMs : undefined);
+            return { ...state, action: 'press' };
+        },
+    });
+    // --- AC5: browser_snapshot (accessibility tree) -------------------------
+    registry.register({
+        name: 'browser_snapshot',
+        class: 'shell',
+        description: `Capture the page's accessibility tree. ${PLAYWRIGHT_INSTALL_HINT}`,
+        toolset: 'web',
+        stateless: false,
+        available: playwrightAvailable,
+        parameters: z.object({}),
+        execute: async () => browser.snapshot(),
+    });
+    // --- AC7: browser_scroll (up / down) ------------------------------------
+    registry.register({
+        name: 'browser_scroll',
+        class: 'shell',
+        description: `Scroll the page up or down. ${PLAYWRIGHT_INSTALL_HINT}`,
+        toolset: 'web',
+        stateless: false,
+        available: playwrightAvailable,
+        parameters: z.object({
+            direction: z.enum(['up', 'down']).describe('Scroll direction.'),
+            amountPx: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe('Pixels to scroll (default ~one viewport).'),
+        }),
+        execute: async (rawArgs) => {
+            const direction = rawArgs.direction === 'up' ? 'up' : 'down';
+            const state = await browser.scroll(direction, typeof rawArgs.amountPx === 'number' ? rawArgs.amountPx : undefined);
+            return { ...state, direction };
+        },
+    });
+    // --- AC6: browser_vision (screenshot + AI analysis via the E9 chokepoint) -
+    registry.register({
+        name: 'browser_vision',
+        class: 'shell',
+        description: 'Screenshot the current page and analyse it with a vision model. ' +
+            `The AI call routes through the resolveLLMForSystem chokepoint. ${PLAYWRIGHT_INSTALL_HINT}`,
+        toolset: 'web',
+        stateless: false,
+        available: playwrightAvailable,
+        parameters: z.object({
+            prompt: z.string().describe('Question / instruction for the vision model about the page.'),
+            fullPage: z
+                .boolean()
+                .optional()
+                .describe('Capture the full scrollable page (default false).'),
+        }),
+        execute: async (rawArgs) => runBrowserVision(browser, String(rawArgs.prompt), rawArgs.fullPage === true, projectRoot),
+    });
+}
+//# sourceMappingURL=web-agent-tools.js.map

package/dist/tools/web-agent-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-agent-tools.js","sourceRoot":"","sources":["../../src/tools/web-agent-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AASH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EACL,gBAAgB,EAChB,eAAe,EAEf,qBAAqB,EACrB,SAAS,GACV,MAAM,0BAA0B,CAAC;AAElC,MAAM,GAAG,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAAC;AAExC;;;;;GAKG;AACH,MAAM,gBAAgB,GAAsB,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,oBAAoB,KAAK,KAAK,CAAC;AAExF;;;;;;;GAOG;AACH,MAAM,mBAAmB,GAAsB,CAAC,GAAG,EAAE,EAAE,CACrD,GAAG,CAAC,YAAY,EAAE,UAAU,KAAK,IAAI,IAAI,GAAG,CAAC,oBAAoB,KAAK,KAAK,CAAC;AAyB9E;;;;;;;;;;;;;;GAcG;AACH,KAAK,UAAU,gBAAgB,CAC7B,OAAuB,EACvB,MAAc,EACd,QAAiB,EACjB,WAA+B;IAE/B,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IAElD,gFAAgF;IAChF,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,eAAe,EAAE;QAC1D,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QAC/B,0EAA0E;QAC1E,OAAO,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IAC1D,CAAC;IAED,IAAI,CAAC;QACH,2EAA2E;QAC3E,yEAAyE;QACzE,wEAAwE;QACxE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;QAC/D,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC;QAC/D,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC;YACpC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC7B,CAAC,CAAC;oBACE,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ;oBACtC,MAAM;oBACN,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,MAAM;oBAClC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ;iBACvC;gBACH,CAAC,CAAC,IAAI;YACR,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,GAAG,CAAC,QAAQ,CAAC,eAAe,KAAK,SAAS;gBACxC,CAAC,CAAC,EAAE,eAAe,EAAE,QAAQ,CAAC,eAAe,EAAE;gBAC/C,CAAC,CAAC,EAAE,CAAC;YACP,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,GAAG,CAAC,QAAQ,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxF,CAAC,CAAC;QAEH,4EAA4E;QAC5E,+EAA+E;QAC/E,MAAM,QAAQ,GAAuB;YACnC;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;oBAC9B;wBACE,IAAI,EAAE,OAAO;wBACb,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE;qBACzE;iBACF;aACF;SACF,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpD,OAAO;YACL,GAAG,IAAI;YACP,QAAQ,EAAE,QAAQ,CAAC,OAAO;YAC1B,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,aAAa,EAAE,KAAK;SACrB,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,uEAAuE,CAAC,CAAC;QAC3F,OAAO,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IACjF,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAA2B,EAC3B,UAA+B,EAAE;IAEjC,MAAM,IAAI,GAAc,OAAO,CAAC,IAAI,IAAI,gBAAgB,CAAC;IACzD,8EAA8E;IAC9E,6EAA6E;IAC7E,sCAAsC;IACtC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,cAAc,EAAE,CAAC;IACxD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IACjE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAExC,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,KAAK;QACZ,WAAW,EACT,uFAAuF;YACvF,gFAAgF;QAClF,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,gBAAgB;QAC3B,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;YACrD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;YACxF,OAAO,EAAE,CAAC;iBACP,IAAI,CAAC,CAAC,YAAY,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;iBACvC,QAAQ,EAAE;iBACV,QAAQ,CAAC,kEAAkE,CAAC;SAChF,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,OAAO,EAA4B,EAAE;YACnD,MAAM,OAAO,GACX,OAAO,CAAC,OAAO,KAAK,YAAY;gBAChC,OAAO,CAAC,OAAO,KAAK,SAAS;gBAC7B,OAAO,CAAC,OAAO,KAAK,MAAM;gBACxB,CAAC,CAAC,OAAO,CAAC,OAAO;gBACjB,CAAC,CAAC,SAAS,CAAC;YAChB,MAAM,KAAK,GAAmB;gBAC5B,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;gBAC5B,UAAU,EAAE,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;gBACnF,OAAO;aACR,CAAC;YACF,MAAM,QAAQ,GAAG,qBAAqB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;YAC1D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO;oBACL,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,OAAO,EAAE,EAAE;oBACX,OAAO,EAAE,IAAI;oBACb,WAAW,EAAE,IAAI;oBACjB,MAAM,EAAE,kCAAkC;iBAC3C,CAAC;YACJ,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;YACvD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,OAAO;oBACL,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,OAAO,EAAE,EAAE;oBACX,OAAO,EAAE,IAAI;oBACb,WAAW,EAAE,IAAI;oBACjB,MAAM,EAAE,iCAAiC;iBAC1C,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,WAAW,EAAE,KAAK;aACnB,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,KAAK;QACZ,WAAW,EAAE,uDAAuD;QACpE,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,gBAAgB;QAC3B,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YAC9D,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,EAAE;iBACV,QAAQ,CAAC,sCAAsC,CAAC;YACnD,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,EAAE;iBACV,QAAQ,CAAC,wDAAwD,CAAC;SACtE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACzB,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAChC,OAAO,eAAe,CAAC,GAAG,EAAE,IAAI,EAAE;gBAChC,SAAS,EAAE,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;gBAChF,QAAQ,EAAE,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;aAC9E,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;IAEH,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,sDAAsD,uBAAuB,EAAE;QAC5F,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,KAAK;QAChB,SAAS,EAAE,mBAAmB;QAC9B,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;YACxD,SAAS,EAAE,CAAC;iBACT,IAAI,CAAC,CAAC,MAAM,EAAE,kBAAkB,EAAE,aAAa,CAAC,CAAC;iBACjD,QAAQ,EAAE;iBACV,QAAQ,CAAC,+CAA+C,CAAC;YAC5D,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,EAAE;iBACV,QAAQ,CAAC,2CAA2C,CAAC;SACzD,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CACzB,OAAO,CAAC,QAAQ,CAAC;YACf,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;YACxB,SAAS,EACP,OAAO,CAAC,SAAS,KAAK,MAAM;gBAC5B,OAAO,CAAC,SAAS,KAAK,kBAAkB;gBACxC,OAAO,CAAC,SAAS,KAAK,aAAa;gBACjC,CAAC,CAAC,OAAO,CAAC,SAAS;gBACnB,CAAC,CAAC,SAAS;YACf,SAAS,EAAE,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;SACjF,CAAC;KACL,CAAC,CAAC;IAEH,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,gDAAgD,uBAAuB,EAAE;QACtF,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,KAAK;QAChB,SAAS,EAAE,mBAAmB;QAC9B,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;YACpF,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,EAAE;iBACV,QAAQ,CAAC,uCAAuC,CAAC;SACrD,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACzB,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,CAC/B,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EACxB,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CACtE,CAAC;YACF,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,OAAgB,EAAE,CAAC;QAChD,CAAC;KACF,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,gDAAgD,uBAAuB,EAAE;QACtF,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,KAAK;QAChB,SAAS,EAAE,mBAAmB;QAC9B,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;YACjF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;YAC3D,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;YACvF,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,EAAE;iBACV,QAAQ,CAAC,uCAAuC,CAAC;SACrD,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACzB,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAC9B,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EACxB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EACpB,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CACtE,CAAC;YACF,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,MAAe,EAAE,CAAC;QAC/C,CAAC;KACF,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,gEAAgE,uBAAuB,EAAE;QACtG,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,KAAK;QAChB,SAAS,EAAE,mBAAmB;QAC9B,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;YACtF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;YACvF,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,EAAE;iBACV,QAAQ,CAAC,sCAAsC,CAAC;SACpD,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACzB,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,CAC/B,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EACnB,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EACrE,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CACtE,CAAC;YACF,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,OAAgB,EAAE,CAAC;QAChD,CAAC;KACF,CAAC,CAAC;IAEH,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,0CAA0C,uBAAuB,EAAE;QAChF,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,KAAK;QAChB,SAAS,EAAE,mBAAmB;QAC9B,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE;KACxC,CAAC,CAAC;IAEH,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,+BAA+B,uBAAuB,EAAE;QACrE,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,KAAK;QAChB,SAAS,EAAE,mBAAmB;QAC9B,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAC/D,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,EAAE;iBACV,QAAQ,CAAC,2CAA2C,CAAC;SACzD,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACzB,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;YAC7D,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,MAAM,CAChC,SAAS,EACT,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CACpE,CAAC;YACF,OAAO,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,CAAC;QACjC,CAAC;KACF,CAAC,CAAC;IAEH,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,OAAO;QACd,WAAW,EACT,kEAAkE;YAClE,kEAAkE,uBAAuB,EAAE;QAC7F,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,KAAK;QAChB,SAAS,EAAE,mBAAmB;QAC9B,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;YAC1F,QAAQ,EAAE,CAAC;iBACR,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,mDAAmD,CAAC;SACjE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CACzB,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,KAAK,IAAI,EAAE,WAAW,CAAC;KAC5F,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/web-search-backends.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Pluggable `web_search` backends + HTML→markdown extraction (T1742 · epic
+ * T11456 · SG-TOOLS).
+ *
+ * The `web` toolset's network backend. TWO concerns live here, both built over
+ * an INJECTABLE {@link HttpFetch} so unit tests mock the network and CI never
+ * makes a real request (AC9):
+ *
+ *   - **web_search backends** — a {@link WebSearchBackend} interface with two
+ *     keyless builtin implementations ({@link duckDuckGoBackend},
+ *     {@link searxngBackend}). NO hard paid-API dependency: backends are resolved
+ *     at call time and the tool degrades gracefully to an `unavailable` result
+ *     when none answer (AC1). New backends register by satisfying the interface —
+ *     the search tool is backend-agnostic.
+ *   - **web_extract** — {@link htmlToMarkdown}, a dependency-free HTML→markdown
+ *     converter (AC2), plus {@link extractTitle}.
+ *
+ * The pure helpers (parsers, the markdown converter) are exported for direct unit
+ * testing. Import-time side-effect-free.
+ *
+ * @epic T11456
+ * @task T1742
+ */
+import type { WebExtractResult, WebSearchBackendId, WebSearchHit, WebSearchInput } from '@cleocode/contracts/tools/web-tools';
+/**
+ * A minimal HTTP-fetch surface the web tools depend on by INJECTION. Structurally
+ * a subset of the global `fetch`, declared here so the executables can be driven
+ * by a mock in tests (no real network in CI · AC9) and so a future routing of
+ * web egress through a guarded `net` primitive is a one-line swap.
+ */
+export type HttpFetch = (url: string, init?: {
+    readonly headers?: Record<string, string>;
+    readonly signal?: AbortSignal;
+}) => Promise<{
+    readonly status: number;
+    text(): Promise<string>;
+    readonly headers: {
+        get(name: string): string | null;
+    };
+}>;
+/** The default {@link HttpFetch} — the platform global `fetch`. */
+export declare const defaultHttpFetch: HttpFetch;
+/**
+ * One pluggable web-search backend. A backend resolves a query into ranked
+ * {@link WebSearchHit}s, or throws (the resolver moves on to the next backend).
+ * `isConfigured()` lets a backend that needs a URL/instance opt OUT of the `auto`
+ * rotation when it has nothing to talk to — keeping the "graceful when
+ * unconfigured" contract (AC1) without a network round-trip.
+ */
+export interface WebSearchBackend {
+    /** Canonical backend id. */
+    readonly id: WebSearchBackendId;
+    /** Whether this backend has everything it needs to run (e.g. an instance URL). */
+    isConfigured(): boolean;
+    /**
+     * Run the search.
+     *
+     * @param query - The search query.
+     * @param maxResults - Cap on returned hits.
+     * @param http - The injected fetch surface.
+     * @returns Ranked hits.
+     */
+    search(query: string, maxResults: number, http: HttpFetch): Promise<WebSearchHit[]>;
+}
+/**
+ * Parse DuckDuckGo's keyless HTML endpoint (`html.duckduckgo.com/html/`) into
+ * structured hits. Pure helper (AC9) — exported for direct unit testing against
+ * a captured fixture, so no network is needed.
+ *
+ * @param html - The DuckDuckGo HTML response body.
+ * @param maxResults - Cap on returned hits.
+ * @returns Parsed hits.
+ */
+export declare function parseDuckDuckGoHtml(html: string, maxResults: number): WebSearchHit[];
+/**
+ * The DuckDuckGo backend — keyless HTML endpoint, always "configured" (no
+ * instance URL needed). The canonical no-API-key default (AC1).
+ */
+export declare const duckDuckGoBackend: WebSearchBackend;
+/**
+ * Parse a SearXNG JSON response (`{ results: [{ title, url, content }] }`) into
+ * hits. Pure helper (AC9).
+ *
+ * @param json - The parsed SearXNG JSON body.
+ * @param maxResults - Cap on returned hits.
+ * @returns Parsed hits.
+ */
+export declare function parseSearxngJson(json: unknown, maxResults: number): WebSearchHit[];
+/**
+ * Build a SearXNG backend bound to an instance URL (from `SEARXNG_URL` env or
+ * config). When no instance URL is supplied it reports `isConfigured() === false`
+ * so the `auto` resolver skips it — preserving the "graceful when unconfigured"
+ * contract (AC1) with no paid dependency.
+ *
+ * @param instanceUrl - The SearXNG instance base URL (or `undefined`/empty).
+ * @returns A {@link WebSearchBackend}.
+ */
+export declare function makeSearxngBackend(instanceUrl: string | undefined): WebSearchBackend;
+/**
+ * Resolve the candidate backends for a {@link WebSearchInput}, in priority
+ * order. A SearXNG instance (when configured) ranks before DuckDuckGo; an
+ * explicit `input.backend` pins a single backend. The DuckDuckGo backend is
+ * always present (keyless), so the list is never empty — but a pinned backend
+ * that is not configured yields an empty list, which the executable surfaces as
+ * `unavailable` (AC1).
+ *
+ * @param input - The search input.
+ * @param searxngUrl - Optional SearXNG instance URL (config/env).
+ * @returns The ordered candidate backends.
+ */
+export declare function resolveSearchBackends(input: WebSearchInput, searxngUrl: string | undefined): WebSearchBackend[];
+/** Extract the document `<title>` text, or `''` when absent. Pure (AC9). */
+export declare function extractTitle(html: string): string;
+/**
+ * Convert an HTML document to markdown. Dependency-free (AC2) — a focused,
+ * deterministic transform of the structural tags an agent cares about
+ * (headings, links, lists, code, emphasis, paragraphs); `<script>`/`<style>`
+ * and remaining tags are dropped. NOT a full HTML5 parser — a pragmatic
+ * readability-style extraction that keeps `core` free of a heavy DOM dependency.
+ *
+ * Pure function of its input (no I/O), so it is unit-testable in isolation (AC9).
+ *
+ * @param html - The HTML document / fragment.
+ * @returns A markdown rendering of the body content.
+ */
+export declare function htmlToMarkdown(html: string): string;
+/**
+ * Fetch a URL and convert its HTML body to markdown. The single executable body
+ * for the `web_extract` tool — uses the INJECTED {@link HttpFetch} so CI mocks
+ * the network (AC9).
+ *
+ * @param url - The URL to fetch.
+ * @param http - The injected fetch surface.
+ * @param opts - Timeout + markdown length cap.
+ * @returns The {@link WebExtractResult}.
+ */
+export declare function fetchAndExtract(url: string, http: HttpFetch, opts?: {
+    timeoutMs?: number;
+    maxChars?: number;
+}): Promise<WebExtractResult>;
+/**
+ * Run a {@link WebSearchInput} against the resolved backends, first-success-wins.
+ * Returns the hits + the answering backend id, or `null` when no backend could
+ * answer (every candidate failed or the list was empty) — the executable maps
+ * `null` onto a graceful `unavailable` result (AC1).
+ *
+ * @param input - The search input.
+ * @param backends - The ordered candidate backends (from {@link resolveSearchBackends}).
+ * @param http - The injected fetch surface.
+ * @returns The hits + backend, or `null` when none answered.
+ */
+export declare function runSearch(input: WebSearchInput, backends: readonly WebSearchBackend[], http: HttpFetch): Promise<{
+    results: WebSearchHit[];
+    backend: WebSearchBackendId;
+} | null>;
+//# sourceMappingURL=web-search-backends.d.ts.map

package/dist/tools/web-search-backends.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search-backends.d.ts","sourceRoot":"","sources":["../../src/tools/web-search-backends.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACf,MAAM,qCAAqC,CAAC;AAK7C;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,CACtB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,KAChF,OAAO,CAAC;IACX,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE;QAAE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CACxD,CAAC,CAAC;AAEH,mEAAmE;AACnE,eAAO,MAAM,gBAAgB,EAAE,SACuB,CAAC;AAMvD;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,EAAE,kBAAkB,CAAC;IAChC,kFAAkF;IAClF,YAAY,IAAI,OAAO,CAAC;IACxB;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACrF;AAoBD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE,CA6BpF;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,gBAa/B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE,CAclF;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,CAgBpF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,cAAc,EACrB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,gBAAgB,EAAE,CAQpB;AAMD,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoDnD;AAOD;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,SAAS,EACf,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GACnD,OAAO,CAAC,gBAAgB,CAAC,CAoB3B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,SAAS,gBAAgB,EAAE,EACrC,IAAI,EAAE,SAAS,GACd,OAAO,CAAC;IAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,GAAG,IAAI,CAAC,CAW1E"}