@hashgraphonline/standards-agent-kit 0.2.110 → 0.2.112

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hashgraphonline/standards-agent-kit",
-  "version": "0.2.110",
+  "version": "0.2.112",
   "description": "A modular SDK for building on-chain autonomous agents using Hashgraph Online Standards, including HCS-10 for agent discovery and communication.",
   "type": "module",
   "main": "./dist/cjs/standards-agent-kit.cjs",
@@ -89,7 +89,7 @@
   },
   "dependencies": {
     "@hashgraph/sdk": "^2.69.0",
-    "@hashgraphonline/standards-sdk": "0.0.165",
+    "@hashgraphonline/standards-sdk": "0.0.167",
     "@langchain/community": "^0.3.49",
     "@langchain/core": "^0.3.66",
     "@langchain/openai": "^0.6.3",

package/src/builders/hcs6/hcs6-builder.ts

@@ -0,0 +1,136 @@
+import { BaseServiceBuilder } from 'hedera-agent-kit';
+import type { HederaAgentKit } from 'hedera-agent-kit';
+import {
+  HCS6Client,
+  SDKHCS6ClientConfig,
+  HCS6CreateRegistryOptions,
+  HCS6RegisterEntryOptions,
+  HCS6QueryRegistryOptions,
+  HCS6RegisterOptions,
+  HCS6CreateHashinalOptions,
+  HCS6TopicRegistrationResponse,
+  HCS6RegistryOperationResponse,
+  HCS6TopicRegistry,
+  HCS6CreateHashinalResponse,
+  NetworkType,
+} from '@hashgraphonline/standards-sdk';
+
+/**
+ * Builder for HCS-6 operations that delegates to HCS6Client
+ */
+export class HCS6Builder extends BaseServiceBuilder {
+  protected hcs6Client?: HCS6Client;
+
+  constructor(hederaKit: HederaAgentKit) {
+    super(hederaKit);
+  }
+
+  /**
+   * Get or create HCS-6 client
+   */
+  protected async getHCS6Client(): Promise<HCS6Client> {
+    if (!this.hcs6Client) {
+      const operatorId = this.hederaKit.signer.getAccountId().toString();
+      const operatorPrivateKey = this.hederaKit.signer?.getOperatorPrivateKey()
+        ? this.hederaKit.signer.getOperatorPrivateKey().toStringRaw()
+        : '';
+
+      const network = this.hederaKit.client.network;
+      const networkType: NetworkType = network.toString().includes('mainnet')
+        ? 'mainnet'
+        : 'testnet';
+
+      const config: SDKHCS6ClientConfig = {
+        network: networkType,
+        operatorId: operatorId,
+        operatorKey: operatorPrivateKey,
+      };
+
+      this.hcs6Client = new HCS6Client(config);
+    }
+    return this.hcs6Client;
+  }
+
+  /**
+   * Create a new HCS-6 dynamic registry
+   * Note: This executes the transaction directly via HCS6Client
+   */
+  async createRegistry(
+    options: HCS6CreateRegistryOptions = {}
+  ): Promise<HCS6TopicRegistrationResponse> {
+    const client = await this.getHCS6Client();
+    return await client.createRegistry(options);
+  }
+
+  /**
+   * Register a new dynamic hashinal entry in an HCS-6 registry
+   */
+  async registerEntry(
+    registryTopicId: string,
+    options: HCS6RegisterEntryOptions
+  ): Promise<HCS6RegistryOperationResponse> {
+    const client = await this.getHCS6Client();
+    return await client.registerEntry(registryTopicId, options);
+  }
+
+  /**
+   * Query entries from an HCS-6 registry
+   */
+  async getRegistry(
+    topicId: string,
+    options: HCS6QueryRegistryOptions = {}
+  ): Promise<HCS6TopicRegistry> {
+    const client = await this.getHCS6Client();
+    return await client.getRegistry(topicId, options);
+  }
+
+  /**
+   * Create a complete dynamic hashinal with inscription and registry
+   */
+  async createHashinal(
+    options: HCS6CreateHashinalOptions
+  ): Promise<HCS6CreateHashinalResponse> {
+    const client = await this.getHCS6Client();
+    return await client.createHashinal(options);
+  }
+
+  /**
+   * Register a dynamic hashinal with combined inscription and registry creation
+   * This is the main method for creating and updating dynamic hashinals
+   */
+  async register(
+    options: HCS6RegisterOptions
+  ): Promise<HCS6CreateHashinalResponse> {
+    const client = await this.getHCS6Client();
+    return await client.register(options);
+  }
+
+  /**
+   * Submit a raw message to an HCS-6 topic
+   */
+  async submitMessage(
+    topicId: string,
+    payload: any
+  ): Promise<any> {
+    const client = await this.getHCS6Client();
+    return await client.submitMessage(topicId, payload);
+  }
+
+  /**
+   * Get topic info from mirror node
+   */
+  async getTopicInfo(topicId: string): Promise<any> {
+    const client = await this.getHCS6Client();
+    return await client.getTopicInfo(topicId);
+  }
+
+  /**
+   * Close the HCS-6 client
+   */
+  async close(): Promise<void> {
+    if (this.hcs6Client) {
+      this.hcs6Client.close();
+      this.hcs6Client = undefined;
+    }
+  }
+}

package/src/builders/hcs6/index.ts

@@ -0,0 +1 @@
+export * from './hcs6-builder';

package/src/builders/index.ts

@@ -1,4 +1,5 @@
 export * from './types';
 export * from './hcs10/hcs10-builder';
 export * from './hcs2/hcs2-builder';
+export * from './hcs6/hcs6-builder';
 export * from './inscriber/inscriber-builder';

package/src/tools/inscriber/InscribeFromBufferTool.ts

@@ -53,7 +53,7 @@ const inscribeFromBufferSchema = z.object({
  */
 export class InscribeFromBufferTool extends BaseInscriberQueryTool<typeof inscribeFromBufferSchema> {
   name = 'inscribeFromBuffer';
-  description = 'Inscribe content from a buffer/base64 data to the Hedera network. IMPORTANT: Only use this tool when you have actual content to inscribe. The base64Data must contain valid, non-empty content (minimum 10 bytes). Useful for inscribing content that has been read into memory, including files accessed through MCP filesystem tools. Always verify the content exists and is meaningful before attempting inscription.';
+  description = 'Inscribe content that you already have (text, data, or files) to the Hedera network. Use this tool when you have content from: Wikipedia articles, MCP tool responses, text data, API responses, or any content you\'ve retrieved. Convert your content to base64 first. DO NOT use inscribeFromUrl for web page content - use this tool instead after retrieving the actual content.';
 
   get specificInputSchema() {
     return inscribeFromBufferSchema;

package/src/tools/inscriber/InscribeFromUrlTool.ts

@@ -42,7 +42,7 @@ const inscribeFromUrlSchema = z.object({
  */
 export class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeFromUrlSchema> {
   name = 'inscribeFromUrl';
-  description = 'Inscribe content from a URL to the Hedera network. IMPORTANT: Only use this tool when you have a valid URL pointing to actual content. The URL must be accessible and return meaningful data. The tool will validate that the content exists and is not empty before inscription.';
+  description = 'Inscribe content directly from a URL that points to a downloadable file (PDF, image, JSON, etc). DO NOT use this for web pages like Wikipedia, Twitter, or GitHub pages. This tool is ONLY for direct file URLs like https://example.com/document.pdf or https://api.example.com/data.json. For content you already have (from Wikipedia, MCP tools, or text), use inscribeFromBuffer instead.';
 
   get specificInputSchema() {
     return inscribeFromUrlSchema;