@raybase/core 0.0.1 → 0.3.3

package/dist/agent-transcript-pager.js

@@ -0,0 +1,210 @@
+import { normalizeUserTranscriptMessage } from "./agent-user-transcript.js";
+import { readAgentChapterArchive } from "./agent-chapter-archive.js";
+import { q } from "./sql.js";
+/**
+ * Backwards paging of a conversation's member-visible transcript into the
+ * chapter archive. The live tail is served from hot storage by the
+ * conversation Durable Object exactly as before; everything older is read
+ * through to the sha256-verified NDJSON objects each closed chapter archived.
+ * The archive stays the one canonical copy of old spans — nothing here writes
+ * hot storage or rewrites archive objects.
+ *
+ * Scope follows the in-room chapter tools: a reader who holds conversation
+ * access (owner of a direct thread, active room member) pages the whole
+ * conversation's chapters. Membership windows are a cross-conversation
+ * concern and do not arise on a single conversation's own surface.
+ */
+export const agentTranscriptPageDefaultLimit = 50;
+export const agentTranscriptPageMaxLimit = 200;
+/** Bounds R2 reads per page when a conversation has many tiny chapters. */
+export const agentTranscriptPageMaxChapters = 10;
+export function clampAgentTranscriptPageLimit(value) {
+    if (value === undefined || !Number.isFinite(value))
+        return agentTranscriptPageDefaultLimit;
+    return Math.max(1, Math.min(agentTranscriptPageMaxLimit, Math.floor(value)));
+}
+export function encodeAgentTranscriptCursor(cursor) {
+    return base64UrlEncode(JSON.stringify(cursor));
+}
+export function decodeAgentTranscriptCursor(value) {
+    try {
+        const parsed = JSON.parse(base64UrlDecode(value));
+        if (parsed.v !== 1)
+            return null;
+        if (typeof parsed.o !== "number" || !Number.isInteger(parsed.o) || parsed.o < 1)
+            return null;
+        if (parsed.l !== null && (typeof parsed.l !== "number" || !Number.isInteger(parsed.l) || parsed.l < 0)) {
+            return null;
+        }
+        return { v: 1, o: parsed.o, l: parsed.l };
+    }
+    catch {
+        return null;
+    }
+}
+async function loadPagerChapters(control, agentName, conversationId) {
+    return control.all(`SELECT "id", "ordinal", "title", "summary", "messageCount", "startedAt", "endedAt",
+            "firstMessageId", "lastMessageId", "archiveObjectKey", "archiveSha256",
+            "archiveBytes", "archivedAt", "archiveObligationAt"
+     FROM ${q("_agent_chapters")}
+     WHERE "agentName" = ? AND "conversationId" = ?
+     ORDER BY "ordinal" DESC`, [agentName, conversationId]);
+}
+/**
+ * Redaction wins over readability: while any chapter purge obligation is
+ * pending for this conversation, every chapter serves as a summary marker.
+ * Redaction rewrites are rare and drain quickly; briefly over-withholding is
+ * the safe side of the seam.
+ */
+async function conversationHasPendingChapterPurges(control, conversationId) {
+    const row = await control.first(`SELECT "id" FROM ${q("_agent_chapter_purges")} WHERE "conversationId" = ? LIMIT 1`, [conversationId]);
+    return Boolean(row);
+}
+/**
+ * Chapters cover prefix spans of the conversation while hot rows are its
+ * suffix, so a chapter whose boundary ids are all still hot has nothing the
+ * screen is missing. The first (newest-first) chapter that reaches past the
+ * hot tail is where backwards paging starts; overlap inside that boundary
+ * chapter is expected and the client drops duplicate ids on prepend.
+ */
+export async function summarizeOlderAgentTranscript(input) {
+    const chapters = await loadPagerChapters(input.control, input.agentName, input.conversationId);
+    for (const chapter of chapters) {
+        if (!chapterHasOlderContent(chapter, input.hotMessageIds))
+            continue;
+        return {
+            hasOlder: true,
+            nextCursor: encodeAgentTranscriptCursor({ v: 1, o: chapter.ordinal, l: null })
+        };
+    }
+    return { hasOlder: false, nextCursor: null };
+}
+function chapterHasOlderContent(chapter, hotMessageIds) {
+    if (chapter.messageCount === 0)
+        return false;
+    const fullyHot = Boolean(chapter.firstMessageId
+        && chapter.lastMessageId
+        && hotMessageIds.has(chapter.firstMessageId)
+        && hotMessageIds.has(chapter.lastMessageId));
+    return !fullyHot;
+}
+export async function pageArchivedAgentTranscript(input) {
+    const limit = clampAgentTranscriptPageLimit(input.limit);
+    const chapters = await loadPagerChapters(input.control, input.agentName, input.conversationId);
+    const withheld = await conversationHasPendingChapterPurges(input.control, input.conversationId);
+    // Collected newest-first while walking backwards; reversed before returning.
+    const collected = [];
+    const markers = [];
+    let itemBudget = limit;
+    let chaptersVisited = 0;
+    let nextCursor = null;
+    for (const chapter of chapters) {
+        if (chapter.ordinal > input.cursor.o)
+            continue;
+        if (itemBudget <= 0 || chaptersVisited >= agentTranscriptPageMaxChapters) {
+            nextCursor = { v: 1, o: chapter.ordinal, l: null };
+            break;
+        }
+        if (chapter.messageCount === 0)
+            continue;
+        chaptersVisited += 1;
+        const startLine = chapter.ordinal === input.cursor.o ? input.cursor.l : null;
+        if (withheld) {
+            markers.push(chapterMarker(chapter, "pending-rewrite"));
+            itemBudget -= 1;
+            continue;
+        }
+        if (!chapter.archiveObjectKey || !chapter.archivedAt || chapter.archiveObligationAt) {
+            markers.push(chapterMarker(chapter, "summary-only"));
+            itemBudget -= 1;
+            continue;
+        }
+        let lines;
+        try {
+            const ndjson = await readAgentChapterArchive(input.bucket, chapter);
+            lines = ndjson ? ndjson.trimEnd().split("\n") : [];
+        }
+        catch (error) {
+            console.warn(`Agent transcript pager could not read chapter ${chapter.id} (${input.agentName}/${input.conversationId})`, error);
+            markers.push(chapterMarker(chapter, "unavailable"));
+            itemBudget -= 1;
+            continue;
+        }
+        const end = startLine === null ? lines.length : Math.min(startLine, lines.length);
+        const take = Math.min(itemBudget, end);
+        const begin = end - take;
+        for (let index = end - 1; index >= begin; index -= 1) {
+            const projected = projectArchiveLine(chapter, lines[index], index, input.defaultUserId);
+            if (projected)
+                collected.push(projected);
+        }
+        itemBudget -= take;
+        if (begin > 0) {
+            nextCursor = { v: 1, o: chapter.ordinal, l: begin };
+            break;
+        }
+    }
+    return {
+        messages: collected.reverse(),
+        markers: markers.reverse(),
+        returned: collected.length,
+        hasOlder: nextCursor !== null,
+        nextCursor: nextCursor ? encodeAgentTranscriptCursor(nextCursor) : null
+    };
+}
+function chapterMarker(chapter, reason) {
+    return {
+        chapterId: chapter.id,
+        ordinal: chapter.ordinal,
+        title: chapter.title,
+        summary: chapter.summary,
+        messageCount: chapter.messageCount,
+        startedAt: chapter.startedAt,
+        endedAt: chapter.endedAt,
+        reason
+    };
+}
+/**
+ * Archive lines are the stored UI message objects (`raybaseArchiveV` stamped
+ * since 2026-08; absent means the same version 1 shape), so the projection is
+ * the exact one hot rows go through: role filter, hidden-kickoff filter,
+ * removal stubs, attachments. Author names are served as stored at write
+ * time — historically accurate, and rewritten with the archive on redaction —
+ * rather than re-resolved through app hooks.
+ */
+function projectArchiveLine(chapter, line, index, defaultUserId) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return null;
+    let parsed;
+    try {
+        const candidate = JSON.parse(trimmed);
+        if (!candidate || typeof candidate !== "object" || Array.isArray(candidate))
+            return null;
+        parsed = candidate;
+    }
+    catch {
+        console.warn(`Agent transcript pager skipped a malformed archive line in chapter ${chapter.id}`);
+        return null;
+    }
+    const createdAt = typeof parsed.createdAt === "string" && parsed.createdAt.trim()
+        ? parsed.createdAt
+        : chapter.startedAt;
+    const id = typeof parsed.id === "string" && parsed.id.trim() ? parsed.id : `${chapter.id}:${index}`;
+    return normalizeUserTranscriptMessage({ id, message: trimmed, created_at: createdAt }, defaultUserId);
+}
+function base64UrlEncode(value) {
+    const bytes = new TextEncoder().encode(value);
+    let binary = "";
+    for (const byte of bytes)
+        binary += String.fromCharCode(byte);
+    return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+function base64UrlDecode(value) {
+    const normalized = value.replace(/-/g, "+").replace(/_/g, "/");
+    const padded = normalized + "=".repeat((4 - (normalized.length % 4)) % 4);
+    const binary = atob(padded);
+    const bytes = Uint8Array.from(binary, (char) => char.charCodeAt(0));
+    return new TextDecoder().decode(bytes);
+}
+//# sourceMappingURL=agent-transcript-pager.js.map

package/dist/agent-transcript-pager.js.map

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

package/dist/agent-user-data-parts.d.ts

@@ -0,0 +1,20 @@
+import { type JsonSchemaObject } from "./json-schema.js";
+export declare const maxAgentUserDataPartsPerMessage = 8;
+export declare const maxAgentUserDataPartBytes: number;
+export declare const maxAgentUserDataBytesPerMessage: number;
+export type RaybaseAgentUserDataPartDefinition = {
+    schema: JsonSchemaObject;
+    /** UTF-8 byte limit for the canonical JSON value. Required and capped by Core. */
+    maxBytes: number;
+};
+export type RaybaseAgentUserDataPartsConfig = Partial<Record<`data-${string}`, RaybaseAgentUserDataPartDefinition>>;
+export declare function isReservedAgentDataPartType(type: string): boolean;
+export declare function isPotentialAgentUserDataPartType(type: unknown): type is string;
+export declare function isAgentUserDataPartType(type: unknown): type is `data-${string}`;
+export declare function validateAgentUserDataPartsConfig(agentName: string, value: RaybaseAgentUserDataPartsConfig | undefined): void;
+export declare function validateAgentUserDataPartValue(definition: RaybaseAgentUserDataPartDefinition, value: unknown, path?: string): {
+    value: unknown;
+    canonicalJson: string;
+    bytes: number;
+};
+//# sourceMappingURL=agent-user-data-parts.d.ts.map

package/dist/agent-user-data-parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-user-data-parts.d.ts","sourceRoot":"","sources":["../src/agent-user-data-parts.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE7E,eAAO,MAAM,+BAA+B,IAAI,CAAC;AACjD,eAAO,MAAM,yBAAyB,QAAY,CAAC;AACnD,eAAO,MAAM,+BAA+B,QAAY,CAAC;AAEzD,MAAM,MAAM,kCAAkC,GAAG;IAC/C,MAAM,EAAE,gBAAgB,CAAC;IACzB,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG,OAAO,CACnD,MAAM,CAAC,QAAQ,MAAM,EAAE,EAAE,kCAAkC,CAAC,CAC7D,CAAC;AAEF,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAE9E;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,QAAQ,MAAM,EAAE,CAE/E;AAED,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,+BAA+B,GAAG,SAAS,GACjD,IAAI,CA0BN;AAED,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,kCAAkC,EAC9C,KAAK,EAAE,OAAO,EACd,IAAI,SAAc,GACjB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAqB1D"}

package/dist/agent-user-data-parts.js

@@ -0,0 +1,161 @@
+import { stableJson } from "./internal.js";
+import { validateJsonSchema } from "./json-schema.js";
+export const maxAgentUserDataPartsPerMessage = 8;
+export const maxAgentUserDataPartBytes = 32 * 1024;
+export const maxAgentUserDataBytesPerMessage = 64 * 1024;
+export function isReservedAgentDataPartType(type) {
+    return type === "data-voice-note" || type === "data-raybase" || type.startsWith("data-raybase-");
+}
+export function isPotentialAgentUserDataPartType(type) {
+    return typeof type === "string" && type.startsWith("data-") && !isReservedAgentDataPartType(type);
+}
+export function isAgentUserDataPartType(type) {
+    return isPotentialAgentUserDataPartType(type) && /^data-[a-z0-9][a-z0-9-]*$/.test(type);
+}
+export function validateAgentUserDataPartsConfig(agentName, value) {
+    if (value === undefined)
+        return;
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`Raybase agent ${agentName} conversations.messages.userDataParts must be an object`);
+    }
+    for (const [type, rawDefinition] of Object.entries(value)) {
+        const path = `Raybase agent ${agentName} conversations.messages.userDataParts.${type}`;
+        if (!isAgentUserDataPartType(type)) {
+            throw new Error(`${path} must use a lowercase app-defined data-* type outside Core's reserved namespace`);
+        }
+        if (!rawDefinition || typeof rawDefinition !== "object" || Array.isArray(rawDefinition)) {
+            throw new Error(`${path} must be an object`);
+        }
+        const definition = rawDefinition;
+        const unknownDefinitionKeys = Object.keys(rawDefinition).filter((key) => key !== "schema" && key !== "maxBytes");
+        if (unknownDefinitionKeys.length) {
+            throw new Error(`${path}.${unknownDefinitionKeys[0]} is unsupported`);
+        }
+        if (!Number.isInteger(definition.maxBytes) || definition.maxBytes < 1) {
+            throw new Error(`${path}.maxBytes must be a positive integer`);
+        }
+        if (definition.maxBytes > maxAgentUserDataPartBytes) {
+            throw new Error(`${path}.maxBytes exceeds the Core hard cap of ${maxAgentUserDataPartBytes} bytes`);
+        }
+        validateAgentUserDataPartSchema(definition.schema, `${path}.schema`);
+    }
+}
+export function validateAgentUserDataPartValue(definition, value, path = "part.data") {
+    let canonicalJson;
+    try {
+        canonicalJson = stableJson(value);
+    }
+    catch {
+        canonicalJson = undefined;
+    }
+    if (typeof canonicalJson !== "string")
+        throw new Error(`${path} must be JSON serializable`);
+    const canonicalBytes = new TextEncoder().encode(canonicalJson).byteLength;
+    if (canonicalBytes > definition.maxBytes || canonicalBytes > maxAgentUserDataPartBytes) {
+        throw new Error(`${path} exceeds its byte limit`);
+    }
+    const canonicalValue = JSON.parse(canonicalJson);
+    const validated = validateJsonSchema(definition.schema, canonicalValue, path);
+    const validatedJson = stableJson(validated);
+    if (typeof validatedJson !== "string")
+        throw new Error(`${path} must be JSON serializable`);
+    return {
+        value: JSON.parse(validatedJson),
+        canonicalJson: validatedJson,
+        bytes: new TextEncoder().encode(validatedJson).byteLength
+    };
+}
+function validateAgentUserDataPartSchema(schema, path) {
+    const allowedTypes = new Set(["object", "array", "string", "number", "integer", "boolean", "null"]);
+    if (!schema || typeof schema !== "object" || Array.isArray(schema)) {
+        throw new Error(`${path} must be a JSON Schema object`);
+    }
+    if (typeof schema.type !== "string" || !allowedTypes.has(schema.type)) {
+        throw new Error(`${path}.type must be one of object, array, string, number, integer, boolean, or null`);
+    }
+    const common = new Set(["type", "enum"]);
+    const byType = {
+        object: new Set(["properties", "required", "additionalProperties"]),
+        array: new Set(["items", "minItems", "maxItems"]),
+        string: new Set(["minLength", "maxLength"]),
+        number: new Set(["minimum", "maximum"]),
+        integer: new Set(["minimum", "maximum"]),
+        boolean: new Set(),
+        null: new Set()
+    };
+    for (const key of Object.keys(schema)) {
+        if (!common.has(key) && !byType[schema.type].has(key)) {
+            throw new Error(`${path}.${key} is unsupported for type ${schema.type}`);
+        }
+    }
+    if (schema.enum !== undefined) {
+        if (!Array.isArray(schema.enum) || schema.enum.length === 0)
+            throw new Error(`${path}.enum must be a non-empty array`);
+        const schemaWithoutEnum = { ...schema };
+        delete schemaWithoutEnum.enum;
+        for (const [index, candidate] of schema.enum.entries()) {
+            let serialized;
+            try {
+                serialized = stableJson(candidate);
+            }
+            catch {
+                serialized = undefined;
+            }
+            if (typeof serialized !== "string")
+                throw new Error(`${path}.enum[${index}] must be JSON serializable`);
+            try {
+                validateJsonSchema(schemaWithoutEnum, candidate, `${path}.enum[${index}]`);
+            }
+            catch (error) {
+                throw new Error(error instanceof Error ? error.message : `${path}.enum[${index}] is invalid`);
+            }
+        }
+    }
+    if (schema.type === "object") {
+        if (schema.properties !== undefined && (!schema.properties || typeof schema.properties !== "object" || Array.isArray(schema.properties))) {
+            throw new Error(`${path}.properties must be an object`);
+        }
+        if (schema.required !== undefined && (!Array.isArray(schema.required)
+            || schema.required.some((key) => typeof key !== "string")
+            || new Set(schema.required).size !== schema.required.length)) {
+            throw new Error(`${path}.required must contain unique property names`);
+        }
+        if (schema.additionalProperties !== undefined && typeof schema.additionalProperties !== "boolean") {
+            throw new Error(`${path}.additionalProperties must be a boolean`);
+        }
+        for (const required of schema.required ?? []) {
+            if (!schema.properties?.[required])
+                throw new Error(`${path}.required includes undeclared property ${required}`);
+        }
+        for (const [key, child] of Object.entries(schema.properties ?? {})) {
+            validateAgentUserDataPartSchema(child, `${path}.properties.${key}`);
+        }
+    }
+    if (schema.type === "array" && schema.items !== undefined) {
+        validateAgentUserDataPartSchema(schema.items, `${path}.items`);
+    }
+    validateNonNegativeIntegerBound(schema.minLength, `${path}.minLength`);
+    validateNonNegativeIntegerBound(schema.maxLength, `${path}.maxLength`);
+    validateNonNegativeIntegerBound(schema.minItems, `${path}.minItems`);
+    validateNonNegativeIntegerBound(schema.maxItems, `${path}.maxItems`);
+    validateBoundOrder(schema.minLength, schema.maxLength, path, "minLength", "maxLength");
+    validateBoundOrder(schema.minItems, schema.maxItems, path, "minItems", "maxItems");
+    if (schema.minimum !== undefined && (typeof schema.minimum !== "number" || !Number.isFinite(schema.minimum))) {
+        throw new Error(`${path}.minimum must be a finite number`);
+    }
+    if (schema.maximum !== undefined && (typeof schema.maximum !== "number" || !Number.isFinite(schema.maximum))) {
+        throw new Error(`${path}.maximum must be a finite number`);
+    }
+    validateBoundOrder(schema.minimum, schema.maximum, path, "minimum", "maximum");
+}
+function validateNonNegativeIntegerBound(value, path) {
+    if (value !== undefined && (!Number.isInteger(value) || value < 0)) {
+        throw new Error(`${path} must be a non-negative integer`);
+    }
+}
+function validateBoundOrder(minimum, maximum, path, minimumName, maximumName) {
+    if (minimum !== undefined && maximum !== undefined && minimum > maximum) {
+        throw new Error(`${path}.${minimumName} must not exceed ${maximumName}`);
+    }
+}
+//# sourceMappingURL=agent-user-data-parts.js.map

