trigger.dev/dist/esm/mcp/tools/prompts.js

A Command-Line Interface for Trigger.dev projects

import { z } from "zod";
import { toolsMetadata } from "../config.js";
import { CommonProjectsInput } from "../schemas.js";
import { respondWithError, toolHandler } from "../utils.js";
// ---------------------------------------------------------------------------
// Input schemas
// ---------------------------------------------------------------------------
const ListPromptsInput = CommonProjectsInput;
const PromptSlugInput = CommonProjectsInput.extend({
    slug: z.string().describe("The prompt slug"),
});
const PromoteInput = CommonProjectsInput.extend({
    slug: z.string().describe("The prompt slug"),
    version: z.coerce.number().int().positive().describe("The version number to promote to current"),
});
const CreateOverrideInput = CommonProjectsInput.extend({
    slug: z.string().describe("The prompt slug"),
    textContent: z.string().describe("The full text content for the override"),
    model: z.string().optional().describe("Optional model override"),
    commitMessage: z.string().optional().describe("Optional commit message describing the change"),
});
const UpdateOverrideInput = CommonProjectsInput.extend({
    slug: z.string().describe("The prompt slug"),
    textContent: z.string().optional().describe("Updated text content"),
    model: z.string().optional().describe("Updated model"),
    commitMessage: z.string().optional().describe("Commit message describing the change"),
});
const RemoveOverrideInput = PromptSlugInput;
const ReactivateOverrideInput = CommonProjectsInput.extend({
    slug: z.string().describe("The prompt slug"),
    version: z.coerce
        .number()
        .int()
        .positive()
        .describe("The dashboard-sourced version number to reactivate as override"),
});
// ---------------------------------------------------------------------------
// Read tools
// ---------------------------------------------------------------------------
export const listPromptsTool = {
    name: toolsMetadata.list_prompts.name,
    title: toolsMetadata.list_prompts.title,
    description: toolsMetadata.list_prompts.description,
    inputSchema: ListPromptsInput.shape,
    handler: toolHandler(ListPromptsInput.shape, async (input, { ctx }) => {
        if (ctx.options.devOnly && input.environment !== "dev") {
            return respondWithError(`This MCP server is only available for the dev environment. You tried to access the ${input.environment} environment.`);
        }
        const projectRef = await ctx.getProjectRef({
            projectRef: input.projectRef,
            cwd: input.configPath,
        });
        const apiClient = await ctx.getApiClient({
            projectRef,
            environment: input.environment,
            scopes: ["read:prompts"],
            branch: input.branch,
        });
        const result = await apiClient.listPrompts();
        if (result.data.length === 0) {
            return { content: [{ type: "text", text: "No prompts found." }] };
        }
        const lines = ["## Prompts\n"];
        for (const p of result.data) {
            const status = p.hasOverride ? " (override active)" : "";
            const version = p.currentVersion != null ? `v${p.currentVersion}` : "no current";
            lines.push(`- **${p.slug}** — ${version}${status}`);
            if (p.description)
                lines.push(`  ${p.description}`);
            if (p.defaultModel)
                lines.push(`  Model: ${p.defaultModel}`);
        }
        return { content: [{ type: "text", text: lines.join("\n") }] };
    }),
};
export const getPromptVersionsTool = {
    name: toolsMetadata.get_prompt_versions.name,
    title: toolsMetadata.get_prompt_versions.title,
    description: toolsMetadata.get_prompt_versions.description,
    inputSchema: PromptSlugInput.shape,
    handler: toolHandler(PromptSlugInput.shape, async (input, { ctx }) => {
        if (ctx.options.devOnly && input.environment !== "dev") {
            return respondWithError(`This MCP server is only available for the dev environment. You tried to access the ${input.environment} environment.`);
        }
        const projectRef = await ctx.getProjectRef({
            projectRef: input.projectRef,
            cwd: input.configPath,
        });
        const apiClient = await ctx.getApiClient({
            projectRef,
            environment: input.environment,
            scopes: ["read:prompts"],
            branch: input.branch,
        });
        const result = await apiClient.listPromptVersions(input.slug);
        if (result.data.length === 0) {
            return { content: [{ type: "text", text: "No versions found." }] };
        }
        const lines = [`## Versions for "${input.slug}"\n`];
        for (const v of result.data) {
            const labels = v.labels.length > 0 ? ` [${v.labels.join(", ")}]` : "";
            const model = v.model ? ` · ${v.model}` : "";
            const msg = v.commitMessage ? ` — "${v.commitMessage}"` : "";
            lines.push(`- **v${v.version}**${labels} (${v.source})${model}${msg}`);
            if (v.textContent) {
                const preview = v.textContent.length > 120 ? v.textContent.slice(0, 120) + "..." : v.textContent;
                lines.push(`  Content: ${preview}`);
            }
        }
        return { content: [{ type: "text", text: lines.join("\n") }] };
    }),
};
// ---------------------------------------------------------------------------
// Write tools
// ---------------------------------------------------------------------------
export const promotePromptVersionTool = {
    name: toolsMetadata.promote_prompt_version.name,
    title: toolsMetadata.promote_prompt_version.title,
    description: toolsMetadata.promote_prompt_version.description,
    inputSchema: PromoteInput.shape,
    handler: toolHandler(PromoteInput.shape, async (input, { ctx }) => {
        if (ctx.options.devOnly && input.environment !== "dev") {
            return respondWithError(`This MCP server is only available for the dev environment. You tried to access the ${input.environment} environment.`);
        }
        const projectRef = await ctx.getProjectRef({
            projectRef: input.projectRef,
            cwd: input.configPath,
        });
        const apiClient = await ctx.getApiClient({
            projectRef,
            environment: input.environment,
            scopes: ["admin"],
            branch: input.branch,
        });
        await apiClient.promotePromptVersion(input.slug, { version: input.version });
        return {
            content: [
                {
                    type: "text",
                    text: `Promoted "${input.slug}" v${input.version} to current.`,
                },
            ],
        };
    }),
};
export const createPromptOverrideTool = {
    name: toolsMetadata.create_prompt_override.name,
    title: toolsMetadata.create_prompt_override.title,
    description: toolsMetadata.create_prompt_override.description,
    inputSchema: CreateOverrideInput.shape,
    handler: toolHandler(CreateOverrideInput.shape, async (input, { ctx }) => {
        if (ctx.options.devOnly && input.environment !== "dev") {
            return respondWithError(`This MCP server is only available for the dev environment. You tried to access the ${input.environment} environment.`);
        }
        const projectRef = await ctx.getProjectRef({
            projectRef: input.projectRef,
            cwd: input.configPath,
        });
        const apiClient = await ctx.getApiClient({
            projectRef,
            environment: input.environment,
            scopes: ["admin"],
            branch: input.branch,
        });
        const result = await apiClient.createPromptOverride(input.slug, {
            textContent: input.textContent,
            model: input.model,
            commitMessage: input.commitMessage,
            source: "mcp",
        });
        return {
            content: [
                {
                    type: "text",
                    text: `Created override for "${input.slug}" as v${result.version}.`,
                },
            ],
        };
    }),
};
export const updatePromptOverrideTool = {
    name: toolsMetadata.update_prompt_override.name,
    title: toolsMetadata.update_prompt_override.title,
    description: toolsMetadata.update_prompt_override.description,
    inputSchema: UpdateOverrideInput.shape,
    handler: toolHandler(UpdateOverrideInput.shape, async (input, { ctx }) => {
        if (ctx.options.devOnly && input.environment !== "dev") {
            return respondWithError(`This MCP server is only available for the dev environment. You tried to access the ${input.environment} environment.`);
        }
        const projectRef = await ctx.getProjectRef({
            projectRef: input.projectRef,
            cwd: input.configPath,
        });
        const apiClient = await ctx.getApiClient({
            projectRef,
            environment: input.environment,
            scopes: ["admin"],
            branch: input.branch,
        });
        await apiClient.updatePromptOverride(input.slug, {
            textContent: input.textContent,
            model: input.model,
            commitMessage: input.commitMessage,
        });
        return {
            content: [{ type: "text", text: `Updated override for "${input.slug}".` }],
        };
    }),
};
export const removePromptOverrideTool = {
    name: toolsMetadata.remove_prompt_override.name,
    title: toolsMetadata.remove_prompt_override.title,
    description: toolsMetadata.remove_prompt_override.description,
    inputSchema: RemoveOverrideInput.shape,
    handler: toolHandler(RemoveOverrideInput.shape, async (input, { ctx }) => {
        if (ctx.options.devOnly && input.environment !== "dev") {
            return respondWithError(`This MCP server is only available for the dev environment. You tried to access the ${input.environment} environment.`);
        }
        const projectRef = await ctx.getProjectRef({
            projectRef: input.projectRef,
            cwd: input.configPath,
        });
        const apiClient = await ctx.getApiClient({
            projectRef,
            environment: input.environment,
            scopes: ["admin"],
            branch: input.branch,
        });
        await apiClient.removePromptOverride(input.slug);
        return {
            content: [{ type: "text", text: `Removed override for "${input.slug}".` }],
        };
    }),
};
export const reactivatePromptOverrideTool = {
    name: toolsMetadata.reactivate_prompt_override.name,
    title: toolsMetadata.reactivate_prompt_override.title,
    description: toolsMetadata.reactivate_prompt_override.description,
    inputSchema: ReactivateOverrideInput.shape,
    handler: toolHandler(ReactivateOverrideInput.shape, async (input, { ctx }) => {
        if (ctx.options.devOnly && input.environment !== "dev") {
            return respondWithError(`This MCP server is only available for the dev environment. You tried to access the ${input.environment} environment.`);
        }
        const projectRef = await ctx.getProjectRef({
            projectRef: input.projectRef,
            cwd: input.configPath,
        });
        const apiClient = await ctx.getApiClient({
            projectRef,
            environment: input.environment,
            scopes: ["admin"],
            branch: input.branch,
        });
        await apiClient.reactivatePromptOverride(input.slug, { version: input.version });
        return {
            content: [
                {
                    type: "text",
                    text: `Reactivated v${input.version} as override for "${input.slug}".`,
                },
            ],
        };
    }),
};
//# sourceMappingURL=prompts.js.map