hexel 0.1.0__tar.gz

hexel-0.1.0/.gitignore

@@ -0,0 +1,3 @@
+.venv/
+__pycache__/
+*.pyc

hexel-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hexel Studio
+
+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.

hexel-0.1.0/Makefile

@@ -0,0 +1,47 @@
+.PHONY: generate sync-specs install dev test clean
+
+VENV := .venv
+PYTHON := $(VENV)/bin/python
+COMPUTE_REPO := $(HOME)/compute
+REGISTRY_REPO := $(HOME)/agent-registry
+
+# Generate SDK from specs
+generate:
+	$(PYTHON) generator/generate.py
+
+# Sync specs from product repos then generate
+sync-specs:
+	@echo "→ Syncing compute spec..."
+	cd $(COMPUTE_REPO)/compute-controller && make swagger
+	cp $(COMPUTE_REPO)/specs/json/compute-api.json specs/
+	@echo "→ Syncing agentd spec..."
+	cp $(COMPUTE_REPO)/specs/json/agentd-api.json specs/
+	@echo "→ Syncing registry spec..."
+	cp $(REGISTRY_REPO)/specs/json/agent-registry-api.json specs/
+	@echo "✓ Specs synced"
+	$(MAKE) generate
+
+# Setup venv and install deps
+install:
+	uv venv
+	$(VENV)/bin/pip install -e ".[dev]"
+
+# Install dev deps (jinja2 for generator)
+dev:
+	$(VENV)/bin/pip install jinja2
+
+# Run tests
+test:
+	$(PYTHON) -m pytest tests/ -v
+
+# Verify imports work
+check:
+	$(PYTHON) -c "from hexel import Hexel; print('✅ hexel', __import__('hexel').__version__)"
+
+# Clean generated files
+clean:
+	rm -rf hexel/compute/_*.py hexel/compute/types.py hexel/compute/__init__.py
+	rm -f generator/ir.json
+
+# Full rebuild: sync specs + generate + check
+all: sync-specs check

hexel-0.1.0/PKG-INFO

