chat_send
Send a message to an active cloud architecture session and get a response with usage metrics. Use for design requests, modifications, or cost inquiries after creating a session.
Instructions
Send a message to an existing conversation session and get a response.
Returns {'response': str, 'spec': dict|None, 'usage': dict, 'cumulative_usage': dict}.
spec is populated when the turn produced or modified an ArchSpec.
usage reports LLM token counts for this turn; cumulative_usage totals
across the whole session.
When to use: Every turn after chat_create_session. For zero-state
single-shot calls use design_architecture / modify_architecture
instead.
Behavior: Calls an LLM — incurs API costs proportional to the conversation history length (history grows each turn). Persists updated session state back to the session store.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| session_id | Yes | Session handle returned by `chat_create_session`. Must reference an existing session; otherwise the tool returns `{'error': ...}`. | |
| message | Yes | User message for this conversation turn. Can be a design request, a modification instruction, a question about the current spec, or meta-commands (e.g. 'show me the cost'). |