Skip to content

Policy API

The client.policy namespace exposes safety policy enforcement, named profiles, violation reporting, and risk-level lookups.

SDK proxy

crp.sdk.proxies_extra._PolicyProxy

Safety policy proxy (SPEC-006).

Exposes policy enforcement, named profiles, violation reporting, and risk-level lookups.

enforce(policy_text, context=None)

Evaluate policy_text against context.

Parameters:

Name Type Description Default
policy_text str

Policy directive string (CSP-inspired syntax).

required
context dict[str, Any] | None

Optional dict of signals (e.g. risk_level, grounding_pct).

None

Returns:

Type Description
dict[str, Any]

Policy decision as a plain dict.

profiles()

Return the dict of named policy-profile directive strings.

Returns:

Type Description
dict[str, str]

Mapping from profile name to directive string.

report(violations)

Build a violation-report dict from raw violations.

Parameters:

Name Type Description Default
violations list[dict[str, Any]]

List of violation dicts.

required

Returns:

Type Description
dict[str, Any]

Violation report dict.

risk_level(level)

Return the RiskLevel enum member for level.

Parameters:

Name Type Description Default
level str

One of LOW, MEDIUM, HIGH, CRITICAL.

required

Returns:

Type Description
Any

RiskLevel enum member.