@methodts/runtime 0.1.0

package/dist/event-bus/channel-sink.test.js

@@ -0,0 +1,234 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Unit tests for ChannelSink (PRD 026 Phase 3).
+ */
+import { describe, it, beforeEach } from 'node:test';
+import assert from 'node:assert/strict';
+import { ChannelSink, getChannelTarget } from './channel-sink.js';
+// ── Test helpers ───────────────────────────────────────────────
+function makeEvent(seq, overrides = {}) {
+    return {
+        id: `evt-${seq}`,
+        version: 1,
+        timestamp: new Date(Date.now() + seq).toISOString(),
+        sequence: seq,
+        domain: 'session',
+        type: 'session.spawned',
+        severity: 'info',
+        payload: {},
+        source: 'test',
+        sessionId: 'sess-1',
+        ...overrides,
+    };
+}
+// ── Tests ──────────────────────────────────────────────────────
+describe('ChannelSink', () => {
+    let sink;
+    beforeEach(() => {
+        sink = new ChannelSink({ capacity: 5 });
+    });
+    describe('onEvent', () => {
+        it('buffers events by sessionId', () => {
+            sink.onEvent(makeEvent(1, { sessionId: 'sess-1' }));
+            sink.onEvent(makeEvent(2, { sessionId: 'sess-2' }));
+            sink.onEvent(makeEvent(3, { sessionId: 'sess-1' }));
+            const s1 = sink.getEvents('sess-1');
+            const s2 = sink.getEvents('sess-2');
+            assert.equal(s1.messages.length, 2);
+            assert.equal(s2.messages.length, 1);
+        });
+        it('ignores events without sessionId', () => {
+            sink.onEvent(makeEvent(1, { sessionId: undefined }));
+            assert.deepEqual(sink.getSessionIds(), []);
+        });
+        it('evicts oldest when buffer exceeds capacity', () => {
+            for (let i = 1; i <= 7; i++) {
+                sink.onEvent(makeEvent(i, { sessionId: 'sess-1' }));
+            }
+            const result = sink.getEvents('sess-1');
+            assert.equal(result.messages.length, 5, 'buffer should cap at capacity');
+            assert.equal(result.messages[0].sequence, 3, 'oldest events evicted');
+            assert.equal(result.messages[4].sequence, 7);
+        });
+    });
+    describe('cursor recovery', () => {
+        it('skips events at or below cursor', () => {
+            sink.initFromCursor(5);
+            sink.onEvent(makeEvent(3, { sessionId: 'sess-1' }));
+            sink.onEvent(makeEvent(5, { sessionId: 'sess-1' }));
+            sink.onEvent(makeEvent(6, { sessionId: 'sess-1' }));
+            const result = sink.getEvents('sess-1');
+            assert.equal(result.messages.length, 1);
+            assert.equal(result.messages[0].sequence, 6);
+        });
+        it('exposes current cursor', () => {
+            sink.onEvent(makeEvent(10, { sessionId: 'sess-1' }));
+            assert.equal(sink.cursor, 10);
+        });
+    });
+    describe('getEvents', () => {
+        it('filters by sinceSequence', () => {
+            sink.onEvent(makeEvent(1, { sessionId: 'sess-1' }));
+            sink.onEvent(makeEvent(2, { sessionId: 'sess-1' }));
+            sink.onEvent(makeEvent(3, { sessionId: 'sess-1' }));
+            const result = sink.getEvents('sess-1', 1);
+            assert.equal(result.messages.length, 2);
+            assert.equal(result.messages[0].sequence, 2);
+        });
+        it('filters by channel target (progress)', () => {
+            sink.onEvent(makeEvent(1, {
+                sessionId: 'sess-1',
+                type: 'methodology.step_completed',
+                payload: {},
+            }));
+            sink.onEvent(makeEvent(2, {
+                sessionId: 'sess-1',
+                type: 'session.spawned',
+                payload: {},
+            }));
+            const progress = sink.getEvents('sess-1', 0, 'progress');
+            assert.equal(progress.messages.length, 1);
+            assert.equal(progress.messages[0].type, 'methodology.step_completed');
+        });
+        it('filters by channel target (events)', () => {
+            sink.onEvent(makeEvent(1, {
+                sessionId: 'sess-1',
+                type: 'session.observation.idle',
+                payload: { channelTarget: 'progress' },
+            }));
+            sink.onEvent(makeEvent(2, {
+                sessionId: 'sess-1',
+                type: 'session.killed',
+                payload: {},
+            }));
+            const events = sink.getEvents('sess-1', 0, 'events');
+            assert.equal(events.messages.length, 1);
+            assert.equal(events.messages[0].type, 'session.killed');
+        });
+        it('returns empty for unknown session', () => {
+            const result = sink.getEvents('nonexistent');
+            assert.equal(result.messages.length, 0);
+            assert.equal(result.last_sequence, 0);
+        });
+        it('returns backward-compatible ChannelMessage shape', () => {
+            sink.onEvent(makeEvent(1, {
+                sessionId: 'sess-1',
+                source: 'bridge/sessions/pool',
+                payload: { test: true },
+            }));
+            const result = sink.getEvents('sess-1');
+            const msg = result.messages[0];
+            assert.equal(typeof msg.sequence, 'number');
+            assert.equal(typeof msg.timestamp, 'string');
+            assert.equal(typeof msg.sender, 'string');
+            assert.equal(msg.sender, 'bridge/sessions/pool');
+            assert.equal(typeof msg.type, 'string');
+            assert.deepEqual(msg.content, { test: true });
+        });
+    });
+    describe('getAggregated', () => {
+        it('aggregates events across sessions', () => {
+            sink.onEvent(makeEvent(1, { sessionId: 'sess-1', type: 'session.killed', payload: {} }));
+            sink.onEvent(makeEvent(2, { sessionId: 'sess-2', type: 'session.spawned', payload: {} }));
+            const result = sink.getAggregated();
+            assert.equal(result.events.length, 2);
+        });
+        it('filters by sinceSequence', () => {
+            sink.onEvent(makeEvent(1, { sessionId: 'sess-1', type: 'session.killed', payload: {} }));
+            sink.onEvent(makeEvent(2, { sessionId: 'sess-1', type: 'session.spawned', payload: {} }));
+            const result = sink.getAggregated(1);
+            assert.equal(result.events.length, 1);
+            assert.equal(result.events[0].message.sequence, 2);
+        });
+        it('only includes events-channel events', () => {
+            sink.onEvent(makeEvent(1, {
+                sessionId: 'sess-1',
+                type: 'methodology.step_completed',
+                payload: {},
+            }));
+            sink.onEvent(makeEvent(2, {
+                sessionId: 'sess-1',
+                type: 'session.killed',
+                payload: {},
+            }));
+            const result = sink.getAggregated();
+            assert.equal(result.events.length, 1, 'progress events excluded from aggregation');
+        });
+        it('sorts by timestamp', () => {
+            // Events arrive in sequence order but with different timestamps
+            sink.onEvent(makeEvent(1, {
+                sessionId: 'sess-2',
+                timestamp: '2026-01-01T00:00:02.000Z',
+                type: 'session.killed',
+                payload: {},
+            }));
+            sink.onEvent(makeEvent(2, {
+                sessionId: 'sess-1',
+                timestamp: '2026-01-01T00:00:01.000Z',
+                type: 'session.spawned',
+                payload: {},
+            }));
+            const result = sink.getAggregated();
+            assert.equal(result.events[0].message.timestamp, '2026-01-01T00:00:01.000Z');
+            assert.equal(result.events[1].message.timestamp, '2026-01-01T00:00:02.000Z');
+        });
+    });
+    describe('push notifications', () => {
+        it('calls pushToParent for warning/error/critical events', () => {
+            const pushed = [];
+            const pushSink = new ChannelSink({
+                capacity: 10,
+                pushToParent: (sid, evt) => pushed.push({ sessionId: sid, event: evt }),
+            });
+            pushSink.onEvent(makeEvent(1, { sessionId: 'sess-1', severity: 'info' }));
+            pushSink.onEvent(makeEvent(2, { sessionId: 'sess-1', severity: 'warning' }));
+            pushSink.onEvent(makeEvent(3, { sessionId: 'sess-1', severity: 'error' }));
+            pushSink.onEvent(makeEvent(4, { sessionId: 'sess-1', severity: 'critical' }));
+            assert.equal(pushed.length, 3, 'info should not trigger push');
+            assert.equal(pushed[0].event.severity, 'warning');
+            assert.equal(pushed[1].event.severity, 'error');
+            assert.equal(pushed[2].event.severity, 'critical');
+        });
+        it('does not push events without sessionId', () => {
+            const pushed = [];
+            const pushSink = new ChannelSink({
+                pushToParent: () => pushed.push(1),
+            });
+            pushSink.onEvent(makeEvent(1, { sessionId: undefined, severity: 'error' }));
+            assert.equal(pushed.length, 0);
+        });
+        it('push failure is non-fatal', () => {
+            const pushSink = new ChannelSink({
+                pushToParent: () => { throw new Error('push failed'); },
+            });
+            // Should not throw
+            pushSink.onEvent(makeEvent(1, { sessionId: 'sess-1', severity: 'error' }));
+            assert.equal(pushSink.cursor, 1, 'event still processed despite push failure');
+        });
+    });
+    describe('removeSession', () => {
+        it('removes session buffer', () => {
+            sink.onEvent(makeEvent(1, { sessionId: 'sess-1' }));
+            sink.removeSession('sess-1');
+            const result = sink.getEvents('sess-1');
+            assert.equal(result.messages.length, 0);
+        });
+    });
+});
+describe('getChannelTarget', () => {
+    it('returns progress for methodology step events', () => {
+        assert.equal(getChannelTarget(makeEvent(1, { type: 'methodology.step_completed', payload: {} })), 'progress');
+        assert.equal(getChannelTarget(makeEvent(1, { type: 'methodology.step_started', payload: {} })), 'progress');
+    });
+    it('returns progress when payload has channelTarget progress', () => {
+        assert.equal(getChannelTarget(makeEvent(1, { payload: { channelTarget: 'progress' } })), 'progress');
+    });
+    it('returns events when payload has channelTarget events', () => {
+        assert.equal(getChannelTarget(makeEvent(1, { payload: { channelTarget: 'events' } })), 'events');
+    });
+    it('defaults to events for other types', () => {
+        assert.equal(getChannelTarget(makeEvent(1, { type: 'session.spawned', payload: {} })), 'events');
+        assert.equal(getChannelTarget(makeEvent(1, { type: 'strategy.started', payload: {} })), 'events');
+    });
+});
+//# sourceMappingURL=channel-sink.test.js.map

