xlsx.transform | Runstamp Docs

Map or apply independently verified bounded changes to an existing workbook.

Use describe("xlsx.transform") when your code needs the complete live JSON Schemas.

At a glance

Property	Value
Package	`@runstamp/xlsx`
Domain / verb	`xlsx` / `transform`
Customer jobs	transform
Deterministic	Yes
Side effects	none

Availability

Local	SDK	CLI	MCP	Managed API
public ga	public ga	public ga	public ga	public ga

Managed API route: POST /api/v2/operations/xlsx/transform. 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	`deterministic`, `deterministicSeed`, `timeoutMs`, `locale`, `lossPolicy`, `limits`
Result value	none	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
`$.oneOf[0].workbookBase64`	`minLength=8` `maxLength=89478488`
`$.oneOf[0].artifactId`	`minLength=1` `maxLength=256`
`$.oneOf[0].targets`	`maxItems=1000000`
`$.oneOf[1].workbookBase64`	`minLength=8` `maxLength=89478488`
`$.oneOf[1].artifactId`	`minLength=1` `maxLength=256`
`$.oneOf[1].writes`	`minItems=1` `maxItems=100000`
`$.oneOf[1].writes[].locator.artifactId`	`minLength=1` `maxLength=256`
`$.oneOf[1].writes[].locator.value`	`minItems=2` `maxItems=2`
`$.oneOf[1].writes[].locator.value[]`	`minLength=1` `maxLength=255`
`$.timeoutMs`	`minimum=1` `maximum=600000`
`$.limits.maxInputBytes`	`minimum=1` `maximum=67108864`
`$.limits.maxOutputBytes`	`minimum=1` `maximum=134217728`
`$.limits.maxPages`	`minimum=1` `maximum=1048576`
`$.limits.maxElements`	`minimum=1` `maximum=1000000`
`$.limits.maxArchiveEntries`	`minimum=1` `maximum=2000`
`$.limits.maxExpansionRatio`	`minimum=1` `maximum=1000`
`$.limits.maxDurationMs`	`exclusiveMinimum=0`

Showing 32 of 33 constraints. Use describe() or the machine-readable reference for the complete schema.

Invoke

