@hashgraphonline/conversational-agent 0.0.1

package/LICENSE

@@ -0,0 +1,189 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1.  Definitions.
+
+    "License" shall mean the terms and conditions for use, reproduction,
+    and distribution as defined by Sections 1 through 9 of this document.
+
+    "Licensor" shall mean the copyright owner or entity authorized by
+    the copyright owner that is granting the License.
+
+    "Legal Entity" shall mean the union of the acting entity and all
+    other entities that control, are controlled by, or are under common
+    control with that entity. For the purposes of this definition,
+    "control" means (i) the power, direct or indirect, to cause the
+    direction or management of such entity, whether by contract or
+    otherwise, or (ii) ownership of fifty percent (50%) or more of the
+    outstanding shares, or (iii) beneficial ownership of such entity.
+
+    "You" (or "Your") shall mean an individual or Legal Entity
+    exercising permissions granted by this License.
+
+    "Source" form shall mean the preferred form for making modifications,
+    including but not limited to software source code, documentation
+    source, and configuration files.
+
+    "Object" form shall mean any form resulting from mechanical
+    transformation or translation of a Source form, including but
+    not limited to compiled object code, generated documentation,
+    and conversions to other media types.
+
+    "Work" shall mean the work of authorship, whether in Source or
+    Object form, made available under the License, as indicated by a
+    copyright notice that is included in or attached to the work
+    (an example is provided in the Appendix below).
+
+    "Derivative Works" shall mean any work, whether in Source or Object
+    form, that is based on (or derived from) the Work and for which the
+    editorial revisions, annotations, elaborations, or other modifications
+    represent, as a whole, an original work of authorship. For the purposes
+    of this License, Derivative Works shall not include works that remain
+    separable from, or merely link (or bind by name) to the interfaces of,
+    the Work and Derivative Works thereof.
+
+    "Contribution" shall mean any work of authorship, including
+    the original version of the Work and any modifications or additions
+    to that Work or Derivative Works thereof, that is intentionally
+    submitted to Licensor for inclusion in the Work by the copyright owner
+    or by an individual or Legal Entity authorized to submit on behalf of
+    the copyright owner. For the purposes of this definition, "submitted"
+    means any form of electronic, verbal, or written communication sent
+    to the Licensor or its representatives, including but not limited to
+    communication on electronic mailing lists, source code control systems,
+    and issue tracking systems that are managed by, or on behalf of, the
+    Licensor for the purpose of discussing and improving the Work, but
+    excluding communication that is conspicuously marked or otherwise
+    designated in writing by the copyright owner as "Not a Contribution."
+
+    "Contributor" shall mean Licensor and any individual or Legal Entity
+    on behalf of whom a Contribution has been received by Licensor and
+    subsequently incorporated within the Work.
+
+2.  Grant of Copyright License. Subject to the terms and conditions of
+    this License, each Contributor hereby grants to You a perpetual,
+    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+    copyright license to reproduce, prepare Derivative Works of,
+    publicly display, publicly perform, sublicense, and distribute the
+    Work and such Derivative Works in Source or Object form.
+
+3.  Grant of Patent License. Subject to the terms and conditions of
+    this License, each Contributor hereby grants to You a perpetual,
+    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+    (except as stated in this section) patent license to make, have made,
+    use, offer to sell, sell, import, and otherwise transfer the Work,
+    where such license applies only to those patent claims licensable
+    by such Contributor that are necessarily infringed by their
+    Contribution(s) alone or by combination of their Contribution(s)
+    with the Work to which such Contribution(s) was submitted. If You
+    institute patent litigation against any entity (including a
+    cross-claim or counterclaim in a lawsuit) alleging that the Work
+    or a Contribution incorporated within the Work constitutes direct
+    or contributory patent infringement, then any patent licenses
+    granted to You under this License for that Work shall terminate
+    as of the date such litigation is filed.
+
+4.  Redistribution. You may reproduce and distribute copies of the
+    Work or Derivative Works thereof in any medium, with or without
+    modifications, and in Source or Object form, provided that You
+    meet the following conditions:
+
+    (a) You must give any other recipients of the Work or
+    Derivative Works a copy of this License; and
+
+    (b) You must cause any modified files to carry prominent notices
+    stating that You changed the files; and
+
+    (c) You must retain, in the Source form of any Derivative Works
+    that You distribute, all copyright, patent, trademark, and
+    attribution notices from the Source form of the Work,
+    excluding those notices that do not pertain to any part of
+    the Derivative Works; and
+
+    (d) If the Work includes a "NOTICE" text file as part of its
+    distribution, then any Derivative Works that You distribute must
+    include a readable copy of the attribution notices contained
+    within such NOTICE file, excluding those notices that do not
+    pertain to any part of the Derivative Works, in at least one
+    of the following places: within a NOTICE text file distributed
+    as part of the Derivative Works; within the Source form or
+    documentation, if provided along with the Derivative Works; or,
+    within a display generated by the Derivative Works, if and
+    wherever such third-party notices normally appear. The contents
+    of the NOTICE file are for informational purposes only and
+    do not modify the License. You may add Your own attribution
+    notices within Derivative Works that You distribute, alongside
+    or as an addendum to the NOTICE text from the Work, provided
+    that such additional attribution notices cannot be construed
+    as modifying the License.
+
+    You may add Your own copyright statement to Your modifications and
+    may provide additional or different license terms and conditions
+    for use, reproduction, or distribution of Your modifications, or
+    for any such Derivative Works as a whole, provided Your use,
+    reproduction, and distribution of the Work otherwise complies with
+    the conditions stated in this License.
+
+5.  Submission of Contributions. Unless You explicitly state otherwise,
+    any Contribution intentionally submitted for inclusion in the Work
+    by You to the Licensor shall be under the terms and conditions of
+    this License, without any additional terms or conditions.
+    Notwithstanding the above, nothing herein shall supersede or modify
+    the terms of any separate license agreement you may have executed
+    with Licensor regarding such Contributions.
+
+6.  Trademarks. This License does not grant permission to use the trade
+    names, trademarks, service marks, or product names of the Licensor,
+    except as required for reasonable and customary use in describing the
+    origin of the Work and reproducing the content of the NOTICE file.
+
+7.  Disclaimer of Warranty. Unless required by applicable law or
+    agreed to in writing, Licensor provides the Work (and each
+    Contributor provides its Contributions) on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+    implied, including, without limitation, any warranties or conditions
+    of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+    PARTICULAR PURPOSE. You are solely responsible for determining the
+    appropriateness of using or redistributing the Work and assume any
+    risks associated with Your exercise of permissions under this License.
+
+8.  Limitation of Liability. In no event and under no legal theory,
+    whether in tort (including negligence), contract, or otherwise,
+    unless required by applicable law (such as deliberate and grossly
+    negligent acts) or agreed to in writing, shall any Contributor be
+    liable to You for damages, including any direct, indirect, special,
+    incidental, or consequential damages of any character arising as a
+    result of this License or out of the use or inability to use the
+    Work (including but not limited to damages for loss of goodwill,
+    work stoppage, computer failure or malfunction, or any and all
+    other commercial damages or losses), even if such Contributor
+    has been advised of the possibility of such damages.
+
+9.  Accepting Warranty or Additional Liability. While redistributing
+    the Work or Derivative Works thereof, You may choose to offer,
+    and charge a fee for, acceptance of support, warranty, indemnity,
+    or other liability obligations and/or rights consistent with this
+    License. However, in accepting such obligations, You may act only
+    on Your own behalf and on Your sole responsibility, not on behalf
+    of any other Contributor, and only if You agree to indemnify,
+    defend, and hold each Contributor harmless for any liability
+    incurred by, or claims asserted against, such Contributor by reason
+    of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+SPDX-License-Identifier: Apache-2.0

