@hashgraphonline/conversational-agent 0.2.103 → 0.2.105

package/README.md

@@ -133,7 +133,7 @@ When using `returnBytes` mode:
 
 - **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
+- **Core Plugin Suite**: HCS10Plugin, HCS2Plugin, InscribePlugin, and HbarPlugin
 - **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
@@ -188,16 +188,19 @@ The Conversational Agent includes all tools from the `hedera-agent-kit` v2 packa
 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
+# Run the interactive CLI from the source workspace
 pnpm cli
 
-# Or with environment variables
+# Or invoke the published binary with npx (no local build required)
+npx @hashgraphonline/conversational-agent
+
+# Provide credentials via environment variables (works for pnpm cli and npx)
 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
+# Supply configuration through CLI flags
 pnpm cli -- --account-id=0.0.12345 --private-key=... --openai-api-key=sk-...
 ```
 
@@ -210,13 +213,34 @@ pnpm cli -- --account-id=0.0.12345 --private-key=... --openai-api-key=sk-...
 - 🚀 **Fast & Responsive** - Built with React for smooth interactions
 - 📊 **Transaction Details** - See transaction IDs and network responses
 
+### Headless Mode
+
+Use the same executable to run a single command without the interactive UI. Headless mode activates automatically when you pass a command argument or when the CLI receives non-interactive input.
+
+```bash
+# Pass the command immediately after the binary
+npx @hashgraphonline/conversational-agent "Register me as an AI agent named TestBot"
+
+# Or use the explicit flag (useful when the command contains leading dashes)
+npx @hashgraphonline/conversational-agent \
+  --account-id=0.0.12345 \
+  --private-key=... \
+  --openai-api-key=sk-... \
+  --command "Transfer 1 HBAR to 0.0.800"
+
+# From the workspace helper script
+pnpm cli -- --command "Find my pending connection requests"
+```
+
+Headless execution prints structured output prefixed with the speaker (for example `[assistant]`, `[error]`, `[transaction]`) and returns a non-zero exit code when an error occurs. This makes it suitable for automation, CI tasks, or scripting flows that need machine-readable 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.
+See the [Conversational Agent documentation](https://hashgraphonline.com/docs/libraries/conversational-agent/) for detailed plugin development guidance.
 
 ```typescript
 import {
@@ -320,28 +344,39 @@ const response = await agent.processMessage(
 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).
+For more details, see the [Conversational Agent documentation](https://hashgraphonline.com/docs/libraries/conversational-agent/).
 
 ## 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           |
+| 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'`, `'testnet'`, or `'previewnet'`) |
+| `openAIApiKey` | string | **required** | API key used for the default LLM provider and entity memory |
+| `openAIModelName` | string | `'gpt-4o'` | Preferred OpenAI model when `llmProvider` is `openai` |
+| `llmProvider` | `'openai' \| 'anthropic' \| 'openrouter'` | `'openai'` | Primary LLM provider for conversational responses |
+| `verbose` | boolean | false | Enable verbose logging |
+| `operationalMode` | `AgentOperationalMode` | `'autonomous'` | `'autonomous'` or `'returnBytes'` |
+| `userAccountId` | string | undefined | Account ID applied to scheduled transactions in returnBytes mode |
+| `customSystemMessagePreamble` | string | Hashgraph Online system prompt | 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 automatically in returnBytes mode |
+| `mirrorNodeConfig` | `MirrorNodeConfig` | undefined | Custom mirror node configuration |
+| `disableLogging` | boolean | false | Disable all logging |
+| `enabledPlugins` | string[] | undefined | Filter which plugins to enable by ID |
+| `toolFilter` | `(tool: { name: string; namespace?: string }) => boolean` | undefined | Predicate to include or exclude tools dynamically |
+| `mcpServers` | `MCPServerConfig[]` | undefined | Configure MCP servers for Model Context Protocol support |
+| `walletExecutor` | `(base64, network) => Promise<{ transactionId: string }>` | undefined | Custom executor for wallet-driven transaction submission |
+| `customSignerFactory` | `(args) => AbstractSigner` | undefined | Override signer selection when initializing the agent |
+| `entityMemoryEnabled` | boolean | true | Enable automatic entity extraction and storage |
+| `entityMemoryConfig` | `SmartMemoryConfig` | undefined | Custom configuration for entity memory |
+| `entityMemoryProvider` | `'openai' \| 'anthropic' \| 'openrouter'` | Matches `llmProvider` | Provider used for entity extraction and resolution |
+| `entityMemoryModelName` | string | Provider-specific default | Override model used for entity memory operations |
+| `openRouterApiKey` | string | undefined | API key when using OpenRouter (falls back to `openAIApiKey`) |
+| `openRouterBaseURL` | string | `'https://openrouter.ai/api/v1'` | Base URL for OpenRouter requests |
 
 ## Environment Variables
 
@@ -369,6 +404,7 @@ await agent.initialize();
 const hcs10Plugin = agent.hcs10Plugin;
 const hcs2Plugin = agent.hcs2Plugin;
 const inscribePlugin = agent.inscribePlugin;
+const hbarPlugin = agent.hbarPlugin;
 
 // Access the underlying Hedera agent
 const hederaAgent = agent.getConversationalAgent();
@@ -421,6 +457,7 @@ const hcs2Agent = ConversationalAgent.withHCS2({
 // ConversationalAgent.withSmartContract() - Only smart contract tools
 // ConversationalAgent.withAllStandards() - All HCS standards plugins (HCS-10, HCS-2, Inscribe)
 // ConversationalAgent.minimal() - Only basic account tools
+// ConversationalAgent.withMCP(options, mcpServers) - Configure Model Context Protocol servers
 ```
 
 ### Plugin Filtering
@@ -441,7 +478,7 @@ const agent = new ConversationalAgent({
 Available plugin IDs:
 
 - Standard plugins: `hcs-10`, `hcs-2`, `inscribe`
-- Core Hedera plugins: `hts-token`, `account`, `file-service`, `consensus-service`, `smart-contract`, `network`
+- Core Hedera plugins: `hts-token`, `account`, `file-service`, `consensus-service`, `smart-contract`, `network`, `hbar`
 
 ### Legacy Plugin Usage (hedera-agent-kit 2.0.3 only)
 
@@ -490,7 +527,7 @@ If you've created a plugin that extends the Conversational Agent's capabilities,
 
 2. **Create Your Plugin**
    - Place your plugin in `src/plugins/community/[your-plugin-name]/`
-   - Follow the plugin structure outlined in the [Plugin Development Guide](docs/PLUGIN_DEVELOPMENT.md)
+   - Follow the plugin structure outlined in the [Conversational Agent documentation](https://hashgraphonline.com/docs/libraries/conversational-agent/)
    - Include comprehensive tests in `src/plugins/community/[your-plugin-name]/__tests__/`
    - Add documentation in `src/plugins/community/[your-plugin-name]/README.md`
 
@@ -545,7 +582,7 @@ src/plugins/community/your-plugin/
 
 ### Getting Help
 
-- Join our [Discord community](https://discord.gg/hashgraphonline) for discussions
+- Join our [Telegram community](https://t.me/hashinals) for discussions
 - Check existing issues and PRs before starting work
 - Ask questions in the #development channel
 - Review the [HCS Standards](https://hashgraphonline.com/docs/standards) for protocol details

package/cli/dist/CLIApp.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import { type Network } from './types';
+interface Props {
+    accountId?: string;
+    privateKey?: string;
+    network?: Network;
+    openAIApiKey?: string;
+}
+export declare const CLIApp: React.FC<Props>;
+export {};
+//# sourceMappingURL=CLIApp.d.ts.map

package/cli/dist/CLIApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CLIApp.d.ts","sourceRoot":"","sources":["../src/CLIApp.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuC,MAAM,OAAO,CAAC;AAO5D,OAAO,EAA4B,KAAK,OAAO,EAAC,MAAM,SAAS,CAAC;AAEhE,UAAU,KAAK;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAiKlC,CAAC"}

package/cli/dist/CLIApp.js

@@ -0,0 +1,128 @@
+import React, { useState, useMemo, useCallback } from 'react';
+import { useApp } from 'ink';
+import { ScreenRouter } from './components/ScreenRouter';
+import { ConfigManager } from './managers/ConfigManager';
+import { AgentManager } from './managers/AgentManager';
+import { useStableState } from './hooks/useStableState';
+import { useInitializeAgent } from './hooks/useInitializeAgent';
+export const CLIApp = props => {
+    const { exit } = useApp();
+    const configManager = useMemo(() => ConfigManager.getInstance(), []);
+    const agentManager = useMemo(() => AgentManager.getInstance(), []);
+    const initialConfig = useMemo(() => configManager.getConfig(props), [
+        configManager,
+        props.accountId,
+        props.privateKey,
+        props.network,
+        props.openAIApiKey,
+    ]);
+    const initialMcpServers = useMemo(() => configManager.getMCPServers(), [configManager]);
+    const { state, actions } = useStableState(initialMcpServers);
+    const [currentConfig, setCurrentConfig] = useState(initialConfig);
+    const initializeAgent = useInitializeAgent({
+        configManager,
+        agentManager,
+        actions,
+    });
+    const handleInitializeAgent = useCallback(() => {
+        initializeAgent(currentConfig, state.mcpConfig);
+    }, [initializeAgent, currentConfig, state.mcpConfig]);
+    const sendMessage = useCallback(async (message) => {
+        if (!message.trim())
+            return;
+        const userMessage = {
+            role: 'user',
+            content: message,
+            timestamp: new Date(),
+        };
+        actions.addMessages([userMessage]);
+        actions.setInput('');
+        actions.setLoading(true);
+        try {
+            const chatHistory = state.messages
+                .filter((m) => m.role !== 'system')
+                .map((m) => ({
+                type: m.role === 'user' ? 'human' : 'ai',
+                content: m.content,
+            }));
+            const response = await agentManager.sendMessage(message, chatHistory);
+            const assistantMessage = {
+                role: 'assistant',
+                content: response.message ||
+                    response.output ||
+                    response.error ||
+                    'No response received',
+                timestamp: new Date(),
+            };
+            const newMessages = [assistantMessage];
+            if (response.transactionId) {
+                newMessages.push({
+                    role: 'system',
+                    content: `Transaction ID: ${response.transactionId}`,
+                    timestamp: new Date(),
+                });
+            }
+            if (response.scheduleId) {
+                newMessages.push({
+                    role: 'system',
+                    content: `Schedule ID: ${response.scheduleId}`,
+                    timestamp: new Date(),
+                });
+            }
+            if (response.notes && response.notes.length > 0) {
+                response.notes.forEach((note) => {
+                    newMessages.push({
+                        role: 'system',
+                        content: note,
+                        timestamp: new Date(),
+                    });
+                });
+            }
+            actions.addMessages(newMessages);
+        }
+        catch (err) {
+            actions.addMessages([
+                {
+                    role: 'system',
+                    content: `Error: ${err instanceof Error ? err.message : 'Unknown error'}`,
+                    timestamp: new Date(),
+                },
+            ]);
+        }
+        finally {
+            actions.setLoading(false);
+        }
+    }, [agentManager, state.messages, actions]);
+    const updateConfig = (field, value) => {
+        const updated = { ...currentConfig, [field]: value };
+        setCurrentConfig(updated);
+    };
+    const saveMCPConfig = () => {
+        const servers = [];
+        if (state.mcpConfig.enableFilesystem) {
+            const filesystemServer = {
+                name: 'filesystem',
+                command: 'npx',
+                args: [
+                    '-y',
+                    '@modelcontextprotocol/server-filesystem',
+                    state.mcpConfig.filesystemPath,
+                ],
+                transport: 'stdio',
+                autoConnect: true,
+            };
+            servers.push(filesystemServer);
+        }
+        servers.push(...state.mcpConfig.customServers);
+        configManager.saveMCPConfig(servers);
+    };
+    const stableHandlers = useMemo(() => ({
+        initializeAgent: handleInitializeAgent,
+        sendMessage,
+        updateConfig,
+        saveMCPConfig,
+        getMCPConfigPath: () => configManager.getMCPConfigPathForDisplay(),
+    }), [handleInitializeAgent, sendMessage]);
+    return (React.createElement(ScreenRouter, { state: state, currentConfig: currentConfig, actions: actions, stableHandlers: stableHandlers, exit: exit }));
+};
+//# sourceMappingURL=CLIApp.js.map

package/cli/dist/CLIApp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CLIApp.js","sourceRoot":"","sources":["../src/CLIApp.tsx"],"names":[],"mappings":"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"}

package/cli/dist/LocalConversationalAgent.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Minimal ConversationalAgent implementation for CLI use
+ * This avoids complex dependencies while providing the core functionality
+ *
+ * For local development, this allows the CLI to work without needing to publish
+ * the main package, while still providing a functional demo of the interface.
+ */
+export interface ConversationalAgentOptions {
+    accountId: string;
+    privateKey: string;
+    network: 'testnet' | 'mainnet';
+    openAIApiKey: string;
+    openAIModelName?: string;
+    plugins?: any[];
+    verbose?: boolean;
+}
+export interface AgentResponse {
+    message?: string;
+    output?: string;
+    error?: string;
+    transactionId?: string;
+    scheduleId?: string;
+    notes?: string[];
+}
+export declare class ConversationalAgent {
+    private config;
+    private initialized;
+    constructor(config: ConversationalAgentOptions);
+    initialize(): Promise<void>;
+    processMessage(message: string, _chatHistory?: Array<{
+        type: 'human' | 'ai';
+        content: string;
+    }>): Promise<AgentResponse>;
+}
+export declare class OpenConvAIPlugin {
+    constructor();
+}

package/cli/dist/LocalConversationalAgent.js

@@ -0,0 +1,58 @@
+/**
+ * Minimal ConversationalAgent implementation for CLI use
+ * This avoids complex dependencies while providing the core functionality
+ *
+ * For local development, this allows the CLI to work without needing to publish
+ * the main package, while still providing a functional demo of the interface.
+ */
+export class ConversationalAgent {
+    constructor(config) {
+        Object.defineProperty(this, "config", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "initialized", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        this.config = config;
+    }
+    async initialize() {
+        if (!this.config.accountId || !this.config.privateKey || !this.config.openAIApiKey) {
+            throw new Error('Missing required configuration: accountId, privateKey, or openAIApiKey');
+        }
+        await new Promise(resolve => setTimeout(resolve, 500));
+        this.initialized = true;
+    }
+    async processMessage(message, _chatHistory) {
+        if (!this.initialized) {
+            throw new Error('Agent not initialized. Call initialize() first.');
+        }
+        const responses = [
+            "I'm a demo version of the Conversational Agent. In the full version, I would help you interact with the Hedera network.",
+            "This CLI demonstrates the interface for the Hashgraph Online Conversational Agent. Full functionality requires the complete implementation.",
+            "I understand you want to use Hedera network features. The production version would process this request using real network calls.",
+            "Demo mode: Your message has been received. The full agent would analyze this and execute appropriate Hedera operations.",
+            "This is a placeholder response. The actual Conversational Agent would provide real Hedera network functionality."
+        ];
+        const randomResponse = responses[Math.floor(Math.random() * responses.length)];
+        return {
+            message: randomResponse,
+            output: `Demo response for: ${message}`,
+            notes: [
+                `Connected to ${this.config.network}`,
+                `Using account ${this.config.accountId}`,
+                `Model: ${this.config.openAIModelName || 'gpt-4o-mini'}`,
+                'Running in CLI demo mode'
+            ]
+        };
+    }
+}
+export class OpenConvAIPlugin {
+    constructor() {
+    }
+}

package/cli/dist/app.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+import { type Network } from './types';
+type Props = {
+    accountId?: string;
+    privateKey?: string;
+    network?: Network;
+    openAIApiKey?: string;
+};
+/**
+ * Main App component for the Hashgraph Online Conversational Agent CLI
+ * @param accountId - Hedera account ID
+ * @param privateKey - Hedera private key
+ * @param network - Network to connect to (testnet or mainnet)
+ * @param openAIApiKey - OpenAI API key for the conversational agent
+ */
+export default function App({ accountId, privateKey, network, openAIApiKey, }: Props): React.JSX.Element;
+export {};
+//# sourceMappingURL=app.d.ts.map

package/cli/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAC,KAAK,OAAO,EAAC,MAAM,SAAS,CAAC;AAErC,KAAK,KAAK,GAAG;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAIF;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,GAAG,CAAC,EAC3B,SAAS,EACT,UAAU,EACV,OAAmB,EACnB,YAAY,GACZ,EAAE,KAAK,qBASP"}

package/cli/dist/app.js

@@ -0,0 +1,14 @@
+import React from 'react';
+import { CLIApp } from './CLIApp';
+process.setMaxListeners(20);
+/**
+ * Main App component for the Hashgraph Online Conversational Agent CLI
+ * @param accountId - Hedera account ID
+ * @param privateKey - Hedera private key
+ * @param network - Network to connect to (testnet or mainnet)
+ * @param openAIApiKey - OpenAI API key for the conversational agent
+ */
+export default function App({ accountId, privateKey, network = 'testnet', openAIApiKey, }) {
+    return (React.createElement(CLIApp, { accountId: accountId, privateKey: privateKey, network: network, openAIApiKey: openAIApiKey }));
+}
+//# sourceMappingURL=app.js.map

package/cli/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAC,MAAM,EAAC,MAAM,UAAU,CAAC;AAUhC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;AAE5B;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,GAAG,CAAC,EAC3B,SAAS,EACT,UAAU,EACV,OAAO,GAAG,SAAS,EACnB,YAAY,GACL;IACP,OAAO,CACN,oBAAC,MAAM,IACN,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,YAAY,GACzB,CACF,CAAC;AACH,CAAC"}

package/cli/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/cli/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.tsx"],"names":[],"mappings":""}

package/cli/dist/cli.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+import React from 'react';
+import { render } from 'ink';
+import meow from 'meow';
+import App from './app';
+import { runHeadless } from './headless-runner';
+const cli = meow(`
+	Usage
+	  $ conversational-agent
+
+	Options
+		--account-id       Hedera account ID (e.g., 0.0.12345)
+		--private-key      Private key for the account
+		--network          Network to connect to (mainnet or testnet) [default: testnet]
+		--openai-api-key   OpenAI API key for the LLM
+		--command          Execute a single command in headless mode
+
+	Examples
+	  $ conversational-agent
+	  Interactive mode - will prompt for configuration
+
+	  $ conversational-agent --account-id=0.0.12345 --private-key=... --openai-api-key=sk-...
+	  Start with provided configuration
+
+	  $ export HEDERA_ACCOUNT_ID=0.0.12345
+	  $ export HEDERA_PRIVATE_KEY=...
+	  $ export OPENAI_API_KEY=sk-...
+	  $ conversational-agent
+	  Uses environment variables for Hedera credentials
+`, {
+    importMeta: import.meta,
+    flags: {
+        accountId: {
+            type: 'string',
+            default: process.env['HEDERA_ACCOUNT_ID'] || '',
+        },
+        privateKey: {
+            type: 'string',
+            default: process.env['HEDERA_PRIVATE_KEY'] || '',
+        },
+        network: {
+            type: 'string',
+            default: process.env['HEDERA_NETWORK'] || 'testnet',
+            choices: ['testnet', 'mainnet'],
+        },
+        openaiApiKey: {
+            type: 'string',
+            default: process.env['OPENAI_API_KEY'] || '',
+        },
+        command: {
+            type: 'string',
+            default: '',
+        },
+    },
+});
+const commandInput = (cli.flags.command || cli.input.join(' ')).trim();
+const shouldRunHeadless = commandInput.length > 0 || !process.stdin.isTTY;
+const parseNetwork = (value) => value === 'mainnet' ? 'mainnet' : 'testnet';
+const selectedNetwork = parseNetwork(cli.flags.network);
+if (shouldRunHeadless) {
+    (async () => {
+        try {
+            const result = await runHeadless({
+                accountId: cli.flags.accountId,
+                privateKey: cli.flags.privateKey,
+                network: selectedNetwork,
+                openAIApiKey: cli.flags.openaiApiKey,
+                command: commandInput,
+            });
+            if (result.stdout) {
+                const output = result.stdout.endsWith('\n') ? result.stdout : `${result.stdout}\n`;
+                process.stdout.write(output);
+            }
+            process.exit(result.exitCode);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            process.stderr.write(`${message}\n`);
+            process.exit(1);
+        }
+    })();
+}
+else {
+    const { waitUntilExit } = render(React.createElement(App, { accountId: cli.flags.accountId, privateKey: cli.flags.privateKey, network: selectedNetwork, openAIApiKey: cli.flags.openaiApiKey }));
+    waitUntilExit().then(() => process.exit(0));
+}
+//# sourceMappingURL=cli.js.map

package/cli/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.tsx"],"names":[],"mappings":";AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAC,MAAM,EAAC,MAAM,KAAK,CAAC;AAC3B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,GAAG,MAAM,OAAO,CAAC;AACxB,OAAO,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AAG9C,MAAM,GAAG,GAAG,IAAI,CACf;;;;;;;;;;;;;;;;;;;;;;;CAuBA,EACA;IACC,UAAU,EAAE,MAAM,CAAC,IAAI;IACvB,KAAK,EAAE;QACN,SAAS,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,EAAE;SAC/C;QACD,UAAU,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,EAAE;SAChD;QACD,OAAO,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,SAAS;YACnD,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;SAC/B;QACD,YAAY,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE;SAC5C;QACD,OAAO,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,EAAE;SACX;KACD;CACD,CACD,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACvE,MAAM,iBAAiB,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;AAE1E,MAAM,YAAY,GAAG,CAAC,KAAa,EAAW,EAAE,CAC/C,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAE7C,MAAM,eAAe,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAExD,IAAI,iBAAiB,EAAE,CAAC;IACvB,CAAC,KAAK,IAAI,EAAE;QACX,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;gBAChC,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,SAAS;gBAC9B,UAAU,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU;gBAChC,OAAO,EAAE,eAAe;gBACxB,YAAY,EAAE,GAAG,CAAC,KAAK,CAAC,YAAY;gBACpC,OAAO,EAAE,YAAY;aACrB,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBACnB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC;gBACnF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC9B,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;IACF,CAAC,CAAC,EAAE,CAAC;AACN,CAAC;KAAM,CAAC;IACP,MAAM,EAAC,aAAa,EAAC,GAAG,MAAM,CAC7B,oBAAC,GAAG,IACH,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,SAAS,EAC9B,UAAU,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU,EAChC,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,GAAG,CAAC,KAAK,CAAC,YAAY,GACnC,CACF,CAAC;IAEF,aAAa,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC"}

package/cli/dist/components/AppContainer.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import { type Config } from '../types.js';
+import { type AppState } from '../hooks/useStableState.js';
+interface Props {
+    state: AppState;
+    currentConfig: Config;
+    actions: any;
+    stableHandlers: any;
+    exit: () => void;
+}
+/**
+ * App container that keeps all screens mounted but only displays one
+ * This prevents unmounting/remounting which causes double renders
+ */
+export declare const AppContainer: React.FC<Props>;
+export {};

package/cli/dist/components/AppContainer.js

@@ -0,0 +1,24 @@
+import React from 'react';
+import { Box } from 'ink';
+import { WelcomeScreen } from './WelcomeScreen.js';
+import { ChatScreen } from './ChatScreen.js';
+import { LoadingScreen } from './LoadingScreen.js';
+import { SetupScreen } from './SetupScreen.js';
+import { MCPConfigScreen } from './MCPConfigScreen.js';
+/**
+ * App container that keeps all screens mounted but only displays one
+ * This prevents unmounting/remounting which causes double renders
+ */
+export const AppContainer = ({ state, currentConfig, actions, stableHandlers, exit, }) => {
+    return (React.createElement(React.Fragment, null,
+        React.createElement(Box, { display: state.screen === 'welcome' ? 'flex' : 'none' },
+            React.createElement(WelcomeScreen, { config: currentConfig, onExit: exit, onInitializeAgent: stableHandlers.initializeAgent, onSetScreen: actions.setScreen })),
+        React.createElement(Box, { display: state.screen === 'loading' ? 'flex' : 'none' },
+            React.createElement(LoadingScreen, null)),
+        React.createElement(Box, { display: state.screen === 'setup' ? 'flex' : 'none' },
+            React.createElement(SetupScreen, { config: currentConfig, currentField: state.currentField, error: state.error, onUpdateConfig: stableHandlers.updateConfig, onSetCurrentField: actions.setCurrentField, onInitializeAgent: stableHandlers.initializeAgent })),
+        React.createElement(Box, { display: state.screen === 'mcp-config' ? 'flex' : 'none' },
+            React.createElement(MCPConfigScreen, { mcpConfig: state.mcpConfig, editingFilesystemPath: state.editingFilesystemPath, onSetMcpConfig: actions.setMcpConfig, onSetEditingFilesystemPath: actions.setEditingFilesystemPath, onSetScreen: actions.setScreen, onSaveMCPConfig: stableHandlers.saveMCPConfig, getMCPConfigPath: stableHandlers.getMCPConfigPath })),
+        React.createElement(Box, { display: state.screen === 'chat' ? 'flex' : 'none' },
+            React.createElement(ChatScreen, { config: currentConfig, messages: state.messages, input: state.input, isLoading: state.isLoading, setInput: actions.setInput, sendMessage: stableHandlers.sendMessage, showLogs: false, logs: state.logs }))));
+};

package/cli/dist/components/AppScreens.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare const AppScreens: React.FC;