petfishframework 0.5.1__tar.gz → 0.5.2__tar.gz

{petfishframework-0.5.1 → petfishframework-0.5.2}/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 All notable changes to petfishFramework will be documented in this file.
 
+## [0.5.2] — 2026-07-09
+
+### Review Fix Patch
+
+#### MCP Server Version Fix
+- `serve_as_mcp()` now returns dynamic `__version__` instead of hardcoded "0.5.0"
+
+#### README Status Sync
+- MCP server mode: `📋 Planned` → `✅ MVP (stdio JSON-RPC: initialize/tools.list/tools.call)`
+- Examples run instruction: added "from a repository checkout" clarification
+
+#### ToolGovernance First-Class API
+- New `ToolGovernance` dataclass bundles schema_validator + rate_limiter + idempotency_store + timeout_policy
+- `Agent(tool_governance=...)` wires governance into Session → RuntimeEnvironment
+- No more need to construct RuntimeEnvironment directly for governance features
+- README now includes Tool Governance usage example
+
+#### Resource Type Fix
+- `Resource` dataclass gains `risk_level: RiskLevel | None` field
+- `RiskClassificationPolicy` now works with standard Resource objects
+
+#### Rate-Limit / Idempotency Order Fix
+- Idempotency cache check moved BEFORE rate limiting
+- Cache hits no longer consume rate quota (correct semantic: rate limit counts real executions)
+
 ## [0.5.1] — 2026-07-09
 
 ### Deferred Items Completion + Reasoning Strategy Upgrades

{petfishframework-0.5.1 → petfishframework-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: petfishframework
-Version: 0.5.1
+Version: 0.5.2
 Summary: A lightweight runtime framework for reliable, auditable, budget-aware, and permission-aware AI agents.
 Project-URL: Homepage, https://github.com/kylecui/petfishFramework
 Project-URL: Documentation, https://github.com/kylecui/petfishFramework/tree/master/docs
@@ -218,7 +218,7 @@ print(result.summary())
 
 See `examples/05_enterprise_expense.py` and `tests/test_enterprise_demo.py` for a complete enterprise expense approval scenario demonstrating all 6 DecisionEffects.
 
-Run: `python examples/05_enterprise_expense.py`
+Run (from a repository checkout): `python examples/05_enterprise_expense.py`
 
 ## YAML Policy Engine
 
@@ -271,6 +271,20 @@ session.events.subscribe(siem_sink)
 result = session.run()
 ```
 
+## Tool Governance
+
+```python
+from petfishframework.tools import ToolGovernance, ToolSchemaValidator
+from petfishframework.tools.rate_limiter import RateLimiter, RateLimitPolicy
+
+governance = ToolGovernance(
+    schema_validator=ToolSchemaValidator(),  # validate tool args before execution
+    rate_limiter=RateLimiter(),              # per-tool sliding-window rate limit
+)
+
+agent = Agent(model=model, reasoning=ReAct(), tools=tools, tool_governance=governance)
+```
+
 ## Roadmap
 
 - **v0.2.x**: Core runtime, permission semantics, enterprise PoC, Trusted Publishing ✅
@@ -293,7 +307,7 @@ petfishFramework is **Alpha**. API may change before v1.0.
 | Session replay / deterministic rerun / resume | ✅ Available |
 | OpenTelemetry + SIEM observability | ✅ Available |
 | MCP client stdio | ✅ Available |
-| MCP server mode | 📋 Planned |
+| MCP server mode | ✅ MVP (stdio JSON-RPC: initialize/tools.list/tools.call) |
 | Structured output / conversation memory | ✅ Available |
 | YAML Policy Engine | ✅ Available |
 | Credential Broker | ✅ Available |

{petfishframework-0.5.1 → petfishframework-0.5.2}/README.md

@@ -183,7 +183,7 @@ print(result.summary())
 
 See `examples/05_enterprise_expense.py` and `tests/test_enterprise_demo.py` for a complete enterprise expense approval scenario demonstrating all 6 DecisionEffects.
 
-Run: `python examples/05_enterprise_expense.py`
+Run (from a repository checkout): `python examples/05_enterprise_expense.py`
 
 ## YAML Policy Engine
 
@@ -236,6 +236,20 @@ session.events.subscribe(siem_sink)
 result = session.run()
 ```
 
+## Tool Governance
+
+```python
+from petfishframework.tools import ToolGovernance, ToolSchemaValidator
+from petfishframework.tools.rate_limiter import RateLimiter, RateLimitPolicy
+
+governance = ToolGovernance(
+    schema_validator=ToolSchemaValidator(),  # validate tool args before execution
+    rate_limiter=RateLimiter(),              # per-tool sliding-window rate limit
+)
+
+agent = Agent(model=model, reasoning=ReAct(), tools=tools, tool_governance=governance)
+```
+
 ## Roadmap
 
 - **v0.2.x**: Core runtime, permission semantics, enterprise PoC, Trusted Publishing ✅
@@ -258,7 +272,7 @@ petfishFramework is **Alpha**. API may change before v1.0.
 | Session replay / deterministic rerun / resume | ✅ Available |
 | OpenTelemetry + SIEM observability | ✅ Available |
 | MCP client stdio | ✅ Available |
-| MCP server mode | 📋 Planned |
+| MCP server mode | ✅ MVP (stdio JSON-RPC: initialize/tools.list/tools.call) |
 | Structured output / conversation memory | ✅ Available |
 | YAML Policy Engine | ✅ Available |
 | Credential Broker | ✅ Available |

{petfishframework-0.5.1 → petfishframework-0.5.2}/docs/api.md

@@ -1,6 +1,6 @@
 # petfishFramework API Reference
 
-This document is the authoritative reference for the public API of petfishFramework v0.5.1. Every signature, field, and example below is derived from the source code and from the tests that exercise it.
+This document is the authoritative reference for the public API of petfishFramework v0.5.2. Every signature, field, and example below is derived from the source code and from the tests that exercise it.
 
 ## 1. Overview