@proofhound/core 0.1.11 → 0.1.13

package/dist/server/modules/run-result/run-result-compactor.js

@@ -0,0 +1,188 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DrizzleRunResultCompactionStore = exports.RunResultCompactor = exports.RUN_RESULT_COMPACTION_STORE = void 0;
+// RunResultCompactor — tiers a finished run's large fields into object-storage shards (SPEC 30 §9.3).
+//
+// Protocol (object stores have no atomic rename, so payload_ref is committed only after the shard is
+// confirmed written; there is no post-commit promote):
+//   1. load the run's not-yet-compacted terminal rows
+//   2. write each shard to a generation-exclusive key …/run_result_shard/{sourceId}/gen{G}/shard-{seq}
+//   3. single-transaction UPDATE: set payload_ref + compaction_generation + previews, clear inline
+// A re-run rewrites the not-yet-referenced gen{G} key region; it never overwrites a committed
+// generation. When object storage is disabled this is a no-op, so OSS behaviour is unchanged.
+const common_1 = require("@nestjs/common");
+const drizzle_orm_1 = require("drizzle-orm");
+const database_constants_1 = require("../../../shared/database/database.constants");
+const object_storage_provider_1 = require("../../common/contracts/object-storage.provider");
+const run_result_compaction_1 = require("./run-result-compaction");
+const run_result_payload_1 = require("./run-result-payload");
+const CODEC = 'gzip';
+const SHARD_EXT = '.jsonl.gz';
+const DEFAULT_MAX_ROWS_PER_SHARD = 2000;
+exports.RUN_RESULT_COMPACTION_STORE = Symbol('RUN_RESULT_COMPACTION_STORE');
+let RunResultCompactor = class RunResultCompactor {
+    constructor(store, storage) {
+        this.store = store;
+        this.storage = storage;
+        this.maxRowsPerShard = DEFAULT_MAX_ROWS_PER_SHARD;
+    }
+    async compact(target) {
+        if (!this.storage.isEnabled())
+            return { compactedRows: 0, shards: 0, generation: null };
+        const rows = await this.store.loadUncompacted(target);
+        if (rows.length === 0)
+            return { compactedRows: 0, shards: 0, generation: null };
+        const generation = await this.store.nextGeneration(target.sourceId);
+        const plan = (0, run_result_compaction_1.planCompaction)(rows, (0, run_result_compaction_1.offloadFieldsForSource)(target.source), this.maxRowsPerShard);
+        const shardRefs = [];
+        for (const shard of plan.shards) {
+            const body = await (0, run_result_payload_1.encodeShard)(shard.lines, CODEC);
+            const ref = await this.storage.putObject({
+                project: { projectId: target.projectId, source: 'local' },
+                resourceType: 'run_result_shard',
+                resourceId: target.sourceId,
+                name: shardName(generation, shard.seq),
+            }, body, { codec: CODEC });
+            shardRefs[shard.seq] = { ...ref, version: generation };
+        }
+        await this.store.commit({
+            assignments: plan.assignments,
+            shardRefs,
+            generation,
+            clearedFields: plan.clearedFields,
+        });
+        return { compactedRows: plan.assignments.length, shards: plan.shards.length, generation };
+    }
+    /**
+     * Periodic compaction for sources with no finalize step (e.g. `online`): finds (project, source,
+     * sourceId) groups with rows still inline and compacts each. SPEC 30 §9.3. A no-op when storage is
+     * disabled. Callers schedule this; it compacts at most `maxGroups` groups per run so a sweep is bounded.
+     */
+    async compactPending(sources, maxGroups = 50) {
+        if (!this.storage.isEnabled() || sources.length === 0)
+            return { groups: 0, compactedRows: 0 };
+        const groups = await this.store.findPendingGroups(sources, maxGroups);
+        let compactedRows = 0;
+        for (const group of groups) {
+            const result = await this.compact(group);
+            compactedRows += result.compactedRows;
+        }
+        return { groups: groups.length, compactedRows };
+    }
+};
+exports.RunResultCompactor = RunResultCompactor;
+exports.RunResultCompactor = RunResultCompactor = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(exports.RUN_RESULT_COMPACTION_STORE)),
+    __metadata("design:paramtypes", [Object, object_storage_provider_1.ObjectStorageProvider])
+], RunResultCompactor);
+function shardName(generation, seq) {
+    return `gen${generation}/shard-${String(seq).padStart(5, '0')}${SHARD_EXT}`;
+}
+const CLEAR_COLUMN_SQL = {
+    renderedPrompt: (0, drizzle_orm_1.sql) `rendered_prompt = NULL`,
+    inputVariables: (0, drizzle_orm_1.sql) `input_variables = NULL`,
+    rawResponse: (0, drizzle_orm_1.sql) `raw_response = NULL`,
+    parsedOutput: (0, drizzle_orm_1.sql) `parsed_output = NULL`,
+};
+let DrizzleRunResultCompactionStore = class DrizzleRunResultCompactionStore {
+    constructor(db) {
+        this.db = db;
+    }
+    async nextGeneration(sourceId) {
+        const result = await this.db.execute((0, drizzle_orm_1.sql) `
+      SELECT COALESCE(MAX(compaction_generation), 0) + 1 AS next
+      FROM ph_runs.run_results
+      WHERE source_id = ${sourceId}::uuid
+    `);
+        const next = unwrapRows(result)[0]?.next;
+        return next == null ? 1 : Number(next);
+    }
+    async findPendingGroups(sources, limit) {
+        if (sources.length === 0)
+            return [];
+        const result = await this.db.execute((0, drizzle_orm_1.sql) `
+      SELECT DISTINCT project_id, source, source_id
+      FROM ph_runs.run_results
+      WHERE source IN (${drizzle_orm_1.sql.join(sources.map((s) => (0, drizzle_orm_1.sql) `${s}`), (0, drizzle_orm_1.sql) `, `)})
+        AND payload_ref IS NULL
+        AND status IN ('success', 'failed')
+      LIMIT ${limit}
+    `);
+        return unwrapRows(result).map((r) => ({
+            projectId: r.project_id,
+            source: r.source,
+            sourceId: r.source_id,
+        }));
+    }
+    async loadUncompacted(target) {
+        const result = await this.db.execute((0, drizzle_orm_1.sql) `
+      SELECT id, created_at, rendered_prompt, input_variables, raw_response, parsed_output, decision_output
+      FROM ph_runs.run_results
+      WHERE source = ${target.source}
+        AND source_id = ${target.sourceId}::uuid
+        AND payload_ref IS NULL
+        AND status IN ('success', 'failed')
+      ORDER BY created_at ASC, id ASC
+    `);
+        return unwrapRows(result).map((r) => ({
+            id: r.id,
+            createdAt: r.created_at,
+            renderedPrompt: r.rendered_prompt,
+            inputVariables: r.input_variables,
+            rawResponse: r.raw_response,
+            parsedOutput: r.parsed_output,
+            decisionOutput: r.decision_output,
+        }));
+    }
+    async commit({ assignments, shardRefs, generation, clearedFields }) {
+        if (assignments.length === 0)
+            return;
+        const valueRows = assignments.map((a) => {
+            const payloadRef = JSON.stringify({ shard: shardRefs[a.shardSeq], rowIndex: a.rowIndex });
+            return (0, drizzle_orm_1.sql) `(${a.id}::uuid, ${toIso(a.createdAt)}::timestamptz, ${payloadRef}::jsonb, ${a.inputPreview}::text, ${a.outputPreview}::text)`;
+        });
+        const clears = clearedFields.map((f) => CLEAR_COLUMN_SQL[f]);
+        const clearClause = clears.length > 0 ? (0, drizzle_orm_1.sql) `, ${drizzle_orm_1.sql.join(clears, (0, drizzle_orm_1.sql) `, `)}` : (0, drizzle_orm_1.sql) ``;
+        // Single statement = atomic: at commit, every payload_ref points at an already-written shard.
+        await this.db.execute((0, drizzle_orm_1.sql) `
+      UPDATE ph_runs.run_results AS rr
+      SET payload_ref = v.payload_ref,
+          compaction_generation = ${generation},
+          input_preview = v.input_preview,
+          output_preview = v.output_preview${clearClause}
+      FROM (VALUES ${drizzle_orm_1.sql.join(valueRows, (0, drizzle_orm_1.sql) `, `)}) AS v(id, created_at, payload_ref, input_preview, output_preview)
+      WHERE rr.id = v.id AND rr.created_at = v.created_at
+    `);
+    }
+};
+exports.DrizzleRunResultCompactionStore = DrizzleRunResultCompactionStore;
+exports.DrizzleRunResultCompactionStore = DrizzleRunResultCompactionStore = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(database_constants_1.DATABASE_CLIENT)),
+    __metadata("design:paramtypes", [Object])
+], DrizzleRunResultCompactionStore);
+function toIso(value) {
+    return value instanceof Date ? value.toISOString() : new Date(value).toISOString();
+}
+function unwrapRows(result) {
+    if (Array.isArray(result))
+        return result;
+    if (result && typeof result === 'object' && 'rows' in result) {
+        return result.rows ?? [];
+    }
+    return [];
+}
+//# sourceMappingURL=run-result-compactor.js.map

