InvestigatePass and block events

PASS and BLOCK events

AgentKeeper records different event types for different reasons. The most common enterprise confusion is seeing BLOCK events but not PASS events.

AgentKeeper records different event types for different reasons. The most common enterprise confusion is seeing BLOCK events but not PASS events.

The short version: BLOCK events log regardless. PASS events require full tool-call logging for the applicable runtime policy.

Expected behavior

EventLogged by defaultWhy
BLOCKYesA blocked action is a security decision and must be auditable.
WARNYesA warning is a security decision that needs review.
PASSOnly when full tool-call logging is enabledBenign tool calls can be high volume, so admins choose whether to keep the full audit trail.
SystemYesSetup, registration, and self-test events prove install state.

The setting that controls PASS

The product setting is Log All Tool Calls. When enabled, benign runtime activity can appear as PASS in Activity. When disabled, blocked and warned activity still appears, but routine allowed activity may be suppressed.

For a clean test:

  1. Enable Log All Tool Calls in the policy surface that applies to the workstation.
  2. Run a new tool action so the next supported runtime evaluation uses the updated policy.
  3. Restart or refresh the agent session if the integration loads hooks at session start.
  4. Run a benign tool call.
  5. Filter Activity by the expected source.
  6. Confirm the event appears as PASS.

Cowork-specific expectation

Claude Desktop / Cowork should produce source cowork.

Validation sequence:

  1. Run a benign Cowork action, such as reading a non-sensitive project file.
  2. Confirm Activity shows PASS with source cowork.
  3. Run a blocked action that your policy denies, such as reading a protected secret path.
  4. Confirm Activity shows BLOCK with source cowork.

If BLOCK appears but PASS does not:

  • Confirm Log All Tool Calls is enabled.
  • Confirm you are viewing the same environment used by the install command.
  • Confirm the event source is cowork.
  • Confirm the runtime policy applying to the user did not explicitly disable full audit logging.
  • Run a fresh tool action after saving policy changes; old events will not be backfilled as PASS.

Claude Chat-specific expectation

Claude Chat in Claude Desktop should produce source claude_chat when the Gateway identifies the Chat surface, or Gateway-routed MCP activity for older Gateway builds.

Validation sequence:

  1. Start AgentKeeper Gateway.
  2. Fully restart Claude Desktop.
  3. Ask Claude Chat to use a configured MCP tool.
  4. Confirm Activity shows PASS for the Chat or Gateway MCP source.
  5. Configure a temporary policy that blocks a low-risk test MCP server or tool.
  6. Ask Claude Chat to use that blocked tool.
  7. Confirm Activity shows BLOCK for the same workstation.

If Gateway check-in appears but Chat activity does not, confirm claude_desktop_config.json points Claude Desktop at AgentKeeper Gateway and that Gateway is running in the same user profile.

Why system events are not enough

A system event proves that the workstation or installer reached AgentKeeper. It does not prove that the live runtime hook is firing.

A healthy install should show:

  • System or self-test event after setup.
  • PASS event after a benign tool action.
  • BLOCK event after a denied tool action.

Enterprise acceptance test

Before expanding a deployment cohort, run this test on at least one representative workstation per agent source:

StepActionExpected Activity row
1Run setup or self-testSystem event for the source or host
2Run benign tool actionPASS for the expected source
3Run blocked tool actionBLOCK for the expected source
4Review person/group mappingEvent resolves to the intended policy audience

Do not mark a cohort complete if it only produces system events.