@oneciel-ai/claude-any 0.1.69 → 0.1.71

package/README.md

@@ -68,7 +68,7 @@ arguments through unchanged.
 
 Credits: One Ciel LLC
 
-Current version: `0.1.69`
+Current version: `0.1.71`
 
 ## Why This Exists
 
@@ -495,6 +495,22 @@ steps under that larger model's supervision.
 
 ## Changelog
 
+### 0.1.71
+
+- **MCP SSE channel initialization**: the channel bridge now handles MCP
+  `endpoint` events by sending `initialize` and `notifications/initialized`,
+  so AI-Net style push notifications can start flowing into Claude Any.
+- **Channel SSE diagnostics**: connector status now reports the MCP endpoint,
+  initialization state, and last MCP initialization error.
+
+### 0.1.70
+
+- **Linux menu debug log fix**: key-debug logging now writes under the user's
+  Claude Any config directory instead of global `/tmp`, avoiding permission
+  crashes on locked-down Linux systems.
+- **Best-effort key logging**: menu input no longer fails if the optional
+  key-debug log cannot be written.
+
 ### 0.1.69
 
 - **Realtime channel bridge**: added `/ca/channel/messages`, `/ca/channel/wait`,

package/claude_any.py

@@ -51,6 +51,7 @@ CONTEXT_USAGE_PATH = CONFIG_DIR / "context-usage.json"
 OLLAMA_MODEL_CATALOG_PATH = CONFIG_DIR / "ollama-model-catalog.json"
 CHAT_MESSAGES_PATH = CONFIG_DIR / "chat-messages.jsonl"
 CHAT_FILES_DIR = CONFIG_DIR / "chat-files"
+MENU_KEY_DEBUG_PATH = CONFIG_DIR / "ca-key-debug.log"
 PLAN_ARTIFACTS_DIR = CONFIG_DIR / "plan-artifacts"
 PID_PATH = CONFIG_DIR / "router.pid"
 MODEL_LIST_CACHE_PATH = CONFIG_DIR / "model-list-cache.json"
@@ -95,7 +96,7 @@ PROVIDER_LABELS = {
     "self-hosted-nim": "Self Hosted NIM",
 }
 APP_NAME = "Claude Any"
-VERSION = "0.1.69"
+VERSION = "0.1.71"
 CREDITS = "Credits: One Ciel LLC"
 
 LOG_LEVELS = {"SILENT": 0, "ERROR": 1, "WARN": 2, "INFO": 3, "DEBUG": 4, "TRACE": 5}
@@ -4337,6 +4338,9 @@ def _channel_sse_status_public(name: str, state: dict[str, Any]) -> dict[str, An
         "messages_received": int(state.get("messages_received") or 0),
         "event_filter": state.get("event_filter") or [],
         "read_timeout_seconds": state.get("read_timeout_seconds"),
+        "mcp_endpoint": state.get("mcp_endpoint"),
+        "mcp_initialized": bool(state.get("mcp_initialized")),
+        "mcp_last_error": state.get("mcp_last_error"),
         "last_error": state.get("last_error"),
     }
 
@@ -4401,8 +4405,78 @@ def _sse_payload_to_chat_payload(data_text: str, event_name: str, defaults: dict
     }
 
 
+def _channel_sse_set_state(name: str, **updates: Any) -> None:
+    with _CHANNEL_SSE_LOCK:
+        state = _CHANNEL_SSE_CONNECTIONS.get(name)
+        if state:
+            state.update(updates)
+
+
+def _channel_sse_absolute_endpoint(stream_url: str, endpoint: str) -> str:
+    endpoint = (endpoint or "").strip()
+    if endpoint.startswith(("http://", "https://")):
+        return endpoint
+    return urllib.parse.urljoin(stream_url, endpoint)
+
+
+def _mcp_sse_post_json(endpoint: str, headers: dict[str, str], payload: dict[str, Any], timeout: float) -> Any:
+    request_headers = {**headers, "Content-Type": "application/json", "Accept": "application/json, text/event-stream"}
+    req = urllib.request.Request(
+        endpoint,
+        data=json.dumps(payload, ensure_ascii=False).encode("utf-8"),
+        headers=request_headers,
+        method="POST",
+    )
+    with urllib.request.urlopen(req, timeout=timeout) as response:
+        data = response.read()
+        if not data:
+            return None
+        try:
+            return json.loads(data.decode("utf-8"))
+        except Exception:
+            return data.decode("utf-8", errors="replace")
+
+
+def _channel_sse_maybe_initialize_mcp(name: str, endpoint_text: str) -> None:
+    with _CHANNEL_SSE_LOCK:
+        state = _CHANNEL_SSE_CONNECTIONS.get(name)
+        if not state:
+            return
+        if not bool(state.get("mcp_enabled", True)):
+            return
+        if state.get("mcp_initialized"):
+            return
+        stream_url = str(state.get("url") or "")
+        headers = dict(state.get("headers") or {})
+        timeout = max(5.0, min(120.0, float(state.get("mcp_timeout_seconds") or 20.0)))
+        protocol_version = str(state.get("mcp_protocol_version") or "2024-11-05")
+    endpoint = _channel_sse_absolute_endpoint(stream_url, endpoint_text)
+    try:
+        initialize = {
+            "jsonrpc": "2.0",
+            "id": 1,
+            "method": "initialize",
+            "params": {
+                "protocolVersion": protocol_version,
+                "capabilities": {},
+                "clientInfo": {"name": "claude-any-channel-bridge", "version": VERSION},
+            },
+        }
+        _mcp_sse_post_json(endpoint, headers, initialize, timeout)
+        initialized = {"jsonrpc": "2.0", "method": "notifications/initialized", "params": {}}
+        _mcp_sse_post_json(endpoint, headers, initialized, timeout)
+        _channel_sse_set_state(name, mcp_endpoint=endpoint, mcp_initialized=True, mcp_last_error=None)
+        router_log("INFO", f"channel_sse_mcp_initialized name={name} endpoint={endpoint}")
+    except Exception as exc:
+        _channel_sse_set_state(name, mcp_endpoint=endpoint, mcp_initialized=False, mcp_last_error=f"{type(exc).__name__}: {exc}")
+        router_log("WARN", f"channel_sse_mcp_initialize_failed name={name} endpoint={endpoint} error={type(exc).__name__}: {exc}")
+
+
 def _channel_sse_dispatch(name: str, event_name: str, data_lines: list[str]) -> None:
     data_text = "\n".join(data_lines)
