@promptlayer/mcp-server 1.10.0 → 1.13.0

package/gcp/src/index.ts

@@ -32,12 +32,15 @@ const TOOL_HANDLERS: Record<string, ToolHandler> = {
     c.deletePromptLabel(prompt_label_id as number),
   "get-snippet-usage": (c, { api_key: _, identifier, ...p }) =>
     c.getSnippetUsage(identifier as string, p),
+  "patch-prompt-template-version": (c, { api_key: _, identifier, ...b }) =>
+    c.patchPromptTemplateVersion(identifier as string, b),
 
   // Request Logs
   "search-request-logs": (c, a) => c.searchRequestLogs(body(a)),
   "get-request": (c, { request_id }) => c.getRequest(request_id as number),
   "get-trace": (c, { trace_id }) => c.getTrace(trace_id as string),
   "get-request-search-suggestions": (c, a) => c.getRequestSearchSuggestions(body(a)),
+  "get-request-analytics": (c, a) => c.getRequestAnalytics(body(a)),
 
   // Tracking
   "log-request": (c, a) => c.logRequest(body(a)),
@@ -52,6 +55,7 @@ const TOOL_HANDLERS: Record<string, ToolHandler> = {
     c.getDatasetRows(dataset_id as number, p),
   "create-draft-dataset-version": (c, a) => c.createDraftDatasetVersion(body(a)),
   "add-request-log-to-dataset": (c, a) => c.addRequestLogToDatasetVersion(body(a)),
+  "add-trace-to-dataset": (c, a) => c.addTraceToDatasetVersion(body(a)),
   "save-draft-dataset-version": (c, a) => c.saveDraftDatasetVersion(body(a)),
 
   // Evaluations
@@ -97,6 +101,12 @@ const TOOL_HANDLERS: Record<string, ToolHandler> = {
   "create-tool-registry": (c, a) => c.createToolRegistry(body(a)),
   "create-tool-version": (c, { api_key: _, identifier, ...b }) =>
     c.createToolVersion(identifier as string, b),
+  "test-execute-tool-registry": (c, { api_key: _, identifier, label, version, ...b }) => {
+    const query: Args = {};
+    if (label !== undefined) query.label = label;
+    if (version !== undefined) query.version = version;
+    return c.testExecuteToolRegistry(identifier as string, b, query);
+  },
 
   // Folders
   "create-folder": (c, a) => c.createFolder(body(a)),
@@ -106,6 +116,16 @@ const TOOL_HANDLERS: Record<string, ToolHandler> = {
   "move-folder-entities": (c, a) => c.moveFolderEntities(body(a)),
   "delete-folder-entities": (c, a) => c.deleteFolderEntities(body(a)),
   "resolve-folder-id": (c, a) => c.resolveFolderId(body(a)),
+
+  // Skill Collections
+  "list-skill-collections": (c) => c.listSkillCollections(),
+  "create-skill-collection": (c, a) => c.createSkillCollection(body(a)),
+  "get-skill-collection": (c, { api_key: _, identifier, ...p }) =>
+    c.getSkillCollection(identifier as string, p),
+  "update-skill-collection": (c, { api_key: _, identifier, ...b }) =>
+    c.updateSkillCollection(identifier as string, b),
+  "save-skill-collection-version": (c, { api_key: _, identifier, ...b }) =>
+    c.saveSkillCollectionVersion(identifier as string, b),
 };
 
 // ── Instructions ────────────────────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@promptlayer/mcp-server",
-  "version": "1.10.0",
+  "version": "1.13.0",
   "description": "Model Context Protocol server for PromptLayer",
   "type": "module",
   "main": "build/index.js",
@@ -34,11 +34,13 @@
     "node": ">=18.0.0"
   },
   "overrides": {
-    "hono": "^4.12.14",
+    "hono": "^4.12.18",
     "@hono/node-server": "^1.19.13",
     "express-rate-limit": "^8.2.2",
     "path-to-regexp": "^8.4.0",
-    "qs": "^6.14.2",
-    "ajv": "^8.18.0"
+    "qs": "^6.15.2",
+    "ajv": "^8.18.0",
+    "fast-uri": "^3.1.2",
+    "ip-address": "^10.1.1"
   }
 }

package/src/client.ts

@@ -73,6 +73,7 @@ export class PromptLayerClient {
   createDatasetVersionFromFilterParams(body: Body) { return this.post("/api/public/v2/dataset-versions/from-filter-params", body); }
   createDraftDatasetVersion(body: Body) { return this.post("/api/public/v2/dataset-versions/create-draft", body); }
   addRequestLogToDatasetVersion(body: Body) { return this.post("/api/public/v2/dataset-versions/add-request-log", body); }
+  addTraceToDatasetVersion(body: Body) { return this.post("/api/public/v2/dataset-versions/add-trace", body); }
   saveDraftDatasetVersion(body: Body) { return this.post("/api/public/v2/dataset-versions/save-draft", body); }
 
   // Evaluations
@@ -104,6 +105,7 @@ export class PromptLayerClient {
   getToolRegistry(identifier: string, params?: Body) { return this.get(`/api/public/v2/tool-registry/${this.enc(identifier)}`, params); }
   createToolRegistry(body: Body) { return this.post("/api/public/v2/tool-registry", body); }
   createToolVersion(identifier: string, body: Body) { return this.post(`/api/public/v2/tool-registry/${this.enc(identifier)}/versions`, body); }
+  testExecuteToolRegistry(identifier: string, body: Body, query?: Body) { return this.post(`/api/public/v2/tool-registry/${this.enc(identifier)}/test-execute${buildQueryParams(query)}`, body); }
 
   // Folders
   createFolder(body: Body) { return this.post("/api/public/v2/folders", body); }
@@ -112,4 +114,17 @@ export class PromptLayerClient {
   moveFolderEntities(body: Body) { return this.post("/api/public/v2/folders/entities", body); }
   deleteFolderEntities(body: Body) { return this.request("/api/public/v2/folders/entities", { method: "DELETE", body: JSON.stringify(body) }); }
   resolveFolderId(params: Body) { return this.get("/api/public/v2/folders/resolve-id", params); }
+
+  // Skill Collections
+  listSkillCollections() { return this.get("/api/public/v2/skill-collections"); }
+  createSkillCollection(body: Body) { return this.post("/api/public/v2/skill-collections", body); }
+  getSkillCollection(identifier: string, params?: Body) { return this.get(`/api/public/v2/skill-collections/${this.enc(identifier)}`, params); }
+  updateSkillCollection(identifier: string, body: Body) { return this.patch(`/api/public/v2/skill-collections/${this.enc(identifier)}`, body); }
+  saveSkillCollectionVersion(identifier: string, body: Body) { return this.post(`/api/public/v2/skill-collections/${this.enc(identifier)}/versions`, body); }
+
+  // Analytics
+  getRequestAnalytics(body: Body) { return this.post("/api/public/v2/requests/analytics", body); }
+
+  // Prompt template patch
+  patchPromptTemplateVersion(identifier: string, body: Body) { return this.patch(`/rest/prompt-templates/${this.enc(identifier)}`, body); }
 }

package/src/handlers.ts

@@ -80,6 +80,8 @@ export function registerAllTools(server: any) {
     (r) => { const { rows, total, page, pages } = r as { rows?: unknown[]; total?: number; page?: number; pages?: number }; return `${rows?.length ?? 0} row(s) (page ${page ?? 1}/${pages ?? 1}, total ${total ?? "?"})`; });
   reg(t["create-draft-dataset-version"], (c, a) => c.createDraftDatasetVersion(body(a)), () => "Draft dataset version created");
   reg(t["add-request-log-to-dataset"], (c, a) => c.addRequestLogToDatasetVersion(body(a)), () => "Request log added to draft dataset");
+  reg(t["add-trace-to-dataset"], (c, a) => c.addTraceToDatasetVersion(body(a)),
+    (r) => { const m = (r as { mode?: string }).mode; return m ? `Trace added to draft dataset (mode: ${m})` : "Trace added to draft dataset"; });
   reg(t["save-draft-dataset-version"], (c, a) => c.saveDraftDatasetVersion(body(a)), () => "Draft dataset save initiated");
 
   // Evaluations
@@ -150,6 +152,20 @@ export function registerAllTools(server: any) {
   reg(t["create-tool-version"],
     (c, a) => { const { api_key: _, identifier, ...b } = a as { identifier: string; api_key?: string } & Args; return c.createToolVersion(identifier, b); },
     (r) => { const v = (r as { version?: { number?: number } }).version; return v ? `Version ${v.number} created` : "Version created"; });
+  reg(t["test-execute-tool-registry"],
+    (c, a) => {
+      const { api_key: _, identifier, label, version, ...rest } = a as { identifier: string; api_key?: string; label?: string; version?: number } & Args;
+      const query: Record<string, unknown> = {};
+      if (label !== undefined) query.label = label;
+      if (version !== undefined) query.version = version;
+      return c.testExecuteToolRegistry(identifier, rest, query);
+    },
+    (r) => {
+      const res = (r as { result?: { status?: string; duration_ms?: number; error?: { message?: string } } }).result;
+      if (!res) return "Tool executed";
+      if (res.status === "error") return `Tool failed: ${res.error?.message ?? "unknown error"}`;
+      return `Tool executed (${res.duration_ms ?? 0} ms)`;
+    });
 
   // Folders
   reg(t["create-folder"], (c, a) => c.createFolder(body(a)), () => "Folder created");
@@ -164,4 +180,28 @@ export function registerAllTools(server: any) {
     (r) => { const c_ = (r as { moved_count?: number }).moved_count; return `Deleted ${c_ ?? 0} entity/entities`; });
   reg(t["resolve-folder-id"], (c, a) => c.resolveFolderId(body(a)),
     (r) => { const id = (r as { id?: number }).id; return id ? `Folder ID: ${id}` : "Folder not found"; });
+
+  // Skill Collections
+  reg(t["list-skill-collections"], (c) => c.listSkillCollections(),
+    (r) => { const cs = (r as { skill_collections?: unknown[] }).skill_collections; return `${cs?.length ?? 0} skill collection(s)`; });
+  reg(t["create-skill-collection"], (c, a) => c.createSkillCollection(body(a)),
+    (r) => { const s = (r as { skill_collection?: { name?: string; id?: string } }).skill_collection; return s ? `Skill collection "${s.name}" created (ID: ${s.id})` : "Skill collection created"; });
+  reg(t["get-skill-collection"],
+    (c, a) => { const { api_key: _, identifier, ...p } = a as { identifier: string; api_key?: string } & Args; return c.getSkillCollection(identifier, p); },
+    (r) => { const s = (r as { skill_collection?: { name?: string }; version?: { version_number?: number } }); const name = s.skill_collection?.name ?? ""; const v = s.version?.version_number; return v !== undefined ? `Skill collection "${name}" v${v} retrieved` : `Skill collection "${name}" retrieved`; });
+  reg(t["update-skill-collection"],
+    (c, a) => { const { api_key: _, identifier, ...b } = a as { identifier: string; api_key?: string } & Args; return c.updateSkillCollection(identifier, b); },
+    () => "Skill collection updated");
+  reg(t["save-skill-collection-version"],
+    (c, a) => { const { api_key: _, identifier, ...b } = a as { identifier: string; api_key?: string } & Args; return c.saveSkillCollectionVersion(identifier, b); },
+    (r) => { const v = (r as { version?: { version_number?: number } }).version?.version_number; return v !== undefined ? `Version ${v} saved` : "Version saved"; });
+
+  // Analytics
+  reg(t["get-request-analytics"], (c, a) => c.getRequestAnalytics(body(a)),
+    (r) => { const x = r as { totalRequests?: number; totalCost?: number }; const reqs = x.totalRequests ?? 0; const cost = x.totalCost; return cost !== undefined ? `${reqs} request(s), $${cost} total cost` : `${reqs} request(s) analyzed`; });
+
+  // Prompt template patch
+  reg(t["patch-prompt-template-version"],
+    (c, a) => { const { api_key: _, identifier, ...b } = a as { identifier: string; api_key?: string } & Args; return c.patchPromptTemplateVersion(identifier, b); },
+    (r) => { const v = (r as { version_number?: number }).version_number; return v !== undefined ? `Patched — new version ${v} created` : "Patched — new version created"; });
 }

package/src/types.ts

@@ -313,6 +313,15 @@ export const SaveDraftDatasetVersionArgsSchema = z.object({
   api_key: z.string().optional().describe("PromptLayer API key (optional, defaults to PROMPTLAYER_API_KEY env var)"),
 });
 
+// ── Add Trace to Draft Dataset (POST /api/public/v2/dataset-versions/add-trace) ─────
+
+export const AddTraceToDatasetVersionArgsSchema = z.object({
+  dataset_group_id: z.number().int().min(1).describe("ID of the dataset group containing the draft"),
+  trace_id: z.string().min(1).describe("ID of the trace to add as a dataset row"),
+  span_id: z.string().min(1).optional().describe("Optional span ID to anchor the row on a specific span subtree instead of the full trace"),
+  api_key: z.string().optional().describe("PromptLayer API key (optional, defaults to PROMPTLAYER_API_KEY env var)"),
+});
+
 // ── List Evaluations (GET /api/public/v2/evaluations) ────────────────────
 
 export const ListEvaluationsArgsSchema = z.object({
@@ -529,11 +538,19 @@ export const GetToolRegistryArgsSchema = z.object({
   api_key: z.string().optional().describe("PromptLayer API key (optional, defaults to PROMPTLAYER_API_KEY env var)"),
 });
 
+export const ToolExecutionSchema = z.object({
+  type: z.literal("code"),
+  language: z.enum(["python", "javascript"]),
+  code: z.string().describe("Function body only. Signature is auto-generated; LLM args arrive as a single `args` object."),
+});
+
 export const CreateToolRegistryArgsSchema = z.object({
   name: z.string().describe("Tool name (unique per workspace)"),
   tool_definition: z.record(z.unknown()).describe("Tool definition in OpenAI function-calling format: {type: 'function', function: {name, description, parameters}}"),
+  description: z.string().optional().describe("Optional human-readable description of the tool"),
   folder_id: z.number().int().optional().describe("Folder ID to place tool in"),
   commit_message: z.string().optional().describe("Commit message for the initial version"),
+  execution: ToolExecutionSchema.optional().describe("Optional sandbox-executable body. When set, PromptLayer auto-runs the body between LLM turns whenever a prompt uses this tool."),
   api_key: z.string().optional().describe("PromptLayer API key (optional, defaults to PROMPTLAYER_API_KEY env var)"),
 });
 
@@ -541,6 +558,17 @@ export const CreateToolVersionArgsSchema = z.object({
   identifier: z.string().describe("Tool ID (numeric) or name"),
   tool_definition: z.record(z.unknown()).describe("Updated tool definition in OpenAI function-calling format"),
   commit_message: z.string().optional().describe("Commit message describing what changed"),
+  execution: ToolExecutionSchema.optional().describe("Optional sandbox-executable body to attach to this version. See ToolExecutionSchema for details."),
+  api_key: z.string().optional().describe("PromptLayer API key (optional, defaults to PROMPTLAYER_API_KEY env var)"),
+});
+
+export const TestExecuteToolRegistryArgsSchema = z.object({
+  identifier: z.string().describe("Tool ID (numeric) or name"),
+  inputs: z.record(z.unknown()).optional().describe("Arguments passed to the tool body, keyed by the tool's parameter names. Same shape the LLM would emit."),
+  execution: ToolExecutionSchema.optional().describe("In-flight override of the stored execution config. Lets you test unsaved code without creating a version."),
+  tool_definition: z.record(z.unknown()).optional().describe("In-flight override of the stored tool definition. Useful for testing a different function name without saving."),
+  label: z.string().optional().describe("Resolve version by label name (e.g. 'production'). Falls back to latest if neither label nor version given."),
+  version: z.number().int().optional().describe("Resolve by specific version number"),
   api_key: z.string().optional().describe("PromptLayer API key (optional, defaults to PROMPTLAYER_API_KEY env var)"),
 });
 
@@ -617,24 +645,129 @@ export const ResolveFolderIdArgsSchema = z.object({
 });
 
 
-// ── Search Request Logs (POST /api/public/v2/requests/search) ────────────
-// (StructuredFilter / StructuredFilterGroup are defined higher up so the
-// dataset-from-filter-params endpoint can reuse them.)
+// ── Skill Collections ────────────────────────────────────────────────────
+// Public API endpoints under /api/public/v2/skill-collections.
+// MCP supports JSON bodies only (multipart/form-data with ZIP archive uploads
+// is intentionally not exposed — agents should send file contents inline).
 
-export const SearchRequestLogsArgsSchema = z.object({
+export const ListSkillCollectionsArgsSchema = z.object({
+  api_key: z.string().optional().describe("PromptLayer API key (optional, defaults to PROMPTLAYER_API_KEY env var)"),
+});
+
+const SkillCollectionFileSchema = z.object({
+  path: z.string().describe("Relative file path inside the collection (e.g. 'README.md', 'src/util.ts')"),
+  content: z.string().optional().describe("File contents as a string. Defaults to empty string if omitted."),
+});
+
+export const CreateSkillCollectionArgsSchema = z.object({
+  name: z.string().describe("Collection name. Must be a valid root folder name (will be made unique within the workspace)."),
+  description: z.string().optional().describe("Optional human-readable description"),
+  folder_id: z.number().int().optional().describe("Folder ID to place the collection into"),
+  provider: z.string().optional().describe("Provider hint (e.g. 'claude', 'cursor'). Auto-detected from file paths if omitted."),
+  files: z.array(SkillCollectionFileSchema).optional().describe("Initial files for the collection. Each item is {path, content}."),
+  commit_message: z.string().optional().describe("Commit message for the initial version"),
+  api_key: z.string().optional().describe("PromptLayer API key (optional, defaults to PROMPTLAYER_API_KEY env var)"),
+});
+
+export const GetSkillCollectionArgsSchema = z.object({
+  identifier: z.string().describe("Skill collection UUID, name, or root_path"),
+  label: z.string().optional().describe("Release label to pin the version (mutually exclusive with version)"),
+  version: z.number().int().min(1).optional().describe("Version number to pin (mutually exclusive with label)"),
+  api_key: z.string().optional().describe("PromptLayer API key (optional, defaults to PROMPTLAYER_API_KEY env var)"),
+});
+
+export const UpdateSkillCollectionArgsSchema = z.object({
+  identifier: z.string().describe("Skill collection UUID, name, or root_path"),
+  name: z.string().optional().describe("New collection name (will be made unique within the workspace if it collides)"),
+  description: z.string().optional().describe("New description. Pass empty string to clear."),
+  api_key: z.string().optional().describe("PromptLayer API key (optional, defaults to PROMPTLAYER_API_KEY env var)"),
+});
+
+const SkillCollectionFileMoveSchema = z.object({
+  old_path: z.string().describe("Existing relative path"),
+  new_path: z.string().describe("New relative path"),
+});
+
+export const SaveSkillCollectionVersionArgsSchema = z.object({
+  identifier: z.string().describe("Skill collection UUID, name, or root_path"),
+  file_updates: z.array(SkillCollectionFileSchema).optional().describe("Files to add or overwrite. Each item is {path, content}. Files not mentioned are carried forward from the previous version."),
+  moves: z.array(SkillCollectionFileMoveSchema).optional().describe("Files to rename: [{old_path, new_path}, ...]"),
+  deletes: z.array(z.string()).optional().describe("Relative paths of files to delete from the new version"),
+  commit_message: z.string().optional().describe("Commit message describing what changed"),
+  release_label: z.string().optional().describe("Release label to attach to the new version (e.g. 'production')"),
+  api_key: z.string().optional().describe("PromptLayer API key (optional, defaults to PROMPTLAYER_API_KEY env var)"),
+});
+
+
+// ── Patch Prompt Template Version (PATCH /rest/prompt-templates/{identifier}) ──
+// Partial update: fetches the base version, applies field-level patches, creates a new version.
+
+export const PatchPromptTemplateVersionArgsSchema = z.object({
+  identifier: z.string().describe("Prompt template name or numeric ID"),
+  version: z.number().int().optional().describe("Base version number to patch from (mutually exclusive with label; defaults to latest)"),
+  label: z.string().optional().describe("Release label identifying the base version (mutually exclusive with version)"),
+  messages: z.union([z.record(z.unknown()), z.array(z.record(z.unknown()))]).optional().describe(
+    "Chat templates only. " +
+    "Object form: index-based patch ({\"0\": {...}}) — only listed indices are updated, others preserved. " +
+    "Array form: full replacement of all messages."
+  ),
+  tools: z.union([z.record(z.unknown()), z.array(z.record(z.unknown())), z.null()]).optional().describe(
+    "Chat templates only. Same patching behavior as messages. Pass null to remove all tools."
+  ),
+  functions: z.union([z.record(z.unknown()), z.array(z.record(z.unknown())), z.null()]).optional().describe(
+    "Chat templates only. Same patching behavior as messages. Pass null to remove all functions."
+  ),
+  function_call: z.union([z.string(), z.record(z.unknown()), z.null()]).optional().describe("Replaces the function_call setting. Null removes."),
+  tool_choice: z.union([z.string(), z.record(z.unknown()), z.null()]).optional().describe("Replaces the tool_choice setting. Null removes."),
+  content: z.union([z.record(z.unknown()), z.array(z.record(z.unknown()))]).optional().describe(
+    "Completion templates only. Same index-based / full-replacement behavior as messages."
+  ),
+  model_parameters: z.record(z.unknown()).optional().describe("Shallow-merged into existing model parameters (e.g. temperature, max_tokens)."),
+  response_format: z.union([z.record(z.unknown()), z.null()]).optional().describe("Convenience field to set response_format inside model parameters. Null removes. Cannot be combined with response_format inside model_parameters."),
+  commit_message: z.string().optional().describe("Commit message for the new version"),
+  release_labels: z.array(z.string()).optional().describe("Release labels to create or move to the new version"),
+  api_key: z.string().optional().describe("PromptLayer API key (optional, defaults to PROMPTLAYER_API_KEY env var)"),
+});
+
+
+
+
+// ── Request log query (shared by /requests/search and /requests/analytics) ──
+// Backend models: search uses PostStructuredSearchRequest = RequestLogQuery + page/per_page/include_prompt_name;
+// analytics uses RequestLogQuery directly. We share the 4 RequestLogQuery fields here.
+
+const RequestLogQueryShape = {
   filter_group: StructuredFilterGroupSchema.optional().describe("Filter group with AND/OR logic, supports nesting. Wrap multiple filters in an AND group."),
   q: z.string().optional().describe("Free-text search across prompt input and LLM output"),
-  page: z.number().int().optional().describe("Page number (default: 1)"),
-  per_page: z.number().int().optional().describe("Items per page (max: 25)"),
   sort_by: z.enum([
     "request_start_time", "input_tokens", "output_tokens", "cost", "latency_ms", "status",
     "turn_count", "tool_call_count",
   ]).optional().describe("Sort field"),
   sort_order: z.enum(["asc", "desc"]).optional().describe("Sort direction (must be provided with sort_by)"),
+};
+
+// ── Search Request Logs (POST /api/public/v2/requests/search) ────────────
+// (StructuredFilter / StructuredFilterGroup are defined higher up so the
+// dataset-from-filter-params endpoint can reuse them.)
+
+export const SearchRequestLogsArgsSchema = z.object({
+  ...RequestLogQueryShape,
+  page: z.number().int().optional().describe("Page number (default: 1)"),
+  per_page: z.number().int().optional().describe("Items per page (max: 25)"),
   include_prompt_name: z.boolean().optional().describe("Include prompt template name in results"),
   api_key: z.string().optional().describe("PromptLayer API key (optional, defaults to PROMPTLAYER_API_KEY env var)"),
 });
 
+// ── Get Request Analytics (POST /api/public/v2/requests/analytics) ───────
+// Same RequestLogQuery body as search-request-logs but returns aggregated
+// charts (requests/tokens/cost over time, latency stats, model & prompt
+// breakdowns) instead of paginated rows.
+
+export const GetRequestAnalyticsArgsSchema = z.object({
+  ...RequestLogQueryShape,
+  api_key: z.string().optional().describe("PromptLayer API key (optional, defaults to PROMPTLAYER_API_KEY env var)"),
+});
+
 // ── Get Request (GET /api/public/v2/requests/{request_id}) ───────────────
 
 export const GetRequestArgsSchema = z.object({
@@ -880,6 +1013,12 @@ export const TOOL_DEFINITIONS = {
     inputSchema: SaveDraftDatasetVersionArgsSchema,
     annotations: { readOnlyHint: false },
   },
+  "add-trace-to-dataset": {
+    name: "add-trace-to-dataset",
+    description: "Add a trace as a row to the draft dataset version. Pass span_id to anchor on a specific span subtree instead of the full trace root. Requires create-draft first.",
+    inputSchema: AddTraceToDatasetVersionArgsSchema,
+    annotations: { readOnlyHint: false },
+  },
 
   // ── Evaluations ─────────────────────────────────────────────────────
   "list-evaluations": {
@@ -1020,16 +1159,22 @@ export const TOOL_DEFINITIONS = {
   },
   "create-tool-registry": {
     name: "create-tool-registry",
-    description: "Create a new tool in the Tool Registry with an initial version. The tool definition should be in OpenAI function-calling format.",
+    description: "Create a new tool in the Tool Registry with an initial version. The tool definition should be in OpenAI function-calling format. Pass an optional `execution` payload to attach a sandbox-executable body that PromptLayer will auto-run between LLM turns.",
     inputSchema: CreateToolRegistryArgsSchema,
     annotations: { readOnlyHint: false },
   },
   "create-tool-version": {
     name: "create-tool-version",
-    description: "Create a new version of an existing tool in the Tool Registry. Each version is immutable — this adds a new version with the updated definition.",
+    description: "Create a new version of an existing tool in the Tool Registry. Each version is immutable - this adds a new version with the updated definition. Pass an optional `execution` payload to attach (or replace) the sandbox-executable body for this version.",
     inputSchema: CreateToolVersionArgsSchema,
     annotations: { readOnlyHint: false },
   },
+  "test-execute-tool-registry": {
+    name: "test-execute-tool-registry",
+    description: "Run a tool's execution body in the sandbox against test inputs. Returns the body's return value plus stdout/stderr/duration. Useful for verifying a body before publishing. Pass `execution` and/or `tool_definition` to test unsaved overrides without creating a version. User-code errors return status='error' inside the result (HTTP 200); sandbox infrastructure failures return HTTP 502.",
+    inputSchema: TestExecuteToolRegistryArgsSchema,
+    annotations: { readOnlyHint: false },
+  },
 
   // ── Folders ─────────────────────────────────────────────────────────
   "create-folder": {
@@ -1068,4 +1213,74 @@ export const TOOL_DEFINITIONS = {
     inputSchema: ResolveFolderIdArgsSchema,
     annotations: { readOnlyHint: true },
   },
+
+  // ── Skill Collections ───────────────────────────────────────────────
+  "list-skill-collections": {
+    name: "list-skill-collections",
+    description: "List all skill collections in the workspace. Returns each collection's UUID, name, root_path, provider, description, and timestamps.",
+    inputSchema: ListSkillCollectionsArgsSchema,
+    annotations: { readOnlyHint: true },
+  },
+  "create-skill-collection": {
+    name: "create-skill-collection",
+    description:
+      "Create a new skill collection with optional initial files. Each file is {path, content} where path is relative inside the collection " +
+      "(e.g. 'README.md' or 'src/util.ts'). Provider is auto-detected from file paths if omitted (e.g. .claude/* → 'claude'). " +
+      "Names are made unique within the workspace if they collide.",
+    inputSchema: CreateSkillCollectionArgsSchema,
+    annotations: { readOnlyHint: false },
+  },
+  "get-skill-collection": {
+    name: "get-skill-collection",
+    description:
+      "Fetch a skill collection by UUID, name, or root_path. Returns the collection metadata, the version object, and a 'files' map of " +
+      "{relative_path: file_content}. Pin a specific version with 'version' (number) or 'label' (release label) — these are mutually exclusive. " +
+      "If neither is provided, returns the latest committed version.",
+    inputSchema: GetSkillCollectionArgsSchema,
+    annotations: { readOnlyHint: true },
+  },
+  "update-skill-collection": {
+    name: "update-skill-collection",
+    description: "Rename a skill collection or update its description. To save new file contents as a version, use save-skill-collection-version instead.",
+    inputSchema: UpdateSkillCollectionArgsSchema,
+    annotations: { readOnlyHint: false },
+  },
+  "save-skill-collection-version": {
+    name: "save-skill-collection-version",
+    description:
+      "Save a new version of a skill collection. Apply file changes via three lists: " +
+      "file_updates (add or overwrite — files not mentioned are carried forward unchanged), " +
+      "moves (rename), and deletes (remove). Optionally attach a release_label to the new version.",
+    inputSchema: SaveSkillCollectionVersionArgsSchema,
+    annotations: { readOnlyHint: false },
+  },
+
+  // ── Analytics ───────────────────────────────────────────────────────
+  "get-request-analytics": {
+    name: "get-request-analytics",
+    description:
+      "Aggregate analytics across request logs — totals (requests, tokens, cost), time-series breakdowns, latency percentiles, " +
+      "and most-used models/prompts. Body is the same shape as search-request-logs (filter_group, q, sort_by, sort_order); the response is aggregated, not paginated rows. " +
+      "Use this to answer questions like 'how much have we spent on GPT-4o this week?' or 'what's the p90 latency for prod traffic?'.",
+    inputSchema: GetRequestAnalyticsArgsSchema,
+    annotations: { readOnlyHint: true },
+  },
+
+  // ── Prompt Template Patch ───────────────────────────────────────────
+  "patch-prompt-template-version": {
+    name: "patch-prompt-template-version",
+    description:
+      "Partially update a prompt template by creating a new version with merged changes. Fetches the base version (latest by default, or pin via version/label), " +
+      "applies field-level patches, and creates a new version.\n\n" +
+      "MERGE BEHAVIOR:\n" +
+      "  - messages/tools/functions/content: object form is index-based patch ({\"0\": {...}} updates only listed indices); array form fully replaces.\n" +
+      "  - tools/functions/function_call/tool_choice/response_format: pass null to remove.\n" +
+      "  - model_parameters: shallow merge — existing keys are preserved unless overwritten.\n" +
+      "  - release_labels: creates or moves the labels to the new version.\n\n" +
+      "Use this for surgical edits (e.g. tweak the system message, add a tool, change temperature) without resending the whole template. " +
+      "For a full rewrite, use publish-prompt-template instead.",
+    inputSchema: PatchPromptTemplateVersionArgsSchema,
+    annotations: { readOnlyHint: false },
+  },
+
 } as const;