Sisyphus
c199d3a8eb
* feat(tools): add session management tools for OpenCode sessions - Add session_list tool for listing sessions with filtering - Add session_read tool for reading session messages and history - Add session_search tool for full-text search across sessions - Add session_info tool for session metadata inspection - Add comprehensive tests for storage, utils, and tools - Update documentation in AGENTS.md Closes #132 * fix(session-manager): add Windows compatibility for storage paths - Create shared/data-path.ts utility for cross-platform data directory resolution - On Windows: uses %LOCALAPPDATA% (e.g., C:\Users\Username\AppData\Local) - On Unix: uses $XDG_DATA_HOME or ~/.local/share (XDG Base Directory spec) - Update session-manager/constants.ts to use getOpenCodeStorageDir() - Update hook-message-injector/constants.ts to use same utility - Remove dependency on xdg-basedir package in session-manager - Follows existing pattern from auto-update-checker for consistency --------- Co-authored-by: sisyphus-dev-ai <sisyphus-dev-ai@users.noreply.github.com>
97 lines
3.5 KiB
TypeScript
97 lines
3.5 KiB
TypeScript
import { join } from "node:path"
|
|
import { homedir } from "node:os"
|
|
import { getOpenCodeStorageDir } from "../../shared/data-path"
|
|
|
|
export const OPENCODE_STORAGE = getOpenCodeStorageDir()
|
|
export const MESSAGE_STORAGE = join(OPENCODE_STORAGE, "message")
|
|
export const PART_STORAGE = join(OPENCODE_STORAGE, "part")
|
|
export const TODO_DIR = join(homedir(), ".claude", "todos")
|
|
export const TRANSCRIPT_DIR = join(homedir(), ".claude", "transcripts")
|
|
export const SESSION_LIST_DESCRIPTION = `List all OpenCode sessions with optional filtering.
|
|
|
|
Returns a list of available session IDs with metadata including message count, date range, and agents used.
|
|
|
|
Arguments:
|
|
- limit (optional): Maximum number of sessions to return
|
|
- from_date (optional): Filter sessions from this date (ISO 8601 format)
|
|
- to_date (optional): Filter sessions until this date (ISO 8601 format)
|
|
|
|
Example output:
|
|
| Session ID | Messages | First | Last | Agents |
|
|
|------------|----------|-------|------|--------|
|
|
| ses_abc123 | 45 | 2025-12-20 | 2025-12-24 | build, oracle |
|
|
| ses_def456 | 12 | 2025-12-19 | 2025-12-19 | build |`
|
|
|
|
export const SESSION_READ_DESCRIPTION = `Read messages and history from an OpenCode session.
|
|
|
|
Returns a formatted view of session messages with role, timestamp, and content. Optionally includes todos and transcript data.
|
|
|
|
Arguments:
|
|
- session_id (required): Session ID to read
|
|
- include_todos (optional): Include todo list if available (default: false)
|
|
- include_transcript (optional): Include transcript log if available (default: false)
|
|
- limit (optional): Maximum number of messages to return (default: all)
|
|
|
|
Example output:
|
|
Session: ses_abc123
|
|
Messages: 45
|
|
Date Range: 2025-12-20 to 2025-12-24
|
|
|
|
[Message 1] user (2025-12-20 10:30:00)
|
|
Hello, can you help me with...
|
|
|
|
[Message 2] assistant (2025-12-20 10:30:15)
|
|
Of course! Let me help you with...`
|
|
|
|
export const SESSION_SEARCH_DESCRIPTION = `Search for content within OpenCode session messages.
|
|
|
|
Performs full-text search across session messages and returns matching excerpts with context.
|
|
|
|
Arguments:
|
|
- query (required): Search query string
|
|
- session_id (optional): Search within specific session only (default: all sessions)
|
|
- case_sensitive (optional): Case-sensitive search (default: false)
|
|
- limit (optional): Maximum number of results to return (default: 20)
|
|
|
|
Example output:
|
|
Found 3 matches across 2 sessions:
|
|
|
|
[ses_abc123] Message msg_001 (user)
|
|
...implement the **session manager** tool...
|
|
|
|
[ses_abc123] Message msg_005 (assistant)
|
|
...I'll create a **session manager** with full search...
|
|
|
|
[ses_def456] Message msg_012 (user)
|
|
...use the **session manager** to find...`
|
|
|
|
export const SESSION_INFO_DESCRIPTION = `Get metadata and statistics about an OpenCode session.
|
|
|
|
Returns detailed information about a session including message count, date range, agents used, and available data sources.
|
|
|
|
Arguments:
|
|
- session_id (required): Session ID to inspect
|
|
|
|
Example output:
|
|
Session ID: ses_abc123
|
|
Messages: 45
|
|
Date Range: 2025-12-20 10:30:00 to 2025-12-24 15:45:30
|
|
Duration: 4 days, 5 hours
|
|
Agents Used: build, oracle, librarian
|
|
Has Todos: Yes (12 items, 8 completed)
|
|
Has Transcript: Yes (234 entries)`
|
|
|
|
export const SESSION_DELETE_DESCRIPTION = `Delete an OpenCode session and all associated data.
|
|
|
|
Removes session messages, parts, todos, and transcript. This operation cannot be undone.
|
|
|
|
Arguments:
|
|
- session_id (required): Session ID to delete
|
|
- confirm (required): Must be true to confirm deletion
|
|
|
|
Example:
|
|
session_delete(session_id="ses_abc123", confirm=true)
|
|
Successfully deleted session ses_abc123`
|
|
|
|
export const TOOL_NAME_PREFIX = "session_"
|