linkshell-cli 0.3.27 → 0.3.29

package/dist/cli/src/runtime/bridge-session.js

@@ -2,9 +2,9 @@ import * as pty from "node-pty";
 import * as http from "node:http";
 import WebSocket from "ws";
 import { hostname, platform, homedir } from "node:os";
-import { writeFileSync, readFileSync, readdirSync, statSync, mkdirSync, existsSync, openSync, readSync, closeSync } from "node:fs";
+import { writeFileSync, readFileSync, readdirSync, statSync, unlinkSync, mkdirSync, existsSync, openSync, readSync, closeSync } from "node:fs";
 import { tmpdir } from "node:os";
-import { join, resolve } from "node:path";
+import { join, basename, resolve } from "node:path";
 import { createEnvelope, parseEnvelope, parseTypedPayload, serializeEnvelope, PROTOCOL_VERSION, } from "@linkshell/protocol";
 import { ScrollbackBuffer } from "./scrollback.js";
 import { ScreenFallback } from "./screen-fallback.js";
@@ -13,6 +13,7 @@ import { getLanIp } from "../utils/lan-ip.js";
 import { startKeepAwake } from "../utils/keep-awake.js";
 import { loadOrCreateMachineIdentity } from "../machine-id.js";
 import { getValidToken } from "../auth.js";
+import { AgentSessionProxy } from "./acp/agent-session.js";
 import { AgentWorkspaceProxy } from "./acp/agent-workspace.js";
 import { detectAvailableProviders } from "./acp/provider-resolver.js";
 const HEARTBEAT_INTERVAL = 15_000;
@@ -20,6 +21,113 @@ const RECONNECT_BASE_DELAY = 1_000;
 const RECONNECT_MAX_DELAY = 30_000;
 const RECONNECT_MAX_ATTEMPTS = 20;
 const DEFAULT_TERMINAL_ID = "default";
