@hol-org/hashnet-mcp 1.0.17 → 1.0.19

package/README.md

@@ -93,7 +93,7 @@ Use `"type": "sse"` if your build expects it.
 Categories are exposed as MCP tools (`hol.*`) plus workflows (`workflow.*`):
 - **Discovery**: `hol.search`, `hol.vectorSearch`, `hol.registrySearchByNamespace`, `hol.resolveUaid`
 - **Registration**: `hol.getRegistrationQuote`, `hol.registerAgent`, `hol.waitForRegistrationCompletion`, `hol.updateAgent`
-- **Chat**: `hol.chat.createSession` (uaid or agentUrl), `hol.chat.sendMessage` (sessionId or uaid/agentUrl; auto-creates session), `hol.chat.history`, `hol.chat.compact`, `hol.chat.end`, `hol.closeUaidConnection`
+- **Chat**: `hol.chat.createSession` (uaid), `hol.chat.sendMessage` (sessionId or uaid; auto-creates session), `hol.chat.history`, `hol.chat.compact`, `hol.chat.end`, `hol.closeUaidConnection`
 - **Protocols/Ops**: `hol.listProtocols`, `hol.detectProtocol`, `hol.stats`, `hol.metricsSummary`, `hol.dashboardStats`, `hol.websocketStats`
 - **Credits**: `hol.credits.balance`, `hol.purchaseCredits.hbar`, `hol.x402.minimums`, `hol.x402.buyCredits`
 - **Ledger**: `hol.ledger.challenge`, `hol.ledger.authenticate`
@@ -122,8 +122,8 @@ Categories are exposed as MCP tools (`hol.*`) plus workflows (`workflow.*`):
 - `hol.additionalRegistries` — catalog of additional registries/networks.
 
 **Chat**
-- `hol.chat.createSession` — open a session by `uaid` or `agentUrl`.
-- `hol.chat.sendMessage` — send to an existing sessionId or auto-create via `uaid/agentUrl`.
+- `hol.chat.createSession` — open a session by `uaid`.
+- `hol.chat.sendMessage` — send to an existing sessionId or auto-create via `uaid`.
 - `hol.chat.history` / `hol.chat.compact` / `hol.chat.end` — manage chat lifecycle.
 
 **Protocols / Ops**
@@ -163,4 +163,3 @@ Set in `.env` or your process:
 ## Logging & observability
 - `pino` structured logs; set `LOG_LEVEL=fatal|error|warn|info|debug|trace`.
 - Each tool call logs requestId + duration. SSE/HTTP transport logs requests. Credits/registration calls surface broker status/body on failure.
-

package/dist/index.js

@@ -5,9 +5,7 @@ import { PassThrough } from "stream";
 
 // src/mcp.ts
 import { randomUUID } from "crypto";
-import {
-  RegistryBrokerError as RegistryBrokerError3
-} from "@hashgraphonline/standards-sdk";
+import { RegistryBrokerError as RegistryBrokerError3 } from "@hashgraphonline/standards-sdk";
 import { FastMCP } from "fastmcp";
 import { z as z3 } from "zod";
 
