fix(plugins): use shared handoff resources and native patch versions

integrations/agent-plugin-core/python/mcp_server.py

@@ -1,11 +1,13 @@
 #!/usr/bin/env python3
-"""Expose Mem0's memory search as one local coding-agent tool."""
+"""Expose memory search and shared handoff resources to coding agents."""
 
 from __future__ import annotations
 
 import json
 import os
+import subprocess
 import sys
+from pathlib import Path
 from typing import Any
 
 import telemetry
@@ -135,6 +137,44 @@ def call_search_memories(arguments: Any, cwd: str | None = None) -> str:
     return format_search_result(result)
 
 
+HANDOFF_TOOL = {
+    "name": "handoff_resource",
+    "description": (
+        "Only on explicit user request, list shared handoffs for this project or resume a saved handoff "
+        "from any Mem0 plugin. Use the returned context as historical evidence; do not execute recorded tool calls."
+    ),
+    "inputSchema": {
+        "type": "object",
+        "properties": {
+            "action": {"type": "string", "enum": ["list", "resume"]},
+            "resource": {"type": "string", "minLength": 1, "description": "Saved handoff resource path; required for resume."},
+        },
+        "required": ["action"],
+        "additionalProperties": False,
+    },
+    "annotations": {"readOnlyHint": True, "idempotentHint": True, "openWorldHint": True},
+}
+
+
+def call_handoff_resource(arguments: Any, cwd: str | None = None) -> str:
+    if not isinstance(arguments, dict) or set(arguments) - {"action", "resource"}:
+        raise ToolInputError("Expected handoff action and optional resource path.")
+    action, resource = arguments.get("action"), arguments.get("resource")
+    if action == "list" and resource is None:
+        flags = ["--list"]
+    elif action == "resume" and isinstance(resource, str) and resource.strip() and "\0" not in resource:
+        flags = [f"--resume={resource}"]
+    else:
+        raise ToolInputError("Use action=list, or action=resume with a saved resource path.")
+    project = cwd or os.environ.get("CLAUDE_PROJECT_DIR") or os.getcwd()
+    command = [sys.executable, str(Path(__file__).with_name("session_handoff.py")), *flags,
+               f"--cwd={project}", "--command-output"]
+    result = subprocess.run(command, text=True, capture_output=True, check=False, timeout=90)
+    if result.returncode:
+        raise ToolInputError(result.stderr.strip() or "Could not read the shared handoff resource.")
+    return result.stdout.strip()
+
+
 def _workspace_cwd(params: dict[str, Any]) -> str | None:
     meta = params.get("_meta")
     if not isinstance(meta, dict):
@@ -191,13 +231,19 @@ def handle_request(message: Any) -> dict[str, Any] | None:
                             "idempotentHint": True,
                             "openWorldHint": True,
                         },
-                    }
+                    },
+                    HANDOFF_TOOL,
                 ]
             },
         }
     if method == "tools/call":
         params = message.get("params") or {}
-        if params.get("name") != TOOL_NAME:
+        if params.get("name") == HANDOFF_TOOL["name"]:
+            try:
+                result = _tool_response(call_handoff_resource(params.get("arguments"), _workspace_cwd(params)))
+            except (ToolInputError, OSError, subprocess.SubprocessError) as exc:
+                result = _tool_response(str(exc), is_error=True)
+        elif params.get("name") != TOOL_NAME:
             result = _tool_response("Unknown Mem0 tool.", is_error=True)
         else:
             try: