@tiwater/office-mcp 0.21.38 → 0.21.40

package/_shared/effect-kind.mjs

@@ -5,6 +5,7 @@ export const effectKindSchema = 'tiwater.provider-effect-kind/v1';
 export const documentRevisionRoleKey = 'x-tiwater-document-revision-role';
 
 const effectKinds = new Set([
+  'document-create',
   'document-mutation',
   'source-conversion',
   'native-render',
@@ -46,10 +47,15 @@ export function assertEffectKindToolContract(tool, expectedKind = undefined) {
   if (expectedKind !== undefined && metadata.kind !== expectedKind) {
     throw new Error(`effect-kind-mismatch:${tool?.name || 'unnamed'}:${metadata.kind}`);
   }
-  if (!bindings.some(binding => binding.role === 'read')) {
+  if (metadata.kind !== 'document-create' && !bindings.some(binding => binding.role === 'read')) {
     throw new Error(`effect-kind-source-binding-missing:${tool?.name || 'unnamed'}`);
   }
-  if (metadata.kind === 'document-mutation') {
+  if (metadata.kind === 'document-create') {
+    if (bindings.some(binding => binding.role === 'read')
+        || currentDocumentBindings.length !== 0 || effectiveWrites.length !== 1) {
+      throw new Error(`document-create-bindings-invalid:${tool?.name || 'unnamed'}`);
+    }
+  } else if (metadata.kind === 'document-mutation') {
     if (currentDocumentBindings.length !== 1) {
       throw new Error(`document-mutation-current-binding-invalid:${tool?.name || 'unnamed'}`);
     }
@@ -70,6 +76,16 @@ export function assertEffectKindToolContract(tool, expectedKind = undefined) {
   return metadata.kind;
 }
 
+export function documentCreateFileArguments(tool, args) {
+  assertEffectKindToolContract(tool, 'document-create');
+  const bindings = boundFileArguments(tool?.inputSchema, args);
+  const effectiveOutput = bindings.filter(binding => binding.role === 'write' && binding.effect);
+  if (bindings.some(binding => binding.role === 'read') || effectiveOutput.length !== 1) {
+    throw new Error(`document-create-file-arguments-invalid:${tool?.name || 'unnamed'}`);
+  }
+  return { effectiveOutput: effectiveOutput[0].value };
+}
+
 export function documentMutationFileArguments(tool, args) {
   assertEffectKindToolContract(tool, 'document-mutation');
   const bindings = boundFileArguments(tool?.inputSchema, args);

package/office/contracts/docx_compare.schema.json

@@ -20,7 +20,8 @@
       "type": "string",
       "minLength": 1,
       "description": "Absolute path for a new JSON file containing the complete result. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write"
+      "x-tiwater-file-role": "write",
+      "x-tiwater-file-effect": false
     }
   },
   "required": [

package/office/contracts/docx_create.schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "tiwater.office-mcp-input/docx_create/v1",
+  "type": "object",
+  "properties": {
+    "output": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New DOCX path. Existing files are never overwritten.",
+      "x-tiwater-file-role": "write"
+    },
+    "receiptOutput": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New JSON receipt path. Existing files are never overwritten.",
+      "x-tiwater-file-role": "write",
+      "x-tiwater-file-effect": false
+    }
+  },
+  "required": ["output", "receiptOutput"],
+  "additionalProperties": false
+}

package/office/contracts/docx_list_objects.schema.json

@@ -54,12 +54,6 @@
       "additionalProperties": false,
       "description": "Optional parent OpenXML address. Only nearest published children are returned."
     },
-    "limit": {
-      "default": 50,
-      "type": "integer",
-      "minimum": 1,
-      "maximum": 2147483647
-    },
     "offset": {
       "default": 0,
       "type": "integer",
@@ -70,7 +64,8 @@
       "type": "string",
       "minLength": 1,
       "description": "Optional path for retaining the complete requested page. May be combined with returnContent.",
-      "x-tiwater-file-role": "write"
+      "x-tiwater-file-role": "write",
+      "x-tiwater-file-effect": false
     }
   },
   "required": [

package/office/contracts/docx_read_object.schema.json

@@ -57,7 +57,8 @@
       "type": "string",
       "minLength": 1,
       "description": "Optional path for retaining the complete selected observation. May be combined with returnContent.",
-      "x-tiwater-file-role": "write"
+      "x-tiwater-file-role": "write",
+      "x-tiwater-file-effect": false
     }
   },
   "required": [

package/office/contracts/docx_read_table.schema.json

@@ -30,7 +30,8 @@
       "type": "string",
       "minLength": 1,
       "description": "Optional path for retaining the selected detailed row page. May be combined with returnContent.",
-      "x-tiwater-file-role": "write"
+      "x-tiwater-file-role": "write",
+      "x-tiwater-file-effect": false
     }
   },
   "required": ["input", "table", "returnContent"],

package/office/contracts/docx_table_index.schema.json

@@ -17,7 +17,8 @@
       "type": "string",
       "minLength": 1,
       "description": "Optional new JSON artifact path for retaining the complete table index. May be combined with returnContent.",
