@hashgraphonline/standards-agent-kit 0.2.136 → 0.2.138

package/dist/cjs/tools/hcs10/InitiateConnectionTool.d.ts

@@ -8,12 +8,12 @@ declare const InitiateConnectionZodSchema: z.ZodObject<{
     memo: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     targetAccountId: string;
-    disableMonitor?: boolean | undefined;
     memo?: string | undefined;
+    disableMonitor?: boolean | undefined;
 }, {
     targetAccountId: string;
-    disableMonitor?: boolean | undefined;
     memo?: string | undefined;
+    disableMonitor?: boolean | undefined;
 }>;
 /**
  * A tool to actively START a NEW HCS-10 connection TO a target agent.
@@ -30,12 +30,12 @@ export declare class InitiateConnectionTool extends BaseHCS10TransactionTool<typ
         memo: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         targetAccountId: string;
-        disableMonitor?: boolean | undefined;
         memo?: string | undefined;
+        disableMonitor?: boolean | undefined;
     }, {
         targetAccountId: string;
-        disableMonitor?: boolean | undefined;
         memo?: string | undefined;
+        disableMonitor?: boolean | undefined;
     }>;
     constructor(params: HCS10TransactionToolParams);
     protected callBuilderMethod(builder: BaseServiceBuilder, specificArgs: z.infer<typeof InitiateConnectionZodSchema>): Promise<void>;

package/dist/cjs/tools/hcs2/CreateRegistryTool.d.ts

@@ -11,13 +11,13 @@ declare const createRegistrySchema: z.ZodObject<{
     adminKey: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
     submitKey: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
 }, "strip", z.ZodTypeAny, {
-    registryType?: HCS2RegistryType | undefined;
     ttl?: number | undefined;
+    registryType?: HCS2RegistryType | undefined;
     adminKey?: string | boolean | undefined;
     submitKey?: string | boolean | undefined;
 }, {
-    registryType?: HCS2RegistryType | undefined;
     ttl?: number | undefined;
+    registryType?: HCS2RegistryType | undefined;
     adminKey?: string | boolean | undefined;
     submitKey?: string | boolean | undefined;
 }>;

package/dist/cjs/tools/hcs2/DeleteEntryTool.d.ts

@@ -9,12 +9,12 @@ declare const deleteEntrySchema: z.ZodObject<{
     uid: z.ZodString;
     memo: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    uid: string;
     registryTopicId: string;
+    uid: string;
     memo?: string | undefined;
 }, {
-    uid: string;
     registryTopicId: string;
+    uid: string;
     memo?: string | undefined;
 }>;
 /**

package/dist/cjs/tools/hcs2/UpdateEntryTool.d.ts

@@ -11,15 +11,15 @@ declare const updateEntrySchema: z.ZodObject<{
     metadata: z.ZodOptional<z.ZodString>;
     memo: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    uid: string;
     registryTopicId: string;
     targetTopicId: string;
+    uid: string;
     metadata?: string | undefined;
     memo?: string | undefined;
 }, {
-    uid: string;
     registryTopicId: string;
     targetTopicId: string;
+    uid: string;
     metadata?: string | undefined;
     memo?: string | undefined;
 }>;

package/dist/cjs/tools/hcs6/RegisterDynamicHashinalTool.d.ts

@@ -27,25 +27,25 @@ declare const RegisterDynamicHashinalSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     metadata: Record<string, unknown>;
     ttl: number;
+    registryTopicId?: string | undefined;
+    memo?: string | undefined;
     data?: {
         base64?: string | undefined;
         url?: string | undefined;
         mimeType?: string | undefined;
     } | undefined;
-    memo?: string | undefined;
     submitKey?: string | undefined;
-    registryTopicId?: string | undefined;
 }, {
     metadata: Record<string, unknown>;
+    registryTopicId?: string | undefined;
+    memo?: string | undefined;
+    ttl?: number | undefined;
     data?: {
         base64?: string | undefined;
         url?: string | undefined;
         mimeType?: string | undefined;
     } | undefined;
-    memo?: string | undefined;
-    ttl?: number | undefined;
     submitKey?: string | undefined;
-    registryTopicId?: string | undefined;
 }>;
 export type RegisterDynamicHashinalInput = z.infer<typeof RegisterDynamicHashinalSchema>;
 /**
@@ -76,25 +76,25 @@ export declare class RegisterDynamicHashinalTool extends BaseHCS6QueryTool<typeo
     }, "strip", z.ZodTypeAny, {
         metadata: Record<string, unknown>;
         ttl: number;
+        registryTopicId?: string | undefined;
+        memo?: string | undefined;
         data?: {
             base64?: string | undefined;
             url?: string | undefined;
             mimeType?: string | undefined;
         } | undefined;
-        memo?: string | undefined;
         submitKey?: string | undefined;
-        registryTopicId?: string | undefined;
     }, {
         metadata: Record<string, unknown>;
+        registryTopicId?: string | undefined;
+        memo?: string | undefined;
+        ttl?: number | undefined;
         data?: {
             base64?: string | undefined;
             url?: string | undefined;
             mimeType?: string | undefined;
         } | undefined;
-        memo?: string | undefined;
-        ttl?: number | undefined;
         submitKey?: string | undefined;
-        registryTopicId?: string | undefined;
     }>;
     constructor(params: HCS6QueryToolParams);
     protected executeQuery(params: RegisterDynamicHashinalInput, _runManager?: CallbackManagerForToolRun): Promise<unknown>;

package/dist/cjs/tools/hcs6/UpdateDynamicHashinalTool.d.ts

@@ -24,25 +24,25 @@ declare const UpdateDynamicHashinalSchema: z.ZodObject<{
     memo: z.ZodOptional<z.ZodString>;
     submitKey: z.ZodString;
 }, "strip", z.ZodTypeAny, {
+    registryTopicId: string;
     metadata: Record<string, unknown>;
     submitKey: string;
-    registryTopicId: string;
+    memo?: string | undefined;
     data?: {
         base64?: string | undefined;
         url?: string | undefined;
         mimeType?: string | undefined;
     } | undefined;
-    memo?: string | undefined;
 }, {
+    registryTopicId: string;
     metadata: Record<string, unknown>;
     submitKey: string;
-    registryTopicId: string;
+    memo?: string | undefined;
     data?: {
         base64?: string | undefined;
         url?: string | undefined;
         mimeType?: string | undefined;
     } | undefined;
-    memo?: string | undefined;
 }>;
 export type UpdateDynamicHashinalInput = z.infer<typeof UpdateDynamicHashinalSchema>;
 /**
@@ -70,25 +70,25 @@ export declare class UpdateDynamicHashinalTool extends BaseHCS6QueryTool<typeof
         memo: z.ZodOptional<z.ZodString>;
         submitKey: z.ZodString;
     }, "strip", z.ZodTypeAny, {
+        registryTopicId: string;
         metadata: Record<string, unknown>;
         submitKey: string;
-        registryTopicId: string;
+        memo?: string | undefined;
         data?: {
             base64?: string | undefined;
             url?: string | undefined;
             mimeType?: string | undefined;
         } | undefined;
-        memo?: string | undefined;
     }, {
+        registryTopicId: string;
         metadata: Record<string, unknown>;
         submitKey: string;
-        registryTopicId: string;
+        memo?: string | undefined;
         data?: {
             base64?: string | undefined;
             url?: string | undefined;
             mimeType?: string | undefined;
         } | undefined;
-        memo?: string | undefined;
     }>;
     constructor(params: HCS6QueryToolParams);
     protected executeQuery(params: UpdateDynamicHashinalInput, _runManager?: CallbackManagerForToolRun): Promise<unknown>;

package/dist/cjs/tools/inscriber/InscribeFromBufferTool.d.ts

@@ -16,8 +16,8 @@ declare const inscribeFromBufferSchema: z.ZodObject<{
     quoteOnly: boolean;
     fileName: string;
     base64Data: string;
-    tags?: string[] | undefined;
     metadata?: Record<string, unknown> | undefined;
+    tags?: string[] | undefined;
     mimeType?: string | undefined;
     chunkSize?: number | undefined;
     waitForConfirmation?: boolean | undefined;
@@ -26,8 +26,8 @@ declare const inscribeFromBufferSchema: z.ZodObject<{
 }, {
     fileName: string;
     base64Data: string;
-    tags?: string[] | undefined;
     metadata?: Record<string, unknown> | undefined;
+    tags?: string[] | undefined;
     mimeType?: string | undefined;
     chunkSize?: number | undefined;
     waitForConfirmation?: boolean | undefined;
@@ -54,8 +54,8 @@ export declare class InscribeFromBufferTool extends BaseInscriberQueryTool<typeo
         quoteOnly: boolean;
         fileName: string;
         base64Data: string;
-        tags?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
+        tags?: string[] | undefined;
         mimeType?: string | undefined;
         chunkSize?: number | undefined;
         waitForConfirmation?: boolean | undefined;
@@ -64,8 +64,8 @@ export declare class InscribeFromBufferTool extends BaseInscriberQueryTool<typeo
     }, {
         fileName: string;
         base64Data: string;
-        tags?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
+        tags?: string[] | undefined;
         mimeType?: string | undefined;
         chunkSize?: number | undefined;
         waitForConfirmation?: boolean | undefined;
@@ -73,6 +73,7 @@ export declare class InscribeFromBufferTool extends BaseInscriberQueryTool<typeo
         apiKey?: string | undefined;
         quoteOnly?: boolean | undefined;
     }>;
+    protected _call(args: z.infer<typeof inscribeFromBufferSchema>, _runManager?: CallbackManagerForToolRun): Promise<string>;
     protected executeQuery(params: z.infer<typeof inscribeFromBufferSchema>, _runManager?: CallbackManagerForToolRun): Promise<unknown>;
     private validateInput;
     private validateContent;

package/dist/cjs/tools/inscriber/InscribeFromFileTool.d.ts

@@ -17,8 +17,8 @@ declare const inscribeFromFileSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     quoteOnly: boolean;
     filePath: string;
-    tags?: string[] | undefined;
     metadata?: Record<string, unknown> | undefined;
+    tags?: string[] | undefined;
     mode?: "file" | "hashinal" | undefined;
     chunkSize?: number | undefined;
     waitForConfirmation?: boolean | undefined;
@@ -26,8 +26,8 @@ declare const inscribeFromFileSchema: z.ZodObject<{
     apiKey?: string | undefined;
 }, {
     filePath: string;
-    tags?: string[] | undefined;
     metadata?: Record<string, unknown> | undefined;
+    tags?: string[] | undefined;
     mode?: "file" | "hashinal" | undefined;
     chunkSize?: number | undefined;
     waitForConfirmation?: boolean | undefined;

package/dist/cjs/tools/inscriber/InscribeFromUrlTool.d.ts

@@ -17,8 +17,8 @@ declare const inscribeFromUrlSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     url: string;
     quoteOnly: boolean;
-    tags?: string[] | undefined;
     metadata?: Record<string, unknown> | undefined;
+    tags?: string[] | undefined;
     mode?: "file" | "hashinal" | undefined;
     chunkSize?: number | undefined;
     waitForConfirmation?: boolean | undefined;
@@ -26,8 +26,8 @@ declare const inscribeFromUrlSchema: z.ZodObject<{
     apiKey?: string | undefined;
 }, {
     url: string;
-    tags?: string[] | undefined;
     metadata?: Record<string, unknown> | undefined;
+    tags?: string[] | undefined;
     mode?: "file" | "hashinal" | undefined;
     chunkSize?: number | undefined;
     waitForConfirmation?: boolean | undefined;
@@ -54,8 +54,8 @@ export declare class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof i
     }, "strip", z.ZodTypeAny, {
         url: string;
         quoteOnly: boolean;
-        tags?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
+        tags?: string[] | undefined;
         mode?: "file" | "hashinal" | undefined;
         chunkSize?: number | undefined;
         waitForConfirmation?: boolean | undefined;
@@ -63,8 +63,8 @@ export declare class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof i
         apiKey?: string | undefined;
     }, {
         url: string;
-        tags?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
+        tags?: string[] | undefined;
         mode?: "file" | "hashinal" | undefined;
         chunkSize?: number | undefined;
         waitForConfirmation?: boolean | undefined;

package/dist/cjs/tools/inscriber/InscribeHashinalTool.d.ts

@@ -7,15 +7,17 @@ import { FormValidatable } from '../../interfaces/FormValidatable';
  * Schema for inscribing Hashinal NFT
  */
 declare const inscribeHashinalSchema: import('../..').ZodSchemaWithRender<{
+    name?: string | undefined;
     url?: string | undefined;
     type?: string | undefined;
-    name?: string | undefined;
     description?: string | undefined;
     tags?: string[] | undefined;
     creator?: string | undefined;
     properties?: Record<string, unknown> | undefined;
     mimeType?: string | undefined;
+    fileStandard?: "1" | "6" | undefined;
     chunkSize?: number | undefined;
+    jsonFileURL?: string | undefined;
     waitForConfirmation?: boolean | undefined;
     timeoutMs?: number | undefined;
     quoteOnly?: boolean | undefined;
@@ -26,8 +28,6 @@ declare const inscribeHashinalSchema: import('../..').ZodSchemaWithRender<{
         trait_type: string;
     }[] | undefined;
     contentRef?: string | undefined;
-    jsonFileURL?: string | undefined;
-    fileStandard?: "1" | "6" | undefined;
     withHashLinkBlocks?: boolean | undefined;
     renderForm?: boolean | undefined;
 }>;

