@notionhq/apps 0.0.46 → 0.0.48

package/README.md

@@ -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/notion-as-code/resource.d.ts

@@ -1,6 +1,6 @@
 import { type Parent } from "./intents.js";
-/** Validate parent references accepted by Apps declarations. */
+/** Validate parent references. Reserved Apps IDs are allowed as parents. */
 export declare function assertParent(parent: Parent): void;
-/** Reject empty or runtime-reserved resource IDs in user declarations. */
+/** Reject empty or runtime-reserved IDs for created resources. */
 export declare function assertUserResourceId(resourceId: string): void;
 //# sourceMappingURL=resource.d.ts.map

package/dist/notion-as-code/resource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/notion-as-code/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAE7E,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAKjD;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAO7D"}
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/notion-as-code/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAE7E,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAOjD;AAED,kEAAkE;AAClE,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAO7D"}

package/dist/notion-as-code/resource.js

@@ -3,7 +3,9 @@ function assertParent(parent) {
   if (parent.type !== "resourceId") {
     throw new Error("Notion-as-Code parents must reference a resourceId");
   }
-  assertUserResourceId(parent.resourceId);
+  if (parent.resourceId.length === 0) {
+    throw new Error("Notion-as-Code resourceId must be a non-empty string");
+  }
 }
 function assertUserResourceId(resourceId) {
   if (resourceId.length === 0) {

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.46",
+	"version": "0.0.48",
 	"description": "An SDK for building workflow apps for Notion",
 	"license": "MIT",
 	"bin": {

package/skills/notion-as-code/SKILL.md

@@ -155,8 +155,10 @@ Custom views do not accept standard view properties, sorts, or filters. Keep
 the view resource ID and the custom-block filename stable across builds.
 
 Keep resource IDs stable across builds. They identify declarations, not live
-Notion UUIDs. Avoid the reserved `__notion_apps_` prefix. Explicit parents
-use `{ type: "resourceId", resourceId: parent.resourceId }`; child helpers set
+Notion UUIDs. Do not create resources whose IDs use the reserved
+`__notion_apps_` prefix. Parenting to reserved IDs such as
+`__notion_apps_app_md__` is allowed. Explicit parents use
+`{ type: "resourceId", resourceId: parent.resourceId }`; child helpers set
 this reference for you. Pages and databases without a parent default to private
 top-level resources in the Apps workspace.
 

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/notion-as-code/database.test.ts

@@ -791,6 +791,32 @@ describe("Notion-as-Code database declarations", () => {
 		expect(serialized.description).toBe("Metadata source");
 	});
 
+	it("allows parenting a database to a reserved Apps resource ID", () => {
+		const recorder = startMetadataRecording();
+		notion.database("meetings-db", {
+			parent: { type: "resourceId", resourceId: "__notion_apps_app_md__" },
+			dataSourceResourceId: "meetings-source",
+			name: "Meetings",
+			schema: { Name: { resourceId: "meeting-name", type: "title" } },
+		});
+		expect(finishMetadataRecording(recorder).intents[0]).toEqual(
+			expect.objectContaining({
+				resourceId: "meetings-db",
+				parent: { type: "resourceId", resourceId: "__notion_apps_app_md__" },
+			}),
+		);
+	});
+
+	it("rejects creating a database whose resource ID uses the reserved Apps prefix", () => {
+		expect(() =>
+			notion.database("__notion_apps_meetings__", {
+				dataSourceResourceId: "meetings-source",
+				name: "Meetings",
+				schema: { Name: { resourceId: "meeting-name", type: "title" } },
+			}),
+		).toThrow('Resource ID "__notion_apps_meetings__" uses the reserved Apps prefix');
+	});
+
 	it("requires the status property configuration in authoring types", () => {
 		const invalidStatusDeclaration = () =>
 			notion.database("missing-status-options-database", {

package/src/notion-as-code/page.test.ts

@@ -28,6 +28,30 @@ describe("Notion-as-Code page declarations", () => {
 		]);
 	});
 
+	it("allows parenting a page to a reserved Apps resource ID", () => {
+		const recorder = startMetadataRecording();
+		notion.page({
+			resourceId: "guide",
+			parent: { type: "resourceId", resourceId: "__notion_apps_app_md__" },
+			properties: { title: notion.text("Guide") },
+		});
+		expect(finishMetadataRecording(recorder).intents[0]).toEqual(
+			expect.objectContaining({
+				resourceId: "guide",
+				parent: { type: "resourceId", resourceId: "__notion_apps_app_md__" },
+			}),
+		);
+	});
+
+	it("rejects creating a page whose resource ID uses the reserved Apps prefix", () => {
+		expect(() =>
+			notion.page({
+				resourceId: "__notion_apps_guide__",
+				properties: { title: notion.text("Guide") },
+			}),
+		).toThrow('Resource ID "__notion_apps_guide__" uses the reserved Apps prefix');
+	});
+
 	it("records a regular page title separately from Markdown content", () => {
 		const properties = {
 			title: notion.text("Workflow guide"),

package/src/notion-as-code/resource.ts

@@ -1,14 +1,16 @@
 import { APPS_RESERVED_RESOURCE_ID_PREFIX, type Parent } from "./intents.js";
 
-/** Validate parent references accepted by Apps declarations. */
+/** Validate parent references. Reserved Apps IDs are allowed as parents. */
 export function assertParent(parent: Parent): void {
 	if (parent.type !== "resourceId") {
 		throw new Error("Notion-as-Code parents must reference a resourceId");
 	}
-	assertUserResourceId(parent.resourceId);
+	if (parent.resourceId.length === 0) {
+		throw new Error("Notion-as-Code resourceId must be a non-empty string");
+	}
 }
 
-/** Reject empty or runtime-reserved resource IDs in user declarations. */
+/** Reject empty or runtime-reserved IDs for created resources. */
 export function assertUserResourceId(resourceId: string): void {
 	if (resourceId.length === 0) {
 		throw new Error("Notion-as-Code resourceId must be a non-empty string");

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

@@ -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>>> {

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