@hashgraphonline/standards-agent-kit 0.2.136 → 0.2.138

package/README.md

@@ -1,6 +1,6 @@
 # Hashgraph Online Standards Agent Kit
 
-| ![](https://hashgraphonline.com/img/logo.png) | A modular SDK for building on-chain autonomous agents using Hashgraph Online Standards, including HCS-10 for agent discovery and communication.<br><br>This SDK is built and maintained by [Hashgraph Online](https://hashgraphonline.com), a consortium of leading Hedera Organizations within the Hedera ecosystem.<br><br>[📚 Standards Agent Kit Documentation](https://hashgraphonline.com/docs/libraries/standards-agent-kit/)<br>[📖 HCS Standards Documentation](https://hcs-improvement-proposals.pages.dev/docs/standards) |
+| ![](https://hashgraphonline.com/img/logo.png) | A modular SDK for building on-chain autonomous agents using Hashgraph Online Standards, including HCS-10 for agent discovery and communication.<br><br>This SDK is built and maintained by [Hashgraph Online](https://hashgraphonline.com), a consortium of leading Hedera Organizations within the Hedera ecosystem.<br><br>[📚 Standards Agent Kit Documentation](https://hashgraphonline.com/docs/libraries/standards-agent-kit/)<br>[📖 HCS Standards Documentation](https://hashgraphonline.com/docs/standards) |
 | :-------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 
 ## Quick Start
@@ -24,7 +24,7 @@ npm install @hashgraphonline/standards-agent-plugin
 For complete documentation, examples, and API references, visit:
 
 - [Standards Agent Kit Documentation](https://hashgraphonline.com/docs/libraries/standards-agent-kit/)
-- [HCS-10 Standard Documentation](https://hcs-improvement-proposals.pages.dev/docs/standards/hcs-10)
+- [HCS-10 Standard Documentation](https://hashgraphonline.com/docs/standards/hcs-10)
 
 ## Features
 
@@ -189,11 +189,10 @@ Please read our [Contributing Guide](CONTRIBUTING.md) before contributing to thi
 ## Resources
 
 - [Standards Agent Kit Documentation](https://hashgraphonline.com/docs/libraries/standards-agent-kit/)
-- [HCS Standards Documentation](https://hcs-improvement-proposals.pages.dev/docs/standards)
+- [HCS Standards Documentation](https://hashgraphonline.com/docs/standards)
 - [Hedera Documentation](https://docs.hedera.com)
 - [GitHub Repository](https://github.com/hashgraph-online/standards-agent-kit)
 
 ## License
 
 Apache-2.0
-

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

@@ -161,6 +161,7 @@ export declare class HCS10Builder extends BaseServiceBuilder {
      * Load profile picture from URL or file path
      */
     private loadProfilePicture;
+    private pollForNewSequence;
     /**
      * Create and register an agent
      */

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

@@ -1,5 +1,6 @@
 import { BaseServiceBuilder, HederaAgentKit } from 'hedera-agent-kit';
-import { HCS2Client, CreateRegistryOptions, RegisterEntryOptions, UpdateEntryOptions, DeleteEntryOptions, MigrateTopicOptions, QueryRegistryOptions, TopicRegistrationResponse, RegistryOperationResponse, TopicRegistry } from '@hashgraphonline/standards-sdk';
+import { HCS2Client, CreateRegistryOptions, RegisterEntryOptions, UpdateEntryOptions, DeleteEntryOptions, MigrateTopicOptions, QueryRegistryOptions, TopicRegistry } from '@hashgraphonline/standards-sdk';
+import { TopicRegistrationResult, RegistryOperationResult, SubmitMessageResult } from '../../types/tx-results';
 /**
  * Builder for HCS-2 operations that delegates to HCS2Client
  */
@@ -14,23 +15,23 @@ export declare class HCS2Builder extends BaseServiceBuilder {
      * Create a new HCS-2 registry
      * Note: This executes the transaction directly via HCS2Client
      */
-    createRegistry(options?: CreateRegistryOptions): Promise<TopicRegistrationResponse>;
+    createRegistry(options?: CreateRegistryOptions): Promise<TopicRegistrationResult>;
     /**
      * Register a new entry in an HCS-2 registry
      */
-    registerEntry(registryTopicId: string, options: RegisterEntryOptions): Promise<RegistryOperationResponse>;
+    registerEntry(registryTopicId: string, options: RegisterEntryOptions): Promise<RegistryOperationResult>;
     /**
      * Update an existing entry in an HCS-2 registry
      */
-    updateEntry(registryTopicId: string, options: UpdateEntryOptions): Promise<RegistryOperationResponse>;
+    updateEntry(registryTopicId: string, options: UpdateEntryOptions): Promise<RegistryOperationResult>;
     /**
      * Delete an entry from an HCS-2 registry
      */
-    deleteEntry(registryTopicId: string, options: DeleteEntryOptions): Promise<RegistryOperationResponse>;
+    deleteEntry(registryTopicId: string, options: DeleteEntryOptions): Promise<RegistryOperationResult>;
     /**
      * Migrate an HCS-2 registry to a new topic
      */
-    migrateRegistry(registryTopicId: string, options: MigrateTopicOptions): Promise<RegistryOperationResponse>;
+    migrateRegistry(registryTopicId: string, options: MigrateTopicOptions): Promise<RegistryOperationResult>;
     /**
      * Query entries from an HCS-2 registry
      */
@@ -38,7 +39,7 @@ export declare class HCS2Builder extends BaseServiceBuilder {
     /**
      * Submit a raw message to an HCS-2 topic
      */
-    submitMessage(topicId: string, payload: any): Promise<any>;
+    submitMessage(topicId: string, payload: any): Promise<SubmitMessageResult>;
     /**
      * Get topic info from mirror node
      */

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

@@ -1,5 +1,6 @@
 import { BaseServiceBuilder, HederaAgentKit } from 'hedera-agent-kit';
-import { HCS6Client, HCS6CreateRegistryOptions, HCS6RegisterEntryOptions, HCS6QueryRegistryOptions, HCS6RegisterOptions, HCS6CreateHashinalOptions, HCS6TopicRegistrationResponse, HCS6RegistryOperationResponse, HCS6TopicRegistry, HCS6CreateHashinalResponse } from '@hashgraphonline/standards-sdk';
+import { HCS6Client, HCS6CreateRegistryOptions, HCS6RegisterEntryOptions, HCS6QueryRegistryOptions, HCS6RegisterOptions, HCS6CreateHashinalOptions, HCS6TopicRegistry, HCS6CreateHashinalResponse } from '@hashgraphonline/standards-sdk';
+import { HCS6TopicRegistrationResult, HCS6RegistryOperationResult } from '../../types/tx-results';
 /**
  * Builder for HCS-6 operations that delegates to HCS6Client
  */
@@ -14,11 +15,11 @@ export declare class HCS6Builder extends BaseServiceBuilder {
      * Create a new HCS-6 dynamic registry
      * Note: This executes the transaction directly via HCS6Client
      */
-    createRegistry(options?: HCS6CreateRegistryOptions): Promise<HCS6TopicRegistrationResponse>;
+    createRegistry(options?: HCS6CreateRegistryOptions): Promise<HCS6TopicRegistrationResult>;
     /**
      * Register a new dynamic hashinal entry in an HCS-6 registry
      */
-    registerEntry(registryTopicId: string, options: HCS6RegisterEntryOptions): Promise<HCS6RegistryOperationResponse>;
+    registerEntry(registryTopicId: string, options: HCS6RegisterEntryOptions): Promise<HCS6RegistryOperationResult>;
     /**
      * Query entries from an HCS-6 registry
      */
@@ -35,7 +36,7 @@ export declare class HCS6Builder extends BaseServiceBuilder {
     /**
      * Submit a raw message to an HCS-6 topic
      */
-    submitMessage(topicId: string, payload: any): Promise<any>;
+    submitMessage(topicId: string, payload: any): Promise<HCS6RegistryOperationResult>;
     /**
      * Get topic info from mirror node
      */

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

@@ -1,4 +1,4 @@
-import { BaseServiceBuilder, HederaAgentKit } from 'hedera-agent-kit';
+import { BaseServiceBuilder, HederaAgentKit, AgentOperationalMode } from 'hedera-agent-kit';
 import { InscriptionInput, InscriptionOptions, InscriptionResponse, RetrievedInscriptionResult } from '@hashgraphonline/standards-sdk';
 import { InscriptionSDK } from '@kiloscribe/inscription-sdk';
 /**
@@ -15,7 +15,37 @@ interface DAppSigner {
  */
 export declare class InscriberBuilder extends BaseServiceBuilder {
     protected inscriptionSDK?: InscriptionSDK;
+    private static signerProvider?;
+    private static walletInfoResolver?;
+    private static startInscriptionDelegate?;
+    private static walletExecutor?;
+    /** When true, do not allow server fallback; require a wallet path in Provide Bytes */
+    private static preferWalletOnly;
     constructor(hederaKit: HederaAgentKit);
+    getOperationalMode(): AgentOperationalMode;
+    static setSignerProvider(provider: () => Promise<DAppSigner | null> | DAppSigner | null): void;
+    static setWalletInfoResolver(resolver: () => Promise<{
+        accountId: string;
+        network: 'mainnet' | 'testnet';
+    } | null> | {
+        accountId: string;
+        network: 'mainnet' | 'testnet';
+    } | null): void;
+    static setStartInscriptionDelegate(delegate: (request: Record<string, unknown>, network: 'mainnet' | 'testnet') => Promise<{
+        transactionBytes: string;
+        tx_id?: string;
+        topic_id?: string;
+        status?: string;
+        completed?: boolean;
+    }>): void;
+    static setWalletExecutor(executor: (base64: string, network: 'mainnet' | 'testnet') => Promise<{
+        transactionId: string;
+    }>): void;
+    /**
+     * Control fallback behavior. When true, wallet must be available for execution paths.
+     */
+    static setPreferWalletOnly(flag: boolean): void;
+    getSigner(): Promise<DAppSigner | null>;
     /**
      * Get or create Inscription SDK - temporarily returns null since we don't have the actual SDK
      */
@@ -28,6 +58,7 @@ export declare class InscriberBuilder extends BaseServiceBuilder {
      * Inscribe content using a DApp signer
      */
     inscribeWithSigner(input: InscriptionInput, signer: DAppSigner, options: InscriptionOptions): Promise<InscriptionResponse>;
+    inscribeAuto(input: InscriptionInput, options: InscriptionOptions): Promise<InscriptionResponse>;
     /**
      * Retrieve an existing inscription
      */

package/dist/cjs/index.d.ts

@@ -9,3 +9,7 @@ export type { ExecuteResult } from './builders';
 export { HCS10Client } from './hcs10';
 export type { ContentReferenceConfig } from './config/ContentReferenceConfig';
 export { loadConfig } from './config/ContentReferenceConfig';
+export { SignerProviderRegistry } from './signing/signer-provider';
+export type { DAppSigner, WalletInfo, WalletExecutor, StartHCSDelegate, NetworkString } from './signing/signer-provider';
+export { ByteBuildRegistry } from './signing/bytes-registry';
+export type { ByteBuildHandler } from './signing/bytes-registry';

package/dist/cjs/signing/bytes-registry.d.ts

@@ -0,0 +1,17 @@
+import { HederaAgentKit } from 'hedera-agent-kit';
+export type ByteBuildHandler = (ctx: {
+    hederaKit: HederaAgentKit;
+    request: Record<string, unknown>;
+}) => Promise<{
+    transactionBytes: string;
+}>;
+declare class ByteBuildRegistryImpl {
+    private handlers;
+    register(op: string, handler: ByteBuildHandler): void;
+    has(op: string): boolean;
+    build(op: string, hederaKit: HederaAgentKit, request: Record<string, unknown>): Promise<{
+        transactionBytes: string;
+    } | null>;
+}
+export declare const ByteBuildRegistry: ByteBuildRegistryImpl;
+export {};

package/dist/cjs/signing/signer-provider.d.ts

@@ -0,0 +1,45 @@
+export type NetworkString = 'mainnet' | 'testnet';
+export interface DAppSigner {
+    getAccountId(): {
+        toString(): string;
+    };
+    [key: string]: unknown;
+}
+export type WalletInfo = {
+    accountId: string;
+    network: NetworkString;
+};
+export type WalletInfoResolver = () => Promise<WalletInfo | null> | WalletInfo | null;
+export type WalletExecutor = (base64: string, network: NetworkString) => Promise<{
+    transactionId: string;
+}>;
+export type HCSOperation = 'submitConnectionRequest' | 'handleConnectionRequest' | 'sendMessage' | 'hcs2.createRegistry' | 'hcs2.migrateRegistry' | 'hcs2.registerEntry' | 'hcs2.updateEntry' | 'hcs2.deleteEntry' | 'hcs2.submitMessage' | 'hcs6.createRegistry' | 'hcs6.registerEntry' | 'hcs6.submitMessage';
+export type StartHCSDelegate = (op: HCSOperation, request: Record<string, unknown>, network: NetworkString) => Promise<{
+    transactionBytes: string;
+}>;
+/**
+ * Central registry for browser signer and wallet execution delegates
+ */
+export declare class SignerProviderRegistry {
+    private static _signerProvider;
+    private static _walletInfoResolver;
+    private static _walletExecutor;
+    private static _startHCSDelegate;
+    private static _browserHCSClientFactory;
+    private static _preferWalletOnly;
+    static setSignerProvider(provider: typeof SignerProviderRegistry._signerProvider): void;
+    static getSigner(): Promise<DAppSigner | null>;
+    static setWalletInfoResolver(resolver: WalletInfoResolver | null): void;
+    static getWalletInfo(): Promise<WalletInfo | null>;
+    static setWalletExecutor(executor: WalletExecutor | null): void;
+    static get walletExecutor(): WalletExecutor | null;
+    static setStartHCSDelegate(delegate: StartHCSDelegate | null): void;
+    static get startHCSDelegate(): StartHCSDelegate | null;
+    static setPreferWalletOnly(flag: boolean): void;
+    /**
+     * Register a factory to construct a BrowserHCSClient-like instance for wallet-driven flows
+     */
+    static setBrowserHCSClientFactory(factory: ((network: NetworkString) => unknown) | null): void;
+    static getBrowserHCSClient(network: NetworkString): unknown | null;
+    static get preferWalletOnly(): boolean;
+}