@superdoc/sdk 2.22.0-next.9 → 2.23.0-next.1

package/dist/index.d.ts

@@ -94,7 +94,7 @@ export type { AnthropicSystemPrompt, CacheStrategy, SystemPromptForProviderResul
 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, ActionDisposition } from './agent/actions.js';
+export type { ActionName, ActionDisposition, ReplaceTextArgs } from './agent/actions.js';
 export { getActionDispositions } from './agent/actions.js';
 export { getOperationInputAliases } from './agent/operation-catalog.js';
 export type { AgentReceipt, AgentApplyArgs, AgentVerifyArgs, AgentInspectResult } from './agent/runtime.js';

package/dist/prompts/mcp-prompt.md

@@ -18,6 +18,8 @@ These tools handle the OOXML format correctly and preserve document structure.
 
 **Edit with named actions.** `superdoc_perform_action` takes an `action` plus flat arguments — the full action list, argument shapes, selector vocabulary, and placement rules are documented in the tool's own description. Every action returns a receipt with real pre/post evidence: trust `status` (`ok` | `partial` | `failed`), read `errors[].message` for recovery guidance, and re-inspect after `partial`.
 
+**Target one repeated match.** For `replace_text`, scope to one block with a selector and set `occurrence` on the edit (1 = first match in that block) to change only that match. Also pass `expectedRevision` from your latest inspect or receipt; on `REVISION_CONFLICT`, inspect again and recount.
+
 **Tracked changes (redlining).** Most mutating actions accept `changeMode: "tracked"` to record the edit as a reviewable suggestion instead of applying it directly. Review with `accept_tracked_changes` / `reject_tracked_changes` (target one change with `id`, or an exact set with `id:[…]`; or filter by `author` or `changeType`). Do not combine exact IDs with filters. Recover with `undo_changes` / `redo_changes`.
 
 **Failures are safe.** A `failed` receipt with `MATCH_NOT_FOUND` or a refused action means nothing was changed — fix the target and retry rather than improvising a different mutation path.

package/dist/prompts/system-prompt.md

@@ -48,7 +48,7 @@ ACTIONS (superdoc_perform_action with flat args)
 - undo_changes: untilMarker (rendered marker from the original state, e.g. "2.1.") or steps (1-25). Deterministic revert — steps history back until the marker reappears; the receipt proves it. NEVER use steps > 1 blindly: prefer untilMarker, and after ANY undo verify (superdoc_inspect) that content you meant to KEEP still exists — if you overshot, redo_changes {steps:N} steps forward again to recover it.
 - redo_changes: steps (1-25, default 1). Steps history FORWARD to re-apply edits a prior undo removed — THE recovery for an undo overshoot. Only reaches the forward branch until a NEW edit is made.
 - attach_numbering: anchorText (text of the block) or nodeId, likeMarker (rendered marker of a sibling clause, e.g. "10."). Makes an EXISTING block a numbered clause at the same scheme/level — "make this the section 11 heading" in a clause-numbered document is exactly this (it will render as the next number).
