handoff-mcp-server 0.8.0 → 0.8.1

package/Cargo.lock

@@ -144,7 +144,7 @@ dependencies = [
 
 [[package]]
 name = "handoff-mcp"
-version = "0.8.0"
+version = "0.8.1"
 dependencies = [
  "anyhow",
  "chrono",

package/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "handoff-mcp"
-version = "0.8.0"
+version = "0.8.1"
 edition = "2021"
 description = "MCP server that gives AI coding agents persistent memory across sessions"
 license = "MIT"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "handoff-mcp-server",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "MCP server that gives AI coding agents persistent memory across sessions",
   "license": "MIT",
   "author": "AlphaElements <66808803+alphaelements@users.noreply.github.com>",

package/src/mcp/handlers/import_context.rs

@@ -49,6 +49,11 @@ pub fn handle(arguments: &Value) -> Result<String> {
         }
     }
 
+    let skip_session_close = arguments
+        .get("skip_session_close")
+        .and_then(|v| v.as_bool())
+        .unwrap_or(false);
+
     let mut session_saved = false;
     if let Some(session) = arguments.get("session") {
         let summary = session
@@ -58,7 +63,9 @@ pub fn handle(arguments: &Value) -> Result<String> {
                 anyhow::anyhow!("'session.summary' is required when session is provided")
             })?;
 
-        close_active_sessions(&sessions_dir)?;
+        if !skip_session_close {
+            close_active_sessions(&sessions_dir)?;
+        }
         let git_state = capture_git_state(&project_dir)?;
         let now = Utc::now().to_rfc3339();
 
@@ -118,7 +125,9 @@ pub fn handle(arguments: &Value) -> Result<String> {
         session_saved = true;
     } else if let Some(raw_notes) = arguments.get("raw_notes").and_then(|v| v.as_str()) {
         if !raw_notes.is_empty() {
-            close_active_sessions(&sessions_dir)?;
+            if !skip_session_close {
+                close_active_sessions(&sessions_dir)?;
+            }
             let git_state = capture_git_state(&project_dir)?;
             let now = Utc::now().to_rfc3339();
 

package/src/mcp/handlers/save_context.rs

@@ -21,11 +21,6 @@ pub fn handle(arguments: &Value) -> Result<String> {
     let sessions_dir = handoff.join("sessions");
     let config_path = handoff.join("config.toml");
 
-    let summary = arguments
-        .get("summary")
-        .and_then(|v| v.as_str())
-        .ok_or_else(|| anyhow::anyhow!("'summary' is required"))?;
-
     let close_id = arguments.get("close_session_id").and_then(|v| v.as_str());
     let pause_id = arguments.get("pause_session_id").and_then(|v| v.as_str());
     let pause_all = arguments
@@ -37,6 +32,19 @@ pub fn handle(arguments: &Value) -> Result<String> {
         .and_then(|v| v.as_str())
         .unwrap_or("open");
 
+    let is_pause_only = arguments
+        .get("pause_only")
+        .and_then(|v| v.as_bool())
+        .unwrap_or(false);
+
+    let summary_opt = arguments.get("summary").and_then(|v| v.as_str());
+
+    if !is_pause_only && summary_opt.is_none() {
+        anyhow::bail!("'summary' is required (unless pause_only=true)");
+    }
+
+    let summary = summary_opt.unwrap_or("");
+
     if session_status != "open" && session_status != "active" {
         anyhow::bail!(
             "Invalid session_status '{}': must be 'open' or 'active'",
@@ -53,6 +61,27 @@ pub fn handle(arguments: &Value) -> Result<String> {
         total_paused = pause_active_sessions(&sessions_dir)?.len();
     }
 
+    if is_pause_only {
+        let mut msg = String::new();
+        if total_paused > 0 {
+            msg.push_str(&format!("Paused {} session(s)", total_paused));
+        }
+        if let Some(id) = pause_id {
+            if total_paused == 0 {
+                msg.push_str(&format!(
+                    "Warning: pause_session_id '{id}' not found among active/open sessions"
+                ));
+            }
+        }
+        if !pause_all && pause_id.is_none() {
+            msg.push_str("Warning: pause_only=true requires pause_session_id or pause_active=true");
+        }
+        if msg.is_empty() {
+            msg.push_str("No sessions were paused (none active)");
+        }
+        return Ok(msg);
+    }
+
     let total_closed = if let Some(id) = close_id {
         let closed = close_session_by_id(&sessions_dir, id)?;
         if closed.is_some() {
@@ -124,7 +153,7 @@ pub fn handle(arguments: &Value) -> Result<String> {
     if let Some(id) = pause_id {
         if total_paused == 0 {
             msg.push_str(&format!(
-                "\nWarning: pause_session_id '{id}' not found among active sessions"
+                "\nWarning: pause_session_id '{id}' not found among active/open sessions"
             ));
         }
     }

package/src/mcp/tools.rs

@@ -75,6 +75,10 @@ pub fn all_tool_definitions() -> Vec<ToolDefinition> {
                         "type": "boolean",
                         "description": "If true, pause all active sessions instead of closing them. Cannot be combined with close_session_id."
                     },
+                    "pause_only": {
+                        "type": "boolean",
+                        "description": "If true, only pause sessions (via pause_session_id or pause_active) without creating a new session. Useful for session switching. When true, summary is optional."
+                    },
                     "decisions": {
                         "type": "array",
                         "description": "Decisions made during this session",
@@ -479,6 +483,10 @@ pub fn all_tool_definitions() -> Vec<ToolDefinition> {
                     "raw_notes": {
                         "type": "string",
                         "description": "Free-form text that couldn't be structured. Saved as a handoff_note with category 'context'."
+                    },
+                    "skip_session_close": {
+                        "type": "boolean",
+                        "description": "If true, do not close active sessions before creating the import session. Default false."
                     }
                 },
                 "required": ["source"],

package/src/storage/sessions.rs

@@ -273,7 +273,10 @@ pub fn pause_active_sessions(sessions_dir: &Path) -> Result<Vec<PathBuf>> {
 }
 
 pub fn pause_session_by_id(sessions_dir: &Path, session_id: &str) -> Result<Option<PathBuf>> {
-    transition_session_by_id(sessions_dir, session_id, "active", "paused")
+    if let Some(path) = transition_session_by_id(sessions_dir, session_id, "active", "paused")? {
+        return Ok(Some(path));
+    }
+    transition_session_by_id(sessions_dir, session_id, "open", "paused")
 }
 
 pub fn resume_paused_session_by_id(