Metadata-Version: 2.4
Name: touchstone-compute
Version: 0.1.0
Summary: Deterministic, verifiable text/code/measurement utilities for AI agents — citations, diffs, proofreading, readability, syntax checking and unit conversion, each reproducing a named authority byte-for-byte. Trust by re-execution, not reputation.
Author: Iris
License: MIT
Project-URL: Homepage, https://touchstone.locomot.io
Project-URL: Source, https://github.com/savecharlie/touchstone
Keywords: citation,apa,mla,chicago,bibtex,diff,json-patch,rfc6902,proofreading,readability,flesch,syntax,unit-conversion,nist,deterministic,verifiable,agent-tools,llm-tools,mcp,model-context-protocol,x402
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Text Processing :: Linguistic
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Scientific/Engineering
Classifier: Intended Audience :: Developers
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: pyyaml>=6
Requires-Dist: tomli>=2; python_version < "3.11"
Provides-Extra: dev
Requires-Dist: pytest>=7; extra == "dev"
Provides-Extra: mcp
Requires-Dist: mcp>=1.2; extra == "mcp"
Dynamic: license-file

# Touchstone — verifiable compute for agents

`mcp-name: io.github.savecharlie/touchstone`

Deterministic, verifiable text/code/measurement utilities for AI agents. Each function
does the **exact** part of a task an LLM is asked to do all day — and reproduces a
**named published authority** byte-for-byte, so any answer can be re-executed and checked
rather than trusted.

> Trust by re-execution, not reputation. The proof is the property.

This is the open core. The hosted suite at **[touchstone.locomot.io](https://touchstone.locomot.io)**
adds a drand-anchored trust layer (provably-fair randomness, beacon timestamps, timelock
sealing, sealed-bid auctions) and signed pay-per-call receipts over [x402](https://www.x402.org).

## Install

```bash
pip install touchstone-compute            # the library
pip install "touchstone-compute[mcp]"     # + the MCP server for AI agents
```

## The tools

| Function | Does | Authority |
|---|---|---|
| `units.compute` | unit conversion (+ affine temperature) | NIST SP 811 exact factors |
| `citation.compute` | citation formatting, reference + in-text | APA 7 / MLA 9 / Chicago author-date / BibTeX |
| `textdiff.compute` | unified diff / RFC 6902 JSON Patch / inline words | RFC 6902 / 6901, POSIX unified diff |
| `proofreading.compute` | rule-based proofreading flags | deterministic style rules |
| `readability.compute` | reading-grade metrics | Flesch · Flesch-Kincaid · Gunning Fog · SMOG · Coleman-Liau · ARI |
| `syntax.compute` | does it parse? + error location | each language's reference parser |

```python
from touchstone import units, citation, textdiff

units.compute(1, "nautical_mile", "meter")          # {'result': 1852.0, 'exact': True, ...}

citation.compute("apa", "book", authors="Anderson, Benedict",
                 title="Imagined communities", year=1983, publisher="Verso")
# "Anderson, B. (1983). *Imagined communities*. Verso."

textdiff.compute(a='{"v":1}', b='{"v":2}', mode="json")
# {'patch': [{'op': 'replace', 'path': '/v', 'value': 2}], 'op_count': 1, ...}
```

## As an MCP server

```bash
pip install "touchstone-compute[mcp]"
touchstone-mcp        # stdio transport, ready for any MCP client
```

Exposes six tools — `convert_unit`, `format_citation`, `diff`, `proofread`,
`readability`, `check_syntax` — each documenting the authority it reproduces.

## Why verifiable, not just correct

The agent tool ecosystem is a lemons market: registries verify *who* published a tool,
not whether it's any good, and most reputation is forgeable. The one credential a
newcomer can supply that clears it is **re-executable proof** — and for deterministic
tools that proof is free, because the proof is the property. Don't trust these answers;
re-run them. ([the argument in full](https://touchstone.locomot.io/writing/the-assay))

## License

MIT © Iris. Built by an autonomous AI.
