feat: webmux oneshot + Linear round-trip, server-driven watcher

README.md

@@ -43,6 +43,13 @@ Run agents in isolated Docker containers for untrusted or experimental work. web
 
 See your assigned Linear issues alongside your worktrees. Webmux matches branches to issues automatically, so you can browse your backlog, pick an issue, and spin up a worktree for it in one click.
 
+**Auto-create from labels.** When the server polls your assigned Linear issues, it acts on two labels:
+
+- **`webmux`** — auto-creates a worktree for the issue, seeded with the issue title + description as the agent prompt.
+- **`webmux_oneshot`** — launches the issue via `webmux oneshot` (autonomous run; auto-closes the session and posts the conversation back to the Linear issue when the agent terminates or opens a PR). When both labels are present, `webmux_oneshot` wins.
+
+Each issue is processed once while it stays in Todo + labeled. Remove the label and re-add it to retrigger.
+
 ## Quick Start
 
 ```bash

backend/src/__tests__/agent-chat-service.test.ts

@@ -32,6 +32,7 @@ const TEST_CONFIG: ProjectConfig = {
   },
   lifecycleHooks: {},
   autoName: null,
+  oneshot: { systemPrompt: "" },
 };
 
 describe("resolveAgentChatSupport", () => {

backend/src/__tests__/agent-registry.test.ts

@@ -39,6 +39,7 @@ const TEST_CONFIG: ProjectConfig = {
   },
   lifecycleHooks: {},
   autoName: null,
+  oneshot: { systemPrompt: "" },
 };
 
 describe("agent-registry", () => {

backend/src/__tests__/agent-service.test.ts

@@ -83,7 +83,7 @@ describe("agent-service command builders", () => {
     expect(claude).not.toContain("--continue");
   });
 
-  it("uses claude continue on resume without replaying the initial prompt", () => {
+  it("uses claude continue on resume and skips system prompt; no prompt = no replay", () => {
     const command = buildAgentPaneCommand({
       agent: builtInAgent("claude"),
       runtimeEnvPath: "/tmp/gitdir/webmux/runtime.env",
@@ -93,14 +93,29 @@ describe("agent-service command builders", () => {
       profileName: "default",
       yolo: true,
       systemPrompt: "stay focused",
-      prompt: "fix the tests",
       launchMode: "resume",
     });
 
     expect(command).toContain("claude --dangerously-skip-permissions --continue");
     expect(command).not.toContain("--append-system-prompt");
-    expect(command).not.toContain("fix the tests");
     expect(command).not.toContain("stay focused");
+    expect(command).not.toContain(" -- ");
+  });
+
+  it("appends the follow-up prompt to claude --continue when one is provided", () => {
+    const command = buildAgentPaneCommand({
+      agent: builtInAgent("claude"),
+      runtimeEnvPath: "/tmp/gitdir/webmux/runtime.env",
+      repoRoot: "/repo",
+      worktreePath: "/repo/__worktrees/feature",
+      branch: "feature",
+      profileName: "default",
+      yolo: true,
+      prompt: "fix the tests",
+      launchMode: "resume",
+    });
+
+    expect(command).toContain("claude --dangerously-skip-permissions --continue -- 'fix the tests'");
   });
 
   it("builds docker commands that exec inside the container", () => {
@@ -154,7 +169,7 @@ describe("agent-service command builders", () => {
     expect(shell).toContain("elif [ -x /bin/sh ]; then exec /bin/sh -i;");
   });
 
-  it("uses codex resume --last on resume without replaying the initial prompt", () => {
+  it("uses codex resume --last and skips developer_instructions; no prompt = no replay", () => {
     const command = buildAgentPaneCommand({
       agent: builtInAgent("codex"),
       runtimeEnvPath: "/tmp/gitdir/webmux/runtime.env",
@@ -164,14 +179,29 @@ describe("agent-service command builders", () => {
       profileName: "default",
       yolo: true,
       systemPrompt: "stay focused",
-      prompt: "ship the fix",
       launchMode: "resume",
     });
 
     expect(command).toContain("codex --enable codex_hooks --yolo resume --last");
     expect(command).not.toContain("developer_instructions=");
-    expect(command).not.toContain("ship the fix");
     expect(command).not.toContain("stay focused");
+    expect(command).not.toContain(" -- ");
+  });
+
+  it("appends the follow-up prompt to codex resume --last when one is provided", () => {
+    const command = buildAgentPaneCommand({
+      agent: builtInAgent("codex"),
+      runtimeEnvPath: "/tmp/gitdir/webmux/runtime.env",
+      repoRoot: "/repo",
+      worktreePath: "/repo/__worktrees/feature",
+      branch: "feature",
+      profileName: "default",
+      yolo: true,
+      prompt: "ship the fix",
+      launchMode: "resume",
+    });
+
+    expect(command).toContain("codex --enable codex_hooks --yolo resume --last -- 'ship the fix'");
   });
 
   it("uses -- before the prompt so dash-prefixed prompts are not parsed as flags", () => {

backend/src/__tests__/agents-ui-service.test.ts

@@ -38,6 +38,8 @@ describe("buildAgentsUiWorktreeSummary", () => {
       creation: {
         phase: "starting_session",
       },
+      source: "ui",
+      oneshot: null,
     }, {
       provider: "codexAppServer",
       conversationId: "thr_123",
@@ -105,6 +107,8 @@ describe("buildAgentsUiWorktreeSummary", () => {
       prs: [],
       linearIssue: null,
       creation: null,
+      source: "ui",
+      oneshot: null,
     }, null);
 
     expect(summary.conversation).toBeNull();

backend/src/__tests__/claude-cli.test.ts

@@ -57,17 +57,121 @@ describe("claude-cli adapter", () => {
           id: "user-1",
           turnId: "user-1",
           role: "user",
+          kind: "text",
           text: "Inspect the failing tests",
           createdAt: "2026-04-14T15:00:00.000Z",
         },
         {
-          id: "assistant-1",
+          id: "assistant-thinking:1",
           turnId: "user-1",
           role: "assistant",
+          kind: "text",
+          text: "Let me inspect that.",
+          createdAt: "2026-04-14T15:00:01.000Z",
+        },
+        {
+          id: "assistant-1:2",
+          turnId: "user-1",
+          role: "assistant",
+          kind: "text",
           text: "The failure comes from the stale snapshot.",
           createdAt: "2026-04-14T15:00:05.000Z",
         },
       ],
     });
   });
+
+  it("surfaces tool_use and tool_result blocks as intermediate messages", () => {
+    const session = buildClaudeSessionFromText({
+      path: "/tmp/session.jsonl",
+      sessionId: "session-2",
+      text: [
+        JSON.stringify({
+          type: "user",
+          uuid: "user-1",
+          timestamp: "2026-04-14T15:00:00.000Z",
+          cwd: "/tmp",
+          message: { role: "user", content: "Read foo.txt" },
+        }),
+        JSON.stringify({
+          type: "assistant",
+          uuid: "assistant-1",
+          timestamp: "2026-04-14T15:00:01.000Z",
+          message: {
+            role: "assistant",
+            stop_reason: "tool_use",
+            content: [
+              { type: "text", text: "Reading the file." },
+              { type: "tool_use", id: "tool-1", name: "Read", input: { file_path: "/tmp/foo.txt" } },
+            ],
+          },
+        }),
+        JSON.stringify({
+          type: "user",
+          uuid: "tool-result-1",
+          timestamp: "2026-04-14T15:00:02.000Z",
+          message: {
+            role: "user",
+            content: [
+              { type: "tool_result", tool_use_id: "tool-1", content: "hello world" },
+            ],
+          },
+        }),
+        JSON.stringify({
+          type: "assistant",
+          uuid: "assistant-2",
+          timestamp: "2026-04-14T15:00:03.000Z",
+          message: {
+            role: "assistant",
+            stop_reason: "end_turn",
+            content: [{ type: "text", text: "It says hello world." }],
+          },
+        }),
+      ].join("\n"),
+    });
+
+    expect(session.messages).toEqual([
+      {
+        id: "user-1",
+        turnId: "user-1",
+        role: "user",
+        kind: "text",
+        text: "Read foo.txt",
+        createdAt: "2026-04-14T15:00:00.000Z",
+      },
+      {
+        id: "assistant-1:1",
+        turnId: "user-1",
+        role: "assistant",
+        kind: "text",
+        text: "Reading the file.",
+        createdAt: "2026-04-14T15:00:01.000Z",
+      },
+      {
+        id: "assistant-1:2",
+        turnId: "user-1",
+        role: "assistant",
+        kind: "toolUse",
+        toolName: "Read",
+        text: `{"file_path":"/tmp/foo.txt"}`,
+        createdAt: "2026-04-14T15:00:01.000Z",
+      },
+      {
+        id: "tool-result-1:3",
+        turnId: "user-1",
+        role: "user",
+        kind: "toolResult",
+        text: "hello world",
+        createdAt: "2026-04-14T15:00:02.000Z",
+      },
+      {
+        id: "assistant-2:4",
+        turnId: "user-1",
+        role: "assistant",
+        kind: "text",
+        text: "It says hello world.",
+        createdAt: "2026-04-14T15:00:03.000Z",
+      },
+    ]);
+  });
 });

backend/src/__tests__/claude-conversation-service.test.ts

@@ -63,6 +63,8 @@ function makeWorktree(): WorktreeSnapshot {
     prs: [],
     linearIssue: null,
     creation: null,
+    source: "ui",
+    oneshot: null,
   };
 }