@hashgraphonline/conversational-agent 0.2.216 → 0.2.218

package/dist/esm/index50.js

@@ -0,0 +1,75 @@
+import { BaseHederaQueryTool } from "hedera-agent-kit";
+import { z } from "zod";
+import { getResponseWithStructuredContent } from "./index62.js";
+import { GATEWAY_TAG_ERROR_MESSAGE } from "./index63.js";
+const QueryUploadProgressSchema = z.object({
+  tagId: z.string()
+});
+class QueryUploadProgressTool extends BaseHederaQueryTool {
+  constructor(params) {
+    const { bee, config, ...rest } = params;
+    super(rest);
+    this.name = "swarm-query-upload-progress";
+    this.description = `Query upload progress for a specific upload session identified with the returned Tag ID.
+    tagId: Tag ID returned by swarm-upload-file and swarm-upload-folder tools to track upload progress.
+  `;
+    this.namespace = "swarm";
+    this.specificInputSchema = QueryUploadProgressSchema;
+    this.bee = bee;
+    this.config = config;
+  }
+  async executeQuery(input) {
+    if (!input?.tagId) {
+      this.logger.error(
+        "Missing required parameter: tagId."
+      );
+      throw new Error("Missing required parameter: tagId.");
+    }
+    const tagUid = Number.parseInt(input.tagId, 10);
+    if (Number.isNaN(tagUid)) {
+      this.logger.error(
+        "Invalid tagId format. Expected a numeric string."
+      );
+      throw new Error("Invalid tagId format. Expected a numeric string.");
+    }
+    try {
+      const tag = await this.bee.retrieveTag(tagUid);
+      const synced = tag.synced ?? 0;
+      const seen = tag.seen ?? 0;
+      const processed = synced + seen;
+      const total = tag.split ?? 0;
+      const startedAt = tag.startedAt;
+      const processedPercentage = total > 0 ? Math.round(processed / total * 100) : 0;
+      const isComplete = processedPercentage === 100;
+      let tagDeleted = false;
+      if (isComplete) {
+        try {
+          await this.bee.deleteTag(tagUid);
+          tagDeleted = true;
+        } catch {
+        }
+      }
+      return getResponseWithStructuredContent({
+        processedPercentage,
+        message: isComplete ? "Upload completed successfully." : `Upload progress: ${processedPercentage}% processed`,
+        startedAt,
+        tagAddress: tag.address
+      });
+    } catch (error) {
+      let errorMessage = `Failed to retrieve upload progress: ${error?.message ?? "Unknown error"}`;
+      const status = error?.status ?? error?.response?.status;
+      if (status === 404) {
+        errorMessage = `Tag with ID ${input.tagId} does not exist or has been deleted. ` + GATEWAY_TAG_ERROR_MESSAGE;
+      }
+      this.logger.error(
+        errorMessage,
+        error
+      );
+      throw new Error(errorMessage);
+    }
+  }
+}
+export {
+  QueryUploadProgressTool
+};
+//# sourceMappingURL=index50.js.map

package/dist/esm/index50.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index50.js","sources":["../../src/plugins/community/swarm/tools/QueryUploadProgressTool.ts"],"sourcesContent":["import {\r\n  type GenericPluginContext,\r\n  BaseHederaQueryTool,\r\n  type HederaAgentKit,\r\n} from \"hedera-agent-kit\";\r\nimport { Bee } from \"@ethersphere/bee-js\";\r\nimport { z } from \"zod\";\r\nimport {\r\n  errorHasStatus,\r\n  getResponseWithStructuredContent,\r\n  ToolResponse,\r\n} from \"../utils\";\r\nimport { GATEWAY_TAG_ERROR_MESSAGE } from \"../constants\";\r\nimport { SwarmConfig } from \"../config\";\r\n\r\nconst QueryUploadProgressSchema = z.object({\r\n  tagId: z.string(),\r\n});\r\n\r\nexport class QueryUploadProgressTool extends BaseHederaQueryTool<typeof QueryUploadProgressSchema> {\r\n  name = \"swarm-query-upload-progress\";\r\n  description = `Query upload progress for a specific upload session identified with the returned Tag ID.\r\n    tagId: Tag ID returned by swarm-upload-file and swarm-upload-folder tools to track upload progress.\r\n  `;\r\n  namespace = \"swarm\";\r\n  specificInputSchema = QueryUploadProgressSchema;\r\n  bee: Bee;\r\n  config: SwarmConfig;\r\n    \r\n  constructor(params: {\r\n    hederaKit: HederaAgentKit;\r\n    config: SwarmConfig;\r\n    logger?: GenericPluginContext['logger'];\r\n    bee: Bee;\r\n  }) {\r\n    const { bee, config, ...rest } = params;\r\n    super(rest);\r\n    this.bee = bee;\r\n    this.config = config;\r\n  }\r\n\r\n  protected async executeQuery(\r\n      input: z.infer<typeof QueryUploadProgressSchema>\r\n  ): Promise<ToolResponse | string> {\r\n    if (!input?.tagId) {\r\n      this.logger.error(\r\n        'Missing required parameter: tagId.'\r\n      );\r\n\r\n      throw new Error('Missing required parameter: tagId.');\r\n    }\r\n\r\n    const tagUid = Number.parseInt(input.tagId, 10);\r\n    if (Number.isNaN(tagUid)) {\r\n      this.logger.error(\r\n        'Invalid tagId format. Expected a numeric string.'\r\n      );\r\n\r\n      throw new Error('Invalid tagId format. Expected a numeric string.');\r\n    }\r\n\r\n    try {\r\n      const tag = await this.bee.retrieveTag(tagUid);\r\n\r\n      const synced = tag.synced ?? 0;\r\n      const seen = tag.seen ?? 0;\r\n      const processed = synced + seen;\r\n      const total = tag.split ?? 0;\r\n      const startedAt = tag.startedAt;\r\n\r\n      const processedPercentage =\r\n        total > 0 ? Math.round((processed / total) * 100) : 0;\r\n      const isComplete = processedPercentage === 100;\r\n\r\n      let tagDeleted = false;\r\n      if (isComplete) {\r\n        try {\r\n          await this.bee.deleteTag(tagUid);\r\n          tagDeleted = true;\r\n        } catch {\r\n          // Non-fatal: if deletion fails we still return progress\r\n        }\r\n      }\r\n\r\n      return getResponseWithStructuredContent({\r\n        processedPercentage,\r\n        message: isComplete\r\n          ? \"Upload completed successfully.\"\r\n          : `Upload progress: ${processedPercentage}% processed`,\r\n        startedAt,\r\n        tagAddress: tag.address,\r\n      });\r\n    } catch (error: any) {\r\n      let errorMessage = `Failed to retrieve upload progress: ${error?.message ?? \"Unknown error\"}`;\r\n      \r\n      const status = error?.status ?? error?.response?.status;\r\n      if (status === 404) {\r\n        errorMessage = `Tag with ID ${input.tagId} does not exist or has been deleted. ` + GATEWAY_TAG_ERROR_MESSAGE;\r\n      }\r\n      \r\n      this.logger.error(\r\n        errorMessage,\r\n        error\r\n      );\r\n      \r\n      throw new Error(errorMessage);\r\n    }\r\n  }\r\n}\r\n"],"names":[],"mappings":";;;;AAeA,MAAM,4BAA4B,EAAE,OAAO;AAAA,EACzC,OAAO,EAAE,OAAA;AACX,CAAC;AAEM,MAAM,gCAAgC,oBAAsD;AAAA,EAUjG,YAAY,QAKT;AACD,UAAM,EAAE,KAAK,QAAQ,GAAG,SAAS;AACjC,UAAM,IAAI;AAhBZ,SAAA,OAAO;AACP,SAAA,cAAc;AAAA;AAAA;AAGd,SAAA,YAAY;AACZ,SAAA,sBAAsB;AAYpB,SAAK,MAAM;AACX,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,MAAgB,aACZ,OAC8B;AAChC,QAAI,CAAC,OAAO,OAAO;AACjB,WAAK,OAAO;AAAA,QACV;AAAA,MAAA;AAGF,YAAM,IAAI,MAAM,oCAAoC;AAAA,IACtD;AAEA,UAAM,SAAS,OAAO,SAAS,MAAM,OAAO,EAAE;AAC9C,QAAI,OAAO,MAAM,MAAM,GAAG;AACxB,WAAK,OAAO;AAAA,QACV;AAAA,MAAA;AAGF,YAAM,IAAI,MAAM,kDAAkD;AAAA,IACpE;AAEA,QAAI;AACF,YAAM,MAAM,MAAM,KAAK,IAAI,YAAY,MAAM;AAE7C,YAAM,SAAS,IAAI,UAAU;AAC7B,YAAM,OAAO,IAAI,QAAQ;AACzB,YAAM,YAAY,SAAS;AAC3B,YAAM,QAAQ,IAAI,SAAS;AAC3B,YAAM,YAAY,IAAI;AAEtB,YAAM,sBACJ,QAAQ,IAAI,KAAK,MAAO,YAAY,QAAS,GAAG,IAAI;AACtD,YAAM,aAAa,wBAAwB;AAE3C,UAAI,aAAa;AACjB,UAAI,YAAY;AACd,YAAI;AACF,gBAAM,KAAK,IAAI,UAAU,MAAM;AAC/B,uBAAa;AAAA,QACf,QAAQ;AAAA,QAER;AAAA,MACF;AAEA,aAAO,iCAAiC;AAAA,QACtC;AAAA,QACA,SAAS,aACL,mCACA,oBAAoB,mBAAmB;AAAA,QAC3C;AAAA,QACA,YAAY,IAAI;AAAA,MAAA,CACjB;AAAA,IACH,SAAS,OAAY;AACnB,UAAI,eAAe,uCAAuC,OAAO,WAAW,eAAe;AAE3F,YAAM,SAAS,OAAO,UAAU,OAAO,UAAU;AACjD,UAAI,WAAW,KAAK;AAClB,uBAAe,eAAe,MAAM,KAAK,0CAA0C;AAAA,MACrF;AAEA,WAAK,OAAO;AAAA,QACV;AAAA,QACA;AAAA,MAAA;AAGF,YAAM,IAAI,MAAM,YAAY;AAAA,IAC9B;AAAA,EACF;AACF;"}

