@toolforge-js/sdk 0.7.0 → 0.8.2

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-DDDEH8M3.js";
 
 //#region src/components/tool.ts
 /**

package/dist/config/index.d.ts

@@ -10,6 +10,10 @@ type ToolForgeConfig = {
   apiKey: string;
   /** Optional URL for the SDK server (overrides default). */
   sdkServer?: string;
+  /** Optional URL for the Tool Forge app server (overrides default). */
+  appServerUrl?: string;
+  /** Optional URL for the Tool Forge app (overrides default). */
+  appUrl?: string;
 };
 /**
  * Define and validate Tool Forge SDK configuration.
@@ -20,7 +24,10 @@ declare function defineConfig(input: ToolForgeConfig): {
   toolsDir: string;
   apiKey: string;
   sdkServer: string;
+  appServerUrl: string;
+  appUrl: string;
   maxRetries: number;
+  __tf__tag__name__: symbol;
 };
 //#endregion
 export { defineConfig };

package/dist/config/index.js

@@ -1,4 +1,4 @@
-import { t as toolForgeConfigSchema } from "../config-schema-CcWOtgOv.js";
+import { n as toolForgeConfigSchema, t as TF_CONFIG_TAG_NAME } from "../config-schema-DcLVggqh.js";
 
 //#region src/config/index.ts
 /**
@@ -7,7 +7,10 @@ import { t as toolForgeConfigSchema } from "../config-schema-CcWOtgOv.js";
 * @param config - The configuration object for Tool Forge SDK.
 */
 function defineConfig(input) {
-	return toolForgeConfigSchema.parse(input);
+	return {
+		__tf__tag__name__: TF_CONFIG_TAG_NAME,
+		...toolForgeConfigSchema.parse(input)
+	};
 }
 
 //#endregion

package/dist/config-schema-DcLVggqh.js

@@ -0,0 +1,19 @@
+import * as z$1 from "zod";
+
+//#region ../core/dist/token/index.js
+const TOKEN_PREFIX = "tf_token--";
+
+//#endregion
+//#region src/config/config-schema.ts
+const toolForgeConfigSchema = z$1.object({
+	toolsDir: z$1.string().describe("Directory where the tools are located").optional().default("tools"),
+	apiKey: z$1.string().describe("API key for authenticating with the Tool Forge platform").refine((val) => val.startsWith("sk_live") || val.startsWith("pk_test") || val.startsWith(TOKEN_PREFIX), { message: `API key must start with sk_live, pk_test or ${TOKEN_PREFIX}` }).describe("API key for authenticating with the Tool Forge platform."),
+	sdkServer: z$1.url().describe("URL of the Tool Forge SDK server").optional().default("https://sdk.tool-forge.ai"),
+	appServerUrl: z$1.url().optional().describe("URL of the Tool Forge application server").default("https://api.tool-forge.ai"),
+	appUrl: z$1.url().optional().describe("URL of the Tool Forge application").default("https://app.tool-forge.ai"),
+	maxRetries: z$1.number().optional().default(100)
+});
+const TF_CONFIG_TAG_NAME = Symbol("TOOL_FORGE_CONFIG");
+
+//#endregion
+export { toolForgeConfigSchema as n, TOKEN_PREFIX as r, TF_CONFIG_TAG_NAME as t };

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

@@ -1,8 +1,8 @@
 import { createRequire } from "node:module";
 import * as z$1 from "zod";
+import { nanoid } from "nanoid";
 import { P, match } from "ts-pattern";
 import { setTimeout } from "node:timers/promises";
-import { nanoid } from "nanoid";
 
 //#region rolldown:runtime
 var __create = Object.create;
