@superdoc/sdk 2.9.1-next.2 → 2.10.0-next.10

package/dist/runtime/process.cjs

@@ -1,5 +1,8 @@
 'use strict';
 
+var promises = require('node:fs/promises');
+var os = require('node:os');
+var path = require('node:path');
 var host = require('./host.cjs');
 var embeddedCli = require('./embedded-cli.cjs');
 var embeddedDocumentHost = require('./embedded-document-host.cjs');
@@ -54,6 +57,12 @@ class SuperDocRuntime {
     async connect() {
         await this.transport.connect();
     }
+    supportsDocumentFacts(sessionId) {
+        return this.transport.supportsDocumentFacts(sessionId);
+    }
+    async readDocumentRevision(sessionId) {
+        return this.transport.readDocumentRevision(sessionId);
+    }
     async dispose() {
         await this.transport.dispose();
     }
@@ -88,6 +97,35 @@ class SuperDocRuntime {
             throw error;
         }
     }
+    async replaceFile(sessionId, source, options = {}) {
+        if (typeof source === 'string') {
+            if (source.trim().length === 0) {
+                throw new errors.SuperDocCliError('replaceFile source path must be non-empty.', { code: 'INVALID_ARGUMENT' });
+            }
+            return (await this.transport.replaceFile(sessionId, source, options));
+        }
+        let bytes;
+        if (source instanceof Uint8Array) {
+            bytes = new Uint8Array(source);
+        }
+        else if (source instanceof ArrayBuffer) {
+            bytes = new Uint8Array(source.slice(0));
+        }
+        else {
+            throw new errors.SuperDocCliError('replaceFile source must be a path, Uint8Array, or ArrayBuffer.', {
+                code: 'INVALID_ARGUMENT',
+            });
+        }
+        const stagingDirectory = await promises.mkdtemp(path.join(os.tmpdir(), 'superdoc-sdk-replace-'));
+        const stagedPath = path.join(stagingDirectory, 'replacement.docx');
+        try {
+            await promises.writeFile(stagedPath, bytes, { mode: 0o600 });
+            return (await this.transport.replaceFile(sessionId, stagedPath, options));
+        }
+        finally {
+            await promises.rm(stagingDirectory, { recursive: true, force: true });
+        }
+    }
 }
 
 exports.SuperDocRuntime = SuperDocRuntime;

package/dist/runtime/process.d.ts

@@ -7,6 +7,19 @@ type EmbeddedRuntimeResolvers = {
     cli: () => string;
     documentHost: () => string;
 };
+export type ReplaceFileSource = string | Uint8Array | ArrayBuffer;
+export interface ReplaceFileOptions {
+    readonly timeoutMs?: number;
+}
+export interface ReplaceFileResult {
+    readonly contextId: string;
+    readonly runtime: 'v2';
+    readonly replaced: true;
+    readonly document: {
+        readonly byteLength: number;
+        readonly revision: string;
+    };
+}
 export declare function resolveRuntimeProcess(options?: SuperDocClientOptions, embedded?: EmbeddedRuntimeResolvers): RuntimeProcessResolution;
 export declare function toSafeInvokeTraceOptions(options: TransportInvokeOptions): InvokeOptions;
 /**
@@ -19,7 +32,10 @@ export declare class SuperDocRuntime {
     private readonly transport;
     constructor(options?: SuperDocClientOptions);
     connect(): Promise<void>;
+    supportsDocumentFacts(sessionId: string): boolean;
+    readDocumentRevision(sessionId: string): Promise<string | undefined>;
     dispose(): Promise<void>;
     invoke<TData = unknown>(operation: OperationSpec, params?: Record<string, unknown>, options?: TransportInvokeOptions): Promise<TData>;
+    replaceFile(sessionId: string, source: ReplaceFileSource, options?: ReplaceFileOptions): Promise<ReplaceFileResult>;
 }
 export type { CollaborationAuth, DocumentRuntimeKind, DocOpenOptions, InvokeOptions, OperationParamSpec, OperationSpec, RuntimeInvoker, SuperDocClientOptions, };

package/dist/runtime/process.js

@@ -1,3 +1,6 @@
+import { mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
 import { HostTransport } from './host.js';
 import { resolveEmbeddedCliBinary } from './embedded-cli.js';
 import { resolveEmbeddedDocumentHostBinary } from './embedded-document-host.js';
@@ -51,6 +54,12 @@ export class SuperDocRuntime {
     async connect() {
         await this.transport.connect();
     }
+    supportsDocumentFacts(sessionId) {
+        return this.transport.supportsDocumentFacts(sessionId);
+    }
+    async readDocumentRevision(sessionId) {
+        return this.transport.readDocumentRevision(sessionId);
+    }
     async dispose() {
         await this.transport.dispose();
     }
@@ -85,4 +94,33 @@ export class SuperDocRuntime {
             throw error;
         }
     }
+    async replaceFile(sessionId, source, options = {}) {
+        if (typeof source === 'string') {
+            if (source.trim().length === 0) {
+                throw new SuperDocCliError('replaceFile source path must be non-empty.', { code: 'INVALID_ARGUMENT' });
+            }
+            return (await this.transport.replaceFile(sessionId, source, options));
+        }
+        let bytes;
+        if (source instanceof Uint8Array) {
+            bytes = new Uint8Array(source);
+        }
+        else if (source instanceof ArrayBuffer) {
+            bytes = new Uint8Array(source.slice(0));
+        }
+        else {
+            throw new SuperDocCliError('replaceFile source must be a path, Uint8Array, or ArrayBuffer.', {
+                code: 'INVALID_ARGUMENT',
+            });
+        }
+        const stagingDirectory = await mkdtemp(join(tmpdir(), 'superdoc-sdk-replace-'));
+        const stagedPath = join(stagingDirectory, 'replacement.docx');
+        try {
+            await writeFile(stagedPath, bytes, { mode: 0o600 });
+            return (await this.transport.replaceFile(sessionId, stagedPath, options));
+        }
+        finally {
+            await rm(stagingDirectory, { recursive: true, force: true });
+        }
+    }
 }

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.9.1-next.2';
+const SDK_VERSION = '2.10.0-next.10';
 
 exports.SDK_VERSION = SDK_VERSION;

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

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.9.1-next.2";
+export declare const SDK_VERSION = "2.10.0-next.10";

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.9.1-next.2';
+export const SDK_VERSION = '2.10.0-next.10';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc/sdk",
-  "version": "2.9.1-next.2",
+  "version": "2.10.0-next.10",
   "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",
@@ -33,15 +33,16 @@
   "devDependencies": {
     "@types/bun": "^1.3.8",
     "@types/node": "22.19.2",
+    "jszip": "3.10.1",
     "rollup": "^4.31.0",
     "typescript": "^5.9.2"
   },
   "optionalDependencies": {
-    "@superdoc/sdk-darwin-arm64": "2.9.1-next.2",
-    "@superdoc/sdk-darwin-x64": "2.9.1-next.2",
-    "@superdoc/sdk-linux-x64": "2.9.1-next.2",
-    "@superdoc/sdk-linux-arm64": "2.9.1-next.2",
-    "@superdoc/sdk-windows-x64": "2.9.1-next.2"
+    "@superdoc/sdk-darwin-arm64": "2.10.0-next.10",
+    "@superdoc/sdk-darwin-x64": "2.10.0-next.10",
+    "@superdoc/sdk-linux-x64": "2.10.0-next.10",
+    "@superdoc/sdk-linux-arm64": "2.10.0-next.10",
+    "@superdoc/sdk-windows-x64": "2.10.0-next.10"
   },
   "publishConfig": {
     "access": "public"
@@ -50,8 +51,9 @@
     "build": "rm -rf dist && node scripts/embed-version.mjs && node scripts/embed-prompts.mjs && node scripts/embed-tools.mjs && tsc && pnpm run typecheck:consumer && rollup -c rollup.cjs.config.mjs && rm -rf dist/prompts && mkdir -p dist/prompts && cp src/prompts/*.md dist/prompts/ && pnpm run audit:publish",
     "audit:publish": "node ../../../../scripts/audit-publish-artifact.mjs dist --label sdk-node-dist",
     "typecheck": "tsc --noEmit",
-    "typecheck:consumer": "tsc --noEmit --strict --skipLibCheck --target ES2022 --module NodeNext --moduleResolution NodeNext ../../../../tests/consumer-typecheck/src/sdk-per-open-collaboration-auth.mts",
-    "test:document-host": "bun test src/runtime/__tests__/host-spawn-args.test.ts src/runtime/__tests__/document-rpc.test.ts src/__tests__/structured-document-rpc.e2e.test.ts src/__tests__/request-timeout-ms.e2e.test.ts",
+    "typecheck:consumer": "tsc --noEmit --strict --skipLibCheck --target ES2022 --module NodeNext --moduleResolution NodeNext ../../../../tests/consumer-typecheck/src/sdk-per-open-collaboration-auth.mts ../../../../tests/consumer-typecheck/src/sdk-replace-file.mts ../../../../tests/consumer-typecheck/src/sdk-agent-evidence.mts",
+    "test:agent-actions": "bun test src/__tests__/actions.test.ts src/__tests__/agent-runtime.test.ts",
+    "test:document-host": "bun test src/runtime/__tests__/host-spawn-args.test.ts src/runtime/__tests__/document-rpc.test.ts src/__tests__/structured-document-rpc.e2e.test.ts src/__tests__/request-timeout-ms.e2e.test.ts src/__tests__/agent-evidence.e2e.test.ts src/__tests__/agent-apply.e2e.test.ts src/__tests__/find-text.e2e.test.ts",
     "smoke:product-action": "node scripts/product-action-smoke.mjs"
   }
 }

package/tools/catalog.json

@@ -43,6 +43,41 @@
             "type": "boolean",
             "description": "Only for actions 'markdown_projection', 'html_projection'. Omit for other actions."
           },
+          "nodeIds": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "description": "Top-level block identities to match before pagination. Only for action 'blocks'. Omit for other actions."
+          },
+          "textSearch": {
+            "type": "object",
+            "properties": {
+              "terms": {
+                "type": "array",
+                "minItems": 1,
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "match": {
+                "enum": [
+                  "all",
+                  "any"
+                ]
+              },
+              "caseSensitive": {
+                "type": "boolean"
+              }
+            },
+            "additionalProperties": false,
+            "required": [
+              "terms"
+            ],
+            "description": "Only for action 'blocks'. Omit for other actions."
+          },
           "offset": {
             "type": "number",
             "minimum": 0,
@@ -3647,6 +3682,10 @@
                   "wholeWord": {
                     "type": "boolean",
                     "description": "Require word-boundary matches. Default: false."
+                  },
+                  "includeDeletedText": {
+                    "type": "boolean",
+                    "description": "When true, includes text from pending tracked deletions. Default: false."
                   }
                 },
                 "additionalProperties": false,
@@ -3841,6 +3880,10 @@
                                     "wholeWord": {
                                       "type": "boolean",
                                       "description": "Require word-boundary matches. Default: false."
+                                    },
+                                    "includeDeletedText": {
+                                      "type": "boolean",
+                                      "description": "When true, includes text from pending tracked deletions. Default: false."
                                     }
                                   },
                                   "additionalProperties": false,
@@ -4030,6 +4073,20 @@
                             }
                           ]
                         },
+                        "replacementMode": {
+                          "enum": [
+                            "literal",
+                            "regex-template"
+                          ],
+                          "type": "string"
+                        },
+                        "caseHandling": {
+                          "enum": [
+                            "exact",
+                            "preserve-match"
+                          ],
+                          "type": "string"
+                        },
                         "style": {
                           "type": "object",
                           "properties": {
@@ -4181,6 +4238,10 @@
                                     "wholeWord": {
                                       "type": "boolean",
                                       "description": "Require word-boundary matches. Default: false."
+                                    },
+                                    "includeDeletedText": {
+                                      "type": "boolean",
+                                      "description": "When true, includes text from pending tracked deletions. Default: false."
                                     }
                                   },
                                   "additionalProperties": false,
@@ -4470,6 +4531,10 @@
                                     "wholeWord": {
                                       "type": "boolean",
                                       "description": "Require word-boundary matches. Default: false."
+                                    },
+                                    "includeDeletedText": {
+                                      "type": "boolean",
+                                      "description": "When true, includes text from pending tracked deletions. Default: false."
                                     }
                                   },
                                   "additionalProperties": false,
@@ -4681,6 +4746,10 @@
                                     "wholeWord": {
                                       "type": "boolean",
                                       "description": "Require word-boundary matches. Default: false."
+                                    },
+                                    "includeDeletedText": {
+                                      "type": "boolean",
+                                      "description": "When true, includes text from pending tracked deletions. Default: false."
                                     }
                                   },
                                   "additionalProperties": false,
@@ -5715,6 +5784,10 @@
                                 "wholeWord": {
                                   "type": "boolean",
                                   "description": "Require word-boundary matches. Default: false."
+                                },
+                                "includeDeletedText": {
+                                  "type": "boolean",
+                                  "description": "When true, includes text from pending tracked deletions. Default: false."
                                 }
                               },
                               "additionalProperties": false,
@@ -5808,6 +5881,22 @@
             },
             "description": "Ordered array of mutation steps. Each step needs 'op' (text.rewrite, text.insert, text.delete, format.apply, or assert) and a 'where' targeting clause."
           },
+          "detail": {
+            "type": "object",
+            "properties": {
+              "offset": {
+                "type": "number",
+                "minimum": 0
+              },
+              "limit": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 1000
+              }
+            },
+            "additionalProperties": false,
+            "description": "Only for action 'preview'. Omit for other actions."
+          },
           "force": {
             "type": "boolean",
             "description": "Bypass confirmation checks. Only for action 'apply'. Omit for other actions."

package/tools/tools-policy.json

@@ -43,5 +43,5 @@
       "mutates": true
     }
   ],
-  "contractHash": "02f82dbd04b3ff01becfcb9387d5a23191fd88b17e8fa27a86fe89c9dc046008"
+  "contractHash": "243b9ae43deca7396cb83238901d31cec3aa20fcba31f9ba5eba561f63c6c2cc"
 }

package/tools/tools.anthropic.json

@@ -41,6 +41,41 @@
             "type": "boolean",
             "description": "Only for actions 'markdown_projection', 'html_projection'. Omit for other actions."
           },
+          "nodeIds": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "description": "Top-level block identities to match before pagination. Only for action 'blocks'. Omit for other actions."
+          },
+          "textSearch": {
+            "type": "object",
+            "properties": {
+              "terms": {
+                "type": "array",
+                "minItems": 1,
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "match": {
+                "enum": [
+                  "all",
+                  "any"
+                ]
+              },
+              "caseSensitive": {
+                "type": "boolean"
+              }
+            },
+            "additionalProperties": false,
+            "required": [
+              "terms"
+            ],
+            "description": "Only for action 'blocks'. Omit for other actions."
+          },
           "offset": {
             "type": "number",
             "minimum": 0,
@@ -3250,6 +3285,10 @@
                   "wholeWord": {
                     "type": "boolean",
                     "description": "Require word-boundary matches. Default: false."
+                  },
+                  "includeDeletedText": {
+                    "type": "boolean",
+                    "description": "When true, includes text from pending tracked deletions. Default: false."
                   }
                 },
                 "additionalProperties": false,
@@ -3434,6 +3473,10 @@
                                     "wholeWord": {
                                       "type": "boolean",
                                       "description": "Require word-boundary matches. Default: false."
+                                    },
+                                    "includeDeletedText": {
+                                      "type": "boolean",
+                                      "description": "When true, includes text from pending tracked deletions. Default: false."
                                     }
                                   },
                                   "additionalProperties": false,
@@ -3623,6 +3666,20 @@
                             }
                           ]
                         },
+                        "replacementMode": {
+                          "enum": [
+                            "literal",
+                            "regex-template"
+                          ],
+                          "type": "string"
+                        },
+                        "caseHandling": {
+                          "enum": [
+                            "exact",
+                            "preserve-match"
+                          ],
+                          "type": "string"
+                        },
                         "style": {
                           "type": "object",
                           "properties": {
@@ -3774,6 +3831,10 @@
                                     "wholeWord": {
                                       "type": "boolean",
                                       "description": "Require word-boundary matches. Default: false."
+                                    },
+                                    "includeDeletedText": {
+                                      "type": "boolean",
+                                      "description": "When true, includes text from pending tracked deletions. Default: false."
                                     }
                                   },
                                   "additionalProperties": false,
@@ -4063,6 +4124,10 @@
                                     "wholeWord": {
                                       "type": "boolean",
                                       "description": "Require word-boundary matches. Default: false."
+                                    },
+                                    "includeDeletedText": {
+                                      "type": "boolean",
+                                      "description": "When true, includes text from pending tracked deletions. Default: false."
                                     }
                                   },
                                   "additionalProperties": false,
@@ -4274,6 +4339,10 @@
                                     "wholeWord": {
                                       "type": "boolean",
                                       "description": "Require word-boundary matches. Default: false."
+                                    },
+                                    "includeDeletedText": {
+                                      "type": "boolean",
+                                      "description": "When true, includes text from pending tracked deletions. Default: false."
                                     }
                                   },
                                   "additionalProperties": false,
@@ -5308,6 +5377,10 @@
                                 "wholeWord": {
                                   "type": "boolean",
                                   "description": "Require word-boundary matches. Default: false."
+                                },
+                                "includeDeletedText": {
+                                  "type": "boolean",
+                                  "description": "When true, includes text from pending tracked deletions. Default: false."
                                 }
                               },
                               "additionalProperties": false,
@@ -5401,6 +5474,22 @@
             },
             "description": "Ordered array of mutation steps. Each step needs 'op' (text.rewrite, text.insert, text.delete, format.apply, or assert) and a 'where' targeting clause."
           },
+          "detail": {
+            "type": "object",
+            "properties": {
+              "offset": {
+                "type": "number",
+                "minimum": 0
+              },
+              "limit": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 1000
+              }
+            },
+            "additionalProperties": false,
+            "description": "Only for action 'preview'. Omit for other actions."
+          },
           "force": {
             "type": "boolean",
             "description": "Bypass confirmation checks. Only for action 'apply'. Omit for other actions."

package/tools/tools.generic.json

@@ -41,6 +41,41 @@
             "type": "boolean",
             "description": "Only for actions 'markdown_projection', 'html_projection'. Omit for other actions."
           },
+          "nodeIds": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "description": "Top-level block identities to match before pagination. Only for action 'blocks'. Omit for other actions."
+          },
+          "textSearch": {
+            "type": "object",
+            "properties": {
+              "terms": {
+                "type": "array",
+                "minItems": 1,
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "match": {
+                "enum": [
+                  "all",
+                  "any"
+                ]
+              },
+              "caseSensitive": {
+                "type": "boolean"
+              }
+            },
+            "additionalProperties": false,
+            "required": [
+              "terms"
+            ],
+            "description": "Only for action 'blocks'. Omit for other actions."
+          },
           "offset": {
             "type": "number",
             "minimum": 0,
@@ -3400,6 +3435,10 @@
                   "wholeWord": {
                     "type": "boolean",
                     "description": "Require word-boundary matches. Default: false."
+                  },
+                  "includeDeletedText": {
+                    "type": "boolean",
+                    "description": "When true, includes text from pending tracked deletions. Default: false."
                   }
                 },
                 "additionalProperties": false,
@@ -3600,6 +3639,10 @@
                                     "wholeWord": {
                                       "type": "boolean",
                                       "description": "Require word-boundary matches. Default: false."
+                                    },
+                                    "includeDeletedText": {
+                                      "type": "boolean",
+                                      "description": "When true, includes text from pending tracked deletions. Default: false."
                                     }
                                   },
                                   "additionalProperties": false,
@@ -3789,6 +3832,20 @@
                             }
                           ]
                         },
+                        "replacementMode": {
+                          "enum": [
+                            "literal",
+                            "regex-template"
+                          ],
+                          "type": "string"
+                        },
+                        "caseHandling": {
+                          "enum": [
+                            "exact",
+                            "preserve-match"
+                          ],
+                          "type": "string"
+                        },
                         "style": {
                           "type": "object",
                           "properties": {
@@ -3940,6 +3997,10 @@
                                     "wholeWord": {
                                       "type": "boolean",
                                       "description": "Require word-boundary matches. Default: false."
+                                    },
+                                    "includeDeletedText": {
+                                      "type": "boolean",
+                                      "description": "When true, includes text from pending tracked deletions. Default: false."
                                     }
                                   },
                                   "additionalProperties": false,
@@ -4229,6 +4290,10 @@
                                     "wholeWord": {
                                       "type": "boolean",
                                       "description": "Require word-boundary matches. Default: false."
+                                    },
+                                    "includeDeletedText": {
+                                      "type": "boolean",
+                                      "description": "When true, includes text from pending tracked deletions. Default: false."
                                     }
                                   },
                                   "additionalProperties": false,
@@ -4440,6 +4505,10 @@
                                     "wholeWord": {
                                       "type": "boolean",
                                       "description": "Require word-boundary matches. Default: false."
+                                    },
+                                    "includeDeletedText": {
+                                      "type": "boolean",
+                                      "description": "When true, includes text from pending tracked deletions. Default: false."
                                     }
                                   },
                                   "additionalProperties": false,
@@ -5474,6 +5543,10 @@
                                 "wholeWord": {
                                   "type": "boolean",
                                   "description": "Require word-boundary matches. Default: false."
+                                },
+                                "includeDeletedText": {
+                                  "type": "boolean",
+                                  "description": "When true, includes text from pending tracked deletions. Default: false."
                                 }
                               },
                               "additionalProperties": false,
@@ -5567,6 +5640,22 @@
             },
             "description": "Ordered array of mutation steps. Each step needs 'op' (text.rewrite, text.insert, text.delete, format.apply, or assert) and a 'where' targeting clause."
           },
+          "detail": {
+            "type": "object",
+            "properties": {
+              "offset": {
+                "type": "number",
+                "minimum": 0
+              },
+              "limit": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 1000
+              }
+            },
+            "additionalProperties": false,
+            "description": "Only for action 'preview'. Omit for other actions."
+          },
           "force": {
             "type": "boolean",
             "description": "Bypass confirmation checks. Only for action 'apply'. Omit for other actions."