---
type: Attested Computation
title: inspect
identifier: sheet/inspect
description: Inspect spreadsheet workbooks (XLSX, ODS), listing sheet names, row and column dimensions, and header columns.
pack: sheet
tags:
- documents
- engineering
runtime: fragletc
image: ofthemachine/python3@sha256:a015b4f9f0e7c1648f8fcd4164f6a296dd3c9189404f88f333a9764d08d13522
network: none
stdin: none
execution_class: hermetic
procedure_hash: sha256:78e22335f0414ecb2b33794512af5e34218a2c3d24a186a4d7823a8c1f2b05bb
parameters:
- name: workbook
  type: file
  required: true
  description: Spreadsheet workbook mounted at /input/workbook
- name: format
  type: string
  required: false
  default: markdown
  description: 'Output format: markdown or json'
computation: https://tools.ofthemachine.com/sheet/inspect.py
executor:
  resource: https://github.com/ofthemachine/fraglet
  receipt:
  - schema
  - fragletc
  - procedure
  - procedure_hash
  - image
  - image_digest
  - network
  - stdin_mode
  - params
  - inputs
  - argv
  - env
  - memo_key
  - started
  - finished
  - exit_code
  - stdout
  - outputs
  format: fraglet-receipt/2 (fragletc --receipt <path>, or FRAGLETC_RECEIPT_DIR)
attester:
  resource: https://tools.ofthemachine.com/receipt/attest.py
  method: 'deterministic, no re-execution: procedure_hash equals sha256 of computation; memo_key recomputes from the receipt''s own fields; claimed params and any artifact hash match the receipt'
generated:
  by: process:tools/catalog/compile.py
  at: '2026-11-13T18:27:40Z'
---

# inspect

Inspect spreadsheet workbooks (XLSX, ODS), listing sheet names, row and column dimensions, and header columns.

Use when the user wants to see the structure, sheets, dimensions, or column names of an Excel or ODS spreadsheet without reading all rows.

# Schema

## Parameters
- `workbook` (file, required) — Spreadsheet workbook mounted at /input/workbook
- `format` (string, optional, default `markdown`) — Output format: markdown or json

## Outputs
- stdout (the anonymous result)

# Execution

The computation is [`sheet/inspect.py`](https://tools.ofthemachine.com/sheet/inspect.py) (frontmatter `computation`; in `tools.tar.gz` the same file sits at `sheet/inspect.py` beside this bundle), run by `fragletc` in `ofthemachine/python3@sha256:a015b4f9f0e7c1648f8fcd4164f6a296dd3c9189404f88f333a9764d08d13522` with network `none`. Its identity is `procedure_hash` = sha256 of that file, shebang included — the same value every receipt records. Parameters are passed as `-p name=value`; `--receipt run.json` (or `FRAGLETC_RECEIPT_DIR`) writes the receipt, a `fraglet-receipt/2` JSON document with the fields listed under `executor.receipt`.

# Attestation

A run's receipt is attested with [`receipt/attest.py`](https://tools.ofthemachine.com/receipt/attest.py): the computation that ran is this script (`procedure_hash`), the receipt is internally consistent (`memo_key` recomputes from its own fields), the claimed parameters are the ones that ran, and an artifact claimed as an output hashes to what the receipt recorded. No re-execution: attestation is provenance fidelity, not reproduction.

Hermetic: no network, so `memo_key` also fully determines the outputs — a re-run with the same inputs must reproduce them, which makes results from this tool safely memoizable.

Skill: [SKILL.md](https://tools.ofthemachine.com/sheet/SKILL.md)