@@ -0,0 +1,167 @@
+Metadata-Version: 2.4
+Name: hexel
+Version: 0.1.0
+Summary: Hexel Studio SDK — deploy and run AI agents
+Project-URL: Homepage, https://hexelstudio.com
+Project-URL: Documentation, https://docs.hexelstudio.com
+Project-URL: Repository, https://github.com/hexelstudio/python-sdk
+Project-URL: Changelog, https://docs.hexelstudio.com/changelog
+Author-email: Hexel Studio <support@hexelstudio.com>
+License: MIT
+License-File: LICENSE
+Keywords: agents,ai,code-execution,compute,hexel,sandbox
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: websockets>=12.0
+Provides-Extra: dev
+Requires-Dist: jinja2; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Hexel Python SDK
+
+The official Python SDK for [Hexel Studio](https://hexelstudio.com) — build, deploy, and run AI agents.
+
+## Install
+
+```bash
+pip install hexel
+```
+
+## Quick Start
+
+```python
+from hexel import Hexel
+
+client = Hexel(api_key="your_api_key")
+
+# Create a sandbox and execute code
+sandbox = client.compute.sandbox.create(tier="standard")
+print(sandbox)  # {"vm_id": "...", "state": "allocated", ...}
+
+# Register an agent
+agent = client.compute.agent.register(
+    name="my-agent",
+    image="ghcr.io/org/agent:v1",
+    capabilities=["chat", "streaming"],
+)
+
+# Deploy an agent
+instance = client.compute.instance.deploy(agent["id"], env={"MODEL": "gpt-4"})
+print(instance["endpoint"])  # https://zeal-isle-a620.compute.hexelstudio.com
+```
+
+## Authentication
+
+Two authentication methods are supported:
+
+```python
+# API Key (recommended for development)
+client = Hexel(api_key="studio_live_xxxx")
+
+# OAuth Client Credentials (recommended for production)
+client = Hexel(client_id="your_client_id", client_secret="your_client_secret")
+```
+
+Both methods exchange credentials for a short-lived STS token automatically. Tokens are cached and refreshed transparently.
+
+## Sandboxes
+
+Sandboxes are isolated execution environments allocated instantly.
+
+```python
+# Create
+sandbox = client.compute.sandbox.create(tier="standard")
+
+# Execute code (HTTP)
+result = client.compute.sandbox.execute(sandbox["vm_id"], code="print(1+1)", language="python")
+
+# List
+sandboxes = client.compute.sandbox.list()
+
+# Renew TTL
+client.compute.sandbox.renew(sandbox["vm_id"], ttl_seconds=3600)
+
+# Release
+client.compute.sandbox.release(sandbox["vm_id"], recycle=True)
+
+# Delete
+client.compute.sandbox.delete(sandbox["vm_id"])
+```
+
+## Agents
+
+Agents are Docker images registered in the Hexel registry.
+
+```python
+# Register
+agent = client.compute.agent.register(
+    name="fraud-detector",
+    image="ghcr.io/org/fraud-agent:v1",
+    capabilities=["fraud-detection"],
+)
+
+# List
+agents = client.compute.agent.list()
+
+# Get
+agent = client.compute.agent.get("agent-id")
+
+# Search
+results = client.compute.agent.search(q="fraud")
+
+# Delete
+client.compute.agent.delete("agent-id")
+```
+
+## Instances
+
+Instances are running deployments of agents with permanent endpoints.
+
+```python
+# Deploy
+instance = client.compute.instance.deploy("agent-id", env={"MODEL": "gpt-4"})
+
+# List
+instances = client.compute.instance.list()
+
+# Get
+instance = client.compute.instance.get("deployment-id")
+
+# Stop
+client.compute.instance.stop("deployment-id")
+
+# Redeploy
+client.compute.instance.redeploy("deployment-id")
+
+# Delete
+client.compute.instance.delete("deployment-id")
+```
+
+## Configuration
+
+```python
+client = Hexel(
+    api_key="...",
+)
+```
+
+## Requirements
+
+- Python 3.10+
+- `httpx` for HTTP
+- `websockets` for WebSocket connections
+
+## License
+
+MIT

hexel-0.1.0/README.md

@@ -0,0 +1,137 @@
+# Hexel Python SDK
+
+The official Python SDK for [Hexel Studio](https://hexelstudio.com) — build, deploy, and run AI agents.
+
+## Install
+
+```bash
+pip install hexel
+```
+
+## Quick Start
+
+```python
+from hexel import Hexel
+
+client = Hexel(api_key="your_api_key")
+
+# Create a sandbox and execute code
+sandbox = client.compute.sandbox.create(tier="standard")
+print(sandbox)  # {"vm_id": "...", "state": "allocated", ...}
+
+# Register an agent
+agent = client.compute.agent.register(
+    name="my-agent",
+    image="ghcr.io/org/agent:v1",
+    capabilities=["chat", "streaming"],
+)
+
+# Deploy an agent
+instance = client.compute.instance.deploy(agent["id"], env={"MODEL": "gpt-4"})
+print(instance["endpoint"])  # https://zeal-isle-a620.compute.hexelstudio.com
+```
+
+## Authentication
+
+Two authentication methods are supported:
+
+```python
+# API Key (recommended for development)
+client = Hexel(api_key="studio_live_xxxx")
+
+# OAuth Client Credentials (recommended for production)
+client = Hexel(client_id="your_client_id", client_secret="your_client_secret")
+```
+
+Both methods exchange credentials for a short-lived STS token automatically. Tokens are cached and refreshed transparently.
+
+## Sandboxes
+
+Sandboxes are isolated execution environments allocated instantly.
+
+```python
+# Create
+sandbox = client.compute.sandbox.create(tier="standard")
+
+# Execute code (HTTP)
+result = client.compute.sandbox.execute(sandbox["vm_id"], code="print(1+1)", language="python")
+
+# List
+sandboxes = client.compute.sandbox.list()
+
+# Renew TTL
+client.compute.sandbox.renew(sandbox["vm_id"], ttl_seconds=3600)
+
+# Release
+client.compute.sandbox.release(sandbox["vm_id"], recycle=True)
+
+# Delete
+client.compute.sandbox.delete(sandbox["vm_id"])
+```
+
+## Agents
+
+Agents are Docker images registered in the Hexel registry.
+
+```python
+# Register
+agent = client.compute.agent.register(
+    name="fraud-detector",
+    image="ghcr.io/org/fraud-agent:v1",
+    capabilities=["fraud-detection"],
+)
+
+# List
+agents = client.compute.agent.list()
+
+# Get
+agent = client.compute.agent.get("agent-id")
+
+# Search
+results = client.compute.agent.search(q="fraud")
+
+# Delete
+client.compute.agent.delete("agent-id")
+```
+
+## Instances
+
+Instances are running deployments of agents with permanent endpoints.
+
+```python
+# Deploy
+instance = client.compute.instance.deploy("agent-id", env={"MODEL": "gpt-4"})
+
+# List
+instances = client.compute.instance.list()
+
+# Get
+instance = client.compute.instance.get("deployment-id")
+
+# Stop
+client.compute.instance.stop("deployment-id")
+
+# Redeploy
+client.compute.instance.redeploy("deployment-id")
+
+# Delete
+client.compute.instance.delete("deployment-id")
+```
+
+## Configuration
+
+```python
+client = Hexel(
+    api_key="...",
+)
+```
+
+## Requirements
+
+- Python 3.10+
+- `httpx` for HTTP
+- `websockets` for WebSocket connections
+
+## License
+
+MIT

hexel-0.1.0/generator/generate.py

@@ -0,0 +1,110 @@
+#!/usr/bin/env python3
+"""
+Hexel SDK Generator
+
+Reads OpenAPI specs + overrides → builds IR → generates Python SDK.
+
+Usage:
+    python generator/generate.py
+"""
+import json
+import os
+import sys
+from pathlib import Path
+
+from jinja2 import Environment, FileSystemLoader
+
+from parser import build_from_files
+
+SPECS_DIR = "specs"
+OVERRIDES = "generator/overrides.json"
+OUTPUT_DIR = "hexel/compute"
+TEMPLATES_DIR = "generator/templates"
+
+# Type mapping: OpenAPI → Python
+TYPE_MAP = {
+    "string": "str",
+    "integer": "int",
+    "number": "float",
+    "boolean": "bool",
+    "object": "dict",
+    "any": "Any",
+}
+
+
+def python_type(t: str) -> str:
+    """Convert IR type to Python type annotation."""
+    if t.startswith("list["):
+        inner = t[5:-1]
+        return f"list[{python_type(inner)}]"
+    if t.startswith("dict["):
+        return t
+    return TYPE_MAP.get(t, t)
+
+
+def to_class_name(service_name: str) -> str:
+    """sandbox → SandboxClient"""
+    return service_name.capitalize() + "Client"
+
+
+def generate():
+    print("→ Parsing specs...")
+    ir = build_from_files(SPECS_DIR, OVERRIDES)
+
+    print(f"  Services: {list(ir['services'].keys())}")
+    print(f"  Types: {len(ir['types'])}")
+
+    # Setup Jinja
+    env = Environment(
+        loader=FileSystemLoader(TEMPLATES_DIR),
+        keep_trailing_newline=True,
+        trim_blocks=True,
+        lstrip_blocks=True,
+    )
+    env.filters["python_type"] = python_type
+
+    output = Path(OUTPUT_DIR)
+    output.mkdir(parents=True, exist_ok=True)
+
+    # Generate types.py
+    print("→ Generating types.py...")
+    types_tmpl = env.get_template("types.py.j2")
+    types_code = types_tmpl.render(types=ir["types"])
+    (output / "types.py").write_text(types_code)
+
+    # Generate service clients
+    service_tmpl = env.get_template("service.py.j2")
+    for service_name, service_def in ir["services"].items():
+        class_name = to_class_name(service_name)
+        has_ws = service_name in ir.get("websocket", {})
+
+        print(f"→ Generating _{service_name}.py ({class_name}, {len(service_def['methods'])} methods)...")
+        code = service_tmpl.render(
+            class_name=class_name,
+            description=service_def["description"],
+            methods=service_def["methods"],
+            has_ws=has_ws,
+        )
+        (output / f"_{service_name}.py").write_text(code)
+
+    # Generate __init__.py
+    print("→ Generating __init__.py...")
+    init_tmpl = env.get_template("compute_init.py.j2")
+    init_code = init_tmpl.render()
+    (output / "__init__.py").write_text(init_code)
+
+    # Write IR for debugging
+    ir_path = Path("generator/ir.json")
+    ir_path.write_text(json.dumps(ir, indent=2))
+    print(f"→ IR written to {ir_path}")
+
+    print(f"\n✅ Generated {len(ir['services'])} services + types in {OUTPUT_DIR}/")
+    print("   Files:")
+    for f in sorted(output.glob("*.py")):
+        lines = len(f.read_text().splitlines())
+        print(f"   {f.name:20s} {lines:4d} lines")
+
+
+if __name__ == "__main__":
+    os.chdir(Path(__file__).resolve().parent.parent)
+    generate()