@superdoc-dev/sdk 1.0.0-alpha.44 → 1.0.0-alpha.46

package/README.md

@@ -91,29 +91,39 @@ client.doc.insert(params)
 
 ### AI Tool Integration
 
-The SDK includes built-in support for exposing document operations as AI tool definitions:
+The SDK includes built-in support for exposing grouped intent tools as AI tool definitions:
 
 ```ts
-import { chooseTools, dispatchSuperDocTool } from '@superdoc-dev/sdk';
-
-// Get tool definitions for your AI provider, filtered by group
-const { tools, selected } = await chooseTools({
+import {
+  chooseTools,
+  dispatchSuperDocTool,
+  getToolCatalog,
+} from '@superdoc-dev/sdk';
+
+// Get the full grouped tool set for your AI provider
+const { tools, meta } = await chooseTools({
   provider: 'openai',  // 'openai' | 'anthropic' | 'vercel' | 'generic'
-  groups: ['core', 'format', 'comments'],  // core is always auto-included
 });
 
+// Optional: inspect the generated tool catalog
+const catalog = await getToolCatalog();
+
 // Dispatch a tool call from the AI model
 const result = await dispatchSuperDocTool(client, toolName, args);
 ```
 
+The current catalog contains 9 grouped tools:
+`superdoc_get_content`, `superdoc_edit`, `superdoc_format`, `superdoc_create`, `superdoc_list`, `superdoc_comment`, `superdoc_track_changes`, `superdoc_search`, and `superdoc_mutations`.
+
+Multi-action tools use an `action` field to select the underlying operation. Single-action tools like `superdoc_search` do not require `action`.
+
 | Function | Description |
 |----------|-------------|
-| `chooseTools(input)` | Select tools filtered by group for a provider |
+| `chooseTools(input)` | Load grouped tool definitions for a provider |
 | `listTools(provider)` | List all tool definitions for a provider |
 | `dispatchSuperDocTool(client, toolName, args)` | Execute a tool call against a client |
-| `resolveToolOperation(toolName)` | Map a tool name to its operation ID |
-| `getToolCatalog()` | Load the full tool catalog |
-| `getAvailableGroups()` | List all available tool groups |
+| `getToolCatalog()` | Load the grouped tool catalog with metadata |
+| `getSystemPrompt()` | Read the bundled system prompt for intent tools |
 
 ## Part of SuperDoc
 

package/dist/generated/client.cjs

@@ -187,6 +187,9 @@ function createDocApi(runtime) {
         query: {
             match: (params, options) => runtime.invoke(contract.CONTRACT.operations["doc.query.match"], params, options),
         },
+        ranges: {
+            resolve: (params, options) => runtime.invoke(contract.CONTRACT.operations["doc.ranges.resolve"], params, options),
+        },
         mutations: {
             preview: (params, options) => runtime.invoke(contract.CONTRACT.operations["doc.mutations.preview"], params, options),
             apply: (params, options) => runtime.invoke(contract.CONTRACT.operations["doc.mutations.apply"], params, options),
@@ -463,6 +466,11 @@ function createDocApi(runtime) {
                 remove: (params, options) => runtime.invoke(contract.CONTRACT.operations["doc.authorities.entries.remove"], params, options),
             },
         },
+        diff: {
+            capture: (params = {}, options) => runtime.invoke(contract.CONTRACT.operations["doc.diff.capture"], params, options),
+            compare: (params, options) => runtime.invoke(contract.CONTRACT.operations["doc.diff.compare"], params, options),
+            apply: (params, options) => runtime.invoke(contract.CONTRACT.operations["doc.diff.apply"], params, options),
+        },
         open: (params = {}, options) => runtime.invoke(contract.CONTRACT.operations["doc.open"], params, options),
         save: (params = {}, options) => runtime.invoke(contract.CONTRACT.operations["doc.save"], params, options),
         close: (params = {}, options) => runtime.invoke(contract.CONTRACT.operations["doc.close"], params, options),