@hashgraphonline/standards-agent-kit 0.0.37 → 0.2.0

package/dist/es/plugins/hedera/HbarPricePlugin.d.ts

@@ -1,45 +1,17 @@
-import { StructuredTool } from '@langchain/core/tools';
-import { z } from 'zod';
-import { IPlugin } from '../PluginInterface';
+import { BasePlugin, GenericPluginContext, HederaTool } from 'hedera-agent-kit';
+export { HederaGetHbarPriceTool as GetHbarPriceTool } from 'hedera-agent-kit';
 /**
- * A Langchain tool to get the current HBAR price in USD.
- */
-export declare class GetHbarPriceTool extends StructuredTool {
-    name: string;
-    description: string;
-    schema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
-    /**
-     * DISCLAIMER: THIS TOOL USES THE EXCHANGE RATE ENDPOINT FROM THE MIRROR NODE, AND IT IS NOT GUARANTEED TO BE ACCURATE.
-     * USE AN ORACLE OR OTHER SOURCES FOR PRODUCTION USE WHERE PRICE IS IMPORTANT.
-     * Retrieves the current price of HBAR in USD from the Hedera Mirror Node.
-     * @returns A promise that resolves to a string containing the current HBAR price in USD.
-     */
-    protected _call(): Promise<string>;
-}
-/**
- * DISCLAIMER: THIS PLUGIN USES THE EXCHANGE RATE ENDPOINT FROM THE MIRROR NODE, AND IT IS NOT GUARANTEED TO BE ACCURATE.
- * USE AN ORACLE OR OTHER SOURCES FOR PRODUCTION USE WHERE PRICE IS IMPORTANT.
  * Plugin to provide tools related to Hedera network information, like HBAR price.
+ * Uses the built-in HederaGetHbarPriceTool from hedera-agent-kit.
  */