-- replace_text: edits:[{find,replace}], caseSensitive default false. selector to scope. changeMode:"tracked" if asked. The receipt reports editsApplied and editsSkipped per find — READ IT: a skipped find is not in the selected block; re-target instead of assuming success.
+- replace_text: edits:[{find,replace,occurrence?}], caseSensitive default false. selector to scope. Keep find/replace spans MINIMAL. If the find appears more than once in the selected block and only one should change, give that edit occurrence (1 = first match in the block; needs selector; not selector.occurrence). With occurrence, also pass expectedRevision from your latest inspect or receipt; on REVISION_CONFLICT inspect again and recount. changeMode:"tracked" if asked. The receipt reports editsApplied and editsSkipped per find — READ IT: a skipped find is not in the selected block; re-target instead of assuming success.
 - delete_text: finds:[string]. selector to scope deletions to ONE block — REQUIRED for whitespace-only finds (unscoped whitespace matches document-wide and is refused). changeMode:"tracked" if asked. Deletes TEXT ONLY: the block survives, so a list item keeps its bullet/number and an accepted tracked deletion leaves an empty numbered item behind. To remove the item itself use delete_blocks.
 - delete_blocks: selectors:[…], each resolving to ONE block (list item, paragraph or heading). changeMode:"tracked" if asked. THE way to DELETE a whole LIST ITEM, paragraph or heading — the bullet/number goes with it and the remaining items renumber. "Delete the first item under Article II" / "remove that clause" is exactly this, NOT delete_text. Pass every target in ONE call. Use delete_table for a whole table.
 - rewrite_block: selector, text. Inspect first to gather current text; never ask the user to paste text already in the doc.

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.22.0-next.9';
+const SDK_VERSION = '2.23.0-next.1';
 
 exports.SDK_VERSION = SDK_VERSION;

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

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.22.0-next.9";
+export declare const SDK_VERSION = "2.23.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.22.0-next.9';
+export const SDK_VERSION = '2.23.0-next.1';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc/sdk",
-  "version": "2.22.0-next.9",
+  "version": "2.23.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.22.0-next.9",
-    "@superdoc/sdk-darwin-x64": "2.22.0-next.9",
-    "@superdoc/sdk-linux-x64": "2.22.0-next.9",
-    "@superdoc/sdk-linux-arm64": "2.22.0-next.9",
-    "@superdoc/sdk-windows-x64": "2.22.0-next.9"
+    "@superdoc/sdk-darwin-arm64": "2.23.0-next.1",
+    "@superdoc/sdk-darwin-x64": "2.23.0-next.1",
+    "@superdoc/sdk-linux-x64": "2.23.0-next.1",
+    "@superdoc/sdk-linux-arm64": "2.23.0-next.1",
+    "@superdoc/sdk-windows-x64": "2.23.0-next.1"
   },
   "publishConfig": {
     "access": "public"

package/tools/catalog.json

@@ -4654,6 +4654,10 @@
             "type": "string",
             "description": "Text content for the new list item. Only for action 'insert'. Omit for other actions."
           },
