tether-ai 0.2.0__tar.gz

tether_ai-0.2.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md
+recursive-include tether/static_ui *
+include tether/py.typed

tether_ai-0.2.0/PKG-INFO

@@ -0,0 +1,302 @@
+Metadata-Version: 2.4
+Name: tether-ai
+Version: 0.2.0
+Summary: Control your AI coding agents from your phone when you're away from your desk
+Author-email: Lars de Ridder <lars@xithing.io>
+Maintainer-email: Lars de Ridder <lars@xithing.io>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://gettether.dev
+Project-URL: Documentation, https://github.com/larsderidder/tether#readme
+Project-URL: Repository, https://github.com/larsderidder/tether
+Project-URL: Issues, https://github.com/larsderidder/tether/issues
+Project-URL: Changelog, https://github.com/larsderidder/tether/releases
+Keywords: ai,agent,claude,codex,remote,mobile,coding-assistant
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Web Environment
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: agent-tether[all]>=0.3.0
+Requires-Dist: agent-sessions>=0.1.0
+Requires-Dist: fastapi==0.110.0
+Requires-Dist: uvicorn==0.27.1
+Requires-Dist: pydantic==2.7.4
+Requires-Dist: structlog==24.4.0
+Requires-Dist: payload-redactor>=0.3.0
+Requires-Dist: anthropic>=0.39.0
+Requires-Dist: sqlmodel>=0.0.22
+Requires-Dist: alembic>=1.13
+Requires-Dist: claude-agent-sdk>=0.1.0
+Provides-Extra: dev
+Requires-Dist: black==24.4.2; extra == "dev"
+Requires-Dist: httpx==0.27.0; extra == "dev"
+Requires-Dist: pytest==8.2.2; extra == "dev"
+Requires-Dist: pytest-cov==5.0.0; extra == "dev"
+Requires-Dist: anyio[trio]>=4.0.0; extra == "dev"
+Requires-Dist: pytest-anyio>=0.0.0; extra == "dev"
+Provides-Extra: telegram
+Requires-Dist: python-telegram-bot>=20.0; extra == "telegram"
+Provides-Extra: slack
+Requires-Dist: slack-sdk>=3.27.0; extra == "slack"
+Provides-Extra: discord
+Requires-Dist: discord.py>=2.3.0; extra == "discord"
+Provides-Extra: litellm
+Requires-Dist: litellm>=1.0; extra == "litellm"
+Provides-Extra: mcp
+Requires-Dist: mcp>=0.1.0; extra == "mcp"
+
+# Tether Agent
+
+Control your AI coding agents from your phone when you're away from your desk.
+
+You start a coding agent, walk away for lunch, and come back to find it stuck waiting for input for an hour. Tether fixes that. Get notified when your agent needs you, respond from anywhere.
+
+## Features
+
+- **Local-first** — Runs on your machine, your data stays yours
+- **Multi-agent** — Supports Claude and Codex, more to come
+- **Web UI** — Monitor sessions from your phone or desktop
+- **External Agent API** — WebSocket and REST API for connecting any AI agent
+- **Messaging Platform Integrations** — Telegram, Slack, and Discord bridges
+- **MCP Server** — Model Context Protocol server for Claude Desktop and other MCP clients
+- **No API keys required** — Uses Claude / Codex local OAuth by default
+
+## Installation
+
+```bash
+pip install tether-ai
+```
+
+### Optional Platform Integrations
+
+Install platform-specific dependencies as needed:
+
+```bash
+# Telegram bridge
+pip install tether-ai[telegram]
+
+# Slack bridge
+pip install tether-ai[slack]
+
+# Discord bridge
+pip install tether-ai[discord]
+
+# All bridges
+pip install tether-ai[telegram,slack,discord]
+
+# Development tools
+pip install tether-ai[dev]
+```
+
+## Quick Start
+
+### Run the Agent Server
+
+```bash
+# Start the agent server
+tether-agent
+```
+
+Then open http://localhost:8787 in your browser.
+
+### Use with MCP (Claude Desktop)
+
+Add Tether as an MCP server in your Claude Desktop config:
+
+```json
+{
+  "mcpServers": {
+    "tether": {
+      "command": "python",
+      "args": ["-m", "tether.mcp_server.server"],
+      "env": {
+        "TETHER_API_URL": "http://localhost:8787"
+      }
+    }
+  }
+}
+```
+
+## Configuration
+
+Set environment variables to configure:
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `TETHER_AGENT_HOST` | Host to bind to | `0.0.0.0` |
+| `TETHER_AGENT_PORT` | Port to listen on | `8787` |
+| `TETHER_AGENT_TOKEN` | Auth token (optional; if set, API/UI/MCP require bearer auth) | — |
+| `TETHER_AGENT_DEV_MODE` | Enable dev mode (no token required) | `0` |
+| `TETHER_AGENT_ADAPTER` | AI adapter to use | `claude_auto` |
+| `TETHER_AGENT_DATA_DIR` | Data storage directory | `./data` |
+
+### AI Adapters
+
+| Adapter | Description |
+|---------|-------------|
+| `claude_auto` | Auto-detect (prefer OAuth, fallback to API key) |
+| `claude_subprocess` | Claude via Agent SDK in subprocess (CLI OAuth) |
+| `claude_api` | Claude via API key (set `ANTHROPIC_API_KEY`) |
+| `codex_sdk_sidecar` | Codex via sidecar |
+
+### Messaging Platform Bridges
+
+Configure bridges to get notifications on your preferred platform:
+
+#### Telegram
+
+```bash
+export TELEGRAM_BOT_TOKEN="your_bot_token"
+export TELEGRAM_FORUM_GROUP_ID="your_group_id"
+```
+
+#### Slack
+
+```bash
+export SLACK_BOT_TOKEN="xoxb-your-token"
+export SLACK_CHANNEL_ID="C01234567"
+```
+
+#### Discord
+
+```bash
+export DISCORD_BOT_TOKEN="your_bot_token"
+export DISCORD_CHANNEL_ID="1234567890"
+```
+
+## External Agent API
+
+Tether exposes a WebSocket and REST API for external agents to connect and interact with users through messaging platforms.
+
+### REST API Endpoints
+
+#### Create a Session
+
+```bash
+POST /external/sessions
+Content-Type: application/json
+
+{
+  "agent_metadata": {
+    "name": "My Custom Agent",
+    "type": "custom",
+    "icon": "🤖",
+    "workspace": "my-workspace"
+  },
+  "session_name": "Code Review Task",
+  "platform": "telegram"
+}
+```
+
+Response:
+```json
+{
+  "session_id": "sess_abc123",
+  "platform": "telegram",
+  "thread_info": {
+    "thread_id": "123456",
+    "platform": "telegram"
+  }
+}
+```
+
+#### Send Output
+
+```bash
+POST /external/sessions/{session_id}/output
+Content-Type: application/json
+
+{
+  "text": "Agent output text here",
+  "metadata": {}
+}
+```
+
+#### Request Approval
+
+```bash
+POST /external/sessions/{session_id}/approval
+Content-Type: application/json
+
+{
+  "title": "Approve Changes?",
+  "description": "Ready to commit these changes",
+  "options": ["Approve", "Reject", "Review"]
+}
+```
+
+#### Check for Input
+
+```bash
+GET /external/sessions/{session_id}/input?timeout=30
+```
+
+Response:
+```json
+{
+  "type": "human_input",
+  "data": {
+    "text": "User's message",
+    "timestamp": "2025-01-01T12:00:00Z"
+  }
+}
+```
+
+### WebSocket API
+
+Connect to `/external/sessions/{session_id}/ws` for bidirectional communication:
+
+**Agent → Tether events:**
+- `output`: Send text output to user
+- `approval_request`: Request user approval
+- `status`: Update agent status (thinking, executing, done, error)
+
+**Tether → Agent events:**
+- `human_input`: User sent a message
+- `approval_response`: User responded to approval request
+
+Example WebSocket message:
+```json
+{
+  "type": "output",
+  "data": {
+    "text": "Processing your request...",
+    "metadata": {}
+  }
+}
+```
+
+## Development
+
+### Run Tests
+
+```bash
+pytest tests/
+```
+
+### Database Migrations
+
+```bash
+# Create a new migration
+alembic revision --autogenerate -m "description"
+
+# Apply migrations
+alembic upgrade head
+```
+
+## Documentation
+
+For full documentation, see [github.com/larsderidder/tether](https://github.com/larsderidder/tether).
+
+## License
+
+Apache 2.0. See [LICENSE](https://github.com/larsderidder/tether/blob/main/LICENSE) for details.

tether_ai-0.2.0/README.md

@@ -0,0 +1,246 @@
+# Tether Agent
+
+Control your AI coding agents from your phone when you're away from your desk.
+
+You start a coding agent, walk away for lunch, and come back to find it stuck waiting for input for an hour. Tether fixes that. Get notified when your agent needs you, respond from anywhere.
+
+## Features
+
+- **Local-first** — Runs on your machine, your data stays yours
+- **Multi-agent** — Supports Claude and Codex, more to come
+- **Web UI** — Monitor sessions from your phone or desktop
+- **External Agent API** — WebSocket and REST API for connecting any AI agent
+- **Messaging Platform Integrations** — Telegram, Slack, and Discord bridges
+- **MCP Server** — Model Context Protocol server for Claude Desktop and other MCP clients
+- **No API keys required** — Uses Claude / Codex local OAuth by default
+
+## Installation
+
+```bash
+pip install tether-ai
+```
+
+### Optional Platform Integrations
+
+Install platform-specific dependencies as needed:
+
+```bash
+# Telegram bridge
+pip install tether-ai[telegram]
+
+# Slack bridge
+pip install tether-ai[slack]
+
+# Discord bridge
+pip install tether-ai[discord]
+
+# All bridges
+pip install tether-ai[telegram,slack,discord]
+
+# Development tools
+pip install tether-ai[dev]
+```
+
+## Quick Start
+
+### Run the Agent Server
+
+```bash
+# Start the agent server
+tether-agent
+```
+
+Then open http://localhost:8787 in your browser.
+
+### Use with MCP (Claude Desktop)
+
+Add Tether as an MCP server in your Claude Desktop config:
+
+```json
+{
+  "mcpServers": {
+    "tether": {
+      "command": "python",
+      "args": ["-m", "tether.mcp_server.server"],
+      "env": {
+        "TETHER_API_URL": "http://localhost:8787"
+      }
+    }
+  }
+}
+```
+
+## Configuration
+
+Set environment variables to configure:
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `TETHER_AGENT_HOST` | Host to bind to | `0.0.0.0` |
+| `TETHER_AGENT_PORT` | Port to listen on | `8787` |
+| `TETHER_AGENT_TOKEN` | Auth token (optional; if set, API/UI/MCP require bearer auth) | — |
+| `TETHER_AGENT_DEV_MODE` | Enable dev mode (no token required) | `0` |
+| `TETHER_AGENT_ADAPTER` | AI adapter to use | `claude_auto` |
+| `TETHER_AGENT_DATA_DIR` | Data storage directory | `./data` |
+
+### AI Adapters
+
+| Adapter | Description |
+|---------|-------------|
+| `claude_auto` | Auto-detect (prefer OAuth, fallback to API key) |
+| `claude_subprocess` | Claude via Agent SDK in subprocess (CLI OAuth) |
+| `claude_api` | Claude via API key (set `ANTHROPIC_API_KEY`) |
+| `codex_sdk_sidecar` | Codex via sidecar |
+
+### Messaging Platform Bridges
+
+Configure bridges to get notifications on your preferred platform:
+
+#### Telegram
+
+```bash
+export TELEGRAM_BOT_TOKEN="your_bot_token"
+export TELEGRAM_FORUM_GROUP_ID="your_group_id"
+```
+
+#### Slack
+
+```bash
+export SLACK_BOT_TOKEN="xoxb-your-token"
+export SLACK_CHANNEL_ID="C01234567"
+```
+
+#### Discord
+
+```bash
+export DISCORD_BOT_TOKEN="your_bot_token"
+export DISCORD_CHANNEL_ID="1234567890"
+```
+
+## External Agent API
+
+Tether exposes a WebSocket and REST API for external agents to connect and interact with users through messaging platforms.
+
+### REST API Endpoints
+
+#### Create a Session
+
+```bash
+POST /external/sessions
+Content-Type: application/json
+
+{
+  "agent_metadata": {
+    "name": "My Custom Agent",
+    "type": "custom",
+    "icon": "🤖",
+    "workspace": "my-workspace"
+  },
+  "session_name": "Code Review Task",
+  "platform": "telegram"
+}
+```
+
+Response:
+```json
+{
+  "session_id": "sess_abc123",
+  "platform": "telegram",
+  "thread_info": {
+    "thread_id": "123456",
+    "platform": "telegram"
+  }
+}
+```
+
+#### Send Output
+
+```bash
+POST /external/sessions/{session_id}/output
+Content-Type: application/json
+
+{
+  "text": "Agent output text here",
+  "metadata": {}
+}
+```
+
+#### Request Approval
+
+```bash
+POST /external/sessions/{session_id}/approval
+Content-Type: application/json
+
+{
+  "title": "Approve Changes?",
+  "description": "Ready to commit these changes",
+  "options": ["Approve", "Reject", "Review"]
+}
+```
+
+#### Check for Input
+
+```bash
+GET /external/sessions/{session_id}/input?timeout=30
+```
+
+Response:
+```json
+{
+  "type": "human_input",
+  "data": {
+    "text": "User's message",
+    "timestamp": "2025-01-01T12:00:00Z"
+  }
+}
+```
+
+### WebSocket API
+
+Connect to `/external/sessions/{session_id}/ws` for bidirectional communication:
+
+**Agent → Tether events:**
+- `output`: Send text output to user
+- `approval_request`: Request user approval
+- `status`: Update agent status (thinking, executing, done, error)
+
+**Tether → Agent events:**
+- `human_input`: User sent a message
+- `approval_response`: User responded to approval request
+
+Example WebSocket message:
+```json
+{
+  "type": "output",
+  "data": {
+    "text": "Processing your request...",
+    "metadata": {}
+  }
+}
+```
+
+## Development
+
+### Run Tests
+
+```bash
+pytest tests/
+```
+
+### Database Migrations
+
+```bash
+# Create a new migration
+alembic revision --autogenerate -m "description"
+
+# Apply migrations
+alembic upgrade head
+```
+
+## Documentation
+
+For full documentation, see [github.com/larsderidder/tether](https://github.com/larsderidder/tether).
+
+## License
+
+Apache 2.0. See [LICENSE](https://github.com/larsderidder/tether/blob/main/LICENSE) for details.

tether_ai-0.2.0/pyproject.toml

@@ -0,0 +1,114 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tether-ai"
+version = "0.2.0"
+description = "Control your AI coding agents from your phone when you're away from your desk"
+readme = "README.md"
+license = "Apache-2.0"
+requires-python = ">=3.10"
+authors = [
+  { name = "Lars de Ridder", email = "lars@xithing.io" },
+]
+maintainers = [
+  { name = "Lars de Ridder", email = "lars@xithing.io" },
+]
+keywords = [
+  "ai",
+  "agent",
+  "claude",
+  "codex",
+  "remote",
+  "mobile",
+  "coding-assistant",
+]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Web Environment",
+  "Framework :: FastAPI",
+  "Intended Audience :: Developers",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Software Development",
+  "Topic :: Software Development :: Quality Assurance",
+  "Typing :: Typed",
+]
+dependencies = [
+  "agent-tether[all]>=0.3.0",
+  "agent-sessions>=0.1.0",
+  "fastapi==0.110.0",
+  "uvicorn==0.27.1",
+  "pydantic==2.7.4",
+  "structlog==24.4.0",
+  "payload-redactor>=0.3.0",
+  "anthropic>=0.39.0",
+  "sqlmodel>=0.0.22",
+  "alembic>=1.13",
+  "claude-agent-sdk>=0.1.0",
+]
+
+[project.optional-dependencies]
+dev = [
+  "black==24.4.2",
+  "httpx==0.27.0",
+  "pytest==8.2.2",
+  "pytest-cov==5.0.0",
+  "anyio[trio]>=4.0.0",
+  "pytest-anyio>=0.0.0",
+]
+telegram = [
+  "python-telegram-bot>=20.0",
+]
+slack = [
+  "slack-sdk>=3.27.0",
+]
+discord = [
+  "discord.py>=2.3.0",
+]
+litellm = [
+  "litellm>=1.0",
+]
+mcp = [
+  "mcp>=0.1.0",
+]
+
+[project.urls]
+Homepage = "https://gettether.dev"
+Documentation = "https://github.com/larsderidder/tether#readme"
+Repository = "https://github.com/larsderidder/tether"
+Issues = "https://github.com/larsderidder/tether/issues"
+Changelog = "https://github.com/larsderidder/tether/releases"
+
+[project.scripts]
+tether = "tether.cli:main"
+tether-agent = "tether.cli:_start_compat"
+tether-mcp = "tether.mcp_server.server:main"
+
+[tool.setuptools.packages.find]
+include = ["tether*"]
+
+[tool.setuptools.package-data]
+tether = ["static_ui/**/*", "py.typed"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.coverage.run]
+source = ["tether"]
+omit = ["*/tests/*"]
+
+[tool.coverage.report]
+exclude_lines = [
+  "pragma: no cover",
+  "if TYPE_CHECKING:",
+  "raise NotImplementedError",
+]
+
+[tool.black]
+line-length = 88
+target-version = ["py310"]

tether_ai-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+