@2kw/ai-mcp-server 6.3.0-dev.92 → 6.3.0-dev.96

package/dist/lib/overlay.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The body for a PUT that replaces the whole row: the stored resource as its GET returned it, with
+ * every change the caller gave written over it. A change that is `undefined` was not given and keeps
+ * the stored value; the backend would store it as null otherwise (#1195). Server-managed fields in
+ * `current` (a dataset's or prompt's latestVersionId) go back as read, which is what keeps them.
+ */
+export declare function overlay<T extends object>(current: T, changes: Record<string, unknown>): T;
+/** Refuses a name that is present but blank, which a full-replace PUT would otherwise store. */
+export declare function assertNameNotBlank(name: string | undefined): void;
+//# sourceMappingURL=overlay.d.ts.map

package/dist/lib/overlay.js

@@ -0,0 +1,20 @@
+/**
+ * The body for a PUT that replaces the whole row: the stored resource as its GET returned it, with
+ * every change the caller gave written over it. A change that is `undefined` was not given and keeps
+ * the stored value; the backend would store it as null otherwise (#1195). Server-managed fields in
+ * `current` (a dataset's or prompt's latestVersionId) go back as read, which is what keeps them.
+ */
+export function overlay(current, changes) {
+    const body = { ...current };
+    for (const [key, value] of Object.entries(changes)) {
+        if (value !== undefined)
+            body[key] = value;
+    }
+    return body;
+}
+/** Refuses a name that is present but blank, which a full-replace PUT would otherwise store. */
+export function assertNameNotBlank(name) {
+    if (name !== undefined && !name.trim())
+        throw new Error("name must not be empty.");
+}
+//# sourceMappingURL=overlay.js.map

package/dist/tools/agents.js

@@ -2,6 +2,7 @@ import { z } from "zod";
 import { formatErrorForMcp } from "../errors.js";
 import { continueWithDecisions, fetchPendingApprovals, planDecisions, resolveAgentId, splitAgentRef } from "../lib/agent-decide.js";
 import { buildRunEnvelope, chatUrlFor, MODE_RULE } from "../lib/agent-run.js";
+import { assertNameNotBlank } from "../lib/overlay.js";
 const modelSchema = z
     .string()
     .min(1)
@@ -159,9 +160,9 @@ export function register(server, client) {
         }
     });
     // ── update_agent ────────────────────────────────────────────────────────
