@assemblyline-agents/runtime 0.1.0

package/dist/usage-reconciliation.js

@@ -0,0 +1,463 @@
+import { openRouterGenerationAccounting } from "@assemblyline-agents/pi";
+import { UsageAccountingError, sha256Json, usageRecordInput } from "./usage-records.js";
+const DEFAULT_PROVIDER_SETTLEMENT_LAG_HOURS = 48;
+const FETCH_TIMEOUT_MS = 10_000;
+const EMPTY_AGGREGATE = {
+    dimensions: {},
+    recordCount: "0",
+    inputTokens: "0",
+    outputTokens: "0",
+    cachedTokens: "0",
+    cacheWriteTokens: "0",
+    reasoningTokens: "0",
+    actualCostMicros: "0",
+    upstreamCostMicros: "0",
+    currency: "USD",
+    unavailableCostRecords: "0",
+    unreconciledTokenRecords: "0",
+    unreconciledRecords: "0"
+};
+/**
+ * Import settled OpenAI organization token and cash control totals.
+ *
+ * Control totals are deliberately separate from transaction records. A
+ * project/API-key mapping is the only way they receive an agentId; OpenEve
+ * never invents per-run cost attribution from aggregate provider invoices.
+ */
+export async function reconcileOpenAIOrganization(options) {
+    const provider = clean(options.provider) ?? "openai-codex";
+    const adminKey = requiredSecret(options.adminKey, "OpenAI admin key");
+    const range = settledDailyRange(options.from, options.to, options.now ?? new Date(), options.settlementLagHours ?? DEFAULT_PROVIDER_SETTLEMENT_LAG_HOURS);
+    const baseUrl = (clean(options.baseUrl) ?? "https://api.openai.com/v1").replace(/\/+$/u, "");
+    const common = {
+        start_time: String(Math.floor(new Date(range.from).getTime() / 1_000)),
+        end_time: String(Math.floor(new Date(range.to).getTime() / 1_000)),
+        bucket_width: "1d"
+    };
+    const usageBuckets = await fetchOpenAIPages(`${baseUrl}/organization/usage/completions`, adminKey, common, ["model", "project_id", "api_key_id"], options.projectIds, options.apiKeyIds, options.fetch);
+    const costBuckets = await fetchOpenAIPages(`${baseUrl}/organization/costs`, adminKey, common, ["project_id", "line_item"], options.projectIds, undefined, options.fetch);
+    let recordedControlTotals = 0;
+    for (const bucket of usageBuckets) {
+        const startTime = integer(bucket.start_time);
+        const endTime = integer(bucket.end_time);
+        if (startTime === undefined || endTime === undefined)
+            continue;
+        for (const result of arrayObjects(bucket.results)) {
+            const inputTokens = integer(result.input_tokens) ?? 0;
+            const outputTokens = integer(result.output_tokens) ?? 0;
+            const cachedTokens = integer(result.input_cached_tokens) ?? 0;
+            const cacheWriteTokens = integer(result.input_cache_write_tokens) ?? 0;
+            const dimensions = openAIDimensions(result);
+            const model = string(result.model);
+            await options.state.recordUsage({
+                idempotencyKey: controlKey(provider, "openai-usage", startTime, dimensions),
+                ...openAIAgentAttribution(result, options),
+                provider,
+                ...(model ? { model } : {}),
+                billingMode: "api_key",
+                recordKind: "control_total",
+                inputTokens,
+                outputTokens,
+                cachedTokens,
+                cacheWriteTokens,
+                tokenSource: "provider_reconciled",
+                costSource: "unavailable",
+                providerReceipt: providerReceipt("openai.organization.usage.completions", startTime, endTime, result),
+                metadata: compactJson({
+                    controlType: "token_usage",
+                    numModelRequests: integer(result.num_model_requests),
+                    ...dimensions
+                }),
+                occurredAt: epochIso(startTime)
+            });
+            recordedControlTotals += 1;
+        }
+    }
+    for (const bucket of costBuckets) {
+        const startTime = integer(bucket.start_time);
+        const endTime = integer(bucket.end_time);
+        if (startTime === undefined || endTime === undefined)
+            continue;
+        for (const result of arrayObjects(bucket.results)) {
+            const amount = object(result.amount);
+            const costUsd = number(amount?.value);
+            if (costUsd === undefined)
+                continue;
+            const currency = string(amount?.currency)?.toUpperCase() ?? "USD";
+            const dimensions = openAIDimensions(result);
+            await options.state.recordUsage({
+                idempotencyKey: controlKey(provider, "openai-costs", startTime, dimensions),
+                ...openAIAgentAttribution(result, options),
+                provider,
+                billingMode: "api_key",
+                recordKind: "control_total",
+                costUsd,
+                currency,
+                tokenSource: "unavailable",
+                costSource: "provider_reconciled",
+                providerReceipt: providerReceipt("openai.organization.costs", startTime, endTime, result),
+                metadata: compactJson({
+                    controlType: "cash_cost",
+                    quantity: number(result.quantity),
+                    ...dimensions
+                }),
+                occurredAt: epochIso(startTime)
+            });
+            recordedControlTotals += 1;
+        }
+    }
+    return {
+        provider,
+        ...range,
+        recordedControlTotals,
+        reconciledTransactions: 0,
+        report: await usageReconciliationReport(options.state, { provider, ...range })
+    };
+}
+/** Retry missing generation receipts and import completed OpenRouter activity totals. */
+export async function reconcileOpenRouterUsage(options) {
+    const provider = clean(options.provider) ?? "openrouter";
+    const range = completedUtcRange(options.from, options.to, options.now ?? new Date());
+    const baseUrl = (clean(options.baseUrl) ?? "https://openrouter.ai/api/v1").replace(/\/+$/u, "");
+    let reconciledTransactions = 0;
+    if (clean(options.apiKey)) {
+        const candidates = (options.state.queryUsage
+            ? await options.state.queryUsage({ provider, recordKind: "transaction", from: range.from, to: range.to, limit: 10_000 })
+            : (await options.state.listUsage()).filter((record) => record.provider === provider &&
+                record.recordKind === "transaction" &&
+                record.occurredAt >= range.from &&
+                record.occurredAt < range.to))
+            .filter((record) => Boolean(record.providerRequestId) &&
+            record.costSource === "unavailable");
+        for (const record of candidates) {
+            const accounting = await openRouterGenerationAccounting(record.providerRequestId, {
+                env: { OPENROUTER_API_KEY: options.apiKey },
+                ...(options.fetch ? { fetch: options.fetch } : {}),
+                fallback: harnessUsage(record)
+            });
+            if (!accounting || accounting.usage.costSource !== "provider_reconciled")
+                continue;
+            await options.state.recordUsage(reconciledTransactionInput(record, accounting));
+            reconciledTransactions += 1;
+        }
+    }
+    let recordedControlTotals = 0;
+    const managementKey = clean(options.managementKey);
+    if (managementKey) {
+        for (const date of utcDates(range.from, range.to)) {
+            const url = new URL(`${baseUrl}/activity`);
+            url.searchParams.set("date", date);
+            if (clean(options.apiKeyHash))
+                url.searchParams.set("api_key_hash", options.apiKeyHash);
+            const body = await fetchJsonWithRetry(url, managementKey, options.fetch);
+            for (const row of arrayObjects(object(body)?.data)) {
+                const dimensions = compactJson({
+                    endpointId: string(row.endpoint_id),
+                    model: string(row.model),
+                    modelPermaslug: string(row.model_permaslug),
+                    providerName: string(row.provider_name)
+                });
+                const inputTokens = integer(row.prompt_tokens) ?? 0;
+                const outputTokens = integer(row.completion_tokens) ?? 0;
+                const reasoningTokens = Math.min(integer(row.reasoning_tokens) ?? 0, outputTokens);
+                const costUsd = number(row.usage);
+                const upstreamCostUsd = number(row.byok_usage_inference);
+                const model = string(row.model);
+                const control = {
+                    idempotencyKey: controlKey(provider, "openrouter-activity", date, dimensions),
+                    provider,
+                    ...(model ? { model } : {}),
+                    billingMode: upstreamCostUsd && !costUsd ? "byok" : "unknown",
+                    recordKind: "control_total",
+                    inputTokens,
+                    outputTokens,
+                    reasoningTokens,
+                    tokenSource: "provider_reconciled",
+                    costSource: costUsd === undefined ? "unavailable" : "provider_reconciled",
+                    providerReceipt: {
+                        source: "openrouter.activity",
+                        date,
+                        result: row
+                    },
+                    metadata: compactJson({
+                        controlType: "activity",
+                        requests: integer(row.requests),
+                        apiKeyHash: clean(options.apiKeyHash),
+                        ...dimensions
+                    }),
+                    occurredAt: `${date}T00:00:00.000Z`
+                };
+                if (costUsd !== undefined)
+                    control.costUsd = costUsd;
+                if (upstreamCostUsd !== undefined)
+                    control.upstreamCostUsd = upstreamCostUsd;
+                if (clean(options.agentId))
+                    control.agentId = options.agentId;
+                await options.state.recordUsage(control);
+                recordedControlTotals += 1;
+            }
+        }
+    }
+    return {
+        provider,
+        ...range,
+        recordedControlTotals,
+        reconciledTransactions,
+        report: await usageReconciliationReport(options.state, { provider, ...range })
+    };
+}
+export async function usageReconciliationReport(state, input) {
+    const [transactions] = await summarize(state, {
+        provider: input.provider,
+        currency: "USD",
+        recordKind: "transaction",
+        from: input.from,
+        to: input.to
+    });
+    const [controlTotals] = await summarize(state, {
+        provider: input.provider,
+        currency: "USD",
+        recordKind: "control_total",
+        from: input.from,
+        to: input.to
+    });
+    const transactionAggregate = transactions ?? EMPTY_AGGREGATE;
+    const controlAggregate = controlTotals ?? EMPTY_AGGREGATE;
+    return {
+        ...input,
+        transactions: transactionAggregate,
+        controlTotals: controlAggregate,
+        variance: {
+            inputTokens: difference(controlAggregate.inputTokens, transactionAggregate.inputTokens),
+            outputTokens: difference(controlAggregate.outputTokens, transactionAggregate.outputTokens),
+            cachedTokens: difference(controlAggregate.cachedTokens, transactionAggregate.cachedTokens),
+            reasoningTokens: difference(controlAggregate.reasoningTokens, transactionAggregate.reasoningTokens),
+            actualCostMicros: difference(controlAggregate.actualCostMicros, transactionAggregate.actualCostMicros)
+        },
+        coverage: {
+            transactionRecords: transactionAggregate.recordCount,
+            unreconciledTransactionTokenRecords: transactionAggregate.unreconciledTokenRecords,
+            unreconciledTransactionRecords: transactionAggregate.unreconciledRecords,
+            controlTotalRecords: controlAggregate.recordCount,
+            exactRunTokenCoverage: transactionAggregate.unreconciledTokenRecords === "0",
+            exactRunCostCoverage: transactionAggregate.unreconciledRecords === "0",
+            providerControlTotalsAvailable: controlAggregate.recordCount !== "0"
+        }
+    };
+}
+async function summarize(state, query) {
+    if (state.summarizeUsage)
+        return state.summarizeUsage(query);
+    const records = await state.listUsage();
+    const { summarizeUsageRecords } = await import("./usage-records.js");
+    return summarizeUsageRecords(records, query);
+}
+async function fetchOpenAIPages(endpoint, key, common, groups, projectIds, apiKeyIds, fetchImpl) {
+    const buckets = [];
+    let page;
+    do {
+        const url = new URL(endpoint);
+        for (const [name, value] of Object.entries(common))
+            url.searchParams.set(name, value);
+        url.searchParams.set("limit", "31");
+        for (const group of groups)
+            url.searchParams.append("group_by", group);
+        for (const projectId of projectIds ?? [])
+            url.searchParams.append("project_ids", projectId);
+        for (const apiKeyId of apiKeyIds ?? [])
+            url.searchParams.append("api_key_ids", apiKeyId);
+        if (page)
+            url.searchParams.set("page", page);
+        const body = object(await fetchJsonWithRetry(url, key, fetchImpl));
+        buckets.push(...arrayObjects(body?.data));
+        page = body?.has_more === true ? string(body.next_page) : undefined;
+        if (body?.has_more === true && !page) {
+            throw new UsageAccountingError("Provider pagination reported has_more without next_page.");
+        }
+    } while (page);
+    return buckets;
+}
+async function fetchJsonWithRetry(url, key, fetchImpl) {
+    const request = fetchImpl ?? globalThis.fetch;
+    let lastError;
+    for (const delayMs of [0, 150, 750]) {
+        if (delayMs)
+            await delay(delayMs);
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+        timer.unref?.();
+        try {
+            const response = await request(url, {
+                headers: { authorization: `Bearer ${key}`, accept: "application/json" },
+                signal: controller.signal
+            });
+            if (response.ok)
+                return response.json();
+            const retryable = response.status === 429 || response.status >= 500;
+            const detail = (await response.text()).slice(0, 500);
+            lastError = new UsageAccountingError(`Provider reconciliation failed with HTTP ${response.status}${detail ? `: ${detail}` : "."}`, "usage_provider_reconciliation_failed");
+            if (!retryable)
+                throw lastError;
+        }
+        catch (error) {
+            lastError = error;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    throw lastError instanceof Error
+        ? lastError
+        : new UsageAccountingError("Provider reconciliation failed after retries.");
+}
+function reconciledTransactionInput(record, accounting) {
+    const input = usageRecordInput(record);
+    const usage = accounting.usage;
+    if (usage.inputTokens !== undefined)
+        input.inputTokens = usage.inputTokens;
+    if (usage.outputTokens !== undefined)
+        input.outputTokens = usage.outputTokens;
+    if (usage.cachedTokens !== undefined)
+        input.cachedTokens = usage.cachedTokens;
+    if (usage.cacheWriteTokens !== undefined)
+        input.cacheWriteTokens = usage.cacheWriteTokens;
+    if (usage.reasoningTokens !== undefined)
+        input.reasoningTokens = usage.reasoningTokens;
+    if (usage.costUsd !== undefined)
+        input.costUsd = usage.costUsd;
+    if (usage.upstreamCostUsd !== undefined)
+        input.upstreamCostUsd = usage.upstreamCostUsd;
+    if (usage.currency !== undefined)
+        input.currency = usage.currency;
+    if (usage.tokenSource !== undefined)
+        input.tokenSource = usage.tokenSource;
+    if (usage.costSource !== undefined)
+        input.costSource = usage.costSource;
+    if (accounting.providerReceipt)
+        input.providerReceipt = accounting.providerReceipt;
+    input.billingMode = accounting.billingMode;
+    return input;
+}
+function harnessUsage(record) {
+    return {
+        inputTokens: record.inputTokens,
+        outputTokens: record.outputTokens,
+        cachedTokens: record.cachedTokens,
+        cacheWriteTokens: record.cacheWriteTokens,
+        reasoningTokens: record.reasoningTokens,
+        tokenSource: record.tokenSource,
+        costSource: record.costSource
+    };
+}
+function openAIAgentAttribution(result, options) {
+    const apiKeyId = string(result.api_key_id);
+    const projectId = string(result.project_id);
+    const agentId = (apiKeyId ? options.agentByApiKeyId?.[apiKeyId] : undefined) ??
+        (projectId ? options.agentByProjectId?.[projectId] : undefined);
+    return agentId ? { agentId } : {};
+}
+function openAIDimensions(result) {
+    return compactJson({
+        apiKeyId: string(result.api_key_id),
+        projectId: string(result.project_id),
+        model: string(result.model),
+        lineItem: string(result.line_item),
+        serviceTier: string(result.service_tier),
+        batch: typeof result.batch === "boolean" ? result.batch : undefined
+    });
+}
+function providerReceipt(source, startTime, endTime, result) {
+    return {
+        source,
+        bucketStart: epochIso(startTime),
+        bucketEnd: epochIso(endTime),
+        result: result
+    };
+}
+function controlKey(provider, source, bucket, dimensions) {
+    return `control:${provider}:${source}:${bucket}:${sha256Json(dimensions)}`;
+}
+function settledDailyRange(from, to, now, lagHours) {
+    if (!Number.isFinite(lagHours) || lagHours < 0) {
+        throw new UsageAccountingError("Provider settlement lag must be non-negative.");
+    }
+    const cutoff = new Date(now.getTime() - lagHours * 60 * 60 * 1_000);
+    const settledTo = utcDay(cutoff);
+    return normalizedRange(from, to, settledTo);
+}
+function completedUtcRange(from, to, now) {
+    return normalizedRange(from, to, utcDay(now));
+}
+function normalizedRange(from, to, maximumTo) {
+    const normalizedFrom = iso(from, "from");
+    const requestedTo = to ? iso(to, "to") : maximumTo;
+    const normalizedTo = requestedTo < maximumTo ? requestedTo : maximumTo;
+    if (normalizedFrom >= normalizedTo) {
+        throw new UsageAccountingError("Reconciliation range has no completed provider buckets.");
+    }
+    return { from: normalizedFrom, to: normalizedTo };
+}
+function utcDay(value) {
+    return `${value.toISOString().slice(0, 10)}T00:00:00.000Z`;
+}
+function utcDates(from, to) {
+    const dates = [];
+    for (let cursor = new Date(from); cursor < new Date(to); cursor = new Date(cursor.getTime() + 86_400_000)) {
+        dates.push(cursor.toISOString().slice(0, 10));
+    }
+    if (dates.length > 30) {
+        throw new UsageAccountingError("OpenRouter activity reconciliation supports at most 30 completed UTC days.");
+    }
+    return dates;
+}
+function difference(left, right) {
+    return (BigInt(left) - BigInt(right)).toString();
+}
+function epochIso(value) {
+    return new Date(value * 1_000).toISOString();
+}
+function iso(value, name) {
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime()))
+        throw new UsageAccountingError(`${name} must be an ISO timestamp.`);
+    return date.toISOString();
+}
+function arrayObjects(value) {
+    return Array.isArray(value)
+        ? value.filter((entry) => Boolean(object(entry)))
+        : [];
+}
+function object(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function compactJson(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, entry]) => typeof entry === "string" ||
+        typeof entry === "number" ||
+        typeof entry === "boolean"));
+}
+function string(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+function clean(value) {
+    return value?.trim() || undefined;
+}
+function number(value) {
+    const parsed = typeof value === "number" ? value : typeof value === "string" ? Number(value) : NaN;
+    return Number.isFinite(parsed) && parsed >= 0 ? parsed : undefined;
+}
+function integer(value) {
+    const parsed = number(value);
+    return parsed !== undefined && Number.isSafeInteger(parsed) ? parsed : undefined;
+}
+function requiredSecret(value, name) {
+    const secret = clean(value);
+    if (!secret)
+        throw new UsageAccountingError(`${name} is required.`);
+    return secret;
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=usage-reconciliation.js.map

package/dist/usage-reconciliation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-reconciliation.js","sourceRoot":"","sources":["../src/usage-reconciliation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AAQzE,OAAO,EACL,oBAAoB,EACpB,UAAU,EACV,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,qCAAqC,GAAG,EAAE,CAAC;AACjD,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAChC,MAAM,eAAe,GAAmB;IACtC,UAAU,EAAE,EAAE;IACd,WAAW,EAAE,GAAG;IAChB,WAAW,EAAE,GAAG;IAChB,YAAY,EAAE,GAAG;IACjB,YAAY,EAAE,GAAG;IACjB,gBAAgB,EAAE,GAAG;IACrB,eAAe,EAAE,GAAG;IACpB,gBAAgB,EAAE,GAAG;IACrB,kBAAkB,EAAE,GAAG;IACvB,QAAQ,EAAE,KAAK;IACf,sBAAsB,EAAE,GAAG;IAC3B,wBAAwB,EAAE,GAAG;IAC7B,mBAAmB,EAAE,GAAG;CACzB,CAAC;AAmDF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,OAAgD;IAEhD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,cAAc,CAAC;IAC3D,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;IACtE,MAAM,KAAK,GAAG,iBAAiB,CAC7B,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,EAAE,EACV,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,EACzB,OAAO,CAAC,kBAAkB,IAAI,qCAAqC,CACpE,CAAC;IACF,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,2BAA2B,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC7F,MAAM,MAAM,GAAG;QACb,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC;QACtE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC;QAClE,YAAY,EAAE,IAAI;KACnB,CAAC;IACF,MAAM,YAAY,GAAG,MAAM,gBAAgB,CACzC,GAAG,OAAO,iCAAiC,EAC3C,QAAQ,EACR,MAAM,EACN,CAAC,OAAO,EAAE,YAAY,EAAE,YAAY,CAAC,EACrC,OAAO,CAAC,UAAU,EAClB,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,KAAK,CACd,CAAC;IACF,MAAM,WAAW,GAAG,MAAM,gBAAgB,CACxC,GAAG,OAAO,qBAAqB,EAC/B,QAAQ,EACR,MAAM,EACN,CAAC,YAAY,EAAE,WAAW,CAAC,EAC3B,OAAO,CAAC,UAAU,EAClB,SAAS,EACT,OAAO,CAAC,KAAK,CACd,CAAC;IAEF,IAAI,qBAAqB,GAAG,CAAC,CAAC;IAC9B,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,SAAS,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS;YAAE,SAAS;QAC/D,KAAK,MAAM,MAAM,IAAI,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAClD,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YACtD,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YACxD,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;YAC9D,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;YACvE,MAAM,UAAU,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC;gBAC9B,cAAc,EAAE,UAAU,CAAC,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,CAAC;gBAC3E,GAAG,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC;gBAC1C,QAAQ;gBACR,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3B,WAAW,EAAE,SAAS;gBACtB,UAAU,EAAE,eAAe;gBAC3B,WAAW;gBACX,YAAY;gBACZ,YAAY;gBACZ,gBAAgB;gBAChB,WAAW,EAAE,qBAAqB;gBAClC,UAAU,EAAE,aAAa;gBACzB,eAAe,EAAE,eAAe,CAAC,uCAAuC,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC;gBACrG,QAAQ,EAAE,WAAW,CAAC;oBACpB,WAAW,EAAE,aAAa;oBAC1B,gBAAgB,EAAE,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;oBACpD,GAAG,UAAU;iBACd,CAAC;gBACF,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC;aAChC,CAAC,CAAC;YACH,qBAAqB,IAAI,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,SAAS,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS;YAAE,SAAS;QAC/D,KAAK,MAAM,MAAM,IAAI,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAClD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACrC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACtC,IAAI,OAAO,KAAK,SAAS;gBAAE,SAAS;YACpC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,EAAE,IAAI,KAAK,CAAC;YAClE,MAAM,UAAU,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAC5C,MAAM,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC;gBAC9B,cAAc,EAAE,UAAU,CAAC,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,CAAC;gBAC3E,GAAG,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC;gBAC1C,QAAQ;gBACR,WAAW,EAAE,SAAS;gBACtB,UAAU,EAAE,eAAe;gBAC3B,OAAO;gBACP,QAAQ;gBACR,WAAW,EAAE,aAAa;gBAC1B,UAAU,EAAE,qBAAqB;gBACjC,eAAe,EAAE,eAAe,CAAC,2BAA2B,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC;gBACzF,QAAQ,EAAE,WAAW,CAAC;oBACpB,WAAW,EAAE,WAAW;oBACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;oBACjC,GAAG,UAAU;iBACd,CAAC;gBACF,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC;aAChC,CAAC,CAAC;YACH,qBAAqB,IAAI,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,OAAO;QACL,QAAQ;QACR,GAAG,KAAK;QACR,qBAAqB;QACrB,sBAAsB,EAAE,CAAC;QACzB,MAAM,EAAE,MAAM,yBAAyB,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAC;KAC/E,CAAC;AACJ,CAAC;AAgBD,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAwC;IAExC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC;IACzD,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;IACrF,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,8BAA8B,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAChG,IAAI,sBAAsB,GAAG,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU;YAC1C,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YACxH,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CACpD,MAAM,CAAC,QAAQ,KAAK,QAAQ;gBAC5B,MAAM,CAAC,UAAU,KAAK,aAAa;gBACnC,MAAM,CAAC,UAAU,IAAI,KAAK,CAAC,IAAI;gBAC/B,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC,EAAE,CAC7B,CAAC;aACD,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CACjB,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC;YACjC,MAAM,CAAC,UAAU,KAAK,aAAa,CACpC,CAAC;QACJ,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;YAChC,MAAM,UAAU,GAAG,MAAM,8BAA8B,CAAC,MAAM,CAAC,iBAA2B,EAAE;gBAC1F,GAAG,EAAE,EAAE,kBAAkB,EAAE,OAAO,CAAC,MAAM,EAAE;gBAC3C,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClD,QAAQ,EAAE,YAAY,CAAC,MAAM,CAAC;aAC/B,CAAC,CAAC;YACH,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,KAAK,CAAC,UAAU,KAAK,qBAAqB;gBAAE,SAAS;YACnF,MAAM,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,0BAA0B,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;YAChF,sBAAsB,IAAI,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,IAAI,qBAAqB,GAAG,CAAC,CAAC;IAC9B,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACnD,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YAClD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,OAAO,WAAW,CAAC,CAAC;YAC3C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACnC,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;gBAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,CAAC,UAAoB,CAAC,CAAC;YAClG,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YACzE,KAAK,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC;gBACnD,MAAM,UAAU,GAAG,WAAW,CAAC;oBAC7B,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC;oBACnC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;oBACxB,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC;oBAC3C,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;iBACxC,CAAC,CAAC;gBACH,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;gBACpD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;gBACzD,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;gBACnF,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBAClC,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;gBACzD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBAChC,MAAM,OAAO,GAAqB;oBAChC,cAAc,EAAE,UAAU,CAAC,QAAQ,EAAE,qBAAqB,EAAE,IAAI,EAAE,UAAU,CAAC;oBAC7E,QAAQ;oBACR,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC3B,WAAW,EAAE,eAAe,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;oBAC7D,UAAU,EAAE,eAAe;oBAC3B,WAAW;oBACX,YAAY;oBACZ,eAAe;oBACf,WAAW,EAAE,qBAAqB;oBAClC,UAAU,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,qBAAqB;oBACzE,eAAe,EAAE;wBACf,MAAM,EAAE,qBAAqB;wBAC7B,IAAI;wBACJ,MAAM,EAAE,GAAiB;qBAC1B;oBACD,QAAQ,EAAE,WAAW,CAAC;wBACpB,WAAW,EAAE,UAAU;wBACvB,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;wBAC/B,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;wBACrC,GAAG,UAAU;qBACd,CAAC;oBACF,UAAU,EAAE,GAAG,IAAI,gBAAgB;iBACpC,CAAC;gBACF,IAAI,OAAO,KAAK,SAAS;oBAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;gBACrD,IAAI,eAAe,KAAK,SAAS;oBAAE,OAAO,CAAC,eAAe,GAAG,eAAe,CAAC;gBAC7E,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;oBAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,OAAiB,CAAC;gBACxE,MAAM,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;gBACzC,qBAAqB,IAAI,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO;QACL,QAAQ;QACR,GAAG,KAAK;QACR,qBAAqB;QACrB,sBAAsB;QACtB,MAAM,EAAE,MAAM,yBAAyB,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAC;KAC/E,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,KAAiB,EACjB,KAAqD;IAErD,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE;QAC5C,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK;QACf,UAAU,EAAE,aAAa;QACzB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,EAAE,EAAE,KAAK,CAAC,EAAE;KACb,CAAC,CAAC;IACH,MAAM,CAAC,aAAa,CAAC,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE;QAC7C,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK;QACf,UAAU,EAAE,eAAe;QAC3B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,EAAE,EAAE,KAAK,CAAC,EAAE;KACb,CAAC,CAAC;IACH,MAAM,oBAAoB,GAAG,YAAY,IAAI,eAAe,CAAC;IAC7D,MAAM,gBAAgB,GAAG,aAAa,IAAI,eAAe,CAAC;IAC1D,OAAO;QACL,GAAG,KAAK;QACR,YAAY,EAAE,oBAAoB;QAClC,aAAa,EAAE,gBAAgB;QAC/B,QAAQ,EAAE;YACR,WAAW,EAAE,UAAU,CAAC,gBAAgB,CAAC,WAAW,EAAE,oBAAoB,CAAC,WAAW,CAAC;YACvF,YAAY,EAAE,UAAU,CAAC,gBAAgB,CAAC,YAAY,EAAE,oBAAoB,CAAC,YAAY,CAAC;YAC1F,YAAY,EAAE,UAAU,CAAC,gBAAgB,CAAC,YAAY,EAAE,oBAAoB,CAAC,YAAY,CAAC;YAC1F,eAAe,EAAE,UAAU,CAAC,gBAAgB,CAAC,eAAe,EAAE,oBAAoB,CAAC,eAAe,CAAC;YACnG,gBAAgB,EAAE,UAAU,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,oBAAoB,CAAC,gBAAgB,CAAC;SACvG;QACD,QAAQ,EAAE;YACR,kBAAkB,EAAE,oBAAoB,CAAC,WAAW;YACpD,mCAAmC,EAAE,oBAAoB,CAAC,wBAAwB;YAClF,8BAA8B,EAAE,oBAAoB,CAAC,mBAAmB;YACxE,mBAAmB,EAAE,gBAAgB,CAAC,WAAW;YACjD,qBAAqB,EAAE,oBAAoB,CAAC,wBAAwB,KAAK,GAAG;YAC5E,oBAAoB,EAAE,oBAAoB,CAAC,mBAAmB,KAAK,GAAG;YACtE,8BAA8B,EAAE,gBAAgB,CAAC,WAAW,KAAK,GAAG;SACrE;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,SAAS,CACtB,KAAiB,EACjB,KAA+D;IAE/D,IAAI,KAAK,CAAC,cAAc;QAAE,OAAO,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;IACxC,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACrE,OAAO,qBAAqB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,QAAgB,EAChB,GAAW,EACX,MAA8B,EAC9B,MAAgB,EAChB,UAAgC,EAChC,SAA+B,EAC/B,SAAmC;IAEnC,MAAM,OAAO,GAA8B,EAAE,CAAC;IAC9C,IAAI,IAAwB,CAAC;IAC7B,GAAG,CAAC;QACF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACtF,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACpC,KAAK,MAAM,KAAK,IAAI,MAAM;YAAE,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACvE,KAAK,MAAM,SAAS,IAAI,UAAU,IAAI,EAAE;YAAE,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QAC5F,KAAK,MAAM,QAAQ,IAAI,SAAS,IAAI,EAAE;YAAE,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QACzF,IAAI,IAAI;YAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1C,IAAI,GAAG,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACpE,IAAI,IAAI,EAAE,QAAQ,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACrC,MAAM,IAAI,oBAAoB,CAAC,0DAA0D,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC,QAAQ,IAAI,EAAE;IACf,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,GAAQ,EACR,GAAW,EACX,SAAmC;IAEnC,MAAM,OAAO,GAAG,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC;IAC9C,IAAI,SAAkB,CAAC;IACvB,KAAK,MAAM,OAAO,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;QACpC,IAAI,OAAO;YAAE,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,gBAAgB,CAAC,CAAC;QACrE,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE;gBAClC,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,GAAG,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;gBACvE,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YACH,IAAI,QAAQ,CAAC,EAAE;gBAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,CAAC;YACpE,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACrD,SAAS,GAAG,IAAI,oBAAoB,CAClC,4CAA4C,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,EAC5F,sCAAsC,CACvC,CAAC;YACF,IAAI,CAAC,SAAS;gBAAE,MAAM,SAAS,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;QACpB,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,MAAM,SAAS,YAAY,KAAK;QAC9B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,IAAI,oBAAoB,CAAC,+CAA+C,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,0BAA0B,CACjC,MAAmB,EACnB,UAA2E;IAE3E,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;IAC/B,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;QAAE,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IAC3E,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS;QAAE,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;IAC9E,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS;QAAE,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;IAC9E,IAAI,KAAK,CAAC,gBAAgB,KAAK,SAAS;QAAE,KAAK,CAAC,gBAAgB,GAAG,KAAK,CAAC,gBAAgB,CAAC;IAC1F,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS;QAAE,KAAK,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;IACvF,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;QAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC/D,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS;QAAE,KAAK,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;IACvF,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;QAAE,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IAClE,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;QAAE,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IAC3E,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;QAAE,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IACxE,IAAI,UAAU,CAAC,eAAe;QAAE,KAAK,CAAC,eAAe,GAAG,UAAU,CAAC,eAAe,CAAC;IACnF,KAAK,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;IAC3C,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,MAAmB;IACvC,OAAO;QACL,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAC7B,MAA+B,EAC/B,OAAgD;IAEhD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1E,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAClE,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,gBAAgB,CAAC,MAA+B;IACvD,OAAO,WAAW,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;QACnC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;QACpC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;QAClC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;QACxC,KAAK,EAAE,OAAO,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;KACpE,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CACtB,MAAc,EACd,SAAiB,EACjB,OAAe,EACf,MAA+B;IAE/B,OAAO;QACL,MAAM;QACN,WAAW,EAAE,QAAQ,CAAC,SAAS,CAAC;QAChC,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC;QAC5B,MAAM,EAAE,MAAoB;KAC7B,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,QAAgB,EAAE,MAAc,EAAE,MAAuB,EAAE,UAAsB;IACnG,OAAO,WAAW,QAAQ,IAAI,MAAM,IAAI,MAAM,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;AAC7E,CAAC;AAED,SAAS,iBAAiB,CACxB,IAAY,EACZ,EAAsB,EACtB,GAAS,EACT,QAAgB;IAEhB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,oBAAoB,CAAC,+CAA+C,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,QAAQ,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;IACpE,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,eAAe,CAAC,IAAI,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY,EAAE,EAAsB,EAAE,GAAS;IACxE,OAAO,eAAe,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,EAAsB,EAAE,SAAiB;IAC9E,MAAM,cAAc,GAAG,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACnD,MAAM,YAAY,GAAG,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IACvE,IAAI,cAAc,IAAI,YAAY,EAAE,CAAC;QACnC,MAAM,IAAI,oBAAoB,CAAC,yDAAyD,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC;AACpD,CAAC;AAED,SAAS,MAAM,CAAC,KAAW;IACzB,OAAO,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC;AAC7D,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,EAAU;IACxC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC;QAC1G,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACtB,MAAM,IAAI,oBAAoB,CAAC,4EAA4E,CAAC,CAAC;IAC/G,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,KAAa;IAC7C,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AACnD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa;IAC7B,OAAO,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;AAC/C,CAAC;AAED,SAAS,GAAG,CAAC,KAAa,EAAE,IAAY;IACtC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAAE,MAAM,IAAI,oBAAoB,CAAC,GAAG,IAAI,4BAA4B,CAAC,CAAC;IACtG,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;AAC5B,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzB,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAoC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACnF,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,CAAC,CAAC,KAAgC;QAClC,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,KAA8B;IACjD,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CACzC,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,SAAS,CAC3B,CACY,CAAC;AAClB,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9E,CAAC;AAED,SAAS,KAAK,CAAC,KAAyB;IACtC,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;AACpC,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACnG,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACrE,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACnF,CAAC;AAED,SAAS,cAAc,CAAC,KAAa,EAAE,IAAY;IACjD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,oBAAoB,CAAC,GAAG,IAAI,eAAe,CAAC,CAAC;IACpE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/usage-records.d.ts

@@ -0,0 +1,24 @@
+import type { JsonObject } from "@assemblyline-agents/core";
+import type { UsageAggregate, UsageQuery, UsageRecord, UsageRecordInput, UsageSummaryQuery } from "./state.js";
+export declare function usageTokensAreAuthoritative(source: UsageRecord["tokenSource"]): boolean;
+export declare class UsageAccountingError extends Error {
+    readonly code: string;
+    constructor(message: string, code?: string);
+}
+export declare function createUsageRecord(input: UsageRecordInput, id?: string): UsageRecord;
+export declare function usageRecordInput(record: UsageRecord): UsageRecordInput;
+/**
+ * Merge a duplicate provider receipt without weakening its accounting
+ * provenance. Transaction identity stays immutable; provider-reconciled
+ * values may replace unavailable observations, and control totals may be refreshed when a
+ * provider revises a settled bucket.
+ */
+export declare function reconcileUsageRecord(existing: UsageRecord, input: UsageRecordInput): UsageRecord;
+export declare function normalizeStoredUsageRecord(value: unknown): UsageRecord | undefined;
+export declare function matchesUsageQuery(record: UsageRecord, query: UsageQuery): boolean;
+export declare function queryUsageRecords(records: UsageRecord[], query: UsageQuery): UsageRecord[];
+export declare function summarizeUsageRecords(records: UsageRecord[], query: UsageSummaryQuery): UsageAggregate[];
+export declare function usdToMicros(value: number): string;
+export declare function microsToUsd(value: string | bigint): number;
+export declare function sha256Json(value: JsonObject): string;
+//# sourceMappingURL=usage-records.d.ts.map

package/dist/usage-records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-records.d.ts","sourceRoot":"","sources":["../src/usage-records.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EACV,cAAc,EAGd,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAKpB,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,WAAW,CAAC,aAAa,CAAC,GAAG,OAAO,CAEvF;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAChB,QAAQ,CAAC,IAAI;gBAA9B,OAAO,EAAE,MAAM,EAAW,IAAI,SAA4B;CAIvE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,EAAE,EAAE,GAAE,MAAqB,GAAG,WAAW,CAiEjG;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,gBAAgB,CAgCtE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,gBAAgB,GAAG,WAAW,CA2ChG;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAmDlF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAsBjF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,UAAU,GAAG,WAAW,EAAE,CAM1F;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,iBAAiB,GAAG,cAAc,EAAE,CAexG;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEpD"}