@agentunion/kite 1.0.1 → 1.0.2

package/core/data_dir.py

@@ -0,0 +1,62 @@
+"""
+Data directory management for Kite.
+When installed globally via npm, use ~/.kite/ for runtime data.
+When running locally, use project_root/core/*/data/.
+"""
+import os
+import sys
+
+
+def get_data_root() -> str:
+    """Get the root directory for runtime data.
+
+    Returns:
+        - ~/.kite/ if installed globally (no write permission to install dir)
+        - project_root if running locally (development mode)
+    """
+    # Check if we're in a global npm install (no write permission)
+    project_root = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+    test_file = os.path.join(project_root, "core", "launcher", "data", ".write_test")
+
+    try:
+        os.makedirs(os.path.dirname(test_file), exist_ok=True)
+        with open(test_file, "w") as f:
+            f.write("test")
+        os.remove(test_file)
+        # Write permission OK, use project_root
+        return project_root
+    except (OSError, PermissionError):
+        # No write permission, use user home
+        home = os.path.expanduser("~")
+        kite_home = os.path.join(home, ".kite")
+        os.makedirs(kite_home, exist_ok=True)
+        return kite_home
+
+
+def get_launcher_data_dir() -> str:
+    """Get launcher data directory."""
+    root = get_data_root()
+    if root.endswith(".kite"):
+        # User home mode: ~/.kite/launcher/
+        return os.path.join(root, "launcher")
+    else:
+        # Project mode: project_root/core/launcher/data/
+        return os.path.join(root, "core", "launcher", "data")
+
+
+def get_registry_data_dir() -> str:
+    """Get registry data directory."""
+    root = get_data_root()
+    if root.endswith(".kite"):
+        return os.path.join(root, "registry")
+    else:
+        return os.path.join(root, "core", "registry", "data")
+
+
+def get_event_hub_data_dir() -> str:
+    """Get event hub data directory."""
+    root = get_data_root()
+    if root.endswith(".kite"):
+        return os.path.join(root, "event_hub")
+    else:
+        return os.path.join(root, "core", "event_hub", "data")

package/core/launcher/data/log/lifecycle.jsonl

@@ -1113,3 +1113,46 @@
 {"ts": "2026-02-28T07:57:48.632978+00:00", "event": "scanned", "module": "hello_test", "state": "manual", "module_dir": "C:\\Users\\agentcp\\AppData\\Roaming\\Evol\\default\\workspace\\openclaw-acp-channel\\ai-phone-agent\\Kite\\test_modules\\hello"}
 {"ts": "2026-02-28T07:57:48.633432+00:00", "event": "scanned", "module": "hello_node", "state": "manual", "module_dir": "C:\\Users\\agentcp\\AppData\\Roaming\\Evol\\default\\workspace\\openclaw-acp-channel\\ai-phone-agent\\Kite\\test_modules\\hello_node"}
 {"ts": "2026-02-28T07:57:48.852301+00:00", "event": "starting", "module": "event_hub"}
