@superdoc-dev/sdk 1.10.0 → 1.11.0-next.4

package/dist/generated/contract.cjs

@@ -41810,7 +41810,7 @@ const CONTRACT = {
                 "set-alignment"
             ],
             "category": "format",
-            "description": "Set paragraph alignment (justification) on a paragraph-like block.",
+            "description": "Set visual paragraph alignment on a paragraph-like block. For RTL paragraphs, left/right are translated to Word-compatible stored justification values.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": "result",
@@ -41952,8 +41952,10 @@ const CONTRACT = {
                             {
                                 "const": "justify"
                             }
-                        ]
-                    }
+                        ],
+                        "description": "Visual paragraph alignment. In RTL paragraphs, 'left' stores w:jc='right' and 'right' stores w:jc='left' so Word displays the requested side."
+                    },
+                    "description": "Visual paragraph alignment. In RTL paragraphs, 'left' stores w:jc='right' and 'right' stores w:jc='left' so Word displays the requested side."
                 },
                 {
                     "name": "blockId",
@@ -42005,7 +42007,8 @@ const CONTRACT = {
                             "center",
                             "right",
                             "justify"
-                        ]
+                        ],
+                        "description": "Visual paragraph alignment. In RTL paragraphs, 'left' stores w:jc='right' and 'right' stores w:jc='left' so Word displays the requested side."
                     }
                 },
                 "additionalProperties": false,

package/dist/generated/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/generated/contract.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;IAClC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,GAAG,EAAE;QACH,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CACpD;AAED,eAAO,MAAM,QAAQ,EAAE,QA48yJtB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/generated/contract.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;IAClC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,GAAG,EAAE;QACH,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CACpD;AAED,eAAO,MAAM,QAAQ,EAAE,QA+8yJtB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC"}

package/dist/generated/contract.js

@@ -42931,7 +42931,7 @@ export const CONTRACT = {
                 "set-alignment"
             ],
             "category": "format",
-            "description": "Set paragraph alignment (justification) on a paragraph-like block.",
+            "description": "Set visual paragraph alignment on a paragraph-like block. For RTL paragraphs, left/right are translated to Word-compatible stored justification values.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": "result",
@@ -43073,8 +43073,10 @@ export const CONTRACT = {
                             {
                                 "const": "justify"
                             }
-                        ]
-                    }
+                        ],
+                        "description": "Visual paragraph alignment. In RTL paragraphs, 'left' stores w:jc='right' and 'right' stores w:jc='left' so Word displays the requested side."
+                    },
+                    "description": "Visual paragraph alignment. In RTL paragraphs, 'left' stores w:jc='right' and 'right' stores w:jc='left' so Word displays the requested side."
                 },
                 {
                     "name": "blockId",
@@ -43126,7 +43128,8 @@ export const CONTRACT = {
                             "center",
                             "right",
                             "justify"
-                        ]
+                        ],
+                        "description": "Visual paragraph alignment. In RTL paragraphs, 'left' stores w:jc='right' and 'right' stores w:jc='left' so Word displays the requested side."
                     }
                 },
                 "additionalProperties": false,

package/dist/runtime/host.cjs

@@ -12,6 +12,54 @@ const FORWARD_HOST_STDERR = typeof process !== 'undefined' && typeof process.env
     ? process.env.SUPERDOC_DEBUG_TEXT_REWRITE === '1'
     : false;
 const JSON_RPC_TIMEOUT_CODE = -32011;
