@hashgraphonline/conversational-agent 0.2.201 → 0.2.203

package/dist/cjs/plugins/index.d.ts

@@ -3,3 +3,4 @@ export { HCS2Plugin } from './hcs-2';
 export { InscribePlugin } from './inscribe';
 export { HbarPlugin } from './hbar/HbarPlugin';
 export * from './hbar';
+export { WebBrowserPlugin } from './web-browser/WebBrowserPlugin';

package/dist/cjs/plugins/web-browser/WebBrowserPlugin.d.ts

@@ -0,0 +1,14 @@
+import { BasePlugin, GenericPluginContext, HederaTool } from 'hedera-agent-kit';
+
+export declare class WebBrowserPlugin extends BasePlugin<GenericPluginContext> {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    author: string;
+    namespace: string;
+    private tools;
+    initialize(context: GenericPluginContext): Promise<void>;
+    getTools(): HederaTool[];
+    cleanup(): Promise<void>;
+}

package/dist/esm/index10.js

@@ -3,8 +3,8 @@ import { extractRenderConfigs, generateFieldOrdering } from "@hashgraphonline/st
 import { Logger } from "@hashgraphonline/standards-sdk";
 import { fieldTypeRegistry } from "./index12.js";
 import { fieldGuidanceRegistry } from "./index13.js";
-import "./index41.js";
-import { FIELD_PRIORITIES } from "./index43.js";
+import "./index44.js";
+import { FIELD_PRIORITIES } from "./index47.js";
 function isZodObjectSchema(schema) {
   return typeof schema === "object" && schema !== null && "shape" in schema;
 }

package/dist/esm/index21.js

@@ -1,5 +1,5 @@
 import { ReferenceIdGenerator } from "./index22.js";
