# ZoneGaze Chat Plugin

## Role

First-party Matrix plugin for workspace-scoped AI conversations.

## Source Boundaries

- Plugin UI: `plugins/chat/apps/web/src/`
- Runtime service: `flow/runtime/src/chat/`
- Shared streaming/contracts: `flow/contracts/src/api-contract.ts`

## Current Capability Signals

- Capability registry: `chat`
- Runtime/package status: `ready`
- Default provider path: local Ollama-compatible endpoint

## Major Features

- Local conversation persistence per workspace
- Project context attachment
- Whispr transcript insertion
- Deep Research evidence cards and linked research sessions
- Settings and tool-approval aware runtime integration

## Current Matrix Coordination

- `Flow`: Chat is workspace-scoped and can attach Flow project context to conversations.
- `Whispr`: Chat exposes dictation-driven message entry instead of treating voice input as a
  separate app.
- `Research`: Chat already supports linked research sessions, Deep Research requests, evidence
  cards, and cited research metadata on messages.
- `Code`: use Chat for reasoning and planning while Code handles editing in the same project.
- `Exo`: local-model usage beside Chat is directionally supported, but universal plugin-to-Exo
  routing is still a future coordination target.

## Related Docs

- [Plugin README](../../plugins/chat/README.md)
- [AI chat architecture](../architecture/ai-chat.md)
- [Matrix feature catalog](../features/matrix-feature-catalog.md)
- [Matrix plugin coordination](plugin-coordination.md)
