agentomy-agent 0.3.0__tar.gz

agentomy_agent-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agentomy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

agentomy_agent-0.3.0/PKG-INFO

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: agentomy-agent
+Version: 0.3.0
+Summary: Embedded AI agent governance peer. Standalone or connected to Agentomy infrastructure.
+Author-email: Agentomy <governance@agentomy.com>
+License: MIT
+Project-URL: Homepage, https://agentomy.com
+Project-URL: Documentation, https://agentomy.com/docs
+Project-URL: Source, https://github.com/getagentomy
+Keywords: governance,ai-agents,security,compliance
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Security
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# agentomy-agent
+
+Embedded AI Agent Governance Peer. Drop it into any agent session to get real-time governance assessment, flag reporting, and GovernanceBench scoring.
+
+**License:** MIT | **Requires:** Python 3.9+
+
+## Installation
+
+```bash
+pip install agentomy-agent
+```
+
+## Quick start
+
+```bash
+# Detect local LLMs and print the governance system prompt
+agentomy-agent init
+
+# Start a governed session (prints governance context + system prompt)
+agentomy-agent session --model qwen2.5:32b --scope security-research
+
+# Check governance state
+agentomy-agent status
+
+# Connect to Agentomy infrastructure (6/6 mode)
+agentomy-agent status --infra http://localhost:3000
+```
+
+## What it does
+
+The Agentomy Agent is a governance peer -- not a wall. It observes, assesses, flags, and summarises. It does not block or halt. Enforcement belongs to the human operator.
+
+**Standalone mode (Architecture B):** 3/6 GovernanceBench dimensions.
+- Authorization: is the agent operating within its assigned scope?
+- Behavioral Integrity: is the agent's behavior consistent with its stated purpose?
+
+**Connected mode (Architecture A):** 6/6 GovernanceBench dimensions.
+- Adds: Auditability (cryptographic audit trail) + Override Capability (verified kill switch)
+
+## Governance system prompt
+
+The governance system prompt is bundled in the package. Paste it into any LLM session to activate the Agentomy Agent:
+
+```bash
+agentomy-agent init --full-prompt
+```
+
+Or access it in Python:
+
+```python
+from agentomy_agent.prompt import SYSTEM_PROMPT
+print(SYSTEM_PROMPT)
+```
+
+## Ollama MCP integration
+
+Start the MCP server:
+
+```bash
+agentomy-agent serve
+# Listening on http://127.0.0.1:8765
+```
+
+Add to your Ollama MCP config (`~/.ollama/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "agentomy": {
+      "url": "http://127.0.0.1:8765",
+      "description": "Agentomy Agent -- Embedded AI Agent Governance Peer"
+    }
+  }
+}
+```
+
+The MCP server exposes two tools:
+- `agentomy_prompt` -- returns the full governance system prompt
+- `agentomy_status` -- returns current governance state (standalone mode)
+
+## Model recommendations
+
+Use a frontier model (Claude, GPT-5.x, Gemini) or a local model of 32B+ parameters for reliable governance assessment. Models below 14B may produce false governance confidence.
+
+```bash
+# Check what you have installed
+agentomy-agent init
+```
+
+The `init` command probes Ollama (localhost:11434) and LM Studio (localhost:1234) and reports available models with size tags and recommendations.
+
+## Python API
+
+```python
+from agentomy_agent.governance import GovernanceSession, check_model_capability
+from agentomy_agent.detector import detect_all
+from agentomy_agent.prompt import SYSTEM_PROMPT
+
+# Detect local LLMs
+providers = detect_all()
+for p in providers:
+    print(p["provider"], [m["name"] for m in p["models"]])
+
+# Check model capability
+cap = check_model_capability("qwen2.5:32b")
+print(cap["level"], cap["message"])  # degraded / full / warning
+
+# Track a governance session
+session = GovernanceSession(model="qwen2.5:32b", connected=False)
+session.record_clean()
+session.record_flag("HIGH", "tool call outside scope", "accessed /etc/passwd", "Authorization")
+print(session.summary())
+```
+
+## Architecture B vs Architecture A
+
+| | Architecture B (standalone) | Architecture A (connected) |
+|---|---|---|
+| GovernanceBench score | 3/6 | 6/6 |
+| Authorization assessment | Yes | Yes |
+| Behavioral Integrity | Yes | Yes |
+| Cryptographic audit trail | No | Yes |
+| Fleet-level kill switch | No | Yes |
+| VIGIL threat detection | Observation only | 148 scenarios, scored |
+| Shadow AI discovery | No | Yes |
+| GDPR Article 22 | No | Yes |
+
+Architecture B ships today. No infrastructure required. Connect to the Agentomy infrastructure layer for the full 6/6 experience.
+
+## Connect
+
+- Infrastructure integration: [agentomy.com/integrations](https://agentomy.com/integrations)
+- Enterprise deployment: governance@agentomy.com
+- GitHub: [github.com/getagentomy](https://github.com/getagentomy)

agentomy_agent-0.3.0/README.md

@@ -0,0 +1,134 @@
+# agentomy-agent
+
+Embedded AI Agent Governance Peer. Drop it into any agent session to get real-time governance assessment, flag reporting, and GovernanceBench scoring.
+
+**License:** MIT | **Requires:** Python 3.9+
+
+## Installation
+
+```bash
+pip install agentomy-agent
+```
+
+## Quick start
+
+```bash
+# Detect local LLMs and print the governance system prompt
+agentomy-agent init
+
+# Start a governed session (prints governance context + system prompt)
+agentomy-agent session --model qwen2.5:32b --scope security-research
+
+# Check governance state
+agentomy-agent status
+
+# Connect to Agentomy infrastructure (6/6 mode)
+agentomy-agent status --infra http://localhost:3000
+```
+
+## What it does
+
+The Agentomy Agent is a governance peer -- not a wall. It observes, assesses, flags, and summarises. It does not block or halt. Enforcement belongs to the human operator.
+
+**Standalone mode (Architecture B):** 3/6 GovernanceBench dimensions.
+- Authorization: is the agent operating within its assigned scope?
+- Behavioral Integrity: is the agent's behavior consistent with its stated purpose?
+
+**Connected mode (Architecture A):** 6/6 GovernanceBench dimensions.
+- Adds: Auditability (cryptographic audit trail) + Override Capability (verified kill switch)
+
+## Governance system prompt
+
+The governance system prompt is bundled in the package. Paste it into any LLM session to activate the Agentomy Agent:
+
+```bash
+agentomy-agent init --full-prompt
+```
+
+Or access it in Python:
+
+```python
+from agentomy_agent.prompt import SYSTEM_PROMPT
+print(SYSTEM_PROMPT)
+```
+
+## Ollama MCP integration
+
+Start the MCP server:
+
+```bash
+agentomy-agent serve
+# Listening on http://127.0.0.1:8765
+```
+
+Add to your Ollama MCP config (`~/.ollama/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "agentomy": {
+      "url": "http://127.0.0.1:8765",
+      "description": "Agentomy Agent -- Embedded AI Agent Governance Peer"
+    }
+  }
+}
+```
+
+The MCP server exposes two tools:
+- `agentomy_prompt` -- returns the full governance system prompt
+- `agentomy_status` -- returns current governance state (standalone mode)
+
+## Model recommendations
+
+Use a frontier model (Claude, GPT-5.x, Gemini) or a local model of 32B+ parameters for reliable governance assessment. Models below 14B may produce false governance confidence.
+
+```bash
+# Check what you have installed
+agentomy-agent init
+```
+
+The `init` command probes Ollama (localhost:11434) and LM Studio (localhost:1234) and reports available models with size tags and recommendations.
+
+## Python API
+
+```python
+from agentomy_agent.governance import GovernanceSession, check_model_capability
+from agentomy_agent.detector import detect_all
+from agentomy_agent.prompt import SYSTEM_PROMPT
+
+# Detect local LLMs
+providers = detect_all()
+for p in providers:
+    print(p["provider"], [m["name"] for m in p["models"]])
+
+# Check model capability
+cap = check_model_capability("qwen2.5:32b")
+print(cap["level"], cap["message"])  # degraded / full / warning
+
+# Track a governance session
+session = GovernanceSession(model="qwen2.5:32b", connected=False)
+session.record_clean()
+session.record_flag("HIGH", "tool call outside scope", "accessed /etc/passwd", "Authorization")
+print(session.summary())
+```
+
+## Architecture B vs Architecture A
+
+| | Architecture B (standalone) | Architecture A (connected) |
+|---|---|---|
+| GovernanceBench score | 3/6 | 6/6 |
+| Authorization assessment | Yes | Yes |
+| Behavioral Integrity | Yes | Yes |
+| Cryptographic audit trail | No | Yes |
+| Fleet-level kill switch | No | Yes |
+| VIGIL threat detection | Observation only | 148 scenarios, scored |
+| Shadow AI discovery | No | Yes |
+| GDPR Article 22 | No | Yes |
+
+Architecture B ships today. No infrastructure required. Connect to the Agentomy infrastructure layer for the full 6/6 experience.
+
+## Connect
+
+- Infrastructure integration: [agentomy.com/integrations](https://agentomy.com/integrations)
+- Enterprise deployment: governance@agentomy.com
+- GitHub: [github.com/getagentomy](https://github.com/getagentomy)

agentomy_agent-0.3.0/agentomy_agent/__init__.py

@@ -0,0 +1,2 @@
+"""Agentomy Agent -- Embedded AI Agent Governance Peer"""
+__version__ = "0.3.0"