@inbrowser/agent 0.1.0 → 0.3.0

package/dist/retrieval.d.ts

@@ -0,0 +1,74 @@
+/**
+ * `createRetrievalStrategy()` — a code-orchestrated retrieve-then-read
+ * (RAG) `AgentStrategy`.
+ *
+ * Where `createReactLoopStrategy` lets the model drive — deciding when
+ * to call tools and when to stop — this strategy inverts the control
+ * flow. The *code* does the retrieval (search + read top-K docs); the
+ * model is invoked exactly ONCE, with NO tools advertised, to write a
+ * grounded answer from the retrieved excerpts. This is the
+ * "zero-agency" tier-1 shape from
+ * `plans/retrieval-strategy-and-eval.md`: a small model (e.g. SmolLM2
+ * 360M) that can't reliably emit tool calls or decide when to stop
+ * still does one thing well — grounded generation over stuffed context.
+ *
+ * Lifecycle (`run`):
+ *
+ *   1. SEARCH (code). Synthesize a tool-call id, emit `tool_call`
+ *      for the search tool with `{ query: input.prompt }`, dispatch it
+ *      through `input.tools.execute`, emit `tool_result`.
+ *   2. READ top-K (code). Pull routes from the search result via
+ *      `extractRoutes`, take the first `topK`, and for each emit
+ *      `tool_call`(read) → dispatch → `tool_result`. Collect the
+ *      extracted text until `contextBudget` chars are reached.
+ *   3. COMPOSE. Build `[system, ...history, user(composeContext(...))]`
+ *      the same way the ReAct loop's `buildMessages` does — except the
+ *      final user message is the grounded context+question, not the
+ *      raw prompt.
+ *   4. GENERATE. One `input.llm.chat({ messages, tools: [],
+ *      toolUseEnabled: false })` call; map model `text` / `thinking` /
+ *      `usage` / `error` events straight to `StrategyEvent`s.
+ *   5. `turn_complete` carrying the captured usage.
+ *
+ * It emits the SAME `tool_call` / `tool_result` / `text` event surface
+ * the ReAct loop does, so an existing host (cards, sources, streaming)
+ * works unchanged — the only difference is the events are driven by
+ * code, not the model.
+ */
+import type { AgentStrategy } from './types/strategy.js';
+export interface RetrievalStrategyOpts {
+    /** Tool that returns candidate doc hits for a query. Default `'search_docs'`. */
+    searchTool?: string;
+    /** Tool that returns a single doc's content by route. Default `'get_doc'`. */
+    readTool?: string;
+    /** How many of the search hits to read. Default 3. */
+    topK?: number;
+    /**
+     * Pull the routes to read from the search tool's `ToolResult.data`.
+     * Default: `(d as { hits: { route }[] }).hits.map((h) => h.route)`.
+     */
+    extractRoutes?(searchData: unknown): string[];
+    /**
+     * Pull the context text from a read tool's `ToolResult.data`.
+     * Default: from `{ route, title, body }`.
+     */
+    extractText?(readData: unknown): {
+        route: string;
+        title: string;
+        text: string;
+    };
+    /**
+     * Build the grounded user message from the question + retrieved docs.
+     * Default: an instruction to answer ONLY from the excerpts and cite
+     * the route(s), the labeled excerpts, then the question.
+     */
+    composeContext?(question: string, docs: {
+        route: string;
+        title: string;
+        text: string;
+    }[]): string;
+    /** Cap on total context chars fed to the model. Default ~6000. */
+    contextBudget?: number;
+}
+export declare function createRetrievalStrategy(opts?: RetrievalStrategyOpts): AgentStrategy;
+//# sourceMappingURL=retrieval.d.ts.map

package/dist/retrieval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval.d.ts","sourceRoot":"","sources":["../src/retrieval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAmC,MAAM,qBAAqB,CAAC;AAE1F,MAAM,WAAW,qBAAqB;IACpC,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,aAAa,CAAC,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;IAC9C;;;OAGG;IACH,WAAW,CAAC,CAAC,QAAQ,EAAE,OAAO,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAChF;;;;OAIG;IACH,cAAc,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,MAAM,CAAC;IAClG,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAoHD,wBAAgB,uBAAuB,CAAC,IAAI,GAAE,qBAA0B,GAAG,aAAa,CA4JvF"}

package/dist/retrieval.js

