@superdoc-dev/sdk 1.6.0-next.4 → 1.6.0-next.41

package/dist/index.cjs

@@ -159,6 +159,7 @@ exports.installSkill = skills.installSkill;
 exports.listSkills = skills.listSkills;
 exports.chooseTools = tools.chooseTools;
 exports.dispatchSuperDocTool = tools.dispatchSuperDocTool;
+exports.getMcpPrompt = tools.getMcpPrompt;
 exports.getSystemPrompt = tools.getSystemPrompt;
 exports.getToolCatalog = tools.getToolCatalog;
 exports.listTools = tools.listTools;

package/dist/index.d.ts

@@ -77,7 +77,7 @@ export declare class SuperDocClient {
 }
 export declare function createSuperDocClient(options?: SuperDocClientOptions): SuperDocClient;
 export { getSkill, installSkill, listSkills } from './skills.js';
-export { chooseTools, dispatchSuperDocTool, getSystemPrompt, getToolCatalog, listTools } from './tools.js';
+export { chooseTools, dispatchSuperDocTool, getMcpPrompt, getSystemPrompt, getToolCatalog, listTools, } from './tools.js';
 export { dispatchIntentTool } from './generated/intent-dispatch.generated.js';
 export { SuperDocCliError } from './runtime/errors.js';
 export type { InvokeOptions, OperationSpec, OperationParamSpec, RuntimeInvoker, SuperDocClientOptions, } from './runtime/process.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -147,6 +147,6 @@ export function createSuperDocClient(options = {}) {
     return new SuperDocClient(options);
 }
 export { getSkill, installSkill, listSkills } from './skills.js';
-export { chooseTools, dispatchSuperDocTool, getSystemPrompt, getToolCatalog, listTools } from './tools.js';
+export { chooseTools, dispatchSuperDocTool, getMcpPrompt, getSystemPrompt, getToolCatalog, listTools, } from './tools.js';
 export { dispatchIntentTool } from './generated/intent-dispatch.generated.js';
 export { SuperDocCliError } from './runtime/errors.js';

package/dist/tools.cjs

@@ -15,9 +15,28 @@ const providerFileByName = {
     vercel: 'tools.vercel.json',
     generic: 'tools.generic.json',
 };
+const STRIP_EMPTY_OPTIONAL_ARGS = new Set(['parentId', 'parentCommentId', 'id', 'status']);
 function isRecord(value) {
     return typeof value === 'object' && value != null && !Array.isArray(value);
 }
+function isObviouslyCorruptedToolArgKey(key) {
+    const trimmed = key.trim();
+    return trimmed.length === 0 || !/[\p{L}\p{N}]/u.test(trimmed);
+}
+function stripCorruptedToolArgKeys(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => stripCorruptedToolArgKeys(item));
+    }
+    if (!isRecord(value))
+        return value;
+    const clean = {};
+    for (const [key, entryValue] of Object.entries(value)) {
+        if (isObviouslyCorruptedToolArgKey(key))
+            continue;
+        clean[key] = stripCorruptedToolArgKeys(entryValue);
+    }
+    return clean;
+}
 async function readJson(fileName) {
     const filePath = path.join(toolsDir, fileName);
     let raw = '';
@@ -202,6 +221,13 @@ async function dispatchSuperDocTool(documentHandle, toolName, args = {}, invokeO
             details: { toolName },
         });
     }
+    const sanitizedArgs = stripCorruptedToolArgKeys(args);
+    if (!isRecord(sanitizedArgs)) {
+        throw new errors.SuperDocCliError(`Tool arguments for ${toolName} must be an object.`, {
+            code: 'INVALID_ARGUMENT',
+            details: { toolName },
+        });
+    }
     // Validate against the tool schema before dispatch.
     const catalog = await getCachedCatalog();
     const tool = catalog.tools.find((t) => t.toolName === toolName);
@@ -211,13 +237,12 @@ async function dispatchSuperDocTool(documentHandle, toolName, args = {}, invokeO
             details: { toolName },
         });
     }
-    validateToolArgs(toolName, args, tool);
+    validateToolArgs(toolName, sanitizedArgs, tool);
     // Strip empty strings for known optional ID/enum params that LLMs fill with ""
     // instead of omitting. Only target params where "" is never a valid value.
-    const STRIP_EMPTY = new Set(['parentId', 'parentCommentId', 'id', 'status']);
     const cleanArgs = {};
