@tiwater/office-mcp 0.17.34 → 0.18.0

package/office/contracts/tiwater-office-provider-contract-manifest-v1.json

@@ -2,29 +2,29 @@
   "schema": "tiwater.office-provider-contract-manifest/v1",
   "provider": {
     "id": "@tiwater/office-mcp",
-    "version": "0.17.34"
+    "version": "0.18.0"
   },
   "tools": [
     {
       "name": "docx_apply_font_policy",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_apply_font_policy.schema.json",
-        "sha256": "153e50e2f6577b5ea70fd1d3522f8ccf3a74b82b683f1f8fe724f6433a9c72e0"
+        "sha256": "d7c0006cc1ee6a001f8a82f26a9ed260c4ff48babcc7a93b785c019cfa91a3a0"
       },
       "inputContract": {
         "path": "office/contracts/docx_apply_font_policy.schema.json",
-        "sha256": "153e50e2f6577b5ea70fd1d3522f8ccf3a74b82b683f1f8fe724f6433a9c72e0"
+        "sha256": "d7c0006cc1ee6a001f8a82f26a9ed260c4ff48babcc7a93b785c019cfa91a3a0"
       }
     },
     {
       "name": "docx_apply_toc_style_policy",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_apply_toc_style_policy.schema.json",
-        "sha256": "2d4887ab4dc57e2c655f130e67c08886ff1630a889e7258b13519fb6e1529d25"
+        "sha256": "20e97023efe9a06354f22c93fff1576e0102a5d8b16058e9684af9478cb36286"
       },
       "inputContract": {
         "path": "office/contracts/docx_apply_toc_style_policy.schema.json",
-        "sha256": "2d4887ab4dc57e2c655f130e67c08886ff1630a889e7258b13519fb6e1529d25"
+        "sha256": "20e97023efe9a06354f22c93fff1576e0102a5d8b16058e9684af9478cb36286"
       }
     },
     {
@@ -42,33 +42,33 @@
       "name": "docx_copy_content",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_copy_content.schema.json",
-        "sha256": "a988f7c4284c5f99bd3cc28f31813c0a12b999c2486f697776bf6f873c9c49e7"
+        "sha256": "50e1633e97d0aaab32c58935b92aa73128b566ae3ed742bc3ae1a62d0b1ba617"
       },
       "inputContract": {
         "path": "office/contracts/docx_copy_content.schema.json",
-        "sha256": "a988f7c4284c5f99bd3cc28f31813c0a12b999c2486f697776bf6f873c9c49e7"
+        "sha256": "50e1633e97d0aaab32c58935b92aa73128b566ae3ed742bc3ae1a62d0b1ba617"
       }
     },
     {
       "name": "docx_copy_object",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_copy_object.schema.json",
-        "sha256": "5f0bfc826d68f451055aba20390686e0e0df2182797fc36ff285f42d09084104"
+        "sha256": "03bbda134699a76193054a18ca72199d4e74ebd6437a94bb6512a68597dcb0df"
       },
       "inputContract": {
         "path": "office/contracts/docx_copy_object.schema.json",
-        "sha256": "5f0bfc826d68f451055aba20390686e0e0df2182797fc36ff285f42d09084104"
+        "sha256": "03bbda134699a76193054a18ca72199d4e74ebd6437a94bb6512a68597dcb0df"
       }
     },
     {
       "name": "docx_delete_object",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_delete_object.schema.json",
-        "sha256": "a9ef8f5a195a9fd6731023e76731f3aef0905002b160c876e2fbc5288dcde66b"
+        "sha256": "efbb9017fe4b5dd0a66ee7d1229560d006fbca09beffbc6a600bda225b4f2d05"
       },
       "inputContract": {
         "path": "office/contracts/docx_delete_object.schema.json",
-        "sha256": "a9ef8f5a195a9fd6731023e76731f3aef0905002b160c876e2fbc5288dcde66b"
+        "sha256": "efbb9017fe4b5dd0a66ee7d1229560d006fbca09beffbc6a600bda225b4f2d05"
       }
     },
     {
@@ -97,33 +97,33 @@
       "name": "docx_list_objects",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_list_objects.schema.json",
-        "sha256": "f496d10fefe414d49993b447b50ccce4d808fd11e6df8625f8f906de8a2d90bb"
+        "sha256": "2709c5e81ce6a421d12b8ae5752b9251c7e379c0dc5fb5872b658466172a1c2f"
       },
       "inputContract": {
         "path": "office/contracts/docx_list_objects.schema.json",
-        "sha256": "f496d10fefe414d49993b447b50ccce4d808fd11e6df8625f8f906de8a2d90bb"
+        "sha256": "2709c5e81ce6a421d12b8ae5752b9251c7e379c0dc5fb5872b658466172a1c2f"
       }
     },
     {
       "name": "docx_merge_cells",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_merge_cells.schema.json",
-        "sha256": "35958ebea8ef3123c2122b505a3c02fef3a8d423a3f054a9162d144089092d8b"
+        "sha256": "417def05619b271471c76883eea52a2f5772ac399111215df5a7259b8a41c3d1"
       },
       "inputContract": {
         "path": "office/contracts/docx_merge_cells.schema.json",
-        "sha256": "35958ebea8ef3123c2122b505a3c02fef3a8d423a3f054a9162d144089092d8b"
+        "sha256": "417def05619b271471c76883eea52a2f5772ac399111215df5a7259b8a41c3d1"
       }
     },
     {
       "name": "docx_read_object",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_read_object.schema.json",
-        "sha256": "589b616fa60e39107fb6061a67b23387f07acf0d3974a8bf1580cc2567857ff1"
+        "sha256": "f8d29a89c0a321332d5d964c970b2cb18c7ecd59f87e9892e6779747a00f9825"
       },
       "inputContract": {
         "path": "office/contracts/docx_read_object.schema.json",
-        "sha256": "589b616fa60e39107fb6061a67b23387f07acf0d3974a8bf1580cc2567857ff1"
+        "sha256": "f8d29a89c0a321332d5d964c970b2cb18c7ecd59f87e9892e6779747a00f9825"
       }
     },
     {
@@ -152,33 +152,33 @@
       "name": "docx_replace_table_rows",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_replace_table_rows.schema.json",
-        "sha256": "2b2aa0f981767c57b974ff088e8bfe51091cc73bd10ad3eb86a6ce5ff3a798e9"
+        "sha256": "8dfc2cb6f366610281eb6f14118d3855e1e27a34f27b5e2a425690b581ada5a6"
       },
       "inputContract": {
         "path": "office/contracts/docx_replace_table_rows.schema.json",
-        "sha256": "2b2aa0f981767c57b974ff088e8bfe51091cc73bd10ad3eb86a6ce5ff3a798e9"
+        "sha256": "8dfc2cb6f366610281eb6f14118d3855e1e27a34f27b5e2a425690b581ada5a6"
       }
     },
     {
       "name": "docx_set_text",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_set_text.schema.json",
-        "sha256": "f66adf07e6e53599d93ad29420d7a977d869371ef3e0759a128fb2333f8daf08"
+        "sha256": "0e0ccfb2ac910660c6aea6b4dca0e023bd30931c691913647576999b096f43e9"
       },
       "inputContract": {
         "path": "office/contracts/docx_set_text.schema.json",
-        "sha256": "f66adf07e6e53599d93ad29420d7a977d869371ef3e0759a128fb2333f8daf08"
+        "sha256": "0e0ccfb2ac910660c6aea6b4dca0e023bd30931c691913647576999b096f43e9"
       }
     },
     {
       "name": "docx_split_cells",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_split_cells.schema.json",
-        "sha256": "d25ff4b44dade94bf3f09676feae31c93d4ec3a14c22d9f5602f3016d6fd40ec"
+        "sha256": "9d53d0234d98c6cc5cb5b523e1457b777d015c5aaf49cbd745e6598c1793d6bb"
       },
       "inputContract": {
         "path": "office/contracts/docx_split_cells.schema.json",
-        "sha256": "d25ff4b44dade94bf3f09676feae31c93d4ec3a14c22d9f5602f3016d6fd40ec"
+        "sha256": "9d53d0234d98c6cc5cb5b523e1457b777d015c5aaf49cbd745e6598c1793d6bb"
       }
     },
     {

package/office/index.mjs

@@ -161,20 +161,17 @@ function artifactOutput(tool) {
   return z.object({ tool: z.literal(tool), runtime: runtimeIdentity, source: artifact, artifact }).strict();
 }
 
-const docxRevision = z.object({
-  id: z.string().regex(/^docx-rev-v1-[0-9a-f]{64}$/),
-  inputSha256: z.string().regex(/^[A-F0-9]{64}$/),
-  provider: z.literal('tiwater.docx.cli'),
-  toolVersion: z.string(),
+const docxAddress = z.object({
+  part: z.string().min(1),
+  path: z.string().startsWith('/'),
 }).strict();
 
 function docxInspectionOutput(tool) {
   return artifactOutput(tool).extend({
-    revision: docxRevision,
     summary: z.object({
       tableCount: z.number().int().nonnegative(),
       openingParagraphs: z.array(z.object({
-        ref: z.string().regex(/^dox1_[0-9a-f]{64}$/),
+        address: docxAddress,
         textPreview: z.string().min(1).max(240),
       }).strict()).max(6),
     }).strict(),
@@ -182,8 +179,8 @@ function docxInspectionOutput(tool) {
 }
 
 const docxObjectIdentity = z.object({
-  ref: z.string().regex(/^dox1_[0-9a-f]{64}$/),
-  parentRef: z.string().regex(/^dox1_[0-9a-f]{64}$/).nullable(),
+  address: docxAddress,
+  parentAddress: docxAddress.nullable(),
   kind: z.string(),
   textPreview: z.string().nullable(),
   gridSpan: z.number().int().positive().nullable(),
@@ -191,7 +188,7 @@ const docxObjectIdentity = z.object({
 }).strict();
 
 const docxNestedObjectIdentity = docxObjectIdentity.pick({
-  ref: true,
+  address: true,
   kind: true,
   textPreview: true,
 }).extend({
@@ -206,11 +203,10 @@ const docxObservationNode = z.lazy(() => z.object({
 const docxObservationReceipt = z.object({
   schema: z.literal('tiwater.docx-observation-receipt/v1'),
   operation: z.literal('list'),
-  revision: docxRevision,
   totalCount: z.number().int().nonnegative(),
   returnedCount: z.number().int().nonnegative(),
   remaining: z.number().int().nonnegative(),
-  continuation: z.string().nullable(),
+  nextOffset: z.number().int().nonnegative().nullable(),
 }).strict();
 
 const docxListObjectsOutput = artifactOutput('docx_list_objects').extend({
@@ -221,14 +217,13 @@ const docxListObjectsOutput = artifactOutput('docx_list_objects').extend({
 }).strict();
 
 const docxReadObjectOutput = artifactOutput('docx_read_object').extend({
-  revision: docxRevision,
   observations: z.array(docxObservationNode).min(1),
 }).strict();
 
 const tools = [
   {
     name: 'docx_inspect',
-    description: 'Inspect one current DOCX and retain its complete machine observation at output. The response returns the current revision, observation artifact, table count, and up to six opening non-empty body paragraphs for document identity. Use list and read operations to traverse selected document objects in native structure order.',
+    description: 'Inspect one current DOCX and retain its complete machine observation at output. The response returns the observation artifact, table count, and up to six opening non-empty body paragraphs with their OpenXML addresses. Use list and read operations to traverse selected document objects in native structure order.',
     inputSchema: inputContract('docx_inspect'),
     outputSchema: docxInspectionOutput('docx_inspect'),
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -236,7 +231,7 @@ const tools = [
   },
   {
     name: 'docx_list_objects',
-    description: 'List one small page of nearest-child identities from the current DOCX in native document order and retain the exact page at output. This call creates and returns the current revision; it does not accept a revision argument. Request only the object kinds needed by the current local traversal, follow continuation in order, and descend only through returned refs with parentRef. Text previews describe already located objects; they do not prove descendant content.',
+    description: 'List one small page of nearest-child OpenXML addresses from the current DOCX in native document order and retain the exact page at output. Continue with nextOffset and descend through a returned address as parent. Text previews describe already located objects; they do not prove descendant content.',
     inputSchema: inputContract('docx_list_objects'),
     outputSchema: docxListObjectsOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -244,7 +239,7 @@ const tools = [
   },
   {
     name: 'docx_read_object',
-    description: 'Read selected rows, cells, or paragraphs from one native DOCX in one call and return them in refs order. Unlike docx_list_objects, this call accepts the list result revision to reject stale refs. Pass the document path once and only the refs needed for the current target. For exact inline content, use observed cell or paragraph refs and request run or text.',
+    description: 'Read selected rows, cells, or paragraphs from one native DOCX in one call and return them in address order. Pass the document path once and only the OpenXML addresses needed for the current target. For exact inline content, use an observed cell or paragraph address and request run or text.',
     inputSchema: inputContract('docx_read_object'),
     outputSchema: docxReadObjectOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -252,7 +247,7 @@ const tools = [
   },
   {
     name: 'docx_copy_content',
-    description: 'Replace content in existing plain-text target paragraphs or cells while retaining target container formatting and source inline meaning. Targets containing non-text objects are rejected. Batch cells that need exact observed subsets after docx_replace_table_rows. A selection copies a whole object by ref, or an exact substring when range is attached to a run or text ref.',
+    description: 'Replace content in existing plain-text target paragraphs or cells while retaining target container formatting and source inline meaning. A selection copies a whole object by OpenXML address, or an exact substring when range is attached to a run or text address.',
     inputSchema: inputContract('docx_copy_content'),
     outputSchema: fixedEditOutput('docx_copy_content'),
     handler: args => fixedEdit('docx_copy_content', args),
@@ -266,7 +261,7 @@ const tools = [
   },
   {
     name: 'docx_replace_table_rows',
-    description: 'Replace one or more data-row ranges in one current target document. targetDocument appears once; each tables item binds one source document and its source and target rows. All source-cell paragraphs copy by default; sourceCellContents selects exact observed content that the target keeps.',
+    description: 'Replace one or more data-row ranges in one current target document. input appears once; each tables item binds sourceInput and exact source and target OpenXML addresses. All source-cell paragraphs copy by default; sourceCellContents selects exact observed content that the target keeps.',
     inputSchema: inputContract('docx_replace_table_rows'),
     outputSchema: fixedEditOutput('docx_replace_table_rows'),
     handler: args => fixedEdit('docx_replace_table_rows', args),
@@ -484,20 +479,20 @@ function buildServer() {
 }
 
 function compactDocxInspection(report) {
-  if (!report?.tables?.revision || !Array.isArray(report.tables.tables) || !Array.isArray(report.flow)) {
+  if (!Array.isArray(report?.tables?.tables) || !Array.isArray(report.flow)) {
     throw new Error('docx-table-inspection-result-invalid');
   }
   const openingParagraphs = report.flow
     .filter(item => item?.type === 'paragraph'
-      && /^dox1_[0-9a-f]{64}$/u.test(item.objectRef)
+      && typeof item.address?.part === 'string'
+      && typeof item.address?.path === 'string'
       && typeof item.text === 'string' && item.text.trim())
     .slice(0, 6)
     .map(item => ({
-      ref: item.objectRef,
+      address: item.address,
       textPreview: item.text.trim().replace(/\s+/gu, ' ').slice(0, 240),
     }));
   return {
-    revision: report.tables.revision,
     summary: {
       tableCount: report.tables.tables.length,
       openingParagraphs,
@@ -507,8 +502,8 @@ function compactDocxInspection(report) {
 
 function compactDocxObjectIdentity(object) {
   return {
-    ref: object.ref,
-    parentRef: object.parentRef,
+    address: object.address,
+    parentAddress: object.parentAddress,
     kind: object.kind,
     textPreview: object.textPreview,
     gridSpan: object.gridSpan,
@@ -522,7 +517,7 @@ function compactDocxObservation(observation) {
     const identity = compactDocxObjectIdentity(node.object);
     const children = (node.children ?? []).map(compactNode);
     const object = {
-      ref: identity.ref,
+      address: identity.address,
       kind: identity.kind,
       textPreview: children.length === 0 ? identity.textPreview : null,
       ...(identity.gridSpan === null ? {} : { gridSpan: identity.gridSpan }),
@@ -582,7 +577,6 @@ async function docxReadObject(args) {
       runtime: commandRuntime(result),
       source: await fileArtifact(input),
       artifact: await writeJsonArtifact(output, result.json),
-      revision: result.json.receipt.revision,
       observations: result.json.observations.map(compactDocxObservation),
     };
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiwater/office-mcp",
-  "version": "0.17.34",
+  "version": "0.18.0",
   "description": "Published MCP server for Tiwater Office document capabilities",
   "type": "module",
   "license": "MIT",