+{"ts": "2026-02-28T07:58:18.884176+00:00", "event": "started", "module": "event_hub", "pid": 16856}
+{"ts": "2026-02-28T07:58:18.885116+00:00", "event": "starting", "module": "event_hub_bench"}
+{"ts": "2026-02-28T07:58:48.914951+00:00", "event": "started", "module": "event_hub_bench", "pid": 7428}
+{"ts": "2026-02-28T07:58:48.915845+00:00", "event": "starting", "module": "registry"}
+{"ts": "2026-02-28T07:59:18.918721+00:00", "event": "started", "module": "registry", "pid": 1784}
+{"ts": "2026-02-28T07:59:18.919864+00:00", "event": "starting", "module": "watchdog"}
+{"ts": "2026-02-28T07:59:48.945594+00:00", "event": "started", "module": "watchdog", "pid": 7328}
+{"ts": "2026-02-28T07:59:49.189163+00:00", "event": "exited", "module": "event_hub_bench", "exit_code": 1}
+{"ts": "2026-02-28T07:59:49.190243+00:00", "event": "core_crash", "module": "event_hub_bench", "exit_code": 1}
+{"ts": "2026-02-28T07:59:49.191319+00:00", "event": "stopping", "module": "event_hub", "reason": "system_shutdown"}
+{"ts": "2026-02-28T07:59:49.192040+00:00", "event": "stopping", "module": "registry", "reason": "system_shutdown"}
+{"ts": "2026-02-28T07:59:49.192534+00:00", "event": "stopping", "module": "watchdog", "reason": "system_shutdown"}
+{"ts": "2026-02-28T07:59:53.841466+00:00", "event": "stopping", "module": "registry", "reason": "restart"}
+{"ts": "2026-02-28T07:59:59.121162+00:00", "event": "started", "module": "registry", "pid": 5100, "via": "restart_api"}
+{"ts": "2026-02-28T07:59:59.299185+00:00", "event": "stopped", "module": "event_hub", "reason": "system_shutdown"}
+{"ts": "2026-02-28T07:59:59.299948+00:00", "event": "stopped", "module": "registry", "reason": "system_shutdown"}
+{"ts": "2026-02-28T07:59:59.300517+00:00", "event": "stopped", "module": "watchdog", "reason": "system_shutdown"}
+{"ts": "2026-02-28T08:00:00.422625+00:00", "event": "scanned", "module": "event_hub", "state": "enabled", "module_dir": "C:\\Users\\agentcp\\AppData\\Roaming\\Evol\\default\\workspace\\openclaw-acp-channel\\ai-phone-agent\\Kite\\core\\event_hub"}
+{"ts": "2026-02-28T08:00:00.423287+00:00", "event": "scanned", "module": "event_hub_bench", "state": "enabled", "module_dir": "C:\\Users\\agentcp\\AppData\\Roaming\\Evol\\default\\workspace\\openclaw-acp-channel\\ai-phone-agent\\Kite\\core\\event_hub_bench"}
+{"ts": "2026-02-28T08:00:00.423795+00:00", "event": "scanned", "module": "registry", "state": "enabled", "module_dir": "C:\\Users\\agentcp\\AppData\\Roaming\\Evol\\default\\workspace\\openclaw-acp-channel\\ai-phone-agent\\Kite\\core\\registry"}
+{"ts": "2026-02-28T08:00:00.424305+00:00", "event": "scanned", "module": "watchdog", "state": "enabled", "module_dir": "C:\\Users\\agentcp\\AppData\\Roaming\\Evol\\default\\workspace\\openclaw-acp-channel\\ai-phone-agent\\Kite\\extensions\\services\\watchdog"}
+{"ts": "2026-02-28T08:00:00.425001+00:00", "event": "scanned", "module": "hello_test", "state": "manual", "module_dir": "C:\\Users\\agentcp\\AppData\\Roaming\\Evol\\default\\workspace\\openclaw-acp-channel\\ai-phone-agent\\Kite\\test_modules\\hello"}
+{"ts": "2026-02-28T08:00:00.425888+00:00", "event": "scanned", "module": "hello_node", "state": "manual", "module_dir": "C:\\Users\\agentcp\\AppData\\Roaming\\Evol\\default\\workspace\\openclaw-acp-channel\\ai-phone-agent\\Kite\\test_modules\\hello_node"}
+{"ts": "2026-02-28T08:00:00.658390+00:00", "event": "starting", "module": "event_hub"}
+{"ts": "2026-02-28T08:00:30.678544+00:00", "event": "started", "module": "event_hub", "pid": 16788}
+{"ts": "2026-02-28T08:00:30.679539+00:00", "event": "starting", "module": "event_hub_bench"}
+{"ts": "2026-02-28T08:01:00.699105+00:00", "event": "started", "module": "event_hub_bench", "pid": 14584}
+{"ts": "2026-02-28T08:01:00.700248+00:00", "event": "starting", "module": "registry"}
+{"ts": "2026-02-28T08:01:30.704355+00:00", "event": "started", "module": "registry", "pid": 7948}
+{"ts": "2026-02-28T08:01:30.705422+00:00", "event": "starting", "module": "watchdog"}
+{"ts": "2026-02-28T08:02:00.733196+00:00", "event": "started", "module": "watchdog", "pid": 11596}
+{"ts": "2026-02-28T08:02:00.952786+00:00", "event": "exited", "module": "event_hub_bench", "exit_code": 1}
+{"ts": "2026-02-28T08:02:00.953605+00:00", "event": "core_crash", "module": "event_hub_bench", "exit_code": 1}
+{"ts": "2026-02-28T08:02:00.954466+00:00", "event": "stopping", "module": "event_hub", "reason": "system_shutdown"}
+{"ts": "2026-02-28T08:02:00.955040+00:00", "event": "stopping", "module": "registry", "reason": "system_shutdown"}
+{"ts": "2026-02-28T08:02:00.955518+00:00", "event": "stopping", "module": "watchdog", "reason": "system_shutdown"}
+{"ts": "2026-02-28T08:02:05.223936+00:00", "event": "stopping", "module": "registry", "reason": "restart"}
+{"ts": "2026-02-28T08:02:10.527416+00:00", "event": "started", "module": "registry", "pid": 16200, "via": "restart_api"}
+{"ts": "2026-02-28T08:02:11.075072+00:00", "event": "stopped", "module": "event_hub", "reason": "system_shutdown"}
+{"ts": "2026-02-28T08:02:11.075831+00:00", "event": "stopped", "module": "registry", "reason": "system_shutdown"}
+{"ts": "2026-02-28T08:02:11.076307+00:00", "event": "stopped", "module": "watchdog", "reason": "system_shutdown"}
+{"ts": "2026-02-28T08:02:21.121280+00:00", "event": "stopping", "module": "registry", "reason": "system_shutdown"}
+{"ts": "2026-02-28T08:02:31.218728+00:00", "event": "stopped", "module": "registry", "reason": "system_shutdown"}

