@prompt-ot/mcp 0.1.0

package/dist/server.js

@@ -0,0 +1,42 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { registerPromptTools } from './tools/prompts.js';
+import { registerBlockTools } from './tools/blocks.js';
+import { registerVariableTools } from './tools/variables.js';
+import { registerVersionTools } from './tools/versions.js';
+import { registerTestCaseTools } from './tools/test-cases.js';
+import { registerPromptResources } from './resources/prompts.js';
+/**
+ * Build the MCP server with all tools and resources registered.
+ *
+ * Shared by both transport entry points (`stdio.ts` for local installs and
+ * `http.ts` for the hosted Streamable HTTP server). Both transports expose
+ * the same tool catalog so the LLM has identical capabilities regardless of
+ * how the user connects.
+ *
+ * Tool registration is delegated to per-area modules under `tools/` so each
+ * domain (prompts, blocks, variables, versions, test_cases) owns its own
+ * Zod schemas and handler logic.
+ */
+export function createMcpServer(opts) {
+    const server = new McpServer({
+        name: 'promptot',
+        version: '0.1.0',
+    });
+    // Tool modules — order doesn't matter functionally, but we register prompts
+    // first because the rest of the catalog operates on prompt subresources.
+    registerPromptTools(server, opts.client);
+    registerBlockTools(server, opts.client);
+    registerVariableTools(server, opts.client);
+    registerVersionTools(server, opts.client);
+    registerTestCaseTools(server, opts.client);
+    // Resources — URI-addressable read-only data exposed via the @ picker
+    // in clients like Claude Desktop.
+    registerPromptResources(server, opts.client);
+    // clientName is currently informational only — the PromptOTClient already
+    // forwards it as X-PromptOT-Client-Name on every request. Future tool
+    // modules might use it for client-specific behavior (e.g. different
+    // truncation defaults for ChatGPT vs Claude Desktop).
+    void opts.clientName;
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAOjE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,IAA4B;IAC1D,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,4EAA4E;IAC5E,yEAAyE;IACzE,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACzC,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3C,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAE3C,sEAAsE;IACtE,kCAAkC;IAClC,uBAAuB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAE7C,0EAA0E;IAC1E,sEAAsE;IACtE,oEAAoE;IACpE,sDAAsD;IACtD,KAAK,IAAI,CAAC,UAAU,CAAC;IAErB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/stdio.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+/**
+ * stdio entry point for @prompt-ot/mcp.
+ *
+ * Spawned by MCP clients (Claude Desktop, Cursor, Codex CLI, Windsurf, Zed)
+ * via `npx -y @prompt-ot/mcp`. Reads PROMPTOT_API_KEY from env and speaks
+ * JSON-RPC over stdin/stdout.
+ *
+ * stdout is reserved for the MCP protocol — all logging goes to stderr.
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { readEnv, requireApiKey } from './lib/env.js';
+import { PromptOTClient } from './client.js';
+import { createMcpServer } from './server.js';
+async function main() {
+    const env = readEnv();
+    requireApiKey(env);
+    const client = new PromptOTClient(env);
+    const server = createMcpServer({ client, clientName: env.clientName });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    if (env.debug) {
+        process.stderr.write(`[promptot-mcp] Ready (client=${env.clientName}, api=${env.apiUrl})\n`);
+    }
+}
+main().catch((err) => {
+    process.stderr.write(`[promptot-mcp] Fatal error: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=stdio.js.map

package/dist/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,KAAK,UAAU,IAAI;IACjB,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,aAAa,CAAC,GAAG,CAAC,CAAC;IAEnB,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;IAEvE,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,GAAG,CAAC,UAAU,SAAS,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC;IAC/F,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/blocks.js

@@ -0,0 +1,156 @@
+import { z } from 'zod';
+import { isPromptOTError } from '../lib/errors.js';
+import { jsonContent, textContent } from '../lib/format.js';
+/**
+ * MCP tool registrations for the /api/v1/blocks endpoints.
+ *
+ * Each tool maps 1:1 to a public-api endpoint and uses inline Zod schemas
+ * (the MCP SDK 1.29 expects a ZodRawShapeCompat — a record of Zod schemas,
+ * not a wrapped ZodObject).
+ *
+ * All errors from PromptOTClient are caught and surfaced to the LLM as
+ * `isError: true` content blocks with human-readable hints from PromptOTError.
+ */
+export function registerBlockTools(server, client) {
+    // ---------------------------------------------------------------------------
+    // list_blocks
+    // ---------------------------------------------------------------------------
+    server.registerTool('list_blocks', {
+        title: 'List blocks for a prompt',
+        description: 'List all blocks for a prompt in their current sort order. Returns each block\'s id, type, title, content, sort_order, enabled, locked, and is_required flags. Use create_block, update_block, or reorder_blocks to modify the prompt structure.',
+        inputSchema: {
+            prompt_id: z.string().uuid().describe('The UUID of the prompt whose blocks to list.'),
+        },
+    }, async (args) => {
+        try {
+            const data = await client.get('/api/v1/blocks', {
+                tool: 'list_blocks',
+                query: { prompt_id: args.prompt_id },
+            });
+            return jsonContent({ count: data.length, blocks: data });
+        }
+        catch (err) {
+            if (isPromptOTError(err))
+                return { content: err.toMcpContent(), isError: true };
+            throw err;
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // create_block
+    // ---------------------------------------------------------------------------
+    server.registerTool('create_block', {
+        title: 'Create a new block on a prompt',
+        description: 'Create a new block on an existing prompt. The block is appended to the end of the prompt by default; pass sort_order to insert at a specific position. Use the type field to pick one of the standard block types (role, context, instructions, guardrails, output_format) or "custom" for free-form sections. Returns the created block.',
+        inputSchema: {
+            prompt_id: z.string().uuid().describe('The UUID of the prompt to add the block to.'),
+            type: z
+                .enum(['role', 'context', 'instructions', 'guardrails', 'output_format', 'custom'])
+                .describe('Block type — determines styling and semantics in the editor.'),
+            title: z.string().min(1).max(200).describe('Display title for the block (shown as a heading when compiled).'),
+            content: z.string().optional().describe('Block content body in markdown. Defaults to empty.'),
+            sort_order: z.number().int().min(0).optional().describe('Position in the prompt (0-indexed). Defaults to appending at the end.'),
+            enabled: z.boolean().optional().describe('Whether the block is included in the compiled prompt. Defaults to true.'),
+            is_required: z.boolean().optional().describe('Mark the block as required so it cannot be deleted. Defaults to false.'),
+        },
+    }, async (args) => {
+        try {
+            const data = await client.post('/api/v1/blocks', args, { tool: 'create_block' });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Created block "${data.title}" (id: ${data.id})\n\n${JSON.stringify(data, null, 2)}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            if (isPromptOTError(err))
+                return { content: err.toMcpContent(), isError: true };
+            throw err;
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // update_block
+    // ---------------------------------------------------------------------------
+    server.registerTool('update_block', {
+        title: 'Update an existing block',
+        description: 'Update fields on an existing block. Only the provided fields are changed — omitted fields are left untouched. Locked blocks reject content edits. Returns the updated block.',
+        inputSchema: {
+            block_id: z.string().uuid().describe('The UUID of the block to update.'),
+            title: z.string().min(1).max(200).optional().describe('New display title for the block.'),
+            content: z.string().optional().describe('New markdown content for the block.'),
+            enabled: z.boolean().optional().describe('Enable or disable the block in the compiled output.'),
+            sort_order: z.number().int().min(0).optional().describe('New position of the block in the prompt (0-indexed).'),
+        },
+    }, async (args) => {
+        try {
+            const { block_id, ...rest } = args;
+            const patch = {};
+            for (const [key, value] of Object.entries(rest)) {
+                if (value !== undefined)
+                    patch[key] = value;
+            }
+            const data = await client.patch(`/api/v1/blocks/${block_id}`, patch, { tool: 'update_block' });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Updated block "${data.title}" (id: ${data.id})\n\n${JSON.stringify(data, null, 2)}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            if (isPromptOTError(err))
+                return { content: err.toMcpContent(), isError: true };
+            throw err;
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // delete_block
+    // ---------------------------------------------------------------------------
+    server.registerTool('delete_block', {
+        title: 'Delete a block',
+        description: 'Permanently delete a block from a prompt. Required blocks (such as the default "role" and "instructions" blocks) cannot be deleted — the API will return an error in that case. Always confirm with the user before calling this tool.',
+        inputSchema: {
+            block_id: z.string().uuid().describe('The UUID of the block to delete.'),
+        },
+    }, async (args) => {
+        try {
+            await client.delete(`/api/v1/blocks/${args.block_id}`, {
+                tool: 'delete_block',
+            });
+            return textContent(`Block ${args.block_id} deleted.`);
+        }
+        catch (err) {
+            if (isPromptOTError(err))
+                return { content: err.toMcpContent(), isError: true };
+            throw err;
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // reorder_blocks
+    // ---------------------------------------------------------------------------
+    server.registerTool('reorder_blocks', {
+        title: 'Reorder blocks within a prompt',
+        description: 'Reorder all blocks on a prompt by passing the block UUIDs in the desired order. Each block\'s sort_order is set to its index in the array. All block IDs must belong to the given prompt or the call is rejected.',
+        inputSchema: {
+            prompt_id: z.string().uuid().describe('The UUID of the prompt whose blocks to reorder.'),
+            block_ids: z
+                .array(z.string().uuid())
+                .describe('All block IDs in the desired order. Each block\'s sort_order will be set to its index.'),
+        },
+    }, async (args) => {
+        try {
+            await client.post('/api/v1/blocks/reorder', { prompt_id: args.prompt_id, block_ids: args.block_ids }, { tool: 'reorder_blocks' });
+            return textContent(`Reordered ${args.block_ids.length} block${args.block_ids.length === 1 ? '' : 's'} on prompt ${args.prompt_id}.`);
+        }
+        catch (err) {
+            if (isPromptOTError(err))
+                return { content: err.toMcpContent(), isError: true };
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=blocks.js.map

package/dist/tools/blocks.js.map

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

package/dist/tools/prompts.js

@@ -0,0 +1,201 @@
+import { z } from 'zod';
+import { isPromptOTError } from '../lib/errors.js';
+import { jsonContent, textContent, truncateText } from '../lib/format.js';
+/**
+ * MCP tool registrations for the /api/v1/prompts endpoints.
+ *
+ * Each tool maps 1:1 to a public-api endpoint and uses Zod schemas defined
+ * inline (not imported from @prompt-ot/shared) for two reasons:
+ *   1. The MCP SDK 1.29 needs ZodRawShapeCompat — a record of Zod schemas,
+ *      not a ZodObject — and exposing `.shape` from a complex shared schema
+ *      can drift between versions.
+ *   2. Some MCP-specific options (truncate, max_tokens) don't exist on the
+ *      API schemas and need to be added at the MCP layer.
+ *
+ * All errors from PromptOTClient are caught and surfaced to the LLM as
+ * `isError: true` content blocks with human-readable hints from PromptOTError.
+ */
+export function registerPromptTools(server, client) {
+    // ---------------------------------------------------------------------------
+    // list_prompts
+    // ---------------------------------------------------------------------------
+    server.registerTool('list_prompts', {
+        title: 'List prompts',
+        description: 'List all prompts in the PromptOT project this MCP key is scoped to. Returns id, name, description, tags, and updated_at for each. Use get_prompt to fetch the full content of a specific one.',
+        inputSchema: {
+            limit: z.number().int().min(1).max(200).optional().describe('Maximum prompts to return (default 50).'),
+        },
+    }, async (args) => {
+        try {
+            const data = await client.get('/api/v1/prompts', { tool: 'list_prompts' });
+            const limited = args.limit ? data.slice(0, args.limit) : data.slice(0, 50);
+            return jsonContent({ count: limited.length, total: data.length, prompts: limited });
+        }
+        catch (err) {
+            if (isPromptOTError(err))
+                return { content: err.toMcpContent(), isError: true };
+            throw err;
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // get_prompt
+    // ---------------------------------------------------------------------------
+    server.registerTool('get_prompt', {
+        title: 'Get a prompt with blocks',
+        description: 'Fetch a single prompt with its blocks, variables, and currently compiled output. Use this when the user wants to read or edit the structure of an existing prompt.',
+        inputSchema: {
+            prompt_id: z.string().uuid().describe('The UUID of the prompt to fetch.'),
+            truncate: z.boolean().optional().describe('Truncate the compiled prompt text (default true).'),
+            max_tokens: z.number().int().min(100).max(20000).optional().describe('Maximum tokens to return when truncating (default 2000).'),
+        },
+    }, async (args) => {
+        try {
+            const data = await client.get(`/api/v1/prompts/${args.prompt_id}/full`, { tool: 'get_prompt' });
+            const truncated = truncateText(data.compiled_prompt, {
+                truncate: args.truncate,
+                maxTokens: args.max_tokens,
+                fullTextHint: `Use the resource promptot://prompts/${args.prompt_id}/markdown for the full text.`,
+            });
+            return jsonContent({
+                id: data.id,
+                name: data.name,
+                description: data.description,
+                tags: data.tags,
+                model_config: data.model_config,
+                blocks: data.blocks.map((b) => ({
+                    id: b.id,
+                    type: b.type,
+                    title: b.title,
+                    content: b.content,
+                    sort_order: b.sort_order,
+                    enabled: b.enabled,
+                    locked: b.locked,
+                })),
+                variables: data.variables,
+                compiled_prompt: truncated,
+                token_count: data.token_count,
+            });
+        }
+        catch (err) {
+            if (isPromptOTError(err))
+                return { content: err.toMcpContent(), isError: true };
+            throw err;
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // get_compiled_prompt
+    // ---------------------------------------------------------------------------
+    server.registerTool('get_compiled_prompt', {
+        title: 'Compile a prompt to markdown',
+        description: 'Get the compiled markdown output of a prompt with all blocks joined and {{variables}} substituted. Optionally pass variable_overrides to test what the prompt looks like with specific values. Returns the compiled text and token count.',
+        inputSchema: {
+            prompt_id: z.string().uuid().describe('The UUID of the prompt to compile.'),
+            truncate: z.boolean().optional().describe('Truncate the output (default true).'),
+            max_tokens: z.number().int().min(100).max(20000).optional().describe('Max tokens when truncating (default 2000).'),
+        },
+    }, async (args) => {
+        try {
+            const data = await client.get(`/api/v1/prompts/${args.prompt_id}/compile`, { tool: 'get_compiled_prompt' });
+            const truncated = truncateText(data.compiled_prompt, {
+                truncate: args.truncate,
+                maxTokens: args.max_tokens,
+                fullTextHint: `Use the resource promptot://prompts/${args.prompt_id}/markdown for the full text.`,
+            });
+            return jsonContent({
+                compiled_prompt: truncated,
+                token_count: data.token_count,
+                block_token_counts: data.block_token_counts,
+            });
+        }
+        catch (err) {
+            if (isPromptOTError(err))
+                return { content: err.toMcpContent(), isError: true };
+            throw err;
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // create_prompt
+    // ---------------------------------------------------------------------------
+    server.registerTool('create_prompt', {
+        title: 'Create a new prompt',
+        description: 'Create a new prompt in the PromptOT project. Automatically initializes with five default blocks: role, context, instructions, guardrails, output_format. Use update_block afterwards to fill in the content. Returns the created prompt with its blocks.',
+        inputSchema: {
+            name: z.string().min(1).max(200).describe('Display name for the prompt.'),
+            description: z.string().max(1000).optional().describe('Short description of what the prompt does.'),
+            tags: z.array(z.string().max(50)).max(10).optional().describe('Tags for grouping/filtering prompts.'),
+            folder_id: z.string().uuid().optional().describe('Optional folder to put the prompt in.'),
+        },
+    }, async (args) => {
+        try {
+            const data = await client.post('/api/v1/prompts', args, { tool: 'create_prompt' });
+            return linesAndJson(`Created prompt "${data.name}" (id: ${data.id})`, data);
+        }
+        catch (err) {
+            if (isPromptOTError(err))
+                return { content: err.toMcpContent(), isError: true };
+            throw err;
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // update_prompt
+    // ---------------------------------------------------------------------------
+    server.registerTool('update_prompt', {
+        title: 'Update prompt metadata',
+        description: 'Update a prompt\'s metadata fields (name, description, tags, folder_id). Does NOT modify blocks or variables — use update_block / upsert_variable for those. Returns the updated prompt.',
+        inputSchema: {
+            prompt_id: z.string().uuid().describe('The UUID of the prompt to update.'),
+            name: z.string().min(1).max(200).optional(),
+            description: z.string().max(1000).nullable().optional(),
+            tags: z.array(z.string().max(50)).max(10).optional(),
+            folder_id: z.string().uuid().nullable().optional(),
+        },
+    }, async (args) => {
+        try {
+            const { prompt_id, ...patch } = args;
+            const data = await client.patch(`/api/v1/prompts/${prompt_id}`, patch, { tool: 'update_prompt' });
+            return linesAndJson(`Updated prompt "${data.name}"`, data);
+        }
+        catch (err) {
+            if (isPromptOTError(err))
+                return { content: err.toMcpContent(), isError: true };
+            throw err;
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // delete_prompt
+    // ---------------------------------------------------------------------------
+    server.registerTool('delete_prompt', {
+        title: 'Delete a prompt permanently',
+        description: 'Permanently delete a prompt and all its blocks, variables, versions, and test cases. This action is IRREVERSIBLE. Requires the `prompts:delete` scope. Always confirm with the user before calling this tool.',
+        inputSchema: {
+            prompt_id: z.string().uuid().describe('The UUID of the prompt to delete.'),
+            confirm: z.literal(true).describe('Must be exactly true to confirm the deletion.'),
+        },
+    }, async (args) => {
+        try {
+            await client.delete(`/api/v1/prompts/${args.prompt_id}`, {
+                tool: 'delete_prompt',
+            });
+            return textContent(`Prompt ${args.prompt_id} deleted permanently.`);
+        }
+        catch (err) {
+            if (isPromptOTError(err))
+                return { content: err.toMcpContent(), isError: true };
+            throw err;
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// Local helpers
+// ---------------------------------------------------------------------------
+function linesAndJson(headline, data) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `${headline}\n\n${JSON.stringify(data, null, 2)}`,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=prompts.js.map

package/dist/tools/prompts.js.map

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

package/dist/tools/test-cases.js

@@ -0,0 +1,165 @@
+import { z } from 'zod';
+import { isPromptOTError } from '../lib/errors.js';
+import { jsonContent, textContent } from '../lib/format.js';
+/**
+ * MCP tool registrations for the /api/v1/test-cases endpoints.
+ *
+ * Test cases are reusable inputs (with optional variable overrides and
+ * evaluation criteria) that pair with a prompt and feed into the evaluations
+ * runner. The shapes here mirror the v1 router in apps/api/src/routes/public-api/test-cases.ts.
+ *
+ * Zod schemas are defined inline (rather than imported from @prompt-ot/shared)
+ * because the MCP SDK 1.29 takes a `ZodRawShapeCompat` (a flat record of Zod
+ * schemas) and exposing `.shape` from a complex shared schema can drift across
+ * versions.
+ */
+export function registerTestCaseTools(server, client) {
+    // Reusable evaluation criteria schema. The four `type` values match the
+    // database constraint and the JWT-gated route in routes/test-cases.ts.
+    const evaluationCriteriaSchema = z
+        .array(z.object({
+        type: z
+            .enum(['contains', 'not_contains', 'regex_match', 'similarity_score'])
+            .describe('Criteria type. similarity_score requires a threshold between 0 and 1.'),
+        value: z.string().describe('The substring, regex, or reference text to evaluate against.'),
+        threshold: z
+            .number()
+            .min(0)
+            .max(1)
+            .optional()
+            .describe('Threshold between 0 and 1, used for similarity_score criteria.'),
+    }))
+        .optional()
+        .describe('Optional list of evaluation criteria the test case is scored against.');
+    // ---------------------------------------------------------------------------
+    // list_test_cases
+    // ---------------------------------------------------------------------------
+    server.registerTool('list_test_cases', {
+        title: 'List test cases for a prompt',
+        description: 'List all test cases attached to a prompt, ordered newest first. Each entry includes id, name, input_text, variable_overrides, expected_output, and evaluation_criteria. Use these as fixtures for the evaluations runner.',
+        inputSchema: {
+            prompt_id: z.string().uuid().describe('The UUID of the prompt to list test cases for.'),
+        },
+    }, async (args) => {
+        try {
+            const data = await client.get('/api/v1/test-cases', {
+                tool: 'list_test_cases',
+                query: { prompt_id: args.prompt_id },
+            });
+            return jsonContent({ count: data.length, test_cases: data });
+        }
+        catch (err) {
+            if (isPromptOTError(err))
+                return { content: err.toMcpContent(), isError: true };
+            throw err;
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // create_test_case
+    // ---------------------------------------------------------------------------
+    server.registerTool('create_test_case', {
+        title: 'Create a test case',
+        description: 'Create a new test case for a prompt. Provide an input_text fixture and optional variable_overrides, expected_output, and evaluation_criteria. The evaluations runner will use these to score the prompt against the input.',
+        inputSchema: {
+            prompt_id: z.string().uuid().describe('The UUID of the prompt to attach the test case to.'),
+            name: z.string().min(1).max(200).describe('Display name for the test case.'),
+            input_text: z.string().describe('The input fixture passed to the compiled prompt at run time.'),
+            variable_overrides: z
+                .record(z.string())
+                .optional()
+                .describe('Optional map of variable key -> value overrides for this test case.'),
+            expected_output: z
+                .string()
+                .optional()
+                .describe('Optional reference output used for similarity_score / human review.'),
+            evaluation_criteria: evaluationCriteriaSchema,
+        },
+    }, async (args) => {
+        try {
+            const data = await client.post('/api/v1/test-cases', args, { tool: 'create_test_case' });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Created test case "${data.name}" (id: ${data.id})\n\n${JSON.stringify(data, null, 2)}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            if (isPromptOTError(err))
+                return { content: err.toMcpContent(), isError: true };
+            throw err;
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // update_test_case
+    // ---------------------------------------------------------------------------
+    server.registerTool('update_test_case', {
+        title: 'Update a test case',
+        description: 'Update one or more fields on an existing test case. Only the provided fields are changed; omitted fields are left untouched. The test_case_id cannot be moved between prompts.',
+        inputSchema: {
+            test_case_id: z.string().uuid().describe('The UUID of the test case to update.'),
+            name: z.string().min(1).max(200).optional().describe('New display name.'),
+            input_text: z.string().optional().describe('New input fixture.'),
+            variable_overrides: z
+                .record(z.string())
+                .optional()
+                .describe('New map of variable overrides (replaces the existing map).'),
+            expected_output: z
+                .string()
+                .nullable()
+                .optional()
+                .describe('New expected output reference text. Pass null to clear.'),
+            evaluation_criteria: evaluationCriteriaSchema,
+        },
+    }, async (args) => {
+        try {
+            const { test_case_id, ...rest } = args;
+            // Strip undefined fields so the PATCH only touches what was sent.
+            const patch = {};
+            for (const [key, value] of Object.entries(rest)) {
+                if (value !== undefined) {
+                    patch[key] = value;
+                }
+            }
+            const data = await client.patch(`/api/v1/test-cases/${test_case_id}`, patch, { tool: 'update_test_case' });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Updated test case "${data.name}"\n\n${JSON.stringify(data, null, 2)}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            if (isPromptOTError(err))
+                return { content: err.toMcpContent(), isError: true };
+            throw err;
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // delete_test_case
+    // ---------------------------------------------------------------------------
+    server.registerTool('delete_test_case', {
+        title: 'Delete a test case permanently',
+        description: 'Permanently delete a test case. This action is IRREVERSIBLE. Always confirm with the user before calling this tool.',
+        inputSchema: {
+            test_case_id: z.string().uuid().describe('The UUID of the test case to delete.'),
+        },
+    }, async (args) => {
+        try {
+            await client.delete(`/api/v1/test-cases/${args.test_case_id}`, {
+                tool: 'delete_test_case',
+            });
+            return textContent(`Test case ${args.test_case_id} deleted permanently.`);
+        }
+        catch (err) {
+            if (isPromptOTError(err))
+                return { content: err.toMcpContent(), isError: true };
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=test-cases.js.map

package/dist/tools/test-cases.js.map

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