Metadata-Version: 2.4
Name: zin-adk
Version: 0.1.2
Summary: Zin Agent Development Kit — build, deploy, and govern autonomous cybersecurity agents
Author-email: "zeron.one" <info@zeron.one>
Maintainer-email: "zeron.one" <info@zeron.one>
License: Proprietary
Project-URL: Homepage, https://zeron.one
Project-URL: Repository, https://github.com/securezeron/zia
Project-URL: Bug Tracker, https://github.com/securezeron/zia/issues
Project-URL: Changelog, https://github.com/securezeron/zia/blob/main/CHANGELOG.md
Keywords: cybersecurity,security-agents,ai-agents,autonomous-agents,risk-quantification,devsecops,soc-automation,vulnerability-management,compliance-automation,security-intelligence
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: OS Independent
Classifier: Typing :: Typed
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: pydantic>=2.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: structlog>=23.0
Requires-Dist: click>=8.0
Requires-Dist: rich>=13.0
Requires-Dist: python-ulid>=2.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: mypy>=1.0; extra == "dev"
Requires-Dist: build>=1.0; extra == "dev"
Requires-Dist: twine>=5.0; extra == "dev"
Provides-Extra: graph
Requires-Dist: kuzu>=0.6.0; extra == "graph"
Provides-Extra: api
Requires-Dist: fastapi>=0.110; extra == "api"
Requires-Dist: uvicorn[standard]>=0.27; extra == "api"
Requires-Dist: python-multipart>=0.0.9; extra == "api"
Provides-Extra: all
Requires-Dist: fastapi>=0.110; extra == "all"
Requires-Dist: uvicorn[standard]>=0.27; extra == "all"
Requires-Dist: python-multipart>=0.0.9; extra == "all"

# Zin ADK — Agent Development Kit for Cybersecurity

> **Build, deploy, and govern autonomous cybersecurity agents.**

[![PyPI version](https://badge.fury.io/py/zin-adk.svg)](https://badge.fury.io/py/zin-adk)
[![Python](https://img.shields.io/pypi/pyversions/zin-adk.svg)](https://pypi.org/project/zin-adk/)
[![License](https://img.shields.io/badge/license-Proprietary-red.svg)](https://zeron.one)

ZIA provides a unified platform for building cybersecurity agents with bounded autonomy, policy enforcement, and full auditability — out of the box.

---

## Install

```bash
pip install zin-adk

# With REST API support
pip install "zin-adk[api]"

# With graph database support (Python ≤ 3.13)
pip install "zin-adk[graph]"
```

## Quick Start

```bash
# Scaffold a new agent
zia init --name "Vuln Triage Agent" --domain appsec --out ./agents

# Implement agents/vuln_triage_agent.py → execute()

# Validate
zia validate agents/vuln-triage-agent.yaml

# Run
zia run agents/vuln-triage-agent.yaml --tenant acme

# Or start the REST API
zia serve --host 0.0.0.0 --port 8000
```

## What's included

| Component | What it does |
|---|---|
| **US-ADSL** | YAML DSL for declarative agent definitions — schema-validated |
| **Agent Runtime** | Lifecycle management (`pre_run → execute → post_run`) |
| **Policy Engine** | 6-rule in-process guardrails enforced on every tool call |
| **Tool Substrate** | `@zia_tool` decorator — policy-aware, auditable tool execution |
| **Agent Registry** | `@register_agent` — domain-based discovery and dispatch |
| **SIF Graph** | Time-aware security knowledge graph (Kuzu, namespace-isolated per tenant) |
| **Multi-tenancy** | Tenant isolation from day one — no leakage possible |
| **REST API** | FastAPI layer for portal and SIEM integration |
| **CLI** | `zia init` · `zia validate` · `zia run` · `zia serve` |

## Supported Agent Domains

| Domain | Use case |
|---|---|
| `risk_quant` | Continuous risk scoring, FAIR-like modelling |
| `supply_chain` | Vendor posture, SBOM risk, 3rd-party exposure |
| `red_team` | Autonomous red teaming, attack path discovery |
| `appsec` | SAST, DAST, IaC scanning, dependency analysis |
| `ai_security` | Prompt risk, model exposure, LLM guardrail validation |
| `compliance` | Control monitoring, evidence collection, drift detection |

## Build an agent in 3 steps

**1. Define it**

```yaml
# agents/my-agent.yaml
agent:
  id: my-agent
  domain: appsec
  version: "1.0.0"
intent:
  goal: "Triage open vulnerabilities by severity"
reasoning:
  mode: rule_based
  autonomy_level: bounded
capabilities:
  tools: [list_vulnerabilities]
boundaries:
  allowed_actions: [agent_execute, list_vulnerabilities]
safety:
  sandbox_profile: standard
  audit_level: standard
```

**2. Implement it**

```python
from zia.core.runtime.agent import AgentContext, AgentResult, BaseAgent
from zia.core.runtime.registry import register_agent
from zia.core.tools.substrate import ToolExecutor
import zia.core.tools.builtins as tools

@register_agent(domain="appsec")
class MyAgent(BaseAgent):
    def execute(self, context: AgentContext) -> AgentResult:
        vulns = ToolExecutor.call(tools.list_vulnerabilities, context=context)
        critical = [v for v in vulns if v.get("severity") == "critical"]
        return AgentResult.ok(context, output={"critical_count": len(critical)})
```

**3. Run it**

```bash
zia run agents/my-agent.yaml --tenant acme
```

## REST API

```bash
zia serve --host 0.0.0.0 --port 8000

# Create tenant
curl -X POST http://localhost:8000/tenants \
  -H "X-API-Key: your-key" \
  -d '{"tenant_id": "acme", "name": "Acme Corp"}'

# Trigger agent run
curl -X POST http://localhost:8000/tenants/acme/runs \
  -H "X-API-Key: your-key" \
  -d '{"domain": "risk_quant", "environment": "staging"}'

# Interactive API docs
open http://localhost:8000/docs
```

---

**Zeron © 2026** — [zeron.one](https://zeron.one)
