seereel-agent-sessionlisted

# SeeReel Agent Session ## Boundary Boundary: REST session control only. This skill owns API mechanics for visible SeeReel state. It does not decide story, casting, production design, camera language, storyboard sequence, prompt quality, or final creative approval. Use the stage skills for those decisions, then use this skill to create, patch, inspect, poll, publish, and stitch their outputs. ## Base URL Default: ```text process.env.SEEREEL_AGENT_BASE_URL || process.env.CINEMA_AGENT_BASE_URL || "http://localhost:5173" ``` Check health with: ```text GET /api/state ``` If the service is unavailable, start the app with `npm run dev` or point `SEEREEL_AGENT_BASE_URL` at the running service. ## API Responsibilities Use REST APIs for: - session create/select/update - StoryPlan persistence - asset create/import/generate/update - storyboard and sketch import - shot create/patch/generate/poll - tailframe extraction and canvas-node writeback - storyboard publish to TOS - render status inspection - stitch and stitch polling - final download URL lookup Keep every operation auditable in web state. ## Common Operations ```text GET /api/state POST /api/sessions PATCH /api/sessions/:sessionId PATCH /api/sessions/:sessionId/script POST /api/assets PATCH /api/assets/:assetId POST /api/assets/:assetId/generate POST /api/sessions/:sessionId/storyboard PATCH /api/shots/:shotId POST /api/shots/:shotId/generate POST /api/shots/:shotId/poll POST /api/shots/:shotId/tailframe POST /api/