stack/docs/tess/USER-GUIDE.md

Tess User Guide

All HTTP interaction calls require authenticated session credentials and X-Correlation-Id. Use GET /api/interaction/{agentName}/sessions?provider=... to list only visible runtime sessions, then enroll with POST .../sessions/{sessionId}/enroll body {providerId,runtimeSessionId}. Attach uses {mode:"read"}; send uses {content,idempotencyKey}. Stop requires {approvalRef} and fails with 403 without the exact durable approval. Recovery only requeues interrupted durable work.

Memory is user-scoped: preferences support list/get/upsert/delete; insights support list/get/create/delete; search body is {query,limit?,maxDistance?}. Mos work is handed off with POST /api/coord/mos/handoff; observe and result use the returned handoff ID.