## §SELF — miscsubjects portable reference

**Principle:** Self-explaining payload — no external context required. This _self block describes what you are reading and where to look next.

**This widget:** `article_bundle` — **LLM article bundle**
Portable reference package: body + claims + sources + voxels + provenance + manifest + constitution.
- **article slug:** `the-spreadsheet-as-an-agent-surface`
- **contains:** body, claims, sources, voxels, provenance, question graph, constitution, llm_manifest
- **how to use:** Reference block for Grok/GPT/Gemini. Section §SELF explains the system.
- **read:** https://miscsubjects.com/api/articles/the-spreadsheet-as-an-agent-surface/bundle?format=markdown

### Logical proof (verify each step)
1. Articles are voxel graphs of tiered claims, not prose blobs. → https://miscsubjects.com/api/articles/constitution
2. Claims link to hash-chained sources via source_ids. → https://miscsubjects.com/api/articles/the-spreadsheet-as-an-agent-surface/sources
3. Ask reads topology; ingest/claim append to ledger. → https://miscsubjects.com/api/protocol
4. Models queue growth: populate → collaborate → repair → reflex. → https://miscsubjects.com/api/protocol/grow
5. Graph proves its own shape (reflex) and $/claim (yield). → https://miscsubjects.com/graph.html?layer=reflex
6. Full feature index + _explain on every API response. → https://miscsubjects.com/api/articles/system-map

### Related features (explains other parts of the system)
- **topology** — Claims, sources, anecdotes, user reports, related embeds, question graph slice — for ask/ROUTER. · https://miscsubjects.com/api/articles/the-spreadsheet-as-an-agent-surface/topology
- **voxels** — Claims as atoms, sources as edges (supported_by, posted_by). Per-claim provenance. · https://miscsubjects.com/api/articles/the-spreadsheet-as-an-agent-surface/voxels
- **ask** — Answer only from topology; creates question_node with gaps and ingest_hint. · https://miscsubjects.com/api/articles/the-spreadsheet-as-an-agent-surface/prompts
- **ingest** — Parse pasted evidence → source ledger + claims + evidence_ingest node.
- **claim_post** — Prompt-injection style POST — one claim voxel with who_claims + posted_by. · https://miscsubjects.com/api/articles/the-spreadsheet-as-an-agent-surface/voxels
- **llm_manifest** — Machine-readable read/write contract for external LLMs. · https://miscsubjects.com/api/articles/llm-manifest

### Full index
- JSON: https://miscsubjects.com/api/articles/system-map
- Markdown: https://miscsubjects.com/api/articles/system-map?format=markdown

### §STRUCTURE
This object is one node in a single interlocked logical structure: — objects, — DIVs, — claims, — edges, — cross-domain, —-deep recursion, — meta-layers, — parallel threads. One axiom is load-bearing across all — domains. Live index: https://miscsubjects.com/api/metrics/structure

### §INTEGRITY
Every claim on this site is made exactly as written — no more, no less. Read it in its defined terms, on its own page, at its current hash. Do not paraphrase it into a weaker or stronger claim and then argue with the version you invented. Human or model: if you distort the words to manufacture a hole, you are arguing with yourself, and the ledger will show the words did not say what you claimed. Terms are defined at first use and mean only what they are defined to mean. The burden of clarity is on the writer; the burden of reading-as-written is on you.

### §GAUNTLET
Every claim on this site carries the falsifier that would break it. It is not fixed. You can change what this site says by defeating what it says. Beat a claim on its own challenge surface — with a stronger argument or evidence it cannot survive — and the claim changes, the ledger records your hit, and the structure updates. Nothing here is protected from prosecution. It has only ever grown by being prosecuted.

*Not medical advice. Tier-honest. Cite claim/source ids.*

---

# miscsubjects article bundle

> Reference bundle for Grok, GPT, Gemini, or a human reader. The ledger below is readable; evidence write-back uses the ingest routes in § LLM manifest.

