@hashgraphonline/standards-agent-kit 0.2.148 → 0.2.149

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

@@ -12,6 +12,8 @@ export interface InscriptionSuccessResponse {
         hrl: string;
         /** Topic ID where the inscription was stored */
         topicId: string;
+        /** Topic ID containing the JSON metadata when available */
+        jsonTopicId?: string;
         /** Type of Hashinal - Static (HCS-5) or Dynamic (HCS-6) */
         standard: 'Static' | 'Dynamic';
         /** CDN URL for direct access to the inscribed content */
@@ -19,6 +21,8 @@ export interface InscriptionSuccessResponse {
         /** Transaction ID of the inscription */
         transactionId?: string;
     };
+    /** Topic ID used for metadata lookups */
+    jsonTopicId?: string;
     metadata: {
         /** Name/title of the inscribed content */
         name?: string;
@@ -97,6 +101,7 @@ export type InscriptionResponse = InscriptionSuccessResponse | InscriptionQuoteR
 export declare function createInscriptionSuccess(params: {
     hrl: string;
     topicId: string;
+    jsonTopicId?: string;
     standard: 'Static' | 'Dynamic';
     cdnUrl?: string;
     transactionId?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hashgraphonline/standards-agent-kit",
-  "version": "0.2.148",
+  "version": "0.2.149",
   "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

@@ -90,13 +90,7 @@ 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<PendingInscriptionResponse | CompletedInscriptionResponse>
   ): void {
     InscriberBuilder.startInscriptionDelegate = delegate;
   }
@@ -280,7 +274,7 @@ export class InscriberBuilder extends BaseServiceBuilder {
 
       const completedStart = start as CompletedInscriptionResponse;
       const isCompletedResponse =
-        completedStart?.inscription && completedStart?.confirmed;
+        Boolean(completedStart?.inscription) && completedStart?.confirmed;
 
       if (isCompletedResponse) {
         const completed = start as {

package/src/tools/inscriber/InscribeHashinalTool.ts

@@ -551,6 +551,7 @@ export class InscribeHashinalTool
         const successResponse = createInscriptionSuccess({
           hrl: hrl || 'hcs://1/unknown',
           topicId: topicId || 'unknown',
+          jsonTopicId: ids.jsonTopicId,
           standard: fileStandard === '6' ? 'Dynamic' : 'Static',
           cdnUrl,
           transactionId: txId,
@@ -680,6 +681,7 @@ export class InscribeHashinalTool
         name: response.metadata.name || 'Untitled Content',
         creator: response.metadata.creator || '',
         topicId: response.inscription.topicId,
+        jsonTopicId: response.inscription.jsonTopicId || response.jsonTopicId,
         hrl: response.inscription.hrl,
         network: network,
       },

package/src/types/inscription-response.ts

@@ -13,6 +13,8 @@ export interface InscriptionSuccessResponse {
     hrl: string;
     /** Topic ID where the inscription was stored */
     topicId: string;
+    /** Topic ID containing the JSON metadata when available */
+    jsonTopicId?: string;
     /** Type of Hashinal - Static (HCS-5) or Dynamic (HCS-6) */
     standard: 'Static' | 'Dynamic';
     /** CDN URL for direct access to the inscribed content */
@@ -20,6 +22,8 @@ export interface InscriptionSuccessResponse {
     /** Transaction ID of the inscription */
     transactionId?: string;
   };
+  /** Topic ID used for metadata lookups */
+  jsonTopicId?: string;
   metadata: {
     /** Name/title of the inscribed content */
     name?: string;
@@ -102,6 +106,7 @@ export type InscriptionResponse =
 export function createInscriptionSuccess(params: {
   hrl: string;
   topicId: string;
+  jsonTopicId?: string;
   standard: 'Static' | 'Dynamic';
   cdnUrl?: string;
   transactionId?: string;
@@ -113,7 +118,15 @@ export function createInscriptionSuccess(params: {
     attributes?: Array<{ trait_type: string; value: string | number }>;
   };
 }): InscriptionSuccessResponse {
-  const { hrl, topicId, standard, cdnUrl, transactionId, metadata } = params;
+  const {
+    hrl,
+    topicId,
+    jsonTopicId,
+    standard,
+    cdnUrl,
+    transactionId,
+    metadata,
+  } = params;
 
   return {
     success: true,
@@ -125,10 +138,12 @@ export function createInscriptionSuccess(params: {
     inscription: {
       hrl,
       topicId,
+      jsonTopicId,
       standard,
       cdnUrl,
       transactionId,
     },
+    jsonTopicId,
     metadata,
     nextSteps: {
       primary: 'CRITICAL: When minting NFTs, use ONLY the mintingMetadata value as a single string in the metadata array. Do NOT create JSON objects.',

package/src/utils/inscription-utils.ts

@@ -23,7 +23,9 @@ export function extractTopicIds(
   result?: unknown
 ): TopicIds {
   const jsonTopicId =
-    inscription?.jsonTopicId || getStringProp(inscription, 'json_topic_id');
+    inscription?.jsonTopicId ||
+    getStringProp(inscription, 'json_topic_id') ||
+    getStringProp(result, 'jsonTopicId');
 
   const imageTopicId =
     getStringProp(inscription, 'topic_id') ||