@superdoc-dev/sdk 1.0.0-alpha.43 → 1.0.0-alpha.45

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

@@ -36,7 +36,9 @@ function createDocApi(runtime) {
         replace: (params = {}, options) => runtime.invoke(contract.CONTRACT.operations["doc.replace"], params, options),
         delete: (params = {}, options) => runtime.invoke(contract.CONTRACT.operations["doc.delete"], params, options),
         blocks: {
+            list: (params = {}, options) => runtime.invoke(contract.CONTRACT.operations["doc.blocks.list"], params, options),
             delete: (params = {}, options) => runtime.invoke(contract.CONTRACT.operations["doc.blocks.delete"], params, options),
+            deleteRange: (params = {}, options) => runtime.invoke(contract.CONTRACT.operations["doc.blocks.deleteRange"], params, options),
         },
         format: {
             apply: (params = {}, options) => runtime.invoke(contract.CONTRACT.operations["doc.format.apply"], params, options),
@@ -185,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),