-    for (const [key, value] of Object.entries(args)) {
-        if (value === '' && STRIP_EMPTY.has(key))
+    for (const [key, value] of Object.entries(sanitizedArgs)) {
+        if (value === '' && STRIP_EMPTY_OPTIONAL_ARGS.has(key))
             continue;
         cleanArgs[key] = value;
     }
@@ -227,7 +252,11 @@ async function dispatchSuperDocTool(documentHandle, toolName, args = {}, invokeO
     });
 }
 /**
- * Read the bundled system prompt for intent tools.
+ * Read the bundled SDK system prompt for intent tools.
+ *
+ * This prompt includes a persona preamble ("You are a document editing assistant…")
+ * suitable for embedded LLM usage (OpenAI, Anthropic, Vercel APIs).
+ * For MCP server instructions, use {@link getMcpPrompt} instead.
  */
 async function getSystemPrompt() {
     const promptPath = path.join(toolsDir, 'system-prompt.md');
@@ -241,9 +270,28 @@ async function getSystemPrompt() {
         });
     }
 }
+/**
+ * Read the bundled MCP system prompt for intent tools.
+ *
+ * This prompt omits the persona preamble and includes session lifecycle
+ * instructions (open/save/close) suitable for MCP server `instructions`.
+ */
+async function getMcpPrompt() {
+    const promptPath = path.join(toolsDir, 'system-prompt-mcp.md');
+    try {
+        return await promises.readFile(promptPath, 'utf8');
+    }
+    catch {
+        throw new errors.SuperDocCliError('MCP system prompt not found.', {
+            code: 'TOOLS_ASSET_NOT_FOUND',
+            details: { filePath: promptPath },
+        });
+    }
+}
 
 exports.chooseTools = chooseTools;
 exports.dispatchSuperDocTool = dispatchSuperDocTool;
+exports.getMcpPrompt = getMcpPrompt;
 exports.getSystemPrompt = getSystemPrompt;
 exports.getToolCatalog = getToolCatalog;
 exports.listTools = listTools;

package/dist/tools.d.ts

@@ -50,8 +50,19 @@ export declare function chooseTools(input: ToolChooserInput): Promise<{
  */
 export declare function dispatchSuperDocTool(documentHandle: BoundDocApi, toolName: string, args?: Record<string, unknown>, invokeOptions?: InvokeOptions): Promise<unknown>;
 /**
- * Read the bundled system prompt for intent tools.
+ * Read the bundled SDK system prompt for intent tools.
+ *
+ * This prompt includes a persona preamble ("You are a document editing assistant…")
+ * suitable for embedded LLM usage (OpenAI, Anthropic, Vercel APIs).
+ * For MCP server instructions, use {@link getMcpPrompt} instead.
  */
 export declare function getSystemPrompt(): Promise<string>;
+/**
+ * Read the bundled MCP system prompt for intent tools.
+ *
+ * This prompt omits the persona preamble and includes session lifecycle
+ * instructions (open/save/close) suitable for MCP server `instructions`.
+ */
+export declare function getMcpPrompt(): Promise<string>;
 export {};
 //# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI1D,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAWzE,MAAM,MAAM,WAAW,GAAG;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;CAC5B,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B,CAAC;AA6CF,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAE3D;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAU1E;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,YAAY,CAAC;CACxB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC;IAClE,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,IAAI,EAAE;QACJ,QAAQ,EAAE,YAAY,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH,CAAC,CAWD;AAiID;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,cAAc,EAAE,WAAW,EAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAClC,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,OAAO,CAAC,CAgClB;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAUvD"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI1D,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAWzE,MAAM,MAAM,WAAW,GAAG;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;CAC5B,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B,CAAC;AAmEF,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAE3D;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAU1E;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,YAAY,CAAC;CACxB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC;IAClE,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,IAAI,EAAE;QACJ,QAAQ,EAAE,YAAY,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH,CAAC,CAWD;AAiID;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,cAAc,EAAE,WAAW,EAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAClC,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,OAAO,CAAC,CAuClB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAUvD;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAUpD"}

package/dist/tools.js

@@ -11,9 +11,28 @@ const providerFileByName = {
     vercel: 'tools.vercel.json',
     generic: 'tools.generic.json',
 };
+const STRIP_EMPTY_OPTIONAL_ARGS = new Set(['parentId', 'parentCommentId', 'id', 'status']);
 function isRecord(value) {
     return typeof value === 'object' && value != null && !Array.isArray(value);
 }
+function isObviouslyCorruptedToolArgKey(key) {
+    const trimmed = key.trim();
+    return trimmed.length === 0 || !/[\p{L}\p{N}]/u.test(trimmed);
+}
+function stripCorruptedToolArgKeys(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => stripCorruptedToolArgKeys(item));
+    }
+    if (!isRecord(value))
+        return value;
+    const clean = {};
+    for (const [key, entryValue] of Object.entries(value)) {
+        if (isObviouslyCorruptedToolArgKey(key))
+            continue;
+        clean[key] = stripCorruptedToolArgKeys(entryValue);
+    }
+    return clean;
+}
 async function readJson(fileName) {
     const filePath = path.join(toolsDir, fileName);
     let raw = '';
@@ -198,6 +217,13 @@ export async function dispatchSuperDocTool(documentHandle, toolName, args = {},
             details: { toolName },
         });
     }
