# AgentStartPayload

**Kind:** Interface

**Source:** [`atloria-monorepo/apps/api/src/agent/agent.types.ts`](https://github.com/sherkety/atloria/blob/main/atloria-monorepo/apps/api/src/agent/agent.types.ts#L28)

Agent WebSocket Protocol Types

Defines the event contract between frontend and backend for real-time
agent sessions. Mirrors the CLI experience over WebSocket.

Client → Server:
  agent:start    — Create a new session
  agent:send     — Send a message to the agent
  agent:inject   — Inject a message mid-task
  agent:cancel   — Cancel the current operation

Server → Client:
  agent:thinking   — Agent is processing
  agent:tool_start — Tool call started
  agent:tool_end   — Tool call completed
  agent:message    — Agent text output (streamed or full)
  agent:todo       — Todo list updated
  agent:turn_done  — Turn completed with usage stats
  agent:error      — Error occurred
  agent:ended      — Session ended

## Properties

| Property | Type |
|---|---|
| `workspace` | `string` |
| `model` | `string` |
| `maxTurns` | `number` |
| `projectId` | `string` |
| `organizationId` | `string` |
| `superMode` | `boolean` |
| `verbose` | `boolean` |
| `autonomous` | `boolean` |
| `testCommand` | `string` |
| `resumeSessionId` | `string` |
| `routingTable` | `'gpt54-family' | import('@atloria/agent-core').ModelRoutingTable` |
| `mode` | `import('@atloria/agent-core').TaskMode` |