@toolforge-js/sdk 0.7.0 → 0.8.0

package/dist/cli/index.js

@@ -1,15 +1,16 @@
-import { C as __toESM, S as __require, _ as startAgentMessageSchema, a as TOOL_TAG_NAME, b as stopToolMessageSchema, c as getErrorMessage, d as runWithRetries, f as ackMessageSchema, g as runnerId, h as initCommunicationMessageSchema, i as TOOL_HANDLER_TAG_NAME, l as invariant, m as heartbeatAckMessageSchema, n as AGENT_TAG_NAME, o as Tool, p as baseMessageSchema, r as Agent, s as convertToWords, t as AGENT_STEP_TAG_NAME, u as exponentialBackoff, v as startToolMessageSchema, x as __commonJS, y as stopAgentMessageSchema } from "../agent-DBDnKm26.js";
+import { C as __toESM, S as __require, _ as startAgentMessageSchema, a as AGENT_TAG_NAME, b as stopToolMessageSchema, c as getErrorMessage, d as runWithRetries, f as ackMessageSchema, g as runnerId, h as initCommunicationMessageSchema, i as AGENT_STEP_TAG_NAME, l as invariant, m as heartbeatAckMessageSchema, n as TOOL_TAG_NAME, o as Agent, p as baseMessageSchema, r as Tool, s as convertToWords, t as TOOL_HANDLER_TAG_NAME, u as exponentialBackoff, v as startToolMessageSchema, x as __commonJS, y as stopAgentMessageSchema } from "../tool-UVAGtnlr.js";
 import { t as toolForgeConfigSchema } from "../config-schema-CcWOtgOv.js";
 import * as z$1 from "zod";
 import z from "zod";
-import { P, match } from "ts-pattern";
-import { setTimeout as setTimeout$1 } from "node:timers/promises";
-import { nanoid } from "nanoid";
 import { readFileSync } from "node:fs";
 import * as path from "node:path";
 import { EventEmitter } from "node:events";
+import ora from "ora";
 import { pino } from "pino";
+import { P, match } from "ts-pattern";
+import { setTimeout as setTimeout$1 } from "node:timers/promises";
 import chokidar from "chokidar";
+import { nanoid } from "nanoid";
 import picocolors from "picocolors";
 import * as fs from "node:fs/promises";
 import * as os from "node:os";