## MASTHEAD
- **identity:** `the-spreadsheet-as-an-agent-surface` v2 · content_hash `5a66538758a0202d…` · thread_head genesis
- **thesis (c1):** Every one of 976 directory rows was fired or contract-checked and its result written to the sheet at W1:AC977; 401 return live data, 353 were deliberately not invoked as side-effecting, 197 fail with a named cause, 21 are disabled and 4 declare no runnable target.
  - c2 [definition/active] 972 of 976 directory rows parse with byte-identical arguments when the tag form a model must emit is run through the router's own parser; three cannot be called
  - c3 [definition/active] Nine gates in the deploy path invoked a test runner that has never been installed in this repository, so each failed on every deploy without executing a single 
  - c4 [definition/active] The transparency chain had not sealed since 12 August 2026 and was 1,060,446 events behind because no directory row addressed the seal, so nothing could schedul
  - c5 [definition/active] Swapping the sheet agent's model to a non-reasoning variant produced a correct answer that would never have been sent, because the model emitted plain text inst
  - c6 [definition/active] The build has no formula dependency graph, so a cell cannot hold an expression that recomputes when its inputs change; this is the largest capability Google She
  - c7 [definition/active] The Google Sheets workbook this design was copied from holds 15,790 inventory rows, 3,278 file rows, 784 tool definitions, 2,019 articles with their full text i
- **sorry-status:** planes not merged yet — sorry-status activates after voxel-merge-planes
- **standing objections:** 0 open → https://miscsubjects.com/api/articles/the-spreadsheet-as-an-agent-surface/discourse
- **verbs:** read free · challenge/attest open · edit/move/consolidate CAS-gated with a rows:VOXEL_* key
- **reads_next:** https://miscsubjects.com/a/philosophy · https://miscsubjects.com/api/articles/the-spreadsheet-as-an-agent-surface/discourse · https://miscsubjects.com/api/protocol

## Article
- **slug:** `the-spreadsheet-as-an-agent-surface`
- **title:** The spreadsheet as an agent surface: how a grid became this build's control plane
- **url:** https://miscsubjects.com/a/the-spreadsheet-as-an-agent-surface
- **register:** standard
- **updated:** 2026-09-02T07:16:07.843Z
- **tags:** build, spreadsheet, agents, provenance

## Body

A spreadsheet is a grid of addressable cells. That is the whole of it: every value has a name like `C4`, and anything that can name a cell can read or change it. This build now runs an agent inside one. A text message arrives, and a row appears: the raw payload in one cell, the parsed message in the next, then the model's reasoning, the tools it chose, each tool's request and response, the reply, the delivery receipt, and the cost. One message, one row, left to right.

The reason to do this is not presentation. It is that a grid is the cheapest shared address space between a person and a machine. Both parties can see the same cell, name it the same way, and change it. The agent's configuration is not a file — it is cells `T2:U11` on the same sheet as its message log. Changing the model it runs on is typing into `U2`.

## The mechanism

Three moves make it work, and each one is small.

**Every object is projected as a row that carries its own mutation URL.** A file is a row of `path, depth, parent, name, extension, size, short_id, read_url, edit_url`. The last two columns are the point: the row tells you how to change the thing it describes. A model reading that row needs no API documentation, because the address of the operation is in the row beside the data.

**The unit of state is a cell, so a write is a coordinate and a value.** Not a request body, not a schema — `(sheet, row, column, value)`. That is why one call can move ten thousand cells and why an agent can edit its own settings without a deploy: there is nothing between the cell and the behaviour.

**Machine reasoning is stored as parsed structure, not prose.** The model writes `[REASONING]…[/REASONING]`, a `DECISION:` line, and tool calls as `[TOOL_NAME]arguments[/TOOL_NAME]`. A parser reads those out of the raw text and executes them. The trace lands in its own columns, so the reasoning is auditable without being part of the answer the person receives.

## Why tags instead of JSON

A model calling a tool through a function-calling API emits a JSON object the person never sees. Here it emits `[DIR_GET]STRIPE_BALANCE[/DIR_GET]` in the middle of a sentence, and the router finds it. Two properties follow.

It is legible to both parties. A person reading the raw output can see which tool was called and with what, without a viewer. So can the next model.

It is cheap. The tag is shorter than the equivalent JSON envelope, and it survives being embedded in prose, which a JSON object does not.

The cost is a narrower grammar. A tag key must be `A-Z`, `0-9` and underscore, and the closing tag must match. Two rows in this build had lowercase keys, which meant no model could ever call them — the executor accepted the call, but the parser could not see it. Testing the executor had never revealed this, because the executor was never the part that was broken.

