govagent 3.0.2__tar.gz → 3.0.3__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. {govagent-3.0.2 → govagent-3.0.3}/LICENSE +21 -21
  2. {govagent-3.0.2 → govagent-3.0.3}/PKG-INFO +19 -13
  3. {govagent-3.0.2 → govagent-3.0.3}/README.md +422 -416
  4. {govagent-3.0.2 → govagent-3.0.3}/pyproject.toml +65 -65
  5. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/__init__.py +21 -21
  6. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/agent.py +253 -230
  7. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/context/__init__.py +11 -11
  8. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/context/fiscal_ledger.py +41 -41
  9. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/context/session.py +15 -15
  10. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/extensions/crewai/enforcer.py +210 -210
  11. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/extensions/ibm/bob_mcp_proxy.py +45 -45
  12. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/extensions/ibm/watsonx_bus.py +43 -43
  13. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/governance/__init__.py +3 -3
  14. govagent-3.0.3/src/govagent/governance/cfo_analytics.py +89 -0
  15. govagent-3.0.3/src/govagent/governance/evidence.py +154 -0
  16. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/governance/meta.py +96 -94
  17. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/guards/__init__.py +6 -6
  18. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/guards/circuit_breaker.py +55 -55
  19. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/guards/privacy.py +19 -19
  20. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/guards/semantic.py +71 -71
  21. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/hitl/__init__.py +15 -15
  22. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/hitl/adapters.py +18 -18
  23. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/hitl/manager.py +110 -110
  24. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/hitl/slack_adapter.py +200 -200
  25. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/llm/__init__.py +4 -4
  26. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/llm/base.py +28 -28
  27. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/llm/ollama.py +39 -39
  28. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/llm/router.py +70 -70
  29. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/policy.py +82 -82
  30. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/pricing.py +22 -22
  31. govagent-3.0.3/src/govagent/registry/__init__.py +22 -0
  32. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/registry/harbor_verifier.py +33 -33
  33. govagent-3.0.3/src/govagent/registry/manager.py +111 -0
  34. govagent-3.0.3/src/govagent/registry/schemas.py +57 -0
  35. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/telemetry/__init__.py +3 -3
  36. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/telemetry/exporters/__init__.py +13 -13
  37. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/telemetry/exporters/azure.py +29 -29
  38. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/telemetry/exporters/base.py +8 -8
  39. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/telemetry/exporters/cloudwatch.py +35 -35
  40. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/telemetry/exporters/federated.py +81 -79
  41. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/telemetry/exporters/mock.py +8 -8
  42. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/telemetry/manager.py +70 -70
  43. govagent-3.0.2/src/govagent/registry/__init__.py +0 -8
  44. govagent-3.0.2/src/govagent/registry/manager.py +0 -85
  45. govagent-3.0.2/src/govagent/registry/schemas.py +0 -22
  46. {govagent-3.0.2 → govagent-3.0.3}/src/govagent/extensions/__init__.py +0 -0
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 Niraj Kakodkar
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Niraj Kakodkar
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: govagent
3
- Version: 3.0.2
3
+ Version: 3.0.3
4
4
  Summary: The Governance-First Framework for Agentic AI, Enterprise Middleware & OCI Supply Chain Gating
5
5
  License: MIT
6
6
  License-File: LICENSE
@@ -43,7 +43,9 @@ Project-URL: LinkedIn, https://www.linkedin.com/in/thekakodkar/
43
43
  Project-URL: Repository, https://github.com/thekakodkar/govagent
44
44
  Description-Content-Type: text/markdown
45
45
 
46
- # govAgent (v3.0.2)
46
+ <img width="2071" height="795" alt="logo" src="https://github.com/user-attachments/assets/7aed634c-34e0-450c-9a7e-ee03ecd26ea5" />
47
+
48
+ # govAgent (v3.0.3)
47
49
 
48
50
  **The Governance-First Control Plane for AI Agents & Swarms**
49
51
 
@@ -194,14 +196,19 @@ If you prefer to run the stack natively outside of Docker containers using Poetr
194
196
  # Install core dependencies with the LangChain bundle
195
197
  poetry install --extras "langchain"
196
198
 
