RESOURCES
Shared resource management failures.
The RESOURCES module covers errors in accessing and managing shared resources across a multi-agent system. This includes access control, resource contention, and quota management.
Categories
ACCESS
Resource access failures.
| Code | Severity | Description | Remediation |
|---|---|---|---|
RESOURCES.ACCESS.DENIED | 4 | Resource access denied | Implement access control |
RESOURCES.ACCESS.NOT_FOUND | 3 | Resource not found | Handle missing resources |
RESOURCES.ACCESS.LOCKED | 3 | Resource is locked | Implement lock timeout |
RESOURCES.ACCESS.EXPIRED | 3 | Resource access expired | Handle expiration |
RESOURCES.ACCESS.REVOKED | 4 | Resource access revoked | Handle revocation gracefully |
CONTENTION
Resource contention failures.
| Code | Severity | Description | Remediation |
|---|---|---|---|
RESOURCES.CONTENTION.DEADLOCK | 5 | Resource deadlock | Implement deadlock prevention |
RESOURCES.CONTENTION.STARVATION | 4 | Resource starvation | Implement fair scheduling |
RESOURCES.CONTENTION.PRIORITY_INVERSION | 4 | Priority inversion | Implement priority inheritance |
RESOURCES.CONTENTION.THRASHING | 4 | Resource thrashing | Implement throttling |
RESOURCES.CONTENTION.OVERFLOW | 3 | Resource pool overflow | Implement pool limits |
Warning
RESOURCES.CONTENTION.DEADLOCK (severity 5) occurs when multiple agents are each waiting for resources held by others, creating a circular wait. This is distinct from COORDINATION.WORKFLOW.DEADLOCK, which refers to workflow-level blocking rather than resource-level blocking.
QUOTA
Resource quota failures.
| Code | Severity | Description | Remediation |
|---|---|---|---|
RESOURCES.QUOTA.EXCEEDED | 3 | Quota exceeded | Implement quota enforcement |
RESOURCES.QUOTA.ALLOCATION_FAILED | 4 | Quota allocation failed | Handle allocation failure |
RESOURCES.QUOTA.UNFAIR_DISTRIBUTION | 3 | Unfair quota distribution | Implement fair distribution |
RESOURCES.QUOTA.LEAK | 4 | Quota leak detected | Implement quota accounting |
RESOURCES.QUOTA.STALE | 2 | Quota information is stale | Refresh quota regularly |
Example Diagnosis
{
"error_code": "RESOURCES.CONTENTION.DEADLOCK",
"confidence": 0.91,
"root_cause": "Agent A holds a lock on the database connection pool while waiting for the file system lock held by Agent B, which is waiting for the database connection pool.",
"suggested_fixes": ["guard", "parameter"]
}