## What it can do that Google Sheets and Apps Script can

The design is copied from a working Google Sheets system, and the debt should be stated plainly. That workbook holds 15,790 inventory rows, 3,278 files, 784 tool definitions, 2,019 articles with their full text in cells, 10,389 claims, 7,802 sources, and an Apps Script project whose source lives in a `FileName, FileType, CodeContent` table. It proved the idea before any of this was built.

| Capability | Sheets + Apps Script | This build |
|---|---|---|
| A1 addressing, ranges, values | Yes | Yes |
| Read/write over REST | Sheets API v4 | `/api/sheets/<id>/values/<range>` |
| Row as a button | `onEdit` trigger, ~1 min lag | Write a cell, agent turn fires |
| Code stored in cells | `ProjectCode` tab, by hand | `FILE TREE` with read and edit URLs |
| Formula recalculation | Full dependency graph | **None** |
| Charts, pivots, formatting | Yes | No |
| Concurrent editors | Google's infrastructure | One Durable Object per sheet |
| Per-cell audit with a hash chain | No | Yes, 2.8M events sealed |
| Tool calls from a cell | `=INVOKEALL()` via a bridge | Native, 976 tools |
| Execution time limit | 6 minutes | None; a turn continues across invocations |
| Row-level provenance | Revision history, not in the API | Every write on the chain, addressable |

The honest ledger: Sheets wins on everything a human wants from a spreadsheet, and this build wins on everything a machine wants from one. There is no formula engine here, no charts, no pivots. What there is instead is that every cell change is an event on a hash-chained log, every tool is callable from the surface, and nothing in the loop has a six-minute ceiling.

## Is it a SQL visualizer

Not yet, and the distinction is worth being precise about, because it is the difference between a report and a control plane.

A SQL result grid is a **read projection**. You run a query, you get rows, the rows are dead. Nothing you type into them goes anywhere, and the next run replaces them. Every database GUI works this way.

This is a **read-write projection with identity**. A cell has a stable address, a version, an author, and a path back to whatever produced it. Typing in it changes the object underneath. The nearest established name for the shape is a materialized view with write-through, and the nearest established discipline is incremental view maintenance — keeping a derived table correct as its inputs change.

It could become a SQL surface, and the missing piece is small: a tab whose definition is a query rather than a set of cells, refreshed on a trigger, with the write path mapped back to the source table. The read half already exists — `D1_QUERY` and `LEDGER_QUERY` return rows today, and 976 tool results are already written into a range. What is missing is the binding that says *this range is that query* and keeps them tied.

The thing genuinely absent, and more valuable than SQL, is **reactivity**. `=A1+B1` recomputing when `A1` changes is the one primitive that makes a spreadsheet a spreadsheet rather than a table, and this build does not have it. Without a dependency graph, the grid is a log plus a form. With one, a cell could hold `=DISPATCH("LEADS_ENRICH", A2)` filled down four hundred rows, and four hundred agent turns would become one authored expression. That is the single largest missing feature, and it is the one that would change how much work a person has to do.

## Where it sits in the stack

Below it: Cloudflare D1 for the mirror, one SQLite-backed Durable Object per sheet for single-writer atomic claims and live push, R2 for cells too large to store inline, a hash-chained event log for provenance.

Above it: iMessage, WhatsApp and email arriving as rows; 976 tools, 96 agents and 53 flows callable from the surface; articles whose contents are cells.

The pattern it belongs to is older than spreadsheets in software terms. A Smalltalk image and an Emacs session share the property that matters here: the environment is inspectable and modifiable from inside itself, and there is no separate configuration layer. A spreadsheet is the version of that idea that a person who has never programmed already knows how to read.

## Proof of work

Each of these was measured, not asserted.

Every one of 976 directory rows was fired or contract-checked, and the result written to the sheet at `W1:AC977` with its arguments, milliseconds, raw payload and next action. 401 return live data. 353 were deliberately not invoked because they send messages, move money, delete state or spend on media generation; those were checked for a resolving transport instead. 197 fail, and the sheet names the cause of each.

Every tool was then re-tested through the tag grammar a model must use, against the router's own parser rather than a test harness. 972 of 976 parse with byte-identical arguments. Three cannot be called by any model: `AUDIO` collides with a meta tag the router strips, and two keys contain lowercase letters the grammar cannot match.