package/dist/cjs/types/inscription-response.d.ts

@@ -169,4 +169,12 @@ export declare function createInscriptionError(params: {
     details: string;
     suggestions?: string[];
 }): InscriptionErrorResponse;
+/**
+ * Helper for pending inscription state (submitted but not yet confirmed)
+ */
+export declare function createInscriptionPending(params: {
+    transactionId: string;
+    details?: string;
+    suggestions?: string[];
+}): InscriptionErrorResponse;
 export {};

package/dist/cjs/types/tx-results.d.ts

@@ -0,0 +1,15 @@
+import { TopicRegistrationResponse, RegistryOperationResponse, HCS6TopicRegistrationResponse, HCS6RegistryOperationResponse, HCS6CreateHashinalResponse } from '@hashgraphonline/standards-sdk';
+export interface WalletBytesResponse {
+    success: true;
+    transactionBytes: string;
+}
+export declare function isWalletBytesResponse(value: unknown): value is WalletBytesResponse;
+export type TopicRegistrationResult = TopicRegistrationResponse | WalletBytesResponse;
+export type RegistryOperationResult = RegistryOperationResponse | WalletBytesResponse;
+export type SubmitMessageResult = {
+    success: true;
+    transactionId?: string;
+} | WalletBytesResponse;
+export type HCS6TopicRegistrationResult = HCS6TopicRegistrationResponse | WalletBytesResponse;
+export type HCS6RegistryOperationResult = HCS6RegistryOperationResponse | WalletBytesResponse;
+export type HCS6CreateHashinalResult = HCS6CreateHashinalResponse | WalletBytesResponse;

