granttap-mcp 0.8.23 → 0.8.24

package/README.md

@@ -43,6 +43,11 @@ hosted service is governed by its own terms.
 GrantTap reports the depth each provider actually exposes. Visibility does not
 imply deterministic remote blocking or full mobile continuation.
 
+Session catalogs report `lastMessageAt` only when a provider transcript has a
+timestamped user or assistant message. `lastActivityAt` remains the separate
+runtime activity timestamp and can include metadata or file updates. Clients
+label that fallback as activity rather than presenting it as a message time.
+
 ## Project Mesh and task handoff
 
 Project Mesh adds stable Project and Task identity above provider-native

package/apps/bridge/src/sessions/cursor/scan.ts

@@ -137,6 +137,8 @@ function addComposerSession(context: ScanContext, composer: ComposerRow): void {
     sessionId: composer.id, files, cwd: composer.cwd, composers: context.composers, descendants,
   });
   const childLast = child.children.reduce((latest, item) => Math.max(latest, item.lastActivityAt), 0);
+  const lastMessageAt = Math.max(root.lastMessageAt ?? 0,
+    ...child.summaries.map((item) => item.lastMessageAt ?? 0));
   const lastActivityAt = Math.max(
     composerActivityAt(composer), root.lastActivityAt, childLast,
   );
@@ -153,6 +155,7 @@ function addComposerSession(context: ScanContext, composer: ComposerRow): void {
       root.startedAt || lastActivityAt || context.now,
     ),
     lastActivityAt: lastActivityAt || composer.createdAt,
+    ...(lastMessageAt ? { lastMessageAt } : {}),
     tokensSession,
     tokensLastTurn: root.files.length ? root.tokensLastTurn : 0,
     contextTokensUsed: composer.contextTokensUsed ?? root.contextTokensUsed ?? tokensSession,
