granttap-mcp 0.8.94 → 0.8.95

package/apps/bridge/src/mesh/runtime/prepared-transfer/README.md

@@ -25,6 +25,10 @@ provider. Rejected preparations also publish their retained Project state.
 
 Capsule status is bounded independently from the complete conversation capture;
 a long native summary cannot invalidate an otherwise transferable Git Task.
+Local prepared handoffs persist their destination and validated receipt before
+publishing to the phone. A blocked socket cannot hold the local preparation
+behind a notification. Publication errors retain both durable events for the
+next snapshot; they never replay the transfer or start a provider.
 
 Tests: `tests/metadata.test.ts`, `tests/source-checkout.test.ts`,
 `tests/mesh/mesh-handoff-safety.test.ts`, and catalog

package/apps/bridge/src/mesh/runtime/prepared-transfer/local.ts

@@ -0,0 +1,23 @@
+import type { RelayClient } from '../../../../../../packages/core/relay-client';
+import type { MeshEvent } from '../../../../../../packages/protocol/schema';
+import type { MeshRuntimeDependencies } from '../dependencies';
+import { createHandoffFlow } from '../handoff';
+import { preparedHandoffMetadata } from '.';
+
+/** Commit the local destination before phone publication can wait on a socket. */
+export async function prepareLocalHandoff(deps: MeshRuntimeDependencies, client: RelayClient,
+  event: MeshEvent): Promise<boolean> {
+  const notifications: Parameters<MeshRuntimeDependencies['send']>[] = [];
+  const flow = createHandoffFlow({ ...deps, send: async (...notification) => { notifications.push(notification); } });
+  await flow.acceptHandoff(client, event);
+  const accepted = notifications.some(([, payload]) => payload.type === 'mesh.event'
+    && payload.eventType === 'HANDOFF_ACCEPTED');
+  const request: Parameters<MeshRuntimeDependencies['send']> = [client, preparedHandoffMetadata(event),
+    { ttlMs: 60 * 60_000, wake: true }];
+  for (const notification of [request, ...notifications]) {
+    // Both events are durable already. A transport error cannot undo the
+    // prepared chat or trigger a second preparation; retained snapshots recover it.
+    try { await deps.send(...notification); } catch { /* next connection publishes durable state */ }
+  }
+  return accepted;
+}

package/apps/bridge/src/mesh/runtime/prepared-transfer/prepare.ts

@@ -6,6 +6,7 @@ import { prepareCloudHandoff } from "../cloud-handoff";
 import { capturePreparedHandoff, preparedHandoffMetadata } from ".";
 import { prepareSourceCapsule } from "./source";
 import { resolveHandoffSource } from "./source-binding";
+import { prepareLocalHandoff } from "./local";
 
 export async function prepareHandoff(
   deps: MeshRuntimeDependencies,
@@ -86,6 +87,7 @@ export async function prepareHandoff(
     return false;
   }
   deps.store().acceptEvent(event);
+  if (local && request.prepareOnly) return prepareLocalHandoff(deps, client, event);
   await deps.send(client, request.prepareOnly ? preparedHandoffMetadata(event) : event, { ttlMs: 60 * 60_000, wake: true });
   if (local) await acceptHandoff(client, event);
   return true;

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.94
+npm install -g granttap-mcp@0.8.95
 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.94\";\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 22.13.0+ 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.95\";\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 22.13.0+ 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.94";
+const PACKAGE = "granttap-mcp@0.8.95";
 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.94",
+  "version": "0.8.95",
   "description": "Commercial computer runtime connecting local coding agents to GrantTap on Mac, iPhone, iPad and Apple Watch.",
   "type": "module",
   "bin": {

package/packages/core/outbound-scheduler/README.md

@@ -3,7 +3,8 @@
 Public entry point: `index.ts`. Preserves per-peer encrypted envelopes while
 pacing a connection below the managed relay's 300-frame-per-second admission
 limit. Explicit approval and configuration messages take priority over queued
-replaceable snapshots. TCP write completion, bounded queued bytes, cancellation
+replaceable snapshots. Encrypted results explicitly marked for wake delivery
+also precede replaceable snapshots, including sealed transfer receipts. TCP write completion, bounded queued bytes, cancellation
 on disconnect, and a fresh queue on reconnect prevent stale bursts from crossing
 connection generations. No message content or keys are logged.
 

package/packages/core/outbound-scheduler/index.ts

@@ -83,6 +83,6 @@ export async function sendEncryptedPayload(queue: OutboundFrameQueue, config: Pe
   if (!peers.length) throw new Error("no authorized pairing peers");
   for (const peerPublicKey of peers) {
     await queue.send(sealEnvelope({ ...config, peerPublicKey }, payload, to,
-      peers.length === 1 ? options : { ...options, deliveryId: undefined }), control(payload.type));
+      peers.length === 1 ? options : { ...options, deliveryId: undefined }), control(payload.type) || options.wake === true);
   }
 }