@frugalco/frugal-sdk-node 0.1.0

package/dist/instrument.js

@@ -0,0 +1,194 @@
+// Shared instrumentation helpers used by per-provider wrappers.
+//
+// A wrapper calls `startCall()` at the top of its closure to resolve the
+// caller and start a timer, then calls `emit.success(...)` on return or
+// `emit.error(...)` on exception. The wrapper must call resolveCaller
+// synchronously from its own frame — don't interpose helper functions between
+// the wrapper frame and resolveCaller, or the caller attribution will be wrong.
+import { consumeCapHitEvent, resolveCaller, } from "./caller.js";
+import { getInstruments } from "./otel.js";
+import { getSharedBlockHashLRU } from "./block-hash-lru.js";
+import { analyzeRequest, shouldSample, structuredOutputMode, } from "./prompt-analyzer.js";
+import { BLOCK_SCHEMA, BLOCK_SYSTEM, BLOCK_TOOLS, BLOCK_USER, FRUGAL_BATCHED, FRUGAL_BLOCK, FRUGAL_CALLER_FILE, FRUGAL_CALLER_FUNCTION, FRUGAL_CUSTOMER_ID, FRUGAL_ERROR_TYPE, FRUGAL_PROJECT_ID, FRUGAL_STABLE, FRUGAL_STRUCTURED_OUTPUT_MODE, GEN_AI_OPERATION_NAME, GEN_AI_REQUEST_MODEL, GEN_AI_RESPONSE_MODEL, GEN_AI_SYSTEM, GEN_AI_TOKEN_TYPE, TOKEN_INPUT, TOKEN_OUTPUT, } from "./semconv.js";
+export function startCall(config, ctx, opts = {}) {
+    const instruments = getInstruments(config);
+    const caller = opts.caller ??
+        resolveCaller({
+            skipPackageDirs: ctx.skipPackageDirs,
+            blockList: config.pathBlockList,
+            repoRoot: config.repoRoot,
+            maxCallSites: config.maxCallSites,
+            skipFrames: opts.skipFrames ?? 2,
+        });
+    if (consumeCapHitEvent()) {
+        try {
+            instruments.internalErrors.add(1, {
+                ...(config.customerId ? { [FRUGAL_CUSTOMER_ID]: config.customerId } : {}),
+                [FRUGAL_PROJECT_ID]: config.projectId,
+                "frugal.internal_error.stage": "cardinality_cap_hit",
+            });
+        }
+        catch {
+            // never let our own metric emission break a customer call
+        }
+    }
+    return new CallEmitter(config, ctx, caller, instruments, nowSeconds());
+}
+function nowSeconds() {
+    // performance.now() returns ms with sub-ms resolution.
+    return performance.now() / 1000;
+}
+export class CallEmitter {
+    config;
+    ctx;
+    caller;
+    instruments;
+    startSec;
+    finalized = false;
+    constructor(config, ctx, caller, instruments, startSec) {
+        this.config = config;
+        this.ctx = ctx;
+        this.caller = caller;
+        this.instruments = instruments;
+        this.startSec = startSec;
+    }
+    success(usage) {
+        if (this.finalized)
+            return;
+        this.finalized = true;
+        const attrs = this.baseAttrs();
+        if (usage.responseModel) {
+            attrs[GEN_AI_RESPONSE_MODEL] = usage.responseModel;
+        }
+        const duration = nowSeconds() - this.startSec;
+        this.instruments.operationDuration.record(duration, attrs);
+        this.instruments.calls.add(1, attrs);
+        if (nonNull(usage.inputTokens)) {
+            this.instruments.tokenUsage.record(usage.inputTokens, {
+                ...attrs,
+                [GEN_AI_TOKEN_TYPE]: TOKEN_INPUT,
+            });
+        }
+        if (nonNull(usage.outputTokens)) {
+            this.instruments.tokenUsage.record(usage.outputTokens, {
+                ...attrs,
+                [GEN_AI_TOKEN_TYPE]: TOKEN_OUTPUT,
+            });
+        }
+        if (nonNull(usage.cacheReadTokens)) {
+            this.instruments.cacheReadTokens.record(usage.cacheReadTokens, attrs);
+        }
+        if (nonNull(usage.cacheWriteTokens)) {
+            this.instruments.cacheWriteTokens.record(usage.cacheWriteTokens, attrs);
+        }
+        if (nonNull(usage.reasoningTokens)) {
+            this.instruments.reasoningTokens.record(usage.reasoningTokens, attrs);
+        }
+        this.recordCapUtilization(usage, attrs);
+        this.maybeAnalyze(attrs);
+    }
+    recordCapUtilization(usage, attrs) {
+        const payload = this.ctx.requestPayload;
+        if (!payload || !nonNull(payload.maxTokens) || !nonNull(usage.outputTokens)) {
+            return;
+        }
+        if (payload.maxTokens <= 0)
+            return;
+        const ratio = Math.min(1, usage.outputTokens / payload.maxTokens);
+        this.instruments.outputCapUtilization.record(ratio, {
+            ...attrs,
+            [FRUGAL_STRUCTURED_OUTPUT_MODE]: structuredOutputMode(payload),
+        });
+    }
+    maybeAnalyze(attrs) {
+        const payload = this.ctx.requestPayload;
+        if (!payload)
+            return;
+        const callSiteId = `${this.caller.file}:${this.caller.function}`;
+        if (!shouldSample(callSiteId, this.config.promptAnalysisSampleRate))
+            return;
+        let result;
+        try {
+            result = analyzeRequest(payload);
+        }
+        catch {
+            return;
+        }
+        if (nonNull(result.historyDepth)) {
+            this.instruments.historyDepth.record(result.historyDepth, attrs);
+        }
+        if (nonNull(result.fewShotCount)) {
+            this.instruments.fewShotCount.record(result.fewShotCount, attrs);
+        }
+        if (nonNull(result.noiseRatio)) {
+            this.instruments.noiseRatio.record(result.noiseRatio, attrs);
+        }
+        if (result.structuredOutputHint) {
+            this.instruments.structuredOutputHint.add(1, attrs);
+        }
+        const lru = getSharedBlockHashLRU(this.config.maxCallSites);
+        const previous = lru.get(callSiteId);
+        const current = {
+            systemHash: result.systemHash,
+            userHash: result.userHash,
+            toolsHash: result.toolsHash,
+            schemaHash: result.schemaHash,
+        };
+        if (previous !== undefined) {
+            this.recordStable(attrs, BLOCK_SYSTEM, previous.systemHash, current.systemHash);
+            this.recordStable(attrs, BLOCK_USER, previous.userHash, current.userHash);
+            this.recordStable(attrs, BLOCK_TOOLS, previous.toolsHash, current.toolsHash);
+            this.recordStable(attrs, BLOCK_SCHEMA, previous.schemaHash, current.schemaHash);
+        }
+        lru.set(callSiteId, current);
+    }
+    recordStable(attrs, block, prev, curr) {
+        // Only emit when both calls had this block — comparing absent-vs-present
+        // would conflate "user didn't send a system prompt this time" with churn.
+        if (prev === null || curr === null)
+            return;
+        this.instruments.cachePrefixStable.add(1, {
+            ...attrs,
+            [FRUGAL_BLOCK]: block,
+            [FRUGAL_STABLE]: prev === curr,
+        });
+    }
+    error(err) {
+        if (this.finalized)
+            return;
+        this.finalized = true;
+        const attrs = this.baseAttrs();
+        attrs[FRUGAL_ERROR_TYPE] = errorName(err);
+        const duration = nowSeconds() - this.startSec;
+        this.instruments.operationDuration.record(duration, attrs);
+        this.instruments.calls.add(1, attrs);
+        this.instruments.errors.add(1, attrs);
+    }
+    baseAttrs() {
+        const attrs = {
+            [GEN_AI_SYSTEM]: this.ctx.system,
+            [GEN_AI_OPERATION_NAME]: this.ctx.operation,
+            [GEN_AI_REQUEST_MODEL]: this.ctx.requestModel,
+            [FRUGAL_PROJECT_ID]: this.config.projectId,
+            [FRUGAL_CALLER_FILE]: this.caller.file,
+            [FRUGAL_CALLER_FUNCTION]: this.caller.function,
+            [FRUGAL_BATCHED]: this.ctx.batched ?? false,
+        };
+        if (this.config.customerId) {
+            attrs[FRUGAL_CUSTOMER_ID] = this.config.customerId;
+        }
+        return attrs;
+    }
+}
+function nonNull(v) {
+    return v !== null && v !== undefined;
+}
+function errorName(err) {
+    if (err && typeof err === "object" && "name" in err && typeof err.name === "string") {
+        return err.name;
+    }
+    if (err instanceof Error)
+        return err.constructor.name;
+    return "UnknownError";
+}
+//# sourceMappingURL=instrument.js.map

