@notionhq/apps 0.0.13 → 0.0.15

package/src/cursor.generated.ts

@@ -0,0 +1,167 @@
+// Generated by notion tool-core codegen-script-types --connections. Do not edit.
+import type { ConnectionActionInvoker } from "./connection-actions.js"
+/**
+ * Script input for the "Create Cursor agent" effect (`cursor.createAgent`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Create a new Cursor agent
+ */
+export type CreateAgentScriptInput = {
+	/**
+	 * What you want the agent to do
+	 */
+	prompt: string
+	/**
+	 * GitHub repository URL or owner/repo format (e.g. 'owner/repo' or 'https://github.com/owner/repo')
+	 */
+	repository: string
+	/**
+	 * Optional branch or ref to work from (e.g. 'main', 'develop')
+	 */
+	ref?: string
+	/**
+	 * Custom branch name for the agent to create in the target repository.
+	 */
+	branchName?: string
+	/**
+	 * Whether to open the pull request as the Cursor GitHub App instead of as the user (default: true). Only applies when a PR is auto-created.
+	 */
+	openAsCursorGithubApp?: boolean
+	/**
+	 * Whether to skip adding the user as a reviewer on the pull request. Only applies if autoCreatePr is true and the PR is opened as the Cursor GitHub App (default: false).
+	 */
+	skipReviewerRequest?: boolean
+	webhook?: {
+		/**
+		 * Webhook URL to receive agent status updates.
+		 */
+		url: string
+		/**
+		 * Optional shared secret for verifying webhook signatures.
+		 */
+		secret?: string
+	}
+}
+
+/**
+ * Canonical Tool Core output for the "Create Cursor agent" effect (`cursor.createAgent`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type CreateAgentScriptOutput = {
+	id: string
+	name: string
+	/**
+	 * One of: `CREATING`, `RUNNING`, `FINISHED`, `ERROR`, `EXPIRED`
+	 */
+	status: "CREATING" | "RUNNING" | "FINISHED" | "ERROR" | "EXPIRED"
+	source: {
+		repository: string
+		ref?: string
+	}
+	target: {
+		url: string
+		prUrl?: string
+		branchName?: string
+		autoCreatePr?: boolean
+		autoBranch?: boolean
+		openAsCursorGithubApp?: boolean
+		skipReviewerRequest?: boolean
+	}
+	createdAt: string
+	summary?: string
+	conversation?: {
+		id: string
+		messages: Array<{
+			id: string
+			type: string
+			text: string
+		}>
+	}
+}
+
+/**
+ * Script input for the "Get Cursor agent" effect (`cursor.getAgent`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Get a Cursor agent by ID
+ */
+export type GetAgentScriptInput = {
+	/**
+	 * The ID of the Cursor agent to get (e.g. 'agent-123')
+	 */
+	agentId: string
+}
+
+/**
+ * Canonical Tool Core output for the "Get Cursor agent" effect (`cursor.getAgent`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type GetAgentScriptOutput = {
+	id: string
+	name: string
+	/**
+	 * One of: `CREATING`, `RUNNING`, `FINISHED`, `ERROR`, `EXPIRED`
+	 */
+	status: "CREATING" | "RUNNING" | "FINISHED" | "ERROR" | "EXPIRED"
+	source: {
+		repository: string
+		ref?: string
+	}
+	target: {
+		url: string
+		prUrl?: string
+		branchName?: string
+		autoCreatePr?: boolean
+		autoBranch?: boolean
+		openAsCursorGithubApp?: boolean
+		skipReviewerRequest?: boolean
+	}
+	createdAt: string
+	summary?: string
+	conversation?: {
+		id: string
+		messages: Array<{
+			id: string
+			type: string
+			text: string
+		}>
+	}
+}
+
+/**
+ * Script input for the "List Cursor repositories" effect (`cursor.listRepositories`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * List accessible Cursor repositories
+ */
+export type ListRepositoriesScriptInput = Record<string, never>
+
+/**
+ * Canonical Tool Core output for the "List Cursor repositories" effect (`cursor.listRepositories`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type ListRepositoriesScriptOutput = {
+	repositories: Array<{
+		owner: string
+		name: string
+		repository: string
+	}>
+}
+
+export class CursorConnectionClient {
+	constructor(private readonly invoke: ConnectionActionInvoker) {}
+	createAgent(args: CreateAgentScriptInput): Promise<CreateAgentScriptOutput> {
+		return this.invoke<CreateAgentScriptOutput>("createAgent", args)
+	}
+	getAgent(args: GetAgentScriptInput): Promise<GetAgentScriptOutput> {
+		return this.invoke<GetAgentScriptOutput>("getAgent", args)
+	}
+	listRepositories(
+		args: ListRepositoriesScriptInput,
+	): Promise<ListRepositoriesScriptOutput> {
+		return this.invoke<ListRepositoriesScriptOutput>("listRepositories", args)
+	}
+}

package/src/custom-block.test.ts

@@ -1,9 +1,9 @@
 import { describe, expect, it } from "vitest";
-import { createCustomBlock } from "./custom-block.js";
+import { customBlock } from "./custom-block.js";
 
-describe("createCustomBlock", () => {
+describe("customBlock", () => {
 	it("supports static assets without a build command", () => {
-		expect(createCustomBlock({ path: "assets", static: true }).config.source).toEqual({
+		expect(customBlock({ path: "assets", static: true }).config.source).toEqual({
 			type: "static",
 			path: "assets",
 		});
@@ -11,7 +11,7 @@ describe("createCustomBlock", () => {
 	it.each(["//hello", "Hello", "-hello", "", "a".repeat(65)])(
 		"rejects invalid slash command %s",
 		(slashCommand) => {
-			expect(() => createCustomBlock({ path: "blocks/hello", slashCommand })).toThrow(
+			expect(() => customBlock({ path: "blocks/hello", slashCommand })).toThrow(
 				/slashCommand/,
 			);
 		},

package/src/custom-block.ts

@@ -10,9 +10,9 @@ export type CustomBlockOptions = {
 );
 
 /** Declare a browser project. Its filename under src/customBlocks supplies its key. */
