cave-harness 0.1.0__tar.gz

cave_harness-0.1.0/LICENSE

@@ -0,0 +1,144 @@
+GNOSYS Personal Builder License (GPBL) v1.0
+
+Copyright © 2025 Isaac Wostrel-Rubin
+Guardian of the GNOSYS / Sanctuary Stack
+
+GNOSYS and the Sanctuary libraries are free, open, and hackable for personal and internal use.
+Run them, fork them, and share them — with one core constraint:
+
+You can't sell them or run them as-a-service without a separate commercial license from me.
+
+⸻
+
+1  You Can
+
+You are granted a non-exclusive, non-transferable, worldwide license to:
+    •    Run GNOSYS / Sanctuary libraries anywhere, for yourself or inside your own org, for free.
+    •    Study, modify, and extend the code, including:
+    •    Changing behavior, structure, or architecture
+    •    Adding MCPs, agents, workflows, UI, or integrations
+    •    Share your modified versions (forks, patches, examples) publicly, as long as:
+    •    You keep this license text, and
+    •    Your distribution stays non-commercial (see §3).
+
+This applies to:
+    •    The GNOSYS meta-library
+    •    Sanctuary / STARSYSTEM / HEAVEN / CartON / related libraries and tools in this repo
+    •    Any example configs or reference agents shipped with them
+
+unless a specific file or subproject explicitly states a different license.
+
+⸻
+
+2  Please Do
+
+To keep the ecosystem coherent:
+    •    Keep this license notice and a link back to the main repo.
+    •    Clearly mark modifications (e.g. in the README:
+"This is a modified version of GNOSYS by <your name>."
+    •    When possible, credit GNOSYS / Sanctuary in docs or marketing as the underlying stack.
+
+⸻
+
+3  You Can't (Without a Commercial License)
+
+You may not, without a separate written commercial license from Isaac Wostrel-Rubin:
+    •    Sell GNOSYS / Sanctuary itself, including:
+    •    Paid downloads, paywalled builds, or subscriptions
+    •    "Pro" binaries where GNOSYS is the primary value
+    •    Offer GNOSYS / Sanctuary as a hosted or managed service, including:
+    •    SaaS platforms, hosted agents, or API products where:
+    •    GNOSYS / Sanctuary code is a core dependency and
+    •    Third parties sign up, pay, or are billed for access
+    •    Bundle GNOSYS / Sanctuary into another paid product, where:
+    •    The libraries are a key part of the product's value, even if not visible
+    •    Or the product would not realistically function as-sold without them
+    •    Re-license this code under a different, more permissive or commercial license.
+
+If you want to:
+    •    Build a SaaS,
+    •    Embed this stack in a product, or
+    •    Sell access to agents powered by GNOSYS / Sanctuary,
+then you need a commercial license. See §9.
+
+⸻
+
+4  What Is Allowed Commercially
+
+You may, without a separate license:
+    •    Charge for your time and expertise, including:
+    •    Consulting, coaching, architecture, and design work
+    •    Installation, customization, and integration of GNOSYS / Sanctuary on the client's own infrastructure
+    •    Teaching others how to use, extend, or modify the stack
+    •    Use GNOSYS internally to:
+    •    Accelerate your own work
+    •    Build internal tools and workflows not sold as products
+    •    Support your own content, research, or services
+
+Put simply:
+
+Selling your brain is OK. Selling GNOSYS / Sanctuary as a product or hosted service is not, unless you've got a commercial agreement.
+
+⸻
+
+5  Trademarks & Naming
+
+"GNOSYS", "Sanctuary System", "STARSYSTEM", "Victory-Everything Chain (VEC)", "OMNISANC", and related marks, names, or logos may be protected as trademarks or service marks.
+
+Under this license you:
+    •    May reference these names factually (e.g. "Built on GNOSYS"), and
+    •    May not imply official endorsement, partnership, or authorship by Isaac Wostrel-Rubin unless you actually have that agreement.
+
+If you fork the stack into your own product, use your own brand and clearly mark it as such.
+
+⸻
+
+6  No Warranty
+
+The software is provided "as is", without warranty of any kind, express or implied, including but not limited to:
+    •    Merchantability
+    •    Fitness for a particular purpose
+    •    Non-infringement
+
+You assume all risk for using, modifying, or deploying this code.
+
+⸻
+
+7  Limitation of Liability
+
+In no event shall the author(s) or copyright holder(s) 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.
+
+⸻
+
+8  Termination
+
+If you violate this license and do not remedy the violation within 30 days of being notified:
+    •    Your rights under this license automatically terminate.
+    •    You must stop using, distributing, or hosting GNOSYS / Sanctuary under this license.
+
+The author may grant you a new license at their sole discretion after remediation.
+
+⸻
+
+9  Commercial Licensing
+
+If you want to:
+    •    Run GNOSYS / Sanctuary as a SaaS or hosted agent platform
+    •    Embed it into a commercial product
+    •    Resell it or bundle it into paid offerings
+
+you must obtain a commercial license.
+
+To do that:
+    1.    Book a paid licensing meeting via
+👉 https://isaacwr.carrd.co
+and note that you are requesting a GNOSYS / Sanctuary commercial license.
+    2.    The meeting payment reserves Isaac's time and is non-refundable if you decide not to purchase the license.
+    3.    If you proceed, the meeting fee will be discounted against the license price.
+
+The standard commercial license is:
+
+$997 USD — universal commercial rights
+(to use GNOSYS / Sanctuary in your own commercial products and services, subject to the terms in the commercial agreement).
+
+Do not book this meeting unless you are seriously intending to obtain the license; the call fee compensates for time even if you choose not to move forward.

cave_harness-0.1.0/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.4
+Name: cave-harness
+Version: 0.1.0
+Summary: Code Agent Virtualization Environment - Virtualize any terminal-based code agent
+Author-email: Isaac <isaac@example.com>
+License: GPBL-1.0
+Project-URL: Homepage, https://github.com/sancovp/cave
+Project-URL: Documentation, https://github.com/sancovp/cave#readme
+Project-URL: Repository, https://github.com/sancovp/cave
+Keywords: ai,agents,claude,virtualization,harness
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic==2.10.6
+Requires-Dist: fastapi==0.136.1
+Requires-Dist: uvicorn==0.46.0
+Requires-Dist: httpx==0.28.1
+Requires-Dist: sanctuary-dna>=0.3.5
+Requires-Dist: beartype
+Requires-Dist: deepmerge
+Requires-Dist: svix-ksuid==0.7.0
+Requires-Dist: networkx
+Requires-Dist: pydash
+Requires-Dist: pyee
+Requires-Dist: sorcery
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Dynamic: license-file
+
+# CAVE — Code Agent Virtualization Environment
+
+**Package:** `cave-harness`
+
+CAVE virtualizes any terminal-based code agent (e.g. Claude Code) behind an HTTP server, so it can be
+driven, observed, and orchestrated as a service instead of an interactive terminal. It is the agent
+runtime that PromptWorld and the other *Worlds are built on.
+
+## What it gives you
+
+- **An HTTP server around a code agent** — start a long-lived agent process and talk to it over HTTP
+  instead of a TTY: inject prompts, stream output, and run it inside a loop.
+- **A hook harness** — a registry + dispatch layer for Claude Code hooks (session-start / per-turn /
+  stop), so behavior can be layered onto the agent from outside.
+- **Loop infrastructure** — the autopoiesis / guru loops that keep an agent working across turns.
+
+## Install
+
+```bash
+pip install cave-harness
+```
+
+Optional extras:
+
+```bash
+pip install "cave-harness[sdna]"   # + sanctuary-dna integration
+pip install "cave-harness[dev]"    # + pytest / pytest-asyncio
+```
+
+## Run the server
+
+```bash
+cave-server
+```
+
+This launches the HTTP server (`cave.server.http_server:run_server`, FastAPI + uvicorn). Point your
+client at it to register hooks, inject prompts, and drive the virtualized agent.
+
+## Where it sits
+
+CAVE is the **runtime** layer of the SANCREV / GNOSYS stack: the *Worlds (PromptWorld, …) compile their
+agents and run them on top of the CAVE harness. See the ecosystem docs for the full picture.
+
+## Docs
+
+Full documentation and the ecosystem map: **https://sancovp.github.io/aisaac/**
+
+## License
+
+GPBL-1.0 — see `LICENSE`.

cave_harness-0.1.0/README.md

@@ -0,0 +1,50 @@
+# CAVE — Code Agent Virtualization Environment
+
+**Package:** `cave-harness`
+
+CAVE virtualizes any terminal-based code agent (e.g. Claude Code) behind an HTTP server, so it can be
+driven, observed, and orchestrated as a service instead of an interactive terminal. It is the agent
+runtime that PromptWorld and the other *Worlds are built on.
+
+## What it gives you
+
+- **An HTTP server around a code agent** — start a long-lived agent process and talk to it over HTTP
+  instead of a TTY: inject prompts, stream output, and run it inside a loop.
+- **A hook harness** — a registry + dispatch layer for Claude Code hooks (session-start / per-turn /
+  stop), so behavior can be layered onto the agent from outside.
+- **Loop infrastructure** — the autopoiesis / guru loops that keep an agent working across turns.
+
+## Install
+
+```bash
+pip install cave-harness
+```
+
+Optional extras:
+
+```bash
+pip install "cave-harness[sdna]"   # + sanctuary-dna integration
+pip install "cave-harness[dev]"    # + pytest / pytest-asyncio
+```
+
+## Run the server
+
+```bash
+cave-server
+```
+
+This launches the HTTP server (`cave.server.http_server:run_server`, FastAPI + uvicorn). Point your
+client at it to register hooks, inject prompts, and drive the virtualized agent.
+
+## Where it sits
+
+CAVE is the **runtime** layer of the SANCREV / GNOSYS stack: the *Worlds (PromptWorld, …) compile their
+agents and run them on top of the CAVE harness. See the ecosystem docs for the full picture.
+
+## Docs
+
+Full documentation and the ecosystem map: **https://sancovp.github.io/aisaac/**
+
+## License
+
+GPBL-1.0 — see `LICENSE`.

cave_harness-0.1.0/cave/__init__.py

@@ -0,0 +1,92 @@
+"""
+CAVE - Code Agent Virtualization Environment
+
+Virtualize any terminal-based code agent (Claude Code, Aider, etc.)
+to create AI-legible architectures where you can vibe code together.
+"""
+
+# === Core Agent Classes ===
+from .core.agent import (
+    CodeAgent,
+    CodeAgentConfig,
+    ClaudeCodeAgent,
+    ClaudeCodeAgentConfig,
+    InboxMessage,
+    UserPromptMessage,
+    SystemEventMessage,
+    BlockedMessage,
+    CompletedMessage,
+    IngressType,
+    create_user_message,
+    create_system_event,
+)
+
+# === CAVEAgent (The God Object) ===
+from .core.cave_agent import CAVEAgent
+from .core.config import CAVEConfig
+from .core.models import MainAgentConfig, PAIAState, AgentRegistration, RemoteAgentHandle
+from .core.state_reader import ClaudeStateReader
+
+# === Mixins ===
+from .core.mixins import (
+    PAIAStateMixin,
+    AgentRegistryMixin,
+    MessageRouterMixin,
+    HookRouterMixin,
+    RemoteAgentMixin,
+    SSEMixin,
+)
+
+# === Hooks (define hooks in code) ===
+from .core.hooks import (
+    ClaudeCodeHook,
+    HookType,
+    HookDecision,
+    HookResult,
+    HookRegistry,
+    RegistryEntry,
+    AntigravityHook,
+    AntigravityEnvelopeAdapter,
+)
+
+__version__ = "0.1.0"
+__all__ = [
+    # Core agents
+    "CodeAgent",
+    "CodeAgentConfig",
+    "ClaudeCodeAgent",
+    "ClaudeCodeAgentConfig",
+    "InboxMessage",
+    "UserPromptMessage",
+    "SystemEventMessage",
+    "BlockedMessage",
+    "CompletedMessage",
+    "IngressType",
+    "create_user_message",
+    "create_system_event",
+    # CAVEAgent
+    "CAVEAgent",
+    "CAVEConfig",
+    # Models
+    "PAIAState",
+    "AgentRegistration",
+    "RemoteAgentHandle",
+    "ClaudeStateReader",
+    # Mixins
+    "PAIAStateMixin",
+    "AgentRegistryMixin",
+    "MessageRouterMixin",
+    "HookRouterMixin",
+    "RemoteAgentMixin",
+    "SSEMixin",
+    # Hooks
+    "ClaudeCodeHook",
+    "HookType",
+    "HookDecision",
+    "HookResult",
+    "HookRegistry",
+    "RegistryEntry",
+    "AntigravityHook",
+    "AntigravityEnvelopeAdapter",
+]
+

cave_harness-0.1.0/cave/_llegos/__init__.py

@@ -0,0 +1,3 @@
+"""llegos - Actor model for multi-agent systems (LGPL-3.0)"""
+from .llegos import Actor, Message, Network, Object, message_send, message_propagate
+__all__ = ["Actor", "Message", "Network", "Object", "message_send", "message_propagate"]