@hashgraphonline/conversational-agent 0.2.216 → 0.2.217

package/dist/esm/index40.js

@@ -1,82 +1,69 @@
-import { BasePlugin, BaseHederaQueryTool } from "hedera-agent-kit";
-import { z } from "zod";
-const PageSnapshotSchema = z.object({
-  url: z.string().url(),
-  maxCharacters: z.number().int().min(256, "Minimum length is 256 characters").max(8e3, "Maximum length is 8000 characters").optional().default(3e3)
-});
-class WebPageSnapshotTool extends BaseHederaQueryTool {
-  constructor(params) {
-    const { fetchImpl, ...rest } = params;
-    super(rest);
-    this.name = "web_page_snapshot";
-    this.description = "Fetches the visible text content of a web page for analysis.";
-    this.namespace = "browser";
-    this.specificInputSchema = PageSnapshotSchema;
-    this.fetchImpl = fetchImpl ?? fetch;
+import { AccountId, Client, PrivateKey, TransactionReceipt, PublicKey } from "@hashgraph/sdk";
+import { AbstractSigner } from "hedera-agent-kit";
+import { HederaMirrorNode, Logger } from "@hashgraphonline/standards-sdk";
+class BrowserSigner extends AbstractSigner {
+  getAccountId() {
+    return this.account;
   }
-  async executeQuery(input) {
-    const maxChars = input.maxCharacters ?? 3e3;
-    try {
-      const response = await this.fetchImpl(input.url, {
-        redirect: "follow"
-      });
-      if (!response.ok) {
-        return `Failed to load ${input.url}: HTTP ${response.status}`;
-      }
-      const html = await response.text();
-      const text = this.normalizeHtml(html);
-      if (!text) {
-        return "The fetched page did not contain readable text.";
-      }
-      return text.length > maxChars ? `${text.slice(0, maxChars)}…` : text;
-    } catch (error) {
-      this.logger.error("WebPageSnapshotTool failed", error);
-      return `Failed to fetch content for ${input.url}: ${error instanceof Error ? error.message : String(error)}`;
-    }
+  getNetwork() {
+    return this.network;
   }
-  normalizeHtml(html) {
-    const withoutScripts = html.replace(/<script[\s\S]*?<\/script>/gi, " ").replace(/<style[\s\S]*?<\/style>/gi, " ").replace(/<!--([\s\S]*?)-->/g, " ");
-    const stripped = withoutScripts.replace(/<[^>]+>/g, " ");
-    const decoded = stripped.replace(/&nbsp;/gi, " ").replace(/&amp;/gi, "&").replace(/&lt;/gi, "<").replace(/&gt;/gi, ">").replace(/&quot;/gi, '"').replace(/&#39;/gi, "'");
-    return decoded.replace(/\s+/g, " ").trim();
+  constructor(accountId, network, executor) {
+    super();
+    this.account = AccountId.fromString(accountId);
+    this.network = network;
+    this.client = network === "mainnet" ? Client.forMainnet() : Client.forTestnet();
+    this.exec = executor ?? null;
+    this.ephemeralKey = PrivateKey.generateED25519();
   }
-}
-class WebBrowserPlugin extends BasePlugin {
-  constructor() {
-    super(...arguments);
-    this.id = "web-browser";
-    this.name = "Web Browser Plugin";
-    this.description = "Provides tools for fetching live web page content to enrich assistant understanding.";
-    this.version = "0.1.0";
-    this.author = "Hashgraph Online";
-    this.namespace = "browser";
-    this.tools = [];
+  /**
+   * Returns an auto-generated ED25519 key for client wiring only.
+   * Do not use for signing; wallet performs signing in renderer.
+   */
+  getOperatorPrivateKey() {
+    return this.ephemeralKey;
   }
-  async initialize(context) {
-    await super.initialize(context);
-    const hederaKit = context.config.hederaKit;
-    if (!hederaKit) {
-      this.context.logger.warn(
-        "WebBrowserPlugin skipped because HederaAgentKit was not present in plugin context."
-      );
-      this.tools = [];
-      return;
-    }
-    const tool = new WebPageSnapshotTool({
-      hederaKit,
-      logger: this.context.logger
-    });
-    this.tools = [tool];
-    this.context.logger.info("Web Browser Plugin initialized with snapshot tool");
+  getClient() {
+    return this.client;
   }
-  getTools() {
-    return this.tools;
+  async signAndExecuteTransaction(tx) {
+    if (!this.exec) {
+      throw new Error("BrowserSigner executor not available");
+    }
+    if (!tx.isFrozen()) {
+      await tx.freezeWith(this.client);
+    }
+    const base64 = Buffer.from(tx.toBytes()).toString("base64");
+    const { transactionId } = await this.exec(base64, this.network);
+    const mirror = new HederaMirrorNode(this.network);
+    const deadline = Date.now() + 6e4;
+    while (Date.now() < deadline) {
+      try {
+        const details = await mirror.getTransaction(transactionId);
+        if (details && details.result) {
+          return TransactionReceipt.fromBytes(
+            Buffer.from(details.result, "base64")
+          );
+        }
+      } catch {
+      }
+      await new Promise((r) => setTimeout(r, 1200));
+    }
+    return TransactionReceipt.fromBytes(Buffer.from(""));
   }
-  async cleanup() {
-    this.tools = [];
+  async getPublicKey() {
+    const network = this.network === "mainnet" ? "mainnet" : "testnet";
+    const mirror = new HederaMirrorNode(
+      network,
+      new Logger({ module: "BrowserSigner" })
+    );
+    const anyKey = await mirror.getPublicKey(this.account.toString());
+    const keyStr = typeof anyKey?.toString === "function" ? anyKey.toString() : String(anyKey);
+    return PublicKey.fromString(keyStr);
   }
 }
 export {
-  WebBrowserPlugin
+  BrowserSigner,
+  BrowserSigner as default
 };
 //# sourceMappingURL=index40.js.map

package/dist/esm/index40.js.map

@@ -1 +1 @@
-{"version":3,"file":"index40.js","sources":["../../src/plugins/web-browser/WebBrowserPlugin.ts"],"sourcesContent":["import {\n  BasePlugin,\n  type GenericPluginContext,\n  BaseHederaQueryTool,\n  type HederaAgentKit,\n  type HederaTool,\n} from 'hedera-agent-kit';\nimport { z } from 'zod';\n\nconst PageSnapshotSchema = z.object({\n  url: z.string().url(),\n  maxCharacters: z\n    .number()\n    .int()\n    .min(256, 'Minimum length is 256 characters')\n    .max(8000, 'Maximum length is 8000 characters')\n    .optional()\n    .default(3000),\n});\n\nclass WebPageSnapshotTool extends BaseHederaQueryTool<typeof PageSnapshotSchema> {\n  name = 'web_page_snapshot';\n  description = 'Fetches the visible text content of a web page for analysis.';\n  namespace = 'browser';\n  specificInputSchema = PageSnapshotSchema;\n\n  constructor(params: {\n    hederaKit: HederaAgentKit;\n    logger?: GenericPluginContext['logger'];\n    fetchImpl?: typeof fetch;\n  }) {\n    const { fetchImpl, ...rest } = params;\n    super(rest);\n    this.fetchImpl = fetchImpl ?? fetch;\n  }\n\n  private readonly fetchImpl: typeof fetch;\n\n  protected async executeQuery(\n    input: z.infer<typeof PageSnapshotSchema>\n  ): Promise<string> {\n    const maxChars = input.maxCharacters ?? 3000;\n\n    try {\n      const response = await this.fetchImpl(input.url, {\n        redirect: 'follow',\n      });\n\n      if (!response.ok) {\n        return `Failed to load ${input.url}: HTTP ${response.status}`;\n      }\n\n      const html = await response.text();\n      const text = this.normalizeHtml(html);\n\n      if (!text) {\n        return 'The fetched page did not contain readable text.';\n      }\n\n      return text.length > maxChars ? `${text.slice(0, maxChars)}…` : text;\n    } catch (error) {\n      this.logger.error('WebPageSnapshotTool failed', error);\n      return `Failed to fetch content for ${input.url}: ${\n        error instanceof Error ? error.message : String(error)\n      }`;\n    }\n  }\n\n  private normalizeHtml(html: string): string {\n    const withoutScripts = html\n      .replace(/<script[\\s\\S]*?<\\/script>/gi, ' ')\n      .replace(/<style[\\s\\S]*?<\\/style>/gi, ' ')\n      .replace(/<!--([\\s\\S]*?)-->/g, ' ');\n\n    const stripped = withoutScripts.replace(/<[^>]+>/g, ' ');\n    const decoded = stripped\n      .replace(/&nbsp;/gi, ' ')\n      .replace(/&amp;/gi, '&')\n      .replace(/&lt;/gi, '<')\n      .replace(/&gt;/gi, '>')\n      .replace(/&quot;/gi, '\"')\n      .replace(/&#39;/gi, \"'\");\n\n    return decoded.replace(/\\s+/g, ' ').trim();\n  }\n}\n\nexport class WebBrowserPlugin extends BasePlugin<GenericPluginContext> {\n  id = 'web-browser';\n  name = 'Web Browser Plugin';\n  description =\n    'Provides tools for fetching live web page content to enrich assistant understanding.';\n  version = '0.1.0';\n  author = 'Hashgraph Online';\n  namespace = 'browser';\n\n  private tools: HederaTool[] = [];\n\n  override async initialize(context: GenericPluginContext): Promise<void> {\n    await super.initialize(context);\n\n    const hederaKit = context.config.hederaKit as HederaAgentKit | undefined;\n\n    if (!hederaKit) {\n      this.context.logger.warn(\n        'WebBrowserPlugin skipped because HederaAgentKit was not present in plugin context.'\n      );\n      this.tools = [];\n      return;\n    }\n\n    const tool = new WebPageSnapshotTool({\n      hederaKit,\n      logger: this.context.logger,\n    });\n\n    this.tools = [tool];\n    this.context.logger.info('Web Browser Plugin initialized with snapshot tool');\n  }\n\n  override getTools(): HederaTool[] {\n    return this.tools;\n  }\n\n  override async cleanup(): Promise<void> {\n    this.tools = [];\n  }\n}\n"],"names":[],"mappings":";;AASA,MAAM,qBAAqB,EAAE,OAAO;AAAA,EAClC,KAAK,EAAE,OAAA,EAAS,IAAA;AAAA,EAChB,eAAe,EACZ,OAAA,EACA,IAAA,EACA,IAAI,KAAK,kCAAkC,EAC3C,IAAI,KAAM,mCAAmC,EAC7C,SAAA,EACA,QAAQ,GAAI;AACjB,CAAC;AAED,MAAM,4BAA4B,oBAA+C;AAAA,EAM/E,YAAY,QAIT;AACD,UAAM,EAAE,WAAW,GAAG,KAAA,IAAS;AAC/B,UAAM,IAAI;AAXZ,SAAA,OAAO;AACP,SAAA,cAAc;AACd,SAAA,YAAY;AACZ,SAAA,sBAAsB;AASpB,SAAK,YAAY,aAAa;AAAA,EAChC;AAAA,EAIA,MAAgB,aACd,OACiB;AACjB,UAAM,WAAW,MAAM,iBAAiB;AAExC,QAAI;AACF,YAAM,WAAW,MAAM,KAAK,UAAU,MAAM,KAAK;AAAA,QAC/C,UAAU;AAAA,MAAA,CACX;AAED,UAAI,CAAC,SAAS,IAAI;AAChB,eAAO,kBAAkB,MAAM,GAAG,UAAU,SAAS,MAAM;AAAA,MAC7D;AAEA,YAAM,OAAO,MAAM,SAAS,KAAA;AAC5B,YAAM,OAAO,KAAK,cAAc,IAAI;AAEpC,UAAI,CAAC,MAAM;AACT,eAAO;AAAA,MACT;AAEA,aAAO,KAAK,SAAS,WAAW,GAAG,KAAK,MAAM,GAAG,QAAQ,CAAC,MAAM;AAAA,IAClE,SAAS,OAAO;AACd,WAAK,OAAO,MAAM,8BAA8B,KAAK;AACrD,aAAO,+BAA+B,MAAM,GAAG,KAC7C,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CACvD;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,cAAc,MAAsB;AAC1C,UAAM,iBAAiB,KACpB,QAAQ,+BAA+B,GAAG,EAC1C,QAAQ,6BAA6B,GAAG,EACxC,QAAQ,sBAAsB,GAAG;AAEpC,UAAM,WAAW,eAAe,QAAQ,YAAY,GAAG;AACvD,UAAM,UAAU,SACb,QAAQ,YAAY,GAAG,EACvB,QAAQ,WAAW,GAAG,EACtB,QAAQ,UAAU,GAAG,EACrB,QAAQ,UAAU,GAAG,EACrB,QAAQ,YAAY,GAAG,EACvB,QAAQ,WAAW,GAAG;AAEzB,WAAO,QAAQ,QAAQ,QAAQ,GAAG,EAAE,KAAA;AAAA,EACtC;AACF;AAEO,MAAM,yBAAyB,WAAiC;AAAA,EAAhE,cAAA;AAAA,UAAA,GAAA,SAAA;AACL,SAAA,KAAK;AACL,SAAA,OAAO;AACP,SAAA,cACE;AACF,SAAA,UAAU;AACV,SAAA,SAAS;AACT,SAAA,YAAY;AAEZ,SAAQ,QAAsB,CAAA;AAAA,EAAC;AAAA,EAE/B,MAAe,WAAW,SAA8C;AACtE,UAAM,MAAM,WAAW,OAAO;AAE9B,UAAM,YAAY,QAAQ,OAAO;AAEjC,QAAI,CAAC,WAAW;AACd,WAAK,QAAQ,OAAO;AAAA,QAClB;AAAA,MAAA;AAEF,WAAK,QAAQ,CAAA;AACb;AAAA,IACF;AAEA,UAAM,OAAO,IAAI,oBAAoB;AAAA,MACnC;AAAA,MACA,QAAQ,KAAK,QAAQ;AAAA,IAAA,CACtB;AAED,SAAK,QAAQ,CAAC,IAAI;AAClB,SAAK,QAAQ,OAAO,KAAK,mDAAmD;AAAA,EAC9E;AAAA,EAES,WAAyB;AAChC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAe,UAAyB;AACtC,SAAK,QAAQ,CAAA;AAAA,EACf;AACF;"}
+{"version":3,"file":"index40.js","sources":["../../src/signers/browser-signer.ts"],"sourcesContent":["import {\n  AccountId,\n  Client,\n  PrivateKey,\n  PublicKey,\n  Transaction,\n  TransactionReceipt,\n} from '@hashgraph/sdk';\nimport { AbstractSigner } from 'hedera-agent-kit';\nimport {\n  HederaMirrorNode,\n  Logger,\n  type NetworkType,\n} from '@hashgraphonline/standards-sdk';\n\n/**\n * BrowserSigner (bytes-only)\n *\n * Minimal signer compatible with HederaAgentKit in bytes/Provide Bytes mode.\n * - Does NOT hold a private key\n * - Cannot execute transactions; only provides identity and network context\n * - getOperatorPrivateKey() throws to signal absence of a local key\n */\nexport class BrowserSigner extends AbstractSigner {\n  private readonly account: AccountId;\n  private readonly network: 'mainnet' | 'testnet';\n  private readonly client: Client;\n  private readonly exec: ((\n    base64: string,\n    network: 'mainnet' | 'testnet'\n  ) => Promise<{ transactionId: string }>) | null;\n  private readonly ephemeralKey: PrivateKey;\n\n  getAccountId(): AccountId {\n    return this.account;\n  }\n\n  getNetwork(): 'mainnet' | 'testnet' {\n    return this.network;\n  }\n\n  constructor(\n    accountId: string,\n    network: 'mainnet' | 'testnet',\n    executor?: (\n      base64: string,\n      network: 'mainnet' | 'testnet'\n    ) => Promise<{ transactionId: string }>\n  ) {\n    super();\n    this.account = AccountId.fromString(accountId);\n    this.network = network;\n    this.client =\n      network === 'mainnet' ? Client.forMainnet() : Client.forTestnet();\n    this.exec = executor ?? null;\n    this.ephemeralKey = PrivateKey.generateED25519();\n  }\n\n  /**\n   * Returns an auto-generated ED25519 key for client wiring only.\n   * Do not use for signing; wallet performs signing in renderer.\n   */\n  getOperatorPrivateKey(): PrivateKey {\n    return this.ephemeralKey;\n  }\n\n  getClient(): Client {\n    return this.client;\n  }\n\n  async signAndExecuteTransaction(\n    tx: Transaction\n  ): Promise<TransactionReceipt> {\n    if (!this.exec) {\n      throw new Error('BrowserSigner executor not available');\n    }\n    if (!tx.isFrozen()) {\n      await tx.freezeWith(this.client);\n    }\n    const base64 = Buffer.from(tx.toBytes()).toString('base64');\n    const { transactionId } = await this.exec(base64, this.network);\n    const mirror = new HederaMirrorNode(this.network);\n    const deadline = Date.now() + 60000;\n    while (Date.now() < deadline) {\n      try {\n        const details = await mirror.getTransaction(transactionId);\n        if (details && details.result) {\n          return TransactionReceipt.fromBytes(\n            Buffer.from(details.result, 'base64')\n          );\n        }\n      } catch {}\n      await new Promise((r) => setTimeout(r, 1200));\n    }\n    return TransactionReceipt.fromBytes(Buffer.from(''));\n  }\n\n  override async getPublicKey(): Promise<PublicKey> {\n    const network: NetworkType =\n      this.network === 'mainnet' ? 'mainnet' : 'testnet';\n    const mirror = new HederaMirrorNode(\n      network,\n      new Logger({ module: 'BrowserSigner' })\n    );\n    const anyKey: any = await mirror.getPublicKey(this.account.toString());\n    const keyStr = typeof anyKey?.toString === 'function' ? anyKey.toString() : String(anyKey);\n    return PublicKey.fromString(keyStr);\n  }\n}\n\nexport default BrowserSigner;\n"],"names":[],"mappings":";;;AAuBO,MAAM,sBAAsB,eAAe;AAAA,EAUhD,eAA0B;AACxB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,aAAoC;AAClC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,YACE,WACA,SACA,UAIA;AACA,UAAA;AACA,SAAK,UAAU,UAAU,WAAW,SAAS;AAC7C,SAAK,UAAU;AACf,SAAK,SACH,YAAY,YAAY,OAAO,WAAA,IAAe,OAAO,WAAA;AACvD,SAAK,OAAO,YAAY;AACxB,SAAK,eAAe,WAAW,gBAAA;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,wBAAoC;AAClC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,YAAoB;AAClB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,0BACJ,IAC6B;AAC7B,QAAI,CAAC,KAAK,MAAM;AACd,YAAM,IAAI,MAAM,sCAAsC;AAAA,IACxD;AACA,QAAI,CAAC,GAAG,YAAY;AAClB,YAAM,GAAG,WAAW,KAAK,MAAM;AAAA,IACjC;AACA,UAAM,SAAS,OAAO,KAAK,GAAG,SAAS,EAAE,SAAS,QAAQ;AAC1D,UAAM,EAAE,kBAAkB,MAAM,KAAK,KAAK,QAAQ,KAAK,OAAO;AAC9D,UAAM,SAAS,IAAI,iBAAiB,KAAK,OAAO;AAChD,UAAM,WAAW,KAAK,IAAA,IAAQ;AAC9B,WAAO,KAAK,IAAA,IAAQ,UAAU;AAC5B,UAAI;AACF,cAAM,UAAU,MAAM,OAAO,eAAe,aAAa;AACzD,YAAI,WAAW,QAAQ,QAAQ;AAC7B,iBAAO,mBAAmB;AAAA,YACxB,OAAO,KAAK,QAAQ,QAAQ,QAAQ;AAAA,UAAA;AAAA,QAExC;AAAA,MACF,QAAQ;AAAA,MAAC;AACT,YAAM,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC;AAAA,IAC9C;AACA,WAAO,mBAAmB,UAAU,OAAO,KAAK,EAAE,CAAC;AAAA,EACrD;AAAA,EAEA,MAAe,eAAmC;AAChD,UAAM,UACJ,KAAK,YAAY,YAAY,YAAY;AAC3C,UAAM,SAAS,IAAI;AAAA,MACjB;AAAA,MACA,IAAI,OAAO,EAAE,QAAQ,iBAAiB;AAAA,IAAA;AAExC,UAAM,SAAc,MAAM,OAAO,aAAa,KAAK,QAAQ,UAAU;AACrE,UAAM,SAAS,OAAO,QAAQ,aAAa,aAAa,OAAO,SAAA,IAAa,OAAO,MAAM;AACzF,WAAO,UAAU,WAAW,MAAM;AAAA,EACpC;AACF;"}

package/dist/esm/index41.js

@@ -1,24 +1,82 @@
-const getSystemMessage = (accountId) => `You are a helpful assistant managing Hashgraph Online HCS-10 connections, messages, HCS-2 registries, content inscription, and Hedera Hashgraph operations.
-
-You have access to tools for:
-- HCS-10: registering agents, finding registered agents, initiating connections, listing active connections, sending messages over connections, and checking for new messages
-- HCS-2: creating registries, registering entries, updating entries, deleting entries, migrating registries, and querying registry contents
-- Inscription: inscribing content from URLs, files, or buffers, creating Hashinal NFTs, and retrieving inscriptions
-- Hedera Token Service (HTS): creating tokens, transferring tokens, airdropping tokens, and managing token operations
-
-
-*** IMPORTANT CONTEXT ***
-You are currently operating as agent: ${accountId || "unknown"} on the Hedera Hashgraph
-When users ask about "my profile", "my account", "my connections", etc., use this account ID: ${accountId || "unknown"}
-
-*** CRITICAL ENTITY HANDLING RULES ***
-- When users refer to entities (tokens, topics, accounts) with pronouns like "it", "that", "the token/topic", etc., ALWAYS use the most recently created entity of that type
-- Entity IDs look like "0.0.XXXXXX" and are stored in memory after creation
-- NEVER use example or placeholder IDs like "0.0.123456" - always use actual created entity IDs
-- Account ID ${accountId} is NOT a token - tokens and accounts are different entities
-
- Remember the connection numbers when listing connections, as users might refer to them.`;
+import { BasePlugin, BaseHederaQueryTool } from "hedera-agent-kit";
+import { z } from "zod";
+const PageSnapshotSchema = z.object({
+  url: z.string().url(),
+  maxCharacters: z.number().int().min(256, "Minimum length is 256 characters").max(8e3, "Maximum length is 8000 characters").optional().default(3e3)
+});
+class WebPageSnapshotTool extends BaseHederaQueryTool {
+  constructor(params) {
+    const { fetchImpl, ...rest } = params;
+    super(rest);
+    this.name = "web_page_snapshot";
+    this.description = "Fetches the visible text content of a web page for analysis.";
+    this.namespace = "browser";
+    this.specificInputSchema = PageSnapshotSchema;
+    this.fetchImpl = fetchImpl ?? fetch;
+  }
+  async executeQuery(input) {
+    const maxChars = input.maxCharacters ?? 3e3;
+    try {
+      const response = await this.fetchImpl(input.url, {
+        redirect: "follow"
+      });
+      if (!response.ok) {
+        return `Failed to load ${input.url}: HTTP ${response.status}`;
+      }
+      const html = await response.text();
+      const text = this.normalizeHtml(html);
+      if (!text) {
+        return "The fetched page did not contain readable text.";
+      }
+      return text.length > maxChars ? `${text.slice(0, maxChars)}…` : text;
+    } catch (error) {
+      this.logger.error("WebPageSnapshotTool failed", error);
+      return `Failed to fetch content for ${input.url}: ${error instanceof Error ? error.message : String(error)}`;
+    }
+  }
+  normalizeHtml(html) {
+    const withoutScripts = html.replace(/<script[\s\S]*?<\/script>/gi, " ").replace(/<style[\s\S]*?<\/style>/gi, " ").replace(/<!--([\s\S]*?)-->/g, " ");
+    const stripped = withoutScripts.replace(/<[^>]+>/g, " ");
+    const decoded = stripped.replace(/&nbsp;/gi, " ").replace(/&amp;/gi, "&").replace(/&lt;/gi, "<").replace(/&gt;/gi, ">").replace(/&quot;/gi, '"').replace(/&#39;/gi, "'");
+    return decoded.replace(/\s+/g, " ").trim();
+  }
+}
+class WebBrowserPlugin extends BasePlugin {
+  constructor() {
+    super(...arguments);
+    this.id = "web-browser";
+    this.name = "Web Browser Plugin";
+    this.description = "Provides tools for fetching live web page content to enrich assistant understanding.";
+    this.version = "0.1.0";
+    this.author = "Hashgraph Online";
+    this.namespace = "browser";
+    this.tools = [];
+  }
+  async initialize(context) {
+    await super.initialize(context);
+    const hederaKit = context.config.hederaKit;
+    if (!hederaKit) {
+      this.context.logger.warn(
+        "WebBrowserPlugin skipped because HederaAgentKit was not present in plugin context."
+      );
+      this.tools = [];
+      return;
+    }
+    const tool = new WebPageSnapshotTool({
+      hederaKit,
+      logger: this.context.logger
+    });
+    this.tools = [tool];
+    this.context.logger.info("Web Browser Plugin initialized with snapshot tool");
+  }
+  getTools() {
+    return this.tools;
+  }
+  async cleanup() {
+    this.tools = [];
+  }
+}
 export {
-  getSystemMessage
+  WebBrowserPlugin
 };
 //# sourceMappingURL=index41.js.map

package/dist/esm/index41.js.map

@@ -1 +1 @@
-{"version":3,"file":"index41.js","sources":["../../src/config/system-message.ts"],"sourcesContent":["export const getSystemMessage = (\n  accountId?: string\n): string => `You are a helpful assistant managing Hashgraph Online HCS-10 connections, messages, HCS-2 registries, content inscription, and Hedera Hashgraph operations.\n\nYou have access to tools for:\n- HCS-10: registering agents, finding registered agents, initiating connections, listing active connections, sending messages over connections, and checking for new messages\n- HCS-2: creating registries, registering entries, updating entries, deleting entries, migrating registries, and querying registry contents\n- Inscription: inscribing content from URLs, files, or buffers, creating Hashinal NFTs, and retrieving inscriptions\n- Hedera Token Service (HTS): creating tokens, transferring tokens, airdropping tokens, and managing token operations\n\n\n*** IMPORTANT CONTEXT ***\nYou are currently operating as agent: ${accountId || 'unknown'} on the Hedera Hashgraph\nWhen users ask about \"my profile\", \"my account\", \"my connections\", etc., use this account ID: ${accountId || 'unknown'}\n\n*** CRITICAL ENTITY HANDLING RULES ***\n- When users refer to entities (tokens, topics, accounts) with pronouns like \"it\", \"that\", \"the token/topic\", etc., ALWAYS use the most recently created entity of that type\n- Entity IDs look like \"0.0.XXXXXX\" and are stored in memory after creation\n- NEVER use example or placeholder IDs like \"0.0.123456\" - always use actual created entity IDs\n- Account ID ${accountId} is NOT a token - tokens and accounts are different entities\n\n Remember the connection numbers when listing connections, as users might refer to them.`;\n"],"names":[],"mappings":"AAAO,MAAM,mBAAmB,CAC9B,cACW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wCAU2B,aAAa,SAAS;AAAA,gGACkC,aAAa,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,eAMvG,SAAS;AAAA;AAAA;"}
+{"version":3,"file":"index41.js","sources":["../../src/plugins/web-browser/WebBrowserPlugin.ts"],"sourcesContent":["import {\n  BasePlugin,\n  type GenericPluginContext,\n  BaseHederaQueryTool,\n  type HederaAgentKit,\n  type HederaTool,\n} from 'hedera-agent-kit';\nimport { z } from 'zod';\n\nconst PageSnapshotSchema = z.object({\n  url: z.string().url(),\n  maxCharacters: z\n    .number()\n    .int()\n    .min(256, 'Minimum length is 256 characters')\n    .max(8000, 'Maximum length is 8000 characters')\n    .optional()\n    .default(3000),\n});\n\nclass WebPageSnapshotTool extends BaseHederaQueryTool<typeof PageSnapshotSchema> {\n  name = 'web_page_snapshot';\n  description = 'Fetches the visible text content of a web page for analysis.';\n  namespace = 'browser';\n  specificInputSchema = PageSnapshotSchema;\n\n  constructor(params: {\n    hederaKit: HederaAgentKit;\n    logger?: GenericPluginContext['logger'];\n    fetchImpl?: typeof fetch;\n  }) {\n    const { fetchImpl, ...rest } = params;\n    super(rest);\n    this.fetchImpl = fetchImpl ?? fetch;\n  }\n\n  private readonly fetchImpl: typeof fetch;\n\n  protected async executeQuery(\n    input: z.infer<typeof PageSnapshotSchema>\n  ): Promise<string> {\n    const maxChars = input.maxCharacters ?? 3000;\n\n    try {\n      const response = await this.fetchImpl(input.url, {\n        redirect: 'follow',\n      });\n\n      if (!response.ok) {\n        return `Failed to load ${input.url}: HTTP ${response.status}`;\n      }\n\n      const html = await response.text();\n      const text = this.normalizeHtml(html);\n\n      if (!text) {\n        return 'The fetched page did not contain readable text.';\n      }\n\n      return text.length > maxChars ? `${text.slice(0, maxChars)}…` : text;\n    } catch (error) {\n      this.logger.error('WebPageSnapshotTool failed', error);\n      return `Failed to fetch content for ${input.url}: ${\n        error instanceof Error ? error.message : String(error)\n      }`;\n    }\n  }\n\n  private normalizeHtml(html: string): string {\n    const withoutScripts = html\n      .replace(/<script[\\s\\S]*?<\\/script>/gi, ' ')\n      .replace(/<style[\\s\\S]*?<\\/style>/gi, ' ')\n      .replace(/<!--([\\s\\S]*?)-->/g, ' ');\n\n    const stripped = withoutScripts.replace(/<[^>]+>/g, ' ');\n    const decoded = stripped\n      .replace(/&nbsp;/gi, ' ')\n      .replace(/&amp;/gi, '&')\n      .replace(/&lt;/gi, '<')\n      .replace(/&gt;/gi, '>')\n      .replace(/&quot;/gi, '\"')\n      .replace(/&#39;/gi, \"'\");\n\n    return decoded.replace(/\\s+/g, ' ').trim();\n  }\n}\n\nexport class WebBrowserPlugin extends BasePlugin<GenericPluginContext> {\n  id = 'web-browser';\n  name = 'Web Browser Plugin';\n  description =\n    'Provides tools for fetching live web page content to enrich assistant understanding.';\n  version = '0.1.0';\n  author = 'Hashgraph Online';\n  namespace = 'browser';\n\n  private tools: HederaTool[] = [];\n\n  override async initialize(context: GenericPluginContext): Promise<void> {\n    await super.initialize(context);\n\n    const hederaKit = context.config.hederaKit as HederaAgentKit | undefined;\n\n    if (!hederaKit) {\n      this.context.logger.warn(\n        'WebBrowserPlugin skipped because HederaAgentKit was not present in plugin context.'\n      );\n      this.tools = [];\n      return;\n    }\n\n    const tool = new WebPageSnapshotTool({\n      hederaKit,\n      logger: this.context.logger,\n    });\n\n    this.tools = [tool];\n    this.context.logger.info('Web Browser Plugin initialized with snapshot tool');\n  }\n\n  override getTools(): HederaTool[] {\n    return this.tools;\n  }\n\n  override async cleanup(): Promise<void> {\n    this.tools = [];\n  }\n}\n"],"names":[],"mappings":";;AASA,MAAM,qBAAqB,EAAE,OAAO;AAAA,EAClC,KAAK,EAAE,OAAA,EAAS,IAAA;AAAA,EAChB,eAAe,EACZ,OAAA,EACA,IAAA,EACA,IAAI,KAAK,kCAAkC,EAC3C,IAAI,KAAM,mCAAmC,EAC7C,SAAA,EACA,QAAQ,GAAI;AACjB,CAAC;AAED,MAAM,4BAA4B,oBAA+C;AAAA,EAM/E,YAAY,QAIT;AACD,UAAM,EAAE,WAAW,GAAG,KAAA,IAAS;AAC/B,UAAM,IAAI;AAXZ,SAAA,OAAO;AACP,SAAA,cAAc;AACd,SAAA,YAAY;AACZ,SAAA,sBAAsB;AASpB,SAAK,YAAY,aAAa;AAAA,EAChC;AAAA,EAIA,MAAgB,aACd,OACiB;AACjB,UAAM,WAAW,MAAM,iBAAiB;AAExC,QAAI;AACF,YAAM,WAAW,MAAM,KAAK,UAAU,MAAM,KAAK;AAAA,QAC/C,UAAU;AAAA,MAAA,CACX;AAED,UAAI,CAAC,SAAS,IAAI;AAChB,eAAO,kBAAkB,MAAM,GAAG,UAAU,SAAS,MAAM;AAAA,MAC7D;AAEA,YAAM,OAAO,MAAM,SAAS,KAAA;AAC5B,YAAM,OAAO,KAAK,cAAc,IAAI;AAEpC,UAAI,CAAC,MAAM;AACT,eAAO;AAAA,MACT;AAEA,aAAO,KAAK,SAAS,WAAW,GAAG,KAAK,MAAM,GAAG,QAAQ,CAAC,MAAM;AAAA,IAClE,SAAS,OAAO;AACd,WAAK,OAAO,MAAM,8BAA8B,KAAK;AACrD,aAAO,+BAA+B,MAAM,GAAG,KAC7C,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CACvD;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,cAAc,MAAsB;AAC1C,UAAM,iBAAiB,KACpB,QAAQ,+BAA+B,GAAG,EAC1C,QAAQ,6BAA6B,GAAG,EACxC,QAAQ,sBAAsB,GAAG;AAEpC,UAAM,WAAW,eAAe,QAAQ,YAAY,GAAG;AACvD,UAAM,UAAU,SACb,QAAQ,YAAY,GAAG,EACvB,QAAQ,WAAW,GAAG,EACtB,QAAQ,UAAU,GAAG,EACrB,QAAQ,UAAU,GAAG,EACrB,QAAQ,YAAY,GAAG,EACvB,QAAQ,WAAW,GAAG;AAEzB,WAAO,QAAQ,QAAQ,QAAQ,GAAG,EAAE,KAAA;AAAA,EACtC;AACF;AAEO,MAAM,yBAAyB,WAAiC;AAAA,EAAhE,cAAA;AAAA,UAAA,GAAA,SAAA;AACL,SAAA,KAAK;AACL,SAAA,OAAO;AACP,SAAA,cACE;AACF,SAAA,UAAU;AACV,SAAA,SAAS;AACT,SAAA,YAAY;AAEZ,SAAQ,QAAsB,CAAA;AAAA,EAAC;AAAA,EAE/B,MAAe,WAAW,SAA8C;AACtE,UAAM,MAAM,WAAW,OAAO;AAE9B,UAAM,YAAY,QAAQ,OAAO;AAEjC,QAAI,CAAC,WAAW;AACd,WAAK,QAAQ,OAAO;AAAA,QAClB;AAAA,MAAA;AAEF,WAAK,QAAQ,CAAA;AACb;AAAA,IACF;AAEA,UAAM,OAAO,IAAI,oBAAoB;AAAA,MACnC;AAAA,MACA,QAAQ,KAAK,QAAQ;AAAA,IAAA,CACtB;AAED,SAAK,QAAQ,CAAC,IAAI;AAClB,SAAK,QAAQ,OAAO,KAAK,mDAAmD;AAAA,EAC9E;AAAA,EAES,WAAyB;AAChC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAe,UAAyB;AACtC,SAAK,QAAQ,CAAA;AAAA,EACf;AACF;"}

package/dist/esm/index42.js

@@ -1,8 +1,24 @@
-const ERROR_MESSAGES = {
-  TOO_MANY_REQUESTS: "Too many requests. Please wait a moment and try again.",
-  RATE_LIMITED: "I'm receiving too many requests right now. Please wait a moment and try again."
-};
+const getSystemMessage = (accountId) => `You are a helpful assistant managing Hashgraph Online HCS-10 connections, messages, HCS-2 registries, content inscription, and Hedera Hashgraph operations.
+
+You have access to tools for:
+- HCS-10: registering agents, finding registered agents, initiating connections, listing active connections, sending messages over connections, and checking for new messages
+- HCS-2: creating registries, registering entries, updating entries, deleting entries, migrating registries, and querying registry contents
+- Inscription: inscribing content from URLs, files, or buffers, creating Hashinal NFTs, and retrieving inscriptions
+- Hedera Token Service (HTS): creating tokens, transferring tokens, airdropping tokens, and managing token operations
+
+
+*** IMPORTANT CONTEXT ***
+You are currently operating as agent: ${accountId || "unknown"} on the Hedera Hashgraph
+When users ask about "my profile", "my account", "my connections", etc., use this account ID: ${accountId || "unknown"}
+
+*** CRITICAL ENTITY HANDLING RULES ***
+- When users refer to entities (tokens, topics, accounts) with pronouns like "it", "that", "the token/topic", etc., ALWAYS use the most recently created entity of that type
+- Entity IDs look like "0.0.XXXXXX" and are stored in memory after creation
+- NEVER use example or placeholder IDs like "0.0.123456" - always use actual created entity IDs
+- Account ID ${accountId} is NOT a token - tokens and accounts are different entities
+
+ Remember the connection numbers when listing connections, as users might refer to them.`;
 export {
-  ERROR_MESSAGES
+  getSystemMessage
 };
 //# sourceMappingURL=index42.js.map

package/dist/esm/index42.js.map

@@ -1 +1 @@
-{"version":3,"file":"index42.js","sources":["../../src/constants/messages.ts"],"sourcesContent":["/**\n * Common error messages and user feedback strings\n */\nexport const ERROR_MESSAGES = {\n  TOO_MANY_REQUESTS: 'Too many requests. Please wait a moment and try again.',\n  RATE_LIMITED: \"I'm receiving too many requests right now. Please wait a moment and try again.\",\n  SYSTEM_ERROR: 'System error occurred',\n  INVALID_INPUT: 'Invalid input provided',\n  NETWORK_ERROR: 'Network error occurred',\n} as const;\n\n/**\n * Common success and status messages\n */\nexport const STATUS_MESSAGES = {\n  OPERATION_SUCCESSFUL: 'Operation completed successfully',\n  PROCESSING: 'Processing your request...',\n  READY: 'Ready to process requests',\n  INITIALIZING: 'Initializing...',\n} as const;"],"names":[],"mappings":"AAGO,MAAM,iBAAiB;AAAA,EAC5B,mBAAmB;AAAA,EACnB,cAAc;AAIhB;"}
+{"version":3,"file":"index42.js","sources":["../../src/config/system-message.ts"],"sourcesContent":["export const getSystemMessage = (\n  accountId?: string\n): string => `You are a helpful assistant managing Hashgraph Online HCS-10 connections, messages, HCS-2 registries, content inscription, and Hedera Hashgraph operations.\n\nYou have access to tools for:\n- HCS-10: registering agents, finding registered agents, initiating connections, listing active connections, sending messages over connections, and checking for new messages\n- HCS-2: creating registries, registering entries, updating entries, deleting entries, migrating registries, and querying registry contents\n- Inscription: inscribing content from URLs, files, or buffers, creating Hashinal NFTs, and retrieving inscriptions\n- Hedera Token Service (HTS): creating tokens, transferring tokens, airdropping tokens, and managing token operations\n\n\n*** IMPORTANT CONTEXT ***\nYou are currently operating as agent: ${accountId || 'unknown'} on the Hedera Hashgraph\nWhen users ask about \"my profile\", \"my account\", \"my connections\", etc., use this account ID: ${accountId || 'unknown'}\n\n*** CRITICAL ENTITY HANDLING RULES ***\n- When users refer to entities (tokens, topics, accounts) with pronouns like \"it\", \"that\", \"the token/topic\", etc., ALWAYS use the most recently created entity of that type\n- Entity IDs look like \"0.0.XXXXXX\" and are stored in memory after creation\n- NEVER use example or placeholder IDs like \"0.0.123456\" - always use actual created entity IDs\n- Account ID ${accountId} is NOT a token - tokens and accounts are different entities\n\n Remember the connection numbers when listing connections, as users might refer to them.`;\n"],"names":[],"mappings":"AAAO,MAAM,mBAAmB,CAC9B,cACW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wCAU2B,aAAa,SAAS;AAAA,gGACkC,aAAa,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,eAMvG,SAAS;AAAA;AAAA;"}

package/dist/esm/index43.js

@@ -1,15 +1,8 @@
-import { EntityFormat } from "./index26.js";
-const ENTITY_PATTERNS = {
-  TOPIC_REFERENCE: "the topic",
-  TOKEN_REFERENCE: "the token"
+const ERROR_MESSAGES = {
+  TOO_MANY_REQUESTS: "Too many requests. Please wait a moment and try again.",
+  RATE_LIMITED: "I'm receiving too many requests right now. Please wait a moment and try again."
 };
-({
-  TOPIC: EntityFormat.TOPIC_ID,
-  TOKEN: EntityFormat.TOKEN_ID,
-  ACCOUNT: EntityFormat.ACCOUNT_ID,
-  CONTRACT: EntityFormat.CONTRACT_ID
-});
 export {
-  ENTITY_PATTERNS
+  ERROR_MESSAGES
 };
 //# sourceMappingURL=index43.js.map

package/dist/esm/index43.js.map

@@ -1 +1 @@
-{"version":3,"file":"index43.js","sources":["../../src/constants/entity-references.ts"],"sourcesContent":["/**\n * Common entity reference patterns used across the application\n */\nexport const ENTITY_PATTERNS = {\n  TOPIC_REFERENCE: 'the topic',\n  TOKEN_REFERENCE: 'the token',\n  ACCOUNT_REFERENCE: 'the account',\n  TRANSACTION_REFERENCE: 'the transaction',\n  CONTRACT_REFERENCE: 'the contract',\n} as const;\n\n/**\n * Entity type identifiers\n */\nimport { EntityFormat } from '../services/formatters/types';\n\nexport const ENTITY_TYPES = {\n  TOPIC: EntityFormat.TOPIC_ID,\n  TOKEN: EntityFormat.TOKEN_ID,\n  ACCOUNT: EntityFormat.ACCOUNT_ID,\n  TRANSACTION: 'transaction',\n  CONTRACT: EntityFormat.CONTRACT_ID,\n} as const;\n"],"names":[],"mappings":";AAGO,MAAM,kBAAkB;AAAA,EAC7B,iBAAiB;AAAA,EACjB,iBAAiB;AAInB;AAAA,CAO4B;AAAA,EAC1B,OAAO,aAAa;AAAA,EACpB,OAAO,aAAa;AAAA,EACpB,SAAS,aAAa;AAAA,EAEtB,UAAU,aAAa;AACzB;"}
+{"version":3,"file":"index43.js","sources":["../../src/constants/messages.ts"],"sourcesContent":["/**\n * Common error messages and user feedback strings\n */\nexport const ERROR_MESSAGES = {\n  TOO_MANY_REQUESTS: 'Too many requests. Please wait a moment and try again.',\n  RATE_LIMITED: \"I'm receiving too many requests right now. Please wait a moment and try again.\",\n  SYSTEM_ERROR: 'System error occurred',\n  INVALID_INPUT: 'Invalid input provided',\n  NETWORK_ERROR: 'Network error occurred',\n} as const;\n\n/**\n * Common success and status messages\n */\nexport const STATUS_MESSAGES = {\n  OPERATION_SUCCESSFUL: 'Operation completed successfully',\n  PROCESSING: 'Processing your request...',\n  READY: 'Ready to process requests',\n  INITIALIZING: 'Initializing...',\n} as const;"],"names":[],"mappings":"AAGO,MAAM,iBAAiB;AAAA,EAC5B,mBAAmB;AAAA,EACnB,cAAc;AAIhB;"}