Error codes
Every RelKit error and warning code, what it means and what to do next.
Every error and warning RelKit prints starts with a RELKIT_* code and ends with a link to that code’s page. Each page says what happened and what to do next.
| Code | Problem |
|---|---|
RELKIT_ADD_API_UNAVAILABLE |
Scaffolding support could not be loaded |
RELKIT_ADD_CANCELLED |
relkit add was cancelled |
RELKIT_ADD_COLLISION |
Added code would overwrite existing code |
RELKIT_ADD_INSTALLATION_FAILED |
Dependency installation failed after relkit add |
RELKIT_ADD_INVALID_PROJECT |
Project cannot be extended by relkit add |
RELKIT_ADD_UNSUPPORTED_SOURCE_SHAPE |
Source file is too customized to edit |
RELKIT_ADD_USAGE |
Invalid relkit add arguments |
RELKIT_ADD_VALIDATION_FAILED |
Project check failed after relkit add |
RELKIT_AGENT_ACCESS_DENIED |
Agent tool call was refused |
RELKIT_AGENT_CANCELLED |
Agent run was cancelled |
RELKIT_AGENT_CONTROL_INVALID |
Agent is missing the approve control |
RELKIT_AGENT_DEADLINE_INVALID |
Agent timeout or deadline is invalid |
RELKIT_AGENT_INPUT_VALIDATION |
Agent input is invalid |
RELKIT_AGENT_INVOCATION_FAILED |
Agent run failed |
RELKIT_AGENT_JSON_INVALID |
Agent value is not plain JSON |
RELKIT_AGENT_LIMIT_INVALID |
Agent size limit is invalid |
RELKIT_AGENT_MODEL_ERROR |
Model returned an error |
RELKIT_AGENT_MODEL_UNAVAILABLE |
Agent model is not available |
RELKIT_AGENT_OUTPUT_VALIDATION |
Agent output is invalid |
RELKIT_AGENT_RESPONSE_LIMIT |
Agent value is too large |
RELKIT_AGENT_RESUME_UNAVAILABLE |
No agent run is waiting |
RELKIT_AGENT_RUN_FAILED |
Agent run failed |
RELKIT_AGENT_RUN_PENDING |
Agent thread is waiting for approval |
RELKIT_AGENT_STEP_LIMIT |
Agent hit its step limit |
RELKIT_AGENT_TIMEOUT |
Agent run timed out |
RELKIT_AGENT_TOOL_DENIED |
Agent tool call was denied |
RELKIT_AGENT_TOOL_FAILED |
Agent tool call failed |
RELKIT_AGENT_TOOL_INVALID |
Agent tool is invalid |
RELKIT_AGENT_TOOL_LIMIT |
Agent hit its tool-call limit |
RELKIT_AGENT_TOOL_UNKNOWN |
Agent called an unknown tool |
RELKIT_APP_DUPLICATE |
More than one app config is exported |
RELKIT_APPLICATION_BUILD_UNAVAILABLE |
No build for createRelkit |
RELKIT_APPLICATION_NOT_RUNNING |
No application is running |
RELKIT_APPROVAL_DENIED |
Tool call was denied |
RELKIT_APPROVAL_INVALID |
Approval request is invalid |
RELKIT_APPROVAL_REQUIRED |
Tool call needs approval |
RELKIT_APPROVAL_STATE_INVALID |
Approval cannot change to this state |
RELKIT_ARTIFACT_WRITE_FAILED |
Generated files could not be written |
RELKIT_AUTH_DUPLICATE |
Better Auth is set up more than once |