package/dist/agent-user-data-parts.js.map

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

package/dist/agent-user-transcript.d.ts

@@ -0,0 +1,46 @@
+import { type RaybaseAgentMessageAttachment } from "./agent-message-parts.js";
+/**
+ * The member-facing transcript projection, shared by the conversation Durable
+ * Object's hot reads and the worker's archive read-through pager. Pure by
+ * design: archive NDJSON lines are the stored UI message objects, so both
+ * stores project through exactly this code and the screen cannot diverge by
+ * source.
+ */
+export type StoredChatMessageRow = {
+    id: string;
+    message: string;
+    created_at: string;
+};
+export declare function normalizeUserTranscriptMessage(row: StoredChatMessageRow, defaultUserId?: string | null): {
+    id: string;
+    role: "user" | "assistant";
+    parts: Array<Record<string, unknown>>;
+    /** Derived from the stored parts, before any projection flattens them. */
+    attachments: RaybaseAgentMessageAttachment[];
+    createdAt: string;
+    author: {
+        kind: "user" | "agent" | "app";
+        userId: string | null;
+        name: string | null;
+    };
+    metadata?: {
+        raybase: {
+            editedAt?: string;
+            removed?: boolean;
+            removedAt?: string;
+            reactions?: Record<string, string>;
+            /** Absent on messages committed before turn identity was stamped. */
+            runId?: string;
+        };
+    };
+} | null;
+export declare function transcriptMessageAuthor(message: Record<string, unknown>, defaultUserId?: string | null): {
+    kind: "user" | "agent" | "app";
+    userId: string | null;
+    name: string | null;
+};
+export declare function isHiddenEntryKickoffRecord(message: Record<string, unknown>): boolean;
+export declare function userTranscriptParts(parts: unknown[], role: "user" | "assistant"): Array<Record<string, unknown>>;
+export declare function storedMessageRunId(message: Record<string, unknown>): string | null;
+export declare function parseStoredMessage(value: string): Record<string, unknown>;
+//# sourceMappingURL=agent-user-transcript.d.ts.map

