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

package/dist/generated/intent-dispatch.generated.cjs

@@ -0,0 +1,93 @@
+'use strict';
+
+// Auto-generated by generate-intent-tools.mjs — do not edit
+function dispatchIntentTool(toolName, args, execute) {
+    switch (toolName) {
+        case 'superdoc_get_content': {
+            const { action, ...rest } = args;
+            switch (action) {
+                case 'text': return execute('doc.getText', rest);
+                case 'markdown': return execute('doc.getMarkdown', rest);
+                case 'html': return execute('doc.getHtml', rest);
+                case 'info': return execute('doc.info', rest);
+                default: throw new Error(`Unknown action for superdoc_get_content: ${action}`);
+            }
+        }
+        case 'superdoc_edit': {
+            const { action, ...rest } = args;
+            switch (action) {
+                case 'insert': return execute('doc.insert', rest);
+                case 'replace': return execute('doc.replace', rest);
+                case 'delete': return execute('doc.delete', rest);
+                case 'undo': return execute('doc.history.undo', rest);
+                case 'redo': return execute('doc.history.redo', rest);
+                default: throw new Error(`Unknown action for superdoc_edit: ${action}`);
+            }
+        }
+        case 'superdoc_format': {
+            const { action, ...rest } = args;
+            switch (action) {
+                case 'inline': return execute('doc.format.apply', rest);
+                case 'set_style': return execute('doc.styles.paragraph.setStyle', rest);
+                case 'set_alignment': return execute('doc.format.paragraph.setAlignment', rest);
+                case 'set_indentation': return execute('doc.format.paragraph.setIndentation', rest);
+                case 'set_spacing': return execute('doc.format.paragraph.setSpacing', rest);
+                default: throw new Error(`Unknown action for superdoc_format: ${action}`);
+            }
+        }
+        case 'superdoc_create': {
+            const { action, ...rest } = args;
+            switch (action) {
+                case 'paragraph': return execute('doc.create.paragraph', rest);
+                case 'heading': return execute('doc.create.heading', rest);
+                default: throw new Error(`Unknown action for superdoc_create: ${action}`);
+            }
+        }
+        case 'superdoc_list': {
+            const { action, ...rest } = args;
+            switch (action) {
+                case 'insert': return execute('doc.lists.insert', rest);
+                case 'create': return execute('doc.lists.create', rest);
+                case 'detach': return execute('doc.lists.detach', rest);
+                case 'indent': return execute('doc.lists.indent', rest);
+                case 'outdent': return execute('doc.lists.outdent', rest);
+                case 'set_level': return execute('doc.lists.setLevel', rest);
+                case 'set_type': return execute('doc.lists.setType', rest);
+                default: throw new Error(`Unknown action for superdoc_list: ${action}`);
+            }
+        }
+        case 'superdoc_comment': {
+            const { action, ...rest } = args;
+            switch (action) {
+                case 'create': return execute('doc.comments.create', rest);
+                case 'update': return execute('doc.comments.patch', rest);
+                case 'delete': return execute('doc.comments.delete', rest);
+                case 'get': return execute('doc.comments.get', rest);
+                case 'list': return execute('doc.comments.list', rest);
+                default: throw new Error(`Unknown action for superdoc_comment: ${action}`);
+            }
+        }
+        case 'superdoc_track_changes': {
+            const { action, ...rest } = args;
+            switch (action) {
+                case 'list': return execute('doc.trackChanges.list', rest);
+                case 'decide': return execute('doc.trackChanges.decide', rest);
+                default: throw new Error(`Unknown action for superdoc_track_changes: ${action}`);
+            }
+        }
+        case 'superdoc_search':
+            return execute('doc.query.match', args);
+        case 'superdoc_mutations': {
+            const { action, ...rest } = args;
+            switch (action) {
+                case 'preview': return execute('doc.mutations.preview', rest);
+                case 'apply': return execute('doc.mutations.apply', rest);
+                default: throw new Error(`Unknown action for superdoc_mutations: ${action}`);
+            }
+        }
+        default:
+            throw new Error(`Unknown intent tool: ${toolName}`);
+    }
+}
+
+exports.dispatchIntentTool = dispatchIntentTool;

