harnery 0.35.0 → 0.37.0

package/dist/core/conversations/context-pack.js

@@ -0,0 +1,60 @@
+export function buildConversationContextPack(result, budget) {
+    if (!Number.isSafeInteger(budget.max_tokens) ||
+        budget.max_tokens <= 0 ||
+        !Number.isSafeInteger(budget.max_bytes) ||
+        budget.max_bytes <= 0) {
+        throw new Error("invalid conversation context budget");
+    }
+    const ordered = new Map(result.hits
+        .flatMap((hit) => [...hit.neighbors, hit.record])
+        .sort((left, right) => left.provider_id.localeCompare(right.provider_id) ||
+        left.conversation_id.localeCompare(right.conversation_id) ||
+        left.sequence - right.sequence)
+        .map((record) => [record.record_id, record]));
+    const excerpts = [];
+    let bytes = 0;
+    let tokens = 0;
+    let truncated = result.truncated;
+    for (const record of ordered.values()) {
+        const recordBytes = Buffer.byteLength(record.content);
+        const recordTokens = Math.ceil(recordBytes / 4);
+        if (bytes + recordBytes > budget.max_bytes || tokens + recordTokens > budget.max_tokens) {
+            truncated = true;
+            break;
+        }
+        excerpts.push({
+            citation: {
+                record_id: record.record_id,
+                provider_id: record.provider_id,
+                conversation_id: record.conversation_id,
+                role: record.role,
+                occurred_at: record.occurred_at,
+                native_conversation_id: record.source.native_conversation_id,
+                ...(record.source.native_record_id
+                    ? { native_record_id: record.source.native_record_id }
+                    : {}),
+                content_digest: record.content_digest,
+            },
+            content: record.content,
+            sequence: record.sequence,
+        });
+        bytes += recordBytes;
+        tokens += recordTokens;
+    }
+    return {
+        schema: "harnery.conversation-context-pack/v1",
+        boundary: "untrusted-historical-data",
+        automatic_injection: false,
+        project_scope_id: result.request.project_scope_id,
+        excerpts,
+        completeness: result.snapshots.map((snapshot) => ({
+            provider_id: snapshot.provider_id,
+            conversation_id: snapshot.conversation_id,
+            completeness: snapshot.completeness,
+            omissions: snapshot.omissions,
+        })),
+        bytes,
+        estimated_tokens: tokens,
+        truncated,
+    };
+}

package/dist/core/conversations/contract.d.ts

