@agenticprimitives/account-custody 0.1.0-alpha.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agentic Trust Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+# @agenticprimitives/account-custody
+
+Custody-layer SDK for Smart Agent account safety and recovery.
+
+This package owns the TypeScript surface around `CustodyPolicy`: ABI exports,
+`CustodyAction` argument builders, EIP-712 typed data, quorum signature packing,
+and custody-domain types.
+
+## Install
+
+```bash
+pnpm add @agenticprimitives/account-custody
+```
+
+## Use
+
+```ts
+import {
+  CustodyAction,
+  buildRecoverAccountArgs,
+  custodyDomain,
+  packQuorumSigs,
+} from '@agenticprimitives/account-custody';
+```
+
+## Boundary
+
+This package speaks custody vocabulary only:
+
+- `Custodian`
+- `Trustee`
+- `CustodyCouncil`
+- `CustodyAction`
+- `ScheduledChange`
+
+It does not own delegation caveats, MCP transport, passkey ceremonies, account
+deployment, or key-custody providers. See `CLAUDE.md` for routing.
+
+## Validate
+
+```bash
+pnpm --filter @agenticprimitives/account-custody typecheck
+pnpm --filter @agenticprimitives/account-custody test
+```

package/dist/abi.d.ts

@@ -0,0 +1,280 @@
+export declare const custodyPolicyAbi: readonly [{
+    readonly type: "function";
+    readonly name: "scheduleCustodyChange";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }, {
+        readonly name: "action";
+        readonly type: "uint8";
+    }, {
+        readonly name: "args";
+        readonly type: "bytes";
+    }, {
+        readonly name: "quorumSigs";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "changeId";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "applyCustodyChange";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }, {
+        readonly name: "changeId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "quorumSigs";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "cancelScheduledChange";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }, {
+        readonly name: "changeId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "quorumSigs";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "isInstalledOn";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "domainSeparator";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "bytes32";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "custodyMode";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint8";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "approvalsRequired";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }, {
+        readonly name: "tier";
+        readonly type: "uint8";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint8";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "recoveryApprovals";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint8";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "t3HighValueCeiling";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "safetyDelay";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }, {
+        readonly name: "tier";
+        readonly type: "uint8";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint32";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "isTrustee";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }, {
+        readonly name: "signer";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "trusteeCount";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "scheduledChangeCount";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "defaultApprovals";
+    readonly stateMutability: "pure";
+    readonly inputs: readonly [{
+        readonly name: "nCustodians";
+        readonly type: "uint8";
+    }, {
+        readonly name: "tier";
+        readonly type: "uint8";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint8";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "getScheduledChange";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }, {
+        readonly name: "changeId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "action";
+        readonly type: "uint8";
+    }, {
+        readonly name: "args";
+        readonly type: "bytes";
+    }, {
+        readonly name: "proposedAt";
+        readonly type: "uint64";
+    }, {
+        readonly name: "eta";
+        readonly type: "uint64";
+    }, {
+        readonly name: "proposer";
+        readonly type: "address";
+    }, {
+        readonly name: "executed";
+        readonly type: "bool";
+    }, {
+        readonly name: "cancelled";
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "CustodyChangeScheduled";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "changeId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "action";
+        readonly type: "uint8";
+        readonly indexed: true;
+    }, {
+        readonly name: "eta";
+        readonly type: "uint64";
+        readonly indexed: false;
+    }, {
+        readonly name: "proposer";
+        readonly type: "address";
+        readonly indexed: false;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "CustodyChangeApplied";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "changeId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "ScheduledChangeCancelled";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "changeId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "CustodyPolicyInstalled";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "mode";
+        readonly type: "uint8";
+        readonly indexed: false;
+    }, {
+        readonly name: "recoveryApprovals";
+        readonly type: "uint8";
+        readonly indexed: false;
+    }];
+}];
+//# sourceMappingURL=abi.d.ts.map

package/dist/abi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abi.d.ts","sourceRoot":"","sources":["../src/abi.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoGnB,CAAC"}

package/dist/abi.js