package/dist/generated/intent-dispatch.generated.d.ts

@@ -0,0 +1,2 @@
+export declare function dispatchIntentTool(toolName: string, args: Record<string, unknown>, execute: (operationId: string, input: Record<string, unknown>) => unknown): unknown;
+//# sourceMappingURL=intent-dispatch.generated.d.ts.map

package/dist/generated/intent-dispatch.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-dispatch.generated.d.ts","sourceRoot":"","sources":["../../src/generated/intent-dispatch.generated.ts"],"names":[],"mappings":"AAEA,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,GACxE,OAAO,CAuFT"}

package/dist/generated/intent-dispatch.generated.js

@@ -0,0 +1,89 @@
+// Auto-generated by generate-intent-tools.mjs — do not edit
+export function dispatchIntentTool(toolName, args, execute) {
+    switch (toolName) {
+        case 'superdoc_get_content': {
+            const { action, ...rest } = args;
+            switch (action) {
+                case 'text': return execute('doc.getText', rest);
+                case 'markdown': return execute('doc.getMarkdown', rest);
+                case 'html': return execute('doc.getHtml', rest);
+                case 'info': return execute('doc.info', rest);
+                default: throw new Error(`Unknown action for superdoc_get_content: ${action}`);
+            }
+        }
+        case 'superdoc_edit': {
+            const { action, ...rest } = args;
+            switch (action) {
+                case 'insert': return execute('doc.insert', rest);
+                case 'replace': return execute('doc.replace', rest);
+                case 'delete': return execute('doc.delete', rest);
+                case 'undo': return execute('doc.history.undo', rest);
+                case 'redo': return execute('doc.history.redo', rest);
+                default: throw new Error(`Unknown action for superdoc_edit: ${action}`);
+            }
+        }
+        case 'superdoc_format': {
+            const { action, ...rest } = args;
+            switch (action) {
+                case 'inline': return execute('doc.format.apply', rest);
+                case 'set_style': return execute('doc.styles.paragraph.setStyle', rest);
+                case 'set_alignment': return execute('doc.format.paragraph.setAlignment', rest);
+                case 'set_indentation': return execute('doc.format.paragraph.setIndentation', rest);
+                case 'set_spacing': return execute('doc.format.paragraph.setSpacing', rest);
+                default: throw new Error(`Unknown action for superdoc_format: ${action}`);
+            }
+        }
+        case 'superdoc_create': {
+            const { action, ...rest } = args;
+            switch (action) {
+                case 'paragraph': return execute('doc.create.paragraph', rest);
+                case 'heading': return execute('doc.create.heading', rest);
+                default: throw new Error(`Unknown action for superdoc_create: ${action}`);
+            }
+        }
+        case 'superdoc_list': {
+            const { action, ...rest } = args;
+            switch (action) {
+                case 'insert': return execute('doc.lists.insert', rest);
+                case 'create': return execute('doc.lists.create', rest);
+                case 'detach': return execute('doc.lists.detach', rest);
+                case 'indent': return execute('doc.lists.indent', rest);
+                case 'outdent': return execute('doc.lists.outdent', rest);
+                case 'set_level': return execute('doc.lists.setLevel', rest);
+                case 'set_type': return execute('doc.lists.setType', rest);
+                default: throw new Error(`Unknown action for superdoc_list: ${action}`);
+            }
+        }
+        case 'superdoc_comment': {
+            const { action, ...rest } = args;
+            switch (action) {
+                case 'create': return execute('doc.comments.create', rest);
+                case 'update': return execute('doc.comments.patch', rest);
+                case 'delete': return execute('doc.comments.delete', rest);
+                case 'get': return execute('doc.comments.get', rest);
+                case 'list': return execute('doc.comments.list', rest);
+                default: throw new Error(`Unknown action for superdoc_comment: ${action}`);
+            }
+        }
+        case 'superdoc_track_changes': {
+            const { action, ...rest } = args;
+            switch (action) {
+                case 'list': return execute('doc.trackChanges.list', rest);
+                case 'decide': return execute('doc.trackChanges.decide', rest);
+                default: throw new Error(`Unknown action for superdoc_track_changes: ${action}`);
+            }
+        }
+        case 'superdoc_search':
+            return execute('doc.query.match', args);
+        case 'superdoc_mutations': {
+            const { action, ...rest } = args;
+            switch (action) {
+                case 'preview': return execute('doc.mutations.preview', rest);
+                case 'apply': return execute('doc.mutations.apply', rest);
+                default: throw new Error(`Unknown action for superdoc_mutations: ${action}`);
+            }
+        }
+        default:
+            throw new Error(`Unknown intent tool: ${toolName}`);
+    }
+}

