@2kw/ai-mcp-server 6.3.0-dev.14 → 6.3.0-dev.153

package/dist/tools/prompts.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { formatErrorForMcp } from "../errors.js";
+import { assertNameNotBlank, overlay } from "../lib/overlay.js";
 export function register(server, client) {
     // ── prompts ─────────────────────────────────────────────────────────────
     server.tool("2kw_list_prompts", "List org prompts with optional name/type filter and pagination.", {
@@ -74,23 +75,23 @@ export function register(server, client) {
             };
         }
     });
-    server.tool("2kw_update_prompt", "Update prompt metadata (name, description, type).", {
+    server.tool("2kw_update_prompt", "Update prompt metadata (name, description, type). Omitted fields keep their current values (the tool reads the prompt first).", {
         promptId: z.string(),
         name: z.string().optional(),
         description: z.string().optional(),
         type: z.enum(["TEXT", "CHAT"]).optional(),
     }, async (params) => {
         try {
-            const body = {};
-            if (params.name !== undefined)
-                body.name = params.name;
-            if (params.description !== undefined)
-                body.description = params.description;
-            if (params.type !== undefined)
-                body.type = params.type;
+            assertNameNotBlank(params.name);
+            // PUT /v1/prompts/{id} replaces the whole prompt, so an omitted field would be stored as null.
+            const { data: current } = await client.GET("/v1/prompts/{id}", {
+                params: { path: { id: params.promptId } },
+            });
+            if (!current)
+                throw new Error(`Prompt ${params.promptId} could not be read.`);
             const { data } = await client.PUT("/v1/prompts/{id}", {
                 params: { path: { id: params.promptId } },
-                body: body,
+                body: overlay(current, { name: params.name, description: params.description, type: params.type }),
             });
             return {
                 content: [{ type: "text", text: JSON.stringify(data, null, 2) }],

package/dist/tools/schemas.js

@@ -85,20 +85,27 @@ export function register(server, client) {
         }
     });
     // ── update_schema ───────────────────────────────────────────────────────
-    server.tool("2kw_update_schema", "Update an existing schema.", {
+    server.tool("2kw_update_schema", "Update an existing schema. Omitted fields keep their current values (the tool reads the schema first).", {
         schemaId: z.string().describe("The schema ID"),
         name: z.string().optional().describe("New schema name"),
         description: z.string().optional().describe("New schema description"),
     }, async ({ schemaId, name, description }) => {
         try {
-            const body = {};
-            if (name !== undefined)
-                body.name = name;
-            if (description !== undefined)
-                body.description = description;
+            if (name !== undefined && !name.trim())
+                throw new Error("name must not be empty.");
+            // PUT /v1/schemas/{id} replaces the whole schema, so an omitted field would be stored as null.
+            if (name === undefined || description === undefined) {
+                const { data: current } = await client.GET("/v1/schemas/{id}", {
+                    params: { path: { id: schemaId } },
+                });
+                if (!current)
+                    throw new Error(`Schema ${schemaId} could not be read.`);
+                name ??= current.name;
+                description ??= current.description;
+            }
             const { data } = await client.PUT("/v1/schemas/{id}", {
                 params: { path: { id: schemaId } },
-                body: body,
+                body: { name, description },
             });
             return {
                 content: [{ type: "text", text: JSON.stringify(data, null, 2) }],

package/dist/tools/tracing.js

@@ -2,7 +2,7 @@ import { z } from "zod";
 import { formatErrorForMcp } from "../errors.js";
 export function register(server, client) {
     // ── settings ────────────────────────────────────────────────────────────
-    server.tool("2kw_get_tracing_settings", "Return the org's tracing settings (includePrompts / includeCompletions). These control whether raw prompt and completion content are persisted on ingested spans. Defaults are false for both.", {}, async () => {
+    server.tool("2kw_get_tracing_settings", "Return the org's tracing settings: includePrompts / includeCompletions (whether raw prompt and completion content are persisted on ingested spans; false by default) and trace retention: retentionDays (the org's choice, null = follow the plan), planRetentionDays and effectiveRetentionDays.", {}, async () => {
         try {
             const { data } = await client.GET("/v1/tracing/settings");
             return {
@@ -16,7 +16,7 @@ export function register(server, client) {
             };
         }
     });
-    server.tool("2kw_update_tracing_settings", "Update the org's tracing settings. Admin-only. Omit a field to leave it at its current value — the tool reads the current setting first and merges.", {
+    server.tool("2kw_update_tracing_settings", "Update the org's tracing settings. Admin-only. Omit a field to leave it at its current value — the tool reads the current setting first and merges. Shortening retentionDays deletes older traces at the next daily sweep.", {
         includePrompts: z
             .boolean()
             .optional()
@@ -25,12 +25,20 @@ export function register(server, client) {
             .boolean()
             .optional()
             .describe("Retain completion content on ingested spans (default false)"),
+        retentionDays: z
+            .number()
+            .int()
+            .min(1)
+            .nullable()
+            .optional()
+            .describe("Trace retention in days, at most the plan's limit (planRetentionDays). null follows the plan. Shortening deletes older traces at the next daily sweep."),
     }, async (params) => {
         try {
             const { data: current } = await client.GET("/v1/tracing/settings");
             const merged = {
                 includePrompts: params.includePrompts ?? current?.includePrompts ?? false,
                 includeCompletions: params.includeCompletions ?? current?.includeCompletions ?? false,
+                retentionDays: params.retentionDays !== undefined ? params.retentionDays : (current?.retentionDays ?? null),
             };
             const { data } = await client.PUT("/v1/tracing/settings", {
                 body: merged,
@@ -121,8 +129,12 @@ export function register(server, client) {
         }
     });
     // ── sessions ────────────────────────────────────────────────────────────
-    server.tool("2kw_list_trace_sessions", "List sessions (spans grouped by an exporter-stamped session id) in the org, with turn/error counts, duration, tokens and cost. Optional free-text search across session id and name, and a start-time range.", {
+    server.tool("2kw_list_trace_sessions", "List sessions (spans grouped by an exporter-stamped session id) in the org, with turn/error counts, duration, tokens and cost. Optional free-text search across session id and name, an exact session id match, and a start-time range. Each line starts with the session's own id, which 2kw_get_trace_session takes.", {
         search: z.string().optional().describe("Free-text search across session id and name"),
+        sessionId: z
+            .string()
+            .optional()
+            .describe("Exact match on the session.id the exporter stamped (slashes allowed)"),
         from: z.string().optional().describe("Start of time range (ISO-8601)"),
         to: z.string().optional().describe("End of time range (ISO-8601)"),
         page: z.number().int().min(0).optional().describe("Page index (0-based)"),
@@ -133,6 +145,7 @@ export function register(server, client) {
                 params: {
                     query: {
                         search: params.search,
+                        sessionId: params.sessionId,
                         from: params.from,
                         to: params.to,
                         page: params.page ?? 0,
@@ -145,7 +158,7 @@ export function register(server, client) {
                 const services = Array.isArray(s.sourceServices)
                     ? s.sourceServices.join(", ")
                     : "";
-                return `- ${s.sessionId} ${s.name ?? "(unnamed)"} · ${s.durationMs}ms · ${s.turnCount} turns · ${s.errorCount} errors · ${services}`;
+                return `- ${s.id} ${s.sessionId} ${s.name ?? "(unnamed)"} · ${s.durationMs}ms · ${s.turnCount} turns · ${s.errorCount} errors · ${services}`;
             });
             return {
                 content: [
@@ -163,12 +176,12 @@ export function register(server, client) {
             };
         }
     });
-    server.tool("2kw_get_trace_session", "Get every span recorded under a session, flat and sorted by start time — reconstruct the conversation chronologically. The id is the external session id stamped by the exporter.", {
-        sessionId: z.string().describe("Session id"),
+    server.tool("2kw_get_trace_session", "Get every span recorded under a session, flat and sorted by start time — reconstruct the conversation chronologically. The id is the session's own id from 2kw_list_trace_sessions; to find a session by the session id the exporter stamped, use that tool's sessionId filter.", {
+        id: z.string().describe("Session id, as 2kw_list_trace_sessions lists it"),
     }, async (params) => {
         try {
-            const { data } = await client.GET("/v1/traces/sessions/{sessionId}", {
-                params: { path: { sessionId: params.sessionId } },
+            const { data } = await client.GET("/v1/traces/sessions/{id}", {
+                params: { path: { id: params.id } },
             });
             return {
                 content: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2kw/ai-mcp-server",
-  "version": "6.3.0-dev.14",
+  "version": "6.3.0-dev.153",
   "description": "MCP server for 2kw.ai — EU-hosted AI platform: OpenAI-compatible LLM gateway, schema-driven document extraction, transcription, agents with a knowledge base, and cost observability. 158 tools for Claude Code, Cursor, and Windsurf.",
   "mcpName": "ai.2kw/mcp-server",
   "keywords": [
@@ -41,6 +41,10 @@
     "check:generated": "tsx openapi/scripts/check-generated.ts",
     "fix:generated": "tsx openapi/scripts/check-generated.ts --write",
     "check:coverage": "tsx ../cli/openapi/scripts/check-coverage.ts",
+    "docs:tools": "tsx scripts/tool-docs.ts",
+    "check:tool-docs": "tsx scripts/tool-docs.ts --check",
+    "sync:connect-pause": "tsx scripts/sync-connect-pause.ts",
+    "check:connect-pause": "tsx scripts/sync-connect-pause.ts --check",
     "test": "tsx --test tests/*.test.ts",
     "typecheck": "tsc --noEmit"
   },