@nodetool-ai/base-nodes 0.7.0-rc.11

package/dist/lib/audio-wav.js

@@ -0,0 +1,215 @@
+/**
+ * Canonical audio encoding/decoding helpers shared across the base-nodes
+ * audio node implementations.
+ *
+ * - `encodeWav` / `decodeWav` operate in Float32 sample space ([-1, 1]) and
+ *   handle 16-bit PCM WAV with proper chunk traversal.
+ * - `audioBytes` / `audioBytesAsync` / `audioRefFromBytes` deal with the raw
+ *   byte stream inside an `AudioRef`, independent of format. These are the
+ *   single source of truth for every nodetool audio node — do not duplicate
+ *   them at call sites.
+ */
+import { promises as fs } from "node:fs";
+import { fileURLToPath } from "node:url";
+/** Decode a base64 string to bytes, or pass through an existing Uint8Array. */
+export function toBytes(value) {
+    if (!value)
+        return new Uint8Array();
+    if (value instanceof Uint8Array)
+        return value;
+    if (typeof value !== "string")
+        throw new Error("Invalid audio data");
+    return Uint8Array.from(Buffer.from(value, "base64"));
+}
+/** Synchronously extract raw bytes from an AudioRef's inline `data` field. */
+export function audioBytes(audio) {
+    if (!audio || typeof audio !== "object")
+        return new Uint8Array();
+    return toBytes(audio.data);
+}
+/**
+ * Extract raw bytes from an AudioRef, falling back to URI-based retrieval
+ * (storage, `file://`, `http(s)://`) when no inline data is present.
+ */
+export async function audioBytesAsync(audio, context) {
+    if (!audio || typeof audio !== "object")
+        return new Uint8Array();
+    const ref = audio;
+    if (ref.data)
+        return toBytes(ref.data);
+    if (typeof ref.uri === "string" && ref.uri) {
+        try {
+            if (context?.storage) {
+                const stored = await context.storage.retrieve(ref.uri);
+                if (stored !== null)
+                    return new Uint8Array(stored);
+            }
+            if (ref.uri.startsWith("file://")) {
+                return new Uint8Array(await fs.readFile(uriToPath(ref.uri)));
+            }
+            if (ref.uri.startsWith("http://") || ref.uri.startsWith("https://")) {
+                const response = await fetch(ref.uri);
+                return new Uint8Array(await response.arrayBuffer());
+            }
+        }
+        catch {
+            return new Uint8Array();
+        }
+    }
+    return new Uint8Array();
+}
+/** Strip a `file://` scheme from a URI, returning a plain filesystem path. */
+export function uriToPath(uriOrPath) {
+    if (uriOrPath.startsWith("file://")) {
+        try {
+            return fileURLToPath(new URL(uriOrPath));
+        }
+        catch {
+            // Fallback for non-standard URIs like file://C:\path
+            return uriOrPath.slice("file://".length);
+        }
+    }
+    return uriOrPath;
+}
+/** Wrap raw bytes into an AudioRef (base64-encoding the data). */
+export function audioRefFromBytes(data, uri) {
+    return {
+        type: "audio",
+        uri: uri ?? "",
+        data: Buffer.from(data).toString("base64")
+    };
+}
+/** Semantic alias for `audioRefFromBytes` at sites that specifically emit WAV. */
+export function audioRefFromWav(wav, uri) {
+    return audioRefFromBytes(wav, uri);
+}
+/** Concatenate Uint8Arrays into a single buffer. */
+export function concatBytes(chunks) {
+    const total = chunks.reduce((sum, c) => sum + c.length, 0);
+    const out = new Uint8Array(total);
+    let offset = 0;
+    for (const c of chunks) {
+        out.set(c, offset);
+        offset += c.length;
+    }
+    return out;
+}
+/**
+ * Wrap a buffer of already-encoded little-endian 16-bit PCM samples in a
+ * RIFF/WAVE container. Use when the caller already has Int16 samples (e.g.
+ * from a TTS provider streaming `response_format: "pcm"`) — avoids the
+ * Int16 → Float32 → Int16 round-trip that `encodeWav` would impose.
+ */
+export function encodePcm16Wav(pcmBytes, sampleRate, numChannels = 1) {
+    const bitsPerSample = 16;
+    const blockAlign = (numChannels * bitsPerSample) / 8;
+    const byteRate = sampleRate * blockAlign;
+    const dataSize = pcmBytes.length;
+    const buffer = Buffer.alloc(44 + dataSize);
+    buffer.write("RIFF", 0);
+    buffer.writeUInt32LE(36 + dataSize, 4);
+    buffer.write("WAVE", 8);
+    buffer.write("fmt ", 12);
+    buffer.writeUInt32LE(16, 16);
+    buffer.writeUInt16LE(1, 20); // PCM
+    buffer.writeUInt16LE(numChannels, 22);
+    buffer.writeUInt32LE(sampleRate, 24);
+    buffer.writeUInt32LE(byteRate, 28);
+    buffer.writeUInt16LE(blockAlign, 32);
+    buffer.writeUInt16LE(bitsPerSample, 34);
+    buffer.write("data", 36);
+    buffer.writeUInt32LE(dataSize, 40);
+    Buffer.from(pcmBytes.buffer, pcmBytes.byteOffset, pcmBytes.byteLength).copy(buffer, 44);
+    return new Uint8Array(buffer);
+}
+/**
+ * Encode Float32 samples (expected range [-1, 1]) as a 16-bit PCM WAV file.
+ * Samples outside the range are clipped. Channels are interleaved.
+ */
+export function encodeWav(samples, sampleRate, numChannels = 1) {
+    const bitsPerSample = 16;
+    const blockAlign = (numChannels * bitsPerSample) / 8;
+    const byteRate = sampleRate * blockAlign;
+    const dataSize = samples.length * 2;
+    const buffer = Buffer.alloc(44 + dataSize);
+    buffer.write("RIFF", 0);
+    buffer.writeUInt32LE(36 + dataSize, 4);
+    buffer.write("WAVE", 8);
+    buffer.write("fmt ", 12);
+    buffer.writeUInt32LE(16, 16);
+    buffer.writeUInt16LE(1, 20); // PCM
+    buffer.writeUInt16LE(numChannels, 22);
+    buffer.writeUInt32LE(sampleRate, 24);
+    buffer.writeUInt32LE(byteRate, 28);
+    buffer.writeUInt16LE(blockAlign, 32);
+    buffer.writeUInt16LE(bitsPerSample, 34);
+    buffer.write("data", 36);
+    buffer.writeUInt32LE(dataSize, 40);
+    for (let i = 0; i < samples.length; i++) {
+        const s = Math.max(-1, Math.min(1, samples[i]));
+        buffer.writeInt16LE(Math.round(s * 0x7fff), 44 + i * 2);
+    }
+    return new Uint8Array(buffer);
+}
+/**
+ * Parse already-loaded WAV bytes into Float32 samples.
+ * Returns null when the input is not a valid RIFF/WAVE file.
+ * Supports 16-bit and 8-bit PCM. Subchunks are traversed, so non-standard
+ * layouts with `LIST`/`JUNK`/etc. before the `data` chunk work correctly.
+ */
+export function parseWavBytes(bytes) {
+    if (bytes.length < 44)
+        return null;
+    const buf = Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    if (buf.toString("ascii", 0, 4) !== "RIFF" ||
+        buf.toString("ascii", 8, 12) !== "WAVE") {
+        return null;
+    }
+    const sampleRate = buf.readUInt32LE(24);
+    const bitsPerSample = buf.readUInt16LE(34);
+    const numChannels = buf.readUInt16LE(22);
+    let dataOffset = 36;
+    while (dataOffset < buf.length - 8) {
+        const chunkId = buf.toString("ascii", dataOffset, dataOffset + 4);
+        const chunkSize = buf.readUInt32LE(dataOffset + 4);
+        if (chunkId === "data") {
+            dataOffset += 8;
+            break;
+        }
+        dataOffset += 8 + chunkSize;
+    }
+    const bytesPerSample = bitsPerSample / 8;
+    if (bytesPerSample !== 1 && bytesPerSample !== 2)
+        return null;
+    const totalSamples = Math.floor((buf.length - dataOffset) / bytesPerSample);
+    const samples = new Float32Array(totalSamples);
+    for (let i = 0; i < totalSamples; i++) {
+        const pos = dataOffset + i * bytesPerSample;
+        if (bitsPerSample === 16) {
+            samples[i] = buf.readInt16LE(pos) / 0x7fff;
+        }
+        else if (bitsPerSample === 8) {
+            samples[i] = (buf.readUInt8(pos) - 128) / 128;
+        }
+    }
+    return { samples, sampleRate, numChannels };
+}
+/**
+ * Decode an AudioRef as WAV. Throws when the ref does not contain a valid
+ * WAV file.
+ */
+export function decodeWav(audio) {
+    const wav = parseWavBytes(audioBytes(audio));
+    if (!wav)
+        throw new Error("Invalid WAV file");
+    return wav;
+}
+/**
+ * Decode an AudioRef as WAV, returning null for non-WAV / malformed input
+ * instead of throwing. Use this when a caller wants to fall back to raw
+ * byte handling when the input is not WAV.
+ */
+export function tryDecodeWav(audio) {
+    return parseWavBytes(audioBytes(audio));
+}
+//# sourceMappingURL=audio-wav.js.map

