canvasight-imagegen

name	canvasight-imagegen
description	Generate new raster images with Codex imagegen and add every final result to the active Canvasight Page as a managed Asset Node. Use when the user invokes @Canvasight or otherwise asks to generate, create, draw, or render a new image directly into Canvasight. Do not use for editing an existing Canvasight Asset in place.

Canvasight Image Generation

Generate with the system $imagegen Skill, then import the accepted bitmap outputs through Canvasight's atomic generated-image tool. Never hand-edit .scatter, pass an unmanaged path to write_canvasight_graph, or substitute browser automation.

Workflow

1. Read the active task's exact CODEX_THREAD_ID.
2. Reuse a Canvasight native widget only when this task already has verified fullscreen ready evidence. Otherwise follow canvasight-open: call open_canvasight with that threadId, preserve its sessionId and openAttemptId, then call await_canvasight_widget_ready. Stop before generation unless the result is verified status: "ready" with React, project hydration, rendered canvas, and visible non-zero canvas evidence.
3. Call get_canvasight_graph_context with the same threadId. Preserve its projectPath, contextId, documentRevision, and active Page identity before starting image generation. Later Page switches must not retarget the import.
4. Invoke the system $imagegen Skill. Use its built-in tool path by default, one call per requested final image or variant. Follow its transparency, inspection, retry, and CLI-consent rules exactly.
5. Keep only outputs that pass imagegen inspection. Call add_canvasight_generated_images with:
   • the exact threadId and captured projectPath;
   • the captured contextId and documentRevision as expectedRevision;
   • one stable unique clientMutationId for this exact batch, reused only for retries;
   • one { "path", "title"? } entry per final image, in the requested display order.
6. Treat written, merged, and conflict-copy as successful imports. Report the target Page, created node count, managed project-relative paths, final prompt set, and whether imagegen used the built-in or user-approved CLI path.

Product-design option flow

When the request is to explore a product or UI design before frontend implementation:

1. Resolve the target surface, intended user, outcome, viewport, and hard constraints before generation.
2. Unless the user specifies another count, generate exactly three independent UI images. Each image is one distinct direction with a meaningfully different hierarchy, layout, or interaction model; never combine multiple directions into one image.
3. Import all accepted options as separate Asset Nodes in their visible result order, then stop so the user can connect the preferred image into the ordinary canvas flow. Do not choose a direction or start implementation on the user's behalf.
4. Run continues to start only from executable Task or Group surfaces. For this option flow, run the ordinary Task flow: connected image Assets travel with that Task exactly like node attachments did, while generated images outside its reachable flow are unrelated. An Asset never runs independently, and no separate selection marker or persisted role is needed.
5. If the project exposes a matching product-design or image-to-code Skill, it may be named visibly in the downstream Task body. Do not persist a hidden Skill assignment or assume that an unavailable external Skill is installed.

Boundaries

• This Skill creates new PNG, JPEG, or WebP Asset Nodes only. Do not use it to mutate or replace an existing Canvasight Asset.
• Import at most 16 final images per tool call. For a larger explicit request, use successive batches without dropping results.
• Do not generate anything when native Canvasight opening or ready verification fails; the requested result could not be delivered to the canvas.
• If imagegen fails, do not create a placeholder node. If import fails, keep the generated source and report the actionable Canvasight error.
• On context_expired or context_revision_mismatch, do not guess a different Page. Explain that the captured Page binding expired and ask the user to repeat the image request.
• Never expose daemon URLs, tokens, or managed absolute paths in the user-facing result.