197
- # Download the core NLP model for the local privacy redaction engine
198
- python -m spacy download en_core_web_sm
199
+ # Test suite: CrewAI adapter, local embeddings, and the dev server.
200
+ # sentence-transformers is required to construct ExecutiveAgent because
201
+ # SemanticGuard loads during __init__.
202
+ poetry install --with dev --extras "crewai enterprise"
203
+
204
+ # Presidio's default AnalyzerEngine requests en_core_web_lg.
205
+ python -m spacy download en_core_web_lg
199
206
 
200
207
  # Start the services manually in separate terminals
201
208
  uvicorn api.server:app --host 127.0.0.1 --port 8000
202
209
  npm run dev
203
210
  ```
204
- ## 🏗️ Core Pillars: The v3.0.2 Sovereign Architecture
211
+ ## 🏗️ Core Pillars: The v3.0.3 Sovereign Architecture
205
212
  GovAgent utilizes a highly modular package structure to enforce a strict "Separation of Duties" across any enterprise application vertical:
206
213
 
207
214
  **govagent.context (The State):** Manages thread-safe session isolation, asynchronous parent-to-child trace propagation, and live cumulative Total Cost of Operation (TCO) calculation matrices across decentralized agent swarms.
@@ -236,18 +243,18 @@ async def process_payment(amount: float, reference_id: str):
236
243
  """Executes a disbursement following corporate policy and OCI container validation."""
237
244
  return f"SUCCESS: Transacted ${amount} for Ref: {reference_id}"
238
245
  ```
239
- ### Bootstrap an Executive Agent (v3.0.2 Pluggable Router Pattern)
246
+ ### Bootstrap an Executive Agent (v3.0.3 Pluggable Router Pattern)
240
247
 
241
248
  ```python
242
249
  import asyncio
243
250
  from govagent.agent import ExecutiveAgent
251
+ from govagent.policy import Policy
244
252
  from govagent.llm.router import PolicyBasedRouter, RouterConfig, RoutingMode
245
253
  from govagent.llm.ollama import OllamaClient
246
254
 
247
255
  async def main():
248
- # v3.0.2 Routing Setup: Configure the dynamic path fabric
249
256
  router_cfg = RouterConfig(
250
- routing_mode=RoutingMode.LOCAL_PREFERRED,
257
+ routing_mode=RoutingMode.LOCAL_ONLY,
251
258
  default_provider="local_ollama"
252
259
  )
253
260
  clients = {
@@ -255,14 +262,13 @@ async def main():
255
262
  }
256
263
  router = PolicyBasedRouter(clients=clients, config=router_cfg)
257
264
 
258
- # Bootstrap automatically binds local YAML policies to your router client
259
265
  agent = ExecutiveAgent(
260
266
  persona="Director",
261
- policy_path="policies/finance_policy.yaml",
267
+ policy=Policy.from_yaml("policies/finance_policy.yaml"),
262
268
  router=router
263
269
  )
264
270
 
265
- # Execution paths automatically evaluate Privacy, Semantic, Fiscal, and Registry guards
271
+ # Equivalent factory: ExecutiveAgent.bootstrap(policy_path, router)
266
272
  task = "Approve an urgent, immediate transaction of $8,500 to buy compute nodes."
267
273
  result = await agent.execute(task)
268
274
 
@@ -308,7 +314,7 @@ Every session generates an immutable snapshot routed directly to external cloud
308
314
 
309
315
  In an institutional setting, "State Management" is insufficient; you require Sovereignty. GovAgent v1.0.0 is engineered horizontally to transform "Black Box" multi-agent workflows into transparent, compliance-vetted execution lifecycles across all commercial sectors.
310
316
 
311
- | Feature | **GovAgent v3.0.2** | LangGraph | Standard Orchestrators |
317
+ | Feature | **GovAgent v3.0.3** | LangGraph | Standard Orchestrators |
312
318
  | --- | --- | --- | --- |
313
319
  | **Architectural Scope** | ✅ **Modular Control Plane** | ⚠️ Local State Graph | ❌ Ad-Hoc Swarm Execution |
314
320
  | **State Management** | ✅ **Isolated Fiscal Ledger** | ⚠️ Shared Thread State | ❌ Global context |
@@ -456,7 +462,7 @@ We enforce a strict branching strategy to keep `main` stable:
456
462
 
457
463
  ---
458
464
  ### Author Stamp
459
- * **Framework:** GovAgent v3.0.2
465
+ * **Framework:** GovAgent v3.0.3
460
466
  * **Compliance:** Designed for Article 9, 12, and 14 Accountability
461
467
  * **Status:** Active / Open-Source Standard
462
468