@@ -30,6 +30,22 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
+//#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 ../../node_modules/.bun/dayjs@1.11.18/node_modules/dayjs/dayjs.min.js
 var require_dayjs_min = /* @__PURE__ */ __commonJS({ "../../node_modules/.bun/dayjs@1.11.18/node_modules/dayjs/dayjs.min.js": ((exports, module) => {
@@ -1234,9 +1250,24 @@ const layoutBlockSchema = z$1.object({
 	columns: z$1.number().optional().default(12),
 	children: layoutChildren.array()
 });
+const timelineBlockSchema = z$1.object({
+	type: z$1.literal("timeline"),
+	items: z$1.array(z$1.object({
+		title: z$1.string().optional(),
+		content: z$1.string()
+	})),
+	orientation: z$1.enum(["horizontal", "vertical"]).optional().default("vertical"),
+	mode: z$1.enum([
+		"start",
+		"end",
+		"alternate"
+	]).optional().default("start"),
+	reverse: z$1.boolean().optional().default(false)
+});
 const blockSchema = z$1.discriminatedUnion("type", [
 	kpiCardSchema,
 	chartBlock,
+	timelineBlockSchema,
 	layoutBlockSchema,
 	tableBlockSchema,
 	imageBlockSchema,
@@ -1420,7 +1451,12 @@ const runnerId = z$1.string().regex(/^tf-runner:[A-Za-z0-9_-]{32}$/, { message:
 const clientId = z$1.string().regex(/^tf-client:[A-Za-z0-9_-]{32}$/, { message: "runnerId must start with \"tf-runner:\" followed by a 32-character nanoid" });
 const sdkServerId = z$1.string().regex(/^tf-ss:[A-Za-z0-9_-]{32}$/, { message: "serverId must start with \"tf-ss:\" followed by a 32-character nanoid" });
 const appServerId = z$1.string().regex(/^tf-as:[A-Za-z0-9_-]{32}$/, { message: "serverId must start with \"tf-ss:\" followed by a 32-character nanoid" });
-const serverId = z$1.union([sdkServerId, appServerId]);
+const ciServerId = z$1.string().regex(/^tf-cs:[A-Za-z0-9_-]{32}$/, { message: "serverId must start with \"tf-cs:\" followed by a 32-character nanoid" });
+const serverId = z$1.union([
+	sdkServerId,
+	appServerId,
+	ciServerId
+]);
 const ackMessageSchema = baseMessageSchema.extend({
 	type: z$1.literal("ACK"),
 	rootMessageId: z$1.string(),
@@ -1770,6 +1806,26 @@ const agentErrorMessageSchema = baseMessageSchema.extend({
 		executionContext: executionContextSchema
 	})
 });
+const inviteEmailMessageSchema = baseMessageSchema.extend({
+	type: z$1.literal("invite-email"),
+	payload: z$1.object({
+		email: z$1.email(),
+		inviteLink: z$1.url(),
+		role: z$1.string(),
+		inviterEmail: z$1.string(),
+		inviterName: z$1.string(),
+		workspaceName: z$1.string()
+	})
+});
+const deployForgeMessageSchema = baseMessageSchema.extend({
+	type: z$1.literal("deploy-forge"),
+	payload: z$1.object({
+		deploymentId: z$1.uuid(),
+		environmentId: z$1.uuid(),
+		workspaceId: z$1.string(),
+		sha256: z$1.string().min(64).max(64)
+	})
+});
 
 //#endregion
 //#region src/internal/block.ts
@@ -2000,6 +2056,17 @@ var Block = class {
 			...props
 		});
 	}
+	/**
+	* Creates a timeline block.
+	*
+	* A timeline block displays a sequence of events in chronological order.
+	*/
+	timeline(props) {
+		return timelineBlockSchema.parse({
+			type: "timeline",
+			...props
+		});
+	}
 };
 
 //#endregion
@@ -2027,22 +2094,6 @@ function runWithRetries(fn, retries = 3, config = {}) {
 	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 {
@@ -2384,7 +2435,7 @@ var IO = class {
 	/**
 	* Prompts the user for a text input.
 	*/
-	async textInput({ label, description, optional, secure, inputType, mode, maxRetryAttempts = 5, validationSchema, defaultValue }) {
+	async textInput({ label, description, optional, secure, inputType, mode, min, max, maxRetryAttempts = 5, validationSchema, defaultValue }) {
 		const form = { value: {
 			type: "text",
 			label,
@@ -2392,6 +2443,8 @@ var IO = class {
 			optional,
 			secure,
 			mode,
+			min,
+			max,
 			inputType
 		} };
 		const stringValidationSchema = validationSchema ?? getValidationSchemaForField(form.value);
@@ -2624,73 +2677,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 +3076,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, stopToolMessageSchema as _, AGENT_TAG_NAME as a, invariant as b, runWithRetries as c, heartbeatAckMessageSchema as d, initCommunicationMessageSchema as f, stopAgentMessageSchema as g, startToolMessageSchema as h, AGENT_STEP_TAG_NAME as i, ackMessageSchema as l, startAgentMessageSchema as m, TOOL_TAG_NAME as n, Agent as o, runnerId as p, Tool as r, exponentialBackoff as s, TOOL_HANDLER_TAG_NAME as t, baseMessageSchema as u, convertToWords as v, __commonJS as x, getErrorMessage as y };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolforge-js/sdk",
-  "version": "0.7.0",
+  "version": "0.8.2",
   "type": "module",
   "files": [
     "dist",
@@ -17,23 +17,29 @@
     }
   },
   "dependencies": {
+    "@clack/prompts": "0.11.0",
+    "better-auth": "1.3.34",
+    "bumpp": "10.4.0",
     "chokidar": "4.0.3",
     "es-toolkit": "1.39.10",
     "esbuild": "0.27.0",
+    "hono": "4.9.7",
     "nanoid": "5.1.5",
+    "ora": "9.0.0",
     "picocolors": "1.1.1",
     "pino": "9.11.0",
     "pino-pretty": "13.1.1",
+    "tar": "7.5.2",
     "ts-pattern": "5.8.0",
     "zod": "4.1.12"
   },
   "devDependencies": {
-    "@types/bun": "1.3.1",
-    "@types/node": "24.0.7",
+    "@types/bun": "1.3.3",
+    "@types/node": "24.10.0",
     "commander": "14.0.2",
-    "typescript": "5.9.2"
+    "typescript": "5.9.3"
   },
   "bin": {
-    "toolforge-js": "index.js"
+    "toolforge": "index.js"
   }
 }

package/dist/config-schema-CcWOtgOv.js

@@ -1,12 +0,0 @@
-import * as z$1 from "zod";
-
-//#region src/config/config-schema.ts
-const toolForgeConfigSchema = z$1.object({
-	toolsDir: z$1.string().optional().default("tools"),
-	apiKey: z$1.string().refine((val) => val.startsWith("sk_live") || val.startsWith("pk_test"), { message: "API key must start with sk_live or pk_test" }).describe("API key for authenticating with the Tool Forge platform."),
-	sdkServer: z$1.url().optional().default("https://sdk.tool-forge.ai"),
-	maxRetries: z$1.number().optional().default(100)
-});
-
-//#endregion
-export { toolForgeConfigSchema as t };