+// Mirrors apps/cli/src/host/server.ts:DEFAULT_REQUEST_TIMEOUT_MS. Kept in sync
+// by hand; an explicit constant here avoids importing CLI app internals across
+// the package boundary.
+const HOST_DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
+// Extra time the JS-side watchdog waits beyond the host-side ceiling so the
+// host's structured RequestTimeout error wins the race against the SDK's own
+// abort. The buffer absorbs JSON-RPC serialization, stdio drain, and event-
+// loop latency.
+const WATCHDOG_HEADROOM_MS = 5_000;
+/**
+ * Builds the argv passed to `spawn` for `superdoc host --stdio`. Propagates
+ * `requestTimeoutMs` to the host via `--request-timeout-ms`, since the SDK
+ * option alone cannot raise the host's 30s per-invoke ceiling otherwise.
+ *
+ * Exported for unit testing.
+ */
+function buildHostSpawnArgs(prefixArgs, options) {
+    const args = [...prefixArgs, 'host', '--stdio'];
+    if (options.requestTimeoutMs != null) {
+        args.push('--request-timeout-ms', String(options.requestTimeoutMs));
+    }
+    return args;
+}
+/**
+ * Computes the JS-side watchdog timeout for a single JSON-RPC request.
+ *
+ * The watchdog must outlive the host-side `cli.invoke` ceiling so the host's
+ * structured `RequestTimeout` JSON-RPC frame wins the race against the SDK's
+ * own abort. Three cases:
+ *
+ * 1. A per-call `InvokeOptions.timeoutMs` is supplied → widen above it.
+ * 2. The client set `requestTimeoutMs` → widen above that.
+ * 3. Neither is set → widen above the host's compiled-in default so the
+ *    default-config case doesn't race at 30s (which previously surfaced the
+ *    old "Host watchdog timed out" string instead of the host's structured
+ *    TIMEOUT error).
+ *
+ * Exported for unit testing.
+ */
+function resolveJsWatchdogTimeout(watchdogTimeoutMs, requestTimeoutMs, timeoutMsOverride) {
+    if (timeoutMsOverride != null) {
+        return Math.max(watchdogTimeoutMs, timeoutMsOverride + WATCHDOG_HEADROOM_MS);
+    }
+    if (requestTimeoutMs != null) {
+        return Math.max(watchdogTimeoutMs, requestTimeoutMs + WATCHDOG_HEADROOM_MS);
+    }
+    return Math.max(watchdogTimeoutMs, HOST_DEFAULT_REQUEST_TIMEOUT_MS + WATCHDOG_HEADROOM_MS);
+}
 /**
  * Transport that communicates with a long-lived CLI host process over JSON-RPC stdio.
  */