package/dist/instrument.js.map

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

package/dist/otel.d.ts

@@ -0,0 +1,27 @@
+import type { Counter, Histogram } from "@opentelemetry/api";
+import { MeterProvider, type MetricReader } from "@opentelemetry/sdk-metrics";
+import type { Config } from "./config.js";
+export interface Instruments {
+    meterProvider: MeterProvider;
+    operationDuration: Histogram;
+    tokenUsage: Histogram;
+    calls: Counter;
+    cacheReadTokens: Histogram;
+    cacheWriteTokens: Histogram;
+    reasoningTokens: Histogram;
+    errors: Counter;
+    internalErrors: Counter;
+    outputCapUtilization: Histogram;
+    cachePrefixStable: Counter;
+    historyDepth: Histogram;
+    fewShotCount: Histogram;
+    noiseRatio: Histogram;
+    structuredOutputHint: Counter;
+}
+export declare function getInstruments(config: Config): Instruments;
+export declare function buildFromReader(config: Config, reader: MetricReader): Instruments;
+/** Test-only hook — wipe the cached instruments between tests. */
+export declare function resetInstrumentsForTests(): void;
+/** Test-only hook — install pre-built instruments (e.g. with InMemory reader). */
+export declare function setInstrumentsForTests(instruments: Instruments): void;
+//# sourceMappingURL=otel.d.ts.map