package/dist/esm/index51.js

@@ -0,0 +1,124 @@
+import { MantarayNode } from "@ethersphere/bee-js";
+import { z } from "zod";
+import fs from "fs";
+import path from "path";
+import { BaseHederaQueryTool } from "hedera-agent-kit";
+import { promisify } from "util";
+const DownloadFilesSchema = z.object({
+  reference: z.string(),
+  filePath: z.string().optional()
+});
+class DownloadFilesTool extends BaseHederaQueryTool {
+  constructor(params) {
+    const { bee, config, ...rest } = params;
+    super(rest);
+    this.name = "swarm-download-files";
+    this.description = `Download folder, files from a Swarm reference and save to file path or return file list of the reference.
+    Prioritizes this tool over swarm-download-data if there is no assumption about the data type.
+    reference: Swarm reference hash.
+    filePath: Optional file path to save the downloaded content (only available in stdio mode). If not provided list of files in the manifest will be returned.
+  `;
+    this.namespace = "swarm";
+    this.specificInputSchema = DownloadFilesSchema;
+    this.bee = bee;
+    this.config = config;
+  }
+  async executeQuery(input) {
+    const { reference, filePath } = input;
+    if (!reference) {
+      this.logger.error(
+        "Missing required parameter: reference."
+      );
+      throw new Error("Missing required parameter: reference.");
+    }
+    this.logger.info(`[API] Downloading folder from Swarm with reference: ${reference}.`);
+    let isManifest = false;
+    let node;
+    try {
+      node = await MantarayNode.unmarshal(this.bee, reference);
+      await node.loadRecursively(this.bee);
+      isManifest = true;
+    } catch (error) {
+    }
+    if (isManifest) {
+      if (filePath) {
+        const destinationFolder = filePath;
+        if (!fs.existsSync(destinationFolder)) {
+          await promisify(fs.mkdir)(destinationFolder, { recursive: true });
+        }
+        const nodes = node.collect();
+        if (nodes.length === 1) {
+          const node2 = nodes[0];
+          const data = await this.bee.downloadData(node2.targetAddress);
+          await promisify(fs.writeFile)(
+            path.join(
+              destinationFolder,
+              node2.fullPathString.split("\\").slice(-1)[0]
+            ),
+            data.toUint8Array()
+          );
+        } else {
+          for (const node2 of nodes) {
+            const parsedPath = path.parse(node2.fullPathString);
+            const nodeDestFolder = path.join(destinationFolder, parsedPath.dir);
+            if (!fs.existsSync(nodeDestFolder)) {
+              await promisify(fs.mkdir)(nodeDestFolder, { recursive: true });
+            }
+            const data = await this.bee.downloadData(node2.targetAddress);
+            await promisify(fs.writeFile)(
+              path.join(destinationFolder, node2.fullPathString),
+              data.toUint8Array()
+            );
+          }
+        }
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                {
+                  reference,
+                  manifestNodeCount: nodes.length,
+                  savedTo: destinationFolder,
+                  message: `Manifest content (${nodes.length} files) successfully downloaded to ${destinationFolder}`
+                },
+                null,
+                2
+              )
+            }
+          ]
+        };
+      } else {
+        const nodes = node.collect();
+        const filesList = nodes.map((node2) => ({
+          path: node2.fullPathString || "/",
+          targetAddress: Array.from(node2.targetAddress).map((e) => e.toString(16).padStart(2, "0")).join(""),
+          metadata: node2.metadata
+        }));
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                {
+                  reference,
+                  type: "manifest",
+                  files: filesList,
+                  message: "This is a manifest with multiple files. Provide a filePath to download all files or download individual files using their specific references."
+                },
+                null,
+                2
+              )
+            }
+          ]
+        };
+      }
+    } else {
+      return "Try swarm-download-data tool instead since the given reference is not a manifest.";
+    }
+  }
+}
+export {
+  DownloadFilesTool
+};
+//# sourceMappingURL=index51.js.map

