Skip to content

v0.52.0

Latest

Choose a tag to compare

@apollo-watcher-release apollo-watcher-release released this 19 Nov 12:26
Immutable release. Only release title and notes can be modified.

This release tightens session ownership in the API, makes the Watcher client's Codex coverage and decision uploads more reliable, and lets organization viewers filter sessions by person.

Breaking changes

  • Changed: API: Recording a session no longer changes who owns it. Ingest-only uploads no longer join personal sessions by native ID, uploads and parent–child agent links no longer claim existing sessions, and writing a link requires write access to both sessions; ingest requests may also return 503 with Retry-After during a transient ownership change and should be retried. Existing history is not migrated. Affected integrations must use authorised attribution or keep recordings separate; self-host deployments must roll out the API and worker together. See the "fixed session ownership" release note in the customer docs for upgrade and recovery guidance.
  • Changed: API: GET /v1/users and the Python SDK now return email as nullable; other users' emails are included only for callers with users:read:any, so typed consumers should add a null check and fall back to the user ID when no name or email is visible.
  • Changed: Live: When grading cannot decide a tool call, the client now records which part failed (the Watcher app on this machine, the server, the grading model provider, or a paused circuit breaker) instead of the single summary "Watcher grading service unavailable"; filters or scripts matching the old text will not match decisions from this client onward, and a local-app failure now keeps its summary even when the grading-failure policy is allow or deny.
  • Changed: Live: The Bash rule that protects Watcher settings and agent hook files now escalates a write only when it pairs with a protected path in the same command, and treats cp as a write only when the protected path is its destination; commands that read a protected file in a later command or copy one out, such as cp ~/.apollo_monitor/db/watcher.db /tmp/x.db, no longer prompt for approval. Very long single-line commands (roughly 48 KB of write words) may now time out and be sent for approval.
  • Changed: Self-host deployment: This release's database migration removes the organization S3 ingestion settings that the previous release stopped using. Upgrade to the previous release before applying this one, because older servers still read those settings, and a rollback after the migration does not restore their values.

Live

  • Added: watcher doctor and Codex setup now warn when Codex has not trusted Watcher's hooks on its "Hooks need review" screen, or has turned them off in /hooks, naming the hooks Codex will not run and what to do; without trust Watcher records nothing from Codex sessions, and in enforce mode Codex prompts for every network or out-of-workspace command. Doctor exits non-zero while this warning is present.
  • Fixed: The client no longer abandons a tool-call decision after about two hours when its tool call has not yet reached the server; it holds the decision for up to 7 days and retries once the call arrives, and watcher doctor now counts held decisions and lists give-ups by reason.
  • Fixed: Claude Code subagents spawned by a forking Skill (such as code-review) are now linked to the agent that ran the Skill and appear in its subagent list instead of as top-level sessions; children recorded before this release stay unlinked unless their parent session is resumed.

Analyzer

  • Added: Organization viewers can filter Sessions and Tool calls by person; labels fall back to the user ID when a name or email is not visible.

Other

  • Changed: Documentation and the Data Retention tab now explain that unlinked grades (grades for tool calls whose decision never reached Watcher) are deleted by the session-content retention period and are kept indefinitely until one is set; self-host operators should set a period or watch database storage.

Watcher documentation.