getcompanion-ai/co-mono
1
0
Fork 0
mirror of https://github.com/getcompanion-ai/co-mono.git synced 2026-04-17 09:02:08 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Update Message History section and remove Key Concepts

Browse source
This commit is contained in:
badlogic 2025-12-13 20:48:47 +00:00
parent f44549cfe8
commit 2e2de3905d
1 changed files with 5 additions and 14 deletions
Download patch file Download diff file Expand all files Collapse all files

19
packages/mom/README.md
View file

@ -271,19 +271,18 @@ Update mom anytime with `npm install -g @mariozechner/pi-mom`. This only updates
## Message History ## Message History
Mom uses two files per channel: Mom uses two files per channel to manage conversation history:
**log.jsonl** (source of truth): **log.jsonl** ([format](../../src/store.ts)) (source of truth):
- All messages from users and mom (no tool results) - All messages from users and mom (no tool results)
- Custom JSONL format with timestamps, user info, text, attachments - Custom JSONL format with timestamps, user info, text, attachments
- Append-only, never compacted - Append-only, never compacted
- Used for syncing to context and searching older history - Used for syncing to context and searching older history
**context.jsonl** (LLM context): **context.jsonl** ([format](../../src/context.ts)) (LLM context):
- What's sent to the LLM (includes tool results) - What's sent to the LLM (includes tool results and full history)
- Contains full history plus compaction events
- Auto-synced from `log.jsonl` before each @mention (picks up backfilled messages, channel chatter) - Auto-synced from `log.jsonl` before each @mention (picks up backfilled messages, channel chatter)
- When exceeds token limit (default 100k): keeps recent messages, summarizes older ones into checkpoint - When context exceeds the LLM's context window size, mom compacts it: keeps recent messages and tool results in full, summarizes older ones into a compaction event. On subsequent requests, the LLM gets the summary + recent messages from the compaction point onward
- Mom can grep `log.jsonl` for older history beyond what's in context - Mom can grep `log.jsonl` for older history beyond what's in context
## Security Considerations ## Security Considerations
@ -389,14 +388,6 @@ cd packages/mom
npx tsx --watch-path src --watch src/main.ts --sandbox=docker:mom-sandbox ./data npx tsx --watch-path src --watch src/main.ts --sandbox=docker:mom-sandbox ./data
``` ```
### Key Concepts
- **SlackContext**: Per-message context with respond/setWorking/replaceMessage methods
- **AgentRunner**: Returns `{ stopReason }`. Never throws for normal flow
- **Working Indicator**: "..." appended while processing, removed on completion
- **Memory System**: MEMORY.md files loaded into system prompt automatically
- **Prompt Caching**: Recent messages in user prompt (not system) for better cache hits
## License ## License
MIT MIT