@trazum/core 1.39.0 → 1.41.0

package/dist/connector.js

@@ -0,0 +1,431 @@
+/**
+ * Your bill, read from the provider, without anybody exporting anything.
+ *
+ * Every command in this product reads a file somebody produced by hand, and
+ * the export step is where adoption dies: the person who would benefit most
+ * from a cost report is the person least likely to have a `usage.jsonl` lying
+ * around. Every provider that bills by the token also serves that data over an
+ * API, and this module turns those payloads into figures the rest of Trazum
+ * already knows how to reason about.
+ *
+ * **Pure, and in the core, so it is testable without a network.** The fetch,
+ * the credentials and the pagination live in the CLI — the same split
+ * `openrouterOverlay` has had since 1.13. Everything here is a transformation
+ * of a document the caller already holds.
+ *
+ * **The honest part is what the providers cannot tell you.** Usage APIs serve
+ * *aggregates*: tokens per bucket per model, and — depending on the provider —
+ * a request count or nothing at all. They do not serve per-call rows. That
+ * makes a whole class of Trazum's findings impossible on this source: the
+ * shape of the calls, the truncation retries, the conversations, the largest
+ * call's context pressure. Those findings need per-call data and no amount of
+ * arithmetic recovers them from a sum.
+ *
+ * So a connected report is a **restricted** report, and it is restricted out
+ * loud. It carries its own shape rather than a `UsageProfileReport` with holes
+ * in it, precisely so a per-call finding can never read a zero this module
+ * wrote and report "nothing found" about something nobody measured. Not
+ * recorded is not not-happened, at the level of the type system.
+ */
+import { effectivePricing, multipliersFor } from './pricing.js';
+/** Every finding that needs a row per call, named once. */
+const PER_CALL_FINDINGS = [
+    {
+        finding: 'inputShapes',
+        because: 'the provider serves sums over a window, and the spread of call sizes is not in a sum',
+        unlockedBy: 'a per-call usage log, or the gateway',
+    },
+    {
+        finding: 'truncationRetries',
+        because: 'pairing a truncated answer with its retry needs both calls, their order and their stop reasons',
+        unlockedBy: 'a per-call usage log recording stop_reason and session',
+    },
+    {
+        finding: 'repeatedTurns',
+        because: 'the same request sent twice is invisible once both are added together',
+        unlockedBy: 'a per-call usage log recording session',
+    },
+    {
+        finding: 'sessionCosts',
+        because: 'conversations are not a dimension any usage API groups by',
+        unlockedBy: 'a per-call usage log recording session',
+    },
+    {
+        finding: 'contextPressure',
+        because: 'it reads the largest single call, and a total has lost the maximum',
+        unlockedBy: 'a per-call usage log, or the gateway',
+    },
+    {
+        finding: 'duplicateLines',
+        because: 'a doubled bill is caught by finding identical rows, and there are no rows here',
+        unlockedBy: 'a per-call usage log',
+    },
+];
+/**
+ * The two providers this release connects to, and the asymmetry between them
+ * that a report must not paper over.
+ *
+ * OpenAI's usage endpoint serves a request count per bucket; Anthropic's
+ * serves token sums without one. So a connected OpenAI report can say "$412
+ * over 9,004 calls" and a connected Anthropic report can only say "$412", and
+ * every per-call average is available on one and absent on the other. Printing
+ * a call count of zero, or dividing by a denominator that does not exist,
+ * would be this module inventing the number it is here to stop inventing.
+ */
+export const CONNECTORS = [
+    {
+        id: 'anthropic',
+        displayName: 'Anthropic',
+        granularity: 'bucketed',
+        credentialEnv: ['TRAZUM_ANTHROPIC_ADMIN_KEY', 'ANTHROPIC_ADMIN_KEY'],
+        keyKind: 'an Admin API key (read access to the usage report)',
+        servesCallCounts: false,
+        unavailable: [
+            ...PER_CALL_FINDINGS,
+            {
+                finding: 'calls',
+                because: 'the usage report serves token sums per bucket and no request count',
+                unlockedBy: 'a per-call usage log, or the gateway',
+            },
+        ],
+        docs: 'https://docs.anthropic.com/en/api/admin-api/usage-cost/get-messages-usage-report',
+    },
+    {
+        id: 'openai',
+        displayName: 'OpenAI',
+        granularity: 'bucketed',
+        credentialEnv: ['TRAZUM_OPENAI_ADMIN_KEY', 'OPENAI_ADMIN_KEY'],
+        keyKind: 'an Admin key with the api.usage.read scope',
+        servesCallCounts: true,
+        unavailable: PER_CALL_FINDINGS,
+        docs: 'https://platform.openai.com/docs/api-reference/usage',
+    },
+];
+export function connectorFor(id) {
+    return CONNECTORS.find((c) => c.id === id) ?? null;
+}
+// --------------------------------------------------------------------------
+// Normalising provider payloads
+// --------------------------------------------------------------------------
+const num = (value) => typeof value === 'number' && Number.isFinite(value) ? value : null;
+const ms = (value) => {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value * 1000;
+    if (typeof value !== 'string')
+        return null;
+    const parsed = Date.parse(value);
+    return Number.isNaN(parsed) ? null : parsed;
+};
+/** Merges buckets that share a window, model and grouping. */
+function collect(buckets) {
+    const merged = new Map();
+    for (const bucket of buckets) {
+        const key = `${bucket.fromMs}\n${bucket.toMs}\n${bucket.model}\n${JSON.stringify(bucket.group)}`;
+        const seen = merged.get(key);
+        if (seen === undefined) {
+            merged.set(key, { ...bucket });
+            continue;
+        }
+        seen.inputTokens += bucket.inputTokens;
+        seen.cacheReadTokens += bucket.cacheReadTokens;
+        seen.cacheWrite5mTokens += bucket.cacheWrite5mTokens;
+        seen.cacheWrite1hTokens += bucket.cacheWrite1hTokens;
+        seen.outputTokens += bucket.outputTokens;
+        seen.writeTtlKnown = seen.writeTtlKnown && bucket.writeTtlKnown;
+        // A count merged with an absent count is still absent: adding a number to
+        // "unknown" produces a number that describes only part of the traffic.
+        seen.calls = seen.calls === null || bucket.calls === null ? null : seen.calls + bucket.calls;
+    }
+    return [...merged.values()].sort((a, b) => a.fromMs - b.fromMs || a.model.localeCompare(b.model));
+}
+function windowOf(buckets) {
+    if (buckets.length === 0)
+        return null;
+    return {
+        fromMs: Math.min(...buckets.map((b) => b.fromMs)),
+        toMs: Math.max(...buckets.map((b) => b.toMs)),
+    };
+}
+/**
+ * Anthropic's messages usage report.
+ *
+ * Shape: `{ data: [ { starting_at, ending_at, results: [ {...tokens, model} ] } ] }`.
+ * The fields read are the documented ones; anything unreadable is reported as
+ * a gap rather than defaulted to zero, because a zero here is a bill that is
+ * quietly smaller than the real one.
+ */
+export function normalizeAnthropicUsage(payload) {
+    const descriptor = connectorFor('anthropic');
+    const gaps = [];
+    const buckets = [];
+    const data = payload?.data;
+    if (!Array.isArray(data)) {
+        throw new Error('This payload has no "data" array — is it the response from the Anthropic usage report endpoint?');
+    }
+    for (const [index, entry] of data.entries()) {
+        const row = entry;
+        const fromMs = ms(row.starting_at);
+        const toMs = ms(row.ending_at) ?? (fromMs === null ? null : fromMs);
+        if (fromMs === null || toMs === null) {
+            gaps.push({
+                kind: 'unreadable-entry',
+                detail: `bucket ${index} has no readable time window, so its tokens are in no period and were left out`,
+            });
+            continue;
+        }
+        const results = Array.isArray(row.results) ? row.results : [];
+        if (results.length === 0 && row.results !== undefined && !Array.isArray(row.results)) {
+            gaps.push({ kind: 'unreadable-entry', detail: `bucket ${index} has an unreadable "results" field` });
+            continue;
+        }
+        for (const result of results) {
+            const r = result;
+            const model = typeof r.model === 'string' ? r.model : null;
+            if (model === null) {
+                gaps.push({
+                    kind: 'unreadable-entry',
+                    detail: `a result in bucket ${index} names no model, so its tokens could not be priced and were left out`,
+                });
+                continue;
+            }
+            const creation = (r.cache_creation ?? {});
+            const write5m = num(creation.ephemeral_5m_input_tokens) ?? 0;
+            const write1h = num(creation.ephemeral_1h_input_tokens) ?? 0;
+            const flatWrite = num(r.cache_creation_input_tokens) ?? 0;
+            const ttlKnown = !(flatWrite > 0 && write5m === 0 && write1h === 0);
+            buckets.push({
+                fromMs,
+                toMs,
+                model,
+                // Documented and deliberate: the usage report has no request count.
+                calls: null,
+                inputTokens: num(r.uncached_input_tokens) ?? num(r.input_tokens) ?? 0,
+                cacheReadTokens: num(r.cache_read_input_tokens) ?? 0,
+                cacheWrite5mTokens: ttlKnown ? write5m : flatWrite,
+                cacheWrite1hTokens: ttlKnown ? write1h : 0,
+                writeTtlKnown: ttlKnown,
+                outputTokens: num(r.output_tokens) ?? 0,
+                group: groupOf(r, ['workspace_id', 'api_key_id', 'service_tier', 'context_window']),
+            });
+        }
+    }
+    const merged = collect(buckets);
+    return {
+        provider: 'anthropic',
+        granularity: 'bucketed',
+        buckets: merged,
+        window: windowOf(merged),
+        gaps,
+        unavailable: descriptor.unavailable,
+    };
+}
+/**
+ * OpenAI's completions usage endpoint.
+ *
+ * Shape: `{ data: [ { start_time, end_time, results: [ { input_tokens,
+ * output_tokens, input_cached_tokens, num_model_requests, model } ] } ] }`.
+ *
+ * This one serves a request count, so every per-call average is available on
+ * it — and the report says so, rather than making both providers look alike.
+ */
+export function normalizeOpenAIUsage(payload) {
+    const descriptor = connectorFor('openai');
+    const gaps = [];
+    const buckets = [];
+    const data = payload?.data;
+    if (!Array.isArray(data)) {
+        throw new Error('This payload has no "data" array — is it the response from the OpenAI usage endpoint?');
+    }
+    for (const [index, entry] of data.entries()) {
+        const row = entry;
+        const fromMs = ms(row.start_time);
+        const toMs = ms(row.end_time) ?? (fromMs === null ? null : fromMs);
+        if (fromMs === null || toMs === null) {
+            gaps.push({
+                kind: 'unreadable-entry',
+                detail: `bucket ${index} has no readable time window, so its tokens are in no period and were left out`,
+            });
+            continue;
+        }
+        const results = Array.isArray(row.results) ? row.results : [];
+        for (const result of results) {
+            const r = result;
+            const model = typeof r.model === 'string' ? r.model : null;
+            if (model === null) {
+                gaps.push({
+                    kind: 'unreadable-entry',
+                    detail: `a result in bucket ${index} names no model, so its tokens could not be priced and were left out`,
+                });
+                continue;
+            }
+            const cached = num(r.input_cached_tokens) ?? 0;
+            const input = num(r.input_tokens) ?? 0;
+            buckets.push({
+                fromMs,
+                toMs,
+                model,
+                calls: num(r.num_model_requests),
+                // OpenAI reports cached tokens *inside* the input total, so the
+                // uncached half is the subtraction. Reporting both at face value
+                // would bill the cached tokens twice, at the dearer rate.
+                inputTokens: Math.max(0, input - cached),
+                cacheReadTokens: cached,
+                cacheWrite5mTokens: 0,
+                cacheWrite1hTokens: 0,
+                // Nothing was assumed: this API reports no cache writes at all, and an
+                // absent field is not an assumed TTL.
+                writeTtlKnown: true,
+                outputTokens: num(r.output_tokens) ?? 0,
+                group: groupOf(r, ['project_id', 'api_key_id', 'batch']),
+            });
+        }
+    }
+    const merged = collect(buckets);
+    return {
+        provider: 'openai',
+        granularity: 'bucketed',
+        buckets: merged,
+        window: windowOf(merged),
+        gaps,
+        unavailable: descriptor.unavailable,
+    };
+}
+function groupOf(row, keys) {
+    const group = {};
+    for (const key of keys) {
+        const value = row[key];
+        if (typeof value === 'string' && value !== '')
+            group[key] = value;
+        else if (typeof value === 'number' && Number.isFinite(value))
+            group[key] = String(value);
+        else if (typeof value === 'boolean')
+            group[key] = String(value);
+    }
+    return group;
+}
+/**
+ * Prices the buckets a connector pulled.
+ *
+ * Every figure here is the provider's own billed token count at the
+ * catalogue's rates — the same arithmetic `profile` does, over sums instead of
+ * rows. What it deliberately does not do is synthesise the per-call findings:
+ * they are listed as unavailable and left absent, so nothing downstream can
+ * read a zero this function wrote.
+ */
+export function bucketedProfile(pull, options) {
+    const { catalogue, on = new Date() } = options;
+    const slices = new Map();
+    const days = new Map();
+    const unpriced = new Map();
+    for (const bucket of pull.buckets) {
+        const model = catalogue.byId.get(bucket.model);
+        if (model === undefined) {
+            const seen = unpriced.get(bucket.model) ?? { inputTokens: 0, outputTokens: 0 };
+            seen.inputTokens += bucket.inputTokens + bucket.cacheReadTokens;
+            seen.outputTokens += bucket.outputTokens;
+            unpriced.set(bucket.model, seen);
+            continue;
+        }
+        const { inputPerMTok, outputPerMTok } = effectivePricing(model, on);
+        const rates = multipliersFor(model);
+        const per = (count, rate) => (count / 1_000_000) * rate;
+        const inputUsd = per(bucket.inputTokens, inputPerMTok);
+        const cacheReadUsd = per(bucket.cacheReadTokens, inputPerMTok * rates.cacheRead);
+        const cacheWriteUsd = per(bucket.cacheWrite5mTokens, inputPerMTok * rates.cacheWrite5m) +
+            per(bucket.cacheWrite1hTokens, inputPerMTok * rates.cacheWrite1h);
+        const outputUsd = per(bucket.outputTokens, outputPerMTok);
+        const writeTokens = bucket.cacheWrite5mTokens + bucket.cacheWrite1hTokens;
+        const atInputRate = per(bucket.cacheReadTokens + writeTokens, inputPerMTok);
+        const ifAssumed1h = bucket.writeTtlKnown
+            ? cacheWriteUsd
+            : per(writeTokens, inputPerMTok * rates.cacheWrite1h);
+        const slice = slices.get(bucket.model) ?? {
+            model: bucket.model,
+            calls: bucket.calls === null ? null : 0,
+            inputTokens: 0,
+            cacheReadTokens: 0,
+            cacheWriteTokens: 0,
+            outputTokens: 0,
+            inputUsd: 0,
+            cacheReadUsd: 0,
+            cacheWriteUsd: 0,
+            outputUsd: 0,
+            totalUsd: 0,
+            cachedTokensAtInputRateUsd: 0,
+            cacheWriteUsdIfAssumed1h: 0,
+            writeTtlKnown: true,
+        };
+        slice.calls = slice.calls === null || bucket.calls === null ? null : slice.calls + bucket.calls;
+        slice.inputTokens += bucket.inputTokens;
+        slice.cacheReadTokens += bucket.cacheReadTokens;
+        slice.cacheWriteTokens += writeTokens;
+        slice.outputTokens += bucket.outputTokens;
+        slice.inputUsd += inputUsd;
+        slice.cacheReadUsd += cacheReadUsd;
+        slice.cacheWriteUsd += cacheWriteUsd;
+        slice.outputUsd += outputUsd;
+        slice.totalUsd += inputUsd + cacheReadUsd + cacheWriteUsd + outputUsd;
+        slice.cachedTokensAtInputRateUsd += atInputRate;
+        slice.cacheWriteUsdIfAssumed1h += ifAssumed1h;
+        slice.writeTtlKnown = slice.writeTtlKnown && bucket.writeTtlKnown;
+        slices.set(bucket.model, slice);
+        const day = new Date(bucket.fromMs).toISOString().slice(0, 10);
+        const entry = days.get(day) ?? { usd: 0, calls: bucket.calls === null ? null : 0 };
+        entry.usd += inputUsd + cacheReadUsd + cacheWriteUsd + outputUsd;
+        entry.calls = entry.calls === null || bucket.calls === null ? null : entry.calls + bucket.calls;
+        days.set(day, entry);
+    }
+    const byModel = [...slices.values()].sort((a, b) => b.totalUsd - a.totalUsd);
+    const anyCallsUnknown = byModel.some((s) => s.calls === null) || byModel.length === 0;
+    return {
+        schemaVersion: 1,
+        provider: pull.provider,
+        granularity: pull.granularity,
+        span: pull.window,
+        total: {
+            totalUsd: byModel.reduce((sum, s) => sum + s.totalUsd, 0),
+            calls: anyCallsUnknown ? null : byModel.reduce((sum, s) => sum + (s.calls ?? 0), 0),
+            inputTokens: byModel.reduce((sum, s) => sum + s.inputTokens, 0),
+            cacheReadTokens: byModel.reduce((sum, s) => sum + s.cacheReadTokens, 0),
+            cacheWriteTokens: byModel.reduce((sum, s) => sum + s.cacheWriteTokens, 0),
+            outputTokens: byModel.reduce((sum, s) => sum + s.outputTokens, 0),
+        },
+        byModel,
+        byDay: [...days.entries()]
+            .sort((a, b) => a[0].localeCompare(b[0]))
+            .map(([day, entry]) => ({ day, usd: entry.usd, calls: entry.calls })),
+        unpricedModels: [...unpriced.entries()]
+            .map(([model, tokens]) => ({ model, ...tokens }))
+            .sort((a, b) => b.inputTokens + b.outputTokens - (a.inputTokens + a.outputTokens)),
+        gaps: pull.gaps,
+        unavailable: pull.unavailable,
+    };
+}
+/**
+ * The cache verdict over a connected report.
+ *
+ * Same counterfactual `cacheEconomics` runs on a per-call report: what the
+ * cache-touched tokens cost, against what they would have cost as ordinary
+ * input. The worst case is carried separately for the same reason it is
+ * there — when the source did not state the write TTL, the cheaper rate was
+ * assumed for the headline and the verdict can move under the other one.
+ */
+export function bucketedCacheEconomics(report) {
+    const spent = report.byModel.reduce((sum, s) => sum + s.cacheReadUsd + s.cacheWriteUsd, 0);
+    const without = report.byModel.reduce((sum, s) => sum + s.cachedTokensAtInputRateUsd, 0);
+    const worst = report.byModel.reduce((sum, s) => sum + s.cacheReadUsd + s.cacheWriteUsdIfAssumed1h, 0);
+    const touched = report.byModel.reduce((sum, s) => sum + s.cacheReadTokens + s.cacheWriteTokens, 0);
+    const verdictOf = (paid) => {
+        if (touched === 0)
+            return 'no-cache';
+        return paid <= without ? 'paid-off' : 'lost-money';
+    };
+    return {
+        spentUsd: spent,
+        withoutCachingUsd: without,
+        deltaUsd: spent - without,
+        verdict: verdictOf(spent),
+        worstCaseVerdict: verdictOf(worst),
+    };
+}
+//# sourceMappingURL=connector.js.map

