@hashgraphonline/conversational-agent 0.2.103 → 0.2.105

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

@@ -1,4 +1,4 @@
-import { BasePlugin, AgentOperationalMode, MirrorNodeConfig } from 'hedera-agent-kit';
+import { BasePlugin, AbstractSigner, AgentOperationalMode, MirrorNodeConfig } from 'hedera-agent-kit';
 import { Logger, NetworkType } from '@hashgraphonline/standards-sdk';
 import { createAgent } from './agent-factory';
 import { ChatResponse } from './base-agent';
@@ -6,6 +6,7 @@ import { HCS10Plugin } from './plugins/hcs-10/HCS10Plugin';
 import { HCS2Plugin } from './plugins/hcs-2/HCS2Plugin';
 import { InscribePlugin } from './plugins/inscribe/InscribePlugin';
 import { HbarPlugin } from './plugins/hbar/HbarPlugin';
+import { WebBrowserPlugin } from './plugins/web-browser/WebBrowserPlugin';
 import { IStateManager } from '@hashgraphonline/standards-agent-kit';
 import { MCPServerConfig, MCPConnectionStatus } from './mcp/types';
 import { ContentStoreManager } from './services/content-store-manager';
@@ -40,11 +41,21 @@ export interface ConversationalAgentOptions {
     mirrorNodeConfig?: MirrorNodeConfig;
     disableLogging?: boolean;
     enabledPlugins?: string[];
+    disabledPlugins?: string[];
     toolFilter?: (tool: {
         name: string;
         namespace?: string;
     }) => boolean;
     mcpServers?: MCPServerConfig[];
+    walletExecutor?: (base64: string, network: 'mainnet' | 'testnet') => Promise<{
+        transactionId: string;
+    }>;
+    /** Optional: provide a signer factory to override default signer selection */
+    customSignerFactory?: (args: {
+        operationalMode: AgentOperationalMode;
+        accountId: string;
+        network: NetworkType;
+    }) => AbstractSigner;
     /** Enable automatic entity memory functionality (default: true) */
     entityMemoryEnabled?: boolean;
     /** Configuration for entity memory system */
@@ -76,6 +87,7 @@ export declare class ConversationalAgent {
     hcs2Plugin: HCS2Plugin;
     inscribePlugin: InscribePlugin;
     hbarPlugin: HbarPlugin;
+    webBrowserPlugin: WebBrowserPlugin;
     stateManager: IStateManager;
     private options;
     logger: Logger;
@@ -143,7 +155,7 @@ export declare class ConversationalAgent {
     /**
      * Creates the agent configuration object.
      *
-     * @param serverSigner - The server signer instance
+     * @param signer - The signer instance
      * @param llm - The language model instance
      * @param allPlugins - Array of plugins to use
      * @returns Configuration object for creating the agent
@@ -235,5 +247,21 @@ export declare class ConversationalAgent {
      * Clean up resources
      */
     cleanup(): Promise<void>;
+    /**
+     * Switch operational mode
+     */
+    switchMode(mode?: AgentOperationalMode): void;
+    /**
+     * Get usage statistics
+     */
+    getUsageStats(): unknown;
+    /**
+     * Clear usage statistics
+     */
+    clearUsageStats(): void;
+    /**
+     * Shutdown the agent
+     */
+    shutdown(): Promise<void>;
     private extractResponseText;
 }

package/dist/cjs/core/tool-registry.d.ts

@@ -2,6 +2,7 @@ import { StructuredTool } from '@langchain/core/tools';
 import { z } from 'zod';
 import { Logger } from '@hashgraphonline/standards-sdk';
 import { FormValidatingToolWrapper } from '../langchain/form-validating-tool-wrapper';
+import { ToolFieldConfiguration as FG_ToolFieldConfiguration, FieldGuidanceProvider as FG_FieldGuidanceProvider } from '../forms/field-guidance-registry';
 
 /**
  * Tool capabilities configuration for registry entries
@@ -33,6 +34,8 @@ export interface ToolMetadata {
     dependencies: string[];
     schema: unknown;
     entityResolutionPreferences?: EntityResolutionPreferences;
+    fieldGuidance?: FG_ToolFieldConfiguration;
+    fieldGuidanceProvider?: FG_FieldGuidanceProvider;
 }
 /**
  * Registry entry containing tool instance and metadata
@@ -42,6 +45,12 @@ export interface ToolRegistryEntry {
     metadata: ToolMetadata;
     wrapper?: FormValidatingToolWrapper<z.ZodObject<z.ZodRawShape>> | undefined;
     originalTool: StructuredTool;
+    options?: {
+        priority?: ToolCapabilities['priority'];
+        capability?: string;
+        enabled?: boolean;
+        namespace?: string;
+    };
 }
 /**
  * Options for tool registration
@@ -99,6 +108,26 @@ export declare class ToolRegistry {
      * Get all tool names
      */
     getToolNames(): string[];
+    /**
+     * Get tools by priority
+     */
+    getToolsByPriority(priority: ToolCapabilities['priority']): ToolRegistryEntry[];
+    /**
+     * Get enabled tools (all tools are considered enabled by default)
+     */
+    getEnabledTools(): ToolRegistryEntry[];
+    /**
+     * Get tools by namespace/category
+     */
+    getToolsByNamespace(namespace?: string): ToolRegistryEntry[];
+    /**
+     * Check if registry has capability
+     */
+    hasCapability(capability: keyof ToolCapabilities): boolean;
+    /**
+     * Update tool options (metadata)
+     */
+    updateToolOptions(name: string, options: Partial<ToolMetadata>): boolean;
     /**
      * Check if a tool is registered
      */

package/dist/cjs/forms/field-guidance-registry.d.ts

@@ -79,10 +79,29 @@ export interface ToolFieldConfiguration {
  */
 declare class FieldGuidanceRegistry {
     private configurations;
+    private providers;
+    private registerOrderCounter;
+    private logger;
+    constructor();
     /**
      * Register field guidance for a specific tool
      */
     registerToolConfiguration(config: ToolFieldConfiguration): void;
+    /**
+     * Register a provider for dynamic field/global guidance
+     */
+    registerToolProvider(toolPattern: string | RegExp, provider: FieldGuidanceProvider, options?: {
+        id?: string;
+        priority?: number;
+    }): string;
+    /** Unregister a provider by id */
+    unregisterProvider(id: string): void;
+    /** List registered providers */
+    listProviders(): Array<{
+        id: string;
+        priority: number;
+        pattern: string | RegExp;
+    }>;
     /**
      * Get field guidance for a specific tool and field
      */
@@ -103,6 +122,20 @@ declare class FieldGuidanceRegistry {
      * Clear all configurations (useful for testing)
      */
     clear(): void;
+    /** Choose matching provider by priority then last-in wins */
+    private pickMatchingProviders;
+    private safeGetFieldGuidance;
+    private safeGetGlobalGuidance;
+    private mergeGuidance;
 }
 export declare const fieldGuidanceRegistry: FieldGuidanceRegistry;
+/**
+ * Provider interface (optional, for dynamic guidance)
+ */
+export interface FieldGuidanceProvider {
+    getFieldGuidance(fieldName: string, ctx: {
+        toolName: string;
+    }): FieldGuidance | null;
+    getGlobalGuidance?(toolName: string): ToolFieldConfiguration['globalGuidance'] | null;
+}
 export {};