@@ -126,26 +124,15 @@ var broker = new RegistryBrokerClient({
 var brokerLimiter = createLimiter();
 function createLimiter() {
   if (!config.rateLimit) return void 0;
-  const limiterOptions = {};
-  if (config.rateLimit.maxConcurrent !== void 0) {
-    limiterOptions.maxConcurrent = config.rateLimit.maxConcurrent;
-  }
-  if (config.rateLimit.minTimeMs !== void 0) {
-    limiterOptions.minTime = config.rateLimit.minTimeMs;
-  }
-  if (config.rateLimit.reservoir !== void 0) {
-    limiterOptions.reservoir = config.rateLimit.reservoir;
-  }
-  if (config.rateLimit.reservoirRefreshAmount !== void 0) {
-    limiterOptions.reservoirRefreshAmount = config.rateLimit.reservoirRefreshAmount;
-  }
-  if (config.rateLimit.reservoirRefreshIntervalMs !== void 0) {
-    limiterOptions.reservoirRefreshInterval = config.rateLimit.reservoirRefreshIntervalMs;
-  }
-  if (config.rateLimit.redis?.url) {
-    limiterOptions.datastore = "ioredis";
-    limiterOptions.connection = new IORedis(config.rateLimit.redis.url);
-  }
+  const redisClient = config.rateLimit.redis?.url ? new IORedis(config.rateLimit.redis.url) : void 0;
+  const limiterOptions = {
+    ...config.rateLimit.maxConcurrent !== void 0 ? { maxConcurrent: config.rateLimit.maxConcurrent } : {},
+    ...config.rateLimit.minTimeMs !== void 0 ? { minTime: config.rateLimit.minTimeMs } : {},
+    ...config.rateLimit.reservoir !== void 0 ? { reservoir: config.rateLimit.reservoir } : {},
+    ...config.rateLimit.reservoirRefreshAmount !== void 0 ? { reservoirRefreshAmount: config.rateLimit.reservoirRefreshAmount } : {},
+    ...config.rateLimit.reservoirRefreshIntervalMs !== void 0 ? { reservoirRefreshInterval: config.rateLimit.reservoirRefreshIntervalMs } : {},
+    ...redisClient ? { datastore: "ioredis", connection: redisClient } : {}
+  };
   if (!limiterOptions.maxConcurrent && !limiterOptions.minTime && !limiterOptions.reservoir && !limiterOptions.datastore) {
     return void 0;
   }
@@ -153,8 +140,7 @@ function createLimiter() {
 }
 async function withBroker(task, label) {
   const run = async () => {
-    const isLocal = config.registryBrokerUrl.includes("localhost") || config.registryBrokerUrl.includes("127.0.0.1");
-    if (!config.registryBrokerApiKey && !isLocal) {
+    if (!config.registryBrokerApiKey) {
       throw new Error("REGISTRY_BROKER_API_KEY is required to call the registry broker. Set it in your environment or .env file.");
     }
     try {
@@ -434,7 +420,7 @@ var InsufficientCreditsError = class extends Error {
     super(message);
     this.name = "InsufficientCreditsError";
     this.summary = {
-      requiredCredits: quote.requiredCredits,
+      requiredCredits: quote.requiredCredits ?? 0,
       availableCredits: quote.availableCredits ?? 0,
       shortfallCredits: shortfall,
       estimatedHbar: quote.estimatedHbar,
@@ -503,7 +489,7 @@ var registrationDefinition = {
       run: async ({ context }) => {
         const response = await runCreditAwareRegistration({
           payload: context.payload,
-          onShortfall: async (err) => {
+          onShortfall: (err) => {
             context.quote = err.summary;
             return "abort";
           }
@@ -527,8 +513,12 @@ var registrationDefinition = {
             timeoutMs: 5 * 6e4
           })
         );
-        if (result?.result?.uaid) {
-          context.uaid = result.result.uaid;
+        if (result && typeof result === "object" && "result" in result) {
+          const progress = result;
+          const maybeUaid = progress.result?.uaid;
+          if (typeof maybeUaid === "string") {
+            context.uaid = maybeUaid;
+          }
         }
         return result;
       }
@@ -739,12 +729,6 @@ var openRouterChatDefinition = {
           throw new Error(`Model ${input.modelId} not found in registry ${input.registry ?? "openrouter"}`);
         }
         context.uaid = result.hits[0].uaid;
-        const endpoints = result.hits[0].endpoints;
-        if (Array.isArray(endpoints)) {
-          context.agentUrl = endpoints.find((endpoint) => typeof endpoint === "string" && endpoint.length > 0);
-        } else if (endpoints && typeof endpoints === "object") {
-          context.agentUrl = Object.values(endpoints).find((value) => typeof value === "string" && value.length > 0);
-        }
         return result.hits[0];
       }
     },
@@ -756,7 +740,6 @@ var openRouterChatDefinition = {
         const response = await withBroker(
           (client) => client.chat.createSession({
             uaid: context.uaid,
-            agentUrl: context.agentUrl,
             historyTtlSeconds: input.historyTtlSeconds ?? 900,
             auth
           })
@@ -771,7 +754,7 @@ var openRouterChatDefinition = {
         if (!context.sessionId) throw new Error("Missing chat session");
         const auth = input.authToken ? { type: "bearer", token: input.authToken } : void 0;
         return withBroker(
-          (client) => client.chat.sendMessage({ sessionId: context.sessionId, auth, message: input.message, agentUrl: context.agentUrl })
+          (client) => client.chat.sendMessage({ sessionId: context.sessionId, auth, message: input.message })
         );
       }
     },
@@ -883,7 +866,9 @@ var registryShowcaseDefinition = {
       name: "hol.getRegistrationQuote",
       skip: ({ input }) => !input.performCreditCheck,
       run: async ({ context }) => {
-        const response = await withBroker((client) => client.getRegistrationQuote(context.discovery?.context?.registrationPayload || context.discovery));
+        const discoveryRecord = context.discovery && typeof context.discovery === "object" ? context.discovery : null;
+        const payload = discoveryRecord?.context?.registrationPayload ?? context.discovery;
+        const response = await withBroker((client) => client.getRegistrationQuote(payload));
         context.creditQuote = response;
         return response;
       }
@@ -998,14 +983,18 @@ var registerAgentAdvancedDefinition = {
       name: "hol.getAdditionalRegistries",
       allowDuringDryRun: true,
       skip: ({ input }) => !input.additionalRegistrySelections?.length && !input.updateAdditionalRegistries?.length,
-      run: async () => withBroker((client) => client.getAdditionalRegistries())
+      run: async ({ context }) => {
+        const catalog = await withBroker((client) => client.getAdditionalRegistries());
+        context.catalog = catalog;
+        return catalog;
+      }
     },
     {
       name: "workflow.resolveAdditionalRegistries",
       allowDuringDryRun: true,
-      run: async ({ input, context }, resultFromCatalog) => {
-        if (!resultFromCatalog) return null;
-        const catalog = resultFromCatalog;
+      run: async ({ input, context }) => {
+        const catalog = context.catalog;
+        if (!catalog) return null;
         const selections = input.additionalRegistrySelections ?? [];
         const { resolved, missing } = resolveAdditionalSelections(selections, catalog);
         context.resolvedRegistries = resolved;
@@ -1029,12 +1018,12 @@ var registerAgentAdvancedDefinition = {
       run: async ({ input, context }) => {
         const response = await runCreditAwareRegistration({
           payload: context.payload,
-          onShortfall: async (summary) => {
-            context.lastQuote = summary;
+          onShortfall: async (err) => {
+            context.lastQuote = err.summary;
             if (!input.creditTopUp) {
               return "abort";
             }
-            await purchaseCreditsWithHbar(input.creditTopUp, summary);
+            await purchaseCreditsWithHbar(input.creditTopUp, err.summary);
             return "retry";
           }
         });
@@ -1054,8 +1043,12 @@ var registerAgentAdvancedDefinition = {
         if (!context.attemptId) throw new Error("Registration attemptId missing.");
         const result = await waitForRegistrationCompletion(context.attemptId);
         context.progress = result;
-        if (result?.result?.uaid) {
-          context.uaid = result.result.uaid;
+        if (result && typeof result === "object" && "result" in result) {
+          const progress = result;
+          const maybeUaid = progress.result?.uaid;
+          if (typeof maybeUaid === "string") {
+            context.uaid = maybeUaid;
+          }
         }
         return result;
       }
@@ -1079,6 +1072,9 @@ var registerAgentAdvancedDefinition = {
 };
 var registerAgentAdvancedPipeline = scaffoldWorkflow(registerAgentAdvancedDefinition);
 function resolveAdditionalSelections(selections, catalog) {
+  if (!catalog.registries || catalog.registries.length === 0) {
+    return { resolved: [], missing: selections };
+  }
   const resolved = /* @__PURE__ */ new Set();
   const missing = [];
   for (const selection of selections) {
@@ -1095,13 +1091,20 @@ function collectMatches(selection, catalog) {
   const target = selection.trim().toLowerCase();
   if (!target) return [];
   const matches = [];
-  for (const registry of catalog.registries) {
-    const registryId = registry.id.toLowerCase();
+  for (const registry of catalog.registries ?? []) {
+    const registryId = registry.id?.toLowerCase();
+    const networks = registry.networks ?? [];
+    if (!registryId || networks.length === 0) continue;
     if (registryId === target) {
-      registry.networks.forEach((network) => matches.push(network.key));
+      networks.forEach((network) => {
+        if (network?.key) {
+          matches.push(network.key);
+        }
+      });
       continue;
     }
-    for (const network of registry.networks) {
+    for (const network of networks) {
+      if (!network?.key) continue;
       const keyLower = network.key.toLowerCase();
       const networkIdLower = network.networkId?.toLowerCase();
       const labelLower = network.label?.toLowerCase();
@@ -1140,13 +1143,22 @@ var registerAgentErc8004Definition = {
     {
       name: "hol.getAdditionalRegistries",
       allowDuringDryRun: true,
-      run: async () => withBroker((client) => client.getAdditionalRegistries())
+      run: async ({ context }) => {
+        const catalog = await withBroker((client) => client.getAdditionalRegistries());
+        context.catalog = catalog;
+        return catalog;
+      }
     },
     {
       name: "workflow.erc8004.resolveNetworks",
       allowDuringDryRun: true,
-      run: async ({ input, context }, catalog) => {
-        const response = catalog;
+      run: async ({ input, context }) => {
+        const response = context.catalog;
+        if (!response) {
+          context.resolvedNetworks = [];
+          context.missingNetworks = [];
+          return { resolved: [], missing: [] };
+        }
         const selections = input.erc8004Networks?.length ? input.erc8004Networks : defaultErc8004Selections(response);
         const { resolved, missing } = resolveErc8004Selections(selections, response);
         context.resolvedNetworks = resolved;
@@ -1178,18 +1190,26 @@ var registerAgentErc8004Definition = {
 };
 var registerAgentErc8004Pipeline = scaffoldWorkflow(registerAgentErc8004Definition);
 function resolveErc8004Selections(selections, catalog) {
+  if (!catalog.registries || catalog.registries.length === 0) {
+    return { resolved: [], missing: selections };
+  }
   const resolved = /* @__PURE__ */ new Set();
   const missing = [];
   selections.forEach((entry) => {
     const normalized2 = entry.trim().toLowerCase();
     if (!normalized2) return;
     let matched = false;
-    for (const descriptor of catalog.registries) {
-      if (!descriptor.id.toLowerCase().startsWith("erc-8004")) continue;
-      for (const network of descriptor.networks) {
+    for (const descriptor of catalog.registries ?? []) {
+      const descriptorId = descriptor.id?.toLowerCase();
+      const networks = descriptor.networks ?? [];
+      if (!descriptorId || !descriptorId.startsWith("erc-8004")) continue;
+      for (const network of networks) {
+        if (!network) continue;
         const candidates = [network.key, network.networkId, network.label, network.name].map((value) => value?.toLowerCase().trim()).filter(Boolean);
-        if (candidates.includes(normalized2) || `${descriptor.id.toLowerCase()}:${network.networkId?.toLowerCase()}` === normalized2) {
-          resolved.add(network.key);
+        if (candidates.includes(normalized2) || `${descriptorId}:${network.networkId?.toLowerCase()}` === normalized2) {
+          if (network.key) {
+            resolved.add(network.key);
+          }
           matched = true;
         }
       }
@@ -1201,9 +1221,9 @@ function resolveErc8004Selections(selections, catalog) {
   return { resolved: Array.from(resolved), missing };
 }
 function defaultErc8004Selections(catalog) {
-  const defaults = catalog.registries.find((entry) => entry.id.toLowerCase() === "erc-8004");
-  if (!defaults) return [];
-  return defaults.networks.map((network) => network.key);
+  const defaults = catalog.registries?.find((entry) => entry.id?.toLowerCase() === "erc-8004");
+  if (!defaults || !defaults.networks) return [];
+  return defaults.networks.map((network) => network?.key).filter((key) => Boolean(key));
 }
 function withAdditionalRegistries(payload, networks) {
   if (networks.length === 0) return payload;
@@ -1346,7 +1366,7 @@ var connectionInstructions = [
   "You expose the Hashgraph Online Registry Broker via hol.* primitives and workflow.* pipelines. Prefer workflow.* when possible\u2014they bundle common steps and return a pipeline summary plus full results.",
   "Discovery: use workflow.discovery (or hol.search / hol.vectorSearch) to find UAIDs/agents/MCP servers; pass q/query and optional filters like capabilities, metadata, or type=ai-agents|mcp-servers.",
   "Registration: workflow.registerMcp (quote \u2192 register \u2192 wait) is the default; workflow.fullRegistration adds discovery/chat/ops. hol.registerAgent + hol.waitForRegistrationCompletion are the lower-level primitives.",
-  "Chat: call hol.resolveUaid if the UAID is unverified, then hol.chat.createSession (uaid or agentUrl + optional auth) followed by hol.chat.sendMessage (sessionId or uaid/agentUrl). Use hol.chat.history/compact/end to manage the session.",
+  "Chat: call hol.resolveUaid if the UAID is unverified, then hol.chat.createSession (uaid + optional auth) followed by hol.chat.sendMessage (sessionId or uaid). Use hol.chat.history/compact/end to manage the session.",
   "Operations: workflow.opsCheck or hol.stats/hol.metricsSummary/hol.dashboardStats show registry health; hol.listProtocols + hol.detectProtocol help route third-party requests.",
   "Credits: check hol.credits.balance before purchases. Use hol.purchaseCredits.hbar or hol.x402.buyCredits only with explicit user approval (X402 requires an EVM key); hol.x402.minimums provides thresholds.",
   "Always include UAIDs/sessionIds exactly as given and echo any auth headers/tokens the user supplies. If required fields are missing (UAID, payload, accountId), ask for them before calling tools.",
@@ -1362,25 +1382,21 @@ var agentAuthSchema = z3.object({
   headers: z3.record(z3.string(), z3.string()).optional()
 }).partial();
 var chatSessionSchema = z3.object({
-  uaid: z3.string().min(1).optional(),
-  agentUrl: z3.string().url().optional(),
+  uaid: z3.string().min(1),
   historyTtlSeconds: z3.number().int().positive().optional(),
-  auth: agentAuthSchema.optional()
-}).superRefine((value, ctx) => {
-  if (!value.uaid && !value.agentUrl) {
-    ctx.addIssue({ code: z3.ZodIssueCode.custom, message: "uaid or agentUrl is required" });
-  }
+  auth: agentAuthSchema.optional(),
+  senderUaid: z3.string().min(1).optional(),
+  encryptionRequested: z3.boolean().optional()
 });
 var chatMessageSchema = z3.object({
   sessionId: z3.string().min(1).optional(),
   uaid: z3.string().min(1).optional(),
-  agentUrl: z3.string().url().optional(),
   message: z3.string().min(1),
   streaming: z3.boolean().optional(),
   auth: agentAuthSchema.optional()
 }).superRefine((value, ctx) => {
-  if (!value.sessionId && !value.uaid && !value.agentUrl) {
-    ctx.addIssue({ code: z3.ZodIssueCode.custom, message: "Provide sessionId for existing chats or uaid/agentUrl to start a new one." });
+  if (!value.sessionId && !value.uaid) {
+    ctx.addIssue({ code: z3.ZodIssueCode.custom, message: "Provide sessionId for existing chats or uaid to start a new one." });
   }
 });
 var chatCompactSchema = z3.object({
@@ -1426,6 +1442,49 @@ var workflowFullInput = z3.object({
   discoveryQuery: z3.string().optional(),
   chatMessage: z3.string().optional()
 });
+var openRouterChatToolSchema = z3.object({
+  modelId: z3.string().min(1),
+  registry: z3.string().optional(),
+  message: z3.string(),
+  authToken: z3.string().optional()
+});
+var registryShowcaseToolSchema = z3.object({
+  query: z3.string().optional(),
+  uaid: z3.string().optional(),
+  message: z3.string().optional(),
+  performCreditCheck: z3.boolean().optional()
+});
+var erc8004DiscoveryToolSchema = z3.object({ query: z3.string().optional(), limit: z3.number().int().positive().optional() });
+var bridgePayloadSchema = z3.object({
+  uaid: z3.string().min(1),
+  agentverseUaid: z3.string().min(1),
+  localMessage: z3.string().min(1),
+  agentverseMessage: z3.string().min(1),
+  iterations: z3.number().int().positive().optional()
+});
+var erc8004X402ToolSchema = z3.object({
+  payload: agentRegistrationSchema,
+  erc8004Networks: z3.array(z3.string()).optional(),
+  chatMessage: z3.string().optional()
+});
+var x402RegistrationToolSchema = z3.object({
+  payload: agentRegistrationSchema,
+  x402: z3.object({
+    accountId: z3.string().min(1),
+    credits: z3.number().positive(),
+    evmPrivateKey: z3.string().min(1),
+    ledgerVerification: z3.object({
+      challengeId: z3.string().min(1),
+      accountId: z3.string().min(1),
+      network: z3.enum(["mainnet", "testnet"]),
+      signature: z3.string().min(1),
+      signatureKind: z3.enum(["raw", "map"]).optional(),
+      publicKey: z3.string().optional(),
+      expiresInMinutes: z3.number().int().positive().optional()
+    }).optional()
+  }),
+  chatMessage: z3.string().optional()
+});
 var waitForRegistrationInput = z3.object({
   attemptId: z3.string(),
   intervalMs: z3.number().int().positive().default(2e3),
@@ -1483,7 +1542,6 @@ var buyX402Input = z3.object({
 var mcp = new FastMCP({
   name: "hashgraph-standards",
   version: "1.0.0",
-  description: "MCP tools exposing Hashgraph Online Registry Broker via standards-sdk",
   instructions: connectionInstructions,
   // Route FastMCP logging to our pino logger (stderr) to keep stdio transport clean.
   logger: {
@@ -1494,7 +1552,7 @@ var mcp = new FastMCP({
     log: (...args) => logger.info(args)
   }
 });
-var toolDefinitions = [
+var rawToolDefinitions = [
   {
     name: "hol.search",
     description: "Keyword search for agents or MCP servers with filtering controls.",
@@ -1579,29 +1637,26 @@ var toolDefinitions = [
     description: "Send a message to an active chat session.",
     schema: chatMessageSchema,
     handler: (input) => withBroker(async (client) => {
-      if (input.sessionId) {
-        return client.chat.sendMessage(input);
+      const { sessionId, uaid, message, auth, streaming } = input;
+      if (sessionId) {
+        const payload2 = { sessionId, message, auth, streaming };
+        return client.chat.sendMessage(payload2);
       }
-      const uaid = input.uaid;
-      const agentUrl = input.agentUrl;
-      if (!uaid && !agentUrl) {
-        throw new Error("sessionId missing; provide uaid or agentUrl so a session can be created before sending.");
+      if (!uaid) {
+        throw new Error("sessionId missing; provide uaid so a session can be created before sending.");
       }
-      const session = await client.chat.createSession({
-        uaid,
-        agentUrl,
-        auth: input.auth
-      });
-      const sessionId = session.sessionId ?? session.id;
-      if (!sessionId) {
+      const session = await client.chat.createSession({ uaid, auth });
+      const derivedSessionId = session.sessionId;
+      if (!derivedSessionId) {
         throw new Error("Unable to determine sessionId from broker response when auto-creating chat session.");
       }
-      return client.chat.sendMessage({
-        sessionId,
-        message: input.message,
-        auth: input.auth,
-        streaming: input.streaming
-      });
+      const payload = {
+        sessionId: derivedSessionId,
+        message,
+        auth,
+        streaming
+      };
+      return client.chat.sendMessage(payload);
     }, "hol.chat.sendMessage")
   },
   {
@@ -1733,50 +1788,37 @@ var toolDefinitions = [
   {
     name: "workflow.openrouterChat",
     description: "Pipeline: discover OpenRouter model and run a chat message",
-    schema: z3.object({ modelId: z3.string().min(1), registry: z3.string().optional(), message: z3.string(), authToken: z3.string().optional() }),
+    schema: openRouterChatToolSchema,
     handler: async (input) => formatPipelineResult(await openRouterChatWorkflow.run(input))
   },
   {
     name: "workflow.registryBrokerShowcase",
     description: "Pipeline: discovery, analytics, UAID validation, chat",
-    schema: z3.object({ query: z3.string().optional(), uaid: z3.string().optional(), message: z3.string().optional(), performCreditCheck: z3.boolean().optional() }),
+    schema: registryShowcaseToolSchema,
     handler: async (input) => formatPipelineResult(await registryBrokerShowcaseWorkflow.run(input))
   },
   {
     name: "workflow.agentverseBridge",
     description: "Pipeline: relay chat between local UAID and Agentverse UAID",
-    schema: z3.object({
-      uaid: z3.string().min(1),
-      agentverseUaid: z3.string().min(1),
-      localMessage: z3.string().min(1),
-      agentverseMessage: z3.string().min(1),
-      iterations: z3.number().int().positive().optional()
-    }),
+    schema: bridgePayloadSchema,
     handler: async (input) => formatPipelineResult(await agentverseBridgeWorkflow.run(input))
   },
   {
     name: "workflow.erc8004Discovery",
     description: "Pipeline: search ERC-8004 registries",
-    schema: z3.object({ query: z3.string().optional(), limit: z3.number().int().positive().optional() }),
+    schema: erc8004DiscoveryToolSchema,
     handler: async (input) => formatPipelineResult(await erc8004DiscoveryWorkflow.run(input))
   },
   {
     name: "workflow.erc8004X402",
     description: "Pipeline: ERC-8004 registration funded via X402 credits",
-    schema: z3.object({
-      payload: agentRegistrationSchema,
-      erc8004Networks: z3.array(z3.string()).optional(),
-      chatMessage: z3.string().optional()
-    }),
+    schema: erc8004X402ToolSchema,
     handler: async (input) => formatPipelineResult(await erc8004X402Workflow.run(input))
   },
   {
     name: "workflow.x402Registration",
     description: "Pipeline: register agent using X402 payments + chat smoke test",
-    schema: z3.object({
-      payload: agentRegistrationSchema,
-      chatMessage: z3.string().optional()
-    }),
+    schema: x402RegistrationToolSchema,
     handler: async (input) => formatPipelineResult(await x402RegistrationWorkflow.run(input))
   },
   {
@@ -1786,11 +1828,14 @@ var toolDefinitions = [
     handler: async (input) => formatPipelineResult(await fullWorkflowPipeline.run(input))
   }
 ];
+var toolDefinitions = rawToolDefinitions;
 function formatPipelineResult(result) {
+  const contextRecord = result.context && typeof result.context === "object" ? result.context : {};
+  const contextUaid = typeof contextRecord.uaid === "string" ? contextRecord.uaid : void 0;
   const summaryLines = [
     `Workflow: ${result.pipeline}`,
     result.dryRun ? "(dry-run)" : void 0,
-    result.context?.uaid ? `UAID: ${result.context.uaid}` : void 0,
+    contextUaid ? `UAID: ${contextUaid}` : void 0,
     `Steps executed: ${result.steps.length}`
   ].filter(Boolean);
   return {
@@ -1941,7 +1986,7 @@ mcp.addResource({
         "Prefer workflow.* pipelines when available\u2014they run multiple broker calls and return both a text summary and structured results:",
         "- Discovery: workflow.discovery { query?, limit? } (or hol.search / hol.vectorSearch).",
         "- Registration: workflow.registerMcp { payload } (quote \u2192 register \u2192 wait) or workflow.fullRegistration to add discovery/chat/ops.",
-        "- Chat: hol.chat.createSession { uaid or agentUrl, auth?, historyTtlSeconds? } \u2192 hol.chat.sendMessage { sessionId OR (uaid/agentUrl), message, auth?, streaming? } \u2192 hol.chat.history/compact/end.",
+        "- Chat: hol.chat.createSession { uaid, auth?, historyTtlSeconds? } \u2192 hol.chat.sendMessage { sessionId OR uaid, message, auth?, streaming? } \u2192 hol.chat.history/compact/end.",
         "- UAID validation/resets: hol.resolveUaid { uaid }, hol.closeUaidConnection { uaid }.",
         "- Ops/metrics: workflow.opsCheck or hol.stats / hol.metricsSummary / hol.dashboardStats.",
         "- Credits: hol.credits.balance first, then hol.purchaseCredits.hbar or hol.x402.buyCredits (X402 requires evmPrivateKey; call hol.x402.minimums to inspect limits).",