@hashgraphonline/standards-agent-kit 0.2.162 → 0.2.165

package/README.md

@@ -162,6 +162,74 @@ The SDK provides a comprehensive set of tools for HCS-10 agent operations:
 - **AcceptConnectionRequestTool**: Accept incoming connections
 - **ListUnapprovedConnectionRequestsTool**: View pending requests
 
+## Registry Broker Plugin
+
+The `RegistryBrokerPlugin` bridges the [`RegistryBrokerClient`](https://hashgraphonline.com/docs/registry-broker/api/client) inside every Hedera Agent Kit integration. Once registered, agents can call *any* broker endpoint (search, chat, registration, UAID utilities, ledger auth, credits, encryption) through a single tool. The plugin automatically reuses shared credentials and keeps encrypted chat handles alive via `conversation.*` operations.
+
+```ts
+import { PluginRegistry } from 'hedera-agent-kit';
+import { RegistryBrokerPlugin } from '@hashgraphonline/standards-agent-kit';
+
+const pluginRegistry = new PluginRegistry();
+pluginRegistry.register(
+  new RegistryBrokerPlugin(),
+);
+```
+
+Configure credentials via `registryBroker` plugin config or environment variables:
+
+```ts
+const plugin = new RegistryBrokerPlugin();
+await plugin.initialize({
+  config: {
+    hederaKit,
+    registryBroker: {
+      client: {
+        baseUrl: process.env.REGISTRY_BROKER_BASE_URL,
+        apiKey: process.env.REGISTRY_BROKER_API_KEY,
+      },
+    },
+  },
+  logger,
+});
+```
+
+> **Env Fallbacks**
+>
+> - `REGISTRY_BROKER_API_KEY` / `RB_API_KEY`
+> - `REGISTRY_BROKER_BASE_URL`
+> - `REGISTRY_BROKER_LEDGER_ACCOUNT_ID`, `REGISTRY_BROKER_LEDGER_NETWORK`, `REGISTRY_BROKER_LEDGER_PRIVATE_KEY` (or `HEDERA_ACCOUNT_ID` / `HEDERA_PRIVATE_KEY`) – enables automatic ledger authentication if no API key is supplied.
+
+Every operation is invoked through `registry_broker_operation`:
+
+```ts
+const [registryTool] = plugin.getTools();
+
+// Discovery
+await registryTool._call({
+  operation: 'search',
+  payload: { q: 'openrouter', limit: 5 },
+});
+
+// Chat with broker-managed UAIDs
+const session = await registryTool._call({
+  operation: 'chat.createSession',
+  payload: {
+    uaid: 'uaid:aid:2bnewJwP95isoCUkT5mee5gm212WS76tphHwBQvbWoquRa9kt89UanrBqHXpaSh4AN;uid=anthropic/claude-3.5-sonnet;registry=openrouter;proto=openrouter;nativeId=anthropic/claude-3.5-sonnet',
+    historyTtlSeconds: 900,
+  },
+});
+await registryTool._call({
+  operation: 'chat.sendMessage',
+  payload: {
+    sessionId: JSON.parse(session).result.sessionId,
+    message: 'Hello from the Hedera Agent Kit plugin!',
+  },
+});
+```
+
+For encrypted chat flows, call `chat.start`, `chat.createEncryptedSession`, or `chat.acceptEncryptedSession`. The plugin returns a `handleId`; subsequent `conversation.send`, `conversation.decryptHistoryEntry`, and `conversation.release` operations reuse that state without exposing the raw `ChatConversationHandle`.
+
 ## Plugin Development
 
 Create custom plugins by extending the base plugin interface:

package/dist/cjs/builders/inscriber/inscriber-builder.d.ts

@@ -27,7 +27,7 @@ export interface CompletedInscriptionResponse {
 /**
  * Builder for Inscription operations
  */
-type InscriptionSDKInstance = InstanceType<typeof InscriptionSDK>;
+type InscriptionSDKInstance = InscriptionSDK;
 export declare const toDashedTransactionId: (transactionId: string) => string;
 export declare class InscriberBuilder extends BaseServiceBuilder {
     protected inscriptionSDK?: InscriptionSDKInstance;
@@ -59,7 +59,7 @@ export declare class InscriberBuilder extends BaseServiceBuilder {
     /**
      * Get or create Inscription SDK
      */
-    protected getInscriptionSDK(_options: InscriptionOptions): Promise<InscriptionSDKInstance | null>;
+    protected getInscriptionSDK(options: InscriptionOptions): Promise<InscriptionSDKInstance | null>;
     /**
      * Inscribe content using server-side authentication
      */