+    if (event_name or "").strip().lower() == "endpoint":
+        _channel_sse_maybe_initialize_mcp(name, data_text)
+        return
     with _CHANNEL_SSE_LOCK:
         state = _CHANNEL_SSE_CONNECTIONS.get(name)
         if not state:
@@ -4510,6 +4584,12 @@ def start_channel_sse_connection(config: dict[str, Any]) -> dict[str, Any]:
             "event_filter": event_filter,
             "read_timeout_seconds": float(config.get("read_timeout_seconds") or config.get("timeout") or 300.0),
             "retry_seconds": float(config.get("retry_seconds") or 5.0),
+            "mcp_enabled": bool(config.get("mcp", config.get("mcp_enabled", True))),
+            "mcp_endpoint": None,
+            "mcp_initialized": False,
+            "mcp_last_error": None,
+            "mcp_protocol_version": str(config.get("mcp_protocol_version") or "2024-11-05"),
+            "mcp_timeout_seconds": float(config.get("mcp_timeout_seconds") or 20.0),
         }
         _CHANNEL_SSE_CONNECTIONS[name] = state
     thread = threading.Thread(target=_channel_sse_worker, args=(name,), daemon=True, name=f"claude-any-channel-sse-{name}")
@@ -11693,6 +11773,15 @@ def print_intro_panel(width: int) -> None:
     print("\n".join(intro_panel_lines(width)))
 
 
+def append_menu_key_debug_log(line: str) -> None:
+    try:
+        MENU_KEY_DEBUG_PATH.parent.mkdir(parents=True, exist_ok=True)
+        with MENU_KEY_DEBUG_PATH.open("a", encoding="utf-8") as f:
+            f.write(line)
+    except OSError:
+        pass
+
+
 def read_menu_key(fd: int | None = None) -> str:
     if os.name == "nt":
         import msvcrt
@@ -11707,7 +11796,6 @@ def read_menu_key(fd: int | None = None) -> str:
         return ch.lower()
 
     import time
-    debug_path = "/tmp/ca-key-debug.log"
     if fd is None or fd < 0:
         fd = sys.stdin.fileno()
     ch = os.read(fd, 1)
@@ -11717,8 +11805,7 @@ def read_menu_key(fd: int | None = None) -> str:
         b = os.read(fd, 1)
         log += f" next={b!r}"
         if not b:
-            with open(debug_path, "a", encoding="utf-8") as f:
-                f.write(log + " result='esc'\n")
+            append_menu_key_debug_log(log + " result='esc'\n")
             return "esc"
         seq += b.decode("latin-1")
         if b == b"[":
@@ -11741,15 +11828,13 @@ def read_menu_key(fd: int | None = None) -> str:
             "\x1b[H": "home", "\x1b[F": "end",
         }.get(seq, "esc")
         log += f" seq={seq!r} result={result!r}"
-        with open(debug_path, "a", encoding="utf-8") as f:
-            f.write(log + "\n")
+        append_menu_key_debug_log(log + "\n")
         return result
     if ch in (b"\r", b"\n"):
         result = "enter"
     else:
         result = ch.decode("latin-1").lower()
-    with open(debug_path, "a", encoding="utf-8") as f:
-        f.write(log + f" result={result!r}\n")
+    append_menu_key_debug_log(log + f" result={result!r}\n")
     return result
 
 

