@hashgraphonline/standards-agent-kit 0.2.135 → 0.2.137

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

@@ -15,7 +15,9 @@ declare const inscribeHashinalSchema: import('../..').ZodSchemaWithRender<{
     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;
 }>;
@@ -51,14 +51,6 @@ export declare class InscribeHashinalTool extends BaseInscriberQueryTool impleme
      * Returns the focused schema for form generation
      */
     getFormSchema(): z.ZodObject<z.ZodRawShape>;
-    /**
-     * Implementation of FormValidatable interface
-     * Validates metadata quality and provides detailed feedback
-     */
-    validateMetadataQuality(input: unknown): {
-        needsForm: boolean;
-        reason: string;
-    };
     protected executeQuery(params: z.infer<typeof inscribeHashinalSchema>, _runManager?: CallbackManagerForToolRun): Promise<InscriptionResponse>;
     /**
      * Creates HashLink block configuration for Hashinal inscriptions.

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/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/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/interfaces/FormValidatable.d.ts

@@ -16,28 +16,19 @@ export interface FormValidatable {
      */
     getFormSchema(): z.ZodSchema;
     /**
-     * Optional method to validate metadata quality and provide detailed feedback
-     * @param input The input data to analyze
-     * @returns Object indicating if form is needed and the reason
-     */
-    validateMetadataQuality?(input: unknown): {
-        needsForm: boolean;
-        reason: string;
-    };
-    /**
-     * Optional method to define which fields are essential for this tool
+     * Defines which fields are essential for this tool
      * Essential fields are always shown in forms even if marked as optional
      * @returns Array of field names that are essential for user experience
      */
-    getEssentialFields?(): string[];
+    getEssentialFields(): string[];
     /**
-     * Optional method to determine if a field value should be considered empty
+     * Determines if a field value should be considered empty
      * Allows tools to define custom empty logic for their specific data types
      * @param fieldName The name of the field
      * @param value The value to check
      * @returns true if the field should be considered empty
      */
-    isFieldEmpty?(fieldName: string, value: unknown): boolean;
+    isFieldEmpty(fieldName: string, value: unknown): boolean;
 }
 /**
  * Type guard to check if a tool implements FormValidatable

package/dist/es/standards-agent-kit.es3.js

@@ -7,6 +7,10 @@ const NOT_INITIALIZED_ERROR = "ConnectionsManager not initialized";
 class HCS10Builder extends BaseServiceBuilder {
   constructor(hederaKit, stateManager, options) {
     super(hederaKit);
+    const isBytesMode = String(this.hederaKit.operationalMode || "returnBytes") === "returnBytes";
+    if (isBytesMode) {
+      throw new Error("HCS10Builder is not available in returnBytes mode (no local operator key). Use BrowserHCSClient with a wallet signer in the renderer.");
+    }
     this.stateManager = stateManager;
     const network = this.hederaKit.client.network;
     this.network = network.toString().includes("mainnet") ? "mainnet" : "testnet";