@@ -0,0 +1,287 @@
+/**
+ * `createRetrievalStrategy()` — a code-orchestrated retrieve-then-read
+ * (RAG) `AgentStrategy`.
+ *
+ * Where `createReactLoopStrategy` lets the model drive — deciding when
+ * to call tools and when to stop — this strategy inverts the control
+ * flow. The *code* does the retrieval (search + read top-K docs); the
+ * model is invoked exactly ONCE, with NO tools advertised, to write a
+ * grounded answer from the retrieved excerpts. This is the
+ * "zero-agency" tier-1 shape from
+ * `plans/retrieval-strategy-and-eval.md`: a small model (e.g. SmolLM2
+ * 360M) that can't reliably emit tool calls or decide when to stop
+ * still does one thing well — grounded generation over stuffed context.
+ *
+ * Lifecycle (`run`):
+ *
+ *   1. SEARCH (code). Synthesize a tool-call id, emit `tool_call`
+ *      for the search tool with `{ query: input.prompt }`, dispatch it
+ *      through `input.tools.execute`, emit `tool_result`.
+ *   2. READ top-K (code). Pull routes from the search result via
+ *      `extractRoutes`, take the first `topK`, and for each emit
+ *      `tool_call`(read) → dispatch → `tool_result`. Collect the
+ *      extracted text until `contextBudget` chars are reached.
+ *   3. COMPOSE. Build `[system, ...history, user(composeContext(...))]`
+ *      the same way the ReAct loop's `buildMessages` does — except the
+ *      final user message is the grounded context+question, not the
+ *      raw prompt.
+ *   4. GENERATE. One `input.llm.chat({ messages, tools: [],
+ *      toolUseEnabled: false })` call; map model `text` / `thinking` /
+ *      `usage` / `error` events straight to `StrategyEvent`s.
+ *   5. `turn_complete` carrying the captured usage.
+ *
+ * It emits the SAME `tool_call` / `tool_result` / `text` event surface
+ * the ReAct loop does, so an existing host (cards, sources, streaming)
+ * works unchanged — the only difference is the events are driven by
+ * code, not the model.
+ */
+const DEFAULT_SEARCH_TOOL = 'search_docs';
+const DEFAULT_READ_TOOL = 'get_doc';
+const DEFAULT_TOP_K = 3;
+const DEFAULT_CONTEXT_BUDGET = 6000;
+/** Default route extractor: `data.hits[].route`. Defensive against
+ *  any non-conforming shape — returns `[]` rather than throwing so the
+ *  strategy still completes (generating from whatever context it has). */
+function defaultExtractRoutes(searchData) {
+    if (!searchData || typeof searchData !== 'object')
+        return [];
+    const hits = searchData.hits;
+    if (!Array.isArray(hits))
+        return [];
+    const routes = [];
+    for (const hit of hits) {
+        if (hit && typeof hit === 'object') {
+            const route = hit.route;
+            if (typeof route === 'string' && route.length > 0)
+                routes.push(route);
+        }
+    }
+    return routes;
+}
+/** Default text extractor: from `{ route, title, body }`. */
+function defaultExtractText(readData) {
+    const obj = (readData && typeof readData === 'object' ? readData : {});
+    return {
+        route: typeof obj.route === 'string' ? obj.route : '',
+        title: typeof obj.title === 'string' ? obj.title : '',
+        text: typeof obj.body === 'string' ? obj.body : '',
+    };
+}
+/** Default context composer: a tight grounding instruction, the
+ *  labeled excerpts, then the question. Mirrors the wording in the
+ *  plan: answer ONLY from the excerpts + cite the route(s). */
+function defaultComposeContext(question, docs) {
+    const instruction = 'Answer the question using ONLY the documentation excerpts below. ' +
+        'Cite the route(s) you used. If the answer is not in the excerpts, say so.';
+    const excerpts = docs.map((doc) => `--- [${doc.route}] ${doc.title}\n${doc.text}`).join('\n\n');
+    const excerptBlock = excerpts.length > 0 ? excerpts : '(no documentation excerpts were retrieved)';
+    return `${instruction}\n\n${excerptBlock}\n\nQuestion: ${question}`;
+}
+/**
+ * Build `[system, ...history, user(<groundedContext>)]`. Identical to
+ * the ReAct loop's `buildMessages` except the trailing user message is
+ * the grounded context rather than the raw prompt. This strategy never
+ * encodes assistant tool-calls of its own — the only tool activity is
+ * the code-driven retrieval, which the model never sees.
+ */
+function buildMessages(input, groundedUserText) {
+    const out = [];
+    out.push({ role: 'system', text: input.systemPrompt });
+    for (const m of input.history) {
+        if (m.role === 'system')
+            continue; // already emitted
+        if (m.role === 'assistant') {
+            const tc = m.toolCalls?.map((c) => ({
+                id: c.id,
+                name: c.name,
+                args: safeParse(c.argsJson),
+                ...(c.signature ? { signature: c.signature } : {}),
+            })) ?? [];
+            out.push({
+                role: 'assistant',
+                text: m.text,
+                ...(tc.length > 0 ? { toolCalls: tc } : {}),
+            });
+            for (const c of m.toolCalls ?? []) {
+                if (c.resultJson !== undefined) {
+                    out.push({
+                        role: 'tool',
+                        toolCallId: c.id,
+                        name: c.name,
+                        resultJson: c.resultJson,
+                        text: '',
+                    });
+                }
+            }
+        }
+        else {
+            out.push({ role: m.role, text: m.text });
+        }
+    }
+    out.push({ role: 'user', text: groundedUserText });
+    return out;
+}
+function safeParse(s) {
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        return s;
+    }
+}
+let idSeq = 0;
+/** Per-call id for the synthetic, code-driven tool calls. Mirrors the
+ *  ReAct loop's per-iteration `requestId` discipline — the host only
+ *  needs the id to be stable + unique across a single run so it can
+ *  pair `tool_call` with `tool_result`. */
+function rid(prefix) {
+    idSeq += 1;
+    return `${prefix}-${Date.now().toString(36)}-${idSeq}`;
+}
+export function createRetrievalStrategy(opts = {}) {
+    const searchTool = opts.searchTool ?? DEFAULT_SEARCH_TOOL;
+    const readTool = opts.readTool ?? DEFAULT_READ_TOOL;
+    const topK = opts.topK ?? DEFAULT_TOP_K;
+    const extractRoutes = opts.extractRoutes ?? defaultExtractRoutes;
+    const extractText = opts.extractText ?? defaultExtractText;
+    const composeContext = opts.composeContext ?? defaultComposeContext;
+    const contextBudget = opts.contextBudget ?? DEFAULT_CONTEXT_BUDGET;
+    return {
+        id: 'retrieval',
+        async *run(input, signal) {
+            if (signal.aborted) {
+                yield { kind: 'error', message: 'aborted' };
+                return;
+            }
+            // 1. SEARCH (code-driven). Emit the same `tool_call` /
+            //    `tool_result` surface the ReAct loop emits for a model-driven
+            //    call, so the host's "searching" UI + Sources work unchanged.
+            const searchId = rid('search');
+            yield { kind: 'tool_call', id: searchId, name: searchTool, args: { query: input.prompt } };
+            const searchResult = await input.tools.execute({ id: searchId, name: searchTool, args: { query: input.prompt } }, input.toolContext());
+            yield { kind: 'tool_result', id: searchId, result: searchResult };
+            // 2. READ top-K (code-driven). Even when search failed or
+            //    returned no usable routes we still proceed to generate — the
+            //    model grounds on whatever context we managed to collect (or
+            //    on an explicit "nothing retrieved" note). It never crashes.
+            const routes = searchResult.ok ? extractRoutes(searchResult.data).slice(0, topK) : [];
+            const docs = [];
+            let usedChars = 0;
+            for (const route of routes) {
+                if (signal.aborted) {
+                    yield { kind: 'error', message: 'aborted' };
+                    return;
+                }
+                if (usedChars >= contextBudget)
+                    break;
+                const readId = rid('read');
+                yield { kind: 'tool_call', id: readId, name: readTool, args: { route } };
+                const readResult = await input.tools.execute({ id: readId, name: readTool, args: { route } }, input.toolContext());
+                yield { kind: 'tool_result', id: readId, result: readResult };
+                if (!readResult.ok)
+                    continue;
+                const doc = extractText(readResult.data);
+                // Trim the excerpt so the running total never exceeds the
+                // budget — a small local model can't hold several full bodies.
+                const remaining = contextBudget - usedChars;
+                const text = doc.text.length > remaining ? doc.text.slice(0, remaining) : doc.text;
+                docs.push({ route: doc.route, title: doc.title, text });
+                usedChars += text.length;
+            }
+            if (signal.aborted) {
+                yield { kind: 'error', message: 'aborted' };
+                return;
+            }
+            // 3. COMPOSE. The model's only input is system + history + the
+            //    grounded question. No tools are advertised → no tool-call
+            //    parsing, no loop.
+            const groundedUserText = composeContext(input.prompt, docs);
+            const messages = buildMessages(input, groundedUserText);
+            const chatRequest = {
+                messages,
+                tools: [],
+                toolUseEnabled: false,
+            };
+            // Emit the trace BEFORE dispatch — same agent-layer view the
+            // ReAct loop captures. A single-iteration run, so iteration 0.
+            const turnIdForReq = input.turnId ?? 'turn-anon';
+            const requestId = `${turnIdForReq}#0`;
+            if (input.tracer) {
+                input.tracer.emit({
+                    kind: 'llm_request',
+                    data: {
+                        requestId,
+                        turnId: turnIdForReq,
+                        iteration: 0,
+                        ts: Date.now(),
+                        systemPrompt: input.systemPrompt,
+                        messages: messages.map((m) => ({ ...m })),
+                        tools: [],
+                        llm: { id: input.llm.id, supportsTools: input.llm.supportsTools },
+                    },
+                });
+            }
+            // 4. GENERATE (the model's ONLY job).
+            let turnUsage;
+            const turnDetails = { requestedModel: input.llm.id };
+            let assistantText = '';
+            let assistantThinking = '';
+            for await (const ev of input.llm.chat(chatRequest, signal)) {
+                if (ev.kind === 'text') {
+                    assistantText += ev.text;
+                    yield { kind: 'text', chunk: ev.text };
+                }
+                else if (ev.kind === 'thinking') {
+                    assistantThinking += ev.text;
+                    yield { kind: 'thinking', chunk: ev.text };
+                }
+                else if (ev.kind === 'usage') {
+                    turnUsage = ev.usage;
+                }
+                else if (ev.kind === 'error') {
+                    yield { kind: 'error', message: ev.message };
+                    return;
+                }
+                // `tool_call` events are impossible here (toolUseEnabled:false,
+                // no tools advertised); a misbehaving stub that emits one is
+                // ignored rather than dispatched — this is a zero-agency
+                // strategy and the code already retrieved everything.
+            }
+            // Pair the `llm_request` with its response — the closing endpoint
+            // of this run's language-model wall-clock segment.
+            if (input.tracer) {
+                input.tracer.emit({
+                    kind: 'llm_response',
+                    data: {
+                        requestId,
+                        ts: Date.now(),
+                        text: assistantText,
+                        thinking: assistantThinking,
+                        toolCalls: [],
+                        ...(turnUsage
+                            ? {
+                                usage: {
+                                    promptTokens: turnUsage.promptTokens,
+                                    outputTokens: turnUsage.outputTokens,
+                                    ...(turnUsage.cachedTokens !== undefined
+                                        ? { cachedTokens: turnUsage.cachedTokens }
+                                        : {}),
+                                },
+                            }
+                            : {}),
+                    },
+                });
+            }
+            // 5. turn_complete. Synthesize a zero-usage accounting when the
+            //    stub never emitted a `usage` event so the strategy always
+            //    terminates with a `turn_complete` (the contract a host
+            //    relies on), matching the plan.
+            yield {
+                kind: 'turn_complete',
+                usage: turnUsage ?? { promptTokens: 0, outputTokens: 0 },
+                details: turnDetails,
+            };
+        },
+    };
+}
+//# sourceMappingURL=retrieval.js.map