package/dist/cjs/utils/CodedError.d.ts

@@ -0,0 +1,4 @@
+export declare class CodedError extends Error {
+    code: string;
+    constructor(code: string, message: string);
+}

package/dist/cjs/utils/inscription-utils.d.ts

@@ -0,0 +1,21 @@
+export type NetworkType = 'mainnet' | 'testnet';
+export interface TopicIds {
+    jsonTopicId?: string;
+    topicId?: string;
+}
+/**
+ * Extract topic ids from an inscription and/or result object without using any.
+ * - Prefers jsonTopicId when present (for CDN linking)
+ * - Collects topic_id/topicId from either inscription or result
+ */
+export declare function extractTopicIds(inscription: unknown, result?: unknown): TopicIds;
+/**
+ * Build HRL/CDN URLs from extracted topic ids.
+ * - HRL prefers jsonTopicId, falls back to topicId
+ * - CDN URL only provided when jsonTopicId is present
+ */
+export declare function buildInscriptionLinks(ids: TopicIds, network: NetworkType, fileStandard?: string): {
+    hrl?: string;
+    cdnUrl?: string;
+    topicId?: string;
+};

package/dist/cjs/validation/hip412-schemas.d.ts

@@ -77,9 +77,9 @@ export declare const hip412MetadataSchema: z.ZodObject<{
     }>, "many">>;
     properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
+    name: string;
     type: string;
     image: string;
-    name: string;
     description: string;
     format: string;
     creator?: string | undefined;
@@ -98,9 +98,9 @@ export declare const hip412MetadataSchema: z.ZodObject<{
         display_type?: string | undefined;
     }[] | undefined;
 }, {
+    name: string;
     type: string;
     image: string;
-    name: string;
     description: string;
     creator?: string | undefined;
     properties?: Record<string, unknown> | undefined;

package/dist/es/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/es/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/es/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/es/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/es/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/es/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/es/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;
+}