-      "x-tiwater-file-role": "write"
+      "x-tiwater-file-role": "write",
+      "x-tiwater-file-effect": false
     },
     "offset": {
       "type": "integer",

package/office/contracts/docx_validate.schema.json

@@ -15,7 +15,8 @@
       "type": "string",
       "minLength": 1,
       "description": "Absolute path for a new JSON file containing the complete result. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write"
+      "x-tiwater-file-role": "write",
+      "x-tiwater-file-effect": false
     }
   },
   "required": [

package/office/contracts/docx_validate_font_policy.schema.json

@@ -48,7 +48,8 @@
       "type": "string",
       "minLength": 1,
       "description": "Absolute path for a new JSON file containing the complete result. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write"
+      "x-tiwater-file-role": "write",
+      "x-tiwater-file-effect": false
     }
   },
   "required": [

package/office/contracts/docx_validate_toc_style_policy.schema.json

@@ -23,7 +23,8 @@
       "type": "string",
       "minLength": 1,
       "description": "Absolute path for a new JSON file containing the complete result. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write"
+      "x-tiwater-file-role": "write",
+      "x-tiwater-file-effect": false
     }
   },
   "required": [

package/office/contracts/pptx_read_shape.schema.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "tiwater.office-mcp-input/pptx_read_shape/v1",
+  "type": "object",
+  "properties": {
+    "input": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Current PPTX presentation.",
+      "x-tiwater-file-role": "read"
+    },
+    "slideNumber": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 9007199254740991,
+      "description": "Exact one-based slide number returned by presentation observation."
+    },
+    "shapeId": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 4294967295,
+      "description": "Exact native shape id returned by pptx_read_slide."
+    },
+    "offset": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 9007199254740991,
+      "description": "Zero-based text-segment offset within the selected shape. Continue only when another segment is needed."
+    },
+    "returnContent": {
+      "type": "boolean",
+      "description": "Return this selected technical page directly when it fits the response limit. May be combined with output."
+    },
+    "output": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Optional immutable JSON artifact path for this selected technical page. May be combined with returnContent.",
+      "x-tiwater-file-role": "write",
+      "x-tiwater-file-effect": false
+    }
+  },
+  "required": ["input", "slideNumber", "shapeId", "returnContent"],
+  "additionalProperties": false
+}

package/office/contracts/pptx_read_slide.schema.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "tiwater.office-mcp-input/pptx_read_slide/v1",
+  "type": "object",
+  "properties": {
+    "input": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Current PPTX presentation.",
+      "x-tiwater-file-role": "read"
+    },
+    "slideNumber": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 9007199254740991,
+      "description": "Exact one-based slide number returned by presentation observation."
+    },
+    "offset": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 9007199254740991,
+      "description": "Zero-based shape offset in native z-order on the selected slide. Continue only when another selected shape is needed."
+    },
+    "returnContent": {
+      "type": "boolean",
+      "description": "Return this selected technical page directly when it fits the response limit. May be combined with output."
+    },
+    "output": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Optional immutable JSON artifact path for this selected technical page. May be combined with returnContent.",
+      "x-tiwater-file-role": "write",
+      "x-tiwater-file-effect": false
+    }
+  },
+  "required": ["input", "slideNumber", "returnContent"],
+  "additionalProperties": false
+}

package/office/contracts/pptx_validate.schema.json

@@ -15,7 +15,8 @@
       "type": "string",
       "minLength": 1,
       "description": "Absolute path for a new JSON file containing the complete result. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write"
