@rudderjs/ai 1.17.3 → 1.18.0

package/dist/fake.js

@@ -1,428 +0,0 @@
-import { AiRegistry } from './registry.js';
-/**
- * Testing fake for @rudderjs/ai.
- *
- * @example Single-response shorthand
- * const fake = AiFake.fake()
- * fake.respondWith('Mocked response')
- *
- * const response = await AI.prompt('Hello')
- * assert.strictEqual(response.text, 'Mocked response')
- *
- * fake.assertPrompted(input => input.includes('Hello'))
- * fake.restore()
- *
- * @example Multi-step sequence
- * const fake = AiFake.fake()
- * fake.respondWithSequence([
- *   { toolCalls: [{ id: 't1', name: 'lookup', arguments: { q: 'a' } }] },
- *   { text: 'Done.' },
- * ])
- *
- * @example Forced failure
- * const fake = AiFake.fake()
- * fake.failOnStep(0, new Error('Rate limited'))
- * // first provider call throws; useful for testing onError middleware
- */
-export class AiFake {
-    calls = [];
-    imageCalls = [];
-    ttsCalls = [];
-    sttCalls = [];
-    embedCalls = [];
-    rerankCalls = [];
-    fileCalls = [];
-    _response = 'fake response';
-    _sequence = [];
-    _failures = new Map();
-    _preventStray = false;
-    _imageResponse = 'ZmFrZS1pbWFnZQ=='; // base64 of 'fake-image'
-    _ttsResponse = Buffer.from('fake-audio');
-    _sttResponse = 'fake transcription';
-    _embedResponse = [[0.1, 0.2, 0.3]];
-    _rerankResponse = { results: [] };
-    _fileUploadResponse = { id: 'fake-file-id', filename: 'fake.txt', bytes: 0 };
-    /** Set the text response the fake will return */
-    respondWith(text) {
-        this._response = text;
-    }
-    /**
-     * Strict mode — throw when the agent makes a prompt the fake doesn't have a
-     * scripted response for.
-     *
-     * Without this, an unscripted prompt silently falls back to the ambient
-     * `respondWith` default (`'fake response'` if untouched). That behavior
-     * makes tests pass even when they accidentally trigger an extra prompt the
-     * test never asserted on.
-     *
-     * Under strict mode, only entries from {@link respondWithSequence} count
-     * as valid responses; the ambient `respondWith` default is **not used**.
-     * Force a single-step script via `respondWithSequence([{ text: '...' }])`
-     * if you need an exact-one-prompt test that still returns content.
-     *
-     * @example
-     * const fake = AiFake.fake().preventStrayPrompts()
-     * fake.respondWithSequence([{ text: 'expected reply' }])
-     *
-     * await new ChatAgent().prompt('hello')   // OK
-     * await new ChatAgent().prompt('again')   // throws — no second script entry
-     */
-    preventStrayPrompts() {
-        this._preventStray = true;
-        return this;
-    }
-    /**
-     * Script a multi-step provider response. Each entry in `steps` corresponds
-     * to one provider call (the Nth `generate`/`stream` invocation consumes
-     * `steps[N]`). When the sequence is exhausted, subsequent calls fall back
-     * to {@link respondWith} (default: `'fake response'`).
-     *
-     * Pair with `tools` on an agent to drive a complete tool-call loop:
-     * step 0 emits `toolCalls`, step 1 returns the final assistant text.
-     *
-     * Calling this resets the sequence and the provider-call counter so
-     * scripted step indices are relative to this call. Registered failures
-     * (see {@link failOnStep}) are left intact, so the order in which you
-     * call `respondWithSequence` and `failOnStep` does not matter.
-     */
-    respondWithSequence(steps) {
-        this._sequence = [...steps];
-        this.calls.length = 0;
-    }
-    /**
-     * Force the Nth provider call to throw. Useful for testing failover
-     * (paired with multiple registered factories), error middleware, and
-     * `onError` hooks without a real network failure.
-     *
-     * The step index is 0-based and counts every `generate`/`stream` call
-     * the fake adapter receives. Failures take precedence over any scripted
-     * sequence at the same index — the sequence step is NOT consumed.
-     */
-    failOnStep(stepIndex, error) {
-        this._failures.set(stepIndex, error);
-    }
-    /** Set the base64 image the fake will return */
-    respondWithImage(base64) {
-        this._imageResponse = base64;
-    }
-    /** Set the audio buffer the TTS fake will return */
-    respondWithAudio(audio) {
-        this._ttsResponse = audio;
-    }
-    /** Set the transcription text the STT fake will return */
-    respondWithTranscription(text) {
-        this._sttResponse = text;
-    }
-    /** Set the embeddings the fake will return */
-    respondWithEmbedding(embeddings) {
-        this._embedResponse = embeddings;
-    }
-    /** Set the reranking results the fake will return */
-    respondWithRanking(results) {
-        this._rerankResponse = { results };
-    }
-    /** Set the file upload result the fake will return */
-    respondWithFileUpload(result) {
-        this._fileUploadResponse = result;
-    }
-    /**
-     * Stub a `fileSearch` interaction. The hosted-OpenAI path runs the
-     * search server-side and the result lands in the assistant message —
-     * no agent-loop tool round-trip — so the simplest fake is a single
-     * scripted response carrying the synthesized text.
-     *
-     * Pass `hits` to auto-format the text or pass `text` to control the
-     * exact assistant reply. `usage` flows through to budget middleware.
-     *
-     * @example
-     * fake.respondWithFileSearchResults({ text: 'The policy expires in 2027.' })
-     *
-     * @example
-     * fake.respondWithFileSearchResults({
-     *   hits: [
-     *     { text: 'Policies are reviewed annually.', source: 'policy.pdf', score: 0.92 },
-     *     { text: 'The renewal date is March 1st.',   source: 'renewal.pdf', score: 0.88 },
-     *   ],
-     * })
-     */
-    respondWithFileSearchResults(opts) {
-        const text = opts.text ?? formatFileSearchHits(opts.hits ?? []);
-        const step = { text };
-        if (opts.usage)
-            step.usage = opts.usage;
-        this.respondWithSequence([step]);
-    }
-    /** Install the fake — replaces all registered providers with a mock */
-    static fake() {
-        const fake = new AiFake();
-        const strayError = (stepIndex) => new Error(`[Rudder AI] Stray prompt: no scripted response at step ${stepIndex}. ` +
-            `Add an entry via respondWithSequence([...]) or remove preventStrayPrompts().`);
-        const adapter = {
-            async generate(opts) {
-                const stepIndex = fake.calls.length;
-                fake.calls.push(opts);
-                const failure = fake._failures.get(stepIndex);
-                if (failure)
-                    throw failure;
-                const next = fake._sequence[stepIndex];
-                if (next) {
-                    return {
-                        message: {
-                            role: 'assistant',
-                            content: next.text ?? '',
-                            ...(next.toolCalls ? { toolCalls: next.toolCalls } : {}),
-                        },
-                        usage: next.usage ?? { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
-                        finishReason: next.finishReason ?? (next.toolCalls ? 'tool_calls' : 'stop'),
-                    };
-                }
-                if (fake._preventStray)
-                    throw strayError(stepIndex);
-                return {
-                    message: { role: 'assistant', content: fake._response },
-                    usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
-                    finishReason: 'stop',
-                };
-            },
-            async *stream(opts) {
-                const stepIndex = fake.calls.length;
-                fake.calls.push(opts);
-                const failure = fake._failures.get(stepIndex);
-                if (failure)
-                    throw failure;
-                const next = fake._sequence[stepIndex];
-                if (next) {
-                    if (next.text)
-                        yield { type: 'text-delta', text: next.text };
-                    if (next.toolCalls) {
-                        for (const tc of next.toolCalls)
-                            yield { type: 'tool-call', toolCall: tc };
-                    }
-                    yield {
-                        type: 'finish',
-                        finishReason: next.finishReason ?? (next.toolCalls ? 'tool_calls' : 'stop'),
-                        usage: next.usage ?? { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
-                    };
-                    return;
-                }
-                if (fake._preventStray)
-                    throw strayError(stepIndex);
-                yield { type: 'text-delta', text: fake._response };
-                yield { type: 'finish', finishReason: 'stop', usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 } };
-            },
-        };
-        const imageAdapter = {
-            async generate(opts) {
-                fake.imageCalls.push(opts);
-                return {
-                    images: [{ base64: fake._imageResponse }],
-                    model: opts.model ?? 'fake-image',
-                };
-            },
-        };
-        const ttsAdapter = {
-            async generate(opts) {
-                fake.ttsCalls.push(opts);
-                return {
-                    audio: fake._ttsResponse,
-                    format: opts.format ?? 'mp3',
-                    model: opts.model ?? 'fake-tts',
-                };
-            },
-        };
-        const sttAdapter = {
-            async transcribe(opts) {
-                fake.sttCalls.push(opts);
-                return {
-                    text: fake._sttResponse,
-                    language: opts.language,
-                    model: opts.model ?? 'fake-stt',
-                };
-            },
-        };
-        const embeddingAdapter = {
-            async embed(input, model) {
-                fake.embedCalls.push({ input, model });
-                const inputs = Array.isArray(input) ? input : [input];
-                const embeddings = inputs.map((_, i) => fake._embedResponse[i % fake._embedResponse.length]);
-                return {
-                    embeddings,
-                    usage: { promptTokens: 0, totalTokens: 0 },
-                };
-            },
-        };
-        const rerankingAdapter = {
-            async rerank(opts) {
-                fake.rerankCalls.push(opts);
-                return fake._rerankResponse;
-            },
-        };
-        const fileAdapter = {
-            async upload(opts) {
-                fake.fileCalls.push({ method: 'upload', args: opts });
-                return { ...fake._fileUploadResponse, filename: opts.filePath.split('/').pop() ?? fake._fileUploadResponse.filename };
-            },
-            async list() {
-                fake.fileCalls.push({ method: 'list', args: {} });
-                return { files: [fake._fileUploadResponse] };
-            },
-            async delete(fileId) {
-                fake.fileCalls.push({ method: 'delete', args: fileId });
-            },
-            async retrieve(fileId) {
-                fake.fileCalls.push({ method: 'retrieve', args: fileId });
-                return { data: Buffer.from('fake-content'), mimeType: 'application/octet-stream' };
-            },
-        };
-        const factory = {
-            name: '__fake__',
-            create: () => adapter,
-            createEmbedding: () => embeddingAdapter,
-            createImage: () => imageAdapter,
-            createTts: () => ttsAdapter,
-            createStt: () => sttAdapter,
-            createReranking: () => rerankingAdapter,
-            createFiles: () => fileAdapter,
-        };
-        AiRegistry.reset();
-        AiRegistry.register(factory);
-        AiRegistry.setDefault('__fake__/default');
-        return fake;
-    }
-    /** Assert at least one prompt was sent, optionally matching a predicate */
-    assertPrompted(predicate) {
-        if (this.calls.length === 0)
-            throw new Error('[Rudder AI] Expected at least one prompt, but none were sent.');
-        if (predicate) {
-            const match = this.calls.some(c => {
-                const userMsg = c.messages.find(m => m.role === 'user');
-                if (!userMsg)
-                    return false;
-                const text = typeof userMsg.content === 'string' ? userMsg.content : userMsg.content.filter(p => p.type === 'text').map(p => p.text).join('');
-                return predicate(text);
-            });
-            if (!match)
-                throw new Error('[Rudder AI] No prompt matched the predicate.');
-        }
-    }
-    /** Assert no prompts were sent */
-    assertNothingPrompted() {
-        if (this.calls.length > 0) {
-            throw new Error(`[Rudder AI] Expected no prompts, but ${this.calls.length} were sent.`);
-        }
-    }
-    /** Assert at least one image generation was made */
-    assertImageGenerated(predicate) {
-        if (this.imageCalls.length === 0)
-            throw new Error('[Rudder AI] Expected at least one image generation, but none were made.');
-        if (predicate) {
-            const match = this.imageCalls.some(c => predicate(c.prompt));
-            if (!match)
-                throw new Error('[Rudder AI] No image generation matched the predicate.');
-        }
-    }
-    /** Assert at least one TTS generation was made */
-    assertAudioGenerated(predicate) {
-        if (this.ttsCalls.length === 0)
-            throw new Error('[Rudder AI] Expected at least one audio generation, but none were made.');
-        if (predicate) {
-            const match = this.ttsCalls.some(c => predicate(c.text));
-            if (!match)
-                throw new Error('[Rudder AI] No audio generation matched the predicate.');
-        }
-    }
-    /** Assert at least one transcription was made */
-    assertTranscribed(predicate) {
-        if (this.sttCalls.length === 0)
-            throw new Error('[Rudder AI] Expected at least one transcription, but none were made.');
-        if (predicate) {
-            const match = this.sttCalls.some(c => predicate(c));
-            if (!match)
-                throw new Error('[Rudder AI] No transcription matched the predicate.');
-        }
-    }
-    /** Get all recorded provider calls */
-    getCalls() {
-        return [...this.calls];
-    }
-    /** Get all recorded image generation calls */
-    getImageCalls() {
-        return [...this.imageCalls];
-    }
-    /** Get all recorded TTS calls */
-    getTtsCalls() {
-        return [...this.ttsCalls];
-    }
-    /** Get all recorded STT calls */
-    getSttCalls() {
-        return [...this.sttCalls];
-    }
-    /** Assert at least one embedding was made */
-    assertEmbedded(predicate) {
-        if (this.embedCalls.length === 0)
-            throw new Error('[Rudder AI] Expected at least one embedding, but none were made.');
-        if (predicate) {
-            const match = this.embedCalls.some(c => predicate(c.input));
-            if (!match)
-                throw new Error('[Rudder AI] No embedding matched the predicate.');
-        }
-    }
-    /** Assert at least one reranking was made */
-    assertReranked(predicate) {
-        if (this.rerankCalls.length === 0)
-            throw new Error('[Rudder AI] Expected at least one reranking, but none were made.');
-        if (predicate) {
-            const match = this.rerankCalls.some(c => predicate(c));
-            if (!match)
-                throw new Error('[Rudder AI] No reranking matched the predicate.');
-        }
-    }
-    /** Get all recorded embedding calls */
-    getEmbedCalls() {
-        return [...this.embedCalls];
-    }
-    /** Get all recorded reranking calls */
-    getRerankCalls() {
-        return [...this.rerankCalls];
-    }
-    /** Assert at least one file upload was made */
-    assertFileUploaded(predicate) {
-        const uploads = this.fileCalls.filter(c => c.method === 'upload');
-        if (uploads.length === 0)
-            throw new Error('[Rudder AI] Expected at least one file upload, but none were made.');
-        if (predicate) {
-            const match = uploads.some(c => predicate(c.args.filePath));
-            if (!match)
-                throw new Error('[Rudder AI] No file upload matched the predicate.');
-        }
-    }
-    /** Get all recorded file operation calls */
-    getFileCalls() {
-        return [...this.fileCalls];
-    }
-    /** Restore — clears the fake (user must re-register real providers) */
-    restore() {
-        AiRegistry.reset();
-    }
-}
-/**
- * Render canned file-search hits into a prose assistant reply for
- * {@link AiFake.respondWithFileSearchResults}. Keeps tests readable
- * without each app having to ad-hoc its own formatter.
- */
-function formatFileSearchHits(hits) {
-    if (hits.length === 0)
-        return 'No relevant documents found.';
-    return hits
-        .map(h => {
-        const parts = [];
-        if (h.score !== undefined)
-            parts.push(`(${h.score.toFixed(2)})`);
-        parts.push(h.text);
-        if (h.source)
-            parts.push(`— ${h.source}`);
-        return parts.join(' ');
-    })
-        .join('\n');
-}
-//# sourceMappingURL=fake.js.map

package/dist/fake.js.map

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

package/dist/file-search.d.ts

@@ -1,168 +0,0 @@
-/**
- * `fileSearch({ stores, where?, maxResults?, name?, description? })` — agent
- * tool factory for hosted vector-store retrieval (#B8 Phase 2).
- *
- * Wraps OpenAI's native `file_search` tool. The tool object is tagged with
- * `providerHint: { type: 'file-search', ... }`; the OpenAI adapter's
- * `toOpenAITools` recognizes the hint and emits the native
- * `{ type: 'file_search', vector_store_ids, filters, max_num_results }`
- * block instead of a generic function-call shape. The model runs the search
- * server-side and the results land in the assistant message — no agent-loop
- * tool round-trip on the hosted path.
- *
- * # Hosted on OpenAI today
- *
- * Other providers see the tool as a regular function-call tool with the
- * placeholder `{ query: string }` schema — without an `execute` they pause
- * for client tools, which is degraded. Phase 3 will add a `fallback` opt
- * that installs an `execute` delegating to `similaritySearch` over a local
- * pgvector model.
- *
- * # Wiring
- *
- * ```ts
- * import { Agent, fileSearch, VectorStores } from '@rudderjs/ai'
- *
- * const kb = await VectorStores.get('vs_abc123')
- *
- * class SupportAgent extends Agent {
- *   model() { return 'openai/gpt-4o' }
- *   tools() {
- *     return [
- *       fileSearch({
- *         stores:     [kb.id],
- *         where:      { author: 'Alice', year: 2026 },
- *         maxResults: 10,
- *       }),
- *     ]
- *   }
- * }
- * ```
- *
- * # Metadata filter sugar
- *
- * `where: { author: 'Alice', year: 2026 }` is shorthand for the typed
- * OpenAI filter shape `{ type: 'and', filters: [{ type: 'eq', key: 'author',
- * value: 'Alice' }, { type: 'eq', key: 'year', value: 2026 }] }`. Either
- * shape works — pass the typed object form for `gt` / `lt` / `or`.
- */
-import type { SimilaritySearchOptions } from './similarity-search.js';
-import type { Tool, ToolDefinitionOptions, ToolDefinitionSchema } from './types.js';
-/**
- * Symbol-tagged marker identifying a file-search tool. Mirrors the
- * `COMPUTER_USE_MARKER` pattern — `Symbol.for(...)` so cross-bundle /
- * cross-realm checks succeed even when `@rudderjs/ai` loads twice.
- */
-export declare const FILE_SEARCH_MARKER: unique symbol;
-/**
- * Default tool name. OpenAI's native `file_search` tool expects calls to
- * land on a tool literally named `file_search` — the model is trained on
- * that identifier. Apps can override via `opts.name` but usually shouldn't.
- */
-export declare const FILE_SEARCH_TOOL_NAME = "file_search";
-/** OpenAI vector-store metadata filter, typed form. */
-export type FileSearchFilter = {
-    type: 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte';
-    key: string;
-    value: string | number | boolean;
-} | {
-    type: 'and' | 'or';
-    filters: FileSearchFilter[];
-};
-/** Sugar shape for `where` — `{ key: value }` pairs lowered to a typed `and` of `eq` filters. */
-export type FileSearchWhereSugar = Record<string, string | number | boolean>;
-/**
- * Local pgvector fallback configuration (#B8 Phase 3). When set, the tool
- * gains an `execute` that delegates to {@link similaritySearch} against
- * the supplied Model. Forwards every {@link SimilaritySearchOptions} field
- * except `name` / `description` (those flow from the outer `fileSearch`
- * call so the agent prompt stays identical across providers).
- */
-export type FileSearchFallback<TInstance = unknown> = Omit<SimilaritySearchOptions<TInstance>, 'name' | 'description'>;
-export interface FileSearchOptions<TInstance = unknown> {
-    /**
-     * Vector-store IDs the model should search. At least one required.
-     * Mixing providers (e.g. an OpenAI `vs_...` id with a Gemini cached-
-     * content id) is not supported in v1 — every id must come from the
-     * agent's configured provider.
-     */
-    stores: string[];
-    /**
-     * Metadata filter applied server-side. Accepts either the sugar
-     * `{ key: value }` form (lowered to an `and` of `eq` filters) or the
-     * typed {@link FileSearchFilter} shape directly.
-     */
-    where?: FileSearchWhereSugar | FileSearchFilter;
-    /** Maximum number of result chunks to return. Provider default applies when unset. */
-    maxResults?: number;
-    /** Override the tool name. Defaults to {@link FILE_SEARCH_TOOL_NAME}. */
-    name?: string;
-    /** Override the tool description shown to the model. Defaults to a generic phrasing. */
-    description?: string;
-    /**
-     * Local pgvector fallback (#B8 Phase 3). When set, the returned tool gains
-     * an `execute` that delegates to `similaritySearch` for providers that
-     * don't recognize the `'file-search'` `providerHint`.
-     *
-     * The cascade is automatic. On OpenAI the adapter emits the native
-     * `file_search` block — the search runs server-side, the model never
-     * invokes the function-call tool, and `execute` is dead weight. On any
-     * other provider (Anthropic, Gemini today, others) the tool serializes
-     * as a regular function-call schema, the model calls it, and `execute`
-     * delegates to `similaritySearch` against the local pgvector model.
-     *
-     * Same agent prompt across hosted and self-hosted RAG — ops can swap
-     * deployment targets without retraining.
-     *
-     * @example
-     * ```ts
-     * fileSearch({
-     *   stores: [vs_id],
-     *   fallback: {
-     *     model:     Document,
-     *     column:    'embedding',
-     *     embedWith: 'openai/text-embedding-3-small',
-     *   },
-     * })
-     * ```
-     */
-    fallback?: FileSearchFallback<TInstance>;
-}
-/**
- * A `fileSearch` tool. Implements {@link Tool}; carries
- * {@link FILE_SEARCH_MARKER} for typeguarding.
- *
- * `execute` is absent on the hosted-only path (no `fallback` opt) — the
- * provider runs the search natively and the model gets results back
- * inline. With a `fallback` opt configured (#B8 Phase 3), `execute` is
- * present and delegates to `similaritySearch` so non-native providers
- * (Anthropic, Gemini today, others) get a working RAG path against a
- * local pgvector model.
- */
-export interface FileSearchTool extends Tool<{
-    query: string;
-}, unknown> {
-    readonly [FILE_SEARCH_MARKER]: true;
-    readonly definition: ToolDefinitionOptions;
-    toSchema(): ToolDefinitionSchema;
-}
-/** Build the agent tool. See module JSDoc for usage. */
-export declare function fileSearch<TInstance = unknown>(opts: FileSearchOptions<TInstance>): FileSearchTool;
-/**
- * Structural typeguard. Mirrors `isComputerUseTool` / `isHandoffTool` —
- * tools are plain objects tagged with `Symbol.for(...)` markers so the
- * loop and adapters can detect them without coupling to a class.
- */
-export declare function isFileSearchTool(t: unknown): t is FileSearchTool;
-/**
- * Lower the user-friendly `where` shape to OpenAI's typed filter object.
- *
- * - `{ author: 'Alice', year: 2026 }` → `{ type: 'and', filters: [eq, eq] }`
- * - `{ type: 'eq' | ... }`           → pass-through
- * - `{ type: 'and' | 'or', filters }` → pass-through
- *
- * A single-key sugar object short-circuits to the bare `eq` (no `and`
- * wrapper), matching OpenAI's recommended shape.
- */
-export declare function normalizeWhere(where: FileSearchWhereSugar | FileSearchFilter): FileSearchFilter;
-//# sourceMappingURL=file-search.d.ts.map

package/dist/file-search.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"file-search.d.ts","sourceRoot":"","sources":["../src/file-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAKH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AACrE,OAAO,KAAK,EAAgB,IAAI,EAAE,qBAAqB,EAAE,oBAAoB,EAAiB,MAAM,YAAY,CAAA;AAEhH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAAO,MAA8C,CAAA;AAEtF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,gBAAgB,CAAA;AAMlD,uDAAuD;AACvD,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;CAAE,GAClG;IAAE,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAAA;AAEvD,iGAAiG;AACjG,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;AAE5E;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,CAAC,SAAS,GAAG,OAAO,IAChD,IAAI,CAAC,uBAAuB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,CAAA;AAElE,MAAM,WAAW,iBAAiB,CAAC,SAAS,GAAG,OAAO;IACpD;;;;;OAKG;IACH,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,oBAAoB,GAAG,gBAAgB,CAAA;IAC/C,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,QAAQ,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAA;CACzC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,CAAC;IACtE,QAAQ,CAAC,CAAC,kBAAkB,CAAC,EAAE,IAAI,CAAA;IACnC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAA;IAC1C,QAAQ,IAAI,oBAAoB,CAAA;CACjC;AAED,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,SAAS,GAAG,OAAO,EAAE,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC,GAAG,cAAc,CA4DlG;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,cAAc,CAIhE;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,oBAAoB,GAAG,gBAAgB,GAAG,gBAAgB,CAS/F"}