package/dist/event-bus/channel-sink.test.js.map

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

package/dist/event-bus/event-types.snapshot.test.d.ts

@@ -0,0 +1,27 @@
+/**
+ * PRD-057 SC-6 / C7 — Event-type snapshot gate (G-EVENT-TYPE-SNAPSHOT).
+ *
+ * Asserts that the union of **literal** RuntimeEvent `type` strings
+ * emitted by `@methodts/runtime` source code matches a committed manifest.
+ * Any accidental removal, rename, or addition of an event type flips
+ * this test red. Intentional changes update both the emission site and
+ * the manifest in the same PR.
+ *
+ * Scope:
+ * - Scans `packages/runtime/src/**\/*.ts` excluding tests, index barrels,
+ *   and architecture tests.
+ * - Matches three syntactic shapes used today in the codebase:
+ *     1. Object-literal property: `type: 'domain.subtype'`
+ *     2. `emit(bus, 'domain.subtype', ...)` (cost-events.ts factory)
+ *     3. Membership sets containing `'domain.subtype'` entries — captured
+ *        only when the surrounding context was already a known
+ *        `SESSION_EVENT_TYPES`-style static list (detected heuristically).
+ * - Dynamic / interpolated types (e.g. `\`session.cognitive.${e}\``) are
+ *   out of scope — the snapshot captures the **stable wire surface** per
+ *   S2 §4 ("Event `type` strings unchanged — wire format is stable").
+ *
+ * Wire-format stability rule: event `type` strings are part of the
+ * public contract. This test enforces that invariant.
+ */
+export {};
+//# sourceMappingURL=event-types.snapshot.test.d.ts.map

