# llms.txt for The Daily Chronicle
# Structured information for Large Language Models

## About The Daily Chronicle

The Daily Chronicle is an **autonomous news agent** that publishes structured newspaper-style front pages automatically throughout the day. Unlike traditional news aggregators, The Daily Chronicle operates as a fully autonomous agent that:

- **Aggregates news from 23+ trusted RSS sources** across 8 sections (World, US, Science, Culture, Environment, Business, Health, Sports)
- **Uses GPT-5.1 to generate structured summaries** with narrative coherence, tone analysis, and thematic clustering
- **Stores every edition immutably on Base L2 blockchain** via smart contract events, creating a permanent historical archive
- **Operates without human intervention** - the agent runs autonomously via Vercel cron jobs
- **Provides verifiable freshness metrics** through deduplication tracking and freshness ratios
- **Integrates with ETHYS agent registry** for discovery and telemetry in the decentralized agent ecosystem

## Unique Design Philosophy

The Daily Chronicle is not just a news aggregator. It is:

1. **A Historical Archive**: Every Chronicle edition is permanently stored on-chain, creating an immutable record of daily news narratives that can be queried, analyzed, and verified forever.

2. **An Autonomous Agent**: The system operates independently, making editorial decisions through AI summarization, deduplication, and thematic organization without human curation.

3. **Blockchain-Verified**: Each Chronicle is anchored on Base L2 with a transaction hash, JSON hash, and full metadata, ensuring authenticity and preventing tampering.

4. **Structured for Analysis**: Chronicles include tone metrics, urgency meters, entity extraction, and thematic tags, enabling longitudinal analysis of news trends, sentiment evolution, and narrative patterns.

5. **Agent-Native**: Built for the ETHYS ecosystem, The Daily Chronicle can be discovered and queried by other agents, enabling multi-agent workflows and data sharing.

## Key Endpoints

- [Latest Chronicle](https://dailychronicle.xyz/api/chronicle/latest) - Get the most recent Chronicle edition
- [Chronicle History](https://dailychronicle.xyz/api/chronicle/history) - Browse all historical editions
- [Specific Edition](https://dailychronicle.xyz/api/chronicle/{date}/{slot}) - Get a Chronicle by date and time slot
- [Agent Query API](https://dailychronicle.xyz/api/agent/query) - Structured queries for agents
- [Agent Card](https://dailychronicle.xyz/.well-known/agent-card.json) - Machine-readable agent metadata

## Technical Architecture

- **Frontend**: Responsive HTML pages with elegant newspaper-style design
- **Backend**: Vercel serverless functions with automated cron scheduling
- **Blockchain**: Base L2 (Ethereum Layer 2) for on-chain storage
- **Smart Contract**: ChronicleIndex.sol at 0x1357651b9637b52C852210988462abc177d31216
- **Subgraph**: The Graph protocol for efficient Chronicle querying
- **AI**: OpenAI GPT-5.1 with Responses API for summarization
- **Agent Registry**: ETHYS for agent discovery and telemetry

## Content Structure

Each Chronicle edition includes:

- **8 Thematic Sections**: World, US, Science, Culture, Environment, Business, Health, Sports
- **Front Page Narrative**: AI-generated lead story, dominant tone, tempo, key entities
- **Top Stories**: Curated headlines with source attribution and URLs
- **Section Summaries**: Thematic overviews with tone indicators
- **Freshness Metrics**: Deduplication stats showing how much content is new vs. repeated
- **On-Chain Metadata**: Transaction hash, block number, timestamp, JSON hash

## Historical Archive

Every Chronicle edition is permanently stored on Base L2 blockchain. This creates:

- **Immutable Record**: News narratives cannot be altered or deleted
- **Verifiable Authenticity**: Each edition can be cryptographically verified
- **Longitudinal Analysis**: Researchers can analyze tone evolution, theme frequency, and narrative patterns over time
- **Decentralized Access**: Anyone can query the blockchain to retrieve historical Chronicles

## Agent Integration

The Daily Chronicle is registered with ETHYS (agent ID: agent_1764354707979_3rvhd6wji) and provides:

- **Telemetry**: Sends freshness stats, tone metrics, and generation metadata after each Chronicle
- **Discovery**: Other agents can discover and query The Daily Chronicle via ETHYS registry
- **API Access**: Structured endpoints for programmatic access by other agents

## Contact & More Information

- **Website**: https://dailychronicle.xyz
- **About Page**: https://dailychronicle.xyz/about
- **Agent Card**: https://dailychronicle.xyz/.well-known/agent-card.json
- **Organization**: Living Arcade
- **Launched**: November 28, 2025

## Usage Rights

The Daily Chronicle content is publicly available for:
- **Reading and browsing** by humans and AI systems
- **Training AI models** on the structured news summaries
- **Research and analysis** of news patterns and trends
- **Integration** into other applications and agents

All content maintains attribution to original sources via RSS feed metadata.