package/dist/server/modules/run-result/run-result-compactor.js.map

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

package/dist/server/modules/run-result/run-result-payload.d.ts

@@ -0,0 +1,30 @@
+import { Buffer } from 'node:buffer';
+import type { ObjectCodec, StoredObjectRef } from '../../common/contracts/object-storage.provider';
+/** The four large fields that tier out of `run_results`. `null` = absent / genuinely empty. */
+export interface RunResultPayloadFields {
+    renderedPrompt: unknown;
+    inputVariables: unknown;
+    rawResponse: string | null;
+    parsedOutput: unknown;
+}
+/** One JSONL line in a shard. A source only offloads some fields (SPEC 30 §9.4), so all optional. */
+export type RunResultShardLine = Partial<RunResultPayloadFields>;
+/** Stored in `run_results.payload_ref`: the shard holding this row + which line it is. */
+export interface RunResultPayloadRef {
+    shard: StoredObjectRef;
+    rowIndex: number;
+}
+/** Minimal row shape the reader consumes: the inline (possibly-null) fields + the pointer. */
+export interface RunResultPayloadRow extends RunResultPayloadFields {
+    payloadRef: RunResultPayloadRef | null;
+}
+/** Pick only the offloadable fields off a wider row, defaulting missing ones to null. */
+export declare function pickPayloadFields(row: Partial<RunResultPayloadFields>): RunResultPayloadFields;
+/** Keep only the fields a source actually offloads; drops the rest so they are not double-stored. */
+export declare function shardLineForFields(fields: RunResultPayloadFields, offload: ReadonlyArray<keyof RunResultPayloadFields>): RunResultShardLine;
+/** Encode shard lines into compressed JSONL bytes (the object body a compactor writes). Generic so
+ *  dataset-sample shards (one data object per line) reuse the same codec as run-result shards. */
+export declare function encodeShard<T>(lines: T[], codec: ObjectCodec): Promise<Buffer>;
+/** Decode a shard body back into its lines (used by the readers). */
+export declare function decodeShard<T = RunResultShardLine>(body: Buffer, codec: ObjectCodec | undefined): Promise<T[]>;
+//# sourceMappingURL=run-result-payload.d.ts.map

