Glossary
All public error codes.
Runtime dialogs and Studio diagnostics link directly to these stable pages, so users can repair the real failure instead of guessing from a raw exception.
CB_ERR_RUNTIME_ARGUMENTSMissing runtime package
ClosedBit Runtime was opened without an embedded app package and without a .cba path.
CB_ERR_SYNTAXSyntax shape error
The source could not be parsed into valid CBP statements, blocks, or expressions.
CB_ERR_UNKNOWN_KEYWORDUnknown command or keyword
A statement starts with a word that is not part of the CBP language.
CB_ERR_UNKNOWN_FUNCTIONUnknown function
A function call is not built in, not defined in the source, and not exported by a loaded library.
CB_ERR_UNDECLARED_VALUEUnknown value or variable
A name was read before it was declared or before a function returned it.
CB_ERR_TYPE_MISMATCHValue type mismatch
A value reached an operator or function that expects a different type.
CB_ERR_BAD_ARGUMENT_COUNTWrong number of arguments
A function was called with too few or too many values.
CB_ERR_MISSING_SEMICOLONLine termination ambiguity
Semicolons are optional at normal line ends, but compact one-line code can still need a separator.
CB_ERR_OVERFLOWNumeric overflow
A checked integer or floating lane exceeded the value it can represent.
CB_ERR_UNDERFLOWNumeric underflow
A checked unsigned operation produced a value below zero.
CB_ERR_DIVIDE_BY_ZERODivision by zero
A division or modulo operation used zero as the divisor.
CB_ERR_NONFINITE_FLOATNon-finite floating result
A floating-point operation produced NaN, positive infinity, or negative infinity.
CB_ERR_INVALID_NUMBERInvalid number text
Text could not be parsed into the requested numeric type.
CB_ERR_RANGEValue out of accepted range
A number, dimension, color, memory cap, shift amount, or index exceeded the supported range.
CB_ERR_SHIFT_RANGEShift count out of range
A bit shift used a count outside the valid 0..255 range.
CB_ERR_TRUNCATIONUnsafe truncation
A conversion would lose information, usually from a larger numeric lane into a smaller lane.
CB_ERR_LIMITNative safety limit reached
A native ClosedBit operation hit a configured safety limit.
CB_ERR_NULLRequired value was missing
A native call received a missing pointer, buffer, or required value.
CB_ERR_BUFFER_TOO_SMALLOutput buffer too small
A native compile or validation call could not fit the result into the provided output buffer.
CB_ERR_INVALID_FORMATInvalid file format
A .cb, .cba, .cbl, .dll package, or embedded overlay does not match the expected ClosedBit format.
CB_ERR_VERSIONUnsupported format version
The installed runtime does not support the package version.
CB_ERR_ARRAY_INDEXArray index out of range
The program tried to read or write an array slot that does not exist.
CB_ERR_STRING_INDEXString index out of range
The program tried to read a character outside the string.
CB_ERR_INDEX_TARGETIndexed a non-indexable value
Square brackets were used on a value that is not an array or string.
CB_ERR_EMPTY_ARRAYArray is empty
A function needed at least one item, but the array had none.
CB_ERR_ASSERTIONAssertion failed
A program assertion evaluated to false.
CB_ERR_LOOP_LIMITLoop safety budget exceeded
A loop ran past the compiled runtime safety budget.
CB_ERR_RENDER_CALLRender call shape error
A rendering function received invalid arguments or ran before the window was ready.
CB_ERR_WINDOW_REQUIREDWindow required first
A draw or input operation ran before a window existed.
CB_ERR_RENDER_RANGERender value out of range
A render dimension, line width, grid count, color, or font size is outside the allowed range.
CB_ERR_GPU_UNAVAILABLEGPU unavailable
The selected GPU backend could not be created.
CB_ERR_GPU_BUDGETGPU memory budget exceeded
The GPU request exceeded the configured VRAM budget.
CB_ERR_GPU_BACKENDGPU backend failure
The Direct3D/GPU runtime path failed while creating or running work.
CB_ERR_FILE_NOT_FOUNDFile not found
A source, model, save, key, asset, or library file was missing.
CB_ERR_FILE_IOFile input/output failure
A file could not be read, written, copied, or decoded.
CB_ERR_SAVE_CONTAINERInvalid .cb save container
A .cb file failed validation or no longer matches the ClosedBit storage format.
CB_ERR_STORAGE_IOStorage operation failed
A CB-Storage read or write failed.
CB_ERR_ASSET_IOAsset loader failure
An asset could not be loaded, decoded, measured, copied, or packed.
CB_ERR_NETWORK_IONetwork operation failed
An HTTP, WebSocket, socket, DNS, or API request failed.
CB_ERR_INDEX_IOTagged index failure
The indexed dataset or tag index could not be read or did not match the dataset.
CB_ERR_INVALID_PACKAGEInvalid runtime package
The .cba, .exe overlay, .dll package, .cbl, or CBVM payload is malformed or unsupported.
CB_ERR_PACKAGE_AUTHPackage authentication failed
A protected compiled package did not pass authentication.
CB_ERR_PACKAGE_VERSIONUnsupported package version
The runtime does not support the package version.
CB_ERR_RUNTIME_LAUNCHRuntime launch failed
The app reached a runtime failure that did not match a narrower error family.
CB_ERR_RUNTIME_DEPENDENCYRuntime dependency missing
A required ClosedBit runtime DLL or service could not be loaded.
CB_ERR_MEMORY_POLICYMemory policy failure
Runtime could not apply or satisfy the selected memory profile.
CB_ERR_RESOURCE_LIMITResource limit reached
A workload exceeded the active CPU, RAM, VRAM, string, node, or operation safety budget.
CB_ERR_BUILD_OUTPUTOutput artifact failure
The compiler could not write the requested .cba, .exe, .dll, .cbl, or .msi artifact.
CB_ERR_LICENSE_REQUIREDLicense check required
The compiler could not confirm an active product license for the requested build.
CB_ERR_ENCRYPT_KEYEncrypt key problem
The encrypt command did not receive a generated key, key file, or valid 256-character key.
CB_ERR_DECRYPT_KEYDecrypt key problem
Decrypt needs the original matching key and an unchanged encrypted package.
CB_ERR_UNKNOWN_KEYUnknown keyboard key
Input code named a key the runtime does not recognize.
CB_ERR_UNSUPPORTED_NODEUnsupported compiled node
The compiled program contains a node this runtime cannot execute.
CB_ERR_LIBRARY_NOT_FOUNDLibrary not found
A library declaration names a library that is not shipped, compiled, or installed in the active library path.
CB_ERR_LIBRARY_INVALIDInvalid compiled library
A .cbl library failed validation, uses an unsupported version, or does not export valid functions.
CB_ERR_ENTRYPOINTEntry point problem
An app package did not define a usable main function, or a library tried to define the app entry point.
CB_ERR_AI_INDEXAI index query failed
A generation or understanding query could not use its tagged index or fallback dataset.
CB_ERR_API_ROUTEAPI route did not match
A local API handler received a method or path it does not serve.
CB_ERR_SECURITY_POLICYSecurity policy blocked the operation
Authentication, RBAC, rate limiting, token validation, or a sandbox policy denied the request.
CB_ERR_INTERNALInternal ClosedBit error
ClosedBit hit a failure that does not have a more specific public code yet.