package/dist/esm/index51.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index51.js","sources":["../../src/plugins/community/swarm/tools/DownloadFilesTool.ts"],"sourcesContent":["import { Bee, MantarayNode } from \"@ethersphere/bee-js\";\r\nimport { z } from \"zod\";\r\nimport fs from \"fs\";\r\nimport path from \"path\";\r\nimport { BaseHederaQueryTool, GenericPluginContext, HederaAgentKit } from \"hedera-agent-kit\";\r\nimport { promisify } from \"util\";\r\nimport { ToolResponse } from \"../utils\";\r\nimport { SwarmConfig } from \"../config\";\r\n\r\nconst DownloadFilesSchema = z.object({\r\n  reference: z.string(),\r\n  filePath: z.string().optional()\r\n});\r\n\r\nexport class DownloadFilesTool extends BaseHederaQueryTool<typeof DownloadFilesSchema> {\r\n  name = \"swarm-download-files\";\r\n  description = `Download folder, files from a Swarm reference and save to file path or return file list of the reference.\r\n    Prioritizes this tool over swarm-download-data if there is no assumption about the data type.\r\n    reference: Swarm reference hash.\r\n    filePath: Optional file path to save the downloaded content (only available in stdio mode). If not provided list of files in the manifest will be returned.\r\n  `;\r\n  namespace = \"swarm\";\r\n  specificInputSchema = DownloadFilesSchema;\r\n  bee: Bee; \r\n  config: SwarmConfig;\r\n\r\n  constructor(params: {\r\n    hederaKit: HederaAgentKit;\r\n    config: SwarmConfig;\r\n    logger?: GenericPluginContext['logger'];\r\n    bee: Bee;\r\n  }) {\r\n    const { bee, config, ...rest } = params;\r\n    super(rest);\r\n    this.bee = bee;\r\n    this.config = config;\r\n  }\r\n\r\n  protected async executeQuery(\r\n      input: z.infer<typeof DownloadFilesSchema>\r\n  ): Promise<ToolResponse | string> {\r\n    const { reference, filePath } = input;\r\n    \r\n    if (!reference) {\r\n      this.logger.error(\r\n        'Missing required parameter: reference.'\r\n      );\r\n      \r\n      throw new Error(\"Missing required parameter: reference.\");\r\n    }\r\n\r\n    this.logger.info(`[API] Downloading folder from Swarm with reference: ${reference}.`);\r\n\r\n    // Check if the reference is a manifest\r\n    let isManifest = false;\r\n    let node: MantarayNode;\r\n\r\n    try {\r\n      node = await MantarayNode.unmarshal(this.bee, reference);\r\n      await node.loadRecursively(this.bee);\r\n      isManifest = true;\r\n    } catch (error) {\r\n      // ignore\r\n    }\r\n\r\n    if (isManifest) {\r\n      if (filePath) {\r\n        const destinationFolder = filePath;\r\n\r\n        if (!fs.existsSync(destinationFolder)) {\r\n          await promisify(fs.mkdir)(destinationFolder, { recursive: true });\r\n        }\r\n\r\n        const nodes = node!.collect();\r\n\r\n        if (nodes.length === 1) {\r\n          const node = nodes[0];\r\n          const data = await this.bee.downloadData(node.targetAddress);\r\n          await promisify(fs.writeFile)(\r\n            path.join(\r\n              destinationFolder,\r\n              node.fullPathString.split(\"\\\\\").slice(-1)[0]\r\n            ),\r\n            data.toUint8Array()\r\n          );\r\n        } else {\r\n          // Download each node\r\n          for (const node of nodes) {\r\n            const parsedPath = path.parse(node.fullPathString);\r\n            const nodeDestFolder = path.join(destinationFolder, parsedPath.dir);\r\n            // Create subdirectories if necessary\r\n            if (!fs.existsSync(nodeDestFolder)) {\r\n              await promisify(fs.mkdir)(nodeDestFolder, { recursive: true });\r\n            }\r\n\r\n            const data = await this.bee.downloadData(node.targetAddress);\r\n            await promisify(fs.writeFile)(\r\n              path.join(destinationFolder, node.fullPathString),\r\n              data.toUint8Array()\r\n            );\r\n          }\r\n        }\r\n\r\n        return {\r\n          content: [\r\n            {\r\n              type: \"text\",\r\n              text: JSON.stringify(\r\n                {\r\n                  reference: reference,\r\n                  manifestNodeCount: nodes.length,\r\n                  savedTo: destinationFolder,\r\n                  message: `Manifest content (${nodes.length} files) successfully downloaded to ${destinationFolder}`,\r\n                },\r\n                null,\r\n                2\r\n              ),\r\n            },\r\n          ],\r\n        };\r\n      } else {\r\n        // regular file\r\n        const nodes = node!.collect();\r\n        const filesList = nodes.map((node) => ({\r\n          path: node.fullPathString || \"/\",\r\n          targetAddress: Array.from(node.targetAddress)\r\n            .map((e) => e.toString(16).padStart(2, \"0\"))\r\n            .join(\"\"),\r\n          metadata: node.metadata,\r\n        }));\r\n\r\n        return {\r\n          content: [\r\n            {\r\n              type: \"text\",\r\n              text: JSON.stringify(\r\n                {\r\n                  reference: reference,\r\n                  type: \"manifest\",\r\n                  files: filesList,\r\n                  message:\r\n                    \"This is a manifest with multiple files. Provide a filePath to download all files or download individual files using their specific references.\",\r\n                },\r\n                null,\r\n                2\r\n              ),\r\n            },\r\n          ],\r\n        };\r\n      }\r\n    } else {\r\n      return \"Try swarm-download-data tool instead since the given reference is not a manifest.\";\r\n    }\r\n  }\r\n}\r\n"],"names":["node"],"mappings":"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"}

package/dist/esm/index52.js

@@ -0,0 +1,58 @@
+import { BaseHederaQueryTool } from "hedera-agent-kit";
+import { z } from "zod";
+import { errorHasStatus, getBatchSummary, getResponseWithStructuredContent } from "./index62.js";
+import { NOT_FOUND_STATUS, GATEWAY_STAMP_ERROR_MESSAGE } from "./index63.js";
+const GetPostageStampSchema = z.object({
+  postageBatchId: z.string()
+});
+class GetPostageStampTool extends BaseHederaQueryTool {
+  constructor(params) {
+    const { bee, config, ...rest } = params;
+    super(rest);
+    this.name = "swarm-get-postage-stamp";
+    this.description = `Get a specific postage stamp based on postageBatchId.
+    postageBatchId: The id of the stamp which is requested.
+  `;
+    this.namespace = "swarm";
+    this.specificInputSchema = GetPostageStampSchema;
+    this.bee = bee;
+    this.config = config;
+  }
+  async executeQuery(input) {
+    const { postageBatchId } = input;
+    if (!postageBatchId) {
+      this.logger.error(
+        "Missing required parameter: postageBatchId."
+      );
+      throw new Error("Missing required parameter: postageBatchId.");
+    }
+    let rawPostageBatch;
+    try {
+      rawPostageBatch = await this.bee.getPostageBatch(postageBatchId);
+    } catch (error) {
+      let errorMessage = "Retrieval of postage batch failed.";
+      if (errorHasStatus(error, NOT_FOUND_STATUS)) {
+        errorMessage = GATEWAY_STAMP_ERROR_MESSAGE;
+      }
+      this.logger.error(
+        errorMessage,
+        error
+      );
+      throw new Error(errorMessage);
+    }
+    const batch = {
+      ...rawPostageBatch,
+      batchID: rawPostageBatch.batchID.toHex()
+    };
+    const batchSummary = getBatchSummary(rawPostageBatch);
+    const content = {
+      raw: batch,
+      summary: batchSummary
+    };
+    return getResponseWithStructuredContent(content);
+  }
+}
+export {
+  GetPostageStampTool
+};
+//# sourceMappingURL=index52.js.map

