@superdoc/sdk 2.12.0 → 2.13.0-next.1

package/dist/agent/actions.cjs

@@ -1133,7 +1133,7 @@ async function runInsertHeading(doc, args) {
         return failedReceipt('insert_heading', err, pre);
     }
 }
-async function runReplaceText(doc, args) {
+async function runReplaceTextUnchecked(doc, args) {
     const selectorDomains = args.selector ? snapshotDomainsForSelector(args.selector) : null;
     const requiresBlockSnapshot = args.selector != null;
     const preIdentity = requiresBlockSnapshot ? null : await readDocumentIdentity(doc);
@@ -1326,6 +1326,13 @@ async function runReplaceText(doc, args) {
         return failedReceipt('replace_text', err, pre);
     }
 }
+async function runReplaceText(doc, args) {
+    const changeMode = args.changeMode ?? 'direct';
+    return {
+        ...(await runReplaceTextUnchecked(doc, { ...args, changeMode })),
+        changeMode,
+    };
+}
 async function runDeleteText(doc, args) {
     const caseSensitive = args.caseSensitive === true;
     // Scoped form: delete finds within ONE block (mirrors replace_text's selector
@@ -4613,7 +4620,7 @@ function compactOpResult(result) {
         compact.stepCount = result.steps.length;
     return compact;
 }
-function parseScopedReplaceArgs(args) {
+function parseScopedReplaceArgs(args, changeMode) {
     if (args.action !== 'replace_text')
         return null;
     if (!isRecord(args.selector))
@@ -4630,7 +4637,7 @@ function parseScopedReplaceArgs(args) {
         edits,
         selector: args.selector,
         caseSensitive: args.caseSensitive === true,
-        changeMode: args.changeMode === 'tracked' ? 'tracked' : 'direct',
+        changeMode,
     };
 }
 async function runScopedReplaceUnchecked(doc, args) {
@@ -4796,11 +4803,15 @@ async function runScopedReplaceUnchecked(doc, args) {
     };
 }
 async function runScopedReplace(doc, args) {
+    const changeMode = args.changeMode ?? 'direct';
     try {
-        return await runScopedReplaceUnchecked(doc, args);
+        return {
+            ...(await runScopedReplaceUnchecked(doc, { ...args, changeMode })),
+            changeMode,
+        };
     }
     catch (error) {
-        return failedReceipt('replace_text', error);
+        return { ...failedReceipt('replace_text', error), changeMode };
     }
 }
 /**
@@ -6526,11 +6537,12 @@ async function dispatchSuperdocPerformAction(doc, args) {
                     code: 'INVALID_ARGUMENT',
                 });
             }
+            const changeMode = parseReplaceTextChangeMode(args.changeMode);
             // Selector-scoped replaces take the span-targeted path: per-find
             // text.rewrite spans inside the one selected block, so tabs/breaks/
             // images outside the spans survive and the receipt reports per-edit
             // applied/skipped truth.
-            const scoped = parseScopedReplaceArgs(args);
+            const scoped = parseScopedReplaceArgs(args, changeMode);
             if (scoped) {
                 return runScopedReplace(doc, scoped);
             }
@@ -6543,7 +6555,7 @@ async function dispatchSuperdocPerformAction(doc, args) {
                 edits,
                 selector,
                 caseSensitive: args.caseSensitive === true,
-                changeMode: parseChangeMode(args.changeMode),
+                changeMode,
             });
         }
         case 'delete_text': {
@@ -7171,6 +7183,17 @@ function parseChangeMode(value) {
         return value;
     return undefined;
 }
+function parseReplaceTextChangeMode(value) {
+    if (value === undefined)
+        return 'direct';
+    const changeMode = parseChangeMode(value);
+    if (changeMode)
+        return changeMode;
+    throw new errors.SuperDocCliError('replace_text: "changeMode" must be "direct" or "tracked"', {
+        code: 'INVALID_ARGUMENT',
+        details: { changeMode: value },
+    });
+}
 function parseTrackedChangeKind(value) {
     if (value === 'insert' || value === 'delete' || value === 'replacement' || value === 'format')
         return value;

package/dist/agent/actions.js

@@ -1130,7 +1130,7 @@ async function runInsertHeading(doc, args) {
         return failedReceipt('insert_heading', err, pre);
     }
 }
-async function runReplaceText(doc, args) {
+async function runReplaceTextUnchecked(doc, args) {
     const selectorDomains = args.selector ? snapshotDomainsForSelector(args.selector) : null;
     const requiresBlockSnapshot = args.selector != null;
     const preIdentity = requiresBlockSnapshot ? null : await readDocumentIdentity(doc);
@@ -1323,6 +1323,13 @@ async function runReplaceText(doc, args) {
         return failedReceipt('replace_text', err, pre);
     }
 }
+async function runReplaceText(doc, args) {
+    const changeMode = args.changeMode ?? 'direct';
+    return {
+        ...(await runReplaceTextUnchecked(doc, { ...args, changeMode })),
+        changeMode,
+    };
+}
 async function runDeleteText(doc, args) {
     const caseSensitive = args.caseSensitive === true;
     // Scoped form: delete finds within ONE block (mirrors replace_text's selector
@@ -4610,7 +4617,7 @@ function compactOpResult(result) {
         compact.stepCount = result.steps.length;
     return compact;
 }
-function parseScopedReplaceArgs(args) {
+function parseScopedReplaceArgs(args, changeMode) {
     if (args.action !== 'replace_text')
         return null;
     if (!isRecord(args.selector))
@@ -4627,7 +4634,7 @@ function parseScopedReplaceArgs(args) {
         edits,
         selector: args.selector,
         caseSensitive: args.caseSensitive === true,
-        changeMode: args.changeMode === 'tracked' ? 'tracked' : 'direct',
+        changeMode,
     };
 }
 async function runScopedReplaceUnchecked(doc, args) {
@@ -4793,11 +4800,15 @@ async function runScopedReplaceUnchecked(doc, args) {
     };
 }
 async function runScopedReplace(doc, args) {
+    const changeMode = args.changeMode ?? 'direct';
     try {
-        return await runScopedReplaceUnchecked(doc, args);
+        return {
+            ...(await runScopedReplaceUnchecked(doc, { ...args, changeMode })),
+            changeMode,
+        };
     }
     catch (error) {
-        return failedReceipt('replace_text', error);
+        return { ...failedReceipt('replace_text', error), changeMode };
     }
 }
 /**
@@ -6523,11 +6534,12 @@ async function dispatchSuperdocPerformAction(doc, args) {
                     code: 'INVALID_ARGUMENT',
                 });
             }
+            const changeMode = parseReplaceTextChangeMode(args.changeMode);
             // Selector-scoped replaces take the span-targeted path: per-find
             // text.rewrite spans inside the one selected block, so tabs/breaks/
             // images outside the spans survive and the receipt reports per-edit
             // applied/skipped truth.
-            const scoped = parseScopedReplaceArgs(args);
+            const scoped = parseScopedReplaceArgs(args, changeMode);
             if (scoped) {
                 return runScopedReplace(doc, scoped);
             }
@@ -6540,7 +6552,7 @@ async function dispatchSuperdocPerformAction(doc, args) {
                 edits,
                 selector,
                 caseSensitive: args.caseSensitive === true,
-                changeMode: parseChangeMode(args.changeMode),
+                changeMode,
             });
         }
         case 'delete_text': {
@@ -7170,6 +7182,17 @@ function parseChangeMode(value) {
         return value;
     return undefined;
 }
+function parseReplaceTextChangeMode(value) {
+    if (value === undefined)
+        return 'direct';
+    const changeMode = parseChangeMode(value);
+    if (changeMode)
+        return changeMode;
+    throw new SuperDocCliError('replace_text: "changeMode" must be "direct" or "tracked"', {
+        code: 'INVALID_ARGUMENT',
+        details: { changeMode: value },
+    });
+}
 function parseTrackedChangeKind(value) {
     if (value === 'insert' || value === 'delete' || value === 'replacement' || value === 'format')
         return value;