AgentForge

Error Catalog

Complete list of AgentForge error codes and their meanings.

ErrorCatalog

import { ErrorCatalog } from '@ahzan-agentforge/core';

The ErrorCatalog is a map of error codes to their metadata. Use it to look up error details programmatically.

ErrorCode

type ErrorCode = string;

Error codes follow the pattern {CATEGORY}_{DESCRIPTION}:

CategoryExamples
AGENT_*Agent lifecycle errors
TOOL_*Tool execution errors
LLM_*LLM provider errors
STATE_*State store errors
BUDGET_*Budget violation errors
POLICY_*Autonomy policy errors
MEMORY_*Memory store errors

Common Error Codes

CodeSourceDescription
AGENT_MAX_STEPSframeworkAgent exceeded maxSteps limit
TOOL_TIMEOUTtoolTool execution timed out
TOOL_VALIDATIONtoolInput/output schema validation failed
LLM_API_ERRORllmLLM provider returned an error
LLM_RATE_LIMITllmRate limited by the provider
BUDGET_EXCEEDEDframeworkToken or cost budget exceeded
POLICY_DENIEDframeworkTool call denied by autonomy policy
STATE_LOAD_ERRORframeworkFailed to load state from store

Using the Catalog

const entry = ErrorCatalog['TOOL_TIMEOUT'];
// { message: '...', source: 'tool', recoverable: true }

Next Steps