@notionhq/workers 0.0.85 → 0.1.0

package/dist/worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,EACf,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EACX,+BAA+B,EAC/B,eAAe,EACf,kBAAkB,EAClB,6BAA6B,EAC7B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhF,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5D,YAAY,EACX,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,+BAA+B,EAC/B,6BAA6B,EAC7B,iBAAiB,EACjB,iBAAiB,GACjB,CAAC;AAMF,KAAK,UAAU,GACZ,cAAc,GAEd,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,GACxB,oBAAoB,GACpB,eAAe,CAAC;AAMnB,qBAAa,MAAM;;IAGlB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8CG;IACH,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,EAC9D,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,iBAAiB,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,GACvC,cAAc;IAOjB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,IAAI,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,SAAS,SAAS,GAAG,SAAS,EACxD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC7B,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;IAQvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,UAAU,CACT,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,uBAAuB,GAC7B,oBAAoB;IAOvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,eAAe;IAO/D;;OAEG;IACH,IAAI,YAAY,IAAI,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC,EAAE,CAMhE;IAED;;;;;;;OAOG;IACG,GAAG,CACR,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,cAAmB,GAC1B,OAAO,CAAC,OAAO,CAAC;CAyBnB"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,EACf,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EACX,+BAA+B,EAC/B,eAAe,EACf,kBAAkB,EAClB,6BAA6B,EAC7B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhF,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5D,YAAY,EACX,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,+BAA+B,EAC/B,6BAA6B,EAC7B,iBAAiB,EACjB,iBAAiB,GACjB,CAAC;AAMF,KAAK,UAAU,GACZ,cAAc,GAEd,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,GACxB,oBAAoB,GACpB,eAAe,CAAC;AAMnB,qBAAa,MAAM;;IAGlB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8CG;IACH,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,EAC9D,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,iBAAiB,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,GACvC,cAAc;IAOjB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,IAAI,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,SAAS,SAAS,GAAG,SAAS,EACxD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC7B,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;IAQvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,UAAU,CACT,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,uBAAuB,GAC7B,oBAAoB;IAOvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,eAAe;IAO/D;;OAEG;IACH,IAAI,YAAY,IAAI,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC,EAAE,CAMhE;IAED;;;;;;;OAOG;IACG,GAAG,CACR,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,cAAmB,GAC1B,OAAO,CAAC,OAAO,CAAC;CAyBnB"}

package/dist/worker.js

@@ -63,23 +63,18 @@ class Worker {
    * Example:
    *
    * ```ts
+   * import { j } from "@notionhq/workers/schema-builder";
+   *
    * worker.tool<{ name: string }, string>("sayHello", {
    *   title: "Say Hello",
    *   description: "Say hello to the user",
-   *   schema: {
-   *     type: "object",
-   *     properties: {
-   *       name: { type: "string" },
-   *     },
-   *     required: ["name"],
-   *   },
+   *   schema: j.object({ name: j.string() }),
    *   execute: ({ name }, { notion }) => {
    *     return `Hello, ${name}!`;
    *   },
    * })
    * ```
    *
-   *
    * @param key - The unique key for this capability.
    * @param config - The tool configuration.
    * @returns The capability object.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@notionhq/workers",
-	"version": "0.0.85",
+	"version": "0.1.0",
 	"description": "An SDK for building workers for the Notion Workers platform",
 	"license": "MIT",
 	"type": "module",
@@ -25,6 +25,10 @@
 			"types": "./dist/error.d.ts",
 			"default": "./dist/error.js"
 		},