@@ -3800,8 +3801,8 @@ var ForgeRunner = class extends EventEmitter {
 //#endregion
 //#region src/cli/index.ts
 const version = JSON.parse(readFileSync(path.resolve(__dirname, "../../package.json"), "utf-8")).version;
-program.name("toolforge-js").description("Tool Forge SDK").version(version);
-program.command("dev").description("start the tool forge development server").option("-c, --config <path>", "path to the tool-forge config file", "toolforge.config.ts").option("-d, --debug", "enable debug logging", false).action(async function startServer() {
+program.name("toolforge").description("Tool Forge SDK cli").version(version);
+program.command("dev").description("start the tool forge development server").option("-c, --config <path>", "path to the tool-forge config file", (val) => z$1.string().parse(val), "toolforge.config.ts").option("-d, --debug", "enable debug logging", false).action(async function startServer() {
 	const debug = z$1.boolean().optional().default(false).parse(this.opts().debug);
 	await startToolForge({
 		configRelPath: z$1.string().parse(this.opts().config),
@@ -3809,7 +3810,15 @@ program.command("dev").description("start the tool forge development server").op
 		mode: "development"
 	});
 });
-program.command("build").description("build the tools for production").option("-c, --config <path>", "path to the tool-forge config file", "toolforge.config.ts").option("-d, --debug", "enable debug logging", false).action(async function() {
+program.command("start").description("start the tool forge server in production mode").option("-c, --config <path>", "path to the tool-forge config file", (val) => z$1.string().parse(val), "toolforge.config.ts").option("-d, --debug", "enable debug logging", false).action(async function startServer() {
+	const debug = z$1.boolean().optional().default(false).parse(this.opts().debug);
+	await startToolForge({
+		configRelPath: z$1.string().parse(this.opts().config),
+		debug,
+		mode: "production"
+	});
+});
+program.command("build").description("build the tools for production").option("-c, --config <path>", "path to the tool-forge config file", (val) => z$1.string().parse(val), "toolforge.config.ts").option("-d, --debug", "enable debug logging", false).action(async function() {
 	const logger = pino({
 		level: z$1.boolean().optional().default(false).parse(this.opts().debug) ? "debug" : "info",
 		transport: { target: "pino-pretty" }
@@ -3838,22 +3847,16 @@ program.command("build").description("build the tools for production").option("-
 		process.exit(1);
 	}
 });
-program.command("start").description("start the tool forge server in production mode").option("-c, --config <path>", "path to the tool-forge config file", "toolforge.config.ts").option("-d, --debug", "enable debug logging", false).action(async function startServer() {
-	const debug = z$1.boolean().optional().default(false).parse(this.opts().debug);
-	await startToolForge({
-		configRelPath: z$1.string().parse(this.opts().config),
-		debug,
-		mode: "production"
-	});
-});
 async function startToolForge({ configRelPath, debug, mode }) {
 	const logger = pino({
 		level: debug ? "debug" : "info",
 		transport: { target: "pino-pretty" }
 	});
 	try {
+		const spinner = ora("loading configuration...").start();
 		const configPath = path.resolve(process.cwd(), configRelPath);
 		const config = toolForgeConfigSchema.parse(await import(configPath).then((mod) => mod.default));
+		spinner.stop();
 		logger.debug({ config }, "loaded config from %s", configPath);
 		const runner = new ForgeRunner(config, { mode }, logger);
 		runner.on("error", async (error) => {

package/dist/components/index.d.ts

@@ -5074,7 +5074,7 @@ declare class Block {
       type: "number" | "currency" | "percentage";
       decimals: number;
       currency: string;
-      currencyDisplay: "symbol" | "code" | "name";
+      currencyDisplay: "symbol" | "name" | "code";
       thousandsSeparator: string;
       decimalSeparator: string;
       showPercentageSymbol: boolean;
@@ -5111,7 +5111,7 @@ declare class Block {
       type: "number" | "currency" | "percentage";
       decimals: number;
       currency: string;
-      currencyDisplay: "symbol" | "code" | "name";
+      currencyDisplay: "symbol" | "name" | "code";
       thousandsSeparator: string;
       decimalSeparator: string;
       showPercentageSymbol: boolean;
@@ -5180,7 +5180,7 @@ declare class Block {
       type: "number" | "currency" | "percentage";
       decimals: number;
       currency: string;
-      currencyDisplay: "symbol" | "code" | "name";
+      currencyDisplay: "symbol" | "name" | "code";
       thousandsSeparator: string;
       decimalSeparator: string;
       showPercentageSymbol: boolean;
@@ -5215,7 +5215,7 @@ declare class Block {
       type: "number" | "currency" | "percentage";
       decimals: number;
       currency: string;
-      currencyDisplay: "symbol" | "code" | "name";
+      currencyDisplay: "symbol" | "name" | "code";
       thousandsSeparator: string;
       decimalSeparator: string;
       showPercentageSymbol: boolean;
@@ -5235,7 +5235,7 @@ declare class Block {
     chartType: "progress-bar";
     value: number;
     max: number;
-    variant: "error" | "success" | "default" | "neutral" | "warning";
+    variant: "error" | "default" | "success" | "neutral" | "warning";
     title?: string | undefined;
     description?: string | undefined;
     label?: string | number | undefined;
@@ -5251,7 +5251,7 @@ declare class Block {
     value: number;
     max: number;
     radius: number;
-    variant: "error" | "success" | "default" | "neutral" | "warning";
+    variant: "error" | "default" | "success" | "neutral" | "warning";
     title?: string | undefined;
     description?: string | undefined;
   };
@@ -5315,7 +5315,7 @@ declare class Block {
         type: "number" | "currency" | "percentage";
         decimals: number;
         currency: string;
-        currencyDisplay: "symbol" | "code" | "name";
+        currencyDisplay: "symbol" | "name" | "code";
         thousandsSeparator: string;
         decimalSeparator: string;
         showPercentageSymbol: boolean;
@@ -5336,7 +5336,7 @@ declare class Block {
         type: "number" | "currency" | "percentage";
         decimals: number;
         currency: string;
-        currencyDisplay: "symbol" | "code" | "name";
+        currencyDisplay: "symbol" | "name" | "code";
         thousandsSeparator: string;
         decimalSeparator: string;
         showPercentageSymbol: boolean;
@@ -5381,7 +5381,7 @@ declare class Block {
       type: "number" | "currency" | "percentage";
       decimals: number;
       currency: string;
-      currencyDisplay: "symbol" | "code" | "name";
+      currencyDisplay: "symbol" | "name" | "code";
       thousandsSeparator: string;
       decimalSeparator: string;
       showPercentageSymbol: boolean;
@@ -5406,7 +5406,7 @@ declare class Block {
       type: "number" | "currency" | "percentage";
       decimals: number;
       currency: string;
-      currencyDisplay: "symbol" | "code" | "name";
+      currencyDisplay: "symbol" | "name" | "code";
       thousandsSeparator: string;
       decimalSeparator: string;
       showPercentageSymbol: boolean;
@@ -5416,7 +5416,7 @@ declare class Block {
       suffix?: string | undefined;
     } | undefined;
     change?: string | number | undefined;
-    changeType?: "positive" | "negative" | "neutral" | undefined;
+    changeType?: "neutral" | "positive" | "negative" | undefined;
     chart?: {
       values: (number | {
         value: number;
@@ -5436,14 +5436,14 @@ declare class Block {
       type: "chart";
       max: number;
       chartType: "progress-bar";
-      variant: "error" | "success" | "default" | "neutral" | "warning";
+      variant: "error" | "default" | "success" | "neutral" | "warning";
       label?: string | number | undefined;
     } | {
       value: number;
       type: "chart";
       max: number;
       chartType: "progress-circle";
-      variant: "error" | "success" | "default" | "neutral" | "warning";
+      variant: "error" | "default" | "success" | "neutral" | "warning";
       radius: number;
     } | {
       data: Record<string, any>[];
@@ -5486,7 +5486,7 @@ declare class Block {
         type: "default";
       } | {
         type: "badge";
-        variant: "error" | "success" | "default" | "neutral" | "warning";
+        variant: "error" | "default" | "success" | "neutral" | "warning";
       } | {
         type: "image";
         width: number;
@@ -5496,7 +5496,7 @@ declare class Block {
         type: "progress";
         chartType: "bar" | "circle";
         maxValue: number;
-        variant: "error" | "success" | "default" | "neutral" | "warning";
+        variant: "error" | "default" | "success" | "neutral" | "warning";
       } | {
         type: "link";
         target: "_blank" | "_self";
@@ -5507,7 +5507,7 @@ declare class Block {
         type: "number" | "currency" | "percentage";
         decimals: number;
         currency: string;
-        currencyDisplay: "symbol" | "code" | "name";
+        currencyDisplay: "symbol" | "name" | "code";
         thousandsSeparator: string;
         decimalSeparator: string;
         showPercentageSymbol: boolean;
@@ -5572,7 +5572,7 @@ declare class Block {
           type: "number" | "currency" | "percentage";
           decimals: number;
           currency: string;
-          currencyDisplay: "symbol" | "code" | "name";
+          currencyDisplay: "symbol" | "name" | "code";
           thousandsSeparator: string;
           decimalSeparator: string;
           showPercentageSymbol: boolean;
@@ -5582,7 +5582,7 @@ declare class Block {
           suffix?: string | undefined;
         } | undefined;
         change?: string | number | undefined;
-        changeType?: "positive" | "negative" | "neutral" | undefined;
+        changeType?: "neutral" | "positive" | "negative" | undefined;
         chart?: {
           values: (number | {
             value: number;
@@ -5602,14 +5602,14 @@ declare class Block {
           type: "chart";
           max: number;
           chartType: "progress-bar";
-          variant: "error" | "success" | "default" | "neutral" | "warning";
+          variant: "error" | "default" | "success" | "neutral" | "warning";
           label?: string | number | undefined;
         } | {
           value: number;
           type: "chart";
           max: number;
           chartType: "progress-circle";
-          variant: "error" | "success" | "default" | "neutral" | "warning";
+          variant: "error" | "default" | "success" | "neutral" | "warning";
           radius: number;
         } | {
           data: Record<string, any>[];
@@ -5654,7 +5654,7 @@ declare class Block {
           type: "number" | "currency" | "percentage";
           decimals: number;
           currency: string;
-          currencyDisplay: "symbol" | "code" | "name";
+          currencyDisplay: "symbol" | "name" | "code";
           thousandsSeparator: string;
           decimalSeparator: string;
           showPercentageSymbol: boolean;
@@ -5687,7 +5687,7 @@ declare class Block {
           type: "number" | "currency" | "percentage";
           decimals: number;
           currency: string;
-          currencyDisplay: "symbol" | "code" | "name";
+          currencyDisplay: "symbol" | "name" | "code";
           thousandsSeparator: string;
           decimalSeparator: string;
           showPercentageSymbol: boolean;
@@ -5717,7 +5717,7 @@ declare class Block {
             type: "number" | "currency" | "percentage";
             decimals: number;
             currency: string;
-            currencyDisplay: "symbol" | "code" | "name";
+            currencyDisplay: "symbol" | "name" | "code";
             thousandsSeparator: string;
             decimalSeparator: string;
             showPercentageSymbol: boolean;
@@ -5738,7 +5738,7 @@ declare class Block {
             type: "number" | "currency" | "percentage";
             decimals: number;
             currency: string;
-            currencyDisplay: "symbol" | "code" | "name";
+            currencyDisplay: "symbol" | "name" | "code";
             thousandsSeparator: string;
             decimalSeparator: string;
             showPercentageSymbol: boolean;
@@ -5798,7 +5798,7 @@ declare class Block {
           type: "number" | "currency" | "percentage";
           decimals: number;
           currency: string;
-          currencyDisplay: "symbol" | "code" | "name";
+          currencyDisplay: "symbol" | "name" | "code";
           thousandsSeparator: string;
           decimalSeparator: string;
           showPercentageSymbol: boolean;
@@ -5829,7 +5829,7 @@ declare class Block {
           type: "number" | "currency" | "percentage";
           decimals: number;
           currency: string;
-          currencyDisplay: "symbol" | "code" | "name";
+          currencyDisplay: "symbol" | "name" | "code";
           thousandsSeparator: string;
           decimalSeparator: string;
           showPercentageSymbol: boolean;
@@ -5843,7 +5843,7 @@ declare class Block {
         chartType: "progress-bar";
         value: number;
         max: number;
-        variant: "error" | "success" | "default" | "neutral" | "warning";
+        variant: "error" | "default" | "success" | "neutral" | "warning";
         title?: string | undefined;
         description?: string | undefined;
         label?: string | number | undefined;
@@ -5853,7 +5853,7 @@ declare class Block {
         value: number;
         max: number;
         radius: number;
-        variant: "error" | "success" | "default" | "neutral" | "warning";
+        variant: "error" | "default" | "success" | "neutral" | "warning";
         title?: string | undefined;
         description?: string | undefined;
       } | {
@@ -5901,7 +5901,7 @@ declare class Block {
           type: "number" | "currency" | "percentage";
           decimals: number;
           currency: string;
-          currencyDisplay: "symbol" | "code" | "name";
+          currencyDisplay: "symbol" | "name" | "code";
           thousandsSeparator: string;
           decimalSeparator: string;
           showPercentageSymbol: boolean;
@@ -5924,7 +5924,7 @@ declare class Block {
             type: "default";
           } | {
             type: "badge";
-            variant: "error" | "success" | "default" | "neutral" | "warning";
+            variant: "error" | "default" | "success" | "neutral" | "warning";
           } | {
             type: "image";
             width: number;
@@ -5934,7 +5934,7 @@ declare class Block {
             type: "progress";
             chartType: "bar" | "circle";
             maxValue: number;
-            variant: "error" | "success" | "default" | "neutral" | "warning";
+            variant: "error" | "default" | "success" | "neutral" | "warning";
           } | {
             type: "link";
             target: "_blank" | "_self";
@@ -5945,7 +5945,7 @@ declare class Block {
             type: "number" | "currency" | "percentage";
             decimals: number;
             currency: string;
-            currencyDisplay: "symbol" | "code" | "name";
+            currencyDisplay: "symbol" | "name" | "code";
             thousandsSeparator: string;
             decimalSeparator: string;
             showPercentageSymbol: boolean;

package/dist/components/index.js

@@ -1,4 +1,4 @@
-import { a as TOOL_TAG_NAME, i as TOOL_HANDLER_TAG_NAME, n as AGENT_TAG_NAME, t as AGENT_STEP_TAG_NAME } from "../agent-DBDnKm26.js";
+import { a as AGENT_TAG_NAME, i as AGENT_STEP_TAG_NAME, n as TOOL_TAG_NAME, t as TOOL_HANDLER_TAG_NAME } from "../tool-UVAGtnlr.js";
 
 //#region src/components/tool.ts
 /**

package/dist/{agent-DBDnKm26.js → tool-UVAGtnlr.js}

@@ -1771,6 +1771,47 @@ const agentErrorMessageSchema = baseMessageSchema.extend({
 	})
 });
 
+//#endregion
+//#region ../core/dist/utils.js
+function exponentialBackoff(attempt, initialDelay = 1e3, maxRetryDelay = 3e4, jitterFactor = .5, backoffMultiplier = 2) {
+	let delay = initialDelay * Math.pow(backoffMultiplier, attempt - 1);
+	const jitter = delay * jitterFactor * Math.random();
+	delay += jitter;
+	return Math.min(delay, maxRetryDelay);
+}
+function runWithRetries(fn, retries = 3, config = {}) {
+	let attempt = 0;
+	const execute = async () => {
+		try {
+			return await fn();
+		} catch (error) {
+			if (attempt < retries) {
+				attempt++;
+				await setTimeout(exponentialBackoff(attempt, config.initialDelayMs, config.maxDelayMs, config.backoffMultiplier));
+				return execute();
+			}
+			throw error;
+		}
+	};
+	return execute();
+}
+
+//#endregion
+//#region src/lib/utils.ts
+function convertToWords(input) {
+	if (input.includes("-") || input.includes("_")) return input.split(/[-_]+/).filter((word) => word.length > 0).map((word) => word.toLowerCase());
+	return input.split(/(?=[A-Z])/).filter((word) => word.length > 0).map((word) => word.toLowerCase());
+}
+function invariant(cond, message) {
+	if (!cond) throw new Error(message);
+}
+function getErrorMessage(error, defaultMessage = "Something went wrong. Please try again") {
+	let errorMessage = defaultMessage;
+	if (error instanceof z$1.ZodError) errorMessage = error.issues.length ? error.issues.map((e) => e.message).join(", ") : error.message;
+	else if (error instanceof Error) errorMessage = error.message;
+	return errorMessage;
+}
+
 //#endregion
 //#region src/internal/block.ts
 var Block = class {
@@ -2002,47 +2043,6 @@ var Block = class {
 	}
 };
 
-//#endregion
-//#region ../core/dist/utils.js
-function exponentialBackoff(attempt, initialDelay = 1e3, maxRetryDelay = 3e4, jitterFactor = .5, backoffMultiplier = 2) {
-	let delay = initialDelay * Math.pow(backoffMultiplier, attempt - 1);
-	const jitter = delay * jitterFactor * Math.random();
-	delay += jitter;
-	return Math.min(delay, maxRetryDelay);
-}
-function runWithRetries(fn, retries = 3, config = {}) {
-	let attempt = 0;
-	const execute = async () => {
-		try {
-			return await fn();
-		} catch (error) {
-			if (attempt < retries) {
-				attempt++;
-				await setTimeout(exponentialBackoff(attempt, config.initialDelayMs, config.maxDelayMs, config.backoffMultiplier));
-				return execute();
-			}
-			throw error;
-		}
-	};
-	return execute();
-}
-
-//#endregion
-//#region src/lib/utils.ts
-function convertToWords(input) {
-	if (input.includes("-") || input.includes("_")) return input.split(/[-_]+/).filter((word) => word.length > 0).map((word) => word.toLowerCase());
-	return input.split(/(?=[A-Z])/).filter((word) => word.length > 0).map((word) => word.toLowerCase());
-}
-function invariant(cond, message) {
-	if (!cond) throw new Error(message);
-}
-function getErrorMessage(error, defaultMessage = "Something went wrong. Please try again") {
-	let errorMessage = defaultMessage;
-	if (error instanceof z$1.ZodError) errorMessage = error.issues.length ? error.issues.map((e) => e.message).join(", ") : error.message;
-	else if (error instanceof Error) errorMessage = error.message;
-	return errorMessage;
-}
-
 //#endregion
 //#region src/internal/loader.ts
 var Loader = class {
@@ -2624,73 +2624,6 @@ var IO = class {
 	}
 };
 
-//#endregion
-//#region src/internal/tool.ts
-const TOOL_HANDLER_TAG_NAME = Symbol("TOOL_HANDLER");
-const TOOL_TAG_NAME = Symbol("TOOL");
-/**
-* Tool class is responsible for running the tool's logic.
-* It manages the tool lifecycle, communication with the worker, and handles sending messages back to the ForgeRunner.
-* It uses the IO component to facilitate input/output operations for the tool.
-*/
-var Tool = class {
-	#metadata;
-	#abortController = new AbortController();
-	#handler;
-	#io;
-	#block;
-	#logger;
-	constructor(options, logger) {
-		this.#metadata = options.metadata;
-		this.#handler = options.handler;
-		this.#logger = logger.child({
-			sessionId: this.#metadata.sessionId,
-			component: "TOOL"
-		});
-		this.#io = new IO({
-			sessionId: this.#metadata.sessionId,
-			runnerId: this.#metadata.runnerId,
-			webSocketClient: options.webSocketClient,
-			signal: this.#abortController.signal,
-			executionContext: { type: "TOOL" }
-		}, this.#logger);
-		this.#block = new Block({ signal: this.#abortController.signal });
-		this.#logger.debug("initialized Tool instance");
-	}
-	async run() {
-		return new Promise(async (resolve, reject) => {
-			if (this.#abortController.signal.aborted) {
-				this.#logger.info("tool execution aborted before start");
-				return Promise.reject(/* @__PURE__ */ new Error("tool execution aborted"));
-			}
-			this.#abortController.signal.addEventListener("abort", () => {
-				this.#logger.info("tool execution aborted");
-				reject(/* @__PURE__ */ new Error("Tool execution aborted"));
-			});
-			try {
-				this.#logger.info("running tool handler...");
-				const output = await this.#handler({
-					io: this.#io,
-					signal: this.#abortController.signal,
-					block: this.#block,
-					metadata: this.#metadata
-				});
-				this.#logger.info("tool handler completed successfully");
-				this.#io[STOP_SYMBOL]();
-				resolve(output);
-			} catch (error) {
-				this.#logger.error(error, "error running tool handler");
-				return reject(error);
-			}
-		});
-	}
-	stop() {
-		this.#logger.info("stopping Tool...");
-		this.#abortController.abort();
-		this.#logger.info("Tool stopped");
-	}
-};
-
 //#endregion
 //#region src/internal/workflow-builder.ts
 var WorkflowBuilder = class {
@@ -3090,4 +3023,71 @@ var Agent = class {
 };
 
 //#endregion
-export { __toESM as C, __require as S, startAgentMessageSchema as _, TOOL_TAG_NAME as a, stopToolMessageSchema as b, getErrorMessage as c, runWithRetries as d, ackMessageSchema as f, runnerId as g, initCommunicationMessageSchema as h, TOOL_HANDLER_TAG_NAME as i, invariant as l, heartbeatAckMessageSchema as m, AGENT_TAG_NAME as n, Tool as o, baseMessageSchema as p, Agent as r, convertToWords as s, AGENT_STEP_TAG_NAME as t, exponentialBackoff as u, startToolMessageSchema as v, __commonJS as x, stopAgentMessageSchema as y };
+//#region src/internal/tool.ts
+const TOOL_HANDLER_TAG_NAME = Symbol("TOOL_HANDLER");
+const TOOL_TAG_NAME = Symbol("TOOL");
+/**
+* Tool class is responsible for running the tool's logic.
+* It manages the tool lifecycle, communication with the worker, and handles sending messages back to the ForgeRunner.
+* It uses the IO component to facilitate input/output operations for the tool.
+*/
+var Tool = class {
+	#metadata;
+	#abortController = new AbortController();
+	#handler;
+	#io;
+	#block;
+	#logger;
+	constructor(options, logger) {
+		this.#metadata = options.metadata;
+		this.#handler = options.handler;
+		this.#logger = logger.child({
+			sessionId: this.#metadata.sessionId,
+			component: "TOOL"
+		});
+		this.#io = new IO({
+			sessionId: this.#metadata.sessionId,
+			runnerId: this.#metadata.runnerId,
+			webSocketClient: options.webSocketClient,
+			signal: this.#abortController.signal,
+			executionContext: { type: "TOOL" }
+		}, this.#logger);
+		this.#block = new Block({ signal: this.#abortController.signal });
+		this.#logger.debug("initialized Tool instance");
+	}
+	async run() {
+		return new Promise(async (resolve, reject) => {
+			if (this.#abortController.signal.aborted) {
+				this.#logger.info("tool execution aborted before start");
+				return Promise.reject(/* @__PURE__ */ new Error("tool execution aborted"));
+			}
+			this.#abortController.signal.addEventListener("abort", () => {
+				this.#logger.info("tool execution aborted");
+				reject(/* @__PURE__ */ new Error("Tool execution aborted"));
+			});
+			try {
+				this.#logger.info("running tool handler...");
+				const output = await this.#handler({
+					io: this.#io,
+					signal: this.#abortController.signal,
+					block: this.#block,
+					metadata: this.#metadata
+				});
+				this.#logger.info("tool handler completed successfully");
+				this.#io[STOP_SYMBOL]();
+				resolve(output);
+			} catch (error) {
+				this.#logger.error(error, "error running tool handler");
+				return reject(error);
+			}
+		});
+	}
+	stop() {
+		this.#logger.info("stopping Tool...");
+		this.#abortController.abort();
+		this.#logger.info("Tool stopped");
+	}
+};
+
+//#endregion
+export { __toESM as C, __require as S, startAgentMessageSchema as _, AGENT_TAG_NAME as a, stopToolMessageSchema as b, getErrorMessage as c, runWithRetries as d, ackMessageSchema as f, runnerId as g, initCommunicationMessageSchema as h, AGENT_STEP_TAG_NAME as i, invariant as l, heartbeatAckMessageSchema as m, TOOL_TAG_NAME as n, Agent as o, baseMessageSchema as p, Tool as r, convertToWords as s, TOOL_HANDLER_TAG_NAME as t, exponentialBackoff as u, startToolMessageSchema as v, __commonJS as x, stopAgentMessageSchema as y };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolforge-js/sdk",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "type": "module",
   "files": [
     "dist",
@@ -21,6 +21,7 @@
     "es-toolkit": "1.39.10",
     "esbuild": "0.27.0",
     "nanoid": "5.1.5",
+    "ora": "9.0.0",
     "picocolors": "1.1.1",
     "pino": "9.11.0",
     "pino-pretty": "13.1.1",
@@ -34,6 +35,6 @@
     "typescript": "5.9.2"
   },
   "bin": {
-    "toolforge-js": "index.js"
+    "toolforge": "index.js"
   }
 }