@rasensio/aidlc 1.2.1 → 1.4.0

package/dist/cost/report.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Cost reports: per-instance, all-instances, by-template, unattributed.
+ *
+ * Reads ledgers only — never re-parses platform records (FR7.4). Applies
+ * read-time fidelity precedence, then prices weighted usage against the
+ * effective rate table. Every dollar-bearing report names its snapshot.
+ *
+ * Design: design.md §4.5
+ */
+import type { CostConfig, CostFidelity, CostEntry } from './types.js';
+export interface PhaseCost {
+    phase: string;
+    microUsd: number | null;
+    unpricedModels: string[];
+    tokens: number;
+    credits: number;
+    elapsedSeconds: number;
+}
+export interface InstanceCost {
+    instance: string;
+    template: string | null;
+    microUsd: number | null;
+    unpricedModels: string[];
+    tokens: number;
+    credits: number;
+    elapsedSeconds: number;
+    fidelityMix: Record<CostFidelity, number>;
+    phases: PhaseCost[];
+    snapshot: string;
+}
+/** Compute the full cost view of one instance. */
+export declare function instanceCost(projectRoot: string, instance: string, config: CostConfig | null): InstanceCost;
+/** All instances with state directories. */
+export declare function listInstances(projectRoot: string): string[];
+export interface TemplateRollup {
+    template: string;
+    count: number;
+    avgMicroUsd: number;
+    avgElapsedSeconds: number;
+}
+export declare function byTemplate(projectRoot: string, config: CostConfig | null): TemplateRollup[];
+/** Unattributed ledger entries (FR7.2 --unattributed). */
+export declare function unattributedEntries(projectRoot: string): CostEntry[];
+//# sourceMappingURL=report.d.ts.map

package/dist/cost/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/cost/report.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEtE,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC1C,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AA6DD,kDAAkD;AAClD,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,GAAG,IAAI,GACxB,YAAY,CA8Dd;AAED,4CAA4C;AAC5C,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAO3D;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,cAAc,EAAE,CAoB3F;AAED,0DAA0D;AAC1D,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,CAEpE"}

package/dist/cost/report.js