package/core/launcher/entry.py

@@ -26,6 +26,7 @@ from fastapi.responses import JSONResponse
 
 from .module_scanner import ModuleScanner, ModuleInfo, _parse_frontmatter
 from .process_manager import ProcessManager
+from core.data_dir import get_launcher_data_dir
 
 IS_WINDOWS = sys.platform == "win32"
 
@@ -68,7 +69,7 @@ class Launcher:
         self._event_waiters: dict[str, tuple[asyncio.Event, dict]] = {}
 
         self._lifecycle_log = os.path.join(
-            self.project_root, "core", "launcher", "data", "log", "lifecycle.jsonl",
+            get_launcher_data_dir(), "lifecycle.jsonl",
         )
         self._app = self._create_api_app()
 
@@ -376,8 +377,12 @@ class Launcher:
         if not os.path.isdir(registry_dir):
             raise RuntimeError(f"Registry module not found at {registry_dir}")
 
+        # Use centralized data directory
+        from core.data_dir import get_registry_data_dir
+        registry_data_dir = get_registry_data_dir()
+
         # Clean our instance's port file before starting
-        port_file = os.path.join(registry_dir, "data", f"port_{self.instance_id}.txt")
+        port_file = os.path.join(registry_data_dir, f"port_{self.instance_id}.txt")
         if os.path.isfile(port_file):
             os.remove(port_file)
 
@@ -701,7 +706,8 @@ class Launcher:
             os.remove(self.process_manager.records_path)
         except OSError:
             pass
-        port_file = os.path.join(self.project_root, "core", "registry", "data", f"port_{self.instance_id}.txt")
+        from core.data_dir import get_registry_data_dir
+        port_file = os.path.join(get_registry_data_dir(), f"port_{self.instance_id}.txt")
         try:
             os.remove(port_file)
         except OSError:

package/core/launcher/process_manager.py

@@ -32,7 +32,10 @@ class ProcessManager:
         self.project_root = project_root
         self.kite_token = kite_token
         self.instance_id = instance_id or str(os.getpid())
-        self.data_dir = os.path.join(project_root, "core", "launcher", "data")
+        # Use centralized data directory management
+        sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+        from data_dir import get_launcher_data_dir
+        self.data_dir = get_launcher_data_dir()
         self.records_path = os.path.join(self.data_dir, f"processes_{self.instance_id}.json")
         self._processes: dict[str, subprocess.Popen] = {}   # name -> Popen
         self._records: dict[str, ProcessRecord] = {}         # name -> record
@@ -56,6 +59,10 @@ class ProcessManager:
             files.append(legacy)
 
         registry_data_dir = os.path.join(self.project_root, "core", "registry", "data")
