> ## Documentation Index
> Fetch the complete documentation index at: https://docs.app.useharmonia.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Platform and infrastructure

> Technology map for Harmonia's UI, agent runtime, durable state, integrations, media pipeline, and observability.

Harmonia separates agentic judgment from deterministic workflow authority. Models analyze, plan, write, review, compose bounded interfaces, and answer read-only questions. Application services own state transitions, approvals, external effects, receipts, and verification.

## How Harmonia uses it

| Area                   | Components                                                                        | Responsibility                                                                                         |
| ---------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| UI                     | Next.js, React, Vercel AI SDK 7                                                   | Dashboard, chat, authenticated APIs, and server-hydrated generative surfaces                           |
| Agents and AI          | Strands Agents SDK, Bedrock, AgentCore Runtime, AgentCore Memory                  | Bounded specialist reasoning and eligible advisory memory                                              |
| Security and identity  | Amazon Cognito, IAM roles, AWS Secrets Manager                                    | Operator identity, machine identity, and server-side credentials                                       |
| Storage and messaging  | DynamoDB, SQS, Amazon S3                                                          | Durable workflow truth, asynchronous stage delivery, and binary assets                                 |
| Runtime and automation | ECS Fargate, EventBridge Scheduler                                                | Web/worker hosting and authenticated durable ticks                                                     |
| Media                  | ffmpeg, Nova Canvas, Nova Reel, ElevenLabs Music                                  | Deterministic rendering and approval-gated generated assets                                            |
| Integrations           | X API, Telegram Bot API, Google Calendar API, Hacker News Algolia, YouTube        | Publishing, operator access, explicit calendar synchronization, public signals, and authorized sources |
| Observability          | OpenTelemetry, CloudWatch traces target, structured logs, metrics, budget records | Correlation, diagnosis, usage accounting, and operator visibility                                      |

<Warning>DynamoDB is the durable workflow authority. AgentCore Runtime sessions, AgentCore Memory facts, model output, telemetry, and external API responses cannot approve or authorize an effect.</Warning>

## Evidence status

Repository tests and local emulator runs establish contract behavior. A technology page labels authenticated cloud or provider evidence separately. Code presence, mock mode, or a deploy script is not proof that a managed service or external effect has run successfully.

## Source map

* `src/` — Next.js UI, APIs, state, integrations, and telemetry
* `agent/harmonia_agent/` — Strands team, worker stages, media, memory, and provider clients
* `infra/` — AWS CDK and deployment wrappers
* `docs/` — operational contracts and evidence runbooks