@hashgraphonline/standards-sdk 0.1.170 → 0.1.171

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

@@ -1,553 +1,203 @@
-import { skillRegistryConfigResponseSchema, skillRegistryListResponseSchema, skillSecurityBreakdownResponseSchema, skillCatalogResponseSchema, skillRegistryVersionsResponseSchema, skillRegistryMineResponseSchema, skillRegistryMyListResponseSchema, skillRegistryQuoteResponseSchema, skillRegistryPublishResponseSchema, skillRegistryJobStatusResponseSchema, skillRegistryOwnershipResponseSchema, skillRecommendedVersionResponseSchema, skillDeprecationsResponseSchema, skillDeprecationRecordSchema, skillBadgeResponseSchema, skillRegistryTagsResponseSchema, skillRegistryCategoriesResponseSchema, skillResolverManifestResponseSchema, skillRegistryVoteStatusResponseSchema, skillVerificationRequestCreateResponseSchema, skillVerificationStatusResponseSchema, skillVerificationDomainProofChallengeResponseSchema, skillVerificationDomainProofVerifyResponseSchema } from "./standards-sdk.es145.js";
-async function skillsConfig(client) {
-  const raw = await client.requestJson("/skills/config", {
-    method: "GET"
-  });
-  return client.parseWithSchema(
-    raw,
-    skillRegistryConfigResponseSchema,
-    "skill registry config response"
-  );
-}
-async function listSkills(client, params = {}) {
-  const query = new URLSearchParams();
-  if (params.name) {
-    query.set("name", params.name);
-  }
-  if (params.version) {
-    query.set("version", params.version);
-  }
-  if (typeof params.limit === "number" && Number.isFinite(params.limit)) {
-    query.set("limit", String(Math.trunc(params.limit)));
-  }
-  if (params.cursor) {
-    query.set("cursor", params.cursor);
-  }
-  if (typeof params.includeFiles === "boolean") {
-    query.set("includeFiles", params.includeFiles ? "true" : "false");
-  }
-  if (params.accountId) {
-    query.set("accountId", params.accountId);
-  }
-  if (params.q) {
-    query.set("q", params.q);
-  }
-  if (params.tag) {
-    query.set("tag", params.tag);
-  }
-  if (params.category) {
-    query.set("category", params.category);
-  }
-  if (typeof params.featured === "boolean") {
-    query.set("featured", params.featured ? "true" : "false");
-  }
-  if (typeof params.verified === "boolean") {
-    query.set("verified", params.verified ? "true" : "false");
-  }
-  if (params.view) {
-    query.set("view", params.view);
-  }
-  const suffix = query.size > 0 ? `?${query.toString()}` : "";
-  const raw = await client.requestJson(`/skills${suffix}`, {
-    method: "GET"
-  });
-  return client.parseWithSchema(
-    raw,
-    skillRegistryListResponseSchema,
-    "skill registry list response"
-  );
-}
-async function getSkillSecurityBreakdown(client, params) {
-  const normalizedJobId = params.jobId.trim();
-  if (!normalizedJobId) {
-    throw new Error("jobId is required");
-  }
-  const raw = await client.requestJson(
-    `/skills/${encodeURIComponent(normalizedJobId)}/security-breakdown`,
-    { method: "GET" }
-  );
-  return client.parseWithSchema(
-    raw,
-    skillSecurityBreakdownResponseSchema,
-    "skill security breakdown response"
-  );
-}
-async function getSkillsCatalog(client, params = {}) {
-  const query = new URLSearchParams();
-  if (params.q) {
-    query.set("q", params.q);
-  }
-  if (params.category) {
-    query.set("category", params.category);
-  }
-  params.tags?.forEach((tag) => {
-    if (tag.trim()) {
-      query.append("tag", tag.trim());
+import { parseSemicolonFields } from "./standards-sdk.es165.js";
+const ANS_HCS27_REGISTRY = "ans";
+function isObjectRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function asString(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const trimmed = value.trim();
+  if (!trimmed) {
+    return null;
+  }
+  return trimmed;
+}
+function isSemver(value) {
+  return /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/.test(
+    value
+  );
+}
+function normalizeAnsVersion(value) {
+  const trimmed = value.trim();
+  if (!trimmed) {
+    return null;
+  }
+  const withoutPrefix = trimmed.startsWith("v") || trimmed.startsWith("V") ? trimmed.slice(1) : trimmed;
+  if (!isSemver(withoutPrefix)) {
+    return null;
+  }
+  return withoutPrefix;
+}
+function parseAnsDnsTxtRecord(rawRecord) {
+  const fields = parseSemicolonFields(rawRecord);
+  const version = fields["v"];
+  const urlValue = fields["url"];
+  if (!version || !urlValue || version.toLowerCase() !== "ans1") {
+    return null;
+  }
+  let parsedUrl;
+  try {
+    parsedUrl = new URL(urlValue);
+  } catch {
+    return null;
+  }
+  if (parsedUrl.protocol.toLowerCase() !== "https:") {
+    return null;
+  }
+  const rawAnsVersion = fields["version"];
+  let normalizedAnsVersion;
+  if (rawAnsVersion !== void 0) {
+    const parsedVersion = normalizeAnsVersion(rawAnsVersion);
+    if (!parsedVersion) {
+      return null;
     }
-  });
-  if (typeof params.featured === "boolean") {
-    query.set("featured", params.featured ? "true" : "false");
-  }
-  if (typeof params.verified === "boolean") {
-    query.set("verified", params.verified ? "true" : "false");
-  }
-  if (params.channel) {
-    query.set("channel", params.channel);
-  }
-  if (params.sortBy) {
-    query.set("sortBy", params.sortBy);
+    normalizedAnsVersion = parsedVersion;
   }
-  if (typeof params.limit === "number" && Number.isFinite(params.limit)) {
-    query.set("limit", String(Math.trunc(params.limit)));
-  }
-  if (params.cursor) {
-    query.set("cursor", params.cursor);
-  }
-  const suffix = query.size > 0 ? `?${query.toString()}` : "";
-  const raw = await client.requestJson(`/skills/catalog${suffix}`, {
-    method: "GET"
-  });
-  return client.parseWithSchema(
-    raw,
-    skillCatalogResponseSchema,
-    "skill catalog response"
-  );
+  return {
+    version: normalizedAnsVersion,
+    url: parsedUrl.toString()
+  };
 }
-async function listSkillVersions(client, params) {
-  const normalizedName = params.name.trim();
-  if (!normalizedName) {
-    throw new Error("name is required");
-  }
-  const query = new URLSearchParams();
-  query.set("name", normalizedName);
-  const raw = await client.requestJson(
-    `/skills/versions?${query.toString()}`,
-    { method: "GET" }
-  );
-  return client.parseWithSchema(
-    raw,
-    skillRegistryVersionsResponseSchema,
-    "skill registry versions response"
-  );
+function isValidAnsProfileVersion(value) {
+  return !!value && normalizeAnsVersion(value) !== null;
 }
-async function listMySkills(client, params = {}) {
-  const query = new URLSearchParams();
-  if (typeof params.limit === "number" && Number.isFinite(params.limit)) {
-    query.set("limit", String(Math.trunc(params.limit)));
-  }
-  const suffix = query.size > 0 ? `?${query.toString()}` : "";
-  const raw = await client.requestJson(`/skills/mine${suffix}`, {
-    method: "GET"
-  });
-  return client.parseWithSchema(
-    raw,
-    skillRegistryMineResponseSchema,
-    "skill registry mine response"
-  );
-}
-async function getMySkillsList(client, params = {}) {
-  const query = new URLSearchParams();
-  if (typeof params.limit === "number" && Number.isFinite(params.limit)) {
-    query.set("limit", String(Math.trunc(params.limit)));
-  }
-  if (params.cursor) {
-    query.set("cursor", params.cursor);
+function hasProtocolPathSegment(pathname, protocol) {
+  const normalizedProtocol = protocol.trim().toLowerCase();
+  if (!normalizedProtocol) {
+    return false;
   }
-  if (params.accountId) {
-    query.set("accountId", params.accountId);
-  }
-  const suffix = query.size > 0 ? `?${query.toString()}` : "";
-  const raw = await client.requestJson(`/skills/my-list${suffix}`, {
-    method: "GET"
-  });
-  return client.parseWithSchema(
-    raw,
-    skillRegistryMyListResponseSchema,
-    "skill registry my list response"
-  );
-}
-async function quoteSkillPublish(client, payload) {
-  const raw = await client.requestJson("/skills/quote", {
-    method: "POST",
-    body: payload,
-    headers: { "content-type": "application/json" }
-  });
-  return client.parseWithSchema(
-    raw,
-    skillRegistryQuoteResponseSchema,
-    "skill registry quote response"
-  );
-}
-async function publishSkill(client, payload) {
-  const raw = await client.requestJson("/skills/publish", {
-    method: "POST",
-    body: payload,
-    headers: { "content-type": "application/json" }
-  });
-  return client.parseWithSchema(
-    raw,
-    skillRegistryPublishResponseSchema,
-    "skill registry publish response"
-  );
-}
-async function getSkillPublishJob(client, jobId, params = {}) {
-  const normalized = jobId.trim();
-  if (!normalized) {
-    throw new Error("jobId is required");
-  }
-  const query = new URLSearchParams();
-  if (params.accountId) {
-    query.set("accountId", params.accountId);
-  }
-  const suffix = query.size > 0 ? `?${query.toString()}` : "";
-  const raw = await client.requestJson(
-    `/skills/jobs/${encodeURIComponent(normalized)}${suffix}`,
-    { method: "GET" }
-  );
-  return client.parseWithSchema(
-    raw,
-    skillRegistryJobStatusResponseSchema,
-    "skill registry job status response"
-  );
-}
-async function getSkillOwnership(client, params) {
-  const normalizedName = params.name.trim();
-  if (!normalizedName) {
-    throw new Error("name is required");
-  }
-  const query = new URLSearchParams();
-  query.set("name", normalizedName);
-  if (params.accountId) {
-    query.set("accountId", params.accountId);
-  }
-  const raw = await client.requestJson(
-    `/skills/ownership?${query.toString()}`,
-    {
-      method: "GET"
+  const pathSegments = pathname.split("/").map((segment) => segment.trim()).filter((segment) => segment.length > 0);
+  for (const segment of pathSegments) {
+    if (segment.toLowerCase() === normalizedProtocol) {
+      return true;
     }
-  );
-  return client.parseWithSchema(
-    raw,
-    skillRegistryOwnershipResponseSchema,
-    "skill registry ownership response"
-  );
-}
-async function getRecommendedSkillVersion(client, params) {
-  const normalizedName = params.name.trim();
-  if (!normalizedName) {
-    throw new Error("name is required");
   }
-  const query = new URLSearchParams();
-  query.set("name", normalizedName);
-  const raw = await client.requestJson(
-    `/skills/recommended?${query.toString()}`,
-    { method: "GET" }
-  );
-  return client.parseWithSchema(
-    raw,
-    skillRecommendedVersionResponseSchema,
-    "skill recommended version response"
-  );
+  return false;
 }
-async function setRecommendedSkillVersion(client, payload) {
-  const normalizedName = payload.name.trim();
-  const normalizedVersion = payload.version.trim();
-  if (!normalizedName) {
-    throw new Error("name is required");
-  }
-  if (!normalizedVersion) {
-    throw new Error("version is required");
-  }
-  const raw = await client.requestJson("/skills/recommended", {
-    method: "POST",
-    body: {
-      name: normalizedName,
-      version: normalizedVersion
-    },
-    headers: { "content-type": "application/json" }
-  });
-  return client.parseWithSchema(
-    raw,
-    skillRecommendedVersionResponseSchema,
-    "skill recommended version response"
-  );
-}
-async function getSkillDeprecations(client, params) {
-  const normalizedName = params.name.trim();
-  if (!normalizedName) {
-    throw new Error("name is required");
-  }
-  const query = new URLSearchParams();
-  query.set("name", normalizedName);
-  const raw = await client.requestJson(
-    `/skills/deprecations?${query.toString()}`,
-    { method: "GET" }
-  );
-  return client.parseWithSchema(
-    raw,
-    skillDeprecationsResponseSchema,
-    "skill deprecations response"
-  );
-}
-async function setSkillDeprecation(client, payload) {
-  const normalizedName = payload.name.trim();
-  if (!normalizedName) {
-    throw new Error("name is required");
-  }
-  const version = payload.version?.trim();
-  const reason = payload.reason.trim();
-  if (!reason) {
-    throw new Error("reason is required");
-  }
-  const replacementRef = payload.replacementRef?.trim();
-  const raw = await client.requestJson("/skills/deprecate", {
-    method: "POST",
-    body: {
-      name: normalizedName,
-      version,
-      reason,
-      replacementRef
-    },
-    headers: { "content-type": "application/json" }
-  });
-  return client.parseWithSchema(
-    raw,
-    skillDeprecationRecordSchema,
-    "skill deprecation response"
-  );
-}
-async function getSkillBadge(client, params) {
-  const normalizedName = params.name.trim();
-  if (!normalizedName) {
-    throw new Error("name is required");
-  }
-  const query = new URLSearchParams();
-  query.set("name", normalizedName);
-  if (params.metric) {
-    query.set("metric", params.metric);
-  }
-  if (params.label?.trim()) {
-    query.set("label", params.label.trim());
-  }
-  if (params.style) {
-    query.set("style", params.style);
-  }
-  const raw = await client.requestJson(
-    `/skills/badge?${query.toString()}`,
-    { method: "GET" }
-  );
-  return client.parseWithSchema(
-    raw,
-    skillBadgeResponseSchema,
-    "skill badge response"
-  );
-}
-async function listSkillTags(client) {
-  const raw = await client.requestJson("/skills/tags", {
-    method: "GET"
-  });
-  return client.parseWithSchema(
-    raw,
-    skillRegistryTagsResponseSchema,
-    "skill tags response"
-  );
-}
-async function listSkillCategories(client) {
-  const raw = await client.requestJson("/skills/categories", {
-    method: "GET"
-  });
-  return client.parseWithSchema(
-    raw,
-    skillRegistryCategoriesResponseSchema,
-    "skill categories response"
-  );
-}
-async function resolveSkillMarkdown(client, skillRef) {
-  const normalizedSkillRef = skillRef.trim();
-  if (!normalizedSkillRef) {
-    throw new Error("skillRef is required");
-  }
-  const response = await client.request(
-    `/skills/${encodeURIComponent(normalizedSkillRef)}/SKILL.md`,
-    {
-      method: "GET",
-      headers: {
-        accept: "text/markdown, text/plain;q=0.9, */*;q=0.8"
-      }
-    }
-  );
-  return response.text();
-}
-async function resolveSkillManifest(client, skillRef) {
-  const normalizedSkillRef = skillRef.trim();
-  if (!normalizedSkillRef) {
-    throw new Error("skillRef is required");
-  }
-  const raw = await client.requestJson(
-    `/skills/${encodeURIComponent(normalizedSkillRef)}/manifest`,
-    {
-      method: "GET"
+function extractEndpointCandidates(endpoints, supportedSchemes) {
+  const candidates = [];
+  for (const [key, value] of Object.entries(endpoints)) {
+    if (!isObjectRecord(value)) {
+      continue;
     }
-  );
-  return client.parseWithSchema(
-    raw,
-    skillResolverManifestResponseSchema,
-    "skill resolver manifest response"
-  );
-}
-async function getSkillVoteStatus(client, params) {
-  const normalizedName = params.name.trim();
-  if (!normalizedName) {
-    throw new Error("name is required");
-  }
-  const query = new URLSearchParams();
-  query.set("name", normalizedName);
-  const raw = await client.requestJson(
-    `/skills/vote?${query.toString()}`,
-    { method: "GET" }
-  );
-  return client.parseWithSchema(
-    raw,
-    skillRegistryVoteStatusResponseSchema,
-    "skill registry vote status response"
-  );
-}
-async function setSkillVote(client, payload) {
-  const normalizedName = payload.name.trim();
-  if (!normalizedName) {
-    throw new Error("name is required");
-  }
-  const raw = await client.requestJson("/skills/vote", {
-    method: "POST",
-    body: { name: normalizedName, upvoted: payload.upvoted },
-    headers: { "content-type": "application/json" }
-  });
-  return client.parseWithSchema(
-    raw,
-    skillRegistryVoteStatusResponseSchema,
-    "skill registry vote status response"
-  );
-}
-async function requestSkillVerification(client, payload) {
-  const normalizedName = payload.name.trim();
-  if (!normalizedName) {
-    throw new Error("name is required");
-  }
-  const raw = await client.requestJson(
-    "/skills/verification/request",
-    {
-      method: "POST",
-      body: {
-        name: normalizedName,
-        version: payload.version,
-        tier: payload.tier
-      },
-      headers: { "content-type": "application/json" }
+    const endpoint = asString(value["url"]);
+    if (!endpoint) {
+      continue;
     }
-  );
-  return client.parseWithSchema(
-    raw,
-    skillVerificationRequestCreateResponseSchema,
-    "skill verification request create response"
-  );
-}
-async function getSkillVerificationStatus(client, params) {
-  const normalizedName = params.name.trim();
-  if (!normalizedName) {
-    throw new Error("name is required");
-  }
-  const query = new URLSearchParams();
-  query.set("name", normalizedName);
-  if (params.version) {
-    query.set("version", params.version);
-  }
-  const raw = await client.requestJson(
-    `/skills/verification/status?${query.toString()}`,
-    { method: "GET" }
-  );
-  return client.parseWithSchema(
-    raw,
-    skillVerificationStatusResponseSchema,
-    "skill verification status response"
-  );
-}
-async function createSkillDomainProofChallenge(client, payload) {
-  const normalizedName = payload.name.trim();
-  if (!normalizedName) {
-    throw new Error("name is required");
-  }
-  const raw = await client.requestJson(
-    "/skills/verification/domain/challenge",
-    {
-      method: "POST",
-      body: {
-        name: normalizedName,
-        version: payload.version,
-        domain: payload.domain
-      },
-      headers: { "content-type": "application/json" }
+    let parsedUrl;
+    try {
+      parsedUrl = new URL(endpoint);
+    } catch {
+      continue;
     }
-  );
-  return client.parseWithSchema(
-    raw,
-    skillVerificationDomainProofChallengeResponseSchema,
-    "skill domain proof challenge response"
-  );
-}
-async function verifySkillDomainProof(client, payload) {
-  const normalizedName = payload.name.trim();
-  const challengeToken = payload.challengeToken.trim();
-  if (!normalizedName) {
-    throw new Error("name is required");
-  }
-  if (!challengeToken) {
-    throw new Error("challengeToken is required");
-  }
-  const raw = await client.requestJson(
-    "/skills/verification/domain/verify",
-    {
-      method: "POST",
-      body: {
-        name: normalizedName,
-        version: payload.version,
-        domain: payload.domain,
-        challengeToken
-      },
-      headers: { "content-type": "application/json" }
+    const scheme = parsedUrl.protocol.replace(/:$/, "").toLowerCase();
+    if (!supportedSchemes.has(scheme)) {
+      continue;
     }
-  );
-  return client.parseWithSchema(
-    raw,
-    skillVerificationDomainProofVerifyResponseSchema,
-    "skill domain proof verify response"
-  );
+    candidates.push({
+      key,
+      endpointUrl: parsedUrl.toString(),
+      parsedUrl
+    });
+  }
+  return candidates;
+}
+function validateAnsHcs27Hints(input) {
+  if (!isObjectRecord(input)) {
+    return void 0;
+  }
+  const checkpointTopicId = asString(input["checkpoint_topic_id"]);
+  const registry = asString(input["registry"]);
+  const logId = asString(input["log_id"]);
+  if (!checkpointTopicId || !registry || !logId || registry !== ANS_HCS27_REGISTRY) {
+    return void 0;
+  }
+  const checkpointUri = asString(input["checkpoint_uri"]) ?? void 0;
+  const viewerUri = asString(input["viewer_uri"]) ?? void 0;
+  return {
+    checkpointTopicId,
+    registry,
+    logId,
+    checkpointUri,
+    viewerUri
+  };
+}
+function validateHcs28Hints(input) {
+  if (!isObjectRecord(input)) {
+    return void 0;
+  }
+  const directoryTopicId = asString(input["directory_topic_id"]);
+  const tId = asString(input["t_id"]);
+  const agentId = asString(input["agent_id"]);
+  if (!directoryTopicId || !tId || !agentId) {
+    return void 0;
+  }
+  const proofProfile = asString(input["proof_profile"]) ?? void 0;
+  return {
+    directoryTopicId,
+    tId,
+    agentId,
+    proofProfile
+  };
+}
+function parseTransparencyHints(input) {
+  if (!isObjectRecord(input)) {
+    return void 0;
+  }
+  const hcs27 = validateAnsHcs27Hints(input["hcs27"]);
+  const hcs28 = validateHcs28Hints(input["hcs28"]);
+  if (!hcs27 && !hcs28) {
+    return void 0;
+  }
+  return {
+    hcs27,
+    hcs28
+  };
+}
+function parseAnsAgentCard(input) {
+  if (!isObjectRecord(input)) {
+    return null;
+  }
+  const ansName = asString(input["ansName"]);
+  const endpoints = input["endpoints"];
+  if (!ansName || !isObjectRecord(endpoints)) {
+    return null;
+  }
+  return {
+    ansName,
+    endpoints,
+    transparencyHints: parseTransparencyHints(input["transparency"])
+  };
+}
+function selectPreferredEndpoint(candidates, protocol) {
+  if (candidates.length === 0) {
+    return null;
+  }
+  const sortedCandidates = [...candidates].sort(
+    (a, b) => a.key.localeCompare(b.key)
+  );
+  const protocolMatches = sortedCandidates.filter(
+    (candidate) => hasProtocolPathSegment(candidate.parsedUrl.pathname, protocol)
+  );
+  if (protocolMatches.length > 0) {
+    return protocolMatches[0];
+  }
+  return sortedCandidates[0];
+}
+function toErrorMessage(error) {
+  if (error instanceof Error && error.message) {
+    return error.message;
+  }
+  return null;
 }
 export {
-  createSkillDomainProofChallenge,
-  getMySkillsList,
-  getRecommendedSkillVersion,
-  getSkillBadge,
-  getSkillDeprecations,
-  getSkillOwnership,
-  getSkillPublishJob,
-  getSkillSecurityBreakdown,
-  getSkillVerificationStatus,
-  getSkillVoteStatus,
-  getSkillsCatalog,
-  listMySkills,
-  listSkillCategories,
-  listSkillTags,
-  listSkillVersions,
-  listSkills,
-  publishSkill,
-  quoteSkillPublish,
-  requestSkillVerification,
-  resolveSkillManifest,
-  resolveSkillMarkdown,
-  setRecommendedSkillVersion,
-  setSkillDeprecation,
-  setSkillVote,
-  skillsConfig,
-  verifySkillDomainProof
+  extractEndpointCandidates,
+  isValidAnsProfileVersion,
+  normalizeAnsVersion,
+  parseAnsAgentCard,
+  parseAnsDnsTxtRecord,
+  selectPreferredEndpoint,
+  toErrorMessage
 };
 //# sourceMappingURL=standards-sdk.es166.js.map