code-yeongyu/oh-my-openagent / packages/shared-skills/skills/coding-agent-sessions
coding-agent-sessions
VerifiedFinds, reads, and reconstructs coding-agent sessions across Codex, Claude, OpenCode, OMO/Senpi, and other local agent logs. Use when asked to find or search past sessions, transcripts, or subagent runs, or to recover what an earlier session did.
scripts/tests/test_cli_contract.py
View on GitHub# /// script
# requires-python = ">=3.11"
# dependencies = ["pytest"]
# ///
# --- How to run ---
# uv run --with pytest pytest scripts/tests/test_cli_contract.py -v
# pyright: reportImplicitRelativeImport=false, reportMissingImports=false
from __future__ import annotations
import json
import os
import sqlite3
import subprocess
import sys
from pathlib import Path
import pytest
sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
from agent_sessions.jsonio import as_map, parse_json_text
from agent_sessions.types import Json, JsonMap
SKILL_ROOT = Path(__file__).resolve().parents[2]
def _map(value: Json) -> JsonMap:
assert isinstance(value, dict)
return value
def _rows(payload: JsonMap, key: str) -> list[JsonMap]:
value = payload[key]
assert isinstance(value, list)
return [_map(item) for item in value]
def _payload(text_value: str) -> JsonMap:
value = as_map(parse_json_text(text_value))
assert value is not None
return value
def _run(root: Path, *args: str) -> JsonMap:
env = os.environ.copy()
env["APPDATA"] = str(root / "appdata")
env["CODEX_HOME"] = str(root)
env["HOME"] = str(root / "home")
env["OPENCODE_HOME"] = str(root / "opencode-home")
proc = subprocess.run(
[sys.executable, "scripts/find-agent-sessions.py", *args, "--root", str(root)],
cwd=SKILL_ROOT,
env=env,
check=True,
capture_output=True,
text=True,
)
return _payload(proc.stdout)
def _write_jsonl(path: Path, rows: list[JsonMap]) -> None:
path.parent.mkdir(parents=True, exist_ok=True)
_ = path.write_text("\n".join(json.dumps(row) for row in rows) + "\n")
def _fixture_root(tmp_path: Path) -> Path:
root = tmp_path / "agents"
root.mkdir(parents=True)
with sqlite3.connect(root / "state_test.sqlite") as conn:
schema = (
"CREATE TABLE threads (id TEXT PRIMARY KEY, rollout_path TEXT NOT NULL, created_at INTEGER NOT NULL, "
+ "updated_at INTEGER NOT NULL, source TEXT NOT NULL, model_provider TEXT NOT NULL, cwd TEXT NOT NULL, "
+ "model TEXT, first_user_message TEXT NOT NULL DEFAULT '', tokens_used INTEGER NOT NULL DEFAULT 0, "
+ "agent_nickname TEXT, agent_role TEXT)"
)
row = (
"INSERT INTO threads VALUES ('codex-alpha', '/tmp/codex-alpha.jsonl', 100, 200, 'cli', 'openai', "
+ "'/tmp/work', 'gpt-5', 'alpha rollout fix', 9, NULL, NULL)"
)
_ = conn.execute(schema)
_ = conn.execute(row)
_write_jsonl(
root / "transcripts" / "claude-beta.jsonl",
[
{"sessionId": "claude-beta", "type": "user", "timestamp": "2026-06-10T00:00:00Z", "cwd": "/tmp/work", "content": "unrelated"},
{"sessionId": "claude-beta", "type": "user", "timestamp": "2026-06-10T00:00:03Z", "cwd": "/tmp/work", "content": "alpha review notes"},
],
)
return root
def test_find_searches_all_platforms_and_explains_matches(tmp_path: Path) -> None:
payload = _run(_fixture_root(tmp_path), "find", "alpha", "--limit", "10")
results = _rows(payload, "results")
platforms: set[str] = set()
for item in results:
platform = item["platform"]
assert isinstance(platform, str)
platforms.add(platform)
assert platforms == {"codex", "claude"}
for item in results:
reasons = _rows(item, "match_reasons")
assert reasons, f"missing match reasons for {item}"
assert reasons[0]["query"] == "alpha"
assert reasons[0]["platform"] == item["platform"]
assert isinstance(reasons[0]["snippet"], str) and "alpha" in reasons[0]["snippet"].lower()
assert item["detail_hint"] == f"python3 -B scripts/find-agent-sessions.py read {item['id']} --platform {item['platform']}"
def test_platform_filter_narrows_find_results(tmp_path: Path) -> None:
payload = _run(_fixture_root(tmp_path), "find", "alpha", "--platform", "codex")
results = _rows(payload, "results")
assert len(results) == 1
assert results[0]["platform"] == "codex"
def test_find_matches_a_user_event_between_the_first_and_last_prompts(tmp_path: Path) -> None:
# given: a transcript whose query text appears only in a middle user event
root = _fixture_root(tmp_path)
_write_jsonl(
root / "transcripts" / "claude-gamma.jsonl",
[
{"sessionId": "claude-gamma", "type": "user", "timestamp": "2026-06-11T00:00:00Z", "cwd": "/tmp/work", "content": "alpha-edge"},
{"sessionId": "claude-gamma", "type": "user", "timestamp": "2026-06-11T00:00:01Z", "cwd": "/tmp/work", "content": "needle-middle-only"},
{"sessionId": "claude-gamma", "type": "user", "timestamp": "2026-06-11T00:00:02Z", "cwd": "/tmp/work", "content": "omega-edge"},
],
)
# when
payload = _run(root, "find", "needle-middle-only", "--platform", "claude")
# then
results = _rows(payload, "results")
assert [item["id"] for item in results] == ["claude-gamma"]
reasons = _rows(results[0], "match_reasons")
assert reasons[0]["field"] == "user_message"
assert reasons[0]["snippet"] == "needle-middle-only"
EDGE_AND_MIDDLE_PROMPTS = ("alpha-edge", "needle-middle-only", "omega-edge")
OWN_FORMAT_TRANSCRIPTS: dict[str, tuple[str, list[JsonMap]]] = {
"droid": ("sessions/proj/droid-1.jsonl", [{"type": "message", "message": {"role": "user", "content": prompt}} for prompt in EDGE_AND_MIDDLE_PROMPTS]),
"kimi": ("sessions/proj/kimi-1/wire.jsonl", [{"type": "TurnBegin", "payload": {"user_input": prompt}} for prompt in EDGE_AND_MIDDLE_PROMPTS]),
"aside": ("sessions/x_aside-1/messages.jsonl", [{"role": "user", "content": [{"type": "text", "text": prompt}]} for prompt in EDGE_AND_MIDDLE_PROMPTS]),
}
@pytest.mark.parametrize("platform", sorted(OWN_FORMAT_TRANSCRIPTS))
def test_find_matches_a_middle_prompt_in_platform_specific_transcripts(tmp_path: Path, platform: str) -> None:
# given: a transcript in the platform's own format whose query text appears only in a middle prompt
relative, rows = OWN_FORMAT_TRANSCRIPTS[platform]
_write_jsonl(tmp_path / relative, rows)
# when
payload = _run(tmp_path, "find", "needle-middle-only", "--platform", platform)
# then
results = _rows(payload, "results")
assert [item["id"] for item in results] == [f"{platform}-1"]
assert _rows(results[0], "match_reasons")[0]["field"] == "user_message"
def test_entrypoint_rejects_python_older_than_3_11(tmp_path: Path) -> None:
# given: an interpreter that reports Python 3.9
script = SKILL_ROOT / "scripts" / "find-agent-sessions.py"
launcher = (
"import runpy, sys\n"
+ "sys.version_info = (3, 9, 6, 'final', 0)\n"
+ f"runpy.run_path({str(script)!r}, run_name='__main__')\n"
)
# when
proc = subprocess.run([sys.executable, "-c", launcher, "list"], cwd=tmp_path, capture_output=True, text=True, check=False)
# then
assert proc.returncode == 2
assert "3.11" in proc.stderr
assert proc.stdout == ""
def test_read_summarizes_first_and_last_user_prompts(tmp_path: Path) -> None:
payload = _run(_fixture_root(tmp_path), "read", "claude-beta", "--platform", "claude")
result = _rows(payload, "results")[0]
prompts = _map(result["prompts"])
session = _map(result["session"])
assert prompts["first_user_message"] == "unrelated"
assert prompts["last_user_message"] == "alpha review notes"
assert session["last_user_message"] == "alpha review notes"
assert result["detail_hint"] == "python3 -B scripts/find-agent-sessions.py read claude-beta --platform claude"
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |