@notionhq/apps 0.0.13 → 0.0.15

package/src/slack.generated.ts

@@ -0,0 +1,330 @@
+// Generated by notion tool-core codegen-script-types --connections. Do not edit.
+import type { ConnectionActionInvoker } from "./connection-actions.js"
+/**
+ * Script input for the "Find a Slack user by email" effect (`slack.findUserByEmail`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Find a Slack user by email
+ */
+export type FindUserByEmailScriptInput = {
+	email: string
+}
+
+/**
+ * Script result of the "Find a Slack user by email" effect (`slack.findUserByEmail`):
+ * the canonical Tool Core output schema with the effect's declared
+ * script-output projection applied, exactly as the runtime encoder
+ * returns it.
+ */
+export type FindUserByEmailScriptOutput =
+	| {
+			handle: string
+			id: string
+			uri: string
+			displayName?: string
+			email?: string
+			notionUser?: string
+			realName?: string
+			statusEmoji?: string
+			statusText?: string
+			timeZone?: string
+			title?: string
+	  }
+	| undefined
+
+/**
+ * Script input for the "Get Slack channel threads" effect (`slack.getThreadsInChannelSince`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Get all threads in a channel since a given timestamp
+ */
+export type GetThreadsInChannelSinceScriptInput = {
+	/**
+	 * The name of the channel without the # symbol. For example, "engineering".
+	 */
+	channelName: string
+	/**
+	 * ISO 8601 timestamp, for example 2026-01-01T00:00:00Z.
+	 */
+	timestamp: string
+}
+
+/**
+ * Canonical Tool Core output for the "Get Slack channel threads" effect (`slack.getThreadsInChannelSince`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type GetThreadsInChannelSinceScriptOutput = Array<
+	Array<{
+		channelId: string
+		channelUri: string
+		from:
+			| {
+					handle: string
+					id: string
+					type: "user"
+					uri: string
+			  }
+			| {
+					type: "bot"
+			  }
+		id: string
+		message: string
+		threadId: string
+		timestamp: string
+		uri: string
+		url: string
+		urls: Array<string>
+		channel?: string
+		fileIds?: Array<string>
+		files?: Array<string>
+	}>
+>
+
+/**
+ * Script input for the "Load Slack message" effect (`slack.loadMessage`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Load a Slack message by ID.
+ */
+export type LoadMessageScriptInput =
+	| {
+			/**
+			 * Slack channel ID for the message.
+			 */
+			channelId: string
+			/**
+			 * Slack message timestamp (ts).
+			 */
+			messageTs: string
+			/**
+			 * Slack thread timestamp (ts) if threaded.
+			 */
+			threadTs?: string
+			/**
+			 * Slack workspace host parsed from the user's URL
+			 */
+			workspaceHost?: string
+	  }
+	| {
+			/**
+			 * A Slack message identifier. Accepts a slackMessage:// URI as returned by other Slack tools (e.g. slackMessage://workspace.slack.com/C0123ABCDEF/12345/9876543210.987654), a https Slack archive URL, or a connector href from search results (slack://?base_url=...&channel_id=...&message_id=...).
+			 */
+			url: string
+	  }
+
+/**
+ * Canonical Tool Core output for the "Load Slack message" effect (`slack.loadMessage`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type LoadMessageScriptOutput = {
+	type: "slack"
+	channel: string
+	messages: Array<{
+		user: {
+			name: string
+			notionUserName?: string
+			notionUserId?: string
+		}
+		text: string
+		date?: string
+		ts?: string
+		attachments?: Array<string>
+		files?: Array<string>
+	}>
+	timestamp: number
+	additionalMessageToModel?: string
+}
+
+/**
+ * Script input for the "Query Slack channels" effect (`slack.queryChannels`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Query Slack channels by criteria
+ */
+export type QueryChannelsScriptInput = {
+	id?: string
+	name?: string
+	/**
+	 * Filter channels created after this date. ISO format with timezone (e.g. 2024-01-01T00:00:00-05:00 for Eastern Time)
+	 */
+	createdStart?: string
+	/**
+	 * Filter channels created before this date. ISO format with timezone (e.g. 2024-01-01T00:00:00-05:00 for Eastern Time)
+	 */
+	createdEnd?: string
+	isGeneral?: boolean
+	isIm?: boolean
+	isPrivate?: boolean
+	isMpim?: boolean
+	isShared?: boolean
+	isOrgShared?: boolean
+	botIsMember?: boolean
+	isArchived?: boolean
+}
+
+/**
+ * Canonical Tool Core output for the "Query Slack channels" effect (`slack.queryChannels`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type QueryChannelsScriptOutput = Array<{
+	/**
+	 * The Slack channel ID.
+	 */
+	id: string
+	/**
+	 * The prefixed channel URI.
+	 */
+	uri: string
+	/**
+	 * The user-navigable channel URL. Include this link when telling the user the channel was created.
+	 */
+	url: string
+	/**
+	 * The channel name, without a "#" prefix.
+	 */
+	name: string
+	/**
+	 * ISO 8601 timestamp of when the channel was created.
+	 */
+	created: string
+	/**
+	 * Whether this is the workspace's general channel.
+	 */
+	isGeneral: boolean
+	/**
+	 * Whether this is a direct message channel.
+	 */
+	isIm: boolean
+	/**
+	 * Whether the channel is private.
+	 */
+	isPrivate: boolean
+	/**
+	 * Whether this is a group direct message channel.
+	 */
+	isMpim: boolean
+	/**
+	 * Whether the channel is shared between Slack workspaces.
+	 */
+	isShared: boolean
+	/**
+	 * Whether the channel is shared across an Enterprise Grid organization.
+	 */
+	isOrgShared: boolean
+	/**
+	 * Whether the integration bot user is in the channel.
+	 */
+	botIsMember: boolean
+	/**
+	 * Whether the channel is archived.
+	 */
+	isArchived: boolean
+}>
+
+/**
+ * Script input for the "Search Slack messages" effect (`slack.search`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Search Slack via the configured connector.
+ */
+export type SearchScriptInput = {
+	/**
+	 * A single, focused question to search for.
+	 */
+	question: string
+	/**
+	 * Brief keywords capturing the core entities.
+	 */
+	keywords?: string
+	/**
+	 * Optional time window. Use only "default", "all_time", a duration matching /^\d+[dwmy]$/ (for example, "7d", "2w", "3m", or "1y"), or a date in "YYYY-MM-DD" format. Do not use natural-language durations or combine units.
+	 */
+	lookback?: string
+	options?: {
+		/**
+		 * Preferred Slack channel name. This boosts results from that channel but does not filter the search. Results from other conversations may be returned. Check each result's conversation before using it.
+		 */
+		channel?: string
+	}
+}
+
+/**
+ * Canonical Tool Core output for the "Search Slack messages" effect (`slack.search`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type SearchScriptOutput = {
+	results: Array<{
+		conversation: {
+			id: string
+			kind: "channel" | "dm" | "groupDm"
+			name: string
+		}
+		messageUrl: string
+		lastEdited: string
+		messages: Array<{
+			messageUrl: string
+			lastEdited: string
+			text: string
+			user: string
+		}>
+	}>
+}
+
+/**
+ * Script input for the "View Slack file URL" effect (`slack.viewFileUrl`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Return a Slack file URL for script-agent viewing.
+ */
+export type ViewFileUrlScriptInput = {
+	/**
+	 * Slack private file URL or workspace file permalink to download and attach for viewing.
+	 */
+	url: string
+}
+
+/**
+ * Canonical Tool Core output for the "View Slack file URL" effect (`slack.viewFileUrl`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type ViewFileUrlScriptOutput = {
+	url: string
+	fileName?: string
+	fileUrl?: string
+}
+
+export class SlackConnectionClient {
+	constructor(private readonly invoke: ConnectionActionInvoker) {}
+	findUserByEmail(
+		args: FindUserByEmailScriptInput,
+	): Promise<FindUserByEmailScriptOutput> {
+		return this.invoke<FindUserByEmailScriptOutput>("findUserByEmail", args)
+	}
+	getThreadsInChannelSince(
+		args: GetThreadsInChannelSinceScriptInput,
+	): Promise<GetThreadsInChannelSinceScriptOutput> {
+		return this.invoke<GetThreadsInChannelSinceScriptOutput>(
+			"getThreadsInChannelSince",
+			args,
+		)
+	}
+	loadMessage(args: LoadMessageScriptInput): Promise<LoadMessageScriptOutput> {
+		return this.invoke<LoadMessageScriptOutput>("loadMessage", args)
+	}
+	queryChannels(
+		args: QueryChannelsScriptInput,
+	): Promise<QueryChannelsScriptOutput> {
+		return this.invoke<QueryChannelsScriptOutput>("queryChannels", args)
+	}
+	search(args: SearchScriptInput): Promise<SearchScriptOutput> {
+		return this.invoke<SearchScriptOutput>("search", args)
+	}
+	viewFileUrl(args: ViewFileUrlScriptInput): Promise<ViewFileUrlScriptOutput> {
+		return this.invoke<ViewFileUrlScriptOutput>("viewFileUrl", args)
+	}
+}

package/src/sync.ts

@@ -89,7 +89,7 @@ export type SyncConfiguration<
 };
 
 /** Configuration for a sync backed by a Notion-as-Code data source. */