package/dist/esm/index52.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index52.js","sources":["../../src/plugins/community/swarm/tools/GetPostageStampTool.ts"],"sourcesContent":["import {\r\n  type GenericPluginContext,\r\n  BaseHederaQueryTool,\r\n  type HederaAgentKit,\r\n} from \"hedera-agent-kit\";\r\nimport { Bee } from \"@ethersphere/bee-js\";\r\nimport { z } from \"zod\";\r\nimport {\r\n  PostageBatchCurated,\r\n  PostageBatchSummary,\r\n  ResponseContent,\r\n} from \"../model\";\r\nimport {\r\n  errorHasStatus,\r\n  getBatchSummary,\r\n  getResponseWithStructuredContent,\r\n  ToolResponse,\r\n} from \"../utils\";\r\nimport { GATEWAY_STAMP_ERROR_MESSAGE, NOT_FOUND_STATUS } from \"../constants\";\r\nimport { SwarmConfig } from \"../config\";\r\n\r\nconst GetPostageStampSchema = z.object({\r\n  postageBatchId: z.string(),\r\n});\r\n\r\nexport class GetPostageStampTool extends BaseHederaQueryTool<typeof GetPostageStampSchema> {\r\n  name = \"swarm-get-postage-stamp\";\r\n  description = `Get a specific postage stamp based on postageBatchId.\r\n    postageBatchId: The id of the stamp which is requested.\r\n  `;\r\n  namespace = \"swarm\";\r\n  specificInputSchema = GetPostageStampSchema;\r\n  bee: Bee;\r\n  config: SwarmConfig;\r\n      \r\n  constructor(params: {\r\n    hederaKit: HederaAgentKit;\r\n    config: SwarmConfig;\r\n    logger?: GenericPluginContext['logger'];\r\n    bee: Bee;\r\n  }) {\r\n    const { bee, config, ...rest } = params;\r\n    super(rest);\r\n    this.bee = bee;\r\n    this.config = config;\r\n  }\r\n\r\n  protected async executeQuery(\r\n      input: z.infer<typeof GetPostageStampSchema>\r\n  ): Promise<ToolResponse | string> {\r\n    const { postageBatchId } = input;\r\n    if (!postageBatchId) {\r\n      this.logger.error(\r\n        'Missing required parameter: postageBatchId.'\r\n      );\r\n\r\n      throw new Error(\"Missing required parameter: postageBatchId.\");\r\n    }\r\n\r\n    let rawPostageBatch;\r\n\r\n    try {\r\n      rawPostageBatch = await this.bee.getPostageBatch(postageBatchId);\r\n    } catch (error) {\r\n      let errorMessage = 'Retrieval of postage batch failed.';\r\n    \r\n      if (errorHasStatus(error, NOT_FOUND_STATUS)) {\r\n        errorMessage = GATEWAY_STAMP_ERROR_MESSAGE;\r\n      }\r\n\r\n      this.logger.error(\r\n        errorMessage,\r\n        error\r\n      );\r\n\r\n      throw new Error(errorMessage);\r\n    }\r\n\r\n    const batch: PostageBatchCurated = {\r\n      ...rawPostageBatch,\r\n      batchID: rawPostageBatch.batchID.toHex(),\r\n    };\r\n    const batchSummary: PostageBatchSummary = getBatchSummary(rawPostageBatch);\r\n\r\n    const content: ResponseContent<PostageBatchCurated, PostageBatchSummary> = {\r\n      raw: batch,\r\n      summary: batchSummary,\r\n    };\r\n\r\n    return getResponseWithStructuredContent(content);\r\n  }\r\n}\r\n"],"names":[],"mappings":";;;;AAqBA,MAAM,wBAAwB,EAAE,OAAO;AAAA,EACrC,gBAAgB,EAAE,OAAA;AACpB,CAAC;AAEM,MAAM,4BAA4B,oBAAkD;AAAA,EAUzF,YAAY,QAKT;AACD,UAAM,EAAE,KAAK,QAAQ,GAAG,SAAS;AACjC,UAAM,IAAI;AAhBZ,SAAA,OAAO;AACP,SAAA,cAAc;AAAA;AAAA;AAGd,SAAA,YAAY;AACZ,SAAA,sBAAsB;AAYpB,SAAK,MAAM;AACX,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,MAAgB,aACZ,OAC8B;AAChC,UAAM,EAAE,mBAAmB;AAC3B,QAAI,CAAC,gBAAgB;AACnB,WAAK,OAAO;AAAA,QACV;AAAA,MAAA;AAGF,YAAM,IAAI,MAAM,6CAA6C;AAAA,IAC/D;AAEA,QAAI;AAEJ,QAAI;AACF,wBAAkB,MAAM,KAAK,IAAI,gBAAgB,cAAc;AAAA,IACjE,SAAS,OAAO;AACd,UAAI,eAAe;AAEnB,UAAI,eAAe,OAAO,gBAAgB,GAAG;AAC3C,uBAAe;AAAA,MACjB;AAEA,WAAK,OAAO;AAAA,QACV;AAAA,QACA;AAAA,MAAA;AAGF,YAAM,IAAI,MAAM,YAAY;AAAA,IAC9B;AAEA,UAAM,QAA6B;AAAA,MACjC,GAAG;AAAA,MACH,SAAS,gBAAgB,QAAQ,MAAA;AAAA,IAAM;AAEzC,UAAM,eAAoC,gBAAgB,eAAe;AAEzE,UAAM,UAAqE;AAAA,MACzE,KAAK;AAAA,MACL,SAAS;AAAA,IAAA;AAGX,WAAO,iCAAiC,OAAO;AAAA,EACjD;AACF;"}

package/dist/esm/index53.js

@@ -0,0 +1,83 @@
+import { Wallet } from "@ethereumjs/wallet";
+import { z } from "zod";
+import crypto from "crypto";
+import { hexToBytes, errorHasStatus, getErrorMessage, getResponseWithStructuredContent } from "./index62.js";
+import { BaseHederaQueryTool } from "hedera-agent-kit";
+import { BAD_REQUEST_STATUS } from "./index63.js";
+const ReadFeedSchema = z.object({
+  memoryTopic: z.string(),
+  owner: z.string().optional()
+});
+class ReadFeedTool extends BaseHederaQueryTool {
+  constructor(params) {
+    const { bee, config, ...rest } = params;
+    super(rest);
+    this.name = "swarm-read-feed";
+    this.description = `Retrieve the latest data from the feed of a given topic.
+    memoryTopic: Feed topic.
+    owner: When accessing external memory or feed, ethereum address of the owner must be set.
+  `;
+    this.namespace = "swarm";
+    this.specificInputSchema = ReadFeedSchema;
+    this.bee = bee;
+    this.config = config;
+  }
+  async executeQuery(input) {
+    const { memoryTopic, owner } = input;
+    if (!memoryTopic) {
+      this.logger.error(
+        "Missing required parameter: memoryTopic."
+      );
+      throw new Error("Missing required parameter: memoryTopic.");
+    }
+    this.logger.info(`[API] Downloading text from Swarm feed with topic: ${memoryTopic}.`);
+    if (!this.config.beeFeedPK) {
+      this.logger.error("Feed private key not configured.");
+      throw new Error("Feed private key not configured.");
+    }
+    let topic = memoryTopic;
+    if (topic.startsWith("0x")) {
+      topic = topic.slice(2);
+    }
+    const isHexString = /^[0-9a-fA-F]{64}$/.test(topic);
+    if (!isHexString) {
+      const hash = crypto.createHash("sha256").update(memoryTopic).digest("hex");
+      topic = hash;
+    }
+    const topicBytes = hexToBytes(topic);
+    let feedOwner = owner;
+    if (!feedOwner) {
+      const feedPrivateKey = hexToBytes(this.config.beeFeedPK);
+      const signer = new Wallet(feedPrivateKey);
+      feedOwner = signer.getAddressString().slice(2);
+    } else {
+      if (feedOwner.startsWith("0x")) {
+        feedOwner = feedOwner.slice(2);
+      }
+      if (feedOwner.length !== 40) {
+        this.logger.error("Owner must be a valid Ethereum address.");
+        throw new Error("Owner must be a valid Ethereum address.");
+      }
+    }
+    let textData;
+    try {
+      const feedReader = this.bee.makeFeedReader(topicBytes, feedOwner);
+      const latestUpdate = await feedReader.downloadPayload();
+      textData = latestUpdate.payload.toUtf8();
+    } catch (error) {
+      let errorMessage = "Reading feed failed.";
+      if (errorHasStatus(error, BAD_REQUEST_STATUS)) {
+        errorMessage = getErrorMessage(error);
+      }
+      this.logger.error(errorMessage, error);
+      throw new Error(errorMessage);
+    }
+    return getResponseWithStructuredContent({
+      textData
+    });
+  }
+}
+export {
+  ReadFeedTool
+};
+//# sourceMappingURL=index53.js.map