+        # Also check user home registry data dir
+        sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+        from data_dir import get_registry_data_dir
+        registry_data_dir_alt = get_registry_data_dir()
 
         for path in files:
             if path == self.records_path:
@@ -99,6 +106,10 @@ class ProcessManager:
                 port_file = os.path.join(registry_data_dir, f"port_{inst_id}.txt")
                 if os.path.isfile(port_file):
                     os.remove(port_file)
+                # Also check alt location
+                port_file_alt = os.path.join(registry_data_dir_alt, f"port_{inst_id}.txt")
+                if os.path.isfile(port_file_alt):
+                    os.remove(port_file_alt)
 
             # Also clean legacy port.txt
             legacy_port = os.path.join(registry_data_dir, "port.txt")

package/core/registry/entry.py

@@ -26,7 +26,8 @@ def _get_free_port() -> int:
 
 
 def _write_port_file(port: int, instance_id: str = ""):
-    data_dir = os.path.join(_this_dir, "data")
+    from core.data_dir import get_registry_data_dir
+    data_dir = get_registry_data_dir()
     os.makedirs(data_dir, exist_ok=True)
     filename = f"port_{instance_id}.txt" if instance_id else "port.txt"
     port_file = os.path.join(data_dir, filename)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentunion/kite",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Kite framework launcher — start Kite from anywhere",
   "bin": {
     "kite": "./cli.js"
@@ -16,8 +16,16 @@
   "engines": {
     "node": ">=16"
   },
-  "os": ["win32", "linux", "darwin"],
-  "keywords": ["kite", "framework", "launcher"],
+  "os": [
+    "win32",
+    "linux",
+    "darwin"
+  ],
+  "keywords": [
+    "kite",
+    "framework",
+    "launcher"
+  ],
   "license": "MIT",
   "author": "agentcp",
   "repository": {

package/core/launcher/data/processes_14752.json

@@ -1,32 +0,0 @@
-[
-  {
-    "name": "event_hub",
-    "pid": 7768,
-    "cmd": [
-      "C:\\Users\\agentcp\\AppData\\Local\\Microsoft\\WindowsApps\\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\\python.exe",
-      "C:\\Users\\agentcp\\AppData\\Roaming\\Evol\\default\\workspace\\openclaw-acp-channel\\ai-phone-agent\\Kite\\core\\event_hub\\entry.py"
-    ],
-    "module_dir": "C:\\Users\\agentcp\\AppData\\Roaming\\Evol\\default\\workspace\\openclaw-acp-channel\\ai-phone-agent\\Kite\\core\\event_hub",
-    "started_at": 1772265337.0893958
-  },
-  {
-    "name": "watchdog",
-    "pid": 15496,
-    "cmd": [
-      "C:\\Users\\agentcp\\AppData\\Local\\Microsoft\\WindowsApps\\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\\python.exe",
-      "C:\\Users\\agentcp\\AppData\\Roaming\\Evol\\default\\workspace\\openclaw-acp-channel\\ai-phone-agent\\Kite\\extensions\\services\\watchdog\\entry.py"
-    ],
-    "module_dir": "C:\\Users\\agentcp\\AppData\\Roaming\\Evol\\default\\workspace\\openclaw-acp-channel\\ai-phone-agent\\Kite\\extensions\\services\\watchdog",
-    "started_at": 1772265427.1668043
-  },
-  {
-    "name": "registry",
-    "pid": 11156,
-    "cmd": [
-      "C:\\Users\\agentcp\\AppData\\Local\\Microsoft\\WindowsApps\\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\\python.exe",
-      "C:\\Users\\agentcp\\AppData\\Roaming\\Evol\\default\\workspace\\openclaw-acp-channel\\ai-phone-agent\\Kite\\core\\registry\\entry.py"
-    ],
-    "module_dir": "C:\\Users\\agentcp\\AppData\\Roaming\\Evol\\default\\workspace\\openclaw-acp-channel\\ai-phone-agent\\Kite\\core\\registry",
-    "started_at": 1772265467.0388315
-  }
-]

package/core/registry/data/port_14752.txt

@@ -1 +0,0 @@
-63212