@hashgraphonline/standards-agent-kit 0.0.32 → 0.0.33

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

@@ -1,69 +1,127 @@
 import { StructuredTool } from "@langchain/core/tools";
 import { z } from "zod";
 import { Logger } from "@hashgraphonline/standards-sdk";
-class RetrieveProfileTool extends StructuredTool {
-  /**
-   * Creates a new RetrieveProfileTool instance.
-   * @param client - An instance of HCS10Client.
-   */
-  constructor(client) {
-    super();
-    this.name = "retrieve_profile";
-    this.description = "Retrieves the HCS-11 profile data associated with a given Hedera account ID. If no account ID is provided, it defaults to the current operator account ID. Returns the profile object as a JSON string on success.";
+class ListUnapprovedConnectionRequestsTool extends StructuredTool {
+  constructor({
+    hcsClient,
+    stateManager,
+    ...rest
+  }) {
+    super(rest);
+    this.name = "list_unapproved_connection_requests";
+    this.description = "Lists all connection requests that are not fully established, including incoming requests needing approval and outgoing requests waiting for confirmation.";
     this.schema = z.object({
-      accountId: z.string().optional().describe(
-        "The Hedera account ID (e.g., 0.0.12345) to retrieve the profile for. If omitted, defaults to the current operator account ID."
+      sortBy: z.enum(["time_asc", "time_desc", "name_asc", "name_desc"]).optional().describe(
+        "Optional sorting criteria for the requests list (default: time_desc, newest first)"
       ),
-      disableCache: z.boolean().optional().describe(
-        "Optional: Set to true to bypass the cache and fetch fresh profile data."
+      limit: z.number().optional().describe(
+        "Optional limit on the number of requests to return (default: all)"
       )
     });
-    this.client = client;
-    this.logger = Logger.getInstance({ module: this.name });
+    this.hcsClient = hcsClient;
+    this.stateManager = stateManager;
+    this.logger = Logger.getInstance({
+      module: "ListPendingRequestsTool",
+      level: "debug"
+    });
+  }
+  async _call({
+    sortBy = "time_desc",
+    limit
+  }) {
+    const currentAgent = this.stateManager.getCurrentAgent();
+    if (!currentAgent) {
+      return "Error: Cannot list pending requests. No agent is currently active. Please register or select an agent first.";
+    }
+    try {
+      const pendingRequests = await this.findAllPendingRequests();
+      return this.formatRequestsList(pendingRequests, sortBy, limit);
+    } catch (error) {
+      this.logger.error(`Error in ${this.name}: ${error}`);
+      return `Error listing pending requests: ${error instanceof Error ? error.message : String(error)}`;
+    }
   }
   /**
-   * Executes the profile retrieval.
-   * @param input - The input object containing accountId and optional disableCache flag.
-   * @returns A JSON string of the profile on success, or an error message string.
+   * Processes the connection connectionMap to find all requests
+   * that are not fully established (incoming unapproved and outgoing pending).
    */
-  async _call(input) {
-    let targetAccountId;
-    try {
-      if (input.accountId) {
-        targetAccountId = input.accountId;
-      } else {
-        this.logger.info("accountId not provided, defaulting to operator ID.");
-        targetAccountId = this.client.getOperatorId();
+  async findAllPendingRequests() {
+    const connectionsManager = this.stateManager.getConnectionsManager();
+    if (!connectionsManager) {
+      return [];
+    }
+    const currentAgent = this.stateManager.getCurrentAgent();
+    if (!currentAgent) {
+      return [];
+    }
+    await connectionsManager.fetchConnectionData(currentAgent.accountId);
+    const pendingRequests = connectionsManager.getPendingRequests();
+    const connectionsNeedingConfirmation = connectionsManager.getConnectionsNeedingConfirmation();
+    return [...pendingRequests, ...connectionsNeedingConfirmation];
+  }
+  /**
+   * Formats the list of pending requests for display.
+   */
+  formatRequestsList(requests, sortBy, limit) {
+    if (requests.length === 0) {
+      return "No pending connection requests found (incoming or outgoing).";
+    }
+    const sortedRequests = this.sortRequests(requests, sortBy);
+    const limitedRequests = limit ? sortedRequests.slice(0, limit) : sortedRequests;
+    let output = `Found ${requests.length} pending connection request(s):
+
+`;
+    limitedRequests.forEach((request, index) => {
+      const statusIndicator = request.status === "needs_confirmation" ? "🟠 Incoming" : "⚪️ Outgoing";
+      output += `${index + 1}. ${statusIndicator} - ID: ${request.uniqueRequestKey}
+`;
+      output += `   ${request.status === "needs_confirmation" ? "From:" : "To:  "} ${request.targetAgentName} (${request.targetAccountId})
+`;
+      output += `   Sent/Rcvd: ${request.created.toLocaleString()}
+`;
+      if (request.memo) {
+        output += `   Memo: ${request.memo}
+`;
       }
-      if (!targetAccountId) {
-        throw new Error("Could not determine target account ID.");
+      if (request.profileInfo?.bio) {
+        output += `   Bio: ${request.profileInfo.bio.substring(0, 100)}${request.profileInfo.bio.length > 100 ? "..." : ""}
+`;
       }
-      this.logger.info(
-        `Attempting to retrieve profile for account: ${targetAccountId}, Disable Cache: ${!!input.disableCache}`
-      );
-      const result = await this.client.standardClient.retrieveProfile(
-        targetAccountId,
-        input.disableCache
-      );
-      if (result.success && result.profile) {
-        this.logger.info(
-          `Successfully retrieved profile for ${targetAccountId}.`
+      output += "\n";
+    });
+    output += "Use related tools (manage_requests, accept_request) to handle these items.";
+    return output;
+  }
+  /**
+   * Sorts connection requests based on the specified criteria.
+   */
+  sortRequests(requests, sortBy) {
+    const requestsCopy = [...requests];
+    switch (sortBy) {
+      case "time_asc":
+        return requestsCopy.sort(
+          (a, b) => a.created.getTime() - b.created.getTime()
+        );
+      case "time_desc":
+        return requestsCopy.sort(
+          (a, b) => b.created.getTime() - a.created.getTime()
+        );
+      case "name_asc":
+        return requestsCopy.sort(
+          (a, b) => a.targetAgentName?.localeCompare(b?.targetAgentName || "") || 0
+        );
+      case "name_desc":
+        return requestsCopy.sort(
+          (a, b) => b.targetAgentName?.localeCompare(a?.targetAgentName || "") || 0
+        );
+      default:
+        return requestsCopy.sort(
+          (a, b) => b.created.getTime() - a.created.getTime()
         );
-        return JSON.stringify(result.profile, null, 2);
-      } else {
-        const errorMessage = `Error retrieving profile for ${targetAccountId}: ${result.error || "Profile not found or invalid."}`;
-        this.logger.error(errorMessage);
-        return errorMessage;
-      }
-    } catch (error) {
-      const idForError = input.accountId || "operator default";
-      const errorMessage = `Unexpected error retrieving profile for ${idForError}: ${error instanceof Error ? error.message : String(error)}`;
-      this.logger.error(errorMessage, error);
-      return errorMessage;
     }
   }
 }
 export {
-  RetrieveProfileTool
+  ListUnapprovedConnectionRequestsTool
 };
 //# sourceMappingURL=standards-agent-kit.es15.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es15.js","sources":["../../src/tools/RetrieveProfileTool.ts"],"sourcesContent":["import { StructuredTool } from '@langchain/core/tools';\nimport { z } from 'zod';\nimport { HCS10Client } from '../hcs10/HCS10Client';\nimport { Logger } from '@hashgraphonline/standards-sdk';\n\n/**\n * Tool for retrieving the HCS-11 profile associated with a Hedera account ID.\n * Utilizes the HCS10Client's retrieveProfile method, which handles fetching.\n */\nexport class RetrieveProfileTool extends StructuredTool {\n  name = 'retrieve_profile';\n  description =\n    'Retrieves the HCS-11 profile data associated with a given Hedera account ID. If no account ID is provided, it defaults to the current operator account ID. Returns the profile object as a JSON string on success.';\n\n  private client: HCS10Client;\n  private logger: Logger;\n\n  schema = z.object({\n    accountId: z\n      .string()\n      .optional()\n      .describe(\n        'The Hedera account ID (e.g., 0.0.12345) to retrieve the profile for. If omitted, defaults to the current operator account ID.'\n      ),\n    disableCache: z\n      .boolean()\n      .optional()\n      .describe(\n        'Optional: Set to true to bypass the cache and fetch fresh profile data.'\n      ),\n  });\n\n  /**\n   * Creates a new RetrieveProfileTool instance.\n   * @param client - An instance of HCS10Client.\n   */\n  constructor(client: HCS10Client) {\n    super();\n    this.client = client;\n    this.logger = Logger.getInstance({ module: this.name });\n  }\n\n  /**\n   * Executes the profile retrieval.\n   * @param input - The input object containing accountId and optional disableCache flag.\n   * @returns A JSON string of the profile on success, or an error message string.\n   */\n  async _call(input: z.infer<typeof this.schema>): Promise<string> {\n    let targetAccountId: string;\n    try {\n      if (input.accountId) {\n        targetAccountId = input.accountId;\n      } else {\n        this.logger.info('accountId not provided, defaulting to operator ID.');\n        targetAccountId = this.client.getOperatorId();\n      }\n\n      if (!targetAccountId) {\n        throw new Error('Could not determine target account ID.');\n      }\n\n      this.logger.info(\n        `Attempting to retrieve profile for account: ${targetAccountId}, Disable Cache: ${!!input.disableCache}`\n      );\n\n      // Call retrieveProfile via the standardClient instance using the determined ID\n      const result = await this.client.standardClient.retrieveProfile(\n        targetAccountId,\n        input.disableCache\n      );\n\n      if (result.success && result.profile) {\n        this.logger.info(\n          `Successfully retrieved profile for ${targetAccountId}.`\n        );\n\n        return JSON.stringify(result.profile, null, 2); \n      } else {\n        const errorMessage = `Error retrieving profile for ${targetAccountId}: ${\n          result.error || 'Profile not found or invalid.'\n        }`;\n        this.logger.error(errorMessage);\n        return errorMessage;\n      }\n    } catch (error) {\n      const idForError = input.accountId || 'operator default';\n      const errorMessage = `Unexpected error retrieving profile for ${idForError}: ${\n        error instanceof Error ? error.message : String(error)\n      }`;\n      this.logger.error(errorMessage, error);\n      return errorMessage;\n    }\n  }\n}\n"],"names":[],"mappings":";;;AASO,MAAM,4BAA4B,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA,EA2BtD,YAAY,QAAqB;AACzB,UAAA;AA3BD,SAAA,OAAA;AAEL,SAAA,cAAA;AAKF,SAAA,SAAS,EAAE,OAAO;AAAA,MAChB,WAAW,EACR,SACA,SACA,EAAA;AAAA,QACC;AAAA,MACF;AAAA,MACF,cAAc,EACX,UACA,SACA,EAAA;AAAA,QACC;AAAA,MAAA;AAAA,IACF,CACH;AAQC,SAAK,SAAS;AACd,SAAK,SAAS,OAAO,YAAY,EAAE,QAAQ,KAAK,MAAM;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQxD,MAAM,MAAM,OAAqD;AAC3D,QAAA;AACA,QAAA;AACF,UAAI,MAAM,WAAW;AACnB,0BAAkB,MAAM;AAAA,MAAA,OACnB;AACA,aAAA,OAAO,KAAK,oDAAoD;AACnD,0BAAA,KAAK,OAAO,cAAc;AAAA,MAAA;AAG9C,UAAI,CAAC,iBAAiB;AACd,cAAA,IAAI,MAAM,wCAAwC;AAAA,MAAA;AAG1D,WAAK,OAAO;AAAA,QACV,+CAA+C,eAAe,oBAAoB,CAAC,CAAC,MAAM,YAAY;AAAA,MACxG;AAGA,YAAM,SAAS,MAAM,KAAK,OAAO,eAAe;AAAA,QAC9C;AAAA,QACA,MAAM;AAAA,MACR;AAEI,UAAA,OAAO,WAAW,OAAO,SAAS;AACpC,aAAK,OAAO;AAAA,UACV,sCAAsC,eAAe;AAAA,QACvD;AAEA,eAAO,KAAK,UAAU,OAAO,SAAS,MAAM,CAAC;AAAA,MAAA,OACxC;AACL,cAAM,eAAe,gCAAgC,eAAe,KAClE,OAAO,SAAS,+BAClB;AACK,aAAA,OAAO,MAAM,YAAY;AACvB,eAAA;AAAA,MAAA;AAAA,aAEF,OAAO;AACR,YAAA,aAAa,MAAM,aAAa;AAChC,YAAA,eAAe,2CAA2C,UAAU,KACxE,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CACvD;AACK,WAAA,OAAO,MAAM,cAAc,KAAK;AAC9B,aAAA;AAAA,IAAA;AAAA,EACT;AAEJ;"}
+{"version":3,"file":"standards-agent-kit.es15.js","sources":["../../src/tools/ListUnapprovedConnectionRequestsTool.ts"],"sourcesContent":["import { StructuredTool, ToolParams } from '@langchain/core/tools';\nimport { z } from 'zod';\nimport {\n  IStateManager,\n} from '../state/state-types';\nimport { HCS10Client } from '../hcs10/HCS10Client';\nimport {\n  Logger,\n  Connection,\n} from '@hashgraphonline/standards-sdk';\n\n\ntype ListPendingRequestsToolParams = ToolParams & {\n  hcsClient: HCS10Client;\n  stateManager: IStateManager;\n};\n\nexport class ListUnapprovedConnectionRequestsTool extends StructuredTool {\n  name = 'list_unapproved_connection_requests';\n  description =\n    'Lists all connection requests that are not fully established, including incoming requests needing approval and outgoing requests waiting for confirmation.';\n  schema = z.object({\n    sortBy: z\n      .enum(['time_asc', 'time_desc', 'name_asc', 'name_desc'])\n      .optional()\n      .describe(\n        'Optional sorting criteria for the requests list (default: time_desc, newest first)'\n      ),\n    limit: z\n      .number()\n      .optional()\n      .describe(\n        'Optional limit on the number of requests to return (default: all)'\n      ),\n  });\n\n  private hcsClient: HCS10Client;\n  private stateManager: IStateManager;\n  private logger: Logger;\n\n  constructor({\n    hcsClient,\n    stateManager,\n    ...rest\n  }: ListPendingRequestsToolParams) {\n    super(rest);\n    this.hcsClient = hcsClient;\n    this.stateManager = stateManager;\n    this.logger = Logger.getInstance({\n      module: 'ListPendingRequestsTool',\n      level: 'debug',\n    });\n  }\n\n  protected async _call({\n    sortBy = 'time_desc',\n    limit,\n  }: z.infer<this['schema']>): Promise<string> {\n    const currentAgent = this.stateManager.getCurrentAgent();\n    if (!currentAgent) {\n      return 'Error: Cannot list pending requests. No agent is currently active. Please register or select an agent first.';\n    }\n\n    try {\n      const pendingRequests = await this.findAllPendingRequests();\n      return this.formatRequestsList(pendingRequests, sortBy, limit);\n    } catch (error) {\n      this.logger.error(`Error in ${this.name}: ${error}`);\n      return `Error listing pending requests: ${\n        error instanceof Error ? error.message : String(error)\n      }`;\n    }\n  }\n\n  /**\n   * Processes the connection connectionMap to find all requests\n   * that are not fully established (incoming unapproved and outgoing pending).\n   */\n  private async findAllPendingRequests(): Promise<Connection[]> {\n    const connectionsManager = this.stateManager.getConnectionsManager();\n    if (!connectionsManager) {\n      return [];\n    }\n    const currentAgent = this.stateManager.getCurrentAgent();\n    if (!currentAgent) {\n      return [];\n    }\n\n    await connectionsManager.fetchConnectionData(currentAgent.accountId);\n    const pendingRequests = connectionsManager.getPendingRequests();\n    const connectionsNeedingConfirmation = connectionsManager.getConnectionsNeedingConfirmation();\n\n    return [...pendingRequests, ...connectionsNeedingConfirmation];\n  }\n\n  /**\n   * Formats the list of pending requests for display.\n   */\n  private formatRequestsList(\n    requests: Connection[],\n    sortBy: string,\n    limit?: number\n  ): string {\n    if (requests.length === 0) {\n      return 'No pending connection requests found (incoming or outgoing).';\n    }\n\n    const sortedRequests = this.sortRequests(requests, sortBy);\n    const limitedRequests = limit\n      ? sortedRequests.slice(0, limit)\n      : sortedRequests;\n\n    let output = `Found ${requests.length} pending connection request(s):\\n\\n`;\n\n    limitedRequests.forEach((request, index) => {\n      const statusIndicator =\n        request.status === 'needs_confirmation'\n          ? '🟠 Incoming'\n          : '⚪️ Outgoing';\n      output += `${index + 1}. ${statusIndicator} - ID: ${request.uniqueRequestKey}\\n`;\n      output += `   ${\n        request.status === 'needs_confirmation' ? 'From:' : 'To:  '\n      } ${request.targetAgentName} (${request.targetAccountId})\\n`;\n      output += `   Sent/Rcvd: ${request.created.toLocaleString()}\\n`;\n      if (request.memo) {\n        output += `   Memo: ${request.memo}\\n`;\n      }\n      if (request.profileInfo?.bio) {\n        output += `   Bio: ${request.profileInfo.bio.substring(0, 100)}${\n          request.profileInfo.bio.length > 100 ? '...' : ''\n        }\\n`;\n      }\n      output += '\\n';\n    });\n\n    output +=\n      'Use related tools (manage_requests, accept_request) to handle these items.';\n    return output;\n  }\n\n  /**\n   * Sorts connection requests based on the specified criteria.\n   */\n  private sortRequests(\n    requests: Connection[],\n    sortBy: string\n  ): Connection[] {\n    const requestsCopy = [...requests];\n\n    switch (sortBy) {\n      case 'time_asc':\n        return requestsCopy.sort(\n          (a, b) => a.created.getTime() - b.created.getTime()\n        );\n      case 'time_desc':\n        return requestsCopy.sort(\n          (a, b) => b.created.getTime() - a.created.getTime()\n        );\n      case 'name_asc':\n        return requestsCopy.sort((a, b) =>\n          a.targetAgentName?.localeCompare(b?.targetAgentName || '') || 0\n        );\n      case 'name_desc':\n        return requestsCopy.sort((a, b) =>\n          b.targetAgentName?.localeCompare(a?.targetAgentName || '') || 0\n        );\n      default:\n        return requestsCopy.sort(\n          (a, b) => b.created.getTime() - a.created.getTime()\n        );\n    }\n  }\n}\n"],"names":[],"mappings":";;;AAiBO,MAAM,6CAA6C,eAAe;AAAA,EAuBvE,YAAY;AAAA,IACV;AAAA,IACA;AAAA,IACA,GAAG;AAAA,EAAA,GAC6B;AAChC,UAAM,IAAI;AA3BL,SAAA,OAAA;AAEL,SAAA,cAAA;AACF,SAAA,SAAS,EAAE,OAAO;AAAA,MAChB,QAAQ,EACL,KAAK,CAAC,YAAY,aAAa,YAAY,WAAW,CAAC,EACvD,SAAA,EACA;AAAA,QACC;AAAA,MACF;AAAA,MACF,OAAO,EACJ,SACA,SACA,EAAA;AAAA,QACC;AAAA,MAAA;AAAA,IACF,CACH;AAYC,SAAK,YAAY;AACjB,SAAK,eAAe;AACf,SAAA,SAAS,OAAO,YAAY;AAAA,MAC/B,QAAQ;AAAA,MACR,OAAO;AAAA,IAAA,CACR;AAAA,EAAA;AAAA,EAGH,MAAgB,MAAM;AAAA,IACpB,SAAS;AAAA,IACT;AAAA,EAAA,GAC2C;AACrC,UAAA,eAAe,KAAK,aAAa,gBAAgB;AACvD,QAAI,CAAC,cAAc;AACV,aAAA;AAAA,IAAA;AAGL,QAAA;AACI,YAAA,kBAAkB,MAAM,KAAK,uBAAuB;AAC1D,aAAO,KAAK,mBAAmB,iBAAiB,QAAQ,KAAK;AAAA,aACtD,OAAO;AACd,WAAK,OAAO,MAAM,YAAY,KAAK,IAAI,KAAK,KAAK,EAAE;AACnD,aAAO,mCACL,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CACvD;AAAA,IAAA;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAOF,MAAc,yBAAgD;AACtD,UAAA,qBAAqB,KAAK,aAAa,sBAAsB;AACnE,QAAI,CAAC,oBAAoB;AACvB,aAAO,CAAC;AAAA,IAAA;AAEJ,UAAA,eAAe,KAAK,aAAa,gBAAgB;AACvD,QAAI,CAAC,cAAc;AACjB,aAAO,CAAC;AAAA,IAAA;AAGJ,UAAA,mBAAmB,oBAAoB,aAAa,SAAS;AAC7D,UAAA,kBAAkB,mBAAmB,mBAAmB;AACxD,UAAA,iCAAiC,mBAAmB,kCAAkC;AAE5F,WAAO,CAAC,GAAG,iBAAiB,GAAG,8BAA8B;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAMvD,mBACN,UACA,QACA,OACQ;AACJ,QAAA,SAAS,WAAW,GAAG;AAClB,aAAA;AAAA,IAAA;AAGT,UAAM,iBAAiB,KAAK,aAAa,UAAU,MAAM;AACzD,UAAM,kBAAkB,QACpB,eAAe,MAAM,GAAG,KAAK,IAC7B;AAEA,QAAA,SAAS,SAAS,SAAS,MAAM;AAAA;AAAA;AAErB,oBAAA,QAAQ,CAAC,SAAS,UAAU;AAC1C,YAAM,kBACJ,QAAQ,WAAW,uBACf,gBACA;AACN,gBAAU,GAAG,QAAQ,CAAC,KAAK,eAAe,UAAU,QAAQ,gBAAgB;AAAA;AAClE,gBAAA,MACR,QAAQ,WAAW,uBAAuB,UAAU,OACtD,IAAI,QAAQ,eAAe,KAAK,QAAQ,eAAe;AAAA;AACvD,gBAAU,iBAAiB,QAAQ,QAAQ,eAAgB,CAAA;AAAA;AAC3D,UAAI,QAAQ,MAAM;AACN,kBAAA,YAAY,QAAQ,IAAI;AAAA;AAAA,MAAA;AAEhC,UAAA,QAAQ,aAAa,KAAK;AAC5B,kBAAU,WAAW,QAAQ,YAAY,IAAI,UAAU,GAAG,GAAG,CAAC,GAC5D,QAAQ,YAAY,IAAI,SAAS,MAAM,QAAQ,EACjD;AAAA;AAAA,MAAA;AAEQ,gBAAA;AAAA,IAAA,CACX;AAGC,cAAA;AACK,WAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAMD,aACN,UACA,QACc;AACR,UAAA,eAAe,CAAC,GAAG,QAAQ;AAEjC,YAAQ,QAAQ;AAAA,MACd,KAAK;AACH,eAAO,aAAa;AAAA,UAClB,CAAC,GAAG,MAAM,EAAE,QAAQ,YAAY,EAAE,QAAQ,QAAQ;AAAA,QACpD;AAAA,MACF,KAAK;AACH,eAAO,aAAa;AAAA,UAClB,CAAC,GAAG,MAAM,EAAE,QAAQ,YAAY,EAAE,QAAQ,QAAQ;AAAA,QACpD;AAAA,MACF,KAAK;AACH,eAAO,aAAa;AAAA,UAAK,CAAC,GAAG,MAC3B,EAAE,iBAAiB,cAAc,GAAG,mBAAmB,EAAE,KAAK;AAAA,QAChE;AAAA,MACF,KAAK;AACH,eAAO,aAAa;AAAA,UAAK,CAAC,GAAG,MAC3B,EAAE,iBAAiB,cAAc,GAAG,mBAAmB,EAAE,KAAK;AAAA,QAChE;AAAA,MACF;AACE,eAAO,aAAa;AAAA,UAClB,CAAC,GAAG,MAAM,EAAE,QAAQ,YAAY,EAAE,QAAQ,QAAQ;AAAA,QACpD;AAAA,IAAA;AAAA,EACJ;AAEJ;"}

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

@@ -1,127 +1,249 @@
-import { StructuredTool } from "@langchain/core/tools";
-import { z } from "zod";
-import { Logger } from "@hashgraphonline/standards-sdk";
-class ListUnapprovedConnectionRequestsTool extends StructuredTool {
-  constructor({
-    hcsClient,
-    stateManager,
-    ...rest
-  }) {
-    super(rest);
-    this.name = "list_unapproved_connection_requests";
-    this.description = "Lists all connection requests that are not fully established, including incoming requests needing approval and outgoing requests waiting for confirmation.";
-    this.schema = z.object({
-      sortBy: z.enum(["time_asc", "time_desc", "name_asc", "name_desc"]).optional().describe(
-        "Optional sorting criteria for the requests list (default: time_desc, newest first)"
-      ),
-      limit: z.number().optional().describe(
-        "Optional limit on the number of requests to return (default: all)"
-      )
-    });
-    this.hcsClient = hcsClient;
-    this.stateManager = stateManager;
-    this.logger = Logger.getInstance({
-      module: "ListPendingRequestsTool",
-      level: "debug"
-    });
-  }
-  async _call({
-    sortBy = "time_desc",
-    limit
-  }) {
-    const currentAgent = this.stateManager.getCurrentAgent();
-    if (!currentAgent) {
-      return "Error: Cannot list pending requests. No agent is currently active. Please register or select an agent first.";
-    }
-    try {
-      const pendingRequests = await this.findAllPendingRequests();
-      return this.formatRequestsList(pendingRequests, sortBy, limit);
-    } catch (error) {
-      this.logger.error(`Error in ${this.name}: ${error}`);
-      return `Error listing pending requests: ${error instanceof Error ? error.message : String(error)}`;
-    }
-  }
-  /**
-   * Processes the connection connectionMap to find all requests
-   * that are not fully established (incoming unapproved and outgoing pending).
-   */
-  async findAllPendingRequests() {
-    const connectionsManager = this.stateManager.getConnectionsManager();
-    if (!connectionsManager) {
-      return [];
+import { updateEnvFile } from "./standards-agent-kit.es26.js";
+import { Logger, ConnectionsManager } from "@hashgraphonline/standards-sdk";
+class OpenConvaiState {
+  /**
+   * Creates a new OpenConvaiState instance
+   * @param options - Options for environment variable persistence
+   */
+  constructor(options) {
+    this.currentAgent = null;
+    this.connectionMessageTimestamps = {};
+    this.connectionsManager = null;
+    this.defaultEnvFilePath = options?.defaultEnvFilePath;
+    this.defaultPrefix = options?.defaultPrefix ?? "TODD";
+    const shouldSilence = options?.disableLogging || process.env.DISABLE_LOGGING === "true";
+    this.logger = new Logger({ module: "OpenConvaiState", silent: shouldSilence });
+    if (options?.baseClient) {
+      this.initializeConnectionsManager(options.baseClient);
+    }
+  }
+  /**
+   * Initializes the ConnectionsManager
+   * @param baseClient - HCS10BaseClient instance to use
+   */
+  initializeConnectionsManager(baseClient) {
+    if (!this.connectionsManager) {
+      this.logger.debug("Initializing ConnectionsManager");
+      this.connectionsManager = new ConnectionsManager({
+        baseClient,
+        logLevel: "error"
+      });
+    } else {
+      this.logger.debug("ConnectionsManager already initialized");
+    }
+    return this.connectionsManager;
+  }
+  /**
+   * Gets the ConnectionsManager instance
+   * @returns The ConnectionsManager instance, or null if not initialized
+   */
+  getConnectionsManager() {
+    return this.connectionsManager;
+  }
+  /**
+   * Sets the current active agent and clears any previous connection data.
+   * This should be called when switching between agents.
+   */
+  setCurrentAgent(agent) {
+    this.currentAgent = agent;
+    this.connectionMessageTimestamps = {};
+    if (this.connectionsManager) {
+      this.connectionsManager.clearAll();
+    }
+  }
+  /**
+   * Returns the currently active agent or null if none is set.
+   */
+  getCurrentAgent() {
+    return this.currentAgent;
+  }
+  /**
+   * Adds a new connection to the active connections list.
+   * Ensures no duplicates are added based on connectionTopicId.
+   * Initializes timestamp tracking for the connection.
+   */
+  addActiveConnection(connection) {
+    if (!this.connectionsManager) {
+      this.logger.error(
+        "ConnectionsManager not initialized. Call initializeConnectionsManager before adding connections."
+      );
+      throw new Error(
+        "ConnectionsManager not initialized. Call initializeConnectionsManager before adding connections."
+      );
     }
-    const currentAgent = this.stateManager.getCurrentAgent();
-    if (!currentAgent) {
+    const sdkConnection = {
+      connectionTopicId: connection.connectionTopicId,
+      targetAccountId: connection.targetAccountId,
+      targetAgentName: connection.targetAgentName,
+      targetInboundTopicId: connection.targetInboundTopicId,
+      status: this.convertConnectionStatus(connection.status || "established"),
+      isPending: connection.isPending || false,
+      needsConfirmation: connection.needsConfirmation || false,
+      created: connection.created || /* @__PURE__ */ new Date(),
+      lastActivity: connection.lastActivity,
+      profileInfo: connection.profileInfo,
+      connectionRequestId: connection.connectionRequestId,
+      processed: true
+    };
+    this.connectionsManager.updateOrAddConnection(sdkConnection);
+    this.initializeTimestampIfNeeded(connection.connectionTopicId);
+  }
+  /**
+   * Updates an existing connection or adds it if not found.
+   * Preserves existing properties when updating by merging objects.
+   */
+  updateOrAddConnection(connection) {
+    this.addActiveConnection(connection);
+  }
+  /**
+   * Returns a copy of all active connections.
+   */
+  listConnections() {
+    if (!this.connectionsManager) {
+      this.logger.debug(
+        "ConnectionsManager not initialized, returning empty connections list"
+      );
       return [];
     }
-    await connectionsManager.fetchConnectionData(currentAgent.accountId);
-    const pendingRequests = connectionsManager.getPendingRequests();
-    const connectionsNeedingConfirmation = connectionsManager.getConnectionsNeedingConfirmation();
-    return [...pendingRequests, ...connectionsNeedingConfirmation];
-  }
-  /**
-   * Formats the list of pending requests for display.
-   */
-  formatRequestsList(requests, sortBy, limit) {
-    if (requests.length === 0) {
-      return "No pending connection requests found (incoming or outgoing).";
-    }
-    const sortedRequests = this.sortRequests(requests, sortBy);
-    const limitedRequests = limit ? sortedRequests.slice(0, limit) : sortedRequests;
-    let output = `Found ${requests.length} pending connection request(s):
-
-`;
-    limitedRequests.forEach((request, index) => {
-      const statusIndicator = request.status === "needs_confirmation" ? "🟠 Incoming" : "⚪️ Outgoing";
-      output += `${index + 1}. ${statusIndicator} - ID: ${request.uniqueRequestKey}
-`;
-      output += `   ${request.status === "needs_confirmation" ? "From:" : "To:  "} ${request.targetAgentName} (${request.targetAccountId})
-`;
-      output += `   Sent/Rcvd: ${request.created.toLocaleString()}
-`;
-      if (request.memo) {
-        output += `   Memo: ${request.memo}
-`;
-      }
-      if (request.profileInfo?.bio) {
-        output += `   Bio: ${request.profileInfo.bio.substring(0, 100)}${request.profileInfo.bio.length > 100 ? "..." : ""}
-`;
-      }
-      output += "\n";
-    });
-    output += "Use related tools (manage_requests, accept_request) to handle these items.";
-    return output;
-  }
-  /**
-   * Sorts connection requests based on the specified criteria.
-   */
-  sortRequests(requests, sortBy) {
-    const requestsCopy = [...requests];
-    switch (sortBy) {
-      case "time_asc":
-        return requestsCopy.sort(
-          (a, b) => a.created.getTime() - b.created.getTime()
-        );
-      case "time_desc":
-        return requestsCopy.sort(
-          (a, b) => b.created.getTime() - a.created.getTime()
-        );
-      case "name_asc":
-        return requestsCopy.sort(
-          (a, b) => a.targetAgentName?.localeCompare(b?.targetAgentName || "") || 0
-        );
-      case "name_desc":
-        return requestsCopy.sort(
-          (a, b) => b.targetAgentName?.localeCompare(a?.targetAgentName || "") || 0
-        );
+    return this.connectionsManager.getAllConnections().map((conn) => this.convertToActiveConnection(conn));
+  }
+  /**
+   * Finds a connection by its identifier, which can be:
+   * - A 1-based index as displayed in the connection list
+   * - A target account ID string
+   * - A connection topic ID string
+   */
+  getConnectionByIdentifier(identifier) {
+    if (!this.connectionsManager) {
+      return void 0;
+    }
+    const connections = this.listConnections();
+    const numericIndex = parseInt(identifier) - 1;
+    if (!isNaN(numericIndex) && numericIndex >= 0 && numericIndex < connections.length) {
+      return connections[numericIndex];
+    }
+    const byTopicId = this.connectionsManager.getConnectionByTopicId(identifier);
+    if (byTopicId) {
+      return this.convertToActiveConnection(byTopicId);
+    }
+    const byAccountId = this.connectionsManager.getConnectionByAccountId(identifier);
+    if (byAccountId) {
+      return this.convertToActiveConnection(byAccountId);
+    }
+    return void 0;
+  }
+  /**
+   * Gets the last processed message timestamp for a connection.
+   * Returns 0 if no timestamp has been recorded.
+   */
+  getLastTimestamp(connectionTopicId) {
+    return this.connectionMessageTimestamps[connectionTopicId] || 0;
+  }
+  /**
+   * Updates the last processed message timestamp for a connection,
+   * but only if the new timestamp is more recent than the existing one.
+   */
+  updateTimestamp(connectionTopicId, timestampNanos) {
+    if (!(connectionTopicId in this.connectionMessageTimestamps)) {
+      this.connectionMessageTimestamps[connectionTopicId] = timestampNanos;
+      return;
+    }
+    const currentTimestamp = this.connectionMessageTimestamps[connectionTopicId];
+    if (timestampNanos > currentTimestamp) {
+      this.connectionMessageTimestamps[connectionTopicId] = timestampNanos;
+    }
+  }
+  /**
+   * Helper method to initialize timestamp tracking for a connection
+   * if it doesn't already exist.
+   */
+  initializeTimestampIfNeeded(connectionTopicId) {
+    if (!(connectionTopicId in this.connectionMessageTimestamps)) {
+      this.connectionMessageTimestamps[connectionTopicId] = Date.now() * 1e6;
+    }
+  }
+  /**
+   * Converts ConnectionStatus to SDK status format
+   */
+  convertConnectionStatus(status) {
+    switch (status) {
+      case "pending":
+        return "pending";
+      case "established":
+        return "established";
+      case "needs confirmation":
+        return "needs_confirmation";
+      default:
+        return "established";
+    }
+  }
+  /**
+   * Converts SDK Connection to ActiveConnection
+   */
+  convertToActiveConnection(conn) {
+    return {
+      targetAccountId: conn.targetAccountId,
+      targetAgentName: conn.targetAgentName || `Agent ${conn.targetAccountId}`,
+      targetInboundTopicId: conn.targetInboundTopicId || "",
+      connectionTopicId: conn.connectionTopicId,
+      status: this.convertToStateStatus(conn.status),
+      created: conn.created,
+      lastActivity: conn.lastActivity,
+      isPending: conn.isPending,
+      needsConfirmation: conn.needsConfirmation,
+      profileInfo: conn.profileInfo,
+      connectionRequestId: conn.connectionRequestId
+    };
+  }
+  /**
+   * Converts SDK status to state status format
+   */
+  convertToStateStatus(status) {
+    switch (status) {
+      case "pending":
+        return "pending";
+      case "established":
+        return "established";
+      case "needs_confirmation":
+        return "needs confirmation";
+      case "closed":
+        return "established";
+      // Mapping closed to established for compatibility
       default:
-        return requestsCopy.sort(
-          (a, b) => b.created.getTime() - a.created.getTime()
-        );
+        return "unknown";
+    }
+  }
+  /**
+   * Persists agent data to environment variables
+   * @param agent - The agent data to persist
+   * @param options - Environment file persistence options
+   */
+  async persistAgentData(agent, options) {
+    if (options?.type && options.type !== "env-file") {
+      throw new Error(
+        `Unsupported persistence type: ${options.type}. Only 'env-file' is supported.`
+      );
+    }
+    const envFilePath = options?.envFilePath || this.defaultEnvFilePath || process.env.ENV_FILE_PATH || ".env";
+    const prefix = options?.prefix || this.defaultPrefix;
+    if (!agent.accountId || !agent.inboundTopicId || !agent.outboundTopicId) {
+      throw new Error("Agent data incomplete, cannot persist to environment");
+    }
+    const updates = {
+      [`${prefix}_ACCOUNT_ID`]: agent.accountId,
+      [`${prefix}_INBOUND_TOPIC_ID`]: agent.inboundTopicId,
+      [`${prefix}_OUTBOUND_TOPIC_ID`]: agent.outboundTopicId
+    };
+    if (agent.privateKey) {
+      updates[`${prefix}_PRIVATE_KEY`] = agent.privateKey;
+    }
+    if (agent.profileTopicId) {
+      updates[`${prefix}_PROFILE_TOPIC_ID`] = agent.profileTopicId;
     }
+    await updateEnvFile(envFilePath, updates);
   }
 }
 export {
-  ListUnapprovedConnectionRequestsTool
+  OpenConvaiState
 };
 //# sourceMappingURL=standards-agent-kit.es16.js.map