@mysten-incubation/memwal 0.0.1-dev.0

package/README.md

@@ -0,0 +1,59 @@
+# @mysten-incubation/memwal
+
+Privacy-first AI memory SDK for storing encrypted memories on Walrus and retrieving them with semantic search.
+
+> MemWal is currently in beta and actively evolving. While fully usable today, we continue to refine the developer experience and operational guidance. We welcome feedback from early builders as we continue to improve the product.
+
+## Documentation
+
+For full documentation, visit [docs.memwal.ai](https://docs.memwal.ai).
+
+## Install
+
+```bash
+pnpm add @mysten-incubation/memwal
+```
+
+Peer dependencies (install as needed):
+
+```bash
+pnpm add @mysten/sui @mysten/seal @mysten/walrus ai zod
+```
+
+## Quick Start
+
+```ts
+import { MemWal } from "@mysten-incubation/memwal";
+
+const memwal = MemWal.create({
+  key: "your-delegate-key-hex",
+  accountId: "your-memwal-account-id",
+  serverUrl: "https://your-relayer-url.com",
+  namespace: "demo",
+});
+
+await memwal.remember("User prefers dark mode and uses TypeScript.");
+const memories = await memwal.recall("What are the user's preferences?");
+await memwal.restore("demo");
+```
+
+If you are self-hosting the relayer and do not have an account ID yet, see [Self-Hosting](../../docs/relayer/self-hosting.md) for the account creation and delegate key setup flow.
+
+## Exports
+
+| Entry | Description |
+|---|---|
+| `@mysten-incubation/memwal` | Default client (`MemWal`). The relayer handles embedding, encryption, Walrus upload/download, retrieval, and restore. |
+| `@mysten-incubation/memwal/manual` | Manual client flow (`MemWalManual`). You handle embedding calls and local SEAL operations. The relayer still handles upload relay, registration, search, and restore. |
+| `@mysten-incubation/memwal/ai` | Vercel AI SDK integration - wraps `MemWal` as middleware for use with `streamText`, `generateText`, etc. |
+
+## How It Works
+
+1. **Scope** - Each memory operation runs inside an `owner + namespace` boundary
+2. **Store** - The relayer embeds, encrypts, uploads to Walrus, and stores vector metadata in PostgreSQL
+3. **Recall** - The relayer searches by owner plus namespace, resolves matching blobs, and returns plaintext results
+4. **Restore** - The relayer can incrementally rebuild missing indexed entries for one namespace
+
+## License
+
+Apache 2.0 — see [LICENSE](../../LICENSE)

package/dist/account-entry.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @mysten-incubation/memwal/account
+ *
+ * Account management entry point — on-chain operations.
+ * Requires @mysten/sui as a peer dependency.
+ *
+ * @example
+ * ```typescript
+ * import { createAccount, addDelegateKey, generateDelegateKey } from "@mysten-incubation/memwal/account"
+ * ```
+ */
+export { createAccount, addDelegateKey, removeDelegateKey, generateDelegateKey } from "./account.js";
+export type { CreateAccountOpts, CreateAccountResult, AddDelegateKeyOpts, AddDelegateKeyResult, RemoveDelegateKeyOpts, } from "./types.js";
+//# sourceMappingURL=account-entry.d.ts.map

package/dist/account-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-entry.d.ts","sourceRoot":"","sources":["../src/account-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGrG,YAAY,EACR,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,GACxB,MAAM,YAAY,CAAC"}

package/dist/account-entry.js

@@ -0,0 +1,14 @@
+/**
+ * @mysten-incubation/memwal/account
+ *
+ * Account management entry point — on-chain operations.
+ * Requires @mysten/sui as a peer dependency.
+ *
+ * @example
+ * ```typescript
+ * import { createAccount, addDelegateKey, generateDelegateKey } from "@mysten-incubation/memwal/account"
+ * ```
+ */
+// Account management (on-chain: create account, add/remove delegate keys)
+export { createAccount, addDelegateKey, removeDelegateKey, generateDelegateKey } from "./account.js";
+//# sourceMappingURL=account-entry.js.map

package/dist/account-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-entry.js","sourceRoot":"","sources":["../src/account-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,0EAA0E;AAC1E,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/account.d.ts

@@ -0,0 +1,87 @@
+/**
+ * memwal — Account Management
+ *
+ * On-chain account operations: create account, add/remove delegate keys.
+ * Supports both wallet signing (browser) and private key signing (server-side).
+ *
+ * @example
+ * ```typescript
+ * import { createAccount, addDelegateKey, generateDelegateKey } from "@mysten-incubation/memwal/account"
+ *
+ * // Generate a delegate keypair
+ * const delegate = await generateDelegateKey()
+ *
+ * // Create account (wallet mode — browser)
+ * const account = await createAccount({
+ *     packageId: "0x...",
+ *     registryId: "0x...",
+ *     walletSigner,
+ * })
+ *
+ * // Add the delegate key
+ * await addDelegateKey({
+ *     packageId: "0x...",
+ *     accountId: account.accountId,
+ *     publicKey: delegate.publicKey,
+ *     label: "My Laptop",
+ *     walletSigner,
+ * })
+ *
+ * // Now use the delegate key with the SDK
+ * const memwal = MemWal.create({ key: delegate.privateKey, accountId: account.accountId })
+ * ```
+ */
+import type { CreateAccountOpts, CreateAccountResult, AddDelegateKeyOpts, AddDelegateKeyResult, RemoveDelegateKeyOpts } from "./types.js";
+/**
+ * Create a new MemWalAccount on-chain.
+ *
+ * Calls `{packageId}::account::create_account(registry, clock)`.
+ * Each address can only create ONE account (enforced by the contract).
+ *
+ * @returns CreateAccountResult with accountId, owner, and tx digest
+ */
+export declare function createAccount(opts: CreateAccountOpts): Promise<CreateAccountResult>;
+/**
+ * Add a delegate key to a MemWalAccount.
+ *
+ * Calls `{packageId}::account::add_delegate_key(account, public_key, sui_address, label, clock)`.
+ * Only the account owner can add delegate keys.
+ *
+ * @param opts.publicKey - Ed25519 public key (32 bytes Uint8Array or hex string)
+ * @param opts.label - Human-readable label (e.g. "MacBook Pro", "Production Server")
+ * @returns AddDelegateKeyResult with digest, publicKey hex, and derived suiAddress
+ */
+export declare function addDelegateKey(opts: AddDelegateKeyOpts): Promise<AddDelegateKeyResult>;
+/**
+ * Remove a delegate key from a MemWalAccount.
+ *
+ * Calls `{packageId}::account::remove_delegate_key(account, public_key)`.
+ * Only the account owner can remove delegate keys.
+ *
+ * @param opts.publicKey - Ed25519 public key to remove (32 bytes Uint8Array or hex string)
+ */
+export declare function removeDelegateKey(opts: RemoveDelegateKeyOpts): Promise<{
+    digest: string;
+}>;
+/**
+ * Generate a new Ed25519 delegate keypair.
+ *
+ * Returns the private key (hex), public key (bytes), and derived Sui address.
+ * The private key can be used with `MemWal.create({ key })`.
+ *
+ * @example
+ * ```typescript
+ * const delegate = await generateDelegateKey()
+ * console.log(delegate.privateKey)  // hex string — store securely!
+ * console.log(delegate.suiAddress)  // 0x... — use in addDelegateKey
+ *
+ * // Use with SDK
+ * const memwal = MemWal.create({ key: delegate.privateKey, accountId: "0x..." })
+ * ```
+ */
+export declare function generateDelegateKey(): Promise<{
+    privateKey: string;
+    publicKey: Uint8Array;
+    suiAddress: string;
+}>;
+//# sourceMappingURL=account.d.ts.map

package/dist/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../src/account.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAER,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACxB,MAAM,YAAY,CAAC;AA4GpB;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAC/B,IAAI,EAAE,iBAAiB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CA4C9B;AAMD;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAChC,IAAI,EAAE,kBAAkB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAyC/B;AAMD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACnC,IAAI,EAAE,qBAAqB,GAC5B,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAwB7B;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,UAAU,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACtB,CAAC,CAqBD"}

package/dist/account.js

@@ -0,0 +1,273 @@
+/**
+ * memwal — Account Management
+ *
+ * On-chain account operations: create account, add/remove delegate keys.
+ * Supports both wallet signing (browser) and private key signing (server-side).
+ *
+ * @example
+ * ```typescript
+ * import { createAccount, addDelegateKey, generateDelegateKey } from "@mysten-incubation/memwal/account"
+ *
+ * // Generate a delegate keypair
+ * const delegate = await generateDelegateKey()
+ *
+ * // Create account (wallet mode — browser)
+ * const account = await createAccount({
+ *     packageId: "0x...",
+ *     registryId: "0x...",
+ *     walletSigner,
+ * })
+ *
+ * // Add the delegate key
+ * await addDelegateKey({
+ *     packageId: "0x...",
+ *     accountId: account.accountId,
+ *     publicKey: delegate.publicKey,
+ *     label: "My Laptop",
+ *     walletSigner,
+ * })
+ *
+ * // Now use the delegate key with the SDK
+ * const memwal = MemWal.create({ key: delegate.privateKey, accountId: account.accountId })
+ * ```
+ */
+import { bytesToHex, hexToBytes } from "./utils.js";
+// ============================================================
+// SUI Clock object (shared, always 0x6)
+// ============================================================
+const SUI_CLOCK = "0x0000000000000000000000000000000000000000000000000000000000000006";
+async function buildTxContext(opts) {
+    if (!opts.suiPrivateKey && !opts.walletSigner) {
+        throw new Error("Provide either suiPrivateKey or walletSigner");
+    }
+    if (opts.suiPrivateKey && opts.walletSigner) {
+        throw new Error("Provide suiPrivateKey OR walletSigner, not both");
+    }
+    const { Transaction } = await import("@mysten/sui/transactions");
+    // Build Sui client
+    let suiClient;
+    if (opts.suiClient) {
+        suiClient = opts.suiClient;
+    }
+    else {
+        const mod = await import("@mysten/sui/client");
+        const SuiClient = mod.SuiClient;
+        if (typeof SuiClient !== "function") {
+            throw new Error("SuiClient not found. For @mysten/sui v2.6.0+, pass suiClient in opts.");
+        }
+        const network = opts.suiNetwork ?? "mainnet";
+        const urls = {
+            testnet: "https://fullnode.testnet.sui.io:443",
+            mainnet: "https://fullnode.mainnet.sui.io:443",
+        };
+        suiClient = new SuiClient({ url: urls[network] ?? urls.mainnet });
+    }
+    // Build signer
+    if (opts.walletSigner) {
+        return {
+            suiClient,
+            signer: opts.walletSigner,
+            address: opts.walletSigner.address,
+            Transaction,
+        };
+    }
+    const { decodeSuiPrivateKey } = await import("@mysten/sui/cryptography");
+    const { Ed25519Keypair } = await import("@mysten/sui/keypairs/ed25519");
+    const { secretKey } = decodeSuiPrivateKey(opts.suiPrivateKey);
+    const keypair = Ed25519Keypair.fromSecretKey(secretKey);
+    return {
+        suiClient,
+        signer: keypair,
+        address: keypair.getPublicKey().toSuiAddress(),
+        Transaction,
+    };
+}
+async function signAndExecute(ctx, tx) {
+    if ("signAndExecuteTransaction" in ctx.signer && typeof ctx.signer.signAndExecuteTransaction === "function" && "address" in ctx.signer) {
+        // WalletSigner mode
+        const result = await ctx.signer.signAndExecuteTransaction({ transaction: tx });
+        // Wait for transaction to be confirmed
+        const txResult = await ctx.suiClient.waitForTransaction({
+            digest: result.digest,
+            options: { showEffects: true, showObjectChanges: true },
+        });
+        return { digest: result.digest, effects: txResult };
+    }
+    // Keypair mode
+    const result = await ctx.suiClient.signAndExecuteTransaction({
+        signer: ctx.signer,
+        transaction: tx,
+    });
+    const txResult = await ctx.suiClient.waitForTransaction({
+        digest: result.digest,
+        options: { showEffects: true, showObjectChanges: true },
+    });
+    return { digest: result.digest, effects: txResult };
+}
+// ============================================================
+// createAccount
+// ============================================================
+/**
+ * Create a new MemWalAccount on-chain.
+ *
+ * Calls `{packageId}::account::create_account(registry, clock)`.
+ * Each address can only create ONE account (enforced by the contract).
+ *
+ * @returns CreateAccountResult with accountId, owner, and tx digest
+ */
+export async function createAccount(opts) {
+    const ctx = await buildTxContext(opts);
+    const { Transaction } = ctx;
+    const tx = new Transaction();
+    tx.moveCall({
+        target: `${opts.packageId}::account::create_account`,
+        arguments: [
+            tx.object(opts.registryId),
+            tx.object(SUI_CLOCK),
+        ],
+    });
+    const { digest, effects } = await signAndExecute(ctx, tx);
+    // Extract the created MemWalAccount object ID from object changes
+    let accountId = "";
+    const objectChanges = effects?.objectChanges ?? [];
+    for (const change of objectChanges) {
+        if (change.type === "created" &&
+            change.objectType?.includes("::account::MemWalAccount")) {
+            accountId = change.objectId;
+            break;
+        }
+    }
+    if (!accountId) {
+        // Fallback: try to find from effects
+        const created = effects?.effects?.created ?? [];
+        for (const obj of created) {
+            if (obj.owner?.Shared !== undefined) {
+                accountId = obj.reference?.objectId ?? "";
+                break;
+            }
+        }
+    }
+    return {
+        accountId,
+        owner: ctx.address,
+        digest,
+    };
+}
+// ============================================================
+// addDelegateKey
+// ============================================================
+/**
+ * Add a delegate key to a MemWalAccount.
+ *
+ * Calls `{packageId}::account::add_delegate_key(account, public_key, sui_address, label, clock)`.
+ * Only the account owner can add delegate keys.
+ *
+ * @param opts.publicKey - Ed25519 public key (32 bytes Uint8Array or hex string)
+ * @param opts.label - Human-readable label (e.g. "MacBook Pro", "Production Server")
+ * @returns AddDelegateKeyResult with digest, publicKey hex, and derived suiAddress
+ */
+export async function addDelegateKey(opts) {
+    const ctx = await buildTxContext(opts);
+    const { Transaction } = ctx;
+    // Normalize public key to Uint8Array
+    const pkBytes = typeof opts.publicKey === "string"
+        ? hexToBytes(opts.publicKey)
+        : opts.publicKey;
+    if (pkBytes.length !== 32) {
+        throw new Error(`Invalid Ed25519 public key length: ${pkBytes.length} (expected 32)`);
+    }
+    // Derive Sui address from the public key
+    const { blake2b } = await import("@noble/hashes/blake2.js");
+    const input = new Uint8Array(33);
+    input[0] = 0x00; // Ed25519 scheme flag
+    input.set(pkBytes, 1);
+    const addressBytes = blake2b(input, { dkLen: 32 });
+    const suiAddress = "0x" + bytesToHex(addressBytes);
+    const tx = new Transaction();
+    tx.moveCall({
+        target: `${opts.packageId}::account::add_delegate_key`,
+        arguments: [
+            tx.object(opts.accountId),
+            tx.pure("vector<u8>", Array.from(pkBytes)),
+            tx.pure("address", suiAddress),
+            tx.pure("string", opts.label),
+            tx.object(SUI_CLOCK),
+        ],
+    });
+    const { digest } = await signAndExecute(ctx, tx);
+    return {
+        digest,
+        publicKey: bytesToHex(pkBytes),
+        suiAddress,
+    };
+}
+// ============================================================
+// removeDelegateKey
+// ============================================================
+/**
+ * Remove a delegate key from a MemWalAccount.
+ *
+ * Calls `{packageId}::account::remove_delegate_key(account, public_key)`.
+ * Only the account owner can remove delegate keys.
+ *
+ * @param opts.publicKey - Ed25519 public key to remove (32 bytes Uint8Array or hex string)
+ */
+export async function removeDelegateKey(opts) {
+    const ctx = await buildTxContext(opts);
+    const { Transaction } = ctx;
+    const pkBytes = typeof opts.publicKey === "string"
+        ? hexToBytes(opts.publicKey)
+        : opts.publicKey;
+    if (pkBytes.length !== 32) {
+        throw new Error(`Invalid Ed25519 public key length: ${pkBytes.length} (expected 32)`);
+    }
+    const tx = new Transaction();
+    tx.moveCall({
+        target: `${opts.packageId}::account::remove_delegate_key`,
+        arguments: [
+            tx.object(opts.accountId),
+            tx.pure("vector<u8>", Array.from(pkBytes)),
+        ],
+    });
+    const { digest } = await signAndExecute(ctx, tx);
+    return { digest };
+}
+// ============================================================
+// generateDelegateKey
+// ============================================================
+/**
+ * Generate a new Ed25519 delegate keypair.
+ *
+ * Returns the private key (hex), public key (bytes), and derived Sui address.
+ * The private key can be used with `MemWal.create({ key })`.
+ *
+ * @example
+ * ```typescript
+ * const delegate = await generateDelegateKey()
+ * console.log(delegate.privateKey)  // hex string — store securely!
+ * console.log(delegate.suiAddress)  // 0x... — use in addDelegateKey
+ *
+ * // Use with SDK
+ * const memwal = MemWal.create({ key: delegate.privateKey, accountId: "0x..." })
+ * ```
+ */
+export async function generateDelegateKey() {
+    const ed = await import("@noble/ed25519");
+    const { blake2b } = await import("@noble/hashes/blake2.js");
+    // Generate random 32-byte private key
+    const privateKeyBytes = new Uint8Array(32);
+    globalThis.crypto.getRandomValues(privateKeyBytes);
+    const publicKey = await ed.getPublicKeyAsync(privateKeyBytes);
+    // Derive Sui address
+    const input = new Uint8Array(33);
+    input[0] = 0x00; // Ed25519 scheme flag
+    input.set(publicKey, 1);
+    const addressBytes = blake2b(input, { dkLen: 32 });
+    const suiAddress = "0x" + bytesToHex(addressBytes);
+    return {
+        privateKey: bytesToHex(privateKeyBytes),
+        publicKey,
+        suiAddress,
+    };
+}
+//# sourceMappingURL=account.js.map

package/dist/account.js.map

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

package/dist/ai/index.d.ts

@@ -0,0 +1,3 @@
+export { withMemWal } from "./middleware.js";
+export type { WithMemWalOptions } from "./middleware.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/ai/index.js

@@ -0,0 +1,2 @@
+export { withMemWal } from "./middleware.js";
+//# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/ai/middleware.d.ts

@@ -0,0 +1,55 @@
+/**
+ * MemWal AI SDK Integration — withMemWal Middleware
+ *
+ * Wraps any AI SDK model with automatic memory management.
+ *
+ * @example
+ * ```typescript
+ * import { generateText } from "ai"
+ * import { withMemWal } from "@mysten-incubation/memwal/ai"
+ * import { openai } from "@ai-sdk/openai"
+ *
+ * const model = withMemWal(openai("gpt-4o"), {
+ *   key: process.env.MEMWAL_KEY,  // Ed25519 delegate key (hex)
+ * })
+ *
+ * const result = await generateText({
+ *   model,
+ *   messages: [{ role: "user", content: "What do you know about me?" }]
+ * })
+ * // → Automatically searches memories, injects context, saves new facts
+ * ```
+ */
+import type { MemWalConfig } from "../types.js";
+/**
+ * Accept both LanguageModelV2 (ai SDK v4/v5) and LanguageModelV3 (ai SDK v6+).
+ * We use `any` because LanguageModelV3 may not exist in older @ai-sdk/provider,
+ * and the two interfaces are structurally incompatible at the type level.
+ * `wrapLanguageModel` from `ai` handles version detection internally.
+ */
+type AnyLanguageModel = any;
+export interface WithMemWalOptions extends MemWalConfig {
+    /** Max memories to inject per request (default: 5) */
+    maxMemories?: number;
+    /** Auto-save new facts from conversation (default: true) */
+    autoSave?: boolean;
+    /** Minimum similarity score to include a memory (0-1, default: 0.3) */
+    minRelevance?: number;
+    /** Enable debug logging (default: false) */
+    debug?: boolean;
+}
+/**
+ * Wrap an AI SDK model with MemWal memory management
+ *
+ * BEFORE each LLM call:
+ * - Uses the last user message as a search query
+ * - Recalls relevant memories (server: search → download → decrypt)
+ * - Injects relevant memories into the system prompt
+ *
+ * AFTER each LLM call:
+ * - Analyzes and saves important facts (server: LLM extract → embed → encrypt → Walrus → store)
+ * - Fire-and-forget — does not block the response
+ */
+export declare function withMemWal(model: AnyLanguageModel, options: WithMemWalOptions): any;
+export {};
+//# sourceMappingURL=middleware.d.ts.map

package/dist/ai/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/ai/middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,aAAa,CAAC;AAM9D;;;;;GAKG;AAEH,KAAK,gBAAgB,GAAG,GAAG,CAAC;AAE5B,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACnD,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACtB,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,iBAAiB,OAmF7B"}