olav 0.10.0__tar.gz

olav-0.10.0/.gitignore

@@ -0,0 +1,126 @@
+# ══════════════════════════════════════════════════════════════════════════════
+# OLAV Platform .gitignore
+#
+# AUTO-GENERATED from ownership_manifest.yaml
+# Do not edit manually — run: uv run python scripts/gen_gitignore.py --write
+# ══════════════════════════════════════════════════════════════════════════════
+
+# ── python ──
+__pycache__/
+*.py[cod]
+*.so
+*.egg-info/
+*.egg
+build/
+sdist/
+wheels/
+MANIFEST
+
+# ── venv ──
+venv/
+env/
+
+# ── ide ──
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# ── lint_cache ──
+htmlcov/
+.tox/
+.hypothesis/
+.mypy_cache/
+.pyright_cache/
+MagicMock/
+
+# ── misc ──
+*.log
+logs/
+agent_outputs/
+node_modules/
+
+# ── temp_scripts ──
+demo_*.py
+parse_test.py
+fix_openconfig_closure.py
+test_playwright.py
+test_watermark_integration.py
+WATERMARK_IMPLEMENTATION_REPORT.md
+TRAINING_DATA_*.md
+
+# ── Paths ignored by manifest rules ──
+
+# platform
+uv.lock
+CHANGELOG.md
+PARTNERS.md
+.dockerignore
+dev_docs/
+scripts/
+run/
+.vscode/
+.claude/
+
+# testing
+tests/
+
+# generated
+dist/
+exports/
+tmp/
+.coverage
+.pytest_cache/
+.ruff_cache/
+.venv/
+.agent/
+olav-post/
+olav-netops/exports/
+olav-doc/site/
+olav-web/dist/
+olav-web/node_modules/
+olav-web/.wrangler/
+.olav/databases/
+.olav/logs/
+
+# legacy
+_legacy_archived/
+
+# netops
+olav-netops/
+.olav/workspace/ops/
+.olav/workspace/ops-lab/
+
+# enterprise
+olav-ent/
+
+# docs
+olav-doc/
+
+# website
+olav-web/
+
+# runtime-workspace
+.olav/
+
+# ── Whitelist (tracked paths inside ignored parents) ──
+!.olav/
+.olav/*
+!.olav/config/
+!.olav/config/*.example
+!.olav/config/schemas/
+!.olav/workspace/
+.olav/workspace/*
+!.olav/workspace/config/
+!.olav/workspace/core/
+
+# ── Secrets (NEVER commit) ──
+.env
+.pypirc
+.pypirc_test
+.env.local
+.env.*.local
+*.token
+*.key
+*.pem

olav-0.10.0/LICENSE

@@ -0,0 +1,147 @@
+# Business Source License 1.1
+
+**Parameters**
+
+* **Version:** 0.10.0
+* **Last Updated:** 2026-03-06
+* **Licensor:** DATATECHIE PTY LTD
+* **Registered Address:** Footscray, VIC 3011, Australia
+* **Copyright:** Copyright © 2026-2030 DATATECHIE PTY LTD. All rights reserved.
+* **Software:** olav (including all core orchestration logic, agent skills, and middleware)
+* **Change Date:** 2030-01-01
+* **Change License:** Apache License, Version 2.0
+* **Additional Use Grant:** See section "Additional Use Grant" below.
+* **Partner Program:** Commercial licensing details at [olavai.com/partners](https://olavai.com/partners) (TBA).
+
+---
+
+## 1. The License Text
+
+The Licensor hereby grants you the right to copy, modify, create derivative works, redistribute, and make non-production use of the Software.
+
+**Production use** is allowed ONLY under the conditions specified in the **Additional Use Grant** below.
+
+Any use of the Software in production for purposes not explicitly permitted by the Additional Use Grant requires a separate commercial license as part of the **olav Partner Program**.
+
+---
+
+## 2. Additional Use Grant
+
+You are authorized to use the Software in a production environment under the following conditions:
+
+### A. Internal Expert Use (Free)
+
+1. **Personal Use:** You may use the Software for personal, non-commercial research and experimentation.
+2. **Internal Enterprise Use:** Organizations may use the Software for their **own internal infrastructure management**, provided that:
+* The Software is used to manage infrastructure **owned or leased by that organization**.
+* The use is not intended to provide services to any third party.
+* Contractors, consultants, and part-time staff acting **on behalf of and under the direction of** the organization are permitted to operate the Software for that organization's internal use.
+
+
+
+### B. Prohibited Commercial Use (Partner License Required)
+
+The following use cases are **EXPRESSLY PROHIBITED** under this Free Grant and require joining the **olav Partner Program**:
+
+* **Managed Service Providers (MSP):** Using olav to manage, monitor, or operate infrastructure belonging to third-party clients.
+* **Cloud Service Providers (CSP):** Offering olav as a hosted service, managed instance, or via an API to external customers.
+* **Outsourced Operations:** A third-party firm using the Software to manage **another organization's** infrastructure as a commercial service (note: contractors working under the direction of the infrastructure owner for internal use are permitted under §A.2).
+* **Bundling & Resale:** Packaging olav within a commercial product, hardware appliance, or proprietary software suite.
+* **Commercial Consulting:** Selling "olav Implementation" or "Expert Skill Tuning" as a paid service to third parties.
+
+---
+
+## 3. Vision & Philosophy
+
+The licensing model of **olav** reflects our core architectural values:
+
+* **Empowerment over Displacement:** olav is designed to liberate engineers from trivial, repetitive tasks, not to serve as an interface for cutting professional labor costs.
+* **Robustness over Cost:** We believe expertise is the only true firewall. By restricting use to direct employees or certified partners, we ensure that critical infrastructure is managed by those with the skin in the game and the necessary domain depth.
+* **Professional Respect:** We prioritize the technical sovereignty of the individual architect. If you are a professional making your own network more robust, this tool is yours. If you are a corporation seeking to arbitrage professional knowledge through cheap labor, you must contribute back to the ecosystem.
+
+---
+
+## 4. Partner Program & Licensing
+
+Organizations that fall under the "Prohibited Commercial Use" category must obtain a **Commercial Partner License**. Benefits include:
+
+* Legal right to resell/package olav-based services.
+* Direct architectural support and audit trails for compliance.
+
+For inquiries, contact: **james@olavai.com**
+
+---
+
+## 5. Change License
+
+On the **Change Date (2030-01-01)**, this license will automatically convert to the **Apache License, Version 2.0**. This ensures the long-term openness of the core framework while protecting the initial phase of expert-led innovation.
+
+---
+
+## 6. Disclaimer & Limitation of Liability
+
+### AS-IS Provision
+
+**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.
+
+DATATECHIE PTY LTD makes no representations or warranties regarding:
+* The accuracy, completeness, or reliability of the Software
+* The suitability of the Software for any particular purpose
+* The absence of errors, defects, or malicious code
+* The uninterrupted or error-free operation of the Software
+
+### AI-Generated Output Notice
+
+The Software uses large language models (LLMs) to generate responses, tool calls, and operational recommendations. **AI-generated outputs are non-deterministic and may contain errors.** Users must:
+
+* **Review all AI-generated actions** before applying them to production infrastructure
+* **Not rely solely on AI outputs** for critical infrastructure decisions without human verification
+* Understand that the Software's Agent Harness provides safety layers (HITL approval, sandbox isolation, read-only enforcement) but **cannot guarantee the correctness of LLM-generated content**
+
+### User's Responsibility
+
+By downloading, installing, or using the Software, you acknowledge and accept responsibility for:
+
+* Reviewing and approving all actions the Software takes in your infrastructure
+* All data processed, modified, or deleted by the Software
+* Configuration errors that may result in unintended network changes
+* Security vulnerabilities you may fail to patch
+* Compliance with local regulations in your jurisdiction
+
+### Limitation of Liability
+
+**TO THE MAXIMUM EXTENT PERMITTED BY LAW**, DATATECHIE PTY LTD SHALL NOT BE LIABLE FOR ANY OF THE FOLLOWING, WHETHER BASED ON WARRANTY, CONTRACT, TORT, STRICT LIABILITY, OR ANY OTHER LEGAL THEORY:
+
+* **Indirect Damages:** Loss of profits, revenue, data, goodwill, or business opportunity
+* **Special/Consequential Damages:** Damages arising from network downtime, unauthorized access, or third-party claims
+* **Direct Damages Cap:** The total liability of DATATECHIE PTY LTD shall not exceed the amount paid for the license (if Partner tier), or zero dollars (if Free Grant users)
+
+This limitation applies even if DATATECHIE PTY LTD has been advised of the possibility of such damages.
+
+### Indemnification
+
+Users using the Software shall **indemnify and hold harmless** DATATECHIE PTY LTD, its officers, employees, and partners from any third-party claims, damages, or costs (including legal fees) arising from:
+* User's use of the Software
+* User's breach of this License
+* User's negligence or misuse of the Software
+* User's unauthorized modification or redistribution
+
+### Acceptance of Terms
+
+**Use of the Software constitutes acceptance of this entire License.** You agree that:
+* You have read and understood all terms
+* You assume all risks of using the Software
+* You will not hold DATATECHIE PTY LTD liable for any damages
+* DATATECHIE PTY LTD is not liable for third-party claims against you
+
+If you do not accept these terms, **you must cease use of the Software immediately and delete all copies**.
+
+---
+
+## 7. Governing Law & Jurisdiction
+
+This License shall be governed by and construed in accordance with the laws of **Victoria, Australia**, without regard to its conflict of laws principles.
+
+* **Jurisdiction:** Exclusive jurisdiction for any disputes lies with the courts of Victoria, Australia
+* **Dispute Resolution:** Before initiating legal proceedings, parties agree to attempt good-faith negotiation
+* **Attorney's Fees:** The prevailing party in any legal proceeding shall be entitled to recover reasonable attorney's fees and costs

olav-0.10.0/PKG-INFO

@@ -0,0 +1,311 @@
+Metadata-Version: 2.4
+Name: olav
+Version: 0.10.0
+Summary: OLAV — AI-native platform for autonomous operations with domain-aware agents, API-as-Tool, and Agent Harness
+Project-URL: Homepage, https://github.com/olav-ai/olav
+Project-URL: Repository, https://github.com/olav-ai/olav
+Author: OLAV Team
+License: BSL-1.1
+License-File: LICENSE
+Keywords: agent,agentic-platform,aiops,api-as-tool,deepagents,langgraph
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: System :: Networking :: Monitoring
+Requires-Python: >=3.11
+Requires-Dist: ddgs>=9.11.4
+Requires-Dist: deepagents<1.0,>=0.4.11
+Requires-Dist: duckdb-engine>=0.17.0
+Requires-Dist: duckdb>=0.8.0
+Requires-Dist: duckduckgo-search>=3.0.0
+Requires-Dist: fastapi>=0.109.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: lancedb>=0.29.2
+Requires-Dist: langchain-community>=0.4.1
+Requires-Dist: langchain-core>=0.1.0
+Requires-Dist: langchain-ollama>=0.1.0
+Requires-Dist: langchain-openai>=0.0.1
+Requires-Dist: langchain>=0.1.0
+Requires-Dist: langgraph-checkpoint-sqlite>=3.0.0
+Requires-Dist: langgraph>=1.0.8
+Requires-Dist: markdownify>=0.13.0
+Requires-Dist: ncclient>=0.7.1
+Requires-Dist: nest-asyncio>=1.5.0
+Requires-Dist: netutils>=1.17.1
+Requires-Dist: networkx>=3.6.1
+Requires-Dist: ntc-templates>=9.0.0
+Requires-Dist: numpy>=2.4.1
+Requires-Dist: pandas>=3.0.1
+Requires-Dist: pdfplumber>=0.11.9
+Requires-Dist: prompt-toolkit>=3.0.0
+Requires-Dist: pyang>=2.7.1
+Requires-Dist: pydantic-settings>=2.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pygnmi>=0.8.15
+Requires-Dist: pyjwt>=2.12.1
+Requires-Dist: pypdf2>=3.0.0
+Requires-Dist: python-crontab>=3.0.0
+Requires-Dist: python-dateutil>=2.8.0
+Requires-Dist: python-frontmatter>=1.1.0
+Requires-Dist: pytz>=2024.1
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: rich>=13.0
+Requires-Dist: ruptures>=1.1.10
+Requires-Dist: scikit-learn>=1.8.0
+Requires-Dist: scipy>=1.17.1
+Requires-Dist: sentence-transformers>=5.2.3
+Requires-Dist: sqlalchemy>=2.0
+Requires-Dist: tavily-python>=0.3.0
+Requires-Dist: tenacity>=8.0
+Requires-Dist: textfsm>=1.1.3
+Requires-Dist: typer>=0.9.0
+Requires-Dist: uvicorn[standard]>=0.27.0
+Requires-Dist: xmltodict>=1.0.4
+Requires-Dist: yangson>=1.6.7
+Provides-Extra: dev
+Requires-Dist: black>=23.0; extra == 'dev'
+Requires-Dist: mypy>=1.5.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest-timeout>=2.4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: enterprise
+Requires-Dist: pyjwt>=2.8.0; extra == 'enterprise'
+Requires-Dist: tink>=1.14.1; extra == 'enterprise'
+Provides-Extra: gnmi
+Requires-Dist: pygnmi>=0.8.0; extra == 'gnmi'
+Provides-Extra: ldap
+Requires-Dist: ldap3>=2.9; extra == 'ldap'
+Provides-Extra: netops
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="src/olav_logo.webp" alt="OLAV Logo" width="200">
+</p>
+
+<h1 align="center">OLAV 🐺</h1>
+
+<p align="center">
+  <strong>Online Analytical Vertex for Agentic Operations</strong><br>
+  AI-native platform for autonomous infrastructure operations.
+</p>
+
+<p align="center">
+  <a href="">
+    <img src="https://img.shields.io/badge/version-v0.10.0-blue" alt="Version">
+  </a>
+  <a href="">
+    <img src="https://img.shields.io/badge/license-BSL--1.1-green" alt="License">
+  </a>
+  <a href="">
+    <img src="https://img.shields.io/badge/python-3.11+-yellow" alt="Python">
+  </a>
+  <a href="https://docs.olavai.com">
+    <img src="https://img.shields.io/badge/docs-docs.olavai.com-blue" alt="Docs">
+  </a>
+  <a href="https://discord.gg/AXnDtURJ">
+    <img src="https://img.shields.io/badge/Discord-join-5865F2?logo=discord&logoColor=white" alt="Discord">
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://olavai.com">🌐 olavai.com</a> &nbsp;·&nbsp;
+  <a href="src/README_ZH.md">中文文档</a>
+</p>
+
+> Control your infrastructure with natural language. Connect any API, deploy specialized AI agents, orchestrate operational workflows — without writing SQL or memorizing CLI flags.
+
+```bash
+olav "how many devices are online?"
+olav "which BGP neighbors are down?"
+olav --agent core "run a health check on all endpoints"
+```
+
+[Quick Start](#quick-start) | [中文](src/README_ZH.md)
+
+---
+
+## Why OLAV?
+
+### API-as-Tool — Any API Becomes an Agent Tool in One Command
+
+No code, no MCP servers. Register an OpenAPI service once, query it in natural language forever:
+
+```bash
+olav registry register http://netbox.example.com/api/schema/
+olav "how many devices are in rack A1?"   # works immediately
+```
+
+The Creator Agent can also generate editable Python `@tool` functions from any OpenAPI schema for deep customization.
+
+### Agent Harness — Four-Layer Execution Governance
+
+Every Agent decision passes through a mandatory execution control layer:
+
+```
+Layer 0: AAA        Token/LDAP/OIDC auth → RBAC → full audit trail
+Layer 1: Middleware  HITL dangerous-command interception + memory injection
+Layer 2: Sandbox    Pre-scan → DuckDB read-only enforcement → network namespace isolation
+Layer 3: Output     Credential auto-redaction + SSE JSON encoding + HttpOnly cookies
+```
+
+Hard constraints (DuckDB read-only) cannot be bypassed. Soft constraints (injection scanning, network isolation) are configurable.
+
+### Self-Improving Loop — Agents Get Better Over Time
+
+```
+Use OLAV → audit log captures every tool call and error
+    → /trace-review extracts failure constraints → writes to LanceDB memory
+    → future runs recall constraints before acting → known pitfalls avoided
+```
+
+Data-driven improvement, not manual prompt tuning.
+
+### Multi-Layer Cache — Measured 2000x+ Speedup
+
+```
+Tier-0: SemanticCache (LanceDB vector similarity, ~10ms)
+Tier-1: LLM SQLiteCache (exact prompt match, <1ms, 0 tokens)
+Tier-2: LLM API call (real network request)
+```
+
+Per-user isolation. Anthropic models automatically use prompt caching (system prompt billed once).
+
+### Federated Specialist Agents
+
+Not one omniscient Agent — **multiple specialists collaborating**:
+
+- Semantic router dispatches queries to the best-fit Agent based on `route_keywords`
+- Each Agent holds only its own tools (least privilege)
+- Per-Agent model assignment: cheap models for frequent queries, powerful models for complex analysis — 40-70% token cost reduction
+- Hot-swappable Skills: `olav skill install` extends capabilities instantly
+
+### AAA — Authentication, Authorization, Audit
+
+- **Auth**: none / token / LDAP / AD / OIDC; tokens stored as salted SHA256 hashes
+- **RBAC**: 3 roles (admin/user/readonly) × 5 actions, fine-grained per Agent/Skill
+- **Audit**: Every operation recorded to DuckDB (4 tables), SHA256 tamper-proofing (NIST AU-9), credentials auto-redacted
+
+### Full-Stack Observability — Audit as Data Asset
+
+Audit logs are not just compliance — they're a **continuously growing data asset**:
+
+- Query any dimension with DuckDB SQL (token usage, cache hit rate, tool call frequency, error patterns)
+- Multi-user concurrent-safe (DuckDB atomic writes, each record tagged with `user_id`)
+
+---
+
+## Quick Start
+
+=== "pip install (recommended)"
+    ```bash
+    # 1. Install
+    pip install olav
+
+    # 2. Initialize project
+    olav init                                   # creates .olav/ with config skeleton
+
+    # 3. Configure API key (edit the generated file)
+    #    Set shared.api_key in .olav/config/api.json
+    #    Or use environment variables:
+    export OLAV_LLM_API_KEY="sk-..."           # your LLM provider API key
+
+    # 4. Connect a service and start querying
+    olav registry register http://netbox.example.com/api/schema/
+    olav "how many devices are in rack A1?"
+
+    # Or install a community skill
+    olav skill install https://github.com/olav-ai/skill-netbox
+    olav "list all sites in Europe"
+    ```
+
+=== "From source (development)"
+    ```bash
+    # 1. Clone and install
+    git clone https://github.com/olav-ai/olav.git && cd olav
+    uv sync
+
+    # 2. Initialize and configure
+    uv run olav init                           # creates .olav/ with config skeleton
+    # Edit .olav/config/api.json → set shared.api_key
+    # Or: export OLAV_LLM_API_KEY="sk-..."
+    uv run olav registry register http://netbox.example.com/api/schema/
+    uv run olav "how many devices are in rack A1?"
+    ```
+
+### Other ways to use
+
+```bash
+olav                            # interactive TUI (multi-turn conversations)
+olav service web start          # web UI at http://localhost:2280
+olav --agent core "run: df -h"  # execute shell commands via Core Agent
+```
+
+---
+
+## Three Interfaces
+
+| Interface | Command | Best For |
+|-----------|---------|----------|
+| **CLI** | `olav "your query"` | Scripting, one-off queries, CI/CD |
+| **TUI** | `olav` | Multi-turn conversations, exploration |
+| **Web UI** | `olav service web start` | Team sharing, browser access |
+
+---
+
+## Architecture
+
+```
+User Query
+    ↓
+Semantic Router → selects best Agent (or --agent override)
+    ↓
+Agent Harness → AAA → Middleware → Sandbox
+    ↓
+LLM + Tool Loop (calls tools, gets results, synthesizes response)
+    ↓
+Response + Audit Log (automatic, every run)
+```
+
+**Tech Stack**: LangChain + LangGraph + DeepAgents + DuckDB + LanceDB + FastAPI
+
+---
+
+## Repository Structure
+
+```
+src/olav/          ← OLAV core platform (this repo)
+src/README_ZH.md   ← 中文文档
+src/olav_logo.png  ← Logo
+.olav/workspace/   ← Platform agent definitions (config/ + core/)
+.olav/config/      ← Runtime config (gitignored — contains API keys)
+.olav/databases/   ← Runtime data (gitignored — audit logs, domain data)
+```
+
+---
+
+## Documentation
+
+Documentation site: [docs.olavai.com](https://docs.olavai.com)
+
+---
+
+## License
+
+[BSL-1.1](LICENSE) — Business Source License 1.1
+
+---
+
+## Community
+
+<p align="center">
+  <strong>WeChat Official Account</strong><br>
+  <img src="src/wechat.jpeg" alt="WeChat QR Code" width="160">
+</p>