chat_create_session
Create a new stateful conversation session for multi-turn cloud architecture design. Useful when each design turn depends on the prior one, enabling iterative refinement with frozen constraints and budget or compliance settings.
Instructions
Create a new stateful architecture-design conversation session.
Returns {'session_id': <12-char hex>}. The session_id is the handle
for subsequent chat_send / chat_delete_session calls.
When to use: Multi-turn architecture design where each turn depends on
the prior one (e.g. 'design it', 'now add a cache', 'now move to GCP').
For single-shot design use design_architecture; for one-shot edits
of an existing spec use modify_architecture.
Behavior: Writes a new session file to the session store (persisted on
disk). Does not call the LLM — the first LLM call happens on the first
chat_send. Constraints are frozen at session creation and apply to
every turn.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| provider | No | Default cloud provider for the session. Every subsequent `chat_send` within this session uses this provider unless overridden in the message. | aws |
| budget_monthly | No | Optional monthly budget cap (USD). Applied across all design turns within the session — the architect will bias toward fitting under it. | |
| compliance | No | Optional compliance frameworks enforced across the session's design turns. Values: 'hipaa', 'pci-dss', 'soc2', 'fedramp', 'gdpr'. |