Release Notes
One entry per release tag, newest first. A release covers the control plane, the Go, Python and TypeScript SDKs, and the enforcement adapters (MCP PEP and Envoy PEP) together, and they share one version number. Entries are short summaries of what shipped, not a full change log.
Use matching versions of the control plane, SDKs and adapters. Upgrading one without the others is not tested. See Upgrade and rollback before upgrading approval-bearing integrations, and the SDK Manual for the current install commands.
v0.9.0
- Enforcement modes: an organization can switch from the default
permissivetoobserve, which previews a stricter posture without changing any result, orstrict, which denies calls to unregistered assets and assets with no matching policy. Asuper_admincan also override the mode for one environment or one asset type.permissivestays the default. See Enforcement modes. - Controls: a kill switch stops every call for the organization or for one asset, break-glass gives one asset a time-boxed, two-person exception to strict mode, and definition pinning denies calls in strict mode when an MCP tool's definition has changed. Pinning applies to the MCP stdio adapter and to SDK callers that supply the digest; it has no effect on MCP over HTTP through the Envoy adapter.
- Auditing: the read-only
auditorrole has an expiry and can read recorded operations, decision explanations and outcome coverage. Outcome reports carry execution correlation, and assets can carry an AI inventory description with a risk tier. Approving or rejecting an approval for a high-risk asset needs a reviewer comment. See RBAC and Audit. - Evidence vault: Enterprise licences with the
evidence.vaultentitlement can keep the content of a governed call encrypted under their own key in their own storage, while the control plane records only a pointer. It is off until asuper_adminenables it. Email addresses and comments in new audit events are replaced by pseudonyms, with a documented procedure for unlinking a person. See Evidence vault and Pseudonymous principals. This is not a compliance claim. - SDKs: a
guardcall in Go, Python and TypeScript, a typed outcome report with execution correlation in all three SDKs, optional definition observation and AI inventory on asset writes, and optional vault evidence on the guard. The Python vault helpers need thevaultextra, and the Go AWS KMS key backend is a separate module. The MCP adapter library can write vault records; the packaged adapter binary does not enable that yet. - Correctness fixes: policy evaluation is deterministic when policies tie on creation time, an audit event is written in the same transaction as the change it records (a failed audit write now rolls the change back with a
500), and quotas are capped at 2^53-1 in API responses while enforcement keeps the full value. - Upgrade: the release adds database migrations, none of them destructive, and they run in order. The removed setting
approval_notifications.bypass_email_domains(OPK_APPROVAL_NOTIFY_BYPASS_EMAIL_DOMAINS) must be deleted before the upgrade, because the service now refuses to start while it is set. Sign-in codes always go to the user's own mailbox. Use matching control-plane, SDK and adapter versions, and read Upgrade and rollback first. - SDK source comparisons: Go, Python, TypeScript.
v0.8.0
- Policy lifecycle: policies are draft, published or archived. The Console creates drafts, and API creation without a status stays published. Published edits remain immediately live. Definitions can be validated and simulated without recording a decision, charging usage, creating or redeeming an approval, or permitting execution.
- Policy authoring is validated against the current asset schema. New operators: presence tests, case-sensitive prefix matching, exact list membership and restricted single-leaf negation.
- Exact bounded decimal comparison and payload binding. Unsupported numeric values are rejected instead of rounded, and request errors are distinguished from invalid evaluation context in the API and all three SDKs. This changes some approval bindings; read Upgrade and rollback first.
- The SDKs add an explicit draft status for policy creation.
- Invalid context: the MCP stdio adapter returns a denied tool result, and the Envoy adapter keeps the
invalid_contextcode on HTTP 400. Neither calls the upstream. - An unknown explicit asset ID fails closed. The no-policy, no-match and unknown-key
allowdefaults are unchanged. - SDK source comparisons: Go, Python, TypeScript.
v0.7.0
- First release of the MCP PEP: MCP
tools/callis governed at the Envoy PEP and by the MCP stdio PEP, with tool-to-asset mapping. - Decision-only
allowresults report an explicit audit state. - Go SDK:
NewClientWithTransportfor servers that restart. - Envoy PEP fixes: it waits longer than the decision-point budget, does not keep connections alive to it, and refuses request bodies on MCP
GETandDELETEbefore calling it.
v0.6.0
- Envoy ext_authz PEP image published.
- PEP/PDP contract reference, including client-owned retry. The proxy approval challenge matches the documented contract.
- SDK gRPC streams carry the stored approval retry tuple.
- Go and TypeScript refund examples show the asynchronous approval poll flow.
v0.5.5
- One shared entitlement resolver for SaaS and Enterprise, applied to numeric limits and route checks. Profile responses expose the canonical entitlement set.
- SDKs add
EntitlementSetandBillingSnapshotmodels. - License lifecycle and organization lifecycle handling completed.
- Assets that are not registered are allowed by default, with reason
asset_not_registered. See Reason Codes.
v0.5.3
- Approvals can be scoped, are delivered by webhook, and have a polling endpoint. SDKs wait briefly for asynchronous follow-up.
- License flow and entitlement enforcement documented and validated; license key validation hardened.
v0.5.0
- Assets can be resolved by key, and policies can be cloned.
- Console inventory grids for groups, API keys and members are paginated, and the dashboard shows pending discoveries.
v0.4.3
- Queue-backed asset discovery, with SDK clients and a discovery scope on bootstrap keys.
- Dashboard sessions expire, and the Console shows an entitlement expiry banner.
v0.4.2
- Audit trail with structured evidence, strict filtering and pagination, and recorded evaluation failures. Decision history and approvals paginate strictly.
- Asset owners can resolve approvals, and governance collections are scoped to owned assets.
v0.4.1
- Maintenance release: API reference corrections and Console sign-in refinements.
v0.4.0
- Policies are evaluated through the asset they are linked to, with system presets.
- Decision metadata is validated, and a debug evaluation trace is available on the decision API and the playground.
- Member invitation with roles in the Console.
- Cross-SDK metadata schema guards and asset-ID helpers.
v0.3.0
- Cross-SDK metadata schema guards and asset-ID alignment across the Go, Python and TypeScript SDKs. These notes start at this version.