Part 2: Agent Session Logs (Store terminal output

Tinker

Home Epics Part 2: Agent Session Logs (Store terminal output persistently)Edit

Part 2: Agent Session Logs (Store terminal output persistently)

Cancel

Title *

Project *

Description

## Part 2: Agent Session Logs

**Part of Agent Visibility System Epic (#92)**

---

### Scope of Work

**1. Create Database Models**

**AgentSession Model:**
```ruby
# app/models/agent_session.rb
class AgentSession < ApplicationRecord
  belongs_to :agent
  has_many :terminal_logs, dependent: :destroy
  
  def self.current_for_agent(agent)
    where(agent: agent, ended_at: nil).last
  end
  
  def duration
    return 0 unless ended_at
    (ended_at - started_at).to_i
  end
end
```

**AgentTerminalLog Model:**
```ruby
# app/models/agent_terminal_log.rb
class AgentTerminalLog < ApplicationRecord
  belongs_to :agent_session
  
  scope :recent, -> { order(created_at: :desc) }
end
```

**2. Create Migration**
```ruby
# db/migrate/*_create_agent_sessions.rb
create_table :agent_sessions do |t|
  t.references :agent, null: false
  t.datetime :started_at, null: false
  t.datetime :ended_at
  t.string :log_file_path
  
  t.timestamps
end

add_index :agent_sessions, :agent_id
add_index :agent_sessions, :started_at

# db/migrate/*_create_agent_terminal_logs.rb
create_table :agent_terminal_logs do |t|
  t.references :agent_session, null: false
  t.text :output_line, null: false
  t.datetime :logged_at, null: false
  
  t.timestamps
end

add_index :agent_terminal_logs, :agent_session_id
add_index :agent_terminal_logs, :logged_at
```

**3. Log File Management**
- Store terminal logs in `log/agent_sessions/` directory
- File naming: `agent_session_#{id}.log`
- Implement log rotation (keep 7 days, auto-purge)
- Add cleanup job/rake task

**4. MCP Tool for Querying Logs**
Add MCP tool `list_agent_logs` with filters:
- agent_id
- date range
- limit (max 1000 lines)

---

### Deliverables

- AgentSession and AgentTerminalLog models
- Database migrations
- Log file storage system
- MCP tool to query historical logs

---

### Implementation Notes

- Logs can be large - use pagination
- Consider compression for old logs
- Add background job for cleanup