@@ -0,0 +1,164 @@
+/**
+ * Cost reports: per-instance, all-instances, by-template, unattributed.
+ *
+ * Reads ledgers only — never re-parses platform records (FR7.4). Applies
+ * read-time fidelity precedence, then prices weighted usage against the
+ * effective rate table. Every dollar-bearing report names its snapshot.
+ *
+ * Design: design.md §4.5
+ */
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { loadYaml } from '../state/yaml-helpers.js';
+import { readEntries, applyPrecedence, ledgerPath, unattributedPath } from './ledger.js';
+import { priceUnits, effectiveRates } from './rates.js';
+function sumWeighted(weighted, rates) {
+    let micro = 0;
+    let anyPriced = false;
+    const unpriced = new Set();
+    let tokens = 0;
+    let credits = 0;
+    for (const { entry, weight } of weighted) {
+        if (weight === 0 || entry.units === null)
+            continue;
+        const price = priceUnits(entry.units, rates);
+        if (price === null) {
+            unpriced.add(entry.units.kind === 'tokens' ? entry.units.model : 'kiro-credit');
+        }
+        else {
+            micro += price * weight;
+            anyPriced = true;
+        }
+        if (entry.units.kind === 'tokens') {
+            tokens += (entry.units.input_tokens + entry.units.output_tokens) * weight;
+        }
+        else {
+            credits += entry.units.credits * weight;
+        }
+    }
+    return { microUsd: anyPriced || unpriced.size === 0 ? Math.round(micro) : null, unpriced, tokens, credits };
+}
+function phaseElapsed(projectRoot, instance) {
+    const dir = join(projectRoot, '.aidlc', 'state', instance);
+    const out = new Map();
+    if (!existsSync(dir))
+        return out;
+    for (const f of readdirSync(dir)) {
+        if (!f.startsWith('phase-') || !f.endsWith('.yaml'))
+            continue;
+        try {
+            const state = loadYaml(join(dir, f));
+            out.set(state.phase, state.metrics?.elapsed_seconds ?? 0);
+        }
+        catch {
+            continue;
+        }
+    }
+    return out;
+}
+function instanceTemplate(projectRoot, instance) {
+    try {
+        const meta = loadYaml(join(projectRoot, '.aidlc', 'state', instance, 'instance.yaml'));
+        return meta.template ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Compute the full cost view of one instance. */
+export function instanceCost(projectRoot, instance, config) {
+    const rates = effectiveRates(projectRoot, config);
+    const entries = readEntries(ledgerPath(projectRoot, instance));
+    const weighted = applyPrecedence(entries);
+    const elapsed = phaseElapsed(projectRoot, instance);
+    const byPhase = new Map();
+    for (const w of weighted) {
+        const phase = w.entry.phase ?? 'unknown';
+        const list = byPhase.get(phase) ?? [];
+        list.push(w);
+        byPhase.set(phase, list);
+    }
+    const phases = [];
+    for (const [phase, list] of byPhase) {
+        const s = sumWeighted(list, rates);
+        phases.push({
+            phase,
+            microUsd: s.microUsd,
+            unpricedModels: [...s.unpriced],
+            tokens: Math.round(s.tokens),
+            credits: s.credits,
+            elapsedSeconds: elapsed.get(phase) ?? 0,
+        });
+    }
+    // Phases with time but no cost still appear.
+    for (const [phase, secs] of elapsed) {
+        if (secs > 0 && !byPhase.has(phase)) {
+            phases.push({ phase, microUsd: 0, unpricedModels: [], tokens: 0, credits: 0, elapsedSeconds: secs });
+        }
+    }
+    const total = sumWeighted(weighted, rates);
+    const fidelityMix = { metered: 0, reconciled: 0, estimated: 0, unknown: 0 };
+    let mixTotal = 0;
+    for (const { entry, weight } of weighted) {
+        if (entry.units === null)
+            continue;
+        fidelityMix[entry.fidelity] += weight;
+        mixTotal += weight;
+    }
+    if (mixTotal > 0) {
+        for (const k of Object.keys(fidelityMix)) {
+            fidelityMix[k] = fidelityMix[k] / mixTotal;
+        }
+    }
+    let totalElapsed = 0;
+    for (const secs of elapsed.values())
+        totalElapsed += secs;
+    return {
+        instance,
+        template: instanceTemplate(projectRoot, instance),
+        microUsd: total.microUsd,
+        unpricedModels: [...total.unpriced],
+        tokens: Math.round(total.tokens),
+        credits: total.credits,
+        elapsedSeconds: totalElapsed,
+        fidelityMix,
+        phases,
+        snapshot: rates.snapshot,
+    };
+}
+/** All instances with state directories. */
+export function listInstances(projectRoot) {
+    const dir = join(projectRoot, '.aidlc', 'state');
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir, { withFileTypes: true })
+        .filter((d) => d.isDirectory())
+        .map((d) => d.name)
+        .sort();
+}
+export function byTemplate(projectRoot, config) {
+    const groups = new Map();
+    for (const name of listInstances(projectRoot)) {
+        const cost = instanceCost(projectRoot, name, config);
+        const template = cost.template ?? '(unknown)';
+        const g = groups.get(template) ?? { micro: [], secs: [] };
+        g.micro.push(cost.microUsd ?? 0);
+        g.secs.push(cost.elapsedSeconds);
+        groups.set(template, g);
+    }
+    const out = [];
+    for (const [template, g] of groups) {
+        out.push({
+            template,
+            count: g.micro.length,
+            avgMicroUsd: Math.round(g.micro.reduce((a, b) => a + b, 0) / g.micro.length),
+            avgElapsedSeconds: Math.round(g.secs.reduce((a, b) => a + b, 0) / g.secs.length),
+        });
+    }
+    return out.sort((a, b) => a.template.localeCompare(b.template));
+}
+/** Unattributed ledger entries (FR7.2 --unattributed). */
+export function unattributedEntries(projectRoot) {
+    return readEntries(unattributedPath(projectRoot));
+}
+//# sourceMappingURL=report.js.map

package/dist/cost/report.js.map

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

package/dist/cost/sessions.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Session ledger: durable session↔instance mapping (FR1).
+ *
+ * sessions.ndjson is append-only; the instance.yaml claim field remains
+ * concurrency control only. Attribution intervals are derived here.
+ *
+ * The active-session stash (design §2.3) joins platform session ids to
+ * claims: SessionStart hooks write stash entries; `aidlc claim` resolves
+ * the current session with a strict single-candidate rule.
+ *
+ * Design: design.md §2.2, §2.3, §4.3
+ */
+import type { SessionEvent, ClaimInterval, ActiveSession } from './types.js';
+export declare function sessionsPath(projectRoot: string, instance: string): string;
+export declare function stashDir(projectRoot: string): string;
+/** Append a session event (O_APPEND whole-line write). */
+export declare function appendSessionEvent(path: string, event: SessionEvent): void;
+/** Read valid session events; missing file → empty; bad lines skipped. */
+export declare function readSessionEvents(path: string): SessionEvent[];
+/**
+ * Resolve attribution intervals from session events (FR1.3).
+ *
+ * claim → release pairs per session; an unreleased claim is bounded by
+ * min(now, lastEventForSession + claimTimeoutMinutes) and marked open.
+ * Renew events extend the liveness bound of an open claim.
+ */
+export declare function resolveIntervals(events: SessionEvent[], claimTimeoutMinutes: number, now?: Date): ClaimInterval[];
+/** Write a stash entry for a just-started platform session. */
+export declare function stashSession(projectRoot: string, session: ActiveSession): void;
+/** Remove stash entries older than the TTL. Called opportunistically. */
+export declare function pruneStash(projectRoot: string, now?: Date): void;
+/** Resolve a directory to its repo identity (git common dir), or null. */
+export declare function repoIdentity(cwd: string): string | null;
+/**
+ * Find the current platform session with the strict single-candidate rule:
+ * exactly one live stash entry whose repo identity matches → that session;
+ * zero or multiple → null (caller degrades to id_source: agent).
+ */
+export declare function resolveCurrentSession(projectRoot: string, now?: Date): ActiveSession | null;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/cost/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/cost/sessions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAgBH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAM7E,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEpD;AAgBD,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAS1E;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAuB9D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,YAAY,EAAE,EACtB,mBAAmB,EAAE,MAAM,EAC3B,GAAG,GAAE,IAAiB,GACrB,aAAa,EAAE,CA6BjB;AAiBD,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAK9E;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,IAAI,CAc5E;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWvD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,GAAG,GAAE,IAAiB,GACrB,aAAa,GAAG,IAAI,CAqBtB"}

package/dist/cost/sessions.js

@@ -0,0 +1,200 @@
+/**
+ * Session ledger: durable session↔instance mapping (FR1).
+ *
+ * sessions.ndjson is append-only; the instance.yaml claim field remains
+ * concurrency control only. Attribution intervals are derived here.
+ *
+ * The active-session stash (design §2.3) joins platform session ids to
+ * claims: SessionStart hooks write stash entries; `aidlc claim` resolves
+ * the current session with a strict single-candidate rule.
+ *
+ * Design: design.md §2.2, §2.3, §4.3
+ */
+import { readFileSync, writeFileSync, readdirSync, unlinkSync, openSync, writeSync, closeSync, constants, mkdirSync, existsSync, } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { SESSION_ID_RE } from './types.js';
+const EVENTS = new Set(['claim', 'renew', 'release']);
+const STASH_TTL_MS = 48 * 60 * 60 * 1000;
+export function sessionsPath(projectRoot, instance) {
+    return join(projectRoot, '.aidlc', 'state', instance, 'sessions.ndjson');
+}
+export function stashDir(projectRoot) {
+    return join(projectRoot, '.aidlc', 'cost', 'active-sessions');
+}
+function isValidEvent(e) {
+    if (typeof e !== 'object' || e === null)
+        return false;
+    const r = e;
+    return (EVENTS.has(r.event) &&
+        typeof r.session_id === 'string' &&
+        SESSION_ID_RE.test(r.session_id) &&
+        (r.id_source === 'platform' || r.id_source === 'agent') &&
+        typeof r.agent === 'string' &&
+        typeof r.timestamp === 'string' &&
+        !Number.isNaN(Date.parse(r.timestamp)));
+}
+/** Append a session event (O_APPEND whole-line write). */
+export function appendSessionEvent(path, event) {
+    if (!isValidEvent(event))
+        throw new Error('invalid session event');
+    mkdirSync(dirname(path), { recursive: true });
+    const fd = openSync(path, constants.O_WRONLY | constants.O_APPEND | constants.O_CREAT);
+    try {
+        writeSync(fd, JSON.stringify(event) + '\n');
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+/** Read valid session events; missing file → empty; bad lines skipped. */
+export function readSessionEvents(path) {
+    let raw;
+    try {
+        raw = readFileSync(path, 'utf8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return [];
+        throw err;
+    }
+    const events = [];
+    let skipped = 0;
+    for (const line of raw.split('\n')) {
+        const t = line.trim();
+        if (t === '')
+            continue;
+        try {
+            const parsed = JSON.parse(t);
+            if (isValidEvent(parsed))
+                events.push(parsed);
+            else
+                skipped++;
+        }
+        catch {
+            skipped++;
+        }
+    }
+    if (skipped > 0)
+        process.stderr.write(`${path}: skipped ${skipped} invalid line(s)\n`);
+    return events;
+}
+/**
+ * Resolve attribution intervals from session events (FR1.3).
+ *
+ * claim → release pairs per session; an unreleased claim is bounded by
+ * min(now, lastEventForSession + claimTimeoutMinutes) and marked open.
+ * Renew events extend the liveness bound of an open claim.
+ */
+export function resolveIntervals(events, claimTimeoutMinutes, now = new Date()) {
+    const intervals = [];
+    const open = new Map();
+    for (const e of events) {
+        const cur = open.get(e.session_id);
+        if (e.event === 'claim') {
+            // A re-claim without release closes the previous interval at the new claim.
+            if (cur) {
+                intervals.push(closedInterval(cur.claim, e.timestamp, false));
+            }
+            open.set(e.session_id, { claim: e, lastSeen: e.timestamp });
+        }
+        else if (e.event === 'renew' && cur) {
+            cur.lastSeen = e.timestamp;
+        }
+        else if (e.event === 'release' && cur) {
+            intervals.push(closedInterval(cur.claim, e.timestamp, false));
+            open.delete(e.session_id);
+        }
+    }
+    for (const { claim, lastSeen } of open.values()) {
+        const bound = Math.min(now.getTime(), Date.parse(lastSeen) + claimTimeoutMinutes * 60_000);
+        intervals.push(closedInterval(claim, new Date(bound).toISOString(), true));
+    }
+    return intervals;
+}
+function closedInterval(claim, to, open) {
+    return {
+        session_id: claim.session_id,
+        id_source: claim.id_source,
+        agent: claim.agent,
+        from: claim.timestamp,
+        to,
+        open,
+    };
+}
+// ---------------------------------------------------------------------------
+// Active-session stash (design §2.3)
+// ---------------------------------------------------------------------------
+/** Write a stash entry for a just-started platform session. */
+export function stashSession(projectRoot, session) {
+    if (!SESSION_ID_RE.test(session.session_id))
+        throw new Error('invalid session id');
+    const dir = stashDir(projectRoot);
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, `${session.session_id}.json`), JSON.stringify(session) + '\n');
+}
+/** Remove stash entries older than the TTL. Called opportunistically. */
+export function pruneStash(projectRoot, now = new Date()) {
+    const dir = stashDir(projectRoot);
+    if (!existsSync(dir))
+        return;
+    for (const f of readdirSync(dir)) {
+        if (!f.endsWith('.json'))
+            continue;
+        try {
+            const entry = JSON.parse(readFileSync(join(dir, f), 'utf8'));
+            if (now.getTime() - Date.parse(entry.started_at) > STASH_TTL_MS) {
+                unlinkSync(join(dir, f));
+            }
+        }
+        catch {
+            unlinkSync(join(dir, f));
+        }
+    }
+}
+/** Resolve a directory to its repo identity (git common dir), or null. */
+export function repoIdentity(cwd) {
+    try {
+        const out = execFileSync('git', ['rev-parse', '--git-common-dir'], {
+            cwd,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        return join(cwd, out);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Find the current platform session with the strict single-candidate rule:
+ * exactly one live stash entry whose repo identity matches → that session;
+ * zero or multiple → null (caller degrades to id_source: agent).
+ */
+export function resolveCurrentSession(projectRoot, now = new Date()) {
+    pruneStash(projectRoot, now);
+    const dir = stashDir(projectRoot);
+    if (!existsSync(dir))
+        return null;
+    const here = repoIdentity(projectRoot);
+    const candidates = [];
+    for (const f of readdirSync(dir)) {
+        if (!f.endsWith('.json'))
+            continue;
+        try {
+            const entry = JSON.parse(readFileSync(join(dir, f), 'utf8'));
+            const theirs = repoIdentity(entry.cwd);
+            if (here !== null && theirs !== null && here === theirs) {
+                candidates.push(entry);
+            }
+            else if (here === null && entry.cwd === projectRoot) {
+                candidates.push(entry);
+            }
+        }
+        catch {
+            // Unreadable stash entries are ignored here; pruneStash removes them.
+        }
+    }
+    return candidates.length === 1 ? candidates[0] : null;
+}
+//# sourceMappingURL=sessions.js.map

package/dist/cost/sessions.js.map

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

package/dist/cost/sync.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Post-hoc reconciliation: `aidlc cost sync` (FR4).
+ *
+ * Correlates platform usage records with instances via sessions.ndjson.
+ * Platform-id sessions match records by id equality; agent-id sessions
+ * match by interval overlap with a strict single-candidate rule. Appends
+ * `reconciled` entries only where coverage is not already held at equal or
+ * higher fidelity. Idempotent by construction; never guesses — ambiguity
+ * goes to the report, unattributable usage to unattributed.ndjson.
+ *
+ * Design: design.md §4.4
+ */
+import { type ProviderEnv } from './providers/provider.js';
+export interface SyncReport {
+    attributed: number;
+    skipped: string[];
+    unattributed: number;
+}
+/**
+ * Reconcile one or all instances. Streams platform records session by
+ * session; reports everything it skipped and why (FR4.3).
+ */
+export declare function syncCosts(projectRoot: string, instanceFilter: string | null, claimTimeoutMinutes: number, env?: ProviderEnv): Promise<SyncReport>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/cost/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/cost/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAKxE,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAkBD;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GAAG,IAAI,EAC7B,mBAAmB,EAAE,MAAM,EAC3B,GAAG,GAAE,WAA6B,GACjC,OAAO,CAAC,UAAU,CAAC,CA0GrB"}