glm-mcp-copilot 1.2.0 → 1.3.0

package/README.md

@@ -15,6 +15,10 @@ calls `glm_agent` / `glm_delegate` / `glm_recommend` / `glm_status` to offload w
 - A **`GLM` custom agent (subagent)** — restricted to the `glm` tools, so it *must* delegate to GLM
   (the Copilot analog of the Claude `glm` subagent). Pick it from the chat mode dropdown or hand off to it.
 - A **delegation-policy instructions file** so Copilot offloads to GLM automatically.
+- A **PreToolUse auto-routing hook** (`glm_router_hook.mjs`) — fires before the default model does work
+  itself and nudges delegating to GLM (the Copilot analog of the Claude `glm_subagent_router` hook).
+  Installed to `.github/hooks/glm.hooks.json` per-project, or `~/.copilot/hooks/glm.hooks.json` globally.
+  Non-blocking (always allows the tool call). VS Code **preview feature**.
 
 ## Prerequisites
 - **VS Code** with **GitHub Copilot + Copilot Chat**, and **Agent mode** available (MCP support).
@@ -35,7 +39,8 @@ Run it **from your project folder** (it sets up that workspace). It:
 2. writes your key to that server's `.env`,
 3. registers the server in `.vscode/mcp.json` (VS Code's `servers` format),
 4. installs the **`GLM` custom agent** → `.github/agents/glm.agent.md`,
-5. writes `.github/copilot-instructions.md` (the delegation policy).
+5. writes `.github/copilot-instructions.md` (the delegation policy),
+6. installs the **PreToolUse auto-routing hook** → `.github/hooks/glm.hooks.json`.
 
 ### Global (all projects)
 Set it up once for **every** workspace with `--global`:
@@ -46,6 +51,7 @@ Global mode writes to VS Code's **user config** instead of one workspace:
 - the `glm` server → the **user `mcp.json`** (all workspaces),
 - the **`GLM` custom agent** → `~/.copilot/agents/glm.agent.md`,
 - the delegation policy → `~/.copilot/instructions/glm.instructions.md` (with `applyTo: '**'`),
+- the **PreToolUse auto-routing hook** → `~/.copilot/hooks/glm.hooks.json`,
 - and it registers those locations + enables agent mode in **user `settings.json`**
   (`chat.agentFilesLocations`, `chat.instructionsFilesLocations`, `chat.agent.enabled`).
 
@@ -57,14 +63,20 @@ Then in VS Code: **Reload Window → open Copilot Chat → Agent mode → start
 Servers`). Ask Copilot to do a coding task; it will call `glm_agent`.
 
 ## How it differs from the Claude Code version
-Near-parity — Copilot **does** have subagents (custom agents):
+**Essentially full parity** — Copilot now has all three primitives:
 - **`glm_*` MCP tools** in **agent mode** (same server as the Claude edition).
 - A **`GLM` custom agent (subagent)** restricted to the `glm` tools — the analog of the Claude `glm`
   subagent (forced to delegate to GLM). Invoke it from the mode dropdown or via an agent handoff.
+- A **PreToolUse agent hook** (`glm_router_hook.mjs`) that auto-nudges delegation — the analog of the
+  Claude `glm_subagent_router` hook: before the default model does work itself, it suggests delegating
+  to `glm_agent` (non-blocking; it only injects advisory context, never denies a tool call).
 - **Instructions files** steer delegation (the CLAUDE.md equivalent).
 
-The only thing Copilot lacks is Claude Code's **PreToolUse hook** (auto-routing on every subagent
-spawn) — so in Copilot, delegation is driven by the subagent + instructions rather than a hook.
+Small differences that remain:
+- VS Code hooks **ignore the matcher**, so the hook fires on *every* tool call and filters by
+  `tool_name` internally (and advises at most once per session to stay quiet).
+- VS Code **hooks are a preview feature**; flip them on in Copilot settings if your build hides them.
+- There is **no separate `glm-code` full-GLM launcher** (Claude's standalone all-GLM entry point).
 
 Everything else — the GLM agent loop, peak-aware model pick, cost bias, token cap, usage ledger,
 `dry_run` oversight — is the **same server**, so it behaves identically once a tool is called.

package/glm_router_hook.mjs

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+// glm_router_hook.mjs — PreToolUse hook for GitHub Copilot (VS Code agent hooks).
+// The Copilot analog of the Claude Code glm_subagent_router hook: before the default
+// model does work itself, it nudges delegating to GLM (glm_agent, ~10x cheaper).
+// Non-blocking — it only injects advisory context, never denies a tool call.
+import { readFileSync, existsSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+
+let raw = "";
+try { raw = readFileSync(0, "utf8"); } catch {}
+let data = {};
+try { data = JSON.parse(raw || "{}"); } catch {}
+
+const tool = String(data.tool_name || "");
+const sessionId = String(data.session_id || "");
+
+// "Copilot is about to do real work itself" (not via GLM).
+const WORK_TOOLS = new Set([
+  "editFiles", "createFile", "deleteFile", "applyPatch",
+  "runTerminalCommand", "runCommands", "runInTerminal",
+]);
+
+const allow = (extra) =>
+  process.stdout.write(JSON.stringify({ continue: true, hookSpecificOutput: { permissionDecision: "allow", ...(extra || {}) }, ...(extra && extra.systemMessage ? { systemMessage: extra.systemMessage } : {}) }));
+
+// Never interfere with GLM's own tools, reads, or anything that isn't direct work.
+if (!WORK_TOOLS.has(tool) || /glm/i.test(tool)) { allow(); process.exit(0); }
+
+// Advise only ONCE per session to avoid noise on every edit.
+const marker = join(tmpdir(), "glm-router-" + (sessionId || "nosess") + ".flag");
+if (sessionId && existsSync(marker)) { allow(); process.exit(0); }
+try { if (sessionId) writeFileSync(marker, "1"); } catch {}
+
+const context =
+  "GLM router: the default model is about to do this work itself. If this is a well-specified, " +
+  "self-contained coding / edit / refactor / test / docs task, delegate it to GLM instead — call " +
+  "glm_agent with the goal + the absolute repo path (workdir) so it runs on GLM tokens (~10x cheaper), " +
+  "then review the result. Keep sensitive/secret, vision, parallel, very-large-context (>128K), and " +
+  "heavy dependent tool-loop work on the default model. Run glm_recommend if unsure.";
+
+process.stdout.write(JSON.stringify({
+  continue: true,
+  systemMessage: "GLM router: consider delegating this to glm_agent (~10x cheaper).",
+  hookSpecificOutput: { permissionDecision: "allow", additionalContext: context },
+}));
+process.exit(0);

package/install-copilot.mjs

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
 // install-copilot.mjs — set up GLM as a delegate for GitHub Copilot / Copilot Chat (VS Code agent mode).
 // Installs the shared GLM MCP server, registers it in the workspace .vscode/mcp.json (VS Code's
-// "servers" format), and writes .github/copilot-instructions.md so Copilot delegates to GLM.
-// It does NOT touch any Claude Code setup.
+// "servers" format), writes .github/copilot-instructions.md so Copilot delegates to GLM, and installs a
+// PreToolUse agent hook (.github/hooks/glm.hooks.json or ~/.copilot/hooks/glm.hooks.json) that nudges
+// delegation to GLM. It does NOT touch any Claude Code setup.
 //
 // Usage:
 //   node install-copilot.mjs --key YOUR_ZAI_KEY          # set up in the current workspace
@@ -63,6 +64,13 @@ cpSync(join(SELF, "glm-mcp"), join(SERVER_HOME, "glm-mcp"), {
   },
 });
 
+// Also stage the PreToolUse hook script inside the server home so the hook has a stable absolute path.
+step("Staging the GLM PreToolUse hook script");
+copyFileSync(join(SELF, "glm_router_hook.mjs"), join(SERVER_HOME, "glm_router_hook.mjs"));
+const hookScript = join(SERVER_HOME, "glm_router_hook.mjs").replace(/\\/g, "/");
+const hookCmd = 'node "' + hookScript + '"';
+log("  " + join(SERVER_HOME, "glm_router_hook.mjs"));
+
 // 2. .env (API key)
 step("Setting up .env");
 const envPath = join(SERVER_HOME, "glm-mcp", ".env");
@@ -87,6 +95,7 @@ if (!SKIP_NPM) {
 const idx = join(SERVER_HOME, "glm-mcp", "src", "index.js").replace(/\\/g, "/");
 const AGENTS_HOME = join(homedir(), ".copilot", "agents"); // global custom-agent location
 const INSTR_HOME = join(homedir(), ".copilot", "instructions"); // global instructions location
+const HOOKS_HOME = join(homedir(), ".copilot", "hooks"); // global hooks location
 
 function mergeMcp(mcpPath) {
   mkdirSync(dirname(mcpPath), { recursive: true });
@@ -106,6 +115,12 @@ function copyInto(dir, srcFile) {
   copyFileSync(join(SELF, srcFile), dest);
   return dest;
 }
+function writeHookFile(dir) {
+  mkdirSync(dir, { recursive: true });
+  const p = join(dir, "glm.hooks.json");
+  writeFileSync(p, JSON.stringify({ hooks: { PreToolUse: [ { type: "command", command: hookCmd, timeout: 10 } ] } }, null, 2) + "\n");
+  return p;
+}
 
 if (GLOBAL) {
   const userDir = vscodeUserDir();
@@ -118,6 +133,9 @@ if (GLOBAL) {
   step("Installing GLOBAL Copilot instructions -> " + INSTR_HOME);
   log("  " + copyInto(INSTR_HOME, "glm.instructions.md"));
 
+  step("Installing the GLM PreToolUse hook (auto-routing) -> " + HOOKS_HOME);
+  log("  " + writeHookFile(HOOKS_HOME));
+
   step("Updating VS Code user settings.json (locations + toggles)");
   const setPath = join(userDir, "settings.json");
   let settings = {};
@@ -157,6 +175,9 @@ if (GLOBAL) {
   } else {
     log("  copilot-instructions.md already has the policy");
   }
+
+  step("Installing the GLM PreToolUse hook (auto-routing) -> .github/hooks/");
+  log("  " + writeHookFile(join(WORKSPACE, ".github", "hooks")));
 }
 
 log("\n✅ Done. Next steps:");
@@ -167,6 +188,6 @@ log("  4. Use it: pick the 'GLM' agent in the chat mode dropdown, or ask the mai
 log("     'use glm_agent to …'. Run glm_status for the GLM usage ledger.");
 log(
   GLOBAL
-    ? "\nGLOBAL mode: the glm server, GLM subagent, and delegation policy now apply to ALL your VS Code workspaces."
+    ? "\nGLOBAL mode: the glm server, GLM subagent, delegation policy, and PreToolUse auto-routing hook now apply to ALL your VS Code workspaces."
     : "\nWorkspace mode: current project only. Re-run with --global to apply to every project."
 );

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "glm-mcp-copilot",
-  "version": "1.2.0",
-  "description": "GLM (Zhipu/Z.ai) as a cheap delegate for GitHub Copilot / Copilot Chat in VS Code — the same GLM MCP tools (glm_agent/glm_delegate/glm_recommend/glm_status) plus a GLM custom agent (subagent), wired into VS Code agent mode, installable globally.",
+  "version": "1.3.0",
+  "description": "GLM (Zhipu/Z.ai) as a cheap delegate for GitHub Copilot / Copilot Chat in VS Code — the same GLM MCP tools (glm_agent/glm_delegate/glm_recommend/glm_status), a GLM custom agent (subagent), and a PreToolUse auto-routing hook, wired into VS Code agent mode, installable globally.",
   "type": "module",
   "bin": {
     "glm-mcp-copilot": "install-copilot.mjs"
@@ -9,6 +9,7 @@
   "files": [
     "glm-mcp/",
     "install-copilot.mjs",
+    "glm_router_hook.mjs",
     "glm.agent.md",
     "glm.instructions.md",
     "copilot-instructions.md",