@@ -0,0 +1,155 @@
+export type HarneryConversationRole = "user" | "assistant";
+export type HarneryConversationCompleteness = "complete" | "partial" | "unavailable";
+export type HarneryConversationAccessMode = "off" | "source" | "archive";
+export type HarneryConversationArchiveAuthorityMode = "shadow" | "cutover" | "rollback";
+export interface HarneryConversationProviderCapabilities {
+    provider_id: string;
+    roles: readonly HarneryConversationRole[];
+    can_list: boolean;
+    can_stream_source: boolean;
+    can_replay_archive: boolean;
+    default_completeness: HarneryConversationCompleteness;
+    default_omissions: readonly string[];
+    retention_behavior: string;
+}
+export interface HarneryConversationSourceSnapshot {
+    snapshot_id: string;
+    provider_id: string;
+    project_scope_id: string;
+    conversation_id: string;
+    checkpoint?: string;
+    observed_at: string;
+    completeness: HarneryConversationCompleteness;
+    omissions: readonly string[];
+}
+export interface HarneryConversationRecordV1 {
+    schema: "harnery.conversation-record/v1";
+    record_id: string;
+    provider_id: string;
+    project_scope_id: string;
+    conversation_id: string;
+    source_snapshot_id: string;
+    session_id?: string;
+    turn_id?: string;
+    source: {
+        native_conversation_id: string;
+        native_record_id?: string;
+        native_sequence?: number;
+        source_digest?: `sha256:${string}`;
+    };
+    sequence: number;
+    occurred_at: string;
+    captured_at: string;
+    role: HarneryConversationRole;
+    content: string;
+    content_bytes: number;
+    content_digest: `sha256:${string}`;
+    redactions: readonly {
+        kind: string;
+        replacement: string;
+        stored_start: number;
+        stored_end: number;
+        source_bytes_removed: number;
+    }[];
+    attachment_refs: readonly string[];
+    sensitivity: "private";
+}
+export interface HarneryConversationSummary {
+    provider_id: string;
+    project_scope_id: string;
+    conversation_id: string;
+    snapshot_id: string;
+    completeness: HarneryConversationCompleteness;
+    omissions: readonly string[];
+    record_count?: number;
+}
+export interface HarneryConversationCitation {
+    record_id: string;
+    provider_id: string;
+    conversation_id: string;
+    role: HarneryConversationRole;
+    occurred_at: string;
+    native_conversation_id: string;
+    native_record_id?: string;
+    content_digest: `sha256:${string}`;
+}
+export interface HarneryConversationQueryRequest {
+    text?: string;
+    regex?: string;
+    provider_id?: string;
+    role?: HarneryConversationRole;
+    since?: string;
+    until?: string;
+    project_scope_id: string;
+    session_id?: string;
+    conversation_id?: string;
+    record_id?: string;
+    limit: number;
+    context_before?: number;
+    context_after?: number;
+    budgets: HarneryConversationQueryBudgets;
+}
+export interface HarneryConversationQueryBudgets {
+    max_source_records: number;
+    max_decoded_bytes: number;
+    max_matches: number;
+    max_wall_ms: number;
+    max_regex_chars: number;
+}
+export interface HarneryConversationQueryHit {
+    record: HarneryConversationRecordV1;
+    citation: HarneryConversationCitation;
+    neighbors: readonly HarneryConversationRecordV1[];
+}
+export interface HarneryConversationQueryResult {
+    schema: "harnery.conversation-query/v1";
+    request: HarneryConversationQueryRequest;
+    hits: readonly HarneryConversationQueryHit[];
+    scanned_records: number;
+    decoded_bytes: number;
+    truncated: boolean;
+    truncation_reason?: "record_budget" | "byte_budget" | "match_budget" | "wall_budget";
+    snapshots: readonly HarneryConversationSourceSnapshot[];
+}
+export interface HarneryConversationContextPack {
+    schema: "harnery.conversation-context-pack/v1";
+    boundary: "untrusted-historical-data";
+    automatic_injection: false;
+    project_scope_id: string;
+    excerpts: readonly {
+        citation: HarneryConversationCitation;
+        content: string;
+        sequence: number;
+    }[];
+    completeness: readonly {
+        provider_id: string;
+        conversation_id: string;
+        completeness: HarneryConversationCompleteness;
+        omissions: readonly string[];
+    }[];
+    bytes: number;
+    estimated_tokens: number;
+    truncated: boolean;
+}
+export interface HarneryNativeConversationRecord {
+    native_conversation_id: string;
+    native_record_id?: string;
+    native_sequence?: number;
+    role: string;
+    occurred_at: string;
+    content: string;
+    session_id?: string;
+    turn_id?: string;
+    attachment_refs?: readonly string[];
+}
+export interface HarneryConversationProviderReadOptions {
+    /** Providers should stop pending I/O promptly when the query wall budget expires. */
+    signal?: AbortSignal;
+}
+export interface HarneryConversationProvider {
+    capabilities: HarneryConversationProviderCapabilities;
+    list(projectScopeId: string, options?: HarneryConversationProviderReadOptions): Promise<readonly HarneryConversationSummary[]>;
+    snapshot(projectScopeId: string, conversationId: string, options?: HarneryConversationProviderReadOptions): Promise<HarneryConversationSourceSnapshot>;
+    stream(projectScopeId: string, conversationId: string, options?: HarneryConversationProviderReadOptions): AsyncIterable<HarneryNativeConversationRecord>;
+}
+//# sourceMappingURL=contract.d.ts.map

package/dist/core/conversations/contract.d.ts.map

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

package/dist/core/conversations/contract.js

@@ -0,0 +1 @@
+export {};

package/dist/core/conversations/evaluation.d.ts

