143 lines
11 KiB
Markdown
143 lines
11 KiB
Markdown
# Changelog
|
||
|
||
## 1.5.0 — 2025-12-05
|
||
|
||
### Breaking
|
||
- Dropped all non-Pi agents (Claude, Codex, Gemini, Opencode); `inbound.reply.agent.kind` now only accepts `"pi"` and related CLI helpers have been removed.
|
||
- Removed Twilio support and all related commands/options (webhook/up/provider flags/wait-poll); CLAWDIS is Baileys Web-only.
|
||
|
||
### Changes
|
||
- Default agent handling now favors Pi RPC while falling back to the plain command runner for non-Pi invocations, keeping heartbeat/session plumbing intact.
|
||
- Documentation updated to reflect Pi-only support and to mark legacy Claude paths as historical.
|
||
- Status command reports web session health + session recipients; config paths are locked to `~/.clawdis` with session metadata stored under `~/.clawdis/sessions/`.
|
||
- Simplified send/agent/relay/heartbeat to web-only delivery; removed Twilio mocks/tests and dead code.
|
||
- Tau RPC timeout is now inactivity-based (5m without events) and error messages show seconds only.
|
||
- Pi/Tau sessions now write to `~/.clawdis/sessions/` by default (legacy `~/.tau/agent/sessions/clawdis` files are copied over when present).
|
||
- Directive triggers (`/think`, `/verbose`, `/stop` et al.) now reply immediately using normalized bodies (timestamps/group prefixes stripped) without waiting for the agent.
|
||
- Directive/system acks carry a `⚙️` prefix and verbose parsing rejects typoed `/ver*` strings so unrelated text doesn’t flip verbosity.
|
||
- Batched history blocks no longer trip directive parsing; `/think` in prior messages won't emit stray acknowledgements.
|
||
- RPC fallbacks no longer echo the user's prompt (e.g., pasting a link) when the agent returns no assistant text.
|
||
- Heartbeat prompts with `/think` no longer send directive acks; heartbeat replies stay silent on settings.
|
||
- `clawdis sessions` now renders a colored table (a la oracle) with context usage shown in k tokens and percent of the context window.
|
||
|
||
## 1.4.1 — 2025-12-04
|
||
|
||
### Changes
|
||
- Added `warelay agent` CLI command to talk directly to the configured agent using existing session handling (no WhatsApp send), with JSON output and delivery option.
|
||
- `/new` reset trigger now works even when inbound messages have timestamp prefixes (e.g., `[Dec 4 17:35]`).
|
||
- WhatsApp mention parsing accepts nullable arrays and flattens safely to avoid missed mentions.
|
||
|
||
## 1.4.0 — 2025-12-03
|
||
|
||
### Highlights
|
||
- **Thinking directives & state:** `/t|/think|/thinking <level>` (aliases off|minimal|low|medium|high|max/highest). Inline applies to that message; directive-only message pins the level for the session; `/think:off` clears. Resolution: inline > session override > `inbound.reply.thinkingDefault` > off. Pi/Tau get `--thinking <level>` (except off); other agents append cue words (`think` → `think hard` → `think harder` → `ultrathink`). Heartbeat probe uses `HEARTBEAT /think:high`.
|
||
- **Group chats (web provider):** Warelay now fully supports WhatsApp groups: mention-gated triggers (including image-only @ mentions), recent group history injection, per-group sessions, sender attribution, and a first-turn primer with group subject/member roster; heartbeats are skipped for groups.
|
||
- **Group session primer:** The first turn of a group session now tells the agent it is in a WhatsApp group and lists known members/subject so it can address the right speaker.
|
||
- **Media failures are surfaced:** When a web auto-reply media fetch/send fails (e.g., HTTP 404), we now append a warning to the fallback text so you know the attachment was skipped.
|
||
- **Verbose directives + session hints:** `/v|/verbose on|full|off` mirrors thinking: inline > session > config default. Directive-only replies with an acknowledgement; invalid levels return a hint. When enabled, tool results from JSON-emitting agents (Pi/Tau, etc.) are forwarded as metadata-only `[🛠️ <tool-name> <arg>]` messages (now streamed as they happen), and new sessions surface a `🧭 New session: <id>` hint.
|
||
- **Verbose tool coalescing:** successive tool results of the same tool within ~1s are batched into one `[🛠️ tool] arg1, arg2` message to reduce WhatsApp noise.
|
||
- **Directive confirmations:** Directive-only messages now reply with an acknowledgement (`Thinking level set to high.` / `Thinking disabled.`) and reject unknown levels with a helpful hint (state is unchanged).
|
||
- **Pi/Tau stability:** RPC replies buffered until the assistant turn finishes; parsers return consistent `texts[]`; web auto-replies keep a warm Tau RPC process to avoid cold starts.
|
||
- **Claude prompt flow:** One-time `sessionIntro` with per-message `/think:high` bodyPrefix; system prompt always sent on first turn even with `sendSystemOnce`.
|
||
- **Heartbeat UX:** Backpressure skips reply heartbeats while other commands run; skips don’t refresh session `updatedAt`; web heartbeats normalize array payloads and optional `heartbeatCommand`.
|
||
- **Control via WhatsApp:** Send `/restart` to restart the launchd service (`com.steipete.clawdis`; legacy `com.steipete.warelay`) from your allowed numbers.
|
||
- **Tau completion signal:** RPC now resolves on Tau’s `agent_end` (or process exit) so late assistant messages aren’t truncated; 5-minute hard cap only as a failsafe.
|
||
|
||
### Reliability & UX
|
||
- Outbound chunking prefers newlines/word boundaries and enforces caps (~4000 chars for web/WhatsApp).
|
||
- Web auto-replies fall back to caption-only if media send fails; hosted media MIME-sniffed and cleaned up immediately.
|
||
- IPC relay send shows typing indicator; batched inbound messages keep timestamps; watchdog restarts WhatsApp after long inactivity.
|
||
- Early `allowFrom` filtering prevents decryption errors; same-phone mode supported with echo suppression.
|
||
- All console output is now mirrored into pino logs (still printed to stdout/stderr), so verbose runs keep full traces.
|
||
- `--verbose` now forces log level `trace` (was `debug`) to capture every event.
|
||
- Verbose tool messages now include emoji + args + a short result preview for bash/read/edit/write/attach (derived from RPC tool start/end events).
|
||
|
||
### Security / Hardening
|
||
- IPC socket hardened (0700 dir / 0600 socket, no symlinks/foreign owners); `warelay logout` also prunes session store.
|
||
- Media server blocks symlinks and enforces path containment; logging rotates daily and prunes >24h.
|
||
|
||
### Bug Fixes
|
||
- Web group chats now bypass the second `allowFrom` check (we still enforce it on the group participant at inbox ingest), so mentioned group messages reply even when the group JID isn’t in your allowlist.
|
||
- `logVerbose` also writes to the configured Pino logger at debug level (without breaking stdout).
|
||
- Group auto-replies now append the triggering sender (`[from: Name (+E164)]`) to the batch body so agents can address the right person in group chats.
|
||
- Media-only pings now pick up mentions inside captions (image/video/etc.), so @-mentions on media-only messages trigger replies.
|
||
- MIME sniffing and redirect handling for downloads/hosted media.
|
||
- Response prefix applied to heartbeat alerts; heartbeat array payloads handled for both providers.
|
||
- Tau RPC typing exposes `signal`/`killed`; NDJSON parsers normalized across agents.
|
||
- Tau (pi) session resumes now append `--continue`, so existing history/think level are reloaded instead of starting empty.
|
||
|
||
### Testing
|
||
- Fixtures isolate session stores; added coverage for thinking directives, stateful levels, heartbeat backpressure, and agent parsing.
|
||
|
||
## 1.3.0 — 2025-12-02
|
||
|
||
### Highlights
|
||
- **Pluggable agents (Claude, Pi, Codex, Opencode):** `inbound.reply.agent` selects CLI/parser; per-agent argv builders and NDJSON parsers enable swapping without template changes.
|
||
- **Safety stop words:** `stop|esc|abort|wait|exit` immediately reply “Agent was aborted.” and mark the session so the next prompt is prefixed with an abort reminder.
|
||
- **Agent session reliability:** Only Claude returns a stable `session_id`; others may reset between runs.
|
||
|
||
### Bug Fixes
|
||
- Empty `result` fields no longer leak raw JSON to users.
|
||
- Heartbeat alerts now honor `responsePrefix`.
|
||
- Command failures return user-friendly messages.
|
||
- Test session isolation to avoid touching real `sessions.json`.
|
||
- IPC reuse for `warelay send/heartbeat` prevents Signal/WhatsApp session corruption.
|
||
- Web send respects media kind (image/audio/video/document) with correct limits.
|
||
|
||
### Changes
|
||
- IPC relay socket at `~/.warelay/relay.sock` with automatic CLI fallback.
|
||
- Batched inbound messages with timestamps; typing indicator after IPC sends.
|
||
- Watchdog restarts WhatsApp after long inactivity; heartbeat logging includes minutes since last message.
|
||
- Early `allowFrom` filtering before decryption.
|
||
- Same-phone mode with echo detection and optional `inbound.samePhoneMarker`.
|
||
|
||
## 1.2.2 — 2025-11-28
|
||
|
||
### Changes
|
||
- Manual heartbeat sends: `warelay heartbeat --message/--body` (web provider only); `--dry-run` previews payloads.
|
||
|
||
## 1.2.1 — 2025-11-28
|
||
|
||
### Changes
|
||
- Media MIME-first handling; hosted media extensions derived from detected MIME with tests.
|
||
|
||
### Planned / in progress (from prior notes)
|
||
- Heartbeat targeting quality: clearer recipient resolution and verbose logs.
|
||
- Heartbeat delivery preview (Claude path) dry-run.
|
||
- Simulated inbound hook for local testing.
|
||
|
||
## 1.2.0 — 2025-11-27
|
||
|
||
### Changes
|
||
- Heartbeat interval default 10m for command mode; prompt `HEARTBEAT /think:high`; skips don’t refresh session; session `heartbeatIdleMinutes` support.
|
||
- Heartbeat tooling: `--session-id`, `--heartbeat-now`, relay helpers `relay:heartbeat` and `relay:heartbeat:tmux`.
|
||
- Prompt structure: `sessionIntro` plus per-message `/think:high`; session idle up to 7 days.
|
||
- Thinking directives: `/think:<level>`; Pi uses `--thinking`; others append cue; `/think:off` no-op.
|
||
- Robustness: Baileys/WebSocket guards; global unhandled error handlers; WhatsApp LID mapping; hosted media MIME-sniffing and cleanup.
|
||
- Docs: README Clawd setup; `docs/claude-config.md` for live config.
|
||
|
||
## 1.1.0 — 2025-11-26
|
||
|
||
### Changes
|
||
- Web auto-replies resize/recompress media and honor `inbound.reply.mediaMaxMb`.
|
||
- Detect media kind, enforce provider caps (images ≤6MB, audio/video ≤16MB, docs ≤100MB).
|
||
- `session.sendSystemOnce` and optional `sessionIntro`.
|
||
- Typing indicator refresh during commands; configurable via `inbound.reply.typingIntervalSeconds`.
|
||
- Optional audio transcription via external CLI.
|
||
- Command replies return structured payload/meta; respect `mediaMaxMb`; log Claude metadata; include `cwd` in timeout messages.
|
||
- Web provider refactor; logout command; web-only relay start helper.
|
||
- Structured reconnect/heartbeat logging; bounded backoff with CLI/config knobs; troubleshooting guide.
|
||
- Relay help prints effective heartbeat/backoff when in web mode.
|
||
|
||
## 1.0.4 — 2025-11-25
|
||
|
||
### Changes
|
||
- Timeout fallbacks send partial stdout (≤800 chars) to the user instead of silence; tests added.
|
||
- Web relay auto-reconnects after Baileys/WebSocket drops; close propagation tests.
|
||
|
||
## 0.1.3 — 2025-11-25
|
||
|
||
### Changes
|
||
- Auto-replies send a WhatsApp fallback message on command/Claude timeout with truncated stdout.
|
||
- Added tests for timeout fallback and partial-output truncation.
|