@hashgraphonline/standards-agent-kit 0.2.113 → 0.2.115

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

@@ -24,8 +24,8 @@ declare const inscribeFromBufferSchema: z.ZodObject<{
     mode?: "file" | "hashinal" | undefined;
     chunkSize?: number | undefined;
     waitForConfirmation?: boolean | undefined;
-    apiKey?: string | undefined;
     timeoutMs?: number | undefined;
+    apiKey?: string | undefined;
 }, {
     fileName: string;
     base64Data: string;
@@ -35,8 +35,8 @@ declare const inscribeFromBufferSchema: z.ZodObject<{
     mode?: "file" | "hashinal" | undefined;
     chunkSize?: number | undefined;
     waitForConfirmation?: boolean | undefined;
-    apiKey?: string | undefined;
     timeoutMs?: number | undefined;
+    apiKey?: string | undefined;
 }>;
 /**
  * Tool for inscribing content from buffer
@@ -64,8 +64,8 @@ export declare class InscribeFromBufferTool extends BaseInscriberQueryTool<typeo
         mode?: "file" | "hashinal" | undefined;
         chunkSize?: number | undefined;
         waitForConfirmation?: boolean | undefined;
-        apiKey?: string | undefined;
         timeoutMs?: number | undefined;
+        apiKey?: string | undefined;
     }, {
         fileName: string;
         base64Data: string;
@@ -75,8 +75,8 @@ export declare class InscribeFromBufferTool extends BaseInscriberQueryTool<typeo
         mode?: "file" | "hashinal" | undefined;
         chunkSize?: number | undefined;
         waitForConfirmation?: boolean | undefined;
-        apiKey?: string | undefined;
         timeoutMs?: number | undefined;
+        apiKey?: string | undefined;
     }>;
     protected executeQuery(params: z.infer<typeof inscribeFromBufferSchema>, _runManager?: CallbackManagerForToolRun): Promise<unknown>;
 }

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

@@ -20,8 +20,8 @@ declare const inscribeFromFileSchema: z.ZodObject<{
     mode?: "file" | "hashinal" | undefined;
     chunkSize?: number | undefined;
     waitForConfirmation?: boolean | undefined;
-    apiKey?: string | undefined;
     timeoutMs?: number | undefined;
+    apiKey?: string | undefined;
 }, {
     filePath: string;
     tags?: string[] | undefined;
@@ -29,8 +29,8 @@ declare const inscribeFromFileSchema: z.ZodObject<{
     mode?: "file" | "hashinal" | undefined;
     chunkSize?: number | undefined;
     waitForConfirmation?: boolean | undefined;
-    apiKey?: string | undefined;
     timeoutMs?: number | undefined;
+    apiKey?: string | undefined;
 }>;
 /**
  * Tool for inscribing content from file

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

@@ -11,6 +11,7 @@ declare const inscribeFromUrlSchema: z.ZodObject<{
     tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     chunkSize: z.ZodOptional<z.ZodNumber>;
     waitForConfirmation: z.ZodOptional<z.ZodBoolean>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
     apiKey: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     url: string;
@@ -19,6 +20,7 @@ declare const inscribeFromUrlSchema: z.ZodObject<{
     mode?: "file" | "hashinal" | undefined;
     chunkSize?: number | undefined;
     waitForConfirmation?: boolean | undefined;
+    timeoutMs?: number | undefined;
     apiKey?: string | undefined;
 }, {
     url: string;
@@ -27,6 +29,7 @@ declare const inscribeFromUrlSchema: z.ZodObject<{
     mode?: "file" | "hashinal" | undefined;
     chunkSize?: number | undefined;
     waitForConfirmation?: boolean | undefined;
+    timeoutMs?: number | undefined;
     apiKey?: string | undefined;
 }>;
 /**
@@ -42,6 +45,7 @@ export declare class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof i
         tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         chunkSize: z.ZodOptional<z.ZodNumber>;
         waitForConfirmation: z.ZodOptional<z.ZodBoolean>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
         apiKey: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         url: string;
@@ -50,6 +54,7 @@ export declare class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof i
         mode?: "file" | "hashinal" | undefined;
         chunkSize?: number | undefined;
         waitForConfirmation?: boolean | undefined;
+        timeoutMs?: number | undefined;
         apiKey?: string | undefined;
     }, {
         url: string;
@@ -58,6 +63,7 @@ export declare class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof i
         mode?: "file" | "hashinal" | undefined;
         chunkSize?: number | undefined;
         waitForConfirmation?: boolean | undefined;
+        timeoutMs?: number | undefined;
         apiKey?: string | undefined;
     }>;
     protected executeQuery(params: z.infer<typeof inscribeFromUrlSchema>, _runManager?: CallbackManagerForToolRun): Promise<unknown>;

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

@@ -25,6 +25,7 @@ declare const inscribeHashinalSchema: z.ZodObject<{
     tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     chunkSize: z.ZodOptional<z.ZodNumber>;
     waitForConfirmation: z.ZodOptional<z.ZodBoolean>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
     apiKey: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     url: string;
@@ -36,6 +37,7 @@ declare const inscribeHashinalSchema: z.ZodObject<{
     properties?: Record<string, unknown> | undefined;
     chunkSize?: number | undefined;
     waitForConfirmation?: boolean | undefined;
+    timeoutMs?: number | undefined;
     apiKey?: string | undefined;
     attributes?: {
         value: string | number;
@@ -52,6 +54,7 @@ declare const inscribeHashinalSchema: z.ZodObject<{
     properties?: Record<string, unknown> | undefined;
     chunkSize?: number | undefined;
     waitForConfirmation?: boolean | undefined;
+    timeoutMs?: number | undefined;
     apiKey?: string | undefined;
     attributes?: {
         value: string | number;
@@ -86,6 +89,7 @@ export declare class InscribeHashinalTool extends BaseInscriberQueryTool<typeof
         tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         chunkSize: z.ZodOptional<z.ZodNumber>;
         waitForConfirmation: z.ZodOptional<z.ZodBoolean>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
         apiKey: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         url: string;
@@ -97,6 +101,7 @@ export declare class InscribeHashinalTool extends BaseInscriberQueryTool<typeof
         properties?: Record<string, unknown> | undefined;
         chunkSize?: number | undefined;
         waitForConfirmation?: boolean | undefined;
+        timeoutMs?: number | undefined;
         apiKey?: string | undefined;
         attributes?: {
             value: string | number;
@@ -113,6 +118,7 @@ export declare class InscribeHashinalTool extends BaseInscriberQueryTool<typeof
         properties?: Record<string, unknown> | undefined;
         chunkSize?: number | undefined;
         waitForConfirmation?: boolean | undefined;
+        timeoutMs?: number | undefined;
         apiKey?: string | undefined;
         attributes?: {
             value: string | number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hashgraphonline/standards-agent-kit",
-  "version": "0.2.113",
+  "version": "0.2.115",
   "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/tools/inscriber/InscribeFromBufferTool.ts

@@ -40,7 +40,7 @@ const inscribeFromBufferSchema = z.object({
     .int()
     .positive()
     .optional()
-    .describe('Timeout in milliseconds for inscription (default: no timeout)'),
+    .describe('Timeout in milliseconds for inscription (default: no timeout - waits until completion)'),
   apiKey: z
     .string()
     .optional()
@@ -53,7 +53,7 @@ const inscribeFromBufferSchema = z.object({
  */
 export class InscribeFromBufferTool extends BaseInscriberQueryTool<typeof inscribeFromBufferSchema> {
   name = 'inscribeFromBuffer';
-  description = 'Inscribe content that you already have retrieved or generated. ALWAYS use this tool for: web page articles (after using MCP tools), API responses, text data, or any content from MCP tools. Steps: 1) Retrieve content using appropriate tool, 2) Convert to base64, 3) Use this tool. NEVER use inscribeFromUrl for web pages - that tool is ONLY for direct file downloads like PDFs or images.';
+  description = 'Use this for ANY web page, article, or content you retrieve. If user asks to inscribe a web page or article, FIRST retrieve it, THEN use this tool. This is the CORRECT tool for: web pages, news articles, blog posts, social media content, API responses, or any text content. Steps: 1) Retrieve content, 2) Convert to base64, 3) Use this tool. DO NOT use inscribeFromUrl for web content.';
 
   get specificInputSchema() {
     return inscribeFromBufferSchema;
@@ -123,10 +123,10 @@ export class InscribeFromBufferTool extends BaseInscriberQueryTool<typeof inscri
     };
 
     try {
-      let result: any;
+      let result: Awaited<ReturnType<typeof this.inscriberBuilder.inscribe>>;
       
       if (params.timeoutMs) {
-        const timeoutPromise = new Promise((_, reject) => {
+        const timeoutPromise = new Promise<never>((_, reject) => {
           setTimeout(
             () => reject(new Error(`Inscription timed out after ${params.timeoutMs}ms`)),
             params.timeoutMs

package/src/tools/inscriber/InscribeFromUrlTool.ts

@@ -7,7 +7,7 @@ import { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';
  * Schema for inscribing from URL
  */
 const inscribeFromUrlSchema = z.object({
-  url: z.string().url().describe('The URL of the content to inscribe'),
+  url: z.string().url().describe('ONLY direct file download URLs ending in .pdf, .jpg, .png, .json, .zip etc. NOT for web pages or articles'),
   mode: z
     .enum(['file', 'hashinal'])
     .optional()
@@ -30,6 +30,12 @@ const inscribeFromUrlSchema = z.object({
     .boolean()
     .optional()
     .describe('Whether to wait for inscription confirmation'),
+  timeoutMs: z
+    .number()
+    .int()
+    .positive()
+    .optional()
+    .describe('Timeout in milliseconds for inscription (default: no timeout - waits until completion)'),
   apiKey: z
     .string()
     .optional()
@@ -42,7 +48,7 @@ const inscribeFromUrlSchema = z.object({
  */
 export class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeFromUrlSchema> {
   name = 'inscribeFromUrl';
-  description = 'Inscribe content ONLY from URLs that point directly to downloadable files (PDF, image, JSON, ZIP, etc). This tool will FAIL for web pages, news sites, or social media. Examples of VALID URLs: https://example.com/document.pdf, https://cdn.example.com/image.jpg, https://api.example.com/data.json. For web page articles or any content you retrieve via MCP tools, you MUST use inscribeFromBuffer instead after retrieving the content.';
+  description = 'DO NOT use this for web pages, articles, or HTML content - it will FAIL. ONLY use for direct file downloads like PDFs, images, JSON, ZIP files. If user asks to inscribe a web page article, DO NOT use this tool. Valid examples: .pdf, .jpg, .png, .json, .zip files. Invalid examples: any web page, news article, blog post, social media content. For those, retrieve the content first then use inscribeFromBuffer.';
 
   get specificInputSchema() {
     return inscribeFromUrlSchema;
@@ -180,17 +186,29 @@ export class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeF
     };
 
     try {
-      const timeoutPromise = new Promise((_, reject) => {
-        setTimeout(() => reject(new Error('Inscription timed out after 30 seconds')), 30000);
-      });
+      let result: Awaited<ReturnType<typeof this.inscriberBuilder.inscribe>>;
+      
+      if (params.timeoutMs) {
+        const timeoutPromise = new Promise<never>((_, reject) => {
+          setTimeout(
+            () => reject(new Error(`Inscription timed out after ${params.timeoutMs}ms`)),
+            params.timeoutMs
+          );
+        });
 
-      const result = await Promise.race([
-        this.inscriberBuilder.inscribe(
+        result = await Promise.race([
+          this.inscriberBuilder.inscribe(
+            { type: 'url', url: params.url },
+            options
+          ),
+          timeoutPromise
+        ]);
+      } else {
+        result = await this.inscriberBuilder.inscribe(
           { type: 'url', url: params.url },
           options
-        ),
-        timeoutPromise
-      ]) as any;
+        );
+      }
 
       if (result.confirmed) {
         const topicId = result.inscription?.topic_id || result.result.topicId;

package/src/tools/inscriber/InscribeHashinalTool.ts

@@ -44,6 +44,12 @@ const inscribeHashinalSchema = z.object({
     .boolean()
     .optional()
     .describe('Whether to wait for inscription confirmation'),
+  timeoutMs: z
+    .number()
+    .int()
+    .positive()
+    .optional()
+    .describe('Timeout in milliseconds for inscription (default: no timeout - waits until completion)'),
   apiKey: z
     .string()
     .optional()
@@ -89,17 +95,29 @@ export class InscribeHashinalTool extends BaseInscriberQueryTool<typeof inscribe
     };
 
     try {
-      const timeoutPromise = new Promise((_, reject) => {
-        setTimeout(() => reject(new Error('Inscription timed out after 30 seconds')), 30000);
-      });
+      let result: Awaited<ReturnType<typeof this.inscriberBuilder.inscribe>>;
+      
+      if (params.timeoutMs) {
+        const timeoutPromise = new Promise<never>((_, reject) => {
+          setTimeout(
+            () => reject(new Error(`Inscription timed out after ${params.timeoutMs}ms`)),
+            params.timeoutMs
+          );
+        });
 
-      const result = await Promise.race([
-        this.inscriberBuilder.inscribe(
+        result = await Promise.race([
+          this.inscriberBuilder.inscribe(
+            { type: 'url', url: params.url },
+            options
+          ),
+          timeoutPromise
+        ]);
+      } else {
+        result = await this.inscriberBuilder.inscribe(
           { type: 'url', url: params.url },
           options
-        ),
-        timeoutPromise
-      ]) as any;
+        );
+      }
 
       if (result.confirmed) {
         const topicId = result.inscription?.topic_id || result.result.topicId;