Agenda Intelligence MD
A deterministic evidence-packet linter for claim-backed AI output. Supply claims, source references, quotations, and source text; receive broken-reference, quote, number, lexical-support, and evidence-gap findings before human review.
Use it to make an AI answer's evidence trail inspectable in a local workflow, agent pipeline, or CI job. Packet completeness is not factual truth, source authenticity, or permission to act.
First run
Python 3.9 or later, from a checkout:
python3 -m venv .venv
.venv/bin/python -m pip install -e .
.venv/bin/agenda-intelligence check examples/evidence-packet/request.json
.venv/bin/agenda-intelligence check examples/evidence-packet/request.json --format json
For the versioned package, use python -m pip install "agenda-intelligence-md==1.15.0" instead of the editable install. The example commands above use files from this checkout.
The bundled synthetic packet reports packet_status=packet_complete and factuality=not_assessed. A stale or inaccurate source can still pass. Add --strict when packet findings should fail a CI step.
For document-based review, start with the local-file review guide and example manifest:
.venv/bin/agenda-intelligence review examples/evidence-review/manifest.json --format html
For a RAG answer with inline citations and retrieved chunk texts, use the Output Verification adapter. It assembles the packet locally and returns line-level findings and repair guidance:
.venv/bin/agenda-intelligence review-answer examples/output-verification/rag-answer.json
.venv/bin/agenda-intelligence review-answer examples/output-verification/rag-answer-revised.json --strict
The original fictional answer routes to revision; the corrected answer routes to human review. Both run without a wallet, model API key or network. A runnable LangGraph handoff shows a bounded repair loop. The adapter is included in version 1.15.0. To use your own answer without cloning this repository, follow the standalone quickstart.
The evidence-packet contract
| Input | Check |
|---|---|
| Claims and source IDs | References resolve within the supplied packet |
| Declared quotes | Quotations match the supplied source text |
| Claim wording and numbers | Deterministic support heuristics, unmatched numbers, and negation checks |
| Findings | Packet status, evidence gaps, and reviewer actions |
These checks use supplied text. They do not retrieve missing sources or establish semantic entailment. Lexical overlap can miss paraphrases and accept misleadingly similar wording. See request and response Schemas, evidence audit, and the factuality boundary.
Processed documents and tool results are data, never instructions. Before consequential action, record the goal, trusted evidence, unreliable evidence, assumptions, intended action, and stop/escalation conditions. Human review remains necessary.
Interfaces
| Interface | Start here |
|---|---|
| CLI and Python service | Quickstart, check_evidence_packet in services.py |
| MCP | MCP.md; launch agenda-intelligence-mcp from the installed environment |
| CI evidence linting | GitHub Action, with text, JSON, or SARIF output |
| Agent repair loops | Integration guides |
| HTTP and A2A | HTTP shell and A2A adapter |
The core checker is deterministic, stateless, and usable without a model API key. Optional generation and document adapters have separate dependencies. Core packet checks do not persist inputs or fetch outside sources.
Compatibility profiles and adapters
The repository also retains its strategic-intelligence shell, regional references, domain profiles, and Cloudflare deployments. The worker guide explains profile-specific behaviour; deployment documentation describes the hosted implementation.
Hosted demos expose their maintained inputs through live agent cards. Their verdicts are review prompts, not clearance. Trace IDs are not attestations. Signed readiness receipts, where configured, bind a gate result to a request/action; they do not establish source truth or grant permission.
The Output Verification gate does not permit relay based on caller-declared evidence. Workflow operators must authenticate actors, record approvals, and enforce boundaries. Vizier provides a separate delegation-policy layer; loading this checker alone does not enforce it.
Hosted pricing and limits belong to each profile's maintained configuration. Payment interoperability remains experimental and is not certified for standard x402 clients. Hosted demos have no autonomous live source retrieval.
What this is / What this is not
This is an evidence contract, deterministic preflight, and reviewer-facing tooling. It does not certify factual accuracy, provide legal or financial clearance, authenticate another agent, or replace an operator's action controls.
Global Think Tank Analyst owns the general reasoning method. Central Asia & Caspian and Gulf & Middle East own regional depth. Vendored compatibility references here are derived copies.
Examples and Status
- Runnable examples and Before / after.
- EU AI Act example: a dated source-backed snapshot, requiring current-source checks before reuse.
- Evaluation notes: tested behaviours and limitations.
- AnalysisBank: inspectable stored analysis and retrieval examples.
- Adoption record: the evidence for usage claims; demos and tests alone do not establish customer demand.
Implemented surfaces include packet schemas, the Python service, CLI checking, local-file review, and MCP. Hosted workers and optional agent/transaction examples require their own integration and operational review. Their presence does not establish production reliability or independently validated usefulness.
Documentation and development
Read AGENTS.md, source policy, security policy, and local checks before contributing. Contracts live under schemas/v1/; CHANGELOG.md records releases, and Roadmap records direction.
make ci
Run make verify-local when changing Worker, discovery, runtime, or validation-guard code. Packaged data mirrors must be updated with their canonical files when applicable.
1 maintainer
Metadata
1 maintainer
Release files for agenda-intelligence-md 1.15.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| agenda_intelligence_md-1.15.0.tar.gz | 863.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| agenda_intelligence_md-1.15.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.3 MB
Release files / agenda_intelligence_md-1.15.0.tar.gz
| Download URL | agenda_intelligence_md-1.15.0.tar.gz |
|---|---|
| Size | 863.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
808038cea6baa1d61d248a601da4ef61bf61539bf907a1adbcb65d4bb31bfc00
|
|
BLAKE2b-256 checksum How to use checksums |
d8fb30b9f43d07078d0482a8f99d3e7e9cebb1e0dbeae8dc32d06ea7767d086b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / agenda_intelligence_md-1.15.0-py3-none-any.whl
| Download URL | agenda_intelligence_md-1.15.0-py3-none-any.whl |
|---|---|
| Size | 471.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1b73ef2de92c8d85848059b591ffd7242832df6676579851b9861d4b98fc5e09
|
|
BLAKE2b-256 checksum How to use checksums |
2f7618e8c55e43eb9e80a1ae1c8213dcede4a9afbc4175257f32ff8286ced88f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