@@ -111,7 +159,7 @@ class HostTransport {
     }
     async startHostProcess() {
         const { command, prefixArgs } = transportCommon.resolveInvocation(this.cliBin);
-        const args = [...prefixArgs, 'host', '--stdio'];
+        const args = buildHostSpawnArgs(prefixArgs, { requestTimeoutMs: this.requestTimeoutMs });
         const child = node_child_process.spawn(command, args, {
             env: {
                 ...process.env,
@@ -204,13 +252,7 @@ class HostTransport {
         }
     }
     resolveWatchdogTimeout(timeoutMsOverride) {
-        if (timeoutMsOverride != null) {
-            return Math.max(this.watchdogTimeoutMs, timeoutMsOverride + 1_000);
-        }
-        if (this.requestTimeoutMs != null) {
-            return Math.max(this.watchdogTimeoutMs, this.requestTimeoutMs + 1_000);
-        }
-        return this.watchdogTimeoutMs;
+        return resolveJsWatchdogTimeout(this.watchdogTimeoutMs, this.requestTimeoutMs, timeoutMsOverride);
     }
     async sendJsonRpcRequest(method, params, watchdogTimeoutMs) {
         const child = this.child;
@@ -356,3 +398,5 @@ class HostTransport {
 }
 
 exports.HostTransport = HostTransport;
+exports.buildHostSpawnArgs = buildHostSpawnArgs;
+exports.resolveJsWatchdogTimeout = resolveJsWatchdogTimeout;

package/dist/runtime/host.d.ts

@@ -1,4 +1,31 @@
 import { type InvokeOptions, type OperationSpec, type SuperDocClientOptions } from './transport-common.js';
+/**
+ * Builds the argv passed to `spawn` for `superdoc host --stdio`. Propagates
+ * `requestTimeoutMs` to the host via `--request-timeout-ms`, since the SDK
+ * option alone cannot raise the host's 30s per-invoke ceiling otherwise.
+ *
+ * Exported for unit testing.
+ */
+export declare function buildHostSpawnArgs(prefixArgs: readonly string[], options: {
+    requestTimeoutMs?: number;
+}): string[];
+/**
+ * Computes the JS-side watchdog timeout for a single JSON-RPC request.
+ *
+ * The watchdog must outlive the host-side `cli.invoke` ceiling so the host's
+ * structured `RequestTimeout` JSON-RPC frame wins the race against the SDK's
+ * own abort. Three cases:
+ *
+ * 1. A per-call `InvokeOptions.timeoutMs` is supplied → widen above it.
+ * 2. The client set `requestTimeoutMs` → widen above that.
+ * 3. Neither is set → widen above the host's compiled-in default so the
+ *    default-config case doesn't race at 30s (which previously surfaced the
+ *    old "Host watchdog timed out" string instead of the host's structured
+ *    TIMEOUT error).
+ *
+ * Exported for unit testing.
+ */
+export declare function resolveJsWatchdogTimeout(watchdogTimeoutMs: number, requestTimeoutMs: number | undefined, timeoutMsOverride: number | undefined): number;
 /**
  * Transport that communicates with a long-lived CLI host process over JSON-RPC stdio.
  */

package/dist/runtime/host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/runtime/host.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAE3B,MAAM,uBAAuB,CAAC;AAgC/B;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAqC;IAC1D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAa;IAChD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAe;IAErC,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,qBAAqB;IAmBzD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BxB,MAAM,CAAC,KAAK,GAAG,OAAO,EAC1B,SAAS,EAAE,aAAa,EACxB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACpC,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,KAAK,CAAC;YAkCH,eAAe;YAkBf,gBAAgB;IA0E9B,OAAO,CAAC,kBAAkB;IAuC1B,OAAO,CAAC,sBAAsB;YAYhB,kBAAkB;IAkEhC,OAAO,CAAC,YAAY;IA2CpB,OAAO,CAAC,eAAe;IAmCvB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,cAAc;CA6BvB"}
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/runtime/host.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAE3B,MAAM,uBAAuB,CAAC;AA0C/B;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,EAAE,CAMlH;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,iBAAiB,EAAE,MAAM,EACzB,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,iBAAiB,EAAE,MAAM,GAAG,SAAS,GACpC,MAAM,CAUR;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAqC;IAC1D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAa;IAChD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAe;IAErC,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,qBAAqB;IAmBzD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BxB,MAAM,CAAC,KAAK,GAAG,OAAO,EAC1B,SAAS,EAAE,aAAa,EACxB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACpC,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,KAAK,CAAC;YAkCH,eAAe;YAkBf,gBAAgB;IA0E9B,OAAO,CAAC,kBAAkB;IAuC1B,OAAO,CAAC,sBAAsB;YAIhB,kBAAkB;IAkEhC,OAAO,CAAC,YAAY;IA2CpB,OAAO,CAAC,eAAe;IAmCvB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,cAAc;CA6BvB"}

package/dist/runtime/host.js

@@ -9,6 +9,54 @@ const FORWARD_HOST_STDERR = typeof process !== 'undefined' && typeof process.env
     ? process.env.SUPERDOC_DEBUG_TEXT_REWRITE === '1'
     : false;
 const JSON_RPC_TIMEOUT_CODE = -32011;
+// Mirrors apps/cli/src/host/server.ts:DEFAULT_REQUEST_TIMEOUT_MS. Kept in sync
+// by hand; an explicit constant here avoids importing CLI app internals across
+// the package boundary.
+const HOST_DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
+// Extra time the JS-side watchdog waits beyond the host-side ceiling so the
+// host's structured RequestTimeout error wins the race against the SDK's own
+// abort. The buffer absorbs JSON-RPC serialization, stdio drain, and event-
+// loop latency.
+const WATCHDOG_HEADROOM_MS = 5_000;
+/**
+ * Builds the argv passed to `spawn` for `superdoc host --stdio`. Propagates
+ * `requestTimeoutMs` to the host via `--request-timeout-ms`, since the SDK
+ * option alone cannot raise the host's 30s per-invoke ceiling otherwise.
+ *
+ * Exported for unit testing.
+ */
+export function buildHostSpawnArgs(prefixArgs, options) {
+    const args = [...prefixArgs, 'host', '--stdio'];
+    if (options.requestTimeoutMs != null) {
+        args.push('--request-timeout-ms', String(options.requestTimeoutMs));
+    }
+    return args;
+}
+/**
+ * Computes the JS-side watchdog timeout for a single JSON-RPC request.
+ *
+ * The watchdog must outlive the host-side `cli.invoke` ceiling so the host's
+ * structured `RequestTimeout` JSON-RPC frame wins the race against the SDK's
+ * own abort. Three cases:
+ *
+ * 1. A per-call `InvokeOptions.timeoutMs` is supplied → widen above it.
+ * 2. The client set `requestTimeoutMs` → widen above that.
+ * 3. Neither is set → widen above the host's compiled-in default so the
+ *    default-config case doesn't race at 30s (which previously surfaced the
+ *    old "Host watchdog timed out" string instead of the host's structured
+ *    TIMEOUT error).
+ *
+ * Exported for unit testing.
+ */
+export function resolveJsWatchdogTimeout(watchdogTimeoutMs, requestTimeoutMs, timeoutMsOverride) {
+    if (timeoutMsOverride != null) {
+        return Math.max(watchdogTimeoutMs, timeoutMsOverride + WATCHDOG_HEADROOM_MS);
+    }
+    if (requestTimeoutMs != null) {
+        return Math.max(watchdogTimeoutMs, requestTimeoutMs + WATCHDOG_HEADROOM_MS);
+    }
+    return Math.max(watchdogTimeoutMs, HOST_DEFAULT_REQUEST_TIMEOUT_MS + WATCHDOG_HEADROOM_MS);
+}
 /**
  * Transport that communicates with a long-lived CLI host process over JSON-RPC stdio.
  */
@@ -108,7 +156,7 @@ export class HostTransport {
     }
     async startHostProcess() {
         const { command, prefixArgs } = resolveInvocation(this.cliBin);
-        const args = [...prefixArgs, 'host', '--stdio'];
+        const args = buildHostSpawnArgs(prefixArgs, { requestTimeoutMs: this.requestTimeoutMs });
         const child = spawn(command, args, {
             env: {
                 ...process.env,
@@ -201,13 +249,7 @@ export class HostTransport {
         }
     }
     resolveWatchdogTimeout(timeoutMsOverride) {
-        if (timeoutMsOverride != null) {
-            return Math.max(this.watchdogTimeoutMs, timeoutMsOverride + 1_000);
-        }
-        if (this.requestTimeoutMs != null) {
-            return Math.max(this.watchdogTimeoutMs, this.requestTimeoutMs + 1_000);
-        }
-        return this.watchdogTimeoutMs;
+        return resolveJsWatchdogTimeout(this.watchdogTimeoutMs, this.requestTimeoutMs, timeoutMsOverride);
     }
     async sendJsonRpcRequest(method, params, watchdogTimeoutMs) {
         const child = this.child;

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

@@ -32,7 +32,25 @@ export interface SuperDocClientOptions {
     env?: Record<string, string | undefined>;
     startupTimeoutMs?: number;
     shutdownTimeoutMs?: number;
+    /**
+     * Upper bound (ms) on how long the host process may spend on a single
+     * `cli.invoke` request before it kills the operation and returns a
+     * `RequestTimeout` error. Propagated to the host via `--request-timeout-ms`
+     * at spawn. Raise this for documents that legitimately need more than 30s
+     * to process; the SDK widens its own JSON-RPC watchdog to match.
+     *
+     * Defaults to the host's own default (30s) when unset.
+     */
     requestTimeoutMs?: number;
+    /**
+     * JS-side watchdog (ms) the SDK waits for a host reply before giving up.
+     * Independent of {@link requestTimeoutMs} (which controls the host-side
+     * operation budget). Most callers should leave this at its default and use
+     * {@link requestTimeoutMs} as the single operation-timeout knob —
+     * `resolveWatchdogTimeout` already widens the watchdog above the host
+     * ceiling automatically. Override only when you need to detect a hung or
+     * crashed host faster than the operation budget allows.
+     */
     watchdogTimeoutMs?: number;
     maxQueueDepth?: number;
     defaultChangeMode?: ChangeMode;

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;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,KAAK,GAAG,OAAO,EACpB,SAAS,EAAE,aAAa,EACxB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,KAAK,CAAC,CAAC;CACnB;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"}
+{"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;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,KAAK,GAAG,OAAO,EACpB,SAAS,EAAE,aAAa,EACxB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,KAAK,CAAC,CAAC;CACnB;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;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;;OAQG;IACH,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/sdk",
-  "version": "1.10.0",
+  "version": "1.11.0-next.4",
   "private": false,
   "type": "module",
   "main": "./dist/index.cjs",
@@ -26,11 +26,11 @@
     "typescript": "^5.9.2"
   },
   "optionalDependencies": {
-    "@superdoc-dev/sdk-darwin-arm64": "1.10.0",
-    "@superdoc-dev/sdk-darwin-x64": "1.10.0",
-    "@superdoc-dev/sdk-linux-x64": "1.10.0",
-    "@superdoc-dev/sdk-linux-arm64": "1.10.0",
-    "@superdoc-dev/sdk-windows-x64": "1.10.0"
+    "@superdoc-dev/sdk-darwin-arm64": "1.11.0-next.4",
+    "@superdoc-dev/sdk-linux-arm64": "1.11.0-next.4",
+    "@superdoc-dev/sdk-linux-x64": "1.11.0-next.4",
+    "@superdoc-dev/sdk-darwin-x64": "1.11.0-next.4",
+    "@superdoc-dev/sdk-windows-x64": "1.11.0-next.4"
   },
   "publishConfig": {
     "access": "public"

package/tools/catalog.json

@@ -1653,7 +1653,7 @@
               "right",
               "justify"
             ],
-            "description": "Required for action 'set_alignment'."
+            "description": "Visual paragraph alignment. In RTL paragraphs, 'left' stores w:jc='right' and 'right' stores w:jc='left' so Word displays the requested side. Required for action 'set_alignment'."
           },
           "left": {
             "type": "integer",

package/tools/tools-policy.json

@@ -43,5 +43,5 @@
       "mutates": true
     }
   ],
-  "contractHash": "30a98282620ba67a1197b0a2e228c6dd7203c4692c0ca15e56528855f02f38d1"
+  "contractHash": "266b6bb8fa042ebd94c3da6e11652471f49c40a061960f3df9055cf64c4bcbbe"
 }

package/tools/tools.anthropic.json

@@ -1559,7 +1559,7 @@
               "right",
               "justify"
             ],
-            "description": "Required for action 'set_alignment'."
+            "description": "Visual paragraph alignment. In RTL paragraphs, 'left' stores w:jc='right' and 'right' stores w:jc='left' so Word displays the requested side. Required for action 'set_alignment'."
           },
           "left": {
             "type": "integer",

package/tools/tools.generic.json

@@ -1600,7 +1600,7 @@
               "right",
               "justify"
             ],
-            "description": "Required for action 'set_alignment'."
+            "description": "Visual paragraph alignment. In RTL paragraphs, 'left' stores w:jc='right' and 'right' stores w:jc='left' so Word displays the requested side. Required for action 'set_alignment'."
           },
           "left": {
             "type": "integer",

package/tools/tools.openai.json

@@ -1567,7 +1567,7 @@
                 "right",
                 "justify"
               ],
-              "description": "Required for action 'set_alignment'."
+              "description": "Visual paragraph alignment. In RTL paragraphs, 'left' stores w:jc='right' and 'right' stores w:jc='left' so Word displays the requested side. Required for action 'set_alignment'."
             },
             "left": {
               "type": "integer",

package/tools/tools.vercel.json

@@ -1567,7 +1567,7 @@
                 "right",
                 "justify"
               ],
-              "description": "Required for action 'set_alignment'."
+              "description": "Visual paragraph alignment. In RTL paragraphs, 'left' stores w:jc='right' and 'right' stores w:jc='left' so Word displays the requested side. Required for action 'set_alignment'."
             },
             "left": {
               "type": "integer",