package/dist/agent-user-transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-user-transcript.d.ts","sourceRoot":"","sources":["../src/agent-user-transcript.ts"],"names":[],"mappings":"AACA,OAAO,EAQL,KAAK,6BAA6B,EACnC,MAAM,0BAA0B,CAAC;AAElC;;;;;;GAMG;AAEH,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,oBAAoB,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG;IACxG,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtC,0EAA0E;IAC1E,WAAW,EAAE,6BAA6B,EAAE,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;QAC/B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;KACrB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,OAAO,EAAE;YACP,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,OAAO,CAAC,EAAE,OAAO,CAAC;YAClB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACnC,qEAAqE;YACrE,KAAK,CAAC,EAAE,MAAM,CAAC;SAChB,CAAC;KACH,CAAC;CACH,GAAG,IAAI,CA2BP;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAC5B;IAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAahF;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAIpF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAIhH;AA0CD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAGlF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzE"}

package/dist/agent-user-transcript.js

@@ -0,0 +1,106 @@
+import { raybaseAgentDataPartTypes } from "./agent-data-parts.js";
+import { agentFilePlaceholder, agentMessageAttachments, asAgentFilePart, asAgentUserDataPart, asAgentVoiceNoteData, raybaseFileReferenceId, raybaseVoiceNoteDataPartType } from "./agent-message-parts.js";
+export function normalizeUserTranscriptMessage(row, defaultUserId) {
+    const parsed = parseStoredMessage(row.message);
+    if (parsed.role !== "user" && parsed.role !== "assistant")
+        return null;
+    if (isHiddenEntryKickoffRecord(parsed))
+        return null;
+    const parts = Array.isArray(parsed.parts) ? userTranscriptParts(parsed.parts, parsed.role) : [];
+    const raybase = asRecord(asRecord(parsed.metadata).raybase);
+    const reactions = Object.fromEntries(Object.entries(asRecord(raybase.reactions))
+        .filter((entry) => typeof entry[1] === "string"));
+    const runId = storedMessageRunId(parsed);
+    const projectedRaybase = {
+        ...(typeof raybase.editedAt === "string" ? { editedAt: raybase.editedAt } : {}),
+        ...(raybase.removed === true ? { removed: true } : {}),
+        ...(typeof raybase.removedAt === "string" ? { removedAt: raybase.removedAt } : {}),
+        ...(Object.keys(reactions).length ? { reactions } : {}),
+        ...(runId ? { runId } : {})
+    };
+    return {
+        id: String(parsed.id ?? row.id),
+        role: parsed.role,
+        parts,
+        attachments: agentMessageAttachments(parsed.parts),
+        createdAt: row.created_at,
+        author: transcriptMessageAuthor(parsed, defaultUserId),
+        ...(Object.keys(projectedRaybase).length ? { metadata: { raybase: projectedRaybase } } : {})
+    };
+}
+export function transcriptMessageAuthor(message, defaultUserId) {
+    const metadata = asRecord(message.metadata);
+    const author = asRecord(asRecord(metadata.raybase).author);
+    const kind = author.kind === "user" || author.kind === "agent" || author.kind === "app"
+        ? author.kind
+        : message.role === "assistant" ? "agent" : "user";
+    return {
+        kind,
+        userId: kind === "user"
+            ? typeof author.userId === "string" ? author.userId : defaultUserId ?? null
+            : null,
+        name: typeof author.name === "string" && author.name.trim() ? author.name.trim() : null
+    };
+}
+export function isHiddenEntryKickoffRecord(message) {
+    const metadata = asRecord(message.metadata);
+    const raybase = asRecord(metadata.raybase);
+    return raybase.hidden === true && raybase.entryKickoff === true;
+}
+export function userTranscriptParts(parts, role) {
+    const hasVoiceNote = parts.some((part) => asAgentVoiceNoteData(part) !== null)
+        && parts.some((part) => asAgentFilePart(part)?.mediaType === "audio/wav");
+    return parts.flatMap((part) => userTranscriptPart(part, hasVoiceNote, role));
+}
+function userTranscriptPart(part, hasVoiceNote = false, role = "user") {
+    const record = asRecord(part);
+    const type = typeof record.type === "string" ? record.type : "";
+    if (type === "text" && typeof record.text === "string") {
+        return [{ type: "text", text: record.text }];
+    }
+    const file = asAgentFilePart(record);
+    if (file?.mediaType === "audio/wav") {
+        // A voice note keeps its audio part only alongside its duration marker;
+        // the pair is what the player is built from.
+        return hasVoiceNote ? [file] : [{ type: "text", text: agentFilePlaceholder(file) }];
+    }
+    if (file) {
+        // A durable `raybase-file:` reference is an opaque id the file route
+        // authorizes on its own, so it survives to every reader that can render
+        // it. Anything else — an inline `data:` payload, an unusable URL — is
+        // flattened to the stand-in it always was.
+        return raybaseFileReferenceId(file.url) ? [file] : [{ type: "text", text: agentFilePlaceholder(file) }];
+    }
+    const voiceNote = asAgentVoiceNoteData(record);
+    if (voiceNote && hasVoiceNote)
+        return [{ type: raybaseVoiceNoteDataPartType, data: voiceNote }];
+    const userData = role === "user" ? asAgentUserDataPart(record) : null;
+    if (userData)
+        return [{ type: userData.type, data: userData.data }];
+    if (type === raybaseAgentDataPartTypes.sources ||
+        type === raybaseAgentDataPartTypes.citations ||
+        type === raybaseAgentDataPartTypes.supportRequestCreated ||
+        type === raybaseAgentDataPartTypes.turnError) {
+        const output = { type, data: record.data };
+        if (typeof record.id === "string")
+            output.id = record.id;
+        return [output];
+    }
+    return [];
+}
+export function storedMessageRunId(message) {
+    const runId = asRecord(asRecord(message.metadata).raybase).runId;
+    return typeof runId === "string" && runId.trim() ? runId : null;
+}
+export function parseStoredMessage(value) {
+    try {
+        return asRecord(JSON.parse(value));
+    }
+    catch {
+        return {};
+    }
+}
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+//# sourceMappingURL=agent-user-transcript.js.map

