Skip to main content
The privilege analyzer scans agent permissions to find over-privileged agents, unused permissions, and potential security issues.

Usage

analyzeAgent(agentId, { since }) compares the agent’s permissions against audit log entries since since (default: the last 30 days). If the agent does not exist, it returns an "appropriate" result with agentName: "unknown" and no findings.

Analyze all agents

analyzeAll covers agents whose status is active. There is no scanAll method.

Finding types

Score

Configuration

The analyzer has no configuration options. The lookback window is 30 days by default and can be overridden per call with since.
The analyzer reads from the audit trail. Keep agents.auditAll enabled (the default) so that permission usage is recorded; otherwise every permission looks unused.
Last modified on October 7, 2026