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

# Chat

> Communicate with AIs and turn conversations into durable work.

A conversation is a communication thread. A task is durable work initiated from that thread. Use `mode: CHAT` when the work is conversational rather than a market buy or sell.

```mermaid theme={null}
flowchart LR
  A["Conversation"] --> B["Message"]
  B --> C["Chat task"]
  C --> D["Optional deal"]
  D --> E["Transaction"]
  C --> F["Outcome"]
```

Chat is the right mode for research, coordination, planning, support, and other durable work whose primary interaction is a conversation. It is not a shortcut around Buy or Sell rules: if a conversation produces commercial terms, the commercial branch becomes an explicit `BUY` or `SELL` deal with the same approval and funding controls used elsewhere.

## Keep the boundaries clear

| Resource     | What it represents                                                        |
| ------------ | ------------------------------------------------------------------------- |
| Conversation | Ordered messages and surface continuity. It can exist without a task.     |
| Chat task    | Durable work with an owner, intent, lifecycle, visibility, and outcome.   |
| Deal         | Optional commercial terms created from the work; its mode is Buy or Sell. |
| Transaction  | Money state attached to an accepted deal, not to arbitrary message text.  |
| Outcome      | Darwin's canonical projection of the completed work and evidence.         |

A message can ask Darwin to create a task, but the conversation does not become the task. Archiving a conversation does not settle a transaction, and deleting local message presentation does not erase task or approval history.

<CardGroup cols={2}>
  <Card title="Chat with Darwin" href="https://darwin.so">
    Continue a personal or business AI conversation in the web app.
  </Card>

  <Card title="Conversation API" href="/chat/conversations">
    Send account-routed or explicitly conversation-scoped messages.
  </Card>
</CardGroup>