package/dist/agent-user-transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-user-transcript.js","sourceRoot":"","sources":["../src/agent-user-transcript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,4BAA4B,EAE7B,MAAM,0BAA0B,CAAC;AAgBlC,MAAM,UAAU,8BAA8B,CAAC,GAAyB,EAAE,aAA6B;IAuBrG,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IACvE,IAAI,0BAA0B,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChG,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAClC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;SACxC,MAAM,CAAC,CAAC,KAAK,EAA6B,EAAE,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAC9E,CAAC;IACF,MAAM,KAAK,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,gBAAgB,GAAG;QACvB,GAAG,CAAC,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,GAAG,CAAC,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClF,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5B,CAAC;IACF,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,CAAC;QAC/B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK;QACL,WAAW,EAAE,uBAAuB,CAAC,MAAM,CAAC,KAAK,CAAC;QAClD,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,MAAM,EAAE,uBAAuB,CAAC,MAAM,EAAE,aAAa,CAAC;QACtD,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7F,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,OAAgC,EAChC,aAA6B;IAE7B,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK;QACrF,CAAC,CAAC,MAAM,CAAC,IAAI;QACb,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IACpD,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,IAAI,KAAK,MAAM;YACrB,CAAC,CAAC,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,IAAI,IAAI;YAC3E,CAAC,CAAC,IAAI;QACR,IAAI,EAAE,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;KACxF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,OAAgC;IACzE,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO,OAAO,CAAC,MAAM,KAAK,IAAI,IAAI,OAAO,CAAC,YAAY,KAAK,IAAI,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAgB,EAAE,IAA0B;IAC9E,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;WACzE,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,SAAS,KAAK,WAAW,CAAC,CAAC;IAC5E,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,kBAAkB,CACzB,IAAa,EACb,YAAY,GAAG,KAAK,EACpB,OAA6B,MAAM;IAEnC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,IAAI,IAAI,KAAK,MAAM,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACvD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,IAAI,EAAE,SAAS,KAAK,WAAW,EAAE,CAAC;QACpC,wEAAwE;QACxE,6CAA6C;QAC7C,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,IAAI,EAAE,CAAC;QACT,qEAAqE;QACrE,wEAAwE;QACxE,sEAAsE;QACtE,2CAA2C;QAC3C,OAAO,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1G,CAAC;IACD,MAAM,SAAS,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,SAAS,IAAI,YAAY;QAAE,OAAO,CAAC,EAAE,IAAI,EAAE,4BAA4B,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAChG,MAAM,QAAQ,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACtE,IAAI,QAAQ;QAAE,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACpE,IACE,IAAI,KAAK,yBAAyB,CAAC,OAAO;QAC1C,IAAI,KAAK,yBAAyB,CAAC,SAAS;QAC5C,IAAI,KAAK,yBAAyB,CAAC,qBAAqB;QACxD,IAAI,KAAK,yBAAyB,CAAC,SAAS,EAC5C,CAAC;QACD,MAAM,MAAM,GAA4B,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QACpE,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ;YAAE,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;QACzD,OAAO,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAgC;IACjE,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC;IACjE,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAgC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7G,CAAC"}

package/dist/agent-voice-notes.d.ts

@@ -0,0 +1,15 @@
+export declare const defaultAgentVoiceNoteMaxSeconds = 300;
+export declare const agentVoiceNotePcmBytesPerSecond = 32000;
+export declare const agentVoiceNoteWavSlackBytes = 4096;
+export type RaybaseAgentConversationVoiceNotesConfig = {
+    enabled: true;
+    maxSeconds?: number;
+};
+export type NormalizedRaybaseAgentConversationVoiceNotesConfig = {
+    enabled: true;
+    maxSeconds: number;
+    maxBytes: number;
+};
+export declare function agentVoiceNoteMaxBytes(maxSeconds: number, attachmentMaxBytes: number): number;
+export declare function normalizeAgentVoiceNotesConfig(config: RaybaseAgentConversationVoiceNotesConfig | undefined, attachmentMaxBytes: number): NormalizedRaybaseAgentConversationVoiceNotesConfig | null;
+//# sourceMappingURL=agent-voice-notes.d.ts.map

package/dist/agent-voice-notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-voice-notes.d.ts","sourceRoot":"","sources":["../src/agent-voice-notes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,+BAA+B,MAAM,CAAC;AACnD,eAAO,MAAM,+BAA+B,QAAS,CAAC;AACtD,eAAO,MAAM,2BAA2B,OAAQ,CAAC;AAEjD,MAAM,MAAM,wCAAwC,GAAG;IACrD,OAAO,EAAE,IAAI,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,kDAAkD,GAAG;IAC/D,OAAO,EAAE,IAAI,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAK7F;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,wCAAwC,GAAG,SAAS,EAC5D,kBAAkB,EAAE,MAAM,GACzB,kDAAkD,GAAG,IAAI,CAQ3D"}

package/dist/agent-voice-notes.js

@@ -0,0 +1,17 @@
+export const defaultAgentVoiceNoteMaxSeconds = 300;
+export const agentVoiceNotePcmBytesPerSecond = 32_000;
+export const agentVoiceNoteWavSlackBytes = 4_096;
+export function agentVoiceNoteMaxBytes(maxSeconds, attachmentMaxBytes) {
+    return Math.min(attachmentMaxBytes, maxSeconds * agentVoiceNotePcmBytesPerSecond + agentVoiceNoteWavSlackBytes);
+}
+export function normalizeAgentVoiceNotesConfig(config, attachmentMaxBytes) {
+    if (!config)
+        return null;
+    const maxSeconds = config.maxSeconds ?? defaultAgentVoiceNoteMaxSeconds;
+    return {
+        enabled: true,
+        maxSeconds,
+        maxBytes: agentVoiceNoteMaxBytes(maxSeconds, attachmentMaxBytes)
+    };
+}
+//# sourceMappingURL=agent-voice-notes.js.map

package/dist/agent-voice-notes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-voice-notes.js","sourceRoot":"","sources":["../src/agent-voice-notes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAG,CAAC;AACnD,MAAM,CAAC,MAAM,+BAA+B,GAAG,MAAM,CAAC;AACtD,MAAM,CAAC,MAAM,2BAA2B,GAAG,KAAK,CAAC;AAajD,MAAM,UAAU,sBAAsB,CAAC,UAAkB,EAAE,kBAA0B;IACnF,OAAO,IAAI,CAAC,GAAG,CACb,kBAAkB,EAClB,UAAU,GAAG,+BAA+B,GAAG,2BAA2B,CAC3E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,MAA4D,EAC5D,kBAA0B;IAE1B,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,+BAA+B,CAAC;IACxE,OAAO;QACL,OAAO,EAAE,IAAI;QACb,UAAU;QACV,QAAQ,EAAE,sBAAsB,CAAC,UAAU,EAAE,kBAAkB,CAAC;KACjE,CAAC;AACJ,CAAC"}