+      "x-tiwater-file-role": "write",
+      "x-tiwater-file-effect": false
     }
   },
   "required": [

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

@@ -2,7 +2,7 @@
   "schema": "tiwater.office-provider-contract-manifest/v1",
   "provider": {
     "id": "@tiwater/office-mcp",
-    "version": "0.21.38"
+    "version": "0.21.40"
   },
   "tools": [
     {
@@ -31,11 +31,22 @@
       "name": "docx_compare",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_compare.schema.json",
-        "sha256": "a6d59ee785d8ab3994eb6f539b48411b272565ac136219de58d39a449b3112f3"
+        "sha256": "bcad394d99a118cee1b1b5d62fc08acba2b77de27d6c29c63535049150f2016a"
       },
       "inputContract": {
         "path": "office/contracts/docx_compare.schema.json",
-        "sha256": "a6d59ee785d8ab3994eb6f539b48411b272565ac136219de58d39a449b3112f3"
+        "sha256": "bcad394d99a118cee1b1b5d62fc08acba2b77de27d6c29c63535049150f2016a"
+      }
+    },
+    {
+      "name": "docx_create",
+      "providerContract": {
+        "source": "packages/docx-cli/contracts/mcp-input/docx_create.schema.json",
+        "sha256": "1cf22a23fc5d8b27fff6f50db2672be623696eac79ea986053e703274eab5e3e"
+      },
+      "inputContract": {
+        "path": "office/contracts/docx_create.schema.json",
+        "sha256": "1cf22a23fc5d8b27fff6f50db2672be623696eac79ea986053e703274eab5e3e"
       }
     },
     {
@@ -108,11 +119,11 @@
       "name": "docx_list_objects",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_list_objects.schema.json",
-        "sha256": "f00b36f429ef4e6c68fcb39fd141024897a97ecac89378e3fc1e45cd6c04e906"
+        "sha256": "1f8d857c837d258e14959895260ac7f5c5041b381cdc936c2c4194e0c0b949ae"
       },
       "inputContract": {
         "path": "office/contracts/docx_list_objects.schema.json",
-        "sha256": "f00b36f429ef4e6c68fcb39fd141024897a97ecac89378e3fc1e45cd6c04e906"
+        "sha256": "1f8d857c837d258e14959895260ac7f5c5041b381cdc936c2c4194e0c0b949ae"
       }
     },
     {
@@ -130,22 +141,22 @@
       "name": "docx_read_object",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_read_object.schema.json",
-        "sha256": "ab93256991eaf665dfc096cf7df9ba2b4ba26ad6c11813d885a3c5ff2c2fa45b"
+        "sha256": "bb75dc704a2da4dfbd69004a21697d6824011036e1153778b839357f642c7057"
       },
       "inputContract": {
         "path": "office/contracts/docx_read_object.schema.json",
-        "sha256": "ab93256991eaf665dfc096cf7df9ba2b4ba26ad6c11813d885a3c5ff2c2fa45b"
+        "sha256": "bb75dc704a2da4dfbd69004a21697d6824011036e1153778b839357f642c7057"
       }
     },
     {
       "name": "docx_read_table",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_read_table.schema.json",
-        "sha256": "0b7a5669daeaa6f8e171ba01542b4bfd065cd282a32943e7b5b5854551b4afc7"
+        "sha256": "a0d13fb70cc43d7ee7f3be9730f98df9a5e988d33fb7454b44f5e455d068b950"
       },
       "inputContract": {
         "path": "office/contracts/docx_read_table.schema.json",
-        "sha256": "0b7a5669daeaa6f8e171ba01542b4bfd065cd282a32943e7b5b5854551b4afc7"
+        "sha256": "a0d13fb70cc43d7ee7f3be9730f98df9a5e988d33fb7454b44f5e455d068b950"
       }
     },
     {
@@ -240,44 +251,44 @@
       "name": "docx_table_index",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_table_index.schema.json",
-        "sha256": "737052f653fe0d222bfc2b808e0fbc298376ab88cf052352888ff02e5b71ed52"
+        "sha256": "4dbc4079269d5c37ed8fd213f3987bea82843c2e5d4d17fae169cecd17d44964"
       },
       "inputContract": {
         "path": "office/contracts/docx_table_index.schema.json",
-        "sha256": "737052f653fe0d222bfc2b808e0fbc298376ab88cf052352888ff02e5b71ed52"
+        "sha256": "4dbc4079269d5c37ed8fd213f3987bea82843c2e5d4d17fae169cecd17d44964"
       }
     },
     {
       "name": "docx_validate",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_validate.schema.json",
-        "sha256": "57c25f53aa319dc0e9aafc5cd3fa5f0ea12f28c50fe4a39955caa40e2dfc12d5"
+        "sha256": "06d5f29f7ed23ab53fdf7a5de09cbfb6a800e7a19ae076a3d6d80abf22c464be"
       },
       "inputContract": {
         "path": "office/contracts/docx_validate.schema.json",
-        "sha256": "57c25f53aa319dc0e9aafc5cd3fa5f0ea12f28c50fe4a39955caa40e2dfc12d5"
+        "sha256": "06d5f29f7ed23ab53fdf7a5de09cbfb6a800e7a19ae076a3d6d80abf22c464be"
       }
     },
     {
       "name": "docx_validate_font_policy",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_validate_font_policy.schema.json",
-        "sha256": "1ef0ae13622931c92054b4cf492957c7d9d16f659b2d333c67c065f0bc4750d4"
+        "sha256": "75e98324c6a8387f0207d83ba1a80b351d487c15d386b542e2130956b1237904"
       },
       "inputContract": {
         "path": "office/contracts/docx_validate_font_policy.schema.json",
-        "sha256": "1ef0ae13622931c92054b4cf492957c7d9d16f659b2d333c67c065f0bc4750d4"
+        "sha256": "75e98324c6a8387f0207d83ba1a80b351d487c15d386b542e2130956b1237904"
       }
     },
     {
       "name": "docx_validate_toc_style_policy",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_validate_toc_style_policy.schema.json",
-        "sha256": "e2317dfc690901a89ed3d8b0307674132f65977cee29cb6ace138e5c87d04603"
+        "sha256": "5a98a3073a8e149a591254ef4e93f27d3b8f5dbce3204199d7155365f00088ef"
       },
       "inputContract": {
         "path": "office/contracts/docx_validate_toc_style_policy.schema.json",
-        "sha256": "e2317dfc690901a89ed3d8b0307674132f65977cee29cb6ace138e5c87d04603"
+        "sha256": "5a98a3073a8e149a591254ef4e93f27d3b8f5dbce3204199d7155365f00088ef"
       }
     },
     {
@@ -335,6 +346,28 @@
         "sha256": "9cde8fdda335f379d44e60819367b305a2c97c6c0c8fdf2141bf460335e5da84"
       }
     },
