@calltelemetry/openclaw-linear 0.9.19 → 0.9.20

package/README.md

@@ -41,7 +41,9 @@ Connect Linear to AI agents. Issues get triaged, implemented, and audited — au
 - [x] CI + coverage badges (1170+ tests, Codecov integration)
 - [x] Setup wizard (`openclaw openclaw-linear setup`) + `doctor --fix` auto-repair
 - [x] Project context auto-detection (repo, framework, build/test commands → worker/audit prompts)
-- [x] Per-backend CLI tools (`cli_codex`, `cli_claude`, `cli_gemini`) with Linear session activity streaming
+- [x] Per-backend CLI tools (`cli_codex`, `cli_claude`, `cli_gemini`) with `[Codex]`/`[Claude]`/`[Gemini]`-prefixed Linear session activity streaming
+- [x] Immediate thought emission on comment receipt and tool dispatch (visible before long-running tasks complete)
+- [x] Proactive OAuth token refresh timer (runs on startup, then every 6h)
 - [ ] **Worktree → PR merge** — `createPullRequest()` exists but is not wired into the pipeline. After audit pass, commits sit on a `codex/{identifier}` branch. You create the PR manually.
 - [ ] **Sub-agent worktree sharing** — Sub-agents spawned via `spawn_agent`/`ask_agent` do not inherit the parent worktree. They run in their own session without code access.
 - [ ] **Parallel worktree conflict resolution** — DAG dispatch runs up to 3 issues concurrently in separate worktrees, but there's no merge conflict detection across them.
@@ -118,7 +120,7 @@ The end result: you work in Linear. You create issues, assign them, comment in p
 
 ### Multi-Backend & Multi-Repo
 
-- **Three coding backends** — Codex (OpenAI), Claude (Anthropic), Gemini (Google). Configurable globally or per-agent. Each backend registers as a dedicated tool (`cli_codex`, `cli_claude`, `cli_gemini`) so agents and Linear session UI show exactly which backend is running. Per-agent overrides let you assign different backends to different team members.
+- **Three coding backends** — Codex (OpenAI), Claude (Anthropic), Gemini (Google). Configurable globally or per-agent. Each backend registers as a dedicated tool (`cli_codex`, `cli_claude`, `cli_gemini`) with `[Codex]`/`[Claude]`/`[Gemini]`-prefixed activity streaming — thoughts, actions, progress, and results all show the backend label in Linear's session UI so you always know which runner is active. Per-agent overrides let you assign different backends to different team members.
 - **Multi-repo dispatch** — Tag an issue with `<!-- repos: api, frontend -->` and the worker gets isolated worktrees for each repo. One issue, multiple codebases, one agent session.
 
 ### Operations
@@ -1303,7 +1305,7 @@ Every agent session gets these registered tools. They're available as native too
 
 ### `cli_codex` / `cli_claude` / `cli_gemini` — Coding backend tools
 
-Three per-backend tools that send tasks to their respective coding CLIs. Each agent sees only the tool matching its configured backend (e.g., an agent configured for `codex` gets `cli_codex`). The tool name is visible in Linear's agent session UI, so you always know which backend is running. The agent writes the prompt; the plugin handles worktree setup, session activity streaming, and output capture.
+Three per-backend tools that send tasks to their respective coding CLIs. Each agent sees only the tool matching its configured backend (e.g., an agent configured for `codex` gets `cli_codex`). All activity emissions are prefixed with the backend label (`[Codex]`, `[Claude]`, `[Gemini]`) — thoughts, action starts, progress updates, results, and errors — so the Linear session UI always shows which runner is active. When a CLI tool is dispatched, an immediate thought is emitted with the prompt excerpt before the long-running task begins. The agent writes the prompt; the plugin handles worktree setup, session activity streaming, and output capture.
 
 ### `linear_issues` — Native Linear API
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@calltelemetry/openclaw-linear",
-  "version": "0.9.19",
+  "version": "0.9.20",
   "description": "Linear Agent plugin for OpenClaw — webhook-driven AI pipeline with OAuth, multi-agent routing, and issue triage",
   "type": "module",
   "license": "MIT",

package/src/agent/agent.ts