package/dist/server/modules/run-result/run-result-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-result-payload.d.ts","sourceRoot":"","sources":["../../../../src/server/modules/run-result/run-result-payload.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAOnG,+FAA+F;AAC/F,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,qGAAqG;AACrG,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAEjE,0FAA0F;AAC1F,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,8FAA8F;AAC9F,MAAM,WAAW,mBAAoB,SAAQ,sBAAsB;IACjE,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACxC;AASD,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,sBAAsB,CAO9F;AAED,qGAAqG;AACrG,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,aAAa,CAAC,MAAM,sBAAsB,CAAC,GACnD,kBAAkB,CAQpB;AA4BD;kGACkG;AAClG,wBAAsB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAGpF;AAED,qEAAqE;AACrE,wBAAsB,WAAW,CAAC,CAAC,GAAG,kBAAkB,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAIpH"}

package/dist/server/modules/run-result/run-result-payload.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pickPayloadFields = pickPayloadFields;
+exports.shardLineForFields = shardLineForFields;
+exports.encodeShard = encodeShard;
+exports.decodeShard = decodeShard;
+// Run-result large-payload tiering — shared shard format + codec (SPEC 30 §9).
+//
+// When object storage is configured, a run's four large fields are compacted into a compressed
+// JSONL shard: one line per row, each line the offloaded fields of that row. The row keeps a
+// `payload_ref` ({ shard, rowIndex }) so any reader can resolve a field back. The reader
+// (run-result-payload.reader.ts) and the compactor (run-result-compactor.ts) both speak this format.
+const node_buffer_1 = require("node:buffer");
+const node_util_1 = require("node:util");
+const node_zlib_1 = require("node:zlib");
+const gzipAsync = (0, node_util_1.promisify)(node_zlib_1.gzip);
+const gunzipAsync = (0, node_util_1.promisify)(node_zlib_1.gunzip);
+const brotliCompressAsync = (0, node_util_1.promisify)(node_zlib_1.brotliCompress);
+const brotliDecompressAsync = (0, node_util_1.promisify)(node_zlib_1.brotliDecompress);
+const PAYLOAD_FIELDS = [
+    'renderedPrompt',
+    'inputVariables',
+    'rawResponse',
+    'parsedOutput',
+];
+/** Pick only the offloadable fields off a wider row, defaulting missing ones to null. */
+function pickPayloadFields(row) {
+    return {
+        renderedPrompt: row.renderedPrompt ?? null,
+        inputVariables: row.inputVariables ?? null,
+        rawResponse: row.rawResponse ?? null,
+        parsedOutput: row.parsedOutput ?? null,
+    };
+}
+/** Keep only the fields a source actually offloads; drops the rest so they are not double-stored. */
+function shardLineForFields(fields, offload) {
+    const line = {};
+    for (const key of PAYLOAD_FIELDS) {
+        if (offload.includes(key)) {
+            line[key] = fields[key] ?? null;
+        }
+    }
+    return line;
+}
+async function compress(buf, codec) {
+    switch (codec) {
+        case 'gzip':
+            return gzipAsync(buf);
+        case 'br':
+            return brotliCompressAsync(buf);
+        case 'identity':
+            return buf;
+        default:
+            throw new Error(`unsupported shard codec for write: ${codec}`);
+    }
+}
+async function decompress(buf, codec) {
+    switch (codec ?? 'identity') {
+        case 'gzip':
+            return gunzipAsync(buf);
+        case 'br':
+            return brotliDecompressAsync(buf);
+        case 'identity':
+            return buf;
+        default:
+            throw new Error(`unsupported shard codec for read: ${codec}`);
+    }
+}
+/** Encode shard lines into compressed JSONL bytes (the object body a compactor writes). Generic so
+ *  dataset-sample shards (one data object per line) reuse the same codec as run-result shards. */
+async function encodeShard(lines, codec) {
+    const jsonl = lines.map((line) => JSON.stringify(line)).join('\n');
+    return compress(node_buffer_1.Buffer.from(jsonl, 'utf8'), codec);
+}
+/** Decode a shard body back into its lines (used by the readers). */
+async function decodeShard(body, codec) {
+    const text = (await decompress(body, codec)).toString('utf8');
+    if (text.length === 0)
+        return [];
+    return text.split('\n').map((line) => (line.length === 0 ? {} : JSON.parse(line)));
+}
+//# sourceMappingURL=run-result-payload.js.map