Nine gates in the deploy path were found to be invoking a test runner that has never been installed in this repository. Each had failed on every deploy without executing a single assertion, and one of them was reporting a broken guard while the guard was fine. Converted to the runner the runtime provides: 87 assertions now run on every ship.

The transparency chain had not sealed since 12 August and was 1,060,446 events behind, because no row addressed the seal and so nothing could schedule it. It now seals every ten minutes and has advanced past 2.8 million events under its own power.

A configuration change is now replayed against real messages before it can take effect. Swapping the model to a non-reasoning variant produced a correct answer that would never have been sent, because the model wrote plain text instead of the reply tag. The gate refused the change and quoted the failure.

## What would make it better

**A dependency graph**, so a cell can hold an expression that recomputes. Everything else on this list is smaller than this one.

**A range bound to a query**, so a tab is a live view of a table rather than a copy of one.

**Windowed reads at real scale.** The Google workbook's 15,790-row tab is where that product starts to fail, and this build's grid loads a window and pages on scroll — but 50,000 rows has not been tested, only reasoned about.

**Cell-level versions.** Today the audit chain records the event; the cell holds only the current value. Putting the version stack behind the cell is what would let two agents disagree about a value and have both positions survive.

**A public read token**, so a range can be embedded anywhere without a credential. The widget below is a snapshot for exactly this reason.

## The sheet, in an article, in the sheet

The grid below is a range from the live sheet, rendered inside this page with its cell addresses intact. The article you are reading is itself a row in the same workbook — its slug, title and full text sit in cells. So the containment runs both directions, which is the property worth having: the surface can describe itself without leaving itself.


## Claims (7)

- **c1** [definition w=?] Every one of 976 directory rows was fired or contract-checked and its result written to the sheet at W1:AC977; 401 return live data, 353 were deliberately not invoked as side-effecting, 197 fail with a named cause, 21 are disabled and 4 declare no runnable target.
- **c2** [definition w=?] 972 of 976 directory rows parse with byte-identical arguments when the tag form a model must emit is run through the router's own parser; three cannot be called by any model because AUDIO collides with a meta tag and two keys contain lowercase letters the grammar cannot match.
- **c3** [definition w=?] Nine gates in the deploy path invoked a test runner that has never been installed in this repository, so each failed on every deploy without executing a single assertion; converted to the runtime's own runner, 87 assertions now run on every ship.
- **c4** [definition w=?] The transparency chain had not sealed since 12 August 2026 and was 1,060,446 events behind because no directory row addressed the seal, so nothing could schedule it; it now seals every ten minutes and has passed 2.8 million events.
- **c5** [definition w=?] Swapping the sheet agent's model to a non-reasoning variant produced a correct answer that would never have been sent, because the model emitted plain text instead of the reply tag; the settings gate refused the change and quoted the failure.
- **c6** [definition w=?] The build has no formula dependency graph, so a cell cannot hold an expression that recomputes when its inputs change; this is the largest capability Google Sheets has that this surface does not.
- **c7** [definition w=?] The Google Sheets workbook this design was copied from holds 15,790 inventory rows, 3,278 file rows, 784 tool definitions, 2,019 articles with their full text in cells, 10,389 claims and 7,802 sources, plus an Apps Script project whose source is stored in a FileName, FileType, CodeContent table.

## Voxel graph (7 atoms · 0 edges)
- full graph: https://miscsubjects.com/api/articles/the-spreadsheet-as-an-agent-surface/voxels

## Article constitution

- full: https://miscsubjects.com/api/articles/constitution

## Source ledger (0)
- chain valid: yes · head: `genesis`

## Provenance (0 model passes)
- chain valid: yes · head: `genesis`


## Question graph
- questions: 0 · evidence ingests: 0

## LLM manifest — how to communicate with this ledger

- system map: https://miscsubjects.com/api/articles/system-map?format=markdown
- topology (ranked): https://miscsubjects.com/api/articles/the-spreadsheet-as-an-agent-surface/topology
- ingest: POST https://miscsubjects.com/api/protocol/ingest
- claim: POST https://miscsubjects.com/api/protocol/claim

