@hashgraphonline/standards-sdk 0.1.185 → 0.1.187

package/dist/es/standards-sdk.es164.js

@@ -1,141 +1,61 @@
-import { AccountId, Client, PrivateKey } from "@hashgraph/sdk";
-import { detectKeyTypeFromString } from "./standards-sdk.es134.js";
-class NodeOperatorResolver {
-  constructor(params) {
-    this.mirror = params.mirrorNode;
-    this.logger = params.logger;
-  }
-  /**
-   * Best-guess parsing for an operator key without network calls.
-   * - If PrivateKey: returns immediately with provided or fallback type.
-   * - If string with explicitType: parse directly.
-   * - If string without type: detect format; fallback to ECDSA.
-   */
-  bestGuessOperatorKey(operatorKeyInput, explicitType) {
-    if (typeof operatorKeyInput !== "string") {
-      return { keyType: explicitType || "ecdsa", privateKey: operatorKeyInput };
-    }
-    if (explicitType) {
-      const pk = explicitType === "ed25519" ? PrivateKey.fromStringED25519(operatorKeyInput) : PrivateKey.fromStringECDSA(operatorKeyInput);
-      return { keyType: explicitType, privateKey: pk };
-    }
-    try {
-      const detected = detectKeyTypeFromString(operatorKeyInput);
-      return {
-        keyType: detected.detectedType,
-        privateKey: detected.privateKey
-      };
-    } catch {
-      return {
-        keyType: "ecdsa",
-        privateKey: PrivateKey.fromStringECDSA(operatorKeyInput)
-      };
-    }
-  }
-  /**
-   * Resolve an operator key using Mirror Node for key type when possible.
-   * - If PrivateKey: return immediately.
-   * - If explicitType: parse directly.
-   * - Else: query Mirror Node; fallback to local detection.
-   */
-  async resolveOperatorKey(operatorId, operatorKeyInput, explicitType) {
-    if (typeof operatorKeyInput !== "string") {
-      return { keyType: explicitType || "ecdsa", privateKey: operatorKeyInput };
-    }
-    if (explicitType) {
-      const pk = explicitType === "ed25519" ? PrivateKey.fromStringED25519(operatorKeyInput) : PrivateKey.fromStringECDSA(operatorKeyInput);
-      return { keyType: explicitType, privateKey: pk };
-    }
-    const account = typeof operatorId === "string" ? operatorId : operatorId.toString();
-    try {
-      const info = await this.mirror.requestAccount(account);
-      const t = info?.key?._type || "";
-      const keyType = t.includes("ED25519") ? "ed25519" : "ecdsa";
-      const privateKey = keyType === "ed25519" ? PrivateKey.fromStringED25519(operatorKeyInput) : PrivateKey.fromStringECDSA(operatorKeyInput);
-      return { keyType, privateKey };
-    } catch {
-      this.logger.warn(
-        "Mirror node key detection failed; using local detection or default ECDSA"
-      );
-      return this.bestGuessOperatorKey(operatorKeyInput);
-    }
-  }
-  /**
-   * Resolve a supply key for the given token using Mirror Node token supply_key._type when possible.
-   */
-  async resolveSupplyKey(tokenId, keyInput, fallbackType, explicitType) {
-    try {
-      const info = await this.mirror.getTokenInfo(tokenId);
-      const t = info?.supply_key?._type || "";
-      if (typeof keyInput !== "string") {
-        return keyInput;
-      }
-      if (explicitType) {
-        return explicitType === "ed25519" ? PrivateKey.fromStringED25519(keyInput) : PrivateKey.fromStringECDSA(keyInput);
-      }
-      if (t.includes("ED25519")) {
-        return PrivateKey.fromStringED25519(keyInput);
-      }
-      if (t.includes("ECDSA")) {
-        return PrivateKey.fromStringECDSA(keyInput);
-      }
-      return fallbackType === "ed25519" ? PrivateKey.fromStringED25519(keyInput) : PrivateKey.fromStringECDSA(keyInput);
-    } catch {
-      if (typeof keyInput !== "string") {
-        return keyInput;
-      }
-      if (explicitType) {
-        return explicitType === "ed25519" ? PrivateKey.fromStringED25519(keyInput) : PrivateKey.fromStringECDSA(keyInput);
-      }
-      return fallbackType === "ed25519" ? PrivateKey.fromStringED25519(keyInput) : PrivateKey.fromStringECDSA(keyInput);
-    }
+import { clampScore } from "./standards-sdk.es119.js";
+import { readNumber, readSubjectMetrics } from "./standards-sdk.es178.js";
+import "./standards-sdk.es162.js";
+import "./standards-sdk.es175.js";
+import "./standards-sdk.es176.js";
+import "./standards-sdk.es177.js";
+import { normalizeRatio, logScale } from "./standards-sdk.es163.js";
+const DEFAULT_INCLUDED_REGISTRIES = ["virtuals-protocol"];
+const MISSING = { value: 0, status: "missing" };
+function readAcpField(subject, key) {
+  const metricsValue = readNumber(readSubjectMetrics(subject), key);
+  if (metricsValue !== null) {
+    return metricsValue;
   }
+  const metadata = subject.metadata;
+  return metadata ? readNumber(metadata, key) : null;
 }
-function createNodeOperatorContext(params) {
-  const operatorId = typeof params.operatorId === "string" ? AccountId.fromString(params.operatorId) : params.operatorId;
-  const client = params.client ? params.client : params.network === "mainnet" ? Client.forMainnet() : Client.forTestnet();
-  const resolver = new NodeOperatorResolver({
-    mirrorNode: params.mirrorNode,
-    logger: params.logger
-  });
-  let currentKeyType;
-  let currentPrivateKey;
-  const guess = resolver.bestGuessOperatorKey(
-    params.operatorKey,
-    params.keyType
-  );
-  currentKeyType = guess.keyType;
-  currentPrivateKey = guess.privateKey;
-  client.setOperator(operatorId.toString(), currentPrivateKey);
-  const initPromise = (async () => {
-    try {
-      const resolved = await resolver.resolveOperatorKey(
-        operatorId,
-        params.operatorKey,
-        params.keyType
-      );
-      currentKeyType = resolved.keyType;
-      currentPrivateKey = resolved.privateKey;
-      client.setOperator(operatorId.toString(), currentPrivateKey);
-    } catch {
-    }
-  })();
+function createAcpAdapter(options = {}) {
+  const volumeCap = options.volumeCap ?? 500;
+  const revenueCap = options.revenueCap ?? 1e4;
   return {
-    client,
-    operatorId,
-    get operatorKey() {
-      return currentPrivateKey;
-    },
-    get keyType() {
-      return currentKeyType;
-    },
-    ensureInitialized: async () => {
-      await initPromise;
-    }
+    id: "acp",
+    weight: 2,
+    contributionMode: "scoped",
+    includeRegistries: options.includeRegistries ?? DEFAULT_INCLUDED_REGISTRIES,
+    components: [
+      {
+        name: "jobs.successRate",
+        normalize: ({ subject }) => {
+          const raw = readAcpField(subject, "successRate");
+          return raw === null ? MISSING : { value: clampScore(normalizeRatio(raw) * 100), status: "ok" };
+        }
+      },
+      {
+        name: "jobs.deliveryVolume",
+        normalize: ({ subject }) => {
+          const volume = readAcpField(subject, "volume") ?? readAcpField(subject, "successfulJobCount");
+          return volume === null ? MISSING : { value: logScale(volume, volumeCap), status: "ok" };
+        }
+      },
+      {
+        name: "jobs.revenue",
+        normalize: ({ subject }) => {
+          const revenue = readAcpField(subject, "revenue");
+          return revenue === null ? MISSING : { value: logScale(revenue, revenueCap), status: "ok" };
+        }
+      },
+      {
+        name: "reviews.rating",
+        normalize: ({ subject }) => {
+          const rating = readAcpField(subject, "rating");
+          return rating === null ? MISSING : { value: clampScore(rating / 5 * 100), status: "ok" };
+        }
+      }
+    ]
   };
 }
 export {
-  NodeOperatorResolver,
-  createNodeOperatorContext
+  createAcpAdapter
 };
 //# sourceMappingURL=standards-sdk.es164.js.map

package/dist/es/standards-sdk.es164.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es164.js","sources":["../../src/common/node-operator-resolver.ts"],"sourcesContent":["import { AccountId, Client, PrivateKey } from '@hashgraph/sdk';\nimport { HederaMirrorNode } from '../services/mirror-node';\nimport { ILogger } from '../utils/logger';\nimport { detectKeyTypeFromString } from '../utils/key-type-detector';\nimport { NetworkType } from '../utils/types';\n\n/**\n * Resolves operator and supply private keys using Mirror Node as source of truth\n * with format-detection fallbacks for string keys.\n */\nexport class NodeOperatorResolver {\n  private readonly mirror: HederaMirrorNode;\n  private readonly logger: ILogger;\n\n  constructor(params: { mirrorNode: HederaMirrorNode; logger: ILogger }) {\n    this.mirror = params.mirrorNode;\n    this.logger = params.logger;\n  }\n\n  /**\n   * Best-guess parsing for an operator key without network calls.\n   * - If PrivateKey: returns immediately with provided or fallback type.\n   * - If string with explicitType: parse directly.\n   * - If string without type: detect format; fallback to ECDSA.\n   */\n  bestGuessOperatorKey(\n    operatorKeyInput: string | PrivateKey,\n    explicitType?: 'ed25519' | 'ecdsa',\n  ): { keyType: 'ed25519' | 'ecdsa'; privateKey: PrivateKey } {\n    if (typeof operatorKeyInput !== 'string') {\n      return { keyType: explicitType || 'ecdsa', privateKey: operatorKeyInput };\n    }\n    if (explicitType) {\n      const pk =\n        explicitType === 'ed25519'\n          ? PrivateKey.fromStringED25519(operatorKeyInput)\n          : PrivateKey.fromStringECDSA(operatorKeyInput);\n      return { keyType: explicitType, privateKey: pk };\n    }\n    try {\n      const detected = detectKeyTypeFromString(operatorKeyInput);\n      return {\n        keyType: detected.detectedType,\n        privateKey: detected.privateKey,\n      };\n    } catch {\n      return {\n        keyType: 'ecdsa',\n        privateKey: PrivateKey.fromStringECDSA(operatorKeyInput),\n      };\n    }\n  }\n\n  /**\n   * Resolve an operator key using Mirror Node for key type when possible.\n   * - If PrivateKey: return immediately.\n   * - If explicitType: parse directly.\n   * - Else: query Mirror Node; fallback to local detection.\n   */\n  async resolveOperatorKey(\n    operatorId: string | AccountId,\n    operatorKeyInput: string | PrivateKey,\n    explicitType?: 'ed25519' | 'ecdsa',\n  ): Promise<{ keyType: 'ed25519' | 'ecdsa'; privateKey: PrivateKey }> {\n    if (typeof operatorKeyInput !== 'string') {\n      return { keyType: explicitType || 'ecdsa', privateKey: operatorKeyInput };\n    }\n    if (explicitType) {\n      const pk =\n        explicitType === 'ed25519'\n          ? PrivateKey.fromStringED25519(operatorKeyInput)\n          : PrivateKey.fromStringECDSA(operatorKeyInput);\n      return { keyType: explicitType, privateKey: pk };\n    }\n    const account =\n      typeof operatorId === 'string' ? operatorId : operatorId.toString();\n    try {\n      const info = await this.mirror.requestAccount(account);\n      const t = info?.key?._type || '';\n      const keyType: 'ed25519' | 'ecdsa' = t.includes('ED25519')\n        ? 'ed25519'\n        : 'ecdsa';\n      const privateKey =\n        keyType === 'ed25519'\n          ? PrivateKey.fromStringED25519(operatorKeyInput)\n          : PrivateKey.fromStringECDSA(operatorKeyInput);\n      return { keyType, privateKey };\n    } catch {\n      this.logger.warn(\n        'Mirror node key detection failed; using local detection or default ECDSA',\n      );\n      return this.bestGuessOperatorKey(operatorKeyInput);\n    }\n  }\n\n  /**\n   * Resolve a supply key for the given token using Mirror Node token supply_key._type when possible.\n   */\n  async resolveSupplyKey(\n    tokenId: string,\n    keyInput: string | PrivateKey,\n    fallbackType: 'ed25519' | 'ecdsa',\n    explicitType?: 'ed25519' | 'ecdsa',\n  ): Promise<PrivateKey> {\n    try {\n      const info = await this.mirror.getTokenInfo(tokenId);\n      const t = info?.supply_key?._type || '';\n      if (typeof keyInput !== 'string') {\n        return keyInput;\n      }\n      if (explicitType) {\n        return explicitType === 'ed25519'\n          ? PrivateKey.fromStringED25519(keyInput)\n          : PrivateKey.fromStringECDSA(keyInput);\n      }\n      if (t.includes('ED25519')) {\n        return PrivateKey.fromStringED25519(keyInput);\n      }\n      if (t.includes('ECDSA')) {\n        return PrivateKey.fromStringECDSA(keyInput);\n      }\n      return fallbackType === 'ed25519'\n        ? PrivateKey.fromStringED25519(keyInput)\n        : PrivateKey.fromStringECDSA(keyInput);\n    } catch {\n      if (typeof keyInput !== 'string') {\n        return keyInput;\n      }\n      if (explicitType) {\n        return explicitType === 'ed25519'\n          ? PrivateKey.fromStringED25519(keyInput)\n          : PrivateKey.fromStringECDSA(keyInput);\n      }\n      return fallbackType === 'ed25519'\n        ? PrivateKey.fromStringED25519(keyInput)\n        : PrivateKey.fromStringECDSA(keyInput);\n    }\n  }\n}\n\nexport interface NodeOperatorInitParams {\n  network: NetworkType;\n  operatorId: string | AccountId;\n  operatorKey: string | PrivateKey;\n  keyType?: 'ed25519' | 'ecdsa';\n  mirrorNode: HederaMirrorNode;\n  logger: ILogger;\n  client?: Client;\n}\n\nexport interface NodeOperatorContext {\n  client: Client;\n  operatorId: AccountId;\n  readonly operatorKey: PrivateKey;\n  readonly keyType: 'ed25519' | 'ecdsa';\n  ensureInitialized(): Promise<void>;\n}\n\nexport function createNodeOperatorContext(\n  params: NodeOperatorInitParams,\n): NodeOperatorContext {\n  const operatorId: AccountId =\n    typeof params.operatorId === 'string'\n      ? AccountId.fromString(params.operatorId)\n      : params.operatorId;\n\n  const client: Client = params.client\n    ? params.client\n    : params.network === 'mainnet'\n      ? Client.forMainnet()\n      : Client.forTestnet();\n\n  const resolver = new NodeOperatorResolver({\n    mirrorNode: params.mirrorNode,\n    logger: params.logger,\n  });\n\n  let currentKeyType: 'ed25519' | 'ecdsa';\n  let currentPrivateKey: PrivateKey;\n\n  const guess = resolver.bestGuessOperatorKey(\n    params.operatorKey,\n    params.keyType,\n  );\n  currentKeyType = guess.keyType;\n  currentPrivateKey = guess.privateKey;\n  client.setOperator(operatorId.toString(), currentPrivateKey);\n\n  const initPromise = (async () => {\n    try {\n      const resolved = await resolver.resolveOperatorKey(\n        operatorId,\n        params.operatorKey,\n        params.keyType,\n      );\n      currentKeyType = resolved.keyType;\n      currentPrivateKey = resolved.privateKey;\n      client.setOperator(operatorId.toString(), currentPrivateKey);\n    } catch {}\n  })();\n\n  return {\n    client,\n    operatorId,\n    get operatorKey() {\n      return currentPrivateKey;\n    },\n    get keyType() {\n      return currentKeyType;\n    },\n    ensureInitialized: async () => {\n      await initPromise;\n    },\n  };\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es164.js","sources":["../../src/hcs-25/adapters/acp.ts"],"sourcesContent":["import { clampScore } from '../scoring';\nimport type {\n  Hcs25AdapterDefinition,\n  Hcs25NormalizedValue,\n  Hcs25Subject,\n} from '../types';\nimport { readNumber, readSubjectMetrics } from '../signals';\nimport { logScale, normalizeRatio } from './normalization';\n\n/**\n * Options for the ACP/Virtuals marketplace adapter.\n */\nexport interface Hcs25AcpAdapterOptions {\n  /** Volume cap used for log scaling delivery volume. Default 500. */\n  volumeCap?: number;\n  /** Revenue cap used for log scaling revenue. Default 10000. */\n  revenueCap?: number;\n  /** Registries where marketplace metrics apply. */\n  includeRegistries?: readonly string[];\n}\n\nconst DEFAULT_INCLUDED_REGISTRIES: readonly string[] = ['virtuals-protocol'];\n\nconst MISSING: Hcs25NormalizedValue = { value: 0, status: 'missing' };\n\nfunction readAcpField(subject: Hcs25Subject, key: string): number | null {\n  const metricsValue = readNumber(readSubjectMetrics(subject), key);\n  if (metricsValue !== null) {\n    return metricsValue;\n  }\n  const metadata = subject.metadata;\n  return metadata ? readNumber(metadata, key) : null;\n}\n\n/**\n * Creates the `acp` adapter: normalizes marketplace-native execution\n * performance (job success, delivery volume, revenue, ratings) for\n * ACP/Virtuals-style agents. Delivery volume falls back to the successful\n * job count when no provider-defined volume exists.\n */\nexport function createAcpAdapter(\n  options: Hcs25AcpAdapterOptions = {},\n): Hcs25AdapterDefinition {\n  const volumeCap = options.volumeCap ?? 500;\n  const revenueCap = options.revenueCap ?? 10000;\n\n  return {\n    id: 'acp',\n    weight: 2,\n    contributionMode: 'scoped',\n    includeRegistries: options.includeRegistries ?? DEFAULT_INCLUDED_REGISTRIES,\n    components: [\n      {\n        name: 'jobs.successRate',\n        normalize: ({ subject }): Hcs25NormalizedValue => {\n          const raw = readAcpField(subject, 'successRate');\n          return raw === null\n            ? MISSING\n            : { value: clampScore(normalizeRatio(raw) * 100), status: 'ok' };\n        },\n      },\n      {\n        name: 'jobs.deliveryVolume',\n        normalize: ({ subject }): Hcs25NormalizedValue => {\n          const volume =\n            readAcpField(subject, 'volume') ??\n            readAcpField(subject, 'successfulJobCount');\n          return volume === null\n            ? MISSING\n            : { value: logScale(volume, volumeCap), status: 'ok' };\n        },\n      },\n      {\n        name: 'jobs.revenue',\n        normalize: ({ subject }): Hcs25NormalizedValue => {\n          const revenue = readAcpField(subject, 'revenue');\n          return revenue === null\n            ? MISSING\n            : { value: logScale(revenue, revenueCap), status: 'ok' };\n        },\n      },\n      {\n        name: 'reviews.rating',\n        normalize: ({ subject }): Hcs25NormalizedValue => {\n          const rating = readAcpField(subject, 'rating');\n          return rating === null\n            ? MISSING\n            : { value: clampScore((rating / 5) * 100), status: 'ok' };\n        },\n      },\n    ],\n  };\n}\n"],"names":[],"mappings":";;;;;;;AAqBA,MAAM,8BAAiD,CAAC,mBAAmB;AAE3E,MAAM,UAAgC,EAAE,OAAO,GAAG,QAAQ,UAAA;AAE1D,SAAS,aAAa,SAAuB,KAA4B;AACvE,QAAM,eAAe,WAAW,mBAAmB,OAAO,GAAG,GAAG;AAChE,MAAI,iBAAiB,MAAM;AACzB,WAAO;AAAA,EACT;AACA,QAAM,WAAW,QAAQ;AACzB,SAAO,WAAW,WAAW,UAAU,GAAG,IAAI;AAChD;AAQO,SAAS,iBACd,UAAkC,IACV;AACxB,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,aAAa,QAAQ,cAAc;AAEzC,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,QAAQ;AAAA,IACR,kBAAkB;AAAA,IAClB,mBAAmB,QAAQ,qBAAqB;AAAA,IAChD,YAAY;AAAA,MACV;AAAA,QACE,MAAM;AAAA,QACN,WAAW,CAAC,EAAE,cAAoC;AAChD,gBAAM,MAAM,aAAa,SAAS,aAAa;AAC/C,iBAAO,QAAQ,OACX,UACA,EAAE,OAAO,WAAW,eAAe,GAAG,IAAI,GAAG,GAAG,QAAQ,KAAA;AAAA,QAC9D;AAAA,MAAA;AAAA,MAEF;AAAA,QACE,MAAM;AAAA,QACN,WAAW,CAAC,EAAE,cAAoC;AAChD,gBAAM,SACJ,aAAa,SAAS,QAAQ,KAC9B,aAAa,SAAS,oBAAoB;AAC5C,iBAAO,WAAW,OACd,UACA,EAAE,OAAO,SAAS,QAAQ,SAAS,GAAG,QAAQ,KAAA;AAAA,QACpD;AAAA,MAAA;AAAA,MAEF;AAAA,QACE,MAAM;AAAA,QACN,WAAW,CAAC,EAAE,cAAoC;AAChD,gBAAM,UAAU,aAAa,SAAS,SAAS;AAC/C,iBAAO,YAAY,OACf,UACA,EAAE,OAAO,SAAS,SAAS,UAAU,GAAG,QAAQ,KAAA;AAAA,QACtD;AAAA,MAAA;AAAA,MAEF;AAAA,QACE,MAAM;AAAA,QACN,WAAW,CAAC,EAAE,cAAoC;AAChD,gBAAM,SAAS,aAAa,SAAS,QAAQ;AAC7C,iBAAO,WAAW,OACd,UACA,EAAE,OAAO,WAAY,SAAS,IAAK,GAAG,GAAG,QAAQ,KAAA;AAAA,QACvD;AAAA,MAAA;AAAA,IACF;AAAA,EACF;AAEJ;"}

package/dist/es/standards-sdk.es165.js

@@ -1,45 +1,98 @@
-import { TopicMessageSubmitTransaction, TopicId, TopicCreateTransaction, PublicKey, KeyList } from "@hashgraph/sdk";
-function encodeHcs2RegistryMemo(indexedFlag, ttl) {
-  return `hcs-2:${indexedFlag}:${ttl}`;
-}
-function buildTopicCreateTx(params) {
-  const { memo, adminKey, submitKey, operatorPublicKey } = params;
-  const tx = new TopicCreateTransaction().setTopicMemo(memo);
-  const coerceKey = (k) => {
-    if (!k) return void 0;
-    if (k instanceof PublicKey || k instanceof KeyList) return k;
-    if (typeof k === "boolean") {
-      return k ? operatorPublicKey : void 0;
-    }
-    if (typeof k === "string") {
-      try {
-        return PublicKey.fromString(k);
-      } catch {
-        return void 0;
-      }
-    }
-    return void 0;
-  };
-  const admin = coerceKey(adminKey);
-  if (admin) {
-    tx.setAdminKey(admin);
+import { clampScore } from "./standards-sdk.es119.js";
+import { readSubjectAdditional, readNumber } from "./standards-sdk.es178.js";
+import "./standards-sdk.es162.js";
+import "./standards-sdk.es175.js";
+import "./standards-sdk.es176.js";
+import "./standards-sdk.es177.js";
+import { clampUnit } from "./standards-sdk.es163.js";
+const DEFAULT_INCLUDED_REGISTRIES = ["agentverse", "uagent"];
+const MISSING = { value: 0, status: "missing" };
+function normalizeInsights(subject) {
+  const additional = readSubjectAdditional(subject);
+  const rating = readNumber(additional, "agentverseInsightsRating");
+  if (rating !== null) {
+    return { value: clampScore(rating / 5 * 100), status: "ok" };
   }
-  const submit = coerceKey(submitKey);
-  if (submit) {
-    tx.setSubmitKey(submit);
+  const proxies = [
+    readNumber(additional, "agentverseInsightsReadmeQualityScore"),
+    readNumber(additional, "agentverseInsightsReadmeUniquenessScore"),
+    readNumber(additional, "agentverseInsightsInteractionsScore")
+  ].filter((value) => value !== null);
+  if (proxies.length === 0) {
+    return MISSING;
   }
-  return tx;
+  const mean = proxies.reduce((sum, value) => sum + value, 0) / proxies.length;
+  return { value: clampScore(mean * 100), status: "ok" };
 }
-function buildMessageTx(params) {
-  const tx = new TopicMessageSubmitTransaction().setTopicId(TopicId.fromString(params.topicId)).setMessage(params.message);
-  if (params.transactionMemo) {
-    tx.setTransactionMemo(params.transactionMemo);
-  }
-  return tx;
+function createAgentverseInsightsAdapter(options = {}) {
+  return {
+    id: "agentverse-insights",
+    weight: 1,
+    contributionMode: "scoped",
+    includeRegistries: options.includeRegistries ?? DEFAULT_INCLUDED_REGISTRIES,
+    defaultComponentKey: "agentverse-insights.score",
+    components: [
+      { name: "score", normalize: ({ subject }) => normalizeInsights(subject) }
+    ]
+  };
+}
+function createAgentverseVerifierAdapter(options = {}) {
+  const interactionCap = options.interactionCap ?? 1e3;
+  const responseTimeCapSeconds = options.responseTimeCapSeconds ?? 30;
+  return {
+    id: "agentverse-verifier",
+    weight: 1,
+    contributionMode: "conditional",
+    includeRegistries: options.includeRegistries ?? DEFAULT_INCLUDED_REGISTRIES,
+    defaultComponentKey: "agentverse-verifier.score",
+    components: [
+      {
+        name: "score",
+        nonScorableWhenUnavailable: true,
+        normalize: ({ subject }) => {
+          const additional = readSubjectAdditional(subject);
+          const recentInteractions = readNumber(
+            additional,
+            "agentverseInsightsVerifierRecentInteractions"
+          ) ?? 0;
+          const recentSuccesses = readNumber(
+            additional,
+            "agentverseInsightsVerifierRecentSuccessInteractions"
+          ) ?? 0;
+          const totalInteractions = readNumber(
+            additional,
+            "agentverseInsightsVerifierTotalInteractions"
+          ) ?? 0;
+          const totalSuccesses = readNumber(
+            additional,
+            "agentverseInsightsVerifierTotalSuccessInteractions"
+          ) ?? 0;
+          const useRecent = recentInteractions > 0;
+          const interactions = useRecent ? recentInteractions : totalInteractions;
+          const successes = useRecent ? recentSuccesses : totalSuccesses;
+          if (interactions <= 0) {
+            return MISSING;
+          }
+          const successRate = clampUnit(successes / interactions) * 100;
+          const avgResponseTime = readNumber(
+            additional,
+            "agentverseInsightsAvgResponseTime"
+          );
+          const responseFactor = avgResponseTime === null ? 1 : clampUnit(1 - avgResponseTime / responseTimeCapSeconds);
+          const volumeFactor = clampUnit(
+            Math.log1p(interactions) / Math.log1p(interactionCap)
+          );
+          return {
+            value: clampScore(successRate * responseFactor * volumeFactor),
+            status: "ok"
+          };
+        }
+      }
+    ]
+  };
 }
 export {
-  buildMessageTx,
-  buildTopicCreateTx,
-  encodeHcs2RegistryMemo
+  createAgentverseInsightsAdapter,
+  createAgentverseVerifierAdapter
 };
 //# sourceMappingURL=standards-sdk.es165.js.map

package/dist/es/standards-sdk.es165.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es165.js","sources":["../../src/common/tx/tx-utils.ts"],"sourcesContent":["import {\n  TopicCreateTransaction,\n  TopicMessageSubmitTransaction,\n  PublicKey,\n  KeyList,\n  TopicId,\n} from '@hashgraph/sdk';\n\nexport type MaybeKey = boolean | string | PublicKey | KeyList | undefined;\n\nexport function encodeHcs2RegistryMemo(\n  indexedFlag: 0 | 1,\n  ttl: number,\n): string {\n  return `hcs-2:${indexedFlag}:${ttl}`;\n}\n\nexport function buildTopicCreateTx(params: {\n  memo: string;\n  adminKey?: MaybeKey;\n  submitKey?: MaybeKey;\n  operatorPublicKey?: PublicKey;\n}): TopicCreateTransaction {\n  const { memo, adminKey, submitKey, operatorPublicKey } = params;\n  const tx = new TopicCreateTransaction().setTopicMemo(memo);\n\n  const coerceKey = (k?: MaybeKey): PublicKey | KeyList | undefined => {\n    if (!k) return undefined;\n    if (k instanceof PublicKey || k instanceof KeyList) return k;\n    if (typeof k === 'boolean') {\n      return k ? operatorPublicKey : undefined;\n    }\n    if (typeof k === 'string') {\n      try {\n        return PublicKey.fromString(k);\n      } catch {\n        return undefined;\n      }\n    }\n    return undefined;\n  };\n\n  const admin = coerceKey(adminKey);\n  if (admin) {\n    tx.setAdminKey(admin);\n  }\n\n  const submit = coerceKey(submitKey);\n  if (submit) {\n    tx.setSubmitKey(submit);\n  }\n\n  return tx;\n}\n\nexport function buildMessageTx(params: {\n  topicId: string;\n  message: string | Uint8Array;\n  transactionMemo?: string;\n}): TopicMessageSubmitTransaction {\n  const tx = new TopicMessageSubmitTransaction()\n    .setTopicId(TopicId.fromString(params.topicId))\n    .setMessage(params.message);\n  if (params.transactionMemo) {\n    tx.setTransactionMemo(params.transactionMemo);\n  }\n  return tx;\n}\n"],"names":[],"mappings":";AAUO,SAAS,uBACd,aACA,KACQ;AACR,SAAO,SAAS,WAAW,IAAI,GAAG;AACpC;AAEO,SAAS,mBAAmB,QAKR;AACzB,QAAM,EAAE,MAAM,UAAU,WAAW,sBAAsB;AACzD,QAAM,KAAK,IAAI,yBAAyB,aAAa,IAAI;AAEzD,QAAM,YAAY,CAAC,MAAkD;AACnE,QAAI,CAAC,EAAG,QAAO;AACf,QAAI,aAAa,aAAa,aAAa,QAAS,QAAO;AAC3D,QAAI,OAAO,MAAM,WAAW;AAC1B,aAAO,IAAI,oBAAoB;AAAA,IACjC;AACA,QAAI,OAAO,MAAM,UAAU;AACzB,UAAI;AACF,eAAO,UAAU,WAAW,CAAC;AAAA,MAC/B,QAAQ;AACN,eAAO;AAAA,MACT;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAEA,QAAM,QAAQ,UAAU,QAAQ;AAChC,MAAI,OAAO;AACT,OAAG,YAAY,KAAK;AAAA,EACtB;AAEA,QAAM,SAAS,UAAU,SAAS;AAClC,MAAI,QAAQ;AACV,OAAG,aAAa,MAAM;AAAA,EACxB;AAEA,SAAO;AACT;AAEO,SAAS,eAAe,QAIG;AAChC,QAAM,KAAK,IAAI,gCACZ,WAAW,QAAQ,WAAW,OAAO,OAAO,CAAC,EAC7C,WAAW,OAAO,OAAO;AAC5B,MAAI,OAAO,iBAAiB;AAC1B,OAAG,mBAAmB,OAAO,eAAe;AAAA,EAC9C;AACA,SAAO;AACT;"}
+{"version":3,"file":"standards-sdk.es165.js","sources":["../../src/hcs-25/adapters/agentverse.ts"],"sourcesContent":["import { clampScore } from '../scoring';\nimport type {\n  Hcs25AdapterDefinition,\n  Hcs25NormalizedValue,\n  Hcs25Subject,\n} from '../types';\nimport {\n  readNumber,\n  readSubjectAdditional,\n  type Hcs25JsonObject,\n} from '../signals';\nimport { clampUnit } from './normalization';\n\n/**\n * Options for the AgentVerse insights adapter.\n */\nexport interface Hcs25AgentverseInsightsAdapterOptions {\n  /** Registries where AgentVerse insights apply. */\n  includeRegistries?: readonly string[];\n}\n\n/**\n * Options for the AgentVerse verifier reliability adapter.\n */\nexport interface Hcs25AgentverseVerifierAdapterOptions {\n  /** Interaction count cap for the volume confidence factor. Default 1000. */\n  interactionCap?: number;\n  /** Average response time (seconds) that maps to a zero factor. Default 30. */\n  responseTimeCapSeconds?: number;\n  /** Registries where AgentVerse verifier counters apply. */\n  includeRegistries?: readonly string[];\n}\n\nconst DEFAULT_INCLUDED_REGISTRIES: readonly string[] = ['agentverse', 'uagent'];\n\nconst MISSING: Hcs25NormalizedValue = { value: 0, status: 'missing' };\n\nfunction normalizeInsights(subject: Hcs25Subject): Hcs25NormalizedValue {\n  const additional: Hcs25JsonObject = readSubjectAdditional(subject);\n  const rating = readNumber(additional, 'agentverseInsightsRating');\n  if (rating !== null) {\n    return { value: clampScore((rating / 5) * 100), status: 'ok' };\n  }\n\n  const proxies = [\n    readNumber(additional, 'agentverseInsightsReadmeQualityScore'),\n    readNumber(additional, 'agentverseInsightsReadmeUniquenessScore'),\n    readNumber(additional, 'agentverseInsightsInteractionsScore'),\n  ].filter((value): value is number => value !== null);\n\n  if (proxies.length === 0) {\n    return MISSING;\n  }\n\n  const mean = proxies.reduce((sum, value) => sum + value, 0) / proxies.length;\n  return { value: clampScore(mean * 100), status: 'ok' };\n}\n\n/**\n * Creates the `agentverse-insights` adapter: converts marketplace \"insights\"\n * indicators into a single normalized component, preferring the explicit\n * rating (scaled from five) and falling back to the mean of the available\n * quality proxies.\n */\nexport function createAgentverseInsightsAdapter(\n  options: Hcs25AgentverseInsightsAdapterOptions = {},\n): Hcs25AdapterDefinition {\n  return {\n    id: 'agentverse-insights',\n    weight: 1,\n    contributionMode: 'scoped',\n    includeRegistries: options.includeRegistries ?? DEFAULT_INCLUDED_REGISTRIES,\n    defaultComponentKey: 'agentverse-insights.score',\n    components: [\n      { name: 'score', normalize: ({ subject }) => normalizeInsights(subject) },\n    ],\n  };\n}\n\n/**\n * Creates the `agentverse-verifier` adapter: converts verifier interaction\n * counters into a reliability score combining success rate, a response-time\n * penalty, and a volume confidence factor. Conditional contribution keeps\n * agents without verifier counters out of the denominator.\n */\nexport function createAgentverseVerifierAdapter(\n  options: Hcs25AgentverseVerifierAdapterOptions = {},\n): Hcs25AdapterDefinition {\n  const interactionCap = options.interactionCap ?? 1000;\n  const responseTimeCapSeconds = options.responseTimeCapSeconds ?? 30;\n\n  return {\n    id: 'agentverse-verifier',\n    weight: 1,\n    contributionMode: 'conditional',\n    includeRegistries: options.includeRegistries ?? DEFAULT_INCLUDED_REGISTRIES,\n    defaultComponentKey: 'agentverse-verifier.score',\n    components: [\n      {\n        name: 'score',\n        nonScorableWhenUnavailable: true,\n        normalize: ({ subject }): Hcs25NormalizedValue => {\n          const additional = readSubjectAdditional(subject);\n          const recentInteractions =\n            readNumber(\n              additional,\n              'agentverseInsightsVerifierRecentInteractions',\n            ) ?? 0;\n          const recentSuccesses =\n            readNumber(\n              additional,\n              'agentverseInsightsVerifierRecentSuccessInteractions',\n            ) ?? 0;\n          const totalInteractions =\n            readNumber(\n              additional,\n              'agentverseInsightsVerifierTotalInteractions',\n            ) ?? 0;\n          const totalSuccesses =\n            readNumber(\n              additional,\n              'agentverseInsightsVerifierTotalSuccessInteractions',\n            ) ?? 0;\n\n          const useRecent = recentInteractions > 0;\n          const interactions = useRecent\n            ? recentInteractions\n            : totalInteractions;\n          const successes = useRecent ? recentSuccesses : totalSuccesses;\n\n          if (interactions <= 0) {\n            return MISSING;\n          }\n\n          const successRate = clampUnit(successes / interactions) * 100;\n          const avgResponseTime = readNumber(\n            additional,\n            'agentverseInsightsAvgResponseTime',\n          );\n          const responseFactor =\n            avgResponseTime === null\n              ? 1\n              : clampUnit(1 - avgResponseTime / responseTimeCapSeconds);\n          const volumeFactor = clampUnit(\n            Math.log1p(interactions) / Math.log1p(interactionCap),\n          );\n\n          return {\n            value: clampScore(successRate * responseFactor * volumeFactor),\n            status: 'ok',\n          };\n        },\n      },\n    ],\n  };\n}\n"],"names":[],"mappings":";;;;;;;AAiCA,MAAM,8BAAiD,CAAC,cAAc,QAAQ;AAE9E,MAAM,UAAgC,EAAE,OAAO,GAAG,QAAQ,UAAA;AAE1D,SAAS,kBAAkB,SAA6C;AACtE,QAAM,aAA8B,sBAAsB,OAAO;AACjE,QAAM,SAAS,WAAW,YAAY,0BAA0B;AAChE,MAAI,WAAW,MAAM;AACnB,WAAO,EAAE,OAAO,WAAY,SAAS,IAAK,GAAG,GAAG,QAAQ,KAAA;AAAA,EAC1D;AAEA,QAAM,UAAU;AAAA,IACd,WAAW,YAAY,sCAAsC;AAAA,IAC7D,WAAW,YAAY,yCAAyC;AAAA,IAChE,WAAW,YAAY,qCAAqC;AAAA,EAAA,EAC5D,OAAO,CAAC,UAA2B,UAAU,IAAI;AAEnD,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO;AAAA,EACT;AAEA,QAAM,OAAO,QAAQ,OAAO,CAAC,KAAK,UAAU,MAAM,OAAO,CAAC,IAAI,QAAQ;AACtE,SAAO,EAAE,OAAO,WAAW,OAAO,GAAG,GAAG,QAAQ,KAAA;AAClD;AAQO,SAAS,gCACd,UAAiD,IACzB;AACxB,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,QAAQ;AAAA,IACR,kBAAkB;AAAA,IAClB,mBAAmB,QAAQ,qBAAqB;AAAA,IAChD,qBAAqB;AAAA,IACrB,YAAY;AAAA,MACV,EAAE,MAAM,SAAS,WAAW,CAAC,EAAE,QAAA,MAAc,kBAAkB,OAAO,EAAA;AAAA,IAAE;AAAA,EAC1E;AAEJ;AAQO,SAAS,gCACd,UAAiD,IACzB;AACxB,QAAM,iBAAiB,QAAQ,kBAAkB;AACjD,QAAM,yBAAyB,QAAQ,0BAA0B;AAEjE,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,QAAQ;AAAA,IACR,kBAAkB;AAAA,IAClB,mBAAmB,QAAQ,qBAAqB;AAAA,IAChD,qBAAqB;AAAA,IACrB,YAAY;AAAA,MACV;AAAA,QACE,MAAM;AAAA,QACN,4BAA4B;AAAA,QAC5B,WAAW,CAAC,EAAE,cAAoC;AAChD,gBAAM,aAAa,sBAAsB,OAAO;AAChD,gBAAM,qBACJ;AAAA,YACE;AAAA,YACA;AAAA,UAAA,KACG;AACP,gBAAM,kBACJ;AAAA,YACE;AAAA,YACA;AAAA,UAAA,KACG;AACP,gBAAM,oBACJ;AAAA,YACE;AAAA,YACA;AAAA,UAAA,KACG;AACP,gBAAM,iBACJ;AAAA,YACE;AAAA,YACA;AAAA,UAAA,KACG;AAEP,gBAAM,YAAY,qBAAqB;AACvC,gBAAM,eAAe,YACjB,qBACA;AACJ,gBAAM,YAAY,YAAY,kBAAkB;AAEhD,cAAI,gBAAgB,GAAG;AACrB,mBAAO;AAAA,UACT;AAEA,gBAAM,cAAc,UAAU,YAAY,YAAY,IAAI;AAC1D,gBAAM,kBAAkB;AAAA,YACtB;AAAA,YACA;AAAA,UAAA;AAEF,gBAAM,iBACJ,oBAAoB,OAChB,IACA,UAAU,IAAI,kBAAkB,sBAAsB;AAC5D,gBAAM,eAAe;AAAA,YACnB,KAAK,MAAM,YAAY,IAAI,KAAK,MAAM,cAAc;AAAA,UAAA;AAGtD,iBAAO;AAAA,YACL,OAAO,WAAW,cAAc,iBAAiB,YAAY;AAAA,YAC7D,QAAQ;AAAA,UAAA;AAAA,QAEZ;AAAA,MAAA;AAAA,IACF;AAAA,EACF;AAEJ;"}

package/dist/es/standards-sdk.es166.js

@@ -1,20 +1,52 @@
-import { Logger } from "./standards-sdk.es126.js";
-import { HederaMirrorNode } from "./standards-sdk.es147.js";
-class HCS5BaseClient {
-  /**
-   * Create a new HCS-5 base client
-   */
-  constructor(config) {
-    this.network = config.network;
-    this.logger = config.logger || Logger.getInstance({
-      level: config.logLevel || "info",
-      module: "HCS5Client",
-      silent: config.silent
-    });
-    this.mirrorNode = new HederaMirrorNode(this.network, this.logger);
+import { clampScore } from "./standards-sdk.es119.js";
+import { readNumber, readSubjectMetrics, readBoolean } from "./standards-sdk.es178.js";
+import "./standards-sdk.es162.js";
+import "./standards-sdk.es175.js";
+import "./standards-sdk.es176.js";
+import "./standards-sdk.es177.js";
+const DEFAULT_EXCLUDED_REGISTRIES = [
+  "openrouter",
+  "near-ai"
+];
+function normalizeAvailability(subject, scoreScale, recencyWindowMinutes) {
+  const metadata = subject.metadata;
+  const rawScore = metadata ? readNumber(metadata, "availabilityScore") : null;
+  if (rawScore !== null) {
+    const ratio = scoreScale === "ratio" ? rawScore : scoreScale === "percent" ? rawScore / 100 : rawScore > 1 ? rawScore / 100 : rawScore;
+    return { value: clampScore(ratio * 100), status: "ok" };
   }
+  const metrics = readSubjectMetrics(subject);
+  const minsFromLastOnline = readNumber(metrics, "minsFromLastOnline");
+  if (minsFromLastOnline !== null) {
+    return {
+      value: clampScore(100 * (1 - minsFromLastOnline / recencyWindowMinutes)),
+      status: "ok"
+    };
+  }
+  const isOnline = readBoolean(metrics, "isOnline");
+  if (isOnline !== null) {
+    return { value: isOnline ? 100 : 0, status: "ok" };
+  }
+  return { value: 0, status: "missing" };
+}
+function createAvailabilityAdapter(options = {}) {
+  const scoreScale = options.scoreScale ?? "auto";
+  const recencyWindowMinutes = options.recencyWindowMinutes ?? 1440;
+  return {
+    id: "availability",
+    weight: 1,
+    contributionMode: "universal",
+    excludeRegistries: options.excludeRegistries ?? DEFAULT_EXCLUDED_REGISTRIES,
+    defaultComponentKey: "availability.uptime",
+    components: [
+      {
+        name: "uptime",
+        normalize: ({ subject }) => normalizeAvailability(subject, scoreScale, recencyWindowMinutes)
+      }
+    ]
+  };
 }
 export {
-  HCS5BaseClient
+  createAvailabilityAdapter
 };
 //# sourceMappingURL=standards-sdk.es166.js.map

package/dist/es/standards-sdk.es166.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es166.js","sources":["../../src/hcs-5/base-client.ts"],"sourcesContent":["import { Logger, ILogger } from '../utils/logger';\nimport { HederaMirrorNode } from '../services/mirror-node';\nimport { HCS5ClientConfig } from './types';\nimport { NetworkType } from '../utils/types';\n\n/**\n * Base client for HCS-5 operations\n */\nexport abstract class HCS5BaseClient {\n  protected logger: ILogger;\n  protected mirrorNode: HederaMirrorNode;\n  protected network: NetworkType;\n\n  /**\n   * Create a new HCS-5 base client\n   */\n  constructor(config: HCS5ClientConfig) {\n    this.network = config.network;\n    this.logger =\n      config.logger ||\n      Logger.getInstance({\n        level: config.logLevel || 'info',\n        module: 'HCS5Client',\n        silent: config.silent,\n      });\n\n    this.mirrorNode = new HederaMirrorNode(this.network, this.logger);\n  }\n}\n"],"names":[],"mappings":";;AAQO,MAAe,eAAe;AAAA;AAAA;AAAA;AAAA,EAQnC,YAAY,QAA0B;AACpC,SAAK,UAAU,OAAO;AACtB,SAAK,SACH,OAAO,UACP,OAAO,YAAY;AAAA,MACjB,OAAO,OAAO,YAAY;AAAA,MAC1B,QAAQ;AAAA,MACR,QAAQ,OAAO;AAAA,IAAA,CAChB;AAEH,SAAK,aAAa,IAAI,iBAAiB,KAAK,SAAS,KAAK,MAAM;AAAA,EAClE;AACF;"}
+{"version":3,"file":"standards-sdk.es166.js","sources":["../../src/hcs-25/adapters/availability.ts"],"sourcesContent":["import { clampScore } from '../scoring';\nimport type {\n  Hcs25AdapterDefinition,\n  Hcs25NormalizedValue,\n  Hcs25Subject,\n} from '../types';\nimport { readBoolean, readNumber, readSubjectMetrics } from '../signals';\n\n/**\n * Options for the availability adapter.\n */\nexport interface Hcs25AvailabilityAdapterOptions {\n  /**\n   * How to interpret `availabilityScore`. `auto` (the default) treats\n   * values up to and including one as a ratio and larger values as an\n   * already-normalized percent.\n   */\n  scoreScale?: 'ratio' | 'percent' | 'auto';\n  /** Recency window in minutes for last-seen decay. Defaults to 1440. */\n  recencyWindowMinutes?: number;\n  /** Registries where reachability is not meaningful. */\n  excludeRegistries?: readonly string[];\n}\n\nconst DEFAULT_EXCLUDED_REGISTRIES: readonly string[] = [\n  'openrouter',\n  'near-ai',\n];\n\nfunction normalizeAvailability(\n  subject: Hcs25Subject,\n  scoreScale: 'ratio' | 'percent' | 'auto',\n  recencyWindowMinutes: number,\n): Hcs25NormalizedValue {\n  const metadata = subject.metadata;\n  const rawScore = metadata ? readNumber(metadata, 'availabilityScore') : null;\n  if (rawScore !== null) {\n    const ratio =\n      scoreScale === 'ratio'\n        ? rawScore\n        : scoreScale === 'percent'\n          ? rawScore / 100\n          : rawScore > 1\n            ? rawScore / 100\n            : rawScore;\n    return { value: clampScore(ratio * 100), status: 'ok' };\n  }\n\n  const metrics = readSubjectMetrics(subject);\n  const minsFromLastOnline = readNumber(metrics, 'minsFromLastOnline');\n  if (minsFromLastOnline !== null) {\n    return {\n      value: clampScore(100 * (1 - minsFromLastOnline / recencyWindowMinutes)),\n      status: 'ok',\n    };\n  }\n\n  const isOnline = readBoolean(metrics, 'isOnline');\n  if (isOnline !== null) {\n    return { value: isOnline ? 100 : 0, status: 'ok' };\n  }\n\n  return { value: 0, status: 'missing' };\n}\n\n/**\n * Creates the `availability` adapter: rewards reachable endpoints and\n * penalizes long offline windows using a linear 24-hour recency decay.\n */\nexport function createAvailabilityAdapter(\n  options: Hcs25AvailabilityAdapterOptions = {},\n): Hcs25AdapterDefinition {\n  const scoreScale = options.scoreScale ?? 'auto';\n  const recencyWindowMinutes = options.recencyWindowMinutes ?? 1440;\n\n  return {\n    id: 'availability',\n    weight: 1,\n    contributionMode: 'universal',\n    excludeRegistries: options.excludeRegistries ?? DEFAULT_EXCLUDED_REGISTRIES,\n    defaultComponentKey: 'availability.uptime',\n    components: [\n      {\n        name: 'uptime',\n        normalize: ({ subject }) =>\n          normalizeAvailability(subject, scoreScale, recencyWindowMinutes),\n      },\n    ],\n  };\n}\n"],"names":[],"mappings":";;;;;;AAwBA,MAAM,8BAAiD;AAAA,EACrD;AAAA,EACA;AACF;AAEA,SAAS,sBACP,SACA,YACA,sBACsB;AACtB,QAAM,WAAW,QAAQ;AACzB,QAAM,WAAW,WAAW,WAAW,UAAU,mBAAmB,IAAI;AACxE,MAAI,aAAa,MAAM;AACrB,UAAM,QACJ,eAAe,UACX,WACA,eAAe,YACb,WAAW,MACX,WAAW,IACT,WAAW,MACX;AACV,WAAO,EAAE,OAAO,WAAW,QAAQ,GAAG,GAAG,QAAQ,KAAA;AAAA,EACnD;AAEA,QAAM,UAAU,mBAAmB,OAAO;AAC1C,QAAM,qBAAqB,WAAW,SAAS,oBAAoB;AACnE,MAAI,uBAAuB,MAAM;AAC/B,WAAO;AAAA,MACL,OAAO,WAAW,OAAO,IAAI,qBAAqB,qBAAqB;AAAA,MACvE,QAAQ;AAAA,IAAA;AAAA,EAEZ;AAEA,QAAM,WAAW,YAAY,SAAS,UAAU;AAChD,MAAI,aAAa,MAAM;AACrB,WAAO,EAAE,OAAO,WAAW,MAAM,GAAG,QAAQ,KAAA;AAAA,EAC9C;AAEA,SAAO,EAAE,OAAO,GAAG,QAAQ,UAAA;AAC7B;AAMO,SAAS,0BACd,UAA2C,IACnB;AACxB,QAAM,aAAa,QAAQ,cAAc;AACzC,QAAM,uBAAuB,QAAQ,wBAAwB;AAE7D,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,QAAQ;AAAA,IACR,kBAAkB;AAAA,IAClB,mBAAmB,QAAQ,qBAAqB;AAAA,IAChD,qBAAqB;AAAA,IACrB,YAAY;AAAA,MACV;AAAA,QACE,MAAM;AAAA,QACN,WAAW,CAAC,EAAE,QAAA,MACZ,sBAAsB,SAAS,YAAY,oBAAoB;AAAA,MAAA;AAAA,IACnE;AAAA,EACF;AAEJ;"}