@@ -293,6 +293,8 @@ async function runEmbedded(
 
   // Track last emitted tool to avoid duplicates
   let lastToolAction = "";
+  // Derive a friendly label from cli_ tool names: cli_codex→"Codex", cli_claude→"Claude"
+  const cliLabel = (name: string) => name.startsWith("cli_") ? name.slice(4).charAt(0).toUpperCase() + name.slice(5) : name;
 
   watchdog.start();
 
@@ -335,7 +337,8 @@ async function runEmbedded(
       if (text) {
         // Truncate tool results for activity display
         const truncated = text.length > 300 ? text.slice(0, 300) + "..." : text;
-        emit({ type: "action", action: lastToolAction || "Tool result", parameter: truncated });
+        const prefix = lastToolAction.startsWith("cli_") ? `[${cliLabel(lastToolAction)}] ` : "";
+        emit({ type: "action", action: `${prefix}${lastToolAction || "Tool result"}`, parameter: truncated });
       }
     },
 
@@ -364,11 +367,14 @@ async function runEmbedded(
       if (phase === "start") {
         lastToolAction = toolName;
 
-        // cli_codex / cli_claude / cli_gemini: show working dir and prompt excerpt
+        // cli_codex / cli_claude / cli_gemini: emit a thought + action so the
+        // user immediately sees what the agent is dispatching and why.
         if (toolName.startsWith("cli_") && inputObj) {
+          const tag = cliLabel(toolName);
           const prompt = String(inputObj.prompt ?? "").slice(0, 250);
           const workDir = inputObj.workingDir ? ` in ${inputObj.workingDir}` : "";
-          emit({ type: "action", action: `Running ${toolName}${workDir}`, parameter: prompt });
+          emit({ type: "thought", body: `[${tag}] Starting${workDir}: "${prompt}"\n\n${toolName}\nin progress` });
+          emit({ type: "action", action: `[${tag}] Running${workDir}`, parameter: prompt });
         } else {
           const detail = input || meta || toolName;
           emit({ type: "action", action: `Running ${toolName}`, parameter: detail.slice(0, 300) });
@@ -378,18 +384,21 @@ async function runEmbedded(
       // Tool execution update — partial progress (keeps Linear UI alive for long tools)
       if (phase === "update") {
         const detail = meta || input || "in progress";
-        emit({ type: "action", action: `${toolName}`, parameter: detail.slice(0, 300) });
+        const prefix = toolName.startsWith("cli_") ? `[${cliLabel(toolName)}] ` : "";
+        emit({ type: "action", action: `${prefix}${toolName}`, parameter: detail.slice(0, 300) });
       }
 
       // Tool execution completed successfully
       if (phase === "result" && !data.isError) {
         const detail = meta ? meta.slice(0, 300) : "completed";
-        emit({ type: "action", action: `${toolName} done`, parameter: detail });
+        const prefix = toolName.startsWith("cli_") ? `[${cliLabel(toolName)}] ` : "";
+        emit({ type: "action", action: `${prefix}${toolName} done`, parameter: detail });
       }
 
       // Tool execution result with error
       if (phase === "result" && data.isError) {
-        emit({ type: "action", action: `${toolName} failed`, parameter: (meta || "error").slice(0, 300) });
+        const prefix = toolName.startsWith("cli_") ? `[${cliLabel(toolName)}] ` : "";
+        emit({ type: "action", action: `${prefix}${toolName} failed`, parameter: (meta || "error").slice(0, 300) });
       }
     },
 

package/src/infra/tmux-runner.ts

@@ -119,6 +119,7 @@ export async function runInTmux(opts: RunInTmuxOptions): Promise<CliResult> {
       let killed = false;
       let killedByWatchdog = false;
       let resolved = false;
+      let completionEventReceived = false;
       const collectedMessages: string[] = [];
 
       const timer = setTimeout(() => {
@@ -175,8 +176,15 @@ export async function runInTmux(opts: RunInTmuxOptions): Promise<CliResult> {
             output: `Agent timed out after ${Math.round(timeoutMs / 1000)}s. Partial output:\n${output}`,
             error: "timeout",
           });
+        } else if (reason === "unexpected_exit") {
+          logger.warn(`tmux session ${sessionName} exited without completion event`);
+          resolve({
+            success: false,
+            output: `Agent session exited unexpectedly (no completion event received). Partial output:\n${output}`,
+            error: "unexpected_exit",
+          });
         } else {
-          // Normal completion
+          // Normal completion — only reached when completionEventReceived is true
           resolve({ success: true, output });
         }
       }
@@ -225,6 +233,7 @@ export async function runInTmux(opts: RunInTmuxOptions): Promise<CliResult> {
 
         // Detect completion — Claude uses "result", Codex uses "session.completed"
         if (event.type === "result" || event.type === "session.completed") {
+          completionEventReceived = true;
           cleanup("done");
           rl.close();
         }
@@ -233,7 +242,12 @@ export async function runInTmux(opts: RunInTmuxOptions): Promise<CliResult> {
       // Handle tail process ending (tmux session exited)
       tail.on("close", () => {
         if (!resolved) {
-          cleanup("done");
+          // If we never saw a completion event, the session died unexpectedly
+          if (completionEventReceived) {
+            cleanup("done");
+          } else {
+            cleanup("unexpected_exit");
+          }
         }
         rl.close();
       });

package/src/pipeline/webhook.ts

@@ -1731,11 +1731,12 @@ async function dispatchCommentToAgent(
       });
     }
 
-    // Emit thought
+    // Emit thought — include comment excerpt so the user sees immediate context
     if (agentSessionId) {
+      const excerpt = commentBody.length > 200 ? commentBody.slice(0, 200) + "..." : commentBody;
       await linearApi.emitActivity(agentSessionId, {
         type: "thought",
-        body: `${label} is processing comment on ${issueRef}...`,
+        body: `${label} received comment on ${issueRef}: "${excerpt}" — working on it now...`,
       }).catch(() => {});
     }