@promptlayer/mcp-server 1.0.0

package/.claude/settings.local.json

@@ -0,0 +1,16 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm run build:*)",
+      "Bash(npm install:*)",
+      "Bash(npm run sync:check:*)",
+      "WebSearch",
+      "WebFetch(domain:blog.modelcontextprotocol.io)",
+      "Bash(npx tsx:*)",
+      "WebFetch(domain:docs.promptlayer.com)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push:*)"
+    ]
+  }
+}

package/.env.example

@@ -0,0 +1,3 @@
+# PromptLayer API Key
+# Get your API key from https://promptlayer.com
+PROMPTLAYER_API_KEY=pl_your_api_key_here

package/CLAUDE.md

@@ -0,0 +1,39 @@
+# CLAUDE.md
+
+Project conventions and decisions for the PromptLayer MCP server.
+
+## Architecture
+
+- `src/types.ts` -- Zod input schemas + TOOL_DEFINITIONS for all tools
+- `src/handlers.ts` -- Registers all tools with the MCP server (single file, data-driven)
+- `src/client.ts` -- HTTP client with `get`/`post`/`patch`/`del` helpers
+- `src/utils.ts` -- Query params, error handling, shared `createToolHandler` factory
+- `src/index.ts` -- Entry point
+
+## Response types: don't add them
+
+Client methods return `Promise<unknown>`. Do not add typed response interfaces.
+
+The handler `JSON.stringify`s whatever the API returns and passes it to the LLM as text. Nothing inspects the response shape. Typed responses would be unvalidated guesses that drift silently when the API changes -- TypeScript can't catch runtime shape mismatches.
+
+This matches every major MCP server (GitHub, Stripe, official reference servers). The pattern is: type the inputs (Zod schemas sent to the LLM as tool definitions), stringify the outputs.
+
+## Input schemas are the source of truth
+
+Every tool's input schema is a Zod object in `src/types.ts`, verified against the PromptLayer OpenAPI spec. Run `npm run sync:check` to detect drift. The check must exit 0.
+
+Known exceptions to the OpenAPI diff are declared in `scripts/diff-endpoints.ts` with inline comments explaining each one. If you add a new exception, also add a `// NOTE:` comment on the affected schema in `src/types.ts`.
+
+## Adding a new endpoint
+
+1. Add Zod schema + entry in `TOOL_DEFINITIONS` in `src/types.ts`
+2. Add client method in `src/client.ts`
+3. Register the tool in `src/handlers.ts`
+4. Add mapping in `scripts/extract-mcp-tools.ts` (`TOOL_TO_ENDPOINT`)
+5. Run `npm run sync:check` -- must exit 0
+
+## Commands
+
+- `npm run build` -- Compile TypeScript
+- `npm run dev` -- Run with tsx
+- `npm run sync:check` -- Verify schemas match OpenAPI spec (exit 0 = pass)

package/README.md

