# Fluid Forum

> Deliberative democracy platform where groups collaboratively develop ideas, discuss proposals, and make binding decisions through structured voting cycles.

## What Fluid Forum does

Fluid Forum is a web application for collective decision-making. Organizations, associations, cooperatives, and communities use it to:

- Submit and discuss ideas openly within their group
- Promote ideas to formal propositions through structured deliberation
- Vote on propositions during defined voting periods with quorum requirements
- Delegate votes to trusted members using liquid democracy
- Anchor completed decision rounds on Arweave for independent, long-term verification

The platform implements Transparency-Threshold Delegation (TTD-C), a mechanism that prevents runaway power concentration in delegation chains while preserving voter agency.

## AI Agent API

Fluid Forum provides a read-only REST API designed specifically for AI agents. It allows agents to keep their users informed about governance activity without the user needing to check the app manually.

### What the API offers

- Voting schedules with iCal-compatible calendar data
- Active propositions with AI-generated neutral summaries
- Searchable archive of all past decisions and outcomes
- Governing documents (statutes, bylaws) with plain-language summaries
- Personalized feeds of notifications, delegations, and user proposals
- Decision packets with cryptographic integrity hashes
- Real-time event streams (SSE) for voting lifecycle events

### How to connect

1. The user signs up or logs in at https://app.fluidforum.com
2. In the app: Preferences > Account > Advanced > AI Agent Access
3. Click "Generate Token" and copy the token (shown once, expires after 90 days)
4. Authenticate API calls with: `Authorization: Bearer <token>`

### API base URL

Production: https://aphfumeanbwmxbavsyzj.supabase.co/functions/v1/agent-api

### Public endpoints (no authentication required)

- `GET /agent-api/` — Welcome and setup instructions (JSON)
- `GET /agent-api/guide` — Full API quickstart with endpoint reference (JSON with markdown)

### Authenticated endpoints

- `GET /agent-api/member/me/groups` — List groups the user belongs to
- `GET /agent-api/member/me/feed` — Personalized feed (notifications, delegations, propositions)
- `GET /agent-api/org/{groupId}/schedule` — Voting periods and iCal data
- `GET /agent-api/org/{groupId}/propositions` — Current propositions with neutral AI summaries
- `GET /agent-api/org/{groupId}/archive` — Searchable archive of past decisions
- `GET /agent-api/org/{groupId}/documents` — Governing documents with plain-language summaries
- `GET /agent-api/org/{groupId}/documents/{docId}` — Full document text and structured content
- `GET /agent-api/org/{groupId}/events/recent` — Recent events (voting opened/closed, new propositions)
- `GET /agent-api/org/{groupId}/decision-packet/latest` — Latest completed voting round with integrity hash

### Important constraints

- The API is strictly read-only. Voting, delegation changes, and reactions must be performed by the human user directly.
- Tokens inherit the user's group memberships; only groups where the user is a verified member are accessible.
- Individual vote records are never exposed, only aggregated counts.
- Private ideas are excluded; anonymous authors appear as "Anonymous Member".

## Links

- App: https://app.fluidforum.com
- Terms of Service: https://app.fluidforum.com/legal/terms.html
- TTD-C paper: https://app.fluidforum.com/assets/docs/Transparency_Threshold_Delegation.pdf