@voxslopuli/openagentsy 0.0.0-stage → 0.2.0

package/dist/commands/ledger.js

@@ -0,0 +1,286 @@
+import { access } from 'node:fs/promises';
+import { join } from 'node:path';
+import { closeLedger, detectCacheMiss, detectNoProgressAtPath, emptyLedgerExport, ledgerExport, ledgerPath, openLedger, recordOutcome, recordWasteRows, scanRefsTrailers, scanReverts, scanTaskTransitions, wasteByKind, wasteTotals, } from '@openagentsy/ledger';
+export async function runLedger(stateRoot) {
+    const databasePath = ledgerPath(stateRoot);
+    // A project that has no ledger yet has nothing to show, and reading it
+    // should not create one.
+    const exists = await access(databasePath).then(() => true, () => false);
+    if (!exists) {
+        return {
+            root: stateRoot,
+            databasePath,
+            exists: false,
+            counters: emptyLedgerExport(),
+        };
+    }
+    const db = openLedger(stateRoot);
+    try {
+        return { root: stateRoot, databasePath, exists: true, counters: ledgerExport(db) };
+    }
+    finally {
+        closeLedger(db);
+    }
+}
+/** A price, or the word for a price nobody knows. */
+function money(usd) {
+    return usd === null ? 'unpriced' : `$${usd.toFixed(4)}`;
+}
+function field(label, value) {
+    return `  ${label.padEnd(12)}${value}`;
+}
+/** The number of tokens, with the thousands separated. */
+function tokens(value) {
+    return value.toLocaleString('en-US');
+}
+export function formatLedgerReport(report) {
+    const lines = [];
+    const counters = report.counters;
+    lines.push('ledger');
+    lines.push(field('database', `${report.databasePath} ${report.exists ? 'found' : 'missing'}`));
+    lines.push(field('messages', String(counters.totals.messages)));
+    lines.push(field('tokens', tokens(counters.totals.tokens)));
+    lines.push(field('cost', money(counters.totals.usd)));
+    lines.push(field('unpriced', `${counters.totals.unpricedMessages} message(s)`));
+    lines.push('');
+    lines.push('by role');
+    if (counters.byRole.length === 0) {
+        lines.push('  (none)');
+    }
+    for (const role of counters.byRole) {
+        lines.push(`  ${role.role.padEnd(14)}${tokens(role.tokens).padStart(10)}   ${money(role.usd)}`);
+    }
+    lines.push('');
+    lines.push('by task');
+    if (counters.byTask.length === 0) {
+        lines.push('  (none)');
+    }
+    for (const task of counters.byTask) {
+        lines.push(`  ${task.taskId.padEnd(14)}${tokens(task.tokens).padStart(10)}   ${money(task.usd)}`);
+    }
+    lines.push('');
+    lines.push('waste');
+    lines.push(field('tokens', `${tokens(counters.waste.tokens)} (${counters.waste.percentage.toFixed(1)}%)`));
+    lines.push('');
+    lines.push('outcomes');
+    lines.push(field('tasks', `${counters.outcomes.tasksCompleted} completed, ${counters.outcomes.tasksScrapped} scrapped`));
+    lines.push(field('commits', `${counters.outcomes.commits} commit(s), ${counters.outcomes.prsMerged} merged`));
+    lines.push(field('per task', counters.tokensPerCompletedTask === null
+        ? 'unpriced'
+        : `${tokens(counters.tokensPerCompletedTask)} tokens`));
+    lines.push('');
+    lines.push('offload');
+    lines.push(field('messages', `${counters.offload.messages} message(s), ${tokens(counters.offload.tokens)} tokens`));
+    lines.push(field('cost', money(counters.offload.usd)));
+    return `${lines.join('\n')}\n`;
+}
+/**
+ * The board of a project, at the path the board keeps it.
+ */
+function boardPath(stateRoot) {
+    return join(stateRoot, '.openagentsy', 'board.sqlite');
+}
+/**
+ * Find the waste that can be found without the event bridge, and say what
+ * the waste is.
+ */
+export async function runLedgerWaste(stateRoot, options = {}) {
+    const since = options.since ?? '30 days ago';
+    const instant = instantOf(since);
+    const db = openLedger(stateRoot);
+    try {
+        const candidates = [
+            ...detectCacheMiss(db, {
+                ...(options.dataDir === undefined ? {} : { dataDir: options.dataDir }),
+                since: instant,
+            }),
+            ...detectNoProgressAtPath(db, boardPath(stateRoot), {
+                since: instant,
+                ...(options.leadAgent === undefined ? {} : { leadAgent: options.leadAgent }),
+            }),
+        ];
+        const written = recordWasteRows(db, candidates);
+        return {
+            root: stateRoot,
+            written,
+            byKind: wasteByKind(db),
+            totals: wasteTotals(db),
+        };
+    }
+    finally {
+        closeLedger(db);
+    }
+}
+/**
+ * The reverted code of the repository, found on demand (§6.4).
+ *
+ * A command and not a daemon: it walks the history of the repository once,
+ * when a person or the Lead asks for it. The tokens of a signal are the
+ * builder tokens of the task the commit named, times the share of the lines
+ * that were taken back.
+ *
+ * The history is the workspace's: it is the branch the session works on. The
+ * ledger the signals are written into is the state root's.
+ */
+export async function runLedgerScanReverts(roots, options = {}) {
+    const since = options.since ?? '30 days ago';
+    const db = openLedger(roots.stateRoot);
+    try {
+        const candidates = scanReverts(roots.workspace, since, {
+            tokensForTask: builderTokens(db),
+        });
+        const written = recordWasteRows(db, candidates);
+        return {
+            root: roots.workspace,
+            since,
+            found: candidates.length,
+            written,
+            tokens: candidates.reduce((sum, row) => sum + row.tokens, 0),
+        };
+    }
+    finally {
+        closeLedger(db);
+    }
+}
+/**
+ * The tokens the builders of a task spent.
+ *
+ * The ledger holds the tokens per message and the task each message was
+ * made for, so the sum of the builder rows of a task is what its reverts
+ * cost.
+ */
+function builderTokens(db) {
+    const rows = db
+        .query(`SELECT task_id, SUM(input + output + reasoning + cache_write) AS tokens
+       FROM usage WHERE task_id IS NOT NULL AND role = 'builder' GROUP BY task_id`)
+        .all();
+    const map = new Map();
+    for (const row of rows)
+        map.set(row.task_id, Number(row.tokens ?? 0));
+    return (taskId) => map.get(taskId) ?? 0;
+}
+/**
+ * The outcomes of the work (§6.5).
+ *
+ * Two scanners run here: the `Refs:` trailers of the commits, and the task
+ * transitions — but only when the caller injects a reader for the tasks
+ * store. The ledger does not import that store, so the command runs without
+ * the task transitions until whoever knows the store injects a reader.
+ *
+ * The history is the workspace's, and the ledger the outcomes are written
+ * into is the state root's.
+ */
+export async function runLedgerOutcomes(roots, options = {}) {
+    const since = options.since ?? '30 days ago';
+    const db = openLedger(roots.stateRoot);
+    try {
+        const candidates = [
+            ...scanRefsTrailers(roots.workspace, since),
+            ...(options.taskReader === undefined
+                ? []
+                : await scanTaskTransitions(roots.workspace, instantOf(since), options.taskReader)),
+        ];
+        let written = 0;
+        for (const candidate of candidates) {
+            if (recordOutcome(db, candidate))
+                written += 1;
+        }
+        const rows = db
+            .query('SELECT kind, COUNT(*) AS count FROM outcome GROUP BY kind ORDER BY kind')
+            .all();
+        return {
+            root: roots.workspace,
+            since,
+            found: candidates.length,
+            written,
+            taskTransitions: options.taskReader !== undefined,
+            byKind: rows.map((row) => ({ kind: String(row.kind), count: Number(row.count) })),
+        };
+    }
+    finally {
+        closeLedger(db);
+    }
+}
+/** The length of a unit the relative form of `--since` uses. */
+const RELATIVE_UNITS = {
+    second: 1000,
+    minute: 60_000,
+    hour: 3_600_000,
+    day: 86_400_000,
+    week: 604_800_000,
+    month: 2_592_000_000,
+};
+/**
+ * The instant a `--since` names, and the empty string when it names none.
+ *
+ * A date is a moment, and a relative phrase like "30 days ago" is a moment
+ * too — git understands the phrase, and the scanners that compare
+ * timestamps need it as a timestamp.
+ */
+function instantOf(since) {
+    const parsed = Date.parse(since);
+    if (Number.isFinite(parsed))
+        return new Date(parsed).toISOString();
+    const relative = /^(\d+)\s+([a-z]+)\s+ago$/.exec(since);
+    const amount = Number(relative?.[1]);
+    const unit = relative?.[2];
+    const ms = unit === undefined ? undefined : RELATIVE_UNITS[unit];
+    if (ms === undefined || !Number.isFinite(amount))
+        return '';
+    return new Date(Date.now() - amount * ms).toISOString();
+}
+/** The waste report, as a person reads it. */
+export function formatWasteReport(report) {
+    const lines = [];
+    lines.push('waste');
+    lines.push(field('written', `${report.written} new signal(s)`));
+    lines.push(field('tokens', `${tokens(report.totals.tokens)} (${report.totals.percentage.toFixed(1)}%)`));
+    lines.push('');
+    if (report.byKind.length === 0) {
+        lines.push('  (none)');
+    }
+    for (const kind of report.byKind) {
+        lines.push(`  ${kind.kind.padEnd(16)}${tokens(kind.tokens).padStart(10)}  ${kind.count} signal(s)  ${kind.percentage.toFixed(1)}%`);
+    }
+    return `${lines.join('\n')}\n`;
+}
+/** The head of a scan report: its title and the fields every scan has. */
+function scanHead(title, fields) {
+    const lines = [title];
+    for (const [label, value] of fields)
+        lines.push(field(label, value));
+    return lines;
+}
+/** The revert report, as a person reads it. */
+export function formatScanRevertsReport(report) {
+    const lines = scanHead('scan-reverts', [
+        ['since', report.since],
+        ['found', `${report.found} commit(s)`],
+        ['written', `${report.written} signal(s)`],
+        ['tokens', tokens(report.tokens)],
+    ]);
+    return `${lines.join('\n')}\n`;
+}
+/** The outcome report, as a person reads it. */
+export function formatOutcomesReport(report) {
+    const lines = scanHead('outcomes', [
+        ['since', report.since],
+        ['found', `${report.found} outcome(s)`],
+        ['written', `${report.written} outcome(s)`],
+        [
+            'tasks',
+            report.taskTransitions
+                ? 'task transitions scanned'
+                : 'task transitions not scanned (no reader injected)',
+        ],
+    ]);
+    lines.push('');
+    if (report.byKind.length === 0) {
+        lines.push('  (none)');
+    }
+    for (const kind of report.byKind) {
+        lines.push(`  ${kind.kind.padEnd(16)}${kind.count}`);
+    }
+    return `${lines.join('\n')}\n`;
+}
+//# sourceMappingURL=ledger.js.map