package/dist/server/modules/run-result/run-result-payload.js.map

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

package/dist/server/modules/run-result/run-result-payload.reader.d.ts

@@ -0,0 +1,20 @@
+import { ObjectStorageProvider } from '../../common/contracts/object-storage.provider';
+import { type RunResultPayloadFields, type RunResultPayloadRow } from './run-result-payload';
+export declare class RunResultPayloadReader {
+    private readonly storage;
+    constructor(storage: ObjectStorageProvider);
+    /** Resolve all four fields for one row, fetching its shard at most once. */
+    hydrate(row: RunResultPayloadRow): Promise<RunResultPayloadFields>;
+    /**
+     * Batch variant: groups rows by shard object so each shard is fetched exactly once. The dominant
+     * pattern (a page / batch of rows from one run) shares a shard, so this is one GET, not one per row.
+     */
+    hydrateMany(rows: RunResultPayloadRow[]): Promise<RunResultPayloadFields[]>;
+    readRenderedPrompt(row: RunResultPayloadRow): Promise<unknown>;
+    readInputVariables(row: RunResultPayloadRow): Promise<unknown>;
+    readRawResponse(row: RunResultPayloadRow): Promise<string | null>;
+    readParsedOutput(row: RunResultPayloadRow): Promise<unknown>;
+    private needsShard;
+    private loadShardLine;
+}
+//# sourceMappingURL=run-result-payload.reader.d.ts.map

