# Shyne full agent handoff Shyne is a collaborative design workspace where people and AI edit the same durable artifacts. Canonical docs: https://shyne.ai/docs Agent guide: https://shyne.ai/docs/agent.md MCP: https://mcp.shyne.ai/mcp Transport: Streamable HTTP Authentication: OAuth REST schema: https://api.shyne.ai/openapi.json ## Product model A Task is a durable agent conversation in the workspace and may be filed in one Project. A Project is a cloud identity, access, collaboration, and context boundary that owns Files and Canvases. On desktop, a managed folder is only a sync-on-use working copy of its Files, never the Project identity. A Canvas is one realtime visual workspace. It can hold loose Frames, Groups, and Nodes, plus multiple independently addressable Sequences. A Sequence is an ordered or timed set of Frames. Presentation, document, social, email, and video are profiles and outputs rather than separate document types. ## Required orientation 1. Call `projects_list` and select an exact Project. 2. Call `canvases_list` and select an exact Canvas. 3. Read the MCP resource `shyne://guide/canvas-authoring`; it is the live authoring contract. 4. Use `tools/list` as the live source of tool names and parameter schemas. 5. Pass `projectId` and `canvasId` explicitly on Canvas-bound calls. Canvas omission is valid only for a Project with exactly one Canvas. 6. Call `canvases_read` before editing. ## Working rules Use `frames_apply` and `nodes_apply` for structured edits, `sequences_*` for ordered/timed membership, and `canvases_import` for HTML or SVG creation. Use `frames_replace_from_html` only for an explicitly destructive replacement. Inspect visual changes with `canvases_preview` before reporting completion. Use `media_search_stock`, `media_generate_*`, and Project files for media. Use `timeline_get` and `timeline_*` for timed Sequence clips. Create durable outputs with `exports_create`; poll asynchronous video jobs with `exports_get`. Read `shyne://capabilities` for optional capability packs. Public Shyne tool names use underscores, such as `sequences_get`. ## Bootstrap Before changing anything, call `projects_list` and `canvases_list`, select the exact Project and Canvas, read `shyne://guide/canvas-authoring`, and call `canvases_read`. Preserve unrelated work. Make structured edits, preview the result, and use `exports_create` for durable delivery.