@hashgraphonline/standards-agent-kit 0.2.144 → 0.2.146

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

@@ -1,3 +1,4 @@
+import { RetrievedInscriptionResult } from '@kiloscribe/inscription-sdk';
 export type NetworkType = 'mainnet' | 'testnet';
 export interface TopicIds {
     jsonTopicId?: string;
@@ -8,7 +9,7 @@ export interface TopicIds {
  * - 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;
+export declare function extractTopicIds(inscription?: RetrievedInscriptionResult, result?: unknown): TopicIds;
 /**
  * Build HRL/CDN URLs from extracted topic ids.
  * - HRL prefers jsonTopicId, falls back to topicId

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hashgraphonline/standards-agent-kit",
-  "version": "0.2.144",
+  "version": "0.2.146",
   "description": "A modular SDK for building on-chain autonomous agents using Hashgraph Online Standards, including HCS-10 for agent discovery and communication.",
   "type": "module",
   "main": "./dist/cjs/standards-agent-kit.cjs",

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

@@ -12,7 +12,7 @@ import {
   NetworkType,
   getTopicId,
 } from '@hashgraphonline/standards-sdk';
-import { InscriptionSDK } from '@kiloscribe/inscription-sdk';
+import { InscriptionResult, InscriptionSDK } from '@kiloscribe/inscription-sdk';
 import type { AgentOperationalMode } from 'hedera-agent-kit';
 
 /**
@@ -23,23 +23,39 @@ interface DAppSigner {
   [key: string]: unknown;
 }
 
+export interface PendingInscriptionResponse {
+  transactionBytes: string;
+  tx_id?: string;
+  topic_id?: string;
+  status?: string;
+  completed?: boolean;
+}
+
+export interface CompletedInscriptionResponse {
+  confirmed?: boolean;
+  result?: InscriptionResult;
+  inscription?: RetrievedInscriptionResult;
+  jsonTopicId?: string;
+  network?: string;
+}
 /**
  * Builder for Inscription operations
  */
 export class InscriberBuilder extends BaseServiceBuilder {
   protected inscriptionSDK?: InscriptionSDK;
-  private static signerProvider?: () => Promise<DAppSigner | null> | DAppSigner | null;
-  private static walletInfoResolver?: () => Promise<{ accountId: string; network: 'mainnet' | 'testnet' } | null> | { accountId: string; network: 'mainnet' | 'testnet' } | null;
+  private static signerProvider?: () =>
+    | Promise<DAppSigner | null>
+    | DAppSigner
+    | null;
+  private static walletInfoResolver?: () =>
+    | Promise<{ accountId: string; network: 'mainnet' | 'testnet' } | null>
+    | { accountId: string; network: 'mainnet' | 'testnet' }
+    | null;
+
   private static startInscriptionDelegate?: (
     request: Record<string, unknown>,
     network: 'mainnet' | 'testnet'
-  ) => Promise<{
-    transactionBytes: string;
-    tx_id?: string;
-    topic_id?: string;
-    status?: string;
-    completed?: boolean;
-  }>;
+  ) => Promise<PendingInscriptionResponse | CompletedInscriptionResponse>;
   private static walletExecutor?: (
     base64: string,
     network: 'mainnet' | 'testnet'
@@ -62,7 +78,10 @@ export class InscriberBuilder extends BaseServiceBuilder {
   }
 
   static setWalletInfoResolver(
-    resolver: () => Promise<{ accountId: string; network: 'mainnet' | 'testnet' } | null> | { accountId: string; network: 'mainnet' | 'testnet' } | null
+    resolver: () =>
+      | Promise<{ accountId: string; network: 'mainnet' | 'testnet' } | null>
+      | { accountId: string; network: 'mainnet' | 'testnet' }
+      | null
   ): void {
     InscriberBuilder.walletInfoResolver = resolver;
   }
@@ -71,13 +90,22 @@ export class InscriberBuilder extends BaseServiceBuilder {
     delegate: (
       request: Record<string, unknown>,
       network: 'mainnet' | 'testnet'
-    ) => Promise<{ transactionBytes: string; tx_id?: string; topic_id?: string; status?: string; completed?: boolean }>
+    ) => Promise<{
+      transactionBytes: string;
+      tx_id?: string;
+      topic_id?: string;
+      status?: string;
+      completed?: boolean;
+    }>
   ): void {
     InscriberBuilder.startInscriptionDelegate = delegate;
   }
 
   static setWalletExecutor(
-    executor: (base64: string, network: 'mainnet' | 'testnet') => Promise<{ transactionId: string }>
+    executor: (
+      base64: string,
+      network: 'mainnet' | 'testnet'
+    ) => Promise<{ transactionId: string }>
   ): void {
     InscriberBuilder.walletExecutor = executor;
   }
@@ -94,7 +122,7 @@ export class InscriberBuilder extends BaseServiceBuilder {
     if (!provider) return null;
     try {
       const maybe = provider();
-      return (maybe && typeof (maybe as Promise<unknown>).then === 'function')
+      return maybe && typeof (maybe as Promise<unknown>).then === 'function'
         ? await (maybe as Promise<DAppSigner | null>)
         : (maybe as DAppSigner | null);
     } catch {
@@ -162,13 +190,7 @@ export class InscriberBuilder extends BaseServiceBuilder {
     }
 
     type WalletInfo = { accountId: string; network: 'mainnet' | 'testnet' };
-    type WalletStartResponse = {
-      transactionBytes: string;
-      tx_id?: string;
-      topic_id?: string;
-      status?: string;
-      completed?: boolean;
-    };
+
     type WalletExecutorResponse = { transactionId: string };
 
     const infoMaybe: WalletInfo | null = InscriberBuilder.walletInfoResolver
@@ -176,7 +198,9 @@ export class InscriberBuilder extends BaseServiceBuilder {
       : null;
 
     if (InscriberBuilder.preferWalletOnly && !infoMaybe) {
-      const err = new Error('Wallet unavailable: connect a wallet or switch to autonomous mode');
+      const err = new Error(
+        'Wallet unavailable: connect a wallet or switch to autonomous mode'
+      );
       (err as unknown as { code: string }).code = 'wallet_unavailable';
       throw err;
     }
@@ -193,7 +217,10 @@ export class InscriberBuilder extends BaseServiceBuilder {
         fileStandard?: string;
         chunkSize?: number;
         jsonFileURL?: string;
-        metadata?: Record<string, unknown> & { creator?: string; description?: string };
+        metadata?: Record<string, unknown> & {
+          creator?: string;
+          description?: string;
+        };
       };
       const ext = options as InscriptionOptionsExt;
 
@@ -204,7 +231,8 @@ export class InscriberBuilder extends BaseServiceBuilder {
         mode: options.mode || 'file',
       };
       if (typeof ext.fileStandard !== 'undefined') {
-        (baseRequest as { fileStandard?: string }).fileStandard = ext.fileStandard;
+        (baseRequest as { fileStandard?: string }).fileStandard =
+          ext.fileStandard;
       }
       if (typeof ext.chunkSize !== 'undefined') {
         (baseRequest as { chunkSize?: number }).chunkSize = ext.chunkSize;
@@ -216,7 +244,10 @@ export class InscriberBuilder extends BaseServiceBuilder {
           request = { ...baseRequest, file: { type: 'url', url: input.url } };
           break;
         case 'file':
-          request = { ...baseRequest, file: { type: 'path', path: input.path } };
+          request = {
+            ...baseRequest,
+            file: { type: 'path', path: input.path },
+          };
           break;
         case 'buffer':
           request = {
@@ -233,48 +264,85 @@ export class InscriberBuilder extends BaseServiceBuilder {
 
       if (options.mode === 'hashinal') {
         (request as { metadataObject?: unknown }).metadataObject = ext.metadata;
-        (request as { creator?: string }).creator = ext.metadata?.creator || holderId;
-        (request as { description?: string }).description = ext.metadata?.description;
+        (request as { creator?: string }).creator =
+          ext.metadata?.creator || holderId;
+        (request as { description?: string }).description =
+          ext.metadata?.description;
         if (typeof ext.jsonFileURL === 'string' && ext.jsonFileURL.length > 0) {
           (request as { jsonFileURL?: string }).jsonFileURL = ext.jsonFileURL;
         }
       }
 
-      const start: WalletStartResponse = await InscriberBuilder.startInscriptionDelegate(
+      const start = await InscriberBuilder.startInscriptionDelegate(
         request,
         network
       );
-      if (!start || !start.transactionBytes) {
+
+      const completedStart = start as CompletedInscriptionResponse;
+      const isCompletedResponse =
+        completedStart?.inscription && completedStart?.confirmed;
+
+      if (isCompletedResponse) {
+        const completed = start as {
+          confirmed?: boolean;
+          result?: unknown;
+          inscription?: unknown;
+        };
+        return {
+          quote: false,
+          confirmed: completed.confirmed === true,
+          result: completed.result as InscriptionResult,
+          inscription: completed.inscription,
+        } as unknown as InscriptionResponse;
+      }
+
+      const startResponse = start as {
+        transactionBytes: string;
+        tx_id?: string;
+        topic_id?: string;
+        status?: string;
+        completed?: boolean;
+      };
+
+      if (!startResponse || !startResponse.transactionBytes) {
         throw new Error('Failed to start inscription (no transaction bytes)');
       }
 
-      const exec: WalletExecutorResponse = await InscriberBuilder.walletExecutor(
-        start.transactionBytes,
-        network
-      );
+      const exec: WalletExecutorResponse =
+        await InscriberBuilder.walletExecutor(
+          startResponse.transactionBytes,
+          network
+        );
       const transactionId = exec?.transactionId || '';
 
-      const shouldWait = options.quoteOnly ? false : options.waitForConfirmation ?? true;
+      const shouldWait = options.quoteOnly
+        ? false
+        : options.waitForConfirmation ?? true;
       if (shouldWait) {
-        const maxAttempts = (options as { waitMaxAttempts?: number }).waitMaxAttempts ?? 60;
-        const intervalMs = (options as { waitIntervalMs?: number }).waitIntervalMs ?? 5000;
+        const maxAttempts =
+          (options as { waitMaxAttempts?: number }).waitMaxAttempts ?? 60;
+        const intervalMs =
+          (options as { waitIntervalMs?: number }).waitIntervalMs ?? 5000;
 
         for (let attempt = 0; attempt < maxAttempts; attempt++) {
           try {
-            const retrieved: RetrievedInscriptionResult = await this.retrieveInscription(
-              transactionId,
-              options
+            const retrieved: RetrievedInscriptionResult =
+              await this.retrieveInscription(transactionId, options);
+            const topicIdFromInscription: string | undefined = getTopicId(
+              retrieved as unknown
             );
-            const topicIdFromInscription: string | undefined = getTopicId(retrieved as unknown);
-            const topicId: string | undefined = topicIdFromInscription ?? start.topic_id;
-            const status: string | undefined = (retrieved as { status?: string }).status;
+            const topicId: string | undefined =
+              topicIdFromInscription ?? startResponse.topic_id;
+            const status: string | undefined = (
+              retrieved as { status?: string }
+            ).status;
             const isDone = status === 'completed' || !!topicId;
             if (isDone) {
               const resultConfirmed: InscriptionResponse = {
                 quote: false,
                 confirmed: true,
                 result: {
-                  jobId: start.tx_id || '',
+                  jobId: startResponse.tx_id || '',
                   transactionId,
                   topicId,
                 },
@@ -282,8 +350,7 @@ export class InscriberBuilder extends BaseServiceBuilder {
               } as unknown as InscriptionResponse;
               return resultConfirmed;
             }
-          } catch {
-          }
+          } catch {}
           await new Promise((resolve) => setTimeout(resolve, intervalMs));
         }
       }
@@ -292,18 +359,22 @@ export class InscriberBuilder extends BaseServiceBuilder {
         quote: false,
         confirmed: false,
         result: {
-          jobId: start.tx_id || '',
+          jobId: startResponse.tx_id || '',
           transactionId,
-          status: start.status,
-          completed: start.completed,
+          status: startResponse.status,
+          completed: startResponse.completed,
         },
-        inscription: start.topic_id ? { topic_id: start.topic_id } : undefined,
+        inscription: startResponse.topic_id
+          ? { topic_id: startResponse.topic_id }
+          : undefined,
       } as unknown as InscriptionResponse;
       return partial;
     }
 
     if (InscriberBuilder.preferWalletOnly) {
-      const err = new Error('Wallet unavailable: connect a wallet or switch to autonomous mode');
+      const err = new Error(
+        'Wallet unavailable: connect a wallet or switch to autonomous mode'
+      );
       (err as unknown as { code: string }).code = 'wallet_unavailable';
       throw err;
     }

package/src/utils/inscription-utils.ts

@@ -1,3 +1,5 @@
+import { RetrievedInscriptionResult } from '@kiloscribe/inscription-sdk';
+
 export type NetworkType = 'mainnet' | 'testnet';
 
 export interface TopicIds {
@@ -17,10 +19,11 @@ function getStringProp(obj: unknown, key: string): string | undefined {
  * - Collects topic_id/topicId from either inscription or result
  */
 export function extractTopicIds(
-  inscription: unknown,
+  inscription?: RetrievedInscriptionResult,
   result?: unknown
 ): TopicIds {
-  const jsonTopicId = getStringProp(inscription, 'jsonTopicId');
+  const jsonTopicId =
+    inscription?.jsonTopicId || getStringProp(inscription, 'json_topic_id');
 
   const imageTopicId =
     getStringProp(inscription, 'topic_id') ||