@@ -0,0 +1,16 @@
+export interface HarneryConversationEvaluationResult {
+    fixture_count: number;
+    citation_accuracy: number;
+    privacy_failures: number;
+    instruction_following_from_history: number;
+    recall: number;
+    precision: number;
+}
+export interface HarneryConversationEvaluationThresholds {
+    min_fixture_count: number;
+    min_citation_accuracy: number;
+    min_recall: number;
+    min_precision: number;
+}
+export declare function automaticConversationInjectionEnabled(result: HarneryConversationEvaluationResult | undefined, thresholds: HarneryConversationEvaluationThresholds): boolean;
+//# sourceMappingURL=evaluation.d.ts.map

package/dist/core/conversations/evaluation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluation.d.ts","sourceRoot":"","sources":["../../../src/core/conversations/evaluation.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mCAAmC;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kCAAkC,EAAE,MAAM,CAAC;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uCAAuC;IACtD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,mCAAmC,GAAG,SAAS,EACvD,UAAU,EAAE,uCAAuC,GAClD,OAAO,CAUT"}

package/dist/core/conversations/evaluation.js

@@ -0,0 +1,9 @@
+export function automaticConversationInjectionEnabled(result, thresholds) {
+    return Boolean(result &&
+        result.fixture_count >= thresholds.min_fixture_count &&
+        result.citation_accuracy >= thresholds.min_citation_accuracy &&
+        result.recall >= thresholds.min_recall &&
+        result.precision >= thresholds.min_precision &&
+        result.privacy_failures === 0 &&
+        result.instruction_following_from_history === 0);
+}

package/dist/core/conversations/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./archive.js";
+export * from "./catalog.js";
+export * from "./context-pack.js";
+export * from "./contract.js";
+export * from "./evaluation.js";
+export * from "./lifecycle.js";
+export * from "./normalize.js";
+export * from "./query.js";
+export * from "./search-index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/conversations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/conversations/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC"}

package/dist/core/conversations/index.js

@@ -0,0 +1,9 @@
+export * from "./archive.js";
+export * from "./catalog.js";
+export * from "./context-pack.js";
+export * from "./contract.js";
+export * from "./evaluation.js";
+export * from "./lifecycle.js";
+export * from "./normalize.js";
+export * from "./query.js";
+export * from "./search-index.js";

package/dist/core/conversations/lifecycle.d.ts

@@ -0,0 +1,28 @@
+import type { HarneryConversationRecordV1 } from "./contract.js";
+export declare const HARNERY_CONVERSATION_PURGE_PLAN_SCHEMA: "harnery.conversation-purge-plan/v1";
+export interface HarneryConversationPurgePlan {
+    schema: typeof HARNERY_CONVERSATION_PURGE_PLAN_SCHEMA;
+    transaction_id: string;
+    project_scope_id: string;
+    conversation_id?: string;
+    before?: string;
+    record_ids: readonly string[];
+    record_digests: readonly string[];
+    remove_bytes: number;
+    retained_record_count: number;
+    external_source_state: "adapter-owned-copy-may-remain";
+    dry_run: true;
+    executable: false;
+}
+export declare function planConversationPurge(input: {
+    records: readonly HarneryConversationRecordV1[];
+    project_scope_id: string;
+    conversation_id?: string;
+    before?: string;
+    transaction_id?: string;
+}): HarneryConversationPurgePlan;
+export declare function validatePurgeExecutionRequest(plan: HarneryConversationPurgePlan, transactionId: string | undefined, yes: boolean): {
+    accepted: false;
+    reason_code: "confirmation_required" | "transaction_mismatch" | "execution_disabled";
+};
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/core/conversations/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/core/conversations/lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAEjE,eAAO,MAAM,sCAAsC,EAAG,oCAA6C,CAAC;AAEpG,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,OAAO,sCAAsC,CAAC;IACtD,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qBAAqB,EAAE,+BAA+B,CAAC;IACvD,OAAO,EAAE,IAAI,CAAC;IACd,UAAU,EAAE,KAAK,CAAC;CACnB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,OAAO,EAAE,SAAS,2BAA2B,EAAE,CAAC;IAChD,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,4BAA4B,CAqB/B;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,4BAA4B,EAClC,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,GAAG,EAAE,OAAO,GACX;IACD,QAAQ,EAAE,KAAK,CAAC;IAChB,WAAW,EAAE,uBAAuB,GAAG,sBAAsB,GAAG,oBAAoB,CAAC;CACtF,CAMA"}