@@ -0,0 +1,107 @@
+// CustodyPolicy ABI — source of truth: packages/contracts/src/custody/CustodyPolicy.sol
+// (spec 207 / 209 / 213).
+//
+// This is the typed-data + chain-call surface a custody UI needs. All
+// callers should import from here rather than declaring the ABI inline.
+export const custodyPolicyAbi = [
+    // ─── Mutating: schedule / apply / cancel ─────────────────────────────
+    {
+        type: 'function',
+        name: 'scheduleCustodyChange',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'account', type: 'address' },
+            { name: 'action', type: 'uint8' },
+            { name: 'args', type: 'bytes' },
+            { name: 'quorumSigs', type: 'bytes' },
+        ],
+        outputs: [{ name: 'changeId', type: 'uint256' }],
+    },
+    {
+        type: 'function',
+        name: 'applyCustodyChange',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'account', type: 'address' },
+            { name: 'changeId', type: 'uint256' },
+            { name: 'quorumSigs', type: 'bytes' },
+        ],
+        outputs: [],
+    },
+    {
+        type: 'function',
+        name: 'cancelScheduledChange',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'account', type: 'address' },
+            { name: 'changeId', type: 'uint256' },
+            { name: 'quorumSigs', type: 'bytes' },
+        ],
+        outputs: [],
+    },
+    // ─── Views ──────────────────────────────────────────────────────────
+    { type: 'function', name: 'isInstalledOn', stateMutability: 'view', inputs: [{ name: 'account', type: 'address' }], outputs: [{ type: 'bool' }] },
+    { type: 'function', name: 'domainSeparator', stateMutability: 'view', inputs: [], outputs: [{ type: 'bytes32' }] },
+    { type: 'function', name: 'custodyMode', stateMutability: 'view', inputs: [{ name: 'account', type: 'address' }], outputs: [{ type: 'uint8' }] },
+    { type: 'function', name: 'approvalsRequired', stateMutability: 'view', inputs: [{ name: 'account', type: 'address' }, { name: 'tier', type: 'uint8' }], outputs: [{ type: 'uint8' }] },
+    { type: 'function', name: 'recoveryApprovals', stateMutability: 'view', inputs: [{ name: 'account', type: 'address' }], outputs: [{ type: 'uint8' }] },
+    { type: 'function', name: 't3HighValueCeiling', stateMutability: 'view', inputs: [{ name: 'account', type: 'address' }], outputs: [{ type: 'uint256' }] },
+    { type: 'function', name: 'safetyDelay', stateMutability: 'view', inputs: [{ name: 'account', type: 'address' }, { name: 'tier', type: 'uint8' }], outputs: [{ type: 'uint32' }] },
+    { type: 'function', name: 'isTrustee', stateMutability: 'view', inputs: [{ name: 'account', type: 'address' }, { name: 'signer', type: 'address' }], outputs: [{ type: 'bool' }] },
+    { type: 'function', name: 'trusteeCount', stateMutability: 'view', inputs: [{ name: 'account', type: 'address' }], outputs: [{ type: 'uint256' }] },
+    { type: 'function', name: 'scheduledChangeCount', stateMutability: 'view', inputs: [{ name: 'account', type: 'address' }], outputs: [{ type: 'uint256' }] },
+    { type: 'function', name: 'defaultApprovals', stateMutability: 'pure', inputs: [{ name: 'nCustodians', type: 'uint8' }, { name: 'tier', type: 'uint8' }], outputs: [{ type: 'uint8' }] },
+    {
+        type: 'function',
+        name: 'getScheduledChange',
+        stateMutability: 'view',
+        inputs: [{ name: 'account', type: 'address' }, { name: 'changeId', type: 'uint256' }],
+        outputs: [
+            { name: 'action', type: 'uint8' },
+            { name: 'args', type: 'bytes' },
+            { name: 'proposedAt', type: 'uint64' },
+            { name: 'eta', type: 'uint64' },
+            { name: 'proposer', type: 'address' },
+            { name: 'executed', type: 'bool' },
+            { name: 'cancelled', type: 'bool' },
+        ],
+    },
+    // ─── Events ─────────────────────────────────────────────────────────
+    {
+        type: 'event',
+        name: 'CustodyChangeScheduled',
+        inputs: [
+            { name: 'account', type: 'address', indexed: true },
+            { name: 'changeId', type: 'uint256', indexed: true },
+            { name: 'action', type: 'uint8', indexed: true },
+            { name: 'eta', type: 'uint64', indexed: false },
+            { name: 'proposer', type: 'address', indexed: false },
+        ],
+    },
+    {
+        type: 'event',
+        name: 'CustodyChangeApplied',
+        inputs: [
+            { name: 'account', type: 'address', indexed: true },
+            { name: 'changeId', type: 'uint256', indexed: true },
+        ],
+    },
+    {
+        type: 'event',
+        name: 'ScheduledChangeCancelled',
+        inputs: [
+            { name: 'account', type: 'address', indexed: true },
+            { name: 'changeId', type: 'uint256', indexed: true },
+        ],
+    },
+    {
+        type: 'event',
+        name: 'CustodyPolicyInstalled',
+        inputs: [
+            { name: 'account', type: 'address', indexed: true },
+            { name: 'mode', type: 'uint8', indexed: false },
+            { name: 'recoveryApprovals', type: 'uint8', indexed: false },
+        ],
+    },
+];
+//# sourceMappingURL=abi.js.map