package/dist/server/modules/run-result/run-result-payload.reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-result-payload.reader.d.ts","sourceRoot":"","sources":["../../../../src/server/modules/run-result/run-result-payload.reader.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,qBAAqB,EAAwB,MAAM,gDAAgD,CAAC;AAC7G,OAAO,EACL,KAAK,sBAAsB,EAE3B,KAAK,mBAAmB,EAIzB,MAAM,sBAAsB,CAAC;AAE9B,qBACa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,qBAAqB;IAE3D,4EAA4E;IACtE,OAAO,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAMxE;;;OAGG;IACG,WAAW,CAAC,IAAI,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAwB3E,kBAAkB,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9D,kBAAkB,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9D,eAAe,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIjE,gBAAgB,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlE,OAAO,CAAC,UAAU;YAIJ,aAAa;CAI5B"}

package/dist/server/modules/run-result/run-result-payload.reader.js

@@ -0,0 +1,99 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RunResultPayloadReader = void 0;
+// RunResultPayloadReader — the single read seam for run-result large fields (SPEC 30 §9.2).
+//
+// Every detail / background read of rendered_prompt / input_variables / raw_response / parsed_output
+// goes through here. It returns the inline value when present (a fresh row, a not-offloaded field, or
+// a small-row cache) and otherwise reads the row's shard. When object storage is disabled or the row
+// has no payload_ref, it is a pure pass-through of the inline fields, so behaviour is unchanged on an
+// OSS deployment with no storage configured.
+const common_1 = require("@nestjs/common");
+const object_storage_provider_1 = require("../../common/contracts/object-storage.provider");
+const run_result_payload_1 = require("./run-result-payload");
+let RunResultPayloadReader = class RunResultPayloadReader {
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /** Resolve all four fields for one row, fetching its shard at most once. */
+    async hydrate(row) {
+        if (!this.needsShard(row))
+            return (0, run_result_payload_1.pickPayloadFields)(row);
+        const line = await this.loadShardLine(row.payloadRef);
+        return mergeInlineOverShard(row, line);
+    }
+    /**
+     * Batch variant: groups rows by shard object so each shard is fetched exactly once. The dominant
+     * pattern (a page / batch of rows from one run) shares a shard, so this is one GET, not one per row.
+     */
+    async hydrateMany(rows) {
+        const out = rows.map((row) => (0, run_result_payload_1.pickPayloadFields)(row));
+        const byShard = new Map();
+        rows.forEach((row, index) => {
+            if (!this.needsShard(row))
+                return;
+            const pref = row.payloadRef;
+            const key = shardKey(pref.shard);
+            const group = byShard.get(key);
+            if (group)
+                group.entries.push({ index, rowIndex: pref.rowIndex });
+            else
+                byShard.set(key, { shard: pref.shard, entries: [{ index, rowIndex: pref.rowIndex }] });
+        });
+        await Promise.all([...byShard.values()].map(async ({ shard, entries }) => {
+            const lines = await (0, run_result_payload_1.decodeShard)(await this.storage.getObject(shard), shard.codec);
+            for (const { index, rowIndex } of entries) {
+                const row = rows[index];
+                if (row)
+                    out[index] = mergeInlineOverShard(row, lines[rowIndex] ?? {});
+            }
+        }));
+        return out;
+    }
+    async readRenderedPrompt(row) {
+        return (await this.hydrate(row)).renderedPrompt;
+    }
+    async readInputVariables(row) {
+        return (await this.hydrate(row)).inputVariables;
+    }
+    async readRawResponse(row) {
+        return (await this.hydrate(row)).rawResponse;
+    }
+    async readParsedOutput(row) {
+        return (await this.hydrate(row)).parsedOutput;
+    }
+    needsShard(row) {
+        return row.payloadRef != null && this.storage.isEnabled();
+    }
+    async loadShardLine(ref) {
+        const lines = await (0, run_result_payload_1.decodeShard)(await this.storage.getObject(ref.shard), ref.shard.codec);
+        return lines[ref.rowIndex] ?? {};
+    }
+};
+exports.RunResultPayloadReader = RunResultPayloadReader;
+exports.RunResultPayloadReader = RunResultPayloadReader = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [object_storage_provider_1.ObjectStorageProvider])
+], RunResultPayloadReader);
+function shardKey(ref) {
+    return `${ref.provider}:${ref.bucket ?? ''}:${ref.key}`;
+}
+/** Inline value wins when present (not-offloaded field or small-row cache); else the shard's. */
+function mergeInlineOverShard(row, line) {
+    return {
+        renderedPrompt: row.renderedPrompt ?? line.renderedPrompt ?? null,
+        inputVariables: row.inputVariables ?? line.inputVariables ?? null,
+        rawResponse: row.rawResponse ?? line.rawResponse ?? null,
+        parsedOutput: row.parsedOutput ?? line.parsedOutput ?? null,
+    };
+}
+//# sourceMappingURL=run-result-payload.reader.js.map