package/dist/commands/ledger.js.map

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

package/dist/commands/ledger.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ledger.test.d.ts.map

package/dist/commands/ledger.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.test.d.ts","sourceRoot":"","sources":["../../src/commands/ledger.test.ts"],"names":[],"mappings":""}

package/dist/commands/ledger.test.js

@@ -0,0 +1,238 @@
+import { mkdirSync } from 'node:fs';
+import { mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { closeDatabase, createRecord, migrate, openDatabase, } from '@openagentsy/core';
+import { closeLedger, openLedger, recordAssistantMessage, runGit } from '@openagentsy/ledger';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { formatLedgerReport, formatOutcomesReport, formatScanRevertsReport, formatWasteReport, runLedger, runLedgerOutcomes, runLedgerScanReverts, runLedgerWaste, } from './ledger.js';
+let root;
+/** The two roots of a project that is its own state root. */
+function rootsOf(root) {
+    return { workspace: root, stateRoot: root };
+}
+beforeEach(async () => {
+    root = await mkdtemp(join(tmpdir(), 'openagentsy-ledger-cli-'));
+});
+afterEach(async () => {
+    await rm(root, { recursive: true, force: true });
+});
+const CTX = {
+    rootSessionId: 'ses_1',
+    role: 'builder',
+    ts: '2026-10-26T10:00:00.000Z',
+};
+function seed() {
+    const db = openLedger(root);
+    try {
+        recordAssistantMessage(db, {
+            id: 'msg_1',
+            sessionID: 'ses_1',
+            providerID: 'anthropic',
+            modelID: 'claude-sonnet-4-5',
+            tokens: { input: 100, output: 40, reasoning: 10, cache: { read: 900, write: 5 } },
+            cost: 0.5,
+        }, CTX);
+    }
+    finally {
+        closeLedger(db);
+    }
+}
+describe('the ledger command', () => {
+    it('shows nothing for a project without a ledger, and creates no file', async () => {
+        const report = await runLedger(root);
+        expect(report.exists).toBe(false);
+        expect(report.counters.totals.messages).toBe(0);
+        expect(formatLedgerReport(report)).toContain('missing');
+    });
+    it('shows the counters of a ledger', async () => {
+        seed();
+        const report = await runLedger(root);
+        expect(report.exists).toBe(true);
+        expect(report.counters.totals.messages).toBe(1);
+        expect(report.counters.totals.tokens).toBe(155);
+        expect(report.counters.totals.usd).toBe(0.5);
+        const text = formatLedgerReport(report);
+        expect(text).toContain('builder');
+        expect(text).toContain('$0.5000');
+    });
+    it('shows an unpriced message as unpriced, not as zero', async () => {
+        seed();
+        const db = openLedger(root);
+        try {
+            recordAssistantMessage(db, {
+                id: 'msg_2',
+                sessionID: 'ses_1',
+                providerID: 'anthropic',
+                modelID: 'claude-sonnet-4-5',
+                tokens: { input: 10, output: 5 },
+            }, { ...CTX, role: 'lead' });
+        }
+        finally {
+            closeLedger(db);
+        }
+        const report = await runLedger(root);
+        expect(report.counters.totals.unpricedMessages).toBe(1);
+        expect(formatLedgerReport(report)).toContain('unpriced');
+    });
+    it('exports the counters and nothing else', async () => {
+        seed();
+        const report = await runLedger(root);
+        expect(report.counters.schema).toBe('openagentsy.ledger/v1');
+        const json = JSON.stringify(report.counters);
+        expect(json).not.toContain('msg_1');
+        expect(json).not.toContain('ses_1');
+        expect(json).not.toContain('claude-sonnet-4-5');
+    });
+});
+/** A board of the shape the board writes, for the no-progress detector. */
+function seedBoard() {
+    const dir = join(root, '.openagentsy');
+    mkdirSync(dir, { recursive: true });
+    const db = openDatabase(join(dir, 'board.sqlite'));
+    try {
+        migrate(db);
+        createRecord(db, {
+            bean: 'bean',
+            kind: 'status',
+            from: 'agentsy',
+            action: 'the Lead wrote down where it was',
+            state: 'nothing came of the round',
+            confidence: 'verified',
+        });
+    }
+    finally {
+        closeDatabase(db);
+    }
+}
+/** A Lead message in the ledger. */
+function seedLead() {
+    const db = openLedger(root);
+    try {
+        recordAssistantMessage(db, {
+            id: 'l1',
+            sessionID: 'ses_lead',
+            providerID: 'anthropic',
+            modelID: 'claude-sonnet-4-5',
+            tokens: { input: 1000, output: 0 },
+        }, { rootSessionId: 'ses_lead', role: 'lead', ts: '2026-01-01T00:00:00.000Z' });
+    }
+    finally {
+        closeLedger(db);
+    }
+}
+/** A builder message of a task, for the token share of a revert. */
+function seedBuilder(target, taskId) {
+    const db = openLedger(target);
+    try {
+        recordAssistantMessage(db, {
+            id: 'b1',
+            sessionID: 'ses_builder',
+            providerID: 'anthropic',
+            modelID: 'claude-sonnet-4-5',
+            tokens: { input: 2000, output: 0 },
+        }, {
+            rootSessionId: 'ses_builder',
+            role: 'builder',
+            activeTaskId: taskId,
+            ts: '2026-01-01T00:00:00.000Z',
+        });
+    }
+    finally {
+        closeLedger(db);
+    }
+}
+/** A repository with a commit that was taken back and one that was not. */
+async function seedRepo() {
+    const repo = await mkdtemp(join(tmpdir(), 'openagentsy-cli-repo-'));
+    const git = (...args) => {
+        const result = runGit(repo, [
+            '-c',
+            'user.email=test@example.com',
+            '-c',
+            'user.name=Test',
+            '-c',
+            'commit.gpgsign=false',
+            ...args,
+        ]);
+        if (!result.ok)
+            throw new Error(result.stderr);
+    };
+    git('init', '-q');
+    git('config', 'user.email', 'test@example.com');
+    git('config', 'user.name', 'Test');
+    git('config', 'commit.gpgsign', 'false');
+    await writeFile(join(repo, 'f.txt'), 'alpha\nbeta\n');
+    git('add', 'f.txt');
+    git('commit', '-q', '-m', 'feat: add the file\n\nRefs: task-1');
+    await writeFile(join(repo, 'f.txt'), 'gamma\n');
+    git('add', 'f.txt');
+    git('commit', '-q', '-m', 'chore: rewrite the file');
+    return repo;
+}
+describe('the waste command', () => {
+    it('finds the round of the Lead that went nowhere and says what the waste is', async () => {
+        seedBoard();
+        seedLead();
+        const empty = await mkdtemp(join(tmpdir(), 'openagentsy-cli-empty-'));
+        const report = await runLedgerWaste(root, { dataDir: empty, leadAgent: 'agentsy' });
+        expect(report.written).toBe(1);
+        expect(report.byKind.find((kind) => kind.kind === 'no_progress')?.tokens).toBe(1000);
+        expect(report.totals.tokens).toBe(1000);
+        const text = formatWasteReport(report);
+        expect(text).toContain('no_progress');
+        expect(text).toContain('100.0%');
+    });
+    it('says nothing when there is no board to read', async () => {
+        const empty = await mkdtemp(join(tmpdir(), 'openagentsy-cli-empty-'));
+        const report = await runLedgerWaste(root, { dataDir: empty });
+        expect(report.written).toBe(0);
+        expect(report.byKind).toHaveLength(0);
+    });
+});
+describe('the scan-reverts command', () => {
+    it('finds the code that was taken back and writes it down', async () => {
+        const repo = await seedRepo();
+        seedBuilder(repo, 'task-1');
+        const report = await runLedgerScanReverts(rootsOf(repo), { since: '30 days ago' });
+        expect(report.found).toBe(1);
+        expect(report.written).toBe(1);
+        expect(report.tokens).toBe(2000);
+        expect(formatScanRevertsReport(report)).toContain('scan-reverts');
+        const db = openLedger(repo);
+        try {
+            const row = db.query('SELECT kind, tokens FROM waste').get();
+            expect(row.kind).toBe('reverted_code');
+            expect(row.tokens).toBe(2000);
+        }
+        finally {
+            closeLedger(db);
+        }
+    });
+});
+describe('the outcomes command', () => {
+    it('finds the commits that name a task and writes them down', async () => {
+        const repo = await seedRepo();
+        const report = await runLedgerOutcomes(rootsOf(repo), { since: '30 days ago' });
+        expect(report.found).toBe(1);
+        expect(report.written).toBe(1);
+        expect(report.byKind.find((kind) => kind.kind === 'commit')?.count).toBe(1);
+        expect(formatOutcomesReport(report)).toContain('commit');
+        const db = openLedger(repo);
+        try {
+            const row = db.query('SELECT kind, task_id FROM outcome').get();
+            expect(row.kind).toBe('commit');
+            expect(row.task_id).toBe('task-1');
+        }
+        finally {
+            closeLedger(db);
+        }
+    });
+    it('writes the outcome once, however often it runs', async () => {
+        const repo = await seedRepo();
+        await runLedgerOutcomes(rootsOf(repo), { since: '30 days ago' });
+        const report = await runLedgerOutcomes(rootsOf(repo), { since: '30 days ago' });
+        expect(report.written).toBe(0);
+    });
+});
+//# sourceMappingURL=ledger.test.js.map

package/dist/commands/ledger.test.js.map

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

package/dist/commands/lessons.d.ts

@@ -0,0 +1,73 @@
+import { type EvalResult, type LessonState, type ObserveOutcome } from '@openagentsy/hooks';
+import { deciderBy } from '../who.js';
+export { deciderBy };
+/**
+ * The lesson commands.
+ *
+ * `/oa lessons` is the inbox: the lessons that are waiting for a person,
+ * with the ones that happened most often first. `/oa lesson <id>
+ * validate|apply|reject|observe` records the decision, and the decision is
+ * the person's: the command runs as the person, so `decidedBy` is the human.
+ *
+ * The lessons are the state root's: they are what the project learned, and
+ * a worktree of the project has the same lessons as the project.
+ */
+/** One lesson, as the inbox shows it. */
+export type LessonSummary = {
+    id: string;
+    state: LessonState;
+    summary: string;
+    occurrences: number;
+    kind: string;
+    sessions: number;
+    updated_at: string;
+};
+/** The inbox. */
+export type LessonsReport = {
+    root: string;
+    lessons: LessonSummary[];
+    /** How many lessons are waiting for a decision. */
+    awaiting: number;
+    /** How many lessons the store holds, the waiting ones and the history. */
+    total: number;
+};
+/** What a decision did. */
+export type LessonDecisionReport = {
+    ok: boolean;
+    id: string;
+    state: string;
+    reason: string;
+    hint?: string;
+};
+/** What the caller knows about the decision. */
+export type LessonDecisionOptions = {
+    /** Who decided. The person running the command. */
+    decidedBy?: string;
+    /** Why. */
+    reason?: string;
+    /** The change the decision names. */
+    changeRef?: string;
+    /** The state an observation lands in. */
+    outcome?: ObserveOutcome;
+    /** The proof the decision rests on. */
+    evalResult?: EvalResult;
+    /** The file the proof is in. The content of an eval result file. */
+    evalResultPath?: string;
+};
+/**
+ * The inbox.
+ */
+export declare function runLessons(stateRoot: string): Promise<LessonsReport>;
+/**
+ * The inbox, as it is read.
+ */
+export declare function formatLessonsReport(report: LessonsReport): string;
+/**
+ * Record a decision.
+ */
+export declare function runLessonDecision(stateRoot: string, id: string, action: string, options?: LessonDecisionOptions): Promise<LessonDecisionReport>;
+/**
+ * The decision, as it is read.
+ */
+export declare function formatLessonDecision(report: LessonDecisionReport): string;
+//# sourceMappingURL=lessons.d.ts.map

package/dist/commands/lessons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lessons.d.ts","sourceRoot":"","sources":["../../src/commands/lessons.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EAGf,KAAK,WAAW,EAEhB,KAAK,cAAc,EAGpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB;;;;;;;;;;GAUG;AAEH,yCAAyC;AACzC,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,iBAAiB;AACjB,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,2BAA2B;AAC3B,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,qBAAqB,GAAG;IAClC,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,uCAAuC;IACvC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAiB1E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAYjE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,oBAAoB,CAAC,CA6C/B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAMzE"}