package/dist/otel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../src/otel.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAuB,OAAO,EAAE,SAAS,EAAS,MAAM,oBAAoB,CAAC;AAOzF,OAAO,EAGL,aAAa,EAGb,KAAK,YAAY,EAElB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAwB1C,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,aAAa,CAAC;IAC7B,iBAAiB,EAAE,SAAS,CAAC;IAC7B,UAAU,EAAE,SAAS,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,eAAe,EAAE,SAAS,CAAC;IAC3B,gBAAgB,EAAE,SAAS,CAAC;IAC5B,eAAe,EAAE,SAAS,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;IACxB,oBAAoB,EAAE,SAAS,CAAC;IAChC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,SAAS,CAAC;IACxB,YAAY,EAAE,SAAS,CAAC;IACxB,UAAU,EAAE,SAAS,CAAC;IACtB,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAID,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAI1D;AAOD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,WAAW,CAyGjF;AA4ED,kEAAkE;AAClE,wBAAgB,wBAAwB,IAAI,IAAI,CAO/C;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAErE"}

package/dist/otel.js

@@ -0,0 +1,211 @@
+// OpenTelemetry meter provider + OTLP exporter setup.
+//
+// Lazy init on first wrap call. We own our own MeterProvider (not the global
+// one) so we don't conflict with whatever the customer may have already
+// configured. Metrics go to a Frugal-namespaced provider with its own OTLP
+// exporter.
+// Use the protobuf OTLP exporter: VictoriaMetrics (and other strict OTLP
+// backends) reject application/json on /v1/metrics with HTTP 400. The proto
+// package has the same exporter API but ships application/x-protobuf, which
+// is the broadly-supported OTLP wire format.
+import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-proto";
+import { Resource } from "@opentelemetry/resources";
+import { ConsoleMetricExporter, ExplicitBucketHistogramAggregation, MeterProvider, PeriodicExportingMetricReader, View, } from "@opentelemetry/sdk-metrics";
+import { FRUGAL_COMPONENT, FRUGAL_CUSTOMER_ID, FRUGAL_PROJECT_ID, METRIC_CACHE_PREFIX_STABLE, METRIC_CACHE_READ_TOKENS, METRIC_CACHE_WRITE_TOKENS, METRIC_CALLS, METRIC_ERRORS, METRIC_FEW_SHOT_COUNT, METRIC_HISTORY_DEPTH, METRIC_NOISE_RATIO, METRIC_OPERATION_DURATION, METRIC_INTERNAL_ERRORS, METRIC_OUTPUT_CAP_UTILIZATION, METRIC_REASONING_TOKENS, METRIC_STRUCTURED_OUTPUT_HINT, METRIC_TOKEN_USAGE, } from "./semconv.js";
+const INSTRUMENTATION_NAME = "frugal-metrics";
+const INSTRUMENTATION_VERSION = "0.1.0";
+let cached = null;
+export function getInstruments(config) {
+    if (cached !== null)
+        return cached;
+    cached = buildInstruments(config);
+    return cached;
+}
+function buildInstruments(config) {
+    const reader = buildReader(config);
+    return buildFromReader(config, reader);
+}
+export function buildFromReader(config, reader) {
+    // service.name takes the customer suffix when configured, otherwise stays
+    // flat — the tenant label (auto-injected by VMAuth from the bearer token)
+    // is the canonical customer identifier on the server side, so a missing
+    // customerId is not a problem.
+    const serviceName = config.customerId
+        ? `frugal-metrics-${config.customerId}`
+        : "frugal-metrics";
+    const resourceAttrs = {
+        "service.name": serviceName,
+        [FRUGAL_PROJECT_ID]: config.projectId,
+    };
+    if (config.customerId) {
+        resourceAttrs[FRUGAL_CUSTOMER_ID] = config.customerId;
+    }
+    const resource = new Resource(resourceAttrs);
+    const provider = new MeterProvider({
+        resource,
+        readers: [reader],
+        // Override OTel's default histogram bucket boundaries for operation
+        // duration. The default `[0,5,10,25,50,75,100,250,500,750,1000,2500,5000,
+        // 7500,10000]` is tuned for long-running operations; LLM calls almost
+        // always finish in 0.05s–30s, so the default sticks every sample in the
+        // (0,5] bucket and histogram_quantile() returns the same P50/P95 for
+        // every call site. These boundaries give visible P50/P95/P99 spread for
+        // realistic LLM workloads.
+        views: [
+            new View({
+                instrumentName: METRIC_OPERATION_DURATION,
+                aggregation: new ExplicitBucketHistogramAggregation([
+                    0.05, 0.1, 0.25, 0.5, 0.75, 1, 1.5, 2, 3, 5, 7.5, 10, 15, 20, 30, 60,
+                ]),
+            }),
+        ],
+    });
+    const meter = provider.getMeter(INSTRUMENTATION_NAME, INSTRUMENTATION_VERSION);
+    const raw = {
+        meterProvider: provider,
+        operationDuration: meter.createHistogram(METRIC_OPERATION_DURATION, {
+            unit: "s",
+            description: "Duration of AI client operations.",
+        }),
+        tokenUsage: meter.createHistogram(METRIC_TOKEN_USAGE, {
+            unit: "{token}",
+            description: "Token usage reported by the provider.",
+        }),
+        calls: meter.createCounter(METRIC_CALLS, {
+            unit: "{call}",
+            description: "Count of AI client operation calls.",
+        }),
+        cacheReadTokens: meter.createHistogram(METRIC_CACHE_READ_TOKENS, {
+            unit: "{token}",
+            description: "Tokens served from provider prompt cache.",
+        }),
+        cacheWriteTokens: meter.createHistogram(METRIC_CACHE_WRITE_TOKENS, {
+            unit: "{token}",
+            description: "Tokens written to provider prompt cache.",
+        }),
+        reasoningTokens: meter.createHistogram(METRIC_REASONING_TOKENS, {
+            unit: "{token}",
+            description: "Reasoning / extended thinking tokens billed at output rate.",
+        }),
+        errors: meter.createCounter(METRIC_ERRORS, {
+            unit: "{error}",
+            description: "Count of errors raised by AI client operations.",
+        }),
+        internalErrors: meter.createCounter(METRIC_INTERNAL_ERRORS, {
+            unit: "{error}",
+            description: "Count of frugal-metrics internal failures (instrumentation bugs).",
+        }),
+        outputCapUtilization: meter.createHistogram(METRIC_OUTPUT_CAP_UTILIZATION, {
+            unit: "1",
+            description: "Ratio of output_tokens to the request's max_tokens cap (0 to 1).",
+        }),
+        cachePrefixStable: meter.createCounter(METRIC_CACHE_PREFIX_STABLE, {
+            unit: "{call}",
+            description: "Per-call-site comparison of a request block's hash to the previous call. Stable=true when the hash matches.",
+        }),
+        historyDepth: meter.createHistogram(METRIC_HISTORY_DEPTH, {
+            unit: "{message}",
+            description: "Number of messages in the request payload.",
+        }),
+        fewShotCount: meter.createHistogram(METRIC_FEW_SHOT_COUNT, {
+            unit: "{example}",
+            description: "Count of consecutive user/assistant pairs preceding the final user message in single-turn calls.",
+        }),
+        noiseRatio: meter.createHistogram(METRIC_NOISE_RATIO, {
+            unit: "1",
+            description: "Ratio of noise characters (HTML tags, base64 runs, large whitespace) to total input characters.",
+        }),
+        structuredOutputHint: meter.createCounter(METRIC_STRUCTURED_OUTPUT_HINT, {
+            unit: "{call}",
+            description: "Count of calls whose prompt asks for structured output in prose without using tools or response_format.",
+        }),
+    };
+    return applyComponentFanout(raw, config.components);
+}
+// When FRUGAL_COMPONENTS is set, every per-call gen-AI metric is emitted once
+// without a component label (the canonical project-level series) AND once per
+// component (tagged with frugal.component). So usage can be queried for the
+// whole project (component absent) or split by component, with no double-count
+// of the project total. internalErrors is excluded — it's a process-level
+// diagnostic, not per-component attributable.
+function applyComponentFanout(raw, components) {
+    if (components.length === 0)
+        return raw;
+    return {
+        ...raw,
+        operationDuration: fanoutHistogram(raw.operationDuration, components),
+        tokenUsage: fanoutHistogram(raw.tokenUsage, components),
+        calls: fanoutCounter(raw.calls, components),
+        cacheReadTokens: fanoutHistogram(raw.cacheReadTokens, components),
+        cacheWriteTokens: fanoutHistogram(raw.cacheWriteTokens, components),
+        reasoningTokens: fanoutHistogram(raw.reasoningTokens, components),
+        errors: fanoutCounter(raw.errors, components),
+        outputCapUtilization: fanoutHistogram(raw.outputCapUtilization, components),
+        cachePrefixStable: fanoutCounter(raw.cachePrefixStable, components),
+        historyDepth: fanoutHistogram(raw.historyDepth, components),
+        fewShotCount: fanoutHistogram(raw.fewShotCount, components),
+        noiseRatio: fanoutHistogram(raw.noiseRatio, components),
+        structuredOutputHint: fanoutCounter(raw.structuredOutputHint, components),
+    };
+}
+function fanoutCounter(inner, components) {
+    return {
+        add(value, attributes, context) {
+            inner.add(value, attributes, context);
+            for (const component of components) {
+                inner.add(value, { ...attributes, [FRUGAL_COMPONENT]: component }, context);
+            }
+        },
+    };
+}
+function fanoutHistogram(inner, components) {
+    return {
+        record(value, attributes, context) {
+            inner.record(value, attributes, context);
+            for (const component of components) {
+                inner.record(value, { ...attributes, [FRUGAL_COMPONENT]: component }, context);
+            }
+        },
+    };
+}
+function buildReader(config) {
+    const exporter = config.otlpEndpoint
+        ? new OTLPMetricExporter({
+            url: config.otlpEndpoint,
+            headers: parseHeaders(config.otlpHeaders),
+        })
+        : new ConsoleMetricExporter();
+    return new PeriodicExportingMetricReader({
+        exporter,
+        exportIntervalMillis: config.exportIntervalMs,
+    });
+}
+function parseHeaders(raw) {
+    if (!raw)
+        return undefined;
+    const out = {};
+    for (const part of raw.split(",")) {
+        const trimmed = part.trim();
+        if (!trimmed)
+            continue;
+        const eq = trimmed.indexOf("=");
+        if (eq < 0)
+            continue;
+        out[trimmed.slice(0, eq).trim()] = trimmed.slice(eq + 1).trim();
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+/** Test-only hook — wipe the cached instruments between tests. */
+export function resetInstrumentsForTests() {
+    if (cached) {
+        cached.meterProvider.shutdown().catch(() => {
+            /* ignore */
+        });
+    }
+    cached = null;
+}
+/** Test-only hook — install pre-built instruments (e.g. with InMemory reader). */
+export function setInstrumentsForTests(instruments) {
+    cached = instruments;
+}
+//# sourceMappingURL=otel.js.map

package/dist/otel.js.map

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

package/dist/prompt-analyzer.d.ts

@@ -0,0 +1,26 @@
+export interface RequestPayload {
+    /** Provider-specific messages array (OpenAI chat / Anthropic messages). */
+    messages?: unknown;
+    /** Provider-specific tools array. */
+    tools?: unknown;
+    /** OpenAI response_format object, if any. */
+    responseFormat?: unknown;
+    /** OpenAI max_tokens / max_completion_tokens, or Anthropic max_tokens. */
+    maxTokens?: number | null;
+    /** Optional system prompt for Anthropic (passed alongside messages). */
+    system?: unknown;
+}
+export interface AnalysisResult {
+    systemHash: string | null;
+    userHash: string | null;
+    toolsHash: string | null;
+    schemaHash: string | null;
+    historyDepth: number | null;
+    fewShotCount: number | null;
+    noiseRatio: number | null;
+    structuredOutputHint: boolean;
+}
+export declare function analyzeRequest(payload: RequestPayload): AnalysisResult;
+export declare function structuredOutputMode(payload: RequestPayload): string;
+export declare function shouldSample(callSiteId: string, sampleRate: number, nowMs?: number): boolean;
+//# sourceMappingURL=prompt-analyzer.d.ts.map

package/dist/prompt-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-analyzer.d.ts","sourceRoot":"","sources":["../src/prompt-analyzer.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,CActE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAWpE;AAyKD,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,MAAmB,GACzB,OAAO,CAYT"}