@hashgraphonline/standards-agent-kit 0.0.17 → 0.0.19

package/dist/plugins/BasePlugin.js

@@ -0,0 +1,19 @@
+class n {
+  /**
+   * Initialize the plugin with the provided context
+   * @param context The context containing shared resources
+   */
+  async initialize(a) {
+    this.context = a;
+  }
+  /**
+   * Clean up resources when the plugin is unloaded
+   * Default implementation does nothing
+   */
+  async cleanup() {
+  }
+}
+export {
+  n as BasePlugin
+};
+//# sourceMappingURL=BasePlugin.js.map

package/dist/plugins/BasePlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasePlugin.js","sources":["../../src/plugins/BasePlugin.ts"],"sourcesContent":["import { IPlugin, PluginContext } from './PluginInterface';\nimport { StructuredTool } from '@langchain/core/tools';\n\n/**\n * Base class for plugins to simplify implementation\n */\nexport abstract class BasePlugin implements IPlugin {\n  abstract id: string;\n  abstract name: string;\n  abstract description: string;\n  abstract version: string;\n  abstract author: string;\n\n  protected context!: PluginContext;\n\n  /**\n   * Initialize the plugin with the provided context\n   * @param context The context containing shared resources\n   */\n  async initialize(context: PluginContext): Promise<void> {\n    this.context = context;\n  }\n\n  /**\n   * Get the tools provided by this plugin\n   * @returns Array of tools provided by this plugin\n   */\n  abstract getTools(): StructuredTool[];\n\n  /**\n   * Clean up resources when the plugin is unloaded\n   * Default implementation does nothing\n   */\n  async cleanup(): Promise<void> {\n    // Default implementation does nothing\n  }\n}\n"],"names":["BasePlugin","context"],"mappings":"AAMO,MAAeA,EAA8B;AAAA;AAAA;AAAA;AAAA;AAAA,EAalD,MAAM,WAAWC,GAAuC;AACtD,SAAK,UAAUA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAajB,MAAM,UAAyB;AAAA,EAAA;AAGjC;"}

package/dist/plugins/PluginInterface.d.ts

@@ -0,0 +1,64 @@
+import { StructuredTool } from '@langchain/core/tools';
+import { HCS10Client } from '../hcs10/HCS10Client';
+import { IStateManager } from '../state/state-types';
+import { Logger } from '@hashgraphonline/standards-sdk';
+/**
+ * Context provided to plugins during initialization
+ */
+export interface PluginContext {
+    /**
+     * The HCS10Client instance
+     */
+    client: HCS10Client;
+    /**
+     * Optional state manager
+     */
+    stateManager?: IStateManager;
+    /**
+     * Logger instance
+     */
+    logger: Logger;
+    /**
+     * Configuration options
+     */
+    config: Record<string, any>;
+}
+/**
+ * Standard interface that all plugins must implement
+ */
+export interface IPlugin {
+    /**
+     * Unique identifier for the plugin
+     */
+    id: string;
+    /**
+     * Human-readable name of the plugin
+     */
+    name: string;
+    /**
+     * Description of what the plugin does
+     */
+    description: string;
+    /**
+     * Version of the plugin
+     */
+    version: string;
+    /**
+     * Author of the plugin
+     */
+    author: string;
+    /**
+     * Initialize the plugin with the provided context
+     * @param context The context containing shared resources
+     */
+    initialize(context: PluginContext): Promise<void>;
+    /**
+     * Get the tools provided by this plugin
+     * @returns Array of tools provided by this plugin
+     */
+    getTools(): StructuredTool[];
+    /**
+     * Clean up resources when the plugin is unloaded
+     */
+    cleanup?(): Promise<void>;
+}

package/dist/plugins/PluginLoader.d.ts

@@ -0,0 +1,38 @@
+import { PluginContext, IPlugin } from './PluginInterface';
+/**
+ * Configuration for loading a plugin
+ */
+export interface PluginLoadOptions {
+    /**
+     * Whether to initialize the plugin after loading
+     * @default true
+     */
+    initialize?: boolean;
+}
+/**
+ * Utility for loading plugins from different sources
+ */
+export declare class PluginLoader {
+    /**
+     * Load a plugin from a directory
+     * @param directory Path to the directory containing the plugin
+     * @param context Context to provide to the plugin during initialization
+     * @param options Options for loading the plugin
+     * @returns The loaded plugin instance
+     */
+    static loadFromDirectory(directory: string, context: PluginContext, options?: PluginLoadOptions): Promise<IPlugin>;
+    /**
+     * Load a plugin from an npm package
+     * @param packageName Name of the npm package containing the plugin
+     * @param context Context to provide to the plugin during initialization
+     * @param options Options for loading the plugin
+     * @returns The loaded plugin instance
+     */
+    static loadFromPackage(packageName: string, context: PluginContext, options?: PluginLoadOptions): Promise<IPlugin>;
+    /**
+     * Check if an object implements the IPlugin interface
+     * @param obj Object to check
+     * @returns true if the object implements IPlugin, false otherwise
+     */
+    private static isValidPlugin;
+}

package/dist/plugins/PluginLoader.js

@@ -0,0 +1,60 @@
+import * as l from "fs";
+import * as c from "path";
+class d {
+  /**
+   * Load a plugin from a directory
+   * @param directory Path to the directory containing the plugin
+   * @param context Context to provide to the plugin during initialization
+   * @param options Options for loading the plugin
+   * @returns The loaded plugin instance
+   */
+  static async loadFromDirectory(i, o, a = { initialize: !0 }) {
+    const t = c.join(i, "plugin.json");
+    if (!l.existsSync(t))
+      throw new Error(`Plugin manifest not found at ${t}`);
+    try {
+      const n = l.readFileSync(t, "utf8"), r = JSON.parse(n);
+      if (!r.id || !r.main)
+        throw new Error("Invalid plugin manifest: missing required fields (id, main)");
+      const e = c.join(i, r.main);
+      if (!l.existsSync(e))
+        throw new Error(`Plugin main file not found at ${e}`);
+      const f = await import(e), u = f.default || f[r.id];
+      if (!u)
+        throw new Error(`Could not find plugin class in ${e}`);
+      const s = new u();
+      if (!this.isValidPlugin(s))
+        throw new Error("Plugin does not implement the IPlugin interface correctly");
+      return a.initialize && await s.initialize(o), s;
+    } catch (n) {
+      throw new Error(`Failed to load plugin from directory ${i}: ${n instanceof Error ? n.message : String(n)}`);
+    }
+  }
+  /**
+   * Load a plugin from an npm package
+   * @param packageName Name of the npm package containing the plugin
+   * @param context Context to provide to the plugin during initialization
+   * @param options Options for loading the plugin
+   * @returns The loaded plugin instance
+   */
+  static async loadFromPackage(i, o, a = { initialize: !0 }) {
+    try {
+      const t = require.resolve(i), n = c.dirname(t);
+      return this.loadFromDirectory(n, o, a);
+    } catch (t) {
+      throw new Error(`Failed to load plugin from package ${i}: ${t instanceof Error ? t.message : String(t)}`);
+    }
+  }
+  /**
+   * Check if an object implements the IPlugin interface
+   * @param obj Object to check
+   * @returns true if the object implements IPlugin, false otherwise
+   */
+  static isValidPlugin(i) {
+    return i && typeof i.id == "string" && typeof i.name == "string" && typeof i.description == "string" && typeof i.version == "string" && typeof i.author == "string" && typeof i.initialize == "function" && typeof i.getTools == "function";
+  }
+}
+export {
+  d as PluginLoader
+};
+//# sourceMappingURL=PluginLoader.js.map

package/dist/plugins/PluginLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginLoader.js","sources":["../../src/plugins/PluginLoader.ts"],"sourcesContent":["import { PluginContext } from './PluginInterface';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { IPlugin } from './PluginInterface';\n\n/**\n * Configuration for loading a plugin\n */\nexport interface PluginLoadOptions {\n  /**\n   * Whether to initialize the plugin after loading\n   * @default true\n   */\n  initialize?: boolean;\n}\n\n/**\n * Utility for loading plugins from different sources\n */\nexport class PluginLoader {\n  /**\n   * Load a plugin from a directory\n   * @param directory Path to the directory containing the plugin\n   * @param context Context to provide to the plugin during initialization\n   * @param options Options for loading the plugin\n   * @returns The loaded plugin instance\n   */\n  static async loadFromDirectory(\n    directory: string, \n    context: PluginContext, \n    options: PluginLoadOptions = { initialize: true }\n  ): Promise<IPlugin> {\n    const manifestPath = path.join(directory, 'plugin.json');\n    \n    if (!fs.existsSync(manifestPath)) {\n      throw new Error(`Plugin manifest not found at ${manifestPath}`);\n    }\n    \n    try {\n      const manifestContent = fs.readFileSync(manifestPath, 'utf8');\n      const manifest = JSON.parse(manifestContent);\n      \n      // Validate manifest\n      if (!manifest.id || !manifest.main) {\n        throw new Error('Invalid plugin manifest: missing required fields (id, main)');\n      }\n      \n      // Load the plugin module\n      const mainPath = path.join(directory, manifest.main);\n      if (!fs.existsSync(mainPath)) {\n        throw new Error(`Plugin main file not found at ${mainPath}`);\n      }\n      \n      // Import the plugin module\n      const pluginModule = await import(mainPath);\n      const PluginClass = pluginModule.default || pluginModule[manifest.id];\n      \n      if (!PluginClass) {\n        throw new Error(`Could not find plugin class in ${mainPath}`);\n      }\n      \n      // Create an instance of the plugin\n      const plugin = new PluginClass();\n      \n      // Validate that it implements the IPlugin interface\n      if (!this.isValidPlugin(plugin)) {\n        throw new Error(`Plugin does not implement the IPlugin interface correctly`);\n      }\n      \n      // Initialize the plugin if requested\n      if (options.initialize) {\n        await plugin.initialize(context);\n      }\n      \n      return plugin;\n    } catch (error) {\n      throw new Error(`Failed to load plugin from directory ${directory}: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  }\n  \n  /**\n   * Load a plugin from an npm package\n   * @param packageName Name of the npm package containing the plugin\n   * @param context Context to provide to the plugin during initialization\n   * @param options Options for loading the plugin\n   * @returns The loaded plugin instance\n   */\n  static async loadFromPackage(\n    packageName: string, \n    context: PluginContext, \n    options: PluginLoadOptions = { initialize: true }\n  ): Promise<IPlugin> {\n    try {\n      // Resolve the package path\n      const packagePath = require.resolve(packageName);\n      const packageDir = path.dirname(packagePath);\n      \n      return this.loadFromDirectory(packageDir, context, options);\n    } catch (error) {\n      throw new Error(`Failed to load plugin from package ${packageName}: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  }\n  \n  /**\n   * Check if an object implements the IPlugin interface\n   * @param obj Object to check\n   * @returns true if the object implements IPlugin, false otherwise\n   */\n  private static isValidPlugin(obj: any): obj is IPlugin {\n    return (\n      obj &&\n      typeof obj.id === 'string' &&\n      typeof obj.name === 'string' &&\n      typeof obj.description === 'string' &&\n      typeof obj.version === 'string' &&\n      typeof obj.author === 'string' &&\n      typeof obj.initialize === 'function' &&\n      typeof obj.getTools === 'function'\n    );\n  }\n}\n"],"names":["PluginLoader","directory","context","options","manifestPath","path","fs","manifestContent","manifest","mainPath","pluginModule","PluginClass","plugin","error","packageName","packagePath","packageDir","obj"],"mappings":";;AAmBO,MAAMA,EAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQxB,aAAa,kBACXC,GACAC,GACAC,IAA6B,EAAE,YAAY,MACzB;AAClB,UAAMC,IAAeC,EAAK,KAAKJ,GAAW,aAAa;AAEvD,QAAI,CAACK,EAAG,WAAWF,CAAY;AAC7B,YAAM,IAAI,MAAM,gCAAgCA,CAAY,EAAE;AAG5D,QAAA;AACF,YAAMG,IAAkBD,EAAG,aAAaF,GAAc,MAAM,GACtDI,IAAW,KAAK,MAAMD,CAAe;AAG3C,UAAI,CAACC,EAAS,MAAM,CAACA,EAAS;AACtB,cAAA,IAAI,MAAM,6DAA6D;AAI/E,YAAMC,IAAWJ,EAAK,KAAKJ,GAAWO,EAAS,IAAI;AACnD,UAAI,CAACF,EAAG,WAAWG,CAAQ;AACzB,cAAM,IAAI,MAAM,iCAAiCA,CAAQ,EAAE;AAIvD,YAAAC,IAAe,MAAM,OAAOD,IAC5BE,IAAcD,EAAa,WAAWA,EAAaF,EAAS,EAAE;AAEpE,UAAI,CAACG;AACH,cAAM,IAAI,MAAM,kCAAkCF,CAAQ,EAAE;AAIxD,YAAAG,IAAS,IAAID,EAAY;AAG/B,UAAI,CAAC,KAAK,cAAcC,CAAM;AACtB,cAAA,IAAI,MAAM,2DAA2D;AAI7E,aAAIT,EAAQ,cACJ,MAAAS,EAAO,WAAWV,CAAO,GAG1BU;AAAA,aACAC,GAAO;AACd,YAAM,IAAI,MAAM,wCAAwCZ,CAAS,KAAKY,aAAiB,QAAQA,EAAM,UAAU,OAAOA,CAAK,CAAC,EAAE;AAAA,IAAA;AAAA,EAChI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUF,aAAa,gBACXC,GACAZ,GACAC,IAA6B,EAAE,YAAY,MACzB;AACd,QAAA;AAEI,YAAAY,IAAc,QAAQ,QAAQD,CAAW,GACzCE,IAAaX,EAAK,QAAQU,CAAW;AAE3C,aAAO,KAAK,kBAAkBC,GAAYd,GAASC,CAAO;AAAA,aACnDU,GAAO;AACd,YAAM,IAAI,MAAM,sCAAsCC,CAAW,KAAKD,aAAiB,QAAQA,EAAM,UAAU,OAAOA,CAAK,CAAC,EAAE;AAAA,IAAA;AAAA,EAChI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQF,OAAe,cAAcI,GAA0B;AAEnD,WAAAA,KACA,OAAOA,EAAI,MAAO,YAClB,OAAOA,EAAI,QAAS,YACpB,OAAOA,EAAI,eAAgB,YAC3B,OAAOA,EAAI,WAAY,YACvB,OAAOA,EAAI,UAAW,YACtB,OAAOA,EAAI,cAAe,cAC1B,OAAOA,EAAI,YAAa;AAAA,EAAA;AAG9B;"}

package/dist/plugins/PluginRegistry.d.ts

@@ -0,0 +1,47 @@
+import { IPlugin, PluginContext } from './PluginInterface';
+import { StructuredTool } from '@langchain/core/tools';
+/**
+ * Registry for managing plugins in the Standards Agent Kit
+ */
+export declare class PluginRegistry {
+    private plugins;
+    private context;
+    private logger;
+    /**
+     * Creates a new PluginRegistry instance
+     * @param context The context to provide to plugins during initialization
+     */
+    constructor(context: PluginContext);
+    /**
+     * Register a plugin with the registry
+     * @param plugin The plugin to register
+     * @throws Error if a plugin with the same ID is already registered
+     */
+    registerPlugin(plugin: IPlugin): Promise<void>;
+    /**
+     * Get a plugin by ID
+     * @param id The ID of the plugin to retrieve
+     * @returns The plugin, or undefined if not found
+     */
+    getPlugin(id: string): IPlugin | undefined;
+    /**
+     * Get all registered plugins
+     * @returns Array of all registered plugins
+     */
+    getAllPlugins(): IPlugin[];
+    /**
+     * Get all tools from all registered plugins
+     * @returns Array of all tools provided by registered plugins
+     */
+    getAllTools(): StructuredTool[];
+    /**
+     * Unregister a plugin
+     * @param id The ID of the plugin to unregister
+     * @returns true if the plugin was unregistered, false if it wasn't found
+     */
+    unregisterPlugin(id: string): Promise<boolean>;
+    /**
+     * Unregister all plugins
+     */
+    unregisterAllPlugins(): Promise<void>;
+}

package/dist/plugins/PluginRegistry.js

@@ -0,0 +1,71 @@
+class n {
+  /**
+   * Creates a new PluginRegistry instance
+   * @param context The context to provide to plugins during initialization
+   */
+  constructor(i) {
+    this.plugins = /* @__PURE__ */ new Map(), this.context = i, this.logger = i.logger;
+  }
+  /**
+   * Register a plugin with the registry
+   * @param plugin The plugin to register
+   * @throws Error if a plugin with the same ID is already registered
+   */
+  async registerPlugin(i) {
+    if (this.plugins.has(i.id))
+      throw new Error(`Plugin with ID ${i.id} is already registered`);
+    await i.initialize(this.context), this.plugins.set(i.id, i), this.logger.info(`Plugin registered: ${i.name} (${i.id}) v${i.version}`);
+  }
+  /**
+   * Get a plugin by ID
+   * @param id The ID of the plugin to retrieve
+   * @returns The plugin, or undefined if not found
+   */
+  getPlugin(i) {
+    return this.plugins.get(i);
+  }
+  /**
+   * Get all registered plugins
+   * @returns Array of all registered plugins
+   */
+  getAllPlugins() {
+    return Array.from(this.plugins.values());
+  }
+  /**
+   * Get all tools from all registered plugins
+   * @returns Array of all tools provided by registered plugins
+   */
+  getAllTools() {
+    return this.getAllPlugins().flatMap((i) => i.getTools());
+  }
+  /**
+   * Unregister a plugin
+   * @param id The ID of the plugin to unregister
+   * @returns true if the plugin was unregistered, false if it wasn't found
+   */
+  async unregisterPlugin(i) {
+    const r = this.plugins.get(i);
+    if (!r)
+      return !1;
+    if (r.cleanup)
+      try {
+        await r.cleanup();
+      } catch (t) {
+        this.logger.error(`Error during plugin cleanup: ${t}`);
+      }
+    const e = this.plugins.delete(i);
+    return e && this.logger.info(`Plugin unregistered: ${r.name} (${r.id})`), e;
+  }
+  /**
+   * Unregister all plugins
+   */
+  async unregisterAllPlugins() {
+    const i = Array.from(this.plugins.keys());
+    for (const r of i)
+      await this.unregisterPlugin(r);
+  }
+}
+export {
+  n as PluginRegistry
+};
+//# sourceMappingURL=PluginRegistry.js.map

package/dist/plugins/PluginRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginRegistry.js","sources":["../../src/plugins/PluginRegistry.ts"],"sourcesContent":["import { IPlugin, PluginContext } from './PluginInterface';\nimport { StructuredTool } from '@langchain/core/tools';\nimport { Logger } from '@hashgraphonline/standards-sdk';\n\n/**\n * Registry for managing plugins in the Standards Agent Kit\n */\nexport class PluginRegistry {\n  private plugins: Map<string, IPlugin> = new Map();\n  private context: PluginContext;\n  private logger: Logger;\n  \n  /**\n   * Creates a new PluginRegistry instance\n   * @param context The context to provide to plugins during initialization\n   */\n  constructor(context: PluginContext) {\n    this.context = context;\n    this.logger = context.logger;\n  }\n  \n  /**\n   * Register a plugin with the registry\n   * @param plugin The plugin to register\n   * @throws Error if a plugin with the same ID is already registered\n   */\n  async registerPlugin(plugin: IPlugin): Promise<void> {\n    if (this.plugins.has(plugin.id)) {\n      throw new Error(`Plugin with ID ${plugin.id} is already registered`);\n    }\n    \n    await plugin.initialize(this.context);\n    this.plugins.set(plugin.id, plugin);\n    this.logger.info(`Plugin registered: ${plugin.name} (${plugin.id}) v${plugin.version}`);\n  }\n  \n  /**\n   * Get a plugin by ID\n   * @param id The ID of the plugin to retrieve\n   * @returns The plugin, or undefined if not found\n   */\n  getPlugin(id: string): IPlugin | undefined {\n    return this.plugins.get(id);\n  }\n  \n  /**\n   * Get all registered plugins\n   * @returns Array of all registered plugins\n   */\n  getAllPlugins(): IPlugin[] {\n    return Array.from(this.plugins.values());\n  }\n  \n  /**\n   * Get all tools from all registered plugins\n   * @returns Array of all tools provided by registered plugins\n   */\n  getAllTools(): StructuredTool[] {\n    return this.getAllPlugins().flatMap(plugin => plugin.getTools());\n  }\n  \n  /**\n   * Unregister a plugin\n   * @param id The ID of the plugin to unregister\n   * @returns true if the plugin was unregistered, false if it wasn't found\n   */\n  async unregisterPlugin(id: string): Promise<boolean> {\n    const plugin = this.plugins.get(id);\n    if (!plugin) {\n      return false;\n    }\n    \n    if (plugin.cleanup) {\n      try {\n        await plugin.cleanup();\n      } catch (error) {\n        this.logger.error(`Error during plugin cleanup: ${error}`);\n      }\n    }\n    \n    const result = this.plugins.delete(id);\n    if (result) {\n      this.logger.info(`Plugin unregistered: ${plugin.name} (${plugin.id})`);\n    }\n    \n    return result;\n  }\n  \n  /**\n   * Unregister all plugins\n   */\n  async unregisterAllPlugins(): Promise<void> {\n    const pluginIds = Array.from(this.plugins.keys());\n    for (const id of pluginIds) {\n      await this.unregisterPlugin(id);\n    }\n  }\n}\n"],"names":["PluginRegistry","context","plugin","id","error","result","pluginIds"],"mappings":"AAOO,MAAMA,EAAe;AAAA;AAAA;AAAA;AAAA;AAAA,EAS1B,YAAYC,GAAwB;AAR5B,SAAA,8BAAoC,IAAI,GAS9C,KAAK,UAAUA,GACf,KAAK,SAASA,EAAQ;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQxB,MAAM,eAAeC,GAAgC;AACnD,QAAI,KAAK,QAAQ,IAAIA,EAAO,EAAE;AAC5B,YAAM,IAAI,MAAM,kBAAkBA,EAAO,EAAE,wBAAwB;AAG/D,UAAAA,EAAO,WAAW,KAAK,OAAO,GACpC,KAAK,QAAQ,IAAIA,EAAO,IAAIA,CAAM,GAC7B,KAAA,OAAO,KAAK,sBAAsBA,EAAO,IAAI,KAAKA,EAAO,EAAE,MAAMA,EAAO,OAAO,EAAE;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQxF,UAAUC,GAAiC;AAClC,WAAA,KAAK,QAAQ,IAAIA,CAAE;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO5B,gBAA2B;AACzB,WAAO,MAAM,KAAK,KAAK,QAAQ,QAAQ;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOzC,cAAgC;AAC9B,WAAO,KAAK,gBAAgB,QAAQ,CAAUD,MAAAA,EAAO,UAAU;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQjE,MAAM,iBAAiBC,GAA8B;AACnD,UAAMD,IAAS,KAAK,QAAQ,IAAIC,CAAE;AAClC,QAAI,CAACD;AACI,aAAA;AAGT,QAAIA,EAAO;AACL,UAAA;AACF,cAAMA,EAAO,QAAQ;AAAA,eACdE,GAAO;AACd,aAAK,OAAO,MAAM,gCAAgCA,CAAK,EAAE;AAAA,MAAA;AAI7D,UAAMC,IAAS,KAAK,QAAQ,OAAOF,CAAE;AACrC,WAAIE,KACG,KAAA,OAAO,KAAK,wBAAwBH,EAAO,IAAI,KAAKA,EAAO,EAAE,GAAG,GAGhEG;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAMT,MAAM,uBAAsC;AAC1C,UAAMC,IAAY,MAAM,KAAK,KAAK,QAAQ,MAAM;AAChD,eAAWH,KAAMG;AACT,YAAA,KAAK,iBAAiBH,CAAE;AAAA,EAChC;AAEJ;"}

package/dist/plugins/__tests__/BasePlugin.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/plugins/__tests__/PluginLoader.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/plugins/__tests__/PluginRegistry.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,13 @@
+import { BasePlugin } from '../../../src/plugins';
+import { StructuredTool } from '@langchain/core/tools';
+/**
+ * DeFi Integration Plugin for the Standards Agent Kit
+ */
+export default class DeFiPlugin extends BasePlugin {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    author: string;
+    getTools(): StructuredTool[];
+}

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

@@ -0,0 +1,45 @@
+import { StructuredTool } from '@langchain/core/tools';
+import { z } from 'zod';
+import { IPlugin } from '../PluginInterface';
+/**
+ * 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.
+ */
+export declare class HbarPricePlugin implements IPlugin {
+    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>;
+}

package/dist/plugins/hedera/HbarPricePlugin.js

@@ -0,0 +1,70 @@
+import { StructuredTool as a } from "../../node_modules/@langchain/core/dist/tools.js";
+import { z as e } from "zod";
+import n from "axios";
+const c = "https://mainnet.mirrornode.hedera.com/api/v1", u = e.object({
+  current_rate: e.object({
+    cent_equivalent: e.number(),
+    hbar_equivalent: e.number(),
+    expiration_time: e.number()
+  }),
+  next_rate: e.object({
+    cent_equivalent: e.number(),
+    hbar_equivalent: e.number(),
+    expiration_time: e.number()
+  }),
+  timestamp: e.string()
+});
+class l extends a {
+  constructor() {
+    super(...arguments), this.name = "getHbarPrice", this.description = "Retrieves the current price of HBAR in USD from the Hedera Mirror Node.", this.schema = e.object({});
+  }
+  // No input required for this tool
+  /**
+   * 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.
+   */
+  async _call() {
+    try {
+      const t = (await n.get(`${c}/network/exchangerate`)).data, o = u.safeParse(t);
+      if (!o.success)
+        throw console.error("Failed to parse exchange rate response:", o.error), new Error("Invalid API response format");
+      const { current_rate: s } = o.data;
+      return `The current price of HBAR is $${(s.cent_equivalent / s.hbar_equivalent / 100).toFixed(6)} USD.`;
+    } catch (r) {
+      console.error("Error fetching HBAR price:", r);
+      let t = "An unknown error occurred";
+      return n.isAxiosError(r) ? (t = r.message, r.response && (t += ` (Status: ${r.response.status})`)) : r instanceof Error && (t = r.message), `Failed to retrieve HBAR price: ${t}`;
+    }
+  }
+}
+class b {
+  constructor() {
+    this.id = "hedera-hbar-price", this.name = "Hedera HBAR Price Plugin", this.description = "Provides tools to interact with Hedera network data, specifically HBAR price.", this.version = "1.0.0", this.author = "Hedera Agent", this.tools = [new l()];
+  }
+  /**
+   * Initializes the plugin. Currently no specific initialization needed.
+   */
+  async initialize() {
+    return Promise.resolve();
+  }
+  /**
+   * Returns the tools provided by this plugin.
+   * @returns An array containing the GetHbarPriceTool.
+   */
+  getTools() {
+    return this.tools;
+  }
+  /**
+   * Cleans up resources. Currently no cleanup needed.
+   */
+  async cleanup() {
+    return Promise.resolve();
+  }
+}
+export {
+  l as GetHbarPriceTool,
+  b as HbarPricePlugin
+};
+//# sourceMappingURL=HbarPricePlugin.js.map

package/dist/plugins/hedera/HbarPricePlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HbarPricePlugin.js","sources":["../../../src/plugins/hedera/HbarPricePlugin.ts"],"sourcesContent":["import { StructuredTool } from '@langchain/core/tools';\nimport { z } from 'zod';\nimport { IPlugin /*, PluginContext */ } from '../PluginInterface';\nimport axios from 'axios'; // Use axios instead of node-fetch\n\nconst HEDERA_MIRROR_NODE_API = 'https://mainnet.mirrornode.hedera.com/api/v1';\n\n/**\n * Defines the schema for the HBAR price API response.\n */\nconst ExchangeRateResponseSchema = z.object({\n  current_rate: z.object({\n    cent_equivalent: z.number(),\n    hbar_equivalent: z.number(),\n    expiration_time: z.number(),\n  }),\n  next_rate: z.object({\n    cent_equivalent: z.number(),\n    hbar_equivalent: z.number(),\n    expiration_time: z.number(),\n  }),\n  timestamp: z.string(),\n});\n\n/**\n * A Langchain tool to get the current HBAR price in USD.\n */\n// Export the class for testing purposes\nexport class GetHbarPriceTool extends StructuredTool {\n  name = 'getHbarPrice';\n  description = 'Retrieves the current price of HBAR in USD from the Hedera Mirror Node.';\n  schema = z.object({}); // No input required for this tool\n\n  /**\n   * DISCLAIMER: THIS TOOL USES THE EXCHANGE RATE ENDPOINT FROM THE MIRROR NODE, AND IT IS NOT GUARANTEED TO BE ACCURATE.\n   * USE AN ORACLE OR OTHER SOURCES FOR PRODUCTION USE WHERE PRICE IS IMPORTANT.\n   * Retrieves the current price of HBAR in USD from the Hedera Mirror Node.\n   * @returns A promise that resolves to a string containing the current HBAR price in USD.\n   */\n  protected async _call(): Promise<string> {\n    try {\n      // Use axios.get instead of fetch\n      const response = await axios.get(`${HEDERA_MIRROR_NODE_API}/network/exchangerate`);\n\n      // Axios puts data directly in response.data\n      const data: unknown = response.data;\n\n      // Validate the response structure\n      const parsedData = ExchangeRateResponseSchema.safeParse(data);\n      if (!parsedData.success) {\n         console.error(\"Failed to parse exchange rate response:\", parsedData.error);\n         throw new Error('Invalid API response format');\n      }\n\n      const { current_rate } = parsedData.data;\n      const priceUsd = current_rate.cent_equivalent / current_rate.hbar_equivalent / 100;\n\n      return `The current price of HBAR is $${priceUsd.toFixed(6)} USD.`;\n    } catch (error) {\n      console.error('Error fetching HBAR price:', error);\n      // Handle axios errors specifically if needed, otherwise generic handling\n      let errorMessage = 'An unknown error occurred';\n      if (axios.isAxiosError(error)) {\n        errorMessage = error.message;\n        if (error.response) {\n          errorMessage += ` (Status: ${error.response.status})`;\n        }\n      } else if (error instanceof Error) {\n        errorMessage = error.message;\n      }\n      return `Failed to retrieve HBAR price: ${errorMessage}`;\n    }\n  }\n}\n\n\n/**\n * DISCLAIMER: THIS PLUGIN USES THE EXCHANGE RATE ENDPOINT FROM THE MIRROR NODE, AND IT IS NOT GUARANTEED TO BE ACCURATE.\n * USE AN ORACLE OR OTHER SOURCES FOR PRODUCTION USE WHERE PRICE IS IMPORTANT.\n * Plugin to provide tools related to Hedera network information, like HBAR price.\n */\nexport class HbarPricePlugin implements IPlugin {\n  id = 'hedera-hbar-price';\n  name = 'Hedera HBAR Price Plugin';\n  description = 'Provides tools to interact with Hedera network data, specifically HBAR price.';\n  version = '1.0.0';\n  author = 'Hedera Agent'; // Replace with actual author/team name if desired\n\n  private tools: StructuredTool[];\n\n  constructor() {\n    this.tools = [new GetHbarPriceTool()];\n  }\n\n  /**\n   * Initializes the plugin. Currently no specific initialization needed.\n   */\n  async initialize(): Promise<void> {\n    // No specific initialization required for this plugin yet\n    return Promise.resolve();\n  }\n\n  /**\n   * Returns the tools provided by this plugin.\n   * @returns An array containing the GetHbarPriceTool.\n   */\n  getTools(): StructuredTool[] {\n    return this.tools;\n  }\n\n  /**\n   * Cleans up resources. Currently no cleanup needed.\n   */\n  async cleanup(): Promise<void> {\n    // No cleanup necessary\n    return Promise.resolve();\n  }\n}"],"names":["HEDERA_MIRROR_NODE_API","ExchangeRateResponseSchema","z","GetHbarPriceTool","StructuredTool","data","axios","parsedData","current_rate","error","errorMessage","HbarPricePlugin"],"mappings":";;;AAKA,MAAMA,IAAyB,gDAKzBC,IAA6BC,EAAE,OAAO;AAAA,EAC1C,cAAcA,EAAE,OAAO;AAAA,IACrB,iBAAiBA,EAAE,OAAO;AAAA,IAC1B,iBAAiBA,EAAE,OAAO;AAAA,IAC1B,iBAAiBA,EAAE,OAAO;AAAA,EAAA,CAC3B;AAAA,EACD,WAAWA,EAAE,OAAO;AAAA,IAClB,iBAAiBA,EAAE,OAAO;AAAA,IAC1B,iBAAiBA,EAAE,OAAO;AAAA,IAC1B,iBAAiBA,EAAE,OAAO;AAAA,EAAA,CAC3B;AAAA,EACD,WAAWA,EAAE,OAAO;AACtB,CAAC;AAMM,MAAMC,UAAyBC,EAAe;AAAA,EAA9C,cAAA;AAAA,UAAA,GAAA,SAAA,GACE,KAAA,OAAA,gBACO,KAAA,cAAA,2EACL,KAAA,SAAAF,EAAE,OAAO,CAAA,CAAE;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQpB,MAAgB,QAAyB;AACnC,QAAA;AAKF,YAAMG,KAHW,MAAMC,EAAM,IAAI,GAAGN,CAAsB,uBAAuB,GAGlD,MAGzBO,IAAaN,EAA2B,UAAUI,CAAI;AACxD,UAAA,CAACE,EAAW;AACL,sBAAA,MAAM,2CAA2CA,EAAW,KAAK,GACnE,IAAI,MAAM,6BAA6B;AAG1C,YAAA,EAAE,cAAAC,MAAiBD,EAAW;AAGpC,aAAO,kCAFUC,EAAa,kBAAkBA,EAAa,kBAAkB,KAE9B,QAAQ,CAAC,CAAC;AAAA,aACpDC,GAAO;AACN,cAAA,MAAM,8BAA8BA,CAAK;AAEjD,UAAIC,IAAe;AACf,aAAAJ,EAAM,aAAaG,CAAK,KAC1BC,IAAeD,EAAM,SACjBA,EAAM,aACQC,KAAA,aAAaD,EAAM,SAAS,MAAM,QAE3CA,aAAiB,UAC1BC,IAAeD,EAAM,UAEhB,kCAAkCC,CAAY;AAAA,IAAA;AAAA,EACvD;AAEJ;AAQO,MAAMC,EAAmC;AAAA,EAS9C,cAAc;AART,SAAA,KAAA,qBACE,KAAA,OAAA,4BACO,KAAA,cAAA,iFACJ,KAAA,UAAA,SACD,KAAA,SAAA,gBAKP,KAAK,QAAQ,CAAC,IAAIR,GAAkB;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAMtC,MAAM,aAA4B;AAEhC,WAAO,QAAQ,QAAQ;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOzB,WAA6B;AAC3B,WAAO,KAAK;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAMd,MAAM,UAAyB;AAE7B,WAAO,QAAQ,QAAQ;AAAA,EAAA;AAE3B;"}

package/dist/plugins/hedera/__tests__/HbarPricePlugin.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/plugins/index.d.ts

@@ -0,0 +1,5 @@
+export * from './PluginInterface';
+export * from './PluginRegistry';
+export * from './BasePlugin';
+export * from './PluginLoader';
+export * from './hedera/HbarPricePlugin';

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

@@ -0,0 +1,15 @@
+import { BasePlugin, PluginContext } from '../../../src/plugins';
+import { StructuredTool } from '@langchain/core/tools';
+/**
+ * Weather API Plugin for the Standards Agent Kit
+ */
+export default class WeatherPlugin extends BasePlugin {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    author: string;
+    private apiKey?;
+    initialize(context: PluginContext): Promise<void>;
+    getTools(): StructuredTool[];
+}

package/dist/src/init.d.ts

@@ -51,9 +51,9 @@ export interface HCS10Tools {
  * @param options - Initialization options
  * @returns Object containing hcs10Client and requested tools
  */
-export declare function initializeHCS10Client(options?: HCS10InitializationOptions): Promise<{
+export declare function initializeHCS10Client(options?: HCS10InitializationOptions): {
     hcs10Client: HCS10Client;
     monitoringClient?: HCS10Client;
     tools: Partial<HCS10Tools>;
     stateManager: IStateManager;
-}>;
+};

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

@@ -0,0 +1,45 @@
+import { StructuredTool } from '@langchain/core/tools';
+import { z } from 'zod';
+import { IPlugin } from '../PluginInterface';
+/**
+ * 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.
+ */
+export declare class HbarPricePlugin implements IPlugin {
+    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>;
+}

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

@@ -2,3 +2,4 @@ export * from './PluginInterface';
 export * from './PluginRegistry';
 export * from './BasePlugin';
 export * from './PluginLoader';
+export * from './hedera/HbarPricePlugin';

package/dist/src/tools/CheckMessagesTool.d.ts

@@ -7,21 +7,28 @@ export interface CheckMessagesToolParams extends ToolParams {
     stateManager: IStateManager;
 }
 /**
- * A tool to check for new messages on an active HCS-10 connection topic.
+ * A tool to check for new messages on an active HCS-10 connection topic,
+ * or optionally fetch the latest messages regardless of timestamp.
  */
 export declare class CheckMessagesTool extends StructuredTool {
     name: string;
     description: string;
     schema: z.ZodObject<{
         targetIdentifier: z.ZodString;
+        fetchLatest: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        lastMessagesCount: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         targetIdentifier: string;
+        fetchLatest: boolean;
+        lastMessagesCount?: number | undefined;
     }, {
         targetIdentifier: string;
+        fetchLatest?: boolean | undefined;
+        lastMessagesCount?: number | undefined;
     }>;
     hcsClient: HCS10Client;
     private stateManager;
     private logger;
     constructor({ hcsClient, stateManager, ...rest }: CheckMessagesToolParams);
-    protected _call({ targetIdentifier, }: z.infer<this['schema']>): Promise<string>;
+    protected _call({ targetIdentifier, fetchLatest, lastMessagesCount, }: z.infer<this['schema']>): Promise<string>;
 }

package/dist/src/utils/state-tools.d.ts

@@ -0,0 +1,23 @@
+import { HCS10Client, AgentBuilder, Logger } from '@hashgraphonline/standards-sdk';
+export declare const MIN_REQUIRED_USD = 2;
+export declare const MIN_REQUIRED_HBAR_USD = 10;
+export declare const ENV_FILE_PATH: string;
+export interface AgentData {
+    accountId: string;
+    operatorId: string;
+    inboundTopicId: string;
+    outboundTopicId: string;
+    client: HCS10Client;
+}
+export interface RegistrationProgressData {
+    registered: boolean;
+    accountId?: string;
+    privateKey?: string;
+    publicKey?: string;
+    inboundTopicId?: string;
+    outboundTopicId?: string;
+}
+export declare function ensureAgentHasEnoughHbar(logger: Logger, baseClient: HCS10Client, accountId: string, agentName: string): Promise<void>;
+export declare function getAgentFromEnv(logger: Logger, baseClient: HCS10Client, agentName: string, envPrefix: string): Promise<AgentData | null>;
+export declare function createAgent(logger: Logger, baseClient: HCS10Client, agentName: string, agentBuilder: AgentBuilder, envPrefix: string): Promise<AgentData | null>;
+export declare function updateEnvFile(envFilePath: string, variables: Record<string, string>): Promise<void>;

package/dist/state/index.d.ts

@@ -0,0 +1,2 @@
+export * from './open-convai-state';
+export * from './state-types';