@hashgraphonline/conversational-agent 0.2.216 → 0.2.218

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,30 @@
-import { EntityFormat } from "./index26.js";
-const ENTITY_PATTERNS = {
-  TOPIC_REFERENCE: "the topic",
-  TOKEN_REFERENCE: "the token"
+const DEFAULT_CONTENT_REFERENCE_CONFIG = {
+  sizeThresholdBytes: 10 * 1024,
+  maxAgeMs: 60 * 60 * 1e3,
+  maxReferences: 100,
+  maxTotalStorageBytes: 100 * 1024 * 1024,
+  enableAutoCleanup: true,
+  cleanupIntervalMs: 5 * 60 * 1e3,
+  enablePersistence: false,
+  storageBackend: "memory",
+  cleanupPolicies: {
+    recent: { maxAgeMs: 30 * 60 * 1e3, priority: 1 },
+    userContent: { maxAgeMs: 2 * 60 * 60 * 1e3, priority: 2 },
+    agentGenerated: { maxAgeMs: 60 * 60 * 1e3, priority: 3 },
+    default: { maxAgeMs: 60 * 60 * 1e3, priority: 4 }
+  }
 };
-({
-  TOPIC: EntityFormat.TOPIC_ID,
-  TOKEN: EntityFormat.TOKEN_ID,
-  ACCOUNT: EntityFormat.ACCOUNT_ID,
-  CONTRACT: EntityFormat.CONTRACT_ID
-});
+class ContentReferenceError extends Error {
+  constructor(message, type, referenceId, suggestedActions) {
+    super(message);
+    this.type = type;
+    this.referenceId = referenceId;
+    this.suggestedActions = suggestedActions;
+    this.name = "ContentReferenceError";
+  }
+}
 export {
-  ENTITY_PATTERNS
+  ContentReferenceError,
+  DEFAULT_CONTENT_REFERENCE_CONFIG
 };
 //# 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/types/content-reference.ts"],"sourcesContent":["/**\n * Content Reference System Types\n *\n * Shared interfaces for the Reference-Based Content System that handles\n * large content storage with unique reference IDs to optimize context window usage.\n */\n\n/**\n * Unique identifier for stored content references\n * Format: Cryptographically secure 32-byte identifier with base64url encoding\n */\nexport type ReferenceId = string;\n\n/**\n * Lifecycle state of a content reference\n */\nexport type ReferenceLifecycleState =\n  | 'active'\n  | 'expired'\n  | 'cleanup_pending'\n  | 'invalid';\n\n/**\n * Content types supported by the reference system\n */\nexport type ContentType =\n  | 'text'\n  | 'json'\n  | 'html'\n  | 'markdown'\n  | 'binary'\n  | 'unknown';\n\n/**\n * Sources that created the content reference\n */\nexport type ContentSource =\n  | 'mcp_tool'\n  | 'user_upload'\n  | 'agent_generated'\n  | 'system';\n\n/**\n * Metadata associated with stored content\n */\nexport interface ContentMetadata {\n  /** Content type classification */\n  contentType: ContentType;\n\n  /** MIME type of the original content */\n  mimeType?: string;\n\n  /** Size in bytes of the stored content */\n  sizeBytes: number;\n\n  /** When the content was originally stored */\n  createdAt: Date;\n\n  /** Last time the content was accessed via reference resolution */\n  lastAccessedAt: Date;\n\n  /** Source that created this content reference */\n  source: ContentSource;\n\n  /** Name of the MCP tool that generated the content (if applicable) */\n  mcpToolName?: string;\n\n  /** Original filename or suggested name for the content */\n  fileName?: string;\n\n  /** Number of times this reference has been resolved */\n  accessCount: number;\n\n  /** Tags for categorization and cleanup policies */\n  tags?: string[];\n\n  /** Custom metadata from the source */\n  customMetadata?: Record<string, unknown>;\n}\n\n/**\n * Core content reference object passed through agent context\n * Designed to be lightweight (<100 tokens) while providing enough\n * information for agent decision-making\n */\nexport interface ContentReference {\n  /** Unique identifier for resolving the content */\n  referenceId: ReferenceId;\n\n  /** Current lifecycle state */\n  state: ReferenceLifecycleState;\n\n  /** Brief description or preview of the content (max 200 chars) */\n  preview: string;\n\n  /** Essential metadata for agent decision-making */\n  metadata: Pick<\n    ContentMetadata,\n    'contentType' | 'sizeBytes' | 'source' | 'fileName' | 'mimeType'\n  >;\n\n  /** When this reference was created */\n  createdAt: Date;\n\n  /** Special format indicator for reference IDs in content */\n  readonly format: 'ref://{id}';\n}\n\n/**\n * Result of attempting to resolve a content reference\n */\nexport interface ReferenceResolutionResult {\n  /** Whether the resolution was successful */\n  success: boolean;\n\n  /** The resolved content if successful */\n  content?: Buffer;\n\n  /** Complete metadata if successful */\n  metadata?: ContentMetadata;\n\n  /** Error message if resolution failed */\n  error?: string;\n\n  /** Specific error type for targeted error handling */\n  errorType?:\n    | 'not_found'\n    | 'expired'\n    | 'corrupted'\n    | 'access_denied'\n    | 'system_error';\n\n  /** Suggested actions for recovery */\n  suggestedActions?: string[];\n}\n\n/**\n * Configuration for content reference storage and lifecycle\n */\nexport interface ContentReferenceConfig {\n  /** Size threshold above which content should be stored as references (default: 10KB) */\n  sizeThresholdBytes: number;\n\n  /** Maximum age for unused references before cleanup (default: 1 hour) */\n  maxAgeMs: number;\n\n  /** Maximum number of references to store simultaneously */\n  maxReferences: number;\n\n  /** Maximum total storage size for all references */\n  maxTotalStorageBytes: number;\n\n  /** Whether to enable automatic cleanup */\n  enableAutoCleanup: boolean;\n\n  /** Interval for cleanup checks in milliseconds */\n  cleanupIntervalMs: number;\n\n  /** Whether to persist references across restarts */\n  enablePersistence: boolean;\n\n  /** Storage backend configuration */\n  storageBackend: 'memory' | 'filesystem' | 'hybrid';\n\n  /** Cleanup policies for different content types */\n  cleanupPolicies: {\n    /** Policy for content marked as \"recent\" from MCP tools */\n    recent: { maxAgeMs: number; priority: number };\n\n    /** Policy for user-uploaded content */\n    userContent: { maxAgeMs: number; priority: number };\n\n    /** Policy for agent-generated content */\n    agentGenerated: { maxAgeMs: number; priority: number };\n\n    /** Default policy for other content */\n    default: { maxAgeMs: number; priority: number };\n  };\n}\n\n/**\n * Default configuration values\n */\nexport const DEFAULT_CONTENT_REFERENCE_CONFIG: ContentReferenceConfig = {\n  sizeThresholdBytes: 10 * 1024,\n  maxAgeMs: 60 * 60 * 1000,\n  maxReferences: 100,\n  maxTotalStorageBytes: 100 * 1024 * 1024,\n  enableAutoCleanup: true,\n  cleanupIntervalMs: 5 * 60 * 1000,\n  enablePersistence: false,\n  storageBackend: 'memory',\n  cleanupPolicies: {\n    recent: { maxAgeMs: 30 * 60 * 1000, priority: 1 },\n    userContent: { maxAgeMs: 2 * 60 * 60 * 1000, priority: 2 },\n    agentGenerated: { maxAgeMs: 60 * 60 * 1000, priority: 3 },\n    default: { maxAgeMs: 60 * 60 * 1000, priority: 4 },\n  },\n};\n\n/**\n * Statistics about content reference usage and storage\n */\nexport interface ContentReferenceStats {\n  /** Total number of active references */\n  activeReferences: number;\n\n  /** Total storage used by all references in bytes */\n  totalStorageBytes: number;\n\n  /** Number of references cleaned up in last cleanup cycle */\n  recentlyCleanedUp: number;\n\n  /** Number of successful reference resolutions since startup */\n  totalResolutions: number;\n\n  /** Number of failed resolution attempts */\n  failedResolutions: number;\n\n  /** Average content size in bytes */\n  averageContentSize: number;\n\n  /** Most frequently accessed reference ID */\n  mostAccessedReferenceId?: ReferenceId;\n\n  /** Storage utilization percentage */\n  storageUtilization: number;\n\n  /** Performance metrics */\n  performanceMetrics: {\n    /** Average time to create a reference in milliseconds */\n    averageCreationTimeMs: number;\n\n    /** Average time to resolve a reference in milliseconds */\n    averageResolutionTimeMs: number;\n\n    /** Average cleanup time in milliseconds */\n    averageCleanupTimeMs: number;\n  };\n}\n\n/**\n * Error types for content reference operations\n */\nexport class ContentReferenceError extends Error {\n  constructor(\n    message: string,\n    public readonly type: ReferenceResolutionResult['errorType'],\n    public readonly referenceId?: ReferenceId,\n    public readonly suggestedActions?: string[]\n  ) {\n    super(message);\n    this.name = 'ContentReferenceError';\n  }\n}\n\n/**\n * Interface for content reference storage implementations\n */\nexport interface ContentReferenceStore {\n  /**\n   * Store content and return a reference\n   */\n  storeContent(\n    content: Buffer,\n    metadata: Omit<\n      ContentMetadata,\n      'createdAt' | 'lastAccessedAt' | 'accessCount'\n    >\n  ): Promise<ContentReference>;\n\n  /**\n   * Resolve a reference to its content\n   */\n  resolveReference(\n    referenceId: ReferenceId\n  ): Promise<ReferenceResolutionResult>;\n\n  /**\n   * Check if a reference exists and is valid\n   */\n  hasReference(referenceId: ReferenceId): Promise<boolean>;\n\n  /**\n   * Mark a reference for cleanup\n   */\n  cleanupReference(referenceId: ReferenceId): Promise<boolean>;\n\n  /**\n   * Get current storage statistics\n   */\n  getStats(): Promise<ContentReferenceStats>;\n\n  /**\n   * Update configuration\n   */\n  updateConfig(config: Partial<ContentReferenceConfig>): Promise<void>;\n\n  /**\n   * Perform cleanup based on current policies\n   */\n  performCleanup(): Promise<{ cleanedUp: number; errors: string[] }>;\n\n  /**\n   * Dispose of resources\n   */\n  dispose(): Promise<void>;\n}\n"],"names":[],"mappings":"AAuLO,MAAM,mCAA2D;AAAA,EACtE,oBAAoB,KAAK;AAAA,EACzB,UAAU,KAAK,KAAK;AAAA,EACpB,eAAe;AAAA,EACf,sBAAsB,MAAM,OAAO;AAAA,EACnC,mBAAmB;AAAA,EACnB,mBAAmB,IAAI,KAAK;AAAA,EAC5B,mBAAmB;AAAA,EACnB,gBAAgB;AAAA,EAChB,iBAAiB;AAAA,IACf,QAAQ,EAAE,UAAU,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA,IAC9C,aAAa,EAAE,UAAU,IAAI,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA,IACvD,gBAAgB,EAAE,UAAU,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA,IACtD,SAAS,EAAE,UAAU,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA,EAAE;AAErD;AA8CO,MAAM,8BAA8B,MAAM;AAAA,EAC/C,YACE,SACgB,MACA,aACA,kBAChB;AACA,UAAM,OAAO;AAJG,SAAA,OAAA;AACA,SAAA,cAAA;AACA,SAAA,mBAAA;AAGhB,SAAK,OAAO;AAAA,EACd;AACF;"}