package/dist/event-bus/event-types.snapshot.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-types.snapshot.test.d.ts","sourceRoot":"","sources":["../../src/event-bus/event-types.snapshot.test.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG"}

package/dist/event-bus/event-types.snapshot.test.js

@@ -0,0 +1,165 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * PRD-057 SC-6 / C7 — Event-type snapshot gate (G-EVENT-TYPE-SNAPSHOT).
+ *
+ * Asserts that the union of **literal** RuntimeEvent `type` strings
+ * emitted by `@methodts/runtime` source code matches a committed manifest.
+ * Any accidental removal, rename, or addition of an event type flips
+ * this test red. Intentional changes update both the emission site and
+ * the manifest in the same PR.
+ *
+ * Scope:
+ * - Scans `packages/runtime/src/**\/*.ts` excluding tests, index barrels,
+ *   and architecture tests.
+ * - Matches three syntactic shapes used today in the codebase:
+ *     1. Object-literal property: `type: 'domain.subtype'`
+ *     2. `emit(bus, 'domain.subtype', ...)` (cost-events.ts factory)
+ *     3. Membership sets containing `'domain.subtype'` entries — captured
+ *        only when the surrounding context was already a known
+ *        `SESSION_EVENT_TYPES`-style static list (detected heuristically).
+ * - Dynamic / interpolated types (e.g. `\`session.cognitive.${e}\``) are
+ *   out of scope — the snapshot captures the **stable wire surface** per
+ *   S2 §4 ("Event `type` strings unchanged — wire format is stable").
+ *
+ * Wire-format stability rule: event `type` strings are part of the
+ * public contract. This test enforces that invariant.
+ */
+import { readFileSync, readdirSync, statSync } from 'node:fs';
+import { join, dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const RUNTIME_SRC = resolve(__dirname, '..');
+/**
+ * Committed snapshot of the literal event `type` strings produced by
+ * `@methodts/runtime`. Sorted alphabetically. Changing this list requires
+ * an intentional edit reviewed alongside the emission site change.
+ *
+ * PRD-057 / S2 §4 / SC-6: this is the stable wire format contract.
+ */
+const EVENT_TYPE_MANIFEST = [
+    // Cost governor
+    // Note: `CostEventType` (cost-events.ts) declares two additional
+    // variants — `cost.clock_discontinuity` and `cost.prediction_diverged`
+    // — that are reserved in the union but not currently emitted from
+    // any source path. When an emitter for either is added, re-add the
+    // string here in the same commit.
+    'cost.account_saturated',
+    'cost.estimate_emitted',
+    'cost.integrity_violation',
+    'cost.observation_parse_error',
+    'cost.observation_recorded',
+    'cost.observations_corrupted',
+    'cost.rate_limited',
+    'cost.slot_leaked',
+    // Gate / approval (strategy domain)
+    'gate.approval_response',
+    'gate.awaiting_approval',
+    // Pact lifecycle (cortex-job-backed-executor)
+    'pact.dead_letter',
+    // Session lifecycle
+    'session.dead',
+    'session.killed',
+    'session.prompt.completed',
+    'session.spawned',
+    'session.stale',
+    'session.state_changed',
+    // System
+    'system.bus_error',
+];
+function walkTsFiles(dir, out = []) {
+    const entries = readdirSync(dir);
+    for (const entry of entries) {
+        const full = join(dir, entry);
+        const s = statSync(full);
+        if (s.isDirectory()) {
+            if (entry === 'node_modules' || entry === 'dist' || entry === '__tests__')
+                continue;
+            walkTsFiles(full, out);
+        }
+        else if (entry.endsWith('.ts')) {
+            // Skip test files and architecture tests — they reference arbitrary
+            // event types as fixtures and would pollute the snapshot.
+            if (entry.endsWith('.test.ts'))
+                continue;
+            if (entry === 'architecture.test.ts')
+                continue;
+            out.push(full);
+        }
+    }
+    return out;
+}
+/**
+ * Extract literal event `type` strings emitted by a runtime source file.
+ *
+ * Matches `type: 'x.y'`, `type: "x.y"`, and `emit(bus, 'x.y', ...)`.
+ * Skips template literals (intentional — those are dynamic, not part of
+ * the stable snapshot).
+ */
+function extractEventTypes(source) {
+    const types = [];
+    // Shape 1: `type: 'x.y'` or `type: "x.y"`
+    const propPattern = /\btype:\s*(['"])([a-z][a-z0-9_]*(?:\.[a-z0-9_]+)+)\1/g;
+    // Shape 2: `emit(bus, 'x.y', ...)` (cost-events factory helper)
+    const emitPattern = /\bemit\s*\(\s*[A-Za-z_][\w]*\s*,\s*(['"])([a-z][a-z0-9_]*(?:\.[a-z0-9_]+)+)\1/g;
+    // Shape 3: membership-set literals: ['x.y', 'a.b', ...] or Set([...])
+    //   captured by scanning any string literal matching the event-type shape
+    //   on lines INSIDE a `new Set([`...`])` block starting from an
+    //   identifier-assigned constant containing `EVENT_TYPES`.
+    //   Simpler: include any string-literal of shape domain.subtype appearing
+    //   in files named `session-checkpoint-sink.ts` or inside declared
+    //   `EVENT_TYPES` regions. Rather than over-engineer, handle it by
+    //   explicit inclusion: capture plain string-literals of the shape in
+    //   source files we know hold event-type sets.
+    let m;
+    while ((m = propPattern.exec(source)) !== null)
+        types.push(m[2]);
+    while ((m = emitPattern.exec(source)) !== null)
+        types.push(m[2]);
+    return types;
+}
+/**
+ * A small allow-list of files that declare event-type sets (not emissions).
+ * These contribute literal types via plain string-literals, not
+ * `type: '...'` object-property syntax. We scan them for any
+ * shape-matching string literal.
+ */
+const EVENT_TYPE_SET_FILES = new Set([
+    // session-checkpoint-sink.ts has `SESSION_EVENT_TYPES = new Set([...])`
+    'session-checkpoint-sink.ts',
+]);
+function extractEventTypesFromSetFile(source) {
+    const types = [];
+    // Any 'domain.subtype' string-literal shape. Keep restrictive to
+    // lower-case alnum/underscore tokens separated by dots.
+    const literalPattern = /(['"])([a-z][a-z0-9_]*(?:\.[a-z0-9_]+)+)\1/g;
+    let m;
+    while ((m = literalPattern.exec(source)) !== null)
+        types.push(m[2]);
+    return types;
+}
+describe('@methodts/runtime — event-type snapshot (PRD-057 SC-6 / G-EVENT-TYPE-SNAPSHOT)', () => {
+    it('union of literal RuntimeEvent type strings matches the committed manifest', () => {
+        const files = walkTsFiles(RUNTIME_SRC);
+        const seen = new Set();
+        for (const file of files) {
+            const src = readFileSync(file, 'utf-8');
+            for (const t of extractEventTypes(src))
+                seen.add(t);
+            const basename = file.split(/[\\/]/).pop() ?? '';
+            if (EVENT_TYPE_SET_FILES.has(basename)) {
+                for (const t of extractEventTypesFromSetFile(src))
+                    seen.add(t);
+            }
+        }
+        const actual = Array.from(seen).sort();
+        const expected = [...EVENT_TYPE_MANIFEST].sort();
+        assert.deepEqual(actual, expected, `Event-type snapshot drift detected.\n` +
+            `  Added (in source, not manifest):   ${actual.filter((t) => !expected.includes(t)).join(', ') || '<none>'}\n` +
+            `  Removed (in manifest, not source): ${expected.filter((t) => !actual.includes(t)).join(', ') || '<none>'}\n` +
+            `If the change is intentional, update EVENT_TYPE_MANIFEST in this file.`);
+    });
+});
+//# sourceMappingURL=event-types.snapshot.test.js.map

package/dist/event-bus/event-types.snapshot.test.js.map

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

package/dist/event-bus/genesis-sink.d.ts

@@ -0,0 +1,55 @@
+/**
+ * GenesisSink — PRD 026 Phase 4.
+ *
+ * Feeds events to the Genesis agent session via a narrow callback interface.
+ * Events are batched in a configurable time window (default 30s) and
+ * summarized into a human-readable prompt. Only events matching the severity
+ * filter are buffered (default: warning + error + critical).
+ *
+ * The sink receives a promptSession callback — NOT the SessionPool itself
+ * — to respect G-BOUNDARY. The composition root wires the callback.
+ */
+import type { RuntimeEvent, EventSink, EventSeverity } from '../ports/event-bus.js';
+/**
+ * Narrow callback for prompting the Genesis session.
+ * Composition root wires this to pool.prompt(sessionId, text, timeout).
+ */
+export type GenesisPromptCallback = (sessionId: string, prompt: string) => Promise<void>;
+export interface GenesisSinkOptions {
+    /** Callback to prompt the Genesis session. */
+    promptSession: GenesisPromptCallback;
+    /** Genesis session ID. */
+    sessionId: string;
+    /** Batch window in milliseconds (default: 30_000). */
+    batchWindowMs?: number;
+    /** Severity levels to include (default: ['warning', 'error', 'critical']). */
+    severityFilter?: EventSeverity[];
+}
+export declare class GenesisSink implements EventSink {
+    readonly name = "genesis";
+    private readonly promptSession;
+    private readonly sessionId;
+    private readonly batchWindowMs;
+    private readonly severityFilter;
+    private buffer;
+    private timer;
+    private disposed;
+    constructor(options: GenesisSinkOptions);
+    onEvent(event: RuntimeEvent): void;
+    onError(error: Error, event: RuntimeEvent): void;
+    /**
+     * Flush the buffer and prompt Genesis with a summary.
+     * Exposed for testing — normally called by the batch timer.
+     */
+    flush(): Promise<void>;
+    /**
+     * Summarize buffered events into a human-readable prompt for Genesis.
+     * Groups by domain and severity for efficient consumption.
+     */
+    static summarize(events: RuntimeEvent[]): string;
+    /** Clean up timer. Call on shutdown. */
+    dispose(): void;
+    /** Number of events currently buffered (for testing/monitoring). */
+    get bufferedCount(): number;
+}
+//# sourceMappingURL=genesis-sink.d.ts.map

package/dist/event-bus/genesis-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"genesis-sink.d.ts","sourceRoot":"","sources":["../../src/event-bus/genesis-sink.ts"],"names":[],"mappings":"AACA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAIpF;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEzF,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,aAAa,EAAE,qBAAqB,CAAC;IACrC,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CAClC;AAOD,qBAAa,WAAY,YAAW,SAAS;IAC3C,QAAQ,CAAC,IAAI,aAAa;IAE1B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwB;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IAEpD,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,kBAAkB;IASvC,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAclC,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IAMhD;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB5B;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM;IAyChD,wCAAwC;IACxC,OAAO,IAAI,IAAI;IAUf,oEAAoE;IACpE,IAAI,aAAa,IAAI,MAAM,CAE1B;CACF"}