@superdoc/sdk 2.25.0-next.9 → 2.26.0-next.1

package/dist/presets/core.cjs

@@ -8,6 +8,8 @@ var debugTrace = require('../runtime/debug-trace.cjs');
 var catalog = require('../agent/catalog.cjs');
 var runtime = require('../agent/runtime.cjs');
 var actions = require('../agent/actions.cjs');
+var actionChangeMode = require('../agent/action-change-mode.cjs');
+var executionContext = require('../agent/execution-context.cjs');
 var embeddedPrompts_generated = require('../embedded-prompts.generated.cjs');
 var guards = require('../guards.cjs');
 
@@ -87,9 +89,14 @@ function stripCorruptedToolArgKeys(value) {
         return value;
     const clean = {};
     for (const [key, entryValue] of Object.entries(value)) {
-        if (key === '__proto__' || isObviouslyCorruptedToolArgKey(key))
+        if (isObviouslyCorruptedToolArgKey(key))
             continue;
-        clean[key] = stripCorruptedToolArgKeys(entryValue);
+        Object.defineProperty(clean, key, {
+            value: stripCorruptedToolArgKeys(entryValue),
+            enumerable: true,
+            configurable: true,
+            writable: true,
+        });
     }
     return clean;
 }
@@ -364,6 +371,12 @@ async function dispatchAgentToolInner(documentHandle, toolName, args, invokeOpti
                     actions.ACTION_ARGS[args.action].includes('changeMode')
                     ? { changeMode: invokeOptions.changeMode }
                     : {}),
+                ...(args.expectedRevision === undefined &&
+                    invokeOptions?.expectedRevision != null &&
+                    actions.isActionName(args.action) &&
+                    actions.ACTION_ARGS[args.action].includes('expectedRevision')
+                    ? { expectedRevision: String(invokeOptions.expectedRevision) }
+                    : {}),
             }));
         case 'superdoc_execute_code':
             return dispatchExecuteCode(documentHandle, args, invokeOptions);
@@ -529,6 +542,32 @@ const ENFORCEMENT_SIDE_DOORS = new Set([
     'superdoc_execute_code',
 ]);
 const POLICY_OPTION_KEYS = ['excludeActions', 'enforceChangeMode', 'allowDirectActions'];