@@ -175,6 +178,8 @@ function addOrphanSession(context: ScanContext, file: CursorLogFile): void {
   const root = transcriptSummary(sessionId, files.filter((item) => !item.isSubagent), sessionId, cwd);
   const child = childSummaries({ sessionId, files, cwd, composers: context.composers });
   const childLast = child.children.reduce((latest, item) => Math.max(latest, item.lastActivityAt), 0);
+  const lastMessageAt = Math.max(root.lastMessageAt ?? 0,
+    ...child.summaries.map((item) => item.lastMessageAt ?? 0));
   const lastActivityAt = Math.max(file.mtimeMs, root.lastActivityAt, childLast);
   const title = childTitle(context.sidebar.get(sessionId) || root.titleFromUser);
   const session = aggregateChildThreads({
@@ -185,6 +190,7 @@ function addOrphanSession(context: ScanContext, file: CursorLogFile): void {
     state: stateFor(lastActivityAt),
     startedAt: Math.min(file.birthtimeMs || lastActivityAt, root.startedAt || lastActivityAt),
     lastActivityAt,
+    ...(lastMessageAt ? { lastMessageAt } : {}),
     tokensSession: root.tokensSession,
     tokensLastTurn: root.tokensLastTurn,
     contextTokensUsed: root.contextTokensUsed,

package/apps/bridge/src/sessions/cursor/transcripts.ts

@@ -25,6 +25,7 @@ export type CursorLogFile = {
 
 export type CursorTranscriptSummary = {
   lastActivityAt: number;
+  lastMessageAt?: number;
   startedAt: number;
   files: string[];
   model?: string;
@@ -196,6 +197,11 @@ function summarizeFile(
     const item = safeParse(line);
     if (!item) continue;
     observeBlocks({ item, file, lineIndex, rootSessionId, cwd, acc });
+    if (["user", "assistant"].includes(item.role)
+      && textBlocks(item.message?.content).some((text) => !!text.trim())) {
+      const at = ts(item.timestamp ?? item.message?.timestamp);
+      if (at) acc.lastMessageAt = Math.max(acc.lastMessageAt ?? 0, at);
+    }
     if (!file.isSubagent) {
       if (!acc.titleFromUser && item.role === "user") {
         acc.titleFromUser = titleFrom(textBlocks(item.message?.content).join("\n"));

package/apps/bridge/src/sessions/scan/claude/parse.ts

@@ -24,6 +24,7 @@ type ClaudeParseState = {
   summary?: string;
   startedAt: number;
   lastActivityAt: number;
+  lastMessageAt: number;
   tokensSession: number;
   tokensLastTurn: number;
   contextTokensUsed?: number;
@@ -53,6 +54,15 @@ function applyClaudeLine(d: any, state: ClaudeParseState): void {
   if (t) {
     if (!state.startedAt || t < state.startedAt) state.startedAt = t;
     if (t > state.lastActivityAt) state.lastActivityAt = t;
+    const role = d.message?.role ?? d.type;
+    const content = d.message?.content ?? d.content;
+    const visible = typeof content === "string" ? content.trim().length > 0
+      : Array.isArray(content) && content.some((block: any) =>
+        ["text", "image", "image_url", "input_image"].includes(block?.type)
+          && (block.type !== "text" || typeof block.text === "string" && !!block.text.trim()));
+    if (["user", "assistant"].includes(role) && visible) {
+      state.lastMessageAt = Math.max(state.lastMessageAt, t);
+    }
   }
   const usage = d?.message?.usage;
   if (usage) {
@@ -117,7 +127,10 @@ export function parseClaudeFile(file: string): {
     return undefined;
   }
   const lines = text.split("\n");
-  const state: ClaudeParseState = { sessionId: "", startedAt: 0, lastActivityAt: 0, tokensSession: 0, tokensLastTurn: 0 };
+  const state: ClaudeParseState = {
+    sessionId: "", startedAt: 0, lastActivityAt: 0, lastMessageAt: 0,
+    tokensSession: 0, tokensLastTurn: 0,
+  };
   for (const line of lines) {
     if (!line) continue;
     const d = safeParse(line);
@@ -135,6 +148,7 @@ export function parseClaudeFile(file: string): {
     state: stateFor(state.lastActivityAt),
     startedAt: state.startedAt || state.lastActivityAt,
     lastActivityAt: state.lastActivityAt,
+    ...(state.lastMessageAt ? { lastMessageAt: state.lastMessageAt } : {}),
     tokensSession: state.tokensSession,
     tokensLastTurn: state.tokensLastTurn,
     contextTokensUsed: state.contextTokensUsed,

package/apps/bridge/src/sessions/scan/codex/parse.ts

@@ -27,6 +27,7 @@ type CodexParseState = {
   child?: CodexChildSource;
   startedAt: number;
   lastActivityAt: number;
+  lastMessageAt: number;
   tokensSession: number;
   tokensLastTurn: number;
   contextTokensUsed?: number;
@@ -40,6 +41,15 @@ function applyCodexLine(d: any, state: CodexParseState): void {
   if (t) {
     if (!state.startedAt || t < state.startedAt) state.startedAt = t;
     if (t > state.lastActivityAt) state.lastActivityAt = t;
+    const eventMessage = d.type === "event_msg"
+      && ["user_message", "agent_message"].includes(d.payload?.type);
+    const responseMessage = d.type === "response_item"
+      && d.payload?.type === "message"
+      && ["user", "assistant"].includes(d.payload?.role)
+      && Array.isArray(d.payload?.content) && d.payload.content.length > 0;
+    if (eventMessage || responseMessage) {
+      state.lastMessageAt = Math.max(state.lastMessageAt, t);
+    }
   }
 
   if (d.type === "session_meta") {
@@ -130,7 +140,7 @@ export function parseCodexFile(file: string): CodexCandidate | undefined {
     return undefined;
   }
   const state: CodexParseState = {
-    sessionId: "", startedAt: 0, lastActivityAt: 0,
+    sessionId: "", startedAt: 0, lastActivityAt: 0, lastMessageAt: 0,
     tokensSession: 0, tokensLastTurn: 0, workdirs: [],
   };
   for (const line of lines) {
@@ -155,6 +165,7 @@ export function parseCodexFile(file: string): CodexCandidate | undefined {
     state: stateFor(state.lastActivityAt),
     startedAt: state.startedAt || state.lastActivityAt,
     lastActivityAt: state.lastActivityAt,
+    ...(state.lastMessageAt ? { lastMessageAt: state.lastMessageAt } : {}),
     tokensSession: state.tokensSession,
     tokensLastTurn: state.tokensLastTurn,
     contextTokensUsed: state.contextTokensUsed,

package/apps/bridge/src/sessions/scan/grok.ts

@@ -32,6 +32,7 @@ type ParsedLog = {
   entries: ActivityEntry[];
   usage: CapabilityObservation[];
   firstUser?: string;
+  lastMessageAt?: number;
   tokens: number;
   lastTurn: number;
 };
@@ -78,6 +79,7 @@ function parseLog(path: string, sessionId: string, fallbackTime: number): Parsed
   const usage: CapabilityObservation[] = [];
   const seen = new Set<string>();
   let firstUser: string | undefined;
+  let lastMessageAt = 0;
   let tokens = 0;
   let lastTurn = 0;
   lines.forEach((line, index) => {
@@ -86,11 +88,13 @@ function parseLog(path: string, sessionId: string, fallbackTime: number): Parsed
     const message = row.message && typeof row.message === "object" ? row.message : row;
     const role = String(message.role ?? row.role ?? "");
     if (role === "reasoning" || role === "system") return;
-    const createdAt = ts(row.timestamp ?? message.timestamp) || fallbackTime + index;
+    const messageAt = ts(row.timestamp ?? message.timestamp);
+    const createdAt = messageAt || fallbackTime + index;
     const texts = textBlocks(message.content);
     if (role === "user") {
       const text = texts.join("\n").trim();
       if (text) {
+        if (messageAt) lastMessageAt = Math.max(lastMessageAt, messageAt);
         firstUser ??= text;
         pushEntry({ out: entries, seen: seen, sessionId: sessionId, kind: "user", text: text, createdAt: createdAt, ordinal: index });
         tokens += estimateTokens(text);
@@ -103,6 +107,9 @@ function parseLog(path: string, sessionId: string, fallbackTime: number): Parsed
       pushEntry({ out: entries, seen: seen, sessionId: sessionId, kind: "message", text: text, createdAt: createdAt, ordinal: index * 100 + block });
       turnTokens += estimateTokens(text);
     });
+    if (texts.some((text) => !!text.trim()) && messageAt) {
+      lastMessageAt = Math.max(lastMessageAt, messageAt);
+    }
     const blocks = Array.isArray(message.content) ? message.content : [];
     blocks.forEach((block: Record<string, unknown>, blockIndex: number) => {
       if (block?.type !== "tool_use") return;
@@ -122,7 +129,7 @@ function parseLog(path: string, sessionId: string, fallbackTime: number): Parsed
     tokens += turnTokens;
     if (turnTokens > 0) lastTurn = turnTokens;
   });
-  return { entries, usage, firstUser, tokens, lastTurn };
+  return { entries, usage, firstUser, lastMessageAt: lastMessageAt || undefined, tokens, lastTurn };
 }
 
 function parseSummary(path: string): Summary | null {
@@ -156,6 +163,7 @@ export function scanGrok(maxFiles = MAX_FILES): Scan {
       sessionId, agent: "grok", title: title?.trim().slice(0, 120), cwd,
       model: typeof summary.current_model_id === "string" ? summary.current_model_id : undefined,
       state: stateFor(updatedAt), startedAt, lastActivityAt: updatedAt,
+      ...(parsed.lastMessageAt ? { lastMessageAt: parsed.lastMessageAt } : {}),
       tokensSession: parsed.tokens, tokensLastTurn: parsed.lastTurn,
       contextTokensUsed: parsed.tokens,
     });

package/cursor-plugin/.cursor-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "granttap",
   "displayName": "GrantTap",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "GrantTap pairs this computer with iPhone. The connection card shows a one-time QR when Cursor supports interactive MCP Apps; an interactive terminal command is available if it does not. The website approves the coding app.",
   "author": {
     "name": "GrantTap",

package/cursor-plugin/README.md

@@ -10,7 +10,7 @@ keeps each phone response tied to the exact originating chat and prompt.
 Install the supported CLI on this computer, then run:
 
 ```bash
-npm install -g granttap-mcp@0.8.23
+npm install -g granttap-mcp@0.8.24
 granttap setup
 granttap status
 ```

package/cursor-plugin/mcp.json

@@ -4,7 +4,7 @@
       "command": "node",
       "args": [
         "-e",
-        "\"use strict\";\n\n// Cursor may start this MCP from any cwd. Execute JavaScript entry points with\n// Node itself: Windows batch shims require shell quoting that differs by host.\nconst { spawn } = require(\"node:child_process\");\nconst { existsSync } = require(\"node:fs\");\nconst { delimiter, dirname, join } = require(\"node:path\");\n\nconst PACKAGE = \"granttap-mcp@0.8.23\";\nconst dryRun = process.env.GRANTTAP_BOOTSTRAP_DRY_RUN === \"1\";\nconst platform = dryRun && process.env.GRANTTAP_BOOTSTRAP_PLATFORM\n  ? process.env.GRANTTAP_BOOTSTRAP_PLATFORM : process.platform;\nconst nodeRoot = dryRun && process.env.GRANTTAP_BOOTSTRAP_NODE_ROOT\n  ? process.env.GRANTTAP_BOOTSTRAP_NODE_ROOT : dirname(process.execPath);\nconst pathRoots = (process.env.PATH || \"\").split(delimiter).filter(Boolean);\nconst appData = process.env.APPDATA;\nconst roots = [nodeRoot, ...pathRoots, ...(appData ? [join(appData, \"npm\")] : [])];\nconst first = (paths) => paths.find((path) => existsSync(path));\n\nfunction launch() {\n  if (platform !== \"win32\") {\n    const installed = first(roots.map((root) => join(root, \"granttap-mcp\")));\n    if (installed) return { command: installed, args: [] };\n    const npx = first(roots.map((root) => join(root, \"npx\"))) || \"npx\";\n    return { command: npx, args: [\"-y\", PACKAGE] };\n  }\n  const installed = first(roots.map((root) =>\n    join(root, \"node_modules\", \"granttap-mcp\", \"bin\", \"granttap-mcp.mjs\")));\n  if (installed) return { command: process.execPath, args: [installed] };\n  const npx = first(roots.map((root) =>\n    join(root, \"node_modules\", \"npm\", \"bin\", \"npx-cli.js\")));\n  if (npx) return { command: process.execPath, args: [npx, \"-y\", PACKAGE] };\n  throw new Error(\"Node.js/npm 20+ is required on this Windows device. Install npm and retry GrantTap.\");\n}\n\nlet target;\ntry { target = launch(); }\ncatch (error) {\n  process.stderr.write(`[granttap] ${error.message}\\n`);\n  process.exit(1);\n}\n\nif (dryRun) {\n  process.stdout.write(JSON.stringify(target));\n  process.exit(0);\n}\n\nconst child = spawn(target.command, target.args, { stdio: \"inherit\", windowsHide: true });\nchild.on(\"error\", (error) => {\n  process.stderr.write(`[granttap] ${error.message}\\n`);\n  process.exit(1);\n});\nchild.on(\"exit\", (code, signal) => {\n  if (signal && platform !== \"win32\") {\n    try { process.kill(process.pid, signal); } catch { process.exit(code ?? 1); }\n    return;\n  }\n  process.exit(code ?? 1);\n});\n"
+        "\"use strict\";\n\n// Cursor may start this MCP from any cwd. Execute JavaScript entry points with\n// Node itself: Windows batch shims require shell quoting that differs by host.\nconst { spawn } = require(\"node:child_process\");\nconst { existsSync } = require(\"node:fs\");\nconst { delimiter, dirname, join } = require(\"node:path\");\n\nconst PACKAGE = \"granttap-mcp@0.8.24\";\nconst dryRun = process.env.GRANTTAP_BOOTSTRAP_DRY_RUN === \"1\";\nconst platform = dryRun && process.env.GRANTTAP_BOOTSTRAP_PLATFORM\n  ? process.env.GRANTTAP_BOOTSTRAP_PLATFORM : process.platform;\nconst nodeRoot = dryRun && process.env.GRANTTAP_BOOTSTRAP_NODE_ROOT\n  ? process.env.GRANTTAP_BOOTSTRAP_NODE_ROOT : dirname(process.execPath);\nconst pathRoots = (process.env.PATH || \"\").split(delimiter).filter(Boolean);\nconst appData = process.env.APPDATA;\nconst roots = [nodeRoot, ...pathRoots, ...(appData ? [join(appData, \"npm\")] : [])];\nconst first = (paths) => paths.find((path) => existsSync(path));\n\nfunction launch() {\n  if (platform !== \"win32\") {\n    const installed = first(roots.map((root) => join(root, \"granttap-mcp\")));\n    if (installed) return { command: installed, args: [] };\n    const npx = first(roots.map((root) => join(root, \"npx\"))) || \"npx\";\n    return { command: npx, args: [\"-y\", PACKAGE] };\n  }\n  const installed = first(roots.map((root) =>\n    join(root, \"node_modules\", \"granttap-mcp\", \"bin\", \"granttap-mcp.mjs\")));\n  if (installed) return { command: process.execPath, args: [installed] };\n  const npx = first(roots.map((root) =>\n    join(root, \"node_modules\", \"npm\", \"bin\", \"npx-cli.js\")));\n  if (npx) return { command: process.execPath, args: [npx, \"-y\", PACKAGE] };\n  throw new Error(\"Node.js/npm 20+ is required on this Windows device. Install npm and retry GrantTap.\");\n}\n\nlet target;\ntry { target = launch(); }\ncatch (error) {\n  process.stderr.write(`[granttap] ${error.message}\\n`);\n  process.exit(1);\n}\n\nif (dryRun) {\n  process.stdout.write(JSON.stringify(target));\n  process.exit(0);\n}\n\nconst child = spawn(target.command, target.args, { stdio: \"inherit\", windowsHide: true });\nchild.on(\"error\", (error) => {\n  process.stderr.write(`[granttap] ${error.message}\\n`);\n  process.exit(1);\n});\nchild.on(\"exit\", (code, signal) => {\n  if (signal && platform !== \"win32\") {\n    try { process.kill(process.pid, signal); } catch { process.exit(code ?? 1); }\n    return;\n  }\n  process.exit(code ?? 1);\n});\n"
       ]
     }
   }

package/cursor-plugin/stdio-bootstrap.cjs

@@ -7,7 +7,7 @@ const { spawn } = require("node:child_process");
 const { existsSync } = require("node:fs");
 const { delimiter, dirname, join } = require("node:path");
 
-const PACKAGE = "granttap-mcp@0.8.23";
+const PACKAGE = "granttap-mcp@0.8.24";
 const dryRun = process.env.GRANTTAP_BOOTSTRAP_DRY_RUN === "1";
 const platform = dryRun && process.env.GRANTTAP_BOOTSTRAP_PLATFORM
   ? process.env.GRANTTAP_BOOTSTRAP_PLATFORM : process.platform;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "granttap-mcp",
-  "version": "0.8.23",
+  "version": "0.8.24",
   "description": "Personal live control center runtime for local coding agents on iPhone and Apple Watch.",
   "type": "module",
   "bin": {

package/packages/protocol/messages/sessions/index.ts

@@ -74,6 +74,8 @@ export const SessionInfo = z.object({
   state: SessionState,
   startedAt: z.number(),
   lastActivityAt: z.number(),
+  /** Timestamp of a visible user or assistant message; absent when no message timestamp is known. */
+  lastMessageAt: z.number().optional(),
   tokensSession: z.number(),
   tokensLastTurn: z.number(),
   contextTokensUsed: z.number().optional(),