+    const sanitizedArgs = stripCorruptedToolArgKeys(args);
+    if (!isRecord(sanitizedArgs)) {
+        throw new SuperDocCliError(`Tool arguments for ${toolName} must be an object.`, {
+            code: 'INVALID_ARGUMENT',
+            details: { toolName },
+        });
+    }
     // Validate against the tool schema before dispatch.
     const catalog = await getCachedCatalog();
     const tool = catalog.tools.find((t) => t.toolName === toolName);
@@ -207,13 +233,12 @@ export async function dispatchSuperDocTool(documentHandle, toolName, args = {},
             details: { toolName },
         });
     }
-    validateToolArgs(toolName, args, tool);
+    validateToolArgs(toolName, sanitizedArgs, tool);
     // Strip empty strings for known optional ID/enum params that LLMs fill with ""
     // instead of omitting. Only target params where "" is never a valid value.
-    const STRIP_EMPTY = new Set(['parentId', 'parentCommentId', 'id', 'status']);
     const cleanArgs = {};
-    for (const [key, value] of Object.entries(args)) {
-        if (value === '' && STRIP_EMPTY.has(key))
+    for (const [key, value] of Object.entries(sanitizedArgs)) {
+        if (value === '' && STRIP_EMPTY_OPTIONAL_ARGS.has(key))
             continue;
         cleanArgs[key] = value;
     }
@@ -223,7 +248,11 @@ export async function dispatchSuperDocTool(documentHandle, toolName, args = {},
     });
 }
 /**
- * Read the bundled system prompt for intent tools.
+ * Read the bundled SDK system prompt for intent tools.
+ *
+ * This prompt includes a persona preamble ("You are a document editing assistant…")
+ * suitable for embedded LLM usage (OpenAI, Anthropic, Vercel APIs).
+ * For MCP server instructions, use {@link getMcpPrompt} instead.
  */
 export async function getSystemPrompt() {
     const promptPath = path.join(toolsDir, 'system-prompt.md');
@@ -237,3 +266,21 @@ export async function getSystemPrompt() {
         });
     }
 }
+/**
+ * Read the bundled MCP system prompt for intent tools.
+ *
+ * This prompt omits the persona preamble and includes session lifecycle
+ * instructions (open/save/close) suitable for MCP server `instructions`.
+ */
+export async function getMcpPrompt() {
+    const promptPath = path.join(toolsDir, 'system-prompt-mcp.md');
+    try {
+        return await readFile(promptPath, 'utf8');
+    }
+    catch {
+        throw new SuperDocCliError('MCP system prompt not found.', {
+            code: 'TOOLS_ASSET_NOT_FOUND',
+            details: { filePath: promptPath },
+        });
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/sdk",
-  "version": "1.6.0-next.4",
+  "version": "1.6.0-next.41",
   "private": false,
   "type": "module",
   "main": "./dist/index.cjs",
@@ -26,11 +26,11 @@
     "typescript": "^5.9.2"
   },
   "optionalDependencies": {
-    "@superdoc-dev/sdk-darwin-arm64": "1.6.0-next.4",
-    "@superdoc-dev/sdk-darwin-x64": "1.6.0-next.4",
-    "@superdoc-dev/sdk-linux-x64": "1.6.0-next.4",
-    "@superdoc-dev/sdk-linux-arm64": "1.6.0-next.4",
-    "@superdoc-dev/sdk-windows-x64": "1.6.0-next.4"
+    "@superdoc-dev/sdk-darwin-x64": "1.6.0-next.41",
+    "@superdoc-dev/sdk-linux-x64": "1.6.0-next.41",
+    "@superdoc-dev/sdk-linux-arm64": "1.6.0-next.41",
+    "@superdoc-dev/sdk-windows-x64": "1.6.0-next.41",
+    "@superdoc-dev/sdk-darwin-arm64": "1.6.0-next.41"
   },
   "publishConfig": {
     "access": "public"