agentwire-dev 1.0.3__tar.gz

agentwire_dev-1.0.3/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,42 @@
+---
+name: Bug Report
+about: Report something that isn't working correctly
+title: '[Bug] '
+labels: bug
+assignees: ''
+---
+
+## Description
+
+A clear description of the bug.
+
+## Steps to Reproduce
+
+1.
+2.
+3.
+
+## Expected Behavior
+
+What should happen.
+
+## Actual Behavior
+
+What actually happens.
+
+## Environment
+
+- **OS:** (e.g., macOS 14.2, Ubuntu 22.04)
+- **Python:** (e.g., 3.11.5)
+- **AgentWire version:** (run `agentwire --version`)
+- **Agent:** (Claude Code / OpenCode / Other)
+
+## Logs
+
+```
+Paste relevant logs here (check ~/.agentwire/logs/)
+```
+
+## Additional Context
+
+Any other information that might help.

agentwire_dev-1.0.3/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,23 @@
+---
+name: Feature Request
+about: Suggest a new feature or improvement
+title: '[Feature] '
+labels: enhancement
+assignees: ''
+---
+
+## Problem
+
+What problem does this feature solve? What's the use case?
+
+## Proposed Solution
+
+Describe the feature you'd like to see.
+
+## Alternatives Considered
+
+Have you considered any alternative solutions or workarounds?
+
+## Additional Context
+
+Any mockups, examples, or references that help explain the feature.

agentwire_dev-1.0.3/.github/ISSUE_TEMPLATE/question.md

@@ -0,0 +1,22 @@
+---
+name: Question
+about: Ask a question about using AgentWire
+title: '[Question] '
+labels: question
+assignees: ''
+---
+
+## Question
+
+What would you like to know?
+
+## Context
+
+- What are you trying to accomplish?
+- What have you already tried?
+- Relevant configuration or setup details
+
+## Environment (if relevant)
+
+- **OS:**
+- **AgentWire version:**

agentwire_dev-1.0.3/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,45 @@
+<!--
+Thanks for contributing to AgentWire!
+
+Before submitting, please make sure:
+
+1. You've read the CONTRIBUTING guide: https://github.com/dotdevdotdev/agentwire-dev/blob/main/CONTRIBUTING.md
+2. You've run `uvx ruff check agentwire/` with no errors
+3. You've tested your changes locally
+4. For bug fixes: include a test that would have caught the bug
+5. For new features: include tests and update docs if needed
+
+By submitting this PR, you agree to the Contributor License Agreement:
+https://github.com/dotdevdotdev/agentwire-dev/blob/main/CLA.md
+-->
+
+## Summary
+
+<!-- What's the purpose of this change? What problem does it solve? -->
+
+## Type of Change
+
+- [ ] 🐛 Bug fix (non-breaking change that fixes an issue)
+- [ ] ✨ New feature (non-breaking change that adds functionality)
+- [ ] 💥 Breaking change (fix or feature that would cause existing functionality to change)
+- [ ] 📚 Documentation (changes to docs only)
+- [ ] 🧹 Refactor (code change that neither fixes a bug nor adds a feature)
+
+## Test Plan
+
+<!--
+How did you verify this works? Examples:
+- "Ran `agentwire say 'test'` and confirmed audio played"
+- "Added unit test in test_foo.py"
+- "Tested manually with screenshot below"
+
+If you leave this empty, your PR will likely need revision.
+-->
+
+## Screenshots
+
+<!-- If this changes UI (portal, CLI output), include before/after screenshots -->
+
+## Related Issues
+
+<!-- Link any related issues: "Fixes #123" or "Related to #456" -->

agentwire_dev-1.0.3/.github/workflows/ci.yml

@@ -0,0 +1,28 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --dev
+
+      - name: Run ruff linter
+        run: uvx ruff check agentwire/
+
+      - name: Run ruff formatter check
+        run: uvx ruff format --check agentwire/

agentwire_dev-1.0.3/.gitignore

@@ -0,0 +1,52 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project specific
+*.log
+.env
+.env.*
+
+# Voice clones (user-specific, not distributed)
+# Note: /voices/ ignores root only; agentwire/voices/ contains bundled synthetic voices
+/voices/
+
+.agentwire.yml
+
+# Test outputs
+test_*.wav
+test_output*.wav
+.agentwire/

agentwire_dev-1.0.3/CHANGELOG.md