+async function fenceExpectedRevision(documentHandle, toolName, dispatchArgs, forwardOptions) {
+    const performsAction = toolName === 'superdoc_perform_action';
+    const inputRevision = performsAction ? dispatchArgs.expectedRevision : undefined;
+    const requestedRevision = inputRevision === undefined ? (forwardOptions?.expectedRevision ?? undefined) : inputRevision;
+    if (requestedRevision === undefined)
+        return { document: documentHandle };
+    const expectedRevision = typeof requestedRevision === 'string' && requestedRevision.length > 0
+        ? requestedRevision
+        : inputRevision === undefined &&
+            typeof requestedRevision === 'number' &&
+            Number.isSafeInteger(requestedRevision) &&
+            requestedRevision >= 0
+            ? String(requestedRevision)
+            : undefined;
+    if (expectedRevision === undefined)
+        throw new errors.SuperDocCliError('expectedRevision must be a non-empty live revision or a non-negative safe integer.', {
+            code: 'INVALID_ARGUMENT',
+        });
+    const liveRevision = await executionContext.readPublicRevision(documentHandle);
+    if (performsAction && expectedRevision !== liveRevision) {
+        const action = typeof dispatchArgs.action === 'string' ? dispatchArgs.action : toolName;
+        return { staleReceipt: actions.staleActionRevisionReceipt(action, liveRevision) };
+    }
+    actions.assertExpectedActionRevision(expectedRevision, liveRevision, toolName);
+    return { document: actionChangeMode.bindActionExpectedRevision(documentHandle, expectedRevision) };
+}
 async function coreDispatch(documentHandle, toolName, args, invokeOptions) {
     if (!guards.isRecord(args)) {
         throw new errors.SuperDocCliError(`Tool arguments for ${toolName} must be an object.`, {
@@ -598,7 +637,16 @@ async function coreDispatch(documentHandle, toolName, args, invokeOptions) {
     }
     if (catalog.isAgentToolName(toolName)) {
         validateAgentToolArgs(toolName, dispatchArgs);
-        const result = await dispatchAgentTool(documentHandle, toolName, dispatchArgs, forwardOptions);
+        if (forwardOptions?.dryRun === true) {
+            throw new errors.SuperDocCliError('The core preset dispatcher does not support dryRun previews.', {
+                code: 'CAPABILITY_UNSUPPORTED',
+                details: { toolName, preset: 'core', dryRun: true },
+            });
+        }
+        const fence = await fenceExpectedRevision(documentHandle, toolName, dispatchArgs, forwardOptions);
+        const result = 'staleReceipt' in fence
+            ? fence.staleReceipt
+            : await dispatchAgentTool(fence.document, toolName, dispatchArgs, forwardOptions);
         if (enforcing && toolName === 'superdoc_perform_action' && guards.isRecord(result)) {
             // Receipts under enforcement state the mode that actually ran, so a host
             // can audit "was this edit tracked?" without re-deriving the policy.

package/dist/presets/core.js

@@ -20,7 +20,9 @@ import { SuperDocCliError } from '../runtime/errors.js';
 import { writeSdkDebugTrace } from '../runtime/debug-trace.js';
 import { AGENT_TOOL_DEFINITIONS, isAgentToolName, listAgentTools, resolveActionPolicy, PUBLIC_AGENT_TOOL_NAMES, } from '../agent/catalog.js';
 import { agentApply, agentInspect, agentOperation, agentVerify } from '../agent/runtime.js';
-import { ACTION_ARGS, ACTION_DISPOSITIONS, isActionName, superdocPerformAction } from '../agent/actions.js';
+import { ACTION_ARGS, ACTION_DISPOSITIONS, assertExpectedActionRevision, isActionName, staleActionRevisionReceipt, superdocPerformAction, } from '../agent/actions.js';
+import { bindActionExpectedRevision } from '../agent/action-change-mode.js';
+import { readPublicRevision } from '../agent/execution-context.js';
 import { EMBEDDED_PROMPTS } from '../embedded-prompts.generated.js';
 import { isRecord } from '../guards.js';
 // Prompts ship as <dist>/prompts/*.md. Resolve relative to the compiled
@@ -83,9 +85,14 @@ export function stripCorruptedToolArgKeys(value) {
         return value;
     const clean = {};
     for (const [key, entryValue] of Object.entries(value)) {
-        if (key === '__proto__' || isObviouslyCorruptedToolArgKey(key))
+        if (isObviouslyCorruptedToolArgKey(key))
             continue;
-        clean[key] = stripCorruptedToolArgKeys(entryValue);
+        Object.defineProperty(clean, key, {
+            value: stripCorruptedToolArgKeys(entryValue),
+            enumerable: true,
+            configurable: true,
+            writable: true,
+        });
     }
     return clean;
 }
@@ -360,6 +367,12 @@ async function dispatchAgentToolInner(documentHandle, toolName, args, invokeOpti
                     ACTION_ARGS[args.action].includes('changeMode')
                     ? { changeMode: invokeOptions.changeMode }
                     : {}),
+                ...(args.expectedRevision === undefined &&
+                    invokeOptions?.expectedRevision != null &&
+                    isActionName(args.action) &&
+                    ACTION_ARGS[args.action].includes('expectedRevision')
+                    ? { expectedRevision: String(invokeOptions.expectedRevision) }
+                    : {}),
             }));
         case 'superdoc_execute_code':
             return dispatchExecuteCode(documentHandle, args, invokeOptions);
@@ -525,6 +538,32 @@ const ENFORCEMENT_SIDE_DOORS = new Set([
     'superdoc_execute_code',
 ]);
 const POLICY_OPTION_KEYS = ['excludeActions', 'enforceChangeMode', 'allowDirectActions'];
+async function fenceExpectedRevision(documentHandle, toolName, dispatchArgs, forwardOptions) {
+    const performsAction = toolName === 'superdoc_perform_action';
+    const inputRevision = performsAction ? dispatchArgs.expectedRevision : undefined;
+    const requestedRevision = inputRevision === undefined ? (forwardOptions?.expectedRevision ?? undefined) : inputRevision;
+    if (requestedRevision === undefined)
+        return { document: documentHandle };
+    const expectedRevision = typeof requestedRevision === 'string' && requestedRevision.length > 0
+        ? requestedRevision
+        : inputRevision === undefined &&
+            typeof requestedRevision === 'number' &&
+            Number.isSafeInteger(requestedRevision) &&
+            requestedRevision >= 0
+            ? String(requestedRevision)
+            : undefined;
+    if (expectedRevision === undefined)
+        throw new SuperDocCliError('expectedRevision must be a non-empty live revision or a non-negative safe integer.', {
+            code: 'INVALID_ARGUMENT',
+        });
+    const liveRevision = await readPublicRevision(documentHandle);
+    if (performsAction && expectedRevision !== liveRevision) {
+        const action = typeof dispatchArgs.action === 'string' ? dispatchArgs.action : toolName;
+        return { staleReceipt: staleActionRevisionReceipt(action, liveRevision) };
+    }
+    assertExpectedActionRevision(expectedRevision, liveRevision, toolName);
+    return { document: bindActionExpectedRevision(documentHandle, expectedRevision) };
+}
 async function coreDispatch(documentHandle, toolName, args, invokeOptions) {
     if (!isRecord(args)) {
         throw new SuperDocCliError(`Tool arguments for ${toolName} must be an object.`, {
@@ -594,7 +633,16 @@ async function coreDispatch(documentHandle, toolName, args, invokeOptions) {
     }
     if (isAgentToolName(toolName)) {
         validateAgentToolArgs(toolName, dispatchArgs);
-        const result = await dispatchAgentTool(documentHandle, toolName, dispatchArgs, forwardOptions);
+        if (forwardOptions?.dryRun === true) {
+            throw new SuperDocCliError('The core preset dispatcher does not support dryRun previews.', {
+                code: 'CAPABILITY_UNSUPPORTED',
+                details: { toolName, preset: 'core', dryRun: true },
+            });
+        }
+        const fence = await fenceExpectedRevision(documentHandle, toolName, dispatchArgs, forwardOptions);
+        const result = 'staleReceipt' in fence
+            ? fence.staleReceipt
+            : await dispatchAgentTool(fence.document, toolName, dispatchArgs, forwardOptions);
         if (enforcing && toolName === 'superdoc_perform_action' && isRecord(result)) {
             // Receipts under enforcement state the mode that actually ran, so a host
             // can audit "was this edit tracked?" without re-deriving the policy.

package/dist/presets/full.cjs

@@ -250,6 +250,12 @@ function forwardOptions(invokeOptions) {
     const { excludeActions: _ignored, ...rest } = invokeOptions;
     return rest;
 }
+function operationInvokeOptions(operationId, options) {
+    if (!options || contract.CONTRACT.operations[operationId]?.mutates !== false)
+        return options;
+    const { changeMode: _changeMode, dryRun: _dryRun, ...readOptions } = options;
+    return readOptions;
+}
 function resolveMethod(doc, operationId) {
     const tokens = operationId.split('.').slice(1);
     let cursor = doc;
@@ -271,7 +277,7 @@ function resolveMethod(doc, operationId) {
         });
     }
     const method = cursor;
-    return (args, options) => method(enforceTrackedChangeMode(operationId, args, trackedEnforcementOf(options)).args, options);
+    return (args, options) => method(enforceTrackedChangeMode(operationId, args, trackedEnforcementOf(options)).args, operationInvokeOptions(operationId, options));
 }
 function trackedEnforcementOf(options) {
     if (!guards.isRecord(options) || options.enforceChangeMode !== 'tracked')
@@ -1633,6 +1639,16 @@ async function fullDispatch(includeExec, documentHandle, toolName, args, invokeO
             details: { toolName },
         });
     }
+    if (invokeOptions?.dryRun === true &&
+        (FULL_ONLY_TOOL_NAMES.has(toolName) ||
+            (toolName === 'superdoc_perform_action' &&
+                typeof args.action === 'string' &&
+                Object.hasOwn(HELPER_ACTIONS, args.action)))) {
+        throw new errors.SuperDocCliError('The full preset dispatcher does not support dryRun previews. Use a supported per-call dryRun instead.', {
+            code: 'CAPABILITY_UNSUPPORTED',
+            details: { toolName, preset: 'full', dryRun: true },
+        });
+    }
     if (!includeExec && toolName === 'superdoc_execute_code') {
         throw new errors.SuperDocCliError('superdoc_execute_code is disabled in the full preset. Use superdoc_api_call (a {calls:[…]} batch covers multi-step edits).', { code: 'TOOL_DISPATCH_NOT_FOUND', details: { toolName, preset: 'full' } });
     }
@@ -1648,6 +1664,12 @@ async function fullDispatch(includeExec, documentHandle, toolName, args, invokeO
         if (args.dryRun !== undefined && args.dryRun !== false) {
             throw new errors.SuperDocCliError(`Action ${args.action} has no dry run and would edit the document. Nothing was changed. Describe the planned change instead, or call it without dryRun.`, { code: 'INVALID_ARGUMENT', details: { action: args.action, supportsDryRun: false } });
         }
+        if (Object.hasOwn(HELPER_ACTIONS, args.action) && Object.hasOwn(args, 'expectedRevision')) {
+            throw new errors.SuperDocCliError(`Action ${args.action} cannot enforce args.expectedRevision. Nothing was changed.`, {
+                code: 'CAPABILITY_UNSUPPORTED',
+                details: { toolName, preset: 'full', action: args.action, feature: 'preset.full.helper.expectedRevision' },
+            });
+        }
         return runHelperAction(documentHandle, args.action, args, invokeOptions);
     }
     if (!FULL_ONLY_TOOL_NAMES.has(toolName)) {

package/dist/presets/full.js

@@ -247,6 +247,12 @@ function forwardOptions(invokeOptions) {
     const { excludeActions: _ignored, ...rest } = invokeOptions;
     return rest;
 }
+function operationInvokeOptions(operationId, options) {
+    if (!options || CONTRACT.operations[operationId]?.mutates !== false)
+        return options;
+    const { changeMode: _changeMode, dryRun: _dryRun, ...readOptions } = options;
+    return readOptions;
+}
 function resolveMethod(doc, operationId) {
     const tokens = operationId.split('.').slice(1);
     let cursor = doc;
@@ -268,7 +274,7 @@ function resolveMethod(doc, operationId) {
         });
     }
     const method = cursor;
-    return (args, options) => method(enforceTrackedChangeMode(operationId, args, trackedEnforcementOf(options)).args, options);
+    return (args, options) => method(enforceTrackedChangeMode(operationId, args, trackedEnforcementOf(options)).args, operationInvokeOptions(operationId, options));
 }
 function trackedEnforcementOf(options) {
     if (!isRecord(options) || options.enforceChangeMode !== 'tracked')
@@ -1630,6 +1636,16 @@ async function fullDispatch(includeExec, documentHandle, toolName, args, invokeO
             details: { toolName },
         });
     }
+    if (invokeOptions?.dryRun === true &&
+        (FULL_ONLY_TOOL_NAMES.has(toolName) ||
+            (toolName === 'superdoc_perform_action' &&
+                typeof args.action === 'string' &&
+                Object.hasOwn(HELPER_ACTIONS, args.action)))) {
+        throw new SuperDocCliError('The full preset dispatcher does not support dryRun previews. Use a supported per-call dryRun instead.', {
+            code: 'CAPABILITY_UNSUPPORTED',
+            details: { toolName, preset: 'full', dryRun: true },
+        });
+    }
     if (!includeExec && toolName === 'superdoc_execute_code') {
         throw new SuperDocCliError('superdoc_execute_code is disabled in the full preset. Use superdoc_api_call (a {calls:[…]} batch covers multi-step edits).', { code: 'TOOL_DISPATCH_NOT_FOUND', details: { toolName, preset: 'full' } });
     }
@@ -1645,6 +1661,12 @@ async function fullDispatch(includeExec, documentHandle, toolName, args, invokeO
         if (args.dryRun !== undefined && args.dryRun !== false) {
             throw new SuperDocCliError(`Action ${args.action} has no dry run and would edit the document. Nothing was changed. Describe the planned change instead, or call it without dryRun.`, { code: 'INVALID_ARGUMENT', details: { action: args.action, supportsDryRun: false } });
         }
+        if (Object.hasOwn(HELPER_ACTIONS, args.action) && Object.hasOwn(args, 'expectedRevision')) {
+            throw new SuperDocCliError(`Action ${args.action} cannot enforce args.expectedRevision. Nothing was changed.`, {
+                code: 'CAPABILITY_UNSUPPORTED',
+                details: { toolName, preset: 'full', action: args.action, feature: 'preset.full.helper.expectedRevision' },
+            });
+        }
         return runHelperAction(documentHandle, args.action, args, invokeOptions);
     }
     if (!FULL_ONLY_TOOL_NAMES.has(toolName)) {

package/dist/runtime/host.cjs

@@ -714,6 +714,9 @@ class HostTransport {
         if (typeof idRaw !== 'number') {
             return;
         }
+        if (Object.hasOwn(record, 'result') === Object.hasOwn(record, 'error')) {
+            return;
+        }
         const pending = this.pending.get(idRaw);
         if (!pending) {
             return;

package/dist/runtime/host.js

@@ -711,6 +711,9 @@ export class HostTransport {
         if (typeof idRaw !== 'number') {
             return;
         }
+        if (Object.hasOwn(record, 'result') === Object.hasOwn(record, 'error')) {
+            return;
+        }
         const pending = this.pending.get(idRaw);
         if (!pending) {
             return;

package/dist/runtime/sdk-policy.d.ts

@@ -10,6 +10,7 @@ export declare const SDK_POLICY: {
         requestTimeout: string;
         collaborationAuthPerOpen: string;
         documentAuthor: string;
+        fullPreset?: string;
     };
     documentOpenFields: readonly string[];
     documentSaveFields: readonly string[];

package/dist/runtime/sdk-version.generated.cjs

@@ -3,6 +3,6 @@
 // AUTO-GENERATED by scripts/embed-version.mjs — DO NOT EDIT.
 // Source of truth: package.json. Regenerated on every SDK build so the
 // SDK retains its own version identity when bundled into another package.
-const SDK_VERSION = '2.25.0-next.9';
+const SDK_VERSION = '2.26.0-next.1';
 
 exports.SDK_VERSION = SDK_VERSION;

package/dist/runtime/sdk-version.generated.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.25.0-next.9";
+export declare const SDK_VERSION = "2.26.0-next.1";

package/dist/runtime/sdk-version.generated.js

@@ -1,4 +1,4 @@
 // AUTO-GENERATED by scripts/embed-version.mjs — DO NOT EDIT.
 // Source of truth: package.json. Regenerated on every SDK build so the
 // SDK retains its own version identity when bundled into another package.
-export const SDK_VERSION = '2.25.0-next.9';
+export const SDK_VERSION = '2.26.0-next.1';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc/sdk",
-  "version": "2.25.0-next.9",
+  "version": "2.26.0-next.1",
   "description": "Node SDK for SuperDoc, wrapping the SuperDoc CLI to read and edit .docx files from JavaScript and TypeScript.",
   "private": false,
   "license": "AGPL-3.0",
@@ -38,11 +38,11 @@
     "typescript": "^5.9.2"
   },
   "optionalDependencies": {
-    "@superdoc/sdk-darwin-arm64": "2.25.0-next.9",
-    "@superdoc/sdk-darwin-x64": "2.25.0-next.9",
-    "@superdoc/sdk-linux-x64": "2.25.0-next.9",
-    "@superdoc/sdk-linux-arm64": "2.25.0-next.9",
-    "@superdoc/sdk-windows-x64": "2.25.0-next.9"
+    "@superdoc/sdk-darwin-arm64": "2.26.0-next.1",
+    "@superdoc/sdk-darwin-x64": "2.26.0-next.1",
+    "@superdoc/sdk-linux-x64": "2.26.0-next.1",
+    "@superdoc/sdk-linux-arm64": "2.26.0-next.1",
+    "@superdoc/sdk-windows-x64": "2.26.0-next.1"
   },
   "publishConfig": {
     "access": "public"

package/tools/catalog.json

@@ -4823,6 +4823,10 @@
                     "start": {
                       "type": "integer"
                     },
+                    "lvlRestart": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
                     "alignment": {
                       "enum": [
                         "left",

package/tools/generation-receipt.json

@@ -1,28 +1,34 @@
 {
   "formatVersion": 1,
-  "contractHash": "756068a9617daba6d9b4281bbb7efe4225ac79896afbafaee12a4c7f90d21fa1",
-  "documentApiSourceHash": "e1a052db04cdc53e9bdc5773aac68ae29b283a12a9452b7c083f84cd60aa31a0",
-  "generatorHash": "4bf17cfeace269af436275fcc2f30ccd7b7af3d7136f744785c9332ab6159e1c",
+  "contractHash": "c979c8d1b6aaf55fe9fae706ed82673d3e115be85b36ebdf0a46925ba566ba85",
+  "documentApiSourceHash": "4ac61ff95d6d623345ec29bb64f746232a269e9b02436f8b8a25ce0bb34ce0d7",
+  "generatorHash": "bdbc8c4e1a26b6f497b43e6df9a1f52a1b8391f39b43b0c81f7916f580892cb2",
   "inputs": {
-    "apps/cli/src/host/sdk-policy.ts": "8820bc2cb4694bd665cbfacbb55c262a5df5cde4ed2a1a8d0735c09c6a5e6dd8",
-    "packages/sdk/codegen/src/artifacts.mjs": "aecab7eca4694cbcf2366ddd9cabc033abddad2ff8fb0960d505580dbaf4d8b7",
+    "apps/cli/src/host/sdk-policy.ts": "9a2d67b9957d936a6f26345f5e5fc896a886da183811e3ad2f553d7d67b2da01",
+    "packages/sdk/codegen/src/artifacts.mjs": "1e03c94c1da3cca73a078b5ab445f891409e6053eb695d52933628226c7f1583",
     "packages/sdk/codegen/src/contract-identity.mjs": "9d2fd074c10cf71f89e4cb9a1c8d96f9c4df4a15e11207cd0921dc58b6906b52",
     "packages/sdk/codegen/src/generate-action-names.mjs": "eedb0b3e7ecab3bb7a4e507e339d8a06754cb8bab154da2583be2d5de024ea28",
-    "packages/sdk/codegen/src/generate-all.mjs": "5c4dee723464e4fd73e13ca879a4e38191229414c050e1405c8e747e7a904afb",
+    "packages/sdk/codegen/src/generate-action-policy.mjs": "f99188ec75594ee37a8ef37e021f357c1d308cc4d5eae71a045a1426f58b9fbf",
+    "packages/sdk/codegen/src/generate-all.mjs": "e364d1b02b0c866886c357a598597b3efb3692e2320a88980981fd5f428c7433",
     "packages/sdk/codegen/src/generate-intent-tools.mjs": "843391a0eb83bf762985be96047e9e9109b87c7d9352cde7aabf49f0e57147b5",
-    "packages/sdk/codegen/src/generate-node.mjs": "76e768216cd5e37fb44f5798faaf1b0e5572efac0be3d2e021edd81b28350093",
+    "packages/sdk/codegen/src/generate-node.mjs": "b1fc8c12a810eab72de387a7d87f35e58ebc3c3b94f267185fa1579b8f2d1cdf",
     "packages/sdk/codegen/src/generate-python.mjs": "e6415bb2047db279bf40f32f16ba1c6a4f5d99c9df303a69cc0b9ececfa01028",
     "packages/sdk/codegen/src/model/schema.mjs": "29cb1167413280907ad324d8a1fcb54dc70cce829df00c1a755f43040d01cf3b",
+    "packages/sdk/codegen/src/node22-core-characters.json": "ba26df167c0853b955b6e04d856a899a7c83865c7b5834d80645d1b41d66c693",
     "packages/sdk/codegen/src/shared.mjs": "a411e7ea4fab43b5b08b00294c746ff7063ceddbae66ece8d8c5990f131e0f7c",
     "packages/sdk/codegen/src/targets.mjs": "62c5ae3e3813e07b37e62487d973bac60ef6bea558a01f3ace2e0c6e8374e147",
-    "packages/sdk/langs/node/package.json": "b413c73ffc569b7bd5796fac2b346030ae49d2a8fb9d47152ddc167a925274bb",
+    "packages/sdk/langs/node/package.json": "70e8cec19630c3105b49feeb79028d6a18a0402d2c5f15f54325e080a048eef8",
     "packages/sdk/langs/node/scripts/embed-prompts.mjs": "1b1641bf89cad962a4ff11d93f301fe5a4e32fe856cd3c9586106d8aaab4ad80",
     "packages/sdk/langs/node/scripts/embed-tools.mjs": "4cd8b0605b088421ea1fdf8e4e19c70f571f4e3352309a1480491600122e7bb3",
     "packages/sdk/langs/node/scripts/embed-version.mjs": "95e2ff3a7c15cb38130e12f04c8a96c901a5e55d9960610ebefa37178fd19cde",
     "packages/sdk/langs/node/src/agent/action-descriptors.json": "b2afbe8a23454bf807f7220172fb6211ccd098849f1ca27dc3546fdc352c8e48",
+    "packages/sdk/langs/node/src/agent/actions.ts": "a5ee29da19690344586e39f18631924c58ae8852b49b18339eeadaa45b1ea971",
+    "packages/sdk/langs/node/src/agent/catalog.ts": "9cf79f38dd21a2a082e6d4d35b9bcd2641bd0790a96503f4585d6cc5174ee64e",
+    "packages/sdk/langs/node/src/presets/core.ts": "b0f32dfc94ddfc86ad96a676da26b526edfcd5f658bfc077d880df69c057c214",
     "packages/sdk/langs/node/src/prompts/full-addendum.md": "1c18055ddee8e40661417f75d16c12741c7b5f89987386396dc673b4fc837875",
     "packages/sdk/langs/node/src/prompts/mcp-prompt.md": "ba1e239877b2b316744477e3ca7b6982fa265edb1358759209cc439457728e8b",
     "packages/sdk/langs/node/src/prompts/system-prompt.md": "dd9bdac644843db2f4964ea091f5c832b8c8eb058703861210374037c077bb92",
+    "packages/sdk/langs/node/src/runtime/tracked-support.ts": "779efa7c8a949090aa83e7db93d4fa84500e7563a2d47c464305f4513c424e6f",
     "packages/sdk/scripts/sdk-generate.mjs": "fc5b0cb07a39972694a0c60cfef19b2e166ec12890fb5060e97b2b818f746ef3",
     "packages/sdk/scripts/sdk-platform-targets.mjs": "6bdcd55fec9695c7af44ee5c7f67065450f61c27cdd9552d68b92e88abb9d7ab",
     "packages/sdk/tools/prompt-templates/system-prompt-core.md": "98632908dbece800115db92181b2a48823725b6e2612383de6bc6c34f57ac72e",
@@ -33,14 +39,14 @@
   "outputs": {
     "packages/sdk/langs/node/src/generated/contract.ts": {
       "id": "node-contract",
-      "sha256": "120d819c4fae9de6ded1a66369dbfa91c038b96f1f15b9ca192e42cd31c4a55b",
+      "sha256": "62543eab3fa7ad079c8de9180b08e2cc400432f9533daf06ede129a93b23c27a",
       "consumers": [
         "node"
       ]
     },
     "packages/sdk/langs/node/src/generated/client.ts": {
       "id": "node-client",
-      "sha256": "443e8cc3ed7a72ade8fb9539b024c5caab231e7320594994335985871f4a180a",
+      "sha256": "8d43f3fb870144acbc2a91eaddd556fa88feb6f7b87f85a9d345c635079a9cac",
       "consumers": [
         "node"
       ]
@@ -54,14 +60,14 @@
     },
     "packages/sdk/langs/python/superdoc/generated/contract.py": {
       "id": "python-contract",
-      "sha256": "a08508e328c7c41b8e8ecd8ef086d537d20407dc95becb3d920b240b625d68b1",
+      "sha256": "a1c13a834f7a1e04ec829ed6b663f884d6f28adf12e5f5b9ca9a2064a8f5c978",
       "consumers": [
         "python"
       ]
     },
     "packages/sdk/langs/python/superdoc/generated/client.py": {
       "id": "python-client",
-      "sha256": "f55c6cf0cd9c0f9cb330608faa4f18936bebf61e1ec297062d894f791043d2a2",
+      "sha256": "814a1c4789fc11a43bf1a3067583dc0137b947a6b2e6a5053d3829f884fe98d5",
       "consumers": [
         "python"
       ]
@@ -96,7 +102,7 @@
     },
     "packages/sdk/tools/catalog.json": {
       "id": "tool-catalog",
-      "sha256": "0d22fe1e3bda56c043cd8e2156ec2af6f53e71db18dd1ce3a04486952c564976",
+      "sha256": "e21fbc1034d799d2b52eefe91e7f9b9bd13d7e02ca07a61ddf66552c5995afd5",
       "consumers": [
         "node",
         "python",
@@ -105,7 +111,7 @@
     },
     "packages/sdk/tools/tools-policy.json": {
       "id": "tool-policy",
-      "sha256": "fb0195e4130bb323efa3fc9bddab193c6ea595656da14fa64222464ead34f853",
+      "sha256": "de390e1d508cea61d731e04823ad97b9ed7e56a613e7e34ef40cf73ba76ac8d5",
       "consumers": [
         "node",
         "python"
@@ -113,7 +119,7 @@
     },
     "packages/sdk/tools/tools.openai.json": {
       "id": "tools-openai",
-      "sha256": "f41b4b2c1813d784bb2d32b48575e69d6fc05545bfcb3d29fa6ee690342d6270",
+      "sha256": "723c44e29a2becc1dd79c0b494f5a4383c4bb517189d4ae4cf0ea0a74b31a95b",
       "consumers": [
         "node",
         "python",
@@ -122,7 +128,7 @@
     },
     "packages/sdk/tools/tools.anthropic.json": {
       "id": "tools-anthropic",
-      "sha256": "0920c8379fe6b116d34114a0f56378b52a7261aad78b55a59514ea5d1af3a903",
+      "sha256": "b9415158df37f6eb3b3b32136a8c40ead465d602dce4149169a29d8bd2259ecf",
       "consumers": [
         "node",
         "python",
@@ -131,7 +137,7 @@
     },
     "packages/sdk/tools/tools.vercel.json": {
       "id": "tools-vercel",
-      "sha256": "f41b4b2c1813d784bb2d32b48575e69d6fc05545bfcb3d29fa6ee690342d6270",
+      "sha256": "723c44e29a2becc1dd79c0b494f5a4383c4bb517189d4ae4cf0ea0a74b31a95b",
       "consumers": [
         "node",
         "python",
@@ -140,7 +146,7 @@
     },
     "packages/sdk/tools/tools.generic.json": {
       "id": "tools-generic",
-      "sha256": "81d9007fb7daaf902da38f0bb83681e21969e5eee609a74eb80c637f33b95e50",
+      "sha256": "7f8b0bb02005f1ae7171eebec8bc3367dc1568bc7b063401856e4c7783547f0f",
       "consumers": [
         "node",
         "python",
@@ -180,14 +186,14 @@
     },
     "packages/sdk/langs/node/src/embedded-tools.generated.ts": {
       "id": "node-embedded-tools",
-      "sha256": "69cd0f4c4a7fdb5c1fc631dc99ce659da811b4ab3fed9a220aabe8f2e62a503c",
+      "sha256": "8eccf429e83acad4edeb2b75062614ba285502e47cfbc91293425caae2495b7e",
       "consumers": [
         "node"
       ]
     },
     "packages/sdk/langs/node/src/runtime/sdk-version.generated.ts": {
       "id": "node-sdk-version",
-      "sha256": "3c940e8b9a160f1f103dd7f1414ce2b905b7f478dc1e9db7ce20435d5786e232",
+      "sha256": "229bb110010eb75010b2d9d290dbc5a39625495c0cc3d36f7a722aa16f45204a",
       "consumers": [
         "node"
       ]

package/tools/tools-policy.json

@@ -43,5 +43,5 @@
       "mutates": true
     }
   ],
-  "contractHash": "756068a9617daba6d9b4281bbb7efe4225ac79896afbafaee12a4c7f90d21fa1"
+  "contractHash": "c979c8d1b6aaf55fe9fae706ed82673d3e115be85b36ebdf0a46925ba566ba85"
 }

package/tools/tools.anthropic.json

@@ -4532,6 +4532,10 @@
                     "start": {
                       "type": "integer"
                     },
+                    "lvlRestart": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
                     "alignment": {
                       "enum": [
                         "left",

package/tools/tools.generic.json

@@ -4619,6 +4619,10 @@
                     "start": {
                       "type": "integer"
                     },
+                    "lvlRestart": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
                     "alignment": {
                       "enum": [
                         "left",

package/tools/tools.openai.json

@@ -4546,6 +4546,10 @@
                       "start": {
                         "type": "integer"
                       },
+                      "lvlRestart": {
+                        "type": "integer",
+                        "minimum": 0
+                      },
                       "alignment": {
                         "enum": [
                           "left",

package/tools/tools.vercel.json

@@ -4546,6 +4546,10 @@
                       "start": {
                         "type": "integer"
                       },
+                      "lvlRestart": {
+                        "type": "integer",
+                        "minimum": 0
+                      },
                       "alignment": {
                         "enum": [
                           "left",