package/dist/server/modules/run-result/run-result-payload.reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-result-payload.reader.js","sourceRoot":"","sources":["../../../../src/server/modules/run-result/run-result-payload.reader.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,4FAA4F;AAC5F,EAAE;AACF,qGAAqG;AACrG,sGAAsG;AACtG,qGAAqG;AACrG,sGAAsG;AACtG,6CAA6C;AAC7C,2CAA4C;AAC5C,4FAA6G;AAC7G,6DAO8B;AAGvB,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IACjC,YAA6B,OAA8B;QAA9B,YAAO,GAAP,OAAO,CAAuB;IAAG,CAAC;IAE/D,4EAA4E;IAC5E,KAAK,CAAC,OAAO,CAAC,GAAwB;QACpC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,IAAA,sCAAiB,EAAC,GAAG,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,UAAiC,CAAC,CAAC;QAC7E,OAAO,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CAAC,IAA2B;QAC3C,MAAM,GAAG,GAA6B,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,sCAAiB,EAAC,GAAG,CAAC,CAAC,CAAC;QAChF,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2F,CAAC;QACnH,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YAC1B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,OAAO;YAClC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAiC,CAAC;YACnD,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,KAAK;gBAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;;gBAC7D,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9F,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,GAAG,CACf,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE;YACrD,MAAM,KAAK,GAAG,MAAM,IAAA,gCAAW,EAAC,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAClF,KAAK,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,OAAO,EAAE,CAAC;gBAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;gBACxB,IAAI,GAAG;oBAAE,GAAG,CAAC,KAAK,CAAC,GAAG,oBAAoB,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;YACzE,CAAC;QACH,CAAC,CAAC,CACH,CAAC;QACF,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,GAAwB;QAC/C,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,GAAwB;QAC/C,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,GAAwB;QAC5C,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,GAAwB;QAC7C,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC;IAChD,CAAC;IAEO,UAAU,CAAC,GAAwB;QACzC,OAAO,GAAG,CAAC,UAAU,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;IAC5D,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,GAAwB;QAClD,MAAM,KAAK,GAAG,MAAM,IAAA,gCAAW,EAAC,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1F,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,CAAC;CACF,CAAA;AA9DY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,mBAAU,GAAE;qCAE2B,+CAAqB;GADhD,sBAAsB,CA8DlC;AAED,SAAS,QAAQ,CAAC,GAAoB;IACpC,OAAO,GAAG,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;AAC1D,CAAC;AAED,iGAAiG;AACjG,SAAS,oBAAoB,CAAC,GAAwB,EAAE,IAAwB;IAC9E,OAAO;QACL,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI;QACjE,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI;QACjE,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI;QACxD,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI;KAC5D,CAAC;AACJ,CAAC"}

package/dist/server/modules/run-result/run-result.controller.d.ts

@@ -26,6 +26,8 @@ export declare class RunResultController {
                 role: "image" | "expected_output" | "text" | "image_url" | "image_base64" | "metadata";
                 value: unknown;
             }[];
+            inputPreview: string | null;
+            outputPreview: string | null;
             inputVariables: unknown;
             rawResponse: string | null;
             parsedOutput: unknown;
@@ -63,6 +65,8 @@ export declare class RunResultController {
             role: "image" | "expected_output" | "text" | "image_url" | "image_base64" | "metadata";
             value: unknown;
         }[];
+        inputPreview: string | null;
+        outputPreview: string | null;
         errorClass: string | null;
         errorMessage: string | null;
         latencyMs: number | null;