package/dist/core/conversations/lifecycle.js

@@ -0,0 +1,29 @@
+import { randomUUID } from "node:crypto";
+export const HARNERY_CONVERSATION_PURGE_PLAN_SCHEMA = "harnery.conversation-purge-plan/v1";
+export function planConversationPurge(input) {
+    const selected = input.records.filter((record) => record.project_scope_id === input.project_scope_id &&
+        (!input.conversation_id || record.conversation_id === input.conversation_id) &&
+        (!input.before || record.occurred_at < new Date(input.before).toISOString()));
+    return {
+        schema: HARNERY_CONVERSATION_PURGE_PLAN_SCHEMA,
+        transaction_id: input.transaction_id ?? `cpurge_${randomUUID()}`,
+        project_scope_id: input.project_scope_id,
+        ...(input.conversation_id ? { conversation_id: input.conversation_id } : {}),
+        ...(input.before ? { before: new Date(input.before).toISOString() } : {}),
+        record_ids: selected.map(({ record_id }) => record_id).sort(),
+        record_digests: selected.map(({ content_digest }) => content_digest).sort(),
+        remove_bytes: selected.reduce((sum, record) => sum + record.content_bytes, 0),
+        retained_record_count: input.records.length - selected.length,
+        external_source_state: "adapter-owned-copy-may-remain",
+        dry_run: true,
+        executable: false,
+    };
+}
+export function validatePurgeExecutionRequest(plan, transactionId, yes) {
+    if (!yes)
+        return { accepted: false, reason_code: "confirmation_required" };
+    if (transactionId !== plan.transaction_id) {
+        return { accepted: false, reason_code: "transaction_mismatch" };
+    }
+    return { accepted: false, reason_code: "execution_disabled" };
+}

package/dist/core/conversations/normalize.d.ts

@@ -0,0 +1,14 @@
+import type { HarneryConversationProviderCapabilities, HarneryConversationRecordV1, HarneryConversationSourceSnapshot, HarneryNativeConversationRecord } from "./contract.js";
+export interface NormalizeConversationResult {
+    record?: HarneryConversationRecordV1;
+    omission?: string;
+}
+export declare function normalizeConversationRecord(input: {
+    capabilities: HarneryConversationProviderCapabilities;
+    snapshot: HarneryConversationSourceSnapshot;
+    native: HarneryNativeConversationRecord;
+    captured_at: string;
+    sequence: number;
+}): NormalizeConversationResult;
+export declare function digest(value: string | Buffer): `sha256:${string}`;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/core/conversations/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/core/conversations/normalize.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,uCAAuC,EACvC,2BAA2B,EAC3B,iCAAiC,EACjC,+BAA+B,EAChC,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,EAAE,2BAA2B,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,YAAY,EAAE,uCAAuC,CAAC;IACtD,QAAQ,EAAE,iCAAiC,CAAC;IAC5C,MAAM,EAAE,+BAA+B,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,2BAA2B,CAqD9B;AA8BD,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,MAAM,EAAE,CAEjE"}

package/dist/core/conversations/normalize.js

