ts-proxy 1.1.0__tar.gz

ts_proxy-1.1.0/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.3
+Name: ts-proxy
+Version: 1.1.0
+Summary: Serverless Sovereign MCP Proxy for Tailscale Network Management
+Author: KpihX
+Author-email: KpihX <kapoivha@gmail.com>
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pydantic>=2.10.6
+Requires-Dist: rich>=13.9.4
+Requires-Dist: typer>=0.15.1
+Requires-Dist: pyyaml>=6.0.1
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# ts-proxy
+
+```text
+    ╔╦╗┌─┐  ╔═╗╦═╗╔═╗═╗ ╦╦ ╦
+     ║ └─┐  ╠═╝╠╦╝║ ║╔╩╦╝╚╦╝
+     ╩ └─┘  ╩  ╩╚═╚═╝╩ ╚═ ╩ 
+   Sovereign Tailscale Proxy
+```
+
+> Serverless Sovereign MCP Proxy for Tailscale Network Management (v1.2.2)
+> **0% Hardcode · 100% Flexibility · Strict Alphabetical Order**
+
+Part of the **KpihX-Labs** architecture, `ts-proxy` is a secure, ephemeral CLI tool that runs inside the `docker-host` abstraction layer. It acts as an intelligent intermediary between your AI agents (running on Ubuntu/Mac) and the global Tailscale API.
+
+## Core Principles
+
+1. **JSON-RPC 2.0 Paradigm**: All business logic commands follow a strict payload-driven model, decoupling API evolution from CLI flag stability.
+2. **Dynamic Sovereign Documentation**: Built-in introspection engine extracts rich docstrings and recursive JSON type schemas directly from the source code.
+3. **Strict Alphabetical Ordering**: To ensure maintainability and predictable CLI UX, all API methods and CLI commands are sorted alphabetically.
+4. **Zero Hardcoding**: All versions, paths, and configurations are dynamically resolved or extracted from `pyproject.toml` and `config.yaml`.
+5. **Human-In-The-Loop (HITL) Validation**: Critical operations require explicit web-based approval before execution.
+
+## Documentation Stack
+
+- **[CONTRACT.md](CONTRACT.md)**: The total rigorous usage contract (Prod Facet) and sovereign development guide (Dev Facet). **Source of truth for technical specs.**
+- **[AGENTS.md](AGENTS.md)**: High-level instructions and mantras for AI agents assisting in this repository.
+- **[CHANGELOG.md](CHANGELOG.md)**: Evolution history and versioned releases.
+
+## Quick Start Visual
+```text
+   AI Agent ──▶ ts-proxy ──▶ [Docker: Core] ──▶ Tailscale API
+                │             │
+                │             └─▶ [HITL Approval Web UI]
+                └─▶ [Autosave: /tmp/ts-proxy/]
+```
+
+## Usage
+
+### Discovery & Help
+Explore the capabilities and expected JSON schemas directly from your terminal:
+
+```bash
+# List all available commands with summaries and schemas
+ts-proxy do --help
+
+# Get detailed documentation and examples for a specific command
+ts-proxy do get-device --help
+```
+
+### Business Operations (`do` namespace)
+Commands accept a single JSON payload or a path to a JSON file.
+
+```bash
+# Simple read operation
+ts-proxy do list-devices
+
+# Targeted query with JSON payload
+ts-proxy do get-device '{"device_id": "12345"}'
+```
+
+### Administrative Control (`admin` namespace)
+
+```bash
+# Start a new session
+ts-proxy admin login
+
+# Check session status
+ts-proxy admin status
+```
+
+## Architecture
+
+- **Core**: Python 3.12 (uv)
+- **Validation**: Pydantic V2 (Strict Payload Firewall)
+- **Engine**: Httpx (Async), Typer (CLI Interface)
+- **UI**: Glassmorphism Web HITL (Approved by KpihX)
+- **Runtime**: Ephemeral Docker Container (`ts-proxy:latest`)

ts_proxy-1.1.0/README.md