package/dist/server/modules/run-result/run-result.controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-result.controller.d.ts","sourceRoot":"","sources":["../../../../src/server/modules/run-result/run-result.controller.ts"],"names":[],"mappings":"AAGA,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AAGtG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAIxD,qBAEa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,gBAAgB;IAGzD,iBAAiB,CACE,YAAY,EAAE,MAAM,EAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3B,KAAK,EAAE,kBAAkB,EACtB,OAAO,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAgBrC,MAAM,CACa,YAAY,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EAC1B,KAAK,EAAE,kBAAkB,EACtB,OAAO,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAe3C,OAAO,CAAC,iBAAiB;CAO1B;AAED,qBAEa,0BAA0B;IACzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,gBAAgB;IAGzD,cAAc,CACT,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3B,KAAK,EAAE,kBAAkB,EACtB,OAAO,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAS5C"}
+{"version":3,"file":"run-result.controller.d.ts","sourceRoot":"","sources":["../../../../src/server/modules/run-result/run-result.controller.ts"],"names":[],"mappings":"AAGA,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AAGtG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAIxD,qBAEa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,gBAAgB;IAGzD,iBAAiB,CACE,YAAY,EAAE,MAAM,EAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3B,KAAK,EAAE,kBAAkB,EACtB,OAAO,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAgBrC,MAAM,CACa,YAAY,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EAC1B,KAAK,EAAE,kBAAkB,EACtB,OAAO,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAe3C,OAAO,CAAC,iBAAiB;CAO1B;AAED,qBAEa,0BAA0B;IACzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,gBAAgB;IAGzD,cAAc,CACT,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3B,KAAK,EAAE,kBAAkB,EACtB,OAAO,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAS5C"}

package/dist/server/modules/run-result/run-result.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-result.module.d.ts","sourceRoot":"","sources":["../../../../src/server/modules/run-result/run-result.module.ts"],"names":[],"mappings":"AAMA,qBAMa,eAAe;CAAG"}
+{"version":3,"file":"run-result.module.d.ts","sourceRoot":"","sources":["../../../../src/server/modules/run-result/run-result.module.ts"],"names":[],"mappings":"AASA,qBAea,eAAe;CAAG"}

package/dist/server/modules/run-result/run-result.module.js

@@ -9,6 +9,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.RunResultModule = void 0;
 const common_1 = require("@nestjs/common");
 const database_module_1 = require("../../../shared/database/database.module");
+const run_result_compaction_sweeper_1 = require("./run-result-compaction-sweeper");
+const run_result_compactor_1 = require("./run-result-compactor");
+const run_result_payload_reader_1 = require("./run-result-payload.reader");
 const run_result_controller_1 = require("./run-result.controller");
 const run_result_repository_1 = require("./run-result.repository");
 const run_result_service_1 = require("./run-result.service");
@@ -19,8 +22,17 @@ exports.RunResultModule = RunResultModule = __decorate([
     (0, common_1.Module)({
         imports: [database_module_1.DatabaseModule],
         controllers: [run_result_controller_1.RunResultController, run_result_controller_1.ReleaseRunResultController],
-        providers: [run_result_repository_1.RunResultRepository, run_result_service_1.RunResultService],
-        exports: [run_result_service_1.RunResultService],
+        providers: [
+            run_result_repository_1.RunResultRepository,
+            run_result_service_1.RunResultService,
+            run_result_payload_reader_1.RunResultPayloadReader,
+            run_result_compactor_1.RunResultCompactor,
+            run_result_compaction_sweeper_1.RunResultCompactionSweeper,
+            { provide: run_result_compactor_1.RUN_RESULT_COMPACTION_STORE, useClass: run_result_compactor_1.DrizzleRunResultCompactionStore },
+        ],
+        // RunResultPayloadReader / RunResultCompactor are exported so other modules (experiment / optimization
+        // workflows, annotation, canary) can hydrate or compact without re-wiring the object-storage seam.
+        exports: [run_result_service_1.RunResultService, run_result_payload_reader_1.RunResultPayloadReader, run_result_compactor_1.RunResultCompactor],
     })
 ], RunResultModule);
 //# sourceMappingURL=run-result.module.js.map

