@hashgraphonline/standards-agent-kit 0.2.162 → 0.2.165

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hashgraphonline/standards-agent-kit",
-  "version": "0.2.162",
-  "description": "A modular SDK for building on-chain autonomous agents using Hashgraph Online Standards, including HCS-10 for agent discovery and communication.",
+  "version": "0.2.165",
+  "description": "A modular SDK for building on-chain autonomous agents using Hashgraph Online Standards, including HCS-10 for agent discovery and communication. https://hol.org",
   "type": "module",
   "main": "./dist/cjs/standards-agent-kit.cjs",
   "module": "./dist/es/standards-agent-kit.es.js",
@@ -21,6 +21,33 @@
     "LICENSE",
     "README.md"
   ],
+  "scripts": {
+    "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 && pnpm run build:umd",
+    "test": "jest",
+    "lint": "eslint . --ext .ts",
+    "lint:fix": "eslint . --ext .ts --fix",
+    "prepare": "pnpm run build",
+    "prepublishOnly": "pnpm run build",
+    "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",
+    "demo:cli": "tsx examples/cli-demo.ts",
+    "demo:interactive": "tsx examples/interactive-demo.ts",
+    "demo:langchain": "tsx examples/langchain-demo.ts",
+    "demo:plugin": "tsx examples/plugin-system-example.ts",
+    "demo:plugin:weather": "tsx examples/plugins/weather/index.ts",
+    "demo:plugin:defi": "tsx examples/plugins/defi/index.ts",
+    "demo:plugin:openconvai": "tsx examples/openconvai-plugin-example.ts",
+    "demo:inscription-quotes": "tsx examples/inscription-quote-demo.ts",
+    "standards-agent:start": "tsx examples/standards-expert/cli.ts -- start",
+    "standards-agent:process-docs": "tsx examples/standards-expert/cli.ts -- process-docs --all-repos",
+    "typecheck": "tsc --noEmit"
+  },
   "keywords": [
     "hedera",
     "hcs10",
@@ -63,7 +90,7 @@
   },
   "dependencies": {
     "@hashgraph/sdk": "^2.72.0",
-    "@hashgraphonline/standards-sdk": "^0.1.110",
+    "@hashgraphonline/standards-sdk": "^0.1.111",
     "@kiloscribe/inscription-sdk": "^1.0.60",
     "@langchain/community": "^0.3.5",
     "@langchain/core": "^0.3.71",
@@ -102,29 +129,10 @@
     "vite-plugin-node-polyfills": "^0.23.0",
     "vite-plugin-string-replace": "^1.1.3"
   },
-  "scripts": {
-    "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 && pnpm run build:umd",
-    "test": "jest",
-    "lint": "eslint . --ext .ts",
-    "lint:fix": "eslint . --ext .ts --fix",
-    "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",
-    "demo:cli": "tsx examples/cli-demo.ts",
-    "demo:interactive": "tsx examples/interactive-demo.ts",
-    "demo:langchain": "tsx examples/langchain-demo.ts",
-    "demo:plugin": "tsx examples/plugin-system-example.ts",
-    "demo:plugin:weather": "tsx examples/plugins/weather/index.ts",
-    "demo:plugin:defi": "tsx examples/plugins/defi/index.ts",
-    "demo:plugin:openconvai": "tsx examples/openconvai-plugin-example.ts",
-    "demo:inscription-quotes": "tsx examples/inscription-quote-demo.ts",
-    "standards-agent:start": "tsx examples/standards-expert/cli.ts -- start",
-    "standards-agent:process-docs": "tsx examples/standards-expert/cli.ts -- process-docs --all-repos",
-    "typecheck": "tsc --noEmit"
+  "packageManager": "pnpm@10.11.1+sha512.e519b9f7639869dc8d5c3c5dfef73b3f091094b0a006d7317353c72b124e80e1afd429732e28705ad6bfa1ee879c1fce46c128ccebd3192101f43dd67c667912",
+  "pnpm": {
+    "overrides": {
+      "@hashgraph/sdk": "2.72.0"
+    }
   }
-}
+}