-import { DEFAULT_CONTENT_REFERENCE_CONFIG, ContentReferenceError } from "./index44.js";
+import { DEFAULT_CONTENT_REFERENCE_CONFIG, ContentReferenceError } from "./index42.js";
 const _ContentStorage = class _ContentStorage {
   constructor(maxStorage = _ContentStorage.DEFAULT_MAX_STORAGE, referenceConfig) {
     this.messages = [];

package/dist/esm/index23.js

@@ -1,6 +1,6 @@
 import { ChatOpenAI } from "@langchain/openai";
 import { Logger } from "@hashgraphonline/standards-sdk";
-import { ENTITY_PATTERNS } from "./index41.js";
+import { ENTITY_PATTERNS } from "./index44.js";
 import "hedera-agent-kit";
 import "@hashgraphonline/standards-agent-kit";
 import "./index13.js";

package/dist/esm/index33.js

@@ -8,11 +8,11 @@ import { MCPClientManager } from "./index15.js";
 import { convertMCPToolToLangChain } from "./index17.js";
 import { SmartMemoryManager } from "./index18.js";
 import { ResponseFormatter } from "./index35.js";
-import { ERROR_MESSAGES } from "./index45.js";
-import "./index41.js";
+import { ERROR_MESSAGES } from "./index43.js";
+import "./index44.js";
 import { SystemMessage, AIMessage, HumanMessage } from "@langchain/core/messages";
-import { ToolRegistry } from "./index46.js";
-import { ExecutionPipeline } from "./index47.js";
+import { ToolRegistry } from "./index45.js";
+import { ExecutionPipeline } from "./index46.js";
 import { FormEngine } from "./index11.js";
 function hasHashLinkBlock(metadata) {
   if (!metadata || typeof metadata !== "object") {

package/dist/esm/index37.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { AccountBuilder } from "./index42.js";
+import { AccountBuilder } from "./index48.js";
 import { BaseHederaTransactionTool } from "hedera-agent-kit";
 const HbarTransferInputSchema = z.object({
   accountId: z.string().describe('Account ID for the transfer (e.g., "0.0.xxxx").'),

package/dist/esm/index40.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=index40.js.map

package/dist/esm/index40.js.map

@@ -1 +1 @@
-{"version":3,"file":"index40.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":"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;"}

package/dist/esm/index41.js

@@ -1,15 +1,24 @@
-import { EntityFormat } from "./index26.js";
-const ENTITY_PATTERNS = {
-  TOPIC_REFERENCE: "the topic",
-  TOKEN_REFERENCE: "the token"
-};
-({
-  TOPIC: EntityFormat.TOPIC_ID,
-  TOKEN: EntityFormat.TOKEN_ID,
-  ACCOUNT: EntityFormat.ACCOUNT_ID,
-  CONTRACT: EntityFormat.CONTRACT_ID
-});
+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 {
-  ENTITY_PATTERNS
+  getSystemMessage
 };
 //# sourceMappingURL=index41.js.map

package/dist/esm/index41.js.map

@@ -1 +1 @@
-{"version":3,"file":"index41.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":"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;"}

package/dist/esm/index42.js

@@ -1,98 +1,30 @@
-import { TransferTransaction, AccountId, Hbar } from "@hashgraph/sdk";
-import BigNumber from "bignumber.js";
-import { BaseServiceBuilder } from "hedera-agent-kit";
-class AccountBuilder extends BaseServiceBuilder {
-  constructor(hederaKit) {
-    super(hederaKit);
+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 }
   }
-  /**
-   * Transfers HBAR between accounts with proper decimal handling
-   */
-  transferHbar(params, isUserInitiated = true) {
-    this.clearNotes();
-    const transaction = new TransferTransaction();
-    if (!params.transfers || params.transfers.length === 0) {
-      throw new Error("HbarTransferParams must include at least one transfer.");
-    }
-    let netZeroInTinybars = new BigNumber(0);
-    let userTransferProcessedForScheduling = false;
-    if (isUserInitiated && this.kit.userAccountId && this.kit.operationalMode === "provideBytes" && params.transfers.length === 1) {
-      const receiverTransfer = params.transfers[0];
-      const amountValue = typeof receiverTransfer.amount === "string" || typeof receiverTransfer.amount === "number" ? receiverTransfer.amount : receiverTransfer.amount.toString();
-      const amountBigNum = new BigNumber(amountValue);
-      if (amountBigNum.isPositive()) {
-        const recipientAccountId = typeof receiverTransfer.accountId === "string" ? AccountId.fromString(receiverTransfer.accountId) : receiverTransfer.accountId;
-        const roundedAmount = amountBigNum.toFixed(8, BigNumber.ROUND_DOWN);
-        const sdkHbarAmount = Hbar.fromString(roundedAmount);
-        this.logger.info(
-          `[AccountBuilder.transferHbar] Configuring user-initiated scheduled transfer: ${sdkHbarAmount.toString()} from ${this.kit.userAccountId} to ${recipientAccountId.toString()}`
-        );
-        this.addNote(
-          `Configured HBAR transfer from your account (${this.kit.userAccountId}) to ${recipientAccountId.toString()} for ${sdkHbarAmount.toString()}.`
-        );
-        transaction.addHbarTransfer(recipientAccountId, sdkHbarAmount);
-        transaction.addHbarTransfer(
-          AccountId.fromString(this.kit.userAccountId),
-          sdkHbarAmount.negated()
-        );
-        userTransferProcessedForScheduling = true;
-      }
-    }
-    if (!userTransferProcessedForScheduling) {
-      const processedTransfers = [];
-      for (const transferInput of params.transfers) {
-        const accountId = typeof transferInput.accountId === "string" ? AccountId.fromString(transferInput.accountId) : transferInput.accountId;
-        const amountValue = typeof transferInput.amount === "string" || typeof transferInput.amount === "number" ? transferInput.amount : transferInput.amount.toString();
-        const amountBigNum = new BigNumber(amountValue);
-        const roundedAmount = amountBigNum.toFixed(8, BigNumber.ROUND_DOWN);
-        this.logger.info(
-          `Processing transfer: ${amountValue} HBAR (rounded to ${roundedAmount}) for account ${accountId.toString()}`
-        );
-        const sdkHbarAmount = Hbar.fromString(roundedAmount);
-        processedTransfers.push({
-          accountId,
-          amount: amountBigNum,
-          hbar: sdkHbarAmount
-        });
-        const tinybarsContribution = sdkHbarAmount.toTinybars();
-        netZeroInTinybars = netZeroInTinybars.plus(
-          tinybarsContribution.toString()
-        );
-      }
-      if (!netZeroInTinybars.isZero()) {
-        this.logger.warn(
-          `Transfer sum not zero: ${netZeroInTinybars.toString()} tinybars off. Adjusting last transfer.`
-        );
-        if (processedTransfers.length > 0) {
-          const lastTransfer = processedTransfers[processedTransfers.length - 1];
-          const adjustment = netZeroInTinybars.dividedBy(-1e8);
-          const adjustedAmount = lastTransfer.amount.plus(adjustment);
-          const adjustedRounded = adjustedAmount.toFixed(
-            8,
-            BigNumber.ROUND_DOWN
-          );
-          lastTransfer.hbar = Hbar.fromString(adjustedRounded);
-          this.logger.info(
-            `Adjusted last transfer for ${lastTransfer.accountId.toString()} to ${adjustedRounded} HBAR`
-          );
-        }
-      }
-      for (const transfer of processedTransfers) {
-        transaction.addHbarTransfer(transfer.accountId, transfer.hbar);
-      }
-    }
-    if (typeof params.memo !== "undefined") {
-      if (params.memo === null) {
-        this.logger.warn("Received null for memo in transferHbar.");
-      } else {
-        transaction.setTransactionMemo(params.memo);
-      }
-    }
-    this.setCurrentTransaction(transaction);
-    return this;
+};
+class ContentReferenceError extends Error {
+  constructor(message, type, referenceId, suggestedActions) {
+    super(message);
+    this.type = type;
+    this.referenceId = referenceId;
+    this.suggestedActions = suggestedActions;
+    this.name = "ContentReferenceError";
   }
 }
 export {
-  AccountBuilder
+  ContentReferenceError,
+  DEFAULT_CONTENT_REFERENCE_CONFIG
 };
 //# sourceMappingURL=index42.js.map

package/dist/esm/index42.js.map

@@ -1 +1 @@
-{"version":3,"file":"index42.js","sources":["../../src/plugins/hbar/AccountBuilder.ts"],"sourcesContent":["import { AccountId, Hbar, TransferTransaction } from '@hashgraph/sdk';\nimport BigNumber from 'bignumber.js';\nimport { HederaAgentKit, BaseServiceBuilder } from 'hedera-agent-kit';\nimport { HbarTransferParams } from './types';\n\n/**\n * Custom AccountBuilder that properly handles HBAR decimal conversion\n */\nexport class AccountBuilder extends BaseServiceBuilder {\n  constructor(hederaKit: HederaAgentKit) {\n    super(hederaKit);\n  }\n\n  /**\n   * Transfers HBAR between accounts with proper decimal handling\n   */\n  public transferHbar(\n    params: HbarTransferParams,\n    isUserInitiated: boolean = true\n  ): this {\n    this.clearNotes();\n    const transaction = new TransferTransaction();\n\n    if (!params.transfers || params.transfers.length === 0) {\n      throw new Error('HbarTransferParams must include at least one transfer.');\n    }\n\n    let netZeroInTinybars = new BigNumber(0);\n    let userTransferProcessedForScheduling = false;\n\n    if (\n      isUserInitiated &&\n      this.kit.userAccountId &&\n      (this.kit.operationalMode as string) === 'provideBytes' &&\n      params.transfers.length === 1\n    ) {\n      const receiverTransfer = params.transfers[0];\n      const amountValue =\n        typeof receiverTransfer.amount === 'string' ||\n        typeof receiverTransfer.amount === 'number'\n          ? receiverTransfer.amount\n          : receiverTransfer.amount.toString();\n\n      const amountBigNum = new BigNumber(amountValue);\n\n      if (amountBigNum.isPositive()) {\n        const recipientAccountId =\n          typeof receiverTransfer.accountId === 'string'\n            ? AccountId.fromString(receiverTransfer.accountId)\n            : receiverTransfer.accountId;\n\n        const roundedAmount = amountBigNum.toFixed(8, BigNumber.ROUND_DOWN);\n        const sdkHbarAmount = Hbar.fromString(roundedAmount);\n\n        this.logger.info(\n          `[AccountBuilder.transferHbar] Configuring user-initiated scheduled transfer: ${sdkHbarAmount.toString()} from ${\n            this.kit.userAccountId\n          } to ${recipientAccountId.toString()}`\n        );\n\n        this.addNote(\n          `Configured HBAR transfer from your account (${\n            this.kit.userAccountId\n          }) to ${recipientAccountId.toString()} for ${sdkHbarAmount.toString()}.`\n        );\n\n        transaction.addHbarTransfer(recipientAccountId, sdkHbarAmount);\n        transaction.addHbarTransfer(\n          AccountId.fromString(this.kit.userAccountId),\n          sdkHbarAmount.negated()\n        );\n\n        userTransferProcessedForScheduling = true;\n      }\n    }\n\n    if (!userTransferProcessedForScheduling) {\n      const processedTransfers: Array<{\n        accountId: AccountId;\n        amount: BigNumber;\n        hbar: Hbar;\n      }> = [];\n\n      for (const transferInput of params.transfers) {\n        const accountId =\n          typeof transferInput.accountId === 'string'\n            ? AccountId.fromString(transferInput.accountId)\n            : transferInput.accountId;\n\n        const amountValue =\n          typeof transferInput.amount === 'string' ||\n          typeof transferInput.amount === 'number'\n            ? transferInput.amount\n            : transferInput.amount.toString();\n\n        const amountBigNum = new BigNumber(amountValue);\n        const roundedAmount = amountBigNum.toFixed(8, BigNumber.ROUND_DOWN);\n\n        this.logger.info(\n          `Processing transfer: ${amountValue} HBAR (rounded to ${roundedAmount}) for account ${accountId.toString()}`\n        );\n\n        const sdkHbarAmount = Hbar.fromString(roundedAmount);\n        processedTransfers.push({\n          accountId,\n          amount: amountBigNum,\n          hbar: sdkHbarAmount,\n        });\n\n        const tinybarsContribution = sdkHbarAmount.toTinybars();\n        netZeroInTinybars = netZeroInTinybars.plus(\n          tinybarsContribution.toString()\n        );\n      }\n\n      if (!netZeroInTinybars.isZero()) {\n        this.logger.warn(\n          `Transfer sum not zero: ${netZeroInTinybars.toString()} tinybars off. Adjusting last transfer.`\n        );\n\n        if (processedTransfers.length > 0) {\n          const lastTransfer =\n            processedTransfers[processedTransfers.length - 1];\n          const adjustment = netZeroInTinybars.dividedBy(-100000000);\n          const adjustedAmount = lastTransfer.amount.plus(adjustment);\n          const adjustedRounded = adjustedAmount.toFixed(\n            8,\n            BigNumber.ROUND_DOWN\n          );\n          lastTransfer.hbar = Hbar.fromString(adjustedRounded);\n\n          this.logger.info(\n            `Adjusted last transfer for ${lastTransfer.accountId.toString()} to ${adjustedRounded} HBAR`\n          );\n        }\n      }\n\n      for (const transfer of processedTransfers) {\n        transaction.addHbarTransfer(transfer.accountId, transfer.hbar);\n      }\n    }\n\n    if (typeof params.memo !== 'undefined') {\n      if (params.memo === null) {\n        this.logger.warn('Received null for memo in transferHbar.');\n      } else {\n        transaction.setTransactionMemo(params.memo);\n      }\n    }\n\n    this.setCurrentTransaction(transaction);\n    return this;\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index42.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;"}

package/dist/esm/index43.js

@@ -1,10 +1,8 @@
-const FIELD_PRIORITIES = {
-  ESSENTIAL: "essential",
-  COMMON: "common",
-  ADVANCED: "advanced",
-  EXPERT: "expert"
+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."
 };
 export {
-  FIELD_PRIORITIES
+  ERROR_MESSAGES
 };
 //# sourceMappingURL=index43.js.map

package/dist/esm/index43.js.map

@@ -1 +1 @@
-{"version":3,"file":"index43.js","sources":["../../src/constants/form-priorities.ts"],"sourcesContent":["/**\n * Form field priorities for progressive disclosure\n */\nexport const FIELD_PRIORITIES = {\n  ESSENTIAL: 'essential',\n  COMMON: 'common', \n  ADVANCED: 'advanced',\n  EXPERT: 'expert'\n} as const;\n\n/**\n * Form field types\n */\nexport const FORM_FIELD_TYPES = {\n  TEXT: 'text',\n  NUMBER: 'number',\n  SELECT: 'select',\n  CHECKBOX: 'checkbox',\n  TEXTAREA: 'textarea',\n  FILE: 'file',\n  ARRAY: 'array',\n  OBJECT: 'object',\n  CURRENCY: 'currency',\n  PERCENTAGE: 'percentage',\n} as const;"],"names":[],"mappings":"AAGO,MAAM,mBAAmB;AAAA,EAC9B,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,UAAU;AAAA,EACV,QAAQ;AACV;"}
+{"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;"}

package/dist/esm/index44.js

@@ -1,30 +1,15 @@
-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 }
-  }
+import { EntityFormat } from "./index26.js";
+const ENTITY_PATTERNS = {
+  TOPIC_REFERENCE: "the topic",
+  TOKEN_REFERENCE: "the token"
 };
-class ContentReferenceError extends Error {
-  constructor(message, type, referenceId, suggestedActions) {
-    super(message);
-    this.type = type;
-    this.referenceId = referenceId;
-    this.suggestedActions = suggestedActions;
-    this.name = "ContentReferenceError";
-  }
-}
+({
+  TOPIC: EntityFormat.TOPIC_ID,
+  TOKEN: EntityFormat.TOKEN_ID,
+  ACCOUNT: EntityFormat.ACCOUNT_ID,
+  CONTRACT: EntityFormat.CONTRACT_ID
+});
 export {
-  ContentReferenceError,
-  DEFAULT_CONTENT_REFERENCE_CONFIG
+  ENTITY_PATTERNS
 };
 //# sourceMappingURL=index44.js.map

package/dist/esm/index44.js.map

@@ -1 +1 @@
-{"version":3,"file":"index44.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;"}
+{"version":3,"file":"index44.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;"}