ai-hist 0.6.0 → 0.8.2

package/dist/pair-client.js

@@ -1,60 +0,0 @@
-import { execFile } from "node:child_process";
-import { promisify } from "node:util";
-const execFileAsync = promisify(execFile);
-function pushArg(args, name, value) {
-    const trimmed = value?.trim();
-    if (trimmed)
-        args.push(name, trimmed);
-}
-function cliArgs(req) {
-    const c = req.context;
-    const args = ["pair", "check", "--json"];
-    pushArg(args, "--project-id", c.projectId);
-    pushArg(args, "--repo-path", c.repoPath);
-    pushArg(args, "--cwd", c.cwd);
-    pushArg(args, "--git-remote", c.gitRemote);
-    pushArg(args, "--task", c.task);
-    pushArg(args, "--tool", c.tool);
-    pushArg(args, "--target", c.target);
-    pushArg(args, "--action", c.action);
-    pushArg(args, "--recent-prompt", c.recentPrompt);
-    for (const file of c.files ?? [])
-        pushArg(args, "--file", file);
-    if (req.limit != null)
-        args.push("--limit", String(req.limit));
-    return args;
-}
-export async function pairCheck(req, timeoutMs = 10_000) {
-    const bin = process.env.AI_HIST_PAIR_CHECK_BIN || "ai-hist";
-    const { stdout } = await execFileAsync(bin, cliArgs(req), {
-        timeout: timeoutMs,
-        maxBuffer: 1024 * 1024,
-        env: process.env,
-    });
-    const parsed = (stdout.trim() ? JSON.parse(stdout) : {});
-    return {
-        decision: parsed.decision,
-        warnings: Array.isArray(parsed.warnings) ? parsed.warnings : [],
-        correlationId: parsed.correlationId,
-    };
-}
-export function formatPairWarnings(result) {
-    if (result.warnings.length === 0)
-        return "";
-    const lines = ["Pair advisory warnings from prior convergence events:"];
-    for (const warning of result.warnings) {
-        const label = [warning.kind, warning.lens].filter(Boolean).join("/");
-        const score = typeof warning.score === "number" ? ` score=${warning.score.toFixed(2)}` : "";
-        lines.push(`- ${label ? `[${label}${score}] ` : ""}${warning.text}`);
-        for (const ev of warning.evidence ?? []) {
-            const id = [ev.machineId, ev.source, ev.sessionId, ev.eventId].filter(Boolean).join(":");
-            const when = ev.ts ? ` ${ev.ts}` : "";
-            const snippet = ev.snippet ? ` - ${ev.snippet}` : "";
-            lines.push(`  evidence: ${id || ev.eventId || "(unknown)"}${when}${snippet}`);
-        }
-    }
-    if (result.correlationId)
-        lines.push(`correlationId: ${result.correlationId}`);
-    return lines.join("\n");
-}
-//# sourceMappingURL=pair-client.js.map

package/dist/pair-client.js.map

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

package/dist/pair-client.test.d.ts

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

package/dist/pair-client.test.d.ts.map

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

package/dist/pair-client.test.js

