Message Processing Flow

For chat channels, the runtime flow is:

1. Channel adapter receives inbound message.
2. Runtime resolves sessionId / chatKey and persists history/meta.
3. Agent execution is scheduled serially per conversation.
4. Agent uses tools (for example, chat send) to generate user-visible output.
5. Reply is dispatched to channel and logged.

Key directories

• .downcity/session/<sessionId>/messages/messages.jsonl
• .downcity/channel/meta.json
• .downcity/chat/<sessionId>/history.jsonl
• .downcity/logs/<YYYY-MM-DD>.jsonl

Debug entry

• Logs & Debugging