-export declare class HbarPricePlugin implements IPlugin {
+export declare class HbarPricePlugin extends BasePlugin<GenericPluginContext> {
     id: string;
     name: string;
     description: string;
     version: string;
     author: string;
     private tools;
-    constructor();
-    /**
-     * Initializes the plugin. Currently no specific initialization needed.
-     */
-    initialize(): Promise<void>;
-    /**
-     * Returns the tools provided by this plugin.
-     * @returns An array containing the GetHbarPriceTool.
-     */
-    getTools(): StructuredTool[];
-    /**
-     * Cleans up resources. Currently no cleanup needed.
-     */
-    cleanup(): Promise<void>;
+    initialize(context: GenericPluginContext): Promise<void>;
+    private initializeTools;
+    getTools(): HederaTool[];
 }

package/dist/es/plugins/index.d.ts

@@ -1,8 +1,3 @@
 export * from './PluginInterface';
 export * from './PluginRegistry';
-export * from './BasePlugin';
-export * from './PluginLoader';
 export * from './hedera/HbarPricePlugin';
-export * from './GenericPlugin';
-export * from './openconvai';
-export * from './HCS10Plugin';

package/dist/es/plugins/weather/index.d.ts

@@ -1,16 +1,17 @@
-import { GenericPlugin, GenericPluginContext } from '../../../src/plugins';
-import { StructuredTool } from '@langchain/core/tools';
+import { BasePlugin, GenericPluginContext, HederaTool } from 'hedera-agent-kit';
 /**
  * Weather API Plugin for the Standards Agent Kit
+ * Uses BaseHederaQueryTool for consistent tool architecture
  */
-export default class WeatherPlugin extends GenericPlugin {
+export default class WeatherPlugin extends BasePlugin<GenericPluginContext> {
     id: string;
     name: string;
     description: string;
     version: string;
     author: string;
-    namespace: string;
     private apiKey?;
+    private tools;
     initialize(context: GenericPluginContext): Promise<void>;
-    getTools(): StructuredTool[];
+    private initializeTools;
+    getTools(): HederaTool[];
 }

package/dist/es/standards-agent-kit.es.js

@@ -1,7 +1,7 @@
-import { HCS10Client } from "./standards-agent-kit.es2.js";
-import { RegisterAgentTool } from "./standards-agent-kit.es3.js";
-import { SendMessageTool } from "./standards-agent-kit.es4.js";
-import { ConnectionTool } from "./standards-agent-kit.es5.js";
+import { HCS10Builder } from "./standards-agent-kit.es2.js";
+import { HCS10Client } from "./standards-agent-kit.es3.js";
+import { BaseHCS10QueryTool, BaseHCS10TransactionTool } from "./standards-agent-kit.es4.js";
+import { RegisterAgentTool } from "./standards-agent-kit.es5.js";
 import { SendMessageToConnectionTool } from "./standards-agent-kit.es6.js";
 import { InitiateConnectionTool } from "./standards-agent-kit.es7.js";
 import { ListConnectionsTool } from "./standards-agent-kit.es8.js";
@@ -14,37 +14,29 @@ import { RetrieveProfileTool } from "./standards-agent-kit.es14.js";
 import { ListUnapprovedConnectionRequestsTool } from "./standards-agent-kit.es15.js";
 import { OpenConvaiState } from "./standards-agent-kit.es16.js";
 import { initializeStandardsAgentKit } from "./standards-agent-kit.es17.js";
-import { PluginRegistry } from "./standards-agent-kit.es18.js";
-import { BasePlugin } from "./standards-agent-kit.es19.js";
-import { PluginLoader } from "./standards-agent-kit.es20.js";
-import { GetHbarPriceTool, HbarPricePlugin } from "./standards-agent-kit.es21.js";
-import { GenericPlugin } from "./standards-agent-kit.es22.js";
-import { OpenConvAIPlugin } from "./standards-agent-kit.es23.js";
-import { HCS10Plugin } from "./standards-agent-kit.es24.js";
+import { BasePlugin, HederaGetHbarPriceTool, PluginRegistry } from "hedera-agent-kit";
+import { HbarPricePlugin } from "./standards-agent-kit.es18.js";
 export {
   AcceptConnectionRequestTool,
+  BaseHCS10QueryTool,
+  BaseHCS10TransactionTool,
   BasePlugin,
   CheckMessagesTool,
   ConnectionMonitorTool,
-  ConnectionTool,
   FindRegistrationsTool,
-  GenericPlugin,
-  GetHbarPriceTool,
+  HederaGetHbarPriceTool as GetHbarPriceTool,
+  HCS10Builder,
   HCS10Client,
-  HCS10Plugin,
   HbarPricePlugin,
   InitiateConnectionTool,
   ListConnectionsTool,
   ListUnapprovedConnectionRequestsTool,
   ManageConnectionRequestsTool,
-  OpenConvAIPlugin,
   OpenConvaiState,
-  PluginLoader,
   PluginRegistry,
   RegisterAgentTool,
   RetrieveProfileTool,
   SendMessageToConnectionTool,
-  SendMessageTool,
   initializeStandardsAgentKit
 };
 //# sourceMappingURL=standards-agent-kit.es.js.map

package/dist/es/standards-agent-kit.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"standards-agent-kit.es.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;"}

package/dist/es/standards-agent-kit.es10.js

@@ -1,90 +1,43 @@
-import { StructuredTool } from "@langchain/core/tools";
 import { z } from "zod";
-import { AIAgentCapability, Logger } from "@hashgraphonline/standards-sdk";
-class FindRegistrationsTool extends StructuredTool {
-  constructor({ hcsClient, ...rest }) {
-    super(rest);
+import { AIAgentCapability } from "@hashgraphonline/standards-sdk";
+import { BaseHCS10QueryTool } from "./standards-agent-kit.es4.js";
+const FindRegistrationsZodSchema = z.object({
+  accountId: z.string().optional().describe(
+    "Optional: Filter registrations by a specific Hedera account ID (e.g., 0.0.12345)."
+  ),
+  tags: z.array(z.nativeEnum(AIAgentCapability)).optional().describe(
+    "Optional: Filter registrations by a list of tags (API filter only)."
+  )
+});
+class FindRegistrationsTool extends BaseHCS10QueryTool {
+  constructor(params) {
+    super(params);
     this.name = "find_registrations";
     this.description = "Searches the configured agent registry for HCS-10 agents. You can filter by account ID or tags. Returns basic registration info.";
-    this.schema = z.object({
-      accountId: z.string().optional().describe(
-        "Optional: Filter registrations by a specific Hedera account ID (e.g., 0.0.12345)."
-      ),
-      tags: z.array(z.nativeEnum(AIAgentCapability)).optional().describe(
-        "Optional: Filter registrations by a list of tags (API filter only)."
-      )
-    });
-    this.hcsClient = hcsClient;
-    this.logger = Logger.getInstance({ module: "FindRegistrationsTool" });
+    this.specificInputSchema = FindRegistrationsZodSchema;
   }
-  async _call({
+  async executeQuery({
     accountId,
     tags
   }) {
-    this.logger.info(
-      "Searching registrations with filters - Account ID",
-      JSON.stringify({
-        accountId,
-        tags
-      })
-    );
-    const options = {};
+    const hcs10Builder = this.hcs10Builder;
+    const params = {};
     if (accountId) {
-      options.accountId = accountId;
+      params.accountId = accountId;
     }
-    if (tags && tags.length > 0) {
-      options.tags = tags;
+    if (tags) {
+      params.tags = tags;
     }
-    options.network = this.hcsClient.getNetwork();
-    try {
-      if (!this.hcsClient.standardClient) {
-        throw new Error(
-          "Standard SDK client instance is not available in HCS10Client wrapper."
-        );
-      }
-      const result = await this.hcsClient.standardClient.findRegistrations(
-        options
-      );
-      if (!result.success || result.error) {
-        return `Error finding registrations: ${result.error || "Unknown error"}`;
-      }
-      if (!result.registrations || result.registrations.length === 0) {
-        return "No registrations found matching the criteria.";
-      }
-      let output = `Found ${result.registrations.length} registration(s):
-`;
-      result.registrations.forEach((reg, index) => {
-        const metadata = reg.metadata;
-        output += `${index + 1}. Name: ${metadata.alias || "N/A"}
-`;
-        output += `Description: ${metadata.bio || "N/A"}
-`;
-        output += `   Account ID: ${reg.accountId}
-`;
-        output += `   Status: ${reg.status}
-`;
-        output += `   Model: ${metadata.properties?.model || "N/A"}
-`;
-        if (metadata.properties?.capabilities && metadata.properties.capabilities.length > 0) {
-          output += `   Capabilities: ${metadata.properties.capabilities.join(", ")}
-`;
-        }
-        if (metadata.properties) {
-          output += `   Properties: ${JSON.stringify(metadata.properties)}
-`;
-        }
-        output += `   Inbound Topic: ${reg.inboundTopicId}
-`;
-        output += `   Outbound Topic: ${reg.outboundTopicId}
-`;
-        output += `   Created At: ${reg.createdAt}
-`;
-      });
-      return output.trim();
-    } catch (error) {
-      this.logger.error(`Failed to execute findRegistrations: ${error}`);
-      return `Error searching registrations: ${error instanceof Error ? error.message : String(error)}`;
+    await hcs10Builder.findRegistrations(params);
+    const result = await hcs10Builder.execute();
+    if (result.success && "rawResult" in result && result.rawResult) {
+      const raw = result.rawResult;
+      return {
+        success: true,
+        data: raw.formattedOutput || raw.message || "Registrations searched"
+      };
     }
+    return result;
   }
 }
 export {

package/dist/es/standards-agent-kit.es10.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es10.js","sources":["../../src/tools/FindRegistrationsTool.ts"],"sourcesContent":["import { StructuredTool, ToolParams } from '@langchain/core/tools';\nimport { z } from 'zod';\nimport { HCS10Client } from '../hcs10/HCS10Client';\nimport {\n  AIAgentCapability,\n  Logger,\n  RegistrationSearchOptions,\n} from '@hashgraphonline/standards-sdk';\n\nexport interface FindRegistrationsToolParams extends ToolParams {\n  hcsClient: HCS10Client;\n}\n\n/**\n * A tool to search for registered HCS-10 agents using the configured registry.\n */\nexport class FindRegistrationsTool extends StructuredTool {\n  name = 'find_registrations';\n  description =\n    'Searches the configured agent registry for HCS-10 agents. You can filter by account ID or tags. Returns basic registration info.';\n  schema = z.object({\n    accountId: z\n      .string()\n      .optional()\n      .describe(\n        'Optional: Filter registrations by a specific Hedera account ID (e.g., 0.0.12345).'\n      ),\n    tags: z\n      .array(z.nativeEnum(AIAgentCapability))\n      .optional()\n      .describe(\n        'Optional: Filter registrations by a list of tags (API filter only).'\n      ),\n  });\n\n  private hcsClient: HCS10Client;\n  private logger: Logger;\n\n  constructor({ hcsClient, ...rest }: FindRegistrationsToolParams) {\n    super(rest);\n    this.hcsClient = hcsClient;\n    this.logger = Logger.getInstance({ module: 'FindRegistrationsTool' });\n  }\n\n  protected async _call({\n    accountId,\n    tags,\n  }: z.infer<this['schema']>): Promise<string> {\n    this.logger.info(\n      'Searching registrations with filters - Account ID',\n      JSON.stringify({\n        accountId,\n        tags,\n      })\n    );\n\n    const options: RegistrationSearchOptions = {};\n    if (accountId) {\n      options.accountId = accountId;\n    }\n    if (tags && tags.length > 0) {\n      options.tags = tags;\n    }\n    options.network = this.hcsClient.getNetwork();\n\n    try {\n      if (!this.hcsClient.standardClient) {\n        throw new Error(\n          'Standard SDK client instance is not available in HCS10Client wrapper.'\n        );\n      }\n      const result = await this.hcsClient.standardClient.findRegistrations(\n        options\n      );\n\n      if (!result.success || result.error) {\n        return `Error finding registrations: ${\n          result.error || 'Unknown error'\n        }`;\n      }\n\n      if (!result.registrations || result.registrations.length === 0) {\n        return 'No registrations found matching the criteria.';\n      }\n\n      // Format the results based on available data from RegistrationSearchResult\n      let output = `Found ${result.registrations.length} registration(s):\\n`;\n      result.registrations.forEach((reg, index: number) => {\n        const metadata = reg.metadata;\n        output += `${index + 1}. Name: ${metadata.alias || 'N/A'}\\n`;\n        output += `Description: ${metadata.bio || 'N/A'}\\n`;\n        output += `   Account ID: ${reg.accountId}\\n`;\n        output += `   Status: ${reg.status}\\n`;\n        output += `   Model: ${metadata.properties?.model || 'N/A'}\\n`;\n        if (metadata.properties?.capabilities && metadata.properties.capabilities.length > 0) {\n          output += `   Capabilities: ${metadata.properties.capabilities.join(', ')}\\n`;\n        }\n        if (metadata.properties) {\n          output += `   Properties: ${JSON.stringify(metadata.properties)}\\n`;\n        }\n        output += `   Inbound Topic: ${reg.inboundTopicId}\\n`;\n        output += `   Outbound Topic: ${reg.outboundTopicId}\\n`;\n        output += `   Created At: ${reg.createdAt}\\n`;\n      });\n\n      return output.trim();\n    } catch (error) {\n      this.logger.error(`Failed to execute findRegistrations: ${error}`);\n      return `Error searching registrations: ${\n        error instanceof Error ? error.message : String(error)\n      }`;\n    }\n  }\n}\n"],"names":[],"mappings":";;;AAgBO,MAAM,8BAA8B,eAAe;AAAA,EAsBxD,YAAY,EAAE,WAAW,GAAG,QAAqC;AAC/D,UAAM,IAAI;AAtBL,SAAA,OAAA;AAEL,SAAA,cAAA;AACF,SAAA,SAAS,EAAE,OAAO;AAAA,MAChB,WAAW,EACR,SACA,SACA,EAAA;AAAA,QACC;AAAA,MACF;AAAA,MACF,MAAM,EACH,MAAM,EAAE,WAAW,iBAAiB,CAAC,EACrC,SAAA,EACA;AAAA,QACC;AAAA,MAAA;AAAA,IACF,CACH;AAOC,SAAK,YAAY;AACjB,SAAK,SAAS,OAAO,YAAY,EAAE,QAAQ,yBAAyB;AAAA,EAAA;AAAA,EAGtE,MAAgB,MAAM;AAAA,IACpB;AAAA,IACA;AAAA,EAAA,GAC2C;AAC3C,SAAK,OAAO;AAAA,MACV;AAAA,MACA,KAAK,UAAU;AAAA,QACb;AAAA,QACA;AAAA,MACD,CAAA;AAAA,IACH;AAEA,UAAM,UAAqC,CAAC;AAC5C,QAAI,WAAW;AACb,cAAQ,YAAY;AAAA,IAAA;AAElB,QAAA,QAAQ,KAAK,SAAS,GAAG;AAC3B,cAAQ,OAAO;AAAA,IAAA;AAET,YAAA,UAAU,KAAK,UAAU,WAAW;AAExC,QAAA;AACE,UAAA,CAAC,KAAK,UAAU,gBAAgB;AAClC,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AAAA,MAAA;AAEF,YAAM,SAAS,MAAM,KAAK,UAAU,eAAe;AAAA,QACjD;AAAA,MACF;AAEA,UAAI,CAAC,OAAO,WAAW,OAAO,OAAO;AAC5B,eAAA,gCACL,OAAO,SAAS,eAClB;AAAA,MAAA;AAGF,UAAI,CAAC,OAAO,iBAAiB,OAAO,cAAc,WAAW,GAAG;AACvD,eAAA;AAAA,MAAA;AAIT,UAAI,SAAS,SAAS,OAAO,cAAc,MAAM;AAAA;AACjD,aAAO,cAAc,QAAQ,CAAC,KAAK,UAAkB;AACnD,cAAM,WAAW,IAAI;AACrB,kBAAU,GAAG,QAAQ,CAAC,WAAW,SAAS,SAAS,KAAK;AAAA;AAC9C,kBAAA,gBAAgB,SAAS,OAAO,KAAK;AAAA;AACrC,kBAAA,kBAAkB,IAAI,SAAS;AAAA;AAC/B,kBAAA,cAAc,IAAI,MAAM;AAAA;AAClC,kBAAU,aAAa,SAAS,YAAY,SAAS,KAAK;AAAA;AAC1D,YAAI,SAAS,YAAY,gBAAgB,SAAS,WAAW,aAAa,SAAS,GAAG;AACpF,oBAAU,oBAAoB,SAAS,WAAW,aAAa,KAAK,IAAI,CAAC;AAAA;AAAA,QAAA;AAE3E,YAAI,SAAS,YAAY;AACvB,oBAAU,kBAAkB,KAAK,UAAU,SAAS,UAAU,CAAC;AAAA;AAAA,QAAA;AAEvD,kBAAA,qBAAqB,IAAI,cAAc;AAAA;AACvC,kBAAA,sBAAsB,IAAI,eAAe;AAAA;AACzC,kBAAA,kBAAkB,IAAI,SAAS;AAAA;AAAA,MAAA,CAC1C;AAED,aAAO,OAAO,KAAK;AAAA,aACZ,OAAO;AACd,WAAK,OAAO,MAAM,wCAAwC,KAAK,EAAE;AACjE,aAAO,kCACL,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CACvD;AAAA,IAAA;AAAA,EACF;AAEJ;"}
+{"version":3,"file":"standards-agent-kit.es10.js","sources":["../../src/tools/hcs10/FindRegistrationsTool.ts"],"sourcesContent":["import { z } from 'zod';\nimport { AIAgentCapability } from '@hashgraphonline/standards-sdk';\nimport { BaseHCS10QueryTool } from './base-hcs10-tools';\nimport { HCS10QueryToolParams } from './hcs10-tool-params';\n\n/**\n * A tool to search for registered HCS-10 agents using the configured registry.\n */\nconst FindRegistrationsZodSchema = z.object({\n  accountId: z\n    .string()\n    .optional()\n    .describe(\n      'Optional: Filter registrations by a specific Hedera account ID (e.g., 0.0.12345).'\n    ),\n  tags: z\n    .array(z.nativeEnum(AIAgentCapability))\n    .optional()\n    .describe(\n      'Optional: Filter registrations by a list of tags (API filter only).'\n    ),\n});\n\nexport class FindRegistrationsTool extends BaseHCS10QueryTool<\n  typeof FindRegistrationsZodSchema\n> {\n  name = 'find_registrations';\n  description =\n    'Searches the configured agent registry for HCS-10 agents. You can filter by account ID or tags. Returns basic registration info.';\n  specificInputSchema = FindRegistrationsZodSchema;\n  constructor(params: HCS10QueryToolParams) {\n    super(params);\n  }\n\n  protected async executeQuery({\n    accountId,\n    tags,\n  }: z.infer<typeof FindRegistrationsZodSchema>): Promise<unknown> {\n    const hcs10Builder = this.hcs10Builder;\n    const params: { accountId?: string; tags?: number[] } = {};\n    if (accountId) {\n      params.accountId = accountId;\n    }\n    if (tags) {\n      params.tags = tags;\n    }\n    await hcs10Builder.findRegistrations(params);\n\n    const result = await hcs10Builder.execute();\n\n    if (result.success && 'rawResult' in result && result.rawResult) {\n      const raw = result.rawResult as {\n        formattedOutput?: string;\n        message?: string;\n      };\n      return {\n        success: true,\n        data: raw.formattedOutput || raw.message || 'Registrations searched',\n      };\n    }\n\n    return result;\n  }\n}"],"names":[],"mappings":";;;AAQA,MAAM,6BAA6B,EAAE,OAAO;AAAA,EAC1C,WAAW,EACR,SACA,WACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,MAAM,EACH,MAAM,EAAE,WAAW,iBAAiB,CAAC,EACrC,SAAA,EACA;AAAA,IACC;AAAA,EAAA;AAEN,CAAC;AAEM,MAAM,8BAA8B,mBAEzC;AAAA,EAKA,YAAY,QAA8B;AACxC,UAAM,MAAM;AALd,SAAA,OAAO;AACP,SAAA,cACE;AACF,SAAA,sBAAsB;AAAA,EAGtB;AAAA,EAEA,MAAgB,aAAa;AAAA,IAC3B;AAAA,IACA;AAAA,EAAA,GAC+D;AAC/D,UAAM,eAAe,KAAK;AAC1B,UAAM,SAAkD,CAAA;AACxD,QAAI,WAAW;AACb,aAAO,YAAY;AAAA,IACrB;AACA,QAAI,MAAM;AACR,aAAO,OAAO;AAAA,IAChB;AACA,UAAM,aAAa,kBAAkB,MAAM;AAE3C,UAAM,SAAS,MAAM,aAAa,QAAA;AAElC,QAAI,OAAO,WAAW,eAAe,UAAU,OAAO,WAAW;AAC/D,YAAM,MAAM,OAAO;AAInB,aAAO;AAAA,QACL,SAAS;AAAA,QACT,MAAM,IAAI,mBAAmB,IAAI,WAAW;AAAA,MAAA;AAAA,IAEhD;AAEA,WAAO;AAAA,EACT;AACF;"}