@2kw/ai-mcp-server 6.3.0 → 6.4.0-dev.8

package/dist/lib/agent-run.js

@@ -81,9 +81,26 @@ function parseArguments(raw) {
         return raw;
     }
 }
+/**
+ * A connector tool's open approval, decoded from the standard `mcp_approval_request` item (#949). The item
+ * is the MCP twin of `backbone:approval_request` (#805): it names the server and the tool, carries no call
+ * id, policy class or status, and exists only while the decision is open, so its id doubles as the call id
+ * and the tool is named as the approval row stores it, `mcp__<server_label>__<tool>`.
+ */
+function connectorApproval(i) {
+    return {
+        approvalId: String(i.id),
+        callId: String(i.id),
+        tool: `mcp__${String(i.server_label)}__${String(i.name)}`,
+        arguments: parseArguments(i.arguments),
+        policyClass: "unknown",
+        reason: null,
+    };
+}
 /**
  * Output item types the envelope decodes, or that never hold a run: text, reasoning and finished
- * connector calls. A pause on anything else (a connector approval's `mcp_approval_request`) is named.
+ * connector calls. A pause on anything else is named.
+ * `backbone:tool_image` is an image a finished `ViewImage` call attached (#1244): it never holds a run.
  */
 const DECODED_ITEM_TYPES = new Set([
     "message",
@@ -92,6 +109,8 @@ const DECODED_ITEM_TYPES = new Set([
     "function_call_output",
     "backbone:approval_request",
     "backbone:connector_auth_request",
+    "backbone:tool_image",
+    "mcp_approval_request",
     "mcp_call",
     "mcp_list_tools",
 ]);
@@ -133,17 +152,20 @@ export function buildRunEnvelope(result, agentRef, chatUrl = DEFAULT_CHAT_URL) {
         String(i.call_id),
         i.status === "incomplete" ? "incomplete" : "completed",
     ]));