-type DataSourceSyncConfiguration<
+export type DataSourceSyncConfiguration<
 	Properties extends readonly NotionAsCodeProperty[],
 	PrimaryKey extends KeyPropertyName<AppsSchemaForProperties<Properties>>,
 	State,
@@ -165,7 +165,7 @@ export function createSync<
 }
 
 /** Create a sync backed by a Notion-as-Code data source. */
-export function createDataSourceSync<
+export function sync<
 	const Properties extends readonly NotionAsCodeProperty[],
 	const PrimaryKey extends KeyPropertyName<AppsSchemaForProperties<Properties>>,
 	State = unknown,

package/src/triggers.generated.ts

@@ -1,6 +1,8 @@
 // Generated by scripts/generate-triggers.ts — do not edit by hand.
 // Regenerate with: pnpm run generate
 
+import type { WorkflowConnection, WorkflowConnectionKeys } from "./connections.js";
+
 import type {
 	CalendarEventCanceledEvent,
 	CalendarEventCreatedEvent,
@@ -72,24 +74,32 @@ export type {
 	WebhookEvent,
 } from "./triggers.js";
 
-/** A message was posted in a subscribed Slack channel. */
-export type SlackMessageTrigger = {
+/** Triggers immediately after a new message is posted in Slack (includes new threads and replies) */
+export type SlackMessageTrigger<TKey extends string = string> = {
 	type: "slack.message";
+	/** Key of the declared slack connection. */
+	connectionKey?: TKey;
 };
 
-/** A reaction was added to a Slack message. */
-export type SlackReactionAddedTrigger = {
+/** Triggers immediately after a reaction is added to a message in Slack */
+export type SlackReactionAddedTrigger<TKey extends string = string> = {
 	type: "slack.reaction.added";
+	/** Key of the declared slack connection. */
+	connectionKey?: TKey;
 };
 
-/** The Notion app was mentioned in a Slack message. */
-export type SlackAppMentionTrigger = {
+/** Triggers when the agent is mentioned in a Slack channel or direct message */
+export type SlackAppMentionTrigger<TKey extends string = string> = {
 	type: "slack.app.mention";
+	/** Key of the declared slack connection. */
+	connectionKey?: TKey;
 };
 
-/** A Discord interaction was received. */
-export type DiscordInteractionTrigger = {
+/** Triggers when a user invokes the /ai slash command in a configured Discord channel */
+export type DiscordInteractionTrigger<TKey extends string = string> = {
 	type: "discord.interaction";
+	/** Key of the declared discord connection. */
+	connectionKey?: TKey;
 };
 
 /** An email was received. */
@@ -107,19 +117,25 @@ export type MailLabelAppliedTrigger = {
 	type: "mail.label.applied";
 };
 
-/** A calendar event was created. */
-export type CalendarEventCreatedTrigger = {
+/** Triggers immediately when a calendar event is created */
+export type CalendarEventCreatedTrigger<TKey extends string = string> = {
 	type: "calendar.event.created";
+	/** Key of the declared calendar connection. */
+	connectionKey?: TKey;
 };
 
-/** A calendar event was updated. */
-export type CalendarEventUpdatedTrigger = {
+/** Triggers immediately when a calendar event is updated */
+export type CalendarEventUpdatedTrigger<TKey extends string = string> = {
 	type: "calendar.event.updated";
+	/** Key of the declared calendar connection. */
+	connectionKey?: TKey;
 };
 
-/** A calendar event was canceled. */
-export type CalendarEventCanceledTrigger = {
+/** Triggers immediately when a calendar event is canceled */
+export type CalendarEventCanceledTrigger<TKey extends string = string> = {
 	type: "calendar.event.canceled";
+	/** Key of the declared calendar connection. */
+	connectionKey?: TKey;
 };
 
 /** A page has been added to a database. */
@@ -167,9 +183,11 @@ export type WebhookTrigger = {
 	type: "webhooks.webhook";
 };
 
-/** Files changed in a watched Google Drive folder or drive. */
-export type GoogleDriveOauthFilesChangedTrigger = {
+/** Watches for file changes in a specific Google Drive folder (direct children only) or shared drive. The My Drive root is not supported. Fires on a schedule and provides change tokens for fetching the list of changes. */
+export type GoogleDriveOauthFilesChangedTrigger<TKey extends string = string> = {
 	type: "googleDriveOauth.filesChanged";
+	/** Key of the declared googleDriveOauth connection. */
+	connectionKey?: TKey;
 };
 
 /** A recurring schedule fired. */
@@ -182,44 +200,48 @@ export const triggers = {
 	/**
 	 * Declare that a workflow can run on `slack.message` events.
 	 *
-	 * A message was posted in a subscribed Slack channel.
+	 * Triggers immediately after a new message is posted in Slack (includes new threads and replies)
 	 */
-	slackMessage(): SlackMessageTrigger {
+	slackMessage<const TKey extends string = never>(options: { connectionKey: TKey } | undefined = undefined): SlackMessageTrigger<TKey> {
 		return {
 			type: "slack.message",
+			...(options === undefined ? {} : { connectionKey: options.connectionKey }),
 		};
 	},
 
 	/**
 	 * Declare that a workflow can run on `slack.reaction.added` events.
 	 *
-	 * A reaction was added to a Slack message.
+	 * Triggers immediately after a reaction is added to a message in Slack
 	 */
-	slackReactionAdded(): SlackReactionAddedTrigger {
+	slackReactionAdded<const TKey extends string = never>(options: { connectionKey: TKey } | undefined = undefined): SlackReactionAddedTrigger<TKey> {
 		return {
 			type: "slack.reaction.added",
+			...(options === undefined ? {} : { connectionKey: options.connectionKey }),
 		};
 	},
 
 	/**
 	 * Declare that a workflow can run on `slack.app.mention` events.
 	 *
-	 * The Notion app was mentioned in a Slack message.
+	 * Triggers when the agent is mentioned in a Slack channel or direct message
 	 */
-	slackAppMention(): SlackAppMentionTrigger {
+	slackAppMention<const TKey extends string = never>(options: { connectionKey: TKey } | undefined = undefined): SlackAppMentionTrigger<TKey> {
 		return {
 			type: "slack.app.mention",
+			...(options === undefined ? {} : { connectionKey: options.connectionKey }),
 		};
 	},
 
 	/**
 	 * Declare that a workflow can run on `discord.interaction` events.
 	 *
-	 * A Discord interaction was received.
+	 * Triggers when a user invokes the /ai slash command in a configured Discord channel
 	 */
-	discordInteraction(): DiscordInteractionTrigger {
+	discordInteraction<const TKey extends string = never>(options: { connectionKey: TKey } | undefined = undefined): DiscordInteractionTrigger<TKey> {
 		return {
 			type: "discord.interaction",
+			...(options === undefined ? {} : { connectionKey: options.connectionKey }),
 		};
 	},
 
@@ -259,33 +281,36 @@ export const triggers = {
 	/**
 	 * Declare that a workflow can run on `calendar.event.created` events.
 	 *
-	 * A calendar event was created.
+	 * Triggers immediately when a calendar event is created
 	 */
-	calendarEventCreated(): CalendarEventCreatedTrigger {
+	calendarEventCreated<const TKey extends string = never>(options: { connectionKey: TKey } | undefined = undefined): CalendarEventCreatedTrigger<TKey> {
 		return {
 			type: "calendar.event.created",
+			...(options === undefined ? {} : { connectionKey: options.connectionKey }),
 		};
 	},
 
 	/**
 	 * Declare that a workflow can run on `calendar.event.updated` events.
 	 *
-	 * A calendar event was updated.
+	 * Triggers immediately when a calendar event is updated
 	 */
-	calendarEventUpdated(): CalendarEventUpdatedTrigger {
+	calendarEventUpdated<const TKey extends string = never>(options: { connectionKey: TKey } | undefined = undefined): CalendarEventUpdatedTrigger<TKey> {
 		return {
 			type: "calendar.event.updated",
+			...(options === undefined ? {} : { connectionKey: options.connectionKey }),
 		};
 	},
 
 	/**
 	 * Declare that a workflow can run on `calendar.event.canceled` events.
 	 *
-	 * A calendar event was canceled.
+	 * Triggers immediately when a calendar event is canceled
 	 */
-	calendarEventCanceled(): CalendarEventCanceledTrigger {
+	calendarEventCanceled<const TKey extends string = never>(options: { connectionKey: TKey } | undefined = undefined): CalendarEventCanceledTrigger<TKey> {
 		return {
 			type: "calendar.event.canceled",
+			...(options === undefined ? {} : { connectionKey: options.connectionKey }),
 		};
 	},
 
@@ -391,11 +416,12 @@ export const triggers = {
 	/**
 	 * Declare that a workflow can run on `googleDriveOauth.filesChanged` events.
 	 *
-	 * Files changed in a watched Google Drive folder or drive.
+	 * Watches for file changes in a specific Google Drive folder (direct children only) or shared drive. The My Drive root is not supported. Fires on a schedule and provides change tokens for fetching the list of changes.
 	 */
-	googleDriveOauthFilesChanged(): GoogleDriveOauthFilesChangedTrigger {
+	googleDriveOauthFilesChanged<const TKey extends string = never>(options: { connectionKey: TKey } | undefined = undefined): GoogleDriveOauthFilesChangedTrigger<TKey> {
 		return {
 			type: "googleDriveOauth.filesChanged",
+			...(options === undefined ? {} : { connectionKey: options.connectionKey }),
 		};
 	},
 
@@ -411,6 +437,60 @@ export const triggers = {
 	},
 } as const;
 
+/** Trigger creators restricted to the workflow's declared provider keys. */
+export type WorkflowTriggerCreators<TConnections extends readonly WorkflowConnection[]> = {
+	slackMessage(options?: { connectionKey: WorkflowConnectionKeys<TConnections, "slack"> }): SlackMessageTrigger<WorkflowConnectionKeys<TConnections, "slack">>;
+	slackReactionAdded(options?: { connectionKey: WorkflowConnectionKeys<TConnections, "slack"> }): SlackReactionAddedTrigger<WorkflowConnectionKeys<TConnections, "slack">>;
+	slackAppMention(options?: { connectionKey: WorkflowConnectionKeys<TConnections, "slack"> }): SlackAppMentionTrigger<WorkflowConnectionKeys<TConnections, "slack">>;
+	discordInteraction(options?: { connectionKey: WorkflowConnectionKeys<TConnections, "discord"> }): DiscordInteractionTrigger<WorkflowConnectionKeys<TConnections, "discord">>;
+	mailEmailReceived(): MailEmailReceivedTrigger;
+	mailEmailSent(): MailEmailSentTrigger;
+	mailLabelApplied(): MailLabelAppliedTrigger;
+	calendarEventCreated(options?: { connectionKey: WorkflowConnectionKeys<TConnections, "calendar"> }): CalendarEventCreatedTrigger<WorkflowConnectionKeys<TConnections, "calendar">>;
+	calendarEventUpdated(options?: { connectionKey: WorkflowConnectionKeys<TConnections, "calendar"> }): CalendarEventUpdatedTrigger<WorkflowConnectionKeys<TConnections, "calendar">>;
+	calendarEventCanceled(options?: { connectionKey: WorkflowConnectionKeys<TConnections, "calendar"> }): CalendarEventCanceledTrigger<WorkflowConnectionKeys<TConnections, "calendar">>;
+	notionPageCreated(): NotionPageCreatedTrigger;
+	notionPageUpdated(): NotionPageUpdatedTrigger;
+	notionPageDeleted(): NotionPageDeletedTrigger;
+	notionMeetingNoteSummaryCompleted(): NotionMeetingNoteSummaryCompletedTrigger;
+	notionCommentAdded(): NotionCommentAddedTrigger;
+	notionAgentMentioned(): NotionAgentMentionedTrigger;
+	notionButtonPressed(): NotionButtonPressedTrigger;
+	notionDatabaseAgentUpdated(): NotionDatabaseAgentUpdatedTrigger;
+	webhook(): WebhookTrigger;
+	googleDriveOauthFilesChanged(options?: { connectionKey: WorkflowConnectionKeys<TConnections, "googleDriveOauth"> }): GoogleDriveOauthFilesChangedTrigger<WorkflowConnectionKeys<TConnections, "googleDriveOauth">>;
+	scheduled(): RecurrenceTrigger;
+};
+
+/** Triggers whose connection keys belong to the declared provider. */
+export type WorkflowTriggerForConnections<TConnections extends readonly WorkflowConnection[]> =
+	| SlackMessageTrigger<WorkflowConnectionKeys<TConnections, "slack">>
+	| SlackReactionAddedTrigger<WorkflowConnectionKeys<TConnections, "slack">>
+	| SlackAppMentionTrigger<WorkflowConnectionKeys<TConnections, "slack">>
+	| DiscordInteractionTrigger<WorkflowConnectionKeys<TConnections, "discord">>
+	| MailEmailReceivedTrigger
+	| MailEmailSentTrigger
+	| MailLabelAppliedTrigger
+	| CalendarEventCreatedTrigger<WorkflowConnectionKeys<TConnections, "calendar">>
+	| CalendarEventUpdatedTrigger<WorkflowConnectionKeys<TConnections, "calendar">>
+	| CalendarEventCanceledTrigger<WorkflowConnectionKeys<TConnections, "calendar">>
+	| NotionPageCreatedTrigger
+	| NotionPageUpdatedTrigger
+	| NotionPageDeletedTrigger
+	| NotionMeetingNoteSummaryCompletedTrigger
+	| NotionCommentAddedTrigger
+	| NotionAgentMentionedTrigger
+	| NotionButtonPressedTrigger
+	| NotionDatabaseAgentUpdatedTrigger
+	| WebhookTrigger
+	| GoogleDriveOauthFilesChangedTrigger<WorkflowConnectionKeys<TConnections, "googleDriveOauth">>
+	| RecurrenceTrigger;
+
+/** @internal */
+export function createWorkflowTriggers<TConnections extends readonly WorkflowConnection[]>(): WorkflowTriggerCreators<TConnections> {
+	return triggers;
+}
+
 /** Event that can trigger a workflow. */
 export type WorkflowTrigger =
 	| SlackMessageTrigger

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

@@ -0,0 +1,59 @@
+import { expectTypeOf, it } from "vitest";
+import { triggers } from "./triggers.generated.js";
+import { connections, workflow, type WorkflowConnection } from "./workflow.js";
+
+it("infers only the declared provider clients", () => {
+	workflow({
+		name: "Calendar",
+		description: "Calendar only",
+		triggers: [triggers.notionPageCreated()],
+		connections: [connections.calendar({ key: "work" })],
+		handler(_event, context) {
+			expectTypeOf<keyof typeof context.connections>().toEqualTypeOf<"calendar">();
+			expectTypeOf(context.connections.calendar).toBeFunction();
+		},
+	});
+	const requirements = [connections.calendar(), connections.slack({ key: "support" })];
+	workflow({
+		name: "Multiple providers",
+		description: "Preserves providers in a separately declared array",
+		triggers: [triggers.notionPageCreated()],
+		connections: requirements,
+		handler(_event, context) {
+			expectTypeOf<keyof typeof context.connections>().toEqualTypeOf<"calendar" | "slack">();
+		},
+	});
+});
+
+it("exposes no providers for omitted or empty connections", () => {
+	workflow({
+		name: "No connections",
+		description: "Omitted",
+		triggers: [triggers.notionPageCreated()],
+		handler(_event, context) {
+			expectTypeOf<keyof typeof context.connections>().toEqualTypeOf<never>();
+		},
+	});
+	workflow({
+		name: "No connections",
+		description: "Empty",
+		triggers: [triggers.notionPageCreated()],
+		connections: [],
+		handler(_event, context) {
+			expectTypeOf<keyof typeof context.connections>().toEqualTypeOf<never>();
+		},
+	});
+});
+
+it("preserves literal declarations checked with satisfies", () => {
+	const requirements = [connections.slack()] satisfies readonly WorkflowConnection[];
+	workflow({
+		name: "Slack",
+		description: "Slack only",
+		triggers: [triggers.notionPageCreated()],
+		connections: requirements,
+		handler(_event, context) {
+			expectTypeOf<keyof typeof context.connections>().toEqualTypeOf<"slack">();
+		},
+	});
+});