@promptlayer/mcp-server 1.9.0 → 1.11.0

package/src/client.ts

@@ -112,4 +112,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

@@ -164,4 +164,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

@@ -83,7 +83,12 @@ export const PublishPromptTemplateArgsSchema = z.object({
     prompt_name: z.string().describe("Name of the prompt template"),
     tags: z.array(z.string()).optional().describe("Tags to associate"),
     folder_id: z.number().int().optional().describe("Folder ID to publish into"),
-  }).describe("Template metadata: prompt_name (required), tags, folder_id"),
+    is_snippet: z.boolean().optional().describe(
+      "Mark this template as a reusable snippet (referenced via @@@name@@@ in other prompts). " +
+      "Only takes effect when the prompt is first created — publishing a new version of an " +
+      "existing template will not flip this flag."
+    ),
+  }).describe("Template metadata: prompt_name (required), tags, folder_id, is_snippet"),
   prompt_version: z.object({
     prompt_template: z.record(z.unknown()).describe("The template content in chat ({type:'chat', messages:[...]}) or completion format"),
     commit_message: z.string().optional().describe("Commit message (max 72 chars)"),
@@ -218,44 +223,59 @@ export const CreateDatasetVersionFromFileArgsSchema = z.object({
   api_key: z.string().optional().describe("PromptLayer API key (optional, defaults to PROMPTLAYER_API_KEY env var)"),
 });
 
+// ── Structured filter primitives (shared by request search + dataset-from-history) ──
+// NOTE: value/filters use loose types (z.unknown()) because the backend validates
+// operator-field compatibility at runtime. This is tracked as a known exception in
+// scripts/diff-endpoints.ts.
+
+const StructuredFilterSchema = z.object({
+  field: z.enum([
+    "pl_id", "prompt_id", "engine", "provider_type", "input_text", "output_text",
+    "prompt_version_number", "input_tokens", "output_tokens", "cost", "latency_ms",
+    "request_start_time", "request_end_time", "status",
+    "is_json", "is_tool_call", "is_plain_text", "has_trace",
+    "tags", "metadata_keys", "metadata", "tool_names",
+    "output", "output_keys", "input_variables", "input_variable_keys",
+    "turn_count", "tool_call_count",
+  ]).describe("Request log field to filter on"),
+  operator: z.enum([
+    "is", "is_not", "in", "not_in",
+    "contains", "not_contains", "starts_with", "ends_with",
+    "eq", "neq", "gt", "gte", "lt", "lte", "between",
+    "before", "after",
+    "is_true", "is_false", "is_empty", "is_not_empty",
+    "is_null", "is_not_null",
+    "key_equals", "key_not_equals", "key_contains",
+  ]).describe("Filter operator (availability depends on field type)"),
+  value: z.unknown().optional().describe("Filter value (type depends on operator)"),
+  nested_key: z.string().optional().describe("Key name for nested field operators (metadata, output, input_variables)"),
+});
+
+const StructuredFilterGroupSchema: z.ZodType = z.object({
+  logic: z.enum(["AND", "OR"]).optional().describe("Logical operator (default: AND)"),
+  filters: z.array(z.union([StructuredFilterSchema, z.lazy(() => StructuredFilterGroupSchema)])).describe("Filters or nested filter groups"),
+});
+
 // ── Create Dataset Version from Filter Params (POST /api/public/v2/dataset-versions/from-filter-params)
 
 export const CreateDatasetVersionFromFilterParamsArgsSchema = z.object({
-  dataset_group_id: z.number().int().describe("Dataset group ID"),
-  variables_to_parse: z.array(z.string()).optional().describe("Variables to extract from request logs"),
-  tags: z.array(z.string()).optional().describe("Filter by tags (simple tag filter)"),
-  metadata: z.record(z.string()).optional().describe("Simple metadata key-value filter"),
-  start_time: z.string().optional().describe("Start time filter (ISO 8601)"),
-  end_time: z.string().optional().describe("End time filter (ISO 8601)"),
-  id: z.number().int().optional().describe("Filter by specific request log ID"),
-  limit: z.number().int().optional().describe("Limit number of request logs to pull"),
-  tags_and: z.array(z.string()).optional().describe("Filter by tags (AND logic — all must match)"),
-  tags_or: z.array(z.string()).optional().describe("Filter by tags (OR logic — any can match)"),
-  metadata_and: z.array(z.object({ key: z.string(), value: z.string() })).optional().describe("Metadata filters with AND logic (all must match). Each item: {key, value}"),
-  metadata_or: z.array(z.object({ key: z.string(), value: z.string() })).optional().describe("Metadata filters with OR logic (any can match). Each item: {key, value}"),
-  scores: z.array(z.object({
-    name: z.string().describe("Score name"),
-    operator: z.enum([">", "<", ">=", "<=", "="]).describe("Comparison operator"),
-    value: z.number().int().describe("Score value to compare against"),
-  })).optional().describe("Filter by score criteria. Each item: {name, operator, value}"),
-  prompt_templates_include: z.array(z.object({
-    name: z.string().describe("Prompt template name"),
-    version_numbers: z.array(z.number().int()).optional().describe("Filter to specific version numbers"),
-    labels: z.array(z.string()).optional().describe("Filter to specific labels"),
-  })).optional().describe("Include request logs matching these prompt templates. This is the primary way to filter by prompt — use the prompt name (not ID)."),
-  prompt_templates_exclude: z.array(z.object({
-    name: z.string().describe("Prompt template name"),
-    version_numbers: z.array(z.number().int()).optional().describe("Filter to specific version numbers"),
-    labels: z.array(z.string()).optional().describe("Filter to specific labels"),
-  })).optional().describe("Exclude request logs matching these prompt templates"),
-  starred: z.boolean().optional().describe("Filter by starred status"),
-  status: z.array(z.enum(["SUCCESS", "WARNING", "ERROR"])).optional().describe("Filter by request log status"),
+  dataset_group_id: z.number().int().describe("Dataset group ID to create the new version under"),
+  request_log_ids: z.array(z.number().int().positive()).optional().describe(
+    "Static snapshot mode: pin the dataset to an explicit list of request log IDs (capped at 50,000). " +
+    "≤50 IDs run synchronously; >50 are processed asynchronously. " +
+    "Datasets created this way are not refreshable."
+  ),
+  filter_group: StructuredFilterGroupSchema.optional().describe(
+    "Structured filter mode: same shape as search-request-logs (AND/OR groups of field/operator/value filters). " +
+    "Always processed asynchronously. Persisted on the dataset so refresh_dataset can replay it."
+  ),
+  q: z.string().optional().describe("Free-text search query applied alongside filter_group"),
   sort_by: z.enum([
-    "request_start_time", "input_tokens", "output_tokens", "price",
-    "score", "latency", "prompt_name", "status",
+    "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"),
-  order_by_random: z.boolean().optional().describe("Random ordering (requires limit)"),
+  sort_order: z.enum(["asc", "desc"]).optional().describe("Sort direction (defaults to desc when sort_by is set)"),
+  variables_to_parse: z.array(z.string()).optional().describe("Input variable names to extract as dataset columns"),
   api_key: z.string().optional().describe("PromptLayer API key (optional, defaults to PROMPTLAYER_API_KEY env var)"),
 });
 
@@ -597,49 +617,129 @@ export const ResolveFolderIdArgsSchema = z.object({
 });
 
 
-// ── Search Request Logs (POST /api/public/v2/requests/search) ────────────
-// NOTE: The StructuredFilter and StructuredFilterGroup schemas use loose types
-// (z.unknown()) for value/filters because the backend validates operator-field
-// compatibility at runtime. This is tracked as a known exception in scripts/diff-endpoints.ts.
+// ── 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).
 
-const StructuredFilterSchema = z.object({
-  field: z.enum([
-    "pl_id", "prompt_id", "engine", "provider_type", "input_text", "output_text",
-    "prompt_version_number", "input_tokens", "output_tokens", "cost", "latency_ms",
-    "request_start_time", "request_end_time", "status",
-    "is_json", "is_tool_call", "is_plain_text",
-    "tags", "metadata_keys", "metadata", "tool_names",
-    "output", "output_keys", "input_variables", "input_variable_keys",
-  ]).describe("Request log field to filter on"),
-  operator: z.enum([
-    "is", "is_not", "in", "not_in",
-    "contains", "not_contains", "starts_with", "ends_with",
-    "eq", "neq", "gt", "gte", "lt", "lte", "between",
-    "before", "after",
-    "is_true", "is_false", "is_empty", "is_not_empty",
-    "is_null", "is_not_null",
-    "key_equals", "key_not_equals", "key_contains",
-  ]).describe("Filter operator (availability depends on field type)"),
-  value: z.unknown().optional().describe("Filter value (type depends on operator)"),
-  nested_key: z.string().optional().describe("Key name for nested field operators (metadata, output, input_variables)"),
+export const ListSkillCollectionsArgsSchema = z.object({
+  api_key: z.string().optional().describe("PromptLayer API key (optional, defaults to PROMPTLAYER_API_KEY env var)"),
 });
 
-const StructuredFilterGroupSchema: z.ZodType = z.object({
-  logic: z.enum(["AND", "OR"]).optional().describe("Logical operator (default: AND)"),
-  filters: z.array(z.union([StructuredFilterSchema, z.lazy(() => StructuredFilterGroupSchema)])).describe("Filters or nested filter groups"),
+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 SearchRequestLogsArgsSchema = z.object({
+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"),
+  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)"),
-  sort_by: z.enum(["request_start_time", "input_tokens", "output_tokens", "cost", "latency_ms", "status"]).optional().describe("Sort field"),
-  sort_order: z.enum(["asc", "desc"]).optional().describe("Sort direction (must be provided with sort_by)"),
   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({
@@ -715,11 +815,14 @@ export const TOOL_DEFINITIONS = {
     name: "publish-prompt-template",
     description:
       "Create a new version of a prompt template. " +
-      "Body has two required objects: prompt_template (with prompt_name, tags, folder_id) and " +
+      "Body has two required objects: prompt_template (with prompt_name, tags, folder_id, is_snippet) and " +
       "prompt_version (with prompt_template content in chat/completion format, commit_message, metadata). " +
       "Optionally assign release_labels. " +
       "IMPORTANT: If the prompt uses snippets, preserve @@@snippet_name@@@ markers in the content. " +
-      "Do not inline snippet text — this breaks snippet references.",
+      "Do not inline snippet text — this breaks snippet references. " +
+      "To create a snippet (a reusable fragment referenced by other prompts), set " +
+      "prompt_template.is_snippet=true on the first publish. The flag is only honored on initial " +
+      "creation; later versions cannot flip an existing template into a snippet or vice versa.",
     inputSchema: PublishPromptTemplateArgsSchema,
     annotations: { readOnlyHint: false },
   },
@@ -764,9 +867,9 @@ export const TOOL_DEFINITIONS = {
       "Operators by field type:\n" +
       "  - String fields (engine, provider_type): is, is_not, in, not_in\n" +
       "  - Text fields (input_text, output_text): contains, not_contains, starts_with, ends_with\n" +
-      "  - Numeric fields (cost, latency_ms, input_tokens, output_tokens): eq, neq, gt, gte, lt, lte, between (value=[min,max]), is_null, is_not_null\n" +
+      "  - Numeric fields (cost, latency_ms, input_tokens, output_tokens, turn_count, tool_call_count): eq, neq, gt, gte, lt, lte, between (value=[min,max]), is_null, is_not_null\n" +
       "  - Datetime fields (request_start_time, request_end_time): is, before, after, between (value=[start,end] as ISO 8601)\n" +
-      "  - Boolean fields (is_json, is_tool_call, is_plain_text): is_true, is_false\n" +
+      "  - Boolean fields (is_json, is_tool_call, is_plain_text, has_trace): is_true, is_false\n" +
       "  - Array fields (tags, metadata_keys, tool_names, output_keys, input_variable_keys): contains, not_contains, in, not_in, is_empty, is_not_empty\n" +
       "  - Nested fields (metadata, output, input_variables): key_equals, key_not_equals, key_contains, in, not_in, is_empty, is_not_empty — requires nested_key\n\n" +
       "EXAMPLES:\n" +
@@ -849,7 +952,12 @@ export const TOOL_DEFINITIONS = {
   },
   "create-dataset-version-from-filter-params": {
     name: "create-dataset-version-from-filter-params",
-    description: "Create a dataset version from request log history using filter criteria. Populated asynchronously.",
+    description:
+      "Create a dataset version from request log history. Two modes:\n" +
+      "  1. request_log_ids — pin to an explicit list of IDs (≤50 sync, >50 async). Snapshot, not refreshable.\n" +
+      "  2. filter_group (+ optional q) — structured AND/OR filter, same shape as search-request-logs. " +
+      "Async; persisted on the dataset so refresh_dataset can replay it.\n" +
+      "Use variables_to_parse to extract specific input variables as dataset columns.",
     inputSchema: CreateDatasetVersionFromFilterParamsArgsSchema,
     annotations: { readOnlyHint: false },
   },
@@ -1065,4 +1173,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;