+    {
+      "name": "pptx_read_shape",
+      "providerContract": {
+        "source": "packages/pptx-cli/contracts/mcp-input/pptx_read_shape.schema.json",
+        "sha256": "0311db4e2675773d0dde0cb7751722394a4ae4b06ef828a09c0843a849299009"
+      },
+      "inputContract": {
+        "path": "office/contracts/pptx_read_shape.schema.json",
+        "sha256": "0311db4e2675773d0dde0cb7751722394a4ae4b06ef828a09c0843a849299009"
+      }
+    },
+    {
+      "name": "pptx_read_slide",
+      "providerContract": {
+        "source": "packages/pptx-cli/contracts/mcp-input/pptx_read_slide.schema.json",
+        "sha256": "831b4573bad0ed325682ac16275e122b44c515bceab21c4d0a82db9e90d54cf7"
+      },
+      "inputContract": {
+        "path": "office/contracts/pptx_read_slide.schema.json",
+        "sha256": "831b4573bad0ed325682ac16275e122b44c515bceab21c4d0a82db9e90d54cf7"
+      }
+    },
     {
       "name": "pptx_replace_picture_image",
       "providerContract": {
@@ -361,11 +394,11 @@
       "name": "pptx_validate",
       "providerContract": {
         "source": "packages/pptx-cli/contracts/mcp-input/pptx_validate.schema.json",
-        "sha256": "57c25f53aa319dc0e9aafc5cd3fa5f0ea12f28c50fe4a39955caa40e2dfc12d5"
+        "sha256": "06d5f29f7ed23ab53fdf7a5de09cbfb6a800e7a19ae076a3d6d80abf22c464be"
       },
       "inputContract": {
         "path": "office/contracts/pptx_validate.schema.json",
-        "sha256": "57c25f53aa319dc0e9aafc5cd3fa5f0ea12f28c50fe4a39955caa40e2dfc12d5"
+        "sha256": "06d5f29f7ed23ab53fdf7a5de09cbfb6a800e7a19ae076a3d6d80abf22c464be"
       }
     },
     {
@@ -449,11 +482,11 @@
       "name": "xlsx_read_range",
       "providerContract": {
         "source": "packages/xlsx-cli/contracts/mcp-input/xlsx_read_range.schema.json",
-        "sha256": "04b0ce1b912047f774fbbbb6ba7cf55e5e53a9b74d6f027d9c21b4d6d7397225"
+        "sha256": "66a5ff24b1a207d70aa278b81a8efba5dc272af2f7a7c12331154e8aa8d8f3dd"
       },
       "inputContract": {
         "path": "office/contracts/xlsx_read_range.schema.json",
-        "sha256": "04b0ce1b912047f774fbbbb6ba7cf55e5e53a9b74d6f027d9c21b4d6d7397225"
+        "sha256": "66a5ff24b1a207d70aa278b81a8efba5dc272af2f7a7c12331154e8aa8d8f3dd"
       }
     },
     {
@@ -548,11 +581,11 @@
       "name": "xlsx_validate",
       "providerContract": {
         "source": "packages/xlsx-cli/contracts/mcp-input/xlsx_validate.schema.json",
-        "sha256": "57c25f53aa319dc0e9aafc5cd3fa5f0ea12f28c50fe4a39955caa40e2dfc12d5"
+        "sha256": "06d5f29f7ed23ab53fdf7a5de09cbfb6a800e7a19ae076a3d6d80abf22c464be"
       },
       "inputContract": {
         "path": "office/contracts/xlsx_validate.schema.json",
-        "sha256": "57c25f53aa319dc0e9aafc5cd3fa5f0ea12f28c50fe4a39955caa40e2dfc12d5"
+        "sha256": "06d5f29f7ed23ab53fdf7a5de09cbfb6a800e7a19ae076a3d6d80abf22c464be"
       }
     }
   ]

package/office/contracts/xlsx_read_range.schema.json

@@ -25,12 +25,6 @@
       "maximum": 9007199254740991,
       "description": "Zero-based cell offset in row-major order within the selected range. Continue only when another selected cell is needed."
     },
-    "limit": {
-      "type": "integer",
-      "minimum": 1,
-      "maximum": 256,
-      "description": "Maximum selected cells in this bounded page."
-    },
     "returnContent": {
       "type": "boolean",
       "description": "Return this selected technical page directly when it fits the response limit. May be combined with output."
@@ -39,9 +33,10 @@
       "type": "string",
       "minLength": 1,
       "description": "Optional immutable JSON artifact path for this selected technical page. May be combined with returnContent.",
-      "x-tiwater-file-role": "write"
+      "x-tiwater-file-role": "write",
+      "x-tiwater-file-effect": false
     }
   },
-  "required": ["input", "sheet", "range", "limit", "returnContent"],
+  "required": ["input", "sheet", "range", "returnContent"],
   "additionalProperties": false
 }

package/office/contracts/xlsx_validate.schema.json

