@hashgraphonline/standards-sdk 0.1.189 → 0.1.191

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

@@ -1,32 +1,164 @@
-import { Logger } from "./standards-sdk.es128.js";
-function createLoggerAdapter(iLogger) {
-  const adapter = Object.create(Logger.prototype);
-  adapter.debug = (...args) => iLogger.debug(...args);
-  adapter.info = (...args) => iLogger.info(...args);
-  adapter.warn = (...args) => iLogger.warn(...args);
-  adapter.error = (...args) => iLogger.error(...args);
-  adapter.trace = (...args) => iLogger.trace(...args);
-  adapter.setLogLevel = (level) => iLogger.setLogLevel(level);
-  adapter.getLevel = () => iLogger.getLevel();
-  adapter.setSilent = (silent) => iLogger.setSilent(silent);
-  adapter.setModule = (module) => iLogger.setModule(module);
-  adapter.logger = { level: iLogger.getLevel() };
-  adapter.moduleContext = "";
-  adapter.formatArgs = () => ({ msg: "" });
-  return adapter;
+import { readMetadataRecord, readString } from "./standards-sdk.es201.js";
+import "./standards-sdk.es184.js";
+import "./standards-sdk.es198.js";
+import "./standards-sdk.es199.js";
+import "./standards-sdk.es200.js";
+import "./standards-sdk.es183.js";
+import { resolveSubjectEndpoint } from "./standards-sdk.es127.js";
+import { Hcs25CollectorHttpError, isTimeoutError } from "./standards-sdk.es122.js";
+const DEFAULT_EXCLUDED_REGISTRIES = [
+  "openrouter",
+  "near-ai"
+];
+function minutesSince(timestamp, now) {
+  const ms = Date.parse(timestamp);
+  if (Number.isNaN(ms)) {
+    return null;
+  }
+  return Math.max(0, (now.getTime() - ms) / 6e4);
 }
-function isConcreteLogger(logger) {
-  return logger instanceof Logger;
+function missingResult(now, reason) {
+  return [
+    {
+      signalId: "availability.probe",
+      status: "missing",
+      fields: [
+        {
+          scope: "root",
+          values: {
+            availabilityScore: null,
+            availabilityCheckedAt: now.toISOString(),
+            availabilityReason: reason,
+            availabilitySource: "probe",
+            availabilityStatus: "missing"
+          }
+        }
+      ]
+    }
+  ];
 }
-function ensureLoggerType(logger) {
-  if (isConcreteLogger(logger)) {
-    return logger;
-  }
-  return createLoggerAdapter(logger);
+function createAvailabilitySignalAdapter(options = {}) {
+  const resolveEndpoint = options.resolveEndpoint ?? resolveSubjectEndpoint;
+  const method = options.method ?? "auto";
+  const collect = async (subject, context) => {
+    const { now } = context;
+    const results = [];
+    const metrics = readMetadataRecord(subject, "metrics");
+    const lastActiveAt = metrics ? readString(metrics, "lastActiveAt") : null;
+    if (lastActiveAt !== null) {
+      const mins = minutesSince(lastActiveAt, now);
+      if (mins !== null) {
+        results.push({
+          signalId: "availability.last_seen",
+          status: "ok",
+          value: mins,
+          fields: [{ scope: "metrics", values: { minsFromLastOnline: mins } }],
+          provenance: {
+            source: "metadata",
+            subjectId: subject.id,
+            fetchedAt: now.toISOString()
+          }
+        });
+      }
+    }
+    const endpoint = resolveEndpoint(subject);
+    if (!endpoint) {
+      if (results.length > 0) {
+        return results;
+      }
+      return missingResult(now, "no endpoint metadata");
+    }
+    const started = now.getTime();
+    try {
+      const attempt = async (verb) => {
+        const response = await context.fetch(endpoint, {
+          method: verb,
+          headers: options.headers,
+          signal: context.signal
+        });
+        return response.status;
+      };
+      let status;
+      if (method === "auto") {
+        try {
+          status = await attempt("HEAD");
+          if (status === 405 || status === 501) {
+            status = await attempt("GET");
+          }
+        } catch (error) {
+          if (error instanceof Hcs25CollectorHttpError) {
+            throw error;
+          }
+          status = await attempt("GET");
+        }
+      } else {
+        status = await attempt(method);
+      }
+      const latencyMs = Date.now() - started;
+      const reachable = status < 500;
+      results.push({
+        signalId: "availability.probe",
+        status: "ok",
+        value: reachable ? 1 : 0,
+        fields: [
+          {
+            scope: "root",
+            values: {
+              availabilityScore: reachable ? 1 : 0,
+              availabilityCheckedAt: now.toISOString(),
+              availabilityLatencyMs: latencyMs,
+              availabilityReason: reachable ? "reachable" : `endpoint returned HTTP ${status}`,
+              availabilitySource: "probe",
+              availabilityStatus: "ok"
+            }
+          }
+        ],
+        provenance: {
+          source: "probe",
+          sourceUrl: endpoint,
+          subjectId: subject.id,
+          fetchedAt: now.toISOString()
+        }
+      });
+      return results;
+    } catch (error) {
+      const timedOut = isTimeoutError(error);
+      const statusValue = timedOut ? "timeout" : "error";
+      results.push({
+        signalId: "availability.probe",
+        status: statusValue,
+        fields: [
+          {
+            scope: "root",
+            values: {
+              availabilityCheckedAt: now.toISOString(),
+              availabilityReason: error instanceof Error ? error.message : String(error),
+              availabilitySource: "probe",
+              availabilityStatus: statusValue
+            }
+          }
+        ],
+        provenance: {
+          source: "probe",
+          sourceUrl: endpoint,
+          subjectId: subject.id,
+          fetchedAt: now.toISOString()
+        }
+      });
+      return results;
+    }
+  };
+  return {
+    id: "availability",
+    produces: ["availability.probe", "availability.last_seen"],
+    timeoutMs: options.timeoutMs,
+    includeRegistries: options.includeRegistries,
+    excludeRegistries: options.excludeRegistries ?? DEFAULT_EXCLUDED_REGISTRIES,
+    appliesTo: options.appliesTo,
+    collect
+  };
 }
 export {
-  createLoggerAdapter,
-  ensureLoggerType,
-  isConcreteLogger
+  createAvailabilitySignalAdapter
 };
 //# sourceMappingURL=standards-sdk.es129.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es129.js","sources":["../../src/utils/logger-adapter.ts"],"sourcesContent":["import { Logger, ILogger } from './logger';\n\n/**\n * Creates a Logger instance that wraps an ILogger implementation\n * This is needed for compatibility with external libraries that expect the concrete Logger type\n */\nexport function createLoggerAdapter(iLogger: ILogger): Logger {\n  const adapter = Object.create(Logger.prototype);\n\n  adapter.debug = (...args: any[]) => iLogger.debug(...args);\n  adapter.info = (...args: any[]) => iLogger.info(...args);\n  adapter.warn = (...args: any[]) => iLogger.warn(...args);\n  adapter.error = (...args: any[]) => iLogger.error(...args);\n  adapter.trace = (...args: any[]) => iLogger.trace(...args);\n  adapter.setLogLevel = (level: any) => iLogger.setLogLevel(level);\n  adapter.getLevel = () => iLogger.getLevel();\n  adapter.setSilent = (silent: boolean) => iLogger.setSilent(silent);\n  adapter.setModule = (module: string) => iLogger.setModule(module);\n\n  adapter.logger = { level: iLogger.getLevel() };\n  adapter.moduleContext = '';\n  adapter.formatArgs = () => ({ msg: '' });\n\n  return adapter as Logger;\n}\n\n/**\n * Type guard to check if a logger is the concrete Logger type\n */\nexport function isConcreteLogger(logger: ILogger | Logger): logger is Logger {\n  return logger instanceof Logger;\n}\n\n/**\n * Gets a Logger-compatible instance from an ILogger\n * If the ILogger is already a Logger, returns it as-is\n * Otherwise, creates an adapter\n */\nexport function ensureLoggerType(logger: ILogger): Logger {\n  if (isConcreteLogger(logger)) {\n    return logger;\n  }\n  return createLoggerAdapter(logger);\n}\n"],"names":[],"mappings":";AAMO,SAAS,oBAAoB,SAA0B;AAC5D,QAAM,UAAU,OAAO,OAAO,OAAO,SAAS;AAE9C,UAAQ,QAAQ,IAAI,SAAgB,QAAQ,MAAM,GAAG,IAAI;AACzD,UAAQ,OAAO,IAAI,SAAgB,QAAQ,KAAK,GAAG,IAAI;AACvD,UAAQ,OAAO,IAAI,SAAgB,QAAQ,KAAK,GAAG,IAAI;AACvD,UAAQ,QAAQ,IAAI,SAAgB,QAAQ,MAAM,GAAG,IAAI;AACzD,UAAQ,QAAQ,IAAI,SAAgB,QAAQ,MAAM,GAAG,IAAI;AACzD,UAAQ,cAAc,CAAC,UAAe,QAAQ,YAAY,KAAK;AAC/D,UAAQ,WAAW,MAAM,QAAQ,SAAA;AACjC,UAAQ,YAAY,CAAC,WAAoB,QAAQ,UAAU,MAAM;AACjE,UAAQ,YAAY,CAAC,WAAmB,QAAQ,UAAU,MAAM;AAEhE,UAAQ,SAAS,EAAE,OAAO,QAAQ,WAAS;AAC3C,UAAQ,gBAAgB;AACxB,UAAQ,aAAa,OAAO,EAAE,KAAK,GAAA;AAEnC,SAAO;AACT;AAKO,SAAS,iBAAiB,QAA4C;AAC3E,SAAO,kBAAkB;AAC3B;AAOO,SAAS,iBAAiB,QAAyB;AACxD,MAAI,iBAAiB,MAAM,GAAG;AAC5B,WAAO;AAAA,EACT;AACA,SAAO,oBAAoB,MAAM;AACnC;"}
+{"version":3,"file":"standards-sdk.es129.js","sources":["../../src/hcs-25/collectors/availability.ts"],"sourcesContent":["import type { Hcs25Subject } from '../types';\nimport { readMetadataRecord, readString } from '../signals';\nimport { resolveSubjectEndpoint } from './endpoints';\nimport { Hcs25CollectorHttpError, isTimeoutError } from './http';\nimport type {\n  Hcs25CollectContext,\n  Hcs25SignalAdapter,\n  Hcs25SignalAdapterResult,\n} from './types';\n\n/**\n * Options for the availability signal adapter.\n */\nexport interface Hcs25AvailabilitySignalAdapterOptions {\n  /** Custom endpoint resolver; defaults to {@link resolveSubjectEndpoint}. */\n  resolveEndpoint?: (subject: Hcs25Subject) => string | null;\n  /** Probe method. `auto` (default) tries HEAD and falls back to GET. */\n  method?: 'auto' | 'HEAD' | 'GET';\n  /** Per-probe timeout in milliseconds. */\n  timeoutMs?: number;\n  /** Extra request headers (e.g. auth for gated endpoints). */\n  headers?: Record<string, string>;\n  /** Applicability constraints. */\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\nfunction minutesSince(timestamp: string, now: Date): number | null {\n  const ms = Date.parse(timestamp);\n  if (Number.isNaN(ms)) {\n    return null;\n  }\n  return Math.max(0, (now.getTime() - ms) / 60000);\n}\n\nfunction missingResult(now: Date, reason: string): Hcs25SignalAdapterResult[] {\n  return [\n    {\n      signalId: 'availability.probe',\n      status: 'missing',\n      fields: [\n        {\n          scope: 'root',\n          values: {\n            availabilityScore: null,\n            availabilityCheckedAt: now.toISOString(),\n            availabilityReason: reason,\n            availabilitySource: 'probe',\n            availabilityStatus: 'missing',\n          },\n        },\n      ],\n    },\n  ];\n}\n\n/**\n * Creates the `availability` signal adapter: probes the subject's endpoint,\n * records reachability, latency, and probe provenance, and converts the\n * ecosystem-native `metrics.lastActiveAt` field into\n * `metrics.minsFromLastOnline` (the deterministic scoring adapter consumes\n * the derived field). Unreachable endpoints score 0; absent endpoints are\n * `missing`.\n */\nexport function createAvailabilitySignalAdapter(\n  options: Hcs25AvailabilitySignalAdapterOptions = {},\n): Hcs25SignalAdapter {\n  const resolveEndpoint = options.resolveEndpoint ?? resolveSubjectEndpoint;\n  const method = options.method ?? 'auto';\n\n  const collect = async (\n    subject: Hcs25Subject,\n    context: Hcs25CollectContext,\n  ): Promise<Hcs25SignalAdapterResult[]> => {\n    const { now } = context;\n    const results: Hcs25SignalAdapterResult[] = [];\n\n    const metrics = readMetadataRecord(subject, 'metrics');\n    const lastActiveAt = metrics ? readString(metrics, 'lastActiveAt') : null;\n    if (lastActiveAt !== null) {\n      const mins = minutesSince(lastActiveAt, now);\n      if (mins !== null) {\n        results.push({\n          signalId: 'availability.last_seen',\n          status: 'ok',\n          value: mins,\n          fields: [{ scope: 'metrics', values: { minsFromLastOnline: mins } }],\n          provenance: {\n            source: 'metadata',\n            subjectId: subject.id,\n            fetchedAt: now.toISOString(),\n          },\n        });\n      }\n    }\n\n    const endpoint = resolveEndpoint(subject);\n    if (!endpoint) {\n      if (results.length > 0) {\n        return results;\n      }\n      return missingResult(now, 'no endpoint metadata');\n    }\n\n    const started = now.getTime();\n    try {\n      const attempt = async (verb: 'HEAD' | 'GET'): Promise<number> => {\n        const response = await context.fetch(endpoint, {\n          method: verb,\n          headers: options.headers,\n          signal: context.signal,\n        });\n        return response.status;\n      };\n\n      let status: number;\n      if (method === 'auto') {\n        try {\n          status = await attempt('HEAD');\n          if (status === 405 || status === 501) {\n            status = await attempt('GET');\n          }\n        } catch (error) {\n          if (error instanceof Hcs25CollectorHttpError) {\n            throw error;\n          }\n          status = await attempt('GET');\n        }\n      } else {\n        status = await attempt(method);\n      }\n\n      const latencyMs = Date.now() - started;\n      const reachable = status < 500;\n      results.push({\n        signalId: 'availability.probe',\n        status: 'ok',\n        value: reachable ? 1 : 0,\n        fields: [\n          {\n            scope: 'root',\n            values: {\n              availabilityScore: reachable ? 1 : 0,\n              availabilityCheckedAt: now.toISOString(),\n              availabilityLatencyMs: latencyMs,\n              availabilityReason: reachable\n                ? 'reachable'\n                : `endpoint returned HTTP ${status}`,\n              availabilitySource: 'probe',\n              availabilityStatus: 'ok',\n            },\n          },\n        ],\n        provenance: {\n          source: 'probe',\n          sourceUrl: endpoint,\n          subjectId: subject.id,\n          fetchedAt: now.toISOString(),\n        },\n      });\n      return results;\n    } catch (error) {\n      const timedOut = isTimeoutError(error);\n      const statusValue = timedOut ? 'timeout' : 'error';\n      results.push({\n        signalId: 'availability.probe',\n        status: statusValue,\n        fields: [\n          {\n            scope: 'root',\n            values: {\n              availabilityCheckedAt: now.toISOString(),\n              availabilityReason:\n                error instanceof Error ? error.message : String(error),\n              availabilitySource: 'probe',\n              availabilityStatus: statusValue,\n            },\n          },\n        ],\n        provenance: {\n          source: 'probe',\n          sourceUrl: endpoint,\n          subjectId: subject.id,\n          fetchedAt: now.toISOString(),\n        },\n      });\n      return results;\n    }\n  };\n\n  return {\n    id: 'availability',\n    produces: ['availability.probe', 'availability.last_seen'],\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":"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"}

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

@@ -1,4 +1,4 @@
-import { Logger } from "./standards-sdk.es128.js";
+import { Logger } from "./standards-sdk.es148.js";
 class WasmBridge {
   constructor() {
     this.wasm = null;

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

@@ -1,25 +1,172 @@
-import { HederaMirrorNode } from "./standards-sdk.es149.js";
-async function accountIdsToExemptKeys(accountIds, network, logger) {
-  const mirrorNode = new HederaMirrorNode(
-    network,
-    logger
-  );
-  const exemptKeys = [];
-  for (const accountId of accountIds) {
-    try {
-      const publicKey = await mirrorNode.getPublicKey(accountId);
-      exemptKeys.push(publicKey);
-    } catch (error) {
-      if (logger) {
-        logger.warn(
-          `Could not get public key for account ${accountId}: ${error}`
-        );
+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 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;
+};
+const a2aConnectivityProbe = async (subject, context) => {
+  const endpoint = resolveSubjectEndpoint(subject);
+  if (!endpoint) {
+    return null;
   }
-  return exemptKeys;
+  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 httpConnectivityProbe = async (subject, context) => {
+  const endpoint = resolveSubjectEndpoint(subject);
+  if (!endpoint) {
+    return null;
+  }
+  const ok = await fetchOk(context, endpoint);
+  return ok ? 100 : 0;
+};
+const DEFAULT_PROBES = {
+  mcp: mcpConnectivityProbe,
+  a2a: a2aConnectivityProbe
+};
+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;
+    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: "connectivity.probe",
+          status: "missing",
+          fields: [
+            {
+              scope: "additional",
+              values: { connectivityStatus: "missing" }
+            }
+          ]
+        }
+      ];
+    }
+    const additional = {
+      connectivityStatus: primaryStatus === "ok" ? "ok" : primaryStatus
+    };
+    if (primaryScore !== null) {
+      additional.connectivityScore = primaryScore;
+    }
+    if (Object.keys(targets).length > 0) {
+      additional.connectivityTargets = { ...targets };
+    }
+    const last = results[results.length - 1];
+    return [
+      ...results,
+      {
+        signalId: "connectivity.score",
+        status: primaryStatus === "ok" ? "ok" : primaryStatus,
+        value: primaryScore ?? void 0,
+        fields: [{ scope: "additional", values: additional }],
+        provenance: last?.provenance
+      }
+    ];
+  };
+  return {
+    id: "connectivity",
+    produces: ["connectivity.probe", "connectivity.score"],
+    timeoutMs: options.timeoutMs,
+    includeRegistries: options.includeRegistries,
+    excludeRegistries: options.excludeRegistries ?? DEFAULT_EXCLUDED_REGISTRIES,
+    appliesTo: options.appliesTo,
+    collect
+  };
 }
 export {
-  accountIdsToExemptKeys
+  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/utils/topic-fee-utils.ts"],"sourcesContent":["import { PublicKey } from '@hashgraph/sdk';\nimport { ILogger } from './logger';\nimport { HederaMirrorNode } from '../services/mirror-node';\n\n/**\n * Converts account IDs to public keys for fee exemption\n * @param client Hedera client instance\n * @param accountIds Array of account IDs to convert to public keys\n * @param network The network to use for retrieving public keys\n * @param logger Optional logger instance\n * @returns Array of public keys\n */\nexport async function accountIdsToExemptKeys(\n  accountIds: string[],\n  network: string,\n  logger?: ILogger,\n): Promise<PublicKey[]> {\n  const mirrorNode = new HederaMirrorNode(\n    network as 'mainnet' | 'testnet',\n    logger,\n  );\n  const exemptKeys: PublicKey[] = [];\n\n  for (const accountId of accountIds) {\n    try {\n      const publicKey = await mirrorNode.getPublicKey(accountId);\n      exemptKeys.push(publicKey);\n    } catch (error) {\n      if (logger) {\n        logger.warn(\n          `Could not get public key for account ${accountId}: ${error}`,\n        );\n      }\n    }\n  }\n\n  return exemptKeys;\n}\n"],"names":[],"mappings":";AAYA,eAAsB,uBACpB,YACA,SACA,QACsB;AACtB,QAAM,aAAa,IAAI;AAAA,IACrB;AAAA,IACA;AAAA,EAAA;AAEF,QAAM,aAA0B,CAAA;AAEhC,aAAW,aAAa,YAAY;AAClC,QAAI;AACF,YAAM,YAAY,MAAM,WAAW,aAAa,SAAS;AACzD,iBAAW,KAAK,SAAS;AAAA,IAC3B,SAAS,OAAO;AACd,UAAI,QAAQ;AACV,eAAO;AAAA,UACL,wCAAwC,SAAS,KAAK,KAAK;AAAA,QAAA;AAAA,MAE/D;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;"}
+{"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":"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"}