@@ -1,118 +0,0 @@
-import assert from 'node:assert/strict';
-import { mkdtemp, readFile, writeFile } from 'node:fs/promises';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { test } from 'node:test';
-import { formatPairWarnings, pairCheck } from './pair-client.js';
-test('pairCheck shells to ai-hist pair check with locked v1 context args', async () => {
-    const root = await mkdtemp(join(tmpdir(), 'ai-hist-pair-cli-'));
-    const callsPath = join(root, 'calls.json');
-    const binPath = join(root, 'ai-hist-mock.mjs');
-    await writeFile(binPath, `#!/usr/bin/env node
-import { writeFileSync } from 'node:fs';
-writeFileSync(${JSON.stringify(callsPath)}, JSON.stringify(process.argv.slice(2)));
-process.stdout.write(JSON.stringify({
-  decision: 'warn',
-  warnings: [{
-    text: 'Update permissions config before editing auth middleware.',
-    kind: 'reflection',
-    lens: 'trajectories',
-    score: 0.91,
-    evidence: [{
-      machineId: 'm_1',
-      source: 'trajectory',
-      sessionId: 'tA',
-      kind: 'reflection',
-      eventId: 'reflection:tA:suggestion:0',
-      ts: '2026-06-21T20:00:00Z',
-      snippet: 'update permissions config'
-    }]
-  }],
-  correlationId: 'pair_test'
-}));
-`, { mode: 0o755 });
-    const previousBin = process.env.AI_HIST_PAIR_CHECK_BIN;
-    process.env.AI_HIST_PAIR_CHECK_BIN = binPath;
-    try {
-        const result = await pairCheck({
-            context: {
-                projectId: 'proj-auth-svc',
-                repoPath: '/work/auth',
-                cwd: '/work/auth',
-                gitRemote: 'git@github.com:org/auth.git',
-                task: 'refactor auth middleware token check',
-                files: ['src/auth/middleware.ts'],
-                tool: 'Edit',
-                target: 'src/auth/middleware.ts',
-                action: 'edit',
-                recentPrompt: 'short prompt summary',
-            },
-            limit: 5,
-        });
-        assert.equal(result.decision, 'warn');
-        assert.equal(result.warnings[0].evidence?.[0].eventId, 'reflection:tA:suggestion:0');
-        assert.deepEqual(JSON.parse(await readFile(callsPath, 'utf8')), [
-            'pair',
-            'check',
-            '--json',
-            '--project-id',
-            'proj-auth-svc',
-            '--repo-path',
-            '/work/auth',
-            '--cwd',
-            '/work/auth',
-            '--git-remote',
-            'git@github.com:org/auth.git',
-            '--task',
-            'refactor auth middleware token check',
-            '--tool',
-            'Edit',
-            '--target',
-            'src/auth/middleware.ts',
-            '--action',
-            'edit',
-            '--recent-prompt',
-            'short prompt summary',
-            '--file',
-            'src/auth/middleware.ts',
-            '--limit',
-            '5',
-        ]);
-    }
-    finally {
-        if (previousBin === undefined)
-            delete process.env.AI_HIST_PAIR_CHECK_BIN;
-        else
-            process.env.AI_HIST_PAIR_CHECK_BIN = previousBin;
-    }
-});
-test('formatPairWarnings renders advisory evidence and no-ops on empty warnings', () => {
-    assert.equal(formatPairWarnings({ decision: 'allow', warnings: [] }), '');
-    const text = formatPairWarnings({
-        decision: 'warn',
-        warnings: [
-            {
-                text: 'Prior finding applies here.',
-                kind: 'finding',
-                lens: 'trajectories',
-                score: 0.875,
-                evidence: [
-                    {
-                        machineId: 'm_1',
-                        source: 'trajectory',
-                        sessionId: 'tA',
-                        eventId: 'finding:tA:learning:0',
-                        ts: '2026-06-21T20:00:00Z',
-                        snippet: 'rth_at hash lookup bypasses JWT verify',
-                    },
-                ],
-            },
-        ],
-        correlationId: 'pair_1',
-    });
-    assert.match(text, /Pair advisory warnings/);
-    assert.match(text, /\[finding\/trajectories score=0\.88\]/);
-    assert.match(text, /m_1:trajectory:tA:finding:tA:learning:0/);
-    assert.match(text, /correlationId: pair_1/);
-});
-//# sourceMappingURL=pair-client.test.js.map

package/dist/pair-client.test.js.map

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

package/dist/session-catalog.d.ts