package/README.md

@@ -0,0 +1,387 @@
+# Hashgraph Online Conversational Agent
+
+| ![](./Hashgraph-Online.png) | A conversational AI agent that implements Hashgraph Consensus Standards (HCS) for agent communication, registry management, and content inscription on the Hedera network.<br><br>This package is built and maintained by [Hashgraph Online](https://hashgraphonline.com), a consortium of leading Hashgraph organizations within the Hedera ecosystem.<br><br>[📚 Conversational Agent Documentation](https://hashgraphonline.com/docs/libraries/conversational-agent/)<br>[📖 HCS Standards Documentation](https://hcs-improvement-proposals.pages.dev/docs/standards) |
+| :-------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+
+## Overview
+
+The Hashgraph Online Conversational Agent provides a comprehensive AI agent implementation that supports:
+
+- **HCS-10**: AI Agent Communication standard for trustless peer-to-peer messaging
+- **HCS-2**: Registry management for decentralized data storage
+- **Inscription**: Content inscription following Hashgraph Consensus Standards
+
+### Important Compatibility Note
+
+This package is designed to work as a standalone conversational agent. While it can be used with `hedera-agent-kit` version 2.0.3 **only** (version 3.x no longer supports the plugin architecture), the recommended approach is to use the `ConversationalAgent` class directly.
+
+## Installation
+
+```bash
+# Install the conversational agent
+npm install @hashgraphonline/conversational-agent
+
+# Required dependencies
+npm install @hashgraph/sdk @hashgraphonline/standards-sdk
+```
+
+## Quick Start
+
+```typescript
+import { ConversationalAgent } from '@hashgraphonline/conversational-agent';
+
+// Initialize the agent
+const agent = new ConversationalAgent({
+  accountId: process.env.HEDERA_ACCOUNT_ID!,
+  privateKey: process.env.HEDERA_PRIVATE_KEY!,
+  network: 'testnet',
+  openAIApiKey: process.env.OPENAI_API_KEY!,
+  openAIModelName: 'gpt-4o',
+  verbose: true
+});
+
+// Initialize (automatically detects key type)
+await agent.initialize();
+
+// Process a message
+const response = await agent.processMessage(
+  'Register me as an AI agent with the name TestBot, a random unique alias, and description "A test bot"'
+);
+
+console.log(response.response);
+```
+
+## Features
+
+- **Automatic Key Detection**: Smart detection of ED25519 and ECDSA key types via mirror node
+- **Multiple HCS Standards**: Built-in support for HCS-10, HCS-2, and inscription standards
+- **Three Plugin System**: HCS10Plugin, HCS2Plugin, and InscribePlugin
+- **TypeScript Support**: Full type definitions for all components
+- **State Management**: Integrated state management for agent operations
+- **CLI Interface**: Beautiful terminal interface for interactive agent communication
+
+## Available Tools
+
+The Conversational Agent includes all tools from the `@hashgraphonline/hedera-agent-kit` package, providing comprehensive access to Hedera network functionality:
+
+### Core Hedera Tools (from hedera-agent-kit)
+- **Account Management**: Create accounts, transfer HBAR, manage allowances, get account info
+- **Token Service (HTS)**: Create tokens/NFTs, mint, burn, transfer, manage token properties
+- **Smart Contract Service**: Deploy contracts, execute functions, query contract state
+- **File Service**: Create, append, update, delete files on Hedera
+- **Consensus Service**: Create topics, submit messages, retrieve topic info
+- **Network Queries**: Get network info, HBAR price, transaction details
+
+### HCS-10 Agent Communication Tools
+- **RegisterAgentTool**: Register new agents with capabilities and tags
+- **FindRegistrationsTool**: Search for agents by account ID or tags
+- **RetrieveProfileTool**: Get detailed agent profiles
+- **InitiateConnectionTool**: Start connections with other agents
+- **ListConnectionsTool**: View active connections
+- **ConnectionMonitorTool**: Monitor for incoming connection requests
+- **ManageConnectionRequestsTool**: Handle pending connections
+- **AcceptConnectionRequestTool**: Accept incoming connections
+- **ListUnapprovedConnectionRequestsTool**: View pending requests
+- **SendMessageToConnectionTool**: Send messages to connected agents
+- **CheckMessagesTool**: Retrieve messages from connections
+
+### HCS-2 Registry Tools
+- **CreateRegistryTool**: Create new HCS-2 registry topics
+- **RegisterEntryTool**: Add entries to existing registries
+- **UpdateEntryTool**: Modify existing entries in registries
+- **DeleteEntryTool**: Remove entries from registries
+- **MigrateRegistryTool**: Move registries to new topics
+- **QueryRegistryTool**: Retrieve entries from registries
+
+### Inscription Tools
+- **InscribeFromUrlTool**: Inscribe content from URLs
+- **InscribeFromFileTool**: Inscribe content from local files
+- **InscribeFromBufferTool**: Inscribe content from memory buffers
+- **InscribeHashinalTool**: Create Hashinal NFTs with specific attributes
+- **RetrieveInscriptionTool**: Get details of existing inscriptions
+
+## Command Line Interface (CLI)
+
+This package includes a beautiful terminal interface built with [Ink](https://github.com/vadimdemedes/ink) that follows Hashgraph Consensus Standards design patterns.
+
+```bash
+# Run the interactive CLI
+pnpm cli
+
+# Or with environment variables
+export HEDERA_ACCOUNT_ID=0.0.12345
+export HEDERA_PRIVATE_KEY=your-private-key
+export OPENAI_API_KEY=sk-your-openai-key
+pnpm cli
+
+# Or with command line arguments
+pnpm cli -- --account-id=0.0.12345 --private-key=... --openai-api-key=sk-...
+```
+
+### CLI Features
+
+- 🎨 **Beautiful Terminal UI** - Styled with Hashgraph Consensus Standards improvement proposals design patterns
+- 💬 **Interactive Chat** - Chat with your Hashgraph Online agent in a clean terminal interface
+- 🔐 **Secure Configuration** - Masked input for sensitive credentials
+- 🌈 **Gradient Text & Colors** - Brand-consistent color scheme
+- 🚀 **Fast & Responsive** - Built with React for smooth interactions
+- 📊 **Transaction Details** - See transaction IDs and network responses
+
+## Creating Custom Plugins
+
+You can extend the conversational agent with custom plugins. Here's how to create one:
+
+### Plugin Structure
+
+See our comprehensive [Plugin Development Guide](docs/PLUGIN_DEVELOPMENT.md) for detailed instructions.
+
+```typescript
+import {
+  GenericPluginContext,
+  HederaTool,
+  BasePlugin,
+  HederaAgentKit,
+} from 'hedera-agent-kit';
+
+export class MyCustomPlugin extends BasePlugin {
+  id = 'my-plugin';
+  name = 'MyCustomPlugin';
+  description = 'A custom plugin for specific functionality';
+  version = '1.0.0';
+  author = 'Your Name';
+  namespace = 'myplugin';
+
+  private tools: HederaTool[] = [];
+
+  override async initialize(context: GenericPluginContext): Promise<void> {
+    await super.initialize(context);
+    // Initialize your plugin and tools
+  }
+
+  getTools(): HederaTool[] {
+    return this.tools;
+  }
+}
+```
+
+### Creating a Custom Tool
+
+Tools extend either `BaseHederaTransactionTool` or `BaseHederaQueryTool`:
+
+```typescript
+import { z } from 'zod';
+import {
+  BaseHederaTransactionTool,
+  BaseHederaTransactionToolParams,
+  BaseServiceBuilder,
+} from 'hedera-agent-kit';
+
+const MyToolSchema = z.object({
+  param1: z.string().describe('First parameter'),
+  param2: z.number().optional().describe('Optional second parameter'),
+});
+
+export class MyCustomTool extends BaseHederaTransactionTool<typeof MyToolSchema> {
+  name = 'my-custom-tool';
+  description = 'Performs a custom Hedera transaction';
+  specificInputSchema = MyToolSchema;
+  namespace = 'custom';
+
+  constructor(params: BaseHederaTransactionToolParams) {
+    super(params);
+  }
+
+  protected getServiceBuilder(): BaseServiceBuilder {
+    return this.hederaKit.consensus(); // or hts(), account(), etc.
+  }
+
+  protected async callBuilderMethod(
+    builder: BaseServiceBuilder,
+    specificArgs: z.infer<typeof MyToolSchema>
+  ): Promise<void> {
+    // Implement your transaction logic
+  }
+}
+```
+
+### Using Custom Plugins
+
+```typescript
+import { ConversationalAgent } from '@hashgraphonline/conversational-agent';
+import { MyCustomPlugin } from './plugins/MyCustomPlugin';
+
+const agent = new ConversationalAgent({
+  accountId: process.env.HEDERA_ACCOUNT_ID!,
+  privateKey: process.env.HEDERA_PRIVATE_KEY!,
+  network: 'testnet',
+  openAIApiKey: process.env.OPENAI_API_KEY!,
+  // Add your custom plugins
+  additionalPlugins: [new MyCustomPlugin()]
+});
+
+await agent.initialize();
+
+// Your custom tools are now available to the agent
+const response = await agent.processMessage('Use my custom tool with param1 "test"');
+```
+
+### Plugin Best Practices
+
+1. **Extend Correct Base Classes**: Use `BaseHederaTransactionTool` or `BaseHederaQueryTool` for tools
+2. **Define Clear Schemas**: Use Zod schemas to clearly define tool inputs
+3. **Error Handling**: Always handle errors gracefully and return meaningful messages
+4. **State Management**: If your plugin needs state, consider implementing a custom state manager
+5. **Documentation**: Provide clear descriptions for your plugin and tools
+
+For more details, see our [Plugin Development Guide](docs/PLUGIN_DEVELOPMENT.md).
+
+## Configuration Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `accountId` | string | **required** | Hedera account ID (e.g., '0.0.12345') |
+| `privateKey` | string | **required** | Private key for the account |
+| `network` | NetworkType | 'testnet' | Network to connect to ('mainnet' or 'testnet') |
+| `openAIApiKey` | string | **required** | OpenAI API key for the LLM |
+| `openAIModelName` | string | 'gpt-4o' | OpenAI model to use |
+| `verbose` | boolean | false | Enable verbose logging |
+| `operationalMode` | AgentOperationalMode | 'autonomous' | 'autonomous' or 'returnBytes' |
+| `userAccountId` | string | undefined | User's account ID for transaction context |
+| `customSystemMessagePreamble` | string | instructions | Custom system message prefix |
+| `customSystemMessagePostamble` | string | undefined | Custom system message suffix |
+| `additionalPlugins` | BasePlugin[] | [] | Additional plugins to load |
+| `stateManager` | IStateManager | OpenConvaiState | Custom state manager |
+| `scheduleUserTransactionsInBytesMode` | boolean | false | Schedule transactions in bytes mode |
+| `mirrorNodeConfig` | MirrorNodeConfig | undefined | Custom mirror node configuration |
+| `disableLogging` | boolean | false | Disable all logging |
+| `enabledPlugins` | string[] | undefined | Filter which plugins to enable by ID |
+
+## Environment Variables
+
+```bash
+# Required
+HEDERA_ACCOUNT_ID=0.0.12345
+HEDERA_PRIVATE_KEY=your_private_key_here
+OPENAI_API_KEY=your_openai_api_key
+
+# Optional
+HEDERA_NETWORK=testnet  # defaults to testnet
+```
+
+## Advanced Usage
+
+### Direct Plugin Access
+
+```typescript
+const agent = new ConversationalAgent({ /* config */ });
+await agent.initialize();
+
+// Access plugins directly
+const hcs10Plugin = agent.hcs10Plugin;
+const hcs2Plugin = agent.hcs2Plugin;
+const inscribePlugin = agent.inscribePlugin;
+
+// Access the underlying Hedera agent
+const hederaAgent = agent.getConversationalAgent();
+
+// Access state manager
+const stateManager = agent.getStateManager();
+```
+
+### Custom State Management
+
+```typescript
+import { OpenConvaiState } from '@hashgraphonline/standards-agent-kit';
+
+// Create custom state manager
+const customStateManager = new OpenConvaiState();
+
+const agent = new ConversationalAgent({
+  // ... other config
+  stateManager: customStateManager
+});
+```
+
+### Using Plugin Presets
+
+The ConversationalAgent provides static helper functions to create agents with specific plugin configurations:
+
+```typescript
+// Create agent with only HTS (Hedera Token Service) tools
+const htsAgent = ConversationalAgent.withHTS({
+  accountId: process.env.HEDERA_ACCOUNT_ID!,
+  privateKey: process.env.HEDERA_PRIVATE_KEY!,
+  network: 'testnet',
+  openAIApiKey: process.env.OPENAI_API_KEY!
+});
+
+// Create agent with only HCS-2 registry tools
+const hcs2Agent = ConversationalAgent.withHCS2({
+  accountId: process.env.HEDERA_ACCOUNT_ID!,
+  privateKey: process.env.HEDERA_PRIVATE_KEY!,
+  network: 'testnet',
+  openAIApiKey: process.env.OPENAI_API_KEY!
+});
+
+// Other presets available:
+// ConversationalAgent.withHCS10() - Only HCS-10 agent communication tools
+// ConversationalAgent.withInscribe() - Only inscription tools
+// ConversationalAgent.withAccount() - Only account management tools
+// ConversationalAgent.withFileService() - Only file service tools
+// ConversationalAgent.withConsensusService() - Only consensus service tools
+// ConversationalAgent.withSmartContract() - Only smart contract tools
+// ConversationalAgent.withAllStandards() - All HCS standards plugins (HCS-10, HCS-2, Inscribe)
+// ConversationalAgent.minimal() - Only basic account tools
+```
+
+### Plugin Filtering
+
+You can also manually specify which plugins to enable using the `enabledPlugins` option:
+
+```typescript
+const agent = new ConversationalAgent({
+  accountId: process.env.HEDERA_ACCOUNT_ID!,
+  privateKey: process.env.HEDERA_PRIVATE_KEY!,
+  network: 'testnet',
+  openAIApiKey: process.env.OPENAI_API_KEY!,
+  // Only enable specific plugins by their ID
+  enabledPlugins: ['hcs-10', 'hts-token', 'account']
+});
+```
+
+Available plugin IDs:
+- Standard plugins: `hcs-10`, `hcs-2`, `inscribe`
+- Core Hedera plugins: `hts-token`, `account`, `file-service`, `consensus-service`, `smart-contract`, `network`
+
+### Legacy Plugin Usage (hedera-agent-kit 2.0.3 only)
+
+If you need to use this with hedera-agent-kit 2.0.3:
+
+```typescript
+import { HederaConversationalAgent, ServerSigner } from 'hedera-agent-kit';
+import { HCS10Plugin, HCS2Plugin, InscribePlugin } from '@hashgraphonline/conversational-agent';
+
+const signer = new ServerSigner(accountId, privateKey, network);
+
+const agent = new HederaConversationalAgent(signer, {
+  pluginConfig: {
+    plugins: [
+      new HCS10Plugin(),
+      new HCS2Plugin(),
+      new InscribePlugin()
+    ]
+  },
+  openAIApiKey: process.env.OPENAI_API_KEY!
+});
+```
+
+## Resources
+
+- [Conversational Agent Documentation](https://hashgraphonline.com/docs/libraries/conversational-agent/)
+- [Standards Agent Kit Documentation](https://hashgraphonline.com/docs/libraries/standards-agent-kit/)
+- [HCS Standards Documentation](https://hcs-improvement-proposals.pages.dev/docs/standards)
+- [GitHub Repository](https://github.com/hashgraph-online/conversational-agent)
+
+## License
+
+Apache-2.0

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

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

package/dist/cjs/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;
+}