+          "inheritFrom": {
+            "$ref": "#/$defs/ListItemAddress",
+            "description": "Optional same-story list item to inherit paragraph and run formatting from without changing placement or numbering. When omitted, existing paragraph-creation formatting behavior, including next-style handling, is preserved. Only for action 'insert'. Omit for other actions."
+          },
           "input": {
             "type": "object",
             "description": "Operation input as JSON object."
@@ -6539,7 +6543,7 @@
     },
     {
       "toolName": "superdoc_search",
-      "description": "Find text patterns or nodes in the document and get ref handles for targeting edits and formatting. Refs expire after any mutation that changes the document. Re-search before the next edit when using individual tools (superdoc_edit, superdoc_format). Within a superdoc_mutations batch, selectors in \"where\" clauses resolve automatically at compile time; no manual re-searching needed between steps. Text search returns handle.ref covering only the matched substring. Node search finds blocks by type (paragraph, heading, table, listItem, etc.). The \"require\" parameter controls match cardinality: \"first\" returns one match, \"all\" returns every match, \"exactlyOne\" fails if not exactly one match. Supports scoping via \"within\" to search inside a single block. Patterns are plain text by default; pass select.mode: \"regex\" for regular-expression search (g/gi semantics, 1024-char cap, no wholeWord, capture groups returned on matches). Invalid or unsafe patterns fail with INVALID_INPUT. Do NOT use markdown formatting markers (#, **, etc.) in search patterns. Do NOT use this tool when you already have a ref from superdoc_get_content blocks or superdoc_create; use that ref directly.\n\nEXAMPLES:\n  1. {\"select\":{\"type\":\"text\",\"pattern\":\"Introduction\"},\"require\":\"first\"}\n  2. {\"select\":{\"type\":\"text\",\"pattern\":\"total amount\"},\"require\":\"all\"}\n  3. {\"select\":{\"type\":\"node\",\"nodeType\":\"heading\"},\"require\":\"all\"}\n  4. {\"select\":{\"type\":\"text\",\"pattern\":\"contract\"},\"within\":{\"kind\":\"block\",\"nodeType\":\"paragraph\",\"nodeId\":\"abc123\"},\"require\":\"first\"}",
+      "description": "Find text patterns or nodes in the document and get ref handles for targeting edits and formatting. Refs expire after any mutation that changes the document. Re-search before the next edit when using individual tools (superdoc_edit, superdoc_format). Within a superdoc_mutations batch, selectors in \"where\" clauses resolve automatically at compile time; no manual re-searching needed between steps. Text search returns handle.ref covering only the matched substring. Node search finds blocks by type (paragraph, heading, table, listItem, etc.). The \"require\" parameter controls match cardinality: \"first\" returns one match, \"last\" returns the final match (without limit/offset), \"all\" returns every match, \"exactlyOne\" fails if not exactly one match. Supports scoping via \"within\" to search inside a single block. Patterns are plain text by default; pass select.mode: \"regex\" for regular-expression search (g/gi semantics, 1024-char cap, no wholeWord, capture groups returned on matches). Invalid or unsafe patterns fail with INVALID_INPUT. Do NOT use markdown formatting markers (#, **, etc.) in search patterns. Do NOT use this tool when you already have a ref from superdoc_get_content blocks or superdoc_create; use that ref directly.\n\nEXAMPLES:\n  1. {\"select\":{\"type\":\"text\",\"pattern\":\"Introduction\"},\"require\":\"first\"}\n  2. {\"select\":{\"type\":\"text\",\"pattern\":\"total amount\"},\"require\":\"all\"}\n  3. {\"select\":{\"type\":\"node\",\"nodeType\":\"heading\"},\"require\":\"all\"}\n  4. {\"select\":{\"type\":\"text\",\"pattern\":\"contract\"},\"within\":{\"kind\":\"block\",\"nodeType\":\"paragraph\",\"nodeId\":\"abc123\"},\"require\":\"first\"}",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -6646,10 +6650,11 @@
             "enum": [
               "any",
               "first",
+              "last",
               "exactlyOne",
               "all"
             ],
-            "description": "Match cardinality: 'any' (all matches), 'first' (only first), 'exactlyOne' (fail if != 1), 'all' (fail if 0)."
+            "description": "Match cardinality: 'any' (all matches), 'first' (only first), 'last' (final scoped match, without limit/offset), 'exactlyOne' (fail if != 1), 'all' (fail if 0). For 'last', page.offset reports the selected match's ordinal in the full set."
           },
           "mode": {
             "enum": [
@@ -9225,10 +9230,133 @@
                     "where",
                     "args"
                   ]
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "op": {
+                      "const": "comments.patch",
+                      "type": "string"
+                    },
+                    "args": {
+                      "type": "object",
+                      "properties": {
+                        "commentId": {
+                          "type": "string",
+                          "minLength": 1
+                        },
+                        "target": {
+                          "oneOf": [
+                            {
+                              "$ref": "#/$defs/TextAddress"
+                            },
+                            {
+                              "$ref": "#/$defs/SelectionTarget"
+                            }
+                          ]
+                        }
+                      },
+                      "additionalProperties": false,
+                      "required": [
+                        "commentId",
+                        "target"
+                      ]
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "id",
+                    "op",
+                    "args"
+                  ]
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "op": {
+                      "const": "trackChanges.decide",
+                      "type": "string"
+                    },
+                    "args": {
+                      "type": "object",
+                      "properties": {
+                        "decision": {
+                          "enum": [
+                            "accept",
+                            "reject"
+                          ],
+                          "type": "string"
+                        },
+                        "target": {
+                          "oneOf": [
+                            {
+                              "type": "object",
+                              "properties": {
+                                "kind": {
+                                  "const": "id",
+                                  "type": "string"
+                                },
+                                "id": {
+                                  "type": "string",
+                                  "minLength": 1
+                                }
+                              },
+                              "additionalProperties": false,
+                              "required": [
+                                "kind",
+                                "id"
+                              ]
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "kind": {
+                                  "const": "ids",
+                                  "type": "string"
+                                },
+                                "ids": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string",
+                                    "minLength": 1
+                                  },
+                                  "minItems": 1
+                                }
+                              },
+                              "additionalProperties": false,
+                              "required": [
+                                "kind",
+                                "ids"
+                              ]
+                            }
+                          ]
+                        }
+                      },
+                      "additionalProperties": false,
+                      "required": [
+                        "decision",
+                        "target"
+                      ]
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "id",
+                    "op",
+                    "args"
+                  ]
                 }
               ]
             },