const input = await fetch("https://runstamp.com/demo-evidence/operation-evidence/xlsx/xlsx.transform/input.json").then((response) => response.json());
const result = await runstamp.run("xlsx.transform", 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/xlsx/xlsx.transform/input.json -o input.json
npx -p @runstamp/sdk runstamp ops invoke xlsx.transform --input input.json

{
  "tool": "runstamp_invoke_operation",
  "arguments": {
    "operation": "xlsx.transform",
    "input": "<JSON from https://runstamp.com/demo-evidence/operation-evidence/xlsx/xlsx.transform/input.json>",
    "execution_mode": "local"
  }
}

Errors and losses

Declared errors (21)

xlsx/INVALID_INPUT
xlsx/RESOURCE_LIMIT
xlsx/TIMEOUT
xlsx/XLSX_ABORTED
xlsx/XLSX_ARCHIVE_UNSAFE
xlsx/XLSX_BUDGET_EXCEEDED
xlsx/XLSX_CELL_NOT_FOUND
xlsx/XLSX_ENCRYPTED_UNSUPPORTED
xlsx/XLSX_FORMULA_INJECTION
xlsx/XLSX_MAPPING_UNRESOLVED
xlsx/SCHEMA_REJECTED
common/SCHEMA_REJECTED
common/OPERATION_CANCELLED
common/OPERATION_TIMEOUT
common/CONTRACT_VIOLATION
common/RESOURCE_LIMIT_EXCEEDED
common/INPUT_CORRUPT
xlsx/LOSS_POLICY_VIOLATED
xlsx/INTENDED_CHANGE_NOT_VERIFIED
xlsx/IDEMPOTENCE_NOT_VERIFIED
xlsx/WORKBOOK_MUTATION_REFUSED

Declared losses (1)

xlsx/XLSX_OPAQUE_PART_PRESERVED

SDK AbortSignal, CLI exit 130, and MCP cancellation return the typed common/OPERATION_CANCELLED failure envelope.

Verified example and exact contract

Fixture: icp-workflow (Existing compliance-remediation workbook with one bounded status change).
Example input — SHA-256 1accc6bd4a6b2f44f7662233741d2119f91ddba406f623ee4d7e82537bf0fef0.
Example result — SHA-256 8f6c550ff624dfc0bd6018253bf53c97c07cf69d33e8ddff44959314f5f92e2a.
Verified result SHA-256: 5f1b5cce3f60425e86cc4ea1bbe7a9053ea4261d77177965a2e33be3e8b0d110.
Qualification lane: 11-pdf-xlsx.

Contract fingerprints

Descriptor: eddc2d538c6e4d96652a5f80798f49e6454cccf85aff9bfe6f59d26bf5afebe6.
Input schema: d673396ec6b398c1d2bca1468f9893db6aa3745cb3a285cadb59efc6778d088c.
Options schema: 270bc192b082d67454d7cbb48a246232a1b2b2c37dc87090c704d05f0573e8f1.
Result value schema: 41bfbca2e63e2d1c7bf7a309fb906cd8d5a63a70d9ef1602453cc317beff0cba.

The machine-readable operation reference publishes the complete schemas, qualification results, and evidence bindings for every operation.

Map or apply independently verified bounded changes to an existing workbook.

Use describe("xlsx.transform") when your code needs the complete live JSON Schemas.

At a glance

Property	Value
Package	`@runstamp/xlsx`
Domain / verb	`xlsx` / `transform`
Customer jobs	transform
Deterministic	Yes
Side effects	none

Availability

Local	SDK	CLI	MCP	Managed API
public ga	public ga	public ga	public ga	public ga

Managed API route: POST /api/v2/operations/xlsx/transform. 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	`deterministic`, `deterministicSeed`, `timeoutMs`, `locale`, `lossPolicy`, `limits`
Result value	none	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
`$.oneOf[0].workbookBase64`	`minLength=8` `maxLength=89478488`
`$.oneOf[0].artifactId`	`minLength=1` `maxLength=256`
`$.oneOf[0].targets`	`maxItems=1000000`
`$.oneOf[1].workbookBase64`	`minLength=8` `maxLength=89478488`
`$.oneOf[1].artifactId`	`minLength=1` `maxLength=256`
`$.oneOf[1].writes`	`minItems=1` `maxItems=100000`
`$.oneOf[1].writes[].locator.artifactId`	`minLength=1` `maxLength=256`
`$.oneOf[1].writes[].locator.value`	`minItems=2` `maxItems=2`
`$.oneOf[1].writes[].locator.value[]`	`minLength=1` `maxLength=255`
`$.timeoutMs`	`minimum=1` `maximum=600000`
`$.limits.maxInputBytes`	`minimum=1` `maximum=67108864`
`$.limits.maxOutputBytes`	`minimum=1` `maximum=134217728`
`$.limits.maxPages`	`minimum=1` `maximum=1048576`
`$.limits.maxElements`	`minimum=1` `maximum=1000000`
`$.limits.maxArchiveEntries`	`minimum=1` `maximum=2000`
`$.limits.maxExpansionRatio`	`minimum=1` `maximum=1000`
`$.limits.maxDurationMs`	`exclusiveMinimum=0`

Showing 32 of 33 constraints. Use describe() or the machine-readable reference for the complete schema.

Invoke

const input = await fetch("https://runstamp.com/demo-evidence/operation-evidence/xlsx/xlsx.transform/input.json").then((response) => response.json());
const result = await runstamp.run("xlsx.transform", 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/xlsx/xlsx.transform/input.json -o input.json
npx -p @runstamp/sdk runstamp ops invoke xlsx.transform --input input.json

{
  "tool": "runstamp_invoke_operation",
  "arguments": {
    "operation": "xlsx.transform",
    "input": "<JSON from https://runstamp.com/demo-evidence/operation-evidence/xlsx/xlsx.transform/input.json>",
    "execution_mode": "local"
  }
}

Errors and losses

Declared errors (21)

xlsx/INVALID_INPUT
xlsx/RESOURCE_LIMIT
xlsx/TIMEOUT
xlsx/XLSX_ABORTED
xlsx/XLSX_ARCHIVE_UNSAFE
xlsx/XLSX_BUDGET_EXCEEDED
xlsx/XLSX_CELL_NOT_FOUND
xlsx/XLSX_ENCRYPTED_UNSUPPORTED
xlsx/XLSX_FORMULA_INJECTION
xlsx/XLSX_MAPPING_UNRESOLVED
xlsx/SCHEMA_REJECTED
common/SCHEMA_REJECTED
common/OPERATION_CANCELLED
common/OPERATION_TIMEOUT
common/CONTRACT_VIOLATION
common/RESOURCE_LIMIT_EXCEEDED
common/INPUT_CORRUPT
xlsx/LOSS_POLICY_VIOLATED
xlsx/INTENDED_CHANGE_NOT_VERIFIED
xlsx/IDEMPOTENCE_NOT_VERIFIED
xlsx/WORKBOOK_MUTATION_REFUSED

Declared losses (1)

xlsx/XLSX_OPAQUE_PART_PRESERVED

SDK AbortSignal, CLI exit 130, and MCP cancellation return the typed common/OPERATION_CANCELLED failure envelope.

Verified example and exact contract

Fixture: icp-workflow (Existing compliance-remediation workbook with one bounded status change).
Example input — SHA-256 1accc6bd4a6b2f44f7662233741d2119f91ddba406f623ee4d7e82537bf0fef0.
Example result — SHA-256 8f6c550ff624dfc0bd6018253bf53c97c07cf69d33e8ddff44959314f5f92e2a.
Verified result SHA-256: 5f1b5cce3f60425e86cc4ea1bbe7a9053ea4261d77177965a2e33be3e8b0d110.
Qualification lane: 11-pdf-xlsx.

Contract fingerprints

Descriptor: eddc2d538c6e4d96652a5f80798f49e6454cccf85aff9bfe6f59d26bf5afebe6.
Input schema: d673396ec6b398c1d2bca1468f9893db6aa3745cb3a285cadb59efc6778d088c.
Options schema: 270bc192b082d67454d7cbb48a246232a1b2b2c37dc87090c704d05f0573e8f1.
Result value schema: 41bfbca2e63e2d1c7bf7a309fb906cd8d5a63a70d9ef1602453cc317beff0cba.

The machine-readable operation reference publishes the complete schemas, qualification results, and evidence bindings for every operation.