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

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,8 @@ 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;
-    return dispatchIntentTool(toolName, cleanArgs, (operationId, input) => {
-        const method = resolveDocApiMethod(client, operationId);
+    return dispatchIntentTool(toolName, args, (operationId, input) => {
+        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.74",
   "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.74",
+    "@superdoc-dev/sdk-linux-x64": "1.0.0-next.74",
+    "@superdoc-dev/sdk-linux-arm64": "1.0.0-next.74",
+    "@superdoc-dev/sdk-darwin-x64": "1.0.0-next.74",
+    "@superdoc-dev/sdk-windows-x64": "1.0.0-next.74"
   },
   "publishConfig": {
     "access": "public"

package/tools/catalog.json

@@ -19,14 +19,6 @@
             ],
             "description": "The action to perform. One of: html, info, markdown, text."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "in": {
             "oneOf": [
               {
@@ -220,14 +212,6 @@
             ],
             "description": "The action to perform. One of: delete, insert, redo, replace, undo."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "force": {
             "type": "boolean",
             "description": "Bypass confirmation checks."
@@ -756,14 +740,6 @@
             ],
             "description": "The action to perform. One of: inline, set_alignment, set_direction, set_indentation, set_spacing, set_style."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "force": {
             "type": "boolean",
             "description": "Bypass confirmation checks."
@@ -1504,14 +1480,6 @@
             ],
             "description": "The action to perform. One of: heading, paragraph."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "force": {
             "type": "boolean",
             "description": "Bypass confirmation checks."
@@ -1841,14 +1809,6 @@
             ],
             "description": "The action to perform. One of: create, detach, indent, insert, outdent, set_level, set_type."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "force": {
             "type": "boolean",
             "description": "Bypass confirmation checks."
@@ -2154,14 +2114,6 @@
             ],
             "description": "The action to perform. One of: create, delete, get, list, update."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "force": {
             "type": "boolean",
             "description": "Bypass confirmation checks."
@@ -2307,14 +2259,6 @@
             ],
             "description": "The action to perform. One of: decide, list."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "limit": {
             "type": "number",
             "description": "Maximum number of tracked changes to return."
@@ -2409,14 +2353,6 @@
       "inputSchema": {
         "type": "object",
         "properties": {
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "in": {
             "oneOf": [
               {
@@ -2736,14 +2672,6 @@
             ],
             "description": "The action to perform. One of: apply, preview."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "in": {
             "oneOf": [
               {

package/tools/tools-policy.json

@@ -39,5 +39,5 @@
       "mutates": true
     }
   ],
-  "contractHash": "20a5c483c698af85"
+  "contractHash": "53a4b0e0f230cbd9"
 }

package/tools/tools.anthropic.json

@@ -17,14 +17,6 @@
             ],
             "description": "The action to perform. One of: html, info, markdown, text."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "in": {
             "oneOf": [
               {
@@ -199,14 +191,6 @@
             ],
             "description": "The action to perform. One of: delete, insert, redo, replace, undo."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "force": {
             "type": "boolean",
             "description": "Bypass confirmation checks."
@@ -670,14 +654,6 @@
             ],
             "description": "The action to perform. One of: inline, set_alignment, set_direction, set_indentation, set_spacing, set_style."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "force": {
             "type": "boolean",
             "description": "Bypass confirmation checks."
@@ -1363,14 +1339,6 @@
             ],
             "description": "The action to perform. One of: heading, paragraph."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "force": {
             "type": "boolean",
             "description": "Bypass confirmation checks."
@@ -1686,14 +1654,6 @@
             ],
             "description": "The action to perform. One of: create, detach, indent, insert, outdent, set_level, set_type."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "force": {
             "type": "boolean",
             "description": "Bypass confirmation checks."
@@ -1944,14 +1904,6 @@
             ],
             "description": "The action to perform. One of: create, delete, get, list, update."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "force": {
             "type": "boolean",
             "description": "Bypass confirmation checks."
@@ -2065,14 +2017,6 @@
             ],
             "description": "The action to perform. One of: decide, list."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "limit": {
             "type": "number",
             "description": "Maximum number of tracked changes to return."
@@ -2152,14 +2096,6 @@
       "input_schema": {
         "type": "object",
         "properties": {
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "in": {
             "oneOf": [
               {
@@ -2469,14 +2405,6 @@
             ],
             "description": "The action to perform. One of: apply, preview."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "in": {
             "oneOf": [
               {

package/tools/tools.generic.json

@@ -17,14 +17,6 @@
             ],
             "description": "The action to perform. One of: html, info, markdown, text."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "in": {
             "oneOf": [
               {
@@ -209,14 +201,6 @@
             ],
             "description": "The action to perform. One of: delete, insert, redo, replace, undo."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "force": {
             "type": "boolean",
             "description": "Bypass confirmation checks."
@@ -691,14 +675,6 @@
             ],
             "description": "The action to perform. One of: inline, set_alignment, set_direction, set_indentation, set_spacing, set_style."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "force": {
             "type": "boolean",
             "description": "Bypass confirmation checks."
@@ -1396,14 +1372,6 @@
             ],
             "description": "The action to perform. One of: heading, paragraph."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "force": {
             "type": "boolean",
             "description": "Bypass confirmation checks."
@@ -1727,14 +1695,6 @@
             ],
             "description": "The action to perform. One of: create, detach, indent, insert, outdent, set_level, set_type."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "force": {
             "type": "boolean",
             "description": "Bypass confirmation checks."
@@ -1998,14 +1958,6 @@
             ],
             "description": "The action to perform. One of: create, delete, get, list, update."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "force": {
             "type": "boolean",
             "description": "Bypass confirmation checks."
@@ -2130,14 +2082,6 @@
             ],
             "description": "The action to perform. One of: decide, list."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "limit": {
             "type": "number",
             "description": "Maximum number of tracked changes to return."
@@ -2225,14 +2169,6 @@
       "parameters": {
         "type": "object",
         "properties": {
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "in": {
             "oneOf": [
               {
@@ -2549,14 +2485,6 @@
             ],
             "description": "The action to perform. One of: apply, preview."
           },
-          "doc": {
-            "type": "string",
-            "description": "Document path. Optional when a session is already open."
-          },
-          "sessionId": {
-            "type": "string",
-            "description": "Session ID for multi-session workflows. Optional when only one session is open."
-          },
           "in": {
             "oneOf": [
               {

package/tools/tools.openai.json

@@ -19,14 +19,6 @@
               ],
               "description": "The action to perform. One of: html, info, markdown, text."
             },
-            "doc": {
-              "type": "string",
-              "description": "Document path. Optional when a session is already open."
-            },
-            "sessionId": {
-              "type": "string",
-              "description": "Session ID for multi-session workflows. Optional when only one session is open."
-            },
             "in": {
               "oneOf": [
                 {
@@ -204,14 +196,6 @@
               ],
               "description": "The action to perform. One of: delete, insert, redo, replace, undo."
             },
-            "doc": {
-              "type": "string",
-              "description": "Document path. Optional when a session is already open."
-            },
-            "sessionId": {
-              "type": "string",
-              "description": "Session ID for multi-session workflows. Optional when only one session is open."
-            },
             "force": {
               "type": "boolean",
               "description": "Bypass confirmation checks."
@@ -678,14 +662,6 @@
               ],
               "description": "The action to perform. One of: inline, set_alignment, set_direction, set_indentation, set_spacing, set_style."
             },
-            "doc": {
-              "type": "string",
-              "description": "Document path. Optional when a session is already open."
-            },
-            "sessionId": {
-              "type": "string",
-              "description": "Session ID for multi-session workflows. Optional when only one session is open."
-            },
             "force": {
               "type": "boolean",
               "description": "Bypass confirmation checks."
@@ -1374,14 +1350,6 @@
               ],
               "description": "The action to perform. One of: heading, paragraph."
             },
-            "doc": {
-              "type": "string",
-              "description": "Document path. Optional when a session is already open."
-            },
-            "sessionId": {
-              "type": "string",
-              "description": "Session ID for multi-session workflows. Optional when only one session is open."
-            },
             "force": {
               "type": "boolean",
               "description": "Bypass confirmation checks."
@@ -1700,14 +1668,6 @@
               ],
               "description": "The action to perform. One of: create, detach, indent, insert, outdent, set_level, set_type."
             },
-            "doc": {
-              "type": "string",
-              "description": "Document path. Optional when a session is already open."
-            },
-            "sessionId": {
-              "type": "string",
-              "description": "Session ID for multi-session workflows. Optional when only one session is open."
-            },
             "force": {
               "type": "boolean",
               "description": "Bypass confirmation checks."
@@ -1961,14 +1921,6 @@
               ],
               "description": "The action to perform. One of: create, delete, get, list, update."
             },
-            "doc": {
-              "type": "string",
-              "description": "Document path. Optional when a session is already open."
-            },
-            "sessionId": {
-              "type": "string",
-              "description": "Session ID for multi-session workflows. Optional when only one session is open."
-            },
             "force": {
               "type": "boolean",
               "description": "Bypass confirmation checks."
@@ -2085,14 +2037,6 @@
               ],
               "description": "The action to perform. One of: decide, list."
             },
-            "doc": {
-              "type": "string",
-              "description": "Document path. Optional when a session is already open."
-            },
-            "sessionId": {
-              "type": "string",
-              "description": "Session ID for multi-session workflows. Optional when only one session is open."
-            },
             "limit": {
               "type": "number",
               "description": "Maximum number of tracked changes to return."
@@ -2175,14 +2119,6 @@
         "parameters": {
           "type": "object",
           "properties": {
-            "doc": {
-              "type": "string",
-              "description": "Document path. Optional when a session is already open."
-            },
-            "sessionId": {
-              "type": "string",
-              "description": "Session ID for multi-session workflows. Optional when only one session is open."
-            },
             "in": {
               "oneOf": [
                 {
@@ -2495,14 +2431,6 @@
               ],
               "description": "The action to perform. One of: apply, preview."
             },
-            "doc": {
-              "type": "string",
-              "description": "Document path. Optional when a session is already open."
-            },
-            "sessionId": {
-              "type": "string",
-              "description": "Session ID for multi-session workflows. Optional when only one session is open."
-            },
             "in": {
               "oneOf": [
                 {