package/dist/esm/index53.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index53.js","sources":["../../src/plugins/community/swarm/tools/ReadFeedTool.ts"],"sourcesContent":["import { Bee } from \"@ethersphere/bee-js\";\r\nimport { Wallet } from \"@ethereumjs/wallet\";\r\nimport { z } from \"zod\";\r\nimport crypto from \"crypto\";\r\nimport { errorHasStatus, getErrorMessage, getResponseWithStructuredContent, hexToBytes, ToolResponse } from \"../utils\";\r\nimport { BaseHederaQueryTool, GenericPluginContext, HederaAgentKit } from \"hedera-agent-kit\";\r\nimport { SwarmConfig } from \"../config\";\r\nimport { BAD_REQUEST_STATUS } from \"../constants\";\r\n\r\nconst ReadFeedSchema = z.object({\r\n  memoryTopic: z.string(),\r\n  owner: z.string().optional()\r\n});\r\n\r\nexport class ReadFeedTool extends BaseHederaQueryTool<typeof ReadFeedSchema> {\r\n  name = \"swarm-read-feed\";\r\n  description = `Retrieve the latest data from the feed of a given topic.\r\n    memoryTopic: Feed topic.\r\n    owner: When accessing external memory or feed, ethereum address of the owner must be set.\r\n  `;\r\n  namespace = \"swarm\";\r\n  specificInputSchema = ReadFeedSchema;\r\n  bee: Bee;\r\n  config: SwarmConfig;\r\n      \r\n  constructor(params: {\r\n    hederaKit: HederaAgentKit;\r\n    config: SwarmConfig;\r\n    logger?: GenericPluginContext['logger'];\r\n    bee: Bee;\r\n  }) {\r\n    const { bee, config, ...rest } = params;\r\n    super(rest);\r\n    this.bee = bee;\r\n    this.config = config;\r\n  }\r\n\r\n  protected async executeQuery(\r\n      input: z.infer<typeof ReadFeedSchema>\r\n  ): Promise<ToolResponse | string> {\r\n   const { memoryTopic, owner } = input;\r\n\r\n    if (!memoryTopic) {\r\n      this.logger.error(\r\n        'Missing required parameter: memoryTopic.'\r\n      );\r\n\r\n      throw new Error('Missing required parameter: memoryTopic.');\r\n    }\r\n\r\n    this.logger.info(`[API] Downloading text from Swarm feed with topic: ${memoryTopic}.`);\r\n\r\n    if (!this.config.beeFeedPK) {\r\n      this.logger.error('Feed private key not configured.');\r\n\r\n      throw new Error('Feed private key not configured.');\r\n    }\r\n\r\n    // Process topic - if not a hex string, hash it\r\n    let topic = memoryTopic;\r\n    if (topic.startsWith(\"0x\")) {\r\n      topic = topic.slice(2);\r\n    }\r\n    const isHexString = /^[0-9a-fA-F]{64}$/.test(topic);\r\n\r\n    if (!isHexString) {\r\n      // Hash the topic string using SHA-256\r\n      const hash = crypto.createHash(\"sha256\").update(memoryTopic).digest(\"hex\");\r\n      topic = hash;\r\n    }\r\n\r\n    // Convert topic string to bytes\r\n    const topicBytes = hexToBytes(topic);\r\n\r\n    let feedOwner = owner;\r\n    if (!feedOwner) {\r\n      const feedPrivateKey = hexToBytes(this.config.beeFeedPK);\r\n      const signer = new Wallet(feedPrivateKey);\r\n      feedOwner = signer.getAddressString().slice(2);\r\n    } else {\r\n      if (feedOwner.startsWith(\"0x\")) {\r\n        feedOwner = feedOwner.slice(2);\r\n      }\r\n      if (feedOwner.length !== 40) {\r\n        this.logger.error('Owner must be a valid Ethereum address.');\r\n\r\n        throw new Error('Owner must be a valid Ethereum address.');\r\n      }\r\n    }\r\n\r\n    let textData;\r\n    \r\n    try {\r\n      const feedReader = this.bee.makeFeedReader(topicBytes, feedOwner);\r\n      const latestUpdate = await feedReader.downloadPayload();\r\n      textData = latestUpdate.payload.toUtf8();\r\n    } catch (error) {\r\n      let errorMessage = 'Reading feed failed.';\r\n      if (errorHasStatus(error, BAD_REQUEST_STATUS)) {\r\n        errorMessage = getErrorMessage(error);\r\n      }\r\n      this.logger.error(errorMessage, error);\r\n      throw new Error(errorMessage);\r\n    }\r\n    \r\n    return getResponseWithStructuredContent({\r\n      textData,\r\n    });\r\n  }\r\n}\r\n"],"names":[],"mappings":";;;;;;AASA,MAAM,iBAAiB,EAAE,OAAO;AAAA,EAC9B,aAAa,EAAE,OAAA;AAAA,EACf,OAAO,EAAE,OAAA,EAAS,SAAA;AACpB,CAAC;AAEM,MAAM,qBAAqB,oBAA2C;AAAA,EAW3E,YAAY,QAKT;AACD,UAAM,EAAE,KAAK,QAAQ,GAAG,SAAS;AACjC,UAAM,IAAI;AAjBZ,SAAA,OAAO;AACP,SAAA,cAAc;AAAA;AAAA;AAAA;AAId,SAAA,YAAY;AACZ,SAAA,sBAAsB;AAYpB,SAAK,MAAM;AACX,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,MAAgB,aACZ,OAC8B;AACjC,UAAM,EAAE,aAAa,MAAA,IAAU;AAE9B,QAAI,CAAC,aAAa;AAChB,WAAK,OAAO;AAAA,QACV;AAAA,MAAA;AAGF,YAAM,IAAI,MAAM,0CAA0C;AAAA,IAC5D;AAEA,SAAK,OAAO,KAAK,sDAAsD,WAAW,GAAG;AAErF,QAAI,CAAC,KAAK,OAAO,WAAW;AAC1B,WAAK,OAAO,MAAM,kCAAkC;AAEpD,YAAM,IAAI,MAAM,kCAAkC;AAAA,IACpD;AAGA,QAAI,QAAQ;AACZ,QAAI,MAAM,WAAW,IAAI,GAAG;AAC1B,cAAQ,MAAM,MAAM,CAAC;AAAA,IACvB;AACA,UAAM,cAAc,oBAAoB,KAAK,KAAK;AAElD,QAAI,CAAC,aAAa;AAEhB,YAAM,OAAO,OAAO,WAAW,QAAQ,EAAE,OAAO,WAAW,EAAE,OAAO,KAAK;AACzE,cAAQ;AAAA,IACV;AAGA,UAAM,aAAa,WAAW,KAAK;AAEnC,QAAI,YAAY;AAChB,QAAI,CAAC,WAAW;AACd,YAAM,iBAAiB,WAAW,KAAK,OAAO,SAAS;AACvD,YAAM,SAAS,IAAI,OAAO,cAAc;AACxC,kBAAY,OAAO,mBAAmB,MAAM,CAAC;AAAA,IAC/C,OAAO;AACL,UAAI,UAAU,WAAW,IAAI,GAAG;AAC9B,oBAAY,UAAU,MAAM,CAAC;AAAA,MAC/B;AACA,UAAI,UAAU,WAAW,IAAI;AAC3B,aAAK,OAAO,MAAM,yCAAyC;AAE3D,cAAM,IAAI,MAAM,yCAAyC;AAAA,MAC3D;AAAA,IACF;AAEA,QAAI;AAEJ,QAAI;AACF,YAAM,aAAa,KAAK,IAAI,eAAe,YAAY,SAAS;AAChE,YAAM,eAAe,MAAM,WAAW,gBAAA;AACtC,iBAAW,aAAa,QAAQ,OAAA;AAAA,IAClC,SAAS,OAAO;AACd,UAAI,eAAe;AACnB,UAAI,eAAe,OAAO,kBAAkB,GAAG;AAC7C,uBAAe,gBAAgB,KAAK;AAAA,MACtC;AACA,WAAK,OAAO,MAAM,cAAc,KAAK;AACrC,YAAM,IAAI,MAAM,YAAY;AAAA,IAC9B;AAEA,WAAO,iCAAiC;AAAA,MACtC;AAAA,IAAA,CACD;AAAA,EACH;AACF;"}

package/dist/esm/index54.js