@@ -15,7 +15,8 @@
       "type": "string",
       "minLength": 1,
       "description": "Absolute path for a new JSON file containing the complete result. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write"
+      "x-tiwater-file-role": "write",
+      "x-tiwater-file-effect": false
     }
   },
   "required": [

package/office/index.mjs

@@ -25,6 +25,7 @@ import {
 import { withOutputWriteLock } from '../_shared/output-write-lock.mjs';
 import { evidenceRoleMetadata } from '../_shared/evidence-role.mjs';
 import {
+  documentCreateFileArguments,
   documentMutationFileArguments,
   effectKindMetadata,
 } from '../_shared/effect-kind.mjs';
@@ -178,6 +179,13 @@ function fixedEditOutput(tool) {
   }).strict();
 }
 
+function fixedCreateOutput(tool) {
+  return z.object({
+    tool: z.literal(tool), runtime: runtimeIdentity, receipt: artifact, output: artifact,
+    summary: z.object({ pass: z.literal(true), operationCount: z.literal(1), appliedCount: z.literal(1) }).strict(),
+  }).strict();
+}
+
 function largeResultOutput(tool) {
   return z.object({
     tool: z.literal(tool),
@@ -288,6 +296,102 @@ const pptxInspectionSummary = z.object({
   }).strict()).max(6),
 }).strict();
 
