Cursor session acquisition

Prompt-first procedure: Describe the outcome you want in your agent conversation. The agent should select and load the appropriate AIWG assets, explain material changes, request any needed approval, and report verification evidence. Exact commands and flags appear only in the CLI reference.

AIWG supports four explicit Cursor surfaces under canonical provider `cursor`:

Surface	Locator class	Fidelity
Agent CLI `the output-format option stream-json` capture	`cursor-cli-stream-json`	Structured messages, tool calls/results, cwd, model, permission mode, session and request IDs
Cloud Agents API v1 event capture	`cursor-cloud-events-jsonl`	Structured agent/run status, SSE event IDs, reconnect provenance, cancellation, archive, unarchive, and deletion
Workspace `agent-transcripts` JSONL	`cursor-agent-transcript-jsonl`	Structured user/assistant turns and terminal turn evidence grouped by native session directory
Editor Export Chat Markdown	`cursor-editor-markdown`	Message text and roles only; explicitly lossy

Import an explicitly selected file:

Use AIWG to complete this documented outcome: Import an explicitly selected file
Have it inspect the current state, explain the plan, ask before material
changes, and report the result with verification evidence.

Workspace discovery can enumerate JSONL only beneath an explicitly authorized `agent-transcripts` root. It does not scan other Cursor directories and does not read the editor's undocumented SQLite history database. Cursor documents that history as local SQLite, but directs users to export chats as Markdown for preservation; AIWG therefore keeps SQLite unsupported rather than silently depending on a private schema.

Version and consistency policy

• Adapter and normalized source schema tested: `1.0.0`.
• CLI, Cloud, and agent-transcript JSONL accept additive unknown fields and retain them as source metadata.
• An explicitly declared unknown major schema fails closed before normalized state is written.
• CLI streams remain provisional until a successful terminal `result` event.
• Cloud streams remain provisional until a terminal run, archive, or delete event.
• Agent transcripts remain provisional until a successful `turn_ended` record.
• Markdown is a completed manual snapshot, but never supplies timestamps, model,

tools, native lifecycle, or native session IDs that the export does not contain.

Cursor documents that stream JSON is NDJSON, that assistant deltas must be concatenated, that tool call IDs correlate start/completion, and that fields may be added compatibly. Cloud Agents v1 documents SSE event IDs and `Last-Event-ID` reconnection, run-scoped cancellation, and distinct archive/unarchive/permanent-delete operations. AIWG records those states; importing or deleting AIWG's copy never invokes provider lifecycle endpoints.

Evidence

Verified 2026-07-27 against:

• Cursor CLI output format
• Cursor chat history and Markdown preservation
• Cursor SDK and Cloud Agents v1 lifecycle announcement
• Cursor data use and privacy controls

All fixtures are synthetic. They cover complete and provisional streams, malformed input, unknown-major drift, agent-transcript discovery, unknown-field preservation, redaction, reconnect/cancel, and the distinction between archive, restore, and irreversible provider deletion.