| name | session-logs |
| description | Search and analyze session logs and conversation history using OctoAgent Event Store and SQLite. Use when: user asks about prior conversations, session history, task execution logs, or event timeline. |
| version | 1.0.0 |
| author | OctoAgent |
| tags | ["session","logs","history","events"] |
| tools_required | ["task.inspect","runtime.inspect","sessions.list","session.status"] |
Session Logs
Search and analyze conversation history and task execution logs through OctoAgent's Event Store.
When to Use
- User asks about prior conversations or session history
- Debugging task execution flow
- Reviewing what happened in a specific session
- Finding historical context from past interactions
Data Sources
OctoAgent stores all session data in SQLite via the Event Store:
- Tasks: task_id, status, timestamps, requester info
- Events: append-only event log (tool calls, state transitions, LLM calls)
- Sessions: agent session metadata and conversation turns
Common Queries
List Recent Sessions
Use the sessions.list tool to see recent sessions:
sessions.list limit=10
Check Session Status
session.status
Inspect a Specific Task
task.inspect task_id=<task-id>
This returns:
- Task status and timestamps
- Recent events (tool calls, state changes)
- Execution session details
View Runtime State
runtime.inspect
Returns current runtime information including active tasks, worker states, and system health.
Event Types
The Event Store records these event types:
TASK_CREATED / TASK_COMPLETED / TASK_FAILED - Task lifecycleTOOL_CALL_STARTED / TOOL_CALL_COMPLETED / TOOL_CALL_FAILED - Tool executionSTATE_CHANGED - Task state transitionsLLM_CALL_STARTED / LLM_CALL_COMPLETED - Model callsAPPROVAL_REQUESTED / APPROVAL_GRANTED / APPROVAL_DENIED - Approval flow
Tips
- Events are append-only and never deleted
- Use
task.inspect for detailed per-task event timeline
- Session metadata includes loaded skills and tool selection state
- Cost and token usage data is embedded in LLM call events
