Core Concepts
Message Processing Flow
End-to-end flow from inbound message to outbound reply
Message Processing Flow
For chat channels, the runtime flow is:
- Channel adapter receives inbound message.
- Runtime resolves
contextId/chatKeyand persists history/meta. - Agent execution is scheduled serially per conversation.
- Agent uses tools (for example,
chat send) to generate user-visible output. - Reply is dispatched to channel and logged.
Key directories
.ship/context/<contextId>/messages/messages.jsonl.ship/chat/meta/<contextId>.json.ship/chat/<contextId>/history.jsonl.ship/logs/<YYYY-MM-DD>.jsonl