-    const pendingApprovals = output
-        // Only an open request is pending; judge- or grant-decided requests (#634, #629) carry another status.
-        .filter((i) => i.type === "backbone:approval_request" && (i.status === undefined || i.status === "in_progress"))
-        .map((i) => ({
-        approvalId: String(i.id),
-        callId: String(i.call_id),
-        tool: String(i.tool),
-        arguments: parseArguments(i.arguments),
-        policyClass: String(i.policy_class),
-        reason: typeof i.reason === "string" && i.reason ? i.reason : null,
-    }));
+    const pendingApprovals = [
+        ...output
+            // Only an open request is pending; judge- or grant-decided requests (#634, #629) carry another status.
+            .filter((i) => i.type === "backbone:approval_request" && (i.status === undefined || i.status === "in_progress"))
+            .map((i) => ({
+            approvalId: String(i.id),
+            callId: String(i.call_id),
+            tool: String(i.tool),
+            arguments: parseArguments(i.arguments),
+            policyClass: String(i.policy_class),
+            reason: typeof i.reason === "string" && i.reason ? i.reason : null,
+        })),
+        ...output.filter((i) => i.type === "mcp_approval_request").map(connectorApproval),
+    ];
     // The one decoding rule (#1086): only an open request with its id, call id, label and host.
     const connectRequests = pendingConnectionsOf(output);
     const pendingConnections = connectRequests.map(({ serverLabel, host, reason, destinations }) => ({
@@ -207,8 +229,8 @@ export function buildRunEnvelope(result, agentRef, chatUrl = DEFAULT_CHAT_URL) {
         const approvalsSuffix = pendingApprovals.length > 0
             ? " Show the pending approvals to the user and pass their decisions in the same call, within the same window."
             : "";
-        // A connector-tool approval (mcp_approval_request) never decodes into pendingApprovals, so this
-        // envelope can under-report what is actually pending; say so rather than sound falsely complete
+        // An item type this server does not decode (a connector approval is decoded since #949) can leave
+        // the envelope under-reporting what is actually pending; say so rather than sound falsely complete
         // (#1254 review). The continuation itself still refuses an incomplete answer (400
         // incomplete_tool_outputs, decideErrorText's hint), this only tells the assistant to expect that.
         const undecodedTypes = extraUndecodedTypes(output);
@@ -219,6 +241,14 @@ export function buildRunEnvelope(result, agentRef, chatUrl = DEFAULT_CHAT_URL) {
             : "";
         next = `${connectPrefix}${relay}${approvalsSuffix}${undecodedSuffix}`;
     }
+    else if (status === "requires_tool_output" && pendingConnections.length > 0 && pendingApprovals.length > 0 && pendingToolCalls.length === 0 && ref && responseId) {
+        // A continuation must decide every pending approval (400 incomplete_tool_outputs otherwise), so a
+        // fresh request is no way on; decide answers them and the engine re-checks access itself (#949 review).
+        next =
+            `Tell the user to ${connectionsPhrase(pendingConnections)} in ${chatUrl}/connectors. ` +
+                "Show the pending approvals to the user; after they decide each one, call 2kw_decide_agent_approvals with agent " +
+                `${JSON.stringify(ref)} and responseId ${JSON.stringify(responseId)}.`;
+    }
     else if (status === "requires_tool_output" && pendingConnections.length > 0 && pendingToolCalls.length === 0 && responseId) {
         // A connector-only pause (no relayed call, so 2kw_decide_agent_approvals has nothing to decide,
         // spec M11) has no tool here to continue it by id, and a connect pause cannot be continued by

package/dist/tools/conversion.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { readFile } from "node:fs/promises";
 import { basename } from "node:path";
-import { BackboneApiError, formatErrorForMcp } from "../errors.js";
+import { formatErrorForMcp } from "../errors.js";
 import { getMimeType } from "../mime.js";
 /**
  * Map user-friendly format names to backend OutputFormat enum values.
@@ -167,27 +167,13 @@ export function register(server, client) {
                 if (Object.keys(nestedOpts).length > 0) {
                     formData.append("options", new Blob([JSON.stringify(nestedOpts)], { type: "application/json" }));
                 }
-                const { baseUrl, apiKey } = client._config;
-                const endpoint = isAsync ? "/v1/convert/file/async" : "/v1/convert/file";
-                const url = pipeline
-                    ? `${baseUrl}${endpoint}?pipeline=${encodeURIComponent(pipeline)}`
-                    : `${baseUrl}${endpoint}`;
-                const res = await fetch(url, {
-                    method: "POST",
-                    headers: { Authorization: `Bearer ${apiKey}` },
-                    body: formData,
+                // Placeholder body for the generated type; bodySerializer sends the real parts.
+                const result = await client.POST(isAsync ? "/v1/convert/file/async" : "/v1/convert/file", {
+                    params: { query: { pipeline } },
+                    body: { files: [] },
+                    bodySerializer: () => formData,
                 });
-                if (!res.ok) {
-                    let body;
-                    try {
-                        body = await res.json();
-                    }
-                    catch {
-                        body = { error: res.statusText, message: `HTTP ${res.status}: ${res.statusText}`, status: res.status, timestamp: new Date().toISOString() };
-                    }
-                    throw new BackboneApiError(body);
-                }
-                const data = await res.json();
+                const data = result.data;
                 if (isAsync) {
                     const taskId = data?.taskId;
                     if (waitForCompletion && taskId) {

package/dist/tools/knowledge.js

@@ -46,7 +46,7 @@ const TEXT_SEARCH_LANGUAGES = [
 const knowledgeBaseFields = {
     name: z.string().min(1).describe("Knowledge base name"),
     slug: z.string().min(1).describe("URL-safe slug, lowercase letters and digits joined by single dashes"),
-    embeddingProviderId: z.string().min(1).describe("Provider id serving the embedding model"),
+    embeddingProviderId: z.string().min(1).describe("Provider id serving the embedding model, or builtin for the platform's built-in models (text-embedding-3-small, text-embedding-3-large; charged per input token). Changing it on update re-embeds nothing: stored vectors stay comparable only if the new provider serves the same model at the same width; the safe move is a new knowledge base with the documents uploaded again."),
     embeddingModel: z.string().min(1).describe("Embedding model id"),
     embeddingDim: z.number().int().positive().describe("Embedding dimension. Fixed at creation — on update this must match the existing value, it is not applied as a change."),
     description: z.string().optional().describe("Knowledge base description"),
@@ -55,7 +55,7 @@ const knowledgeBaseFields = {
     chunkOverlap: z.number().int().min(0).max(2000).optional().describe("Chunk overlap (0-2000), must be smaller than chunkSize"),
     parentChunkSize: z.number().int().min(100).max(8000).optional().describe("Parent chunk size for hierarchical chunking (100-8000), must exceed chunkSize"),
     hybridSearchEnabled: z.boolean().optional().describe("Enable hybrid dense + lexical search"),
-    rerankerProviderId: z.string().optional().describe("Provider id used for reranking"),
+    rerankerProviderId: z.string().optional().describe("Provider id used for reranking. builtin is refused: there is no built-in reranker."),
     textSearchLanguage: z.enum(TEXT_SEARCH_LANGUAGES).optional().describe("Text-search language for the lexical leg (default simple on create). On update, omit to leave the active and any pending language untouched — resending the current value would cancel a reindex in progress; changing it starts one in the background."),
 };
 function buildKnowledgeBaseBody(params) {
@@ -380,7 +380,7 @@ export function register(server, client) {
         }
     });
     // ── list_provider_embedding_models ────────────────────────────────────────
-    server.tool("2kw_list_provider_embedding_models", "List embedding models served by a provider that fit a provisioned embedding dimension. Empty when the provider type has no catalogued embedding models; never an error. Use this to pick embeddingModel/embeddingDim for 2kw_create_knowledge_base.", { providerId: z.string().describe("The provider ID") }, async ({ providerId }) => {
+    server.tool("2kw_list_provider_embedding_models", "List embedding models served by a provider that fit a provisioned embedding dimension. Empty when the provider type has no catalogued embedding models; never an error. Pass builtin to list the platform's built-in embedding models. Use this to pick embeddingModel/embeddingDim for 2kw_create_knowledge_base.", { providerId: z.string().describe("The provider ID, or builtin for the platform's built-in embedding models") }, async ({ providerId }) => {
         try {
             const { data } = await client.GET("/v1/providers/{providerId}/embedding-models", {
                 params: { path: { providerId } },

package/dist/tools/skills.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { readFile, stat } from "node:fs/promises";
 import { basename, extname } from "node:path";
-import { BackboneApiError, formatErrorForMcp } from "../errors.js";
+import { formatErrorForMcp } from "../errors.js";
 // Spring accepts flat pagination parameters despite the generated pageable wrapper.
 function paginationParams(params) {
     return {
@@ -160,22 +160,11 @@ export function register(server, client) {
             formData.append("file", new Blob([buffer], {
                 type: isZip ? "application/zip" : "text/markdown",
             }), filename);
-            const { baseUrl, apiKey } = client._config;
-            const res = await fetch(`${baseUrl.replace(/\/+$/, "")}/v1/skills/import`, {
-                method: "POST",
-                headers: { Authorization: `Bearer ${apiKey}` },
-                body: formData,
+            // Placeholder body for the generated type; bodySerializer sends the real part.
+            const { data } = await client.POST("/v1/skills/import", {
+                body: { file: "" },
+                bodySerializer: () => formData,
             });
-            if (!res.ok) {
-                const body = await res.json().catch(() => ({}));
-                throw new BackboneApiError({
-                    status: body.status ?? res.status,
-                    error: body.title ?? body.error ?? res.statusText,
-                    message: body.detail ?? body.message ?? `HTTP ${res.status}: ${res.statusText}`,
-                    timestamp: body.timestamp ?? new Date().toISOString(),
-                });
-            }
-            const data = await res.json();
             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",
+  "version": "6.4.0-dev.8",
   "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": [