@hashgraphonline/conversational-agent 0.0.1

package/dist/esm/index5.js

@@ -0,0 +1,217 @@
+import { ServerSigner, getAllHederaCorePlugins, HederaConversationalAgent } from "hedera-agent-kit";
+import { HCS10Plugin } from "./index2.js";
+import { HCS2Plugin } from "./index3.js";
+import { InscribePlugin } from "./index4.js";
+import { OpenConvaiState } from "@hashgraphonline/standards-agent-kit";
+import { Logger, HederaMirrorNode } from "@hashgraphonline/standards-sdk";
+import { PrivateKey } from "@hashgraph/sdk";
+import { SYSTEM_MESSAGE } from "./index6.js";
+class ConversationalAgent {
+  constructor(options) {
+    this.options = options;
+    this.stateManager = options.stateManager || new OpenConvaiState();
+    this.hcs10Plugin = new HCS10Plugin();
+    this.hcs2Plugin = new HCS2Plugin();
+    this.inscribePlugin = new InscribePlugin();
+    this.logger = new Logger({ module: "ConversationalAgent" });
+  }
+  async initialize() {
+    const {
+      accountId,
+      privateKey,
+      network = "testnet",
+      openAIApiKey,
+      openAIModelName = "gpt-4o",
+      verbose = false,
+      operationalMode = "autonomous",
+      userAccountId,
+      customSystemMessagePreamble,
+      customSystemMessagePostamble,
+      additionalPlugins = [],
+      scheduleUserTransactionsInBytesMode,
+      mirrorNodeConfig,
+      disableLogging
+    } = this.options;
+    if (!accountId || !privateKey) {
+      throw new Error("Account ID and private key are required");
+    }
+    try {
+      const mirrorNode = new HederaMirrorNode(network, this.logger);
+      const accountInfo = await mirrorNode.requestAccount(accountId);
+      const keyType = accountInfo?.key?._type || "";
+      let privateKeyInstance;
+      if (keyType?.toLowerCase()?.includes("ecdsa")) {
+        privateKeyInstance = PrivateKey.fromStringECDSA(privateKey);
+      } else {
+        privateKeyInstance = PrivateKey.fromStringED25519(privateKey);
+      }
+      const serverSigner = new ServerSigner(
+        accountId,
+        privateKeyInstance,
+        network
+      );
+      const standardPlugins = [
+        this.hcs10Plugin,
+        this.hcs2Plugin,
+        this.inscribePlugin
+      ];
+      const corePlugins = getAllHederaCorePlugins();
+      let allPlugins;
+      if (this.options.enabledPlugins) {
+        const enabledSet = new Set(this.options.enabledPlugins);
+        const filteredPlugins = [...standardPlugins, ...corePlugins].filter(
+          (plugin) => enabledSet.has(plugin.id)
+        );
+        allPlugins = [...filteredPlugins, ...additionalPlugins];
+      } else {
+        allPlugins = [...standardPlugins, ...corePlugins, ...additionalPlugins];
+      }
+      const agentConfig = {
+        pluginConfig: {
+          plugins: allPlugins,
+          appConfig: {
+            stateManager: this.stateManager
+          }
+        },
+        openAIApiKey,
+        openAIModelName,
+        verbose,
+        operationalMode,
+        userAccountId,
+        customSystemMessagePreamble: customSystemMessagePreamble || SYSTEM_MESSAGE,
+        ...customSystemMessagePostamble !== void 0 && {
+          customSystemMessagePostamble
+        },
+        ...scheduleUserTransactionsInBytesMode !== void 0 && {
+          scheduleUserTransactionsInBytesMode
+        },
+        ...mirrorNodeConfig !== void 0 && { mirrorNodeConfig },
+        ...disableLogging !== void 0 && { disableLogging }
+      };
+      this.conversationalAgent = new HederaConversationalAgent(
+        serverSigner,
+        agentConfig
+      );
+      await this.conversationalAgent.initialize();
+    } catch (error) {
+      this.logger.error("Failed to initialize ConversationalAgent:", error);
+      throw error;
+    }
+  }
+  getPlugin() {
+    return this.hcs10Plugin;
+  }
+  getStateManager() {
+    return this.stateManager;
+  }
+  getConversationalAgent() {
+    if (!this.conversationalAgent) {
+      throw new Error(
+        "ConversationalAgent not initialized. Call initialize() first."
+      );
+    }
+    return this.conversationalAgent;
+  }
+  async processMessage(message, chatHistory = []) {
+    if (!this.conversationalAgent) {
+      throw new Error(
+        "ConversationalAgent not initialized. Call initialize() first."
+      );
+    }
+    return this.conversationalAgent.processMessage(message, chatHistory);
+  }
+  /**
+   * Create a ConversationalAgent with only HTS (Hedera Token Service) tools enabled
+   */
+  static withHTS(options) {
+    return new ConversationalAgent({
+      ...options,
+      enabledPlugins: ["hts-token"]
+    });
+  }
+  /**
+   * Create a ConversationalAgent with only HCS-2 tools enabled
+   */
+  static withHCS2(options) {
+    return new ConversationalAgent({
+      ...options,
+      enabledPlugins: ["hcs-2"]
+    });
+  }
+  /**
+   * Create a ConversationalAgent with only HCS-10 tools enabled
+   */
+  static withHCS10(options) {
+    return new ConversationalAgent({
+      ...options,
+      enabledPlugins: ["hcs-10"]
+    });
+  }
+  /**
+   * Create a ConversationalAgent with only inscription tools enabled
+   */
+  static withInscribe(options) {
+    return new ConversationalAgent({
+      ...options,
+      enabledPlugins: ["inscribe"]
+    });
+  }
+  /**
+   * Create a ConversationalAgent with only account management tools enabled
+   */
+  static withAccount(options) {
+    return new ConversationalAgent({
+      ...options,
+      enabledPlugins: ["account"]
+    });
+  }
+  /**
+   * Create a ConversationalAgent with only file service tools enabled
+   */
+  static withFileService(options) {
+    return new ConversationalAgent({
+      ...options,
+      enabledPlugins: ["file-service"]
+    });
+  }
+  /**
+   * Create a ConversationalAgent with only consensus service tools enabled
+   */
+  static withConsensusService(options) {
+    return new ConversationalAgent({
+      ...options,
+      enabledPlugins: ["consensus-service"]
+    });
+  }
+  /**
+   * Create a ConversationalAgent with only smart contract tools enabled
+   */
+  static withSmartContract(options) {
+    return new ConversationalAgent({
+      ...options,
+      enabledPlugins: ["smart-contract"]
+    });
+  }
+  /**
+   * Create a ConversationalAgent with all HCS standards plugins
+   */
+  static withAllStandards(options) {
+    return new ConversationalAgent({
+      ...options,
+      enabledPlugins: ["hcs-10", "hcs-2", "inscribe"]
+    });
+  }
+  /**
+   * Create a ConversationalAgent with minimal Hedera tools (no HCS standards)
+   */
+  static minimal(options) {
+    return new ConversationalAgent({
+      ...options,
+      enabledPlugins: []
+    });
+  }
+}
+export {
+  ConversationalAgent
+};
+//# sourceMappingURL=index5.js.map

