Metadata-Version: 2.4
Name: llama-index-tools-csoai
Version: 0.1.3
Summary: LlamaIndex tool spec for the Council of AI GSPC measurement board (wraps csoai-gspc).
Author-email: CSOAI Ltd <nicholas@csoai.org>
License: Apache-2.0
Project-URL: Homepage, https://councilof.ai
Project-URL: Board, https://councilof.ai/api/gspc
Project-URL: Doctrine, https://councilof.ai/doctrine/
Keywords: csoai,gspc,layer0,measurement,llama-index,llamaindex
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: csoai-gspc>=0.2.20260930.1
Requires-Dist: llama-index-core>=0.12
Dynamic: license-file

# llama-index-tools-csoai

LlamaIndex tool spec for the Council of AI GSPC board — a thin wrapper over [`csoai-gspc`](https://pypi.org/project/csoai-gspc/) (0.2.20260930.1+), the
reader for Council of AI's live GSPC board (https://councilof.ai/api/gspc). Two tools: `gspc_board` (the live board) and
`verify_card` (free signed-card verification — VALID / INVALID / UNCHECKABLE).

```python
from llama_index.tools.csoai import CSOAIGSPCToolSpec

tools = CSOAIGSPCToolSpec().to_tool_list()  # gspc_board, verify_card
print(tools[0].call())  # board totals
print(tools[1].call(card_id="acf6bf0356123632758bf6c98c83d81c7a8392c3b111b311317c516cc65133a4"))  # free verification
```

`gspc_board` returns one of three states: `LIVE` (totals or the axis row, verbatim from the board),
`ABSENT` (no axis by that name or alias), `UNREACHABLE` (the board could not be fetched — no cached or
invented number is ever returned). Measurement only: a card is evidence, never a grade, mark or endorsement. Verification is free.

`verify_card` takes `card_id` (the full 64-hex id) or `card` (the JSON) and returns `VALID`,
`INVALID` with the reason, or `UNCHECKABLE` — "could not check" is never "forged". It is free, always.
The same verdicts are served by the remote MCP server at https://councilof.ai/mcp.

Data: https://councilof.ai/api/gspc · Corrections ledger: https://councilof.ai/corrections/ (JSON: https://councilof.ai/api/corrections) · Verify a card, free: https://councilof.ai/gspc-verify/

Licence: Apache-2.0. Doctrine: `docs/DOCTRINE.md` sha256 `845fc1d200eb9e867fc8d682750409d6725084bac632726187759f8fefdfbe0a` (human page https://councilof.ai/doctrine/).
Generated by `scripts/harness-x/render.mjs` — do not hand-edit.
