paseo-follow-up 0.1.2 → 0.2.0

package/OVERVIEW.md

@@ -2,7 +2,7 @@
 
 Follow-up keeps PR stacks, remaining tasks and explicit agent completion attached to a Paseo workspace. It groups workspaces by whether you or an agent can act next and retains settled PR history.
 
-Requires Paseo 0.11+, Node 22+ and authenticated gh on the daemon host. Graphite CLI authentication is used for readiness and explicit Merge. The optional Send to Paseo browser companion enables Graphite's Merge when ready setting; it is not needed for tracking, recovery or follow-up.
+Requires Paseo 0.14+, Node 22+ and authenticated gh on the daemon host. Graphite CLI authentication is used for readiness and explicit Merge. The optional Send to Paseo browser companion enables Graphite's Merge when ready setting; it is not needed for tracking, recovery or follow-up.
 
 Open the sidebar or Command-K, then Track this workspace. Project settings can enroll existing and new workspaces with original main-agent ownership; Auto always starts off. The retained development default enables canonical Git repositories named hero-poc, while other projects require opt-in. Disable that project default to stop further enrollment without losing records.
 

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm version](https://img.shields.io/npm/v/paseo-follow-up?style=for-the-badge&color=cb3837)](https://www.npmjs.com/package/paseo-follow-up)
 [![npm downloads](https://img.shields.io/npm/dm/paseo-follow-up?style=for-the-badge&color=cb3837)](https://www.npmjs.com/package/paseo-follow-up)
-[![Paseo](https://img.shields.io/badge/Paseo-%E2%89%A5%200.11.0-8A63D2?style=for-the-badge)](https://paseo.sh)
+[![Paseo](https://img.shields.io/badge/Paseo-%E2%89%A5%200.14.0-8A63D2?style=for-the-badge)](https://paseo.sh)
 [![License](https://img.shields.io/github/license/tomgrin10/paseo-follow-up?style=for-the-badge&color=2563eb)](LICENSE)
 
 Keep long-lived Paseo workspaces moving through review, deployment, and completion. Follow-up retains PR stacks and remaining tasks, batches repairs for the existing main agent, and records the agent's explicit Done declaration.
@@ -13,7 +13,7 @@ Screenshots use synthetic workspaces and PRs.
 
 ## Requirements
 
-- Paseo 0.11.0 or newer and Node 22 or newer.
+- Paseo 0.14.0 or newer and Node 22 or newer.
 - Authenticated GitHub CLI (`gh`) on the daemon host.
 - Saved Graphite CLI authentication for Graphite readiness and explicit Merge controls.
 - Optional Send to Paseo browser companion for Graphite's actual Merge when ready switch. Core tracking and follow-up work without it.
@@ -63,6 +63,16 @@ Integration checks use a separate Paseo home, synthetic agents and fixtures. Nev
 
 Release tags (`vX.Y.Z`) run `.github/workflows/publish-npm.yml`. GitHub Actions verifies the plugin and packed installation, publishes through npm Trusted Publishing, verifies registry integrity, then creates the GitHub release. No npm token is stored in repository secrets.
 
+## Paseo 0.14 agent integration
+
+The Follow-up MCP attaches when a tracked main or active recovery agent opens a Claude or Codex session. Normal startup no longer writes global Claude/Codex MCP settings. Existing global entries are preserved. Turn-ended discovery now fetches recent history through the SDK because Paseo 0.13+ sends an empty timeline in lifecycle events.
+
+Requires Paseo **0.14.0 or newer**. Agent tools are scoped to interactive Claude
+and Codex sessions; history-only opens receive none. They become available on
+the next idle session open after install or reload. The agent label
+`plugin-tools/enabled: "false"` opts a session out. Existing plugin data and
+settings are retained.
+
 ## Other plugins
 
 Also available from [Tom Gringauz](https://github.com/tomgrin10):

package/index.server.ts

@@ -18,7 +18,7 @@ import { applyHistory, applyDiscovery, extractHistory } from "./server/discovery
 import { lifecycleOnly, recoveryBatch } from "./shared/follow-up";
 import { Deployments } from "./server/deployments";
 import { AgentHooks } from "./server/agent-hooks";
-import { AgentMcp } from "./server/agent-mcp";
+import { withSessionMcp } from "./server/session-mcp";
 import { updateObligation } from "./server/obligations";
 
 export default function contribute(server: PluginServerContext) {
@@ -27,7 +27,6 @@ export default function contribute(server: PluginServerContext) {
   const bridge = join(directory, "mcp.mjs");
   const store = new Store(directory);
   const agentHooks = new AgentHooks(directory, clientEntry());
-  const agentMcp = new AgentMcp(directory, clientEntry(), paseoHome);
   const gateway = new PaseoGateway();
   const graphite = new Graphite();
   const github = new Github(undefined, graphite, new Deployments());
@@ -48,8 +47,6 @@ export default function contribute(server: PluginServerContext) {
     await engine.recover();
     hooksStarted = true;
     await agentHooks.start().catch(() => { hookError = "Automatic sidebar instructions could not be registered for every provider. Check Claude/Codex hook settings; tracking is still available."; });
-    const mcp = await agentMcp.start();
-    if ([mcp.claude, mcp.codex].some(status => ["unavailable", "name-conflict"].includes(status))) hookError = "Some agent MCP connections could not be registered. Existing CLI access remains available.";
     hookTimer = setInterval(() => void agentHooks.heartbeat().catch(() => {}), 30_000);
   })().catch(() => { loadError = "Follow-through could not start. Check its saved state and worker lock."; });
   const requireReady = async () => { await ready; if (loadError || stopped) throw new Error(loadError ?? "Follow-through is stopping"); };
@@ -252,9 +249,9 @@ export default function contribute(server: PluginServerContext) {
     }),
     server.before("agent.session_open", async ({ request }) => {
       await ready;
-      if (loadError || stopped) return request;
+      if (loadError || stopped || request.purpose !== "interactive") return request;
       const saved = await store.snapshot();
-      let w = saved.workspaces.find(w => w.enable_tracking && (w.mainAgentId === request.agentId || w.batches.some(b => b.recipientAgentId === request.agentId)));
+      let w = saved.workspaces.find(w => w.enable_tracking && !w.archived && (w.mainAgentId === request.agentId || w.batches.some(b => b.recipientAgentId === request.agentId && !b.settledAt && b.tasks.every(t => t.kind === "inventory") && ["sending", "sent", "uncertain", "blocked"].includes(b.state))));
       if (!w && request.workspaceId && !saved.workspaces.some(w => w.id === request.workspaceId && (w.archived || w.mainAgentId !== request.agentId))) {
         const project = await gateway.projectForWorkspace(saved, request.workspaceId).catch(() => null);
         if (project?.enable_default_tracking) {
@@ -267,9 +264,10 @@ export default function contribute(server: PluginServerContext) {
         }
       }
       if (!w) return request;
-      return { ...request, env: { ...request.env, FOLLOW_THROUGH_CLI: bridge, FOLLOW_THROUGH_CLIENT_ENTRY: clientEntry(), ...(w.mainAgentId !== request.agentId ? { FOLLOW_THROUGH_RECOVERY: "1" } : {}) } };
+      const recovery = w.mainAgentId !== request.agentId;
+      return withSessionMcp({ ...request, env: { ...request.env, FOLLOW_THROUGH_CLI: bridge, FOLLOW_THROUGH_CLIENT_ENTRY: clientEntry(), ...(recovery ? { FOLLOW_THROUGH_RECOVERY: "1" } : {}) } }, directory, clientEntry(), paseoHome, recovery);
     }),
-    server.on("agent.turn_ended", async event => {
+    server.on("agent.turn_ended", async (event, { paseo, signal }) => {
       await ready;
       if (stopped || loadError) return;
       const interruption = event.outcome.kind === "canceled" || event.outcome.kind === "failed" ? { turnId: event.turnId, at: new Date().toISOString(), kind: event.outcome.kind } : null;
@@ -281,9 +279,13 @@ export default function contribute(server: PluginServerContext) {
       }
       if (!(await store.snapshot()).workspaces.some(w => w.enable_tracking && w.mainAgentId === event.agent.id)) return;
       gateway.markDirty(event.agent.id);
-      await store.mutate(state => {
+      // Since Paseo 0.13 the lifecycle payload deliberately contains no history.
+      // Read a bounded tail through the plugin-owned API, outside the state lock.
+      const history = await paseo.agents.ref(event.agent.id).timeline.refetch({ direction: "tail", limit: 100, projection: "canonical" }).catch(() => null);
+      if (signal.aborted || stopped) return;
+      if (history) await store.mutate(state => {
         const w = state.workspaces.find(w => w.enable_tracking && w.mainAgentId === event.agent.id);
-        if (w) applyHistory(w, extractHistory(event.timeline), null);
+        if (w) applyHistory(w, extractHistory(history.entries.map(entry => entry.item), w.inventory?.historyComplete ?? false, w.inventory?.historyError ?? null), null);
       });
       const guarded = interruption && await sessionGuardOwnsInterruption(event.agent.id, interruption).catch(() => false);
       if (["canceled", "failed"].includes(event.outcome.kind) && !guarded) await store.mutate(state => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "paseo-follow-up",
   "private": false,
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Track workspace pull requests, queue follow-up work, and verify completion in Paseo.",
   "type": "module",
   "files": [
@@ -28,8 +28,8 @@
     "prepare": "node scripts/build.mjs"
   },
   "devDependencies": {
-    "@getpaseo/client": "0.11.0",
-    "@getpaseo/plugin": "0.11.0",
+    "@getpaseo/client": "0.14.0",
+    "@getpaseo/plugin": "0.14.0",
     "@tanstack/react-query": "^5.90.11",
     "@types/node": "^22.10.2",
     "@types/react": "~19.2.0",

package/paseo-plugin.json

@@ -7,6 +7,6 @@
     "docs/screenshots/follow-up-overview.png"
   ],
   "requirements": {
-    "paseo": ">=0.11.0"
+    "paseo": ">=0.14.0"
   }
 }

package/server/session-mcp.ts

@@ -0,0 +1,15 @@
+import type { PluginSessionOpenRequest } from "@getpaseo/plugin/server";
+import { mcpDefinition } from "./agent-mcp";
+
+/** The bridge and caller identity belong to this launch, never global CLI config. */
+export function withSessionMcp(request: PluginSessionOpenRequest, directory: string, clientEntry: string, home: string, recovery: boolean, env: NodeJS.ProcessEnv = process.env): PluginSessionOpenRequest {
+  if (request.purpose !== "interactive" || !["claude", "codex"].includes(request.provider) || request.labels["plugin-tools/enabled"] === "false") return request;
+  const definition = mcpDefinition(directory, clientEntry, home);
+  return { ...request, mcpServers: { ...request.mcpServers, "follow-through": { ...definition, env: {
+    ...definition.env, PASEO_AGENT_ID: request.agentId,
+    ...(recovery ? { FOLLOW_THROUGH_RECOVERY: "1" } : {}),
+    ...(env.PASEO_DAEMON_URL ? { PASEO_DAEMON_URL: env.PASEO_DAEMON_URL } : {}),
+    ...(env.PASEO_PASSWORD ? { PASEO_PASSWORD: env.PASEO_PASSWORD } : {}),
+    ...(env.PASEO_PASSWORD_FILE ? { PASEO_PASSWORD_FILE: env.PASEO_PASSWORD_FILE } : {}),
+  } } } };
+}