@hol-org/rb-client 0.1.170 → 0.1.172

package/dist/index.cjs

@@ -37,13 +37,23 @@ __export(src_exports, {
   buildPaymentApproveMessage: () => buildPaymentApproveMessage,
   buildPaymentDeclineMessage: () => buildPaymentDeclineMessage,
   canonicalizeLedgerNetwork: () => canonicalizeLedgerNetwork,
+  closeUaidConnection: () => closeUaidConnection,
   createPrivateKeySigner: () => createPrivateKeySigner,
   createPrivateKeySignerAsync: () => createPrivateKeySignerAsync,
+  dashboardStats: () => dashboardStats,
+  getRegistrationProgress: () => getRegistrationProgress,
+  getRegistrationQuote: () => getRegistrationQuote,
+  getUaidConnectionStatus: () => getUaidConnectionStatus,
   isHolChatOp: () => isHolChatOp,
   isPartialRegisterAgentResponse: () => isPartialRegisterAgentResponse,
   isPendingRegisterAgentResponse: () => isPendingRegisterAgentResponse,
   isSuccessRegisterAgentResponse: () => isSuccessRegisterAgentResponse,
-  parseHolChatOps: () => parseHolChatOps
+  parseHolChatOps: () => parseHolChatOps,
+  registerAgent: () => registerAgent,
+  resolveUaid: () => resolveUaid,
+  updateAgent: () => updateAgent,
+  validateUaid: () => validateUaid,
+  waitForRegistrationCompletion: () => waitForRegistrationCompletion
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -288,6 +298,13 @@ var metadataFacetSchema = import_zod2.z.record(
     jsonValueSchema
   ])
 ).optional();
