@hol-org/rb-client 0.1.171 → 0.1.172

package/dist/index.js

@@ -239,6 +239,13 @@ var metadataFacetSchema = z2.record(
     jsonValueSchema
   ])
 ).optional();
+var searchHitMetadataSchema = z2.object({
+  delegationRoles: jsonValueSchema.optional(),
+  delegationTaskTags: jsonValueSchema.optional(),
+  delegationProtocols: jsonValueSchema.optional(),
+  delegationSummary: jsonValueSchema.optional(),
+  delegationSignals: jsonValueSchema.optional()
+}).passthrough();
 var searchHitSchema = z2.object({
   id: z2.string(),
   uaid: z2.string(),
@@ -247,7 +254,7 @@ var searchHitSchema = z2.object({
   description: z2.string().optional(),
   capabilities: z2.array(capabilityValueSchema),
   endpoints: z2.union([z2.record(jsonValueSchema), z2.array(z2.string())]).optional(),
-  metadata: z2.record(jsonValueSchema).optional(),
+  metadata: searchHitMetadataSchema.optional(),
   metadataFacet: metadataFacetSchema,
   profile: agentProfileSchema.optional(),
   protocols: z2.array(z2.string()).optional(),
@@ -291,6 +298,62 @@ var popularResponseSchema = z2.object({
 var resolveResponseSchema = z2.object({
   agent: searchHitSchema
 });
+var delegationPlanCandidateSchema = z2.object({
+  uaid: z2.string(),
+  label: z2.string(),
+  registry: z2.string().optional(),
+  agent: searchHitSchema,
+  score: z2.number(),
+  matchedQueries: z2.array(z2.string()).optional(),
+  matchedRoles: z2.array(z2.string()).optional(),
+  matchedProtocols: z2.array(z2.string()).optional(),
+  matchedSurfaces: z2.array(z2.string()).optional(),
+  matchedLanguages: z2.array(z2.string()).optional(),
+  matchedArtifacts: z2.array(z2.string()).optional(),
+  matchedTaskTags: z2.array(z2.string()).optional(),
+  reasons: z2.array(z2.string()).optional(),
+  suggestedMessage: z2.string().optional(),
+  trustScore: z2.number().optional(),
+  verified: z2.boolean().optional(),
+  communicationSupported: z2.boolean().optional(),
+  availability: z2.boolean().optional(),
+  explanation: z2.string().optional()
+}).passthrough();
+var delegationOpportunitySchema = z2.object({
+  id: z2.string(),
+  title: z2.string(),
+  reason: z2.string(),
+  role: z2.string(),
+  type: z2.enum(["ai-agents", "mcp-servers"]),
+  suggestedMode: z2.enum(["best-match", "fallback", "parallel"]),
+  searchQueries: z2.array(z2.string()),
+  protocols: z2.array(z2.string()).optional(),
+  surfaces: z2.array(z2.string()).optional(),
+  languages: z2.array(z2.string()).optional(),
+  artifacts: z2.array(z2.string()).optional(),
+  candidates: z2.array(delegationPlanCandidateSchema)
+}).passthrough();
+var delegationRecommendationSchema = z2.object({
+  action: z2.enum(["delegate-now", "review-shortlist", "handle-locally"]),
+  confidence: z2.number(),
+  reason: z2.string(),
+  opportunityId: z2.string().optional(),
+  candidate: delegationPlanCandidateSchema.optional()
+}).passthrough();
+var delegationPlanResponseSchema = z2.object({
+  task: z2.string(),
+  context: z2.string().optional(),
+  summary: z2.string().optional(),
+  intents: z2.array(z2.string()),
+  protocols: z2.array(z2.string()),
+  surfaces: z2.array(z2.string()),
+  languages: z2.array(z2.string()).optional(),
+  artifacts: z2.array(z2.string()).optional(),
+  shouldDelegate: z2.boolean(),
+  localFirstReason: z2.string().optional(),
+  recommendation: delegationRecommendationSchema.optional(),
+  opportunities: z2.array(delegationOpportunitySchema)
+}).passthrough();
 var agentFeedbackSummarySchema = z2.object({
   averageScore: z2.number(),
   totalFeedbacks: z2.number(),
@@ -2070,6 +2133,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");
@@ -2450,6 +2525,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)}`,
@@ -2463,6 +2613,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",
@@ -4610,6 +4781,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) {
@@ -5322,11 +5496,21 @@ export {
   buildPaymentApproveMessage,
   buildPaymentDeclineMessage,
   canonicalizeLedgerNetwork,
+  closeUaidConnection,
   createPrivateKeySigner,
   createPrivateKeySignerAsync,
+  dashboardStats,
+  getRegistrationProgress,
+  getRegistrationQuote,
+  getUaidConnectionStatus,
   isHolChatOp,
   isPartialRegisterAgentResponse,
   isPendingRegisterAgentResponse,
   isSuccessRegisterAgentResponse,
-  parseHolChatOps
+  parseHolChatOps,
+  registerAgent,
+  resolveUaid,
+  updateAgent,
+  validateUaid,
+  waitForRegistrationCompletion
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hol-org/rb-client",
-  "version": "0.1.171",
+  "version": "0.1.172",
   "description": "Lightweight Registry Broker client for HOL registries.",
   "type": "module",
   "files": [