Skip to content

Sentience Governor v0.3.0.2: Reliable Governance for LangGraph Runs

Choose a tag to compare

View all tags
@rohynal rohynal released this 20 Aug 22:48
v0.3.0.2
7958df8
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Sentience Governor v0.3.0.2

This release fixes LangGraph session continuity and false POL-001 findings in nested agent runs.

LangGraph governance now follows the root invocation

A single LangGraph .invoke() can trigger callbacks at both the graph and node level.

Previously, Sentience could interpret those nested callbacks as separate governance sessions. That meant later sessions could lose the original intent baseline and incorrectly raise POL-001 on a tool the caller had explicitly declared.

v0.3.0.2 keeps one governance session for the root invocation and correctly attributes nested tool and LLM activity back to it.

Concurrent callback runs are isolated

A single SentienceCallbackHandler can now govern overlapping LangGraph runs without one run closing, overwriting, or contaminating another.

Isolation now covers:

  • governance sessions
  • declared intent baselines
  • tool attribution
  • llm_turn_id
  • token usage
  • model and provider telemetry
  • parallel graph branches

SentienceMiddleware is not covered by this concurrency guarantee. LangChain does not provide it with run identifiers, so it remains one middleware instance per agent run. If more than one run is open, it reports a governance error rather than attributing a tool call to a guess.

Existing non-concurrent SessionManager behavior remains unchanged unless a caller explicitly opts into concurrent sessions.

True policy violations still fire

This release fixes the false positive without weakening the underlying governance check.

  • Declared tool inside a nested LangGraph run → no false POL-001
  • Undeclared tool → POL-001 still fires

Documentation is now GitHub-native

The public documentation has been consolidated into the repository's docs/ tree, including:

  • installation and quickstart
  • command reference
  • integrations
  • governance profiles
  • troubleshooting
  • user guide
  • user-facing changelog

The user-facing changelog was also brought current through v0.3.0.2. This corrected stale documentation that still described sentience-sync as an available command after it had been removed in v0.3.0.1.

Verification

v0.3.0.2 was verified against real LangGraph executions, including nested graphs, overlapping root invocations, parallel branches, and default SessionManager behavior.

  • 959 repository tests passed locally on Python 3.14.6
  • required CI passed on Python 3.10, 3.11, 3.12, and 3.13
  • public-surface release checks passed
  • production PyPI artifacts verified byte-for-byte against the pre-release artifacts
  • fresh install from production PyPI verified
  • 21/21 targeted LangGraph release checks passed

Install

pip install -U sentience-governor

Or pin this release:

pip install sentience-governor==0.3.0.2

Full documentation: https://github.com/crescerelabs/sentience-governor/blob/main/docs/index.md

Assets 2
Loading