Skip to content

Add SidClaw Governance Service integration #113

@VladUZH

Description

@VladUZH

Summary

Add a governance service integration for Google ADK agents using SidClaw — policy evaluation, human-in-the-loop approval, and tamper-proof audit trails for tool calls.

Background

This was invited by @rohityan in google/adk-python#5081:

"Hi @VladUZH, Closing this PR here as it belongs to adk-python-community repo. We highly recommend releasing the feature as a standalone package that we will then share through: https://google.github.io/adk-docs/integrations/"

What It Does

The SidClawGovernanceService integrates with ADK's before_tool_callback and after_tool_callback hooks:

  1. Before tool execution — evaluates the action against SidClaw policies (allow / deny / require approval)
  2. After tool execution — records the outcome in SidClaw's hash-chain audit trail

Implementation

  • New module: src/google/adk_community/governance/
  • Uses the sidclaw PyPI package (Apache 2.0, published)
  • Async-only (matches ADK callback pattern)
  • Configurable per-tool data classifications and approval behavior
  • Fail-closed by default when SidClaw is unreachable
  • Comprehensive unit tests (20 test cases)

CLA

Already signed — see google/adk-python#5081.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions