@saleso.innovations/bridge 0.1.16 → 0.1.17

package/README.md

@@ -34,7 +34,7 @@ This installs the latest package, refreshes the CLI symlink, and restarts `cleos
 To pin a specific release (e.g. after a Cleos update):
 
 ```bash
-curl -fsSL https://amicable-elephant-407.convex.site/update-bridge.sh | bash -s -- 0.1.16
+curl -fsSL https://amicable-elephant-407.convex.site/update-bridge.sh | bash -s -- 0.1.17
 ```
 
 ## Manual usage

package/dist/client.d.ts

@@ -18,7 +18,8 @@ export type UserMessageAttachment = {
 export type UserMessageMeta = {
     agentId: string;
     conversationId: string;
-    messageId: string;
+    clientMessageId: string;
+    replyMessageId: string;
     attachments?: UserMessageAttachment[];
 };
 export type AgentActivityPayload = {
@@ -36,7 +37,7 @@ export type AgentFailedPayload = {
 export type AgentReply = {
     delta: (text: string, sequence: number) => void;
     activity: (activity: AgentActivityPayload) => void;
-    complete: (text: string, sequence: number) => void;
+    complete: (text: string, sequence: number, attachments?: UserMessageAttachment[]) => void;
     failed: (failure: AgentFailedPayload) => void;
 };
 export type CronDeliveryMeta = {

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -72,7 +72,7 @@ function createReplySender(ws, agentId, conversationId, messageId) {
                 sequence: activity.sequence,
             }));
         },
-        complete(text, sequence) {
+        complete(text, sequence, attachments) {
             ws.send(JSON.stringify({
                 type: "agent.message",
                 agentId,
@@ -81,6 +81,7 @@ function createReplySender(ws, agentId, conversationId, messageId) {
                 content: text,
                 sequence,
                 final: true,
+                ...(attachments && attachments.length > 0 ? { attachments } : {}),
             }));
         },
         failed(failure) {
@@ -195,11 +196,14 @@ async function openAgentConnection(options) {
                 rememberConversationId(conversationId);
             }
             const attachments = parseUserMessageAttachments(envelope.attachments);
+            const clientMessageId = typeof envelope.clientMessageId === "string" && envelope.clientMessageId.trim().length > 0
+                ? envelope.clientMessageId.trim()
+                : randomUUID();
             const replyMessageId = randomUUID();
             const reply = createReplySender(ws, agentId, conversationId, replyMessageId);
             if (options.onUserMessage) {
                 try {
-                    await options.onUserMessage(content, { agentId, conversationId, messageId: replyMessageId, attachments }, reply);
+                    await options.onUserMessage(content, { agentId, conversationId, clientMessageId, replyMessageId, attachments }, reply);
                 }
                 catch (error) {
                     const { message, code } = userSafeHermesError(error);

package/dist/convexRelay.d.ts

@@ -0,0 +1,24 @@
+export type ConvexUploadedFile = {
+    storageId: string;
+    url: string | null;
+    mimeType: string;
+    fileName: string;
+    size: number;
+};
+export type HermesMessageLink = {
+    clientMessageId?: string;
+    externalMessageId?: string;
+    hermesMessageId: string;
+};
+export declare function linkHermesMessageIds(args: {
+    agentId: string;
+    conversationId: string;
+    links: HermesMessageLink[];
+}): Promise<void>;
+export declare function uploadFileToConvex(args: {
+    agentId: string;
+    fileName: string;
+    mimeType: string;
+    contentBase64: string;
+}): Promise<ConvexUploadedFile>;
+//# sourceMappingURL=convexRelay.d.ts.map

package/dist/convexRelay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convexRelay.d.ts","sourceRoot":"","sources":["../src/convexRelay.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BhB;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA4C9B"}

package/dist/convexRelay.js

@@ -0,0 +1,70 @@
+import { loadCredentials } from "./credentials.js";
+import { MAX_RELAY_UPLOAD_BYTES } from "./hermesFiles.js";
+import { convexSiteUrlFromEnv } from "./resolve.js";
+export async function linkHermesMessageIds(args) {
+    if (args.links.length === 0)
+        return;
+    const credentials = loadCredentials();
+    const convexSiteUrl = credentials?.convexSiteUrl ?? convexSiteUrlFromEnv();
+    const relaySecret = process.env.CLEOS_RELAY_SECRET?.trim() || "dev-relay-secret";
+    const response = await fetch(`${convexSiteUrl.replace(/\/$/, "")}/relay/messages`, {
+        method: "POST",
+        headers: {
+            "content-type": "application/json",
+            "x-cleos-relay-secret": relaySecret,
+        },
+        body: JSON.stringify({
+            envelope: {
+                type: "hermes.link",
+                agentId: args.agentId,
+                conversationId: args.conversationId,
+                links: args.links,
+            },
+        }),
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`Failed to link Hermes message IDs (${response.status}): ${text}`);
+    }
+}
+export async function uploadFileToConvex(args) {
+    if (args.contentBase64.length === 0) {
+        throw new Error("contentBase64 is required");
+    }
+    const byteLength = Buffer.byteLength(args.contentBase64, "base64");
+    if (byteLength > MAX_RELAY_UPLOAD_BYTES) {
+        throw new Error(`File exceeds maximum upload size (${MAX_RELAY_UPLOAD_BYTES} bytes)`);
+    }
+    const credentials = loadCredentials();
+    const convexSiteUrl = credentials?.convexSiteUrl ?? convexSiteUrlFromEnv();
+    const relaySecret = process.env.CLEOS_RELAY_SECRET?.trim() || "dev-relay-secret";
+    const response = await fetch(`${convexSiteUrl.replace(/\/$/, "")}/relay/files`, {
+        method: "POST",
+        headers: {
+            "content-type": "application/json",
+            "x-cleos-relay-secret": relaySecret,
+        },
+        body: JSON.stringify({
+            agentId: args.agentId,
+            fileName: args.fileName,
+            mimeType: args.mimeType,
+            contentBase64: args.contentBase64,
+        }),
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`Failed to upload file to Convex (${response.status}): ${text}`);
+    }
+    const payload = (await response.json());
+    const storageId = typeof payload.storageId === "string" ? payload.storageId : "";
+    if (!storageId) {
+        throw new Error("Upload response missing storageId");
+    }
+    return {
+        storageId,
+        url: typeof payload.url === "string" ? payload.url : null,
+        mimeType: args.mimeType,
+        fileName: args.fileName,
+        size: byteLength,
+    };
+}

package/dist/hermesCommands.d.ts

@@ -1,4 +1,4 @@
-export declare const HERMES_COMMAND_NAMES: readonly ["runtime.health", "runtime.detailedHealth", "runtime.capabilities", "models.list", "model.set", "responses.create", "runs.create", "runs.status", "runs.stop", "jobs.list", "jobs.get", "jobs.create", "jobs.update", "jobs.pause", "jobs.resume", "jobs.runNow", "jobs.delete", "profiles.list", "profiles.create", "gateway.start", "gateway.stop", "gateway.restart", "hermes.update"];
+export declare const HERMES_COMMAND_NAMES: readonly ["runtime.health", "runtime.detailedHealth", "runtime.version", "runtime.capabilities", "models.list", "model.set", "responses.create", "runs.create", "runs.status", "runs.stop", "jobs.list", "jobs.get", "jobs.create", "jobs.update", "jobs.pause", "jobs.resume", "jobs.runNow", "jobs.delete", "profiles.list", "profiles.create", "gateway.start", "gateway.stop", "gateway.restart", "hermes.update", "sessions.messages.list", "sessions.messages.countSent", "skills.list", "files.list", "files.read"];
 export type HermesCommandName = (typeof HERMES_COMMAND_NAMES)[number];
 export declare function isHermesCommandName(value: string): value is HermesCommandName;
 export type HermesCommandErrorCode = "command_unsupported" | "hermes_unreachable" | "hermes_request_failed" | "invalid_command_args" | "unsupported_by_http";

package/dist/hermesCommands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hermesCommands.d.ts","sourceRoot":"","sources":["../src/hermesCommands.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,oBAAoB,qYAwBvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,iBAAiB,CAE7E;AAED,MAAM,MAAM,sBAAsB,GAC9B,qBAAqB,GACrB,oBAAoB,GACpB,uBAAuB,GACvB,sBAAsB,GACtB,qBAAqB,CAAC;AAE1B,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;gBAE1B,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM;CAI1D;AAuFD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACjE,OAAO,CAAC,OAAO,CAAC,CAkKlB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAetG"}
+{"version":3,"file":"hermesCommands.d.ts","sourceRoot":"","sources":["../src/hermesCommands.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,oBAAoB,4fA8BvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,iBAAiB,CAE7E;AAED,MAAM,MAAM,sBAAsB,GAC9B,qBAAqB,GACrB,oBAAoB,GACpB,uBAAuB,GACvB,sBAAsB,GACtB,qBAAqB,CAAC;AAE1B,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;gBAE1B,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM;CAI1D;AAgGD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACjE,OAAO,CAAC,OAAO,CAAC,CAwLlB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAetG"}

package/dist/hermesCommands.js

@@ -1,10 +1,15 @@
 import { resolveHermesApiConfig } from "./hermesForwarder.js";
 import { restartHermesGateway, startHermesGateway, stopHermesGateway } from "./gatewayControl.js";
 import { listHermesCronJobs } from "./cronList.js";
+import { listSessionMessages, countUserMessagesSent } from "./hermesSessionDb.js";
+import { listHermesSkills } from "./skillsList.js";
 import { runHermesUpdate } from "./hermesUpdate.js";
+import { executeFilesList, executeFilesRead } from "./hermesFileCommands.js";
+import { fetchHermesRuntimeVersion } from "./runtimeVersion.js";
 export const HERMES_COMMAND_NAMES = [
     "runtime.health",
     "runtime.detailedHealth",
+    "runtime.version",
     "runtime.capabilities",
     "models.list",
     "model.set",
@@ -26,6 +31,11 @@ export const HERMES_COMMAND_NAMES = [
     "gateway.stop",
     "gateway.restart",
     "hermes.update",
+    "sessions.messages.list",
+    "sessions.messages.countSent",
+    "skills.list",
+    "files.list",
+    "files.read",
 ];
 export function isHermesCommandName(value) {
     return HERMES_COMMAND_NAMES.includes(value);
@@ -71,6 +81,15 @@ function optionalRecord(args, key) {
     }
     return value;
 }
+function optionalNumber(args, key) {
+    const value = args[key];
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+        throw new HermesCommandError("invalid_command_args", `Invalid "${key}"`);
+    }
+    return Math.floor(value);
+}
 async function hermesFetchJson(config, path, init = {}) {
     const url = `${hermesBaseUrl(config.apiUrl)}${path}`;
     const headers = {
@@ -109,6 +128,8 @@ export async function executeHermesCommand(command, args, options = {}) {
             return await hermesFetchJson(config, "/health");
         case "runtime.detailedHealth":
             return await hermesFetchJson(config, "/health/detailed");
+        case "runtime.version":
+            return await fetchHermesRuntimeVersion();
         case "runtime.capabilities":
             return await hermesFetchJson(config, "/v1/capabilities");
         case "models.list":
@@ -256,6 +277,26 @@ export async function executeHermesCommand(command, args, options = {}) {
             const restartGateway = args.restartGateway === true || args.restart_gateway === true;
             return await runHermesUpdate({ restartGateway });
         }
+        case "sessions.messages.list": {
+            const sessionId = requireString(args, "sessionId");
+            const limit = optionalNumber(args, "limit");
+            const offset = optionalNumber(args, "offset");
+            const offsetFromEnd = optionalNumber(args, "offsetFromEnd");
+            return listSessionMessages(sessionId, { limit, offset, offsetFromEnd });
+        }
+        case "sessions.messages.countSent":
+            return countUserMessagesSent();
+        case "skills.list":
+            return await listHermesSkills();
+        case "files.list":
+            return await executeFilesList(args);
+        case "files.read": {
+            const path = optionalString(args, "path");
+            if (!path) {
+                throw new HermesCommandError("invalid_command_args", 'Missing "path"');
+            }
+            return await executeFilesRead({ ...args, path });
+        }
         default: {
             const _exhaustive = command;
             throw new HermesCommandError("command_unsupported", `Unsupported command: ${String(_exhaustive)}`);

package/dist/hermesFileCommands.d.ts

@@ -0,0 +1,19 @@
+export declare function executeFilesList(args: Record<string, unknown>): Promise<{
+    files: import("./hermesFiles.js").HermesFileEntry[];
+}>;
+export declare function executeFilesRead(args: Record<string, unknown>): Promise<{
+    fileName: string;
+    mimeType: string;
+    size: number;
+    contentBase64: string;
+    storageId?: undefined;
+    url?: undefined;
+} | {
+    fileName: string;
+    mimeType: string;
+    size: number;
+    storageId: string;
+    url: string | undefined;
+    contentBase64?: undefined;
+}>;
+//# sourceMappingURL=hermesFileCommands.d.ts.map

package/dist/hermesFileCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermesFileCommands.d.ts","sourceRoot":"","sources":["../src/hermesFileCommands.ts"],"names":[],"mappings":"AA6BA,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;GAKnE;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;;;GAkCnE"}

package/dist/hermesFileCommands.js

@@ -0,0 +1,61 @@
+import { DEFAULT_FILES_READ_MAX_BYTES, listHermesFiles, readHermesFileBytes, } from "./hermesFiles.js";
+import { uploadFileToConvex } from "./convexRelay.js";
+import { loadCredentials } from "./credentials.js";
+function optionalNumber(args, key) {
+    const value = args[key];
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (typeof value === "string" && value.trim().length > 0) {
+        const parsed = Number.parseInt(value, 10);
+        if (Number.isFinite(parsed))
+            return parsed;
+    }
+    return undefined;
+}
+function optionalCategory(args) {
+    const value = args.category;
+    if (typeof value !== "string")
+        return "all";
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "image" || normalized === "video" || normalized === "document") {
+        return normalized;
+    }
+    return "all";
+}
+export async function executeFilesList(args) {
+    const limit = optionalNumber(args, "limit");
+    const offset = optionalNumber(args, "offset");
+    const category = optionalCategory(args);
+    return listHermesFiles({ limit, offset, category });
+}
+export async function executeFilesRead(args) {
+    const path = typeof args.path === "string" ? args.path.trim() : "";
+    const maxBytes = optionalNumber(args, "maxBytes") ?? DEFAULT_FILES_READ_MAX_BYTES;
+    const { bytes, mimeType, fileName, size } = readHermesFileBytes(path);
+    if (size <= maxBytes) {
+        return {
+            fileName,
+            mimeType,
+            size,
+            contentBase64: bytes.toString("base64"),
+        };
+    }
+    const credentials = loadCredentials();
+    const agentId = credentials?.agentId;
+    if (!agentId) {
+        throw new Error("Large files require bridge credentials with agentId for Convex upload.");
+    }
+    const uploaded = await uploadFileToConvex({
+        agentId,
+        fileName,
+        mimeType,
+        contentBase64: bytes.toString("base64"),
+    });
+    return {
+        fileName,
+        mimeType,
+        size,
+        storageId: uploaded.storageId,
+        url: uploaded.url ?? undefined,
+    };
+}

package/dist/hermesFiles.d.ts

@@ -0,0 +1,60 @@
+export declare const MAX_RELAY_UPLOAD_BYTES: number;
+export declare const DEFAULT_FILES_READ_MAX_BYTES: number;
+export type HermesFileCategory = "image" | "video" | "document" | "other";
+export type HermesFileEntry = {
+    relativePath: string;
+    fileName: string;
+    size: number;
+    mtime: number;
+    mimeType: string;
+    category: HermesFileCategory;
+};
+export type HermesFileReadResult = {
+    fileName: string;
+    mimeType: string;
+    size: number;
+    contentBase64?: string;
+    storageId?: string;
+    url?: string;
+};
+export type MediaReference = {
+    kind: "local";
+    absolutePath: string;
+    raw: string;
+} | {
+    kind: "url";
+    url: string;
+    raw: string;
+};
+export declare function resolveHermesHome(): string;
+export declare function inferMimeType(fileName: string): string;
+export declare function inferCategory(fileName: string): HermesFileCategory;
+export declare function resolveSandboxedPath(inputPath: string): string;
+export declare function listHermesFiles(options?: {
+    limit?: number;
+    offset?: number;
+    category?: HermesFileCategory | "all";
+}): {
+    files: HermesFileEntry[];
+};
+export declare function readHermesFileBytes(inputPath: string): {
+    bytes: Buffer;
+    mimeType: string;
+    fileName: string;
+    size: number;
+};
+export declare function parseMediaReferences(text: string): MediaReference[];
+export declare function stripMediaReferences(text: string, refs: MediaReference[]): string;
+export declare function downloadUrlToBytes(url: string, timeoutMs?: number): Promise<{
+    bytes: Buffer;
+    mimeType: string;
+    fileName: string;
+    size: number;
+}>;
+export declare function resolveMediaReferenceBytes(ref: MediaReference): Promise<{
+    bytes: Buffer;
+    mimeType: string;
+    fileName: string;
+    size: number;
+} | null>;
+//# sourceMappingURL=hermesFiles.d.ts.map

package/dist/hermesFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermesFiles.d.ts","sourceRoot":"","sources":["../src/hermesFiles.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,sBAAsB,QAAmB,CAAC;AACvD,eAAO,MAAM,4BAA4B,QAAa,CAAC;AAgCvD,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAE1E,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,kBAAkB,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9C,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiCtD;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAMlE;AAQD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAe9D;AA8DD,wBAAgB,eAAe,CAAC,OAAO,GAAE;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,kBAAkB,GAAG,KAAK,CAAC;CAClC,GAAG;IAAE,KAAK,EAAE,eAAe,EAAE,CAAA;CAAE,CAepC;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAe1H;AAMD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CA6BnE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,MAAM,CAMjF;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAS,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBtJ;AAED,wBAAsB,0BAA0B,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CASzJ"}