package/dist/retrieval.js.map

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

package/dist/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAgB,MAAM,oBAAoB,CAAC;AAOzF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CA+H3E"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAgB,MAAM,oBAAoB,CAAC;AAOzF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAsI3E"}

package/dist/session.js

@@ -47,7 +47,13 @@ export function createAgentSession(config) {
     async function* run(prompt, signal) {
         const turnId = `t-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`;
         yield { kind: 'turn_started', turnId };
-        // Capture the user message in history so the next turn sees it.
+        // The strategy receives the PRE-prompt history — everything
+        // before this turn's prompt — and appends `prompt` itself when
+        // composing messages. Passing the post-append history here would
+        // make every LLM request carry the user prompt twice.
+        const priorHistory = history;
+        // Capture the user message in the session's own history so the
+        // next turn (and persistence) sees it.
         const userMsg = {
             id: `u-${turnId}`,
             role: 'user',
@@ -58,7 +64,7 @@ export function createAgentSession(config) {
         const systemPrompt = config.systemPromptBuilder(workspace, runtime);
         const strategyEvents = config.strategy.run({
             prompt,
-            history,
+            history: priorHistory,
             workspace,
             runtime,
             llm: config.llm,

package/dist/session.js.map

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

package/dist/skill-catalog.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Static catalog of skill workflows.
+ *
+ * Phase five of the implementation plan splits the planner-executor work
+ * into three branches: this catalog, the router that classifies a user
+ * prompt against the catalog, and the executor that walks a chosen
+ * skill's prescribed step sequence. This module is the data + types
+ * gate — no runtime logic. The router reads `triggerHints` to score
+ * candidate matches; the executor reads `steps` to materialize a plan.
+ *
+ * Each entry's `name` matches a value in the `SkillName` enum from
+ * `eval/fixture.ts` (re-exported here for convenience). Step
+ * descriptions are imperative, short, and model-agnostic. Per-step
+ * `verifier?` references existing starter / custom specs where one
+ * fits naturally; not every step has one. Leaf "compile / deploy /
+ * verify" steps tend to have a spec; intermediate read / draft steps
+ * usually don't.
+ *
+ * The catalog is hand-authored and intentionally `const`. The
+ * companion test in `test/skill-catalog.test.ts` asserts shape
+ * invariants: every `name` is in `SKILL_NAMES`, every entry has at
+ * least three trigger hints, every entry has between four and nine
+ * steps, every step id is unique and kebab-case within its plan, and
+ * every `verifier?.name` matches a spec registered by
+ * `registerAllSpecs(createSpecRegistry())`.
+ */
+import type { SkillName, SuccessSpecReference } from './eval/fixture.js';
+/**
+ * One ordered step in a skill's prescribed workflow.
+ *
+ * `id` is a stable kebab-case identifier, unique within the parent
+ * plan. The executor uses it as the scratch key for the step's
+ * bounded sub-loop. `description` is an imperative one-liner — what
+ * the step does, in the project's voice. `verifier?` is an optional
+ * `SuccessSpecReference` the executor can run after the step finishes
+ * to gate whether the plan advances; the same shape that fixtures
+ * use, so the executor can re-use `evaluateSpec` without translation.
+ */
+export interface PlanStep {
+    /** Stable kebab-case id, unique within the plan. */
+    id: string;
+    /** Short imperative description of what the step does. */
+    description: string;
+    /** Optional reference to a success spec that verifies this step. */
+    verifier?: SuccessSpecReference;
+}
+/**
+ * One row in the skill catalog. Describes a single skill workflow as
+ * a triple of (router signals, plan, identity).
+ */
+export interface SkillCatalogEntry {
+    /** Matches a value in `SKILL_NAMES` from `eval/fixture.ts`. */
+    name: SkillName;
+    /** One-line description used by the router and surfaced in the plan. */
+    description: string;
+    /**
+     * Lowercase keyword tokens the router scans the user prompt for.
+     * Order does not matter; at least one hit signals a candidate match.
+     */
+    triggerHints: readonly string[];
+    /** Prescribed workflow as an ordered sequence of steps. */
+    steps: readonly PlanStep[];
+}
+/** Read-only view over the catalog. */
+export type SkillCatalog = readonly SkillCatalogEntry[];
+export declare const SKILL_CATALOG: SkillCatalog;
+/**
+ * Look up a catalog entry by skill name. Returns `undefined` when the
+ * name is not in the catalog. The router will use this to materialize
+ * an entry after picking a winner; the executor will use it to
+ * unwrap a router decision into a plan.
+ */
+export declare function getSkillEntry(name: SkillName): SkillCatalogEntry | undefined;
+/**
+ * List every skill name present in the catalog, in catalog order. The
+ * router uses this to iterate candidates when scoring a prompt; the
+ * test suite uses it to assert the catalog covers every value in
+ * `SKILL_NAMES`.
+ */
+export declare function listSkillNames(): readonly SkillName[];
+//# sourceMappingURL=skill-catalog.d.ts.map

package/dist/skill-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-catalog.d.ts","sourceRoot":"","sources":["../src/skill-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAWzE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,QAAQ;IACvB,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,IAAI,EAAE,SAAS,CAAC;IAChB,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,2DAA2D;IAC3D,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;CAC5B;AAED,uCAAuC;AACvC,MAAM,MAAM,YAAY,GAAG,SAAS,iBAAiB,EAAE,CAAC;AAQxD,eAAO,MAAM,aAAa,EAAE,YA8V3B,CAAC;AAcF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,iBAAiB,GAAG,SAAS,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,SAAS,SAAS,EAAE,CAErD"}