@hashgraphonline/standards-agent-kit 0.2.1 → 0.2.102

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

@@ -1,40 +1,240 @@
+import { AIAgentCapability } from "@hashgraphonline/standards-sdk";
 import { z } from "zod";
-import { BaseHCS10TransactionTool } from "./standards-agent-kit.es4.js";
-const InitiateConnectionZodSchema = z.object({
-  targetAccountId: z.string().describe(
-    "The Hedera account ID (e.g., 0.0.12345) of the agent you want to connect with."
+import { BaseHCS10TransactionTool } from "./standards-agent-kit.es6.js";
+import { NaturalLanguageMapper } from "./standards-agent-kit.es18.js";
+const RegisterAgentZodSchema = z.object({
+  name: z.string().min(1).max(50).describe("A unique name for the agent (1-50 characters)"),
+  description: z.string().max(500).optional().describe("Optional bio description for the agent (max 500 characters)"),
+  alias: z.string().optional().transform((val) => {
+    if (!val || val.toLowerCase().includes("random")) {
+      const timestamp = Date.now().toString(36);
+      const randomChars = Math.random().toString(36);
+      return `bot${timestamp}${randomChars}`;
+    }
+    return val;
+  }).describe(
+    'Optional custom username/alias for the agent. Use "random" to generate a unique alias'
+  ),
+  type: z.enum(["autonomous", "manual"]).optional().describe("Agent type (default: autonomous)"),
+  model: z.string().optional().describe("AI model identifier (default: agent-model-2024)"),
+  capabilities: z.union([
+    z.array(z.nativeEnum(AIAgentCapability)),
+    z.array(z.string()),
+    z.string()
+  ]).optional().transform((val) => {
+    if (!val) return void 0;
+    if (typeof val === "string") {
+      return NaturalLanguageMapper.parseCapabilities(val);
+    }
+    if (Array.isArray(val) && val.length > 0 && typeof val[0] === "string") {
+      return NaturalLanguageMapper.parseTagsOrCapabilities(val);
+    }
+    return val;
+  }).describe('Agent capabilities - can be capability names (e.g. "ai", "data processing"), capability enum values, or array of either. Common values: "ai"/"text" (TEXT_GENERATION), "data" (DATA_INTEGRATION), "analytics" (TRANSACTION_ANALYTICS)'),
+  tags: z.union([
+    z.array(z.string()),
+    z.string()
+  ]).optional().transform((val) => {
+    if (!val) return void 0;
+    if (typeof val === "string") {
+      return NaturalLanguageMapper.parseCapabilities(val);
+    }
+    return NaturalLanguageMapper.parseTagsOrCapabilities(val);
+  }).describe('Tags for the agent (alternative to capabilities) - e.g. "ai", "data", "analytics". Will be converted to appropriate capabilities.'),
+  creator: z.string().optional().describe("Creator attribution for the agent"),
+  socials: z.record(
+    z.enum([
+      "twitter",
+      "github",
+      "discord",
+      "telegram",
+      "linkedin",
+      "youtube",
+      "website",
+      "x"
+    ]),
+    z.string()
+  ).optional().describe(
+    'Social media links (e.g., {"twitter": "@handle", "discord": "username"})'
+  ),
+  properties: z.record(z.unknown()).optional().describe("Custom metadata properties for the agent"),
+  profilePicture: z.union([
+    z.string().describe("URL or local file path to profile picture"),
+    z.object({
+      url: z.string().optional(),
+      path: z.string().optional(),
+      filename: z.string().optional()
+    })
+  ]).optional().describe(
+    "Optional profile picture as URL, file path, or object with url/path/filename"
+  ),
+  existingProfilePictureTopicId: z.string().optional().describe(
+    "Topic ID of an existing profile picture to reuse (e.g., 0.0.12345)"
   ),
-  disableMonitor: z.boolean().optional().describe(
-    "If true, does not wait for connection confirmation. Returns immediately after sending the request."
+  initialBalance: z.number().positive().optional().describe(
+    "Optional initial HBAR balance for the new agent account (will create new account if provided)"
   ),
-  memo: z.string().optional().describe(
-    'Optional memo to include with the connection request (e.g., "Hello from Alice"). If not provided, defaults to "true" or "false" based on monitoring preference.'
-  )
+  userAccountId: z.string().optional().describe(
+    "Optional account ID (e.g., 0.0.12345) to use as the agent account instead of creating a new one"
+  ),
+  hbarFee: z.number().positive().optional().describe(
+    "Optional HBAR fee amount to charge per message on the inbound topic"
+  ),
+  tokenFees: z.array(
+    z.object({
+      amount: z.number().positive(),
+      tokenId: z.string()
+    })
+  ).optional().describe("Optional token fees to charge per message"),
+  exemptAccountIds: z.array(z.string()).optional().describe("Optional account IDs to exempt from fees"),
+  setAsCurrent: z.boolean().optional().describe("Whether to set as current agent (default: true)"),
+  persistence: z.object({
+    prefix: z.string().optional()
+  }).optional().describe("Optional persistence configuration")
 });
-class InitiateConnectionTool extends BaseHCS10TransactionTool {
+class RegisterAgentTool extends BaseHCS10TransactionTool {
   constructor(params) {
     super(params);
-    this.name = "initiate_connection";
-    this.description = "Actively STARTS a NEW HCS-10 connection TO a specific target agent identified by their account ID. Requires the targetAccountId parameter. Use this ONLY to INITIATE an OUTGOING connection request.";
-    this.specificInputSchema = InitiateConnectionZodSchema;
+    this.name = "register_agent";
+    this.description = 'Creates and registers the AI agent on the Hedera network. Returns JSON string with agent details (accountId, privateKey, topics) on success. Supports natural language for capabilities/tags like "ai", "data processing", "analytics". Note: This tool requires multiple transactions and cannot be used in returnBytes mode. If alias is set to "random" or contains "random", a unique alias will be generated.';
+    this.specificInputSchema = RegisterAgentZodSchema;
     this.neverScheduleThisTool = true;
     this.requiresMultipleTransactions = true;
   }
   async callBuilderMethod(builder, specificArgs) {
     const hcs10Builder = builder;
+    this.specificArgs = specificArgs;
     const params = {
-      targetAccountId: specificArgs.targetAccountId
+      name: specificArgs.name
     };
-    if (specificArgs.disableMonitor !== void 0) {
-      params.disableMonitor = specificArgs.disableMonitor;
+    if (specificArgs.description !== void 0) {
+      params.bio = specificArgs.description;
+    }
+    if (specificArgs.alias !== void 0) {
+      params.alias = specificArgs.alias;
+    } else {
+      const randomSuffix = Date.now().toString(36);
+      params.alias = `${specificArgs.name}${randomSuffix}`;
+    }
+    if (specificArgs.type !== void 0) {
+      params.type = specificArgs.type;
+    }
+    if (specificArgs.model !== void 0) {
+      params.model = specificArgs.model;
+    }
+    if (specificArgs.tags !== void 0) {
+      params.capabilities = specificArgs.tags;
+    } else if (specificArgs.capabilities !== void 0) {
+      params.capabilities = specificArgs.capabilities;
+    }
+    if (specificArgs.creator !== void 0) {
+      params.creator = specificArgs.creator;
+    }
+    if (specificArgs.socials !== void 0) {
+      params.socials = specificArgs.socials;
+    }
+    if (specificArgs.properties !== void 0) {
+      params.properties = specificArgs.properties;
+    }
+    if (specificArgs.profilePicture !== void 0) {
+      if (typeof specificArgs.profilePicture === "string") {
+        params.profilePicture = specificArgs.profilePicture;
+      } else {
+        const profilePicObj = {};
+        if (specificArgs.profilePicture.url !== void 0) {
+          profilePicObj.url = specificArgs.profilePicture.url;
+        }
+        if (specificArgs.profilePicture.path !== void 0) {
+          profilePicObj.path = specificArgs.profilePicture.path;
+        }
+        if (specificArgs.profilePicture.filename !== void 0) {
+          profilePicObj.filename = specificArgs.profilePicture.filename;
+        }
+        params.profilePicture = profilePicObj;
+      }
+    }
+    if (specificArgs.existingProfilePictureTopicId !== void 0) {
+      params.existingProfilePictureTopicId = specificArgs.existingProfilePictureTopicId;
+    }
+    if (specificArgs.userAccountId !== void 0) {
+      params.userAccountId = specificArgs.userAccountId;
+    }
+    if (specificArgs.hbarFee !== void 0) {
+      params.hbarFee = specificArgs.hbarFee;
+    }
+    if (specificArgs.tokenFees !== void 0) {
+      params.tokenFees = specificArgs.tokenFees;
+    }
+    if (specificArgs.exemptAccountIds !== void 0) {
+      params.exemptAccountIds = specificArgs.exemptAccountIds;
+    }
+    if (specificArgs.initialBalance !== void 0) {
+      params.initialBalance = specificArgs.initialBalance;
+    }
+    await hcs10Builder.registerAgent(params);
+  }
+  /**
+   * Override _call to intercept the result and save agent to state if needed
+   */
+  async _call(args, runManager) {
+    const result = await super._call(args, runManager);
+    const shouldSetAsCurrent = this.specificArgs?.setAsCurrent !== false;
+    if (this.specificArgs && shouldSetAsCurrent) {
+      try {
+        const parsed = JSON.parse(result);
+        if (parsed.rawResult) {
+          this._handleRegistrationResult(parsed.rawResult);
+        } else if (parsed.state || parsed.accountId || parsed.metadata) {
+          this._handleRegistrationResult(parsed);
+        }
+      } catch (e) {
+      }
+    }
+    return result;
+  }
+  /**
+   * Extract agent data from registration result and save to state
+   */
+  _handleRegistrationResult(rawResult) {
+    let accountId = rawResult.accountId || rawResult.metadata?.accountId;
+    if (!accountId && rawResult.state?.createdResources) {
+      const accountResource = rawResult.state.createdResources.find(
+        (r) => r.startsWith("account:")
+      );
+      if (accountResource) {
+        accountId = accountResource.split(":")[1];
+      }
     }
-    if (specificArgs.memo !== void 0) {
-      params.memo = specificArgs.memo;
+    const inboundTopicId = rawResult.inboundTopicId || rawResult.metadata?.inboundTopicId || rawResult.state?.inboundTopicId;
+    const outboundTopicId = rawResult.outboundTopicId || rawResult.metadata?.outboundTopicId || rawResult.state?.outboundTopicId;
+    const profileTopicId = rawResult.profileTopicId || rawResult.metadata?.profileTopicId || rawResult.state?.profileTopicId;
+    const privateKey = rawResult.privateKey || rawResult.metadata?.privateKey;
+    if (accountId && inboundTopicId && outboundTopicId && this.specificArgs) {
+      const registeredAgent = {
+        name: this.specificArgs.name,
+        accountId,
+        inboundTopicId,
+        outboundTopicId,
+        profileTopicId,
+        privateKey
+      };
+      const hcs10Builder = this.getServiceBuilder();
+      const stateManager = hcs10Builder.getStateManager();
+      if (stateManager) {
+        stateManager.setCurrentAgent(registeredAgent);
+        if (stateManager.persistAgentData) {
+          const prefix = this.specificArgs.persistence?.prefix || this.specificArgs.name.toUpperCase().replace(/[^A-Z0-9]/g, "_");
+          stateManager.persistAgentData(registeredAgent, {
+            type: "env-file",
+            prefix
+          }).catch(() => {
+          });
+        }
+      }
     }
-    await hcs10Builder.initiateConnection(params);
   }
 }
 export {
-  InitiateConnectionTool
+  RegisterAgentTool
 };
 //# sourceMappingURL=standards-agent-kit.es7.js.map

package/dist/es/standards-agent-kit.es7.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es7.js","sources":["../../src/tools/hcs10/InitiateConnectionTool.ts"],"sourcesContent":["import { z } from 'zod';\nimport { BaseHCS10TransactionTool } from './base-hcs10-tools';\nimport { HCS10Builder } from '../../builders/hcs10/hcs10-builder';\nimport { HCS10TransactionToolParams } from './hcs10-tool-params';\nimport { BaseServiceBuilder } from 'hedera-agent-kit';\n\nconst InitiateConnectionZodSchema = z.object({\n  targetAccountId: z\n    .string()\n    .describe(\n      'The Hedera account ID (e.g., 0.0.12345) of the agent you want to connect with.'\n    ),\n  disableMonitor: z\n    .boolean()\n    .optional()\n    .describe(\n      'If true, does not wait for connection confirmation. Returns immediately after sending the request.'\n    ),\n  memo: z\n    .string()\n    .optional()\n    .describe(\n      'Optional memo to include with the connection request (e.g., \"Hello from Alice\"). If not provided, defaults to \"true\" or \"false\" based on monitoring preference.'\n    ),\n});\n\n/**\n * A tool to actively START a NEW HCS-10 connection TO a target agent.\n * Requires the target agent's account ID.\n * It retrieves their profile, sends a connection request, and optionally waits for confirmation.\n * Use this tool ONLY to actively INITIATE an OUTGOING connection.\n */\nexport class InitiateConnectionTool extends BaseHCS10TransactionTool<\n  typeof InitiateConnectionZodSchema\n> {\n  name = 'initiate_connection';\n  description =\n    'Actively STARTS a NEW HCS-10 connection TO a specific target agent identified by their account ID. Requires the targetAccountId parameter. Use this ONLY to INITIATE an OUTGOING connection request.';\n  specificInputSchema = InitiateConnectionZodSchema;\n  constructor(params: HCS10TransactionToolParams) {\n    super(params);\n    this.neverScheduleThisTool = true;\n    this.requiresMultipleTransactions = true;\n  }\n\n  protected async callBuilderMethod(\n    builder: BaseServiceBuilder,\n    specificArgs: z.infer<typeof InitiateConnectionZodSchema>\n  ): Promise<void> {\n    const hcs10Builder = builder as HCS10Builder;\n    const params: {\n      targetAccountId: string;\n      disableMonitor?: boolean;\n      memo?: string;\n    } = {\n      targetAccountId: specificArgs.targetAccountId,\n    };\n    if (specificArgs.disableMonitor !== undefined) {\n      params.disableMonitor = specificArgs.disableMonitor;\n    }\n    if (specificArgs.memo !== undefined) {\n      params.memo = specificArgs.memo;\n    }\n    await hcs10Builder.initiateConnection(params);\n  }\n}"],"names":[],"mappings":";;AAMA,MAAM,8BAA8B,EAAE,OAAO;AAAA,EAC3C,iBAAiB,EACd,OAAA,EACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,gBAAgB,EACb,UACA,WACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,MAAM,EACH,SACA,WACA;AAAA,IACC;AAAA,EAAA;AAEN,CAAC;AAQM,MAAM,+BAA+B,yBAE1C;AAAA,EAKA,YAAY,QAAoC;AAC9C,UAAM,MAAM;AALd,SAAA,OAAO;AACP,SAAA,cACE;AACF,SAAA,sBAAsB;AAGpB,SAAK,wBAAwB;AAC7B,SAAK,+BAA+B;AAAA,EACtC;AAAA,EAEA,MAAgB,kBACd,SACA,cACe;AACf,UAAM,eAAe;AACrB,UAAM,SAIF;AAAA,MACF,iBAAiB,aAAa;AAAA,IAAA;AAEhC,QAAI,aAAa,mBAAmB,QAAW;AAC7C,aAAO,iBAAiB,aAAa;AAAA,IACvC;AACA,QAAI,aAAa,SAAS,QAAW;AACnC,aAAO,OAAO,aAAa;AAAA,IAC7B;AACA,UAAM,aAAa,mBAAmB,MAAM;AAAA,EAC9C;AACF;"}
+{"version":3,"file":"standards-agent-kit.es7.js","sources":["../../src/tools/hcs10/RegisterAgentTool.ts"],"sourcesContent":["import { AIAgentCapability } from '@hashgraphonline/standards-sdk';\nimport { z } from 'zod';\nimport { BaseServiceBuilder } from 'hedera-agent-kit';\nimport { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';\nimport {\n  HCS10Builder,\n  RegisterAgentParams,\n} from '../../builders/hcs10/hcs10-builder';\nimport { BaseHCS10TransactionTool } from './base-hcs10-tools';\nimport { HCS10TransactionToolParams } from './hcs10-tool-params';\nimport { RegisteredAgent } from '../../state/state-types';\nimport { NaturalLanguageMapper } from './natural-language-mapper';\n\nconst RegisterAgentZodSchema = z.object({\n  name: z\n    .string()\n    .min(1)\n    .max(50)\n    .describe('A unique name for the agent (1-50 characters)'),\n  description: z\n    .string()\n    .max(500)\n    .optional()\n    .describe('Optional bio description for the agent (max 500 characters)'),\n  alias: z\n    .string()\n    .optional()\n    .transform((val) => {\n      if (!val || val.toLowerCase().includes('random')) {\n        const timestamp = Date.now().toString(36);\n        const randomChars = Math.random().toString(36);\n        return `bot${timestamp}${randomChars}`;\n      }\n      return val;\n    })\n    .describe(\n      'Optional custom username/alias for the agent. Use \"random\" to generate a unique alias'\n    ),\n  type: z\n    .enum(['autonomous', 'manual'])\n    .optional()\n    .describe('Agent type (default: autonomous)'),\n  model: z\n    .string()\n    .optional()\n    .describe('AI model identifier (default: agent-model-2024)'),\n  capabilities: z\n    .union([\n      z.array(z.nativeEnum(AIAgentCapability)),\n      z.array(z.string()),\n      z.string(),\n    ])\n    .optional()\n    .transform((val) => {\n      if (!val) return undefined;\n      if (typeof val === 'string') {\n        return NaturalLanguageMapper.parseCapabilities(val);\n      }\n      if (Array.isArray(val) && val.length > 0 && typeof val[0] === 'string') {\n        return NaturalLanguageMapper.parseTagsOrCapabilities(val);\n      }\n      return val as AIAgentCapability[];\n    })\n    .describe('Agent capabilities - can be capability names (e.g. \"ai\", \"data processing\"), capability enum values, or array of either. Common values: \"ai\"/\"text\" (TEXT_GENERATION), \"data\" (DATA_INTEGRATION), \"analytics\" (TRANSACTION_ANALYTICS)'),\n  tags: z\n    .union([\n      z.array(z.string()),\n      z.string(),\n    ])\n    .optional()\n    .transform((val) => {\n      if (!val) return undefined;\n      if (typeof val === 'string') {\n        return NaturalLanguageMapper.parseCapabilities(val);\n      }\n      return NaturalLanguageMapper.parseTagsOrCapabilities(val);\n    })\n    .describe('Tags for the agent (alternative to capabilities) - e.g. \"ai\", \"data\", \"analytics\". Will be converted to appropriate capabilities.'),\n  creator: z.string().optional().describe('Creator attribution for the agent'),\n  socials: z\n    .record(\n      z.enum([\n        'twitter',\n        'github',\n        'discord',\n        'telegram',\n        'linkedin',\n        'youtube',\n        'website',\n        'x',\n      ] as const),\n      z.string()\n    )\n    .optional()\n    .describe(\n      'Social media links (e.g., {\"twitter\": \"@handle\", \"discord\": \"username\"})'\n    ),\n  properties: z\n    .record(z.unknown())\n    .optional()\n    .describe('Custom metadata properties for the agent'),\n  profilePicture: z\n    .union([\n      z.string().describe('URL or local file path to profile picture'),\n      z.object({\n        url: z.string().optional(),\n        path: z.string().optional(),\n        filename: z.string().optional(),\n      }),\n    ])\n    .optional()\n    .describe(\n      'Optional profile picture as URL, file path, or object with url/path/filename'\n    ),\n  existingProfilePictureTopicId: z\n    .string()\n    .optional()\n    .describe(\n      'Topic ID of an existing profile picture to reuse (e.g., 0.0.12345)'\n    ),\n  initialBalance: z\n    .number()\n    .positive()\n    .optional()\n    .describe(\n      'Optional initial HBAR balance for the new agent account (will create new account if provided)'\n    ),\n  userAccountId: z\n    .string()\n    .optional()\n    .describe(\n      'Optional account ID (e.g., 0.0.12345) to use as the agent account instead of creating a new one'\n    ),\n  hbarFee: z\n    .number()\n    .positive()\n    .optional()\n    .describe(\n      'Optional HBAR fee amount to charge per message on the inbound topic'\n    ),\n  tokenFees: z\n    .array(\n      z.object({\n        amount: z.number().positive(),\n        tokenId: z.string(),\n      })\n    )\n    .optional()\n    .describe('Optional token fees to charge per message'),\n  exemptAccountIds: z\n    .array(z.string())\n    .optional()\n    .describe('Optional account IDs to exempt from fees'),\n  setAsCurrent: z\n    .boolean()\n    .optional()\n    .describe('Whether to set as current agent (default: true)'),\n  persistence: z\n    .object({\n      prefix: z.string().optional(),\n    })\n    .optional()\n    .describe('Optional persistence configuration'),\n});\n\nexport class RegisterAgentTool extends BaseHCS10TransactionTool<\n  typeof RegisterAgentZodSchema\n> {\n  name = 'register_agent';\n  description =\n    'Creates and registers the AI agent on the Hedera network. Returns JSON string with agent details (accountId, privateKey, topics) on success. Supports natural language for capabilities/tags like \"ai\", \"data processing\", \"analytics\". Note: This tool requires multiple transactions and cannot be used in returnBytes mode. If alias is set to \"random\" or contains \"random\", a unique alias will be generated.';\n  specificInputSchema = RegisterAgentZodSchema;\n  private specificArgs: z.infer<typeof RegisterAgentZodSchema> | undefined;\n\n  constructor(params: HCS10TransactionToolParams) {\n    super(params);\n    this.neverScheduleThisTool = true;\n    this.requiresMultipleTransactions = true;\n  }\n\n  protected async callBuilderMethod(\n    builder: BaseServiceBuilder,\n    specificArgs: z.infer<typeof RegisterAgentZodSchema>\n  ): Promise<void> {\n    const hcs10Builder = builder as HCS10Builder;\n    this.specificArgs = specificArgs;\n    const params: RegisterAgentParams = {\n      name: specificArgs.name,\n    };\n\n    if (specificArgs.description !== undefined) {\n      params.bio = specificArgs.description;\n    }\n    if (specificArgs.alias !== undefined) {\n      params.alias = specificArgs.alias;\n    } else {\n      const randomSuffix = Date.now().toString(36);\n      params.alias = `${specificArgs.name}${randomSuffix}`;\n    }\n    if (specificArgs.type !== undefined) {\n      params.type = specificArgs.type;\n    }\n    if (specificArgs.model !== undefined) {\n      params.model = specificArgs.model;\n    }\n    // Handle both capabilities and tags (tags takes precedence if both provided)\n    if (specificArgs.tags !== undefined) {\n      params.capabilities = specificArgs.tags as AIAgentCapability[];\n    } else if (specificArgs.capabilities !== undefined) {\n      params.capabilities = specificArgs.capabilities as AIAgentCapability[];\n    }\n    if (specificArgs.creator !== undefined) {\n      params.creator = specificArgs.creator;\n    }\n    if (specificArgs.socials !== undefined) {\n      params.socials = specificArgs.socials;\n    }\n    if (specificArgs.properties !== undefined) {\n      params.properties = specificArgs.properties;\n    }\n    if (specificArgs.profilePicture !== undefined) {\n      if (typeof specificArgs.profilePicture === 'string') {\n        params.profilePicture = specificArgs.profilePicture;\n      } else {\n        const profilePicObj: {\n          url?: string;\n          path?: string;\n          filename?: string;\n        } = {};\n        if (specificArgs.profilePicture.url !== undefined) {\n          profilePicObj.url = specificArgs.profilePicture.url;\n        }\n        if (specificArgs.profilePicture.path !== undefined) {\n          profilePicObj.path = specificArgs.profilePicture.path;\n        }\n        if (specificArgs.profilePicture.filename !== undefined) {\n          profilePicObj.filename = specificArgs.profilePicture.filename;\n        }\n        params.profilePicture = profilePicObj;\n      }\n    }\n    if (specificArgs.existingProfilePictureTopicId !== undefined) {\n      params.existingProfilePictureTopicId =\n        specificArgs.existingProfilePictureTopicId;\n    }\n    if (specificArgs.userAccountId !== undefined) {\n      params.userAccountId = specificArgs.userAccountId;\n    }\n    if (specificArgs.hbarFee !== undefined) {\n      params.hbarFee = specificArgs.hbarFee;\n    }\n    if (specificArgs.tokenFees !== undefined) {\n      params.tokenFees = specificArgs.tokenFees;\n    }\n    if (specificArgs.exemptAccountIds !== undefined) {\n      params.exemptAccountIds = specificArgs.exemptAccountIds;\n    }\n    if (specificArgs.initialBalance !== undefined) {\n      params.initialBalance = specificArgs.initialBalance;\n    }\n\n    await hcs10Builder.registerAgent(params);\n  }\n\n  /**\n   * Override _call to intercept the result and save agent to state if needed\n   */\n  protected override async _call(\n    args: z.infer<ReturnType<this['schema']>>,\n    runManager?: CallbackManagerForToolRun\n  ): Promise<string> {\n    const result = await super._call(args, runManager);\n\n    const shouldSetAsCurrent = this.specificArgs?.setAsCurrent !== false;\n\n    if (this.specificArgs && shouldSetAsCurrent) {\n      try {\n        const parsed = JSON.parse(result);\n        if (parsed.rawResult) {\n          this._handleRegistrationResult(parsed.rawResult);\n        } else if (parsed.state || parsed.accountId || parsed.metadata) {\n          this._handleRegistrationResult(parsed);\n        }\n      } catch (e) {}\n    }\n\n    return result;\n  }\n\n  /**\n   * Extract agent data from registration result and save to state\n   */\n  private _handleRegistrationResult(rawResult: any): void {\n    let accountId = rawResult.accountId || rawResult.metadata?.accountId;\n\n    if (!accountId && rawResult.state?.createdResources) {\n      const accountResource = rawResult.state.createdResources.find(\n        (r: string) => r.startsWith('account:')\n      );\n      if (accountResource) {\n        accountId = accountResource.split(':')[1];\n      }\n    }\n\n    const inboundTopicId =\n      rawResult.inboundTopicId ||\n      rawResult.metadata?.inboundTopicId ||\n      rawResult.state?.inboundTopicId;\n\n    const outboundTopicId =\n      rawResult.outboundTopicId ||\n      rawResult.metadata?.outboundTopicId ||\n      rawResult.state?.outboundTopicId;\n\n    const profileTopicId =\n      rawResult.profileTopicId ||\n      rawResult.metadata?.profileTopicId ||\n      rawResult.state?.profileTopicId;\n\n    const privateKey = rawResult.privateKey || rawResult.metadata?.privateKey;\n\n    if (accountId && inboundTopicId && outboundTopicId && this.specificArgs) {\n      const registeredAgent: RegisteredAgent = {\n        name: this.specificArgs.name,\n        accountId,\n        inboundTopicId,\n        outboundTopicId,\n        profileTopicId,\n        privateKey,\n      };\n\n      const hcs10Builder = this.getServiceBuilder() as HCS10Builder;\n      const stateManager = hcs10Builder.getStateManager();\n      if (stateManager) {\n        stateManager.setCurrentAgent(registeredAgent);\n\n        if (stateManager.persistAgentData) {\n          const prefix =\n            this.specificArgs.persistence?.prefix ||\n            this.specificArgs.name.toUpperCase().replace(/[^A-Z0-9]/g, '_');\n          stateManager\n            .persistAgentData(registeredAgent, {\n              type: 'env-file',\n              prefix: prefix,\n            })\n            .catch(() => {});\n        }\n      }\n    }\n  }\n}\n"],"names":[],"mappings":"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"}

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

@@ -1,40 +1,31 @@
 import { z } from "zod";
-import { BaseHCS10QueryTool } from "./standards-agent-kit.es4.js";
-const ListConnectionsZodSchema = z.object({
-  includeDetails: z.boolean().optional().describe(
-    "Whether to include detailed information about each connection"
+import { BaseHCS10TransactionTool } from "./standards-agent-kit.es6.js";
+const SendMessageToConnectionZodSchema = z.object({
+  targetIdentifier: z.string().describe(
+    "The request key (e.g., 'req-1:0.0.6155171@0.0.6154875'), account ID (e.g., 0.0.12345) of the target agent, OR the connection number (e.g., '1', '2') from the 'list_connections' tool. Request key is most deterministic."
   ),
-  showPending: z.boolean().optional().describe("Whether to include pending connection requests")
+  message: z.string().describe("The text message content to send."),
+  disableMonitoring: z.boolean().optional().default(false)
 });
-class ListConnectionsTool extends BaseHCS10QueryTool {
+class SendMessageToConnectionTool extends BaseHCS10TransactionTool {
   constructor(params) {
     super(params);
-    this.name = "list_connections";
-    this.description = "Lists the currently active HCS-10 connections with detailed information. Shows connection status, agent details, and recent activity. Use this to get a comprehensive view of all active connections.";
-    this.specificInputSchema = ListConnectionsZodSchema;
+    this.name = "send_message_to_connection";
+    this.description = "Sends a text message to another agent using an existing active connection. Identify the target agent using their account ID (e.g., 0.0.12345) or the connection number shown in 'list_connections'. Return back the reply from the target agent if possible";
+    this.specificInputSchema = SendMessageToConnectionZodSchema;
+    this.requiresMultipleTransactions = true;
+    this.neverScheduleThisTool = true;
   }
-  async executeQuery(args) {
-    const hcs10Builder = this.hcs10Builder;
-    const params = {};
-    if (args.includeDetails !== void 0) {
-      params.includeDetails = args.includeDetails;
-    }
-    if (args.showPending !== void 0) {
-      params.showPending = args.showPending;
-    }
-    await hcs10Builder.listConnections(params);
-    const result = await hcs10Builder.execute();
-    if (result.success && "rawResult" in result && result.rawResult) {
-      const raw = result.rawResult;
-      return {
-        success: true,
-        data: raw.formattedOutput || raw.message || "Connections listed"
-      };
-    }
-    return result;
+  async callBuilderMethod(builder, specificArgs) {
+    const hcs10Builder = builder;
+    await hcs10Builder.sendMessageToConnection({
+      targetIdentifier: specificArgs.targetIdentifier,
+      message: specificArgs.message,
+      disableMonitoring: specificArgs.disableMonitoring
+    });
   }
 }
 export {
-  ListConnectionsTool
+  SendMessageToConnectionTool
 };
 //# sourceMappingURL=standards-agent-kit.es8.js.map

package/dist/es/standards-agent-kit.es8.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es8.js","sources":["../../src/tools/hcs10/ListConnectionsTool.ts"],"sourcesContent":["import { z } from 'zod';\nimport { BaseHCS10QueryTool } from './base-hcs10-tools';\nimport { HCS10QueryToolParams } from './hcs10-tool-params';\n\n/**\n * A tool to list currently active HCS-10 connections stored in the state manager.\n * Enhanced to show more details similar to moonscape's implementation.\n */\nconst ListConnectionsZodSchema = z.object({\n  includeDetails: z\n    .boolean()\n    .optional()\n    .describe(\n      'Whether to include detailed information about each connection'\n    ),\n  showPending: z\n    .boolean()\n    .optional()\n    .describe('Whether to include pending connection requests'),\n});\n\nexport class ListConnectionsTool extends BaseHCS10QueryTool<\n  typeof ListConnectionsZodSchema\n> {\n  name = 'list_connections';\n  description =\n    'Lists the currently active HCS-10 connections with detailed information. Shows connection status, agent details, and recent activity. Use this to get a comprehensive view of all active connections.';\n  specificInputSchema = ListConnectionsZodSchema;\n  constructor(params: HCS10QueryToolParams) {\n    super(params);\n  }\n\n  protected async executeQuery(\n    args: z.infer<typeof ListConnectionsZodSchema>\n  ): Promise<unknown> {\n    const hcs10Builder = this.hcs10Builder;\n    const params: { includeDetails?: boolean; showPending?: boolean } = {};\n    if (args.includeDetails !== undefined) {\n      params.includeDetails = args.includeDetails;\n    }\n    if (args.showPending !== undefined) {\n      params.showPending = args.showPending;\n    }\n    await hcs10Builder.listConnections(params);\n\n    const result = await hcs10Builder.execute();\n\n    if (result.success && 'rawResult' in result && result.rawResult) {\n      const raw = result.rawResult as { formattedOutput?: string; message?: string };\n      return {\n        success: true,\n        data: raw.formattedOutput || raw.message || 'Connections listed'\n      };\n    }\n\n    return result;\n  }\n}"],"names":[],"mappings":";;AAQA,MAAM,2BAA2B,EAAE,OAAO;AAAA,EACxC,gBAAgB,EACb,UACA,WACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,aAAa,EACV,QAAA,EACA,SAAA,EACA,SAAS,gDAAgD;AAC9D,CAAC;AAEM,MAAM,4BAA4B,mBAEvC;AAAA,EAKA,YAAY,QAA8B;AACxC,UAAM,MAAM;AALd,SAAA,OAAO;AACP,SAAA,cACE;AACF,SAAA,sBAAsB;AAAA,EAGtB;AAAA,EAEA,MAAgB,aACd,MACkB;AAClB,UAAM,eAAe,KAAK;AAC1B,UAAM,SAA8D,CAAA;AACpE,QAAI,KAAK,mBAAmB,QAAW;AACrC,aAAO,iBAAiB,KAAK;AAAA,IAC/B;AACA,QAAI,KAAK,gBAAgB,QAAW;AAClC,aAAO,cAAc,KAAK;AAAA,IAC5B;AACA,UAAM,aAAa,gBAAgB,MAAM;AAEzC,UAAM,SAAS,MAAM,aAAa,QAAA;AAElC,QAAI,OAAO,WAAW,eAAe,UAAU,OAAO,WAAW;AAC/D,YAAM,MAAM,OAAO;AACnB,aAAO;AAAA,QACL,SAAS;AAAA,QACT,MAAM,IAAI,mBAAmB,IAAI,WAAW;AAAA,MAAA;AAAA,IAEhD;AAEA,WAAO;AAAA,EACT;AACF;"}
+{"version":3,"file":"standards-agent-kit.es8.js","sources":["../../src/tools/hcs10/SendMessageToConnectionTool.ts"],"sourcesContent":["import { z } from 'zod';\nimport { BaseHCS10TransactionTool } from './base-hcs10-tools';\nimport { HCS10Builder } from '../../builders/hcs10/hcs10-builder';\nimport { HCS10TransactionToolParams } from './hcs10-tool-params';\nimport { BaseServiceBuilder } from 'hedera-agent-kit';\n\nconst SendMessageToConnectionZodSchema = z.object({\n  targetIdentifier: z\n    .string()\n    .describe(\n      \"The request key (e.g., 'req-1:0.0.6155171@0.0.6154875'), account ID (e.g., 0.0.12345) of the target agent, OR the connection number (e.g., '1', '2') from the 'list_connections' tool. Request key is most deterministic.\"\n    ),\n  message: z.string().describe('The text message content to send.'),\n  disableMonitoring: z.boolean().optional().default(false),\n});\n\n/**\n * A tool to send a message to an agent over an established HCS-10 connection.\n */\nexport class SendMessageToConnectionTool extends BaseHCS10TransactionTool<\n  typeof SendMessageToConnectionZodSchema\n> {\n  name = 'send_message_to_connection';\n  description =\n    \"Sends a text message to another agent using an existing active connection. Identify the target agent using their account ID (e.g., 0.0.12345) or the connection number shown in 'list_connections'. Return back the reply from the target agent if possible\";\n  specificInputSchema = SendMessageToConnectionZodSchema;\n  constructor(params: HCS10TransactionToolParams) {\n    super(params);\n    this.requiresMultipleTransactions = true;\n    this.neverScheduleThisTool = true;\n  }\n\n  protected async callBuilderMethod(\n    builder: BaseServiceBuilder,\n    specificArgs: z.infer<typeof SendMessageToConnectionZodSchema>\n  ): Promise<void> {\n    const hcs10Builder = builder as HCS10Builder;\n\n    await hcs10Builder.sendMessageToConnection({\n      targetIdentifier: specificArgs.targetIdentifier,\n      message: specificArgs.message,\n      disableMonitoring: specificArgs.disableMonitoring,\n    });\n  }\n}"],"names":[],"mappings":";;AAMA,MAAM,mCAAmC,EAAE,OAAO;AAAA,EAChD,kBAAkB,EACf,OAAA,EACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,SAAS,EAAE,SAAS,SAAS,mCAAmC;AAAA,EAChE,mBAAmB,EAAE,QAAA,EAAU,SAAA,EAAW,QAAQ,KAAK;AACzD,CAAC;AAKM,MAAM,oCAAoC,yBAE/C;AAAA,EAKA,YAAY,QAAoC;AAC9C,UAAM,MAAM;AALd,SAAA,OAAO;AACP,SAAA,cACE;AACF,SAAA,sBAAsB;AAGpB,SAAK,+BAA+B;AACpC,SAAK,wBAAwB;AAAA,EAC/B;AAAA,EAEA,MAAgB,kBACd,SACA,cACe;AACf,UAAM,eAAe;AAErB,UAAM,aAAa,wBAAwB;AAAA,MACzC,kBAAkB,aAAa;AAAA,MAC/B,SAAS,aAAa;AAAA,MACtB,mBAAmB,aAAa;AAAA,IAAA,CACjC;AAAA,EACH;AACF;"}

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

@@ -1,50 +1,40 @@
 import { z } from "zod";
-import { BaseHCS10QueryTool } from "./standards-agent-kit.es4.js";
-const CheckMessagesZodSchema = z.object({
-  targetIdentifier: z.string().describe(
-    "The account ID (e.g., 0.0.12345) of the target agent OR the connection number (e.g., '1', '2') from the 'list_connections' tool to check messages for."
+import { BaseHCS10TransactionTool } from "./standards-agent-kit.es6.js";
+const InitiateConnectionZodSchema = z.object({
+  targetAccountId: z.string().describe(
+    "The Hedera account ID (e.g., 0.0.12345) of the agent you want to connect with."
   ),
-  fetchLatest: z.boolean().optional().default(false).describe(
-    "Set to true to fetch the latest messages even if they have been seen before, ignoring the last checked timestamp. Defaults to false (fetching only new messages)."
+  disableMonitor: z.boolean().optional().describe(
+    "If true, does not wait for connection confirmation. Returns immediately after sending the request."
   ),
-  lastMessagesCount: z.number().int().positive().optional().describe(
-    "When fetchLatest is true, specifies how many of the most recent messages to retrieve. Defaults to 1."
+  memo: z.string().optional().describe(
+    'Optional memo to include with the connection request (e.g., "Hello from Alice"). If not provided, defaults to "true" or "false" based on monitoring preference.'
   )
 });
-class CheckMessagesTool extends BaseHCS10QueryTool {
+class InitiateConnectionTool extends BaseHCS10TransactionTool {
   constructor(params) {
     super(params);
-    this.name = "check_messages";
-    this.description = `Checks for and retrieves messages from an active connection.
-Identify the target agent using their account ID (e.g., 0.0.12345) or the connection number shown in 'list_connections'.
-By default, it only retrieves messages newer than the last check.
-Use 'fetchLatest: true' to get the most recent messages regardless of when they arrived.
-Use 'lastMessagesCount' to specify how many latest messages to retrieve (default 1 when fetchLatest is true).`;
-    this.specificInputSchema = CheckMessagesZodSchema;
+    this.name = "initiate_connection";
+    this.description = "Actively STARTS a NEW HCS-10 connection TO a specific target agent identified by their account ID. Requires the targetAccountId parameter. Use this ONLY to INITIATE an OUTGOING connection request.";
+    this.specificInputSchema = InitiateConnectionZodSchema;
+    this.neverScheduleThisTool = true;
+    this.requiresMultipleTransactions = true;
   }
-  async executeQuery({
-    targetIdentifier,
-    fetchLatest,
-    lastMessagesCount
-  }) {
-    const hcs10Builder = this.hcs10Builder;
-    await hcs10Builder.checkMessages({
-      targetIdentifier,
-      fetchLatest,
-      lastMessagesCount: lastMessagesCount || 1
-    });
-    const result = await hcs10Builder.execute();
-    if (result.success && "rawResult" in result && result.rawResult) {
-      const raw = result.rawResult;
-      return {
-        success: true,
-        data: raw.formattedOutput || raw.message || "Messages checked"
-      };
+  async callBuilderMethod(builder, specificArgs) {
+    const hcs10Builder = builder;
+    const params = {
+      targetAccountId: specificArgs.targetAccountId
+    };
+    if (specificArgs.disableMonitor !== void 0) {
+      params.disableMonitor = specificArgs.disableMonitor;
     }
-    return result;
+    if (specificArgs.memo !== void 0) {
+      params.memo = specificArgs.memo;
+    }
+    await hcs10Builder.initiateConnection(params);
   }
 }
 export {
-  CheckMessagesTool
+  InitiateConnectionTool
 };
 //# sourceMappingURL=standards-agent-kit.es9.js.map

package/dist/es/standards-agent-kit.es9.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es9.js","sources":["../../src/tools/hcs10/CheckMessagesTool.ts"],"sourcesContent":["import { z } from 'zod';\nimport { BaseHCS10QueryTool } from './base-hcs10-tools';\nimport { HCS10QueryToolParams } from './hcs10-tool-params';\n\n/**\n * A tool to check for new messages on an active HCS-10 connection topic,\n * or optionally fetch the latest messages regardless of timestamp.\n */\nconst CheckMessagesZodSchema = z.object({\n  targetIdentifier: z\n    .string()\n    .describe(\n      \"The account ID (e.g., 0.0.12345) of the target agent OR the connection number (e.g., '1', '2') from the 'list_connections' tool to check messages for.\"\n    ),\n  fetchLatest: z\n    .boolean()\n    .optional()\n    .default(false)\n    .describe(\n      'Set to true to fetch the latest messages even if they have been seen before, ignoring the last checked timestamp. Defaults to false (fetching only new messages).'\n    ),\n  lastMessagesCount: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe(\n      'When fetchLatest is true, specifies how many of the most recent messages to retrieve. Defaults to 1.'\n    ),\n});\n\nexport class CheckMessagesTool extends BaseHCS10QueryTool<\n  typeof CheckMessagesZodSchema\n> {\n  name = 'check_messages';\n  description = `Checks for and retrieves messages from an active connection.\nIdentify the target agent using their account ID (e.g., 0.0.12345) or the connection number shown in 'list_connections'.\nBy default, it only retrieves messages newer than the last check.\nUse 'fetchLatest: true' to get the most recent messages regardless of when they arrived.\nUse 'lastMessagesCount' to specify how many latest messages to retrieve (default 1 when fetchLatest is true).`;\n  specificInputSchema = CheckMessagesZodSchema;\n  constructor(params: HCS10QueryToolParams) {\n    super(params);\n  }\n\n  protected async executeQuery({\n    targetIdentifier,\n    fetchLatest,\n    lastMessagesCount,\n  }: z.infer<typeof CheckMessagesZodSchema>): Promise<unknown> {\n    const hcs10Builder = this.hcs10Builder;\n    await hcs10Builder.checkMessages({\n      targetIdentifier,\n      fetchLatest,\n      lastMessagesCount: lastMessagesCount || 1,\n    });\n\n    const result = await hcs10Builder.execute();\n\n    if (result.success && 'rawResult' in result && result.rawResult) {\n      const raw = result.rawResult as {\n        formattedOutput?: string;\n        message?: string;\n      };\n      return {\n        success: true,\n        data: raw.formattedOutput || raw.message || 'Messages checked',\n      };\n    }\n\n    return result;\n  }\n}"],"names":[],"mappings":";;AAQA,MAAM,yBAAyB,EAAE,OAAO;AAAA,EACtC,kBAAkB,EACf,OAAA,EACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,aAAa,EACV,QAAA,EACA,WACA,QAAQ,KAAK,EACb;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,mBAAmB,EAChB,SACA,MACA,SAAA,EACA,SAAA,EACA;AAAA,IACC;AAAA,EAAA;AAEN,CAAC;AAEM,MAAM,0BAA0B,mBAErC;AAAA,EAQA,YAAY,QAA8B;AACxC,UAAM,MAAM;AARd,SAAA,OAAO;AACP,SAAA,cAAc;AAAA;AAAA;AAAA;AAAA;AAKd,SAAA,sBAAsB;AAAA,EAGtB;AAAA,EAEA,MAAgB,aAAa;AAAA,IAC3B;AAAA,IACA;AAAA,IACA;AAAA,EAAA,GAC2D;AAC3D,UAAM,eAAe,KAAK;AAC1B,UAAM,aAAa,cAAc;AAAA,MAC/B;AAAA,MACA;AAAA,MACA,mBAAmB,qBAAqB;AAAA,IAAA,CACzC;AAED,UAAM,SAAS,MAAM,aAAa,QAAA;AAElC,QAAI,OAAO,WAAW,eAAe,UAAU,OAAO,WAAW;AAC/D,YAAM,MAAM,OAAO;AAInB,aAAO;AAAA,QACL,SAAS;AAAA,QACT,MAAM,IAAI,mBAAmB,IAAI,WAAW;AAAA,MAAA;AAAA,IAEhD;AAEA,WAAO;AAAA,EACT;AACF;"}
+{"version":3,"file":"standards-agent-kit.es9.js","sources":["../../src/tools/hcs10/InitiateConnectionTool.ts"],"sourcesContent":["import { z } from 'zod';\nimport { BaseHCS10TransactionTool } from './base-hcs10-tools';\nimport { HCS10Builder } from '../../builders/hcs10/hcs10-builder';\nimport { HCS10TransactionToolParams } from './hcs10-tool-params';\nimport { BaseServiceBuilder } from 'hedera-agent-kit';\n\nconst InitiateConnectionZodSchema = z.object({\n  targetAccountId: z\n    .string()\n    .describe(\n      'The Hedera account ID (e.g., 0.0.12345) of the agent you want to connect with.'\n    ),\n  disableMonitor: z\n    .boolean()\n    .optional()\n    .describe(\n      'If true, does not wait for connection confirmation. Returns immediately after sending the request.'\n    ),\n  memo: z\n    .string()\n    .optional()\n    .describe(\n      'Optional memo to include with the connection request (e.g., \"Hello from Alice\"). If not provided, defaults to \"true\" or \"false\" based on monitoring preference.'\n    ),\n});\n\n/**\n * A tool to actively START a NEW HCS-10 connection TO a target agent.\n * Requires the target agent's account ID.\n * It retrieves their profile, sends a connection request, and optionally waits for confirmation.\n * Use this tool ONLY to actively INITIATE an OUTGOING connection.\n */\nexport class InitiateConnectionTool extends BaseHCS10TransactionTool<\n  typeof InitiateConnectionZodSchema\n> {\n  name = 'initiate_connection';\n  description =\n    'Actively STARTS a NEW HCS-10 connection TO a specific target agent identified by their account ID. Requires the targetAccountId parameter. Use this ONLY to INITIATE an OUTGOING connection request.';\n  specificInputSchema = InitiateConnectionZodSchema;\n  constructor(params: HCS10TransactionToolParams) {\n    super(params);\n    this.neverScheduleThisTool = true;\n    this.requiresMultipleTransactions = true;\n  }\n\n  protected async callBuilderMethod(\n    builder: BaseServiceBuilder,\n    specificArgs: z.infer<typeof InitiateConnectionZodSchema>\n  ): Promise<void> {\n    const hcs10Builder = builder as HCS10Builder;\n    const params: {\n      targetAccountId: string;\n      disableMonitor?: boolean;\n      memo?: string;\n    } = {\n      targetAccountId: specificArgs.targetAccountId,\n    };\n    if (specificArgs.disableMonitor !== undefined) {\n      params.disableMonitor = specificArgs.disableMonitor;\n    }\n    if (specificArgs.memo !== undefined) {\n      params.memo = specificArgs.memo;\n    }\n    await hcs10Builder.initiateConnection(params);\n  }\n}"],"names":[],"mappings":";;AAMA,MAAM,8BAA8B,EAAE,OAAO;AAAA,EAC3C,iBAAiB,EACd,OAAA,EACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,gBAAgB,EACb,UACA,WACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,MAAM,EACH,SACA,WACA;AAAA,IACC;AAAA,EAAA;AAEN,CAAC;AAQM,MAAM,+BAA+B,yBAE1C;AAAA,EAKA,YAAY,QAAoC;AAC9C,UAAM,MAAM;AALd,SAAA,OAAO;AACP,SAAA,cACE;AACF,SAAA,sBAAsB;AAGpB,SAAK,wBAAwB;AAC7B,SAAK,+BAA+B;AAAA,EACtC;AAAA,EAEA,MAAgB,kBACd,SACA,cACe;AACf,UAAM,eAAe;AACrB,UAAM,SAIF;AAAA,MACF,iBAAiB,aAAa;AAAA,IAAA;AAEhC,QAAI,aAAa,mBAAmB,QAAW;AAC7C,aAAO,iBAAiB,aAAa;AAAA,IACvC;AACA,QAAI,aAAa,SAAS,QAAW;AACnC,aAAO,OAAO,aAAa;AAAA,IAC7B;AACA,UAAM,aAAa,mBAAmB,MAAM;AAAA,EAC9C;AACF;"}

package/dist/es/tools/hcs10/FindRegistrationsTool.d.ts

@@ -7,26 +7,26 @@ import { HCS10QueryToolParams } from './hcs10-tool-params';
  */
 declare const FindRegistrationsZodSchema: z.ZodObject<{
     accountId: z.ZodOptional<z.ZodString>;
-    tags: z.ZodOptional<z.ZodArray<z.ZodNativeEnum<typeof AIAgentCapability>, "many">>;
+    tags: z.ZodEffects<z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodNativeEnum<typeof AIAgentCapability>, "many">, z.ZodArray<z.ZodString, "many">, z.ZodString]>>, AIAgentCapability[] | undefined, string | string[] | AIAgentCapability[] | undefined>;
 }, "strip", z.ZodTypeAny, {
     accountId?: string | undefined;
     tags?: AIAgentCapability[] | undefined;
 }, {
     accountId?: string | undefined;
-    tags?: AIAgentCapability[] | undefined;
+    tags?: string | string[] | AIAgentCapability[] | undefined;
 }>;
 export declare class FindRegistrationsTool extends BaseHCS10QueryTool<typeof FindRegistrationsZodSchema> {
     name: string;
     description: string;
     specificInputSchema: z.ZodObject<{
         accountId: z.ZodOptional<z.ZodString>;
-        tags: z.ZodOptional<z.ZodArray<z.ZodNativeEnum<typeof AIAgentCapability>, "many">>;
+        tags: z.ZodEffects<z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodNativeEnum<typeof AIAgentCapability>, "many">, z.ZodArray<z.ZodString, "many">, z.ZodString]>>, AIAgentCapability[] | undefined, string | string[] | AIAgentCapability[] | undefined>;
     }, "strip", z.ZodTypeAny, {
         accountId?: string | undefined;
         tags?: AIAgentCapability[] | undefined;
     }, {
         accountId?: string | undefined;
-        tags?: AIAgentCapability[] | undefined;
+        tags?: string | string[] | AIAgentCapability[] | undefined;
     }>;
     constructor(params: HCS10QueryToolParams);
     protected executeQuery({ accountId, tags, }: z.infer<typeof FindRegistrationsZodSchema>): Promise<unknown>;