+		"./schema-builder": {
+			"types": "./dist/schema-builder.d.ts",
+			"default": "./dist/schema-builder.js"
+		},
 		"./types": {
 			"types": "./dist/types.d.ts",
 			"default": "./dist/types.js"

package/src/builder.test.ts

@@ -0,0 +1,229 @@
+import { describe, expect, it } from "vitest";
+import * as Builder from "./builder.js";
+
+/**
+ * Helper to extract the DateValue from a date token.
+ * Date tokens have the shape [["\u2023", [["d", dateValue]]]].
+ */
+// biome-ignore lint/suspicious/noExplicitAny: test helper
+function extractDateValue(token: unknown): any {
+	// biome-ignore lint/suspicious/noExplicitAny: test helper
+	const arr = token as any;
+	return arr[0][1][0][1];
+}
+
+describe("Builder.date", () => {
+	it("creates a date token from YYYY-MM-DD", () => {
+		expect(extractDateValue(Builder.date("2024-01-15"))).toEqual({
+			type: "date",
+			start_date: "2024-01-15",
+		});
+	});
+
+	it("rejects non-YYYY-MM-DD strings", () => {
+		expect(() => Builder.date("01-15-2024")).toThrow("Expected YYYY-MM-DD");
+		expect(() => Builder.date("2024/01/15")).toThrow("Expected YYYY-MM-DD");
+		expect(() => Builder.date("2024-1-5")).toThrow("Expected YYYY-MM-DD");
+	});
+
+	it("rejects invalid calendar dates", () => {
+		expect(() => Builder.date("2024-13-01")).toThrow();
+		// Note: "2024-02-30" is silently coerced by JS Date (rolls to March 1st),
+		// so the current validator does not catch it.
+	});
+});
+
+describe("Builder.dateTime", () => {
+	it("parses minimal ISO 8601 (YYYY-MM-DDTHH:mm)", () => {
+		expect(extractDateValue(Builder.dateTime("2024-01-15T10:30"))).toEqual({
+			type: "datetime",
+			start_date: "2024-01-15",
+			start_time: "10:30",
+		});
+	});
+
+	it("parses ISO 8601 with seconds", () => {
+		expect(extractDateValue(Builder.dateTime("2024-01-15T10:30:45"))).toEqual({
+			type: "datetime",
+			start_date: "2024-01-15",
+			start_time: "10:30",
+		});
+	});
+
+	it("parses ISO 8601 with Z suffix", () => {
+		expect(extractDateValue(Builder.dateTime("2024-01-15T10:30:00Z"))).toEqual({
+			type: "datetime",
+			start_date: "2024-01-15",
+			start_time: "10:30",
+		});
+	});
+
+	it("parses ISO 8601 with positive timezone offset", () => {
+		expect(
+			extractDateValue(Builder.dateTime("2024-01-15T10:30:00+05:30")),
+		).toEqual({
+			type: "datetime",
+			start_date: "2024-01-15",
+			start_time: "10:30",
+		});
+	});
+
+	it("parses ISO 8601 with negative timezone offset", () => {
+		expect(
+			extractDateValue(Builder.dateTime("2024-01-15T10:30:00-08:00")),
+		).toEqual({
+			type: "datetime",
+			start_date: "2024-01-15",
+			start_time: "10:30",
+		});
+	});
+
+	it("parses ISO 8601 with milliseconds", () => {
+		expect(
+			extractDateValue(Builder.dateTime("2024-01-15T10:30:00.000Z")),
+		).toEqual({
+			type: "datetime",
+			start_date: "2024-01-15",
+			start_time: "10:30",
+		});
+	});
+
+	it("includes timeZone when provided", () => {
+		expect(
+			extractDateValue(
+				Builder.dateTime("2024-01-15T10:30", "America/New_York"),
+			),
+		).toEqual({
+			type: "datetime",
+			start_date: "2024-01-15",
+			start_time: "10:30",
+			time_zone: "America/New_York",
+		});
+	});
+
+	it("handles midnight", () => {
+		expect(extractDateValue(Builder.dateTime("2024-01-15T00:00"))).toEqual({
+			type: "datetime",
+			start_date: "2024-01-15",
+			start_time: "00:00",
+		});
+	});
+
+	it("handles end of day", () => {
+		expect(extractDateValue(Builder.dateTime("2024-01-15T23:59"))).toEqual({
+			type: "datetime",
+			start_date: "2024-01-15",
+			start_time: "23:59",
+		});
+	});
+
+	it("rejects date-only strings", () => {
+		expect(() => Builder.dateTime("2024-01-15")).toThrow(
+			"Invalid ISO 8601 datetime",
+		);
+	});
+
+	it("rejects plain text", () => {
+		expect(() => Builder.dateTime("not a date")).toThrow(
+			"Invalid ISO 8601 datetime",
+		);
+	});
+
+	it("rejects empty string", () => {
+		expect(() => Builder.dateTime("")).toThrow("Invalid ISO 8601 datetime");
+	});
+
+	it("rejects date with space instead of T", () => {
+		expect(() => Builder.dateTime("2024-01-15 10:30")).toThrow(
+			"Invalid ISO 8601 datetime",
+		);
+	});
+});
+
+describe("Builder.dateRange", () => {
+	it("creates a date range token", () => {
+		expect(
+			extractDateValue(Builder.dateRange("2024-01-15", "2024-01-20")),
+		).toEqual({
+			type: "daterange",
+			start_date: "2024-01-15",
+			end_date: "2024-01-20",
+		});
+	});
+
+	it("rejects invalid start date", () => {
+		expect(() => Builder.dateRange("bad", "2024-01-20")).toThrow(
+			"Expected YYYY-MM-DD",
+		);
+	});
+
+	it("rejects invalid end date", () => {
+		expect(() => Builder.dateRange("2024-01-15", "bad")).toThrow(
+			"Expected YYYY-MM-DD",
+		);
+	});
+});
+
+describe("Builder.dateTimeRange", () => {
+	it("creates a datetime range token from ISO strings", () => {
+		expect(
+			extractDateValue(
+				Builder.dateTimeRange("2024-01-15T10:30", "2024-01-16T14:00"),
+			),
+		).toEqual({
+			type: "datetimerange",
+			start_date: "2024-01-15",
+			start_time: "10:30",
+			end_date: "2024-01-16",
+			end_time: "14:00",
+		});
+	});
+
+	it("parses mixed ISO formats", () => {
+		expect(
+			extractDateValue(
+				Builder.dateTimeRange(
+					"2024-01-15T10:30:00Z",
+					"2024-01-16T14:00:00.000+05:00",
+				),
+			),
+		).toEqual({
+			type: "datetimerange",
+			start_date: "2024-01-15",
+			start_time: "10:30",
+			end_date: "2024-01-16",
+			end_time: "14:00",
+		});
+	});
+
+	it("includes timeZone when provided", () => {
+		expect(
+			extractDateValue(
+				Builder.dateTimeRange(
+					"2024-01-15T10:30",
+					"2024-01-16T14:00",
+					"Europe/London",
+				),
+			),
+		).toEqual({
+			type: "datetimerange",
+			start_date: "2024-01-15",
+			start_time: "10:30",
+			end_date: "2024-01-16",
+			end_time: "14:00",
+			time_zone: "Europe/London",
+		});
+	});
+
+	it("rejects invalid start datetime", () => {
+		expect(() =>
+			Builder.dateTimeRange("2024-01-15", "2024-01-16T14:00"),
+		).toThrow("Invalid ISO 8601 datetime");
+	});
+
+	it("rejects invalid end datetime", () => {
+		expect(() =>
+			Builder.dateTimeRange("2024-01-15T10:30", "2024-01-16"),
+		).toThrow("Invalid ISO 8601 datetime");
+	});
+});

package/src/builder.ts

@@ -92,13 +92,17 @@ export function date(dateString: string): TextValue {
 }
 
 /**
- * Creates a datetime value from a Date object.
+ * Creates a datetime value from an ISO 8601 datetime string.
+ * @param isoString - An ISO 8601 datetime string (e.g., "2024-01-15T10:30", "2024-01-15T10:30:00Z")
+ * @param timeZone - Optional IANA timezone name (e.g., "America/New_York")
  */
-export function dateTime(date: Date, timeZone?: string): TextValue {
+export function dateTime(isoString: string, timeZone?: string): TextValue {
+	const { date, time } = parseISODateTime(isoString);
+
 	const dateValue: DateValue = {
 		type: "datetime",
-		start_date: formatDate(date),
-		start_time: formatTime(date),
+		start_date: date,
+		start_time: time,
 	};
 
 	if (timeZone) {
@@ -125,19 +129,25 @@ export function dateRange(startDate: string, endDate: string): TextValue {
 }
 
 /**
- * Creates a datetime range value from Date objects.
+ * Creates a datetime range value from ISO 8601 datetime strings.
+ * @param startDateTime - An ISO 8601 datetime string for the range start
+ * @param endDateTime - An ISO 8601 datetime string for the range end
+ * @param timeZone - Optional IANA timezone name (e.g., "America/New_York")
  */
 export function dateTimeRange(
-	startDate: Date,
-	endDate: Date,
+	startDateTime: string,
+	endDateTime: string,
 	timeZone?: string,
 ): TextValue {
+	const start = parseISODateTime(startDateTime);
+	const end = parseISODateTime(endDateTime);
+
 	const dateValue: DateValue = {
 		type: "datetimerange",
-		start_date: formatDate(startDate),
-		start_time: formatTime(startDate),
-		end_date: formatDate(endDate),
-		end_time: formatTime(endDate),
+		start_date: start.date,
+		start_time: start.time,
+		end_date: end.date,
+		end_time: end.time,
 	};
 
 	if (timeZone) {
@@ -242,22 +252,25 @@ function createDateToken(dateValue: DateValue): TextValue {
 }
 
 /**
- * Formats a Date object to YYYY-MM-DD string.
+ * Parses an ISO 8601 datetime string into date and time components.
+ * Accepts formats like "2024-01-15T10:30", "2024-01-15T10:30:00Z",
+ * "2024-01-15T10:30:00.000+05:00", etc.
  */
-function formatDate(date: Date): string {
-	const year = date.getFullYear();
-	const month = String(date.getMonth() + 1).padStart(2, "0");
-	const day = String(date.getDate()).padStart(2, "0");
-	return `${year}-${month}-${day}`;
-}
+function parseISODateTime(isoString: string): { date: string; time: string } {
+	if (!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}/.test(isoString)) {
+		throw new Error(
+			`Invalid ISO 8601 datetime: ${isoString}. Expected format like 2024-01-15T10:30 or 2024-01-15T10:30:00Z`,
+		);
+	}
 
-/**
- * Formats a Date object to HH:mm string.
- */
-function formatTime(date: Date): string {
-	const hours = String(date.getHours()).padStart(2, "0");
-	const minutes = String(date.getMinutes()).padStart(2, "0");
-	return `${hours}:${minutes}`;
+	const date = isoString.slice(0, 10);
+	const time = isoString.slice(11, 16);
+
+	if (Number.isNaN(new Date(isoString).getTime())) {
+		throw new Error(`Invalid datetime: ${isoString}`);
+	}
+
+	return { date, time };
 }
 
 /**

package/src/capabilities/automation.test.ts

@@ -59,7 +59,7 @@ describe("createAutomationCapability", () => {
 			}),
 		);
 		expect(stdoutSpy).toHaveBeenCalledWith(
-			`\n<output>{"status":"success"}</output>\n`,
+			`\n<output>{"_tag":"success","value":{"status":"success"}}</output>\n`,
 		);
 	});
 
@@ -105,7 +105,7 @@ describe("createAutomationCapability", () => {
 			}),
 		);
 		expect(stdoutSpy).toHaveBeenCalledWith(
-			`\n<output>{"status":"success"}</output>\n`,
+			`\n<output>{"_tag":"success","value":{"status":"success"}}</output>\n`,
 		);
 	});
 
@@ -126,7 +126,9 @@ describe("createAutomationCapability", () => {
 		await expect(capability.handler(event)).rejects.toThrow(ExecutionError);
 
 		expect(stdoutSpy).toHaveBeenCalledWith(
-			`\n<output>{"status":"error","error":{"name":"ExecutionError","message":"Error during worker execution: Error: Something went wrong"}}</output>\n`,
+			expect.stringContaining(
+				`"_tag":"error","error":{"name":"ExecutionError","message":"Error during worker execution: Error: Something went wrong"`,
+			),
 		);
 	});
 
@@ -146,7 +148,9 @@ describe("createAutomationCapability", () => {
 		await expect(capability.handler(event)).rejects.toThrow(ExecutionError);
 
 		expect(stdoutSpy).toHaveBeenCalledWith(
-			`\n<output>{"status":"error","error":{"name":"ExecutionError","message":"Error during worker execution: String error"}}</output>\n`,
+			expect.stringContaining(
+				`"_tag":"error","error":{"name":"ExecutionError","message":"Error during worker execution: String error"`,
+			),
 		);
 	});
 });

package/src/capabilities/automation.ts

@@ -111,7 +111,7 @@ export function createAutomationCapability(
 					return { status: "success" };
 				} else {
 					process.stdout.write(
-						`\n<output>${JSON.stringify({ status: "success" })}</output>\n`,
+						`\n<output>${JSON.stringify({ _tag: "success", value: { status: "success" } })}</output>\n`,
 					);
 				}
 			} catch (err) {
@@ -119,7 +119,7 @@ export function createAutomationCapability(
 
 				if (!options?.concreteOutput) {
 					process.stdout.write(
-						`\n<output>${JSON.stringify({ status: "error", error: { name: error.name, message: error.message } })}</output>\n`,
+						`\n<output>${JSON.stringify({ _tag: "error", error: { name: error.name, message: error.message, trace: error.stack } })}</output>\n`,
 					);
 				}
 

package/src/capabilities/sync.test.ts

@@ -1,9 +1,30 @@
-import { describe, expect, it } from "vitest";
+import {
+	afterEach,
+	beforeEach,
+	describe,
+	expect,
+	it,
+	type Mock,
+	vi,
+} from "vitest";
 import * as Builder from "../builder.js";
+import { ExecutionError } from "../error.js";
 import * as Schema from "../schema.js";
 import { createSyncCapability } from "./sync.js";
 
 describe("Worker.sync", () => {
+	let stdoutSpy: Mock<typeof process.stdout.write>;
+
+	beforeEach(() => {
+		stdoutSpy = vi
+			.spyOn(process.stdout, "write")
+			.mockImplementation(() => true);
+	});
+
+	afterEach(() => {
+		vi.restoreAllMocks();
+	});
+
 	describe("Schema.relation", () => {
 		it("creates a relation property configuration", () => {
 			const relationProp = Schema.relation("projectsSync");
@@ -101,4 +122,52 @@ describe("Worker.sync", () => {
 			expect(capability.config.primaryKeyProperty).toBe("Task ID");
 		});
 	});
+
+	describe("handler output envelope", () => {
+		it("wraps successful result in success envelope", async () => {
+			const capability = createSyncCapability("testSync", {
+				primaryKeyProperty: "ID",
+				schema: {
+					defaultName: "Test",
+					properties: {
+						ID: Schema.title(),
+					},
+				},
+				execute: async () => ({
+					changes: [],
+					hasMore: false,
+				}),
+			});
+
+			await capability.handler();
+
+			expect(stdoutSpy).toHaveBeenCalledWith(
+				`\n<output>${JSON.stringify({ _tag: "success", value: { changes: [], hasMore: false, nextUserContext: undefined } })}</output>\n`,
+			);
+		});
+
+		it("wraps error in error envelope", async () => {
+			const capability = createSyncCapability("errorSync", {
+				primaryKeyProperty: "ID",
+				schema: {
+					defaultName: "Test",
+					properties: {
+						ID: Schema.title(),
+					},
+				},
+				execute: async () => {
+					throw new Error("sync failed");
+				},
+			});
+
+			await expect(capability.handler()).rejects.toThrow(ExecutionError);
+
+			expect(stdoutSpy).toHaveBeenCalledWith(
+				expect.stringContaining(`"_tag":"error"`),
+			);
+			expect(stdoutSpy).toHaveBeenCalledWith(
+				expect.stringContaining(`"name":"ExecutionError"`),
+			);
+		});
+	});
 });

package/src/capabilities/sync.ts

@@ -227,11 +227,21 @@ export function createSyncCapability<
 		) {
 			const capabilityContext = createCapabilityContext();
 			const state = runtimeContext?.state ?? runtimeContext?.userContext;
-			const executionResult = await syncConfiguration
-				.execute(state, capabilityContext)
-				.catch((err) => {
-					throw new ExecutionError(err);
-				});
+			let executionResult: SyncExecutionResult<PK, Context>;
+			try {
+				executionResult = await syncConfiguration.execute(
+					state,
+					capabilityContext,
+				);
+			} catch (err) {
+				const error = new ExecutionError(err);
+				if (!options?.concreteOutput) {
+					process.stdout.write(
+						`\n<output>${JSON.stringify({ _tag: "error", error: { name: error.name, message: error.message } })}</output>\n`,
+					);
+				}
+				throw error;
+			}
 
 			const result = {
 				changes: executionResult.changes,
@@ -242,7 +252,9 @@ export function createSyncCapability<
 			if (options?.concreteOutput) {
 				return result;
 			} else {
-				process.stdout.write(`\n<output>${JSON.stringify(result)}</output>\n`);
+				process.stdout.write(
+					`\n<output>${JSON.stringify({ _tag: "success", value: result })}</output>\n`,
+				);
 			}
 
 			return result;