+const pptxSlidePageSummary = z.object({
+  schema: z.literal('tiwater.pptx-slide-page-receipt/v1'),
+  slideNumber: z.number().int().positive(),
+  slidePath: z.string().min(1),
+  masterPath: z.string().min(1).nullable(),
+  layoutPath: z.string().min(1).nullable(),
+  totalShapeCount: z.number().int().nonnegative(),
+  returnedShapeCount: z.number().int().nonnegative(),
+  remaining: z.number().int().nonnegative(),
+  nextOffset: z.number().int().nonnegative().nullable(),
+}).strict();
+
+const pptxShapeTextPageSummary = z.object({
+  schema: z.literal('tiwater.pptx-shape-text-page-receipt/v1'),
+  slideNumber: z.number().int().positive(),
+  shapeId: z.number().int().positive(),
+  totalSegmentCount: z.number().int().nonnegative(),
+  returnedSegmentCount: z.number().int().nonnegative(),
+  remaining: z.number().int().nonnegative(),
+  nextOffset: z.number().int().nonnegative().nullable(),
+}).strict();
+
+const pptxTransform = z.object({
+  x: z.number().int(),
+  y: z.number().int(),
+  cx: z.number().int(),
+  cy: z.number().int(),
+}).strict();
+
+const pptxSlideShapeIdentity = z.object({
+  shapeId: z.number().int().positive(),
+  name: z.string().max(120),
+  kind: z.string().min(1).max(40),
+  zOrder: z.number().int().nonnegative(),
+  placeholderType: z.string().max(120).nullable(),
+  placeholderPresent: z.boolean(),
+  placeholderIndex: z.number().int().nonnegative().nullable(),
+  mediaPartPath: z.string().max(240).nullable(),
+  mediaSha256: z.string().regex(/^[a-f0-9]{64}$/).nullable(),
+  textPreview: z.string().max(240),
+  textLength: z.number().int().nonnegative(),
+  transform: pptxTransform.nullable(),
+  paragraphCount: z.number().int().nonnegative(),
+  runCount: z.number().int().nonnegative(),
+  hasTable: z.boolean(),
+}).strict();
+
+const pptxSlidePage = z.object({
+  schema: z.literal('tiwater.pptx-slide-page/v1'),
+  file: z.string(),
+  inputSha256: z.string().regex(/^[a-f0-9]{64}$/),
+  slideCount: z.number().int().nonnegative(),
+  slideSize: z.object({ cx: z.number().int().nonnegative(), cy: z.number().int().nonnegative() }).strict(),
+  slide: z.object({
+    slideNumber: z.number().int().positive(),
+    path: z.string().min(1),
+    masterPath: z.string().min(1).nullable(),
+    layoutPath: z.string().min(1).nullable(),
+    shapes: z.array(pptxSlideShapeIdentity).max(8),
+  }).strict(),
+  receipt: pptxSlidePageSummary,
+}).strict();
+
+const boundedPptxString = z.string().max(120).nullable();
+const pptxShapeTextSegment = z.object({
+  segmentIndex: z.number().int().nonnegative(),
+  runIndex: z.number().int().nonnegative(),
+  paragraphIndex: z.number().int().nonnegative(),
+  text: z.string().max(160),
+  textOffset: z.number().int().nonnegative(),
+  runTextLength: z.number().int().nonnegative(),
+  textContinues: z.boolean(),
+  paragraphAlignment: boundedPptxString,
+  fontFamily: boundedPptxString,
+  fontSize: z.number().positive().nullable(),
+  color: boundedPptxString,
+  bold: z.boolean().nullable(),
+  directFontFamily: boundedPptxString,
+  directFontSize: z.number().positive().nullable(),
+  directColor: boundedPptxString,
+  directBold: z.boolean().nullable(),
+  fontFamilySource: boundedPptxString,
+  fontSizeSource: boundedPptxString,
+  colorSource: boundedPptxString,
+  boldSource: boundedPptxString,
+}).strict();
+
+const pptxShapeTextPage = z.object({
+  schema: z.literal('tiwater.pptx-shape-text-page/v1'),
+  file: z.string(),
+  inputSha256: z.string().regex(/^[a-f0-9]{64}$/),
+  shape: pptxSlideShapeIdentity,
+  receipt: pptxShapeTextPageSummary,
+  segments: z.array(pptxShapeTextSegment).max(4),
+}).strict();
+
 function docxObservationOutput(tool) {
   return z.object({
     tool: z.literal(tool),
@@ -435,6 +539,14 @@ const docxReadObjectOutput = docxObservationOutput('docx_read_object').extend({
 }).strict();
 
 const tools = [
+  {
+    name: 'docx_create',
+    effectKind: 'document-create',
+    description: 'Create one new minimal standards-valid DOCX containing one empty paragraph. The result is a current native document that can be populated incrementally with the ordinary DOCX object operations. The provider chooses no business wording, template, layout mapping, or target structure and never overwrites an existing path.',
+    inputSchema: inputContract('docx_create'),
+    outputSchema: fixedCreateOutput('docx_create'),
+    handler: (args, tool) => fixedCreate(tool, args, docxCandidates),
+  },
   {
     name: 'docx_inspect',
     evidenceRole: 'document-observation',
@@ -446,7 +558,7 @@ const tools = [
   },
   {
     name: 'docx_list_objects',
-    description: 'Page through mixed nearest-child OpenXML objects only when document order or paragraph relationships are required. Set returnContent true to return a byte-bounded object page. Provide output to store the complete requested page and return its artifact receipt. These channels are independent and may be used together; at least one is required. Continue from receipt.nextOffset only when an unreturned object is needed for the current decision. Do not use this tool to locate tables or read a whole document: use docx_table_index to locate tables, then a narrow table or object read.',
+    description: 'Page through mixed nearest-child OpenXML objects only when document order or paragraph relationships are required. The provider chooses the bounded page size. Set returnContent true to return the selected object page. Provide output to store the complete requested page and return its artifact receipt. These channels are independent and may be used together; at least one is required. Continue from receipt.nextOffset only when an unreturned object is needed for the current decision. Do not use this tool to locate tables or read a whole document: use docx_table_index to locate tables, then a narrow table or object read.',
     inputSchema: inputContract('docx_list_objects'),
     outputSchema: docxListObjectsOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -672,7 +784,7 @@ const tools = [
   },
   {
     name: 'xlsx_read_range',
-    description: 'Read one explicit native A1 cell or rectangular range from one current XLSX worksheet. Pages use a row-major cell offset and return physical presence, raw and formatted values, normalized value type, formula metadata, style, rich text, and merged-range ownership. The receipt always reports remaining cells and the next offset. Continue only when another selected cell is needed. Set returnContent true to return the selected page when it fits the response limit. Provide output to store the same complete selected page as an immutable artifact. These channels are independent and may be used together; at least one is required. This tool does not infer regions, headers, records, field meanings, or business mappings; convert legacy XLS before reading Open XML cells.',
+    description: 'Read one explicit native A1 cell or rectangular range from one current XLSX worksheet. The provider chooses the bounded page size. Pages use a row-major cell offset and return physical presence, raw and formatted values, normalized value type, formula metadata, style, rich text, and merged-range ownership. The receipt always reports remaining cells and the next offset. Continue only when another selected cell is needed. Set returnContent true to return the selected page when it fits the response limit. Provide output to store the same complete selected page as an immutable artifact. These channels are independent and may be used together; at least one is required. This tool does not infer regions, headers, records, field meanings, or business mappings; convert legacy XLS before reading Open XML cells.',
     inputSchema: inputContract('xlsx_read_range'),
     outputSchema: xlsxRangeReadOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -705,6 +817,28 @@ const tools = [
     annotations: { readOnlyHint: true, idempotentHint: true, destructiveHint: false, openWorldHint: false },
     handler: pptxExportJson,
   },
+  {
+    name: 'pptx_read_slide',
+    description: 'List one selected PPTX slide as bounded pages of compact native shape identities in z-order. The provider chooses the bounded page size. Each identity includes its shape id, kind, geometry, text preview, object counts, placeholder facts, media identity, and whether it contains a table. The receipt reports the selected slide, its layout and master paths, remaining shapes, and the next offset. Continue only when another shape on this slide is needed; use pptx_read_shape for bounded text and effective formatting of one selected shape. Set returnContent true to return the selected page when it fits the response limit. Provide output to store the same complete selected page as an immutable artifact. These channels are independent and may be used together; at least one is required. This tool does not select templates, assign business roles, infer repairs, or inspect another slide.',
+    inputSchema: inputContract('pptx_read_slide'),
+    outputSchema: largeResultOutput('pptx_read_slide').extend({
+      summary: pptxSlidePageSummary,
+      content: pptxSlidePage.optional(),
+    }).strict(),
+    annotations: { readOnlyHint: true, idempotentHint: true, destructiveHint: false, openWorldHint: false },
+    handler: pptxReadSlide,
+  },
+  {
+    name: 'pptx_read_shape',
+    description: 'Read one native PPTX shape selected from pptx_read_slide as bounded text segments. The provider chooses the bounded page size. Each segment retains its run and paragraph identity, text offset, paragraph alignment, effective text formatting, direct formatting, and formatting source. Long run text is split without changing its native run identity. The receipt reports remaining segments and the next offset. Continue only when another segment of this shape is needed. Set returnContent true to return the selected page when it fits the response limit. Provide output to store the same complete selected page as an immutable artifact. These channels are independent and may be used together; at least one is required. This tool does not choose formatting, derive repairs, or inspect another shape.',
+    inputSchema: inputContract('pptx_read_shape'),
+    outputSchema: largeResultOutput('pptx_read_shape').extend({
+      summary: pptxShapeTextPageSummary,
+      content: pptxShapeTextPage.optional(),
+    }).strict(),
+    annotations: { readOnlyHint: true, idempotentHint: true, destructiveHint: false, openWorldHint: false },
+    handler: pptxReadShape,
+  },
   {
     name: 'pptx_apply_template',
     effectKind: 'document-mutation',
@@ -1238,6 +1372,36 @@ async function fixedEdit(tool, args, candidates) {
   });
 }
 
+async function fixedCreate(tool, args, candidates) {
+  const publishedContract = {
+    name: tool.name,
+    inputSchema: inputContractSchema(tool.name),
+    annotations: tool.annotations,
+    _meta: effectKindMetadata(tool.effectKind),
+  };
+  const bindings = documentCreateFileArguments(publishedContract, args);
+  const output = path.resolve(bindings.effectiveOutput);
+  const receiptOutput = path.resolve(requireString(args.receiptOutput, 'receiptOutput'));
+  await requireNewFile(output, 'output');
+  await requireNewFile(receiptOutput, 'receiptOutput');
+  return withTempJsonFile(args, async requestPath => {
+    const result = await runJsonCandidateChain(candidates, [tool.name, requestPath], { allowedExitCodes: [0, 1] });
+    if (result.code !== 0) {
+      const detail = result.stderr.trim() || result.stdout.trim()
+        || `${tool.name} failed with exit code ${result.code}`;
+      throw new Error(detail);
+    }
+    if (result.json?.tool !== tool.name) throw new Error(`${tool.name} returned a mismatched tool identity`);
+    await requireReturnedArtifact(result.json.receipt, receiptOutput, 'receipt');
+    await requireReturnedArtifact(result.json.output, output, 'output');
+    if (result.json.summary?.pass !== true
+        || result.json.summary?.operationCount !== 1 || result.json.summary?.appliedCount !== 1) {
+      throw new Error(`${tool.name} returned invalid creation evidence`);
+    }
+    return { ...result.json, runtime: commandRuntime(result) };
+  });
+}
+
 async function docxCompare(args) {
   const baseline = path.resolve(requireString(args.baseline, 'baseline'));
   const updated = path.resolve(requireString(args.updated, 'updated'));
@@ -1396,6 +1560,36 @@ async function pptxExportJson(args) {
   return deliverLargeJsonResult({ tool: 'pptx_export_json', args, runtime: commandRuntime(result), payload: result.json, sourcePaths: [input] });
 }
 
+async function pptxReadSlide(args) {
+  const input = path.resolve(requireString(args.input, 'input'));
+  return withTempJsonFile(args, async requestPath => {
+    const result = await runJsonCandidateChain(pptxCandidates, ['pptx_read_slide', requestPath]);
+    return deliverLargeJsonResult({
+      tool: 'pptx_read_slide',
+      args,
+      runtime: commandRuntime(result),
+      payload: result.json,
+      sourcePaths: [input],
+      summary: result.json.receipt,
+    });
+  });
+}
+
+async function pptxReadShape(args) {
+  const input = path.resolve(requireString(args.input, 'input'));
+  return withTempJsonFile(args, async requestPath => {
+    const result = await runJsonCandidateChain(pptxCandidates, ['pptx_read_shape', requestPath]);
+    return deliverLargeJsonResult({
+      tool: 'pptx_read_shape',
+      args,
+      runtime: commandRuntime(result),
+      payload: result.json,
+      sourcePaths: [input],
+      summary: result.json.receipt,
+    });
+  });
+}
+
 async function pptxValidate(args) {
   const input = path.resolve(requireString(args.input, 'input'));
   const result = await runJsonCandidateChain(pptxCandidates, ['validate', input], { allowedExitCodes: [0, 1] });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiwater/office-mcp",
-  "version": "0.21.38",
+  "version": "0.21.40",
   "description": "Published MCP distribution for independent Tiwater Office, PDF, and Text document capabilities",
   "type": "module",
   "license": "MIT",

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

@@ -2,7 +2,7 @@
   "schema": "tiwater.pdf-provider-contract-manifest/v1",
   "provider": {
     "id": "@tiwater/office-mcp",
-    "version": "0.21.38"
+    "version": "0.21.40"
   },
   "runtime": {
     "command": "tiwater-pdf"

package/text/contracts/text_read_lines.schema.json

@@ -14,12 +14,6 @@
       "maximum": 9007199254740991,
       "description": "Zero-based line offset in the exact current source revision."
     },
-    "limit": {
-      "type": "integer",
-      "minimum": 1,
-      "maximum": 200,
-      "description": "Maximum number of lines in this bounded page."
-    },
     "returnContent": {
       "type": "boolean",
       "description": "Return this selected line page directly when it fits the response limit. May be combined with output."
@@ -28,9 +22,10 @@
       "type": "string",
       "minLength": 1,
       "description": "Optional immutable JSON artifact path for this selected line page. May be combined with returnContent.",
-      "x-tiwater-file-role": "write"
+      "x-tiwater-file-role": "write",
+      "x-tiwater-file-effect": false
     }
   },
-  "required": ["input", "offset", "limit", "returnContent"],
+  "required": ["input", "offset", "returnContent"],
   "additionalProperties": false
 }

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

@@ -2,7 +2,7 @@
   "schema": "tiwater.text-provider-contract-manifest/v1",
   "provider": {
     "id": "@tiwater/office-mcp",
-    "version": "0.21.38"
+    "version": "0.21.40"
   },
   "tools": [
     {
@@ -20,11 +20,11 @@
       "name": "text_read_lines",
       "providerContract": {
         "source": "servers/text/provider-contracts/text_read_lines.schema.json",
-        "sha256": "0f9202f0b45bbd35b3ba4bebec7776da41f2c8668c7cdece068c44102f518bb6"
+        "sha256": "cf855e8131f5f2cfbb65185986d0f85ab87fb0efa5000c31491e10cc7ead3c3a"
       },
       "inputContract": {
         "path": "text/contracts/text_read_lines.schema.json",
-        "sha256": "0f9202f0b45bbd35b3ba4bebec7776da41f2c8668c7cdece068c44102f518bb6"
+        "sha256": "cf855e8131f5f2cfbb65185986d0f85ab87fb0efa5000c31491e10cc7ead3c3a"
       }
     }
   ]

package/text/index.mjs

@@ -113,7 +113,7 @@ const definitions = [
   },
   {
     name: 'text_read_lines',
-    description: 'Read one explicit zero-based line page from one exact supported plain-text revision. The receipt reports remaining lines and nextOffset; continue only when another line is needed. Set returnContent true to return the selected page when it fits the response limit. Provide output to retain the same complete page. These channels are independent and may be used together; at least one is required. Lines retain their exact decoded text and terminator; the provider does not interpret fields, records, key-value pairs, sections, Markdown, or business meaning.',
+    description: 'Read one explicit zero-based line page from one exact supported plain-text revision. The provider chooses the bounded page size. The receipt reports remaining lines and nextOffset; continue only when another line is needed. Set returnContent true to return the selected page when it fits the response limit. Provide output to retain the same complete page. These channels are independent and may be used together; at least one is required. Lines retain their exact decoded text and terminator; the provider does not interpret fields, records, key-value pairs, sections, Markdown, or business meaning.',
     outputSchema: largeResultOutput(linePage).extend({ summary: linePageReceipt }).strict(),
     handler: textReadLines,
   },
@@ -165,7 +165,7 @@ async function textInspect(args) {
 }
 
 async function textReadLines(args) {
-  const observation = await readTextLines(args.input, args.offset, args.limit);
+  const observation = await readTextLines(args.input, args.offset);
   const delivered = await deliverLargeJsonResult({
     tool: 'text_read_lines',
     args,

package/text/observation.mjs

@@ -6,6 +6,7 @@ import { fileArtifact } from '../_shared/large-json-result.mjs';
 const supportedExtensions = new Set(['.txt', '.text', '.log', '.csv', '.tsv', '.md', '.markdown']);
 const openingLineLimit = 8;
 const openingTextLimit = 160;
+const linePageLimit = 200;
 
 export async function inspectText(inputValue) {
   const observation = await observeText(inputValue);
@@ -30,17 +31,14 @@ export async function inspectText(inputValue) {
   };
 }
 
-export async function readTextLines(inputValue, requestedOffset, requestedLimit) {
+export async function readTextLines(inputValue, requestedOffset) {
   if (!Number.isSafeInteger(requestedOffset) || requestedOffset < 0) {
     throw Object.assign(new Error('offset must be a non-negative safe integer'), { code: -32602 });
   }
-  if (!Number.isSafeInteger(requestedLimit) || requestedLimit < 1 || requestedLimit > 200) {
-    throw Object.assign(new Error('limit must be a safe integer from 1 through 200'), { code: -32602 });
-  }
   const observation = await observeText(inputValue);
   const source = await fileArtifact(observation.input);
   const offset = Math.min(requestedOffset, observation.lines.length);
-  const selected = observation.lines.slice(offset, offset + requestedLimit);
+  const selected = observation.lines.slice(offset, offset + linePageLimit);
   const nextOffset = offset + selected.length < observation.lines.length
     ? offset + selected.length
     : null;