@@ -1,257 +0,0 @@
-/**
- * Session catalog: the materialized shallow index of coding-agent sessions.
- *
- * Two halves, deliberately split by who owns the write:
- *
- *   - **Cache-only listing** — `AiHist.listSessionCatalog()` in `index.ts`
- *     reads the `sessions` table and nothing else. No provider file is opened,
- *     no `history` / `session_events` scan happens. This module supplies the
- *     row type and the raw-row → `CatalogSession` mapping it uses.
- *   - **Shallow discovery** — `discoverSessions()` here drives
- *     `ai-hist sessions discover --json`, which scans the known provider
- *     locations with bounded reads and upserts the catalog. It is a top-level
- *     function rather than an `AiHist` method because discovery *writes* the
- *     on-disk database, and an `AiHist` instance is an in-memory snapshot taken
- *     at open time — a method would hand back a reader that cannot see the rows
- *     it just wrote. Re-open (or `openAiHist` again) afterwards to read them.
- *
- * The Rust CLI stays the single source of truth for discovery (provider
- * locations, bounded reads, global recency ordering, stamp comparison), exactly
- * as `cloud-push.ts` defers to `ai-hist push` for the push pipeline.
- */
-import { spawn } from 'node:child_process';
-import type { Source } from './index.js';
-/**
- * Version of the session-catalog output contract this SDK understands.
- * Mirrors the native `SESSION_CATALOG_CONTRACT_VERSION`; a `summary` whose
- * `contractVersion` differs came from a binary that speaks a different dialect.
- */
-export declare const SESSION_CATALOG_CONTRACT_VERSION = 1;
-/**
- * One row of the session catalog — a coding-agent session as shallow
- * discovery knows it.
- *
- * Most fields are *observed* (read straight out of provider data);
- * `firstPrompt` is *derived* — a bounded excerpt of the first substantive human
- * prompt. Provider quirks worth knowing:
- *
- *   - `cursor` rows never have a `firstActivityMs` (the provider records no
- *     timestamps) and their `lastActivityMs` comes from the file mtime.
- *   - `relay` rows never have a `cwd` (a relay thread has no working
- *     directory) and only exist for threads a previous sync pulled down.
- *   - `lastAssistantText` is only written by a full ingest (`ai-hist sync`), so
- *     it is `null` on rows that have only ever been discovered shallowly.
- *   - `models` / `workspaceRoots` are best effort: `[]` means "not seen in a
- *     bounded read", not "none exist".
- */
-export interface CatalogSession {
-    /** Provider that owns the session. `trajectory` never appears here. */
-    source: Source;
-    /** The provider's own session id. `(source, sessionId)` is the catalog key. */
-    sessionId: string;
-    cwd: string | null;
-    gitBranch: string | null;
-    firstActivityMs: number | null;
-    lastActivityMs: number | null;
-    /** Derived: bounded excerpt of the first substantive human prompt. */
-    firstPrompt: string | null;
-    /** Full-ingest only; `null` on shallow-only rows. */
-    lastAssistantText: string | null;
-    /** Parsed from `models_json`; `[]` when nothing was observed. */
-    models: string[];
-    originator: string | null;
-    agentVersion: string | null;
-    repoUrl: string | null;
-    initialCommit: string | null;
-    /** Parsed from `workspace_roots_json`; `[]` when nothing was observed. */
-    workspaceRoots: string[];
-    rawPath: string | null;
-    /** Change stamp of the raw source at scan time (`v{scanner}:{provider stamp}`). */
-    sourceStamp: string | null;
-    /**
-     * `'shallow'` (catalog row only) or `'full'` (full evidence ingested).
-     * Rows written before the catalog existed store `NULL` and are reported as
-     * `'full'`, matching the native reader.
-     */
-    discoveryState: 'shallow' | 'full';
-    /** `true` when the row was served from the catalog without re-reading the source. */
-    fromCache: boolean;
-    /** Parser generation that wrote the row; absent on rows streamed by discovery. */
-    parserVersion?: number;
-}
-/**
- * A precise continuation point in the catalog's total order,
- * `(lastActivityMs DESC, source ASC, sessionId ASC)`.
- *
- * Recency alone is not a key — one discovery pass can stamp many sessions with
- * the same mtime-derived millisecond, and a cursor carrying only a timestamp
- * silently drops every row tied with the page boundary — so the identity
- * columns make the cursor total. `lastActivityMs` is null/absent for the tail
- * of rows whose recency is unknown; those sort after every dated row.
- */
-export interface CatalogCursor {
-    lastActivityMs?: number | null;
-    source: string;
-    sessionId: string;
-}
-/** Filters for the cache-only catalog listing. */
-export interface ListCatalogOptions {
-    /** Restrict to these sources. Omit for every discoverable source. */
-    sources?: Iterable<Source | string>;
-    /** Row cap. Default 50, mirroring the native `DEFAULT_CATALOG_LIMIT`. */
-    limit?: number;
-    /**
-     * Coarse cutoff: only sessions strictly older than this epoch-ms. Convenient
-     * for "anything before last Tuesday", but it cannot separate rows that share
-     * a millisecond — use `after` to walk pages. Ignored when `after` is set.
-     */
-    beforeMs?: number;
-    /** Precise continuation from the previous page's `nextCursor`. */
-    after?: CatalogCursor;
-}
-/** One page of the catalog plus the cursor that continues it. */
-export interface SessionCatalogPage {
-    /** The rows, newest first. */
-    sessions: CatalogSession[];
-    /**
-     * Pass as {@link ListCatalogOptions.after} for the next page. `null` when
-     * the page did not fill its limit, i.e. the catalog is exhausted.
-     */
-    nextCursor: CatalogCursor | null;
-}
-/** A non-fatal failure during discovery: one provider, or one bad session. */
-export interface DiscoveryDiagnostic {
-    source: string;
-    /** File path or provider-scoped handle, when the failure has one. */
-    locator: string | null;
-    error: string;
-}
-/** Per-provider tallies for one discovery run. */
-export interface ProviderDiscoverySummary {
-    /** Candidates enumerated, before the global limit. */
-    candidates: number;
-    /** Rows emitted after a shallow read. */
-    discovered: number;
-    /** Rows served from the catalog because the stamp was unchanged. */
-    skippedUnchanged: number;
-    /** `true` when enumeration itself failed. */
-    failed: boolean;
-}
-/** Work one discovery run actually performed — bounded-work evidence. */
-export interface DiscoveryCounters {
-    candidatesEnumerated: number;
-    shallowReads: number;
-    skippedUnchanged: number;
-    filesOpened: number;
-    bytesRead: number;
-}
-/** A source that deliberately has no shallow adapter, and why. */
-export interface SourceExemption {
-    source: string;
-    reason: string;
-}
-/** The closing `summary` line of a discovery run. */
-export interface DiscoverySummary {
-    /** Compare against {@link SESSION_CATALOG_CONTRACT_VERSION}. */
-    contractVersion: number;
-    discovered: number;
-    skippedUnchanged: number;
-    /** Per-provider tallies, keyed by source name. */
-    providers: Record<string, ProviderDiscoverySummary>;
-    exemptSources: SourceExemption[];
-    counters: DiscoveryCounters;
-}
-/** Everything one `discoverSessions()` run produced. */
-export interface DiscoverResult {
-    /** Rows in the order the CLI streamed them: newest first, globally. */
-    sessions: CatalogSession[];
-    /** Non-fatal per-provider / per-session failures. Never throws on these. */
-    diagnostics: DiscoveryDiagnostic[];
-    /** The closing summary. Always present: a run without one is rejected. */
-    summary: DiscoverySummary;
-}
-/**
- * A discovery run that could not be completed or trusted.
- *
- * The native command emits its diagnostics and the summary trailer even when
- * every provider fails, so a failed run still carries everything it managed to
- * learn: `diagnostics` says which sources broke and why, and `summary` (when
- * the trailer arrived) says what the run actually did. `stderr` and `exitCode`
- * carry the process-level detail.
- */
-export declare class DiscoveryError extends Error {
-    readonly exitCode: number | null;
-    readonly stderr: string;
-    readonly diagnostics: DiscoveryDiagnostic[];
-    readonly summary: DiscoverySummary | null;
-    constructor(message: string, details?: {
-        exitCode?: number | null;
-        stderr?: string;
-        diagnostics?: DiscoveryDiagnostic[];
-        summary?: DiscoverySummary | null;
-    });
-}
-export interface DiscoverSessionsOptions {
-    /** Explicit path to the ai-hist binary (overrides discovery). */
-    binPath?: string;
-    /** Restrict to these sources (forwarded as repeated `--source`). */
-    sources?: Iterable<Source | string>;
-    /**
-     * Global cap across all providers, applied by recency (`--limit`). The
-     * native ordering is global, so a limit of 3 returns the three newest
-     * sessions overall, not three per provider.
-     */
-    limit?: number;
-    /** Called for each session row as it streams, before the promise resolves. */
-    onSession?: (session: CatalogSession) => void;
-    /** Called for each diagnostic line as it streams. */
-    onDiagnostic?: (diagnostic: DiscoveryDiagnostic) => void;
-    /** Extra environment for the spawned binary (merged over `process.env`). */
-    env?: NodeJS.ProcessEnv;
-    /** Injectable spawn for testing. */
-    spawnFn?: typeof spawn;
-}
-/**
- * Parse a JSON string array column (`models_json`, `workspace_roots_json`).
- * `NULL`, `''`, and malformed JSON all mean "nothing observed" → `[]`; the
- * column never stores `[]` itself.
- */
-export declare function parseJsonStringList(raw: string | null | undefined): string[];
-/** `NULL` `discovery_state` predates the catalog and means a fully ingested row. */
-export declare function normalizeDiscoveryState(raw: unknown): 'shallow' | 'full';
-/** Map one snake_case CLI/`sessions`-row object onto a {@link CatalogSession}. */
-export declare function catalogSessionFromJson(raw: Record<string, unknown>): CatalogSession;
-/**
- * Run shallow session discovery by driving `ai-hist sessions discover --json`.
- *
- * The CLI streams JSONL — one `session` object per discovered row, a
- * `diagnostic` per non-fatal failure, then a closing `summary` — and this
- * parses it as it arrives, so `onSession` fires progressively rather than only
- * once the whole run finishes.
- *
- * Discovery **writes the on-disk database**. An `AiHist` opened before the run
- * is a snapshot and will not contain the new rows; re-open (or call
- * `openAiHist` again) before `listSessionCatalog()` to see them.
- *
- * Failure behavior mirrors the CLI's: a provider that blows up contributes a
- * diagnostic and the run still resolves (exit 0). Individual unparseable or
- * unrecognized lines are skipped rather than failing the run, so a newer
- * binary's extra line types stay forward-compatible. The promise rejects with
- * a {@link DiscoveryError} when:
- *
- *   - the binary cannot be run at all (the message names `AI_HIST_RUST_BIN`);
- *   - the run exits non-zero — every selected provider failed. The native
- *     command still writes its diagnostics and the summary trailer before
- *     exiting, so the error carries both alongside `stderr` and `exitCode`;
- *   - no summary line arrived, or its `contractVersion` is not the one this
- *     SDK understands. The trailer is mandatory in the native contract, so a
- *     run without one (or with a version this SDK cannot read) means the rows
- *     are not safe to interpret — better to say so than to hand back a
- *     half-understood catalog.
- *
- * An exception thrown by `onSession` or `onDiagnostic` aborts the run: the
- * child is killed and the promise rejects with that exception, rather than
- * escaping the stream handler as an uncaught error in the host process.
- */
-export declare function discoverSessions(opts?: DiscoverSessionsOptions): Promise<DiscoverResult>;
-//# sourceMappingURL=session-catalog.d.ts.map