package/dist/abi.js.map

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

package/dist/actions.d.ts

@@ -0,0 +1,90 @@
+import { type Address, type Hex } from 'viem';
+export declare enum CustodyAction {
+    AddCustodian = 0,
+    RemoveCustodian = 1,
+    AddPasskeyCredential = 2,
+    RemovePasskeyCredential = 3,
+    AddTrustee = 4,
+    RemoveTrustee = 5,
+    ChangeCustodyMode = 6,
+    ApplySystemUpdate = 7,
+    RotateDelegationManager = 8,
+    RotatePaymaster = 9,
+    RotateSessionIssuer = 10,
+    RotateAllCustodians = 11,
+    ChangeValueCeiling = 12,
+    SetRecoveryApprovals = 13,
+    RecoverAccount = 14,
+    ChangeApprovalsRequired = 15
+}
+export declare function buildAddCustodianArgs(custodian: Address): Hex;
+export declare function buildRemoveCustodianArgs(custodian: Address): Hex;
+export declare function buildAddTrusteeArgs(trustee: Address): Hex;
+export declare function buildRemoveTrusteeArgs(trustee: Address): Hex;
+export declare function buildChangeCustodyModeArgs(newMode: 0 | 1 | 2 | 3): Hex;
+export declare function buildChangeValueCeilingArgs(newCeilingWei: bigint): Hex;
+/**
+ * Encode args for `SetRecoveryApprovals(newThreshold)`.
+ *
+ * The on-chain CustodyPolicy rejects `newThreshold == 0` (Wave 2C C-9)
+ * to prevent T4-quorum-induced silent recovery disable. The builder
+ * does NOT enforce that ceiling because the upper bound is the
+ * runtime trustee count; on-chain validation catches an over-threshold.
+ */
+export declare function buildSetRecoveryApprovalsArgs(approvals: number): Hex;
+export declare function buildApplySystemUpdateArgs(newImpl: Address): Hex;
+/**
+ * Encode args for `ChangeApprovalsRequired(tier, newCount)`.
+ *
+ * `tier` is a RiskTier in [1, 5] — T6 (recovery) lives in a separate
+ * slot and is set via `buildSetRecoveryApprovalsArgs`. `newCount` must
+ * satisfy `1 <= newCount <= account.custodianCount()` at apply time.
+ */
+export declare function buildChangeApprovalsRequiredArgs(tier: number, newCount: number): Hex;
+/**
+ * Encode args for `AddPasskeyCredential(credentialIdDigest, x, y)`.
+ * Side effect on AgentAccount: also registers the PIA derived from
+ * `(x, y)` as a first-class custodian.
+ *
+ * Wave 2C C-6 hardening: on-chain initializer rejects credentialIdDigest
+ * == 0; this builder echoes that check at the wire-format boundary so
+ * the demo never spends gas on a guaranteed-revert tx.
+ */
+export declare function buildAddPasskeyCredentialArgs(credentialIdDigest: Hex, x: bigint, y: bigint): Hex;
+/** Encode args for `RemovePasskeyCredential(credentialIdDigest)`. */
+export declare function buildRemovePasskeyCredentialArgs(credentialIdDigest: Hex): Hex;
+/**
+ * Encode args for `RotateAllCustodians(addCustodians, removeCustodians)`
+ * (Wave 2C C-10). Adds the new set + removes the old in one atomic action;
+ * factory enforces that at-least-one custodian remains.
+ */
+export declare function buildRotateAllCustodiansArgs(addCustodians: readonly Address[], removeCustodians: readonly Address[]): Hex;
+/**
+ * One passkey to add inside a T6 recovery — mirrors the Solidity
+ * `AgentAccountRecoveryPasskeyAdd` struct.
+ */
+export interface RecoveryPasskeyAdd {
+    credentialIdDigest: Hex;
+    x: bigint;
+    y: bigint;
+}
+/**
+ * Encode args for `RecoverAccount(args)` — atomic add/remove of owners
+ * and passkeys in one T6 action so the signer set doesn't pass through
+ * a half-rotated intermediate state.
+ *
+ * Solidity struct (from packages/contracts/src/IAgentAccount.sol):
+ *   struct AgentAccountRecoveryArgs {
+ *     address[] addOwners;
+ *     address[] removeOwners;
+ *     AgentAccountRecoveryPasskeyAdd[] addPasskeys;
+ *     bytes32[] removePasskeyCredentialIdDigests;
+ *   }
+ */
+export declare function buildRecoverAccountArgs(args: {
+    addOwners?: readonly Address[];
+    removeOwners?: readonly Address[];
+    addPasskeys?: readonly RecoveryPasskeyAdd[];
+    removePasskeyCredentialIdDigests?: readonly Hex[];
+}): Hex;
+//# sourceMappingURL=actions.d.ts.map