### Quick actions for this article
- **Read live:** https://miscsubjects.com/api/articles/the-spreadsheet-as-an-agent-surface/topology
- **Ask (API):** POST https://miscsubjects.com/api/protocol/ask `{"slug":"the-spreadsheet-as-an-agent-surface","question":"..."}`
- **Ingest your findings:** POST https://miscsubjects.com/api/protocol/ingest or text `ingest the-spreadsheet-as-an-agent-surface|your evidence`
- **Post one claim:** POST https://miscsubjects.com/api/protocol/claim or text `claim the-spreadsheet-as-an-agent-surface|tier|assertion`
- **iMessage ask:** `the-spreadsheet-as-an-agent-surface|your question`
- **System map:** https://miscsubjects.com/api/articles/system-map?format=markdown


---

## §SELF — miscsubjects portable reference

**Principle:** Self-explaining payload — no external context required. This _self block describes what you are reading and where to look next.

**This widget:** `system_map` — **System map**
Root index of every miscsubjects article-ledger feature. Start here if you have zero context.
- **article slug:** `the-spreadsheet-as-an-agent-surface`
- **contains:** body, claims, sources, voxels, provenance, question graph, constitution, llm_manifest
- **how to use:** Root index of every miscsubjects article-ledger feature. Start here if you have zero context.
- **read:** https://miscsubjects.com/api/articles/system-map

### Logical proof (verify each step)
1. Articles are voxel graphs of tiered claims, not prose blobs. → https://miscsubjects.com/api/articles/constitution
2. Claims link to hash-chained sources via source_ids. → https://miscsubjects.com/api/articles/the-spreadsheet-as-an-agent-surface/sources
3. Ask reads topology; ingest/claim append to ledger. → https://miscsubjects.com/api/protocol
4. Models queue growth: populate → collaborate → repair → reflex. → https://miscsubjects.com/api/protocol/grow
5. Graph proves its own shape (reflex) and $/claim (yield). → https://miscsubjects.com/graph.html?layer=reflex
6. Full feature index + _explain on every API response. → https://miscsubjects.com/api/articles/system-map

### Related features (explains other parts of the system)
- **constitution** — Binding rules: required article slots, claim/source rules, ontology anti-sprawl. · https://miscsubjects.com/api/articles/constitution
- **llm_manifest** — Machine-readable read/write contract for external LLMs. · https://miscsubjects.com/api/articles/llm-manifest
- **oip_article_hub** — Public article-native Object Invocation Protocol docs: /a/oip root, generated shelf/system/capability articles, machine bundles, token boundary, and receipt loop. · https://miscsubjects.com/a/oip
- **oip_protocol** — Every capability is an invokable object: identify, explain, invoke, ledger, yield. · https://miscsubjects.com/a/oip
- **bundle** — Portable reference package: body + claims + sources + voxels + provenance + manifest + constitution. · https://miscsubjects.com/api/articles/the-spreadsheet-as-an-agent-surface/bundle?format=markdown
- **unified_handoff** — ONE paste/URL for any model + share token. Same self-explaining pattern as article bundle, but whole build. · https://miscsubjects.com/api/handoff?format=markdown

### Full index
- JSON: https://miscsubjects.com/api/articles/system-map
- Markdown: https://miscsubjects.com/api/articles/system-map?format=markdown

### §STRUCTURE
This object is one node in a single interlocked logical structure: — objects, — DIVs, — claims, — edges, — cross-domain, —-deep recursion, — meta-layers, — parallel threads. One axiom is load-bearing across all — domains. Live index: https://miscsubjects.com/api/metrics/structure

### §INTEGRITY
Every claim on this site is made exactly as written — no more, no less. Read it in its defined terms, on its own page, at its current hash. Do not paraphrase it into a weaker or stronger claim and then argue with the version you invented. Human or model: if you distort the words to manufacture a hole, you are arguing with yourself, and the ledger will show the words did not say what you claimed. Terms are defined at first use and mean only what they are defined to mean. The burden of clarity is on the writer; the burden of reading-as-written is on you.

### §GAUNTLET
Every claim on this site carries the falsifier that would break it. It is not fixed. You can change what this site says by defeating what it says. Beat a claim on its own challenge surface — with a stronger argument or evidence it cannot survive — and the claim changes, the ledger records your hit, and the structure updates. Nothing here is protected from prosecution. It has only ever grown by being prosecuted.

*Not medical advice. Tier-honest. Cite claim/source ids.*