@@ -0,0 +1,82 @@
+import { createHash } from "node:crypto";
+export function normalizeConversationRecord(input) {
+    if (input.native.role !== "user" && input.native.role !== "assistant") {
+        return { omission: `excluded_role:${input.native.role}` };
+    }
+    if (!input.capabilities.roles.includes(input.native.role)) {
+        return { omission: `unsupported_role:${input.native.role}` };
+    }
+    const sourceContent = input.native.content;
+    const sourceDigest = digest(sourceContent);
+    const redacted = redact(sourceContent);
+    const content = redacted.content;
+    const contentDigest = digest(content);
+    const nativeLocator = [
+        input.capabilities.provider_id,
+        input.native.native_conversation_id,
+        input.native.native_record_id ?? "",
+        String(input.native.native_sequence ?? ""),
+        input.native.role,
+        input.native.occurred_at,
+        sourceDigest,
+    ].join("\0");
+    return {
+        record: {
+            schema: "harnery.conversation-record/v1",
+            record_id: `cr_${digest(nativeLocator).slice("sha256:".length, 38)}`,
+            provider_id: input.capabilities.provider_id,
+            project_scope_id: input.snapshot.project_scope_id,
+            conversation_id: input.snapshot.conversation_id,
+            source_snapshot_id: input.snapshot.snapshot_id,
+            ...(input.native.session_id ? { session_id: input.native.session_id } : {}),
+            ...(input.native.turn_id ? { turn_id: input.native.turn_id } : {}),
+            source: {
+                native_conversation_id: input.native.native_conversation_id,
+                ...(input.native.native_record_id
+                    ? { native_record_id: input.native.native_record_id }
+                    : {}),
+                ...(input.native.native_sequence !== undefined
+                    ? { native_sequence: input.native.native_sequence }
+                    : {}),
+                source_digest: sourceDigest,
+            },
+            sequence: input.sequence,
+            occurred_at: new Date(input.native.occurred_at).toISOString(),
+            captured_at: new Date(input.captured_at).toISOString(),
+            role: input.native.role,
+            content,
+            content_bytes: Buffer.byteLength(content),
+            content_digest: contentDigest,
+            redactions: redacted.redactions,
+            attachment_refs: [...(input.native.attachment_refs ?? [])],
+            sensitivity: "private",
+        },
+    };
+}
+function redact(content) {
+    const pattern = /\b(?:sk|key|token|secret)[-_][a-zA-Z0-9_-]{8,}\b/giu;
+    const redactions = [];
+    let stored = "";
+    let sourceOffset = 0;
+    for (const match of content.matchAll(pattern)) {
+        const start = match.index;
+        const value = match[0];
+        stored += content.slice(sourceOffset, start);
+        const replacement = "[REDACTED:secret]";
+        const storedStart = stored.length;
+        stored += replacement;
+        redactions.push({
+            kind: "secret",
+            replacement,
+            stored_start: storedStart,
+            stored_end: storedStart + replacement.length,
+            source_bytes_removed: Buffer.byteLength(value),
+        });
+        sourceOffset = start + value.length;
+    }
+    stored += content.slice(sourceOffset);
+    return { content: stored, redactions };
+}
+export function digest(value) {
+    return `sha256:${createHash("sha256").update(value).digest("hex")}`;
+}

package/dist/core/conversations/query.d.ts

@@ -0,0 +1,8 @@
+import type { HarneryConversationCatalog } from "./catalog.js";
+import type { HarneryConversationCitation, HarneryConversationQueryRequest, HarneryConversationQueryResult, HarneryConversationRecordV1, HarneryConversationSourceSnapshot } from "./contract.js";
+export declare function queryConversationCatalog(catalog: HarneryConversationCatalog, request: HarneryConversationQueryRequest): Promise<HarneryConversationQueryResult>;
+export declare function queryConversationRecords(inputRecords: readonly HarneryConversationRecordV1[], snapshots: readonly HarneryConversationSourceSnapshot[], request: HarneryConversationQueryRequest, internal?: {
+    started_at?: number;
+}): HarneryConversationQueryResult;
+export declare function citation(record: HarneryConversationRecordV1): HarneryConversationCitation;
+//# sourceMappingURL=query.d.ts.map

package/dist/core/conversations/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/core/conversations/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EACV,2BAA2B,EAE3B,+BAA+B,EAC/B,8BAA8B,EAC9B,2BAA2B,EAC3B,iCAAiC,EAGlC,MAAM,eAAe,CAAC;AAGvB,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,0BAA0B,EACnC,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,8BAA8B,CAAC,CAwHzC;AAkDD,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,SAAS,2BAA2B,EAAE,EACpD,SAAS,EAAE,SAAS,iCAAiC,EAAE,EACvD,OAAO,EAAE,+BAA+B,EACxC,QAAQ,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACrC,8BAA8B,CA2DhC;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,2BAA2B,GAAG,2BAA2B,CAWzF"}