@hashgraphonline/standards-sdk 0.1.189 → 0.1.190

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

@@ -1,108 +1,33 @@
-import { z } from "zod";
-import { hcs26TopicTypeEnumSchema, HCS26_PROTOCOL, hcs26OperationEnumSchema } from "./standards-sdk.es122.js";
-const HCS26_DEFAULT_TTL_SECONDS = 86400;
-function toPositiveInt(value) {
-  if (!Number.isFinite(value)) {
-    throw new Error("Expected a finite number");
-  }
-  const intValue = Math.floor(value);
-  if (intValue <= 0) {
-    throw new Error("Expected a positive integer");
-  }
-  return intValue;
-}
-function buildHcs26TopicMemo(input) {
-  const indexed = input.indexed ?? true;
-  const ttlSeconds = toPositiveInt(
-    input.ttlSeconds ?? HCS26_DEFAULT_TTL_SECONDS
-  );
-  const topicType = hcs26TopicTypeEnumSchema.parse(input.topicType);
-  const indexedSegment = indexed ? "0" : "1";
-  return `${HCS26_PROTOCOL}:${indexedSegment}:${ttlSeconds}:${topicType}`;
-}
-function parseHcs26TopicMemo(memoRaw) {
-  const memo = memoRaw.trim();
-  if (!memo) {
-    return null;
-  }
-  const match = memo.match(/^hcs-26:(\d+):(\d+):(\d+)$/);
-  if (!match) {
-    return null;
-  }
-  const indexedSegment = Number(match[1]);
-  const ttlSeconds = Number(match[2]);
-  const topicType = Number(match[3]);
-  if (![indexedSegment, ttlSeconds, topicType].every(Number.isFinite)) {
-    return null;
-  }
-  const parsedTopicType = hcs26TopicTypeEnumSchema.safeParse(topicType);
-  if (!parsedTopicType.success) {
-    return null;
-  }
-  if (indexedSegment !== 0 && indexedSegment !== 1) {
-    return null;
-  }
-  return {
-    protocol: HCS26_PROTOCOL,
-    indexed: indexedSegment === 0,
-    ttlSeconds,
-    topicType: parsedTopicType.data
+import { isJsonObject } 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";
+function applyCollectedFields(subject, fieldsList) {
+  if (fieldsList.length === 0) {
+    return subject;
+  }
+  const metadata = {
+    ...subject.metadata ?? {}
   };
+  for (const fields of fieldsList) {
+    if (fields.scope === "root") {
+      for (const [key, value] of Object.entries(fields.values)) {
+        metadata[key] = value;
+      }
+      continue;
+    }
+    const scopeKey = fields.scope;
+    const existing = metadata[scopeKey];
+    const record = isJsonObject(existing) ? { ...existing } : {};
+    for (const [key, value] of Object.entries(fields.values)) {
+      record[key] = value;
+    }
+    metadata[scopeKey] = record;
+  }
+  return { ...subject, metadata };
 }
-function buildHcs26TransactionMemo(input) {
-  const operation = hcs26OperationEnumSchema.parse(input.operation);
-  const topicType = hcs26TopicTypeEnumSchema.parse(input.topicType);
-  return `${HCS26_PROTOCOL}:op:${operation}:${topicType}`;
-}
-function parseHcs26TransactionMemo(memoRaw) {
-  const memo = memoRaw.trim();
-  if (!memo) {
-    return null;
-  }
-  const match = memo.match(/^hcs-26:op:(\d+):(\d+)$/);
-  if (!match) {
-    return null;
-  }
-  const operation = Number(match[1]);
-  const topicType = Number(match[2]);
-  if (![operation, topicType].every(Number.isFinite)) {
-    return null;
-  }
-  const parsedOperation = hcs26OperationEnumSchema.safeParse(operation);
-  if (!parsedOperation.success) {
-    return null;
-  }
-  const parsedTopicType = hcs26TopicTypeEnumSchema.safeParse(topicType);
-  if (!parsedTopicType.success) {
-    return null;
-  }
-  return {
-    protocol: HCS26_PROTOCOL,
-    operation: parsedOperation.data,
-    topicType: parsedTopicType.data
-  };
-}
-const hcs26TopicMemoSchema = z.string().transform((value) => {
-  const parsed = parseHcs26TopicMemo(value);
-  if (!parsed) {
-    throw new Error("Invalid HCS-26 topic memo");
-  }
-  return parsed;
-});
-const hcs26TransactionMemoSchema = z.string().transform((value) => {
-  const parsed = parseHcs26TransactionMemo(value);
-  if (!parsed) {
-    throw new Error("Invalid HCS-26 transaction memo");
-  }
-  return parsed;
-});
 export {
-  HCS26_DEFAULT_TTL_SECONDS,
-  buildHcs26TopicMemo,
-  buildHcs26TransactionMemo,
-  hcs26TopicMemoSchema,
-  hcs26TransactionMemoSchema,
-  parseHcs26TopicMemo,
-  parseHcs26TransactionMemo
+  applyCollectedFields
 };
 //# sourceMappingURL=standards-sdk.es124.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es124.js","sources":["../../src/hcs-26/memos.ts"],"sourcesContent":["import { z } from 'zod';\nimport {\n  HCS26_PROTOCOL,\n  hcs26OperationEnumSchema,\n  hcs26TopicTypeEnumSchema,\n  type Hcs26OperationEnum,\n  type Hcs26TopicTypeEnum,\n} from './types';\n\nexport type Hcs26TopicMemo = {\n  protocol: typeof HCS26_PROTOCOL;\n  indexed: boolean;\n  ttlSeconds: number;\n  topicType: Hcs26TopicTypeEnum;\n};\n\nexport const HCS26_DEFAULT_TTL_SECONDS = 86400;\n\nfunction toPositiveInt(value: number): number {\n  if (!Number.isFinite(value)) {\n    throw new Error('Expected a finite number');\n  }\n  const intValue = Math.floor(value);\n  if (intValue <= 0) {\n    throw new Error('Expected a positive integer');\n  }\n  return intValue;\n}\n\nexport function buildHcs26TopicMemo(input: {\n  indexed?: boolean;\n  ttlSeconds?: number;\n  topicType: Hcs26TopicTypeEnum;\n}): string {\n  const indexed = input.indexed ?? true;\n  const ttlSeconds = toPositiveInt(\n    input.ttlSeconds ?? HCS26_DEFAULT_TTL_SECONDS,\n  );\n  const topicType = hcs26TopicTypeEnumSchema.parse(input.topicType);\n\n  // HCS-2 memo convention: indexed topics use \"0\" in the second segment.\n  const indexedSegment = indexed ? '0' : '1';\n  return `${HCS26_PROTOCOL}:${indexedSegment}:${ttlSeconds}:${topicType}`;\n}\n\nexport function parseHcs26TopicMemo(memoRaw: string): Hcs26TopicMemo | null {\n  const memo = memoRaw.trim();\n  if (!memo) {\n    return null;\n  }\n\n  const match = memo.match(/^hcs-26:(\\d+):(\\d+):(\\d+)$/);\n  if (!match) {\n    return null;\n  }\n\n  const indexedSegment = Number(match[1]);\n  const ttlSeconds = Number(match[2]);\n  const topicType = Number(match[3]);\n\n  if (![indexedSegment, ttlSeconds, topicType].every(Number.isFinite)) {\n    return null;\n  }\n\n  const parsedTopicType = hcs26TopicTypeEnumSchema.safeParse(topicType);\n  if (!parsedTopicType.success) {\n    return null;\n  }\n\n  if (indexedSegment !== 0 && indexedSegment !== 1) {\n    return null;\n  }\n\n  return {\n    protocol: HCS26_PROTOCOL,\n    indexed: indexedSegment === 0,\n    ttlSeconds,\n    topicType: parsedTopicType.data,\n  };\n}\n\nexport function buildHcs26TransactionMemo(input: {\n  operation: Hcs26OperationEnum;\n  topicType: Hcs26TopicTypeEnum;\n}): string {\n  const operation = hcs26OperationEnumSchema.parse(input.operation);\n  const topicType = hcs26TopicTypeEnumSchema.parse(input.topicType);\n  return `${HCS26_PROTOCOL}:op:${operation}:${topicType}`;\n}\n\nexport type Hcs26TransactionMemo = {\n  protocol: typeof HCS26_PROTOCOL;\n  operation: Hcs26OperationEnum;\n  topicType: Hcs26TopicTypeEnum;\n};\n\nexport function parseHcs26TransactionMemo(\n  memoRaw: string,\n): Hcs26TransactionMemo | null {\n  const memo = memoRaw.trim();\n  if (!memo) {\n    return null;\n  }\n\n  const match = memo.match(/^hcs-26:op:(\\d+):(\\d+)$/);\n  if (!match) {\n    return null;\n  }\n\n  const operation = Number(match[1]);\n  const topicType = Number(match[2]);\n  if (![operation, topicType].every(Number.isFinite)) {\n    return null;\n  }\n\n  const parsedOperation = hcs26OperationEnumSchema.safeParse(operation);\n  if (!parsedOperation.success) {\n    return null;\n  }\n  const parsedTopicType = hcs26TopicTypeEnumSchema.safeParse(topicType);\n  if (!parsedTopicType.success) {\n    return null;\n  }\n\n  return {\n    protocol: HCS26_PROTOCOL,\n    operation: parsedOperation.data,\n    topicType: parsedTopicType.data,\n  };\n}\n\nexport const hcs26TopicMemoSchema = z.string().transform(value => {\n  const parsed = parseHcs26TopicMemo(value);\n  if (!parsed) {\n    throw new Error('Invalid HCS-26 topic memo');\n  }\n  return parsed;\n});\n\nexport const hcs26TransactionMemoSchema = z.string().transform(value => {\n  const parsed = parseHcs26TransactionMemo(value);\n  if (!parsed) {\n    throw new Error('Invalid HCS-26 transaction memo');\n  }\n  return parsed;\n});\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es124.js","sources":["../../src/hcs-25/collectors/merge.ts"],"sourcesContent":["import type { Hcs25JsonValue, Hcs25Subject } from '../types';\nimport { isJsonObject } from '../signals';\nimport type { Hcs25CollectedFields } from './types';\n\n/**\n * Immutably merges collected fields into a subject's metadata, honoring the\n * storage scopes documented by the HCS-25 signal catalog: `root` writes\n * `metadata.<key>`, `metrics` writes `metadata.metrics.<key>`, `additional`\n * writes `metadata.additional.<key>`, and any other scope string merges into\n * the `metadata.<scope>` record (e.g. `outputVerificationSummary`).\n */\nexport function applyCollectedFields(\n  subject: Hcs25Subject,\n  fieldsList: readonly Hcs25CollectedFields[],\n): Hcs25Subject {\n  if (fieldsList.length === 0) {\n    return subject;\n  }\n\n  const metadata: Record<string, Hcs25JsonValue> = {\n    ...(subject.metadata ?? {}),\n  };\n\n  for (const fields of fieldsList) {\n    if (fields.scope === 'root') {\n      for (const [key, value] of Object.entries(fields.values)) {\n        metadata[key] = value;\n      }\n      continue;\n    }\n\n    const scopeKey = fields.scope;\n    const existing = metadata[scopeKey];\n    const record: Record<string, Hcs25JsonValue> = isJsonObject(existing)\n      ? { ...existing }\n      : {};\n    for (const [key, value] of Object.entries(fields.values)) {\n      record[key] = value;\n    }\n    metadata[scopeKey] = record;\n  }\n\n  return { ...subject, metadata };\n}\n"],"names":[],"mappings":";;;;;AAWO,SAAS,qBACd,SACA,YACc;AACd,MAAI,WAAW,WAAW,GAAG;AAC3B,WAAO;AAAA,EACT;AAEA,QAAM,WAA2C;AAAA,IAC/C,GAAI,QAAQ,YAAY,CAAA;AAAA,EAAC;AAG3B,aAAW,UAAU,YAAY;AAC/B,QAAI,OAAO,UAAU,QAAQ;AAC3B,iBAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,OAAO,MAAM,GAAG;AACxD,iBAAS,GAAG,IAAI;AAAA,MAClB;AACA;AAAA,IACF;AAEA,UAAM,WAAW,OAAO;AACxB,UAAM,WAAW,SAAS,QAAQ;AAClC,UAAM,SAAyC,aAAa,QAAQ,IAChE,EAAE,GAAG,SAAA,IACL,CAAA;AACJ,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,OAAO,MAAM,GAAG;AACxD,aAAO,GAAG,IAAI;AAAA,IAChB;AACA,aAAS,QAAQ,IAAI;AAAA,EACvB;AAEA,SAAO,EAAE,GAAG,SAAS,SAAA;AACvB;"}

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

@@ -1,163 +1,203 @@
-import { Logger } from "./standards-sdk.es128.js";
-import { Hcs26SkillRegistryResolver } from "./standards-sdk.es123.js";
-function getManifestTopicId(entry) {
-  const topicIdCandidate = entry.t_id;
-  if (typeof topicIdCandidate === "string" && topicIdCandidate.trim()) {
-    return topicIdCandidate.trim();
-  }
-  const hrlCandidate = entry.manifest_hcs1;
-  if (typeof hrlCandidate !== "string" || !hrlCandidate.trim()) {
-    throw new Error("Missing manifest reference in version register entry");
-  }
-  const hrl = hrlCandidate.trim();
-  const prefix = "hcs://1/";
-  if (!hrl.startsWith(prefix)) {
-    throw new Error(`Invalid manifest HRL: ${hrl}`);
-  }
-  return hrl.slice(prefix.length);
+import { isValidSignalId, isValidAdapterId } from "./standards-sdk.es117.js";
+import { applyCollectedFields } from "./standards-sdk.es124.js";
+import { resolveFetch, Hcs25CollectorTimeoutError, isTimeoutError } from "./standards-sdk.es122.js";
+const DEFAULT_TIMEOUT_MS = 3e4;
+function isSignalAdapterApplicable(rule, subject) {
+  if (rule.includeRegistries) {
+    if (subject.registry === void 0 || !rule.includeRegistries.includes(subject.registry)) {
+      return false;
+    }
+  }
+  if (rule.excludeRegistries && subject.registry !== void 0 && rule.excludeRegistries.includes(subject.registry)) {
+    return false;
+  }
+  if (rule.appliesTo && !rule.appliesTo(subject)) {
+    return false;
+  }
+  return true;
 }
-class HCS26BaseClient {
-  constructor(config) {
-    this.network = config.network;
-    this.logger = config.logger ?? Logger.getInstance({
-      module: "HCS26Client",
-      level: "info"
-    });
-    this.verificationProvider = config.verificationProvider;
-    this.resolver = new Hcs26SkillRegistryResolver({
-      network: this.network,
-      logger: this.logger,
-      mirrorNode: config.mirrorNode
-    });
+function validateSignalAdapter(adapter) {
+  if (!isValidAdapterId(adapter.id)) {
+    throw new TypeError(
+      `invalid signal adapter id "${String(adapter.id)}": identifiers must match ^[a-z][a-z0-9]*(-[a-z][a-z0-9]*)*$`
+    );
   }
-  async resolveSkill(params) {
-    const discovery = await this.resolver.resolveDiscoveryRecord({
-      directoryTopicId: params.directoryTopicId,
-      skillUid: params.skillUid,
-      scanLimit: params.discoveryScanLimit
-    });
-    if (!discovery) {
-      return null;
-    }
-    const versionRegistryTopicId = discovery.t_id;
-    const latestVersion = await this.resolver.getLatestVersionRegister({
-      versionRegistryTopicId,
-      skillUid: params.skillUid
-    });
-    if (!latestVersion) {
-      throw new Error(
-        `No active version entries found for skill ${params.skillUid} in version registry ${versionRegistryTopicId}`
+  if (!Array.isArray(adapter.produces) || adapter.produces.length === 0) {
+    throw new TypeError(
+      `signal adapter "${adapter.id}" must declare at least one produced signalId`
+    );
+  }
+  for (const signalId of adapter.produces) {
+    if (!isValidSignalId(signalId)) {
+      throw new TypeError(
+        `signal adapter "${adapter.id}" declares invalid signalId "${String(signalId)}"`
       );
     }
-    const manifestTopicId = getManifestTopicId(latestVersion);
-    const { manifest, sha256Hex } = await this.resolver.resolveManifest({
-      manifestTopicId
-    });
-    await this.resolver.verifyVersionRegisterMatchesManifest({
-      versionRegister: latestVersion,
-      manifestSha256Hex: sha256Hex
-    });
-    let verification;
-    const provider = this.verificationProvider;
-    const includeVerification = params.includeVerification === true;
-    const name = typeof discovery.metadata?.name === "string" ? discovery.metadata.name.trim() : "";
-    if (includeVerification && provider && name) {
-      try {
-        verification = await provider.getSkillVerificationStatus({ name });
-      } catch (error) {
-        const detail = error instanceof Error ? error.message : String(error);
-        this.logger.warn(
-          `Failed to resolve verification status for skill "${name}": ${detail}`
-        );
-        verification = null;
+  }
+  if (typeof adapter.collect !== "function") {
+    throw new TypeError(
+      `signal adapter "${adapter.id}" must declare a collect function`
+    );
+  }
+}
+function isStale(fetchedAt, staleAfterMs, now) {
+  if (!fetchedAt) {
+    return false;
+  }
+  const fetchedMs = Date.parse(fetchedAt);
+  if (Number.isNaN(fetchedMs)) {
+    return false;
+  }
+  return now.getTime() - fetchedMs > staleAfterMs;
+}
+function applyFreshness(result, staleAfterMs, now) {
+  if (staleAfterMs === void 0 || result.status !== "ok") {
+    return result;
+  }
+  const fetchedAt = result.provenance?.fetchedAt;
+  if (!isStale(fetchedAt, staleAfterMs, now)) {
+    return result;
+  }
+  return {
+    ...result,
+    status: "stale",
+    fields: markStatusFieldsStale(result.fields)
+  };
+}
+function markStatusFieldsStale(fields) {
+  if (!fields) {
+    return fields;
+  }
+  return fields.map((block) => {
+    const values = { ...block.values };
+    for (const key of Object.keys(values)) {
+      if (key.endsWith("Status") && typeof values[key] === "string") {
+        values[key] = "stale";
       }
     }
-    return {
-      directoryTopicId: params.directoryTopicId,
-      skillUid: params.skillUid,
-      discovery,
-      versionRegistryTopicId,
-      latestVersion,
-      manifest,
-      manifestSha256Hex: sha256Hex,
-      ...includeVerification ? { verification } : {}
-    };
-  }
-  async listSkillVersions(params) {
-    const discovery = await this.resolver.resolveDiscoveryRecord({
-      directoryTopicId: params.directoryTopicId,
-      skillUid: params.skillUid,
-      scanLimit: params.discoveryScanLimit
-    });
-    if (!discovery) {
-      return [];
-    }
-    const versionRegistryTopicId = discovery.t_id;
-    return this.resolver.listVersionRegisters({
-      versionRegistryTopicId,
-      skillUid: params.skillUid,
-      limit: params.limit
-    });
+    return { ...block, values };
+  });
+}
+function toSignal(result, now) {
+  return {
+    status: result.status,
+    value: result.value,
+    fetchedAt: result.provenance?.fetchedAt ?? now.toISOString(),
+    provenance: result.provenance
+  };
+}
+function summarizeStatuses(counts) {
+  if (counts.has("error")) {
+    return "error";
+  }
+  if (counts.has("timeout")) {
+    return "timeout";
+  }
+  if (counts.size === 0) {
+    return "missing";
+  }
+  if ((counts.get("ok") ?? 0) > 0 || counts.has("stale")) {
+    return "ok";
   }
-  async resolveSkillVersion(params) {
-    const versionRaw = params.version.trim();
-    if (!versionRaw) {
-      throw new Error("version is required");
+  return "missing";
+}
+async function collectHcs25Signals(subject, options) {
+  const fetch = resolveFetch(options.fetch);
+  const now = options.now ?? /* @__PURE__ */ new Date();
+  const snapshot = { ...options.previousSnapshot ?? {} };
+  const results = [];
+  let current = subject;
+  for (const adapter of options.adapters) {
+    validateSignalAdapter(adapter);
+    if (!isSignalAdapterApplicable(adapter, current)) {
+      results.push({
+        adapterId: adapter.id,
+        applicable: false,
+        signalIds: [],
+        status: "missing"
+      });
+      continue;
     }
-    const discovery = await this.resolver.resolveDiscoveryRecord({
-      directoryTopicId: params.directoryTopicId,
-      skillUid: params.skillUid,
-      scanLimit: params.discoveryScanLimit
-    });
-    if (!discovery) {
-      return null;
+    const timeoutMs = adapter.timeoutMs ?? options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const controller = new AbortController();
+    let timer;
+    let adapterResults;
+    let runStatus;
+    let runError;
+    try {
+      adapterResults = await Promise.race([
+        adapter.collect(current, {
+          subject: current,
+          fetch,
+          timeoutMs,
+          now,
+          signal: controller.signal,
+          force: options.force === true
+        }),
+        new Promise((_resolve, reject) => {
+          timer = setTimeout(() => {
+            controller.abort();
+            reject(new Hcs25CollectorTimeoutError());
+          }, timeoutMs + 1);
+        })
+      ]);
+      clearTimeout(timer);
+      if (adapterResults.length === 0) {
+        adapterResults = adapter.produces.filter((signalId) => !(signalId in snapshot)).map((signalId) => ({ signalId, status: "missing" }));
+      }
+    } catch (error) {
+      const status = isTimeoutError(error) ? "timeout" : "error";
+      runStatus = status;
+      runError = error instanceof Error ? error.message : String(error);
+      adapterResults = adapter.produces.map((signalId) => ({
+        signalId,
+        status
+      }));
     }
-    const versionRegistryTopicId = discovery.t_id;
-    const entries = await this.resolver.listVersionRegisters({
-      versionRegistryTopicId,
-      skillUid: params.skillUid,
-      limit: 250
-    });
-    const target = entries.find((entry) => entry.version.trim() === versionRaw);
-    if (!target) {
-      return null;
+    const emitted = /* @__PURE__ */ new Set();
+    const statusCounts = /* @__PURE__ */ new Map();
+    const adapterFields = [];
+    for (const raw of adapterResults) {
+      if (!isValidSignalId(raw.signalId)) {
+        continue;
+      }
+      const result = applyFreshness(raw, options.staleAfterMs, now);
+      emitted.add(result.signalId);
+      statusCounts.set(
+        result.status,
+        (statusCounts.get(result.status) ?? 0) + 1
+      );
+      snapshot[result.signalId] = toSignal(result, now);
+      if (result.fields) {
+        adapterFields.push(...result.fields);
+      }
     }
-    const manifestTopicId = getManifestTopicId(target);
-    const { manifest, sha256Hex } = await this.resolver.resolveManifest({
-      manifestTopicId
-    });
-    await this.resolver.verifyVersionRegisterMatchesManifest({
-      versionRegister: target,
-      manifestSha256Hex: sha256Hex
+    if (adapterFields.length > 0) {
+      current = applyCollectedFields(current, adapterFields);
+    }
+    results.push({
+      adapterId: adapter.id,
+      applicable: true,
+      signalIds: [...emitted],
+      status: runStatus ?? summarizeStatuses(statusCounts),
+      error: runError
     });
-    let verification;
-    const provider = this.verificationProvider;
-    const includeVerification = params.includeVerification === true;
-    const name = typeof discovery.metadata?.name === "string" ? discovery.metadata.name.trim() : "";
-    if (includeVerification && provider && name) {
-      try {
-        verification = await provider.getSkillVerificationStatus({ name });
-      } catch (error) {
-        const detail = error instanceof Error ? error.message : String(error);
-        this.logger.warn(
-          `Failed to resolve verification status for skill "${name}": ${detail}`
-        );
-        verification = null;
+  }
+  if (options.staleAfterMs !== void 0) {
+    for (const [signalId, signal] of Object.entries(snapshot)) {
+      if (signal.status === "ok" && isStale(signal.fetchedAt, options.staleAfterMs, now)) {
+        snapshot[signalId] = { ...signal, status: "stale" };
       }
     }
-    return {
-      directoryTopicId: params.directoryTopicId,
-      skillUid: params.skillUid,
-      discovery,
-      versionRegistryTopicId,
-      versionEntry: target,
-      manifest,
-      manifestSha256Hex: sha256Hex,
-      ...includeVerification ? { verification } : {}
-    };
   }
+  return {
+    subject: current,
+    snapshot,
+    results
+  };
 }
 export {
-  HCS26BaseClient
+  collectHcs25Signals,
+  isSignalAdapterApplicable
 };
 //# sourceMappingURL=standards-sdk.es125.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es125.js","sources":["../../src/hcs-26/base-client.ts"],"sourcesContent":["import type { ILogger } from '../utils/logger';\nimport { Logger } from '../utils/logger';\nimport type { NetworkType } from '../utils/types';\nimport type { MirrorNodeConfig } from '../services/mirror-node';\nimport { Hcs26SkillRegistryResolver } from './resolver';\nimport type {\n  Hcs26SkillManifest,\n  Hcs26VersionRegister,\n  Hcs26VersionRegisterLegacy,\n} from './types';\n\nexport type HCS26SkillVerificationStatus = {\n  name: string;\n  verified: boolean;\n  previouslyVerified: boolean;\n  pendingRequest?: unknown;\n};\n\nexport interface HCS26SkillVerificationProvider {\n  getSkillVerificationStatus(params: {\n    name: string;\n  }): Promise<HCS26SkillVerificationStatus | null>;\n}\n\nexport interface HCS26ClientConfig {\n  network: NetworkType;\n  logger?: ILogger;\n  mirrorNode?: MirrorNodeConfig;\n  verificationProvider?: HCS26SkillVerificationProvider;\n}\n\nexport type HCS26DiscoveryRecord = {\n  p: 'hcs-26';\n  op: 'register';\n  t_id: string;\n  account_id: string;\n  metadata: Record<string, unknown>;\n  m?: string;\n  sequence_number?: number;\n};\n\nexport type HCS26ResolvedSkill = {\n  directoryTopicId: string;\n  skillUid: number;\n  discovery: HCS26DiscoveryRecord;\n  versionRegistryTopicId: string;\n  latestVersion:\n    | (Hcs26VersionRegister & { sequence_number?: number })\n    | (Hcs26VersionRegisterLegacy & { sequence_number?: number });\n  manifest: Hcs26SkillManifest;\n  manifestSha256Hex: string;\n  verification?: HCS26SkillVerificationStatus | null;\n};\n\nexport type HCS26ResolvedSkillVersion = Omit<\n  HCS26ResolvedSkill,\n  'latestVersion'\n> & {\n  versionEntry:\n    | (Hcs26VersionRegister & { sequence_number?: number })\n    | (Hcs26VersionRegisterLegacy & { sequence_number?: number });\n};\n\nfunction getManifestTopicId(\n  entry: Hcs26VersionRegister | Hcs26VersionRegisterLegacy,\n): string {\n  const topicIdCandidate = (entry as { t_id?: unknown }).t_id;\n  if (typeof topicIdCandidate === 'string' && topicIdCandidate.trim()) {\n    return topicIdCandidate.trim();\n  }\n\n  const hrlCandidate = (entry as { manifest_hcs1?: unknown }).manifest_hcs1;\n  if (typeof hrlCandidate !== 'string' || !hrlCandidate.trim()) {\n    throw new Error('Missing manifest reference in version register entry');\n  }\n\n  const hrl = hrlCandidate.trim();\n  const prefix = 'hcs://1/';\n  if (!hrl.startsWith(prefix)) {\n    throw new Error(`Invalid manifest HRL: ${hrl}`);\n  }\n  return hrl.slice(prefix.length);\n}\n\nexport class HCS26BaseClient {\n  protected readonly network: NetworkType;\n  protected readonly logger: ILogger;\n  protected readonly resolver: Hcs26SkillRegistryResolver;\n  protected readonly verificationProvider?: HCS26SkillVerificationProvider;\n\n  constructor(config: HCS26ClientConfig) {\n    this.network = config.network;\n    this.logger =\n      config.logger ??\n      Logger.getInstance({\n        module: 'HCS26Client',\n        level: 'info',\n      });\n    this.verificationProvider = config.verificationProvider;\n\n    this.resolver = new Hcs26SkillRegistryResolver({\n      network: this.network,\n      logger: this.logger,\n      mirrorNode: config.mirrorNode,\n    });\n  }\n\n  async resolveSkill(params: {\n    directoryTopicId: string;\n    skillUid: number;\n    discoveryScanLimit?: number;\n    includeVerification?: boolean;\n  }): Promise<HCS26ResolvedSkill | null> {\n    const discovery = (await this.resolver.resolveDiscoveryRecord({\n      directoryTopicId: params.directoryTopicId,\n      skillUid: params.skillUid,\n      scanLimit: params.discoveryScanLimit,\n    })) as HCS26DiscoveryRecord | null;\n\n    if (!discovery) {\n      return null;\n    }\n\n    const versionRegistryTopicId = discovery.t_id;\n    const latestVersion = await this.resolver.getLatestVersionRegister({\n      versionRegistryTopicId,\n      skillUid: params.skillUid,\n    });\n\n    if (!latestVersion) {\n      throw new Error(\n        `No active version entries found for skill ${params.skillUid} in version registry ${versionRegistryTopicId}`,\n      );\n    }\n\n    const manifestTopicId = getManifestTopicId(latestVersion);\n    const { manifest, sha256Hex } = await this.resolver.resolveManifest({\n      manifestTopicId,\n    });\n\n    await this.resolver.verifyVersionRegisterMatchesManifest({\n      versionRegister: latestVersion,\n      manifestSha256Hex: sha256Hex,\n    });\n\n    let verification: HCS26SkillVerificationStatus | null | undefined;\n    const provider = this.verificationProvider;\n    const includeVerification = params.includeVerification === true;\n    const name =\n      typeof discovery.metadata?.name === 'string'\n        ? discovery.metadata.name.trim()\n        : '';\n\n    if (includeVerification && provider && name) {\n      try {\n        verification = await provider.getSkillVerificationStatus({ name });\n      } catch (error) {\n        const detail = error instanceof Error ? error.message : String(error);\n        this.logger.warn(\n          `Failed to resolve verification status for skill \"${name}\": ${detail}`,\n        );\n        verification = null;\n      }\n    }\n\n    return {\n      directoryTopicId: params.directoryTopicId,\n      skillUid: params.skillUid,\n      discovery,\n      versionRegistryTopicId,\n      latestVersion,\n      manifest,\n      manifestSha256Hex: sha256Hex,\n      ...(includeVerification ? { verification } : {}),\n    };\n  }\n\n  async listSkillVersions(params: {\n    directoryTopicId: string;\n    skillUid: number;\n    discoveryScanLimit?: number;\n    limit?: number;\n  }): Promise<\n    Array<\n      | (Hcs26VersionRegister & { sequence_number?: number })\n      | (Hcs26VersionRegisterLegacy & { sequence_number?: number })\n    >\n  > {\n    const discovery = (await this.resolver.resolveDiscoveryRecord({\n      directoryTopicId: params.directoryTopicId,\n      skillUid: params.skillUid,\n      scanLimit: params.discoveryScanLimit,\n    })) as HCS26DiscoveryRecord | null;\n\n    if (!discovery) {\n      return [];\n    }\n\n    const versionRegistryTopicId = discovery.t_id;\n    return this.resolver.listVersionRegisters({\n      versionRegistryTopicId,\n      skillUid: params.skillUid,\n      limit: params.limit,\n    });\n  }\n\n  async resolveSkillVersion(params: {\n    directoryTopicId: string;\n    skillUid: number;\n    version: string;\n    discoveryScanLimit?: number;\n    includeVerification?: boolean;\n  }): Promise<HCS26ResolvedSkillVersion | null> {\n    const versionRaw = params.version.trim();\n    if (!versionRaw) {\n      throw new Error('version is required');\n    }\n\n    const discovery = (await this.resolver.resolveDiscoveryRecord({\n      directoryTopicId: params.directoryTopicId,\n      skillUid: params.skillUid,\n      scanLimit: params.discoveryScanLimit,\n    })) as HCS26DiscoveryRecord | null;\n\n    if (!discovery) {\n      return null;\n    }\n\n    const versionRegistryTopicId = discovery.t_id;\n    const entries = await this.resolver.listVersionRegisters({\n      versionRegistryTopicId,\n      skillUid: params.skillUid,\n      limit: 250,\n    });\n\n    const target = entries.find(entry => entry.version.trim() === versionRaw);\n    if (!target) {\n      return null;\n    }\n\n    const manifestTopicId = getManifestTopicId(target);\n    const { manifest, sha256Hex } = await this.resolver.resolveManifest({\n      manifestTopicId,\n    });\n\n    await this.resolver.verifyVersionRegisterMatchesManifest({\n      versionRegister: target,\n      manifestSha256Hex: sha256Hex,\n    });\n\n    let verification: HCS26SkillVerificationStatus | null | undefined;\n    const provider = this.verificationProvider;\n    const includeVerification = params.includeVerification === true;\n    const name =\n      typeof discovery.metadata?.name === 'string'\n        ? discovery.metadata.name.trim()\n        : '';\n\n    if (includeVerification && provider && name) {\n      try {\n        verification = await provider.getSkillVerificationStatus({ name });\n      } catch (error) {\n        const detail = error instanceof Error ? error.message : String(error);\n        this.logger.warn(\n          `Failed to resolve verification status for skill \"${name}\": ${detail}`,\n        );\n        verification = null;\n      }\n    }\n\n    return {\n      directoryTopicId: params.directoryTopicId,\n      skillUid: params.skillUid,\n      discovery,\n      versionRegistryTopicId,\n      versionEntry: target,\n      manifest,\n      manifestSha256Hex: sha256Hex,\n      ...(includeVerification ? { verification } : {}),\n    };\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es125.js","sources":["../../src/hcs-25/collectors/runner.ts"],"sourcesContent":["import { isValidAdapterId, isValidSignalId } from '../identifiers';\nimport type {\n  Hcs25ApplicabilityRule,\n  Hcs25Signal,\n  Hcs25SignalSnapshot,\n  Hcs25SignalStatus,\n  Hcs25Subject,\n} from '../types';\nimport { applyCollectedFields } from './merge';\nimport {\n  Hcs25CollectorTimeoutError,\n  isTimeoutError,\n  resolveFetch,\n} from './http';\nimport type {\n  Hcs25CollectSignalsOptions,\n  Hcs25CollectedFields,\n  Hcs25SignalAdapter,\n  Hcs25SignalAdapterResult,\n  Hcs25SignalAdapterRunReport,\n  Hcs25SignalCollection,\n} from './types';\n\nconst DEFAULT_TIMEOUT_MS = 30000;\n\n/**\n * Evaluates signal-adapter applicability using the same rule shape as trust\n * score adapters: registry include/exclude lists plus an optional\n * `appliesTo` predicate.\n */\nexport function isSignalAdapterApplicable(\n  rule: Hcs25ApplicabilityRule,\n  subject: Hcs25Subject,\n): boolean {\n  if (rule.includeRegistries) {\n    if (\n      subject.registry === undefined ||\n      !rule.includeRegistries.includes(subject.registry)\n    ) {\n      return false;\n    }\n  }\n  if (\n    rule.excludeRegistries &&\n    subject.registry !== undefined &&\n    rule.excludeRegistries.includes(subject.registry)\n  ) {\n    return false;\n  }\n  if (rule.appliesTo && !rule.appliesTo(subject)) {\n    return false;\n  }\n  return true;\n}\n\nfunction validateSignalAdapter(adapter: Hcs25SignalAdapter): void {\n  if (!isValidAdapterId(adapter.id)) {\n    throw new TypeError(\n      `invalid signal adapter id \"${String(adapter.id)}\": identifiers must match ^[a-z][a-z0-9]*(-[a-z][a-z0-9]*)*$`,\n    );\n  }\n  if (!Array.isArray(adapter.produces) || adapter.produces.length === 0) {\n    throw new TypeError(\n      `signal adapter \"${adapter.id}\" must declare at least one produced signalId`,\n    );\n  }\n  for (const signalId of adapter.produces) {\n    if (!isValidSignalId(signalId)) {\n      throw new TypeError(\n        `signal adapter \"${adapter.id}\" declares invalid signalId \"${String(signalId)}\"`,\n      );\n    }\n  }\n  if (typeof adapter.collect !== 'function') {\n    throw new TypeError(\n      `signal adapter \"${adapter.id}\" must declare a collect function`,\n    );\n  }\n}\n\nfunction isStale(\n  fetchedAt: string | undefined,\n  staleAfterMs: number,\n  now: Date,\n): boolean {\n  if (!fetchedAt) {\n    return false;\n  }\n  const fetchedMs = Date.parse(fetchedAt);\n  if (Number.isNaN(fetchedMs)) {\n    return false;\n  }\n  return now.getTime() - fetchedMs > staleAfterMs;\n}\n\nfunction applyFreshness(\n  result: Hcs25SignalAdapterResult,\n  staleAfterMs: number | undefined,\n  now: Date,\n): Hcs25SignalAdapterResult {\n  if (staleAfterMs === undefined || result.status !== 'ok') {\n    return result;\n  }\n  const fetchedAt = result.provenance?.fetchedAt;\n  if (!isStale(fetchedAt, staleAfterMs, now)) {\n    return result;\n  }\n  return {\n    ...result,\n    status: 'stale',\n    fields: markStatusFieldsStale(result.fields),\n  };\n}\n\n/**\n * When a collected signal is stale, its stored `*Status` fields are rewritten\n * to `stale` so scoring adapters emit `status:'stale'` and the staleness\n * multiplier applies (per HCS-25 missing/stale rules).\n */\nfunction markStatusFieldsStale(\n  fields: readonly Hcs25CollectedFields[] | undefined,\n): readonly Hcs25CollectedFields[] | undefined {\n  if (!fields) {\n    return fields;\n  }\n  return fields.map(block => {\n    const values = { ...block.values };\n    for (const key of Object.keys(values)) {\n      if (key.endsWith('Status') && typeof values[key] === 'string') {\n        values[key] = 'stale';\n      }\n    }\n    return { ...block, values };\n  });\n}\n\nfunction toSignal(result: Hcs25SignalAdapterResult, now: Date): Hcs25Signal {\n  return {\n    status: result.status,\n    value: result.value,\n    fetchedAt: result.provenance?.fetchedAt ?? now.toISOString(),\n    provenance: result.provenance,\n  };\n}\n\nfunction summarizeStatuses(\n  counts: Map<Hcs25SignalStatus, number>,\n): Hcs25SignalAdapterRunReport['status'] {\n  if (counts.has('error')) {\n    return 'error';\n  }\n  if (counts.has('timeout')) {\n    return 'timeout';\n  }\n  if (counts.size === 0) {\n    return 'missing';\n  }\n  if ((counts.get('ok') ?? 0) > 0 || counts.has('stale')) {\n    return 'ok';\n  }\n  return 'missing';\n}\n\n/**\n * Runs signal adapters for a subject: checks applicability, enforces\n * per-adapter time budgets, classifies failures into HCS-25 status codes,\n * marks stale signals per the configured freshness policy, merges collected\n * fields onto the subject record, and emits the signal snapshot.\n *\n * Carried-over `previousSnapshot` entries are preserved; when `staleAfterMs`\n * is configured, entries (new or carried) whose `fetchedAt` exceeds the\n * freshness window are marked `stale`.\n */\nexport async function collectHcs25Signals(\n  subject: Hcs25Subject,\n  options: Hcs25CollectSignalsOptions,\n): Promise<Hcs25SignalCollection> {\n  const fetch = resolveFetch(options.fetch);\n  const now = options.now ?? new Date();\n  const snapshot: Hcs25SignalSnapshot = { ...(options.previousSnapshot ?? {}) };\n  const results: Hcs25SignalAdapterRunReport[] = [];\n  let current = subject;\n\n  for (const adapter of options.adapters) {\n    validateSignalAdapter(adapter);\n\n    if (!isSignalAdapterApplicable(adapter, current)) {\n      results.push({\n        adapterId: adapter.id,\n        applicable: false,\n        signalIds: [],\n        status: 'missing',\n      });\n      continue;\n    }\n\n    const timeoutMs =\n      adapter.timeoutMs ?? options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n    const controller = new AbortController();\n    let timer: ReturnType<typeof setTimeout> | undefined;\n    let adapterResults: readonly Hcs25SignalAdapterResult[];\n    let runStatus: Hcs25SignalAdapterRunReport['status'] | undefined;\n    let runError: string | undefined;\n\n    try {\n      adapterResults = await Promise.race([\n        adapter.collect(current, {\n          subject: current,\n          fetch,\n          timeoutMs,\n          now,\n          signal: controller.signal,\n          force: options.force === true,\n        }),\n        new Promise<never>((_resolve, reject) => {\n          timer = setTimeout(() => {\n            controller.abort();\n            reject(new Hcs25CollectorTimeoutError());\n          }, timeoutMs + 1);\n        }),\n      ]);\n      clearTimeout(timer);\n      if (adapterResults.length === 0) {\n        // An adapter returning no results means \"no changes\" (e.g. a\n        // TTL-gated skip): carry over any existing snapshot entries and emit\n        // `missing` placeholders only for signals never produced before.\n        adapterResults = adapter.produces\n          .filter(signalId => !(signalId in snapshot))\n          .map(signalId => ({ signalId, status: 'missing' as const }));\n      }\n    } catch (error) {\n      const status: Hcs25SignalStatus = isTimeoutError(error)\n        ? 'timeout'\n        : 'error';\n      runStatus = status;\n      runError = error instanceof Error ? error.message : String(error);\n      adapterResults = adapter.produces.map(signalId => ({\n        signalId,\n        status,\n      }));\n    }\n\n    const emitted = new Set<string>();\n    const statusCounts = new Map<Hcs25SignalStatus, number>();\n    const adapterFields: Hcs25CollectedFields[] = [];\n    for (const raw of adapterResults) {\n      if (!isValidSignalId(raw.signalId)) {\n        continue;\n      }\n      const result = applyFreshness(raw, options.staleAfterMs, now);\n      emitted.add(result.signalId);\n      statusCounts.set(\n        result.status,\n        (statusCounts.get(result.status) ?? 0) + 1,\n      );\n      snapshot[result.signalId] = toSignal(result, now);\n      if (result.fields) {\n        adapterFields.push(...result.fields);\n      }\n    }\n    // Merge each adapter's fields before the next adapter runs so later\n    // adapters can consume metadata produced earlier in the same run\n    // (e.g. an id resolved by one collector feeding a downstream source).\n    if (adapterFields.length > 0) {\n      current = applyCollectedFields(current, adapterFields);\n    }\n\n    results.push({\n      adapterId: adapter.id,\n      applicable: true,\n      signalIds: [...emitted],\n      status: runStatus ?? summarizeStatuses(statusCounts),\n      error: runError,\n    });\n  }\n\n  if (options.staleAfterMs !== undefined) {\n    for (const [signalId, signal] of Object.entries(snapshot)) {\n      if (\n        signal.status === 'ok' &&\n        isStale(signal.fetchedAt, options.staleAfterMs, now)\n      ) {\n        snapshot[signalId] = { ...signal, status: 'stale' };\n      }\n    }\n  }\n\n  return {\n    subject: current,\n    snapshot,\n    results,\n  };\n}\n"],"names":[],"mappings":"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"}

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

@@ -1,37 +1,17 @@
-import { getSkillVerificationStatus } from "./standards-sdk.es190.js";
-import { HCS26BaseClient } from "./standards-sdk.es125.js";
-function mapVerification(status) {
-  const pendingRequest = status.pendingRequest ?? void 0;
-  return {
-    name: status.name,
-    verified: status.verified,
-    previouslyVerified: status.previouslyVerified,
-    ...pendingRequest ? { pendingRequest } : {}
-  };
-}
-function createRegistryBrokerVerificationProvider(client) {
-  return {
-    async getSkillVerificationStatus(params) {
-      const status = await getSkillVerificationStatus(client, {
-        name: params.name
-      });
-      return mapVerification(status);
-    }
-  };
-}
-class HCS26Client extends HCS26BaseClient {
-  constructor(config) {
-    const provider = config.verificationProvider ?? (config.registryBrokerClient ? createRegistryBrokerVerificationProvider(config.registryBrokerClient) : void 0);
-    super({
-      network: config.network,
-      logger: config.logger,
-      mirrorNode: config.mirrorNode,
-      verificationProvider: provider
-    });
-  }
+import { computeTrustScore } from "./standards-sdk.es119.js";
+import { collectHcs25Signals } from "./standards-sdk.es125.js";
+async function collectAndScoreTrustScore(subject, options) {
+  const { config, ...collectOptions } = options;
+  const collection = await collectHcs25Signals(subject, collectOptions);
+  const record = computeTrustScore({
+    subject: collection.subject,
+    snapshot: collection.snapshot,
+    config,
+    now: collectOptions.now
+  });
+  return { collection, record };
 }
 export {
-  HCS26Client,
-  createRegistryBrokerVerificationProvider
+  collectAndScoreTrustScore
 };
 //# sourceMappingURL=standards-sdk.es126.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es126.js","sources":["../../src/hcs-26/sdk.ts"],"sourcesContent":["import type { RegistryBrokerClient } from '../services/registry-broker/client/base-client';\nimport { getSkillVerificationStatus } from '../services/registry-broker/client/skills';\nimport type { SkillVerificationStatusResponse } from '../services/registry-broker/types';\nimport {\n  HCS26BaseClient,\n  type HCS26ClientConfig,\n  type HCS26SkillVerificationProvider,\n  type HCS26SkillVerificationStatus,\n} from './base-client';\n\nexport interface SDKHCS26ClientConfig extends HCS26ClientConfig {\n  registryBrokerClient?: RegistryBrokerClient;\n}\n\nfunction mapVerification(\n  status: SkillVerificationStatusResponse,\n): HCS26SkillVerificationStatus {\n  const pendingRequest = status.pendingRequest ?? undefined;\n  return {\n    name: status.name,\n    verified: status.verified,\n    previouslyVerified: status.previouslyVerified,\n    ...(pendingRequest ? { pendingRequest } : {}),\n  };\n}\n\nexport function createRegistryBrokerVerificationProvider(\n  client: RegistryBrokerClient,\n): HCS26SkillVerificationProvider {\n  return {\n    async getSkillVerificationStatus(params: { name: string }) {\n      const status = await getSkillVerificationStatus(client, {\n        name: params.name,\n      });\n      return mapVerification(status);\n    },\n  };\n}\n\nexport class HCS26Client extends HCS26BaseClient {\n  constructor(config: SDKHCS26ClientConfig) {\n    const provider =\n      config.verificationProvider ??\n      (config.registryBrokerClient\n        ? createRegistryBrokerVerificationProvider(config.registryBrokerClient)\n        : undefined);\n\n    super({\n      network: config.network,\n      logger: config.logger,\n      mirrorNode: config.mirrorNode,\n      verificationProvider: provider,\n    });\n  }\n}\n"],"names":[],"mappings":";;AAcA,SAAS,gBACP,QAC8B;AAC9B,QAAM,iBAAiB,OAAO,kBAAkB;AAChD,SAAO;AAAA,IACL,MAAM,OAAO;AAAA,IACb,UAAU,OAAO;AAAA,IACjB,oBAAoB,OAAO;AAAA,IAC3B,GAAI,iBAAiB,EAAE,mBAAmB,CAAA;AAAA,EAAC;AAE/C;AAEO,SAAS,yCACd,QACgC;AAChC,SAAO;AAAA,IACL,MAAM,2BAA2B,QAA0B;AACzD,YAAM,SAAS,MAAM,2BAA2B,QAAQ;AAAA,QACtD,MAAM,OAAO;AAAA,MAAA,CACd;AACD,aAAO,gBAAgB,MAAM;AAAA,IAC/B;AAAA,EAAA;AAEJ;AAEO,MAAM,oBAAoB,gBAAgB;AAAA,EAC/C,YAAY,QAA8B;AACxC,UAAM,WACJ,OAAO,yBACN,OAAO,uBACJ,yCAAyC,OAAO,oBAAoB,IACpE;AAEN,UAAM;AAAA,MACJ,SAAS,OAAO;AAAA,MAChB,QAAQ,OAAO;AAAA,MACf,YAAY,OAAO;AAAA,MACnB,sBAAsB;AAAA,IAAA,CACvB;AAAA,EACH;AACF;"}
+{"version":3,"file":"standards-sdk.es126.js","sources":["../../src/hcs-25/collectors/pipeline.ts"],"sourcesContent":["import { computeTrustScore } from '../scoring';\nimport type {\n  Hcs25ScoringConfigInput,\n  Hcs25Subject,\n  Hcs25TrustScoreRecord,\n} from '../types';\nimport { collectHcs25Signals } from './runner';\nimport type {\n  Hcs25CollectSignalsOptions,\n  Hcs25SignalCollection,\n} from './types';\n\nexport interface Hcs25CollectAndScoreOptions\n  extends Hcs25CollectSignalsOptions {\n  /** Scoring configuration (adapters, weights, modes) per HCS-25. */\n  config: Hcs25ScoringConfigInput;\n}\n\nexport interface Hcs25CollectAndScoreResult {\n  /** The collection outcome: enriched subject + signal snapshot. */\n  collection: Hcs25SignalCollection;\n  /** The computed trust score record for the enriched subject. */\n  record: Hcs25TrustScoreRecord;\n}\n\n/**\n * End-to-end HCS-25 pipeline: collects trust signals via signal adapters,\n * merges the stored fields onto the subject, then computes the composite AI\n * Trust Score with the provided scoring configuration.\n */\nexport async function collectAndScoreTrustScore(\n  subject: Hcs25Subject,\n  options: Hcs25CollectAndScoreOptions,\n): Promise<Hcs25CollectAndScoreResult> {\n  const { config, ...collectOptions } = options;\n  const collection = await collectHcs25Signals(subject, collectOptions);\n  const record = computeTrustScore({\n    subject: collection.subject,\n    snapshot: collection.snapshot,\n    config,\n    now: collectOptions.now,\n  });\n  return { collection, record };\n}\n"],"names":[],"mappings":";;AA8BA,eAAsB,0BACpB,SACA,SACqC;AACrC,QAAM,EAAE,QAAQ,GAAG,eAAA,IAAmB;AACtC,QAAM,aAAa,MAAM,oBAAoB,SAAS,cAAc;AACpE,QAAM,SAAS,kBAAkB;AAAA,IAC/B,SAAS,WAAW;AAAA,IACpB,UAAU,WAAW;AAAA,IACrB;AAAA,IACA,KAAK,eAAe;AAAA,EAAA,CACrB;AACD,SAAO,EAAE,YAAY,OAAA;AACvB;"}