@hashgraphonline/standards-sdk 0.1.190 → 0.1.191

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

@@ -1,382 +1,172 @@
-import { readSubjectAdditional, isJsonObject, readString } from "./standards-sdk.es198.js";
-import "./standards-sdk.es182.js";
-import "./standards-sdk.es195.js";
-import "./standards-sdk.es196.js";
-import "./standards-sdk.es197.js";
-import { parseTimestampMs } from "./standards-sdk.es123.js";
-import { stripTrailingSlashes, requestJson, Hcs25CollectorHttpError, isTimeoutError } from "./standards-sdk.es122.js";
-const ETHOS_API_BASE_URL = "https://api.ethos.network";
-const DEFAULT_CLIENT_ID = "standards-sdk";
-const EMBEDDED_EVM_ADDRESS_PATTERN = /0x[0-9a-fA-F]{40}/;
-const TWITTER_HANDLE_PATTERN = /^[a-zA-Z0-9_]{1,64}$/;
-const DEFAULT_EXCLUDED_REGISTRIES = [
-  "openrouter",
-  "near-ai",
-  "agentverse",
-  "uagent"
-];
-const normalizeRegistry = (value) => typeof value === "string" ? value.trim().toLowerCase() : "";
-const extractAddress = (value) => {
-  if (typeof value !== "string") {
+import { resolveSubjectEndpoint } from "./standards-sdk.es127.js";
+import { isTimeoutError } from "./standards-sdk.es122.js";
+const MCP_PROTOCOL_VERSION = "2024-11-05";
+async function fetchOk(context, url, init) {
+  const response = await context.fetch(url, {
+    ...init,
+    signal: context.signal
+  });
+  return response.status < 500;
+}
+const mcpConnectivityProbe = async (subject, context) => {
+  const endpoint = resolveSubjectEndpoint(subject);
+  if (!endpoint) {
     return null;
   }
-  const match = EMBEDDED_EVM_ADDRESS_PATTERN.exec(value.trim());
-  return match ? match[0] : null;
+  const ok = await fetchOk(context, endpoint, {
+    method: "POST",
+    headers: {
+      "content-type": "application/json",
+      accept: "application/json, text/event-stream"
+    },
+    body: JSON.stringify({
+      jsonrpc: "2.0",
+      id: 1,
+      method: "initialize",
+      params: {
+        protocolVersion: MCP_PROTOCOL_VERSION,
+        capabilities: {},
+        clientInfo: { name: "hcs-25-connectivity-probe", version: "1" }
+      }
+    })
+  });
+  return ok ? 100 : 0;
 };
-function normalizeEthosUserkey(value) {
-  if (typeof value !== "string") {
-    return null;
-  }
-  const trimmed = value.trim();
-  if (!trimmed) {
+const a2aConnectivityProbe = async (subject, context) => {
+  const endpoint = resolveSubjectEndpoint(subject);
+  if (!endpoint) {
     return null;
   }
-  if (trimmed.includes(":")) {
-    return trimmed;
-  }
-  const address = extractAddress(trimmed);
-  return address ? `address:${address}` : null;
-}
-const userkeyKind = (userkey) => {
-  const trimmed = userkey.trim();
-  if (trimmed.startsWith("address:")) {
-    return "address";
-  }
-  if (trimmed.startsWith("service:x.com:")) {
-    return "x";
-  }
-  return "explicit";
+  const cardUrl = endpoint.includes("/.well-known/") ? endpoint : new URL("/.well-known/agent.json", endpoint).toString();
+  const ok = await fetchOk(context, cardUrl);
+  return ok ? 100 : 0;
 };
-const normalizeTwitterHandle = (value) => {
-  if (typeof value !== "string") {
+const httpConnectivityProbe = async (subject, context) => {
+  const endpoint = resolveSubjectEndpoint(subject);
+  if (!endpoint) {
     return null;
   }
-  const withoutAt = value.trim().replace(/^@/, "").replace(/\s+/g, "");
-  return TWITTER_HANDLE_PATTERN.test(withoutAt) ? withoutAt : null;
+  const ok = await fetchOk(context, endpoint);
+  return ok ? 100 : 0;
 };
-const extractTwitterFromSocials = (profile) => {
-  if (!isJsonObject(profile)) {
-    return null;
-  }
-  const socials = profile.socials;
-  if (!Array.isArray(socials)) {
-    return null;
-  }
-  for (const entry of socials) {
-    if (!isJsonObject(entry)) {
-      continue;
-    }
-    const platform = normalizeRegistry(
-      entry.platform
-    );
-    if (platform !== "twitter" && platform !== "x") {
-      continue;
-    }
-    const handle = normalizeTwitterHandle(
-      entry.handle
-    );
-    if (handle) {
-      return handle;
-    }
-  }
-  return null;
+const DEFAULT_PROBES = {
+  mcp: mcpConnectivityProbe,
+  a2a: a2aConnectivityProbe
 };
-function isEthosExcluded(subject) {
-  const registry = normalizeRegistry(subject.registry);
-  const metadata = subject.metadata ?? {};
-  const protocol = normalizeRegistry(
-    metadata.protocol
-  );
-  const protocols = Array.isArray(
-    subject.protocols
-  ) ? (subject.protocols ?? []).filter((v) => typeof v === "string").map(normalizeRegistry) : [];
-  return registry === "agentverse" || registry === "uagent" || protocol === "uagent" || protocols.includes("uagent");
-}
-function deriveEthosSources(subject) {
-  const metadata = subject.metadata ?? {};
-  const registry = normalizeRegistry(subject.registry);
-  const additional = readSubjectAdditional(subject);
-  const epoch = (/* @__PURE__ */ new Date(0)).toISOString();
-  const push = (list, userkey, kind, weight) => {
-    if (!list.some((source) => source.userkey === userkey)) {
-      list.push({
-        userkey,
-        kind,
-        weight,
-        status: "missing",
-        score: null,
-        updatedAt: epoch
-      });
-    }
-  };
-  const sources = [];
-  const trustProviderIds = isJsonObject(metadata.trustProviderIds) ? metadata.trustProviderIds : void 0;
-  const trustProviders = isJsonObject(metadata.trust) && isJsonObject(metadata.trust.providers) ? metadata.trust.providers : void 0;
-  for (const candidate of [
-    trustProviderIds?.ethos,
-    trustProviders?.ethos,
-    metadata.ethosUserkey
-  ]) {
-    const userkey = normalizeEthosUserkey(candidate);
-    if (userkey) {
-      push(sources, userkey, userkeyKind(userkey), 1);
-      return sources;
-    }
-  }
-  const metadataRecord = metadata;
-  const profileSocials = extractTwitterFromSocials(metadataRecord.profile) ?? extractTwitterFromSocials(subject.profile);
-  if (registry === "virtuals-protocol") {
-    const handle = normalizeTwitterHandle(metadataRecord.twitterHandle) ?? normalizeTwitterHandle(metadataRecord.memeTwitterHandle) ?? profileSocials;
-    if (handle) {
-      push(sources, `service:x.com:username:${handle}`, "x", 0.7);
-    }
-  } else if (registry === "moltbook") {
-    const owner = isJsonObject(metadataRecord.moltbook) ? normalizeTwitterHandle(
-      metadataRecord.moltbook.owner
-    ) : null;
-    const handle = owner ?? profileSocials;
-    if (handle) {
-      push(sources, `service:x.com:username:${handle}`, "x", 1);
-    }
-  } else {
-    const genericHandle = [
-      readString(additional, "twitter"),
-      readString(additional, "xHandle"),
-      readString(additional, "x"),
-      readString(additional, "twitterHandle"),
-      readString(metadataRecord, "twitter"),
-      readString(metadataRecord, "xHandle"),
-      readString(metadataRecord, "x"),
-      profileSocials
-    ].map(normalizeTwitterHandle).find((handle) => handle !== null);
-    if (genericHandle) {
-      push(sources, `service:x.com:username:${genericHandle}`, "x", 1);
-    }
-  }
-  const addressCandidates = [
-    metadataRecord.agentAddress,
-    metadataRecord.ownerAddress,
-    metadataRecord.payTo,
-    metadataRecord.agentAddressCaip,
-    metadataRecord.nativeId,
-    metadataRecord.address,
-    metadataRecord.evmAddress,
-    metadataRecord.uid
-  ];
-  for (const candidate of addressCandidates) {
-    const address = extractAddress(candidate);
-    if (!address) {
-      continue;
-    }
-    const weightedRegistry = registry === "virtuals-protocol" || registry === "moltbook";
-    const weight = weightedRegistry && sources.some((source) => source.kind === "x") ? 0.3 : 1;
-    push(sources, `address:${address}`, "address", weight);
-    break;
-  }
-  return sources;
-}
-const pickPrimaryUserkey = (sources) => sources.find((source) => source.kind === "address")?.userkey ?? sources[0]?.userkey ?? null;
-function readStoredSources(subject) {
-  const raw = subject.metadata?.ethosSources;
-  if (!Array.isArray(raw)) {
-    return [];
-  }
-  const out = [];
-  for (const entry of raw) {
-    if (!isJsonObject(entry)) {
-      continue;
-    }
-    const record = entry;
-    const userkey = readString(record, "userkey");
-    if (!userkey) {
-      continue;
-    }
-    const rawKind = readString(record, "kind");
-    const rawStatus = readString(record, "status");
-    const score = record.score;
-    out.push({
-      userkey,
-      kind: rawKind === "x" || rawKind === "address" || rawKind === "explicit" ? rawKind : userkeyKind(userkey),
-      weight: typeof record.weight === "number" && Number.isFinite(record.weight) ? Math.max(0, record.weight) : 1,
-      status: rawStatus === "ok" || rawStatus === "error" ? rawStatus : "missing",
-      score: typeof score === "number" && Number.isFinite(score) ? score : null,
-      updatedAt: readString(record, "updatedAt") ?? (/* @__PURE__ */ new Date(0)).toISOString()
-    });
-  }
-  return out;
-}
-function createEthosSignalAdapter(options = {}) {
-  const baseUrl = stripTrailingSlashes(options.baseUrl ?? ETHOS_API_BASE_URL);
-  const resolveSources = options.sources ?? deriveEthosSources;
-  const ttlMs = options.ttlMs ?? 12 * 60 * 60 * 1e3;
-  const failureTtlMs = options.failureTtlMs ?? 6 * 60 * 60 * 1e3;
-  const maxRetries = options.maxRetries ?? 2;
-  const inferAddress = options.inferAddress ?? true;
-  const clientId = options.client ?? DEFAULT_CLIENT_ID;
+const DEFAULT_EXCLUDED_REGISTRIES = [
+  "openrouter",
+  "near-ai"
+];
+function createConnectivitySignalAdapter(options = {}) {
+  const probes = { ...DEFAULT_PROBES, ...options.probes };
   const collect = async (subject, context) => {
-    const now = context.now.toISOString();
-    const resolved = (() => {
-      const sources = resolveSources(subject);
-      return inferAddress ? [...sources] : sources.filter((source) => source.kind !== "address");
-    })();
-    if (resolved.length === 0) {
+    const now = context.now;
+    const protocol = subject.protocol?.toLowerCase();
+    const protocolProbe = protocol ? probes[protocol] : void 0;
+    const defaultProbe = probes.default ?? httpConnectivityProbe;
+    const namedTargets = Object.keys(probes).filter(
+      (key) => key !== protocol && key !== "default" && !(key in DEFAULT_PROBES)
+    );
+    const results = [];
+    const targets = {};
+    let primaryScore = null;
+    let primaryStatus = "ok";
+    let probed = false;
+    const runProbe = async (probe, signalId, target) => {
+      try {
+        const score = await probe(subject, context);
+        if (score === null) {
+          return;
+        }
+        probed = true;
+        const clamped = Math.min(100, Math.max(0, score));
+        if (target) {
+          targets[target] = clamped;
+        } else {
+          primaryScore = clamped;
+        }
+        results.push({
+          signalId,
+          status: "ok",
+          value: clamped,
+          provenance: {
+            source: "connectivity-probe",
+            sourceUrl: resolveSubjectEndpoint(subject) ?? void 0,
+            subjectId: subject.id,
+            fetchedAt: now.toISOString()
+          }
+        });
+      } catch (error) {
+        probed = true;
+        const status = isTimeoutError(error) ? "timeout" : "error";
+        if (!target) {
+          primaryStatus = status;
+          primaryScore = 0;
+        }
+        results.push({
+          signalId,
+          status,
+          provenance: {
+            source: "connectivity-probe",
+            subjectId: subject.id,
+            fetchedAt: now.toISOString()
+          }
+        });
+      }
+    };
+    await runProbe(protocolProbe ?? defaultProbe, "connectivity.probe");
+    for (const target of namedTargets) {
+      await runProbe(probes[target], `connectivity.${target}`, target);
+    }
+    if (!probed) {
       return [
         {
-          signalId: "ethos.score",
+          signalId: "connectivity.probe",
           status: "missing",
           fields: [
             {
-              scope: "root",
-              values: {
-                ethosScore: null,
-                ethosScoreStatus: "missing",
-                ethosScoreUpdatedAt: now,
-                ethosSources: []
-              }
+              scope: "additional",
+              values: { connectivityStatus: "missing" }
             }
           ]
         }
       ];
     }
-    const storedByUserkey = new Map(
-      readStoredSources(subject).map((source) => [source.userkey, source])
-    );
-    const merged = resolved.map((source) => {
-      const stored = storedByUserkey.get(source.userkey);
-      return {
-        ...source,
-        status: stored?.status ?? source.status ?? "missing",
-        score: stored?.score ?? source.score ?? null,
-        updatedAt: stored?.updatedAt ?? source.updatedAt
-      };
-    });
-    const toRefresh = merged.filter((source) => {
-      if (context.force) {
-        return true;
-      }
-      const updatedMs = parseTimestampMs(source.updatedAt);
-      if (updatedMs === null || updatedMs <= 0) {
-        return true;
-      }
-      const ttl = source.status === "ok" ? ttlMs : failureTtlMs;
-      return context.now.getTime() - updatedMs >= ttl;
-    });
-    const headers = { "X-Ethos-Client": clientId };
-    let sawTimeout = false;
-    await Promise.all(
-      toRefresh.map(async (source) => {
-        const url = `${baseUrl}/api/v1/score/${encodeURIComponent(source.userkey)}`;
-        try {
-          const data = await requestJson(url, {
-            fetch: context.fetch,
-            headers,
-            timeoutMs: context.timeoutMs,
-            signal: context.signal,
-            maxRetries
-          });
-          const score = typeof data?.data?.score === "number" && Number.isFinite(data.data.score) ? data.data.score : typeof data?.score === "number" && Number.isFinite(data.score) ? data.score : null;
-          source.updatedAt = now;
-          if (data?.ok === false || score === null) {
-            source.status = "missing";
-            source.score = null;
-          } else {
-            source.status = "ok";
-            source.score = score;
-          }
-        } catch (error) {
-          source.updatedAt = now;
-          if (error instanceof Hcs25CollectorHttpError) {
-            if (error.status === 404) {
-              source.status = "missing";
-              source.score = null;
-            } else {
-              source.status = "error";
-              source.score = source.score ?? null;
-            }
-          } else if (isTimeoutError(error)) {
-            source.status = "error";
-            sawTimeout = true;
-          } else {
-            source.status = "error";
-          }
-        }
-      })
-    );
-    const scoredSources = merged.filter(
-      (source) => typeof source.score === "number" && Number.isFinite(source.score)
-    );
-    const weightSum = scoredSources.reduce(
-      (sum, source) => sum + Math.max(0, source.weight),
-      0
-    );
-    const composite = weightSum > 0 ? Math.round(
-      scoredSources.reduce(
-        (sum, source) => sum + source.weight * (source.score ?? 0),
-        0
-      ) / weightSum * 100
-    ) / 100 : null;
-    const compositeStatus = merged.some(
-      (source) => source.status === "ok"
-    ) ? "ok" : merged.some((source) => source.status === "error") ? "error" : "missing";
-    const weights = {};
-    for (const source of merged) {
-      weights[source.kind] = Math.round(((weights[source.kind] ?? 0) + source.weight) * 100) / 100;
+    const additional = {
+      connectivityStatus: primaryStatus === "ok" ? "ok" : primaryStatus
+    };
+    if (primaryScore !== null) {
+      additional.connectivityScore = primaryScore;
+    }
+    if (Object.keys(targets).length > 0) {
+      additional.connectivityTargets = { ...targets };
     }
-    const signalStatus = compositeStatus === "ok" ? "ok" : sawTimeout ? "timeout" : compositeStatus === "error" ? "error" : "missing";
+    const last = results[results.length - 1];
     return [
+      ...results,
       {
-        signalId: "ethos.score",
-        status: signalStatus,
-        value: composite,
-        fields: [
-          {
-            scope: "root",
-            values: {
-              ethosUserkey: pickPrimaryUserkey(merged),
-              ethosScore: composite,
-              ethosScoreStatus: compositeStatus,
-              ethosScoreUpdatedAt: now,
-              ethosSources: merged.map((source) => ({
-                userkey: source.userkey,
-                kind: source.kind,
-                weight: source.weight,
-                status: source.status ?? "missing",
-                score: source.score ?? null,
-                updatedAt: source.updatedAt ?? now
-              })),
-              ethosComposite: {
-                version: 1,
-                score: composite,
-                updatedAt: now,
-                weights
-              }
-            }
-          }
-        ],
-        provenance: {
-          source: "ethos",
-          sourceUrl: `${baseUrl}/api/v1/score`,
-          subjectId: subject.id,
-          fetchedAt: now,
-          params: { userkeys: merged.map((source) => source.userkey) }
-        }
+        signalId: "connectivity.score",
+        status: primaryStatus === "ok" ? "ok" : primaryStatus,
+        value: primaryScore ?? void 0,
+        fields: [{ scope: "additional", values: additional }],
+        provenance: last?.provenance
       }
     ];
   };
   return {
-    id: "ethos",
-    produces: ["ethos.score"],
+    id: "connectivity",
+    produces: ["connectivity.probe", "connectivity.score"],
     timeoutMs: options.timeoutMs,
     includeRegistries: options.includeRegistries,
     excludeRegistries: options.excludeRegistries ?? DEFAULT_EXCLUDED_REGISTRIES,
-    appliesTo: options.appliesTo ?? ((subject) => !isEthosExcluded(subject)),
+    appliesTo: options.appliesTo,
     collect
   };
 }
 export {
-  createEthosSignalAdapter,
-  deriveEthosSources,
-  isEthosExcluded,
-  normalizeEthosUserkey
+  a2aConnectivityProbe,
+  createConnectivitySignalAdapter,
+  httpConnectivityProbe,
+  mcpConnectivityProbe
 };
 //# sourceMappingURL=standards-sdk.es130.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es130.js","sources":["../../src/hcs-25/collectors/ethos.ts"],"sourcesContent":["import type { Hcs25JsonValue, Hcs25Subject } from '../types';\nimport { isJsonObject, readString, readSubjectAdditional } from '../signals';\nimport { parseTimestampMs } from './freshness';\nimport {\n  Hcs25CollectorHttpError,\n  isTimeoutError,\n  requestJson,\n  stripTrailingSlashes,\n} from './http';\nimport type {\n  Hcs25CollectContext,\n  Hcs25SignalAdapter,\n  Hcs25SignalAdapterResult,\n} from './types';\n\nconst ETHOS_API_BASE_URL = 'https://api.ethos.network';\nconst DEFAULT_CLIENT_ID = 'standards-sdk';\nconst EMBEDDED_EVM_ADDRESS_PATTERN = /0x[0-9a-fA-F]{40}/;\nconst TWITTER_HANDLE_PATTERN = /^[a-zA-Z0-9_]{1,64}$/;\n\ntype EthosSourceKind = 'explicit' | 'x' | 'address';\ntype EthosStoredStatus = 'ok' | 'missing' | 'error';\n\n/**\n * A resolved Ethos userkey source: the userkey, how it was derived, and its\n * composite weight (per the ethos signal document's `ethosSources` schema).\n */\nexport interface Hcs25EthosSource {\n  userkey: string;\n  kind: EthosSourceKind;\n  weight: number;\n  status?: EthosStoredStatus;\n  score?: number | null;\n  updatedAt?: string;\n}\n\n/**\n * Options for the Ethos signal adapter.\n */\nexport interface Hcs25EthosSignalAdapterOptions {\n  /**\n   * Ethos API base URL; the collector requests\n   * `{baseUrl}/api/v1/score/{userkey}` (the production v1 endpoint, which\n   * returns an `{ok, data: {score}}` envelope). Default\n   * `https://api.ethos.network`.\n   */\n  baseUrl?: string;\n  /** `X-Ethos-Client` identifier sent with every request. */\n  client?: string;\n  /**\n   * Explicit source list; when omitted, sources are derived per the\n   * production derivation rules (see {@link deriveEthosSources}).\n   */\n  sources?: (subject: Hcs25Subject) => readonly Hcs25EthosSource[];\n  /**\n   * Refresh interval applied to sources whose stored status is `ok`.\n   * Default 12 hours. Set to 0 to always refetch.\n   */\n  ttlMs?: number;\n  /**\n   * Refresh interval applied to sources in `missing`/`error` state.\n   * Default 6 hours.\n   */\n  failureTtlMs?: number;\n  /** Transient-failure retries per source request. Default 2. */\n  maxRetries?: number;\n  /**\n   * When false, disables EVM-address inference (`agentAddress`,\n   * `ownerAddress`, `payTo`, `agentAddressCaip`, `nativeId`, …). Default\n   * true.\n   */\n  inferAddress?: boolean;\n  /** Per-adapter timeout in milliseconds. */\n  timeoutMs?: number;\n  includeRegistries?: readonly string[];\n  excludeRegistries?: readonly string[];\n  appliesTo?: (subject: Hcs25Subject) => boolean;\n}\n\nconst DEFAULT_EXCLUDED_REGISTRIES: readonly string[] = [\n  'openrouter',\n  'near-ai',\n  'agentverse',\n  'uagent',\n];\n\ninterface EthosScoreResponse {\n  ok?: boolean;\n  data?: { score?: number };\n  score?: number;\n}\n\nconst normalizeRegistry = (value: unknown): string =>\n  typeof value === 'string' ? value.trim().toLowerCase() : '';\n\nconst extractAddress = (value: unknown): string | null => {\n  if (typeof value !== 'string') {\n    return null;\n  }\n  const match = EMBEDDED_EVM_ADDRESS_PATTERN.exec(value.trim());\n  return match ? match[0] : null;\n};\n\n/**\n * Normalizes a stored/explicit Ethos userkey: values already containing a\n * `kind:` prefix pass through; bare EVM addresses become `address:0x…`.\n */\nexport function normalizeEthosUserkey(value: unknown): string | null {\n  if (typeof value !== 'string') {\n    return null;\n  }\n  const trimmed = value.trim();\n  if (!trimmed) {\n    return null;\n  }\n  if (trimmed.includes(':')) {\n    return trimmed;\n  }\n  const address = extractAddress(trimmed);\n  return address ? `address:${address}` : null;\n}\n\nconst userkeyKind = (userkey: string): EthosSourceKind => {\n  const trimmed = userkey.trim();\n  if (trimmed.startsWith('address:')) {\n    return 'address';\n  }\n  if (trimmed.startsWith('service:x.com:')) {\n    return 'x';\n  }\n  return 'explicit';\n};\n\nconst normalizeTwitterHandle = (value: unknown): string | null => {\n  if (typeof value !== 'string') {\n    return null;\n  }\n  const withoutAt = value.trim().replace(/^@/, '').replace(/\\s+/g, '');\n  return TWITTER_HANDLE_PATTERN.test(withoutAt) ? withoutAt : null;\n};\n\nconst extractTwitterFromSocials = (profile: unknown): string | null => {\n  if (!isJsonObject(profile as Hcs25JsonValue)) {\n    return null;\n  }\n  const socials = (profile as Record<string, Hcs25JsonValue>).socials;\n  if (!Array.isArray(socials)) {\n    return null;\n  }\n  for (const entry of socials) {\n    if (!isJsonObject(entry)) {\n      continue;\n    }\n    const platform = normalizeRegistry(\n      (entry as Record<string, Hcs25JsonValue>).platform,\n    );\n    if (platform !== 'twitter' && platform !== 'x') {\n      continue;\n    }\n    const handle = normalizeTwitterHandle(\n      (entry as Record<string, Hcs25JsonValue>).handle,\n    );\n    if (handle) {\n      return handle;\n    }\n  }\n  return null;\n};\n\n/**\n * True when the subject is structurally outside Ethos coverage (uAgent /\n * AgentVerse agents per the ethos signal doc).\n */\nexport function isEthosExcluded(subject: Hcs25Subject): boolean {\n  const registry = normalizeRegistry(subject.registry);\n  const metadata = subject.metadata ?? {};\n  const protocol = normalizeRegistry(\n    (metadata as Record<string, Hcs25JsonValue>).protocol,\n  );\n  const protocols = Array.isArray(\n    (subject as { protocols?: unknown }).protocols,\n  )\n    ? ((subject as { protocols?: unknown[] }).protocols ?? [])\n        .filter((v): v is string => typeof v === 'string')\n        .map(normalizeRegistry)\n    : [];\n  return (\n    registry === 'agentverse' ||\n    registry === 'uagent' ||\n    protocol === 'uagent' ||\n    protocols.includes('uagent')\n  );\n}\n\n/**\n * Derives Ethos userkey sources per the production rules:\n *\n * - `metadata.trustProviderIds.ethos` / `metadata.trust.providers.ethos` /\n *   `metadata.ethosUserkey` are explicit userkeys (weight 1, short-circuit).\n * - `virtuals-protocol` subjects derive an `x` source from\n *   `twitterHandle`/`memeTwitterHandle`/`profile.socials` (weight 0.7);\n *   `moltbook` subjects derive from `moltbook.owner`/`profile.socials`\n *   (weight 1). Other registries use the generic\n *   `additional.twitter|xHandle|x|twitterHandle` keys (weight 1).\n * - `agentAddress`, `ownerAddress`, `payTo`, `agentAddressCaip`,\n *   `nativeId`, `address`, `evmAddress`, `uid` yield an `address:` source\n *   (embedded `0x…` extraction makes CAIP ids work). Weight drops to 0.3\n *   when an `x` source already exists on a weighted registry.\n */\nexport function deriveEthosSources(subject: Hcs25Subject): Hcs25EthosSource[] {\n  const metadata = subject.metadata ?? {};\n  const registry = normalizeRegistry(subject.registry);\n  const additional = readSubjectAdditional(subject);\n  const epoch = new Date(0).toISOString();\n  const push = (\n    list: Hcs25EthosSource[],\n    userkey: string,\n    kind: EthosSourceKind,\n    weight: number,\n  ): void => {\n    if (!list.some(source => source.userkey === userkey)) {\n      list.push({\n        userkey,\n        kind,\n        weight,\n        status: 'missing',\n        score: null,\n        updatedAt: epoch,\n      });\n    }\n  };\n\n  const sources: Hcs25EthosSource[] = [];\n\n  const trustProviderIds = isJsonObject(metadata.trustProviderIds)\n    ? metadata.trustProviderIds\n    : undefined;\n  const trustProviders =\n    isJsonObject(metadata.trust) && isJsonObject(metadata.trust.providers)\n      ? (metadata.trust.providers as Record<string, Hcs25JsonValue>)\n      : undefined;\n  for (const candidate of [\n    trustProviderIds?.ethos,\n    trustProviders?.ethos,\n    metadata.ethosUserkey,\n  ]) {\n    const userkey = normalizeEthosUserkey(candidate);\n    if (userkey) {\n      push(sources, userkey, userkeyKind(userkey), 1);\n      return sources;\n    }\n  }\n\n  const metadataRecord = metadata as Record<string, Hcs25JsonValue>;\n  const profileSocials =\n    extractTwitterFromSocials(metadataRecord.profile) ??\n    extractTwitterFromSocials((subject as { profile?: unknown }).profile);\n\n  if (registry === 'virtuals-protocol') {\n    const handle =\n      normalizeTwitterHandle(metadataRecord.twitterHandle) ??\n      normalizeTwitterHandle(metadataRecord.memeTwitterHandle) ??\n      profileSocials;\n    if (handle) {\n      push(sources, `service:x.com:username:${handle}`, 'x', 0.7);\n    }\n  } else if (registry === 'moltbook') {\n    const owner = isJsonObject(metadataRecord.moltbook)\n      ? normalizeTwitterHandle(\n          (metadataRecord.moltbook as Record<string, Hcs25JsonValue>).owner,\n        )\n      : null;\n    const handle = owner ?? profileSocials;\n    if (handle) {\n      push(sources, `service:x.com:username:${handle}`, 'x', 1);\n    }\n  } else {\n    const genericHandle = [\n      readString(additional, 'twitter'),\n      readString(additional, 'xHandle'),\n      readString(additional, 'x'),\n      readString(additional, 'twitterHandle'),\n      readString(metadataRecord, 'twitter'),\n      readString(metadataRecord, 'xHandle'),\n      readString(metadataRecord, 'x'),\n      profileSocials,\n    ]\n      .map(normalizeTwitterHandle)\n      .find((handle): handle is string => handle !== null);\n    if (genericHandle) {\n      push(sources, `service:x.com:username:${genericHandle}`, 'x', 1);\n    }\n  }\n\n  const addressCandidates = [\n    metadataRecord.agentAddress,\n    metadataRecord.ownerAddress,\n    metadataRecord.payTo,\n    metadataRecord.agentAddressCaip,\n    metadataRecord.nativeId,\n    metadataRecord.address,\n    metadataRecord.evmAddress,\n    metadataRecord.uid,\n  ];\n  for (const candidate of addressCandidates) {\n    const address = extractAddress(candidate);\n    if (!address) {\n      continue;\n    }\n    const weightedRegistry =\n      registry === 'virtuals-protocol' || registry === 'moltbook';\n    const weight =\n      weightedRegistry && sources.some(source => source.kind === 'x') ? 0.3 : 1;\n    push(sources, `address:${address}`, 'address', weight);\n    break;\n  }\n\n  return sources;\n}\n\nconst pickPrimaryUserkey = (\n  sources: readonly Hcs25EthosSource[],\n): string | null =>\n  sources.find(source => source.kind === 'address')?.userkey ??\n  sources[0]?.userkey ??\n  null;\n\nfunction readStoredSources(subject: Hcs25Subject): Hcs25EthosSource[] {\n  const raw = subject.metadata?.ethosSources;\n  if (!Array.isArray(raw)) {\n    return [];\n  }\n  const out: Hcs25EthosSource[] = [];\n  for (const entry of raw) {\n    if (!isJsonObject(entry)) {\n      continue;\n    }\n    const record = entry as Record<string, Hcs25JsonValue>;\n    const userkey = readString(record, 'userkey');\n    if (!userkey) {\n      continue;\n    }\n    const rawKind = readString(record, 'kind');\n    const rawStatus = readString(record, 'status');\n    const score = record.score;\n    out.push({\n      userkey,\n      kind:\n        rawKind === 'x' || rawKind === 'address' || rawKind === 'explicit'\n          ? rawKind\n          : userkeyKind(userkey),\n      weight:\n        typeof record.weight === 'number' && Number.isFinite(record.weight)\n          ? Math.max(0, record.weight)\n          : 1,\n      status:\n        rawStatus === 'ok' || rawStatus === 'error' ? rawStatus : 'missing',\n      score: typeof score === 'number' && Number.isFinite(score) ? score : null,\n      updatedAt: readString(record, 'updatedAt') ?? new Date(0).toISOString(),\n    });\n  }\n  return out;\n}\n\n/**\n * Creates the `ethos` signal adapter: resolves the subject's Ethos userkeys\n * per the production derivation rules, fetches each source's score from the\n * Ethos v1 score endpoint (`{ok, data:{score}}` envelope), merges with the\n * stored `ethosSources` per-source freshness (TTL/failure-TTL gating), and\n * writes the `ethosUserkey`/`ethosScore`/`ethosScoreStatus`/`ethosSources`/\n * `ethosComposite` stored fields per the signal catalog.\n */\nexport function createEthosSignalAdapter(\n  options: Hcs25EthosSignalAdapterOptions = {},\n): Hcs25SignalAdapter {\n  const baseUrl = stripTrailingSlashes(options.baseUrl ?? ETHOS_API_BASE_URL);\n  const resolveSources = options.sources ?? deriveEthosSources;\n  const ttlMs = options.ttlMs ?? 12 * 60 * 60 * 1000;\n  const failureTtlMs = options.failureTtlMs ?? 6 * 60 * 60 * 1000;\n  const maxRetries = options.maxRetries ?? 2;\n  const inferAddress = options.inferAddress ?? true;\n  const clientId = options.client ?? DEFAULT_CLIENT_ID;\n\n  const collect = async (\n    subject: Hcs25Subject,\n    context: Hcs25CollectContext,\n  ): Promise<Hcs25SignalAdapterResult[]> => {\n    const now = context.now.toISOString();\n\n    const resolved = ((): Hcs25EthosSource[] => {\n      const sources = resolveSources(subject);\n      return inferAddress\n        ? [...sources]\n        : sources.filter(source => source.kind !== 'address');\n    })();\n\n    if (resolved.length === 0) {\n      return [\n        {\n          signalId: 'ethos.score',\n          status: 'missing',\n          fields: [\n            {\n              scope: 'root',\n              values: {\n                ethosScore: null,\n                ethosScoreStatus: 'missing',\n                ethosScoreUpdatedAt: now,\n                ethosSources: [],\n              },\n            },\n          ],\n        },\n      ];\n    }\n\n    // Merge with stored sources: keep prior scores/statuses so a transient\n    // failure does not erase data, and so TTL gating can skip fresh sources.\n    const storedByUserkey = new Map(\n      readStoredSources(subject).map(source => [source.userkey, source]),\n    );\n    const merged: Hcs25EthosSource[] = resolved.map(source => {\n      const stored = storedByUserkey.get(source.userkey);\n      return {\n        ...source,\n        status: stored?.status ?? source.status ?? 'missing',\n        score: stored?.score ?? source.score ?? null,\n        updatedAt: stored?.updatedAt ?? source.updatedAt,\n      };\n    });\n\n    const toRefresh = merged.filter(source => {\n      if (context.force) {\n        return true;\n      }\n      const updatedMs = parseTimestampMs(source.updatedAt);\n      if (updatedMs === null || updatedMs <= 0) {\n        return true;\n      }\n      const ttl = source.status === 'ok' ? ttlMs : failureTtlMs;\n      return context.now.getTime() - updatedMs >= ttl;\n    });\n\n    const headers: Record<string, string> = { 'X-Ethos-Client': clientId };\n    let sawError = false;\n    let sawTimeout = false;\n\n    await Promise.all(\n      toRefresh.map(async source => {\n        const url = `${baseUrl}/api/v1/score/${encodeURIComponent(source.userkey)}`;\n        try {\n          const data = await requestJson<EthosScoreResponse>(url, {\n            fetch: context.fetch,\n            headers,\n            timeoutMs: context.timeoutMs,\n            signal: context.signal,\n            maxRetries,\n          });\n          // Production envelope `{ok, data:{score}}`; tolerate a flat\n          // `{score}` payload for v2-shaped endpoints.\n          const score =\n            typeof data?.data?.score === 'number' &&\n            Number.isFinite(data.data.score)\n              ? data.data.score\n              : typeof data?.score === 'number' && Number.isFinite(data.score)\n                ? data.score\n                : null;\n          source.updatedAt = now;\n          if (data?.ok === false || score === null) {\n            source.status = 'missing';\n            source.score = null;\n          } else {\n            source.status = 'ok';\n            source.score = score;\n          }\n        } catch (error) {\n          source.updatedAt = now;\n          if (error instanceof Hcs25CollectorHttpError) {\n            if (error.status === 404) {\n              source.status = 'missing';\n              source.score = null;\n            } else {\n              source.status = 'error';\n              // Preserve a previously stored score on transient failure.\n              source.score = source.score ?? null;\n              sawError = true;\n            }\n          } else if (isTimeoutError(error)) {\n            source.status = 'error';\n            sawTimeout = true;\n            sawError = true;\n          } else {\n            source.status = 'error';\n            sawError = true;\n          }\n        }\n      }),\n    );\n\n    const scoredSources = merged.filter(\n      source =>\n        typeof source.score === 'number' && Number.isFinite(source.score),\n    );\n    const weightSum = scoredSources.reduce(\n      (sum, source) => sum + Math.max(0, source.weight),\n      0,\n    );\n    const composite =\n      weightSum > 0\n        ? Math.round(\n            (scoredSources.reduce(\n              (sum, source) => sum + source.weight * (source.score ?? 0),\n              0,\n            ) /\n              weightSum) *\n              100,\n          ) / 100\n        : null;\n\n    const compositeStatus: EthosStoredStatus = merged.some(\n      source => source.status === 'ok',\n    )\n      ? 'ok'\n      : merged.some(source => source.status === 'error')\n        ? 'error'\n        : 'missing';\n\n    // Composite weights are keyed by source kind (x/address/explicit).\n    const weights: Record<string, number> = {};\n    for (const source of merged) {\n      weights[source.kind] =\n        Math.round(((weights[source.kind] ?? 0) + source.weight) * 100) / 100;\n    }\n\n    const signalStatus =\n      compositeStatus === 'ok'\n        ? 'ok'\n        : sawTimeout\n          ? 'timeout'\n          : compositeStatus === 'error'\n            ? 'error'\n            : 'missing';\n\n    return [\n      {\n        signalId: 'ethos.score',\n        status: signalStatus,\n        value: composite,\n        fields: [\n          {\n            scope: 'root',\n            values: {\n              ethosUserkey: pickPrimaryUserkey(merged),\n              ethosScore: composite,\n              ethosScoreStatus: compositeStatus,\n              ethosScoreUpdatedAt: now,\n              ethosSources: merged.map(source => ({\n                userkey: source.userkey,\n                kind: source.kind,\n                weight: source.weight,\n                status: source.status ?? 'missing',\n                score: source.score ?? null,\n                updatedAt: source.updatedAt ?? now,\n              })),\n              ethosComposite: {\n                version: 1,\n                score: composite,\n                updatedAt: now,\n                weights,\n              },\n            },\n          },\n        ],\n        provenance: {\n          source: 'ethos',\n          sourceUrl: `${baseUrl}/api/v1/score`,\n          subjectId: subject.id,\n          fetchedAt: now,\n          params: { userkeys: merged.map(source => source.userkey) },\n        },\n      },\n    ];\n  };\n\n  return {\n    id: 'ethos',\n    produces: ['ethos.score'],\n    timeoutMs: options.timeoutMs,\n    includeRegistries: options.includeRegistries,\n    excludeRegistries: options.excludeRegistries ?? DEFAULT_EXCLUDED_REGISTRIES,\n    appliesTo: options.appliesTo ?? (subject => !isEthosExcluded(subject)),\n    collect,\n  };\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es130.js","sources":["../../src/hcs-25/collectors/connectivity.ts"],"sourcesContent":["import type { Hcs25JsonValue, Hcs25Subject } from '../types';\nimport { resolveSubjectEndpoint } from './endpoints';\nimport { isTimeoutError } from './http';\nimport type {\n  Hcs25CollectContext,\n  Hcs25SignalAdapter,\n  Hcs25SignalAdapterResult,\n} from './types';\n\n/**\n * A protocol probe: returns a connectivity score in `[0,100]`, or null when\n * the probe is not meaningful for the subject.\n */\nexport type Hcs25ConnectivityProbe = (\n  subject: Hcs25Subject,\n  context: Hcs25CollectContext,\n) => Promise<number | null>;\n\nconst MCP_PROTOCOL_VERSION = '2024-11-05';\n\nasync function fetchOk(\n  context: Hcs25CollectContext,\n  url: string,\n  init?: { method?: string; headers?: Record<string, string>; body?: string },\n): Promise<boolean> {\n  const response = await context.fetch(url, {\n    ...init,\n    signal: context.signal,\n  });\n  return response.status < 500;\n}\n\n/**\n * MCP probe: posts a JSON-RPC `initialize` request to the endpoint. Any\n * definite HTTP response (including 4xx such as 405 on SSE-only endpoints)\n * proves connectivity; only network failure or 5xx count as disconnected.\n */\nexport const mcpConnectivityProbe: Hcs25ConnectivityProbe = async (\n  subject,\n  context,\n) => {\n  const endpoint = resolveSubjectEndpoint(subject);\n  if (!endpoint) {\n    return null;\n  }\n  const ok = await fetchOk(context, endpoint, {\n    method: 'POST',\n    headers: {\n      'content-type': 'application/json',\n      accept: 'application/json, text/event-stream',\n    },\n    body: JSON.stringify({\n      jsonrpc: '2.0',\n      id: 1,\n      method: 'initialize',\n      params: {\n        protocolVersion: MCP_PROTOCOL_VERSION,\n        capabilities: {},\n        clientInfo: { name: 'hcs-25-connectivity-probe', version: '1' },\n      },\n    }),\n  });\n  return ok ? 100 : 0;\n};\n\n/**\n * A2A probe: fetches the agent card at `/.well-known/agent.json` relative to\n * the endpoint origin (or the endpoint itself when it already points at a\n * well-known path).\n */\nexport const a2aConnectivityProbe: Hcs25ConnectivityProbe = async (\n  subject,\n  context,\n) => {\n  const endpoint = resolveSubjectEndpoint(subject);\n  if (!endpoint) {\n    return null;\n  }\n  const cardUrl = endpoint.includes('/.well-known/')\n    ? endpoint\n    : new URL('/.well-known/agent.json', endpoint).toString();\n  const ok = await fetchOk(context, cardUrl);\n  return ok ? 100 : 0;\n};\n\n/**\n * Generic HTTP probe: GET the endpoint; any response below 500 counts as\n * connected.\n */\nexport const httpConnectivityProbe: Hcs25ConnectivityProbe = async (\n  subject,\n  context,\n) => {\n  const endpoint = resolveSubjectEndpoint(subject);\n  if (!endpoint) {\n    return null;\n  }\n  const ok = await fetchOk(context, endpoint);\n  return ok ? 100 : 0;\n};\n\nconst DEFAULT_PROBES: Record<string, Hcs25ConnectivityProbe> = {\n  mcp: mcpConnectivityProbe,\n  a2a: a2aConnectivityProbe,\n};\n\n/**\n * Options for the connectivity signal adapter.\n */\nexport interface Hcs25ConnectivitySignalAdapterOptions {\n  /**\n   * Probe map keyed by target name. Keys `mcp`/`a2a` are used automatically\n   * for matching `subject.protocol`; other keys run unconditionally as\n   * named targets and populate `connectivityTargets`. Pass `{default: fn}`\n   * to override the fallback HTTP probe.\n   */\n  probes?: Record<string, Hcs25ConnectivityProbe>;\n  /** Per-adapter timeout in milliseconds. */\n  timeoutMs?: number;\n  includeRegistries?: readonly string[];\n  excludeRegistries?: readonly string[];\n  appliesTo?: (subject: Hcs25Subject) => boolean;\n}\n\nconst DEFAULT_EXCLUDED_REGISTRIES: readonly string[] = [\n  'openrouter',\n  'near-ai',\n];\n\n/**\n * Creates the `connectivity` signal adapter: probes the subject's endpoint\n * using a protocol-aware probe (MCP initialize / A2A agent card / generic\n * HTTP) plus any named custom probes, and stores `connectivityScore` /\n * `connectivityTargets` under `metadata.additional`.\n */\nexport function createConnectivitySignalAdapter(\n  options: Hcs25ConnectivitySignalAdapterOptions = {},\n): Hcs25SignalAdapter {\n  const probes = { ...DEFAULT_PROBES, ...options.probes };\n\n  const collect = async (\n    subject: Hcs25Subject,\n    context: Hcs25CollectContext,\n  ): Promise<Hcs25SignalAdapterResult[]> => {\n    const now = context.now;\n    const protocol = subject.protocol?.toLowerCase();\n    const protocolProbe = protocol ? probes[protocol] : undefined;\n    const defaultProbe = probes.default ?? httpConnectivityProbe;\n    const namedTargets = Object.keys(probes).filter(\n      key => key !== protocol && key !== 'default' && !(key in DEFAULT_PROBES),\n    );\n\n    const results: Hcs25SignalAdapterResult[] = [];\n    const targets: Record<string, number> = {};\n    let primaryScore: number | null = null;\n    let primaryStatus: 'ok' | 'timeout' | 'error' = 'ok';\n    let probed = false;\n\n    const runProbe = async (\n      probe: Hcs25ConnectivityProbe,\n      signalId: string,\n      target?: string,\n    ): Promise<void> => {\n      try {\n        const score = await probe(subject, context);\n        if (score === null) {\n          return;\n        }\n        probed = true;\n        const clamped = Math.min(100, Math.max(0, score));\n        if (target) {\n          targets[target] = clamped;\n        } else {\n          primaryScore = clamped;\n        }\n        results.push({\n          signalId,\n          status: 'ok',\n          value: clamped,\n          provenance: {\n            source: 'connectivity-probe',\n            sourceUrl: resolveSubjectEndpoint(subject) ?? undefined,\n            subjectId: subject.id,\n            fetchedAt: now.toISOString(),\n          },\n        });\n      } catch (error) {\n        probed = true;\n        const status = isTimeoutError(error) ? 'timeout' : 'error';\n        if (!target) {\n          primaryStatus = status;\n          primaryScore = 0;\n        }\n        results.push({\n          signalId,\n          status,\n          provenance: {\n            source: 'connectivity-probe',\n            subjectId: subject.id,\n            fetchedAt: now.toISOString(),\n          },\n        });\n      }\n    };\n\n    await runProbe(protocolProbe ?? defaultProbe, 'connectivity.probe');\n\n    for (const target of namedTargets) {\n      await runProbe(probes[target], `connectivity.${target}`, target);\n    }\n\n    if (!probed) {\n      return [\n        {\n          signalId: 'connectivity.probe',\n          status: 'missing',\n          fields: [\n            {\n              scope: 'additional',\n              values: { connectivityStatus: 'missing' },\n            },\n          ],\n        },\n      ];\n    }\n\n    const additional: Record<string, Hcs25JsonValue> = {\n      connectivityStatus: primaryStatus === 'ok' ? 'ok' : primaryStatus,\n    };\n    if (primaryScore !== null) {\n      additional.connectivityScore = primaryScore;\n    }\n    if (Object.keys(targets).length > 0) {\n      additional.connectivityTargets = { ...targets };\n    }\n\n    const last = results[results.length - 1];\n    return [\n      ...results,\n      {\n        signalId: 'connectivity.score',\n        status: primaryStatus === 'ok' ? 'ok' : primaryStatus,\n        value: primaryScore ?? undefined,\n        fields: [{ scope: 'additional', values: additional }],\n        provenance: last?.provenance,\n      },\n    ];\n  };\n\n  return {\n    id: 'connectivity',\n    produces: ['connectivity.probe', 'connectivity.score'],\n    timeoutMs: options.timeoutMs,\n    includeRegistries: options.includeRegistries,\n    excludeRegistries: options.excludeRegistries ?? DEFAULT_EXCLUDED_REGISTRIES,\n    appliesTo: options.appliesTo,\n    collect,\n  };\n}\n"],"names":[],"mappings":";;AAkBA,MAAM,uBAAuB;AAE7B,eAAe,QACb,SACA,KACA,MACkB;AAClB,QAAM,WAAW,MAAM,QAAQ,MAAM,KAAK;AAAA,IACxC,GAAG;AAAA,IACH,QAAQ,QAAQ;AAAA,EAAA,CACjB;AACD,SAAO,SAAS,SAAS;AAC3B;AAOO,MAAM,uBAA+C,OAC1D,SACA,YACG;AACH,QAAM,WAAW,uBAAuB,OAAO;AAC/C,MAAI,CAAC,UAAU;AACb,WAAO;AAAA,EACT;AACA,QAAM,KAAK,MAAM,QAAQ,SAAS,UAAU;AAAA,IAC1C,QAAQ;AAAA,IACR,SAAS;AAAA,MACP,gBAAgB;AAAA,MAChB,QAAQ;AAAA,IAAA;AAAA,IAEV,MAAM,KAAK,UAAU;AAAA,MACnB,SAAS;AAAA,MACT,IAAI;AAAA,MACJ,QAAQ;AAAA,MACR,QAAQ;AAAA,QACN,iBAAiB;AAAA,QACjB,cAAc,CAAA;AAAA,QACd,YAAY,EAAE,MAAM,6BAA6B,SAAS,IAAA;AAAA,MAAI;AAAA,IAChE,CACD;AAAA,EAAA,CACF;AACD,SAAO,KAAK,MAAM;AACpB;AAOO,MAAM,uBAA+C,OAC1D,SACA,YACG;AACH,QAAM,WAAW,uBAAuB,OAAO;AAC/C,MAAI,CAAC,UAAU;AACb,WAAO;AAAA,EACT;AACA,QAAM,UAAU,SAAS,SAAS,eAAe,IAC7C,WACA,IAAI,IAAI,2BAA2B,QAAQ,EAAE,SAAA;AACjD,QAAM,KAAK,MAAM,QAAQ,SAAS,OAAO;AACzC,SAAO,KAAK,MAAM;AACpB;AAMO,MAAM,wBAAgD,OAC3D,SACA,YACG;AACH,QAAM,WAAW,uBAAuB,OAAO;AAC/C,MAAI,CAAC,UAAU;AACb,WAAO;AAAA,EACT;AACA,QAAM,KAAK,MAAM,QAAQ,SAAS,QAAQ;AAC1C,SAAO,KAAK,MAAM;AACpB;AAEA,MAAM,iBAAyD;AAAA,EAC7D,KAAK;AAAA,EACL,KAAK;AACP;AAoBA,MAAM,8BAAiD;AAAA,EACrD;AAAA,EACA;AACF;AAQO,SAAS,gCACd,UAAiD,IAC7B;AACpB,QAAM,SAAS,EAAE,GAAG,gBAAgB,GAAG,QAAQ,OAAA;AAE/C,QAAM,UAAU,OACd,SACA,YACwC;AACxC,UAAM,MAAM,QAAQ;AACpB,UAAM,WAAW,QAAQ,UAAU,YAAA;AACnC,UAAM,gBAAgB,WAAW,OAAO,QAAQ,IAAI;AACpD,UAAM,eAAe,OAAO,WAAW;AACvC,UAAM,eAAe,OAAO,KAAK,MAAM,EAAE;AAAA,MACvC,SAAO,QAAQ,YAAY,QAAQ,aAAa,EAAE,OAAO;AAAA,IAAA;AAG3D,UAAM,UAAsC,CAAA;AAC5C,UAAM,UAAkC,CAAA;AACxC,QAAI,eAA8B;AAClC,QAAI,gBAA4C;AAChD,QAAI,SAAS;AAEb,UAAM,WAAW,OACf,OACA,UACA,WACkB;AAClB,UAAI;AACF,cAAM,QAAQ,MAAM,MAAM,SAAS,OAAO;AAC1C,YAAI,UAAU,MAAM;AAClB;AAAA,QACF;AACA,iBAAS;AACT,cAAM,UAAU,KAAK,IAAI,KAAK,KAAK,IAAI,GAAG,KAAK,CAAC;AAChD,YAAI,QAAQ;AACV,kBAAQ,MAAM,IAAI;AAAA,QACpB,OAAO;AACL,yBAAe;AAAA,QACjB;AACA,gBAAQ,KAAK;AAAA,UACX;AAAA,UACA,QAAQ;AAAA,UACR,OAAO;AAAA,UACP,YAAY;AAAA,YACV,QAAQ;AAAA,YACR,WAAW,uBAAuB,OAAO,KAAK;AAAA,YAC9C,WAAW,QAAQ;AAAA,YACnB,WAAW,IAAI,YAAA;AAAA,UAAY;AAAA,QAC7B,CACD;AAAA,MACH,SAAS,OAAO;AACd,iBAAS;AACT,cAAM,SAAS,eAAe,KAAK,IAAI,YAAY;AACnD,YAAI,CAAC,QAAQ;AACX,0BAAgB;AAChB,yBAAe;AAAA,QACjB;AACA,gBAAQ,KAAK;AAAA,UACX;AAAA,UACA;AAAA,UACA,YAAY;AAAA,YACV,QAAQ;AAAA,YACR,WAAW,QAAQ;AAAA,YACnB,WAAW,IAAI,YAAA;AAAA,UAAY;AAAA,QAC7B,CACD;AAAA,MACH;AAAA,IACF;AAEA,UAAM,SAAS,iBAAiB,cAAc,oBAAoB;AAElE,eAAW,UAAU,cAAc;AACjC,YAAM,SAAS,OAAO,MAAM,GAAG,gBAAgB,MAAM,IAAI,MAAM;AAAA,IACjE;AAEA,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,QACL;AAAA,UACE,UAAU;AAAA,UACV,QAAQ;AAAA,UACR,QAAQ;AAAA,YACN;AAAA,cACE,OAAO;AAAA,cACP,QAAQ,EAAE,oBAAoB,UAAA;AAAA,YAAU;AAAA,UAC1C;AAAA,QACF;AAAA,MACF;AAAA,IAEJ;AAEA,UAAM,aAA6C;AAAA,MACjD,oBAAoB,kBAAkB,OAAO,OAAO;AAAA,IAAA;AAEtD,QAAI,iBAAiB,MAAM;AACzB,iBAAW,oBAAoB;AAAA,IACjC;AACA,QAAI,OAAO,KAAK,OAAO,EAAE,SAAS,GAAG;AACnC,iBAAW,sBAAsB,EAAE,GAAG,QAAA;AAAA,IACxC;AAEA,UAAM,OAAO,QAAQ,QAAQ,SAAS,CAAC;AACvC,WAAO;AAAA,MACL,GAAG;AAAA,MACH;AAAA,QACE,UAAU;AAAA,QACV,QAAQ,kBAAkB,OAAO,OAAO;AAAA,QACxC,OAAO,gBAAgB;AAAA,QACvB,QAAQ,CAAC,EAAE,OAAO,cAAc,QAAQ,YAAY;AAAA,QACpD,YAAY,MAAM;AAAA,MAAA;AAAA,IACpB;AAAA,EAEJ;AAEA,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,UAAU,CAAC,sBAAsB,oBAAoB;AAAA,IACrD,WAAW,QAAQ;AAAA,IACnB,mBAAmB,QAAQ;AAAA,IAC3B,mBAAmB,QAAQ,qBAAqB;AAAA,IAChD,WAAW,QAAQ;AAAA,IACnB;AAAA,EAAA;AAEJ;"}