@hashgraphonline/conversational-agent 0.2.216 → 0.2.217

package/dist/esm/index50.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index50.js","sources":["../../src/plugins/community/swarm/tools/DownloadDataTool.ts"],"sourcesContent":["import { Bee } from \"@ethersphere/bee-js\";\r\nimport { z } from \"zod\";\r\nimport { errorHasStatus, getErrorMessage, getResponseWithStructuredContent, 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 DownloadDataSchema = z.object({\r\n  reference: z.string(),\r\n});\r\n\r\nexport class DownloadDataTool extends BaseHederaQueryTool<typeof DownloadDataSchema> {\r\n  name = \"swarm-download-data\";\r\n  description = `\r\n    Downloads immutable data from a Swarm content address hash.\r\n    reference: Swarm reference hash.\r\n  `;\r\n  namespace = \"swarm\";\r\n  specificInputSchema = DownloadDataSchema;\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 DownloadDataSchema>\r\n  ): Promise<ToolResponse | string> {\r\n    const { reference } = 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    const isRefNotSwarmHash =\r\n      reference.length !== 64 && reference.length !== 66;\r\n\r\n    if (isRefNotSwarmHash) {\r\n      this.logger.error(\r\n        'Invalid Swarm content address hash value for reference.'\r\n      );\r\n\r\n      throw new Error(\"Invalid Swarm content address hash value for reference.\");\r\n    }\r\n\r\n    let data;\r\n    try {\r\n      data = await this.bee.downloadData(reference);\r\n    } catch (error) {\r\n      let errorMessage = 'Downloading data failed.';\r\n\r\n      if (errorHasStatus(error, BAD_REQUEST_STATUS)) {\r\n        errorMessage = getErrorMessage(error);\r\n      }\r\n\r\n      this.logger.error(errorMessage, error);\r\n      throw new Error(errorMessage);\r\n    }\r\n\r\n    const textData = data.toUtf8();\r\n\r\n    return getResponseWithStructuredContent({\r\n      textData,\r\n    });\r\n  }\r\n}\r\n"],"names":[],"mappings":";;;;AAOA,MAAM,qBAAqB,EAAE,OAAO;AAAA,EAClC,WAAW,EAAE,OAAA;AACf,CAAC;AAEM,MAAM,yBAAyB,oBAA+C;AAAA,EAWnF,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,cAAc;AAEtB,QAAI,CAAC,WAAW;AACd,WAAK,OAAO;AAAA,QACV;AAAA,MAAA;AAGF,YAAM,IAAI,MAAM,wCAAwC;AAAA,IAC1D;AAEA,UAAM,oBACJ,UAAU,WAAW,MAAM,UAAU,WAAW;AAElD,QAAI,mBAAmB;AACrB,WAAK,OAAO;AAAA,QACV;AAAA,MAAA;AAGF,YAAM,IAAI,MAAM,yDAAyD;AAAA,IAC3E;AAEA,QAAI;AACJ,QAAI;AACF,aAAO,MAAM,KAAK,IAAI,aAAa,SAAS;AAAA,IAC9C,SAAS,OAAO;AACd,UAAI,eAAe;AAEnB,UAAI,eAAe,OAAO,kBAAkB,GAAG;AAC7C,uBAAe,gBAAgB,KAAK;AAAA,MACtC;AAEA,WAAK,OAAO,MAAM,cAAc,KAAK;AACrC,YAAM,IAAI,MAAM,YAAY;AAAA,IAC9B;AAEA,UAAM,WAAW,KAAK,OAAA;AAEtB,WAAO,iCAAiC;AAAA,MACtC;AAAA,IAAA,CACD;AAAA,EACH;AACF;"}

package/dist/esm/index51.js

