@musashishao/agent-kit 1.11.3 → 1.11.4

package/.agent/agents/game-conductor.md

@@ -9,7 +9,7 @@ skills:
   - vibe-coding-guard
   - brainstorming
   - explained-qa
-  - notebooklm-integration
+  - notebooklm-mcp
   - brave-search
 ---
 

package/.agent/agents/orchestrator.md

@@ -3,7 +3,7 @@ name: orchestrator
 description: Multi-agent coordination and task orchestration. Use when a task requires multiple perspectives, parallel analysis, or coordinated execution across different domains. Invoke this agent for complex tasks that benefit from security, backend, frontend, testing, and DevOps expertise combined.
 tools: Read, Grep, Glob, Bash, Write, Edit, Agent
 model: inherit
-skills: clean-code, parallel-agents, behavioral-modes, plan-writing, brainstorming, architecture, lint-and-validate, powershell-windows, bash-linux, notebooklm-integration
+skills: clean-code, parallel-agents, behavioral-modes, plan-writing, brainstorming, architecture, lint-and-validate, powershell-windows, bash-linux, notebooklm-mcp
 ---
 
 # Orchestrator - Native Multi-Agent Coordination

package/.agent/agents/project-planner.md

@@ -3,7 +3,7 @@ name: project-planner
 description: Smart project planning agent. Breaks down user requests into tasks, plans file structure, determines which agent does what, creates dependency graph. Use when starting new projects or planning major features.
 tools: Read, Grep, Glob, Bash
 model: inherit
-skills: clean-code, app-builder, plan-writing, brainstorming, spec-writing, notebooklm-integration
+skills: clean-code, app-builder, plan-writing, brainstorming, spec-writing, notebooklm-mcp
 ---
 
 # Project Planner - Smart Project Planning

package/.agent/rules/REF_SKILLS.md

@@ -64,11 +64,10 @@ trigger: always_on
 | `browser-extension-builder` | Manifest V3, content scripts, popup UIs (NEW) |
 | `discord-bot-architect` | Discord.js, slash commands, interactions (NEW) |
 | `agent-tool-builder` | MCP servers, function calling, sandboxing (NEW) |
-| `notebooklm-integration` | **Google NotebookLM via MCP. Research, RAG, content gen (NEW)** |
+| `notebooklm-mcp` | **Google NotebookLM via MCP. Research, RAG, content gen (NEW)** |
 | `brave-search` | **Brave Search MCP. Real-time web search** |
 | `memory-mcp` | **Memory MCP. Long-term Knowledge Graph for Dual-Hemisphere Memory (NEW)** |
 | `notion-mcp` | **Notion MCP. Workspace integration - search, read, write (NEW)** |
-
 | `ai-agents-architect` | Multi-agent systems, orchestration, communication (NEW) |
 | `ai-product` | AI PM, UX patterns, eval-driven dev (NEW) |
 | `ai-wrapper-product` | AI wrappers, cost optimization, moats (NEW) |

package/.agent/scripts/setup_all.py

@@ -39,10 +39,21 @@ def check_python_version():
         sys.exit(1)
 
 def create_venv():
-    """Create a virtual environment if it doesn't exist."""
+    """Create a virtual environment with robust error handling for Linux."""
     if not VENV_DIR.exists():
         print(f"📦 Đang tạo môi trường Python cô lập (Virtual Env) tại {VENV_DIR}...")
-        subprocess.check_call([sys.executable, "-m", "venv", str(VENV_DIR)])
+        try:
+            # Try standard venv
+            subprocess.run([sys.executable, "-m", "venv", str(VENV_DIR)], check=True, capture_output=True)
+        except subprocess.CalledProcessError:
+            try:
+                # Try without pip (common failure point on Ubuntu)
+                print("⚠️  Venv chuẩn thất bại, đang thử tạo không kèm pip...")
+                subprocess.run([sys.executable, "-m", "venv", "--without-pip", str(VENV_DIR)], check=True)
+            except Exception as e:
+                print(f"❌ Không thể tạo môi trường: {e}")
+                print("💡 Giải pháp: Chạy 'sudo apt install python3-venv -y'")
+                sys.exit(1)
     
     # Get venv python
     if sys.platform == "win32":
@@ -50,16 +61,40 @@ def create_venv():
     return str(VENV_DIR / "bin" / "python")
 
 def install_deps(venv_python):
