@notionhq/apps 0.0.45 → 0.0.47

package/README.md

@@ -101,7 +101,7 @@ export default workflow({
 	description: "Schedules a follow-up after a page is created",
 	triggers: [events.notionPageCreated()],
 	connections: {
-		calendar: connections.calendar({ scope: "read", readTeammatesCalendars: false }),
+		calendar: connections.calendar({ permissions: "read", readTeammatesCalendars: false }),
 	},
 	handler: async () => {},
 });
@@ -174,6 +174,16 @@ do not need to specify `additionalProperties`.
 See the [manual workflow example](./skills/workflow/SKILL.md#manual-workflow-inputs)
 for the supported schema subset and a complete typed workflow.
 
+## Workflow outputs
+
+Use `outputSchema` to declare the object a workflow returns. It takes the same
+`j.object(...)` schema builder as manual inputs. The handler's return type is
+inferred from the schema, and the SDK validates the returned value before the run
+succeeds. The output must be at most 256 KB as JSON. A workflow without
+`outputSchema` returns nothing.
+
+See the [workflow output example](./skills/workflow/SKILL.md#workflow-outputs).
+
 ## Notion API access
 
 Use `context.notion` for Notion API calls. Deployed apps receive Notion API

package/dist/connections.d.ts

@@ -7,7 +7,7 @@ export type WorkflowConnection<TProvider extends string = string> = {
     calendar?: CalendarConnectionOptions;
 };
 export type CalendarConnectionOptions = {
-    scope: "read" | "read_write";
+    permissions: "read" | "read_write";
     readTeammatesCalendars: boolean;
 };
 export type WorkflowConnectionDeclarations = Readonly<Record<string, WorkflowConnection>>;

package/dist/connections.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connections.d.ts","sourceRoot":"","sources":["../src/connections.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIjF,OAAO,EAGN,KAAK,iBAAiB,EACtB,MAAM,0BAA0B,CAAC;AAGlC,6EAA6E;AAC7E,MAAM,MAAM,kBAAkB,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM,IAAI;IACnE,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,EAAE,yBAAyB,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACvC,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC;IAC7B,sBAAsB,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAE1F,uEAAuE;AACvE,MAAM,MAAM,6BAA6B,GAAG,kBAAkB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjF,yDAAyD;AACzD,MAAM,MAAM,sBAAsB,CACjC,YAAY,SAAS,8BAA8B,EACnD,SAAS,SAAS,MAAM,IACrB,OAAO,CACV;KACE,IAAI,IAAI,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,SAAS,GAAG,IAAI,GAAG,KAAK;CACzF,CAAC,MAAM,YAAY,CAAC,EACrB,MAAM,CACN,CAAC;AAIF,2EAA2E;AAC3E,eAAO,MAAM,WAAW;mBAER,kBAAkB,GAAG,kBAAkB,CAAC,OAAO,CAAC;;;;;;;;;;;CAI/D,CAAC;AACF,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,MAAM,MAAM,eAAe,GAAG;IAAE,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC;AAEjE,KAAK,yBAAyB,GAAG,iBAAiB,GAAG;IAAE,KAAK,EAAE,eAAe,CAAA;CAAE,CAAC;AAIhF,MAAM,MAAM,mBAAmB,CAC9B,YAAY,SAAS,8BAA8B,GAAG,8BAA8B,IACjF;IACH,QAAQ,EAAE,IAAI,IAAI,MAAM,YAAY,GAAG,yBAAyB,CAAC,OAAO,CACvE,MAAM,yBAAyB,EAC/B,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAC1B,CAAC;CACF,CAAC"}
+{"version":3,"file":"connections.d.ts","sourceRoot":"","sources":["../src/connections.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIjF,OAAO,EAGN,KAAK,iBAAiB,EACtB,MAAM,0BAA0B,CAAC;AAGlC,6EAA6E;AAC7E,MAAM,MAAM,kBAAkB,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM,IAAI;IACnE,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,EAAE,yBAAyB,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACvC,WAAW,EAAE,MAAM,GAAG,YAAY,CAAC;IACnC,sBAAsB,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAE1F,uEAAuE;AACvE,MAAM,MAAM,6BAA6B,GAAG,kBAAkB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjF,yDAAyD;AACzD,MAAM,MAAM,sBAAsB,CACjC,YAAY,SAAS,8BAA8B,EACnD,SAAS,SAAS,MAAM,IACrB,OAAO,CACV;KACE,IAAI,IAAI,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,SAAS,GAAG,IAAI,GAAG,KAAK;CACzF,CAAC,MAAM,YAAY,CAAC,EACrB,MAAM,CACN,CAAC;AAIF,2EAA2E;AAC3E,eAAO,MAAM,WAAW;mBAER,kBAAkB,GAAG,kBAAkB,CAAC,OAAO,CAAC;;;;;;;;;;;CAI/D,CAAC;AACF,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,MAAM,MAAM,eAAe,GAAG;IAAE,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC;AAEjE,KAAK,yBAAyB,GAAG,iBAAiB,GAAG;IAAE,KAAK,EAAE,eAAe,CAAA;CAAE,CAAC;AAIhF,MAAM,MAAM,mBAAmB,CAC9B,YAAY,SAAS,8BAA8B,GAAG,8BAA8B,IACjF;IACH,QAAQ,EAAE,IAAI,IAAI,MAAM,YAAY,GAAG,yBAAyB,CAAC,OAAO,CACvE,MAAM,yBAAyB,EAC/B,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAC1B,CAAC;CACF,CAAC"}

package/dist/connections.js

@@ -37,8 +37,10 @@ function normalizeConnectionRequirements(declarations) {
       );
     if (requirement.type === "calendar") {
       const options = requirement.calendar;
-      if (!options || !["read", "read_write"].includes(options.scope) || typeof options.readTeammatesCalendars !== "boolean") {
-        throw new Error("Calendar connections require scope and readTeammatesCalendars.");
+      if (!options || !["read", "read_write"].includes(options.permissions) || typeof options.readTeammatesCalendars !== "boolean") {
+        throw new Error(
+          "Calendar connections require permissions and readTeammatesCalendars."
+        );
       }
     } else if (requirement.calendar !== void 0) {
       throw new Error("Calendar options are only valid on Calendar connections.");

package/dist/workflow-schema.js

@@ -2,9 +2,21 @@ import { Ajv } from "ajv";
 import addFormats from "ajv-formats";
 import { getSchema } from "./schema-builder.js";
 function compileWorkflowInputSchema(schema) {
+  return compileWorkflowObjectSchema(schema, {
+    schemaName: "workflow manual inputSchema",
+    valueName: "manual workflow input"
+  });
+}
+function compileWorkflowOutputSchema(schema) {
+  return compileWorkflowObjectSchema(schema, {
+    schemaName: "workflow outputSchema",
+    valueName: "workflow output"
+  });
+}
+function compileWorkflowObjectSchema(schema, names) {
   const jsonSchema = getSchema(schema);
   if (!("type" in jsonSchema) || jsonSchema.type !== "object") {
-    throw new Error("workflow manual inputSchema: must be a j.object() schema");
+    throw new Error(`${names.schemaName}: must be a j.object() schema`);
   }
   const ajv = new Ajv({ allErrors: true, strict: true });
   addFormats.default(ajv, {
@@ -24,15 +36,14 @@ function compileWorkflowInputSchema(schema) {
   const validate = ajv.compile(jsonSchema);
   return {
     jsonSchema,
-    validate(input) {
-      if (!validate(input)) {
-        throw new Error(
-          `Invalid manual workflow input: ${ajv.errorsText(validate.errors)}`
-        );
+    validate(value) {
+      if (!validate(value)) {
+        throw new Error(`Invalid ${names.valueName}: ${ajv.errorsText(validate.errors)}`);
       }
     }
   };
 }
 export {
-  compileWorkflowInputSchema
+  compileWorkflowInputSchema,
+  compileWorkflowOutputSchema
 };

package/dist/workflow.d.ts

@@ -2,6 +2,7 @@ import { type WorkflowConnectionDeclarations, type WorkflowConnectionRequirement
 import { type WorkflowAccess, type WorkflowAccessDeclarations, type WorkflowAccessRequirements } from "./workflow-access.js";
 import type { CapabilityContext } from "./context.js";
 import { type RunMetadata } from "./runtime-metadata.js";
+import type { Infer, SchemaBuilder } from "./schema-builder.js";
 import { type WorkflowState } from "./workflow-state.js";
 import type { ManualWorkflowTrigger, WebhookTrigger, WorkflowEventMap, WorkflowTrigger, WorkflowEventCreators, WorkflowTriggerForConnections } from "./events.generated.js";
 type HandlerOptions = {
@@ -91,7 +92,15 @@ export type WorkflowWaitForInputResult = {
 type WorkflowWaitResult = WorkflowWaitUntilResult | WorkflowWaitForInputResult;
 type WorkflowHandlerResult = {
     status: "success";
+    output?: Record<string, unknown>;
 } | WorkflowWaitResult;
+/** An object schema describing the value a workflow returns. */
+export type WorkflowOutputSchema = SchemaBuilder<Record<string, unknown>, "object">;
+/**
+ * What a workflow handler returns: the value described by `outputSchema`, or
+ * nothing when the workflow declares no output schema.
+ */
+export type WorkflowHandlerReturn<TOutputSchema extends WorkflowOutputSchema | undefined> = TOutputSchema extends WorkflowOutputSchema ? Promise<Infer<TOutputSchema>> | Infer<TOutputSchema> : Promise<void> | void;
 export { FatalError, RetryableError } from "./error.js";
 export type { WorkflowAccess, WorkflowAccessAgentLevel, WorkflowAccessBindings, WorkflowAccessDeclaration, WorkflowAccessDeclarations, WorkflowAccessLevel, WorkflowAccessLevelFor, WorkflowAccessResource, ResourceAccessLevel, WorkflowAccessResourceType, WorkflowAccessRequirement, WorkflowAccessRequirements, WorkflowAccessValue, } from "./workflow-access.js";
 export { access } from "./workflow-access.js";
@@ -194,7 +203,7 @@ export type WorkflowManifestTrigger = WorkflowTrigger | (WebhookTrigger & {
 /**
  * Configuration passed to {@link workflow}.
  */
-export type WorkflowConfiguration<TTriggers extends readonly [WorkflowTrigger, ...WorkflowTrigger[]], TConnections extends WorkflowConnectionDeclarations = WorkflowConnectionDeclarations, TAccess extends WorkflowAccessDeclarations = WorkflowAccessDeclarations> = {
+export type WorkflowConfiguration<TTriggers extends readonly [WorkflowTrigger, ...WorkflowTrigger[]], TConnections extends WorkflowConnectionDeclarations = WorkflowConnectionDeclarations, TAccess extends WorkflowAccessDeclarations = WorkflowAccessDeclarations, TOutputSchema extends WorkflowOutputSchema | undefined = undefined> = {
     /**
      * A human-readable name for the workflow, shown in the UI when viewing workflows
      */
@@ -259,10 +268,24 @@ export type WorkflowConfiguration<TTriggers extends readonly [WorkflowTrigger, .
      * ```
      */
     verify?: WebhookVerifyHandler;
-    handler: (event: WorkflowEventForTriggers<TTriggers>, context: WorkflowContext<TConnections, TAccess>) => Promise<void> | void;
+    /**
+     * Optional schema for the object the handler returns, built with
+     * `@notionhq/apps/schema-builder`. The handler's return type is inferred
+     * from it, and the returned value is validated before the run succeeds.
+     *
+     * Without `outputSchema`, the workflow returns nothing.
+     *
+     * @example
+     * ```ts
+     * outputSchema: j.object({ releaseUrl: j.string() }),
+     * handler: async () => ({ releaseUrl: "https://example.com/releases/1" }),
+     * ```
+     */
+    outputSchema?: TOutputSchema;
+    handler: (event: WorkflowEventForTriggers<TTriggers>, context: WorkflowContext<TConnections, TAccess>) => WorkflowHandlerReturn<NoInfer<TOutputSchema>>;
 };
 /** Configuration that checks trigger keys against declared connections. */
-export type WorkflowTriggerConfiguration<TTriggers extends readonly [WorkflowTrigger, ...WorkflowTrigger[]], TConnections extends WorkflowConnectionDeclarations, TAccess extends WorkflowAccessDeclarations = WorkflowAccessDeclarations> = Omit<WorkflowConfiguration<TTriggers, TConnections, TAccess>, "triggers"> & {
+export type WorkflowTriggerConfiguration<TTriggers extends readonly [WorkflowTrigger, ...WorkflowTrigger[]], TConnections extends WorkflowConnectionDeclarations, TAccess extends WorkflowAccessDeclarations = WorkflowAccessDeclarations, TOutputSchema extends WorkflowOutputSchema | undefined = undefined> = Omit<WorkflowConfiguration<TTriggers, TConnections, TAccess, TOutputSchema>, "triggers"> & {
     triggers: (context: {
         events: WorkflowEventCreators<NoInfer<TConnections>>;
     }) => TTriggers;
@@ -286,6 +309,8 @@ export type Workflow<TTriggers extends readonly [WorkflowTrigger, ...WorkflowTri
         access?: WorkflowAccessRequirements;
         deadline?: WorkflowDeadline;
         retry?: WorkflowRetryPolicy;
+        /** JSON Schema for the handler's return value. Absent when the workflow returns nothing. */
+        outputJsonSchema?: Record<string, unknown>;
     };
     handler: (input: WorkflowEventForTriggers<TTriggers> | WebhookVerifyInvocation, options?: HandlerOptions) => Promise<WorkflowHandlerResult | WebhookVerifyResponse | undefined>;
 };
@@ -318,8 +343,8 @@ export type Workflow<TTriggers extends readonly [WorkflowTrigger, ...WorkflowTri
 export declare function workflow<const TTriggers extends readonly [
     WorkflowTriggerForConnections<NoInfer<TConnections>>,
     ...WorkflowTriggerForConnections<NoInfer<TConnections>>[]
-], const TConnections extends WorkflowConnectionDeclarations = Record<never, never>, const TAccess extends WorkflowAccessDeclarations = Record<never, never>>(configuration: WorkflowTriggerConfiguration<TTriggers, TConnections, TAccess>): Workflow<TTriggers>;
-export declare function workflow<const TTriggers extends readonly [WorkflowTrigger, ...WorkflowTrigger[]], const TConnections extends WorkflowConnectionDeclarations = Record<never, never>, const TAccess extends WorkflowAccessDeclarations = Record<never, never>>(configuration: WorkflowConfiguration<TTriggers, TConnections, TAccess>): Workflow<TTriggers>;
+], const TConnections extends WorkflowConnectionDeclarations = Record<never, never>, const TAccess extends WorkflowAccessDeclarations = Record<never, never>, const TOutputSchema extends WorkflowOutputSchema | undefined = undefined>(configuration: WorkflowTriggerConfiguration<TTriggers, TConnections, TAccess, TOutputSchema>): Workflow<TTriggers>;
+export declare function workflow<const TTriggers extends readonly [WorkflowTrigger, ...WorkflowTrigger[]], const TConnections extends WorkflowConnectionDeclarations = Record<never, never>, const TAccess extends WorkflowAccessDeclarations = Record<never, never>, const TOutputSchema extends WorkflowOutputSchema | undefined = undefined>(configuration: WorkflowConfiguration<TTriggers, TConnections, TAccess, TOutputSchema>): Workflow<TTriggers>;
 /** Context passed to a workflow step. */
 export type StepContext = {
     /**

package/dist/workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"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"}

package/dist/workflow.js

@@ -16,6 +16,7 @@ import { writeOutput } from "./output.js";
 import { resolveRuntimeInput } from "./runtime-input.js";
 import { readRunMetadata } from "./runtime-metadata.js";
 import { createWorkflowEvents, validateManualWorkflowInput } from "./events.generated.js";
+import { compileWorkflowOutputSchema } from "./workflow-schema.js";
 import { createWorkflowStepState } from "./workflow-state.js";
 const WEBHOOK_TRIGGER_TYPE = "webhooks.webhook";
 const input = {
@@ -74,6 +75,7 @@ function workflow(configuration) {
   }
   const deadline = configuration.deadline === void 0 ? void 0 : structuredClone(configuration.deadline);
   const retry = configuration.retry === void 0 ? void 0 : manifestRetryPolicy(configuration.retry);
+  const outputSchema = configuration.outputSchema === void 0 ? void 0 : compileWorkflowOutputSchema(configuration.outputSchema);
   const manualTriggers = triggers.filter(
     (trigger) => trigger.type === "workflow.manual"
   );
@@ -94,7 +96,8 @@ function workflow(configuration) {
       ...configuration.connections === void 0 ? {} : { connections: requirements },
       ...configuration.access === void 0 ? {} : { access: accessRequirements },
       ...deadline === void 0 ? {} : { deadline },
-      ...retry === void 0 ? {} : { retry }
+      ...retry === void 0 ? {} : { retry },
+      ...outputSchema === void 0 ? {} : { outputJsonSchema: outputSchema.jsonSchema }
     },
     async handler(input2, options) {
       const invocationStartedAt = Date.now();
@@ -145,11 +148,21 @@ function workflow(configuration) {
           }
           validateManualWorkflowInput(manualTrigger, event.input);
         }
-        await configuration.handler(event, capabilityContext);
+        const handlerOutput = await configuration.handler(
+          event,
+          capabilityContext
+        );
+        const result = outputSchema === void 0 ? { status: "success" } : {
+          status: "success",
+          output: serializeWorkflowOutput(
+            handlerOutput,
+            outputSchema.validate
+          )
+        };
         if (options?.concreteOutput) {
-          return { status: "success" };
+          return result;
         }
-        writeOutput({ _tag: "success", value: { status: "success" } });
+        writeOutput({ _tag: "success", value: result });
       } catch (err) {
         if (err instanceof WorkflowWaitInterrupt) {
           if (options?.concreteOutput) {
@@ -199,6 +212,23 @@ function manifestTriggers(triggers, hasVerify) {
     (trigger) => hasVerify && trigger.type === WEBHOOK_TRIGGER_TYPE ? { ...trigger, hasVerify: true } : trigger
   );
 }
+const MAX_WORKFLOW_OUTPUT_BYTES = 256 * 1024;
+function serializeWorkflowOutput(value, validate) {
+  try {
+    const json = value === void 0 ? void 0 : JSON.stringify(value);
+    const bytes = json === void 0 ? 0 : Buffer.byteLength(json, "utf8");
+    if (bytes > MAX_WORKFLOW_OUTPUT_BYTES) {
+      throw new Error(
+        `Invalid workflow output: must be at most ${MAX_WORKFLOW_OUTPUT_BYTES} bytes as JSON, got ${bytes}.`
+      );
+    }
+    const serialized = json === void 0 ? void 0 : JSON.parse(json);
+    validate(serialized);
+    return serialized;
+  } catch (error) {
+    throw new FatalError(error instanceof Error ? error.message : String(error));
+  }
+}
 function isVerifyInvocation(input2) {
   return typeof input2 === "object" && input2 !== null && "request" in input2;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@notionhq/apps",
-	"version": "0.0.45",
+	"version": "0.0.47",
 	"description": "An SDK for building workflow apps for Notion",
 	"license": "MIT",
 	"bin": {

package/skills/workflow/SKILL.md

@@ -187,6 +187,34 @@ export default workflow({
 });
 ```
 
+## Workflow outputs
+
+Declare `outputSchema` when a workflow returns a value. Use the same
+`@notionhq/apps/schema-builder` builders as manual inputs; the schema must be a
+`j.object(...)`. The handler must return a matching object of at most 256 KB as
+JSON, and the run fails without retrying when it does not. Omit `outputSchema` for workflows that return
+nothing.
+
+```ts
+import { workflow } from "@notionhq/apps/workflow";
+import { events } from "@notionhq/apps/events";
+import { j } from "@notionhq/apps/schema-builder";
+
+export default workflow({
+	name: "Prepare releases",
+	description: "Prepares the supplied releases.",
+	triggers: [
+		events.manual({
+			inputSchema: j.object({ releases: j.array(j.object({ version: j.string() })) }),
+		}),
+	],
+	outputSchema: j.object({ prepared: j.integer() }),
+	handler: async (event) => {
+		return { prepared: event.input.releases.length };
+	},
+});
+```
+
 ## Resources created with the App
 
 Use [Notion as Code](../notion-as-code/SKILL.md) for pages, databases, and custom agents

package/src/cli/build.test.ts

@@ -611,6 +611,12 @@ describe("buildApp", () => {
 								},
 							},
 						],
+						outputJsonSchema: {
+							type: "object",
+							additionalProperties: false,
+							required: ["prepared"],
+							properties: { prepared: { type: "integer" } },
+						},
 					},
 				},
 			],

package/src/connections.test.ts

@@ -15,31 +15,35 @@ afterEach(() => {
 describe("connection requirements", () => {
 	it("rejects Calendar declarations that omit explicit access", () => {
 		expect(() => normalizeConnectionRequirements({ work: { type: "calendar" } })).toThrow(
-			"scope and readTeammatesCalendars",
+			"permissions and readTeammatesCalendars",
 		);
 	});
 	it.each([
-		{ scope: "read" },
+		{ scope: "read", readTeammatesCalendars: false },
+		{ permissions: "read" },
 		{ readTeammatesCalendars: false },
-		{ scope: "write", readTeammatesCalendars: false },
-		{ scope: "read", readTeammatesCalendars: "false" },
+		{ permissions: "write", readTeammatesCalendars: false },
+		{ permissions: "read", readTeammatesCalendars: "false" },
 	])("rejects invalid Calendar options: %j", (calendar) => {
 		expect(() =>
 			Reflect.apply(normalizeConnectionRequirements, undefined, [
 				{ work: { type: "calendar", calendar } },
 			]),
-		).toThrow("scope and readTeammatesCalendars");
+		).toThrow("permissions and readTeammatesCalendars");
 	});
 	it("rejects Calendar options on other providers", () => {
 		expect(() =>
 			normalizeConnectionRequirements({
-				work: { type: "mail", calendar: { scope: "read", readTeammatesCalendars: false } },
+				work: {
+					type: "mail",
+					calendar: { permissions: "read", readTeammatesCalendars: false },
+				},
 			}),
 		).toThrow("only valid on Calendar");
 	});
 	it("preserves explicit write and teammate choices in the manifest", () => {
 		const connection = connections.calendar({
-			scope: "read_write",
+			permissions: "read_write",
 			readTeammatesCalendars: true,
 		});
 		const normalized = normalizeConnectionRequirements({ work: connection });
@@ -49,14 +53,14 @@ describe("connection requirements", () => {
 			{
 				type: "calendar",
 				key: "work",
-				calendar: { scope: "read_write", readTeammatesCalendars: true },
+				calendar: { permissions: "read_write", readTeammatesCalendars: true },
 			},
 		]);
 	});
 	it("normalizes object keys into manifest requirements", () => {
 		expect(
 			normalizeConnectionRequirements({
-				work: connections.calendar({ scope: "read", readTeammatesCalendars: false }),
+				work: connections.calendar({ permissions: "read", readTeammatesCalendars: false }),
 				support: connections.slack(),
 				team: connections.slack(),
 			}),
@@ -64,7 +68,7 @@ describe("connection requirements", () => {
 			{
 				type: "calendar",
 				key: "work",
-				calendar: { scope: "read", readTeammatesCalendars: false },
+				calendar: { permissions: "read", readTeammatesCalendars: false },
 			},
 			{ type: "slack", key: "support" },
 			{ type: "slack", key: "team" },
@@ -89,12 +93,12 @@ describe("connection requirements", () => {
 		).toThrow("must be an object");
 		const inherited = { support: connections.slack() };
 		Object.setPrototypeOf(inherited, {
-			hidden: connections.calendar({ scope: "read", readTeammatesCalendars: false }),
+			hidden: connections.calendar({ permissions: "read", readTeammatesCalendars: false }),
 		});
 		expect(() => normalizeConnectionRequirements(inherited)).toThrow("only own");
 		const hidden = { support: connections.slack() };
 		Object.defineProperty(hidden, "hidden", {
-			value: connections.calendar({ scope: "read", readTeammatesCalendars: false }),
+			value: connections.calendar({ permissions: "read", readTeammatesCalendars: false }),
 		});
 		expect(() => normalizeConnectionRequirements(hidden)).toThrow("enumerable strings");
 		const symbolic = { [Symbol("support")]: connections.slack() };
@@ -168,7 +172,7 @@ describe("workflow connection runtime", () => {
 		const declarations = { support: connections.slack(), team: connections.slack() };
 		const runtime = createWorkflowConnections(notion, declarations);
 		Object.assign(declarations, {
-			support: connections.calendar({ scope: "read", readTeammatesCalendars: false }),
+			support: connections.calendar({ permissions: "read", readTeammatesCalendars: false }),
 			injected: connections.slack(),
 		});
 		await runtime.support.findUserByEmail({ email: "support@example.com" });
@@ -357,7 +361,7 @@ describe("workflow connection runtime", () => {
 		const notion = new Client({ auth: "test" });
 		const request = vi.spyOn(notion, "request").mockResolvedValue({ result: { accounts: [] } });
 		const result = await createWorkflowConnections(notion, {
-			calendar: connections.calendar({ scope: "read", readTeammatesCalendars: false }),
+			calendar: connections.calendar({ permissions: "read", readTeammatesCalendars: false }),
 		}).calendar.listCalendars({});
 		expect(result.accounts).toEqual([]);
 		expect(request).toHaveBeenCalledWith({

package/src/connections.ts

@@ -17,7 +17,7 @@ export type WorkflowConnection<TProvider extends string = string> = {
 };
 
 export type CalendarConnectionOptions = {
-	scope: "read" | "read_write";
+	permissions: "read" | "read_write";
 	readTeammatesCalendars: boolean;
 };
 
@@ -104,10 +104,12 @@ export function normalizeConnectionRequirements(
 			const options = requirement.calendar;
 			if (
 				!options ||
-				!["read", "read_write"].includes(options.scope) ||
+				!["read", "read_write"].includes(options.permissions) ||
 				typeof options.readTeammatesCalendars !== "boolean"
 			) {
-				throw new Error("Calendar connections require scope and readTeammatesCalendars.");
+				throw new Error(
+					"Calendar connections require permissions and readTeammatesCalendars.",
+				);
 			}
 		} else if (requirement.calendar !== undefined) {
 			throw new Error("Calendar options are only valid on Calendar connections.");

package/src/workflow-connections-types.test.ts

@@ -21,7 +21,7 @@ it("infers only the declared provider clients", () => {
 		description: "Calendar only",
 		triggers: [events.notionPageCreated()],
 		connections: {
-			work: connections.calendar({ scope: "read", readTeammatesCalendars: false }),
+			work: connections.calendar({ permissions: "read", readTeammatesCalendars: false }),
 		},
 		handler(_event, context) {
 			expectTypeOf<keyof typeof context.connections>().toEqualTypeOf<"work">();
@@ -32,7 +32,7 @@ it("infers only the declared provider clients", () => {
 		},
 	});
 	const requirements = {
-		calendar: connections.calendar({ scope: "read", readTeammatesCalendars: false }),
+		calendar: connections.calendar({ permissions: "read", readTeammatesCalendars: false }),
 		support: connections.slack(),
 		team: connections.slack(),
 	};

package/src/workflow-schema.ts

@@ -2,16 +2,38 @@ import { Ajv } from "ajv";
 import addFormats from "ajv-formats";
 import { getSchema, type SchemaBuilder } from "./schema-builder.js";
 
+type CompiledWorkflowSchema = {
+	jsonSchema: Record<string, unknown>;
+	validate: (value: unknown) => void;
+};
+
 /** @internal */
 export function compileWorkflowInputSchema(
 	schema: SchemaBuilder<Record<string, unknown>, "object">,
-): {
-	jsonSchema: Record<string, unknown>;
-	validate: (input: unknown) => void;
-} {
+): CompiledWorkflowSchema {
+	return compileWorkflowObjectSchema(schema, {
+		schemaName: "workflow manual inputSchema",
+		valueName: "manual workflow input",
+	});
+}
+
+/** @internal */
+export function compileWorkflowOutputSchema(
+	schema: SchemaBuilder<Record<string, unknown>, "object">,
+): CompiledWorkflowSchema {
+	return compileWorkflowObjectSchema(schema, {
+		schemaName: "workflow outputSchema",
+		valueName: "workflow output",
+	});
+}
+
+function compileWorkflowObjectSchema(
+	schema: SchemaBuilder<Record<string, unknown>, "object">,
+	names: { schemaName: string; valueName: string },
+): CompiledWorkflowSchema {
 	const jsonSchema = getSchema(schema);
 	if (!("type" in jsonSchema) || jsonSchema.type !== "object") {
-		throw new Error("workflow manual inputSchema: must be a j.object() schema");
+		throw new Error(`${names.schemaName}: must be a j.object() schema`);
 	}
 	const ajv = new Ajv({ allErrors: true, strict: true });
 	addFormats.default(ajv, {
@@ -31,11 +53,9 @@ export function compileWorkflowInputSchema(
 	const validate = ajv.compile(jsonSchema);
 	return {
 		jsonSchema,
-		validate(input) {
-			if (!validate(input)) {
-				throw new Error(
-					`Invalid manual workflow input: ${ajv.errorsText(validate.errors)}`,
-				);
+		validate(value) {
+			if (!validate(value)) {
+				throw new Error(`Invalid ${names.valueName}: ${ajv.errorsText(validate.errors)}`);
 			}
 		},
 	};

package/src/workflow-types.test.ts

@@ -72,7 +72,7 @@ it("checks provider keys on callback arguments and returned triggers", () => {
 			name: "valid",
 			valid: true,
 			connections:
-				"{ support: connections.slack(), calendar: connections.calendar({ scope: 'read', readTeammatesCalendars: false }) }",
+				"{ support: connections.slack(), calendar: connections.calendar({ permissions: 'read', readTeammatesCalendars: false }) }",
 			trigger:
 				'events.slackMessage({ connectionKey: "support" }), events.calendarEventCreated({ connectionKey: "calendar" })',
 		},
@@ -104,7 +104,7 @@ it("checks provider keys on callback arguments and returned triggers", () => {
 			name: "wrong_provider",
 			valid: false,
 			connections:
-				"{ support: connections.calendar({ scope: 'read', readTeammatesCalendars: false }) }",
+				"{ support: connections.calendar({ permissions: 'read', readTeammatesCalendars: false }) }",
 			trigger: 'events.slackMessage({ connectionKey: "support" })',
 		},
 		{
@@ -123,14 +123,14 @@ it("checks provider keys on callback arguments and returned triggers", () => {
 			name: "global_invalid",
 			valid: false,
 			connections:
-				"{ support: connections.calendar({ scope: 'read', readTeammatesCalendars: false }) }",
+				"{ support: connections.calendar({ permissions: 'read', readTeammatesCalendars: false }) }",
 			trigger: 'globalTriggers.slackMessage({ connectionKey: "support" })',
 		},
 		{
 			name: "literal_invalid",
 			valid: false,
 			connections:
-				"{ support: connections.calendar({ scope: 'read', readTeammatesCalendars: false }) }",
+				"{ support: connections.calendar({ permissions: 'read', readTeammatesCalendars: false }) }",
 			trigger: '{ type: "slack.message", connectionKey: "support" }',
 		},
 		{
@@ -174,7 +174,7 @@ it("checks provider keys on callback arguments and returned triggers", () => {
 			name: "keyed_clients",
 			valid: true,
 			connections:
-				"{ support: connections.slack(), team: connections.slack(), work: connections.calendar({ scope: 'read', readTeammatesCalendars: false }) }",
+				"{ support: connections.slack(), team: connections.slack(), work: connections.calendar({ permissions: 'read', readTeammatesCalendars: false }) }",
 			trigger: "events.notionPageCreated()",
 			handler:
 				'(_event, ctx) => { ctx.connections.support.findUserByEmail({ email: "a@example.com" }); ctx.connections.team.findUserByEmail({ email: "b@example.com" }); ctx.connections.work.listCalendars({}); }',
@@ -228,6 +228,47 @@ it("checks provider keys on callback arguments and returned triggers", () => {
 			trigger: "events.notionPageCreated()",
 			handler: '(_event, ctx) => { ctx.connections.oauth("github"); }',
 		},
+		{
+			name: "output_async",
+			valid: true,
+			trigger: "events.manual()",
+			outputSchema: "j.object({ url: j.string(), draft: j.boolean().nullable() })",
+			handler: 'async () => ({ url: "https://example.com", draft: null })',
+		},
+		{
+			name: "output_sync",
+			valid: true,
+			trigger: "events.manual()",
+			outputSchema: "j.object({ url: j.string() })",
+			handler: '() => ({ url: "https://example.com" })',
+		},
+		{
+			name: "output_mismatch",
+			valid: false,
+			trigger: "events.manual()",
+			outputSchema: "j.object({ url: j.string() })",
+			handler: "async () => ({ url: 1 })",
+		},
+		{
+			name: "output_missing_value",
+			valid: false,
+			trigger: "events.manual()",
+			outputSchema: "j.object({ url: j.string() })",
+			handler: "async () => {}",
+		},
+		{
+			name: "output_requires_object_schema",
+			valid: false,
+			trigger: "events.manual()",
+			outputSchema: "j.string()",
+			handler: '() => "https://example.com"',
+		},
+		{
+			name: "output_absent_returns_void",
+			valid: false,
+			trigger: "events.manual()",
+			handler: 'async () => ({ url: "https://example.com" })',
+		},
 	];
 	const fixtures = new Map(
 		cases.map((testCase) => [
@@ -240,6 +281,7 @@ it("checks provider keys on callback arguments and returned triggers", () => {
 		workflow({
 			name: "Type check", description: "Type check",
 			${testCase.connections === undefined ? "" : `connections: ${testCase.connections},`}
+			${testCase.outputSchema === undefined ? "" : `outputSchema: ${testCase.outputSchema},`}
 			triggers: ({ events }) => [${testCase.trigger}],
 			handler: ${testCase.handler ?? "() => {}"},
 		});`,

package/src/workflow.test.ts

@@ -125,6 +125,111 @@ describe("manual workflow triggers", () => {
 	});
 });
 
+describe("workflow output schemas", () => {
+	const outputSchema = j.object({ url: j.string(), publishedAt: j.datetime().nullable() });
+
+	it("records the output JSON Schema in the workflow config", () => {
+		const definition = workflow({
+			name: "Publish release",
+			description: "Publishes a release",
+			triggers: [events.manual()],
+			outputSchema,
+			handler: () => ({ url: "https://example.com", publishedAt: null }),
+		});
+
+		expect(definition.config.outputJsonSchema).toEqual({
+			type: "object",
+			required: ["url", "publishedAt"],
+			additionalProperties: false,
+			properties: {
+				url: { type: "string" },
+				publishedAt: { anyOf: [{ type: "string", format: "date-time" }, { type: "null" }] },
+			},
+		});
+	});
+
+	it("omits the output schema and output when none is declared", async () => {
+		const definition = workflow({
+			name: "Log pages",
+			description: "Logs created pages",
+			triggers: [events.notionPageCreated()],
+			handler: () => {},
+		});
+
+		expect(definition.config).not.toHaveProperty("outputJsonSchema");
+		await expect(definition.handler(event, { concreteOutput: true })).resolves.toEqual({
+			status: "success",
+		});
+	});
+
+	it("returns the output in the success envelope", async () => {
+		const definition = workflow({
+			name: "Publish release",
+			description: "Publishes a release",
+			triggers: [events.manual()],
+			outputSchema,
+			handler: async () => ({
+				url: "https://example.com",
+				publishedAt: "2026-09-28T00:00:00.000Z",
+			}),
+		});
+
+		await definition.handler({ type: "workflow.manual", input: {} });
+
+		expect(stdoutSpy).toHaveBeenLastCalledWith(
+			`\n<__notion_output__>${JSON.stringify({
+				_tag: "success",
+				value: {
+					status: "success",
+					output: { url: "https://example.com", publishedAt: "2026-09-28T00:00:00.000Z" },
+				},
+			})}</__notion_output__>\n`,
+		);
+	});
+
+	it.each([
+		{ name: "a missing value", output: undefined },
+		{ name: "a wrong type", output: { url: 1, publishedAt: null } },
+		{ name: "an extra key", output: { url: "https://example.com", publishedAt: null, id: 1 } },
+		{
+			name: "more than 256 KB of JSON",
+			output: { url: "x".repeat(256 * 1024), publishedAt: null },
+		},
+	])("fails without retrying when the handler returns $name", async ({ output }) => {
+		const definition = workflow({
+			name: "Publish release",
+			description: "Publishes a release",
+			triggers: [events.manual()],
+			outputSchema,
+			// SAFETY: Simulates untyped handler code returning a value outside the schema.
+			handler: () => output as never,
+		});
+
+		await expect(
+			definition.handler({ type: "workflow.manual", input: {} }),
+		).rejects.toMatchObject({
+			cause: expect.objectContaining({
+				name: "FatalError",
+				message: expect.stringContaining("Invalid workflow output"),
+			}),
+		});
+		expect(String(stdoutSpy.mock.lastCall?.[0])).toContain('"_tag":"terminal"');
+	});
+
+	it("rejects an output schema that is not an object schema", () => {
+		expect(() =>
+			workflow({
+				name: "Publish release",
+				description: "Publishes a release",
+				triggers: [events.manual()],
+				// SAFETY: Simulates untyped app code passing a non-object schema.
+				outputSchema: j.string() as never,
+				handler: (() => {}) as never,
+			}),
+		).toThrow("workflow outputSchema: must be a j.object() schema");
+	});
+});
+
 async function createWorkflowContext(
 	retry?: WorkflowRetryPolicy,
 ): Promise<WorkflowContext<Record<never, never>>> {
@@ -1703,7 +1808,10 @@ describe("workflow", () => {
 			description: "Schedules a follow-up after a page is created",
 			triggers: [events.notionPageCreated()],
 			connections: {
-				calendar: connections.calendar({ scope: "read", readTeammatesCalendars: false }),
+				calendar: connections.calendar({
+					permissions: "read",
+					readTeammatesCalendars: false,
+				}),
 			},
 			handler: () => {},
 		});
@@ -1712,7 +1820,7 @@ describe("workflow", () => {
 			{
 				type: "calendar",
 				key: "calendar",
-				calendar: { scope: "read", readTeammatesCalendars: false },
+				calendar: { permissions: "read", readTeammatesCalendars: false },
 			},
 		]);
 	});
@@ -1730,7 +1838,7 @@ describe("workflow", () => {
 			},
 		});
 		Object.assign(declarations, {
-			support: connections.calendar({ scope: "read", readTeammatesCalendars: false }),
+			support: connections.calendar({ permissions: "read", readTeammatesCalendars: false }),
 			team: connections.slack(),
 		});
 		expect(definition.config.connections).toEqual([{ type: "slack", key: "support" }]);
@@ -1740,7 +1848,7 @@ describe("workflow", () => {
 	it("rejects inherited declaration objects before cloning", () => {
 		const declarations = { support: connections.slack() };
 		Object.setPrototypeOf(declarations, {
-			extra: connections.calendar({ scope: "read", readTeammatesCalendars: false }),
+			extra: connections.calendar({ permissions: "read", readTeammatesCalendars: false }),
 		});
 		expect(() =>
 			workflow({
@@ -1761,7 +1869,7 @@ describe("workflow", () => {
 				triggers: [events.notionPageCreated()],
 				connections: {
 					"bad/key": connections.calendar({
-						scope: "read",
+						permissions: "read",
 						readTeammatesCalendars: false,
 					}),
 				},
@@ -2031,7 +2139,10 @@ describe("connection-bound triggers", () => {
 			description: "Uses only declared provider keys",
 			connections: {
 				support: connections.slack(),
-				calendar: connections.calendar({ scope: "read", readTeammatesCalendars: false }),
+				calendar: connections.calendar({
+					permissions: "read",
+					readTeammatesCalendars: false,
+				}),
 			},
 			triggers: ({ events }) => {
 				calls += 1;
@@ -2083,7 +2194,10 @@ describe("connection-bound triggers", () => {
 		{ requirements: {} },
 		{
 			requirements: {
-				support: connections.calendar({ scope: "read", readTeammatesCalendars: false }),
+				support: connections.calendar({
+					permissions: "read",
+					readTeammatesCalendars: false,
+				}),
 			},
 		},
 		{ requirements: { other: connections.slack() } },

package/src/workflow.ts

@@ -24,6 +24,8 @@ import { writeOutput } from "./output.js";
 import { resolveRuntimeInput } from "./runtime-input.js";
 import { readRunMetadata, type RunMetadata } from "./runtime-metadata.js";
 import { createWorkflowEvents, validateManualWorkflowInput } from "./events.generated.js";
+import type { Infer, SchemaBuilder } from "./schema-builder.js";
+import { compileWorkflowOutputSchema } from "./workflow-schema.js";
 import { createWorkflowStepState, type WorkflowState } from "./workflow-state.js";
 import type {
 	ManualWorkflowTrigger,
@@ -183,7 +185,21 @@ export type WorkflowWaitForInputResult = {
 
 type WorkflowWaitResult = WorkflowWaitUntilResult | WorkflowWaitForInputResult;
 
-type WorkflowHandlerResult = { status: "success" } | WorkflowWaitResult;
+type WorkflowHandlerResult =
+	| { status: "success"; output?: Record<string, unknown> }
+	| WorkflowWaitResult;
+
+/** An object schema describing the value a workflow returns. */
+export type WorkflowOutputSchema = SchemaBuilder<Record<string, unknown>, "object">;
+
+/**
+ * What a workflow handler returns: the value described by `outputSchema`, or
+ * nothing when the workflow declares no output schema.
+ */
+export type WorkflowHandlerReturn<TOutputSchema extends WorkflowOutputSchema | undefined> =
+	TOutputSchema extends WorkflowOutputSchema
+		? Promise<Infer<TOutputSchema>> | Infer<TOutputSchema>
+		: Promise<void> | void;
 
 const MAX_WORKFLOW_WAIT_MS = 7 * 24 * 60 * 60 * 1_000;
 export { FatalError, RetryableError } from "./error.js";
@@ -355,6 +371,7 @@ export type WorkflowConfiguration<
 	TTriggers extends readonly [WorkflowTrigger, ...WorkflowTrigger[]],
 	TConnections extends WorkflowConnectionDeclarations = WorkflowConnectionDeclarations,
 	TAccess extends WorkflowAccessDeclarations = WorkflowAccessDeclarations,
+	TOutputSchema extends WorkflowOutputSchema | undefined = undefined,
 > = {
 	/**
 	 * A human-readable name for the workflow, shown in the UI when viewing workflows
@@ -428,10 +445,25 @@ export type WorkflowConfiguration<
 	 */
 	verify?: WebhookVerifyHandler;
 
+	/**
+	 * Optional schema for the object the handler returns, built with
+	 * `@notionhq/apps/schema-builder`. The handler's return type is inferred
+	 * from it, and the returned value is validated before the run succeeds.
+	 *
+	 * Without `outputSchema`, the workflow returns nothing.
+	 *
+	 * @example
+	 * ```ts
+	 * outputSchema: j.object({ releaseUrl: j.string() }),
+	 * handler: async () => ({ releaseUrl: "https://example.com/releases/1" }),
+	 * ```
+	 */
+	outputSchema?: TOutputSchema;
+
 	handler: (
 		event: WorkflowEventForTriggers<TTriggers>,
 		context: WorkflowContext<TConnections, TAccess>,
-	) => Promise<void> | void;
+	) => WorkflowHandlerReturn<NoInfer<TOutputSchema>>;
 };
 
 /** Configuration that checks trigger keys against declared connections. */
@@ -439,7 +471,8 @@ export type WorkflowTriggerConfiguration<
 	TTriggers extends readonly [WorkflowTrigger, ...WorkflowTrigger[]],
 	TConnections extends WorkflowConnectionDeclarations,
 	TAccess extends WorkflowAccessDeclarations = WorkflowAccessDeclarations,
-> = Omit<WorkflowConfiguration<TTriggers, TConnections, TAccess>, "triggers"> & {
+	TOutputSchema extends WorkflowOutputSchema | undefined = undefined,
+> = Omit<WorkflowConfiguration<TTriggers, TConnections, TAccess, TOutputSchema>, "triggers"> & {
 	triggers: (context: { events: WorkflowEventCreators<NoInfer<TConnections>> }) => TTriggers;
 };
 
@@ -464,6 +497,8 @@ export type Workflow<
 		access?: WorkflowAccessRequirements;
 		deadline?: WorkflowDeadline;
 		retry?: WorkflowRetryPolicy;
+		/** JSON Schema for the handler's return value. Absent when the workflow returns nothing. */
+		outputJsonSchema?: Record<string, unknown>;
 	};
 	handler: (
 		input: WorkflowEventForTriggers<TTriggers> | WebhookVerifyInvocation,
@@ -504,22 +539,27 @@ export function workflow<
 	],
 	const TConnections extends WorkflowConnectionDeclarations = Record<never, never>,
 	const TAccess extends WorkflowAccessDeclarations = Record<never, never>,
+	const TOutputSchema extends WorkflowOutputSchema | undefined = undefined,
 >(
-	configuration: WorkflowTriggerConfiguration<TTriggers, TConnections, TAccess>,
+	configuration: WorkflowTriggerConfiguration<TTriggers, TConnections, TAccess, TOutputSchema>,
 ): Workflow<TTriggers>;
 export function workflow<
 	const TTriggers extends readonly [WorkflowTrigger, ...WorkflowTrigger[]],
 	const TConnections extends WorkflowConnectionDeclarations = Record<never, never>,
 	const TAccess extends WorkflowAccessDeclarations = Record<never, never>,
->(configuration: WorkflowConfiguration<TTriggers, TConnections, TAccess>): Workflow<TTriggers>;
+	const TOutputSchema extends WorkflowOutputSchema | undefined = undefined,
+>(
+	configuration: WorkflowConfiguration<TTriggers, TConnections, TAccess, TOutputSchema>,
+): Workflow<TTriggers>;
 export function workflow<
 	const TTriggers extends readonly [WorkflowTrigger, ...WorkflowTrigger[]],
 	const TConnections extends WorkflowConnectionDeclarations = Record<never, never>,
 	const TAccess extends WorkflowAccessDeclarations = Record<never, never>,
+	const TOutputSchema extends WorkflowOutputSchema | undefined = undefined,
 >(
 	configuration:
-		| WorkflowConfiguration<TTriggers, TConnections, TAccess>
-		| WorkflowTriggerConfiguration<TTriggers, TConnections, TAccess>,
+		| WorkflowConfiguration<TTriggers, TConnections, TAccess, TOutputSchema>
+		| WorkflowTriggerConfiguration<TTriggers, TConnections, TAccess, TOutputSchema>,
 ): Workflow<TTriggers> {
 	const requirements = normalizeConnectionRequirements(configuration.connections ?? {});
 	const accessRequirements = normalizeWorkflowAccess(configuration.access);
@@ -541,6 +581,10 @@ export function workflow<
 		configuration.deadline === undefined ? undefined : structuredClone(configuration.deadline);
 	const retry =
 		configuration.retry === undefined ? undefined : manifestRetryPolicy(configuration.retry);
+	const outputSchema =
+		configuration.outputSchema === undefined
+			? undefined
+			: compileWorkflowOutputSchema(configuration.outputSchema);
 
 	const manualTriggers = triggers.filter(
 		(trigger): trigger is ManualWorkflowTrigger => trigger.type === "workflow.manual",
@@ -569,6 +613,7 @@ export function workflow<
 			...(configuration.access === undefined ? {} : { access: accessRequirements }),
 			...(deadline === undefined ? {} : { deadline }),
 			...(retry === undefined ? {} : { retry }),
+			...(outputSchema === undefined ? {} : { outputJsonSchema: outputSchema.jsonSchema }),
 		},
 		async handler(
 			input: WorkflowEventForTriggers<TTriggers> | WebhookVerifyInvocation,
@@ -630,13 +675,26 @@ export function workflow<
 					}
 					validateManualWorkflowInput(manualTrigger, event.input);
 				}
-				await configuration.handler(event, capabilityContext);
+				const handlerOutput: unknown = await configuration.handler(
+					event,
+					capabilityContext,
+				);
+				const result: WorkflowHandlerResult =
+					outputSchema === undefined
+						? { status: "success" }
+						: {
+								status: "success",
+								output: serializeWorkflowOutput(
+									handlerOutput,
+									outputSchema.validate,
+								),
+							};
 
 				if (options?.concreteOutput) {
-					return { status: "success" };
+					return result;
 				}
 
-				writeOutput({ _tag: "success", value: { status: "success" } });
+				writeOutput({ _tag: "success", value: result });
 			} catch (err) {
 				if (err instanceof WorkflowWaitInterrupt) {
 					if (options?.concreteOutput) {
@@ -721,6 +779,37 @@ function manifestTriggers(
 	);
 }
 
+/** The platform stores workflow output with its run, so it must stay small. */
+const MAX_WORKFLOW_OUTPUT_BYTES = 256 * 1024;
+
+/**
+ * Validates the JSON the platform will receive rather than the in-memory value,
+ * so values that change during serialization, such as `Date` or `toJSON`
+ * objects, are checked in the form callers will see.
+ *
+ * A mismatch is a bug in the handler, so it fails the run without retrying.
+ */
+function serializeWorkflowOutput(
+	value: unknown,
+	validate: (value: unknown) => void,
+): Record<string, unknown> {
+	try {
+		const json = value === undefined ? undefined : JSON.stringify(value);
+		const bytes = json === undefined ? 0 : Buffer.byteLength(json, "utf8");
+		if (bytes > MAX_WORKFLOW_OUTPUT_BYTES) {
+			throw new Error(
+				`Invalid workflow output: must be at most ${MAX_WORKFLOW_OUTPUT_BYTES} bytes as JSON, got ${bytes}.`,
+			);
+		}
+		const serialized: unknown = json === undefined ? undefined : JSON.parse(json);
+		validate(serialized);
+		// SAFETY: validate only accepts values matching the j.object() output schema.
+		return serialized as Record<string, unknown>;
+	} catch (error) {
+		throw new FatalError(error instanceof Error ? error.message : String(error));
+	}
+}
+
 /**
  * Whether an invocation is the platform's synchronous verify dispatch. The
  * platform sends workflow invocations as a trigger event and verify