-            "description": "Ordered array of mutation steps. Each step needs 'op' (text.rewrite, text.insert, text.delete, format.apply, structural.replace, or assert) and a 'where' targeting clause. Check runtime capabilities for operation-specific content and targeting restrictions."
+            "description": "Ordered array of mutation steps. Each step needs 'op' (text.rewrite, text.insert, text.delete, format.apply, structural.replace, assert, comments.patch, or trackChanges.decide). Core steps use 'where'; review steps use explicit native args and require direct body-only plans with relocations before decisions. Check runtime capabilities for operation-specific content and targeting restrictions."
           },
           "detail": {
             "type": "object",
@@ -9299,6 +9427,22 @@
               "exact"
             ]
           },
+          "Range": {
+            "type": "object",
+            "properties": {
+              "start": {
+                "type": "integer"
+              },
+              "end": {
+                "type": "integer"
+              }
+            },
+            "additionalProperties": false,
+            "required": [
+              "start",
+              "end"
+            ]
+          },
           "SectionAddress": {
             "type": "object",
             "properties": {
@@ -9590,6 +9734,30 @@
               }
             ]
           },
+          "TextAddress": {
+            "type": "object",
+            "properties": {
+              "kind": {
+                "const": "text",
+                "type": "string"
+              },
+              "blockId": {
+                "type": "string"
+              },
+              "range": {
+                "$ref": "#/$defs/Range"
+              },
+              "story": {
+                "$ref": "#/$defs/StoryLocator"
+              }
+            },
+            "additionalProperties": false,
+            "required": [
+              "kind",
+              "blockId",
+              "range"
+            ]
+          },
           "TextCoordinateSpace": {
             "enum": [
               "visible",

package/tools/generation-receipt.json

@@ -1,8 +1,8 @@
 {
   "formatVersion": 1,
-  "contractHash": "dd7b9b962daee4a51a4f44f17e9cb12d713fd32af5216c9a3ebe55ab9f737784",
-  "documentApiSourceHash": "f6fa420753dd325c30bb7aea67da9fc8244dc2511d432c06f94af404f91489e7",
-  "generatorHash": "a968f5050a487559bf14155b1700206e0a836ad28241f34257265c5f7d26fe39",
+  "contractHash": "a50e3283a59cc54e270632a210613381fcc1fcb469df230377ca36b4580ff65b",
+  "documentApiSourceHash": "788fb8f77b3891ff66bc0f288c8279a2eeda74ac758cd310e00d297bb47468ab",
+  "generatorHash": "fb5b46535ab172607fc6d07e1ff578237a974b75f05f0e23137e8cc76bb7c98e",
   "inputs": {
     "apps/cli/src/host/sdk-policy.ts": "0adb494bf71f21f9736080b79d59a4205fa9445caa806e28333b738e99e764a7",
     "packages/sdk/codegen/src/artifacts.mjs": "aecab7eca4694cbcf2366ddd9cabc033abddad2ff8fb0960d505580dbaf4d8b7",
@@ -15,16 +15,16 @@
     "packages/sdk/codegen/src/model/schema.mjs": "29cb1167413280907ad324d8a1fcb54dc70cce829df00c1a755f43040d01cf3b",
     "packages/sdk/codegen/src/shared.mjs": "a411e7ea4fab43b5b08b00294c746ff7063ceddbae66ece8d8c5990f131e0f7c",
     "packages/sdk/codegen/src/targets.mjs": "62c5ae3e3813e07b37e62487d973bac60ef6bea558a01f3ace2e0c6e8374e147",
-    "packages/sdk/langs/node/package.json": "6a94a411a646de4582777c858d2df217257a5809495588e9028c61b09d8717af",
+    "packages/sdk/langs/node/package.json": "efd825a5e97cece804c736e10eb843a3ed7a2e4ebb8c2a5ada80380ecd9a6e45",
     "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": "bd979170c1deaa5e7a5df26a8ddeb82b52358645b39a6bef1e7aaade1ff36561",
-    "packages/sdk/langs/node/src/prompts/mcp-prompt.md": "52d9bfbce0ee83923effc7586ffe699050ca90b5e1a5e9a683091e5a293d4524",
-    "packages/sdk/langs/node/src/prompts/system-prompt.md": "639b059ea7cee37402e04bde8263bd1db108822e22812ab0ebeb297aa3de83a7",
+    "packages/sdk/langs/node/src/agent/action-descriptors.json": "427fdf2a163bbc6c25f0a165b84cfb17ea2b27a92611ec74cdc19bc77bff2594",
+    "packages/sdk/langs/node/src/prompts/mcp-prompt.md": "ba1e239877b2b316744477e3ca7b6982fa265edb1358759209cc439457728e8b",
+    "packages/sdk/langs/node/src/prompts/system-prompt.md": "4881073df51001a5e448ef7f755cd858cf752c66374cb8bddc328b1356b3cc6a",
     "packages/sdk/scripts/sdk-generate.mjs": "fc5b0cb07a39972694a0c60cfef19b2e166ec12890fb5060e97b2b818f746ef3",
     "packages/sdk/scripts/sdk-platform-targets.mjs": "6bdcd55fec9695c7af44ee5c7f67065450f61c27cdd9552d68b92e88abb9d7ab",
-    "packages/sdk/tools/prompt-templates/system-prompt-core.md": "4244b9d4c9ec01b14c4b5a56e7525aceed97304326d2b4fc2c3f31af9ec3b65f",
+    "packages/sdk/tools/prompt-templates/system-prompt-core.md": "98632908dbece800115db92181b2a48823725b6e2612383de6bc6c34f57ac72e",
     "packages/sdk/tools/prompt-templates/system-prompt-mcp-header.md": "95e73c78805619991732671991f5aa28c0ab9967344a53ad3ae95b397f6058f7",
     "packages/sdk/tools/prompt-templates/system-prompt-sdk-header.md": "a672b9e5c3ca62685b082f1ac340a66348b37f831303c6cf0d39da9d236cdabe",
     "scripts/generate-all.mjs": "fbcb0920173f8170321a3583e18b2b175e54cdca47b39f3c390c727cf9a5f911"
@@ -32,14 +32,14 @@
   "outputs": {
     "packages/sdk/langs/node/src/generated/contract.ts": {
       "id": "node-contract",
-      "sha256": "87898169c18db17d07784aff9eb3ab065e142bb7053195cf5b2e8128dc920621",
+      "sha256": "185ecff25e6ff73b391a95fa7a1dd6a3af3f81bb6318cada6d121263737cd689",
       "consumers": [
         "node"
       ]
     },
     "packages/sdk/langs/node/src/generated/client.ts": {
       "id": "node-client",
-      "sha256": "af01f15056457436ea412e7362106ea068291632714adc7baddbf1904d70d9f4",
+      "sha256": "e6ee297f64a0e00378d50491bef239b932a143bb9b2e5ee8e9af98aeeaa6245b",
       "consumers": [
         "node"
       ]
@@ -53,14 +53,14 @@
     },
     "packages/sdk/langs/python/superdoc/generated/contract.py": {
       "id": "python-contract",
-      "sha256": "98a10378b1d3709768d9e803efe3a8df43b6abf6fcadedce91bf9c27af940d0c",
+      "sha256": "8a71886c326df7b48a3efc1acb659adc2e7f8a7d87b21f8619a85eb0bdc1c3d8",
       "consumers": [
         "python"
       ]
     },
     "packages/sdk/langs/python/superdoc/generated/client.py": {
       "id": "python-client",
-      "sha256": "c4345e834969e4307a69d7b0d0f1ed7133f7bc4f0ad2a768dd7173e2258d5de4",
+      "sha256": "6704bcf6094845ff51e5825b0224a370e3314f5dd9c003318c675e4f8fda1e57",
       "consumers": [
         "python"
       ]
@@ -95,7 +95,7 @@
     },
     "packages/sdk/tools/catalog.json": {
       "id": "tool-catalog",
-      "sha256": "2b0182baf58f7ff185e46df497d0f2530e4261177265c8da092b733e932d50a6",
+      "sha256": "b05b12f34b4260c0a9785e5f4a7fb532a3e0fb0a1a839dea6b0dfdfa9d6857a1",
       "consumers": [
         "node",
         "python",
@@ -104,7 +104,7 @@
     },
     "packages/sdk/tools/tools-policy.json": {
       "id": "tool-policy",
-      "sha256": "4367c9b439439760d226c4834b6388b83e79d23aa4ff65f533faf3941ca70f31",
+      "sha256": "00f8fccf89404c4cab88d8b97dee419527017734cc8080aab8a249d4a91e4434",
       "consumers": [
         "node",
         "python"
@@ -112,7 +112,7 @@
     },
     "packages/sdk/tools/tools.openai.json": {
       "id": "tools-openai",
-      "sha256": "efce0c7cca138513f35db41695f42f4948994c8856d5b3f167b017605e2ffc06",
+      "sha256": "18889daddc39778b0e51bcff628e015a52f7880dcf56ff7e0bea25c1123e73ce",
       "consumers": [
         "node",
         "python",
@@ -121,7 +121,7 @@
     },
     "packages/sdk/tools/tools.anthropic.json": {
       "id": "tools-anthropic",
-      "sha256": "d40c5679be490694368302d70c64f98e427d1e00bed7ad4d14590b43a96fec77",
+      "sha256": "a53f53b90f5333b87e1cb38e24de5b2d203709d7dba78575f2830cdef67a1d74",
       "consumers": [
         "node",
         "python",
@@ -130,7 +130,7 @@
     },
     "packages/sdk/tools/tools.vercel.json": {
       "id": "tools-vercel",
-      "sha256": "efce0c7cca138513f35db41695f42f4948994c8856d5b3f167b017605e2ffc06",
+      "sha256": "18889daddc39778b0e51bcff628e015a52f7880dcf56ff7e0bea25c1123e73ce",
       "consumers": [
         "node",
         "python",
@@ -139,7 +139,7 @@
     },
     "packages/sdk/tools/tools.generic.json": {
       "id": "tools-generic",
-      "sha256": "32cfd9c177fd6fc198f8d2df50cbc3b7dd0b5407e73505fdd4840b9e7b6e504b",
+      "sha256": "d9f8c272226a5af79949883bcab18a80ba9211c52f6bce1b27960474c4917122",
       "consumers": [
         "node",
         "python",
@@ -148,7 +148,7 @@
     },
     "packages/sdk/tools/system-prompt.md": {
       "id": "sdk-prompt",
-      "sha256": "89eed0297c478f9cb8300901b45c7cf4a4339fa274b71d4309642f5e1bfd5b85",
+      "sha256": "0f08f5ac17b8c4039515a10a227e7c7f6b6a97e05e92fc2e74bdab8da5f4dfd8",
       "consumers": [
         "node",
         "python"
@@ -156,7 +156,7 @@
     },
     "packages/sdk/tools/system-prompt-mcp.md": {
       "id": "mcp-prompt",
-      "sha256": "06a6108117ef8757f73fe8a72e65242d7ef64417b8fe8c3b8c25327a3c9f79de",
+      "sha256": "fdc0e7586e4f6e96b62534ac2b1f74e720523a1bc74e6173e4e80eade2a492b6",
       "consumers": [
         "node",
         "python",
@@ -165,28 +165,28 @@
     },
     "packages/sdk/langs/browser/src/system-prompt.ts": {
       "id": "browser-prompt",
-      "sha256": "4450afb007ca40145578b6651651259a425b8d810c1f463c1843e273ed9cc7ca",
+      "sha256": "cc004dc5aa982c7fe28a1bbba50088c96ce45c48f78446a9f2274d193dc5e658",
       "consumers": [
         "browser"
       ]
     },
     "packages/sdk/langs/node/src/embedded-prompts.generated.ts": {
       "id": "node-embedded-prompts",
-      "sha256": "928cd084dec825f7092ce19b4f230df0e4a900b4c3370ecb2f2f43690ac9cfd4",
+      "sha256": "d9cca82bd3d4593285e5eb274fd0b9b309aacb7217c60b7c7d9754ad5b5426c6",
       "consumers": [
         "node"
       ]
     },
     "packages/sdk/langs/node/src/embedded-tools.generated.ts": {
       "id": "node-embedded-tools",
-      "sha256": "4d6d4a9c4355d77490f5e0b98af91a1f77f061069883a2cd0caeed1f623023eb",
+      "sha256": "a0069774a330ab0bbd9217260c6cdb9fcecc6a51dfb993d70e29a8944581e2ef",
       "consumers": [
         "node"
       ]
     },
     "packages/sdk/langs/node/src/runtime/sdk-version.generated.ts": {
       "id": "node-sdk-version",
-      "sha256": "c045cffe3d33182ec4d9337b54817867c9f3d800779c8eca0f4dc5bfa3ca4bf9",
+      "sha256": "2df5d7961edeb5c70c2ff21e0681e94cd325a0874e8996708d41873ef60a7adc",
       "consumers": [
         "node"
       ]

package/tools/prompt-templates/system-prompt-core.md

@@ -425,6 +425,7 @@ When formatting newly created content, use the right source:
 - **`within` scopes to a single block**, not a section. To find text in a section, search the full document.
 - **Table cells are separate blocks.** Search for individual cell values, not patterns spanning multiple cells.
 - **Do NOT combine `limit`/`offset` with `require: "first"` or `require: "exactlyOne"`.** Use `require: "any"` with `limit` for paginated results.
+- **`require: "last"` returns the final match and rejects any `limit` or `offset`.**
 - **Do NOT hardcode formatting values.** Always read from blocks data and replicate.
 - **Do NOT copy heading/title formatting onto body paragraphs.** Read from body text blocks (alignment "justify" or "left"), not title blocks.
 - **Pass structured objects, not JSON-encoded strings.** Fields like `at`, `target`, and `inline` expect objects, not serialized JSON strings.

package/tools/system-prompt-mcp.md

@@ -475,6 +475,7 @@ When formatting newly created content, use the right source:
 - **`within` scopes to a single block**, not a section. To find text in a section, search the full document.
 - **Table cells are separate blocks.** Search for individual cell values, not patterns spanning multiple cells.
 - **Do NOT combine `limit`/`offset` with `require: "first"` or `require: "exactlyOne"`.** Use `require: "any"` with `limit` for paginated results.
+- **`require: "last"` returns the final match and rejects any `limit` or `offset`.**
 - **Do NOT hardcode formatting values.** Always read from blocks data and replicate.
 - **Do NOT copy heading/title formatting onto body paragraphs.** Read from body text blocks (alignment "justify" or "left"), not title blocks.
 - **Pass structured objects, not JSON-encoded strings.** Fields like `at`, `target`, and `inline` expect objects, not serialized JSON strings.

package/tools/system-prompt.md

@@ -429,6 +429,7 @@ When formatting newly created content, use the right source:
 - **`within` scopes to a single block**, not a section. To find text in a section, search the full document.
 - **Table cells are separate blocks.** Search for individual cell values, not patterns spanning multiple cells.
 - **Do NOT combine `limit`/`offset` with `require: "first"` or `require: "exactlyOne"`.** Use `require: "any"` with `limit` for paginated results.
+- **`require: "last"` returns the final match and rejects any `limit` or `offset`.**
 - **Do NOT hardcode formatting values.** Always read from blocks data and replicate.
 - **Do NOT copy heading/title formatting onto body paragraphs.** Read from body text blocks (alignment "justify" or "left"), not title blocks.
 - **Pass structured objects, not JSON-encoded strings.** Fields like `at`, `target`, and `inline` expect objects, not serialized JSON strings.

package/tools/tools-policy.json

@@ -43,5 +43,5 @@
       "mutates": true
     }
   ],
-  "contractHash": "dd7b9b962daee4a51a4f44f17e9cb12d713fd32af5216c9a3ebe55ab9f737784"
+  "contractHash": "a50e3283a59cc54e270632a210613381fcc1fcb469df230377ca36b4580ff65b"
 }