@@ -0,0 +1,100 @@
+import { BaseHederaQueryTool } from "hedera-agent-kit";
+import { z } from "zod";
+import crypto from "crypto";
+import { getUploadPostageBatchId, hexToBytes, errorHasStatus, getErrorMessage, getResponseWithStructuredContent } from "./index62.js";
+import { BAD_REQUEST_STATUS } from "./index63.js";
+import { Wallet } from "@ethereumjs/wallet";
+const UpdateFeedSchema = z.object({
+  data: z.string(),
+  memoryTopic: z.string(),
+  postageBatchId: z.string().optional()
+});
+class UpdateFeedTool extends BaseHederaQueryTool {
+  constructor(params) {
+    const { bee, config, ...rest } = params;
+    super(rest);
+    this.name = "swarm-update-feed";
+    this.description = `Update the feed of a given topic with new data.
+    data: Arbitrary string to upload.
+    memoryTopic: If provided, uploads the data to a feed with this topic. It is the label of the memory that can be used later to retrieve the data instead of its content hash. If not a hex string, it will be hashed to create a feed topic.
+    postageBatchId: The postage stamp batch ID which will be used to perform the upload, if it is provided.`;
+    this.namespace = "swarm";
+    this.specificInputSchema = UpdateFeedSchema;
+    this.bee = bee;
+    this.config = config;
+  }
+  async executeQuery(input) {
+    const { data, memoryTopic, postageBatchId: inputPostageBatchId } = input;
+    if (!data) {
+      this.logger.error(
+        "Missing required parameter: data."
+      );
+      throw new Error("Missing required parameter: data.");
+    } else if (!memoryTopic) {
+      this.logger.error(
+        "Missing required parameter: topic."
+      );
+      throw new Error("Missing required parameter: topic.");
+    }
+    let postageBatchId = "";
+    try {
+      postageBatchId = await getUploadPostageBatchId(
+        inputPostageBatchId,
+        this.bee,
+        this.config
+      );
+    } catch (error) {
+      let errorMessage = "Update feed failed.";
+      if (error instanceof Error) {
+        errorMessage = error.message;
+      }
+      this.logger.error(errorMessage);
+      throw new Error(errorMessage);
+    }
+    const binaryData = Buffer.from(data);
+    if (!this.config.beeFeedPK) {
+      this.logger.error("Feed private key not configured.");
+      throw new Error("Feed private key not configured.");
+    }
+    let topic = memoryTopic;
+    if (topic.startsWith("0x")) {
+      topic = topic.slice(2);
+    }
+    const isHexString = /^[0-9a-fA-F]{64}$/.test(memoryTopic);
+    if (!isHexString) {
+      const hash = crypto.createHash("sha256").update(memoryTopic).digest("hex");
+      topic = hash;
+    }
+    const topicBytes = hexToBytes(topic);
+    const feedPrivateKey = hexToBytes(this.config.beeFeedPK);
+    const signer = new Wallet(feedPrivateKey);
+    const owner = signer.getAddressString().slice(2);
+    let result;
+    try {
+      const feedWriter = this.bee.makeFeedWriter(topicBytes, feedPrivateKey);
+      result = await feedWriter.uploadPayload(postageBatchId, binaryData);
+    } catch (error) {
+      let errorMessage = "Unable to update feed.";
+      if (errorHasStatus(error, BAD_REQUEST_STATUS)) {
+        errorMessage = getErrorMessage(error);
+      }
+      this.logger.error(
+        errorMessage,
+        error
+      );
+      throw new Error(errorMessage);
+    }
+    const reference = result.reference.toString();
+    return getResponseWithStructuredContent({
+      reference,
+      topicString: memoryTopic,
+      topic,
+      feedUrl: `${this.bee.url}/feeds/${owner}/${topic}`,
+      message: "Data successfully uploaded to Swarm and linked to feed."
+    });
+  }
+}
+export {
+  UpdateFeedTool
+};
+//# sourceMappingURL=index54.js.map