@@ -0,0 +1,69 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+- AGPL v3 licensing with CLA for dual-licensing model
+- GitHub issue templates (bug report, feature request, question)
+- Pull request template
+- Security policy (SECURITY.md)
+- Code of Conduct
+- GitHub Actions CI workflow for linting
+
+## [1.0.0] - 2026-01-19
+
+Initial public release of AgentWire.
+
+### Added
+
+- **Desktop Control Center** - WinBox-powered window management with draggable/resizable session windows
+- **Session Windows** - Monitor mode (read-only output) or Terminal mode (full xterm.js) per session
+- **Push-to-Talk Voice** - Hold to speak, release to send transcription from any device
+- **TTS Playback** - Agent responses spoken back via browser audio with smart routing
+- **Multi-Device Access** - Control sessions from phone, tablet, or laptop on your network
+- **Git Worktrees** - Multiple agents work the same project in parallel on separate branches
+- **Remote Machines** - Orchestrate Claude Code sessions on remote servers via SSH
+- **Safety Hooks** - 300+ dangerous command patterns blocked (rm -rf, git push --force, secret exposure)
+- **Session Roles** - Orchestrator sessions coordinate voice, workers execute focused tasks
+- **Permission Hooks** - Claude Code integration for permission dialogs in the portal
+
+### CLI Commands
+
+- `agentwire init` - Interactive setup wizard
+- `agentwire portal start/stop/status` - Portal management
+- `agentwire tts start/stop/status` - TTS server management
+- `agentwire stt start/stop/status` - STT server management
+- `agentwire new/list/kill/send/output` - Session management
+- `agentwire spawn/split/detach/jump` - Pane management
+- `agentwire say` - TTS with smart audio routing
+- `agentwire safety check/status/logs` - Security diagnostics
+- `agentwire machine add/remove/list` - Remote machine management
+- `agentwire tunnels up/down/status` - SSH tunnel management
+- `agentwire history list/show/resume` - Session history
+- `agentwire doctor` - Auto-diagnose and fix issues
+- `agentwire generate-certs` - SSL certificate generation
+
+### Security
+
+- Damage control hooks protecting against 300+ dangerous command patterns
+- Zero-access paths for credentials, SSH keys, and API tokens
+- Read-only paths for system configs
+- No-delete paths for session and mission files
+- Audit logging for all security decisions
+
+### Documentation
+
+- Comprehensive README with platform-specific installation instructions
+- Architecture documentation
+- Troubleshooting guide
+- TTS setup guide
+- Remote machines guide
+- Security documentation
+
+[1.0.0]: https://github.com/dotdevdotdev/agentwire-dev/releases/tag/v1.0.0

agentwire_dev-1.0.3/CLA.md

@@ -0,0 +1,54 @@
+# Contributor License Agreement
+
+Thank you for your interest in contributing to AgentWire ("Project"). This Contributor License Agreement ("Agreement") documents the rights granted by contributors to the Project.
+
+## Why a CLA?
+
+AgentWire uses a dual-licensing model: the code is available under AGPL v3 for open source use, and under a commercial license for organizations that prefer not to comply with AGPL terms. To maintain this model and protect the project's sustainability, we need contributors to grant us certain rights.
+
+## Agreement
+
+By submitting a contribution (code, documentation, or other materials) to this Project, you agree to the following terms:
+
+### 1. Definitions
+
+- **"You"** means the individual or legal entity submitting a Contribution.
+- **"Contribution"** means any original work of authorship, including modifications or additions to existing work, that you submit to the Project.
+
+### 2. Grant of Copyright License
+
+You grant to the Project maintainers and to recipients of software distributed by the Project a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to:
+- Reproduce, prepare derivative works of, publicly display, publicly perform, sublicense, and distribute your Contributions and such derivative works.
+- Re-license the Contribution under any license, including proprietary licenses.
+
+### 3. Grant of Patent License
+
+You grant to the Project maintainers and to recipients of software distributed by the Project a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Contribution.
+
+### 4. Representations
+
+You represent that:
+- You are legally entitled to grant the above licenses.
+- Each Contribution is your original creation OR you have sufficient rights to submit the Contribution.
+- Your Contribution does not violate any third-party rights.
+- If your employer has rights to intellectual property you create, you have received permission to make Contributions on behalf of that employer, or your employer has waived such rights.
+
+### 5. No Obligation
+
+You understand that:
+- The Project is under no obligation to accept or include your Contribution.
+- You are not expected to provide support for your Contributions.
+
+### 6. Attribution
+
+The Project will maintain a record of all contributors. You may be credited in release notes or other project documentation.
+
+## How to Sign
+
+By submitting a pull request to this repository, you agree to the terms of this CLA. No separate signature is required.
+
+If you are contributing on behalf of your employer, please ensure you have the necessary permissions.
+
+## Questions?
+
+If you have questions about this CLA, please open an issue.

agentwire_dev-1.0.3/CODE_OF_CONDUCT.md

@@ -0,0 +1,46 @@
+# Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+- Showing empathy towards other community members
+
+Examples of unacceptable behavior:
+
+- The use of sexualized language or imagery, and sexual attention or advances
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information without explicit permission
+- Other conduct which could reasonably be considered inappropriate
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the project team at conduct@agentwire.dev.
+
+All complaints will be reviewed and investigated promptly and fairly.
+
+Project maintainers are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org),
+version 2.0.

agentwire_dev-1.0.3/CONTRIBUTING.md

@@ -0,0 +1,184 @@
+# Contributing to AgentWire
+
+Thank you for your interest in contributing to AgentWire!
+
+## Contributor License Agreement
+
+By submitting a pull request, you agree to the terms of our [Contributor License Agreement](CLA.md). This allows us to maintain our dual-licensing model (AGPL v3 + commercial) while accepting community contributions.
+
+## Development Setup
+
+### Prerequisites
+
+- Python 3.10+
+- [uv](https://github.com/astral-sh/uv) - Fast Python package manager
+- tmux
+
+### Quick Start
+
+```bash
+# Clone the repository
+git clone https://github.com/dotdevdotdev/agentwire-dev.git
+cd agentwire-dev
+
+# Install in development mode
+uv pip install -e .
+
+# Run in development mode (picks up code changes instantly)
+agentwire portal start --dev
+
+# After structural changes (pyproject.toml, new files)
+agentwire rebuild
+```
+
+### Development Workflow
+
+```bash
+# Start development session
+agentwire dev
+
+# Run linter
+uvx ruff check agentwire/
+
+# Run with auto-fix
+uvx ruff check agentwire/ --fix
+```
+
+## Code Style
+
+### Linting
+
+We use [ruff](https://github.com/astral-sh/ruff) for linting. Configuration is in `pyproject.toml`:
+
+```toml
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W"]
+```
+
+### Docstrings
+
+Use Google-style docstrings for all public functions:
+
+```python
+def function_name(arg1: str, arg2: int = 10) -> dict:
+    """Brief one-line description.
+
+    Longer description if needed explaining purpose
+    and important details.
+
+    Args:
+        arg1: Description of arg1.
+        arg2: Description of arg2. Defaults to 10.
+
+    Returns:
+        Description of return value.
+
+    Raises:
+        ValueError: When arg1 is empty.
+    """
+```
+
+## Code Patterns
+
+### Use Utility Modules
+
+Common operations are centralized in `agentwire/utils/`:
+
+```python
+# Subprocess execution
+from agentwire.utils import run_command, run_command_check
+
+result = run_command(["ls", "-la"])
+if result.success:
+    print(result.stdout)
+
+# File I/O
+from agentwire.utils import load_json, save_json, load_yaml
+
+config = load_json(config_path, default={})
+save_json(config_path, data)
+
+# Paths
+from agentwire.utils import agentwire_dir, config_path, logs_dir
+
+base = agentwire_dir()  # ~/.agentwire/
+```
+
+### Error Handling
+
+Use the structured error classes in `agentwire/errors.py`:
+
+```python
+from agentwire.errors import AgentWireError
+
+raise AgentWireError(
+    what="Session not found",
+    why="No tmux session exists with that name",
+    how="Create a new session with 'agentwire new -s name'"
+)
+```
+
+### Configuration
+
+Use dataclasses for configuration (see `agentwire/config.py`):
+
+```python
+@dataclass
+class ServerConfig:
+    host: str = "0.0.0.0"
+    port: int = 8765
+```
+
+### Validation
+
+Use structured validation with suggestions (see `agentwire/validation.py`):
+
+```python
+def validate_config(config: Config) -> tuple[list[ConfigError], list[ConfigWarning]]:
+    """Returns errors and warnings with fix suggestions."""
+```
+
+## CLI First
+
+All session/machine logic lives in CLI commands (`__main__.py`). The web portal is a thin wrapper that:
+
+1. Calls CLI via `run_agentwire_cmd(["command", "args"])`
+2. Parses JSON output (`--json` flag)
+3. Adds WebSocket/real-time features
+
+When adding new functionality:
+1. Implement in CLI first with `--json` output
+2. Portal calls CLI, doesn't duplicate logic
+3. Never bypass CLI with direct tmux/subprocess calls
+
+## Project Structure
+
+```
+agentwire/
+├── __main__.py      # CLI commands (entry point)
+├── server.py        # WebSocket server
+├── config.py        # Configuration dataclasses
+├── errors.py        # Structured error classes
+├── validation.py    # Config validation
+├── utils/           # Shared utilities
+│   ├── subprocess.py  # Command execution
+│   ├── file_io.py     # JSON/YAML handling
+│   └── paths.py       # Path management
+├── agents/          # Agent implementations
+├── tts/             # Text-to-speech backends
+├── stt/             # Speech-to-text backends
+├── hooks/           # Claude Code hooks
+└── roles/           # Role instruction files
+```
+
+## Pull Request Guidelines
+
+1. Create a branch from `main`
+2. Make your changes
+3. Run `uvx ruff check agentwire/` - ensure no errors
+4. Commit with descriptive message
+5. Open PR with description of changes
+
+## Questions?
+
+Open an issue or start a discussion on GitHub.

agentwire_dev-1.0.3/Dockerfile.local

@@ -0,0 +1,75 @@
+# Local Self-Hosted TTS - Chatterbox with Voice Cloning + Whisper
+# Run on any machine with NVIDIA GPU + Docker
+#
+# Build:
+#   docker build -f Dockerfile.local -t agentwire-tts-local --build-arg HF_TOKEN=$HF_TOKEN .
+#
+# Run:
+#   docker run --gpus all -p 8100:8100 -v ~/.agentwire/voices:/voices agentwire-tts-local
+
+FROM nvidia/cuda:12.1.0-cudnn8-runtime-ubuntu22.04
+
+# Prevent interactive prompts during build
+ENV DEBIAN_FRONTEND=noninteractive
+
+# Install Python 3.11 and essentials
+RUN apt-get update && apt-get install -y \
+    python3.11 \
+    python3.11-dev \
+    python3-pip \
+    git \
+    ffmpeg \
+    && rm -rf /var/lib/apt/lists/*
+
+# Set Python 3.11 as default
+RUN update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 1 && \
+    update-alternatives --install /usr/bin/python python /usr/bin/python3.11 1
+
+# Upgrade pip
+RUN python3 -m pip install --upgrade pip
+
+# Set working directory
+WORKDIR /app
+
+# Install Python dependencies for HTTP server
+RUN pip install --no-cache-dir \
+    torch>=2.0.0 \
+    torchaudio>=2.0.0 \
+    fastapi \
+    uvicorn[standard] \
+    faster-whisper \
+    pydantic \
+    python-multipart
+
+# Install Chatterbox TTS
+RUN pip install --no-cache-dir git+https://github.com/resemble-ai/chatterbox.git
+
+# Copy AgentWire source code
+COPY agentwire/ ./agentwire/
+
+# Pre-download models (requires HF_TOKEN for Chatterbox)
+ARG HF_TOKEN
+ENV HF_TOKEN=${HF_TOKEN}
+ENV HF_HOME=/app/.cache/huggingface
+
+# Download Chatterbox model
+RUN python3 -c "from chatterbox.tts_turbo import ChatterboxTurboTTS; ChatterboxTurboTTS.from_pretrained(device='cpu')" || \
+    echo "Warning: Model download failed, will retry at runtime"
+
+# Download Whisper large-v3 model
+RUN python3 -c "from faster_whisper import WhisperModel; WhisperModel('large-v3', device='cpu', compute_type='int8')" || \
+    echo "Warning: Whisper download failed, will retry at runtime"
+
+# Copy bundled synthetic voices (can override at runtime with -v mount)
+# Includes: default, darren, jessica, lisa, may
+COPY agentwire/voices/ /voices/
+
+# Environment
+ENV PYTHONUNBUFFERED=1
+ENV VOICES_DIR=/voices
+
+# Expose HTTP port
+EXPOSE 8100
+
+# Run FastAPI server
+CMD ["python3", "-m", "uvicorn", "agentwire.tts_server:app", "--host", "0.0.0.0", "--port", "8100"]