package/dist/index.cjs

@@ -4,6 +4,7 @@ var client = require('./generated/client.cjs');
 var process = require('./runtime/process.cjs');
 var skills = require('./skills.cjs');
 var tools = require('./tools.cjs');
+var intentDispatch_generated = require('./generated/intent-dispatch.generated.cjs');
 var errors = require('./runtime/errors.cjs');
 
 /**
@@ -36,10 +37,10 @@ exports.installSkill = skills.installSkill;
 exports.listSkills = skills.listSkills;
 exports.chooseTools = tools.chooseTools;
 exports.dispatchSuperDocTool = tools.dispatchSuperDocTool;
-exports.getAvailableGroups = tools.getAvailableGroups;
+exports.getSystemPrompt = tools.getSystemPrompt;
 exports.getToolCatalog = tools.getToolCatalog;
 exports.listTools = tools.listTools;
-exports.resolveToolOperation = tools.resolveToolOperation;
+exports.dispatchIntentTool = intentDispatch_generated.dispatchIntentTool;
 exports.SuperDocCliError = errors.SuperDocCliError;
 exports.SuperDocClient = SuperDocClient;
 exports.createSuperDocClient = createSuperDocClient;

package/dist/index.d.ts

@@ -16,8 +16,9 @@ export declare class SuperDocClient {
 }
 export declare function createSuperDocClient(options?: SuperDocClientOptions): SuperDocClient;
 export { getSkill, installSkill, listSkills } from './skills.js';
-export { chooseTools, dispatchSuperDocTool, getAvailableGroups, getToolCatalog, listTools, resolveToolOperation, } from './tools.js';
+export { chooseTools, dispatchSuperDocTool, getSystemPrompt, getToolCatalog, listTools } from './tools.js';
+export { dispatchIntentTool } from './generated/intent-dispatch.generated.js';
 export { SuperDocCliError } from './runtime/errors.js';
 export type { InvokeOptions, OperationSpec, OperationParamSpec, SuperDocClientOptions } from './runtime/process.js';
-export type { ToolChooserInput, ToolChooserMode, ToolGroup, ToolProvider } from './tools.js';
+export type { ToolChooserInput, ToolProvider } from './tools.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAmB,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAEnF;;;;;;GAMG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;gBAElC,OAAO,GAAE,qBAA0B;IAKzC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B;AAED,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,cAAc,CAExF;AAED,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,SAAS,EACT,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACpH,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAmB,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAEnF;;;;;;GAMG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;gBAElC,OAAO,GAAE,qBAA0B;IAKzC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B;AAED,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,cAAc,CAExF;AAED,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,eAAe,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC3G,OAAO,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACpH,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -25,5 +25,6 @@ export function createSuperDocClient(options = {}) {
     return new SuperDocClient(options);
 }
 export { getSkill, installSkill, listSkills } from './skills.js';
-export { chooseTools, dispatchSuperDocTool, getAvailableGroups, getToolCatalog, listTools, resolveToolOperation, } from './tools.js';
+export { chooseTools, dispatchSuperDocTool, getSystemPrompt, getToolCatalog, listTools } from './tools.js';
+export { dispatchIntentTool } from './generated/intent-dispatch.generated.js';
 export { SuperDocCliError } from './runtime/errors.js';

package/dist/tools.cjs

@@ -1,11 +1,10 @@
 'use strict';
 
 var promises = require('node:fs/promises');
-var node_fs = require('node:fs');
 var path = require('node:path');
 var node_url = require('node:url');
-var contract = require('./generated/contract.cjs');
 var errors = require('./runtime/errors.cjs');
+var intentDispatch_generated = require('./generated/intent-dispatch.generated.cjs');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 // Resolve tools directory relative to package root (works from both src/ and dist/)
@@ -16,37 +15,9 @@ const providerFileByName = {
     vercel: 'tools.vercel.json',
     generic: 'tools.generic.json',
 };
-let _policyCache = null;
-function loadPolicy() {
-    if (_policyCache)
-        return _policyCache;
-    const raw = node_fs.readFileSync(path.join(toolsDir, 'tools-policy.json'), 'utf8');
-    _policyCache = JSON.parse(raw);
-    return _policyCache;
-}
 function isRecord(value) {
     return typeof value === 'object' && value != null && !Array.isArray(value);
 }
-function isPresent(value) {
-    if (value == null)
-        return false;
-    if (Array.isArray(value))
-        return value.length > 0;
-    return true;
-}
-function extractProviderToolName(tool) {
-    // Anthropic / Generic: top-level name
-    if (typeof tool.name === 'string')
-        return tool.name;
-    // OpenAI / Vercel: nested under function.name
-    if (isRecord(tool.function) && typeof tool.function.name === 'string') {
-        return tool.function.name;
-    }
-    return null;
-}
-function invalidArgument(message, details) {
-    throw new errors.SuperDocCliError(message, { code: 'INVALID_ARGUMENT', details });
-}
 async function readJson(fileName) {
     const filePath = path.join(toolsDir, fileName);
     let raw = '';
@@ -78,87 +49,43 @@ async function readJson(fileName) {
 async function loadProviderBundle(provider) {
     return readJson(providerFileByName[provider]);
 }
-async function loadToolNameMap() {
-    return readJson('tool-name-map.json');
-}
 async function loadCatalog() {
     return readJson('catalog.json');
 }
-/** All available tool groups from the policy. */
-function getAvailableGroups() {
-    const policy = loadPolicy();
-    return policy.groups;
+async function getToolCatalog() {
+    return loadCatalog();
 }
-const OPERATION_INDEX = Object.fromEntries(Object.entries(contract.CONTRACT.operations).map(([id, op]) => [id, op]));
-function validateDispatchArgs(operationId, args) {
-    const operation = OPERATION_INDEX[operationId];
-    if (!operation) {
-        invalidArgument(`Unknown operation id ${operationId}.`);
-    }
-    // Unknown-param rejection
-    const allowedParams = new Set(operation.params.map((param) => String(param.name)));
-    for (const key of Object.keys(args)) {
-        if (!allowedParams.has(key)) {
-            invalidArgument(`Unexpected parameter ${key} for ${operationId}.`);
-        }
-    }
-    // Required-param enforcement
-    for (const param of operation.params) {
-        if ('required' in param && Boolean(param.required) && args[param.name] == null) {
-            invalidArgument(`Missing required parameter ${param.name} for ${operationId}.`);
-        }
-    }
-    // Constraint validation (CLI handles schema-level type validation authoritatively)
-    const constraints = 'constraints' in operation ? operation.constraints : undefined;
-    if (!constraints || !isRecord(constraints))
-        return;
-    const mutuallyExclusive = Array.isArray(constraints.mutuallyExclusive) ? constraints.mutuallyExclusive : [];
-    const requiresOneOf = Array.isArray(constraints.requiresOneOf) ? constraints.requiresOneOf : [];
-    const requiredWhen = Array.isArray(constraints.requiredWhen) ? constraints.requiredWhen : [];
-    for (const group of mutuallyExclusive) {
-        if (!Array.isArray(group))
-            continue;
-        const present = group.filter((name) => isPresent(args[name]));
-        if (present.length > 1) {
-            invalidArgument(`Arguments are mutually exclusive for ${operationId}: ${group.join(', ')}`, {
-                operationId,
-                group,
-            });
-        }
-    }
-    for (const group of requiresOneOf) {
-        if (!Array.isArray(group))
-            continue;
-        const hasAny = group.some((name) => isPresent(args[name]));
-        if (!hasAny) {
-            invalidArgument(`One of the following arguments is required for ${operationId}: ${group.join(', ')}`, {
-                operationId,
-                group,
-            });
-        }
-    }
-    for (const rule of requiredWhen) {
-        if (!isRecord(rule))
-            continue;
-        const whenValue = args[rule.whenParam];
-        let shouldRequire = false;
-        if (Object.prototype.hasOwnProperty.call(rule, 'equals')) {
-            shouldRequire = whenValue === rule.equals;
-        }
-        else if (Object.prototype.hasOwnProperty.call(rule, 'present')) {
-            const present = rule.present === true;
-            shouldRequire = present ? isPresent(whenValue) : !isPresent(whenValue);
-        }
-        else {
-            shouldRequire = isPresent(whenValue);
-        }
-        if (shouldRequire && !isPresent(args[rule.param])) {
-            invalidArgument(`Argument ${rule.param} is required by constraints for ${operationId}.`, {
-                operationId,
-                rule,
-            });
-        }
+async function listTools(provider) {
+    const bundle = await loadProviderBundle(provider);
+    const tools = bundle.tools;
+    if (!Array.isArray(tools)) {
+        throw new errors.SuperDocCliError('Tool provider bundle is missing tools array.', {
+            code: 'TOOLS_ASSET_INVALID',
+            details: { provider },
+        });
     }
+    return tools;
+}
+/**
+ * Select all intent tools for a specific provider.
+ *
+ * Returns all intent tools in the requested provider format.
+ *
+ * @example
+ * ```ts
+ * const { tools } = await chooseTools({ provider: 'openai' });
+ * ```
+ */
+async function chooseTools(input) {
+    const bundle = await loadProviderBundle(input.provider);
+    const tools = Array.isArray(bundle.tools) ? bundle.tools : [];
+    return {
+        tools,
+        meta: {
+            provider: input.provider,
+            toolCount: tools.length,
+        },
+    };
 }
 function resolveDocApiMethod(client, operationId) {
     const tokens = operationId.split('.').slice(1);
@@ -180,133 +107,130 @@ function resolveDocApiMethod(client, operationId) {
     }
     return cursor;
 }
-async function getToolCatalog() {
-    return loadCatalog();
-}
-async function listTools(provider) {
-    const bundle = await loadProviderBundle(provider);
-    const tools = bundle.tools;
-    if (!Array.isArray(tools)) {
-        throw new errors.SuperDocCliError('Tool provider bundle is missing tools array.', {
-            code: 'TOOLS_ASSET_INVALID',
-            details: { provider },
-        });
+// Cached catalog instance — loaded once per process.
+let _catalogCache = null;
+async function getCachedCatalog() {
+    if (_catalogCache == null) {
+        _catalogCache = await loadCatalog();
     }
-    return tools;
-}
-async function resolveToolOperation(toolName) {
-    const map = await loadToolNameMap();
-    return typeof map[toolName] === 'string' ? map[toolName] : null;
+    return _catalogCache;
 }
 /**
- * Select tools for a specific provider.
- *
- * **mode='essential'** (default): Returns only essential tools + discover_tools.
- * Pass `groups` to additionally load all tools from those categories.
- *
- * **mode='all'**: Returns all tools from requested groups (or all groups if
- * `groups` is omitted). No discover_tools included by default.
+ * Validate tool arguments against the catalog schema.
  *
- * @example
- * ```ts
- * // Default: 5 essential tools + discover_tools
- * const { tools } = await chooseTools({ provider: 'openai' });
- *
- * // Essential + all comment tools
- * const { tools } = await chooseTools({ provider: 'openai', groups: ['comments'] });
- *
- * // All tools (old behavior)
- * const { tools } = await chooseTools({ provider: 'openai', mode: 'all' });
- * ```
+ * Checks three things in order:
+ * 1. No unknown keys (additionalProperties: false in merged schema)
+ * 2. All universally-required keys present (merged schema `required`)
+ * 3. All action-specific required keys present (per-operation `required`)
  */
-async function chooseTools(input) {
-    const catalog = await loadCatalog();
-    const policy = loadPolicy();
-    const mode = input.mode ?? policy.defaults.mode ?? 'essential';
-    const includeDiscover = input.includeDiscoverTool ?? mode === 'essential';
-    let selected;
-    if (mode === 'essential') {
-        // Essential tools + any explicitly requested groups
-        const essentialNames = new Set(policy.essentialTools ?? []);
-        const requestedGroups = input.groups ? new Set(input.groups) : null;
-        selected = catalog.tools.filter((tool) => {
-            if (essentialNames.has(tool.toolName))
-                return true;
-            if (requestedGroups && requestedGroups.has(tool.category))
-                return true;
-            return false;
+function validateToolArgs(toolName, args, tool) {
+    const schema = tool.inputSchema;
+    const properties = isRecord(schema.properties) ? schema.properties : {};
+    const required = Array.isArray(schema.required) ? schema.required : [];
+    // 1. Reject unknown keys
+    const knownKeys = new Set(Object.keys(properties));
+    const unknownKeys = Object.keys(args).filter((k) => !knownKeys.has(k));
+    if (unknownKeys.length > 0) {
+        throw new errors.SuperDocCliError(`Unknown argument(s) for ${toolName}: ${unknownKeys.join(', ')}`, {
+            code: 'INVALID_ARGUMENT',
+            details: { toolName, unknownKeys, knownKeys: [...knownKeys] },
         });
     }
-    else {
-        // mode='all': original behavior — filter by groups
-        const alwaysInclude = new Set(policy.defaults.alwaysInclude ?? ['core']);
-        let groups;
-        if (input.groups) {
-            groups = new Set([...input.groups, ...alwaysInclude]);
-        }
-        else {
-            groups = new Set(policy.groups);
+    // 2. Reject missing universally-required keys
+    const missingKeys = required.filter((k) => args[k] == null);
+    if (missingKeys.length > 0) {
+        throw new errors.SuperDocCliError(`Missing required argument(s) for ${toolName}: ${missingKeys.join(', ')}`, {
+            code: 'INVALID_ARGUMENT',
+            details: { toolName, missingKeys },
+        });
+    }
+    // 3. Reject missing per-operation required keys.
+    //    For multi-action tools, resolve the operation by action; for single-op
+    //    tools, use the sole operation entry.
+    const action = args.action;
+    let op;
+    if (typeof action === 'string' && tool.operations.length > 1) {
+        op = tool.operations.find((o) => o.intentAction === action);
+    }
+    else if (tool.operations.length === 1) {
+        op = tool.operations[0];
+    }
+    if (op) {
+        validateOperationRequired(toolName, action, args, op);
+    }
+}
+/**
+ * Check per-operation required constraints.
+ *
+ * Handles two shapes emitted by the codegen:
+ *   - `required: string[]`        — all listed keys must be present
+ *   - `requiredOneOf: string[][]`  — at least one branch must be fully satisfied
+ *     (mirrors JSON Schema `oneOf` with per-branch `required` arrays)
+ */
+function validateOperationRequired(toolName, action, args, op) {
+    const actionLabel = typeof action === 'string' ? ` action "${action}"` : '';
+    if (op.requiredOneOf && op.requiredOneOf.length > 0) {
+        const satisfied = op.requiredOneOf.some((branch) => branch.every((k) => args[k] != null));
+        if (!satisfied) {
+            const options = op.requiredOneOf.map((b) => b.join(' + ')).join(' | ');
+            throw new errors.SuperDocCliError(`Missing required argument(s) for ${toolName}${actionLabel}: must provide one of: ${options}`, {
+                code: 'INVALID_ARGUMENT',
+                details: { toolName, action, requiredOneOf: op.requiredOneOf },
+            });
         }
-        selected = catalog.tools.filter((tool) => groups.has(tool.category));
     }
-    // Build provider-formatted tools from the provider bundle
-    const bundle = await loadProviderBundle(input.provider);
-    const providerTools = Array.isArray(bundle.tools) ? bundle.tools : [];
-    const providerIndex = new Map(providerTools
-        .filter((tool) => isRecord(tool))
-        .map((tool) => [extractProviderToolName(tool), tool])
-        .filter((entry) => entry[0] !== null));
-    const selectedProviderTools = selected
-        .map((tool) => providerIndex.get(tool.toolName))
-        .filter((tool) => Boolean(tool));
-    // Append discover_tools if requested
-    if (includeDiscover) {
-        const discoverTool = providerIndex.get('discover_tools');
-        if (discoverTool) {
-            selectedProviderTools.push(discoverTool);
+    else if (op.required && op.required.length > 0) {
+        const missingActionKeys = op.required.filter((k) => args[k] == null);
+        if (missingActionKeys.length > 0) {
+            throw new errors.SuperDocCliError(`Missing required argument(s) for ${toolName}${actionLabel}: ${missingActionKeys.join(', ')}`, {
+                code: 'INVALID_ARGUMENT',
+                details: { toolName, action, missingKeys: missingActionKeys },
+            });
         }
     }
-    const resolvedGroups = mode === 'essential' ? (input.groups ?? []) : (input.groups ?? policy.groups);
-    return {
-        tools: selectedProviderTools,
-        selected: selected.map((tool) => ({
-            operationId: tool.operationId,
-            toolName: tool.toolName,
-            category: tool.category,
-            mutates: tool.mutates,
-        })),
-        meta: {
-            provider: input.provider,
-            mode,
-            groups: [...resolvedGroups],
-            selectedCount: selectedProviderTools.length,
-        },
-    };
 }
 async function dispatchSuperDocTool(client, toolName, args = {}, invokeOptions) {
-    const operationId = await resolveToolOperation(toolName);
-    if (!operationId) {
-        throw new errors.SuperDocCliError(`Unknown SuperDoc tool: ${toolName}`, {
-            code: 'TOOL_NOT_FOUND',
+    if (!isRecord(args)) {
+        throw new errors.SuperDocCliError(`Tool arguments for ${toolName} must be an object.`, {
+            code: 'INVALID_ARGUMENT',
             details: { toolName },
         });
     }
-    if (!isRecord(args)) {
-        invalidArgument(`Tool arguments for ${toolName} must be an object.`);
+    // Validate against the tool schema before dispatch.
+    const catalog = await getCachedCatalog();
+    const tool = catalog.tools.find((t) => t.toolName === toolName);
+    if (tool == null) {
+        throw new errors.SuperDocCliError(`Unknown tool: ${toolName}`, {
+            code: 'TOOL_DISPATCH_NOT_FOUND',
+            details: { toolName },
+        });
     }
+    validateToolArgs(toolName, args, tool);
     // Strip doc/sessionId — the SDK client manages session targeting after doc.open().
-    // Models fill these in because the tool schemas expose them, but passing them
-    // alongside an active session causes "stateless input.doc cannot be combined
-    // with a session target" errors.
     const { doc: _doc, sessionId: _sid, ...cleanArgs } = args;
-    validateDispatchArgs(operationId, cleanArgs);
-    const method = resolveDocApiMethod(client, operationId);
-    return method(cleanArgs, invokeOptions);
+    return intentDispatch_generated.dispatchIntentTool(toolName, cleanArgs, (operationId, input) => {
+        const method = resolveDocApiMethod(client, operationId);
+        return method(input, invokeOptions);
+    });
+}
+/**
+ * Read the bundled system prompt for intent tools.
+ */
+async function getSystemPrompt() {
+    const promptPath = path.join(toolsDir, 'system-prompt.md');
+    try {
+        return await promises.readFile(promptPath, 'utf8');
+    }
+    catch {
+        throw new errors.SuperDocCliError('System prompt not found.', {
+            code: 'TOOLS_ASSET_NOT_FOUND',
+            details: { filePath: promptPath },
+        });
+    }
 }
 
 exports.chooseTools = chooseTools;
 exports.dispatchSuperDocTool = dispatchSuperDocTool;
-exports.getAvailableGroups = getAvailableGroups;
+exports.getSystemPrompt = getSystemPrompt;
 exports.getToolCatalog = getToolCatalog;
 exports.listTools = listTools;
-exports.resolveToolOperation = resolveToolOperation;