@agenticprimitives/agent-profile 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,113 @@
+# @agenticprimitives/agent-profile
+
+Typed **profile facet** for Smart Agents — AgentCard schema, CAIP-10 helpers,
+and endpoint-verification methods.
+
+The canonical identifier is the Smart Agent address (`agent-account`). This
+package publishes and verifies off-chain profile manifests **about** that
+address. It does not deploy accounts, resolve `.agent` names, or run login
+ceremonies.
+
+> **Layer:** Discover — a profile **facet** (not login — that is `connect-auth`; not canonical identity — that is `agent-account`).
+> **Canonical key:** the Smart Agent address the AgentCard describes.
+
+Where [`agent-naming`](../agent-naming) maps names → addresses, this package
+maps addresses → typed profiles and optional endpoint-control proofs.
+
+## Use This When
+
+- You author or validate an `AgentCard` (person, org, service, MCP server, …).
+- You need deterministic `profileContentHash` for on-chain `metadata-hash`.
+- You need CAIP-10 `nativeId` encode/decode (strict encode, permissive decode).
+- You need endpoint verification methods (DNS TXT, signed URL, …) — Phase 2+.
+- You build encoded calls to register or update on-chain profile anchors.
+
+## Do Not Use This For
+
+- `.agent` names or namehash → `agent-naming`.
+- Smart Agent deploy / UserOps → `agent-account`.
+- Passkey / SIWE / JWT → `connect-auth`.
+- Trust-fabric edges → `agent-relationships`.
+- UAID string generation → refused ([ADR-0008](../../docs/architecture/decisions/0008-caip10-nativeid-record-predicate.md)).
+
+## Install
+
+Workspace-internal; not yet published.
+
+```bash
+pnpm add @agenticprimitives/agent-profile
+```
+
+## 60-Second Quickstart
+
+```ts
+import {
+  canonicalProfileJson,
+  profileContentHash,
+  buildCaip10Address,
+  type AgentCard,
+} from '@agenticprimitives/agent-profile';
+
+const canonicalAddr = '0x0000000000000000000000000000000000000003' as const;
+
+const profile: AgentCard = {
+  type: 'person',
+  displayName: 'Alice',
+};
+
+const hash = profileContentHash(profile);
+const nativeId = buildCaip10Address({
+  namespace: 'eip155',
+  reference: '84532',
+  address: canonicalAddr,
+});
+// Anchor hash + nativeId on chain via agent-naming records or profile resolver.
+```
+
+## Main Concepts
+
+- **AgentCard**: HCS-11-aligned typed JSON discriminated by `type`.
+- **Profile facet**: `metadata-uri` + `metadata-hash` pointing at the canonical SA.
+- **CAIP-10 `nativeId`**: cross-registry back-link; must match SA on EVM chains.
+- **Verification**: proves an MCP/A2A URL is controlled by the SA (not naming).
+
+See [`docs/concepts.md`](docs/concepts.md).
+
+## Subpath Exports
+
+- `@agenticprimitives/agent-profile/caip10` — CAIP-10 helpers only.
+- `@agenticprimitives/agent-profile/profile` — canonical JSON + content hash.
+
+## Status
+
+Phase 1 — pure helpers + client skeleton. `AgentIdentityClient` reads throw
+`I Phase 2`; writes throw `I Phase 4`. Shape is locked for demo authoring.
+
+## Security Invariants
+
+- Profile content-hash is deterministic (canonical JSON).
+- No raw passkey material in profiles.
+- Verification methods are explicit, not auto-selected.
+
+See [`docs/security.md`](docs/security.md) and [`AUDIT.md`](AUDIT.md).
+
+## Documentation Map
+
+- [`docs/concepts.md`](docs/concepts.md) — profile facet vs canonical SA.
+- [`docs/api.md`](docs/api.md) — public API guide.
+- [`docs/security.md`](docs/security.md) — invariants.
+- [`docs/troubleshooting.md`](docs/troubleshooting.md) — common errors.
+- [`docs/migration.md`](docs/migration.md) — migration notes.
+- [`CLAUDE.md`](CLAUDE.md) — agent routing.
+- [`spec.md`](spec.md) — spec pointer.
+
+## Validation
+
+```bash
+pnpm check:agent-profile
+pnpm check:forbidden-terms
+```
+
+## License
+
+UNLICENSED.