+var searchHitMetadataSchema = import_zod2.z.object({
+  delegationRoles: jsonValueSchema.optional(),
+  delegationTaskTags: jsonValueSchema.optional(),
+  delegationProtocols: jsonValueSchema.optional(),
+  delegationSummary: jsonValueSchema.optional(),
+  delegationSignals: jsonValueSchema.optional()
+}).passthrough();
 var searchHitSchema = import_zod2.z.object({
   id: import_zod2.z.string(),
   uaid: import_zod2.z.string(),
@@ -296,7 +313,7 @@ var searchHitSchema = import_zod2.z.object({
   description: import_zod2.z.string().optional(),
   capabilities: import_zod2.z.array(capabilityValueSchema),
   endpoints: import_zod2.z.union([import_zod2.z.record(jsonValueSchema), import_zod2.z.array(import_zod2.z.string())]).optional(),
-  metadata: import_zod2.z.record(jsonValueSchema).optional(),
+  metadata: searchHitMetadataSchema.optional(),
   metadataFacet: metadataFacetSchema,
   profile: agentProfileSchema.optional(),
   protocols: import_zod2.z.array(import_zod2.z.string()).optional(),
@@ -340,6 +357,62 @@ var popularResponseSchema = import_zod2.z.object({
 var resolveResponseSchema = import_zod2.z.object({
   agent: searchHitSchema
 });
+var delegationPlanCandidateSchema = import_zod2.z.object({
+  uaid: import_zod2.z.string(),
+  label: import_zod2.z.string(),
+  registry: import_zod2.z.string().optional(),
+  agent: searchHitSchema,
+  score: import_zod2.z.number(),
+  matchedQueries: import_zod2.z.array(import_zod2.z.string()).optional(),
+  matchedRoles: import_zod2.z.array(import_zod2.z.string()).optional(),
+  matchedProtocols: import_zod2.z.array(import_zod2.z.string()).optional(),
+  matchedSurfaces: import_zod2.z.array(import_zod2.z.string()).optional(),
+  matchedLanguages: import_zod2.z.array(import_zod2.z.string()).optional(),
+  matchedArtifacts: import_zod2.z.array(import_zod2.z.string()).optional(),
+  matchedTaskTags: import_zod2.z.array(import_zod2.z.string()).optional(),
+  reasons: import_zod2.z.array(import_zod2.z.string()).optional(),
+  suggestedMessage: import_zod2.z.string().optional(),
+  trustScore: import_zod2.z.number().optional(),
+  verified: import_zod2.z.boolean().optional(),
+  communicationSupported: import_zod2.z.boolean().optional(),
+  availability: import_zod2.z.boolean().optional(),
+  explanation: import_zod2.z.string().optional()
+}).passthrough();
+var delegationOpportunitySchema = import_zod2.z.object({
+  id: import_zod2.z.string(),
+  title: import_zod2.z.string(),
+  reason: import_zod2.z.string(),
+  role: import_zod2.z.string(),
+  type: import_zod2.z.enum(["ai-agents", "mcp-servers"]),
+  suggestedMode: import_zod2.z.enum(["best-match", "fallback", "parallel"]),
+  searchQueries: import_zod2.z.array(import_zod2.z.string()),
+  protocols: import_zod2.z.array(import_zod2.z.string()).optional(),
+  surfaces: import_zod2.z.array(import_zod2.z.string()).optional(),
+  languages: import_zod2.z.array(import_zod2.z.string()).optional(),
+  artifacts: import_zod2.z.array(import_zod2.z.string()).optional(),
+  candidates: import_zod2.z.array(delegationPlanCandidateSchema)
+}).passthrough();
+var delegationRecommendationSchema = import_zod2.z.object({
+  action: import_zod2.z.enum(["delegate-now", "review-shortlist", "handle-locally"]),
+  confidence: import_zod2.z.number(),
+  reason: import_zod2.z.string(),
+  opportunityId: import_zod2.z.string().optional(),
+  candidate: delegationPlanCandidateSchema.optional()
+}).passthrough();
+var delegationPlanResponseSchema = import_zod2.z.object({
+  task: import_zod2.z.string(),
+  context: import_zod2.z.string().optional(),
+  summary: import_zod2.z.string().optional(),
+  intents: import_zod2.z.array(import_zod2.z.string()),
+  protocols: import_zod2.z.array(import_zod2.z.string()),
+  surfaces: import_zod2.z.array(import_zod2.z.string()),
+  languages: import_zod2.z.array(import_zod2.z.string()).optional(),
+  artifacts: import_zod2.z.array(import_zod2.z.string()).optional(),
+  shouldDelegate: import_zod2.z.boolean(),
+  localFirstReason: import_zod2.z.string().optional(),
+  recommendation: delegationRecommendationSchema.optional(),
+  opportunities: import_zod2.z.array(delegationOpportunitySchema)
+}).passthrough();
 var agentFeedbackSummarySchema = import_zod2.z.object({
   averageScore: import_zod2.z.number(),
   totalFeedbacks: import_zod2.z.number(),
@@ -2119,6 +2192,18 @@ async function search(client, params = {}) {
   });
   return client.parseWithSchema(raw, searchResponseSchema, "search response");
 }
+async function delegate(client, request) {
+  const raw = await client.requestJson("/delegate", {
+    method: "POST",
+    body: request,
+    headers: { "content-type": "application/json" }
+  });
+  return client.parseWithSchema(
+    raw,
+    delegationPlanResponseSchema,
+    "delegate response"
+  );
+}
 async function stats(client) {
   const raw = await client.requestJson("/stats", { method: "GET" });
   return client.parseWithSchema(raw, statsResponseSchema, "stats response");
@@ -2499,6 +2584,81 @@ async function buyCreditsWithX402(client, params) {
 }
 
 // ../../src/services/registry-broker/client/agents.ts
+async function performRegisterAgent(client, payload) {
+  const raw = await client.requestJson("/register", {
+    method: "POST",
+    body: serialiseAgentRegistrationRequest(payload),
+    headers: { "content-type": "application/json" }
+  });
+  return client.parseWithSchema(
+    raw,
+    registerAgentResponseSchema,
+    "register agent response"
+  );
+}
+function calculateHbarAmount(creditsToPurchase, creditsPerHbar) {
+  if (creditsPerHbar <= 0) {
+    throw new Error("creditsPerHbar must be positive");
+  }
+  if (creditsToPurchase <= 0) {
+    throw new Error("creditsToPurchase must be positive");
+  }
+  const rawHbar = creditsToPurchase / creditsPerHbar;
+  const tinybars = Math.ceil(rawHbar * 1e8);
+  return tinybars / 1e8;
+}
+function resolveCreditsToPurchase(shortfallCredits) {
+  if (!Number.isFinite(shortfallCredits) || shortfallCredits <= 0) {
+    return 0;
+  }
+  return Math.max(
+    Math.ceil(shortfallCredits),
+    MINIMUM_REGISTRATION_AUTO_TOP_UP_CREDITS
+  );
+}
+async function ensureCreditsForRegistration(client, payload, autoTopUp) {
+  const details = autoTopUp ?? null;
+  if (!details) {
+    return;
+  }
+  if (!details.accountId || !details.accountId.trim()) {
+    throw new Error("autoTopUp.accountId is required");
+  }
+  if (!details.privateKey || !details.privateKey.trim()) {
+    throw new Error("autoTopUp.privateKey is required");
+  }
+  for (let attempt = 0; attempt < 3; attempt += 1) {
+    const quote = await getRegistrationQuote(client, payload);
+    const shortfall = quote.shortfallCredits ?? 0;
+    if (shortfall <= 0) {
+      return;
+    }
+    const creditsToPurchase = resolveCreditsToPurchase(shortfall);
+    if (creditsToPurchase <= 0) {
+      return;
+    }
+    const creditsPerHbar = quote.creditsPerHbar ?? null;
+    if (!creditsPerHbar || creditsPerHbar <= 0) {
+      throw new Error("Unable to determine credits per HBAR for auto top-up");
+    }
+    const hbarAmount = calculateHbarAmount(creditsToPurchase, creditsPerHbar);
+    await purchaseCreditsWithHbar(client, {
+      accountId: details.accountId.trim(),
+      privateKey: details.privateKey.trim(),
+      hbarAmount,
+      memo: details.memo ?? "Registry Broker auto top-up",
+      metadata: {
+        shortfallCredits: shortfall,
+        requiredCredits: quote.requiredCredits,
+        purchasedCredits: creditsToPurchase
+      }
+    });
+  }
+  const finalQuote = await getRegistrationQuote(client, payload);
+  if ((finalQuote.shortfallCredits ?? 0) > 0) {
+    throw new Error("Unable to purchase sufficient credits for registration");
+  }
+}
 async function resolveUaid(client, uaid) {
   const raw = await client.requestJson(
     `/resolve/${encodeURIComponent(uaid)}`,
@@ -2512,6 +2672,27 @@ async function resolveUaid(client, uaid) {
     "resolve UAID response"
   );
 }
+async function registerAgent(client, payload, options) {
+  const autoTopUp = options?.autoTopUp ?? client.registrationAutoTopUp;
+  if (!autoTopUp) {
+    return performRegisterAgent(client, payload);
+  }
+  await ensureCreditsForRegistration(client, payload, autoTopUp);
+  let retried = false;
+  while (true) {
+    try {
+      return await performRegisterAgent(client, payload);
+    } catch (error) {
+      const shortfall = client.extractInsufficientCreditsDetails(error);
+      if (shortfall && !retried) {
+        await ensureCreditsForRegistration(client, payload, autoTopUp);
+        retried = true;
+        continue;
+      }
+      throw error;
+    }
+  }
+}
 async function getRegistrationQuote(client, payload) {
   const raw = await client.requestJson("/register/quote", {
     method: "POST",
@@ -4654,6 +4835,9 @@ var RegistryBrokerClient = class _RegistryBrokerClient {
   async search(params = {}) {
     return search(this, params);
   }
+  async delegate(request) {
+    return delegate(this, request);
+  }
   async searchErc8004ByAgentId(params) {
     const chainId = Math.floor(params.chainId);
     if (!Number.isFinite(chainId) || chainId <= 0) {
@@ -5367,11 +5551,21 @@ var buildJobStatusMessage = (input) => JSON.stringify({
   buildPaymentApproveMessage,
   buildPaymentDeclineMessage,
   canonicalizeLedgerNetwork,
+  closeUaidConnection,
   createPrivateKeySigner,
   createPrivateKeySignerAsync,
+  dashboardStats,
+  getRegistrationProgress,
+  getRegistrationQuote,
+  getUaidConnectionStatus,
   isHolChatOp,
   isPartialRegisterAgentResponse,
   isPendingRegisterAgentResponse,
   isSuccessRegisterAgentResponse,
-  parseHolChatOps
+  parseHolChatOps,
+  registerAgent,
+  resolveUaid,
+  updateAgent,
+  validateUaid,
+  waitForRegistrationCompletion
 });