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

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

@@ -0,0 +1,94 @@
+'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);
+                case 'set_direction': return execute('doc.format.paragraph.setDirection', 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,CAwFT"}

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

@@ -0,0 +1,90 @@
+// 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);
+                case 'set_direction': return execute('doc.format.paragraph.setDirection', 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.getSystemPrompt = tools.getSystemPrompt;
 exports.getToolCatalog = tools.getToolCatalog;
-exports.inferDocumentFeatures = tools.inferDocumentFeatures;
 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, getToolCatalog, inferDocumentFeatures, 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 { DocumentFeatures, ToolChooserInput, ToolPhase, ToolProfile, 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,cAAc,EACd,qBAAqB,EACrB,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,gBAAgB,EAAE,SAAS,EAAE,WAAW,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, getToolCatalog, inferDocumentFeatures, 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/runtime/transport-common.cjs

@@ -35,6 +35,14 @@ function buildOperationArgv(operation, params, options, runtimeTimeoutMs, defaul
             normalizedParams = { ...normalizedParams, userEmail: user.email };
         }
     }
+    // Legacy alias: tables.split renamed atRowIndex → rowIndex (SD-2132).
+    if (operation.operationId === 'doc.tables.split' && normalizedParams.atRowIndex !== undefined) {
+        if (normalizedParams.rowIndex !== undefined && normalizedParams.rowIndex !== normalizedParams.atRowIndex) {
+            throw new Error('tables.split: cannot provide both rowIndex and atRowIndex with different values.');
+        }
+        const { atRowIndex, ...rest } = normalizedParams;
+        normalizedParams = { ...rest, rowIndex: atRowIndex };
+    }
     const argv = [...operation.commandTokens];
     for (const spec of operation.params) {
         const value = normalizedParams[spec.name];
@@ -61,6 +69,8 @@ function buildOperationArgv(operation, params, options, runtimeTimeoutMs, defaul
                 }
                 break;
             case 'jsonFlag':
+                // CLI always parses --*-json values via JSON.parse, so even scalar
+                // strings must be serialized as JSON string literals.
                 argv.push(flag, JSON.stringify(value));
                 break;
         }

package/dist/runtime/transport-common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport-common.d.ts","sourceRoot":"","sources":["../../src/runtime/transport-common.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAC9E,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE9C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAC/B,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAMD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAU/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,aAAa,EACtB,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,iBAAiB,CAAC,EAAE,UAAU,EAC9B,IAAI,CAAC,EAAE,YAAY,GAClB,MAAM,EAAE,CAsDV"}
+{"version":3,"file":"transport-common.d.ts","sourceRoot":"","sources":["../../src/runtime/transport-common.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAC9E,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE9C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAC/B,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAMD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAU/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,aAAa,EACtB,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,iBAAiB,CAAC,EAAE,UAAU,EAC9B,IAAI,CAAC,EAAE,YAAY,GAClB,MAAM,EAAE,CAiEV"}

package/dist/runtime/transport-common.js

@@ -33,6 +33,14 @@ export function buildOperationArgv(operation, params, options, runtimeTimeoutMs,
             normalizedParams = { ...normalizedParams, userEmail: user.email };
         }
     }
+    // Legacy alias: tables.split renamed atRowIndex → rowIndex (SD-2132).
+    if (operation.operationId === 'doc.tables.split' && normalizedParams.atRowIndex !== undefined) {
+        if (normalizedParams.rowIndex !== undefined && normalizedParams.rowIndex !== normalizedParams.atRowIndex) {
+            throw new Error('tables.split: cannot provide both rowIndex and atRowIndex with different values.');
+        }
+        const { atRowIndex, ...rest } = normalizedParams;
+        normalizedParams = { ...rest, rowIndex: atRowIndex };
+    }
     const argv = [...operation.commandTokens];
     for (const spec of operation.params) {
         const value = normalizedParams[spec.name];
@@ -59,6 +67,8 @@ export function buildOperationArgv(operation, params, options, runtimeTimeoutMs,
                 }
                 break;
             case 'jsonFlag':
+                // CLI always parses --*-json values via JSON.parse, so even scalar
+                // strings must be serialized as JSON string literals.
                 argv.push(flag, JSON.stringify(value));
                 break;
         }