Every entry in the table is a stable API. The code, the name, and the human-facing message do not change between minor versions. Automation can match on the code; humans should read the message.
The table
| Code | Name | Cause | Remedy |
|---|---|---|---|
| E001 | FingerprintMismatch | Two objects that should be equal produced different fingerprints. | Compare inputs field by field with ns.fingerprint_diff to find the drift. |
| E002 | UnknownAdapter | No adapter is registered for the framework of the model passed in. | Install the matching extra, e.g. pip install 'neuronscope[torch]'. |
| E003 | ProbeIncompatibleWithModel | The probe requested layers the adapter cannot resolve. | Check the layer glob against ns.introspect(model).layer_names. |
| E004 | ArtifactSchemaTooNew | The artifact was written by a newer major version. | Upgrade NeuronScope or ask the writer for a downgraded copy. |
| E005 | ArtifactSchemaTooOld | The artifact predates the minimum supported major. | Migrate with ns migrate <artifact> --to 0.9.2. |
| E006 | NonDeterministicOp | deterministic=True was requested but an installed op is not. | Set the framework flag documented in the error message, or drop the flag. |
| E007 | SealAfterClose | A recording was written to after its scope exited. | Move all writes inside the with-block. |
| E008 | PromptCanonicalizationError | A prompt object contains an unhashable field. | Convert the field to a str, list, or dict of primitives. |
| E009 | StorageBackendUnavailable | The configured storage backend (s3, gcs, azure) is not installed. | Install the matching extra or point the URL scheme at a local path. |
| E010 | PluginContractMismatch | A loaded plugin targets a different plugin-API major. | Upgrade or downgrade the plugin, then re-run ns plugins doctor. |
How to read an entry
Every error raised by NeuronScope carries three attributes: .code (the E-prefixed identifier), .name (the exception class), and .hint(a one-line, mechanical remedy). Log the code in CI so a failure is trivially attributable to a row above.