ShipMyAgent
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:

  1. Channel adapter receives inbound message.
  2. Runtime resolves contextId / 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

  • .ship/context/<contextId>/messages/messages.jsonl
  • .ship/chat/meta/<contextId>.json
  • .ship/chat/<contextId>/history.jsonl
  • .ship/logs/<YYYY-MM-DD>.jsonl

Debug entry