package/dist/lib/audio-wav.js.map

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

package/dist/nodes/agents.d.ts

@@ -0,0 +1,253 @@
+import { BaseNode } from "@nodetool-ai/node-sdk";
+import type { BaseProvider, Message, MessageContent, ProcessingContext, ProviderStreamItem, ToolCall } from "@nodetool-ai/runtime";
+import type { Chunk } from "@nodetool-ai/protocol";
+export type ToolLike = {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+    process?: (context: ProcessingContext, params: Record<string, unknown>) => Promise<unknown>;
+    toProviderTool?: () => {
+        name: string;
+        description?: string;
+        inputSchema?: Record<string, unknown>;
+    };
+};
+export declare function streamProviderMessages(provider: BaseProvider, args: Parameters<BaseProvider["generateMessages"]>[0]): AsyncGenerator<ProviderStreamItem>;
+export declare function isChunkItem(item: ProviderStreamItem): item is Chunk;
+export declare function isToolCallItem(item: ProviderStreamItem): item is ToolCall;
+export declare function toProviderTools(tools: ToolLike[]): Array<{
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+}>;
+export declare function serializeToolResult(value: unknown): unknown;
+export interface AgentLoopOptions {
+    context: ProcessingContext;
+    providerId: string;
+    modelId: string;
+    systemPrompt: string;
+    prompt: string;
+    tools: ToolLike[];
+    contentParts?: MessageContent[];
+    maxTokens?: number;
+    maxIterations?: number;
+    threadId?: string;
+}
+export interface AgentLoopResult {
+    text: string;
+    messages: Message[];
+}
+export declare function runAgentLoop(options: AgentLoopOptions): Promise<AgentLoopResult>;
+export declare class SummarizerNode extends BaseNode {
+    static readonly nodeType = "nodetool.agents.Summarizer";
+    static readonly title = "Summarizer";
+    static readonly description = "Generate concise summaries of text content using LLM providers with streaming output.\n    text, summarization, nlp, content, streaming\n\n    Specialized for creating high-quality summaries with real-time streaming:\n    - Condensing long documents into key points\n    - Creating executive summaries with live output\n    - Extracting main ideas from text as they're generated\n    - Maintaining factual accuracy while reducing length";
+    static readonly metadataOutputTypes: {
+        text: string;
+        chunk: string;
+    };
+    static readonly basicFields: string[];
+    static readonly recommendedModels: ({
+        id: string;
+        type: string;
+        name: string;
+        repo_id: string;
+        description: string;
+        size_on_disk: number;
+        path?: undefined;
+        pipeline_tag?: undefined;
+        tags?: undefined;
+        has_model_index?: undefined;
+        downloads?: undefined;
+        likes?: undefined;
+    } | {
+        id: string;
+        type: string;
+        name: string;
+        repo_id: string;
+        path: string;
+        description: string;
+        size_on_disk: number;
+        pipeline_tag: string;
+        tags: string[];
+        has_model_index: boolean;
+        downloads: number;
+        likes: number;
+    })[];
+    static readonly isStreamingOutput = true;
+    system_prompt: any;
+    model: any;
+    text: any;
+    image: any;
+    audio: any;
+    process(context?: ProcessingContext): Promise<Record<string, unknown>>;
+}
+export declare class CreateThreadNode extends BaseNode {
+    static readonly nodeType = "nodetool.agents.CreateThread";
+    static readonly title = "Create Thread";
+    static readonly description = "Create a new conversation thread and return its ID.\n    threads, chat, conversation, context\n\n    Use this to seed a thread_id that downstream Agent nodes can reuse for\n    persistent history across the graph or multiple runs.";
+    static readonly metadataOutputTypes: {
+        thread_id: string;
+    };
+    title: any;
+    thread_id: any;
+    process(): Promise<Record<string, unknown>>;
+}
+export declare class ExtractorNode extends BaseNode {
+    static readonly nodeType = "nodetool.agents.Extractor";
+    static readonly title = "Extractor";
+    static readonly description = "Extract structured data from text content using LLM providers.\n    data-extraction, structured-data, nlp, parsing\n\n    Specialized for extracting structured information:\n    - Converting unstructured text into structured data\n    - Identifying and extracting specific fields from documents\n    - Parsing text according to predefined schemas\n    - Creating structured records from natural language content";
+    static readonly basicFields: string[];
+    static readonly supportsDynamicOutputs = true;
+    static readonly recommendedModels: ({
+        id: string;
+        type: string;
+        name: string;
+        repo_id: string;
+        description: string;
+        size_on_disk: number;
+        path?: undefined;
+        pipeline_tag?: undefined;
+        tags?: undefined;
+        has_model_index?: undefined;
+        downloads?: undefined;
+        likes?: undefined;
+    } | {
+        id: string;
+        type: string;
+        name: string;
+        repo_id: string;
+        path: string;
+        description: string;
+        size_on_disk: number;
+        pipeline_tag: string;
+        tags: string[];
+        has_model_index: boolean;
+        downloads: number;
+        likes: number;
+    })[];
+    system_prompt: any;
+    model: any;
+    text: any;
+    image: any;
+    audio: any;
+    process(context?: ProcessingContext): Promise<Record<string, unknown>>;
+}
+export declare class ClassifierNode extends BaseNode {
+    static readonly nodeType = "nodetool.agents.Classifier";
+    static readonly title = "Classifier";
+    static readonly description = "Classify text into predefined or dynamic categories using LLM.\n    classification, nlp, categorization\n\n    Use cases:\n    - Sentiment analysis\n    - Topic classification\n    - Intent detection\n    - Content categorization";
+    static readonly metadataOutputTypes: {
+        output: string;
+    };
+    static readonly basicFields: string[];
+    static readonly recommendedModels: ({
+        id: string;
+        type: string;
+        name: string;
+        repo_id: string;
+        description: string;
+        size_on_disk: number;
+        path?: undefined;
+        pipeline_tag?: undefined;
+        tags?: undefined;
+        has_model_index?: undefined;
+        downloads?: undefined;
+        likes?: undefined;
+    } | {
+        id: string;
+        type: string;
+        name: string;
+        repo_id: string;
+        path: string;
+        description: string;
+        size_on_disk: number;
+        pipeline_tag: string;
+        tags: string[];
+        has_model_index: boolean;
+        downloads: number;
+        likes: number;
+    })[];
+    system_prompt: any;
+    model: any;
+    text: any;
+    image: any;
+    audio: any;
+    categories: any;
+    process(context?: ProcessingContext): Promise<Record<string, unknown>>;
+}
+export declare class AgentNode extends BaseNode {
+    static readonly nodeType = "nodetool.agents.Agent";
+    static readonly title = "Agent";
+    static readonly description = "Generate natural language responses using LLM providers and streams output.\n    llm, text-generation, chatbot, question-answering, streaming";
+    static readonly metadataOutputTypes: {
+        text: string;
+        chunk: string;
+        thinking: string;
+        audio: string;
+    };
+    static readonly basicFields: string[];
+    static readonly supportsDynamicOutputs = true;
+    static readonly recommendedModels: ({
+        id: string;
+        type: string;
+        name: string;
+        repo_id: string;
+        description: string;
+        size_on_disk: number;
+        path?: undefined;
+        tags?: undefined;
+        has_model_index?: undefined;
+        downloads?: undefined;
+        likes?: undefined;
+        pipeline_tag?: undefined;
+    } | {
+        id: string;
+        type: string;
+        name: string;
+        repo_id: string;
+        path: string;
+        description: string;
+        size_on_disk: number;
+        tags: string[];
+        has_model_index: boolean;
+        downloads: number;
+        likes: number;
+        pipeline_tag?: undefined;
+    } | {
+        id: string;
+        type: string;
+        name: string;
+        repo_id: string;
+        path: string;
+        description: string;
+        size_on_disk: number;
+        pipeline_tag: string;
+        tags: string[];
+        has_model_index: boolean;
+        downloads: number;
+        likes: number;
+    })[];
+    static readonly isStreamingOutput = true;
+    model: any;
+    mode: any;
+    system: any;
+    prompt: any;
+    tools: any;
+    image: any;
+    audio: any;
+    history: any;
+    thread_id: any;
+    max_tokens: any;
+    num_agents: any;
+    team_strategy: any;
+    genProcess(context?: ProcessingContext): AsyncGenerator<Record<string, unknown>>;
+    process(context?: ProcessingContext): Promise<Record<string, unknown>>;
+    /**
+     * Dispatch to MultiModeAgent for "plan" and "multi-agent" modes.
+     * Converts ToolLike[] to AgentTool[] and bridges ProcessingMessage to node outputs.
+     */
+    private genProcessMultiMode;
+}
+export declare const AGENT_NODES: readonly [typeof SummarizerNode, typeof CreateThreadNode, typeof ExtractorNode, typeof ClassifierNode, typeof AgentNode];
+//# sourceMappingURL=agents.d.ts.map

