agentwire-dev 1.38.0__tar.gz → 1.38.1__tar.gz

{agentwire_dev-1.38.0 → agentwire_dev-1.38.1}/CONTRIBUTING.md

@@ -125,7 +125,7 @@ Use dataclasses for configuration (see `agentwire/config.py`):
 ```python
 @dataclass
 class ServerConfig:
-    host: str = "0.0.0.0"
+    host: str = "127.0.0.1"
     port: int = 8765
 ```
 

{agentwire_dev-1.38.0 → agentwire_dev-1.38.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentwire-dev
-Version: 1.38.0
+Version: 1.38.1
 Summary: Multi-session voice web interface for AI coding agents
 Project-URL: Homepage, https://agentwire.dev
 Project-URL: Repository, https://github.com/dotdevdotdev/agentwire-dev
@@ -954,7 +954,7 @@ agentwire kill --pane 1           # Kill worker
 
 ```bash
 agentwire say "Hello"             # TTS (auto-routes to browser)
-agentwire alert "Done"            # Text notification (no audio)
+agentwire send -s NAME "Done"     # Inject text into a session
 agentwire listen start/stop       # Voice recording
 agentwire voiceclone list         # Custom voices
 ```

{agentwire_dev-1.38.0 → agentwire_dev-1.38.1}/README.md

@@ -233,7 +233,7 @@ agentwire kill --pane 1           # Kill worker
 
 ```bash
 agentwire say "Hello"             # TTS (auto-routes to browser)
-agentwire alert "Done"            # Text notification (no audio)
+agentwire send -s NAME "Done"     # Inject text into a session
 agentwire listen start/stop       # Voice recording
 agentwire voiceclone list         # Custom voices
 ```

{agentwire_dev-1.38.0 → agentwire_dev-1.38.1}/agentwire/__init__.py

@@ -1,3 +1,3 @@
 """AgentWire - Multi-session voice web interface for AI coding agents."""
 
-__version__ = "1.38.0"
+__version__ = "1.38.1"

{agentwire_dev-1.38.0 → agentwire_dev-1.38.1}/agentwire/static/announcements.json

@@ -1,5 +1,23 @@
 {
   "announcements": [
+    {
+      "id": "2026-06-worktree-sessions",
+      "placement": "modal",
+      "emoji": "🌳",
+      "title": "Parallel agents, each on their own branch",
+      "date": "2026-06-15",
+      "body": "Worktree sessions are now a first-class primitive. `agentwire worktree <name>` spins up an isolated git worktree on a fresh branch with its own standalone session — so you can fan out several autonomous agents at once without them stepping on each other. The base branch is derived from your repo (no hardcoded main), names follow templates, monorepos work, and a local branch↔session registry lets you list, remove, and prune them. Best part: each session knows its own etiquette. The spawn verb sets the posture, so a worktree agent automatically gets the isolation / verify-in-worktree / draft-PR / notify-back safety contract — your first prompt only needs the task.",
+      "highlights": [
+        "agentwire worktree <name> — isolated branch + worktree + standalone session",
+        "Repo-derived base branch, naming templates, monorepo support",
+        "Etiquette comes from the spawn verb — agents self-isolate and report back",
+        "Branch↔session registry: --list / --remove / --prune"
+      ],
+      "cta": {
+        "label": "What's new in v1.38",
+        "url": "https://github.com/dotdevdotdev/agentwire-dev/releases/tag/v1.38.0"
+      }
+    },
     {
       "id": "2026-06-window-sizing-fix",
       "placement": "modal",

{agentwire_dev-1.38.0 → agentwire_dev-1.38.1}/docs/wiki/architecture.md

@@ -31,7 +31,7 @@ Three surfaces, one source of truth.
 ```
 ┌──────────────────────────────┐  ┌──────────────────────────────┐
 │  Humans / scripts            │  │  Agents inside sessions      │
-│    agentwire <cmd>           │  │    MCP tools (87 of them)    │
+│    agentwire <cmd>           │  │    MCP tools (~98 of them)   │
 └─────────────┬────────────────┘  └─────────────┬────────────────┘
               │                                 │
               ▼                                 ▼
@@ -75,9 +75,9 @@ This is why bug fixes land in one place: change the CLI, the portal and MCP tool
 ├── damage-control/          # OPTIONAL user override for security rules
 ├── apps/, artifacts/        # agent-generated UIs and HTML artifacts
 ├── locks/                   # session mutexes (acquired by `agentwire ensure`)
-├── queues/                  # overnight queue items
-├── sessions/                # SDK session transcripts (REPL persistence)
-├── sdk-sessions/            # SDK conversation forks
+├── overnight/               # overnight queue items
+├── sessions/                # per-session metadata.json
+├── usage-limit/             # usage-limit recovery park state
 ├── tasks/                   # ensure-task summary files
 ├── tooldefs/                # tool definitions for damage-control ask-patterns
 ├── tunnels/                 # SSH tunnel state
@@ -151,7 +151,7 @@ Two execution paths for non-interactive work:
                           agentwire ensure
                           (tmux + Claude)
 
-                ┌── ~/.agentwire/queues/  (overnight prepare) ──┐
+                ┌── ~/.agentwire/overnight/  (overnight prepare) ┐
                 │  human prepares interactively → sessionId     │
                 └──────────────┬────────────────────────────────┘
                                ▼

{agentwire_dev-1.38.0 → agentwire_dev-1.38.1}/docs/wiki/deployment/remote-machines.md

@@ -43,7 +43,6 @@ agentwire machine remove <id>
 This:
 - Removes from `machines.json`
 - Kills active SSH tunnel
-- Cleans entries from `rooms.json`
 - Prints reminders for manual cleanup (SSH config, deploy keys, etc.)
 
 ### Portal UI
@@ -282,8 +281,8 @@ ssh my-server
 cd ~/.agentwire/machine
 claude  # gets both global prefs and machine context
 
-# Or spawn via agentwire from the Mac
-agentwire new -s my-server-ops --machine my-server -p ~/.agentwire/machine
+# Or spawn via agentwire from the Mac (remote target is the @machine suffix)
+agentwire new -s my-server-ops@my-server -p ~/.agentwire/machine
 ```
 
 ### What to Put in `~/.agentwire/machine/CLAUDE.md`

{agentwire_dev-1.38.0 → agentwire_dev-1.38.1}/docs/wiki/glossary.md

@@ -86,7 +86,7 @@ An SSH or Cloudflare Tunnel that exposes a local agentwire service (TTS server,
 
 ## V — Voice
 
-A TTS reference WAV (10–30 s) stored in `~/.agentwire/voices/`. Selected per-session via `voice:` in project config or per-call via `--voice`. The `default` voice is used when nothing is specified. → [Self-hosted TTS](tts/tts-self-hosted.md#voices).
+A TTS reference WAV (10–30 s) stored in `~/.agentwire/voices/`. Selected per-session via `voice:` in project config or per-call via `--voice`. The `default` voice is used when nothing is specified. → [Self-hosted TTS](voice/tts-self-hosted.md#voices).
 
 ## W — Worker
 

{agentwire_dev-1.38.0 → agentwire_dev-1.38.1}/docs/wiki/internals/shell-escaping.md

@@ -90,20 +90,21 @@ cmd = f'claude --append-system-prompt "$(<{prompt_file.name})"'
 
 ## Implementation Details
 
-Current implementation in `_build_agent_command_env()` (line 154-162 of `__main__.py`):
+Current implementation in `build_agent_command()` (`__main__.py`, e.g. the Claude path around line 309):
 
 ```python
 if merged.instructions:
-    # Write prompt to temp file and read via $(<file) to handle long prompts
-    # This avoids issues with command line length limits and escaping
-    import tempfile
-    prompt_file = tempfile.NamedTemporaryFile(mode='w', suffix='.txt', delete=False)
-    prompt_file.write(merged.instructions)
-    prompt_file.close()
-    env["AGENT_SYSTEM_PROMPT_FILE"] = prompt_file.name
-    env["AGENT_SYSTEM_PROMPT_FLAG"] = f'--append-system-prompt "$(<{prompt_file.name})"'
+    # Write to temp file to avoid shell escaping issues
+    # MUST be last flag — multiline content can break subsequent args
+    f = tempfile.NamedTemporaryFile(mode='w', suffix='.txt', delete=False)
+    f.write(merged.instructions)
+    f.close()
+    temp_file = f.name
+    parts.append(f'--append-system-prompt "$(<{temp_file})"')
 ```
 
+The temp file path is returned on `AgentCommand.temp_file` so the caller can clean it up after the agent starts. The pi path (around line 264) uses the same `$(<file)` technique with the combined global + role prompt.
+
 ---
 
 ## Testing Shell Escaping

{agentwire_dev-1.38.0 → agentwire_dev-1.38.1}/docs/wiki/internals/troubleshooting.md

@@ -421,14 +421,15 @@ ls ~/.agentwire/tasks/
 rm ~/.agentwire/tasks/session-name.json
 ```
 
-### `agentwire alert` vs `agentwire say`
+### Text vs voice notifications
 
 | Command | Audio | Use Case |
 |---------|-------|----------|
 | `agentwire say` | Yes (TTS) | User-facing messages, completion announcements |
-| `agentwire alert` | No (text only) | Background notifications, idle status updates |
+| `agentwire msg send` | No (text only) | Polite peer report-back, dropped into the recipient's inbox |
+| `agentwire notify-parent --to` | No (text only) | Worker → orchestrator status, injected as text |
 
-Idle hooks use `alert` to avoid audio spam when multiple panes go idle.
+Idle hooks route text alerts to the orchestrator (no audio) to avoid spam when multiple panes go idle.
 
 ---
 

{agentwire_dev-1.38.0 → agentwire_dev-1.38.1}/docs/wiki/research/orchestration-transport-alternatives.md

@@ -1,6 +1,8 @@
 # Orchestration transport alternatives: do we need a non-SSH transport?
 
 > Research note for [#297](https://github.com/dotdevdotdev/agentwire-dev/issues/297). Investigates the "we don't use SSH — we use something faster/more secure" pitch from competing agent-orchestration tools, separates real engineering from marketing, and recommends what (if anything) AgentWire should adopt. **This is a recon report, not a transport rewrite.**
+>
+> **Update (shipped):** cheap win #1 below is now implemented — `agentwire/ssh.py::ssh_base_opts()` supplies `ControlMaster`/`ControlPersist` multiplexing and is wired into every remote call site (`agents/tmux.py`, `tunnels.py`, `server.py`, `projects.py`). The present-tense "no `ControlMaster` anywhere / fresh process per command" baseline below describes the pre-#297 state and is kept for historical context.
 
 ## TL;DR — Recommendation (b): cheap hardening, no transport change
 

{agentwire_dev-1.38.0 → agentwire_dev-1.38.1}/docs/wiki/scheduling/scheduled-workloads.md

@@ -186,6 +186,7 @@ Environment variables use `${ENV_VAR}` syntax (expanded at runtime).
 | 4 | Pre-phase failure (command failed, `required` empty, `validate` failed, `starting_ref` not found) |
 | 5 | Timeout (hard timeout exceeded) |
 | 6 | Session error (couldn't create or connect) |
+| 7 | Usage limit (`usage_limit` — session parked awaiting reset; scheduler skips dispatch) |
 
 ---