@superdoc/sdk 2.10.0-next.7 → 2.10.0-next.8

package/dist/index.cjs

@@ -1,5 +1,6 @@
 'use strict';
 
+var documentEvidence = require('./runtime/document-evidence.cjs');
 var client = require('./generated/client.cjs');
 var contract = require('./generated/contract.cjs');
 var process = require('./runtime/process.cjs');
@@ -46,6 +47,14 @@ class BoundRuntime {
         }
         return this.runtime.replaceFile(this.sessionId, source, options);
     }
+    supportsDocumentFacts() {
+        return !this.closed && this.runtime.supportsDocumentFacts(this.sessionId);
+    }
+    async readRevision() {
+        if (this.closed)
+            throw new errors.SuperDocCliError('Document handle is closed; cannot read its revision.', { code: 'DOCUMENT_CLOSED' });
+        return this.runtime.readDocumentRevision(this.sessionId);
+    }
     markClosed() {
         this.closed = true;
     }
@@ -70,6 +79,8 @@ class SuperDocDocumentCore {
         this._openResult = openResult;
         this.client = client$1;
         attachBoundDocApi(this, client.createBoundDocApi(this.boundRuntime));
+        documentEvidence.registerDocumentRevisionReader(this, () => this.boundRuntime.readRevision());
+        documentEvidence.registerDocumentFactCapability(this, () => this.boundRuntime.supportsDocumentFacts());
     }
     get sessionId() {
         return this._sessionId;

package/dist/index.d.ts

@@ -13,6 +13,8 @@ declare class BoundRuntime implements RuntimeInvoker {
     constructor(runtime: SuperDocRuntime, sessionId: string);
     invoke<TData = unknown>(operation: OperationSpec, params?: Record<string, unknown>, options?: InvokeOptions): Promise<TData>;
     replaceFile(source: ReplaceFileSource, options?: ReplaceFileOptions): Promise<ReplaceFileResult>;
+    supportsDocumentFacts(): boolean;
+    readRevision(): Promise<string | undefined>;
     markClosed(): void;
 }
 export interface DocFormatRangeBoundParams extends Omit<DocFormatApplyBoundParams, 'inline'> {
@@ -92,7 +94,7 @@ export { dispatchIntentTool } from './generated/intent-dispatch.generated.js';
 export { wrapV2PresetCompat } from './agent/v2-preset-compat.js';
 export type { BoundDocApi } from './generated/client.js';
 export type { ActionName } from './agent/actions.js';
-export type { AgentReceipt } from './agent/runtime.js';
+export type { AgentReceipt, AgentApplyArgs, AgentVerifyArgs } from './agent/runtime.js';
 export type { GetSystemPromptOptions, GetToolsOptions, GetToolsResult, PresetDescriptor } from './presets.js';
 export { createAgentToolkit } from './tools.js';
 export type { AgentToolkit, CreateAgentToolkitInput } from './tools.js';

package/dist/index.js

@@ -1,3 +1,4 @@
+import { registerDocumentRevisionReader, registerDocumentFactCapability } from './runtime/document-evidence.js';
 import { createDocApi, createBoundDocApi, } from './generated/client.js';
 import { CONTRACT } from './generated/contract.js';
 import { SuperDocRuntime, } from './runtime/process.js';
@@ -38,6 +39,14 @@ class BoundRuntime {
         }
         return this.runtime.replaceFile(this.sessionId, source, options);
     }
+    supportsDocumentFacts() {
+        return !this.closed && this.runtime.supportsDocumentFacts(this.sessionId);
+    }
+    async readRevision() {
+        if (this.closed)
+            throw new SuperDocCliError('Document handle is closed; cannot read its revision.', { code: 'DOCUMENT_CLOSED' });
+        return this.runtime.readDocumentRevision(this.sessionId);
+    }
     markClosed() {
         this.closed = true;
     }
@@ -62,6 +71,8 @@ class SuperDocDocumentCore {
         this._openResult = openResult;
         this.client = client;
         attachBoundDocApi(this, createBoundDocApi(this.boundRuntime));
+        registerDocumentRevisionReader(this, () => this.boundRuntime.readRevision());
+        registerDocumentFactCapability(this, () => this.boundRuntime.supportsDocumentFacts());
     }
     get sessionId() {
         return this._sessionId;

package/dist/presets/core.cjs

@@ -245,7 +245,7 @@ function compactAgentReceipt(receipt) {
             : {}),
         ...(verification
             ? {
-                verificationPassed: verification.every((entry) => entry.passed),
+                verificationPassed: verification.length > 0 && verification.every((entry) => entry.passed),
                 verification: verification.map((entry) => ({
                     check: pickScalarFields(entry.check, undefined, 6),
                     passed: entry.passed,

package/dist/presets/core.js

@@ -241,7 +241,7 @@ function compactAgentReceipt(receipt) {
             : {}),
         ...(verification
             ? {
-                verificationPassed: verification.every((entry) => entry.passed),
+                verificationPassed: verification.length > 0 && verification.every((entry) => entry.passed),
                 verification: verification.map((entry) => ({
                     check: pickScalarFields(entry.check, undefined, 6),
                     passed: entry.passed,

package/dist/runtime/document-evidence.cjs

@@ -0,0 +1,40 @@
+'use strict';
+
+const mutationRevisions = new WeakMap();
+function registerMutationRevision(result, revision) {
+    if (result && typeof result === 'object')
+        mutationRevisions.set(result, revision);
+}
+function getMutationRevision(result) {
+    return result && typeof result === 'object' ? mutationRevisions.get(result) : undefined;
+}
+// Keep transport capabilities off the public document API and tied to the live
+// handle. Undefined means unsupported, never a cached or unknown revision.
+const revisionReaders = new WeakMap();
+function registerDocumentRevisionReader(document, reader) {
+    revisionReaders.set(document, reader);
+}
+function getDocumentRevisionReader(document) {
+    return revisionReaders.get(document);
+}
+const factCapabilities = new WeakMap();
+function registerDocumentFactCapability(document, supported) {
+    factCapabilities.set(document, supported);
+}
+function supportsDocumentFacts(document) {
+    return factCapabilities.get(document)?.() === true;
+}
+function forwardDocumentEvidence(source, target) {
+    const reader = getDocumentRevisionReader(source);
+    if (reader)
+        registerDocumentRevisionReader(target, reader);
+    registerDocumentFactCapability(target, () => supportsDocumentFacts(source));
+}
+
+exports.forwardDocumentEvidence = forwardDocumentEvidence;
+exports.getDocumentRevisionReader = getDocumentRevisionReader;
+exports.getMutationRevision = getMutationRevision;
+exports.registerDocumentFactCapability = registerDocumentFactCapability;
+exports.registerDocumentRevisionReader = registerDocumentRevisionReader;
+exports.registerMutationRevision = registerMutationRevision;
+exports.supportsDocumentFacts = supportsDocumentFacts;

package/dist/runtime/document-evidence.d.ts

@@ -0,0 +1,13 @@
+type RevisionReader = () => Promise<string | undefined>;
+type MutationRevision = {
+    before: string;
+    after: string;
+};
+export declare function registerMutationRevision(result: unknown, revision: MutationRevision): void;
+export declare function getMutationRevision(result: unknown): MutationRevision | undefined;
+export declare function registerDocumentRevisionReader(document: object, reader: RevisionReader): void;
+export declare function getDocumentRevisionReader(document: object): RevisionReader | undefined;
+export declare function registerDocumentFactCapability(document: object, supported: () => boolean): void;
+export declare function supportsDocumentFacts(document: object): boolean;
+export declare function forwardDocumentEvidence(source: object, target: object): void;
+export {};

package/dist/runtime/document-evidence.js

@@ -0,0 +1,30 @@
+const mutationRevisions = new WeakMap();
+export function registerMutationRevision(result, revision) {
+    if (result && typeof result === 'object')
+        mutationRevisions.set(result, revision);
+}
+export function getMutationRevision(result) {
+    return result && typeof result === 'object' ? mutationRevisions.get(result) : undefined;
+}
+// Keep transport capabilities off the public document API and tied to the live
+// handle. Undefined means unsupported, never a cached or unknown revision.
+const revisionReaders = new WeakMap();
+export function registerDocumentRevisionReader(document, reader) {
+    revisionReaders.set(document, reader);
+}
+export function getDocumentRevisionReader(document) {
+    return revisionReaders.get(document);
+}
+const factCapabilities = new WeakMap();
+export function registerDocumentFactCapability(document, supported) {
+    factCapabilities.set(document, supported);
+}
+export function supportsDocumentFacts(document) {
+    return factCapabilities.get(document)?.() === true;
+}
+export function forwardDocumentEvidence(source, target) {
+    const reader = getDocumentRevisionReader(source);
+    if (reader)
+        registerDocumentRevisionReader(target, reader);
+    registerDocumentFactCapability(target, () => supportsDocumentFacts(source));
+}

package/dist/runtime/host.cjs

@@ -4,6 +4,7 @@ var node_child_process = require('node:child_process');
 var node_readline = require('node:readline');
 var transportCommon = require('./transport-common.cjs');
 var errors = require('./errors.cjs');
+var documentEvidence = require('./document-evidence.cjs');
 var documentRpc = require('./document-rpc.cjs');
 
 const HOST_PROTOCOL_VERSION = '1.0';
@@ -130,6 +131,28 @@ class HostTransport {
     async connect() {
         await this.runWhileActive(() => this.ensureConnected());
     }
+    supportsDocumentFacts(sessionId) {
+        return (this.documentRpcSessions.has(sessionId) &&
+            this.hostFeatures.has('document.currentRevision') &&
+            this.hostFeatures.has('document.executionFacts') &&
+            this.hostFeatures.has('document.mutationRevision'));
+    }
+    async readDocumentRevision(sessionId) {
+        return this.runWhileActive(async () => {
+            if (!this.documentRpcSessions.has(sessionId) || !this.hostFeatures.has('document.currentRevision')) {
+                return undefined;
+            }
+            await this.ensureConnected();
+            const revision = await this.sendJsonRpcRequest('document.currentRevision', { sessionId }, this.resolveWatchdogTimeout(undefined), { requestTimeoutMs: this.resolveDocumentRequestTimeout(undefined) });
+            if (typeof revision !== 'string' || revision.trim().length === 0 || revision === 'unknown') {
+                throw new errors.SuperDocCliError('Document host returned an invalid current revision.', {
+                    code: 'HOST_PROTOCOL_ERROR',
+                    details: { sessionId },
+                });
+            }
+            return revision;
+        });
+    }
     async dispose() {
         if (this.disposePromise)
             return this.disposePromise;
@@ -268,12 +291,17 @@ class HostTransport {
                 ? request.params.options
                 : undefined;
             const tracksMutation = request.method === 'document.invoke' && documentOperation.mutates === true && requestOptions?.dryRun !== true;
+            const includeRevision = request.method === 'document.invoke' &&
+                documentOperation.mutates === true &&
+                this.hostFeatures.has('document.mutationRevision');
             if (tracksMutation)
                 this.beginDocumentRpcMutation(sessionId);
             let result;
             try {
-                const response = await this.sendJsonRpcRequest(request.method, request.params, this.resolveWatchdogTimeout(options.timeoutMs), { requestTimeoutMs });
-                result = documentRpc.mapDocumentLifecycleResult(operation.operationId, response, sessionId, operation.operationId === 'doc.save' ? request.params.path === undefined : undefined);
+                const response = await this.sendJsonRpcRequest(request.method, { ...request.params, ...(includeRevision ? { includeRevision: true } : {}) }, this.resolveWatchdogTimeout(options.timeoutMs), { requestTimeoutMs });
+                result = documentRpc.mapDocumentLifecycleResult(operation.operationId, includeRevision ? response.result : response, sessionId, operation.operationId === 'doc.save' ? request.params.path === undefined : undefined);
+                if (includeRevision)
+                    documentEvidence.registerMutationRevision(result, response.revision);
             }
             catch (error) {
                 if (tracksMutation) {

package/dist/runtime/host.d.ts

@@ -61,6 +61,8 @@ export declare class HostTransport {
         processMode?: 'cli' | 'document';
     } & SuperDocClientOptions);
     connect(): Promise<void>;
+    supportsDocumentFacts(sessionId: string): boolean;
+    readDocumentRevision(sessionId: string): Promise<string | undefined>;
     dispose(): Promise<void>;
     private disposeAfterActiveCalls;
     invoke<TData = unknown>(operation: OperationSpec, params?: Record<string, unknown>, options?: TransportInvokeOptions): Promise<TData>;

package/dist/runtime/host.js

@@ -2,6 +2,7 @@ import { spawn } from 'node:child_process';
 import { createInterface } from 'node:readline';
 import { buildOperationArgv, normalizeCollaborationAuth, resolveInvocation, } from './transport-common.js';
 import { SuperDocCliError } from './errors.js';
+import { registerMutationRevision } from './document-evidence.js';
 import { DOCUMENT_RPC_FEATURES, DOCUMENT_RPC_DEFAULT_CHANGE_MODE_FEATURE, DOCUMENT_RPC_REQUEST_TIMEOUT_FEATURE, DOCUMENT_RPC_REPLACE_FILE_FEATURE, DOCUMENT_RPC_SOURCE_SAVE_FEATURE, buildDocumentInvokeParams, buildDocumentOpenParams, canOpenWithDocumentRpc, documentRpcRequestSupportsResponseTimeout, documentRpcEnabled, mapDocumentLifecycleResult, mapDocumentOpenResult, mapDocumentReplaceFileResult, supportsDocumentRpc, } from './document-rpc.js';
 const HOST_PROTOCOL_VERSION = '1.0';
 const CLI_HOST_REQUIRED_FEATURES = ['cli.invoke', 'host.shutdown'];
@@ -127,6 +128,28 @@ export class HostTransport {
     async connect() {
         await this.runWhileActive(() => this.ensureConnected());
     }
+    supportsDocumentFacts(sessionId) {
+        return (this.documentRpcSessions.has(sessionId) &&
+            this.hostFeatures.has('document.currentRevision') &&
+            this.hostFeatures.has('document.executionFacts') &&
+            this.hostFeatures.has('document.mutationRevision'));
+    }
+    async readDocumentRevision(sessionId) {
+        return this.runWhileActive(async () => {
+            if (!this.documentRpcSessions.has(sessionId) || !this.hostFeatures.has('document.currentRevision')) {
+                return undefined;
+            }
+            await this.ensureConnected();
+            const revision = await this.sendJsonRpcRequest('document.currentRevision', { sessionId }, this.resolveWatchdogTimeout(undefined), { requestTimeoutMs: this.resolveDocumentRequestTimeout(undefined) });
+            if (typeof revision !== 'string' || revision.trim().length === 0 || revision === 'unknown') {
+                throw new SuperDocCliError('Document host returned an invalid current revision.', {
+                    code: 'HOST_PROTOCOL_ERROR',
+                    details: { sessionId },
+                });
+            }
+            return revision;
+        });
+    }
     async dispose() {
         if (this.disposePromise)
             return this.disposePromise;
@@ -265,12 +288,17 @@ export class HostTransport {
                 ? request.params.options
                 : undefined;
             const tracksMutation = request.method === 'document.invoke' && documentOperation.mutates === true && requestOptions?.dryRun !== true;
+            const includeRevision = request.method === 'document.invoke' &&
+                documentOperation.mutates === true &&
+                this.hostFeatures.has('document.mutationRevision');
             if (tracksMutation)
                 this.beginDocumentRpcMutation(sessionId);
             let result;
             try {
-                const response = await this.sendJsonRpcRequest(request.method, request.params, this.resolveWatchdogTimeout(options.timeoutMs), { requestTimeoutMs });
-                result = mapDocumentLifecycleResult(operation.operationId, response, sessionId, operation.operationId === 'doc.save' ? request.params.path === undefined : undefined);
+                const response = await this.sendJsonRpcRequest(request.method, { ...request.params, ...(includeRevision ? { includeRevision: true } : {}) }, this.resolveWatchdogTimeout(options.timeoutMs), { requestTimeoutMs });
+                result = mapDocumentLifecycleResult(operation.operationId, includeRevision ? response.result : response, sessionId, operation.operationId === 'doc.save' ? request.params.path === undefined : undefined);
+                if (includeRevision)
+                    registerMutationRevision(result, response.revision);
             }
             catch (error) {
                 if (tracksMutation) {

package/dist/runtime/process.cjs

@@ -57,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();
     }

package/dist/runtime/process.d.ts

@@ -32,6 +32,8 @@ 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>;

package/dist/runtime/process.js

@@ -54,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();
     }

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.10.0-next.7';
+const SDK_VERSION = '2.10.0-next.8';
 
 exports.SDK_VERSION = SDK_VERSION;

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

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.10.0-next.7";
+export declare const SDK_VERSION = "2.10.0-next.8";

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.10.0-next.7';
+export const SDK_VERSION = '2.10.0-next.8';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc/sdk",
-  "version": "2.10.0-next.7",
+  "version": "2.10.0-next.8",
   "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.10.0-next.7",
-    "@superdoc/sdk-darwin-x64": "2.10.0-next.7",
-    "@superdoc/sdk-linux-x64": "2.10.0-next.7",
-    "@superdoc/sdk-linux-arm64": "2.10.0-next.7",
-    "@superdoc/sdk-windows-x64": "2.10.0-next.7"
+    "@superdoc/sdk-darwin-arm64": "2.10.0-next.8",
+    "@superdoc/sdk-darwin-x64": "2.10.0-next.8",
+    "@superdoc/sdk-linux-x64": "2.10.0-next.8",
+    "@superdoc/sdk-linux-arm64": "2.10.0-next.8",
+    "@superdoc/sdk-windows-x64": "2.10.0-next.8"
   },
   "publishConfig": {
     "access": "public"
@@ -50,9 +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 ../../../../tests/consumer-typecheck/src/sdk-replace-file.mts",
-    "test:agent-actions": "bun test src/__tests__/actions.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",
+    "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,

package/tools/tools-policy.json

@@ -43,5 +43,5 @@
       "mutates": true
     }
   ],
-  "contractHash": "2ebd305fc4e4ac63dbc2489355e1907151998252326fc7d2e3f35144da316e15"
+  "contractHash": "2f2396d863395b74209dae900fae2e3eb711890c44d6d9c69060339468ad81d5"
 }

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,

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,

package/tools/tools.openai.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,

package/tools/tools.vercel.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,