package/src/builders/inscriber/inscriber-builder.ts

@@ -4,6 +4,7 @@ import {
   inscribe,
   inscribeWithSigner,
   retrieveInscription,
+  getOrCreateSDK,
   InscriptionInput,
   InscriptionOptions,
   InscriptionResponse,
@@ -13,10 +14,10 @@ import {
   getTopicId,
   Logger,
 } from '@hashgraphonline/standards-sdk';
-import {
+import type {
   InscriptionSDK,
-  type InscriptionResult,
-  type RegistrationProgressData,
+  InscriptionResult,
+  RegistrationProgressData,
 } from '@kiloscribe/inscription-sdk';
 import type { AgentOperationalMode } from 'hedera-agent-kit';
 
@@ -46,12 +47,7 @@ export interface CompletedInscriptionResponse {
 /**
  * Builder for Inscription operations
  */
-type InscriptionSDKInstance = InstanceType<typeof InscriptionSDK>;
-type InscriptionSDKAuthParams = Parameters<
-  typeof InscriptionSDK.createWithAuth
->[0];
-type ClientAuthConfig = Extract<InscriptionSDKAuthParams, { type: 'client' }>;
-type ServerAuthConfig = Extract<InscriptionSDKAuthParams, { type: 'server' }>;
+type InscriptionSDKInstance = InscriptionSDK;
 
 export const toDashedTransactionId = (transactionId: string): string => {
   if (transactionId.includes('-')) {
@@ -159,7 +155,7 @@ export class InscriberBuilder extends BaseServiceBuilder {
    * Get or create Inscription SDK
    */
   protected async getInscriptionSDK(
-    _options: InscriptionOptions
+    options: InscriptionOptions
   ): Promise<InscriptionSDKInstance | null> {
     if (this.inscriptionSDK) {
       return this.inscriptionSDK;
@@ -172,55 +168,37 @@ export class InscriberBuilder extends BaseServiceBuilder {
       ? 'mainnet'
       : 'testnet';
     const accountId = this.hederaKit.signer.getAccountId().toString();
+    const operatorKey = this.hederaKit.signer?.getOperatorPrivateKey();
+    const baseOptions: InscriptionOptions = {
+      ...options,
+      network: options.network ?? networkType,
+    };
+
+    const apiKey = baseOptions.apiKey ?? (operatorKey ? undefined : 'public-access');
+    const effectiveOptions: InscriptionOptions = apiKey
+      ? { ...baseOptions, apiKey }
+      : baseOptions;
+
+    const clientConfig = {
+      accountId,
+      privateKey: operatorKey?.toStringRaw() ?? apiKey ?? 'public-access',
+      network: networkType,
+    };
 
     try {
-      this.logger.info('Attempting InscriptionSDK.createWithAuth', {
-        accountId,
-        network: networkType,
-      });
-      const privateKey = this.hederaKit.signer?.getOperatorPrivateKey();
-      if (privateKey) {
-        this.inscriptionSDK = await InscriptionSDK.createWithAuth({
-          type: 'server',
-          accountId,
-          privateKey:
-            privateKey.toStringRaw() as ServerAuthConfig['privateKey'],
-          network: networkType,
-        });
-        this.logger.info('Created InscriptionSDK via createWithAuth', {
-          network: networkType,
-        });
-      }
+      this.inscriptionSDK = await getOrCreateSDK(
+        clientConfig,
+        effectiveOptions,
+        this.inscriptionSDK
+      );
+      return this.inscriptionSDK;
     } catch (error) {
-      this.logger.warn('Failed to create InscriptionSDK with auth', error);
+      this.logger.error('failed to setup sdk', {
+        error: error instanceof Error ? error.message : String(error),
+      });
       this.inscriptionSDK = undefined;
+      return null;
     }
-
-    if (!this.inscriptionSDK) {
-      try {
-        this.logger.info('Creating fallback InscriptionSDK instance', {
-          network: networkType,
-        });
-        this.inscriptionSDK = new InscriptionSDK({
-          apiKey: 'public-access',
-          network: networkType,
-          connectionMode: 'http',
-        });
-        this.logger.info('Created fallback InscriptionSDK instance', {
-          network: networkType,
-        });
-        return this.inscriptionSDK;
-      } catch (fallbackError) {
-        this.logger.error(
-          'Failed to create InscriptionSDK fallback instance',
-          fallbackError
-        );
-      }
-    }
-
-    this.logger.error('failed to setup sdk');
-
-    return null;
   }
 
   /**
@@ -410,6 +388,8 @@ export class InscriberBuilder extends BaseServiceBuilder {
           network
         );
       const transactionId = exec?.transactionId || '';
+      const rawTransactionId = startResponse.tx_id || transactionId;
+      const canonicalTransactionId = toDashedTransactionId(rawTransactionId);
 
       this.logger.info('inscribeAuto wallet execution', {
         transactionId,
@@ -419,9 +399,6 @@ export class InscriberBuilder extends BaseServiceBuilder {
       const shouldWait = options.quoteOnly
         ? false
         : options.waitForConfirmation ?? true;
-      const canonicalTransactionId = toDashedTransactionId(
-        startResponse.tx_id || transactionId
-      );
       if (shouldWait) {
         const maxAttempts =
           (options as { waitMaxAttempts?: number }).waitMaxAttempts ?? 60;
@@ -433,8 +410,6 @@ export class InscriberBuilder extends BaseServiceBuilder {
         let retrieved: RetrievedInscriptionResult | null = null;
         const sdk = await this.getInscriptionSDK(options);
 
-        console.log('got an SDK', sdk);
-
         if (sdk) {
           try {
             retrieved = await sdk.waitForInscription(

package/src/plugins/index.ts

@@ -1,3 +1,4 @@
 export * from './PluginInterface';
 export * from './PluginRegistry';
 export * from './hedera/HbarPricePlugin';
+export * from './registry-broker/RegistryBrokerPlugin';

package/src/plugins/registry-broker/RegistryBrokerClientProvider.ts

@@ -0,0 +1,116 @@
+import {
+  RegistryBrokerClient,
+  type RegistryBrokerClientOptions,
+  type LedgerCredentialAuthOptions,
+} from '@hashgraphonline/standards-sdk/services/registry-broker';
+import type { GenericPluginContext } from '../PluginInterface';
+
+export interface RegistryBrokerLedgerOptions
+  extends LedgerCredentialAuthOptions {
+  autoAuthenticate?: boolean;
+}
+
+export interface RegistryBrokerPluginConfiguration {
+  client?: RegistryBrokerClientOptions;
+  ledger?: RegistryBrokerLedgerOptions;
+}
+
+type ClientFactory = (
+  options: RegistryBrokerClientOptions,
+) => RegistryBrokerClient;
+
+const env = (key: string): string | undefined =>
+  process.env[key]?.trim() || undefined;
+
+export class RegistryBrokerClientProvider {
+  private clientPromise: Promise<RegistryBrokerClient> | null = null;
+
+  constructor(
+    private readonly config: RegistryBrokerPluginConfiguration | undefined,
+    private readonly logger: GenericPluginContext['logger'],
+    private readonly createClient: ClientFactory = options =>
+      new RegistryBrokerClient(options),
+  ) {}
+
+  async getClient(): Promise<RegistryBrokerClient> {
+    if (!this.clientPromise) {
+      this.clientPromise = this.initialiseClient();
+    }
+    return this.clientPromise;
+  }
+
+  private async initialiseClient(): Promise<RegistryBrokerClient> {
+    const options = this.buildClientOptions();
+    const client = this.createClient(options);
+    const ledgerConfig = this.resolveLedgerOptions();
+    if (ledgerConfig) {
+      const { autoAuthenticate, ...authOptions } = ledgerConfig;
+      if (autoAuthenticate === false) {
+        this.logger.info?.(
+          '[RegistryBrokerPlugin] Ledger authentication disabled via configuration.',
+        );
+      } else {
+        await client.authenticateWithLedgerCredentials(authOptions);
+        this.logger.info?.(
+          `[RegistryBrokerPlugin] Authenticated with ledger account ${authOptions.accountId}.`,
+        );
+      }
+    } else if (!options.apiKey) {
+      this.logger.warn?.(
+        '[RegistryBrokerPlugin] Neither REGISTRY_BROKER_API_KEY nor ledger credentials were provided. Paid endpoints will fail.',
+      );
+    }
+    return client;
+  }
+
+  private buildClientOptions(): RegistryBrokerClientOptions {
+    const merged: RegistryBrokerClientOptions = {
+      ...this.config?.client,
+    };
+    merged.baseUrl =
+      merged.baseUrl ?? env('REGISTRY_BROKER_BASE_URL') ?? merged.baseUrl;
+    merged.apiKey =
+      this.normalizeSecret(this.config?.client?.apiKey) ??
+      this.normalizeSecret(env('REGISTRY_BROKER_API_KEY')) ??
+      this.normalizeSecret(env('RB_API_KEY')) ??
+      merged.apiKey;
+    merged.ledgerApiKey =
+      this.normalizeSecret(this.config?.client?.ledgerApiKey) ??
+      this.normalizeSecret(env('REGISTRY_BROKER_LEDGER_KEY')) ??
+      merged.ledgerApiKey;
+    return merged;
+  }
+
+  private normalizeSecret(value?: string): string | undefined {
+    if (!value) {
+      return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+  }
+
+  private resolveLedgerOptions(): RegistryBrokerLedgerOptions | undefined {
+    if (this.config?.ledger) {
+      return this.config.ledger;
+    }
+    const accountId =
+      env('REGISTRY_BROKER_LEDGER_ACCOUNT_ID') ?? env('HEDERA_ACCOUNT_ID');
+    const hederaPrivateKey =
+      env('REGISTRY_BROKER_LEDGER_PRIVATE_KEY') ?? env('HEDERA_PRIVATE_KEY');
+    const evmPrivateKey =
+      env('REGISTRY_BROKER_LEDGER_EVM_PRIVATE_KEY') ?? env('ETH_PK');
+    const network =
+      env('REGISTRY_BROKER_LEDGER_NETWORK') ??
+      env('HEDERA_NETWORK') ??
+      'hedera:testnet';
+    if (accountId && network && (hederaPrivateKey || evmPrivateKey)) {
+      return {
+        accountId,
+        network,
+        hederaPrivateKey,
+        evmPrivateKey,
+      };
+    }
+    return undefined;
+  }
+}

package/src/plugins/registry-broker/RegistryBrokerConversationStore.ts

@@ -0,0 +1,46 @@
+import type {
+  ChatConversationHandle,
+  ConversationMode,
+  SessionEncryptionSummary,
+} from '@hashgraphonline/standards-sdk/services/registry-broker';
+
+export interface StoredConversationHandle {
+  handleId: string;
+  sessionId: string;
+  mode: ConversationMode;
+  summary: SessionEncryptionSummary | null | undefined;
+}
+
+export class RegistryBrokerConversationStore {
+  private readonly handles = new Map<string, ChatConversationHandle>();
+
+  register(handle: ChatConversationHandle): StoredConversationHandle {
+    const handleId = this.createHandleId();
+    this.handles.set(handleId, handle);
+    return {
+      handleId,
+      sessionId: handle.sessionId,
+      mode: handle.mode,
+      summary: handle.summary ?? null,
+    };
+  }
+
+  get(handleId: string): ChatConversationHandle {
+    const handle = this.handles.get(handleId);
+    if (!handle) {
+      throw new Error(`Conversation handle not found: ${handleId}`);
+    }
+    return handle;
+  }
+
+  release(handleId: string): boolean {
+    return this.handles.delete(handleId);
+  }
+
+  private createHandleId(): string {
+    if (typeof globalThis.crypto?.randomUUID === 'function') {
+      return globalThis.crypto.randomUUID();
+    }
+    return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
+  }
+}