@superdoc-dev/sdk 1.0.0-alpha.30 → 1.0.0-alpha.31

package/README.md

@@ -94,14 +94,12 @@ client.doc.insert(params)
 The SDK includes built-in support for exposing document operations as AI tool definitions:
 
 ```ts
-import { chooseTools, dispatchSuperDocTool, inferDocumentFeatures } from '@superdoc-dev/sdk';
+import { chooseTools, dispatchSuperDocTool } from '@superdoc-dev/sdk';
 
-// Get tool definitions for your AI provider
+// Get tool definitions for your AI provider, filtered by group
 const { tools, selected } = await chooseTools({
-  provider: 'openai',       // 'openai' | 'anthropic' | 'vercel' | 'generic'
-  profile: 'intent',        // human-friendly tool names
-  taskContext: { phase: 'mutate' },
-  documentFeatures: inferDocumentFeatures(await client.doc.info()),
+  provider: 'openai',  // 'openai' | 'anthropic' | 'vercel' | 'generic'
+  groups: ['core', 'format', 'comments'],  // core is always auto-included
 });
 
 // Dispatch a tool call from the AI model
@@ -110,12 +108,12 @@ const result = await dispatchSuperDocTool(client, toolName, args);
 
 | Function | Description |
 |----------|-------------|
-| `chooseTools(input)` | Select tools filtered by phase, capabilities, and budget |
-| `listTools(provider, options?)` | List all tool definitions for a provider |
+| `chooseTools(input)` | Select tools filtered by group 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(options?)` | Load the full tool catalog |
-| `inferDocumentFeatures(infoResult)` | Derive feature flags from `doc.info` output |
+| `getToolCatalog()` | Load the full tool catalog |
+| `getAvailableGroups()` | List all available tool groups |
 
 ## Part of SuperDoc
 

package/dist/generated/client.cjs

@@ -258,6 +258,14 @@ function createDocApi(runtime) {
             setAnchorOptions: (params, options) => runtime.invoke(contract.CONTRACT.operations["doc.images.setAnchorOptions"], params, options),
             setZOrder: (params, options) => runtime.invoke(contract.CONTRACT.operations["doc.images.setZOrder"], params, options),
         },
+        hyperlinks: {
+            list: (params = {}, options) => runtime.invoke(contract.CONTRACT.operations["doc.hyperlinks.list"], params, options),
+            get: (params, options) => runtime.invoke(contract.CONTRACT.operations["doc.hyperlinks.get"], params, options),
+            wrap: (params, options) => runtime.invoke(contract.CONTRACT.operations["doc.hyperlinks.wrap"], params, options),
+            insert: (params, options) => runtime.invoke(contract.CONTRACT.operations["doc.hyperlinks.insert"], params, options),
+            patch: (params, options) => runtime.invoke(contract.CONTRACT.operations["doc.hyperlinks.patch"], params, options),
+            remove: (params, options) => runtime.invoke(contract.CONTRACT.operations["doc.hyperlinks.remove"], 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),