package/dist/nodes/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/nodes/agents.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAQ,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EACV,YAAY,EACZ,OAAO,EAEP,cAAc,EAEd,iBAAiB,EACjB,kBAAkB,EAClB,QAAQ,EACT,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,KAAK,EAAqB,MAAM,uBAAuB,CAAC;AAMtE,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,CACR,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACvC,CAAC;CACH,CAAC;AAgMF,wBAAuB,sBAAsB,CAC3C,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,UAAU,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,GACpD,cAAc,CAAC,kBAAkB,CAAC,CA+BpC;AAqTD,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,IAAI,KAAK,CAOnE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,IAAI,QAAQ,CAQzE;AAYD,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC,CAAC,CAUD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAc3D;AA6RD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,YAAY,CAAC,EAAE,cAAc,EAAE,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CA0J1B;AA2CD,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,MAAM,CAAC,QAAQ,CAAC,QAAQ,gCAAgC;IACxD,MAAM,CAAC,QAAQ,CAAC,KAAK,gBAAgB;IACrC,MAAM,CAAC,QAAQ,CAAC,WAAW,0bAC8Z;IACzb,MAAM,CAAC,QAAQ,CAAC,mBAAmB;;;MAGjC;IACF,MAAM,CAAC,QAAQ,CAAC,WAAW,WAAuC;IAClE,MAAM,CAAC,QAAQ,CAAC,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;SA0G/B;IAEF,MAAM,CAAC,QAAQ,CAAC,iBAAiB,QAAQ;IAQjC,aAAa,EAAE,GAAG,CAAC;IAenB,KAAK,EAAE,GAAG,CAAC;IAQX,IAAI,EAAE,GAAG,CAAC;IAcV,KAAK,EAAE,GAAG,CAAC;IAcX,KAAK,EAAE,GAAG,CAAC;IAEb,OAAO,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CA2B7E;AAED,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,MAAM,CAAC,QAAQ,CAAC,QAAQ,kCAAkC;IAC1D,MAAM,CAAC,QAAQ,CAAC,KAAK,mBAAmB;IACxC,MAAM,CAAC,QAAQ,CAAC,WAAW,4OACgN;IAC3O,MAAM,CAAC,QAAQ,CAAC,mBAAmB;;MAEjC;IAQM,KAAK,EAAE,GAAG,CAAC;IASX,SAAS,EAAE,GAAG,CAAC;IAEjB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAqBlD;AAED,qBAAa,aAAc,SAAQ,QAAQ;IACzC,MAAM,CAAC,QAAQ,CAAC,QAAQ,+BAA+B;IACvD,MAAM,CAAC,QAAQ,CAAC,KAAK,eAAe;IACpC,MAAM,CAAC,QAAQ,CAAC,WAAW,iaACqY;IACha,MAAM,CAAC,QAAQ,CAAC,WAAW,WAAuC;IAClE,MAAM,CAAC,QAAQ,CAAC,sBAAsB,QAAQ;IAC9C,MAAM,CAAC,QAAQ,CAAC,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;SA0G/B;IASM,aAAa,EAAE,GAAG,CAAC;IAenB,KAAK,EAAE,GAAG,CAAC;IAQX,IAAI,EAAE,GAAG,CAAC;IAcV,KAAK,EAAE,GAAG,CAAC;IAcX,KAAK,EAAE,GAAG,CAAC;IAEb,OAAO,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CA4B7E;AAED,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,MAAM,CAAC,QAAQ,CAAC,QAAQ,gCAAgC;IACxD,MAAM,CAAC,QAAQ,CAAC,KAAK,gBAAgB;IACrC,MAAM,CAAC,QAAQ,CAAC,WAAW,2OAC+M;IAC1O,MAAM,CAAC,QAAQ,CAAC,mBAAmB;;MAEjC;IACF,MAAM,CAAC,QAAQ,CAAC,WAAW,WAMzB;IACF,MAAM,CAAC,QAAQ,CAAC,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;SA0G/B;IASM,aAAa,EAAE,GAAG,CAAC;IAenB,KAAK,EAAE,GAAG,CAAC;IAQX,IAAI,EAAE,GAAG,CAAC;IAcV,KAAK,EAAE,GAAG,CAAC;IAcX,KAAK,EAAE,GAAG,CAAC;IASX,UAAU,EAAE,GAAG,CAAC;IAElB,OAAO,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAqD7E;AAED,qBAAa,SAAU,SAAQ,QAAQ;IACrC,MAAM,CAAC,QAAQ,CAAC,QAAQ,2BAA2B;IACnD,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,WAAW,mJACuH;IAClJ,MAAM,CAAC,QAAQ,CAAC,mBAAmB;;;;;MAKjC;IACF,MAAM,CAAC,QAAQ,CAAC,WAAW,WAAkD;IAC7E,MAAM,CAAC,QAAQ,CAAC,sBAAsB,QAAQ;IAC9C,MAAM,CAAC,QAAQ,CAAC,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SAud/B;IAEF,MAAM,CAAC,QAAQ,CAAC,iBAAiB,QAAQ;IAcjC,KAAK,EAAE,GAAG,CAAC;IAUX,IAAI,EAAE,GAAG,CAAC;IASV,MAAM,EAAE,GAAG,CAAC;IASZ,MAAM,EAAE,GAAG,CAAC;IASZ,KAAK,EAAE,GAAG,CAAC;IAcX,KAAK,EAAE,GAAG,CAAC;IAcX,KAAK,EAAE,GAAG,CAAC;IASX,OAAO,EAAE,GAAG,CAAC;IASb,SAAS,EAAE,GAAG,CAAC;IAWf,UAAU,EAAE,GAAG,CAAC;IAWhB,UAAU,EAAE,GAAG,CAAC;IAUhB,aAAa,EAAE,GAAG,CAAC;IAEpB,UAAU,CACf,OAAO,CAAC,EAAE,iBAAiB,GAC1B,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAqjBpC,OAAO,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IA6C5E;;;OAGG;YACY,mBAAmB;CA2FnC;AAED,eAAO,MAAM,WAAW,0HAMd,CAAC"}