Skip to content

Troubleshooting ​

Messages and symptoms visible in the application; provider-specific incidents outside Coral are excluded. For product support, use GitHub issues when online.

MessageLikely causeWhat to do
layout.capability.unsupportedLayout cannot execute authored meaningKeep source and change the unsupported request
layout.constraint.required-unsatisfiedRequired constraints conflictRevise a required constraint
layout.route.anchor-missingA route anchor cannot be resolvedRestore or change the referenced object

Things that look wrong ​

SymptomLikely causeWhat to do
Diagram remains on prior layoutNew geometry is pending or refusedRead Diagnostics; prior verified view is retained
AI change is not appliedCandidate was rejected or staleReview diagnostics and use Retry explicitly
Export is unavailableCurrent route or geometry is unverifiedResolve diagnostics and Reflow
Voice input does not startMode, permission, or model load failedCheck Preferences, microphone access, and network
Open does not replace workLoad was cancelled or invalidKeep current work and choose a valid Coral document

Layout capability unsupported ​

Coral preserves the authored request and reports the unsupported execution surface instead of inventing geometry.

Required constraint unsatisfied ​

Required constraints are atomic. No partial candidate replaces the prior verified diagram.

Route anchor missing ​

The route refers to an object or anchor that is not available in the current document.

Diagram remains on prior layout ​

The previous verified result remains visible while a candidate is pending or when the replacement was refused.

AI change is not applied ​

A rejected or stale result leaves the current document unchanged. Read the diagnostic and use Retry only when you want a new provider request.

Export is unavailable ​

Export uses verified geometry only. Resolve the blocking diagnostic and Reflow before trying again.

Voice input does not start ​

Confirm that an API key is present, voice mode is not off, microphone access is allowed, and any required Whisper model has loaded.

Open does not replace work ​

A cancelled or invalid load leaves current work intact. Choose a supported Coral document and confirm replacement when prompted.