@@ -0,0 +1,160 @@
+# PromptLayer MCP Server
+
+MCP server that wraps the [PromptLayer REST API](https://docs.promptlayer.com/reference/rest-api-reference), giving any MCP-compatible client access to all 33 PromptLayer tools.
+
+## Setup
+
+```bash
+npm install
+```
+
+Set your API key:
+
+```bash
+export PROMPTLAYER_API_KEY=pl_your_key_here
+```
+
+Or create a `.env` file (see `.env.example`).
+
+## Usage
+
+### With Claude Desktop
+
+Add to your Claude Desktop config (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "promptlayer": {
+      "command": "npx",
+      "args": ["-y", "@promptlayer/mcp-server"],
+      "env": {
+        "PROMPTLAYER_API_KEY": "pl_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### With Cursor
+
+Add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "promptlayer": {
+      "command": "npx",
+      "args": ["-y", "@promptlayer/mcp-server"],
+      "env": {
+        "PROMPTLAYER_API_KEY": "pl_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### From source
+
+```bash
+npm run build
+node build/index.js
+```
+
+## Tools
+
+### Prompt Templates
+
+| Tool | Description |
+|---|---|
+| `get-prompt-template` | Get a template by name/ID with optional version or release label. Returns provider-formatted `llm_kwargs`. |
+| `get-prompt-template-raw` | Get raw template data without filling variables. For sync, caching, inspection. |
+| `list-prompt-templates` | List templates with pagination. Filter by name, label, status. |
+| `publish-prompt-template` | Create a new version of a template with content, metadata, and release labels. |
+| `list-prompt-template-labels` | List release labels on a template. |
+| `create-prompt-label` | Attach a release label to a template version. |
+| `move-prompt-label` | Move a label to a different version. |
+| `delete-prompt-label` | Delete a label. |
+| `get-snippet-usage` | Find all templates referencing a snippet. |
+
+### Tracking
+
+| Tool | Description |
+|---|---|
+| `log-request` | Log an LLM request/response pair. Input/output in Prompt Blueprint format. |
+| `track-prompt` | Link a logged request to a prompt template. |
+| `track-score` | Score a logged request (0-100). Supports named scores. |
+| `track-metadata` | Attach metadata to a logged request. |
+| `track-group` | Associate a request with a group. |
+| `create-spans-bulk` | Create OpenTelemetry spans in bulk for tracing. |
+
+### Datasets
+
+| Tool | Description |
+|---|---|
+| `list-datasets` | List datasets with filtering. |
+| `create-dataset-group` | Create a dataset group (container for versions). |
+| `create-dataset-version-from-file` | Create a version from base64 CSV/JSON. |
+| `create-dataset-version-from-filter-params` | Create a version from request log history. |
+
+### Evaluations
+
+| Tool | Description |
+|---|---|
+| `list-evaluations` | List evaluation pipelines. |
+| `create-report` | Create an evaluation pipeline on a dataset. |
+| `run-report` | Execute a pipeline. |
+| `get-report` | Get pipeline details. |
+| `get-report-score` | Get the computed score. |
+| `add-report-column` | Add an evaluation step (one per request). |
+| `update-report-score-card` | Configure custom scoring logic. |
+| `delete-reports-by-name` | Archive pipelines by name. |
+
+### Agents
+
+| Tool | Description |
+|---|---|
+| `list-workflows` | List all agents. |
+| `create-workflow` | Create an agent or new version. |
+| `patch-workflow` | Partially update an agent. |
+| `run-workflow` | Execute an agent by name. |
+| `get-workflow-version-execution-results` | Poll for execution results. |
+
+### Other
+
+| Tool | Description |
+|---|---|
+| `create-folder` | Create a folder for organizing resources. |
+
+## Keeping in Sync
+
+Schemas are verified against the [PromptLayer OpenAPI spec](https://github.com/magnivorg/prompt-layer-docs/blob/master/openapi.json). Run:
+
+```bash
+npm run sync:check
+```
+
+This fetches the spec, extracts our tool schemas, and diffs them structurally. Exit 0 = in sync. See [TESTING.md](TESTING.md) for details.
+
+## Development
+
+```bash
+npm run dev       # Run with tsx (hot reload)
+npm run build     # Compile TypeScript
+npm run watch     # Watch mode
+```
+
+### Project Structure
+
+```
+src/
+  index.ts      # Entry point, starts MCP server
+  types.ts      # Zod schemas + TOOL_DEFINITIONS for all 33 tools
+  client.ts     # HTTP client for PromptLayer API
+  handlers.ts   # Registers all tools with the MCP server
+  utils.ts      # Shared utilities (query params, error handling, handler factory)
+scripts/
+  fetch-openapi-endpoints.ts   # Downloads + extracts OpenAPI spec
+  extract-mcp-tools.ts         # Extracts MCP tool schemas for comparison
+  diff-endpoints.ts            # Structural diff with known exceptions
+```

package/TESTING.md

@@ -0,0 +1,78 @@
+# Keeping the MCP in Sync with PromptLayer REST API
+
+## Quick Start
+
+```bash
+npm run sync:check
+```
+
+Exit code 0 = in sync (pass). Exit code 1 = new issues found (fail).
+
+Known exceptions are declared in `scripts/diff-endpoints.ts` and don't cause failures.
+
+## How It Works
+
+Three scripts, no LLM needed. The source of truth is the [OpenAPI spec](https://github.com/magnivorg/prompt-layer-docs/blob/master/openapi.json).
+
+### Step 1: Fetch OpenAPI endpoints
+
+```bash
+npm run sync:fetch
+```
+
+Downloads the spec, extracts every endpoint into `scripts/openapi-endpoints.json` with method, path, path/query params, and body fields.
+
+### Step 2: Extract MCP tool definitions
+
+```bash
+npm run sync:extract
+```
+
+Imports `TOOL_DEFINITIONS` from `src/types.ts`, converts Zod schemas to JSON Schema, writes `scripts/mcp-tools.json`. The tool-to-endpoint mapping is in `scripts/extract-mcp-tools.ts` (`TOOL_TO_ENDPOINT`).
+
+### Step 3: Diff
+
+```bash
+npm run sync:diff
+```
+
+Structurally compares the two JSON files:
+
+| Category | Meaning |
+|---|---|
+| **MISSING IN MCP** | OpenAPI has an endpoint we don't cover |
+| **EXTRA IN MCP** | We have a tool not in the OpenAPI spec |
+| **MISSING FIELD** | OpenAPI has a field our schema is missing |
+| **EXTRA FIELD** | Our schema has a field not in OpenAPI |
+| **TYPE MISMATCH** | Same field, different type |
+| **REQUIRED MISMATCH** | Same field, different required/optional |
+
+## Known Exceptions
+
+Some issues are expected and won't cause the script to fail. They're declared in the `KNOWN_EXCEPTIONS` array in `scripts/diff-endpoints.ts` with inline comments explaining each one.
+
+There are currently 31 known exceptions. Most exist because the OpenAPI spec lags behind the actual backend — we add fields the backend accepts even if they aren't in the spec yet. Each exception has an inline comment in `scripts/diff-endpoints.ts` explaining why.
+
+When adding a new exception: add the exact issue string to `KNOWN_EXCEPTIONS` in `scripts/diff-endpoints.ts` with a comment explaining why. Also add a `// NOTE:` comment on the affected code in `src/types.ts`.
+
+## Adding a New Endpoint
+
+1. `npm run sync:check` -- see what's missing
+2. Add Zod schema + tool definition in `src/types.ts`
+3. Add client method in `src/client.ts`
+4. Register the tool in `src/handlers.ts`
+5. Add mapping in `scripts/extract-mcp-tools.ts` (`TOOL_TO_ENDPOINT`)
+6. `npm run sync:check` -- verify it passes
+
+## Verifying Against the Backend Source Code
+
+The OpenAPI spec can lag behind the actual backend. For a deeper field-by-field audit against the backend source, see `BACKEND_VERIFICATION.md` (gitignored, available internally).
+## Files
+
+| File | Purpose |
+|---|---|
+| `scripts/fetch-openapi-endpoints.ts` | Downloads + extracts OpenAPI endpoints |
+| `scripts/extract-mcp-tools.ts` | Extracts MCP tool schemas, contains `TOOL_TO_ENDPOINT` mapping |
+| `scripts/diff-endpoints.ts` | Structural diff, contains `KNOWN_EXCEPTIONS` |
+| `scripts/openapi-endpoints.json` | Generated (gitignored) |
+| `scripts/mcp-tools.json` | Generated (gitignored) |

package/build/client.d.ts

@@ -0,0 +1,49 @@
+import type { GetPromptTemplateParams, ListPromptTemplatesParams } from "./types.js";
+type Body = Record<string, unknown>;
+export declare class PromptLayerClient {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey: string, baseUrl?: string);
+    private request;
+    private get;
+    private post;
+    private patch;
+    private del;
+    private enc;
+    getPromptTemplate(name: string, params?: GetPromptTemplateParams): Promise<unknown>;
+    getPromptTemplateRaw(id: string, params?: Body): Promise<unknown>;
+    listPromptTemplates(params?: ListPromptTemplatesParams): Promise<unknown>;
+    publishPromptTemplate(body: Body): Promise<unknown>;
+    listPromptTemplateLabels(id: string): Promise<unknown>;
+    createPromptLabel(promptId: number, body: Body): Promise<unknown>;
+    movePromptLabel(labelId: number, body: Body): Promise<unknown>;
+    deletePromptLabel(labelId: number): Promise<unknown>;
+    getSnippetUsage(id: string, params?: Body): Promise<unknown>;
+    logRequest(body: Body): Promise<unknown>;
+    createSpansBulk(body: Body): Promise<unknown>;
+    listDatasets(params?: Body): Promise<unknown>;
+    createDatasetGroup(body: Body): Promise<unknown>;
+    createDatasetVersionFromFile(body: Body): Promise<unknown>;
+    createDatasetVersionFromFilterParams(body: Body): Promise<unknown>;
+    listEvaluations(params?: Body): Promise<unknown>;
+    createReport(body: Body): Promise<unknown>;
+    runReport(id: number, body: Body): Promise<unknown>;
+    getReport(id: number): Promise<unknown>;
+    getReportScore(id: number): Promise<unknown>;
+    updateReportScoreCard(id: number, body: Body): Promise<unknown>;
+    deleteReportsByName(name: string): Promise<unknown>;
+    listWorkflows(params?: Body): Promise<unknown>;
+    getWorkflow(idOrName: string): Promise<unknown>;
+    createWorkflow(body: Body): Promise<unknown>;
+    patchWorkflow(idOrName: string, body: Body): Promise<unknown>;
+    runWorkflow(name: string, body: Body): Promise<unknown>;
+    getWorkflowVersionExecutionResults(params: Body): Promise<unknown>;
+    createFolder(body: Body): Promise<unknown>;
+    editFolder(folderId: number, body: Body): Promise<unknown>;
+    getFolderEntities(params: Body): Promise<unknown>;
+    moveFolderEntities(body: Body): Promise<unknown>;
+    deleteFolderEntities(body: Body): Promise<unknown>;
+    resolveFolderId(params: Body): Promise<unknown>;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/build/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAGrF,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpC,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;gBADP,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,MAAsC;YAG3C,OAAO;IAarB,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,GAAG;IAKX,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,uBAAuB;IAGhE,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI;IAC9C,mBAAmB,CAAC,MAAM,CAAC,EAAE,yBAAyB;IACtD,qBAAqB,CAAC,IAAI,EAAE,IAAI;IAChC,wBAAwB,CAAC,EAAE,EAAE,MAAM;IACnC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI;IAC9C,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI;IAC3C,iBAAiB,CAAC,OAAO,EAAE,MAAM;IACjC,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI;IAGzC,UAAU,CAAC,IAAI,EAAE,IAAI;IACrB,eAAe,CAAC,IAAI,EAAE,IAAI;IAG1B,YAAY,CAAC,MAAM,CAAC,EAAE,IAAI;IAC1B,kBAAkB,CAAC,IAAI,EAAE,IAAI;IAC7B,4BAA4B,CAAC,IAAI,EAAE,IAAI;IACvC,oCAAoC,CAAC,IAAI,EAAE,IAAI;IAG/C,eAAe,CAAC,MAAM,CAAC,EAAE,IAAI;IAC7B,YAAY,CAAC,IAAI,EAAE,IAAI;IACvB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI;IAChC,SAAS,CAAC,EAAE,EAAE,MAAM;IACpB,cAAc,CAAC,EAAE,EAAE,MAAM;IACzB,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI;IAC5C,mBAAmB,CAAC,IAAI,EAAE,MAAM;IAGhC,aAAa,CAAC,MAAM,CAAC,EAAE,IAAI;IAC3B,WAAW,CAAC,QAAQ,EAAE,MAAM;IAC5B,cAAc,CAAC,IAAI,EAAE,IAAI;IACzB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI;IAC1C,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI;IACpC,kCAAkC,CAAC,MAAM,EAAE,IAAI;IAG/C,YAAY,CAAC,IAAI,EAAE,IAAI;IACvB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI;IACvC,iBAAiB,CAAC,MAAM,EAAE,IAAI;IAC9B,kBAAkB,CAAC,IAAI,EAAE,IAAI;IAC7B,oBAAoB,CAAC,IAAI,EAAE,IAAI;IAC/B,eAAe,CAAC,MAAM,EAAE,IAAI;CAC7B"}

package/build/client.js

@@ -0,0 +1,80 @@
+import { buildQueryParams, handleApiError } from "./utils.js";
+export class PromptLayerClient {
+    apiKey;
+    baseUrl;
+    constructor(apiKey, baseUrl = "https://api.promptlayer.com") {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl;
+    }
+    async request(endpoint, options = {}) {
+        const response = await fetch(`${this.baseUrl}${endpoint}`, {
+            ...options,
+            headers: {
+                "Content-Type": "application/json",
+                "X-API-KEY": this.apiKey,
+                ...options.headers,
+            },
+        });
+        if (!response.ok)
+            throw await handleApiError(response);
+        return (await response.json());
+    }
+    get(path, params) {
+        return this.request(`${path}${buildQueryParams(params)}`, { method: "GET" });
+    }
+    post(path, body) {
+        return this.request(path, { method: "POST", body: JSON.stringify(body) });
+    }
+    patch(path, body) {
+        return this.request(path, { method: "PATCH", body: JSON.stringify(body) });
+    }
+    del(path) {
+        return this.request(path, { method: "DELETE" });
+    }
+    enc(s) {
+        return encodeURIComponent(s);
+    }
+    // Prompt Templates
+    getPromptTemplate(name, params) {
+        return this.post(`/prompt-templates/${this.enc(name)}`, { api_key: this.apiKey, ...params });
+    }
+    getPromptTemplateRaw(id, params) { return this.get(`/prompt-templates/${this.enc(id)}`, params); }
+    listPromptTemplates(params) { return this.get("/prompt-templates", params); }
+    publishPromptTemplate(body) { return this.post("/rest/prompt-templates", body); }
+    listPromptTemplateLabels(id) { return this.get(`/prompt-templates/${this.enc(id)}/labels`); }
+    createPromptLabel(promptId, body) { return this.post(`/prompts/${promptId}/label`, body); }
+    movePromptLabel(labelId, body) { return this.patch(`/prompt-labels/${labelId}`, body); }
+    deletePromptLabel(labelId) { return this.del(`/prompt-labels/${labelId}`); }
+    getSnippetUsage(id, params) { return this.get(`/prompt-templates/${this.enc(id)}/snippet-usage`, params); }
+    // Tracking
+    logRequest(body) { return this.post("/log-request", body); }
+    createSpansBulk(body) { return this.post("/spans-bulk", body); }
+    // Datasets
+    listDatasets(params) { return this.get("/api/public/v2/datasets", params); }
+    createDatasetGroup(body) { return this.post("/api/public/v2/dataset-groups", body); }
+    createDatasetVersionFromFile(body) { return this.post("/api/public/v2/dataset-versions/from-file", body); }
+    createDatasetVersionFromFilterParams(body) { return this.post("/api/public/v2/dataset-versions/from-filter-params", body); }
+    // Evaluations
+    listEvaluations(params) { return this.get("/api/public/v2/evaluations", params); }
+    createReport(body) { return this.post("/reports", body); }
+    runReport(id, body) { return this.post(`/reports/${id}/run`, body); }
+    getReport(id) { return this.get(`/reports/${id}`); }
+    getReportScore(id) { return this.get(`/reports/${id}/score`); }
+    updateReportScoreCard(id, body) { return this.patch(`/reports/${id}/score-card`, body); }
+    deleteReportsByName(name) { return this.del(`/reports/name/${this.enc(name)}`); }
+    // Agents
+    listWorkflows(params) { return this.get("/workflows", params); }
+    getWorkflow(idOrName) { return this.get(`/workflows/${this.enc(idOrName)}`); }
+    createWorkflow(body) { return this.post("/rest/workflows", body); }
+    patchWorkflow(idOrName, body) { return this.patch(`/rest/workflows/${this.enc(idOrName)}`, body); }
+    runWorkflow(name, body) { return this.post(`/workflows/${this.enc(name)}/run`, body); }
+    getWorkflowVersionExecutionResults(params) { return this.get("/workflow-version-execution-results", params); }
+    // Folders
+    createFolder(body) { return this.post("/api/public/v2/folders", body); }
+    editFolder(folderId, body) { return this.patch(`/api/public/v2/folders/${folderId}`, body); }
+    getFolderEntities(params) { return this.get("/api/public/v2/folders/entities", params); }
+    moveFolderEntities(body) { return this.post("/api/public/v2/folders/entities", body); }
+    deleteFolderEntities(body) { return this.request("/api/public/v2/folders/entities", { method: "DELETE", body: JSON.stringify(body) }); }
+    resolveFolderId(params) { return this.get("/api/public/v2/folders/resolve-id", params); }
+}
+//# sourceMappingURL=client.js.map

package/build/client.js.map

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

package/build/handlers.d.ts

@@ -0,0 +1,2 @@
+export declare function registerAllTools(server: any): void;
+//# sourceMappingURL=handlers.d.ts.map

package/build/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../src/handlers.ts"],"names":[],"mappings":"AAQA,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,QA2G3C"}

package/build/handlers.js

@@ -0,0 +1,51 @@
+import { TOOL_DEFINITIONS } from "./types.js";
+import { createToolHandler } from "./utils.js";
+function body(args) { const { api_key: _, ...rest } = args; return rest; }
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function registerAllTools(server) {
+    const t = TOOL_DEFINITIONS;
+    function reg(def, call, msg) {
+        server.tool(def.name, def.description, def.inputSchema.shape, createToolHandler(call, msg));
+    }
+    // Prompt Templates
+    reg(t["get-prompt-template"], (c, a) => { const { api_key: _, prompt_name, ...p } = a; return c.getPromptTemplate(prompt_name, p); }, (r) => { const { prompt_name, version } = r; return `Retrieved "${prompt_name}" v${version}`; });
+    reg(t["get-prompt-template-raw"], (c, a) => { const { api_key: _, identifier, ...p } = a; return c.getPromptTemplateRaw(identifier, p); }, (r) => `Retrieved raw template "${r.prompt_name ?? ""}"`);
+    reg(t["list-prompt-templates"], (c, a) => c.listPromptTemplates(body(a)), (r) => { const { items, page, pages, total } = r; return `${items.length} template(s) (page ${page}/${pages}, total ${total})`; });
+    reg(t["publish-prompt-template"], (c, a) => c.publishPromptTemplate(body(a)), () => "Published");
+    reg(t["list-prompt-template-labels"], (c, a) => c.listPromptTemplateLabels(a.identifier), (r) => `${Array.isArray(r) ? r.length : 0} label(s)`);
+    reg(t["create-prompt-label"], (c, a) => { const { api_key: _, prompt_id, prompt_version_number, name } = a; return c.createPromptLabel(prompt_id, { prompt_version_number, name }); }, () => "Label created");
+    reg(t["move-prompt-label"], (c, a) => { const { api_key: _, prompt_label_id, prompt_version_number } = a; return c.movePromptLabel(prompt_label_id, { prompt_version_number }); }, () => "Label moved");
+    reg(t["delete-prompt-label"], (c, a) => c.deletePromptLabel(a.prompt_label_id), () => "Label deleted");
+    reg(t["get-snippet-usage"], (c, a) => { const { api_key: _, identifier, ...p } = a; return c.getSnippetUsage(identifier, p); }, (r) => `${Array.isArray(r) ? r.length : 0} prompt(s) using snippet`);
+    // Tracking
+    reg(t["log-request"], (c, a) => c.logRequest(body(a)), (r) => { const id = r.request_id; return id ? `Logged (ID: ${id})` : "Logged"; });
+    reg(t["create-spans-bulk"], (c, a) => c.createSpansBulk(body(a)), (r) => `Created ${r.spans?.length ?? 0} span(s)`);
+    // Datasets
+    reg(t["list-datasets"], (c, a) => c.listDatasets(body(a)), (r) => { const { datasets, total } = r; return `${datasets?.length ?? 0} dataset(s) (total: ${total ?? "?"})`; });
+    reg(t["create-dataset-group"], (c, a) => c.createDatasetGroup(body(a)), () => "Dataset group created");
+    reg(t["create-dataset-version-from-file"], (c, a) => c.createDatasetVersionFromFile(body(a)), () => "Dataset version from file initiated");
+    reg(t["create-dataset-version-from-filter-params"], (c, a) => c.createDatasetVersionFromFilterParams(body(a)), () => "Dataset version from history initiated");
+    // Evaluations
+    reg(t["list-evaluations"], (c, a) => c.listEvaluations(body(a)), (r) => { const { items, total } = r; return `${items?.length ?? 0} evaluation(s) (total: ${total ?? "?"})`; });
+    reg(t["create-report"], (c, a) => c.createReport(body(a)), (r) => { const id = r.report_id; return id ? `Pipeline created (ID: ${id})` : "Pipeline created"; });
+    reg(t["run-report"], (c, a) => { const { api_key: _, report_id, ...b } = a; return c.runReport(report_id, b); }, () => "Evaluation run started");
+    reg(t["get-report"], (c, a) => c.getReport(a.report_id), () => "Evaluation retrieved");
+    reg(t["get-report-score"], (c, a) => c.getReportScore(a.report_id), (r) => { const s = r.score; return s !== undefined ? `Score: ${s}` : "Score retrieved"; });
+    reg(t["update-report-score-card"], (c, a) => { const { api_key: _, report_id, ...b } = a; return c.updateReportScoreCard(report_id, b); }, () => "Score card updated");
+    reg(t["delete-reports-by-name"], (c, a) => c.deleteReportsByName(a.report_name), () => "Reports archived");
+    // Agents
+    reg(t["list-workflows"], (c, a) => c.listWorkflows(body(a)), () => "Agents listed");
+    reg(t["create-workflow"], (c, a) => c.createWorkflow(body(a)), () => "Agent created");
+    reg(t["patch-workflow"], (c, a) => { const { api_key: _, workflow_id_or_name, ...b } = a; return c.patchWorkflow(workflow_id_or_name, b); }, () => "Agent updated");
+    reg(t["run-workflow"], (c, a) => { const { api_key: _, workflow_name, ...b } = a; return c.runWorkflow(workflow_name, b); }, (r) => { const id = r.workflow_version_execution_id; return id ? `Agent run started (ID: ${id})` : "Agent run started"; });
+    reg(t["get-workflow-version-execution-results"], (c, a) => c.getWorkflowVersionExecutionResults(body(a)), () => "Execution results retrieved");
+    reg(t["get-workflow"], (c, a) => c.getWorkflow(a.workflow_id_or_name), (r) => { const w = r; return `Agent "${w.workflow?.name ?? ""}" retrieved`; });
+    // Folders
+    reg(t["create-folder"], (c, a) => c.createFolder(body(a)), () => "Folder created");
+    reg(t["edit-folder"], (c, a) => { const { api_key: _, folder_id, ...b } = a; return c.editFolder(folder_id, b); }, () => "Folder renamed");
+    reg(t["get-folder-entities"], (c, a) => c.getFolderEntities(body(a)), (r) => { const e = r.entities; return `${e?.length ?? 0} entity/entities`; });
+    reg(t["move-folder-entities"], (c, a) => c.moveFolderEntities(body(a)), (r) => { const c_ = r.moved_count; return `Moved ${c_ ?? 0} entity/entities`; });
+    reg(t["delete-folder-entities"], (c, a) => c.deleteFolderEntities(body(a)), (r) => { const c_ = r.moved_count; return `Deleted ${c_ ?? 0} entity/entities`; });
+    reg(t["resolve-folder-id"], (c, a) => c.resolveFolderId(body(a)), (r) => { const id = r.id; return id ? `Folder ID: ${id}` : "Folder not found"; });
+}
+//# sourceMappingURL=handlers.js.map

package/build/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../src/handlers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG/C,SAAS,IAAI,CAAC,IAAU,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;AAEhF,8DAA8D;AAC9D,MAAM,UAAU,gBAAgB,CAAC,MAAW;IAC1C,MAAM,CAAC,GAAG,gBAAgB,CAAC;IAE3B,SAAS,GAAG,CAAC,GAA+B,EAAE,IAA6C,EAAE,GAA4C;QACvI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,WAAW,CAAC,KAAK,EAAE,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED,mBAAmB;IACnB,GAAG,CAAC,CAAC,CAAC,qBAAqB,CAAC,EAC1B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,GAAG,CAAwE,CAAC,CAAC,OAAO,CAAC,CAAC,iBAAiB,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAC7K,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,CAA6C,CAAC,CAAC,OAAO,cAAc,WAAW,MAAM,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/I,GAAG,CAAC,CAAC,CAAC,yBAAyB,CAAC,EAC9B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,GAAG,CAAoD,CAAC,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAC1J,CAAC,CAAC,EAAE,EAAE,CAAC,2BAA4B,CAA8B,CAAC,WAAW,IAAI,EAAE,GAAG,CAAC,CAAC;IAE1F,GAAG,CAAC,CAAC,CAAC,uBAAuB,CAAC,EAC5B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAA8B,CAAC,EACrE,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAqE,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC,MAAM,sBAAsB,IAAI,IAAI,KAAK,WAAW,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzM,GAAG,CAAC,CAAC,CAAC,yBAAyB,CAAC,EAC9B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAC1C,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC;IAErB,GAAG,CAAC,CAAC,CAAC,6BAA6B,CAAC,EAClC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,wBAAwB,CAAE,CAA4B,CAAC,UAAU,CAAC,EAC9E,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAExD,GAAG,CAAC,CAAC,CAAC,qBAAqB,CAAC,EAC1B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,qBAAqB,EAAE,IAAI,EAAE,GAAG,CAAyF,CAAC,CAAC,OAAO,CAAC,CAAC,iBAAiB,CAAC,SAAS,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAC/O,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC;IAEzB,GAAG,CAAC,CAAC,CAAC,mBAAmB,CAAC,EACxB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,eAAe,EAAE,qBAAqB,EAAE,GAAG,CAAiF,CAAC,CAAC,OAAO,CAAC,CAAC,eAAe,CAAC,eAAe,EAAE,EAAE,qBAAqB,EAAE,CAAC,CAAC,CAAC,CAAC,EACrO,GAAG,EAAE,CAAC,aAAa,CAAC,CAAC;IAEvB,GAAG,CAAC,CAAC,CAAC,qBAAqB,CAAC,EAC1B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAE,CAAiC,CAAC,eAAe,CAAC,EACjF,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC;IAEzB,GAAG,CAAC,CAAC,CAAC,mBAAmB,CAAC,EACxB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,GAAG,CAAoD,CAAC,CAAC,OAAO,CAAC,CAAC,eAAe,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EACrJ,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC;IAEvE,WAAW;IACX,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EACnD,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,GAAI,CAA8B,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAClH,GAAG,CAAC,CAAC,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAC9D,CAAC,CAAC,EAAE,EAAE,CAAC,WAAY,CAA2B,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC;IAE/E,WAAW;IACX,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EACvD,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,CAA6C,CAAC,CAAC,OAAO,GAAG,QAAQ,EAAE,MAAM,IAAI,CAAC,uBAAuB,KAAK,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAChK,GAAG,CAAC,CAAC,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,uBAAuB,CAAC,CAAC;IACvG,GAAG,CAAC,CAAC,CAAC,kCAAkC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,4BAA4B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,qCAAqC,CAAC,CAAC;IAC3I,GAAG,CAAC,CAAC,CAAC,2CAA2C,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,oCAAoC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,wCAAwC,CAAC,CAAC;IAE/J,cAAc;IACd,GAAG,CAAC,CAAC,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAC7D,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAA0C,CAAC,CAAC,OAAO,GAAG,KAAK,EAAE,MAAM,IAAI,CAAC,0BAA0B,KAAK,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1J,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EACvD,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,GAAI,CAA4B,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IACnI,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,EACjB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,GAAG,CAAmD,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAC5I,GAAG,EAAE,CAAC,wBAAwB,CAAC,CAAC;IAClC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,EACjB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAE,CAA2B,CAAC,SAAS,CAAC,EAC7D,GAAG,EAAE,CAAC,sBAAsB,CAAC,CAAC;IAChC,GAAG,CAAC,CAAC,CAAC,kBAAkB,CAAC,EACvB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAE,CAA2B,CAAC,SAAS,CAAC,EAClE,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,GAAI,CAAwB,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;IACrH,GAAG,CAAC,CAAC,CAAC,0BAA0B,CAAC,EAC/B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,GAAG,CAAmD,CAAC,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EACxJ,GAAG,EAAE,CAAC,oBAAoB,CAAC,CAAC;IAC9B,GAAG,CAAC,CAAC,CAAC,wBAAwB,CAAC,EAC7B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAE,CAA6B,CAAC,WAAW,CAAC,EAC3E,GAAG,EAAE,CAAC,kBAAkB,CAAC,CAAC;IAE5B,SAAS;IACT,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC;IACpF,GAAG,CAAC,CAAC,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC;IACtF,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,EACrB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,mBAAmB,EAAE,GAAG,CAAC,EAAE,GAAG,CAA6D,CAAC,CAAC,OAAO,CAAC,CAAC,aAAa,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAC9K,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC;IACzB,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,EACnB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,GAAG,CAAuD,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAC1J,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,GAAI,CAAgD,CAAC,6BAA6B,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,0BAA0B,EAAE,GAAG,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7K,GAAG,CAAC,CAAC,CAAC,wCAAwC,CAAC,EAC7C,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,kCAAkC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EACvD,GAAG,EAAE,CAAC,6BAA6B,CAAC,CAAC;IACvC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,EACnB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAE,CAAqC,CAAC,mBAAmB,CAAC,EACnF,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,GAAG,CAAqC,CAAC,CAAC,OAAO,UAAU,CAAC,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAErH,UAAU;IACV,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,CAAC;IACnF,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,EAClB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,GAAG,CAAmD,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAC7I,GAAG,EAAE,CAAC,gBAAgB,CAAC,CAAC;IAC1B,GAAG,CAAC,CAAC,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAClE,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,GAAI,CAA8B,CAAC,QAAQ,CAAC,CAAC,OAAO,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9G,GAAG,CAAC,CAAC,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EACpE,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,GAAI,CAA8B,CAAC,WAAW,CAAC,CAAC,OAAO,SAAS,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IACjH,GAAG,CAAC,CAAC,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EACxE,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,GAAI,CAA8B,CAAC,WAAW,CAAC,CAAC,OAAO,WAAW,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IACnH,GAAG,CAAC,CAAC,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAC9D,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,GAAI,CAAqB,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3G,CAAC"}

package/build/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/build/index.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerAllTools } from "./handlers.js";
+const INSTRUCTIONS = `
+PromptLayer is a prompt management and observability platform. This MCP server lets you manage PromptLayer resources.
+
+## Key entities and naming
+
+- **Prompt template**: A versioned prompt in the registry. Each version has a prompt_template (the content) and metadata. Versions are immutable — publishing always creates a new version.
+- **Snippet**: A reusable prompt fragment referenced inside prompt templates with @@@snippet_name@@@ markers. Snippets are themselves prompt templates (with type "completion"). When a prompt is fetched, snippets are expanded inline by default.
+- **Release label**: A pointer (e.g. "prod", "staging") attached to a specific prompt version. Move labels between versions for deployment.
+- **Agent** (backend name: workflow): A multi-step pipeline of nodes. Each node has a type, configuration, and dependencies. Agents are versioned like prompts.
+- **Evaluation pipeline** (backend name: report): Runs evaluation columns against a dataset and produces scores. Columns can be LLM assertions, code execution, comparisons, etc.
+- **Dataset**: A versioned collection of test rows. Belongs to a dataset group. Versions can be created from CSV/JSON files or by filtering request log history.
+- **Folder**: Organizes prompts, agents, datasets, evaluations, and other entities into a hierarchy.
+
+## Working with prompts and snippets
+
+When editing a prompt that may contain snippets, always use get-prompt-template-raw with resolve_snippets=false. This preserves the raw @@@snippet_name@@@ references so they are not lost on re-publish. The response also includes a "snippets" array listing every snippet used.
+
+When publishing back, keep @@@snippet_name@@@ markers intact in the prompt_template content. Do not inline snippet text — this breaks the snippet reference and future snippet updates will no longer propagate.
+
+Use get-prompt-template (the POST variant) only when you need a fully rendered prompt ready to send to an LLM, with input_variables filled in and provider-specific formatting applied.
+
+## Working with evaluations
+
+The recommended way to create an evaluation pipeline is with LLM assertion columns — these use a language model to score each dataset row. For details on all available column types (LLM assertion, code execution, comparison, etc.), search the PromptLayer docs or see https://docs.promptlayer.com/features/evaluations/column-types.
+
+## Additional documentation
+
+For deeper questions about PromptLayer features, configuration, or API details, the PromptLayer docs site has an MCP server you can use for search. See https://docs.promptlayer.com/mcp for setup.
+`.trim();
+const server = new McpServer({ name: "promptlayer-server", version: "1.0.0" }, { instructions: INSTRUCTIONS });
+registerAllTools(server);
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("PromptLayer MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BpB,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,OAAO,EAAE,EAChD,EAAE,YAAY,EAAE,YAAY,EAAE,CAC/B,CAAC;AACF,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAEzB,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;AAC3D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}