package/dist/abis.d.ts

@@ -0,0 +1,336 @@
+export declare const agentProfileResolverAbi: readonly [{
+    readonly type: "error";
+    readonly name: "NotAgentOwner";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "AlreadyRegistered";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NotRegistered";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "PredicateNotActive";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "AttributeNotSet";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "event";
+    readonly name: "AgentRegistered";
+    readonly inputs: readonly [{
+        readonly name: "agent";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "displayName";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "agentKind";
+        readonly type: "bytes32";
+        readonly indexed: true;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "MetadataUpdated";
+    readonly inputs: readonly [{
+        readonly name: "agent";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "metadataURI";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "metadataHash";
+        readonly type: "bytes32";
+        readonly indexed: false;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "PropertySet";
+    readonly inputs: readonly [{
+        readonly name: "agent";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "predicate";
+        readonly type: "bytes32";
+        readonly indexed: true;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "AttributeSet";
+    readonly inputs: readonly [{
+        readonly name: "subject";
+        readonly type: "bytes32";
+        readonly indexed: true;
+    }, {
+        readonly name: "predicate";
+        readonly type: "bytes32";
+        readonly indexed: true;
+    }, {
+        readonly name: "datatype";
+        readonly type: "uint8";
+        readonly indexed: false;
+    }, {
+        readonly name: "version";
+        readonly type: "uint64";
+        readonly indexed: false;
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "ONTOLOGY";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "register";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agent";
+        readonly type: "address";
+    }, {
+        readonly name: "displayName";
+        readonly type: "string";
+    }, {
+        readonly name: "description";
+        readonly type: "string";
+    }, {
+        readonly name: "agentKind";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "profileSchemaURI";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "setMetadata";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agent";
+        readonly type: "address";
+    }, {
+        readonly name: "metadataURI";
+        readonly type: "string";
+    }, {
+        readonly name: "metadataHash";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "setStringProperty";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agent";
+        readonly type: "address";
+    }, {
+        readonly name: "predicate";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "value";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "setAddressProperty";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agent";
+        readonly type: "address";
+    }, {
+        readonly name: "predicate";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "value";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "setBoolProperty";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agent";
+        readonly type: "address";
+    }, {
+        readonly name: "predicate";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "value";
+        readonly type: "bool";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "setBytes32Property";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agent";
+        readonly type: "address";
+    }, {
+        readonly name: "predicate";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "value";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "setUintProperty";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agent";
+        readonly type: "address";
+    }, {
+        readonly name: "predicate";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "setActive";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agent";
+        readonly type: "address";
+    }, {
+        readonly name: "active";
+        readonly type: "bool";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "isRegistered";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agent";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "getStringProperty";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agent";
+        readonly type: "address";
+    }, {
+        readonly name: "predicate";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "getAddressProperty";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agent";
+        readonly type: "address";
+    }, {
+        readonly name: "predicate";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "getBoolProperty";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agent";
+        readonly type: "address";
+    }, {
+        readonly name: "predicate";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "getBytes32Property";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agent";
+        readonly type: "address";
+    }, {
+        readonly name: "predicate";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bytes32";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "getUintProperty";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agent";
+        readonly type: "address";
+    }, {
+        readonly name: "predicate";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "getPredicateKeys";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agent";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bytes32[]";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "agentCount";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "getAllAgents";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "address[]";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "subjectFor";
+    readonly stateMutability: "pure";
+    readonly inputs: readonly [{
+        readonly name: "agent";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bytes32";
+    }];
+}];
+//# sourceMappingURL=abis.d.ts.map

package/dist/abis.d.ts.map

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

package/dist/abis.js

@@ -0,0 +1,98 @@
+// Identity-contract ABIs — source of truth:
+// packages/contracts/src/identity/*.sol (spec 217 / ID Phase 3).
+// AgentProfileResolver inherits the shared AttributeStorage from the
+// NS Phase 3 ontology stack; predicates registered in
+// OntologyTermRegistry govern what can be written.
+export const agentProfileResolverAbi = [
+    { type: 'error', name: 'NotAgentOwner', inputs: [] },
+    { type: 'error', name: 'AlreadyRegistered', inputs: [] },
+    { type: 'error', name: 'NotRegistered', inputs: [] },
+    // From AttributeStorage base.
+    { type: 'error', name: 'PredicateNotActive', inputs: [] },
+    { type: 'error', name: 'AttributeNotSet', inputs: [] },
+    {
+        type: 'event', name: 'AgentRegistered',
+        inputs: [
+            { name: 'agent', type: 'address', indexed: true },
+            { name: 'displayName', type: 'string', indexed: false },
+            { name: 'agentKind', type: 'bytes32', indexed: true },
+        ],
+    },
+    {
+        type: 'event', name: 'MetadataUpdated',
+        inputs: [
+            { name: 'agent', type: 'address', indexed: true },
+            { name: 'metadataURI', type: 'string', indexed: false },
+            { name: 'metadataHash', type: 'bytes32', indexed: false },
+        ],
+    },
+    {
+        type: 'event', name: 'PropertySet',
+        inputs: [
+            { name: 'agent', type: 'address', indexed: true },
+            { name: 'predicate', type: 'bytes32', indexed: true },
+        ],
+    },
+    // From AttributeStorage base.
+    {
+        type: 'event', name: 'AttributeSet',
+        inputs: [
+            { name: 'subject', type: 'bytes32', indexed: true },
+            { name: 'predicate', type: 'bytes32', indexed: true },
+            { name: 'datatype', type: 'uint8', indexed: false },
+            { name: 'version', type: 'uint64', indexed: false },
+        ],
+    },
+    { type: 'function', name: 'ONTOLOGY', stateMutability: 'view', inputs: [], outputs: [{ type: 'address' }] },
+    // ─── Writes ─────────────────────────────────────────────────────
+    {
+        type: 'function', name: 'register', stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'agent', type: 'address' },
+            { name: 'displayName', type: 'string' },
+            { name: 'description', type: 'string' },
+            { name: 'agentKind', type: 'bytes32' },
+            { name: 'profileSchemaURI', type: 'string' },
+        ], outputs: [],
+    },
+    {
+        type: 'function', name: 'setMetadata', stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'agent', type: 'address' },
+            { name: 'metadataURI', type: 'string' },
+            { name: 'metadataHash', type: 'bytes32' },
+        ], outputs: [],
+    },
+    { type: 'function', name: 'setStringProperty', stateMutability: 'nonpayable',
+        inputs: [{ name: 'agent', type: 'address' }, { name: 'predicate', type: 'bytes32' }, { name: 'value', type: 'string' }], outputs: [] },
+    { type: 'function', name: 'setAddressProperty', stateMutability: 'nonpayable',
+        inputs: [{ name: 'agent', type: 'address' }, { name: 'predicate', type: 'bytes32' }, { name: 'value', type: 'address' }], outputs: [] },
+    { type: 'function', name: 'setBoolProperty', stateMutability: 'nonpayable',
+        inputs: [{ name: 'agent', type: 'address' }, { name: 'predicate', type: 'bytes32' }, { name: 'value', type: 'bool' }], outputs: [] },
+    { type: 'function', name: 'setBytes32Property', stateMutability: 'nonpayable',
+        inputs: [{ name: 'agent', type: 'address' }, { name: 'predicate', type: 'bytes32' }, { name: 'value', type: 'bytes32' }], outputs: [] },
+    { type: 'function', name: 'setUintProperty', stateMutability: 'nonpayable',
+        inputs: [{ name: 'agent', type: 'address' }, { name: 'predicate', type: 'bytes32' }, { name: 'value', type: 'uint256' }], outputs: [] },
+    { type: 'function', name: 'setActive', stateMutability: 'nonpayable',
+        inputs: [{ name: 'agent', type: 'address' }, { name: 'active', type: 'bool' }], outputs: [] },
+    // ─── Reads ──────────────────────────────────────────────────────
+    { type: 'function', name: 'isRegistered', stateMutability: 'view',
+        inputs: [{ name: 'agent', type: 'address' }], outputs: [{ type: 'bool' }] },
+    { type: 'function', name: 'getStringProperty', stateMutability: 'view',
+        inputs: [{ name: 'agent', type: 'address' }, { name: 'predicate', type: 'bytes32' }], outputs: [{ type: 'string' }] },
+    { type: 'function', name: 'getAddressProperty', stateMutability: 'view',
+        inputs: [{ name: 'agent', type: 'address' }, { name: 'predicate', type: 'bytes32' }], outputs: [{ type: 'address' }] },
+    { type: 'function', name: 'getBoolProperty', stateMutability: 'view',
+        inputs: [{ name: 'agent', type: 'address' }, { name: 'predicate', type: 'bytes32' }], outputs: [{ type: 'bool' }] },
+    { type: 'function', name: 'getBytes32Property', stateMutability: 'view',
+        inputs: [{ name: 'agent', type: 'address' }, { name: 'predicate', type: 'bytes32' }], outputs: [{ type: 'bytes32' }] },
+    { type: 'function', name: 'getUintProperty', stateMutability: 'view',
+        inputs: [{ name: 'agent', type: 'address' }, { name: 'predicate', type: 'bytes32' }], outputs: [{ type: 'uint256' }] },
+    { type: 'function', name: 'getPredicateKeys', stateMutability: 'view',
+        inputs: [{ name: 'agent', type: 'address' }], outputs: [{ type: 'bytes32[]' }] },
+    { type: 'function', name: 'agentCount', stateMutability: 'view', inputs: [], outputs: [{ type: 'uint256' }] },
+    { type: 'function', name: 'getAllAgents', stateMutability: 'view', inputs: [], outputs: [{ type: 'address[]' }] },
+    { type: 'function', name: 'subjectFor', stateMutability: 'pure',
+        inputs: [{ name: 'agent', type: 'address' }], outputs: [{ type: 'bytes32' }] },
+];
+//# sourceMappingURL=abis.js.map

package/dist/abis.js.map

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

package/dist/caip10.d.ts

@@ -0,0 +1,37 @@
+/**
+ * CAIP-10 chain-agnostic account identifier helpers (HCS-14 +
+ * ERC-8004 aligned; ADR-0008).
+ *
+ * Subpath: `@agenticprimitives/agent-profile/caip10`.
+ *
+ * Grammar (per CAIP-10):
+ *   <namespace>:<reference>:<address>
+ *
+ * Encoder is strict (allowlist-only namespaces); decoder is permissive
+ * (any grammar-valid string accepted) — this is the "validate at write,
+ * forward-compat at read" pattern.
+ */
+import { CAIP10_NAMESPACE_ALLOWLIST } from './constants';
+import type { Caip10Address, Caip10Parts } from '@agenticprimitives/types';
+export type { Caip10Address, Caip10Parts };
+export { CAIP10_NAMESPACE_ALLOWLIST };
+/**
+ * Build a CAIP-10 string. Strict on the encode side — namespace must
+ * be in `CAIP10_NAMESPACE_ALLOWLIST`. Address half is lowercased for
+ * `eip155` so callers can't smuggle two different on-chain canonical
+ * forms past the equality check.
+ */
+export declare function buildCaip10Address(parts: Caip10Parts): Caip10Address;
+/**
+ * Parse any grammar-valid CAIP-10 string into its parts. Permissive on
+ * the read side — does NOT require namespace allowlist membership
+ * (forward-compat: future indexers may publish namespaces we haven't
+ * yet added). Throws only on grammar violations.
+ */
+export declare function parseCaip10(value: string): Caip10Parts;
+/**
+ * Grammar-only validity check (does NOT enforce the allowlist).
+ * Use `buildCaip10Address` if you need allowlist enforcement.
+ */
+export declare function isValidCaip10(value: string): boolean;
+//# sourceMappingURL=caip10.d.ts.map

package/dist/caip10.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip10.d.ts","sourceRoot":"","sources":["../src/caip10.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAM3E,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC;AAC3C,OAAO,EAAE,0BAA0B,EAAE,CAAC;AAItC;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,aAAa,CAcpE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAMtD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD"}