@hashgraphonline/standards-agent-kit 0.2.132 → 0.2.135

package/dist/umd/tools/index.d.ts

@@ -2,4 +2,3 @@ export * from './hcs10';
 export * from './hcs2';
 export * from './hcs6';
 export * from './inscriber';
-export * from './hedera';

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

@@ -37,6 +37,7 @@ declare const inscribeHashinalSchema: import('../..').ZodSchemaWithRender<{
 export declare class InscribeHashinalTool extends BaseInscriberQueryTool implements FormValidatable {
     name: string;
     description: string;
+    getEntityResolutionPreferences(): Record<string, string>;
     get specificInputSchema(): z.ZodObject<z.ZodRawShape>;
     private _schemaWithRenderConfig?;
     get schema(): z.ZodObject<z.ZodRawShape>;
@@ -60,7 +61,47 @@ export declare class InscribeHashinalTool extends BaseInscriberQueryTool impleme
     };
     protected executeQuery(params: z.infer<typeof inscribeHashinalSchema>, _runManager?: CallbackManagerForToolRun): Promise<InscriptionResponse>;
     /**
-     * Creates HashLink block reference for inscription display
+     * Creates HashLink block configuration for Hashinal inscriptions.
+     * Automatically detects network and selects appropriate block ID configuration.
+     * Uses testnet block as fallback for unknown networks or undeployed mainnet blocks.
+     *
+     * @param response The inscription response containing metadata and network information
+     * @param _mimeType Optional MIME type (currently unused, preserved for compatibility)
+     * @returns HCS12BlockResult with network-specific block configuration
+     *
+     * @example
+     * ```typescript
+     * // Testnet usage (automatic detection from client)
+     * const testnetClient = Client.forTestnet();
+     * const tool = new InscribeHashinalTool(testnetClient);
+     * const block = await tool.createHashLinkBlock(inscriptionResponse);
+     * console.log(block.blockId);   // '0.0.6617393'
+     * console.log(block.hashLink);  // 'hcs://12/0.0.6617393'
+     *
+     * // Mainnet usage (automatic detection from client)
+     * const mainnetClient = Client.forMainnet();
+     * const tool = new InscribeHashinalTool(mainnetClient);
+     * const block = await tool.createHashLinkBlock(inscriptionResponse);
+     * console.log(block.blockId);   // Network-specific mainnet block ID
+     *
+     * // HashLink Block Response Structure:
+     * {
+     *   blockId: string;        // Hedera account ID format (e.g., '0.0.6617393')
+     *   hashLink: string;       // HCS-12 URL format: 'hcs://12/{blockId}'
+     *   template: string;       // Block template reference matching blockId
+     *   attributes: {           // Metadata for client-side processing
+     *     name: string;         // Content display name
+     *     creator: string;      // Creator account ID
+     *     topicId: string;      // HCS topic containing the inscription
+     *     hrl: string;          // Hedera Resource Locator
+     *     network: string;      // Network type: 'testnet' | 'mainnet'
+     *   }
+     * }
+     *
+     * // Render function usage in HashLink blocks:
+     * // The block's JavaScript render function receives this structure
+     * // and can access network-specific resources through attributes.network
+     * ```
      */
     private createHashLinkBlock;
     private resolveContent;

package/dist/umd/tools/inscriber/base-inscriber-tools.d.ts

@@ -4,12 +4,22 @@ import { InscriberTransactionToolParams, InscriberQueryToolParams } from './insc
 import { ContentResolverInterface } from '../../types/content-resolver';
 import { InscriptionInput, InscriptionOptions, QuoteResult } from '@hashgraphonline/standards-sdk';
 import { z } from 'zod';
+/**
+ * Event emitted when an entity is created during inscription
+ */
+export interface EntityCreationEvent {
+    entityId: string;
+    entityName: string;
+    entityType: string;
+    transactionId?: string;
+}
 /**
  * Base class for Inscriber transaction tools
  */
 export declare abstract class BaseInscriberTransactionTool<T extends z.ZodObject<z.ZodRawShape, z.UnknownKeysParam, z.ZodTypeAny> = z.ZodObject<z.ZodRawShape>> extends BaseHederaTransactionTool<T> {
     protected inscriberBuilder: InscriberBuilder;
     protected contentResolver: ContentResolverInterface | null;
+    protected onEntityCreated?: (event: EntityCreationEvent) => void;
     namespace: "inscriber";
     constructor(params: InscriberTransactionToolParams);
     /**
@@ -20,6 +30,10 @@ export declare abstract class BaseInscriberTransactionTool<T extends z.ZodObject
      * Get content resolver with fallback to registry
      */
     protected getContentResolver(): ContentResolverInterface | null;
+    /**
+     * Set entity creation handler for automatic entity storage
+     */
+    setEntityCreationHandler(handler: (event: EntityCreationEvent) => void): void;
     /**
      * Generate a quote for an inscription without executing it
      * @param input - The inscription input data
@@ -34,6 +48,7 @@ export declare abstract class BaseInscriberTransactionTool<T extends z.ZodObject
 export declare abstract class BaseInscriberQueryTool<T extends z.ZodObject<z.ZodRawShape, z.UnknownKeysParam, z.ZodTypeAny> = z.ZodObject<z.ZodRawShape>> extends BaseHederaQueryTool<T> {
     protected inscriberBuilder: InscriberBuilder;
     protected contentResolver: ContentResolverInterface | null;
+    protected onEntityCreated?: (event: EntityCreationEvent) => void;
     namespace: "inscriber";
     constructor(params: InscriberQueryToolParams);
     /**
@@ -44,6 +59,10 @@ export declare abstract class BaseInscriberQueryTool<T extends z.ZodObject<z.Zod
      * Get content resolver with fallback to registry
      */
     protected getContentResolver(): ContentResolverInterface | null;
+    /**
+     * Set entity creation handler for automatic entity storage
+     */
+    setEntityCreationHandler(handler: (event: EntityCreationEvent) => void): void;
     /**
      * Generate a quote for an inscription without executing it
      * @param input - The inscription input data

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hashgraphonline/standards-agent-kit",
-  "version": "0.2.132",
+  "version": "0.2.135",
   "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",
@@ -21,6 +21,33 @@
     "LICENSE",
     "README.md"
   ],
+  "scripts": {
+    "clean": "rimraf dist",
+    "build:es": "BUILD_FORMAT=es vite build",
+    "build:cjs": "BUILD_FORMAT=cjs vite build",
+    "build:umd": "BUILD_FORMAT=umd vite build",
+    "build": "pnpm run clean && pnpm run build:es && pnpm run build:cjs && pnpm run build:umd",
+    "test": "jest",
+    "lint": "eslint . --ext .ts",
+    "lint:fix": "eslint . --ext .ts --fix",
+    "prepare": "pnpm run build",
+    "prepublishOnly": "pnpm run build",
+    "release": "pnpm publish --access public",
+    "release:canary": "pnpm run prepublishOnly && pnpm publish --tag canary --access public",
+    "version:canary": "pnpm version prerelease --preid canary --no-git-tag-version",
+    "publish:canary": "pnpm run version:canary && pnpm run release:canary",
+    "demo:cli": "tsx examples/cli-demo.ts",
+    "demo:interactive": "tsx examples/interactive-demo.ts",
+    "demo:langchain": "tsx examples/langchain-demo.ts",
+    "demo:plugin": "tsx examples/plugin-system-example.ts",
+    "demo:plugin:weather": "tsx examples/plugins/weather/index.ts",
+    "demo:plugin:defi": "tsx examples/plugins/defi/index.ts",
+    "demo:plugin:openconvai": "tsx examples/openconvai-plugin-example.ts",
+    "demo:inscription-quotes": "tsx examples/inscription-quote-demo.ts",
+    "standards-agent:start": "tsx examples/standards-expert/cli.ts -- start",
+    "standards-agent:process-docs": "tsx examples/standards-expert/cli.ts -- process-docs --all-repos",
+    "typecheck": "tsc --noEmit"
+  },
   "keywords": [
     "hedera",
     "hcs10",
@@ -63,7 +90,8 @@
   },
   "dependencies": {
     "@hashgraph/sdk": "^2.69.0",
-    "@hashgraphonline/standards-sdk": "0.0.182",
+    "@hashgraphonline/standards-sdk": "0.0.187",
+    "@kiloscribe/inscription-sdk": "^1.0.59",
     "@langchain/community": "^0.3.5",
     "@langchain/core": "^0.3.71",
     "@langchain/openai": "^0.6.7",
@@ -79,7 +107,7 @@
     "zod": "^3.25.28"
   },
   "devDependencies": {
-    "@hashgraphonline/conversational-agent": "0.1.205",
+    "@hashgraphonline/conversational-agent": "0.1.217",
     "@rollup/plugin-commonjs": "^28.0.6",
     "@swc/core": "^1.11.21",
     "@swc/jest": "^0.2.36",
@@ -101,29 +129,5 @@
     "vite-plugin-node-polyfills": "^0.23.0",
     "vite-plugin-string-replace": "^1.1.3"
   },
-  "scripts": {
-    "clean": "rimraf dist",
-    "build:es": "BUILD_FORMAT=es vite build",
-    "build:cjs": "BUILD_FORMAT=cjs vite build",
-    "build:umd": "BUILD_FORMAT=umd vite build",
-    "build": "pnpm run clean && pnpm run build:es && pnpm run build:cjs && pnpm run build:umd",
-    "test": "jest",
-    "lint": "eslint . --ext .ts",
-    "lint:fix": "eslint . --ext .ts --fix",
-    "release": "pnpm publish --access public",
-    "release:canary": "pnpm run prepublishOnly && pnpm publish --tag canary --access public",
-    "version:canary": "pnpm version prerelease --preid canary --no-git-tag-version",
-    "publish:canary": "pnpm run version:canary && pnpm run release:canary",
-    "demo:cli": "tsx examples/cli-demo.ts",
-    "demo:interactive": "tsx examples/interactive-demo.ts",
-    "demo:langchain": "tsx examples/langchain-demo.ts",
-    "demo:plugin": "tsx examples/plugin-system-example.ts",
-    "demo:plugin:weather": "tsx examples/plugins/weather/index.ts",
-    "demo:plugin:defi": "tsx examples/plugins/defi/index.ts",
-    "demo:plugin:openconvai": "tsx examples/openconvai-plugin-example.ts",
-    "demo:inscription-quotes": "tsx examples/inscription-quote-demo.ts",
-    "standards-agent:start": "tsx examples/standards-expert/cli.ts -- start",
-    "standards-agent:process-docs": "tsx examples/standards-expert/cli.ts -- process-docs --all-repos",
-    "typecheck": "tsc --noEmit"
-  }
-}
+  "packageManager": "pnpm@10.11.1+sha512.e519b9f7639869dc8d5c3c5dfef73b3f091094b0a006d7317353c72b124e80e1afd429732e28705ad6bfa1ee879c1fce46c128ccebd3192101f43dd67c667912"
+}

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

@@ -137,8 +137,6 @@ export class HCS10Builder extends BaseServiceBuilder {
   private standardClient: HCS10Client;
   private stateManager: IStateManager | undefined;
   private executeResult?: ExecuteResult & { rawResult?: unknown };
-  private useEncryption: boolean = false;
-  private guardedRegistryBaseUrl: string = '';
   private network: StandardNetworkType;
   private sdkLogger: SDKLogger;
 
@@ -153,8 +151,6 @@ export class HCS10Builder extends BaseServiceBuilder {
   ) {
     super(hederaKit);
     this.stateManager = stateManager;
-    this.useEncryption = options?.useEncryption || false;
-    this.guardedRegistryBaseUrl = options?.registryUrl || '';
 
     const network = this.hederaKit.client.network;
     this.network = network.toString().includes('mainnet')

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

@@ -11,59 +11,16 @@ import {
   HederaClientConfig,
   NetworkType,
 } from '@hashgraphonline/standards-sdk';
+import { InscriptionSDK } from '@kiloscribe/inscription-sdk';
 
 /**
- * Type definition for DAppSigner from hedera-wallet-connect
+ * Type definition for DAppSigner interface compatible with inscription SDK
  */
 interface DAppSigner {
   getAccountId(): { toString(): string };
   [key: string]: unknown;
 }
 
-/**
- * Type definition for inscription request parameters
- */
-interface InscriptionRequest {
-  [key: string]: unknown;
-}
-
-/**
- * Type definition for inscription configuration
- */
-interface InscriptionConfig {
-  [key: string]: unknown;
-}
-
-/**
- * Type definition for inscription execution result
- */
-interface InscriptionExecutionResult {
-  [key: string]: unknown;
-}
-
-/**
- * Type definition for inscription result
- */
-interface InscriptionResult {
-  [key: string]: unknown;
-}
-
-/**
- * Type definition for wait for inscription result
- */
-interface WaitForInscriptionResult {
-  [key: string]: unknown;
-}
-
-/**
- * Type definition for InscriptionSDK since we don't have the actual package
- */
-interface InscriptionSDK {
-  inscribeAndExecute(request: InscriptionRequest, config: InscriptionConfig): Promise<InscriptionExecutionResult>;
-  inscribe(request: InscriptionRequest, signer: DAppSigner): Promise<InscriptionResult>;
-  waitForInscription(txId: string, maxAttempts: number, intervalMs: number, checkCompletion: boolean, progressCallback?: (...args: unknown[]) => void): Promise<WaitForInscriptionResult>;
-}
-
 /**
  * Builder for Inscription operations
  */

package/src/lib/zod-render/config-extractor.ts

@@ -34,15 +34,6 @@ interface FieldConfigMapEntry {
   path: string[];
 }
 
-/**
- * Type definition for validation rules entries
- */
-interface ValidationRulesEntry {
-  required: boolean;
-  type: FormFieldType;
-  constraints: Record<string, unknown>;
-  customMessages?: Record<string, string>;
-}
 
 /**
  * Type definition for simple field configuration
@@ -326,91 +317,8 @@ export function createFieldConfigMap(schema: ZodType<unknown>): Record<string, F
   return configMap;
 }
 
-/**
- * Generates validation rules from schema and render configs
- */
-export function extractValidationRules(schema: ZodType<unknown>): Record<string, ValidationRulesEntry> {
-  const extracted = extractRenderConfigs(schema);
-  const rules: Record<string, ValidationRulesEntry> = {};
-
-  for (const [fieldPath, metadata] of Object.entries(extracted.metadata)) {
-    const renderConfig = extracted.fields[fieldPath];
-
-    rules[fieldPath] = {
-      required: metadata.required,
-      type: metadata.type,
-      constraints: metadata.constraints || {},
-      customMessages: renderConfig?.validation?.customMessages
-    };
-  }
-
-  return rules;
-}
-
-/**
- * Merges render configurations from multiple schemas
- */
-export function mergeRenderConfigs(
-  ...configs: ExtractedRenderConfig[]
-): ExtractedRenderConfig {
-  const merged: ExtractedRenderConfig = {
-    fields: {},
-    groups: {},
-    order: [],
-    metadata: {}
-  };
-
-  for (const config of configs) {
-    Object.assign(merged.fields, config.fields);
-    Object.assign(merged.metadata, config.metadata);
-
-    for (const [groupName, groupFields] of Object.entries(config.groups)) {
-      if (!merged.groups[groupName]) {
-        merged.groups[groupName] = [];
-      }
-      merged.groups[groupName].push(...groupFields);
-    }
-
-    merged.order.push(...config.order);
-  }
-
-  merged.order = [...new Set(merged.order)];
-
-  return merged;
-}
-
-/**
- * Filters render configurations based on conditions
- */
-export function filterRenderConfigs(
-  config: ExtractedRenderConfig,
-  filter: (fieldPath: string, renderConfig: RenderConfigSchema) => boolean
-): ExtractedRenderConfig {
-  const filtered: ExtractedRenderConfig = {
-    fields: {},
-    groups: {},
-    order: [],
-    metadata: {}
-  };
-
-  for (const [fieldPath, renderConfig] of Object.entries(config.fields)) {
-    if (filter(fieldPath, renderConfig)) {
-      filtered.fields[fieldPath] = renderConfig;
-      filtered.metadata[fieldPath] = config.metadata[fieldPath];
-    }
-  }
 
-  for (const [groupName, groupFields] of Object.entries(config.groups)) {
-    const filteredFields = groupFields.filter(fieldPath => filtered.fields[fieldPath]);
-    if (filteredFields.length > 0) {
-      filtered.groups[groupName] = filteredFields;
-    }
-  }
 
-  filtered.order = config.order.filter(fieldPath => filtered.fields[fieldPath]);
-
-  return filtered;
-}
 
 /**
  * Creates a simplified configuration for basic form rendering

package/src/lib/zod-render/index.ts

@@ -6,18 +6,13 @@ export {
   extendZodSchema,
   hasRenderConfig,
   getRenderConfig,
-  renderConfigs,
-  createRenderConfig,
-  schemaComposer
+  renderConfigs
 } from './schema-extension';
 
 export {
   extractRenderConfigs,
   generateFieldOrdering,
   createFieldConfigMap,
-  extractValidationRules,
-  mergeRenderConfigs,
-  filterRenderConfigs,
   createSimpleConfig
 } from './config-extractor';
 
@@ -37,6 +32,5 @@ export type {
   SelectOption,
   FileUploadResult,
   FieldMetadata,
-  SchemaComposer,
   ExtractedRenderConfig
 } from './types';

package/src/lib/zod-render/schema-extension.ts

@@ -1,5 +1,5 @@
 import { ZodType } from 'zod';
-import { RenderConfigSchema, EnhancedRenderConfig, ZodSchemaWithRender, FormFieldType, FieldMetadata, SelectOption, SchemaComposer } from './types';
+import { RenderConfigSchema, EnhancedRenderConfig, ZodSchemaWithRender, FormFieldType, FieldMetadata, SelectOption } from './types';
 
 // Type definitions for extended Zod schemas - using Record to extend existing properties
 interface ExtendedZodSchema {
@@ -376,75 +376,7 @@ export function extractFieldMetadata(schema: ZodType<unknown>): FieldMetadata {
   };
 }
 
-/**
- * Schema composition utilities for building complex forms
- */
-export const schemaComposer: SchemaComposer = {
-  merge: <TSchema1, TSchema2>(schema1: ZodType<TSchema1>, schema2: ZodType<TSchema2>) => {
-    const typeName1 = (schema1._def as Record<string, unknown>)?.typeName;
-    const typeName2 = (schema2._def as Record<string, unknown>)?.typeName;
-
-    if (typeName1 === 'ZodObject' && typeName2 === 'ZodObject') {
-      return (schema1 as ZodType<TSchema1> & ExtendedZodSchema).merge?.(schema2) as ZodType<TSchema1 & TSchema2> || schema1 as ZodType<TSchema1 & TSchema2>;
-    }
 
-    throw new Error('Can only merge ZodObject schemas');
-  },
-
-  extend: <TSchema>(schema: ZodType<TSchema>, extensions: Record<string, ZodType<unknown>>) => {
-    const typeName = (schema._def as Record<string, unknown>)?.typeName;
-
-    if (typeName === 'ZodObject') {
-      return (schema as ZodType<TSchema> & ExtendedZodSchema).extend?.(extensions) as ZodType<TSchema> || schema;
-    }
-
-    throw new Error('Can only extend ZodObject schemas');
-  },
-
-  pick: <TSchema>(schema: ZodType<TSchema>, keys: string[]) => {
-    const typeName = (schema._def as Record<string, unknown>)?.typeName;
-
-    if (typeName === 'ZodObject') {
-      const pickObj: Record<string, boolean> = {};
-      keys.forEach(key => pickObj[key] = true);
-      return (schema as ZodType<TSchema> & ExtendedZodSchema).pick?.(pickObj) as ZodType<Partial<TSchema>> || schema as ZodType<Partial<TSchema>>;
-    }
-
-    throw new Error('Can only pick from ZodObject schemas');
-  },
-
-  omit: <TSchema>(schema: ZodType<TSchema>, keys: string[]) => {
-    const typeName = (schema._def as Record<string, unknown>)?.typeName;
-
-    if (typeName === 'ZodObject') {
-      const omitObj: Record<string, boolean> = {};
-      keys.forEach(key => omitObj[key] = true);
-      return (schema as ZodType<TSchema> & ExtendedZodSchema).omit?.(omitObj) as ZodType<Omit<TSchema, string>> || schema as ZodType<Omit<TSchema, string>>;
-    }
-
-    throw new Error('Can only omit from ZodObject schemas');
-  }
-};
-
-/**
- * Creates render configuration with sensible defaults
- */
-export function createRenderConfig(overrides: Partial<EnhancedRenderConfig> = {}): EnhancedRenderConfig {
-  return {
-    fieldType: 'text',
-    ui: {
-      label: '',
-      width: 'full',
-      priority: 'common',
-      ...overrides.ui
-    },
-    progressive: {
-      priority: 'common',
-      ...overrides.progressive
-    },
-    ...overrides
-  };
-}
 
 /**
  * Helper function to create common render configurations

package/src/tools/index.ts

@@ -1,5 +1,4 @@
 export * from './hcs10';
 export * from './hcs2';
 export * from './hcs6';
-export * from './inscriber';
-export * from './hedera';
+export * from './inscriber';

package/src/tools/inscriber/InscribeFromBufferTool.ts

@@ -59,8 +59,8 @@ export class InscribeFromBufferTool extends BaseInscriberQueryTool<
       waitForConfirmation: params.quoteOnly
         ? false
         : params.waitForConfirmation ?? true,
-      waitMaxAttempts: 10,
-      waitIntervalMs: 3000,
+      waitMaxAttempts: 60,
+      waitIntervalMs: 5000,
       apiKey: params.apiKey,
       network: this.inscriberBuilder['hederaKit'].client.network
         .toString()

package/src/tools/inscriber/InscribeFromUrlTool.ts

@@ -242,8 +242,8 @@ export class InscribeFromUrlTool extends BaseInscriberQueryTool<
       waitForConfirmation: params.quoteOnly
         ? false
         : params.waitForConfirmation ?? true,
-      waitMaxAttempts: 10,
-      waitIntervalMs: 3000,
+      waitMaxAttempts: 60,
+      waitIntervalMs: 5000,
       apiKey: params.apiKey,
       network: this.inscriberBuilder['hederaKit'].client.network
         .toString()