package/dist/session-catalog.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"session-catalog.d.ts","sourceRoot":"","sources":["../src/session-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAI9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAElD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,sEAAsE;IACtE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qDAAqD;IACrD,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,iEAAiE;IACjE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,0EAA0E;IAC1E,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,mFAAmF;IACnF,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;;OAIG;IACH,cAAc,EAAE,SAAS,GAAG,MAAM,CAAC;IACnC,qFAAqF;IACrF,SAAS,EAAE,OAAO,CAAC;IACnB,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,kDAAkD;AAClD,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACpC,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,iEAAiE;AACjE,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B;;;OAGG;IACH,UAAU,EAAE,aAAa,GAAG,IAAI,CAAC;CAClC;AAED,8EAA8E;AAC9E,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,gBAAgB,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;IACpD,aAAa,EAAE,eAAe,EAAE,CAAC;IACjC,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,4EAA4E;IAC5E,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,0EAA0E;IAC1E,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,mBAAmB,EAAE,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;gBAGxC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;QACpC,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;KAC9B;CAST;AAED,MAAM,WAAW,uBAAuB;IACtC,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACpC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC9C,qDAAqD;IACrD,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACzD,4EAA4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAsBD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAO5E;AAED,oFAAoF;AACpF,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAExE;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAyBnF;AAmDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,uBAA4B,GAAG,OAAO,CAAC,cAAc,CAAC,CAiK5F"}