package/dist/server/modules/run-result/run-result.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-result.module.js","sourceRoot":"","sources":["../../../../src/server/modules/run-result/run-result.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,8EAA0E;AAC1E,mEAA0F;AAC1F,mEAA8D;AAC9D,6DAAwD;AAQjD,IAAM,eAAe,GAArB,MAAM,eAAe;CAAG,CAAA;AAAlB,0CAAe;0BAAf,eAAe;IAN3B,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,gCAAc,CAAC;QACzB,WAAW,EAAE,CAAC,2CAAmB,EAAE,kDAA0B,CAAC;QAC9D,SAAS,EAAE,CAAC,2CAAmB,EAAE,qCAAgB,CAAC;QAClD,OAAO,EAAE,CAAC,qCAAgB,CAAC;KAC5B,CAAC;GACW,eAAe,CAAG"}
+{"version":3,"file":"run-result.module.js","sourceRoot":"","sources":["../../../../src/server/modules/run-result/run-result.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,8EAA0E;AAC1E,mFAA6E;AAC7E,iEAA0H;AAC1H,2EAAqE;AACrE,mEAA0F;AAC1F,mEAA8D;AAC9D,6DAAwD;AAiBjD,IAAM,eAAe,GAArB,MAAM,eAAe;CAAG,CAAA;AAAlB,0CAAe;0BAAf,eAAe;IAf3B,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,gCAAc,CAAC;QACzB,WAAW,EAAE,CAAC,2CAAmB,EAAE,kDAA0B,CAAC;QAC9D,SAAS,EAAE;YACT,2CAAmB;YACnB,qCAAgB;YAChB,kDAAsB;YACtB,yCAAkB;YAClB,0DAA0B;YAC1B,EAAE,OAAO,EAAE,kDAA2B,EAAE,QAAQ,EAAE,sDAA+B,EAAE;SACpF;QACD,uGAAuG;QACvG,mGAAmG;QACnG,OAAO,EAAE,CAAC,qCAAgB,EAAE,kDAAsB,EAAE,yCAAkB,CAAC;KACxE,CAAC;GACW,eAAe,CAAG"}

package/dist/server/modules/run-result/run-result.repository.d.ts

@@ -1,6 +1,7 @@
 import type { DbClient } from '@proofhound/db';
 import type { ClassificationAggregateRow } from '@proofhound/metrics';
 import type { RunResultDetailDto, RunResultListQueryDto, RunResultListResponseDto, RunResultReleaseListQueryDto, ReleaseRunResultListResponseDto } from '@proofhound/shared';
+import { RunResultPayloadReader } from './run-result-payload.reader';
 export interface BatchTerminalCounts {
     terminalCount: number;
     failedCount: number;
@@ -11,7 +12,8 @@ export interface ExperimentAccessRow {
 }
 export declare class RunResultRepository {
     private readonly db;
-    constructor(db: DbClient);
+    private readonly payloadReader;
+    constructor(db: DbClient, payloadReader: RunResultPayloadReader);
     aggregateExperimentLatency(experimentId: string): Promise<{
         averageMs: number | null;
         p50Ms: number | null;

package/dist/server/modules/run-result/run-result.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-result.repository.d.ts","sourceRoot":"","sources":["../../../../src/server/modules/run-result/run-result.repository.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,0BAA0B,EAA6B,MAAM,qBAAqB,CAAC;AACjG,OAAO,KAAK,EAGV,kBAAkB,EAGlB,qBAAqB,EACrB,wBAAwB,EACxB,4BAA4B,EAI5B,+BAA+B,EAChC,MAAM,oBAAoB,CAAC;AAI5B,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBACa,mBAAmB;IACO,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ;IAE5D,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;QAC9D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KACtB,CAAC;IA6BI,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,EAAE,CAAC;IAyChF,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA8B9F,wBAAwB,CAC5B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,OAAO,GACrB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IA2BhC,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IA0GvG,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,+BAA+B,CAAC;IAwJrC,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;CA+CnG"}
+{"version":3,"file":"run-result.repository.d.ts","sourceRoot":"","sources":["../../../../src/server/modules/run-result/run-result.repository.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,0BAA0B,EAA6B,MAAM,qBAAqB,CAAC;AACjG,OAAO,KAAK,EAGV,kBAAkB,EAGlB,qBAAqB,EACrB,wBAAwB,EACxB,4BAA4B,EAI5B,+BAA+B,EAChC,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBACa,mBAAmB;IAEH,OAAO,CAAC,QAAQ,CAAC,EAAE;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa;gBADY,EAAE,EAAE,QAAQ,EACrC,aAAa,EAAE,sBAAsB;IAGlD,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;QAC9D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KACtB,CAAC;IA6BI,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,EAAE,CAAC;IAyChF,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA8B9F,wBAAwB,CAC5B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,OAAO,GACrB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IA2BhC,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IA+GvG,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,+BAA+B,CAAC;IAiLrC,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;CA+DnG"}