package/dist/esm/index54.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index54.js","sources":["../../src/plugins/community/swarm/tools/UpdateFeedTool.ts"],"sourcesContent":["import {\r\n  BaseHederaQueryTool,\r\n  HederaAgentKit,\r\n  type GenericPluginContext,\r\n} from \"hedera-agent-kit\";\r\nimport { Bee } from \"@ethersphere/bee-js\";\r\nimport { z } from \"zod\";\r\nimport crypto from \"crypto\";\r\nimport {\r\n  errorHasStatus,\r\n  getErrorMessage,\r\n  getResponseWithStructuredContent,\r\n  getUploadPostageBatchId,\r\n  hexToBytes,\r\n  ToolResponse,\r\n} from \"../utils\";\r\nimport { BAD_REQUEST_STATUS } from \"../constants\";\r\nimport { Wallet } from \"@ethereumjs/wallet\";\r\nimport { SwarmConfig } from \"../config\";\r\n\r\nconst UpdateFeedSchema = z.object({\r\n  data: z.string(),\r\n  memoryTopic: z.string(),\r\n  postageBatchId: z.string().optional(),\r\n});\r\n\r\nexport class UpdateFeedTool extends BaseHederaQueryTool<typeof UpdateFeedSchema> {\r\n  name = \"swarm-update-feed\";\r\n  description = `Update the feed of a given topic with new data.\r\n    data: Arbitrary string to upload.\r\n    memoryTopic: If provided, uploads the data to a feed with this topic. It is the label of the memory that can be used later to retrieve the data instead of its content hash. If not a hex string, it will be hashed to create a feed topic.\r\n    postageBatchId: The postage stamp batch ID which will be used to perform the upload, if it is provided.`;\r\n  namespace = \"swarm\";\r\n  specificInputSchema = UpdateFeedSchema;\r\n  bee: Bee;\r\n  config: SwarmConfig;\r\n        \r\n  constructor(params: {\r\n    hederaKit: HederaAgentKit;\r\n    config: SwarmConfig;\r\n    logger?: GenericPluginContext['logger'];\r\n    bee: Bee;\r\n  }) {\r\n    const { bee, config, ...rest } = params;\r\n    super(rest);\r\n    this.bee = bee;\r\n    this.config = config;\r\n  }\r\n  \r\n  protected async executeQuery(\r\n      input: z.infer<typeof UpdateFeedSchema>\r\n  ): Promise<ToolResponse | string> {\r\n    const { data, memoryTopic, postageBatchId: inputPostageBatchId  } = input;\r\n     if (!data) {\r\n      this.logger.error(\r\n        'Missing required parameter: data.'\r\n      );\r\n\r\n      throw new Error('Missing required parameter: data.');\r\n    } else if (!memoryTopic) {\r\n      this.logger.error(\r\n        'Missing required parameter: topic.'\r\n      );\r\n\r\n      throw new Error('Missing required parameter: topic.');\r\n    }\r\n    \r\n    let postageBatchId = \"\";\r\n\r\n    try {\r\n      postageBatchId = await getUploadPostageBatchId(\r\n        inputPostageBatchId,\r\n        this.bee,\r\n        this.config,\r\n      );\r\n    } catch (error) {\r\n      let errorMessage = 'Update feed failed.';\r\n      if (error instanceof Error) {\r\n        errorMessage = error.message;\r\n      }\r\n      this.logger.error(errorMessage);\r\n\r\n      throw new Error(errorMessage);\r\n    }\r\n\r\n    const binaryData = Buffer.from(data);\r\n\r\n    // Feed upload if memoryTopic is specified\r\n    if (!this.config.beeFeedPK) {\r\n      this.logger.error('Feed private key not configured.');\r\n\r\n      throw new Error('Feed private key not configured.');\r\n    }\r\n\r\n    // Process topic - if not a hex string, hash it\r\n    let topic = memoryTopic;\r\n    if (topic.startsWith(\"0x\")) {\r\n      topic = topic.slice(2);\r\n    }\r\n    const isHexString = /^[0-9a-fA-F]{64}$/.test(memoryTopic);\r\n\r\n    if (!isHexString) {\r\n      // Hash the topic string using SHA-256\r\n      const hash = crypto\r\n        .createHash(\"sha256\")\r\n        .update(memoryTopic)\r\n        .digest(\"hex\");\r\n      topic = hash;\r\n    }\r\n\r\n    // Convert topic string to bytes\r\n    const topicBytes = hexToBytes(topic);\r\n\r\n    const feedPrivateKey = hexToBytes(this.config.beeFeedPK);\r\n    const signer = new Wallet(feedPrivateKey);\r\n    const owner = signer.getAddressString().slice(2);\r\n\r\n    let result;\r\n\r\n    try {\r\n      const feedWriter = this.bee.makeFeedWriter(topicBytes, feedPrivateKey);\r\n\r\n      result = await feedWriter.uploadPayload(postageBatchId!, binaryData);\r\n    } catch (error) {\r\n      let errorMessage = 'Unable to update feed.';\r\n\r\n      if (errorHasStatus(error, BAD_REQUEST_STATUS)) {\r\n        errorMessage = getErrorMessage(error);\r\n      }\r\n\r\n      this.logger.error(\r\n        errorMessage,\r\n        error\r\n      );\r\n      \r\n      throw new Error(errorMessage);\r\n    }\r\n\r\n    const reference = result.reference.toString();\r\n\r\n    return getResponseWithStructuredContent({\r\n      reference,\r\n      topicString: memoryTopic,\r\n      topic: topic,\r\n      feedUrl: `${this.bee.url}/feeds/${owner}/${topic}`,\r\n      message: 'Data successfully uploaded to Swarm and linked to feed.',\r\n    });\r\n  }\r\n}\r\n"],"names":[],"mappings":";;;;;;AAoBA,MAAM,mBAAmB,EAAE,OAAO;AAAA,EAChC,MAAM,EAAE,OAAA;AAAA,EACR,aAAa,EAAE,OAAA;AAAA,EACf,gBAAgB,EAAE,OAAA,EAAS,SAAA;AAC7B,CAAC;AAEM,MAAM,uBAAuB,oBAA6C;AAAA,EAW/E,YAAY,QAKT;AACD,UAAM,EAAE,KAAK,QAAQ,GAAG,SAAS;AACjC,UAAM,IAAI;AAjBZ,SAAA,OAAO;AACP,SAAA,cAAc;AAAA;AAAA;AAAA;AAId,SAAA,YAAY;AACZ,SAAA,sBAAsB;AAYpB,SAAK,MAAM;AACX,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,MAAgB,aACZ,OAC8B;AAChC,UAAM,EAAE,MAAM,aAAa,gBAAgB,wBAAyB;AACnE,QAAI,CAAC,MAAM;AACV,WAAK,OAAO;AAAA,QACV;AAAA,MAAA;AAGF,YAAM,IAAI,MAAM,mCAAmC;AAAA,IACrD,WAAW,CAAC,aAAa;AACvB,WAAK,OAAO;AAAA,QACV;AAAA,MAAA;AAGF,YAAM,IAAI,MAAM,oCAAoC;AAAA,IACtD;AAEA,QAAI,iBAAiB;AAErB,QAAI;AACF,uBAAiB,MAAM;AAAA,QACrB;AAAA,QACA,KAAK;AAAA,QACL,KAAK;AAAA,MAAA;AAAA,IAET,SAAS,OAAO;AACd,UAAI,eAAe;AACnB,UAAI,iBAAiB,OAAO;AAC1B,uBAAe,MAAM;AAAA,MACvB;AACA,WAAK,OAAO,MAAM,YAAY;AAE9B,YAAM,IAAI,MAAM,YAAY;AAAA,IAC9B;AAEA,UAAM,aAAa,OAAO,KAAK,IAAI;AAGnC,QAAI,CAAC,KAAK,OAAO,WAAW;AAC1B,WAAK,OAAO,MAAM,kCAAkC;AAEpD,YAAM,IAAI,MAAM,kCAAkC;AAAA,IACpD;AAGA,QAAI,QAAQ;AACZ,QAAI,MAAM,WAAW,IAAI,GAAG;AAC1B,cAAQ,MAAM,MAAM,CAAC;AAAA,IACvB;AACA,UAAM,cAAc,oBAAoB,KAAK,WAAW;AAExD,QAAI,CAAC,aAAa;AAEhB,YAAM,OAAO,OACV,WAAW,QAAQ,EACnB,OAAO,WAAW,EAClB,OAAO,KAAK;AACf,cAAQ;AAAA,IACV;AAGA,UAAM,aAAa,WAAW,KAAK;AAEnC,UAAM,iBAAiB,WAAW,KAAK,OAAO,SAAS;AACvD,UAAM,SAAS,IAAI,OAAO,cAAc;AACxC,UAAM,QAAQ,OAAO,iBAAA,EAAmB,MAAM,CAAC;AAE/C,QAAI;AAEJ,QAAI;AACF,YAAM,aAAa,KAAK,IAAI,eAAe,YAAY,cAAc;AAErE,eAAS,MAAM,WAAW,cAAc,gBAAiB,UAAU;AAAA,IACrE,SAAS,OAAO;AACd,UAAI,eAAe;AAEnB,UAAI,eAAe,OAAO,kBAAkB,GAAG;AAC7C,uBAAe,gBAAgB,KAAK;AAAA,MACtC;AAEA,WAAK,OAAO;AAAA,QACV;AAAA,QACA;AAAA,MAAA;AAGF,YAAM,IAAI,MAAM,YAAY;AAAA,IAC9B;AAEA,UAAM,YAAY,OAAO,UAAU,SAAA;AAEnC,WAAO,iCAAiC;AAAA,MACtC;AAAA,MACA,aAAa;AAAA,MACb;AAAA,MACA,SAAS,GAAG,KAAK,IAAI,GAAG,UAAU,KAAK,IAAI,KAAK;AAAA,MAChD,SAAS;AAAA,IAAA,CACV;AAAA,EACH;AACF;"}

package/dist/esm/index55.js

@@ -0,0 +1,118 @@
+import { BaseHederaQueryTool } from "hedera-agent-kit";
+import { z } from "zod";
+import { promisify } from "util";
+import fs from "fs";
+import { getUploadPostageBatchId, errorHasStatus, getErrorMessage, getResponseWithStructuredContent } from "./index62.js";
+import { DEFAULT_DEFERRED_UPLOAD_SIZE_THRESHOLD_MB, GATEWAY_TAG_ERROR_MESSAGE, NOT_FOUND_STATUS, BAD_REQUEST_STATUS } from "./index63.js";
+const UploadFileSchema = z.object({
+  data: z.string(),
+  isPath: z.boolean(),
+  redundancyLevel: z.number().optional(),
+  postageBatchId: z.string().optional()
+});
+class UploadFileTool extends BaseHederaQueryTool {
+  constructor(params) {
+    const { bee, config, ...rest } = params;
+    super(rest);
+    this.name = "swarm-upload-file";
+    this.description = `Upload a file to Swarm.
+    data: base64 encoded file content or file path.
+    isPath: Wether the data parameter is a path.
+    redundancyLevel: Redundancy level for fault tolerance (higher values provide better fault tolerance but increase storage overhead). 0 - none, 1 - medium, 2 - strong, 3 - insane, 4 - paranoid.
+    postageBatchId: The postage stamp batch ID which will be used to perform the upload, if it is provided.`;
+    this.namespace = "swarm";
+    this.specificInputSchema = UploadFileSchema;
+    this.bee = bee;
+    this.config = config;
+  }
+  async executeQuery(input) {
+    const { data, isPath, redundancyLevel: inputRedundancyLevel, postageBatchId: inputPostageBatchId } = input;
+    if (!data) {
+      this.logger.error(
+        "Missing required parameter: data."
+      );
+      throw new Error("Missing required parameter: data.");
+    }
+    let postageBatchId = "";
+    try {
+      postageBatchId = await getUploadPostageBatchId(
+        inputPostageBatchId,
+        this.bee,
+        this.config
+      );
+    } catch (error) {
+      let errorMessage = "Upload file failed.";
+      if (error instanceof Error) {
+        errorMessage = error.message;
+      }
+      this.logger.error(errorMessage);
+      throw new Error(errorMessage);
+    }
+    let binaryData;
+    let name;
+    if (isPath) {
+      try {
+        binaryData = await promisify(fs.readFile)(data);
+      } catch (fileError) {
+        this.logger.error(
+          `Unable to read file at path: ${data}.`,
+          fileError
+        );
+        throw new Error(`Unable to read file at path: ${data}.`);
+      }
+      name = data.split("/").pop();
+    } else {
+      binaryData = Buffer.from(data, "base64");
+    }
+    const redundancyLevel = inputRedundancyLevel;
+    const options = {};
+    const deferredUploadSizeThreshold = Number(this.config.deferredUploadSizeThresholdMB) || DEFAULT_DEFERRED_UPLOAD_SIZE_THRESHOLD_MB;
+    const deferred = binaryData.length > deferredUploadSizeThreshold * 1024 * 1024;
+    options.deferred = deferred;
+    if (redundancyLevel) {
+      options.redundancyLevel = redundancyLevel;
+    }
+    let message = "File successfully uploaded to Swarm";
+    let tagId = void 0;
+    if (deferred) {
+      try {
+        const tag = await this.bee.createTag();
+        options.tag = tag.uid;
+        tagId = tag.uid.toString();
+        message = "File upload started in deferred mode. Use query_upload_progress to track progress.";
+      } catch (error) {
+        if (errorHasStatus(error, NOT_FOUND_STATUS)) {
+          this.logger.error(
+            GATEWAY_TAG_ERROR_MESSAGE,
+            error
+          );
+          throw new Error(GATEWAY_TAG_ERROR_MESSAGE);
+        }
+      }
+    }
+    let result;
+    try {
+      result = await this.bee.uploadFile(postageBatchId, binaryData, name, options);
+    } catch (error) {
+      let errorMessage = "Unable to upload file.";
+      if (errorHasStatus(error, BAD_REQUEST_STATUS)) {
+        errorMessage = getErrorMessage(error);
+      }
+      this.logger.error(
+        errorMessage,
+        error
+      );
+      throw new Error(errorMessage);
+    }
+    return getResponseWithStructuredContent({
+      reference: result.reference.toString(),
+      url: this.bee.url + "/bzz/" + result.reference.toString(),
+      message,
+      tagId
+    });
+  }
+}
+export {
+  UploadFileTool
+};
+//# sourceMappingURL=index55.js.map