package/docs/README.ja.md

@@ -61,7 +61,7 @@ vLLM、NVIDIA hosted、self-hosted NIM を選択し、通常の Claude Code 引
 
 Credits: One Ciel LLC
 
-現在のバージョン: `0.1.69`
+現在のバージョン: `0.1.71`
 
 ## 作られた理由
 
@@ -365,6 +365,22 @@ Windows/Linux 管理、クリーンアップスクリプト、定期的なセキ
 
 ## 変更履歴
 
+### 0.1.71
+
+- **MCP SSE channel 初期化**: channel bridge は MCP `endpoint` event を受けると
+  `initialize` と `notifications/initialized` を自動送信し、AI-Net 型 push
+  notification が Claude Any に流れ始めるようになりました。
+- **Channel SSE 診断情報**: connector status に MCP endpoint、初期化状態、
+  最後の MCP 初期化エラーを表示します。
+
+### 0.1.70
+
+- **Linux menu debug log 修正**: key-debug log は global `/tmp` ではなく
+  user の Claude Any config directory に書き込むようになり、制限された Linux
+  環境での permission crash を避けます。
+- **best-effort key logging**: 任意の key-debug log を書けない場合でも menu
+  input は失敗しません。
+
 ### 0.1.69
 
 - **リアルタイム channel bridge**: `/ca/channel/messages`, `/ca/channel/wait`,

package/docs/README.ko.md

@@ -67,7 +67,7 @@ NVIDIA hosted, self-hosted NIM을 선택하고, Claude Code의 일반 인자는
 
 Credits: One Ciel LLC
 
-현재 버전: `0.1.69`
+현재 버전: `0.1.71`
 
 ## 왜 만들었나
 
@@ -371,6 +371,22 @@ Windows 이벤트 로그 리뷰, 바이러스/랜섬웨어 침입 시도 정리,
 
 ## 변경 이력
 
+### 0.1.71
+
+- **MCP SSE channel 초기화**: channel bridge가 MCP `endpoint` 이벤트를 받으면
+  `initialize`와 `notifications/initialized`를 자동 전송하므로, AI-Net 스타일
+  push notification이 Claude Any로 흐를 수 있습니다.
+- **Channel SSE 진단 정보**: connector 상태에 MCP endpoint, 초기화 여부, 마지막
+  MCP 초기화 오류를 표시합니다.
+
+### 0.1.70
+
+- **Linux 메뉴 디버그 로그 수정**: key-debug 로그를 전역 `/tmp`가 아니라 사용자
+  Claude Any config 디렉터리 아래에 기록해, 제한된 Linux 환경에서 permission
+  crash가 발생하지 않도록 했습니다.
+- **best-effort key logging**: 선택적 key-debug 로그를 쓸 수 없어도 메뉴 입력이
+  실패하지 않습니다.
+
 ### 0.1.69
 
 - **실시간 채널 브리지**: `/ca/channel/messages`, `/ca/channel/wait`,

package/docs/README.zh.md

@@ -61,7 +61,7 @@ NIM，并把普通 Claude Code 参数原样传递。
 
 Credits: One Ciel LLC
 
-当前版本: `0.1.69`
+当前版本: `0.1.71`
 
 ## 为什么存在
 
@@ -351,6 +351,20 @@ Hermes 格式模型或部分较旧的 Qwen tool template。
 
 ## 更新日志
 
+### 0.1.71
+
+- **MCP SSE channel 初始化**：channel bridge 收到 MCP `endpoint` 事件后会自动发送
+  `initialize` 与 `notifications/initialized`，让 AI-Net 风格的 push
+  notification 可以流入 Claude Any。
+- **Channel SSE 诊断信息**：connector status 现在会显示 MCP endpoint、初始化状态
+  以及最后一次 MCP 初始化错误。
+
+### 0.1.70
+
+- **Linux 菜单调试日志修复**：key-debug 日志现在写入用户的 Claude Any config
+  目录，而不是全局 `/tmp`，避免受限 Linux 环境中的 permission crash。
+- **best-effort key logging**：即使可选 key-debug 日志无法写入，菜单输入也不会失败。
+
 ### 0.1.69
 
 - **实时 channel bridge**：新增 `/ca/channel/messages`、`/ca/channel/wait`、

package/docs/manual.md

@@ -10,7 +10,7 @@ Code starts, while passing normal Claude Code arguments through unchanged.
 
 Credits: One Ciel LLC
 
-Current version: `0.1.69`
+Current version: `0.1.71`
 
 ## Install
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oneciel-ai/claude-any",
-  "version": "0.1.69",
+  "version": "0.1.71",
   "description": "Claude Code provider selector for Anthropic, Ollama, Ollama Cloud, vLLM, NVIDIA hosted, and self-hosted NIM.",
   "license": "MIT",
   "author": "One Ciel LLC",