@superdoc-dev/sdk 1.0.0-next.73 → 1.0.0-next.75

package/dist/tools.d.ts

@@ -1,3 +1,4 @@
+import type { BoundDocApi } from './generated/client.js';
 import type { InvokeOptions } from './runtime/process.js';
 export type ToolProvider = 'openai' | 'anthropic' | 'vercel' | 'generic';
 export type ToolCatalog = {
@@ -41,9 +42,13 @@ export declare function chooseTools(input: ToolChooserInput): Promise<{
         toolCount: number;
     };
 }>;
-export declare function dispatchSuperDocTool(client: {
-    doc: Record<string, unknown>;
-}, toolName: string, args?: Record<string, unknown>, invokeOptions?: InvokeOptions): Promise<unknown>;
+/**
+ * Dispatch a tool call against a bound document handle.
+ *
+ * The document handle injects session targeting automatically.
+ * Tool arguments should not contain `doc` or `sessionId`.
+ */
+export declare function dispatchSuperDocTool(documentHandle: BoundDocApi, toolName: string, args?: Record<string, unknown>, invokeOptions?: InvokeOptions): Promise<unknown>;
 /**
  * Read the bundled system prompt for intent tools.
  */

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,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,wBAAsB,oBAAoB,CACxC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,EACxC,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAClC,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,OAAO,CAAC,CA0BlB;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;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"}

package/dist/tools.js

@@ -83,9 +83,9 @@ export async function chooseTools(input) {
         },
     };
 }
-function resolveDocApiMethod(client, operationId) {
+function resolveDocApiMethod(documentHandle, operationId) {
     const tokens = operationId.split('.').slice(1);
-    let cursor = client.doc;
+    let cursor = documentHandle;
     for (const token of tokens) {
         if (!isRecord(cursor) || !(token in cursor)) {
             throw new SuperDocCliError(`No SDK doc method found for operation ${operationId}.`, {
@@ -185,7 +185,13 @@ function validateOperationRequired(toolName, action, args, op) {
         }
     }
 }
-export async function dispatchSuperDocTool(client, toolName, args = {}, invokeOptions) {
+/**
+ * Dispatch a tool call against a bound document handle.
+ *
+ * The document handle injects session targeting automatically.
+ * Tool arguments should not contain `doc` or `sessionId`.
+ */
+export async function dispatchSuperDocTool(documentHandle, toolName, args = {}, invokeOptions) {
     if (!isRecord(args)) {
         throw new SuperDocCliError(`Tool arguments for ${toolName} must be an object.`, {
             code: 'INVALID_ARGUMENT',
@@ -202,10 +208,17 @@ export async function dispatchSuperDocTool(client, toolName, args = {}, invokeOp
         });
     }
     validateToolArgs(toolName, args, tool);
-    // Strip doc/sessionId — the SDK client manages session targeting after doc.open().
-    const { doc: _doc, sessionId: _sid, ...cleanArgs } = args;
+    // 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))
+            continue;
+        cleanArgs[key] = value;
+    }
     return dispatchIntentTool(toolName, cleanArgs, (operationId, input) => {
-        const method = resolveDocApiMethod(client, operationId);
+        const method = resolveDocApiMethod(documentHandle, operationId);
         return method(input, invokeOptions);
     });
 }

package/package.json

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