+const HOOK_BODY_LIMIT = 256 * 1024;
+const PERMISSION_REQUEST_TIMEOUT_MS = Number(process.env.LINKSHELL_PERMISSION_TIMEOUT_MS ?? 5 * 60_000);
+const LINKSHELL_PERMISSION_GUARD_MARKER = "LINKSHELL_PERMISSION_GUARD";
+function isLinkShellHookEntry(entry, marker) {
+    let raw = "";
+    try {
+        raw = JSON.stringify(entry);
+    }
+    catch {
+        raw = String(entry);
+    }
+    return ((marker ? raw.includes(`/hook?m=${marker}`) : false) ||
+        raw.includes("/hook?m=lsh-") ||
+        (raw.includes("/hook?m=") && raw.includes("LINKSHELL_ID")));
+}
+function withLinkShellHookEntry(entries, entry, priority) {
+    const cleaned = (Array.isArray(entries) ? entries : []).filter((item) => !isLinkShellHookEntry(item));
+    return priority === "first" ? [entry, ...cleaned] : [...cleaned, entry];
+}
+function guardPermissionCommandForLinkShell(command) {
+    if (typeof command !== "string")
+        return command;
+    if (command.includes(LINKSHELL_PERMISSION_GUARD_MARKER))
+        return command;
+    return [
+        `case "\${LINKSHELL_ID:-}" in lsh-*) exit 0 ;; esac`,
+        `# ${LINKSHELL_PERMISSION_GUARD_MARKER}`,
+        command,
+    ].join("\n");
+}
+function guardPermissionHookObjectForLinkShell(hook) {
+    if (isLinkShellHookEntry(hook))
+        return hook;
+    const next = { ...hook };
+    if (typeof next.command === "string") {
+        next.command = guardPermissionCommandForLinkShell(next.command);
+    }
+    if (typeof next.bash === "string") {
+        next.bash = guardPermissionCommandForLinkShell(next.bash);
+    }
+    return next;
+}
+function guardPermissionHookEntryForLinkShell(entry) {
+    if (isLinkShellHookEntry(entry))
+        return entry;
+    if (typeof entry === "string")
+        return guardPermissionCommandForLinkShell(entry);
+    if (Array.isArray(entry))
+        return entry.map(guardPermissionHookEntryForLinkShell);
+    if (!entry || typeof entry !== "object")
+        return entry;
+    const next = { ...entry };
+    if (Array.isArray(next.hooks)) {
+        next.hooks = next.hooks.map((hook) => hook && typeof hook === "object" && !Array.isArray(hook)
+            ? guardPermissionHookObjectForLinkShell(hook)
+            : guardPermissionHookEntryForLinkShell(hook));
+    }
+    if (typeof next.command === "string" || typeof next.bash === "string") {
+        return guardPermissionHookObjectForLinkShell(next);
+    }
+    return next;
+}
+function withBlockingLinkShellPermissionEntry(entries, entry) {
+    const cleaned = (Array.isArray(entries) ? entries : [])
+        .filter((item) => !isLinkShellHookEntry(item))
+        .map(guardPermissionHookEntryForLinkShell);
+    return [entry, ...cleaned];
+}
+function stringifyHookInput(value) {
+    if (typeof value === "string")
+        return value.slice(0, 1200);
+    if (typeof value === "object" && value) {
+        try {
+            return JSON.stringify(value, null, 2).slice(0, 1200);
+        }
+        catch {
+            return String(value).slice(0, 1200);
+        }
+    }
+    return "";
+}
+function hookPermissionSuggestions(event) {
+    if (isCodexPermissionRequest(event))
+        return [];
+    const snake = event.permission_suggestions;
+    const camel = event.permissionSuggestions;
+    if (Array.isArray(snake))
+        return snake;
+    if (Array.isArray(camel))
+        return camel;
+    return [];
+}
+function isCodexPermissionRequest(event) {
+    if (typeof event.turn_id === "string" || typeof event.turnId === "string")
+        return true;
+    const transcriptPath = event.transcript_path ?? event.transcriptPath;
+    return typeof transcriptPath === "string" && transcriptPath.includes("/.codex/");
+}
+function hookPermissionOptions(suggestions) {
+    return [
+        { id: "deny", label: "拒绝", kind: "deny" },
+        { id: "allow_once", label: "允许一次", kind: "allow" },
+        ...(suggestions.length > 0
+            ? [{ id: "allow_always", label: "始终允许", kind: "allow" }]
+            : []),
+    ];
+}
 function getPairingGatewayParam(gatewayHttpUrl) {
     try {
         const url = new URL(gatewayHttpUrl);
@@ -86,26 +194,36 @@ export class BridgeSession {
     sessionId = "";
     exited = false;
     stopped = false;
+    permissionStacks = new Map();
+    // Pending permission responses: requestId → HTTP response callback
+    pendingPermissions = new Map();
+    hookMarker = `lsh-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`;
     screenCapture;
     screenShare;
     tunnelSockets = new Map();
     keepAwake;
+    agentSession;
     agentWorkspace;
     machineIdentity;
     constructor(options) {
         this.options = options;
-        this.sessionId = options.hostDeviceId ?? "";
+        this.sessionId = options.sessionId ?? "";
     }
     log(msg) {
         if (this.options.verbose) {
             process.stderr.write(`[bridge:verbose] ${msg}\n`);
         }
     }
+    terminalHookMarker(terminalId) {
+        const safeTerminalId = terminalId.replace(/[^a-zA-Z0-9_-]+/g, "-");
+        return `${this.hookMarker}-${safeTerminalId}`;
+    }
     async start() {
-        this.log(`starting device bridge (gateway=${this.options.gatewayUrl}, terminal=shell)`);
+        this.log(`starting session (gateway=${this.options.gatewayUrl}, provider=${this.options.providerConfig.provider})`);
         this.machineIdentity = loadOrCreateMachineIdentity();
-        this.sessionId ||= this.machineIdentity.machineId;
-        await this.createPairing();
+        if (!this.sessionId) {
+            await this.createPairing();
+        }
         if (this.options.keepAwake) {
             this.keepAwake = startKeepAwake();
         }
@@ -113,17 +231,21 @@ export class BridgeSession {
             process.stderr.write("[bridge] keep-awake disabled\n");
         }
         if (this.options.agentUi) {
+            process.env.LINKSHELL_ID = this.terminalHookMarker(DEFAULT_TERMINAL_ID);
             const availableProviders = this.options.agentProvider
                 ? [normalizeAgentProvider(this.options.agentProvider)]
                 : detectAvailableProviders();
             const agentOptions = {
-                hostDeviceId: this.sessionId,
+                sessionId: this.sessionId,
                 cwd: process.cwd(),
                 availableProviders,
                 command: this.options.agentCommand,
                 verbose: this.options.verbose,
                 send: (envelope) => this.send(envelope),
             };
+            this.agentSession = new AgentSessionProxy({
+                ...agentOptions,
+            });
             this.agentWorkspace = new AgentWorkspaceProxy({
                 ...agentOptions,
             });
@@ -141,19 +263,19 @@ export class BridgeSession {
         const res = await fetch(`${this.options.gatewayHttpUrl}/pairings`, {
             method: "POST",
             headers,
-            body: JSON.stringify({ hostDeviceId: this.sessionId }),
+            body: JSON.stringify({}),
         });
         if (!res.ok) {
             throw new Error(`Failed to create pairing: ${res.status}`);
         }
         const body = (await res.json());
-        this.sessionId = body.hostDeviceId;
+        this.sessionId = body.sessionId;
         const pairingGateway = resolvePairingGateway(this.options.gatewayHttpUrl, this.options.pairingGateway);
         const deepLink = pairingGateway
             ? `linkshell://pair?code=${body.pairingCode}&gateway=${encodeURIComponent(pairingGateway)}`
             : `linkshell://pair?code=${body.pairingCode}`;
         process.stderr.write(`\n  \x1b[1mPairing code: \x1b[36m${body.pairingCode}\x1b[0m\n`);
-        process.stderr.write(`  Host device: ${body.hostDeviceId}\n`);
+        process.stderr.write(`  Session: ${body.sessionId}\n`);
         process.stderr.write(`  Expires: ${body.expiresAt}\n\n`);
         if (!pairingGateway) {
             process.stderr.write("  Note: QR will use the app's current gateway because the CLI is pointed at a local-only address.\n\n");
@@ -203,7 +325,7 @@ export class BridgeSession {
             return;
         }
         const url = new URL(this.options.gatewayUrl);
-        url.searchParams.set("hostDeviceId", this.sessionId);
+        url.searchParams.set("sessionId", this.sessionId);
         url.searchParams.set("role", "host");
         const authToken = await this.resolveAuthToken();
         if (authToken) {
@@ -217,22 +339,18 @@ export class BridgeSession {
             this.reconnectAttempts = 0;
             this.reconnecting = false;
             this.send(createEnvelope({
-                type: "device.connect",
-                hostDeviceId: this.sessionId,
+                type: "session.connect",
+                sessionId: this.sessionId,
                 payload: {
                     role: "host",
                     clientName: this.options.clientName,
+                    provider: this.options.providerConfig.provider,
                     protocolVersion: PROTOCOL_VERSION,
                     machineId: this.machineIdentity?.machineId,
                     hostname: this.options.hostname || hostname(),
                     platform: platform(),
                     cwd: process.cwd(),
-                    capabilities: [
-                        "terminal",
-                        ...(this.options.agentUi ? ["agent-ui"] : []),
-                        ...(this.options.screen ? ["screen"] : []),
-                        "tunnel",
-                    ],
+                    projectName: basename(process.cwd()),
                 },
             }));
             this.startHeartbeat();
@@ -283,33 +401,33 @@ export class BridgeSession {
             }
             case "terminal.spawn": {
                 const p = parseTypedPayload("terminal.spawn", envelope.payload);
-                const normalizedCwd = resolve(p.cwd ?? process.cwd());
+                const normalizedCwd = resolve(p.cwd);
                 // Dedup: if a running terminal already exists for this cwd, return it
                 const existing = [...this.terminals.values()].find((t) => t.status === "running" && resolve(t.cwd) === normalizedCwd);
                 if (existing) {
                     this.send(createEnvelope({
                         type: "terminal.spawned",
-                        hostDeviceId: this.sessionId,
+                        sessionId: this.sessionId,
                         terminalId: existing.id,
-                        payload: { terminalId: existing.id, cwd: existing.cwd, shell: this.options.providerConfig.command },
+                        payload: { terminalId: existing.id, cwd: existing.cwd, projectName: existing.projectName, provider: existing.provider },
                     }));
                 }
                 else {
                     const newId = `term-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
                     try {
-                        await this.spawnTerminal(newId, normalizedCwd);
+                        await this.spawnTerminal(newId, normalizedCwd, p.provider);
                         this.send(createEnvelope({
                             type: "terminal.spawned",
-                            hostDeviceId: this.sessionId,
+                            sessionId: this.sessionId,
                             terminalId: newId,
-                            payload: { terminalId: newId, cwd: normalizedCwd, shell: this.options.providerConfig.command },
+                            payload: { terminalId: newId, cwd: normalizedCwd, projectName: basename(normalizedCwd), provider: p.provider },
                         }));
                     }
                     catch (err) {
                         this.log(`failed to spawn terminal ${newId}: ${err}`);
                         this.send(createEnvelope({
                             type: "terminal.exit",
-                            hostDeviceId: this.sessionId,
+                            sessionId: this.sessionId,
                             terminalId: newId,
                             payload: { exitCode: 1, signal: 0 },
                         }));
@@ -352,14 +470,14 @@ export class BridgeSession {
                     });
                     this.send(createEnvelope({
                         type: "terminal.browse.result",
-                        hostDeviceId: this.sessionId,
+                        sessionId: this.sessionId,
                         payload: { path: browsePath, entries, requestId: p.requestId },
                     }));
                 }
                 catch (err) {
                     this.send(createEnvelope({
                         type: "terminal.browse.result",
-                        hostDeviceId: this.sessionId,
+                        sessionId: this.sessionId,
                         payload: { path: browsePath, entries: [], error: err.message, requestId: p.requestId },
                     }));
                 }
@@ -389,7 +507,7 @@ export class BridgeSession {
                     }
                     this.send(createEnvelope({
                         type: "terminal.file.read.result",
-                        hostDeviceId: this.sessionId,
+                        sessionId: this.sessionId,
                         payload: {
                             path: filePath,
                             content: buffer.toString("utf8"),
@@ -403,7 +521,7 @@ export class BridgeSession {
                 catch (err) {
                     this.send(createEnvelope({
                         type: "terminal.file.read.result",
-                        hostDeviceId: this.sessionId,
+                        sessionId: this.sessionId,
                         payload: {
                             path: filePath,
                             content: "",
@@ -434,14 +552,14 @@ export class BridgeSession {
                     }));
                     this.send(createEnvelope({
                         type: "terminal.browse.result",
-                        hostDeviceId: this.sessionId,
+                        sessionId: this.sessionId,
                         payload: { path: parentPath, entries },
                     }));
                 }
                 catch (err) {
                     this.send(createEnvelope({
                         type: "terminal.browse.result",
-                        hostDeviceId: this.sessionId,
+                        sessionId: this.sessionId,
                         payload: { path: dirPath, entries: [], error: err.message },
                     }));
                 }
@@ -483,21 +601,21 @@ export class BridgeSession {
                 catch { }
                 this.send(createEnvelope({
                     type: "terminal.history.response",
-                    hostDeviceId: this.sessionId,
+                    sessionId: this.sessionId,
                     payload: { entries, shell },
                 }));
                 break;
             }
-            case "device.ack": {
-                const p = parseTypedPayload("device.ack", envelope.payload);
+            case "session.ack": {
+                const p = parseTypedPayload("session.ack", envelope.payload);
                 const term = this.terminals.get(tid);
                 if (term) {
                     term.scrollback.trimUpTo(p.seq);
                 }
                 break;
             }
-            case "device.resume": {
-                const p = parseTypedPayload("device.resume", envelope.payload);
+            case "session.resume": {
+                const p = parseTypedPayload("session.resume", envelope.payload);
                 // Replay all terminals
                 for (const [termId, term] of this.terminals) {
                     this.replayFrom(termId, term, p.lastAckedSeqByTerminal[termId] ?? p.lastAckedSeq);
@@ -506,7 +624,7 @@ export class BridgeSession {
                 this.sendTerminalList();
                 break;
             }
-            case "device.heartbeat":
+            case "session.heartbeat":
                 break;
             case "screen.start": {
                 const p = parseTypedPayload("screen.start", envelope.payload);
@@ -527,29 +645,66 @@ export class BridgeSession {
                 this.screenShare?.handleIceCandidate(p.candidate, p.sdpMid, p.sdpMLineIndex);
                 break;
             }
-            case "agent.codex.rpc": {
-                if (!this.agentWorkspace) {
-                    const payload = parseTypedPayload("agent.codex.rpc", envelope.payload);
-                    const idValue = payload && typeof payload === "object" && "id" in payload
-                        ? payload.id
-                        : undefined;
-                    if (typeof idValue === "string" || typeof idValue === "number") {
-                        this.send(createEnvelope({
-                            type: "agent.codex.rpc",
-                            hostDeviceId: this.sessionId,
-                            payload: {
-                                jsonrpc: "2.0",
-                                id: idValue,
-                                error: {
-                                    code: -32000,
-                                    message: "Codex RPC is not enabled. Start CLI with --agent-ui.",
-                                },
-                            },
-                        }));
-                    }
+            case "agent.initialize":
+            case "agent.session.new":
+            case "agent.session.load":
+            case "agent.session.list":
+            case "agent.prompt":
+            case "agent.cancel": {
+                if (!this.agentSession) {
+                    this.send(createEnvelope({
+                        type: "agent.capabilities",
+                        sessionId: this.sessionId,
+                        payload: {
+                            enabled: false,
+                            provider: normalizeAgentProvider(this.options.agentProvider ?? "codex"),
+                            machineId: this.machineIdentity?.machineId,
+                            error: "Agent GUI is not enabled. Start CLI with --agent-ui.",
+                            supportsSessionList: false,
+                            supportsSessionLoad: false,
+                            supportsImages: false,
+                            supportsAudio: false,
+                            supportsPermission: false,
+                            supportsPlan: false,
+                            supportsCancel: false,
+                        },
+                    }));
                     break;
                 }
-                await this.agentWorkspace.handleEnvelope(envelope);
+                if (envelope.type === "agent.prompt")
+                    this.refreshAgentPermissionHooks();
+                await this.agentSession.handleEnvelope(envelope);
+                break;
+            }
+            case "agent.permission.response": {
+                const p = parseTypedPayload("agent.permission.response", envelope.payload);
+                if (this.resolvePendingPermission(p.requestId, {
+                    outcome: p.outcome,
+                    optionId: p.optionId,
+                }, "agent.permission.response").resolved) {
+                    break;
+                }
+                if (!this.agentSession) {
+                    this.send(createEnvelope({
+                        type: "agent.capabilities",
+                        sessionId: this.sessionId,
+                        payload: {
+                            enabled: false,
+                            provider: normalizeAgentProvider(this.options.agentProvider ?? "codex"),
+                            machineId: this.machineIdentity?.machineId,
+                            error: "Agent GUI is not enabled. Start CLI with --agent-ui.",
+                            supportsSessionList: false,
+                            supportsSessionLoad: false,
+                            supportsImages: false,
+                            supportsAudio: false,
+                            supportsPermission: false,
+                            supportsPlan: false,
+                            supportsCancel: false,
+                        },
+                    }));
+                    break;
+                }
+                await this.agentSession.handleEnvelope(envelope);
                 break;
             }
             case "agent.v2.capabilities.request":
@@ -560,13 +715,11 @@ export class BridgeSession {
             case "agent.v2.cancel":
             case "agent.v2.permission.respond":
             case "agent.v2.structured_input.respond":
-            case "agent.v2.snapshot.request":
-            case "agent.v2.history.request":
-            case "agent.v2.delta.request": {
+            case "agent.v2.snapshot.request": {
                 if (!this.agentWorkspace) {
                     this.send(createEnvelope({
                         type: "agent.v2.capabilities",
-                        hostDeviceId: this.sessionId,
+                        sessionId: this.sessionId,
                         payload: {
                             enabled: false,
                             provider: normalizeAgentProvider(this.options.agentProvider ?? "codex"),
@@ -584,6 +737,8 @@ export class BridgeSession {
                     }));
                     break;
                 }
+                if (envelope.type === "agent.v2.prompt" || envelope.type === "agent.v2.command.execute")
+                    this.refreshAgentPermissionHooks();
                 await this.agentWorkspace.handleEnvelope(envelope);
                 break;
             }
@@ -599,6 +754,37 @@ export class BridgeSession {
                 }
                 break;
             }
+            case "permission.decision": {
+                const p = envelope.payload;
+                const result = this.resolvePendingPermission(p.requestId, p.decision, "permission.decision");
+                if (!result.resolved) {
+                    this.sendPermissionSnapshot(tid, "thinking", "permission not pending", {
+                        requestId: p.requestId,
+                        outcome: p.decision,
+                        source: "permission.decision",
+                        delivered: false,
+                    });
+                }
+                process.stderr.write(`[bridge] permission decision request=${p.requestId} decision=${p.decision} resolved=${result.resolved} delivered=${result.delivered}\n`);
+                this.send(createEnvelope({
+                    type: "permission.decision.result",
+                    sessionId: this.sessionId,
+                    terminalId: tid,
+                    payload: {
+                        requestId: p.requestId,
+                        decision: p.decision,
+                        resolved: result.resolved,
+                        delivered: result.delivered,
+                        source: "permission.decision",
+                        message: result.delivered
+                            ? undefined
+                            : result.resolved
+                                ? "Permission resolved but response was not delivered"
+                                : "Permission request is no longer pending",
+                    },
+                }));
+                break;
+            }
             case "tunnel.request": {
                 const p = parseTypedPayload("tunnel.request", envelope.payload);
                 this.handleTunnelRequest(p);
@@ -647,7 +833,7 @@ export class BridgeSession {
             proxyRes.on("data", (chunk) => {
                 this.send(createEnvelope({
                     type: "tunnel.response",
-                    hostDeviceId: this.sessionId,
+                    sessionId: this.sessionId,
                     payload: {
                         requestId,
                         statusCode: proxyRes.statusCode ?? 200,
@@ -661,7 +847,7 @@ export class BridgeSession {
             proxyRes.on("end", () => {
                 this.send(createEnvelope({
                     type: "tunnel.response",
-                    hostDeviceId: this.sessionId,
+                    sessionId: this.sessionId,
                     payload: {
                         requestId,
                         statusCode: proxyRes.statusCode ?? 200,
@@ -698,7 +884,7 @@ export class BridgeSession {
             const buf = typeof data === "string" ? Buffer.from(data) : data;
             this.send(createEnvelope({
                 type: "tunnel.ws.data",
-                hostDeviceId: this.sessionId,
+                sessionId: this.sessionId,
                 payload: {
                     requestId,
                     data: buf.toString("base64"),
@@ -711,7 +897,7 @@ export class BridgeSession {
             const safeCode = typeof code === "number" && code >= 1000 && code <= 4999 ? code : 1000;
             this.send(createEnvelope({
                 type: "tunnel.ws.close",
-                hostDeviceId: this.sessionId,
+                sessionId: this.sessionId,
                 payload: {
                     requestId,
                     code: safeCode,
@@ -723,7 +909,7 @@ export class BridgeSession {
             this.tunnelSockets.delete(requestId);
             this.send(createEnvelope({
                 type: "tunnel.ws.close",
-                hostDeviceId: this.sessionId,
+                sessionId: this.sessionId,
                 payload: {
                     requestId,
                     code: 1001,
@@ -750,7 +936,7 @@ export class BridgeSession {
     sendTunnelError(requestId, statusCode, message) {
         this.send(createEnvelope({
             type: "tunnel.response",
-            hostDeviceId: this.sessionId,
+            sessionId: this.sessionId,
             payload: {
                 requestId,
                 statusCode,
@@ -764,12 +950,13 @@ export class BridgeSession {
         const terminals = [...this.terminals.values()].map((t) => ({
             terminalId: t.id,
             cwd: t.cwd,
+            projectName: t.projectName,
+            provider: t.provider,
             status: t.status,
-            shell: this.options.providerConfig.command,
         }));
         this.send(createEnvelope({
             type: "terminal.list",
-            hostDeviceId: this.sessionId,
+            sessionId: this.sessionId,
             payload: { terminals },
         }));
     }
@@ -779,20 +966,46 @@ export class BridgeSession {
             const payload = msg.payload;
             this.send(createEnvelope({
                 type: "terminal.output",
-                hostDeviceId: this.sessionId,
+                sessionId: this.sessionId,
                 terminalId,
                 seq: msg.seq,
                 payload: { ...payload, isReplay: true },
             }));
         }
     }
-    async spawnTerminal(terminalId, cwd) {
+    async spawnTerminal(terminalId, cwd, providerOverride) {
         const cleanEnv = {};
         for (const [k, v] of Object.entries(this.options.providerConfig.env)) {
             if (v !== undefined)
                 cleanEnv[k] = v;
         }
+        const hookMarker = this.terminalHookMarker(terminalId);
+        // Inject marker so child CLIs' hook commands carry our identity
+        cleanEnv["LINKSHELL_ID"] = hookMarker;
+        const provider = providerOverride ?? this.options.providerConfig.provider;
         const args = [...this.options.providerConfig.args];
+        // Set up hook server for structured status (all supported providers)
+        // For "custom" shell, set up hooks for all providers since user may launch any of them
+        let hookServer;
+        let hookPort;
+        const hookConfigPaths = [];
+        if (provider === "custom") {
+            const result = await this.setupHookServer(terminalId, args, "claude", hookMarker);
+            hookServer = result.server;
+            hookPort = result.port;
+            hookConfigPaths.push(result.configPath);
+            // Also set up hooks for other providers (curlCmd already has marker from setupHookServer)
+            const curlCmd = `curl -s --connect-timeout 1 --max-time ${Math.ceil((PERMISSION_REQUEST_TIMEOUT_MS + 30_000) / 1000)} -X POST "http://127.0.0.1:${result.port}/hook?m=${hookMarker}&lid=$LINKSHELL_ID" -H 'Content-Type: application/json' --data-binary @- || true`;
+            hookConfigPaths.push(this.setupCodexHooks(terminalId, curlCmd, hookMarker));
+            hookConfigPaths.push(this.setupGeminiHooks(terminalId, curlCmd, hookMarker));
+            hookConfigPaths.push(this.setupCopilotHooks(terminalId, curlCmd, hookMarker));
+        }
+        else if (provider === "claude" || provider === "codex" || provider === "gemini" || provider === "copilot") {
+            const result = await this.setupHookServer(terminalId, args, provider, hookMarker);
+            hookServer = result.server;
+            hookPort = result.port;
+            hookConfigPaths.push(result.configPath);
+        }
         const term = {
             id: terminalId,
             pty: pty.spawn(this.options.providerConfig.command, args, {
@@ -803,15 +1016,22 @@ export class BridgeSession {
                 env: cleanEnv,
             }),
             cwd,
+            projectName: basename(cwd),
+            provider,
             scrollback: new ScrollbackBuffer(1000),
             outputSeq: 0,
+            statusSeq: 0,
             status: "running",
+            hookServer,
+            hookPort,
+            hookMarker,
+            hookConfigPaths,
         };
         term.pty.onData((data) => {
             const seq = term.outputSeq++;
             const envelope = createEnvelope({
                 type: "terminal.output",
-                hostDeviceId: this.sessionId,
+                sessionId: this.sessionId,
                 terminalId,
                 seq,
                 payload: {
@@ -827,9 +1047,10 @@ export class BridgeSession {
         });
         term.pty.onExit(({ exitCode, signal }) => {
             term.status = "exited";
+            this.cleanupHookServer(term);
             this.send(createEnvelope({
                 type: "terminal.exit",
-                hostDeviceId: this.sessionId,
+                sessionId: this.sessionId,
                 terminalId,
                 payload: { exitCode, signal },
             }));
@@ -848,12 +1069,698 @@ export class BridgeSession {
         this.terminals.set(terminalId, term);
         this.log(`spawned terminal ${terminalId} in ${cwd}`);
     }
+    async setupHookServer(terminalId, args, provider, marker) {
+        const server = http.createServer((req, res) => {
+            this.log(`hook server received: ${req.method} ${req.url}`);
+            const reqUrl = new URL(req.url ?? "/", "http://localhost");
+            if (req.method !== "POST" || reqUrl.pathname !== "/hook") {
+                res.writeHead(404);
+                res.end();
+                return;
+            }
+            // Check marker — reject events not from our PTY
+            // m must match; lid must match OR be empty (some CLIs don't inherit env vars)
+            const reqMarker = reqUrl.searchParams.get("m");
+            const reqLid = reqUrl.searchParams.get("lid") ?? "";
+            if (reqMarker !== marker || (reqLid !== "" && reqLid !== marker)) {
+                this.log(`ignoring hook event: m=${reqMarker} lid=${reqLid} (expected ${marker})`);
+                res.writeHead(200);
+                res.end("ok");
+                return;
+            }
+            let body = "";
+            let bodyTooLarge = false;
+            req.on("data", (chunk) => {
+                if (bodyTooLarge)
+                    return;
+                body += chunk.toString();
+                if (Buffer.byteLength(body, "utf8") > HOOK_BODY_LIMIT) {
+                    bodyTooLarge = true;
+                    res.writeHead(413);
+                    res.end("payload too large");
+                    req.destroy();
+                }
+            });
+            req.on("end", () => {
+                if (bodyTooLarge || res.writableEnded)
+                    return;
+                this.log(`hook body (${body.length} bytes): ${body.slice(0, 200)}`);
+                try {
+                    const event = JSON.parse(body);
+                    const hookName = (event.hook_event_name ?? event.event_name);
+                    // PermissionRequest: hold connection, wait for user decision from mobile app
+                    if (hookName === "PermissionRequest") {
+                        const requestId = `pr-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+                        const permissionSuggestions = hookPermissionSuggestions(event);
+                        const timeout = setTimeout(() => {
+                            if (this.resolvePendingPermission(requestId, "deny", "permission.timeout").resolved) {
+                                this.log(`permission request ${requestId} timed out`);
+                                this.sendPermissionSnapshot(terminalId, "thinking", "permission timed out");
+                            }
+                        }, PERMISSION_REQUEST_TIMEOUT_MS);
+                        this.pendingPermissions.set(requestId, {
+                            terminalId,
+                            timeout,
+                            permissionSuggestions,
+                            resolve: (decision) => {
+                                if (res.writableEnded)
+                                    return false;
+                                const responseJson = JSON.stringify({
+                                    hookSpecificOutput: {
+                                        hookEventName: "PermissionRequest",
+                                        decision,
+                                    },
+                                });
+                                res.writeHead(200, { "Content-Type": "application/json" });
+                                res.end(responseJson);
+                                return true;
+                            },
+                        });
+                        // Send status with requestId so app can route decision back
+                        this.handleHookEvent(terminalId, event, provider, requestId);
+                        this.sendHookPermissionRequest(terminalId, event, requestId);
+                    }
+                    else {
+                        // All other hooks: respond immediately
+                        res.writeHead(200);
+                        res.end("ok");
+                        this.handleHookEvent(terminalId, event, provider);
+                    }
+                }
+                catch (e) {
+                    res.writeHead(200);
+                    res.end("ok");
+                    this.log(`hook parse error: ${e}`);
+                }
+            });
+        });
+        // Listen on random port — await binding before reading address
+        const port = await new Promise((resolve, reject) => {
+            server.listen(0, "127.0.0.1", () => {
+                const addr = server.address();
+                resolve(addr.port);
+            });
+            server.on("error", reject);
+        });
+        this.log(`hook server for ${terminalId} (${provider}) listening on port ${port}, marker=${marker}`);
+        const curlCmd = `curl -s --connect-timeout 1 --max-time ${Math.ceil((PERMISSION_REQUEST_TIMEOUT_MS + 30_000) / 1000)} -X POST "http://127.0.0.1:${port}/hook?m=${marker}&lid=$LINKSHELL_ID" -H 'Content-Type: application/json' --data-binary @- || true`;
+        let configPath;
+        if (provider === "codex") {
+            configPath = this.setupCodexHooks(terminalId, curlCmd, marker);
+        }
+        else if (provider === "gemini") {
+            configPath = this.setupGeminiHooks(terminalId, curlCmd, marker);
+        }
+        else if (provider === "copilot") {
+            configPath = this.setupCopilotHooks(terminalId, curlCmd, marker);
+        }
+        else {
+            // Claude (default)
+            configPath = this.setupClaudeHooks(terminalId, curlCmd, args, marker);
+        }
+        return { server, port, configPath };
+    }
+    refreshAgentPermissionHooks() {
+        const term = this.terminals.get(DEFAULT_TERMINAL_ID);
+        if (!term?.hookPort)
+            return;
+        const marker = term.hookMarker;
+        const curlCmd = `curl -s --connect-timeout 1 --max-time ${Math.ceil((PERMISSION_REQUEST_TIMEOUT_MS + 30_000) / 1000)} -X POST "http://127.0.0.1:${term.hookPort}/hook?m=${marker}&lid=$LINKSHELL_ID" -H 'Content-Type: application/json' --data-binary @- || true`;
+        const providers = this.options.agentProvider
+            ? [normalizeAgentProvider(this.options.agentProvider)]
+            : detectAvailableProviders();
+        try {
+            for (const provider of providers) {
+                if (provider === "codex") {
+                    this.setupCodexHooks(DEFAULT_TERMINAL_ID, curlCmd, marker);
+                }
+                else {
+                    // claude, custom
+                    this.setupClaudeHooks(DEFAULT_TERMINAL_ID, curlCmd, [], marker);
+                }
+            }
+        }
+        catch (error) {
+            this.log(`failed to refresh agent permission hooks: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    setupClaudeHooks(terminalId, curlCmd, args, marker) {
+        // Write hooks to ~/.claude/settings.json — Claude Code reads hooks from here
+        const claudeDir = join(homedir(), ".claude");
+        if (!existsSync(claudeDir))
+            mkdirSync(claudeDir, { recursive: true });
+        const settingsPath = join(claudeDir, "settings.json");
+        let existing = {};
+        try {
+            existing = JSON.parse(readFileSync(settingsPath, "utf8"));
+        }
+        catch { /* doesn't exist yet */ }
+        const hookEntry = { matcher: "", hooks: [{ type: "command", command: curlCmd, timeout: 5 }] };
+        const permissionEntry = {
+            matcher: "",
+            hooks: [{
+                    type: "command",
+                    command: curlCmd,
+                    timeout: Math.ceil((PERMISSION_REQUEST_TIMEOUT_MS + 30_000) / 1000),
+                }],
+        };
+        const hookEvents = {
+            PreToolUse: hookEntry,
+            PostToolUse: hookEntry,
+            PostToolUseFailure: hookEntry,
+            Stop: hookEntry,
+            PermissionRequest: permissionEntry,
+            UserPromptSubmit: hookEntry,
+            SessionStart: hookEntry,
+        };
+        // Append our entries to existing hooks (first remove stale linkshell entries)
+        const existingHooks = (existing.hooks ?? {});
+        for (const [eventName, entry] of Object.entries(hookEvents)) {
+            existingHooks[eventName] = eventName === "PermissionRequest"
+                ? withBlockingLinkShellPermissionEntry(existingHooks[eventName], entry)
+                : withLinkShellHookEntry(existingHooks[eventName], entry, "last");
+        }
+        const merged = { ...existing, hooks: existingHooks };
+        writeFileSync(settingsPath, JSON.stringify(merged, null, 2));
+        this.log(`claude hooks appended to ${settingsPath}`);
+        return settingsPath;
+    }
+    setupCodexHooks(terminalId, curlCmd, marker) {
+        // Codex uses ~/.codex/hooks.json — same format as Claude (with matcher)
+        const codexDir = join(homedir(), ".codex");
+        if (!existsSync(codexDir))
+            mkdirSync(codexDir, { recursive: true });
+        // Ensure [features] codex_hooks = true in config.toml
+        const tomlPath = join(codexDir, "config.toml");
+        let tomlContent = "";
+        try {
+            tomlContent = readFileSync(tomlPath, "utf8");
+        }
+        catch { /* doesn't exist yet */ }
+        // Remove top-level codex_hooks (wrong location) and ensure it's under [features]
+        const hasFeatureSection = tomlContent.includes("[features]");
+        const hasCodexHooksUnderFeatures = hasFeatureSection &&
+            /\[features\][^\[]*codex_hooks\s*=\s*true/s.test(tomlContent);
+        if (!hasCodexHooksUnderFeatures) {
+            // Remove any top-level codex_hooks line
+            tomlContent = tomlContent.replace(/^codex_hooks\s*=.*\n?/m, "");
+            if (!tomlContent.includes("[features]")) {
+                tomlContent += `\n[features]\ncodex_hooks = true\n`;
+            }
+            else {
+                tomlContent = tomlContent.replace("[features]", "[features]\ncodex_hooks = true");
+            }
+            writeFileSync(tomlPath, tomlContent);
+            this.log(`enabled codex_hooks under [features] in ${tomlPath}`);
+        }
+        const hooksPath = join(codexDir, "hooks.json");
+        const hookEntry = { matcher: "", hooks: [{ type: "command", command: curlCmd, timeout: 5 }] };
+        const permissionEntry = {
+            matcher: "",
+            hooks: [{
+                    type: "command",
+                    command: curlCmd,
+                    timeout: Math.ceil((PERMISSION_REQUEST_TIMEOUT_MS + 30_000) / 1000),
+                }],
+        };
+        const hookEvents = {
+            SessionStart: hookEntry,
+            PreToolUse: hookEntry,
+            PostToolUse: hookEntry,
+            UserPromptSubmit: hookEntry,
+            Stop: hookEntry,
+            PermissionRequest: permissionEntry,
+        };
+        // Read existing and append
+        let existing = {};
+        try {
+            existing = JSON.parse(readFileSync(hooksPath, "utf8"));
+        }
+        catch { /* doesn't exist yet */ }
+        const existingHooks = existing.hooks ?? {};
+        for (const [eventName, entry] of Object.entries(hookEvents)) {
+            existingHooks[eventName] = eventName === "PermissionRequest"
+                ? withBlockingLinkShellPermissionEntry(existingHooks[eventName], entry)
+                : withLinkShellHookEntry(existingHooks[eventName], entry, "last");
+        }
+        writeFileSync(hooksPath, JSON.stringify({ ...existing, hooks: existingHooks }, null, 2));
+        this.log(`codex hooks appended to ${hooksPath}`);
+        return hooksPath;
+    }
+    setupGeminiHooks(terminalId, curlCmd, marker) {
+        // Gemini uses ~/.gemini/settings.json — same format as Claude (with matcher)
+        const geminiDir = join(homedir(), ".gemini");
+        if (!existsSync(geminiDir))
+            mkdirSync(geminiDir, { recursive: true });
+        const settingsPath = join(geminiDir, "settings.json");
+        const hookEntry = { matcher: "", hooks: [{ type: "command", command: curlCmd, timeout: 5000 }] };
+        const hookEvents = {
+            SessionStart: hookEntry,
+            SessionEnd: hookEntry,
+            BeforeTool: hookEntry,
+            AfterTool: hookEntry,
+        };
+        // Merge with existing settings if present
+        let existing = {};
+        try {
+            existing = JSON.parse(readFileSync(settingsPath, "utf8"));
+        }
+        catch { /* doesn't exist yet */ }
+        const existingHooks = (existing.hooks ?? {});
+        for (const [eventName, entry] of Object.entries(hookEvents)) {
+            existingHooks[eventName] = withLinkShellHookEntry(existingHooks[eventName], entry, "last");
+        }
+        existing.hooks = existingHooks;
+        writeFileSync(settingsPath, JSON.stringify(existing, null, 2));
+        this.log(`gemini hooks appended to ${settingsPath}`);
+        return settingsPath;
+    }
+    setupCopilotHooks(terminalId, curlCmd, marker) {
+        // Copilot loads hooks from CWD as hooks.json
+        const cwd = this.terminals.get(terminalId)?.cwd ?? process.cwd();
+        const hooksPath = join(cwd, "hooks.json");
+        const mkHook = () => ({
+            type: "command",
+            bash: curlCmd,
+            timeoutSec: 30,
+        });
+        const hookEvents = {
+            sessionStart: mkHook(),
+            sessionEnd: mkHook(),
+            userPromptSubmitted: mkHook(),
+            preToolUse: mkHook(),
+            postToolUse: mkHook(),
+            errorOccurred: mkHook(),
+        };
+        // Read existing and append
+        let existing = {};
+        try {
+            existing = JSON.parse(readFileSync(hooksPath, "utf8"));
+        }
+        catch { /* doesn't exist yet */ }
+        const existingHooks = existing.hooks ?? {};
+        for (const [eventName, entry] of Object.entries(hookEvents)) {
+            existingHooks[eventName] = withLinkShellHookEntry(existingHooks[eventName], entry, "last");
+        }
+        writeFileSync(hooksPath, JSON.stringify({ version: 1, hooks: existingHooks }, null, 2));
+        this.log(`copilot hooks appended to ${hooksPath}`);
+        return hooksPath;
+    }
+    handleHookEvent(terminalId, event, provider, permissionRequestId) {
+        const rawHookName = (event.hook_event_name ?? event.event_name);
+        if (!rawHookName)
+            return;
+        // Auto-detect provider from hook event fields
+        const hookTerm = this.terminals.get(terminalId);
+        let detectedProvider = provider;
+        // Always detect from transcript_path (most reliable), regardless of current provider
+        const transcriptPath = typeof event.transcript_path === "string" ? event.transcript_path : "";
+        if (transcriptPath.includes(".claude/")) {
+            detectedProvider = "claude";
+        }
+        else if (transcriptPath.includes(".gemini/")) {
+            detectedProvider = "gemini";
+        }
+        else if (transcriptPath.includes(".codex/")) {
+            detectedProvider = "codex";
+        }
+        else if (hookTerm?.provider === "custom") {
+            // Fallback heuristics only when provider is still unknown
+            if (event.model && typeof event.model === "string" && /^(gpt|o[0-9]|codex)/i.test(event.model)) {
+                detectedProvider = "codex";
+            }
+            else if (event.session_id && !transcriptPath) {
+                detectedProvider = "codex";
+            }
+            else if (/^(Before|After)(Tool)$|^Session(Start|End)$/.test(rawHookName)) {
+                detectedProvider = "gemini";
+            }
+            else if (/^(pre|post)ToolUse$|^session(Start|End)$|^userPromptSubmitted$|^errorOccurred$/.test(rawHookName)) {
+                detectedProvider = "copilot";
+            }
+        }
+        if (hookTerm && detectedProvider !== hookTerm.provider) {
+            const wasCustom = hookTerm.provider === "custom";
+            hookTerm.provider = detectedProvider;
+            this.log(`${wasCustom ? "detected" : "provider switched"} provider for ${terminalId}: ${detectedProvider}`);
+            this.permissionStacks.delete(terminalId);
+            this.sendTerminalList();
+        }
+        // Normalize hook event names from different providers to unified names
+        const hookName = this.normalizeHookName(rawHookName, detectedProvider);
+        if (!hookName)
+            return;
+        let phase;
+        let toolName;
+        let toolInput;
+        let permissionRequest;
+        let summary;
+        switch (hookName) {
+            case "PreToolUse":
+                phase = "tool_use";
+                toolName = (event.tool_name ?? event.toolName);
+                if (event.tool_input && typeof event.tool_input === "object") {
+                    const input = event.tool_input;
+                    toolInput = JSON.stringify(input).slice(0, 200);
+                }
+                else if (event.toolInput && typeof event.toolInput === "object") {
+                    toolInput = JSON.stringify(event.toolInput).slice(0, 200);
+                }
+                break;
+            case "PostToolUse":
+                phase = "thinking";
+                toolName = (event.tool_name ?? event.toolName);
+                // Pop permission stack + auto-resolve pending HTTP connection
+                {
+                    const stack = this.permissionStacks.get(terminalId);
+                    if (stack && stack.length > 0) {
+                        const popped = stack.pop();
+                        if (popped)
+                            this.autoResolvePending(popped.requestId);
+                        if (stack.length === 0)
+                            this.permissionStacks.delete(terminalId);
+                    }
+                }
+                break;
+            case "PostToolUseFailure":
+                phase = "error";
+                toolName = (event.tool_name ?? event.toolName);
+                {
+                    const stack = this.permissionStacks.get(terminalId);
+                    if (stack && stack.length > 0) {
+                        const popped = stack.pop();
+                        if (popped)
+                            this.autoResolvePending(popped.requestId);
+                        if (stack.length === 0)
+                            this.permissionStacks.delete(terminalId);
+                    }
+                }
+                break;
+            case "Stop":
+                phase = "idle";
+                if (event.stop_reason)
+                    summary = String(event.stop_reason);
+                this.drainPendingPermissions(terminalId);
+                this.permissionStacks.delete(terminalId);
+                // Reset provider to "custom" when a CLI session ends inside a custom shell
+                if (hookTerm && this.options.providerConfig.provider === "custom") {
+                    hookTerm.provider = "custom";
+                    this.log(`provider reset to custom for ${terminalId} (CLI session ended)`);
+                    this.sendTerminalList();
+                }
+                break;
+            case "PermissionRequest":
+                phase = "waiting";
+                toolName = (event.tool_name ?? event.toolName);
+                if (event.tool_input && typeof event.tool_input === "object") {
+                    const input = event.tool_input;
+                    permissionRequest = JSON.stringify(input).slice(0, 300);
+                }
+                else if (event.toolInput && typeof event.toolInput === "object") {
+                    permissionRequest = JSON.stringify(event.toolInput).slice(0, 300);
+                }
+                // Push to permission stack (use requestId from hook server if available)
+                {
+                    const reqId = permissionRequestId ?? `pr-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+                    if (!this.permissionStacks.has(terminalId)) {
+                        this.permissionStacks.set(terminalId, []);
+                    }
+                    this.permissionStacks.get(terminalId).push({
+                        requestId: reqId,
+                        toolName: toolName ?? "unknown",
+                        toolInput: toolInput ?? (permissionRequest ?? ""),
+                        permissionRequest: permissionRequest ?? "",
+                        timestamp: Date.now(),
+                    });
+                }
+                break;
+            case "SessionStart":
+                phase = "idle";
+                summary = "session started";
+                break;
+            case "UserPromptSubmit":
+                phase = "thinking";
+                this.drainPendingPermissions(terminalId);
+                this.permissionStacks.delete(terminalId);
+                break;
+            default:
+                return;
+        }
+        this.log(`hook event [${provider}]: ${rawHookName} → ${hookName} → phase=${phase} tool=${toolName ?? "none"}`);
+        // Build topPermission from stack
+        const stack = this.permissionStacks.get(terminalId);
+        const topPermission = stack && stack.length > 0 ? stack[stack.length - 1] : undefined;
+        const pendingPermissionCount = stack?.length ?? 0;
+        // Increment statusSeq for ordering
+        const term = this.terminals.get(terminalId);
+        const seq = term ? term.statusSeq++ : 0;
+        this.send(createEnvelope({
+            type: "terminal.status",
+            sessionId: this.sessionId,
+            terminalId,
+            payload: {
+                phase,
+                seq,
+                ...(toolName && { toolName }),
+                ...(toolInput && { toolInput }),
+                ...(permissionRequest && { permissionRequest }),
+                ...(summary && { summary }),
+                ...(topPermission && { topPermission }),
+                ...(pendingPermissionCount > 0 && { pendingPermissionCount }),
+            },
+        }));
+    }
+    sendHookPermissionRequest(terminalId, event, requestId) {
+        const toolName = (event.tool_name ?? event.toolName);
+        const toolInput = stringifyHookInput(event.tool_input ?? event.toolInput);
+        const suggestions = hookPermissionSuggestions(event);
+        const context = typeof event.permission_prompt === "string"
+            ? event.permission_prompt
+            : typeof event.message === "string"
+                ? event.message
+                : undefined;
+        this.send(createEnvelope({
+            type: "agent.permission.request",
+            sessionId: this.sessionId,
+            terminalId,
+            payload: {
+                requestId,
+                toolName,
+                toolInput,
+                context,
+                options: hookPermissionOptions(suggestions),
+            },
+        }));
+    }
+    /**
+     * Normalize hook event names from different CLI providers to unified internal names.
+     * Claude: PascalCase (PreToolUse, PostToolUse, Stop, PermissionRequest)
+     * Codex: camelCase (preToolUse, postToolUse, sessionStart)
+     * Gemini: PascalCase but different names (BeforeTool, AfterTool, BeforeSubmitPrompt)
+     */
+    normalizeHookName(rawName, provider) {
+        // Claude events — already in our canonical format
+        if (provider === "claude") {
+            return rawName;
+        }
+        // Codex events — same as Claude (PascalCase)
+        if (provider === "codex") {
+            switch (rawName) {
+                case "PreToolUse":
+                case "preToolUse": return "PreToolUse";
+                case "PostToolUse":
+                case "postToolUse": return "PostToolUse";
+                case "SessionStart":
+                case "sessionStart": return "SessionStart";
+                case "UserPromptSubmit": return "UserPromptSubmit";
+                case "PermissionRequest": return "PermissionRequest";
+                case "Stop": return "Stop";
+                default: return undefined;
+            }
+        }
+        // Gemini events
+        if (provider === "gemini") {
+            switch (rawName) {
+                case "BeforeTool": return "PreToolUse";
+                case "AfterTool": return "PostToolUse";
+                case "SessionStart": return "SessionStart";
+                case "SessionEnd": return "Stop";
+                default: return undefined;
+            }
+        }
+        // Copilot events (camelCase)
+        if (provider === "copilot") {
+            switch (rawName) {
+                case "preToolUse": return "PreToolUse";
+                case "postToolUse": return "PostToolUse";
+                case "sessionStart": return "SessionStart";
+                case "sessionEnd": return "Stop";
+                case "userPromptSubmitted": return "UserPromptSubmit";
+                case "errorOccurred": return "PostToolUseFailure";
+                default: return undefined;
+            }
+        }
+        // Unknown provider — try all known formats
+        // This handles "custom" shell where any provider might be launched
+        const allProviders = ["claude", "codex", "gemini", "copilot"];
+        for (const p of allProviders) {
+            const result = this.normalizeHookName(rawName, p);
+            if (result)
+                return result;
+        }
+        return undefined;
+    }
+    /** Auto-resolve a single pending permission (user acted in terminal) */
+    autoResolvePending(requestId) {
+        if (this.resolvePendingPermission(requestId, "allow", "terminal.auto").resolved) {
+            this.log(`auto-resolved pending permission ${requestId} (user acted in terminal)`);
+        }
+    }
+    /** Drain all pending permissions for a terminal (session ended, stop, etc.) */
+    drainPendingPermissions(terminalId) {
+        const stack = this.permissionStacks.get(terminalId);
+        if (!stack)
+            return;
+        for (const entry of [...stack]) {
+            if (this.resolvePendingPermission(entry.requestId, "deny", "terminal.drain").resolved) {
+                this.log(`drained pending permission ${entry.requestId}`);
+            }
+        }
+    }
+    resolvePendingPermission(requestId, choice, source = "unknown") {
+        const pending = this.pendingPermissions.get(requestId);
+        const outcome = typeof choice === "string" ? choice : choice.outcome;
+        const optionId = typeof choice === "string" ? undefined : choice.optionId;
+        if (!pending) {
+            this.log(`no pending permission for ${requestId} via ${source}: ${outcome}:${optionId ?? "default"}`);
+            return { resolved: false, delivered: false };
+        }
+        this.pendingPermissions.delete(requestId);
+        clearTimeout(pending.timeout);
+        const delivered = pending.resolve(this.formatHookPermissionDecision(pending, choice));
+        const stack = this.permissionStacks.get(pending.terminalId);
+        if (stack) {
+            const idx = stack.findIndex((entry) => entry.requestId === requestId);
+            if (idx >= 0)
+                stack.splice(idx, 1);
+            if (stack.length === 0)
+                this.permissionStacks.delete(pending.terminalId);
+        }
+        this.log(`resolved permission ${requestId} via ${source}: ${outcome}:${optionId ?? "default"} delivered=${delivered}`);
+        this.sendPermissionSnapshot(pending.terminalId, "thinking", outcome === "allow" ? "permission allowed" : "permission denied", { requestId, outcome, source, delivered });
+        return { resolved: true, delivered };
+    }
+    formatHookPermissionDecision(permission, choice) {
+        const outcome = typeof choice === "string" ? choice : choice.outcome;
+        const optionId = typeof choice === "string" ? undefined : choice.optionId;
+        if (outcome === "allow") {
+            return {
+                behavior: "allow",
+                ...(optionId === "allow_always" && permission.permissionSuggestions.length > 0
+                    ? { updatedPermissions: permission.permissionSuggestions }
+                    : {}),
+            };
+        }
+        return {
+            behavior: "deny",
+            message: outcome === "cancelled" ? "Permission request cancelled." : "Permission denied by user.",
+        };
+    }
+    sendPermissionSnapshot(terminalId, phase, summary, permissionResolution) {
+        const stack = this.permissionStacks.get(terminalId);
+        const topPermission = stack && stack.length > 0 ? stack[stack.length - 1] : undefined;
+        const pendingPermissionCount = stack?.length ?? 0;
+        const term = this.terminals.get(terminalId);
+        const seq = term ? term.statusSeq++ : 0;
+        this.send(createEnvelope({
+            type: "terminal.status",
+            sessionId: this.sessionId,
+            terminalId,
+            payload: {
+                phase,
+                seq,
+                ...(summary && { summary }),
+                ...(permissionResolution && { permissionResolution }),
+                ...(topPermission && { topPermission }),
+                ...(pendingPermissionCount > 0 && { pendingPermissionCount }),
+            },
+        }));
+    }
+    cleanupHookServer(term) {
+        // Drain any pending permission requests for this terminal
+        this.drainPendingPermissions(term.id);
+        if (term.hookServer) {
+            term.hookServer.close();
+            term.hookServer = undefined;
+            this.log(`hook server closed for ${term.id}`);
+        }
+        const marker = term.hookMarker;
+        for (const configPath of term.hookConfigPaths) {
+            try {
+                // Copilot: per-instance file — just delete it
+                if (configPath.includes(`linkshell-${marker}`)) {
+                    if (existsSync(configPath)) {
+                        unlinkSync(configPath);
+                        this.log(`removed copilot hook file ${configPath}`);
+                    }
+                }
+                else {
+                    // Claude/Codex/Gemini: remove our entries from the shared config
+                    this.removeHookEntries(configPath, marker);
+                }
+            }
+            catch { /* ignore */ }
+        }
+        term.hookConfigPaths = [];
+    }
+    /** Remove hook entries containing our marker from a JSON config file */
+    removeHookEntries(configPath, marker) {
+        if (!existsSync(configPath))
+            return;
+        try {
+            const raw = JSON.parse(readFileSync(configPath, "utf8"));
+            const hooks = raw.hooks;
+            if (!hooks)
+                return;
+            let changed = false;
+            for (const [eventName, entries] of Object.entries(hooks)) {
+                if (!Array.isArray(entries))
+                    continue;
+                const filtered = entries.filter((entry) => {
+                    const str = JSON.stringify(entry);
+                    return !str.includes(marker);
+                });
+                if (filtered.length !== entries.length) {
+                    changed = true;
+                    if (filtered.length === 0) {
+                        delete hooks[eventName];
+                    }
+                    else {
+                        hooks[eventName] = filtered;
+                    }
+                }
+            }
+            if (changed) {
+                // If no hooks left, remove the hooks key entirely
+                if (Object.keys(hooks).length === 0) {
+                    delete raw.hooks;
+                }
+                writeFileSync(configPath, JSON.stringify(raw, null, 2));
+                this.log(`removed our hook entries from ${configPath}`);
+            }
+        }
+        catch { /* ignore parse errors */ }
+    }
     send(message) {
         if (!this.socket || this.socket.readyState !== WebSocket.OPEN) {
             return;
         }
         const machineId = this.machineIdentity?.machineId;
-        const enriched = machineId && message.type.startsWith("agent.v2.")
+        const enriched = machineId && (message.type === "terminal.status" ||
+            message.type === "agent.capabilities" ||
+            message.type === "agent.snapshot" ||
+            message.type === "agent.v2.capabilities" ||
+            message.type === "agent.v2.snapshot")
             ? {
                 ...message,
                 payload: {
@@ -868,8 +1775,8 @@ export class BridgeSession {
         this.stopHeartbeat();
         this.heartbeatTimer = setInterval(() => {
             this.send(createEnvelope({
-                type: "device.heartbeat",
-                hostDeviceId: this.sessionId,
+                type: "session.heartbeat",
+                sessionId: this.sessionId,
                 payload: { ts: Date.now() },
             }));
         }, HEARTBEAT_INTERVAL);
@@ -885,7 +1792,7 @@ export class BridgeSession {
             this.log("screen sharing not enabled (use --screen)");
             this.send(createEnvelope({
                 type: "screen.status",
-                hostDeviceId: this.sessionId,
+                sessionId: this.sessionId,
                 payload: { active: false, mode: "off", error: "Screen sharing not enabled on host. Start CLI with --screen flag." },
             }));
             return;
@@ -896,7 +1803,7 @@ export class BridgeSession {
         if (ScreenShare.isAvailable()) {
             this.log("WebRTC available, starting screen share");
             this.screenShare = new ScreenShare({
-                hostDeviceId: this.sessionId,
+                sessionId: this.sessionId,
                 fps,
                 quality,
                 scale,
@@ -919,7 +1826,7 @@ export class BridgeSession {
             fps,
             quality,
             scale,
-            hostDeviceId: this.sessionId,
+            sessionId: this.sessionId,
             onFrame: (envelope) => this.send(envelope),
             onStatus: (envelope) => this.send(envelope),
         });
@@ -966,6 +1873,8 @@ export class BridgeSession {
         this.exited = true;
         this.stopHeartbeat();
         this.stopScreenCapture();
+        this.agentSession?.stop();
+        this.agentSession = undefined;
         this.agentWorkspace?.stop();
         this.agentWorkspace = undefined;
         this.keepAwake?.stop();
@@ -982,6 +1891,7 @@ export class BridgeSession {
         }
         this.tunnelSockets.clear();
         for (const term of this.terminals.values()) {
+            this.cleanupHookServer(term);
             if (term.status === "running")
                 term.pty.kill();
         }