package/dist/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAQA,OAAO,EAAuB,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAEnE,oBAAY,aAAa;IACvB,YAAY,IAAI;IAChB,eAAe,IAAI;IACnB,oBAAoB,IAAI;IACxB,uBAAuB,IAAI;IAC3B,UAAU,IAAI;IACd,aAAa,IAAI;IACjB,iBAAiB,IAAI;IACrB,iBAAiB,IAAI;IACrB,uBAAuB,IAAI;IAC3B,eAAe,IAAI;IACnB,mBAAmB,KAAK;IACxB,mBAAmB,KAAK;IACxB,kBAAkB,KAAK;IACvB,oBAAoB,KAAK;IACzB,cAAc,KAAK;IACnB,uBAAuB,KAAK;CAC7B;AAuCD,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,OAAO,GAAG,GAAG,CAG7D;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,OAAO,GAAG,GAAG,CAGhE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,GAAG,CAGzD;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,GAAG,CAG5D;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAGtE;AAED,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,GAAG,CAGtE;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAGpE;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,GAAG,CAGhE;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,CAOpF;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,kBAAkB,EAAE,GAAG,EACvB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,GAAG,CAWL;AAED,qEAAqE;AACrE,wBAAgB,gCAAgC,CAAC,kBAAkB,EAAE,GAAG,GAAG,GAAG,CAG7E;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,aAAa,EAAE,SAAS,OAAO,EAAE,EACjC,gBAAgB,EAAE,SAAS,OAAO,EAAE,GACnC,GAAG,CAOL;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,kBAAkB,EAAE,GAAG,CAAC;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,SAAS,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC/B,YAAY,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAClC,WAAW,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC5C,gCAAgC,CAAC,EAAE,SAAS,GAAG,EAAE,CAAC;CACnD,GAAG,GAAG,CAwDN"}