@oh-my-pi/pi-mom 1.337.0

package/CHANGELOG.md

@@ -0,0 +1,277 @@
+# Changelog
+
+## [Unreleased]
+
+## [0.31.1] - 2026-01-02
+
+## [0.31.0] - 2026-01-02
+
+### Breaking Changes
+
+- `AgentTool` import moved from `@oh-my-pi/pi-ai` to `@oh-my-pi/pi-agent-core`
+- `AppMessage` type renamed to `AgentMessage`
+- `Attachment` type replaced with `ImageContent` for image handling
+- `MomSessionManager.loadSession()` renamed to `buildSessionContex()`
+- `MomSessionManager.createBranchedSessionFromEntries()` signature changed to `createBranchedSession(leafId)`
+- `ProviderTransport` removed from Agent config, replaced with direct `getApiKey` callback
+- `messageTransformer` renamed to `convertToLlm`
+- `ANTHROPIC_API_KEY`/`ANTHROPIC_OAUTH_TOKEN` no longer checked at startup (deferred to first API call)
+
+### Changed
+
+- Session entries now include `id` and `parentId` fields for tree structure support
+- Auth lookup now uses `AuthStorage` class instead of direct environment variable access
+- Image attachments use `ImageContent` type with `data` field instead of `Attachment` with `content`
+- `session.prompt()` now uses `images` option instead of `attachments`
+
+### Added
+
+- Support for OAuth login via coding agent's `/login` command (link `~/.pi/agent/auth.json` to `~/.pi/mom/auth.json`)
+
+## [0.20.2] - 2025-12-13
+
+### Fixed
+
+- **Skill paths now use container paths**: Skill file paths in system prompt are translated to container paths (e.g., `/workspace/skills/...`) so mom can read them from inside Docker.
+
+## [0.20.1] - 2025-12-13
+
+### Added
+
+- **Skills auto-discovery**: Mom now automatically discovers skills from `workspace/skills/` and `channel/skills/` directories. Skills are directories containing a `SKILL.md` file with `name` and `description` in YAML frontmatter. Available skills are listed in the system prompt with their descriptions. Mom reads the `SKILL.md` file before using a skill.
+
+## [0.19.2] - 2025-12-12
+
+### Added
+
+- Events system: schedule wake-ups via JSON files in `workspace/events/`
+  - Immediate events: trigger when file is created (for webhooks, external signals)
+  - One-shot events: trigger at specific time (for reminders)
+  - Periodic events: trigger on cron schedule (for recurring tasks)
+- `SlackBot.enqueueEvent()` for queueing events (max 5 per channel)
+- `[SILENT]` response marker: deletes status message, posts nothing to Slack (for periodic events with nothing to report)
+- Events documentation in `docs/events.md`
+- System prompt section explaining events to mom
+
+## [0.18.8] - 2025-12-12
+
+### Changed
+
+- Timestamp prefix now includes timezone offset (`[YYYY-MM-DD HH:MM:SS+HH:MM]`)
+
+## [0.18.7] - 2025-12-12
+
+### Added
+
+- Timestamp prefix on user messages (`[YYYY-MM-DD HH:MM:SS]`) so mom knows current date/time
+
+### Fixed
+
+- Sync deduplication now strips timestamp prefix before comparing
+
+## [0.18.6] - 2025-12-12
+
+### Fixed
+
+- Duplicate message in context when message has attachments (sync from log didn't strip attachment section before comparing)
+- Use `<slack_attachments>` delimiter for attachments in messages (easier to parse/strip)
+
+## [0.18.5] - 2025-12-12
+
+### Added
+
+- `--download <channel-id>` flag to download a channel's full history including thread replies as plain text
+
+### Fixed
+
+- Error handling: when agent returns `stopReason: "error"`, main message is updated to "Sorry, something went wrong" and error details are posted to the thread
+
+## [0.18.4] - 2025-12-11
+
+### Fixed
+
+- Attachment downloads now work correctly
+  - SlackBot now receives store for processing file downloads
+  - Files are downloaded in background and stored in `<channel>/attachments/`
+  - Attachment paths passed to agent as absolute paths in execution environment
+  - Backfill also downloads attachments from historical messages
+
+## [0.18.3] - 2025-12-11
+
+### Changed
+
+- Complete rewrite of message handling architecture (#115)
+
+  - Now uses `AgentSession` from coding-agent for session management
+  - Brings auto-compaction, overflow handling, and proper prompt caching
+  - `log.jsonl` is the source of truth for all channel messages
+  - `context.jsonl` stores LLM context (messages sent to Claude, same format as coding-agent)
+  - Sync mechanism ensures context.jsonl stays in sync with log.jsonl at run start
+  - Session header written immediately on new session creation (not lazily)
+  - Tool results preserved in context.jsonl for multi-turn continuity
+
+- Backfill improvements
+
+  - Only backfills channels that already have a `log.jsonl` file
+  - Strips @mentions from backfilled messages (consistent with live messages)
+  - Uses largest timestamp in log for efficient incremental backfill
+  - Fetches DM channels in addition to public/private channels
+
+- Message handling improvements
+
+  - Channel chatter (messages without @mention) logged but doesn't trigger processing
+  - Messages sent while mom is busy are logged and synced on next run
+  - Pre-startup messages (replayed by Slack on reconnect) logged but not auto-processed
+  - Stop command executes immediately (not queued), can interrupt running tasks
+  - Channel @mentions no longer double-logged (was firing both app_mention and message events)
+
+- Usage summary now includes context window usage
+  - Shows current context tokens vs model's context window
+  - Example: `Context: 4.2k / 200k (2.1%)`
+
+### Fixed
+
+- Slack API errors (msg_too_long) no longer crash the process
+
+  - Added try/catch error handling to all Slack API calls in the message queue
+  - Main channel messages truncated at 35K with note to ask for elaboration
+  - Thread messages truncated at 20K
+  - replaceMessage also truncated at 35K
+
+- Private channel messages not being logged
+
+  - Added `message.groups` to required bot events in README
+  - Added `groups:history` and `groups:read` to required scopes in README
+
+- Stop command now updates "Stopping..." to "Stopped" instead of posting two messages
+
+### Added
+
+- Port truncation logic from coding-agent: bash and read tools now use consistent 2000 lines OR 50KB limits with actionable notices
+
+## [0.10.2] - 2025-11-27
+
+### Breaking Changes
+
+- Timestamps now use Slack format (seconds.microseconds) and messages are sorted by `ts` field
+  - **Migration required**: Run `npx tsx scripts/migrate-timestamps.ts ./data` to fix existing logs
+  - Without migration, message context will be incorrectly ordered
+
+### Added
+
+- Channel and user ID mappings in system prompt
+  - Fetches all channels bot is member of and all workspace users at startup
+  - Mom can now reference channels by name and mention users properly
+- Skills documentation in system prompt
+  - Explains custom CLI tools pattern with SKILL.md files
+  - Encourages mom to create reusable tools for recurring tasks
+- Debug output: writes `last_prompt.txt` to channel directory with full context
+- Bash working directory info in system prompt (/ for Docker, cwd for host)
+- Token-efficient log queries that filter out tool calls/results for summaries
+
+### Changed
+
+- Turn-based message context instead of raw line count (#68)
+  - Groups consecutive bot messages (tool calls/results) as single turn
+  - "50 turns" now means ~50 conversation exchanges, not 50 log lines
+  - Prevents tool-heavy runs from pushing out conversation context
+- Messages sorted by Slack timestamp before building context
+  - Fixes out-of-order issues from async attachment downloads
+  - Added monotonic counter for sub-millisecond ordering
+- Condensed system prompt from ~5k to ~2.7k chars
+  - More concise workspace layout (tree format)
+  - Clearer log query examples (conversation-only vs full details)
+  - Removed redundant guidelines section
+- User prompt simplified: removed duplicate "Current message" (already in history)
+- Tool status labels (`_→ label_`) no longer logged to jsonl
+- Thread messages and thinking no longer double-logged
+
+### Fixed
+
+- Duplicate message logging: removed redundant log from app_mention handler
+- Username obfuscation in thread messages to prevent unwanted pings
+  - Handles @username, bare username, and <@USERID> formats
+  - Escapes special regex characters in usernames
+
+## [0.10.1] - 2025-11-27
+
+### Changed
+
+- Reduced tool verbosity in main Slack messages (#65)
+  - During execution: show tool labels (with → prefix), thinking, and text
+  - After completion: replace main message with only final assistant response
+  - Full audit trail preserved in thread (tool details, thinking, text)
+  - Added promise queue to ensure message updates execute in correct order
+
+## [0.10.0] - 2025-11-27
+
+### Added
+
+- Working memory system with MEMORY.md files
+  - Global workspace memory (`workspace/MEMORY.md`) shared across all channels
+  - Channel-specific memory (`workspace/<channel>/MEMORY.md`) for per-channel context
+  - Automatic memory loading into system prompt on each request
+  - Mom can update memory files to remember project details, preferences, and context
+- ISO 8601 date field in log.jsonl for easy date-based grepping
+  - Format: `"date":"2025-11-26T10:44:00.123Z"`
+  - Enables queries like: `grep '"date":"2025-11-26' log.jsonl`
+- Centralized logging system (`src/log.ts`)
+  - Structured, colored console output (green for user messages, yellow for mom activity, dim for details)
+  - Consistent format: `[HH:MM:SS] [context] message`
+  - Type-safe logging functions for all event types
+- Usage tracking and cost reporting
+  - Tracks tokens (input, output, cache read, cache write) and costs per run
+  - Displays summary at end of each agent run in console and Slack thread
+  - Example: `💰 Usage: 12,543 in + 847 out (5,234 cache read, 127 cache write) = $0.0234`
+- Working indicator in Slack messages
+  - Channel messages show "..." while mom is processing
+  - Automatically removed when work completes
+- Improved stop command behavior
+  - Separate "Stopping..." message that updates to "Stopped" when abort completes
+  - Original working message continues to show tool results (including abort errors)
+  - Clean separation between status and results
+
+### Changed
+
+- Enhanced system prompt with clearer directory structure and path examples
+- Improved memory file path documentation to prevent confusion
+- Message history format now includes ISO 8601 date for better searchability
+- System prompt now includes log.jsonl format documentation with grep examples
+- System prompt now includes current date and time for date-aware operations
+- Added efficient log query patterns using jq to prevent context overflow
+- System prompt emphasizes limiting NUMBER of messages (10-50), not truncating message text
+- Log queries now show full message text and attachments for better context
+- Fixed jq patterns to handle null/empty attachments with `(.attachments // [])`
+- Recent messages in system prompt now formatted as TSV (43% token savings vs raw JSONL)
+- Enhanced security documentation with prompt injection risk warnings and mitigations
+- **Moved recent messages from system prompt to user message** for better prompt caching
+  - System prompt is now mostly static (only changes when memory files change)
+  - Enables Anthropic's prompt caching to work effectively
+  - Significantly reduces costs on subsequent requests
+- Switched from Claude Opus 4.5 to Claude Sonnet 4.5 (~40% cost reduction)
+- Tool result display now extracts actual text instead of showing JSON wrapper
+- Slack thread messages now show cleaner tool call formatting with duration and label
+- All console logging centralized and removed from scattered locations
+- Agent run now returns `{ stopReason }` instead of throwing exceptions
+  - Clean handling of "aborted", "error", "stop", "length", "toolUse" cases
+  - No more error-based control flow
+
+### Fixed
+
+- jq query patterns now properly handle messages without attachments (no more errors on empty arrays)
+
+## [0.9.4] - 2025-11-26
+
+### Added
+
+- Initial release of Mom Slack bot
+- Slack integration with @mentions and DMs
+- Docker sandbox mode for isolated execution
+- Bash tool with full shell access
+- Read, write, edit file tools
+- Attach tool for sharing files in Slack
+- Thread-based tool details (clean main messages, verbose details in threads)
+- Single accumulated message per agent run
+- Stop command (`@mom stop`) to abort running tasks
+- Persistent workspace per channel with scratchpad directory
+- Streaming console output for monitoring