-    """Install all necessary packages in isolation."""
-    print("📦 Đang cài đặt các thư viện bổ trợ (Dependencies)...")
+    """Install all necessary packages with self-healing pip logic."""
+    print("📦 Đang kiểm tra và cài đặt các thư viện bổ trợ...")
+    
     try:
-        # Upgrade pip first
+        # 1. Check if pip exists
+        pip_check = subprocess.run([venv_python, "-m", "pip", "--version"], capture_output=True)
+        
+        if pip_check.returncode != 0:
+            print("📦 Pip bị thiếu trong môi trường, đang thử cài đặt lại (get-pip.py)...")
+            try:
+                import urllib.request
+                get_pip_url = "https://bootstrap.pypa.io/get-pip.py"
+                get_pip_path = Path.cwd() / "get-pip.py"
+                with urllib.request.urlopen(get_pip_url) as response, open(get_pip_path, 'wb') as out_file:
+                    shutil.copyfileobj(response, out_file)
+                
+                subprocess.run([venv_python, str(get_pip_path)], check=True, capture_output=True)
+                get_pip_path.unlink() # Cleanup
+                print("✅ Đã cài pip thành công.")
+            except Exception as e:
+                print(f"⚠️  Không thể tự cài pip: {e}")
+                print("💡 Giải pháp: Chạy 'sudo apt install python3-pip -y'")
+
+        # 2. Upgrade pip and install requirements
         subprocess.run([venv_python, "-m", "pip", "install", "--upgrade", "pip"], capture_output=True)
-        # Install packages
-        subprocess.run([venv_python, "-m", "pip", "install"] + REQS, capture_output=True)
-        print("✅ Đã cài đặt xong thư viện.")
+        result = subprocess.run([venv_python, "-m", "pip", "install"] + REQS, capture_output=True, text=True)
+        
+        if result.returncode == 0:
+            print("✅ Đã cài đặt xong thư viện.")
+        else:
+            print(f"⚠️  Cảnh báo cài đặt: {result.stderr}")
+            
     except Exception as e:
-        print(f"⚠️  Có lỗi nhỏ khi cài thư viện: {e}. Vẫn tiếp tục setup...")
+        print(f"⚠️  Lỗi khi cài thư viện: {e}. Vẫn tiếp tục các bước khác...")
 
 def run_sub_setup(script_name, args=None):
     """Run a sub-setup script from the kit."""

package/.agent/scripts/setup_notebooklm_mcp.py

@@ -101,15 +101,25 @@ def create_venv(platform_info: Dict) -> Optional[str]:
     if not venv_dir.exists():
         print(f"📦 Đang tạo môi trường Python riêng...")
         try:
-            subprocess.check_call(
+            # Try to create venv. On Ubuntu, this might fail or create it without pip.
+            subprocess.run(
                 [sys.executable, "-m", "venv", str(venv_dir)],
                 stdout=subprocess.DEVNULL,
-                stderr=subprocess.DEVNULL
+                stderr=subprocess.DEVNULL,
+                check=True
             )
             print(f"✅ Đã tạo môi trường tại: {venv_dir.name}")
         except subprocess.CalledProcessError as e:
-            print(f"❌ Không thể tạo môi trường: {e}")
-            return None
+            # If standard venv fails, try creating without pip as fallback
+            try:
+                subprocess.run(
+                    [sys.executable, "-m", "venv", "--without-pip", str(venv_dir)],
+                    check=True
+                )
+                print(f"✅ Đã tạo môi trường (chế độ --without-pip)")
+            except Exception:
+                print(f"❌ Không thể tạo môi trường: {e}")
+                return None
     else:
         print(f"✅ Môi trường Python đã tồn tại")
     
@@ -127,18 +137,45 @@ def create_venv(platform_info: Dict) -> Optional[str]:
 
 
 def install_package(python_path: str) -> bool:
-    """Install notebooklm-mcp-server package."""
+    """Install notebooklm-mcp-server package with robust pip checking."""
     print(f"📦 Đang cài đặt NotebookLM MCP...")
     
     try:
-        # Upgrade pip quietly
+        # 1. Check if pip is available
+        pip_check = subprocess.run([python_path, "-m", "pip", "--version"], capture_output=True)
+        
+        if pip_check.returncode != 0:
+            print("📦 Pip bị thiếu, đang thử khôi phục...")
+            # Try ensurepip
+            bootstrap = subprocess.run([python_path, "-m", "ensurepip", "--default-pip"], capture_output=True)
+            
+            if bootstrap.returncode != 0:
+                print("📦 Đang thử tải pip trực tiếp (get-pip.py)...")
+                try:
+                    import urllib.request
+                    get_pip_url = "https://bootstrap.pypa.io/get-pip.py"
+                    get_pip_path = Path.cwd() / "get-pip.py"
+                    with urllib.request.urlopen(get_pip_url) as response, open(get_pip_path, 'wb') as out_file:
+                        shutil.copyfileobj(response, out_file)
+                    
+                    subprocess.run([python_path, str(get_pip_path)], check=True, capture_output=True)
+                    get_pip_path.unlink() # Delete after use
+                    print("✅ Đã cài pip thành công qua get-pip.py")
+                except Exception as e:
+                    print(f"❌ Không thể tự cài pip: {e}")
+                    print("💡 Giải pháp trên Ubuntu/Linux: Chạy 'sudo apt install python3-venv python3-pip -y' và chạy lại.")
+                    return False
+            else:
+                print("✅ Đã khôi phục pip qua ensurepip")
+
+        # 2. Upgrade pip quietly
         subprocess.run(
             [python_path, "-m", "pip", "install", "--upgrade", "pip"],
             capture_output=True,
             check=False
         )
         
-        # Install package
+        # 3. Install package
         result = subprocess.run(
             [python_path, "-m", "pip", "install", "--upgrade", MCP_SERVER_PACKAGE],
             capture_output=True,
@@ -153,7 +190,7 @@ def install_package(python_path: str) -> bool:
         return True
         
     except Exception as e:
-        print(f"❌ Lỗi: {e}")
+        print(f"❌ Lỗi cài đặt: {e}")
         return False
 
 
@@ -392,7 +429,7 @@ def main():
         (platform_info["claude_config"], "notebooklm-mcp", "Claude"),
         (platform_info["cursor_config"], "notebooklm-mcp", "Cursor"),
         (platform_info["vscode_config"], "notebooklm-mcp", "VS Code"),
-        (platform_info.get("antigravity_config"), "notebooklm", "Antigravity"),
+        (platform_info.get("antigravity_config"), "notebooklm-mcp", "Antigravity"),
     ]
     
     for config_path, server_name, app_name in json_configs:
@@ -406,7 +443,7 @@ def main():
     # TOML-based configs (Codex CLI)
     codex_config = platform_info.get("codex_config")
     if codex_config:
-        if update_toml_config(codex_config, "notebooklm", python_path, wrapper_path, profile):
+        if update_toml_config(codex_config, "notebooklm-mcp", python_path, wrapper_path, profile):
             print(f"  ✅ Codex CLI")
         else:
             print(f"  ⚠️ Codex CLI (bỏ qua)")

package/.agent/skills/game-development/sage-protocol/SKILL.md

@@ -3,7 +3,7 @@ name: sage-protocol
 description: "The intellectual engine for high-level game reasoning. Market research, design theory, and proactive bifurcation."
 skills:
   - brave-search
-  - notebooklm-integration
+  - notebooklm-mcp
   - explained-qa
   - decision-memory
 ---

package/.agent/skills/{notebooklm-integration → notebooklm-mcp}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: notebooklm-integration
+name: notebooklm-mcp
 description: Google NotebookLM integration via MCP. 31 tools for research, AI analysis, and content generation.
 ---
 

package/.agent/workflows/engineering-brief.md

@@ -12,6 +12,12 @@ Distill PRD documents, specs, and meeting notes into a concise Engineering Brief
 
 ---
 
+## Prerequisites
+- NotebookLM MCP installed and authenticated
+- Activate: @[skills/notebooklm-mcp]
+
+---
+
 ## Why This Matters
 
 **Problem:** Agents receive too many raw documents → Context Window gets full → Likely to hallucinate.

package/.agent/workflows/research.md

@@ -14,7 +14,7 @@ Use NotebookLM MCP to deeply research a topic, import sources, and synthesize in
 
 ## Prerequisites
 - NotebookLM MCP installed and authenticated
-- Skill: `notebooklm-integration`
+- Activate: @[skills/notebooklm-mcp]
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@musashishao/agent-kit",
-  "version": "1.11.3",
+  "version": "1.11.4",
   "description": "AI Agent templates - Skills, Agents, Workflows, and AI-Ready Data Infrastructure Gateway",
   "main": "index.js",
   "bin": {