Compare two versions of a Word file and return the earlier one with every difference as a tracked change; refused when the result would not accept to the later version.
Use describe("docx.diff.redline") when your code needs the complete live JSON Schemas.
At a glance
| Property | Value |
|---|---|
| Package | @runstamp/registry |
| Domain / verb | docx / diff |
| Customer jobs | compare, review |
| Deterministic | No |
| Side effects | none |
Availability
| Local | SDK | CLI | MCP | Managed API |
|---|---|---|---|---|
| unavailable | unavailable | unavailable | unavailable | public ga |
Managed API route: POST /api/v2/operations/docx/diff/redline. Managed execution requires a free-trial workspace or an active Platform or Enterprise workspace, and an environment-bound API key.
Input and result
| Schema | Required fields | Optional fields |
|---|---|---|
| Input | none | none |
| Options | none | operation, author, date, deterministic, deterministicSeed, timeoutMs, locale, lossPolicy, limits |
| Result value | artifact, revisions, comments, stats | none |
Every success also carries losses, diagnostics, and a hash-bound receipt.
Defaults, limits, and format constraints
Defaults
| Path | Default |
|---|---|
$.deterministic | default=true |
$.lossPolicy | default="collect" |
Formats and profiles
No separate format selector is declared. Accepted artifacts are bounded by the exact input schema.
Other limits
| Path | Constraint |
|---|---|
$ | minItems=2maxItems=2 |
$.author | minLength=1maxLength=256 |
$.timeoutMs | minimum=1 |
Invoke
const input = await fetch("https://runstamp.com/demo-evidence/operation-evidence/docx/docx.diff.redline/input.json").then((response) => response.json());
const result = await runstamp.run("docx.diff.redline", input);
if (!result.ok) throw new Error(`${result.error.code}: ${result.error.remediation}`);
console.log(result.value, result.losses, result.diagnostics, result.receipt);curl -fsS https://runstamp.com/demo-evidence/operation-evidence/docx/docx.diff.redline/input.json -o input.json
npx -p @runstamp/sdk runstamp ops invoke docx.diff.redline --input input.json{
"tool": "runstamp_invoke_operation",
"arguments": {
"operation": "docx.diff.redline",
"input": "<JSON from https://runstamp.com/demo-evidence/operation-evidence/docx/docx.diff.redline/input.json>",
"execution_mode": "local"
}
}Errors and losses
Declared errors (9)
common/SCHEMA_REJECTEDcommon/CONTRACT_VIOLATIONcommon/OPERATION_CANCELLEDcommon/OPERATION_TIMEOUTcommon/RESOURCE_LIMIT_EXCEEDEDcommon/INPUT_CORRUPTcommon/STEP_REJECTEDcommon/POLICY_DENIEDcommon/INVARIANT_VIOLATED
Declared losses (0)
- None.
SDK AbortSignal, CLI exit 130, and MCP cancellation return the typed common/OPERATION_CANCELLED failure envelope.
Verified example and exact contract
- Fixture:
icp-workflow(Statement of work SOW-3: draft and the signed revision). - Example input — SHA-256
bb95663e84d9220122efdf0ec6f8c6918fe8ad84bae34db9529a8b1f8d463f2c. - Example result — SHA-256
ee30b4a134dcf3e9cb830cc2492588808d4a3c576c159b163663bd61b81b04a2. - Verified result SHA-256:
724477b7788a72e2b487b1a86e06a00f61c769081cca8ccebc2e0ed207146f94. - Qualification lane:
10-pptx-docx.
Contract fingerprints
- Descriptor:
58d0174096585ebd7fb1121c3d794a228879bb69e26553d656f2983c4ab53e30. - Input schema:
eecbef713539833541f710481d0b7b52bb091358d48537aa533353ceb015e769. - Options schema:
75f35aa7ff8fc343c20a62c4fe3fc53a5a9829d8a5301f32cf5d7d72207b4e80. - Result value schema:
da30a285e4da5d70c4a49d525901e4840cf3e1f0bf75c8efa65412d8c89b5254.
The machine-readable operation reference publishes the complete schemas, qualification results, and evidence bindings for every operation.