xlsx.inspect

Estimate the cost and shape of a render without producing the workbook.

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

At a glance

Availability

Managed API route: POST /api/v2/operations/xlsx/inspect. Managed execution requires a free-trial workspace or an active Platform or Enterprise workspace, and an environment-bound API key.

Input and result

Every success also carries losses, diagnostics, and a hash-bound receipt.

Invoke

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

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

Errors and losses

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

Verified example and exact contract

• Fixture: icp-workflow (xlsx-tracker-compliance-remediation.json).
• Example input — SHA-256 57ed61c3dde8935152aea4a115153c6f75e47d2bbe78024ef0e3c5133563095e.
• Example result — SHA-256 f50cf3f13d28da4d1b1c8c96a1bd20379c713d4c840b65a3d6abe98ee81fd91c.
• Verified result SHA-256: ec52c7ef1b598aa3a9466ad80ce538493dd7163e6d8596bf7ed0cea1efc47830.
• Qualification lane: 11-pdf-xlsx.

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