hipcortex 3.11.0__tar.gz → 3.13.0__tar.gz

{hipcortex-3.11.0 → hipcortex-3.13.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: hipcortex
-Version: 3.11.0
-Summary: Cognitive state substrate for AI agents — Python SDK + CLI. Universal server-side passive capture (any channel, zero client changes); ships the 61-tool / 7-resource MCP server; hard single-role runner, observation-content predicate scorer, GoalRevision→ClarifyEngine, 24h field log, WAL-persistent. LangChain, AutoGen, CrewAI, MCP
+Version: 3.13.0
+Summary: Cognitive state substrate for AI agents — Python SDK + CLI. Graceful shutdown + auto-backup (POST /v1/backup tars 4 data files); actor merge (merge_actor MCP tool); snapshot CLI; VSIX dedup guard; schema-compat proven; universal passive capture; 62-tool / 7-resource MCP server; WAL-persistent. LangChain, AutoGen, CrewAI, MCP
 Author: HipCortex Contributors
 License: Apache-2.0
 Project-URL: Homepage, https://github.com/farmountain/HipCortex
@@ -42,7 +42,7 @@ Requires-Dist: mem0ai>=0.1; extra == "all"
 Requires-Dist: tabulate>=0.9; extra == "all"
 Dynamic: requires-python
 
-# HipCortex Python SDK (`v3.11.0`)
+# HipCortex Python SDK (`v3.12.0`)
 
 **Persistent causal topological memory, recursive Bayesian world-model prediction (`/worldmodel/rollout`), and automatic FSM skill compilation for autonomous AI agents.**
 
@@ -55,11 +55,11 @@ Runs against the standalone local Rust binary (`http://127.0.0.1:3030`) with `0.
 ```bash
 pip install hipcortex
 hipcortex doctor   # verify server health + version after install
-hipcortex install  # wizard: MCP hosts + copies ~/.hipcortex-mcp/server.py (61 tools)
+hipcortex install  # wizard: MCP hosts + copies ~/.hipcortex-mcp/server.py (62 tools)
 hipcortex channels # honesty matrix (native / mcp / framework / guide)
 ```
 
-**Version matrix:** product pip/Cargo/MCP `serverInfo` = **3.11.0**; VS Code VSIX = **3.11.0**. See [docs/channels.md](../../docs/channels.md).
+**Version matrix:** product pip/Cargo/MCP `serverInfo` = **3.12.0**; VS Code VSIX = **3.12.0**. See [docs/channels.md](../../docs/channels.md).
 
 ---
 

{hipcortex-3.11.0 → hipcortex-3.13.0}/README.md

@@ -1,4 +1,4 @@
-# HipCortex Python SDK (`v3.11.0`)
+# HipCortex Python SDK (`v3.12.0`)
 
 **Persistent causal topological memory, recursive Bayesian world-model prediction (`/worldmodel/rollout`), and automatic FSM skill compilation for autonomous AI agents.**
 
@@ -11,11 +11,11 @@ Runs against the standalone local Rust binary (`http://127.0.0.1:3030`) with `0.
 ```bash
 pip install hipcortex
 hipcortex doctor   # verify server health + version after install
-hipcortex install  # wizard: MCP hosts + copies ~/.hipcortex-mcp/server.py (61 tools)
+hipcortex install  # wizard: MCP hosts + copies ~/.hipcortex-mcp/server.py (62 tools)
 hipcortex channels # honesty matrix (native / mcp / framework / guide)
 ```
 
-**Version matrix:** product pip/Cargo/MCP `serverInfo` = **3.11.0**; VS Code VSIX = **3.11.0**. See [docs/channels.md](../../docs/channels.md).
+**Version matrix:** product pip/Cargo/MCP `serverInfo` = **3.12.0**; VS Code VSIX = **3.12.0**. See [docs/channels.md](../../docs/channels.md).
 
 ---
 

{hipcortex-3.11.0 → hipcortex-3.13.0}/hipcortex/__init__.py

@@ -6,7 +6,7 @@ from .langchain_memory import HipCortexMemory, AsyncHipCortexMemory
 from .llamaindex_storage import HipCortexStorageContext
 from .substrate import HipCortexSubstrate
 
-__version__ = "3.11.0"
+__version__ = "3.13.0"
 __all__ = [
     "HipCortexClient",
     "AsyncHipCortexClient",

{hipcortex-3.11.0 → hipcortex-3.13.0}/hipcortex/cli.py

@@ -1335,6 +1335,29 @@ def cmd_restore(args: argparse.Namespace) -> None:
         __import__('sys').exit(1)
 
 
+def cmd_snapshot(args: argparse.Namespace) -> None:
+    """Trigger server-side full data-directory backup (tar.gz)."""
+    import json, urllib.request, urllib.error
+    url = (getattr(args, "url", None) or os.environ.get("HIPCORTEX_URL", DEFAULT_URL)).rstrip("/")
+    req = urllib.request.Request(
+        f"{url}/v1/backup",
+        data=b"{}",
+        headers={"Content-Type": "application/json"},
+        method="POST",
+    )
+    try:
+        with urllib.request.urlopen(req, timeout=30) as r:
+            result = json.loads(r.read().decode("utf-8"))
+        if result.get("ok"):
+            print(f"✓ Snapshot created: {result.get('path', '(server did not return path)')}")
+        else:
+            print(f"✗ Snapshot failed: {result.get('error', 'unknown')}", file=__import__('sys').stderr)
+            __import__('sys').exit(1)
+    except Exception as e:
+        print(f"✗ Snapshot failed: {e}", file=__import__('sys').stderr)
+        __import__('sys').exit(1)
+
+
 def _channels_yaml_candidates() -> list[Path]:
     """Resolve docs/channels.yaml from repo checkout or CWD."""
     here = Path(__file__).resolve()
@@ -1380,7 +1403,7 @@ def _fallback_channels() -> list[dict]:
         {"id": "claude-code", "name": "Claude Code", "status": "native", "install": "hipcortex install"},
         {"id": "cursor", "name": "Cursor", "status": "mcp", "install": "hipcortex install"},
         {"id": "windsurf", "name": "Windsurf", "status": "mcp", "install": "hipcortex install"},
-        {"id": "vscode-extension", "name": "VS Code VSIX", "status": "native", "install": "hipcortex-memory-3.11.0.vsix"},
+        {"id": "vscode-extension", "name": "VS Code VSIX", "status": "native", "install": "hipcortex-memory-3.12.0.vsix"},
         {"id": "vscode-mcp", "name": "VS Code MCP", "status": "mcp", "install": "hipcortex install"},
         {"id": "cline", "name": "Cline", "status": "mcp", "install": "hipcortex install"},
         {"id": "roocode", "name": "RooCode", "status": "mcp", "install": "hipcortex install"},
@@ -1597,6 +1620,10 @@ def build_parser() -> argparse.ArgumentParser:
     p_restore.add_argument("file", help="Backup file path (.json)")
     p_restore.add_argument("--url", help="Server URL")
 
+    # snapshot
+    p_snapshot = sub.add_parser("snapshot", help="Trigger server-side data directory backup (tar.gz)")
+    p_snapshot.add_argument("--url", help="Server URL")
+
     # index
     p_index = sub.add_parser("index", help="Index a codebase into the HipCortex knowledge graph")
     p_index.add_argument("path", nargs="?", default=".", help="Directory or file to index (default: current dir)")
@@ -1666,6 +1693,8 @@ def main() -> None:
         cmd_backup(args)
     elif args.command == "restore":
         cmd_restore(args)
+    elif args.command == "snapshot":
+        cmd_snapshot(args)
     elif args.command == "index":
         cmd_index(args)
     elif args.command == "channels":

{hipcortex-3.11.0 → hipcortex-3.13.0}/hipcortex/client.py

@@ -10,7 +10,7 @@ import requests
 
 
 class HipCortexClient:
-    VERSION = "3.11.0"
+    VERSION = "3.12.0"
 
     """Synchronous HTTP client for the HipCortex memory server.
 

{hipcortex-3.11.0 → hipcortex-3.13.0}/hipcortex/install/mcp_server.py

@@ -33,7 +33,7 @@ import requests
 
 HIPCORTEX_URL = os.getenv("HIPCORTEX_URL", "http://localhost:3030").rstrip("/")
 API_KEY       = os.getenv("HIPCORTEX_API_KEY", "")
-TIMEOUT       = int(os.getenv("HIPCORTEX_TIMEOUT", "10"))
+TIMEOUT       = int(os.getenv("HIPCORTEX_TIMEOUT", "30"))
 
 # Session harness state (one MCP process lifetime). Soft substrate-first nudge:
 # prefer get_live_beliefs / reflect before search_memory. Never hard-blocks.
@@ -233,6 +233,22 @@ TOOLS = [
             },
         },
     },
+    {
+        "name": "merge_actor",
+        "description": (
+            "Move all memory records from one actor to another (MOVE semantics: "
+            "source actor records are deleted after being re-assigned to target). "
+            "Use to consolidate two agent identities or rename an actor."
+        ),
+        "inputSchema": {
+            "type": "object",
+            "required": ["source", "target"],
+            "properties": {
+                "source": {"type": "string", "description": "Actor whose records to move away from"},
+                "target": {"type": "string", "description": "Actor to receive the moved records"},
+            },
+        },
+    },
     {
         "name": "get_stats",
         "description": "Get memory store statistics: total records, types, unique actors.",
@@ -1043,7 +1059,14 @@ def handle_add_memory(args: dict) -> str:
         body["record_type"] = args["record_type"]
     if "ttl_seconds" in args:
         body["ttl_seconds"] = args["ttl_seconds"]
-    result = _post("/memory/add", body)
+    result = _req("POST", "/memory/add", body)
+    if "error" in result:
+        detail_str = result.get("detail", "")
+        try:
+            reason = json.loads(detail_str).get("error") or detail_str
+        except Exception:
+            reason = detail_str or result["error"]
+        return f"✗ Memory refused (HTTP {result.get('status', '?')}): {reason}"
     return f"✓ Memory stored (id: {result.get('record_id', 'unknown')})\n  [{args['action']}] {args['target']}"
 
 
@@ -1428,6 +1451,13 @@ def handle_forget_actor(args: dict) -> str:
     delta = {"type": "ForgetActor", "actor": actor}
     return json.dumps(_post("/v1/cognitive/transact", {"delta": delta, "actor": "mcp"}))
 
+def handle_merge_actor(args: dict) -> str:
+    source = args.get("source", "").strip()
+    target = args.get("target", "").strip()
+    if not source or not target:
+        raise ValueError("merge_actor requires 'source' and 'target'")
+    return json.dumps(_post("/v1/actor/merge", {"source": source, "target": target}))
+
 def handle_archive_record(args: dict) -> str:
     delta = {"type": "ArchiveRecord", "id": args["id"]}
     return json.dumps(_post("/v1/cognitive/transact", {"delta": delta, "actor": "mcp"}))
@@ -1777,6 +1807,7 @@ def dispatch_tool(name: str, args: dict) -> str:
         "add_memory":       handle_add_memory,
         "search_memory":    handle_search_memory,
         "forget_actor":     handle_forget_actor,
+        "merge_actor":      handle_merge_actor,
         "get_stats":        handle_get_stats,
         "search_code":      handle_search_code,
         "link_memories":    handle_link_memories,
@@ -1960,7 +1991,7 @@ def main() -> None:
             respond(id_, {
                 "protocolVersion": "2024-11-05",
                 "capabilities": {"tools": {}, "resources": {}},
-                "serverInfo": {"name": "hipcortex", "version": "3.11.0"},
+                "serverInfo": {"name": "hipcortex", "version": "3.13.0"},
             })
         elif method == "initialized":
             pass  # notification — no response

{hipcortex-3.11.0 → hipcortex-3.13.0}/hipcortex/install_hosts.py

@@ -77,6 +77,16 @@ def _desired_mcp_entry(server_url: str) -> dict:
     }
 
 
+def _is_vsix_managed_entry(entry: object) -> bool:
+    """True if entry was written by the VS Code extension (args[0] ends in launcher.py)."""
+    if not isinstance(entry, dict):
+        return False
+    args = entry.get("args")
+    if not isinstance(args, list) or not args:
+        return False
+    return str(args[0]).endswith("launcher.py")
+
+
 def _atomic_write_text(path: Path, content: str) -> None:
     """Write text via temp file + os.replace (same-dir atomic swap)."""
     path.parent.mkdir(parents=True, exist_ok=True)
@@ -134,6 +144,8 @@ def _write_mcp_servers(mcp_path: Path, server_url: str) -> str:
     prev = mcp_servers.get("hipcortex")
     if prev == entry:
         return INSTALL_UNCHANGED
+    if _is_vsix_managed_entry(prev):
+        return INSTALL_UNCHANGED
 
     had_entry = prev is not None
     mcp_servers["hipcortex"] = entry

{hipcortex-3.11.0 → hipcortex-3.13.0}/hipcortex.egg-info/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: hipcortex
-Version: 3.11.0
-Summary: Cognitive state substrate for AI agents — Python SDK + CLI. Universal server-side passive capture (any channel, zero client changes); ships the 61-tool / 7-resource MCP server; hard single-role runner, observation-content predicate scorer, GoalRevision→ClarifyEngine, 24h field log, WAL-persistent. LangChain, AutoGen, CrewAI, MCP
+Version: 3.13.0
+Summary: Cognitive state substrate for AI agents — Python SDK + CLI. Graceful shutdown + auto-backup (POST /v1/backup tars 4 data files); actor merge (merge_actor MCP tool); snapshot CLI; VSIX dedup guard; schema-compat proven; universal passive capture; 62-tool / 7-resource MCP server; WAL-persistent. LangChain, AutoGen, CrewAI, MCP
 Author: HipCortex Contributors
 License: Apache-2.0
 Project-URL: Homepage, https://github.com/farmountain/HipCortex
@@ -42,7 +42,7 @@ Requires-Dist: mem0ai>=0.1; extra == "all"
 Requires-Dist: tabulate>=0.9; extra == "all"
 Dynamic: requires-python
 
-# HipCortex Python SDK (`v3.11.0`)
+# HipCortex Python SDK (`v3.12.0`)
 
 **Persistent causal topological memory, recursive Bayesian world-model prediction (`/worldmodel/rollout`), and automatic FSM skill compilation for autonomous AI agents.**
 
@@ -55,11 +55,11 @@ Runs against the standalone local Rust binary (`http://127.0.0.1:3030`) with `0.
 ```bash
 pip install hipcortex
 hipcortex doctor   # verify server health + version after install
-hipcortex install  # wizard: MCP hosts + copies ~/.hipcortex-mcp/server.py (61 tools)
+hipcortex install  # wizard: MCP hosts + copies ~/.hipcortex-mcp/server.py (62 tools)
 hipcortex channels # honesty matrix (native / mcp / framework / guide)
 ```
 
-**Version matrix:** product pip/Cargo/MCP `serverInfo` = **3.11.0**; VS Code VSIX = **3.11.0**. See [docs/channels.md](../../docs/channels.md).
+**Version matrix:** product pip/Cargo/MCP `serverInfo` = **3.12.0**; VS Code VSIX = **3.12.0**. See [docs/channels.md](../../docs/channels.md).
 
 ---
 

{hipcortex-3.11.0 → hipcortex-3.13.0}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hipcortex"
-version = "3.11.0"
-description = "Cognitive state substrate for AI agents — Python SDK + CLI. Universal server-side passive capture (any channel, zero client changes); ships the 61-tool / 7-resource MCP server; hard single-role runner, observation-content predicate scorer, GoalRevision→ClarifyEngine, 24h field log, WAL-persistent. LangChain, AutoGen, CrewAI, MCP"
+version = "3.13.0"
+description = "Cognitive state substrate for AI agents — Python SDK + CLI. Graceful shutdown + auto-backup (POST /v1/backup tars 4 data files); actor merge (merge_actor MCP tool); snapshot CLI; VSIX dedup guard; schema-compat proven; universal passive capture; 62-tool / 7-resource MCP server; WAL-persistent. LangChain, AutoGen, CrewAI, MCP"
 readme = "README.md"
 license = {text = "Apache-2.0"}
 requires-python = ">=3.9"

{hipcortex-3.11.0 → hipcortex-3.13.0}/setup.py

@@ -2,8 +2,8 @@ from setuptools import setup, find_packages
 
 setup(
     name="hipcortex",
-    version="3.11.0",
-    description="Cognitive state substrate for AI agents — Python SDK + CLI (universal server-side passive capture, 61-tool / 7-resource MCP server, WAL-persistent, MCP + REST)",
+    version="3.12.0",
+    description="Cognitive state substrate for AI agents — Python SDK + CLI (universal server-side passive capture, 62-tool / 7-resource MCP server, WAL-persistent, MCP + REST)",
     # No long_description here: PEP 621 metadata in pyproject.toml supplies readme = "README.md",
     # and declaring it in both places is a duplicate-metadata error. This used to be a dead
     # expression (open(...).read() if False else "") that read as if it did something.