@made-by-moonlight/athene-plugin-runtime-tmux 0.9.1

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Composio, Inc.
+Copyright (c) 2026 slievr (Athene fork)
+
+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.

package/README.md

@@ -0,0 +1,169 @@
+# @agent-orchestrator/plugin-runtime-tmux
+
+Runtime plugin for executing agent sessions in tmux.
+
+## What This Does
+
+Creates isolated tmux sessions for each agent. Each session runs in a separate tmux session with:
+
+- Working directory set to workspace path
+- Environment variables from config
+- Agent launch command executed automatically
+
+## How It Works
+
+### Creating a Session
+
+```typescript
+const handle = await runtime.create({
+  sessionId: "my-app-3",
+  workspacePath: "/Users/dev/.worktrees/my-app/my-app-3",
+  launchCommand: "claude -p 'Fix bug in auth module'",
+  environment: {
+    AO_SESSION_ID: "my-app-3",
+    AO_PROJECT_ID: "my-app",
+  },
+});
+```
+
+**What happens:**
+
+1. Validates `sessionId` (only alphanumeric, dash, underscore allowed)
+2. Creates detached tmux session: `tmux new-session -d -s my-app-3 -c /path/to/workspace`
+3. Sets environment variables: `tmux ... -e KEY=VALUE`
+4. Sends launch command: `tmux send-keys -t my-app-3 "claude -p '...'" Enter`
+5. Returns RuntimeHandle with tmux session name
+
+### Sending Messages
+
+```typescript
+await runtime.sendMessage(handle, "Fix the test failure in auth.test.ts");
+```
+
+**What happens:**
+
+1. Clears partial input: `tmux send-keys -t my-app-3 C-u`
+2. For short messages (<200 chars, no newlines): sends directly with `-l` flag (literal mode)
+3. For long/multiline messages: writes to temp file → `tmux load-buffer` → `tmux paste-buffer`
+4. Waits 300ms (let tmux process the text)
+5. Sends Enter: `tmux send-keys -t my-app-3 Enter`
+
+**Why the complexity?**
+
+- `send-keys` without `-l` interprets special strings ("Enter", "Space") as key names
+- Long strings can overflow tmux's command buffer
+- Multiline strings need special handling
+
+### Getting Output
+
+```typescript
+const output = await runtime.getOutput(handle, 50); // last 50 lines
+```
+
+Uses `tmux capture-pane -t my-app-3 -p -S -50` to capture terminal buffer.
+
+### Checking if Alive
+
+```typescript
+const alive = await runtime.isAlive(handle);
+```
+
+Uses `tmux has-session -t my-app-3` (exit code 0 = exists, 1 = doesn't exist).
+
+### Destroying
+
+```typescript
+await runtime.destroy(handle);
+```
+
+Kills tmux session: `tmux kill-session -t my-app-3` (ignores errors if already dead).
+
+## Attaching to Sessions
+
+For Terminal plugins (iTerm2, web):
+
+```typescript
+const attachInfo = await runtime.getAttachInfo(handle);
+// Returns: { type: "tmux", target: "my-app-3", command: "tmux attach -t my-app-3" }
+```
+
+## Security
+
+**Session ID validation:**
+
+```typescript
+const SAFE_SESSION_ID = /^[a-zA-Z0-9_-]+$/;
+```
+
+Only allows safe characters. Prevents shell injection via session name (used in tmux commands).
+
+## Error Handling
+
+- **Session creation fails** → cleans up (kills session) before throwing
+- **Message send fails** → throws (caller should handle)
+- **Session already dead** → `destroy()` silently succeeds (idempotent)
+
+## Metrics
+
+```typescript
+const metrics = await runtime.getMetrics(handle);
+// Returns: { uptimeMs: 123456 }
+```
+
+Tracks uptime (stored in RuntimeHandle.data.createdAt).
+
+## Testing
+
+This plugin is tested indirectly via `packages/core/src/__tests__/tmux.test.ts` (utility functions) and integration tests.
+
+To test manually:
+
+```bash
+# Start a test session
+tmux new-session -d -s test-session -c /tmp
+tmux send-keys -t test-session "echo hello" Enter
+
+# Capture output
+tmux capture-pane -t test-session -p
+
+# Kill session
+tmux kill-session -t test-session
+```
+
+## Common Issues
+
+### tmux not installed
+
+If tmux is not in PATH, all operations fail. Install via:
+
+- macOS: `brew install tmux`
+- Linux: `apt-get install tmux` or `yum install tmux`
+
+### Session name conflicts
+
+If a session with the same ID already exists, `create()` fails. The orchestrator should ensure unique session IDs.
+
+### Detached sessions persist after orchestrator crashes
+
+tmux sessions keep running even if the orchestrator dies. Use `tmux list-sessions` to find orphans, `tmux kill-session -t <name>` to clean up.
+
+## Limitations
+
+- **macOS/Linux only** — tmux is not available natively on Windows. On Windows, use the `runtime-process` plugin (the default there); it provides native PTY support via ConPTY and `node-pty`. WSL is not required.
+- **Terminal buffer size** — `getOutput()` limited by tmux buffer size (default 2000 lines)
+- **No resource limits** — agents can consume unlimited CPU/memory (use docker/k8s runtimes for isolation)
+
+## Architecture Notes
+
+**Why tmux over raw processes?**
+
+- Sessions persist across orchestrator restarts
+- Easy to attach for debugging: `tmux attach -t session-name`
+- Terminal emulation (colors, ANSI codes work)
+- Works well with interactive AI tools (Claude Code, Aider)
+
+**Why detached mode?**
+
+- Orchestrator doesn't block waiting for agent
+- Multiple agents can run in parallel
+- Humans can attach later without interrupting agent

package/dist/__tests__/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/__tests__/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/index.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/index.test.js

@@ -0,0 +1,466 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import * as childProcess from "node:child_process";
+import * as fs from "node:fs";
+// Mock node:child_process with custom promisify support
+vi.mock("node:child_process", () => {
+    const mockExecFile = vi.fn();
+    // promisify(execFile) checks for a custom promisify symbol. Set it so
+    // await execFileAsync(...) returns { stdout, stderr } properly.
+    mockExecFile[Symbol.for("nodejs.util.promisify.custom")] = vi.fn();
+    return { execFile: mockExecFile };
+});
+// Mock node:crypto for deterministic UUIDs
+vi.mock("node:crypto", () => ({
+    randomUUID: () => "test-uuid-1234",
+}));
+// Mock node:fs for writeFileSync / unlinkSync
+vi.mock("node:fs", () => ({
+    writeFileSync: vi.fn(),
+    unlinkSync: vi.fn(),
+}));
+// Get reference to the promisify-custom mock — this is what the plugin actually calls
+const mockExecFileCustom = childProcess.execFile[Symbol.for("nodejs.util.promisify.custom")];
+const expectedTmuxOptions = { timeout: 5_000 };
+/** Queue a successful tmux command with the given stdout. */
+function mockTmuxSuccess(stdout = "") {
+    mockExecFileCustom.mockResolvedValueOnce({ stdout: stdout + "\n", stderr: "" });
+}
+/** Queue a failed tmux command. */
+function mockTmuxError(message) {
+    mockExecFileCustom.mockRejectedValueOnce(new Error(message));
+}
+/** Create a RuntimeHandle for testing. */
+function makeHandle(id, createdAt) {
+    return {
+        id,
+        runtimeName: "tmux",
+        data: {
+            createdAt: createdAt ?? 1000,
+            workspacePath: "/tmp/workspace",
+        },
+    };
+}
+// Import after mocks are set up
+import tmuxPlugin, { manifest, create } from "../index.js";
+beforeEach(() => {
+    vi.clearAllMocks();
+});
+describe("manifest", () => {
+    it("has name 'tmux' and slot 'runtime'", () => {
+        expect(manifest.name).toBe("tmux");
+        expect(manifest.slot).toBe("runtime");
+        expect(manifest.version).toBe("0.1.0");
+        expect(manifest.description).toBe("Runtime plugin: tmux sessions");
+    });
+    it("default export includes manifest and create", () => {
+        expect(tmuxPlugin.manifest).toBe(manifest);
+        expect(tmuxPlugin.create).toBe(create);
+    });
+});
+describe("create()", () => {
+    it("returns a Runtime with name 'tmux'", () => {
+        const runtime = create();
+        expect(runtime.name).toBe("tmux");
+    });
+});
+describe("runtime.create()", () => {
+    it("calls new-session with correct args", async () => {
+        const runtime = create();
+        // 1: new-session (with launch command as initial), 2: set-option status off
+        mockTmuxSuccess();
+        mockTmuxSuccess();
+        const handle = await runtime.create({
+            sessionId: "test-session",
+            workspacePath: "/tmp/workspace",
+            launchCommand: "echo hello",
+            environment: {},
+        });
+        expect(handle.id).toBe("test-session");
+        expect(handle.runtimeName).toBe("tmux");
+        expect(handle.data.workspacePath).toBe("/tmp/workspace");
+        // First call: new-session — launch command has the keep-alive shell tail
+        // appended so the tmux session survives agent exit (issue #1756).
+        expect(mockExecFileCustom).toHaveBeenCalledWith("tmux", [
+            "new-session",
+            "-d",
+            "-s",
+            "test-session",
+            "-c",
+            "/tmp/workspace",
+            'echo hello\nexec "${SHELL:-/bin/bash}" -i',
+        ], expectedTmuxOptions);
+    });
+    it("disables the tmux status bar immediately after new-session", async () => {
+        const runtime = create();
+        // 1: new-session, 2: set-option status off
+        mockTmuxSuccess();
+        mockTmuxSuccess();
+        await runtime.create({
+            sessionId: "status-bar-off",
+            workspacePath: "/tmp/ws",
+            launchCommand: "echo hi",
+            environment: {},
+        });
+        // Second call must be set-option ... status off, scoped to the session
+        expect(mockExecFileCustom).toHaveBeenNthCalledWith(2, "tmux", ["set-option", "-t", "status-bar-off", "status", "off"], expectedTmuxOptions);
+    });
+    it("includes -e KEY=VALUE flags for environment variables", async () => {
+        const runtime = create();
+        mockTmuxSuccess();
+        mockTmuxSuccess();
+        await runtime.create({
+            sessionId: "env-session",
+            workspacePath: "/tmp/ws",
+            launchCommand: "bash",
+            environment: { AO_SESSION: "env-session", FOO: "bar" },
+        });
+        // First call: new-session with env args
+        const firstCallArgs = mockExecFileCustom.mock.calls[0];
+        const args = firstCallArgs[1];
+        expect(args).toContain("-e");
+        expect(args).toContain("AO_SESSION=env-session");
+        expect(args).toContain("FOO=bar");
+        expect(args.at(-1)).toBe('bash\nexec "${SHELL:-/bin/bash}" -i');
+    });
+    it("starts the launch command as the initial tmux pane command", async () => {
+        const runtime = create();
+        mockTmuxSuccess();
+        mockTmuxSuccess();
+        await runtime.create({
+            sessionId: "launch-test",
+            workspacePath: "/tmp/ws",
+            launchCommand: "claude --session abc",
+            environment: {},
+        });
+        // First call: new-session passes the launch command as the pane's initial
+        // command, with the keep-alive shell tail appended.
+        expect(mockExecFileCustom).toHaveBeenCalledWith("tmux", [
+            "new-session",
+            "-d",
+            "-s",
+            "launch-test",
+            "-c",
+            "/tmp/ws",
+            'claude --session abc\nexec "${SHELL:-/bin/bash}" -i',
+        ], expectedTmuxOptions);
+    });
+    it("appends an interactive shell tail so the tmux pane survives agent exit (regression for #1756)", async () => {
+        const runtime = create();
+        mockTmuxSuccess();
+        mockTmuxSuccess();
+        await runtime.create({
+            sessionId: "keep-alive",
+            workspacePath: "/tmp/ws",
+            launchCommand: "claude --session abc",
+            environment: {},
+        });
+        const finalArg = mockExecFileCustom.mock.calls[0][1].at(-1);
+        expect(finalArg).toContain("claude --session abc");
+        expect(finalArg).toMatch(/exec "\$\{SHELL:-\/bin\/bash\}" -i\s*$/);
+    });
+    it("keeps the keep-alive tail in the temp script for long launch commands", async () => {
+        const runtime = create();
+        const longCommand = "x".repeat(250);
+        // 1: new-session (with bash invocation as initial command), 2: set-option
+        mockTmuxSuccess();
+        mockTmuxSuccess();
+        await runtime.create({
+            sessionId: "launch-long",
+            workspacePath: "/tmp/ws",
+            launchCommand: longCommand,
+            environment: {},
+        });
+        expect(fs.writeFileSync).toHaveBeenCalledWith(expect.stringContaining("ao-launch-test-uuid-1234.sh"), expect.stringContaining(longCommand), { encoding: "utf-8", mode: 0o700 });
+        // The script body includes the interactive shell tail too — without it
+        // long-command sessions would still nuke tmux on agent exit (#1756).
+        const writeCall = fs.writeFileSync.mock
+            .calls[0];
+        expect(writeCall[1]).toMatch(/exec "\$\{SHELL:-\/bin\/bash\}" -i/);
+        expect(mockExecFileCustom).toHaveBeenNthCalledWith(1, "tmux", [
+            "new-session",
+            "-d",
+            "-s",
+            "launch-long",
+            "-c",
+            "/tmp/ws",
+            expect.stringContaining("bash "),
+        ], expectedTmuxOptions);
+    });
+    it("surfaces tmux new-session failures", async () => {
+        const runtime = create();
+        // new-session itself fails — no further tmux calls happen
+        mockTmuxError("new-session failed");
+        await expect(runtime.create({
+            sessionId: "fail-session",
+            workspacePath: "/tmp/ws",
+            launchCommand: "bad-command",
+            environment: {},
+        })).rejects.toThrow("new-session failed");
+        expect(mockExecFileCustom).toHaveBeenCalledTimes(1);
+    });
+    it("cleans up session if set-option fails", async () => {
+        const runtime = create();
+        // 1: new-session succeeds
+        mockTmuxSuccess();
+        // 2: set-option fails (e.g. tmux command timeout on a slow host)
+        mockTmuxError("set-option timed out");
+        // 3: kill-session (cleanup attempt)
+        mockTmuxSuccess();
+        await expect(runtime.create({
+            sessionId: "setopt-fail",
+            workspacePath: "/tmp/ws",
+            launchCommand: "echo hi",
+            environment: {},
+        })).rejects.toThrow('Failed to configure or launch session "setopt-fail"');
+        // kill-session must run so we don't leave an orphaned tmux session
+        expect(mockExecFileCustom).toHaveBeenCalledWith("tmux", ["kill-session", "-t", "setopt-fail"], expectedTmuxOptions);
+    });
+    it("rejects invalid session IDs with special characters", async () => {
+        const runtime = create();
+        await expect(runtime.create({
+            sessionId: "bad session!",
+            workspacePath: "/tmp/ws",
+            launchCommand: "echo",
+            environment: {},
+        })).rejects.toThrow('Invalid session ID "bad session!"');
+    });
+    it("rejects session IDs with dots", async () => {
+        const runtime = create();
+        await expect(runtime.create({
+            sessionId: "bad.session",
+            workspacePath: "/tmp/ws",
+            launchCommand: "echo",
+            environment: {},
+        })).rejects.toThrow("Invalid session ID");
+    });
+    it("accepts valid session IDs with hyphens and underscores", async () => {
+        const runtime = create();
+        mockTmuxSuccess();
+        mockTmuxSuccess();
+        const handle = await runtime.create({
+            sessionId: "valid-session_123",
+            workspacePath: "/tmp/ws",
+            launchCommand: "echo",
+            environment: {},
+        });
+        expect(handle.id).toBe("valid-session_123");
+    });
+    it("handles no environment (undefined)", async () => {
+        const runtime = create();
+        mockTmuxSuccess();
+        mockTmuxSuccess();
+        await runtime.create({
+            sessionId: "no-env",
+            workspacePath: "/tmp/ws",
+            launchCommand: "echo hi",
+        });
+        // First call should not contain -e flags
+        const firstCallArgs = mockExecFileCustom.mock.calls[0][1];
+        expect(firstCallArgs).toEqual([
+            "new-session",
+            "-d",
+            "-s",
+            "no-env",
+            "-c",
+            "/tmp/ws",
+            'echo hi\nexec "${SHELL:-/bin/bash}" -i',
+        ]);
+    });
+});
+describe("runtime.destroy()", () => {
+    it("calls kill-session with the handle id", async () => {
+        const runtime = create();
+        const handle = makeHandle("destroy-test");
+        mockTmuxSuccess();
+        await runtime.destroy(handle);
+        expect(mockExecFileCustom).toHaveBeenCalledWith("tmux", ["kill-session", "-t", "destroy-test"], expectedTmuxOptions);
+    });
+    it("does not throw if session is already gone", async () => {
+        const runtime = create();
+        const handle = makeHandle("already-dead");
+        mockTmuxError("session not found: already-dead");
+        // Should not throw
+        await expect(runtime.destroy(handle)).resolves.toBeUndefined();
+    });
+});
+describe("runtime.sendMessage()", () => {
+    it("sends short text with send-keys -l (literal) + Enter", async () => {
+        const runtime = create();
+        const handle = makeHandle("msg-short");
+        // 1: send-keys C-u (clear), 2: send-keys -l text, 3: send-keys Enter
+        mockTmuxSuccess();
+        mockTmuxSuccess();
+        mockTmuxSuccess();
+        await runtime.sendMessage(handle, "hello world");
+        expect(mockExecFileCustom).toHaveBeenCalledTimes(3);
+        // Call 0: Clear partial input
+        expect(mockExecFileCustom).toHaveBeenNthCalledWith(1, "tmux", ["send-keys", "-t", "msg-short", "C-u"], expectedTmuxOptions);
+        // Call 1: Literal text
+        expect(mockExecFileCustom).toHaveBeenNthCalledWith(2, "tmux", ["send-keys", "-t", "msg-short", "-l", "hello world"], expectedTmuxOptions);
+        // Call 2: Enter
+        expect(mockExecFileCustom).toHaveBeenNthCalledWith(3, "tmux", ["send-keys", "-t", "msg-short", "Enter"], expectedTmuxOptions);
+    });
+    it("uses load-buffer + paste-buffer for long text (> 200 chars)", async () => {
+        const runtime = create();
+        const handle = makeHandle("msg-long");
+        const longText = "x".repeat(250);
+        // 1: C-u, 2: load-buffer, 3: paste-buffer, 4: unlinkSync (sync), 5: delete-buffer, 6: Enter
+        mockTmuxSuccess(); // C-u
+        mockTmuxSuccess(); // load-buffer
+        mockTmuxSuccess(); // paste-buffer
+        mockTmuxSuccess(); // delete-buffer (finally block)
+        mockTmuxSuccess(); // Enter
+        await runtime.sendMessage(handle, longText);
+        expect(mockExecFileCustom).toHaveBeenCalledTimes(5);
+        // Call 0: clear
+        expect(mockExecFileCustom).toHaveBeenNthCalledWith(1, "tmux", ["send-keys", "-t", "msg-long", "C-u"], expectedTmuxOptions);
+        // Call 1: load-buffer with named buffer
+        expect(mockExecFileCustom).toHaveBeenNthCalledWith(2, "tmux", [
+            "load-buffer",
+            "-b",
+            "ao-test-uuid-1234",
+            expect.stringContaining("ao-send-test-uuid-1234.txt"),
+        ], expectedTmuxOptions);
+        // Call 2: paste-buffer
+        expect(mockExecFileCustom).toHaveBeenNthCalledWith(3, "tmux", ["paste-buffer", "-b", "ao-test-uuid-1234", "-t", "msg-long", "-d"], expectedTmuxOptions);
+        // Verify writeFileSync was called with the message
+        expect(fs.writeFileSync).toHaveBeenCalledWith(expect.stringContaining("ao-send-test-uuid-1234.txt"), longText, { encoding: "utf-8", mode: 0o600 });
+        // Verify unlinkSync was called for cleanup
+        expect(fs.unlinkSync).toHaveBeenCalledWith(expect.stringContaining("ao-send-test-uuid-1234.txt"));
+    });
+    it("uses load-buffer for multiline text", async () => {
+        const runtime = create();
+        const handle = makeHandle("msg-multi");
+        mockTmuxSuccess(); // C-u
+        mockTmuxSuccess(); // load-buffer
+        mockTmuxSuccess(); // paste-buffer
+        mockTmuxSuccess(); // delete-buffer (finally)
+        mockTmuxSuccess(); // Enter
+        await runtime.sendMessage(handle, "line1\nline2\nline3");
+        // Should use buffer path, not send-keys -l
+        expect(mockExecFileCustom).toHaveBeenNthCalledWith(2, "tmux", [
+            "load-buffer",
+            "-b",
+            "ao-test-uuid-1234",
+            expect.stringContaining("ao-send-test-uuid-1234.txt"),
+        ], expectedTmuxOptions);
+        expect(fs.writeFileSync).toHaveBeenCalledWith(expect.stringContaining("ao-send-test-uuid-1234.txt"), "line1\nline2\nline3", { encoding: "utf-8", mode: 0o600 });
+    });
+    it("cleans up buffer and temp file on paste failure", async () => {
+        const runtime = create();
+        const handle = makeHandle("msg-fail");
+        const longText = "y".repeat(250);
+        mockTmuxSuccess(); // C-u
+        mockTmuxSuccess(); // load-buffer succeeds
+        mockTmuxError("paste-buffer failed"); // paste-buffer fails
+        // finally block:
+        // unlinkSync is sync (mocked)
+        mockTmuxSuccess(); // delete-buffer in finally
+        // After finally, the error propagates — no Enter call
+        await expect(runtime.sendMessage(handle, longText)).rejects.toThrow("paste-buffer failed");
+        // unlinkSync should still be called for temp file cleanup
+        expect(fs.unlinkSync).toHaveBeenCalledWith(expect.stringContaining("ao-send-test-uuid-1234.txt"));
+        // delete-buffer should be called in finally block
+        expect(mockExecFileCustom).toHaveBeenCalledWith("tmux", ["delete-buffer", "-b", "ao-test-uuid-1234"], expectedTmuxOptions);
+    });
+});
+describe("runtime.getOutput()", () => {
+    it("calls capture-pane with correct args and default lines", async () => {
+        const runtime = create();
+        const handle = makeHandle("output-test");
+        mockTmuxSuccess("some output\nfrom tmux");
+        const output = await runtime.getOutput(handle);
+        expect(output).toBe("some output\nfrom tmux");
+        expect(mockExecFileCustom).toHaveBeenCalledWith("tmux", ["capture-pane", "-t", "output-test", "-p", "-S", "-50"], expectedTmuxOptions);
+    });
+    it("passes custom line count", async () => {
+        const runtime = create();
+        const handle = makeHandle("output-custom");
+        mockTmuxSuccess("output");
+        await runtime.getOutput(handle, 100);
+        expect(mockExecFileCustom).toHaveBeenCalledWith("tmux", ["capture-pane", "-t", "output-custom", "-p", "-S", "-100"], expectedTmuxOptions);
+    });
+    it("returns empty string on error", async () => {
+        const runtime = create();
+        const handle = makeHandle("output-err");
+        mockTmuxError("session not found");
+        const output = await runtime.getOutput(handle);
+        expect(output).toBe("");
+    });
+});
+describe("runtime.isAlive()", () => {
+    it("returns true when has-session succeeds", async () => {
+        const runtime = create();
+        const handle = makeHandle("alive-test");
+        mockTmuxSuccess();
+        const alive = await runtime.isAlive(handle);
+        expect(alive).toBe(true);
+        expect(mockExecFileCustom).toHaveBeenCalledWith("tmux", ["has-session", "-t", "alive-test"], expectedTmuxOptions);
+    });
+    it("returns false when has-session fails", async () => {
+        const runtime = create();
+        const handle = makeHandle("dead-test");
+        mockTmuxError("session not found");
+        const alive = await runtime.isAlive(handle);
+        expect(alive).toBe(false);
+    });
+});
+describe("runtime.getMetrics()", () => {
+    it("returns uptimeMs based on createdAt", async () => {
+        const runtime = create();
+        const now = Date.now();
+        const handle = makeHandle("metrics-test", now - 5000);
+        const metrics = await runtime.getMetrics(handle);
+        // uptimeMs should be approximately 5000ms (allow some wiggle room)
+        expect(metrics.uptimeMs).toBeGreaterThanOrEqual(5000);
+        expect(metrics.uptimeMs).toBeLessThan(6000);
+    });
+    it("handles missing createdAt by using Date.now()", async () => {
+        const runtime = create();
+        const handle = {
+            id: "metrics-no-created",
+            runtimeName: "tmux",
+            data: {},
+        };
+        const metrics = await runtime.getMetrics(handle);
+        // uptimeMs should be very close to 0 since createdAt defaults to Date.now()
+        expect(metrics.uptimeMs).toBeGreaterThanOrEqual(0);
+        expect(metrics.uptimeMs).toBeLessThan(1000);
+    });
+});
+describe("runtime.getAttachInfo()", () => {
+    it("returns tmux type and attach command", async () => {
+        const runtime = create();
+        const handle = makeHandle("attach-test");
+        const info = await runtime.getAttachInfo(handle);
+        expect(info).toEqual({
+            type: "tmux",
+            target: "attach-test",
+            command: "tmux attach -t attach-test",
+        });
+    });
+});
+describe("runtime.preflight()", () => {
+    it("resolves when `tmux -V` succeeds", async () => {
+        mockTmuxSuccess("tmux 3.4");
+        const runtime = create();
+        await expect(runtime.preflight({})).resolves.toBeUndefined();
+        expect(mockExecFileCustom).toHaveBeenCalledWith("tmux", ["-V"], expectedTmuxOptions);
+    });
+    it("throws with platform-specific install hint when tmux is missing", async () => {
+        mockTmuxError("ENOENT");
+        const runtime = create();
+        const err = (await runtime.preflight({}).catch((e) => e));
+        expect(err).toBeInstanceOf(Error);
+        expect(err.message).toContain("tmux is not installed");
+        expect(err.message).toContain("Install it:");
+        // Hint must include something runnable for the host platform.
+        if (process.platform === "darwin")
+            expect(err.message).toContain("brew install tmux");
+        else if (process.platform === "win32")
+            expect(err.message).toContain("WSL");
+        else
+            expect(err.message).toMatch(/apt install tmux|dnf install tmux/);
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/__tests__/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../src/__tests__/index.test.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+import { type Runtime } from "@made-by-moonlight/athene-core";
+export declare const manifest: {
+    name: string;
+    slot: "runtime";
+    description: string;
+    version: string;
+};
+export declare function create(): Runtime;
+declare const _default: {
+    manifest: {
+        name: string;
+        slot: "runtime";
+        description: string;
+        version: string;
+    };
+    create: typeof create;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,OAAO,EAMb,MAAM,gCAAgC,CAAC;AAKxC,eAAO,MAAM,QAAQ;;;;;CAKpB,CAAC;AA4CF,wBAAgB,MAAM,IAAI,OAAO,CAwKhC;;;;;;;;;;AAED,wBAAoE"}

package/dist/index.js

@@ -0,0 +1,206 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { setTimeout as sleep } from "node:timers/promises";
+import { randomUUID } from "node:crypto";
+import { writeFileSync, unlinkSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { shellEscape, } from "@made-by-moonlight/athene-core";
+const execFileAsync = promisify(execFile);
+const TMUX_COMMAND_TIMEOUT_MS = 5_000;
+export const manifest = {
+    name: "tmux",
+    slot: "runtime",
+    description: "Runtime plugin: tmux sessions",
+    version: "0.1.0",
+};
+/** Only allow safe characters in session IDs */
+const SAFE_SESSION_ID = /^[a-zA-Z0-9_-]+$/;
+function assertValidSessionId(id) {
+    if (!SAFE_SESSION_ID.test(id)) {
+        throw new Error(`Invalid session ID "${id}": must match ${SAFE_SESSION_ID}`);
+    }
+}
+/**
+ * Shell snippet appended after the agent launch command so the tmux pane
+ * (and therefore the tmux session) survives agent exit. Without this, the
+ * pane closes when the agent process exits, the only window goes away, and
+ * the whole tmux session dies — leaving the dashboard with a phantom
+ * "runtime lost" state and the user with no way to do anything in that
+ * workspace (issue #1756).
+ *
+ * `exec` replaces the wrapping sh/bash with the user's interactive shell,
+ * so the lifecycle manager still detects agent termination via
+ * `agent.isProcessRunning` and transitions the session correctly.
+ */
+const KEEP_ALIVE_SHELL = `exec "\${SHELL:-/bin/bash}" -i`;
+function withKeepAliveShell(command) {
+    return `${command.replace(/\n+$/, "")}\n${KEEP_ALIVE_SHELL}`;
+}
+function writeLaunchScript(command) {
+    const scriptPath = join(tmpdir(), `ao-launch-${randomUUID()}.sh`);
+    const content = `#!/usr/bin/env bash\nrm -- "$0" 2>/dev/null || true\n${withKeepAliveShell(command)}\n`;
+    writeFileSync(scriptPath, content, { encoding: "utf-8", mode: 0o700 });
+    return `bash ${shellEscape(scriptPath)}`;
+}
+/** Run a tmux command and return stdout */
+async function tmux(...args) {
+    const { stdout } = await execFileAsync("tmux", args, {
+        timeout: TMUX_COMMAND_TIMEOUT_MS,
+    });
+    return stdout.trimEnd();
+}
+export function create() {
+    return {
+        name: "tmux",
+        async create(config) {
+            assertValidSessionId(config.sessionId);
+            const sessionName = config.sessionId;
+            // Build environment flags: -e KEY=VALUE for each env var
+            const envArgs = [];
+            for (const [key, value] of Object.entries(config.environment ?? {})) {
+                envArgs.push("-e", `${key}=${value}`);
+            }
+            // Re-export PATH inside the launch script. macOS zsh runs path_helper
+            // during shell startup which resets PATH, wiping entries set via tmux -e.
+            // Including the export in the launched shell command avoids terminal
+            // buffer issues with long PATH values (1000+ chars).
+            const pathValue = config.environment?.["PATH"];
+            let launchCommand = config.launchCommand;
+            if (pathValue) {
+                // Use printf with JSON-escaped value to avoid shell injection if
+                // PATH contains single quotes or other shell metacharacters.
+                launchCommand = `export PATH=$(printf '%s' ${JSON.stringify(pathValue)})\n${launchCommand}`;
+            }
+            // Start the launch command as the pane's initial command instead of
+            // typing into a live shell. A dashboard attach can trigger terminal
+            // device responses; if those race with tmux send-keys, they become
+            // literal shell input and corrupt the launch path. The keep-alive
+            // tail is appended in both code paths — see KEEP_ALIVE_SHELL.
+            const shellCommand = launchCommand.length > 200
+                ? writeLaunchScript(launchCommand)
+                : withKeepAliveShell(launchCommand);
+            await tmux("new-session", "-d", "-s", sessionName, "-c", config.workspacePath, ...envArgs, shellCommand);
+            // Hide the tmux status bar — sessions are embedded in the web terminal,
+            // and the green bar at the bottom is visual noise (and racy with the
+            // web layer's own set-option call, which only fires on WebSocket connect).
+            // Kill the session if this fails so we don't leave an orphaned tmux process.
+            try {
+                await tmux("set-option", "-t", sessionName, "status", "off");
+            }
+            catch (err) {
+                try {
+                    await tmux("kill-session", "-t", sessionName);
+                }
+                catch {
+                    // Best-effort cleanup
+                }
+                const msg = err instanceof Error ? err.message : String(err);
+                throw new Error(`Failed to configure or launch session "${sessionName}": ${msg}`, {
+                    cause: err,
+                });
+            }
+            return {
+                id: sessionName,
+                runtimeName: "tmux",
+                data: {
+                    createdAt: Date.now(),
+                    workspacePath: config.workspacePath,
+                },
+            };
+        },
+        async destroy(handle) {
+            try {
+                await tmux("kill-session", "-t", handle.id);
+            }
+            catch {
+                // Session may already be dead — that's fine
+            }
+        },
+        async sendMessage(handle, message) {
+            // Clear any partial input
+            await tmux("send-keys", "-t", handle.id, "C-u");
+            // For long or multiline messages, use load-buffer + paste-buffer
+            // Use randomUUID to avoid temp file collisions on concurrent sends
+            if (message.includes("\n") || message.length > 200) {
+                const bufferName = `ao-${randomUUID()}`;
+                const tmpPath = join(tmpdir(), `ao-send-${randomUUID()}.txt`);
+                writeFileSync(tmpPath, message, { encoding: "utf-8", mode: 0o600 });
+                try {
+                    await tmux("load-buffer", "-b", bufferName, tmpPath);
+                    await tmux("paste-buffer", "-b", bufferName, "-t", handle.id, "-d");
+                }
+                finally {
+                    // Clean up temp file and tmux buffer (in case paste-buffer failed
+                    // and the -d flag didn't delete it)
+                    try {
+                        unlinkSync(tmpPath);
+                    }
+                    catch {
+                        // ignore cleanup errors
+                    }
+                    try {
+                        await tmux("delete-buffer", "-b", bufferName);
+                    }
+                    catch {
+                        // Buffer may already be deleted by -d flag — that's fine
+                    }
+                }
+            }
+            else {
+                // Use -l (literal) so text like "Enter" or "Space" isn't interpreted
+                // as tmux key names
+                await tmux("send-keys", "-t", handle.id, "-l", message);
+            }
+            // Small delay to let tmux process the pasted text before pressing Enter.
+            // Without this, Enter can arrive before the text is fully rendered.
+            await sleep(300);
+            await tmux("send-keys", "-t", handle.id, "Enter");
+        },
+        async getOutput(handle, lines = 50) {
+            try {
+                return await tmux("capture-pane", "-t", handle.id, "-p", "-S", `-${lines}`);
+            }
+            catch {
+                return "";
+            }
+        },
+        async isAlive(handle) {
+            try {
+                await tmux("has-session", "-t", handle.id);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        async getMetrics(handle) {
+            const createdAt = handle.data.createdAt ?? Date.now();
+            return {
+                uptimeMs: Date.now() - createdAt,
+            };
+        },
+        async getAttachInfo(handle) {
+            return {
+                type: "tmux",
+                target: handle.id,
+                command: `tmux attach -t ${handle.id}`,
+            };
+        },
+        async preflight() {
+            try {
+                await execFileAsync("tmux", ["-V"], { timeout: TMUX_COMMAND_TIMEOUT_MS });
+            }
+            catch {
+                const hint = process.platform === "darwin"
+                    ? "brew install tmux"
+                    : process.platform === "win32"
+                        ? "tmux is not available on Windows. Use WSL: wsl --install, then: sudo apt install tmux"
+                        : "sudo apt install tmux (Debian/Ubuntu) or sudo dnf install tmux (Fedora)";
+                throw new Error(`tmux is not installed. Install it: ${hint}`);
+            }
+        },
+    };
+}
+export default { manifest, create };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@made-by-moonlight/athene-plugin-runtime-tmux",
+  "version": "0.9.1",
+  "description": "Runtime plugin: tmux sessions",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/slievr/Athene.git",
+    "directory": "packages/plugins/runtime-tmux"
+  },
+  "homepage": "https://github.com/slievr/Athene",
+  "bugs": {
+    "url": "https://github.com/slievr/Athene/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@made-by-moonlight/athene-core": "0.9.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.3",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  }
+}