@@ -0,0 +1,103 @@
+import { BaseHederaQueryTool } from "hedera-agent-kit";
+import { Size, Duration } from "@ethersphere/bee-js";
+import { z } from "zod";
+import { makeDate, runWithTimeout, errorHasStatus, getErrorMessage } from "./index62.js";
+import { CALL_TIMEOUT, POSTAGE_CREATE_TIMEOUT_MESSAGE, GATEWAY_STAMP_ERROR_MESSAGE, NOT_FOUND_STATUS, BAD_REQUEST_STATUS } from "./index63.js";
+const CreatePostageStampSchema = z.object({
+  size: z.number(),
+  duration: z.string(),
+  label: z.string().optional()
+});
+class CreatePostageStampTool extends BaseHederaQueryTool {
+  constructor(params) {
+    const { bee, config, ...rest } = params;
+    super(rest);
+    this.name = "swarm-create-postage-stamp";
+    this.description = `
+    Buy postage stamp based on size in megabytes and duration.
+    size: The storage size in MB (Megabytes). These other size units convert like this to MB: 1 byte = 0.000001 MB, 1  KB = 0.001 MB, 1GB= 1000MB.
+    duration: Duration for which the data should be stored. Time to live of the postage stamp, e.g. 1d - 1 day, 1w - 1 week, 1month - 1 month.
+    label: Sets label for the postage batch (omit if the user didn't ask for one). Do not set a label with with specific capacity values because they can get misleading.
+  `;
+    this.namespace = "swarm";
+    this.specificInputSchema = CreatePostageStampSchema;
+    this.bee = bee;
+    this.config = config;
+  }
+  async executeQuery(input) {
+    const { size, duration, label } = input;
+    if (!size) {
+      this.logger.error(
+        "Missing required parameter: size."
+      );
+      throw new Error("Missing required parameter: size.");
+    } else if (!duration) {
+      this.logger.error(
+        "Missing required parameter: duration."
+      );
+      throw new Error("Missing required parameter: duration.");
+    }
+    let durationMs;
+    try {
+      durationMs = makeDate(duration);
+    } catch (makeDateError) {
+      this.logger.error(
+        "Invalid parameter: duration."
+      );
+      throw new Error("Invalid parameter: duration.");
+    }
+    let buyStorageResponse;
+    try {
+      let options = {};
+      if (label !== void 0) {
+        options = {
+          label
+        };
+      }
+      const buyStoragePromise = this.bee.buyStorage(
+        Size.fromMegabytes(size),
+        Duration.fromMilliseconds(durationMs),
+        options
+      );
+      const [response, hasTimedOut] = await runWithTimeout(
+        buyStoragePromise,
+        CALL_TIMEOUT
+      );
+      if (hasTimedOut) {
+        return JSON.stringify({
+          content: [
+            {
+              type: "text",
+              text: POSTAGE_CREATE_TIMEOUT_MESSAGE
+            }
+          ]
+        });
+      }
+      buyStorageResponse = response;
+    } catch (error) {
+      let errorMessage = "Unable to buy storage.";
+      if (errorHasStatus(error, NOT_FOUND_STATUS)) {
+        errorMessage = GATEWAY_STAMP_ERROR_MESSAGE;
+      } else if (errorHasStatus(error, BAD_REQUEST_STATUS)) {
+        errorMessage = getErrorMessage(error);
+      }
+      this.logger.error(
+        errorMessage,
+        error
+      );
+      throw new Error(errorMessage);
+    }
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Postage batch ID: ${buyStorageResponse.toHex()}`
+        }
+      ]
+    };
+  }
+}
+export {
+  CreatePostageStampTool
+};
+//# sourceMappingURL=index51.js.map

package/dist/esm/index51.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index51.js","sources":["../../src/plugins/community/swarm/tools/CreatePostageStampTool.ts"],"sourcesContent":["import {\r\n  BaseHederaQueryTool,\r\n  HederaAgentKit,\r\n  type GenericPluginContext,\r\n} from \"hedera-agent-kit\";\r\nimport { BatchId, Bee, Duration, Size } from \"@ethersphere/bee-js\";\r\nimport { z } from \"zod\";\r\nimport {\r\n  errorHasStatus,\r\n  getErrorMessage,\r\n  makeDate,\r\n  runWithTimeout,\r\n  ToolResponse,\r\n} from \"../utils\";\r\nimport { BAD_REQUEST_STATUS, CALL_TIMEOUT, GATEWAY_STAMP_ERROR_MESSAGE, NOT_FOUND_STATUS, POSTAGE_CREATE_TIMEOUT_MESSAGE } from \"../constants\";\r\nimport { SwarmConfig } from \"../config\";\r\n\r\nconst CreatePostageStampSchema = z.object({\r\n  size: z.number(),\r\n  duration: z.string(),\r\n  label: z.string().optional(),\r\n});\r\n\r\nexport class CreatePostageStampTool extends BaseHederaQueryTool<typeof CreatePostageStampSchema> {\r\n  name = \"swarm-create-postage-stamp\";\r\n  description = `\r\n    Buy postage stamp based on size in megabytes and duration.\r\n    size: The storage size in MB (Megabytes). These other size units convert like this to MB: 1 byte = 0.000001 MB, 1  KB = 0.001 MB, 1GB= 1000MB.\r\n    duration: Duration for which the data should be stored. Time to live of the postage stamp, e.g. 1d - 1 day, 1w - 1 week, 1month - 1 month.\r\n    label: Sets label for the postage batch (omit if the user didn't ask for one). Do not set a label with with specific capacity values because they can get misleading.\r\n  `;\r\n  namespace = \"swarm\";\r\n  specificInputSchema = CreatePostageStampSchema;\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 CreatePostageStampSchema>\r\n  ): Promise<ToolResponse | string> {\r\n    const { size, duration, label } = input;\r\n\r\n    if (!size) {\r\n      this.logger.error(\r\n        'Missing required parameter: size.'\r\n      );\r\n      \r\n      throw new Error('Missing required parameter: size.');\r\n    } else if (!duration) {\r\n      this.logger.error(\r\n        'Missing required parameter: duration.'\r\n      );\r\n      \r\n      throw new Error('Missing required parameter: duration.');\r\n    }\r\n\r\n    let durationMs;\r\n\r\n    try {\r\n      durationMs = makeDate(duration);\r\n    } catch (makeDateError) {\r\n      this.logger.error(\r\n        'Invalid parameter: duration.'\r\n      );\r\n\r\n      throw new Error('Invalid parameter: duration.');\r\n    }\r\n\r\n    let buyStorageResponse: BatchId;\r\n\r\n    try {\r\n      let options = {};\r\n      if (label !== undefined) {\r\n        options = {\r\n          label\r\n        };\r\n      }\r\n      const buyStoragePromise = this.bee.buyStorage(\r\n        Size.fromMegabytes(size),\r\n        Duration.fromMilliseconds(durationMs),\r\n        options\r\n      );\r\n      const [response, hasTimedOut] = await runWithTimeout(\r\n        buyStoragePromise,\r\n        CALL_TIMEOUT\r\n      );\r\n\r\n      if (hasTimedOut) {\r\n        return JSON.stringify({\r\n          content: [\r\n            {\r\n              type: 'text',\r\n              text: POSTAGE_CREATE_TIMEOUT_MESSAGE,\r\n            },\r\n          ],\r\n        });\r\n      }\r\n\r\n      buyStorageResponse = response as BatchId;\r\n    } catch (error) {\r\n      let errorMessage = 'Unable to buy storage.';\r\n\r\n      if (errorHasStatus(error, NOT_FOUND_STATUS)) {\r\n        errorMessage = GATEWAY_STAMP_ERROR_MESSAGE;\r\n      } else 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 {\r\n      content: [\r\n        {\r\n          type: 'text',\r\n          text: `Postage batch ID: ${buyStorageResponse.toHex()}`,\r\n        },\r\n      ],\r\n    };\r\n  }\r\n}\r\n"],"names":[],"mappings":";;;;;AAiBA,MAAM,2BAA2B,EAAE,OAAO;AAAA,EACxC,MAAM,EAAE,OAAA;AAAA,EACR,UAAU,EAAE,OAAA;AAAA,EACZ,OAAO,EAAE,OAAA,EAAS,SAAA;AACpB,CAAC;AAEM,MAAM,+BAA+B,oBAAqD;AAAA,EAa/F,YAAY,QAKT;AACD,UAAM,EAAE,KAAK,QAAQ,GAAG,SAAS;AACjC,UAAM,IAAI;AAnBZ,SAAA,OAAO;AACP,SAAA,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAMd,SAAA,YAAY;AACZ,SAAA,sBAAsB;AAYpB,SAAK,MAAM;AACX,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,MAAgB,aACZ,OAC8B;AAChC,UAAM,EAAE,MAAM,UAAU,MAAA,IAAU;AAElC,QAAI,CAAC,MAAM;AACT,WAAK,OAAO;AAAA,QACV;AAAA,MAAA;AAGF,YAAM,IAAI,MAAM,mCAAmC;AAAA,IACrD,WAAW,CAAC,UAAU;AACpB,WAAK,OAAO;AAAA,QACV;AAAA,MAAA;AAGF,YAAM,IAAI,MAAM,uCAAuC;AAAA,IACzD;AAEA,QAAI;AAEJ,QAAI;AACF,mBAAa,SAAS,QAAQ;AAAA,IAChC,SAAS,eAAe;AACtB,WAAK,OAAO;AAAA,QACV;AAAA,MAAA;AAGF,YAAM,IAAI,MAAM,8BAA8B;AAAA,IAChD;AAEA,QAAI;AAEJ,QAAI;AACF,UAAI,UAAU,CAAA;AACd,UAAI,UAAU,QAAW;AACvB,kBAAU;AAAA,UACR;AAAA,QAAA;AAAA,MAEJ;AACA,YAAM,oBAAoB,KAAK,IAAI;AAAA,QACjC,KAAK,cAAc,IAAI;AAAA,QACvB,SAAS,iBAAiB,UAAU;AAAA,QACpC;AAAA,MAAA;AAEF,YAAM,CAAC,UAAU,WAAW,IAAI,MAAM;AAAA,QACpC;AAAA,QACA;AAAA,MAAA;AAGF,UAAI,aAAa;AACf,eAAO,KAAK,UAAU;AAAA,UACpB,SAAS;AAAA,YACP;AAAA,cACE,MAAM;AAAA,cACN,MAAM;AAAA,YAAA;AAAA,UACR;AAAA,QACF,CACD;AAAA,MACH;AAEA,2BAAqB;AAAA,IACvB,SAAS,OAAO;AACd,UAAI,eAAe;AAEnB,UAAI,eAAe,OAAO,gBAAgB,GAAG;AAC3C,uBAAe;AAAA,MACjB,WAAW,eAAe,OAAO,kBAAkB,GAAG;AACpD,uBAAe,gBAAgB,KAAK;AAAA,MACtC;AAEA,WAAK,OAAO;AAAA,QACV;AAAA,QACA;AAAA,MAAA;AAGF,YAAM,IAAI,MAAM,YAAY;AAAA,IAC9B;AAEA,WAAO;AAAA,MACL,SAAS;AAAA,QACP;AAAA,UACE,MAAM;AAAA,UACN,MAAM,qBAAqB,mBAAmB,MAAA,CAAO;AAAA,QAAA;AAAA,MACvD;AAAA,IACF;AAAA,EAEJ;AACF;"}

package/dist/esm/index52.js

@@ -0,0 +1,79 @@
+import { BaseHederaQueryTool } from "hedera-agent-kit";
+import { Size, Duration } from "@ethersphere/bee-js";
+import { z } from "zod";
+import { makeDate, errorHasStatus, getErrorMessage, getResponseWithStructuredContent } from "./index62.js";
+import { NOT_FOUND_STATUS, GATEWAY_STAMP_ERROR_MESSAGE, BAD_REQUEST_STATUS } from "./index63.js";
+const ExtendPostageStampSchema = z.object({
+  postageBatchId: z.string(),
+  duration: z.string().optional(),
+  size: z.number().optional()
+});
+class ExtendPostageStampTool extends BaseHederaQueryTool {
+  constructor(params) {
+    const { bee, config, ...rest } = params;
+    super(rest);
+    this.name = "swarm-extend-postage-stamp";
+    this.description = `Increase the duration (relative to current duration) or size (in megabytes) of a postage stamp.
+    postageBatchId: The id of the batch for which extend is performed.
+    size: The storage size in MB (Megabytes). These other size units convert like this to MB: 1 byte = 0.000001 MB, 1  KB = 0.001 MB, 1GB= 1000MB.
+    duration: Duration for which the data should be stored. Time to live of the postage stamp, e.g. 1d - 1 day, 1w - 1 week, 1month - 1 month.
+  `;
+    this.namespace = "swarm";
+    this.specificInputSchema = ExtendPostageStampSchema;
+    this.bee = bee;
+    this.config = config;
+  }
+  async executeQuery(input) {
+    const { postageBatchId, duration, size } = input;
+    if (!postageBatchId) {
+      this.logger.error(
+        "Missing required parameter: postageBatchId."
+      );
+      throw new Error("Missing required parameter: postageBatchId.");
+    } else if (!duration && !size) {
+      this.logger.error(
+        "You need at least one parameter from duration and size."
+      );
+      throw new Error("You need at least one parameter from duration and size.");
+    }
+    const extendSize = !!size ? Size.fromMegabytes(size) : Size.fromBytes(1);
+    let extendDuration = Duration.ZERO;
+    try {
+      if (duration) {
+        extendDuration = Duration.fromMilliseconds(makeDate(duration));
+      }
+    } catch (makeDateError) {
+      this.logger.error(
+        "Invalid parameter: duration."
+      );
+      throw new Error("Invalid parameter: duration.");
+    }
+    let extendStorageResponse;
+    try {
+      extendStorageResponse = await this.bee.extendStorage(
+        postageBatchId,
+        extendSize,
+        extendDuration
+      );
+    } catch (error) {
+      let errorMessage = "Extend failed.";
+      if (errorHasStatus(error, NOT_FOUND_STATUS)) {
+        errorMessage = GATEWAY_STAMP_ERROR_MESSAGE;
+      } else if (errorHasStatus(error, BAD_REQUEST_STATUS)) {
+        errorMessage = getErrorMessage(error);
+      }
+      this.logger.error(
+        errorMessage,
+        error
+      );
+      throw new Error(errorMessage);
+    }
+    return getResponseWithStructuredContent({
+      postageBatchId: extendStorageResponse.toHex()
+    });
+  }
+}
+export {
+  ExtendPostageStampTool
+};
+//# sourceMappingURL=index52.js.map

package/dist/esm/index52.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index52.js","sources":["../../src/plugins/community/swarm/tools/ExtendPostageStampTool.ts"],"sourcesContent":["import {\r\n  BaseHederaQueryTool,\r\n  HederaAgentKit,\r\n  type GenericPluginContext,\r\n} from \"hedera-agent-kit\";\r\nimport { BatchId, Bee, Duration, Size } from \"@ethersphere/bee-js\";\r\nimport { z } from \"zod\";\r\nimport {\r\n  errorHasStatus,\r\n  getErrorMessage,\r\n  getResponseWithStructuredContent,\r\n  makeDate,\r\n  ToolResponse,\r\n} from \"../utils\";\r\nimport { BAD_REQUEST_STATUS, GATEWAY_STAMP_ERROR_MESSAGE, NOT_FOUND_STATUS } from \"../constants\";\r\nimport { SwarmConfig } from \"../config\";\r\n\r\nconst ExtendPostageStampSchema = z.object({\r\n  postageBatchId: z.string(),\r\n  duration: z.string().optional(),\r\n  size: z.number().optional(),\r\n});\r\n\r\nexport class ExtendPostageStampTool extends BaseHederaQueryTool<typeof ExtendPostageStampSchema> {\r\n  name = \"swarm-extend-postage-stamp\";\r\n  description = `Increase the duration (relative to current duration) or size (in megabytes) of a postage stamp.\r\n    postageBatchId: The id of the batch for which extend is performed.\r\n    size: The storage size in MB (Megabytes). These other size units convert like this to MB: 1 byte = 0.000001 MB, 1  KB = 0.001 MB, 1GB= 1000MB.\r\n    duration: Duration for which the data should be stored. Time to live of the postage stamp, e.g. 1d - 1 day, 1w - 1 week, 1month - 1 month.\r\n  `;\r\n  namespace = \"swarm\";\r\n  specificInputSchema = ExtendPostageStampSchema;\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 ExtendPostageStampSchema>\r\n  ): Promise<ToolResponse | string> {\r\n    const { postageBatchId, duration, size } = input;\r\n\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    } else if (!duration && !size) {\r\n      this.logger.error(\r\n        'You need at least one parameter from duration and size.'\r\n      );\r\n\r\n      throw new Error('You need at least one parameter from duration and size.');\r\n    }\r\n\r\n    // If size is missing, Size.fromBytes(1) will get smallest depth and not increase size.\r\n    const extendSize = !!size ? Size.fromMegabytes(size) : Size.fromBytes(1); \r\n    let extendDuration = Duration.ZERO;\r\n\r\n    try {\r\n      if (duration) {\r\n        extendDuration = Duration.fromMilliseconds(makeDate(duration));\r\n      }\r\n    } catch (makeDateError) {\r\n      this.logger.error(\r\n        'Invalid parameter: duration.'\r\n      );\r\n\r\n      throw new Error('Invalid parameter: duration.');\r\n    }\r\n\r\n    let extendStorageResponse;\r\n\r\n    try {\r\n      extendStorageResponse = await this.bee.extendStorage(\r\n        postageBatchId,\r\n        extendSize,\r\n        extendDuration\r\n      );\r\n    } catch (error) {\r\n      let errorMessage = 'Extend failed.';\r\n\r\n      if (errorHasStatus(error, NOT_FOUND_STATUS)) {\r\n        errorMessage = GATEWAY_STAMP_ERROR_MESSAGE;\r\n      } else 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      postageBatchId: extendStorageResponse.toHex(),\r\n    });\r\n  }\r\n}\r\n"],"names":[],"mappings":";;;;;AAiBA,MAAM,2BAA2B,EAAE,OAAO;AAAA,EACxC,gBAAgB,EAAE,OAAA;AAAA,EAClB,UAAU,EAAE,OAAA,EAAS,SAAA;AAAA,EACrB,MAAM,EAAE,OAAA,EAAS,SAAA;AACnB,CAAC;AAEM,MAAM,+BAA+B,oBAAqD;AAAA,EAY/F,YAAY,QAKT;AACD,UAAM,EAAE,KAAK,QAAQ,GAAG,SAAS;AACjC,UAAM,IAAI;AAlBZ,SAAA,OAAO;AACP,SAAA,cAAc;AAAA;AAAA;AAAA;AAAA;AAKd,SAAA,YAAY;AACZ,SAAA,sBAAsB;AAYpB,SAAK,MAAM;AACX,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,MAAgB,aACd,OACgC;AAChC,UAAM,EAAE,gBAAgB,UAAU,KAAA,IAAS;AAE3C,QAAI,CAAC,gBAAgB;AACnB,WAAK,OAAO;AAAA,QACV;AAAA,MAAA;AAGF,YAAM,IAAI,MAAM,6CAA6C;AAAA,IAC/D,WAAW,CAAC,YAAY,CAAC,MAAM;AAC7B,WAAK,OAAO;AAAA,QACV;AAAA,MAAA;AAGF,YAAM,IAAI,MAAM,yDAAyD;AAAA,IAC3E;AAGA,UAAM,aAAa,CAAC,CAAC,OAAO,KAAK,cAAc,IAAI,IAAI,KAAK,UAAU,CAAC;AACvE,QAAI,iBAAiB,SAAS;AAE9B,QAAI;AACF,UAAI,UAAU;AACZ,yBAAiB,SAAS,iBAAiB,SAAS,QAAQ,CAAC;AAAA,MAC/D;AAAA,IACF,SAAS,eAAe;AACtB,WAAK,OAAO;AAAA,QACV;AAAA,MAAA;AAGF,YAAM,IAAI,MAAM,8BAA8B;AAAA,IAChD;AAEA,QAAI;AAEJ,QAAI;AACF,8BAAwB,MAAM,KAAK,IAAI;AAAA,QACrC;AAAA,QACA;AAAA,QACA;AAAA,MAAA;AAAA,IAEJ,SAAS,OAAO;AACd,UAAI,eAAe;AAEnB,UAAI,eAAe,OAAO,gBAAgB,GAAG;AAC3C,uBAAe;AAAA,MACjB,WAAW,eAAe,OAAO,kBAAkB,GAAG;AACpD,uBAAe,gBAAgB,KAAK;AAAA,MACtC;AAEA,WAAK,OAAO;AAAA,QACV;AAAA,QACA;AAAA,MAAA;AAGF,YAAM,IAAI,MAAM,YAAY;AAAA,IAC9B;AAEA,WAAO,iCAAiC;AAAA,MACtC,gBAAgB,sBAAsB,MAAA;AAAA,IAAM,CAC7C;AAAA,EACH;AACF;"}

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

package/dist/esm/index53.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index53.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/index54.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=index54.js.map

package/dist/esm/index54.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index54.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/index55.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=index55.js.map

package/dist/esm/index55.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index55.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/index56.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=index56.js.map

package/dist/esm/index56.js.map

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