-    server.tool("2kw_update_agent", "Update an agent's metadata and configuration. name is required on every update. `model` or `models` replaces the stored model list (a shorter list leaves no tail); omit both to keep the current models. Does not create a version.", {
+    server.tool("2kw_update_agent", "Update an agent's metadata and configuration. Omitted fields keep their current values (the tool reads the agent's name and description first when either is omitted). `model` or `models` replaces the stored model list (a shorter list leaves no tail); omit both to keep the current models. Does not create a version.", {
         agentId: z.string().describe("The agent ID"),
-        name: z.string().min(1).describe("Agent name"),
+        name: z.string().optional().describe("New agent name"),
         model: modelSchema.optional(),
         models: modelsSchema.optional(),
         description: z.string().optional().describe("Agent description"),
@@ -172,6 +173,18 @@ export function register(server, client) {
         hitlPolicy: z.unknown().optional().describe("Human-in-the-loop approval policy (JSON object)"),
     }, async ({ agentId, name, model, models, description, instructions, options, tools, skills, hitlPolicy }) => {
         try {
+            assertNameNotBlank(name);
+            // PUT /v1/agents/{id} keeps the configuration fields a body omits, but name is required and
+            // description is written as sent, so an omitted description would be cleared (#1195).
+            if (name === undefined || description === undefined) {
+                const { data: current } = await client.GET("/v1/agents/{id}", {
+                    params: { path: { id: agentId } },
+                });
+                if (!current)
+                    throw new Error(`Agent ${agentId} could not be read.`);
+                name ??= current.name;
+                description ??= current.description;
+            }
             const body = { name, ...modelFields(model, models, false) };
             if (description !== undefined)
                 body.description = description;

package/dist/tools/datasets.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { formatErrorForMcp } from "../errors.js";
+import { assertNameNotBlank, overlay } from "../lib/overlay.js";
 async function resolveLatestVersionId(client, datasetId) {
     const { data } = await client.GET("/v1/datasets/{id}/versions/latest", { params: { path: { id: datasetId } } });
     const versionId = data?.id;
@@ -104,7 +105,7 @@ export function register(server, client) {
         }
     });
     // ── update_dataset ─────────────────────────────────────────────
-    server.tool("2kw_update_dataset", "Update an existing dataset's details.", {
+    server.tool("2kw_update_dataset", "Update an existing dataset's details. Omitted fields keep their current values (the tool reads the dataset first).", {
         datasetId: z.string().describe("The dataset ID"),
         name: z.string().optional().describe("New name"),
         description: z.string().optional().describe("New description"),
@@ -114,22 +115,16 @@ export function register(server, client) {
         metadata: z.unknown().optional().describe("Arbitrary metadata (JSON object)"),
     }, async ({ datasetId, name, description, type, inputSchema, expectedOutputSchema, metadata }) => {
         try {
-            const body = {};
-            if (name !== undefined)
-                body.name = name;
-            if (description !== undefined)
-                body.description = description;
-            if (type !== undefined)
-                body.type = type;
-            if (inputSchema !== undefined)
-                body.inputSchema = inputSchema;
-            if (expectedOutputSchema !== undefined)
-                body.expectedOutputSchema = expectedOutputSchema;
-            if (metadata !== undefined)
-                body.metadata = metadata;
+            assertNameNotBlank(name);
+            // PUT /v1/datasets/{id} replaces the whole dataset, so an omitted field would be stored as null.
+            const { data: current } = await client.GET("/v1/datasets/{id}", {
+                params: { path: { id: datasetId } },
+            });
+            if (!current)
+                throw new Error(`Dataset ${datasetId} could not be read.`);
             const { data } = await client.PUT("/v1/datasets/{id}", {
                 params: { path: { id: datasetId } },
-                body: body,
+                body: overlay(current, { name, description, type, inputSchema, expectedOutputSchema, metadata }),
             });
             return {
                 content: [{ type: "text", text: JSON.stringify(data, null, 2) }],

package/dist/tools/experiments.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) {
     // ── list_experiments ────────────────────────────────────────────
     server.tool("2kw_list_experiments", "List experiments in the organization with optional search, status filter, and pagination.", {
@@ -99,7 +100,7 @@ export function register(server, client) {
         }
     });
     // ── update_experiment ───────────────────────────────────────────
-    server.tool("2kw_update_experiment", "Update an existing experiment's details.", {
+    server.tool("2kw_update_experiment", "Update an existing experiment's details. Omitted fields keep their current values (the tool reads the experiment first).", {
         experimentId: z.string().describe("The experiment ID"),
         name: z.string().optional().describe("New name"),
         description: z.string().optional().describe("New description"),
@@ -108,20 +109,16 @@ export function register(server, client) {
         metadata: z.unknown().optional().describe("Arbitrary metadata (JSON object)"),
     }, async ({ experimentId, name, description, type, datasetVersionId, metadata }) => {
         try {
-            const body = {};
-            if (name !== undefined)
-                body.name = name;
-            if (description !== undefined)
-                body.description = description;
-            if (type !== undefined)
-                body.type = type;
-            if (datasetVersionId !== undefined)
-                body.datasetVersionId = datasetVersionId;
-            if (metadata !== undefined)
-                body.metadata = metadata;
+            assertNameNotBlank(name);
+            // PUT /v1/experiments/{id} replaces the whole experiment, so an omitted field would be stored as null.
+            const { data: current } = await client.GET("/v1/experiments/{id}", {
+                params: { path: { id: experimentId } },
+            });
+            if (!current)
+                throw new Error(`Experiment ${experimentId} could not be read.`);
             const { data } = await client.PUT("/v1/experiments/{id}", {
                 params: { path: { id: experimentId } },
-                body: body,
+                body: overlay(current, { name, description, type, datasetVersionId, metadata }),
             });
             return {
                 content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
@@ -210,7 +207,7 @@ export function register(server, client) {
         }
     });
     // ── update_variant ──────────────────────────────────────────────
-    server.tool("2kw_update_variant", "Update an existing variant's details.", {
+    server.tool("2kw_update_variant", "Update an existing variant's details. Omitted fields keep their current values (the tool reads the variant first).", {
         experimentId: z.string().describe("The experiment ID"),
         variantId: z.string().describe("The variant ID"),
         name: z.string().optional().describe("New variant name"),
@@ -220,20 +217,19 @@ export function register(server, client) {
         sortOrder: z.number().optional().describe("New sort order for display"),
     }, async ({ experimentId, variantId, name, taskType, configuration, description, sortOrder }) => {
         try {
-            const body = {};
-            if (name !== undefined)
-                body.name = name;
-            if (taskType !== undefined)
-                body.taskType = taskType;
-            if (configuration !== undefined)
-                body.configuration = configuration;
-            if (description !== undefined)
-                body.description = description;
-            if (sortOrder !== undefined)
-                body.sortOrder = sortOrder;
+            assertNameNotBlank(name);
+            // PUT .../variants/{variantId} writes name, description and configuration as sent, so an
+            // omitted one would be cleared. There is no single-variant GET: read it from the list. The
+            // read's version goes back with the body, so a change made since is refused with 409.
+            const { data: variants } = await client.GET("/v1/experiments/{id}/variants", {
+                params: { path: { id: experimentId } },
+            });
+            const current = variants?.find((v) => v.id === variantId);
+            if (!current)
+                throw new Error(`Variant ${variantId} is not a variant of experiment ${experimentId}.`);
             const { data } = await client.PUT("/v1/experiments/{id}/variants/{variantId}", {
                 params: { path: { id: experimentId, variantId } },
-                body: body,
+                body: overlay(current, { name, taskType, configuration, description, sortOrder }),
             });
             return {
                 content: [{ type: "text", text: JSON.stringify(data, null, 2) }],

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2kw/ai-mcp-server",
-  "version": "6.3.0-dev.92",
+  "version": "6.3.0-dev.96",
   "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": [