@@ -0,0 +1,77 @@
+# ts-proxy
+
+```text
+    ╔╦╗┌─┐  ╔═╗╦═╗╔═╗═╗ ╦╦ ╦
+     ║ └─┐  ╠═╝╠╦╝║ ║╔╩╦╝╚╦╝
+     ╩ └─┘  ╩  ╩╚═╚═╝╩ ╚═ ╩ 
+   Sovereign Tailscale Proxy
+```
+
+> Serverless Sovereign MCP Proxy for Tailscale Network Management (v1.2.2)
+> **0% Hardcode · 100% Flexibility · Strict Alphabetical Order**
+
+Part of the **KpihX-Labs** architecture, `ts-proxy` is a secure, ephemeral CLI tool that runs inside the `docker-host` abstraction layer. It acts as an intelligent intermediary between your AI agents (running on Ubuntu/Mac) and the global Tailscale API.
+
+## Core Principles
+
+1. **JSON-RPC 2.0 Paradigm**: All business logic commands follow a strict payload-driven model, decoupling API evolution from CLI flag stability.
+2. **Dynamic Sovereign Documentation**: Built-in introspection engine extracts rich docstrings and recursive JSON type schemas directly from the source code.
+3. **Strict Alphabetical Ordering**: To ensure maintainability and predictable CLI UX, all API methods and CLI commands are sorted alphabetically.
+4. **Zero Hardcoding**: All versions, paths, and configurations are dynamically resolved or extracted from `pyproject.toml` and `config.yaml`.
+5. **Human-In-The-Loop (HITL) Validation**: Critical operations require explicit web-based approval before execution.
+
+## Documentation Stack
+
+- **[CONTRACT.md](CONTRACT.md)**: The total rigorous usage contract (Prod Facet) and sovereign development guide (Dev Facet). **Source of truth for technical specs.**
+- **[AGENTS.md](AGENTS.md)**: High-level instructions and mantras for AI agents assisting in this repository.
+- **[CHANGELOG.md](CHANGELOG.md)**: Evolution history and versioned releases.
+
+## Quick Start Visual
+```text
+   AI Agent ──▶ ts-proxy ──▶ [Docker: Core] ──▶ Tailscale API
+                │             │
+                │             └─▶ [HITL Approval Web UI]
+                └─▶ [Autosave: /tmp/ts-proxy/]
+```
+
+## Usage
+
+### Discovery & Help
+Explore the capabilities and expected JSON schemas directly from your terminal:
+
+```bash
+# List all available commands with summaries and schemas
+ts-proxy do --help
+
+# Get detailed documentation and examples for a specific command
+ts-proxy do get-device --help
+```
+
+### Business Operations (`do` namespace)
+Commands accept a single JSON payload or a path to a JSON file.
+
+```bash
+# Simple read operation
+ts-proxy do list-devices
+
+# Targeted query with JSON payload
+ts-proxy do get-device '{"device_id": "12345"}'
+```
+
+### Administrative Control (`admin` namespace)
+
+```bash
+# Start a new session
+ts-proxy admin login
+
+# Check session status
+ts-proxy admin status
+```
+
+## Architecture
+
+- **Core**: Python 3.12 (uv)
+- **Validation**: Pydantic V2 (Strict Payload Firewall)
+- **Engine**: Httpx (Async), Typer (CLI Interface)
+- **UI**: Glassmorphism Web HITL (Approved by KpihX)
+- **Runtime**: Ephemeral Docker Container (`ts-proxy:latest`)

ts_proxy-1.1.0/pyproject.toml

@@ -0,0 +1,35 @@
+[project]
+name = "ts-proxy"
+version = "1.1.0"
+description = "Serverless Sovereign MCP Proxy for Tailscale Network Management"
+readme = "README.md"
+authors = [
+    { name = "KpihX", email = "kapoivha@gmail.com" }
+]
+requires-python = ">=3.12"
+dependencies = [
+    "httpx>=0.28.1",
+    "pydantic>=2.10.6",
+    "rich>=13.9.4",
+    "typer>=0.15.1",
+    "pyyaml>=6.0.1",
+]
+
+[project.scripts]
+ts-proxy = "ts_proxy.cli:app"
+
+[build-system]
+requires = ["uv_build>=0.10.3,<0.11.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0.2",
+    "pytest-asyncio>=0.23.5",
+    "pytest-cov>=7.0.0",
+    "ruff>=0.9.0",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]

ts_proxy-1.1.0/src/ts_proxy/__init__.py

@@ -0,0 +1,5 @@
+"""
+ts_proxy: Serverless Sovereign MCP Proxy for Tailscale Network Management.
+"""
+
+__version__ = "0.1.0"