Skip to content

feat(session): add Session Audit Timeline — implement the Auditable p…#1611

Open
shaikh-amer wants to merge 1 commit intodifferent-ai:devfrom
shaikh-amer:feat/session-audit-timeline
Open

feat(session): add Session Audit Timeline — implement the Auditable p…#1611
shaikh-amer wants to merge 1 commit intodifferent-ai:devfrom
shaikh-amer:feat/session-audit-timeline

Conversation

@shaikh-amer
Copy link
Copy Markdown

Summary

Implements the "Auditable: show what happened, when, and why" pillar
from the README and PRINCIPLES.md. Adds a Session Audit Timeline panel
that shows every agent action (tool calls, file writes, shell commands)
in real time with status badges, timestamps, and a JSON export button.

Why

The Auditable pillar was listed as a core product value but had no UI
implementation. PRINCIPLES.md explicitly states "Exportable audit logs"
as a principle. This PR delivers it.

Issue

Closes #1573

Scope

  • New: session-audit-store.ts — SSE subscriber capturing tool/pty/error events
  • New: session-audit-timeline.tsx — React panel with timeline UI and export
  • New: session-audit-export.ts — pure JSON download utility
  • Edit: session-surface.tsx — adds Show/Hide Audit toggle and panel render

Out of scope

  • Desktop native save dialog for export (follow-up PR)
  • Historical session audit (current session only)

Testing

Ran

  • pnpm --filter @openwork/app typecheck

Result

  • pass: yes, 0 errors

CI status

  • pass: typecheck passes
  • code-related failures: none
  • external/env/auth blockers: Rust compile required full Tauri deps install

Manual verification

  1. Open a session, click 📋 Show Audit in the toolbar
  2. Send prompt: create a file called test.py with hello world and run it
  3. Watch audit panel — entries appear in real time as agent works
  4. Verify: write tool shows completed, bash tool shows completed
  5. Click Export Session Log — JSON file downloads with full session data

Evidence

Tested on Tauri desktop app (OpenWork-Dev). Agent created audit_demo.py
and ran it successfully. Audit panel showed 2 entries:

  • write — completed ✓ — file content visible in input summary
  • bash — completed ✓ — python3 command visible in input summary

Toggle works: Show Audit / Hide Audit switches the panel on/off cleanly.
Store disposes on unmount (panel close) with no memory leaks.

No new npm dependencies. No server changes. 4 files total.

Risk

Low. Changes are isolated to the session surface domain. New files only
plus a minimal edit to session-surface.tsx adding one useState and one
conditional render. Existing session behavior is completely unchanged.

Rollback

Remove the 3 new files and revert the session-surface.tsx change.
Screenshot from 2026-04-30 01-52-49
Screenshot from 2026-04-30 01-52-58

@vercel
Copy link
Copy Markdown
Contributor

vercel Bot commented Apr 29, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
openwork-landing Ready Ready Preview, Comment, Open in v0 Apr 29, 2026 8:37pm

@vercel
Copy link
Copy Markdown
Contributor

vercel Bot commented Apr 29, 2026

Someone is attempting to deploy a commit to the Different AI Team on Vercel.

A member of the Team first needs to authorize it.

@github-actions
Copy link
Copy Markdown
Contributor

The following comment was made by an LLM, it may be inaccurate:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feature]: [Feature]: Session Audit Timeline — implement the "Auditable" pillar with a real-time action log UI

1 participant