package/dist/esm/index55.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index55.js","sources":["../../src/plugins/community/swarm/tools/UploadFileTool.ts"],"sourcesContent":["import {\r\n  BaseHederaQueryTool,\r\n  HederaAgentKit,\r\n  type GenericPluginContext,\r\n} from \"hedera-agent-kit\";\r\nimport { Bee, FileUploadOptions } from \"@ethersphere/bee-js\";\r\nimport { z } from \"zod\";\r\nimport { promisify } from \"util\";\r\nimport fs from \"fs\";\r\nimport {\r\n  errorHasStatus,\r\n  getErrorMessage,\r\n  getResponseWithStructuredContent,\r\n  getUploadPostageBatchId,\r\n  ToolResponse,\r\n} from \"../utils\";\r\nimport { BAD_REQUEST_STATUS, DEFAULT_DEFERRED_UPLOAD_SIZE_THRESHOLD_MB, GATEWAY_TAG_ERROR_MESSAGE, NOT_FOUND_STATUS } from \"../constants\";\r\nimport { SwarmConfig } from \"../config\";\r\n\r\nconst UploadFileSchema = z.object({\r\n  data: z.string(),\r\n  isPath: z.boolean(),\r\n  redundancyLevel: z.number().optional(),\r\n  postageBatchId: z.string().optional(),\r\n});\r\n\r\nexport class UploadFileTool extends BaseHederaQueryTool<typeof UploadFileSchema> {\r\n  name = \"swarm-upload-file\";\r\n  description = `Upload a file to Swarm.\r\n    data: base64 encoded file content or file path.\r\n    isPath: Wether the data parameter is a path.\r\n    redundancyLevel: Redundancy level for fault tolerance (higher values provide better fault tolerance but increase storage overhead). 0 - none, 1 - medium, 2 - strong, 3 - insane, 4 - paranoid.\r\n    postageBatchId: The postage stamp batch ID which will be used to perform the upload, if it is provided.`;\r\n  namespace = \"swarm\";\r\n  specificInputSchema = UploadFileSchema;\r\n  bee: Bee;\r\n  config: SwarmConfig;\r\n\r\n  constructor(params: {\r\n    hederaKit: HederaAgentKit;\r\n    config: SwarmConfig;\r\n    logger?: GenericPluginContext['logger'];\r\n    bee: Bee;\r\n  }) {\r\n    const { bee, config, ...rest } = params;\r\n    super(rest);\r\n    this.bee = bee;\r\n    this.config = config;\r\n  }\r\n  \r\n  protected async executeQuery(\r\n      input: z.infer<typeof UploadFileSchema>\r\n  ): Promise<ToolResponse | string> {\r\n    const { data, isPath, redundancyLevel: inputRedundancyLevel, postageBatchId: inputPostageBatchId  } = input;\r\n\r\n    if (!data) {\r\n      this.logger.error(\r\n        'Missing required parameter: data.'\r\n      );\r\n\r\n      throw new Error('Missing required parameter: data.');\r\n    }\r\n\r\n    let postageBatchId = \"\";\r\n\r\n    try {\r\n      postageBatchId = await getUploadPostageBatchId(\r\n        inputPostageBatchId,\r\n        this.bee,\r\n        this.config,\r\n      );\r\n    } catch (error) {\r\n      let errorMessage = 'Upload file failed.';\r\n      if (error instanceof Error) {\r\n        errorMessage = error.message;\r\n      }\r\n      this.logger.error(errorMessage);\r\n\r\n      throw new Error(errorMessage);\r\n    }\r\n\r\n    let binaryData: Buffer;\r\n    let name: string | undefined;\r\n\r\n    if (isPath) {\r\n      // Read file from path\r\n      try {\r\n        binaryData = await promisify(fs.readFile)(data);\r\n      } catch (fileError) {\r\n        this.logger.error(\r\n          `Unable to read file at path: ${data}.`,\r\n          fileError\r\n        );\r\n\r\n        throw new Error(`Unable to read file at path: ${data}.`);\r\n      }\r\n\r\n      name = data.split(\"/\").pop();\r\n    } else {\r\n      binaryData = Buffer.from(data, \"base64\");\r\n    }\r\n\r\n    const redundancyLevel = inputRedundancyLevel;\r\n    const options: FileUploadOptions = {};\r\n    const deferredUploadSizeThreshold = Number(this.config.deferredUploadSizeThresholdMB) ||\r\n      DEFAULT_DEFERRED_UPLOAD_SIZE_THRESHOLD_MB;\r\n    const deferred =\r\n      binaryData.length > deferredUploadSizeThreshold * 1024 * 1024;\r\n    options.deferred = deferred;\r\n    if (redundancyLevel) {\r\n      options.redundancyLevel = redundancyLevel;\r\n    }\r\n\r\n    let message = \"File successfully uploaded to Swarm\";\r\n    let tagId: string | undefined = undefined;\r\n    // Create tag for deferred uploads or when explicitly requested\r\n    if (deferred) {\r\n      try {\r\n        const tag = await this.bee.createTag();\r\n        options.tag = tag.uid;\r\n        tagId = tag.uid.toString();\r\n        message =\r\n          \"File upload started in deferred mode. Use query_upload_progress to track progress.\";\r\n      } catch (error) {\r\n        if (errorHasStatus(error, NOT_FOUND_STATUS)) {\r\n          this.logger.error(\r\n            GATEWAY_TAG_ERROR_MESSAGE,\r\n            error\r\n          );\r\n\r\n          throw new Error(GATEWAY_TAG_ERROR_MESSAGE);\r\n        }\r\n      }\r\n    }\r\n\r\n    let result;\r\n\r\n    try {\r\n      // Start the deferred upload\r\n      result = await this.bee.uploadFile(postageBatchId, binaryData, name, options);\r\n    } catch (error) {\r\n      let errorMessage = 'Unable to upload file.';\r\n\r\n      if (errorHasStatus(error, BAD_REQUEST_STATUS)) {\r\n        errorMessage = getErrorMessage(error);\r\n      }\r\n\r\n      this.logger.error(\r\n        errorMessage,\r\n        error\r\n      );\r\n      \r\n      throw new Error(errorMessage);\r\n    }\r\n\r\n    return getResponseWithStructuredContent({\r\n      reference: result.reference.toString(),\r\n      url: this.bee.url + \"/bzz/\" + result.reference.toString(),\r\n      message,\r\n      tagId,\r\n    });\r\n  }\r\n}\r\n"],"names":[],"mappings":"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"}