-export function createCustomBlock(options: CustomBlockOptions) {
+export function customBlock(options: CustomBlockOptions) {
 	if (typeof options.path !== "string" || options.path.trim() === "") {
-		throw new Error("createCustomBlock requires a non-empty path relative to the app root");
+		throw new Error("customBlock requires a non-empty path relative to the app root");
 	}
 	const slashCommand = options.slashCommand?.replace(/^\//, "");
 	if (slashCommand !== undefined && !/^[a-z0-9][a-z0-9_-]{0,63}$/.test(slashCommand)) {

package/src/discord.generated.ts

@@ -0,0 +1,318 @@
+// Generated by notion tool-core codegen-script-types --connections. Do not edit.
+import type { ConnectionActionInvoker } from "./connection-actions.js"
+/**
+ * Script input for the "Add Discord reaction" effect (`discord.addReaction`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Add a reaction to a Discord message
+ */
+export type AddReactionScriptInput = {
+	/**
+	 * The Discord channel ID containing the message.
+	 */
+	channelId: string
+	/**
+	 * The Discord message ID to react to.
+	 */
+	messageId: string
+	/**
+	 * The emoji to react with. Use Unicode emoji (e.g. "👍") or custom emoji in the format "name:id" (e.g. "notionlogo:123456789").
+	 */
+	emoji: string
+}
+
+/**
+ * Canonical Tool Core output for the "Add Discord reaction" effect (`discord.addReaction`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type AddReactionScriptOutput = Record<string, never>
+
+/**
+ * Script input for the "Get recent Discord channel messages" effect (`discord.getRecentChannelMessages`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Get recent messages from a Discord channel
+ */
+export type GetRecentChannelMessagesScriptInput = {
+	/**
+	 * The Discord channel ID to read messages from.
+	 */
+	channelId: string
+	/**
+	 * Number of messages to retrieve (1-50, default 25).
+	 */
+	limit?: number
+}
+
+/**
+ * Canonical Tool Core output for the "Get recent Discord channel messages" effect (`discord.getRecentChannelMessages`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type GetRecentChannelMessagesScriptOutput = Array<{
+	/**
+	 * The Discord message ID (snowflake).
+	 */
+	id: string
+	/**
+	 * The Discord channel ID containing the message.
+	 */
+	channelId: string
+	/**
+	 * The Discord guild (server) ID.
+	 */
+	guildId: string
+	/**
+	 * The Discord markdown message content.
+	 */
+	content: string
+	/**
+	 * Whether the message was sent by the bot.
+	 */
+	fromBot: boolean
+	/**
+	 * The message timestamp in ISO 8601 format.
+	 */
+	timestamp: string
+	/**
+	 * A user-navigable URL to the message.
+	 */
+	url: string
+	/**
+	 * The channel name, when available.
+	 */
+	channelName?: string
+}>
+
+/**
+ * Script input for the "List Discord channels" effect (`discord.listChannels`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * List text channels in the Discord server
+ */
+export type ListChannelsScriptInput = Record<string, never>
+
+/**
+ * Canonical Tool Core output for the "List Discord channels" effect (`discord.listChannels`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type ListChannelsScriptOutput = Array<{
+	/**
+	 * The Discord channel ID (snowflake).
+	 */
+	id: string
+	/**
+	 * The channel name.
+	 */
+	name: string
+	/**
+	 * The channel type: "text", "announcement", "forum", or "media".
+	 */
+	type: string
+}>
+
+/**
+ * Script input for the "Remove Discord reaction" effect (`discord.removeReaction`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Remove a reaction from a Discord message
+ */
+export type RemoveReactionScriptInput = {
+	/**
+	 * The Discord channel ID containing the message.
+	 */
+	channelId: string
+	/**
+	 * The Discord message ID to remove the reaction from.
+	 */
+	messageId: string
+	/**
+	 * The emoji to remove. Use Unicode emoji (e.g. "👍") or custom emoji in the format "name:id" (e.g. "notionlogo:123456789").
+	 */
+	emoji: string
+}
+
+/**
+ * Canonical Tool Core output for the "Remove Discord reaction" effect (`discord.removeReaction`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type RemoveReactionScriptOutput = Record<string, never>
+
+/**
+ * Script input for the "Send Discord channel message" effect (`discord.sendMessageToChannel`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Send a new message to a Discord channel
+ */
+export type SendMessageToChannelScriptInput = {
+	/**
+	 * The Discord channel ID (snowflake) to send the message to.
+	 */
+	channelId: string
+	/**
+	 * ## Follow these guidelines when sending Discord messages:
+	 * **Response Length:**
+	 * - Keep responses to 1-2 short sentences maximum
+	 * - No long paragraphs or blocks of text
+	 * - Break longer content into bullets or line breaks
+	 * - Every response must be instantly scannable
+	 *
+	 * **Tone:**
+	 * - Write like a friendly human co-worker
+	 * - Be concise and direct
+	 *
+	 * **Formatting:**
+	 * - Use standard Discord markdown
+	 * - Use bullets for lists
+	 * - Use **bold** for emphasis
+	 * - Use line breaks for clarity
+	 * - Emojis allowed sparingly for clarity or tone
+	 *
+	 * **Links:**
+	 * - Always use markdown link syntax: [link text](url)
+	 * - Never use raw URLs
+	 */
+	content: string
+}
+
+/**
+ * Canonical Tool Core output for the "Send Discord channel message" effect (`discord.sendMessageToChannel`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type SendMessageToChannelScriptOutput = {
+	/**
+	 * The Discord message ID (snowflake).
+	 */
+	id: string
+	/**
+	 * The Discord channel ID containing the message.
+	 */
+	channelId: string
+	/**
+	 * The Discord guild (server) ID.
+	 */
+	guildId: string
+	/**
+	 * The Discord markdown message content.
+	 */
+	content: string
+	/**
+	 * Whether the message was sent by the bot.
+	 */
+	fromBot: boolean
+	/**
+	 * The message timestamp in ISO 8601 format.
+	 */
+	timestamp: string
+	/**
+	 * A user-navigable URL to the message.
+	 */
+	url: string
+	/**
+	 * The channel name, when available.
+	 */
+	channelName?: string
+}
+
+/**
+ * Script input for the "Update Discord message" effect (`discord.updateMessage`),
+ * derived from its Tool Core definition's call_function input projection.
+ *
+ * Update an existing Discord message
+ */
+export type UpdateMessageScriptInput = {
+	/**
+	 * The Discord channel ID containing the message.
+	 */
+	channelId: string
+	/**
+	 * The Discord message ID to update.
+	 */
+	messageId: string
+	/**
+	 * The new content for the message (Discord markdown).
+	 */
+	content: string
+}
+
+/**
+ * Canonical Tool Core output for the "Update Discord message" effect (`discord.updateMessage`).
+ * This is the definition's output schema; the effect's script surface may
+ * re-encode it before returning.
+ */
+export type UpdateMessageScriptOutput = {
+	/**
+	 * The Discord message ID (snowflake).
+	 */
+	id: string
+	/**
+	 * The Discord channel ID containing the message.
+	 */
+	channelId: string
+	/**
+	 * The Discord guild (server) ID.
+	 */
+	guildId: string
+	/**
+	 * The Discord markdown message content.
+	 */
+	content: string
+	/**
+	 * Whether the message was sent by the bot.
+	 */
+	fromBot: boolean
+	/**
+	 * The message timestamp in ISO 8601 format.
+	 */
+	timestamp: string
+	/**
+	 * A user-navigable URL to the message.
+	 */
+	url: string
+	/**
+	 * The channel name, when available.
+	 */
+	channelName?: string
+}
+
+export class DiscordConnectionClient {
+	constructor(private readonly invoke: ConnectionActionInvoker) {}
+	addReaction(args: AddReactionScriptInput): Promise<AddReactionScriptOutput> {
+		return this.invoke<AddReactionScriptOutput>("addReaction", args)
+	}
+	getRecentChannelMessages(
+		args: GetRecentChannelMessagesScriptInput,
+	): Promise<GetRecentChannelMessagesScriptOutput> {
+		return this.invoke<GetRecentChannelMessagesScriptOutput>(
+			"getRecentChannelMessages",
+			args,
+		)
+	}
+	listChannels(
+		args: ListChannelsScriptInput,
+	): Promise<ListChannelsScriptOutput> {
+		return this.invoke<ListChannelsScriptOutput>("listChannels", args)
+	}
+	removeReaction(
+		args: RemoveReactionScriptInput,
+	): Promise<RemoveReactionScriptOutput> {
+		return this.invoke<RemoveReactionScriptOutput>("removeReaction", args)
+	}
+	sendMessageToChannel(
+		args: SendMessageToChannelScriptInput,
+	): Promise<SendMessageToChannelScriptOutput> {
+		return this.invoke<SendMessageToChannelScriptOutput>(
+			"sendMessageToChannel",
+			args,
+		)
+	}
+	updateMessage(
+		args: UpdateMessageScriptInput,
+	): Promise<UpdateMessageScriptOutput> {
+		return this.invoke<UpdateMessageScriptOutput>("updateMessage", args)
+	}
+}