session-compact

1# Session Compact
2 
3Use AI DevKit's Jev-backed CLI to create a structured continuation artifact from a historical session. Prefer this command over a hand-written compact when it is available.
4 
5## When to Use
6 
7- Context is getting long and useful state needs to survive compaction.
8- Work is being handed to another agent or resumed after becoming stale.
9- A complex implementation or debugging session is closing.
10- Durable memory candidates or task-progress facts need to be identified after a long run.
11 
12## Workflow
13 
141. Find the session ID when it is not already known:
15   ```bash
16   npx ai-devkit@latest agent sessions --all
17   ```
182. Produce Markdown for a human handoff:
19   ```bash
20   npx ai-devkit@latest agent session compact --id <session-id>
21   ```
223. Use JSON for automation or structured inspection:
23   ```bash
24   npx ai-devkit@latest agent session compact --id <session-id> --format json
25   ```
264. Add `--type <provider>` when the same session ID is ambiguous across providers.
275. Review the artifact before using its resume prompt, memory candidates, or validation claims. Compaction preserves selected transcript evidence; it does not independently verify that evidence.
28 
29## Jev Availability
30 
31The command requires `TYPESAFE_API_KEY`. If it reports:
32 
33```text
34Jev is unavailable because TYPESAFE_API_KEY is not set.
35```
36…