package/dist/esm/index5.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index5.js","sources":["../../src/conversational-agent.ts"],"sourcesContent":["import {\n  ServerSigner,\n  HederaConversationalAgent,\n  getAllHederaCorePlugins,\n  BasePlugin,\n} from 'hedera-agent-kit';\nimport type {\n  AgentOperationalMode,\n  AgentResponse,\n  HederaConversationalAgentConfig,\n  MirrorNodeConfig,\n} from 'hedera-agent-kit';\nimport { HCS10Plugin } from './plugins/hcs-10/HCS10Plugin';\nimport { HCS2Plugin } from './plugins/hcs-2/HCS2Plugin';\nimport { InscribePlugin } from './plugins/inscribe/InscribePlugin';\nimport { OpenConvaiState } from '@hashgraphonline/standards-agent-kit';\nimport type { IStateManager } from '@hashgraphonline/standards-agent-kit';\nimport {\n  Logger,\n  HederaMirrorNode,\n  type NetworkType,\n} from '@hashgraphonline/standards-sdk';\nimport { PrivateKey } from '@hashgraph/sdk';\nimport { SYSTEM_MESSAGE } from './config/system-message';\n\nexport interface ConversationalAgentOptions {\n  accountId: string;\n  privateKey: string;\n  network?: NetworkType;\n  openAIApiKey: string;\n  openAIModelName?: string;\n  verbose?: boolean;\n  operationalMode?: AgentOperationalMode;\n  userAccountId?: string;\n  customSystemMessagePreamble?: string;\n  customSystemMessagePostamble?: string;\n  additionalPlugins?: BasePlugin[];\n  stateManager?: IStateManager;\n  scheduleUserTransactionsInBytesMode?: boolean;\n  mirrorNodeConfig?: MirrorNodeConfig;\n  disableLogging?: boolean;\n  enabledPlugins?: string[];\n}\n\n/**\n * The ConversationalAgent class is an optional wrapper around the HederaConversationalAgent class,\n * which includes the OpenConvAIPlugin and the OpenConvaiState by default.\n * If you want to use a different plugin or state manager, you can pass them in the options.\n * This class is not required and the plugin can be used directly with the HederaConversationalAgent class.\n *\n * @param options - The options for the ConversationalAgent.\n * @returns A new instance of the ConversationalAgent class.\n */\nexport class ConversationalAgent {\n  public conversationalAgent?: HederaConversationalAgent;\n  public hcs10Plugin: HCS10Plugin;\n  public hcs2Plugin: HCS2Plugin;\n  public inscribePlugin: InscribePlugin;\n  public stateManager: IStateManager;\n  private options: ConversationalAgentOptions;\n  private logger: Logger;\n\n  constructor(options: ConversationalAgentOptions) {\n    this.options = options;\n    this.stateManager = options.stateManager || new OpenConvaiState();\n    this.hcs10Plugin = new HCS10Plugin();\n    this.hcs2Plugin = new HCS2Plugin();\n    this.inscribePlugin = new InscribePlugin();\n    this.logger = new Logger({ module: 'ConversationalAgent' });\n  }\n\n  async initialize(): Promise<void> {\n    const {\n      accountId,\n      privateKey,\n      network = 'testnet',\n      openAIApiKey,\n      openAIModelName = 'gpt-4o',\n      verbose = false,\n      operationalMode = 'autonomous',\n      userAccountId,\n      customSystemMessagePreamble,\n      customSystemMessagePostamble,\n      additionalPlugins = [],\n      scheduleUserTransactionsInBytesMode,\n      mirrorNodeConfig,\n      disableLogging,\n    } = this.options;\n\n    if (!accountId || !privateKey) {\n      throw new Error('Account ID and private key are required');\n    }\n\n    try {\n      const mirrorNode = new HederaMirrorNode(network, this.logger);\n      const accountInfo = await mirrorNode.requestAccount(accountId);\n      const keyType = accountInfo?.key?._type || '';\n\n      let privateKeyInstance: PrivateKey;\n      if (keyType?.toLowerCase()?.includes('ecdsa')) {\n        privateKeyInstance = PrivateKey.fromStringECDSA(privateKey);\n      } else {\n        privateKeyInstance = PrivateKey.fromStringED25519(privateKey);\n      }\n\n      const serverSigner = new ServerSigner(\n        accountId,\n        privateKeyInstance,\n        network\n      );\n\n      const standardPlugins = [\n        this.hcs10Plugin,\n        this.hcs2Plugin,\n        this.inscribePlugin,\n      ];\n\n      const corePlugins = getAllHederaCorePlugins();\n\n      let allPlugins: BasePlugin[];\n\n      if (this.options.enabledPlugins) {\n        const enabledSet = new Set(this.options.enabledPlugins);\n        const filteredPlugins = [...standardPlugins, ...corePlugins].filter(\n          (plugin) => enabledSet.has(plugin.id)\n        );\n        allPlugins = [...filteredPlugins, ...additionalPlugins];\n      } else {\n        allPlugins = [...standardPlugins, ...corePlugins, ...additionalPlugins];\n      }\n\n      const agentConfig: HederaConversationalAgentConfig = {\n        pluginConfig: {\n          plugins: allPlugins,\n          appConfig: {\n            stateManager: this.stateManager,\n          },\n        },\n        openAIApiKey,\n        openAIModelName,\n        verbose,\n        operationalMode,\n        userAccountId,\n        customSystemMessagePreamble:\n          customSystemMessagePreamble || SYSTEM_MESSAGE,\n        ...(customSystemMessagePostamble !== undefined && {\n          customSystemMessagePostamble,\n        }),\n        ...(scheduleUserTransactionsInBytesMode !== undefined && {\n          scheduleUserTransactionsInBytesMode,\n        }),\n        ...(mirrorNodeConfig !== undefined && { mirrorNodeConfig }),\n        ...(disableLogging !== undefined && { disableLogging }),\n      };\n\n      this.conversationalAgent = new HederaConversationalAgent(\n        serverSigner,\n        agentConfig\n      );\n\n      await this.conversationalAgent.initialize();\n    } catch (error) {\n      this.logger.error('Failed to initialize ConversationalAgent:', error);\n      throw error;\n    }\n  }\n\n  getPlugin(): HCS10Plugin {\n    return this.hcs10Plugin;\n  }\n\n  getStateManager(): IStateManager {\n    return this.stateManager;\n  }\n\n  getConversationalAgent(): HederaConversationalAgent {\n    if (!this.conversationalAgent) {\n      throw new Error(\n        'ConversationalAgent not initialized. Call initialize() first.'\n      );\n    }\n    return this.conversationalAgent;\n  }\n\n  async processMessage(\n    message: string,\n    chatHistory: {\n      type: 'human' | 'ai';\n      content: string;\n    }[] = []\n  ): Promise<AgentResponse> {\n    if (!this.conversationalAgent) {\n      throw new Error(\n        'ConversationalAgent not initialized. Call initialize() first.'\n      );\n    }\n    return this.conversationalAgent.processMessage(message, chatHistory);\n  }\n\n  /**\n   * Create a ConversationalAgent with only HTS (Hedera Token Service) tools enabled\n   */\n  static withHTS(options: ConversationalAgentOptions): ConversationalAgent {\n    return new ConversationalAgent({\n      ...options,\n      enabledPlugins: ['hts-token'],\n    });\n  }\n\n  /**\n   * Create a ConversationalAgent with only HCS-2 tools enabled\n   */\n  static withHCS2(options: ConversationalAgentOptions): ConversationalAgent {\n    return new ConversationalAgent({\n      ...options,\n      enabledPlugins: ['hcs-2'],\n    });\n  }\n\n  /**\n   * Create a ConversationalAgent with only HCS-10 tools enabled\n   */\n  static withHCS10(options: ConversationalAgentOptions): ConversationalAgent {\n    return new ConversationalAgent({\n      ...options,\n      enabledPlugins: ['hcs-10'],\n    });\n  }\n\n  /**\n   * Create a ConversationalAgent with only inscription tools enabled\n   */\n  static withInscribe(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return new ConversationalAgent({\n      ...options,\n      enabledPlugins: ['inscribe'],\n    });\n  }\n\n  /**\n   * Create a ConversationalAgent with only account management tools enabled\n   */\n  static withAccount(options: ConversationalAgentOptions): ConversationalAgent {\n    return new ConversationalAgent({\n      ...options,\n      enabledPlugins: ['account'],\n    });\n  }\n\n  /**\n   * Create a ConversationalAgent with only file service tools enabled\n   */\n  static withFileService(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return new ConversationalAgent({\n      ...options,\n      enabledPlugins: ['file-service'],\n    });\n  }\n\n  /**\n   * Create a ConversationalAgent with only consensus service tools enabled\n   */\n  static withConsensusService(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return new ConversationalAgent({\n      ...options,\n      enabledPlugins: ['consensus-service'],\n    });\n  }\n\n  /**\n   * Create a ConversationalAgent with only smart contract tools enabled\n   */\n  static withSmartContract(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return new ConversationalAgent({\n      ...options,\n      enabledPlugins: ['smart-contract'],\n    });\n  }\n\n  /**\n   * Create a ConversationalAgent with all HCS standards plugins\n   */\n  static withAllStandards(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return new ConversationalAgent({\n      ...options,\n      enabledPlugins: ['hcs-10', 'hcs-2', 'inscribe'],\n    });\n  }\n\n  /**\n   * Create a ConversationalAgent with minimal Hedera tools (no HCS standards)\n   */\n  static minimal(options: ConversationalAgentOptions): ConversationalAgent {\n    return new ConversationalAgent({\n      ...options,\n      enabledPlugins: [],\n    });\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/index6.js

@@ -0,0 +1,16 @@
+const SYSTEM_MESSAGE = `You are a helpful assistant managing Hashgraph Online HCS-10 connections, messages, HCS-2 registries, and content inscription.
+
+You have access to tools for:
+- HCS-10: registering agents, finding registered agents, initiating connections, listing active connections, sending messages over connections, and checking for new messages
+- HCS-2: creating registries, registering entries, updating entries, deleting entries, migrating registries, and querying registry contents
+- Inscription: inscribing content from URLs, files, or buffers, creating Hashinal NFTs, and retrieving inscriptions
+
+*** IMPORTANT CONTEXT ***
+You are currently operating as agent: ${accountId} on the Hashgraph Online network
+When users ask about "my profile", "my account", "my connections", etc., use this account ID: ${accountId}
+
+Remember the connection numbers when listing connections, as users might refer to them.`;
+export {
+  SYSTEM_MESSAGE
+};
+//# sourceMappingURL=index6.js.map

package/dist/esm/index6.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index6.js","sources":["../../src/config/system-message.ts"],"sourcesContent":["export const SYSTEM_MESSAGE = `You are a helpful assistant managing Hashgraph Online HCS-10 connections, messages, HCS-2 registries, and content inscription.\n\nYou have access to tools for:\n- HCS-10: registering agents, finding registered agents, initiating connections, listing active connections, sending messages over connections, and checking for new messages\n- HCS-2: creating registries, registering entries, updating entries, deleting entries, migrating registries, and querying registry contents\n- Inscription: inscribing content from URLs, files, or buffers, creating Hashinal NFTs, and retrieving inscriptions\n\n*** IMPORTANT CONTEXT ***\nYou are currently operating as agent: ${accountId} on the Hashgraph Online network\nWhen users ask about \"my profile\", \"my account\", \"my connections\", etc., use this account ID: ${accountId}\n\nRemember the connection numbers when listing connections, as users might refer to them.`"],"names":[],"mappings":"AAAO,MAAM,iBAAiB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wCAQU,SAAS;AAAA,gGAC+C,SAAS;AAAA;AAAA;"}

package/dist/types/config/system-message.d.ts

@@ -0,0 +1 @@
+export declare const SYSTEM_MESSAGE: string;

package/dist/types/conversational-agent.d.ts

@@ -0,0 +1,92 @@
+import { HederaConversationalAgent, BasePlugin, AgentOperationalMode, AgentResponse, MirrorNodeConfig } from 'hedera-agent-kit';
+import { HCS10Plugin } from './plugins/hcs-10/HCS10Plugin';
+import { HCS2Plugin } from './plugins/hcs-2/HCS2Plugin';
+import { InscribePlugin } from './plugins/inscribe/InscribePlugin';
+import { IStateManager } from '@hashgraphonline/standards-agent-kit';
+import { NetworkType } from '@hashgraphonline/standards-sdk';
+
+export interface ConversationalAgentOptions {
+    accountId: string;
+    privateKey: string;
+    network?: NetworkType;
+    openAIApiKey: string;
+    openAIModelName?: string;
+    verbose?: boolean;
+    operationalMode?: AgentOperationalMode;
+    userAccountId?: string;
+    customSystemMessagePreamble?: string;
+    customSystemMessagePostamble?: string;
+    additionalPlugins?: BasePlugin[];
+    stateManager?: IStateManager;
+    scheduleUserTransactionsInBytesMode?: boolean;
+    mirrorNodeConfig?: MirrorNodeConfig;
+    disableLogging?: boolean;
+    enabledPlugins?: string[];
+}
+/**
+ * The ConversationalAgent class is an optional wrapper around the HederaConversationalAgent class,
+ * which includes the OpenConvAIPlugin and the OpenConvaiState by default.
+ * If you want to use a different plugin or state manager, you can pass them in the options.
+ * This class is not required and the plugin can be used directly with the HederaConversationalAgent class.
+ *
+ * @param options - The options for the ConversationalAgent.
+ * @returns A new instance of the ConversationalAgent class.
+ */
+export declare class ConversationalAgent {
+    conversationalAgent?: HederaConversationalAgent;
+    hcs10Plugin: HCS10Plugin;
+    hcs2Plugin: HCS2Plugin;
+    inscribePlugin: InscribePlugin;
+    stateManager: IStateManager;
+    private options;
+    private logger;
+    constructor(options: ConversationalAgentOptions);
+    initialize(): Promise<void>;
+    getPlugin(): HCS10Plugin;
+    getStateManager(): IStateManager;
+    getConversationalAgent(): HederaConversationalAgent;
+    processMessage(message: string, chatHistory?: {
+        type: 'human' | 'ai';
+        content: string;
+    }[]): Promise<AgentResponse>;
+    /**
+     * Create a ConversationalAgent with only HTS (Hedera Token Service) tools enabled
+     */
+    static withHTS(options: ConversationalAgentOptions): ConversationalAgent;
+    /**
+     * Create a ConversationalAgent with only HCS-2 tools enabled
+     */
+    static withHCS2(options: ConversationalAgentOptions): ConversationalAgent;
+    /**
+     * Create a ConversationalAgent with only HCS-10 tools enabled
+     */
+    static withHCS10(options: ConversationalAgentOptions): ConversationalAgent;
+    /**
+     * Create a ConversationalAgent with only inscription tools enabled
+     */
+    static withInscribe(options: ConversationalAgentOptions): ConversationalAgent;
+    /**
+     * Create a ConversationalAgent with only account management tools enabled
+     */
+    static withAccount(options: ConversationalAgentOptions): ConversationalAgent;
+    /**
+     * Create a ConversationalAgent with only file service tools enabled
+     */
+    static withFileService(options: ConversationalAgentOptions): ConversationalAgent;
+    /**
+     * Create a ConversationalAgent with only consensus service tools enabled
+     */
+    static withConsensusService(options: ConversationalAgentOptions): ConversationalAgent;
+    /**
+     * Create a ConversationalAgent with only smart contract tools enabled
+     */
+    static withSmartContract(options: ConversationalAgentOptions): ConversationalAgent;
+    /**
+     * Create a ConversationalAgent with all HCS standards plugins
+     */
+    static withAllStandards(options: ConversationalAgentOptions): ConversationalAgent;
+    /**
+     * Create a ConversationalAgent with minimal Hedera tools (no HCS standards)
+     */
+    static minimal(options: ConversationalAgentOptions): ConversationalAgent;
+}

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+export { HCS10Plugin } from './plugins/hcs-10/HCS10Plugin';
+export { HCS2Plugin } from './plugins/hcs-2/HCS2Plugin';
+export { InscribePlugin } from './plugins/inscribe/InscribePlugin';
+export { ConversationalAgent } from './conversational-agent';
+export type { ConversationalAgentOptions } from './conversational-agent';
+export * from 'hedera-agent-kit';
+export type { IStateManager } from '@hashgraphonline/standards-agent-kit';

package/dist/types/plugins/hcs-10/HCS10Plugin.d.ts

@@ -0,0 +1,18 @@
+import { GenericPluginContext, HederaTool, BasePlugin } from 'hedera-agent-kit';
+import { IStateManager } from '@hashgraphonline/standards-agent-kit';
+
+export declare class HCS10Plugin extends BasePlugin {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    author: string;
+    namespace: string;
+    private stateManager?;
+    private tools;
+    initialize(context: GenericPluginContext): Promise<void>;
+    private initializeTools;
+    getTools(): HederaTool[];
+    getStateManager(): IStateManager | undefined;
+    cleanup(): Promise<void>;
+}

package/dist/types/plugins/hcs-10/index.d.ts

@@ -0,0 +1 @@
+export { HCS10Plugin } from './HCS10Plugin';

package/dist/types/plugins/hcs-2/HCS2Plugin.d.ts

@@ -0,0 +1,18 @@
+import { GenericPluginContext, HederaTool, BasePlugin } from 'hedera-agent-kit';
+
+/**
+ * Plugin providing HCS-2 registry management tools
+ */
+export declare class HCS2Plugin extends BasePlugin {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    author: string;
+    namespace: string;
+    private tools;
+    initialize(context: GenericPluginContext): Promise<void>;
+    private initializeTools;
+    getTools(): HederaTool[];
+    cleanup(): Promise<void>;
+}

package/dist/types/plugins/hcs-2/index.d.ts

@@ -0,0 +1 @@
+export { HCS2Plugin } from './HCS2Plugin';

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

@@ -0,0 +1,3 @@
+export { HCS10Plugin } from './hcs-10';
+export { HCS2Plugin } from './hcs-2';
+export { InscribePlugin } from './inscribe';

package/dist/types/plugins/inscribe/InscribePlugin.d.ts

@@ -0,0 +1,18 @@
+import { GenericPluginContext, HederaTool, BasePlugin } from 'hedera-agent-kit';
+
+/**
+ * Plugin providing content inscription tools for Hedera
+ */
+export declare class InscribePlugin extends BasePlugin {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    author: string;
+    namespace: string;
+    private tools;
+    initialize(context: GenericPluginContext): Promise<void>;
+    private initializeTools;
+    getTools(): HederaTool[];
+    cleanup(): Promise<void>;
+}

package/dist/types/plugins/inscribe/index.d.ts

@@ -0,0 +1 @@
+export { InscribePlugin } from './InscribePlugin';

package/package.json

@@ -0,0 +1,103 @@
+{
+  "name": "@hashgraphonline/conversational-agent",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/cjs/index.cjs",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "browser": {
+        "import": "./dist/esm/index.js",
+        "require": "./dist/umd/conversational-agent.umd.js"
+      },
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "LICENSE",
+    "README.md"
+  ],
+  "keywords": [
+    "hedera",
+    "hashgraph",
+    "consensus",
+    "standards",
+    "hcs",
+    "hcs-10",
+    "hcs-2",
+    "agent",
+    "ai",
+    "conversational",
+    "inscription",
+    "registry",
+    "openconvai",
+    "hashgraph-online"
+  ],
+  "author": "Hashgraph Online",
+  "license": "Apache-2.0",
+  "description": "Hashgraph Online conversational AI agent implementing HCS-10 communication, HCS-2 registries, and content inscription on Hedera",
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.3.1",
+    "@typescript-eslint/eslint-plugin": "^8.38.0",
+    "@typescript-eslint/parser": "^8.38.0",
+    "dotenv": "^17.2.1",
+    "eslint": "^8.57.1",
+    "eslint-config-next": "14.1.0",
+    "eslint-plugin-sonarjs": "^3.0.4",
+    "rimraf": "^6.0.1",
+    "rollup-plugin-polyfill-node": "^0.13.0",
+    "terser": "^5.43.1",
+    "tsx": "^4.20.3",
+    "typescript": "^5.8.3",
+    "vite": "^6.3.5",
+    "vite-plugin-dts": "^3.9.1",
+    "vite-plugin-node-polyfills": "^0.23.0",
+    "vite-plugin-string-replace": "^1.1.5",
+    "vitest": "^3.2.4"
+  },
+  "dependencies": {
+    "@hashgraph/sdk": "^2.69.0",
+    "@hashgraphonline/standards-agent-kit": "^0.2.102",
+    "@hashgraphonline/standards-sdk": "^0.0.155",
+    "@langchain/core": "^0.3.66",
+    "hedera-agent-kit": "^2.0.3",
+    "zod": "^3.25.76"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hashgraph-online/conversational-agent.git"
+  },
+  "directories": {
+    "test": "tests"
+  },
+  "bugs": {
+    "url": "https://github.com/hashgraph-online/conversational-agent/issues"
+  },
+  "homepage": "https://github.com/hashgraph-online/conversational-agent#readme",
+  "scripts": {
+    "test": "vitest run",
+    "test:integration": "vitest run tests/integration",
+    "clean": "rimraf dist",
+    "build:es": "BUILD_FORMAT=es vite build",
+    "build:cjs": "BUILD_FORMAT=cjs vite build",
+    "build:umd": "BUILD_FORMAT=umd vite build",
+    "build": "pnpm run clean && pnpm run build:es && pnpm run build:cjs",
+    "release": "pnpm publish --access public",
+    "release:canary": "pnpm run prepublishOnly && pnpm publish --tag canary --access public",
+    "version:canary": "pnpm version prerelease --preid canary --no-git-tag-version",
+    "publish:canary": "pnpm run version:canary && pnpm run release:canary",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "typecheck": "tsc --noEmit",
+    "cli:build": "pnpm run build && cd cli && pnpm install && pnpm build",
+    "cli": "tsx cli/scripts/run-cli.ts",
+    "cli:dev": "cd cli && pnpm dev",
+    "postinstall": "cd cli && pnpm install --silent 2>/dev/null || true"
+  }
+}

package/src/config/system-message.ts

@@ -0,0 +1,12 @@
+export const SYSTEM_MESSAGE = `You are a helpful assistant managing Hashgraph Online HCS-10 connections, messages, HCS-2 registries, and content inscription.
+
+You have access to tools for:
+- HCS-10: registering agents, finding registered agents, initiating connections, listing active connections, sending messages over connections, and checking for new messages
+- HCS-2: creating registries, registering entries, updating entries, deleting entries, migrating registries, and querying registry contents
+- Inscription: inscribing content from URLs, files, or buffers, creating Hashinal NFTs, and retrieving inscriptions
+
+*** IMPORTANT CONTEXT ***
+You are currently operating as agent: ${accountId} on the Hashgraph Online network
+When users ask about "my profile", "my account", "my connections", etc., use this account ID: ${accountId}
+
+Remember the connection numbers when listing connections, as users might refer to them.`