package/dist/connector.js.map

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

package/dist/history.d.ts

@@ -0,0 +1,110 @@
+/**
+ * The long run: many reports over many periods, as one series.
+ *
+ * Every comparison in Trazum is between two logs, and a product's cost
+ * problem is rarely visible in two — it is visible in twenty. This module
+ * takes *stored reports* (the `--json` documents a team already keeps) and
+ * builds the series no pairwise comparison can see: the workload that grew a
+ * little every week, the model share that has been climbing since a date,
+ * the cache hit rate decaying slowly enough that no single week's report
+ * called it a finding.
+ *
+ * **Still no forecasts.** Twenty points make a trend visible; they do not
+ * make next month knowable. The series is stated, the shape is named as
+ * consecutive movement — never a line fitted through the points — and where
+ * it goes next remains the reader's to judge, the same refusal
+ * `modelMixDrift` has carried since 1.27.
+ *
+ * **Derived from stored reports, not re-parsed logs**, so a year of `--json`
+ * output is enough and the raw logs can be thrown away — which is what the
+ * privacy story requires anyway. Browser-safe: documents in, series out.
+ */
+import type { PlanActionKind, PlanDocument } from './plan.js';
+/** The slice of a stored profile document this module actually reads. */
+export interface StoredReport {
+    /** Where it came from — a file name, shown so a finding can be traced. */
+    name: string;
+    span: {
+        fromMs: number;
+        toMs: number;
+    } | null;
+    totalUsd: number;
+    calls: number;
+    /** Label → dollars this period. */
+    byLabel: Map<string, number>;
+    /** Model → dollars this period. */
+    byModel: Map<string, number>;
+    /** Share of input tokens served from cache, or null when unknowable. */
+    cacheReadShare: number | null;
+}
+/**
+ * A run of consecutive movement, named — never extrapolated.
+ *
+ * `periods` counts the *rises* (or falls), so a run of 3 spans 4 reports.
+ * The floor is 3: two rises is what `--against` already shows, and one is
+ * noise wearing a trend's clothes.
+ */
+export interface HistoryRun {
+    kind: 'label-spend-climbing' | 'model-share-climbing' | 'cache-share-decaying';
+    subject: string;
+    /** Consecutive rises (falls, for decay). */
+    periods: number;
+    /** The report the run started in, by name — "climbing since <this one>". */
+    sinceName: string;
+    /** First and last values of the run, so the reader judges the size. */
+    from: number;
+    to: number;
+}
+/** The same action planned again and again: a decision nobody is executing. */
+export interface RepeatedPlanAction {
+    kind: PlanActionKind;
+    label: string;
+    model: string;
+    appearances: number;
+    firstPlanned: string | null;
+    lastPlanned: string | null;
+}
+export interface HistoryDocument {
+    schemaVersion: 1;
+    /** Ordered oldest first by span start. */
+    periods: {
+        name: string;
+        fromMs: number;
+        toMs: number;
+        totalUsd: number;
+        calls: number;
+    }[];
+    /** Per label, dollars per period — null where the label had no traffic. */
+    labelSeries: {
+        label: string;
+        points: (number | null)[];
+    }[];
+    /** Per model, share of that period's total — null where absent. */
+    modelShareSeries: {
+        model: string;
+        points: (number | null)[];
+    }[];
+    /** Cache read share per period, null where unknowable. */
+    cacheShareSeries: (number | null)[];
+    /** The findings only a series can make. Shapes, never forecasts. */
+    runs: HistoryRun[];
+    /** Plans in the same directory, held against each other. */
+    repeatedPlanActions: RepeatedPlanAction[];
+    /**
+     * Reports that carry no span cannot be placed on a timeline; they are
+     * named here and in no series above, never silently absorbed.
+     */
+    undatedReports: string[];
+}
+export declare const MIN_RUN = 3;
+export declare function buildHistory(reports: StoredReport[], plans?: (PlanDocument & {
+    createdAt?: string;
+    name?: string;
+})[]): HistoryDocument;
+/**
+ * Reads one stored `profile --json` document into the slice history needs.
+ * Returns null when the JSON is not a profile document — the caller names
+ * the file rather than absorbing it.
+ */
+export declare function storedReportFrom(name: string, parsed: unknown): StoredReport | null;
+//# sourceMappingURL=history.d.ts.map

package/dist/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9D,yEAAyE;AACzE,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,mCAAmC;IACnC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,wEAAwE;IACxE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,sBAAsB,GAAG,sBAAsB,GAAG,sBAAsB,CAAC;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,+EAA+E;AAC/E,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,CAAC,CAAC;IACjB,0CAA0C;IAC1C,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3F,2EAA2E;IAC3E,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAA;KAAE,EAAE,CAAC;IAC5D,mEAAmE;IACnE,gBAAgB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAA;KAAE,EAAE,CAAC;IACjE,0DAA0D;IAC1D,gBAAgB,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IACpC,oEAAoE;IACpE,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,4DAA4D;IAC5D,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;IAC1C;;;OAGG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,eAAO,MAAM,OAAO,IAAI,CAAC;AAwBzB,wBAAgB,YAAY,CAC1B,OAAO,EAAE,YAAY,EAAE,EACvB,KAAK,GAAE,CAAC,YAAY,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAAO,GACnE,eAAe,CAiHjB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CA8CnF"}