@elizaos/plugin-agent-orchestrator 0.3.7 → 0.3.9

package/dist/api/hook-routes.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Claude Code HTTP Hooks — Webhook Endpoint
+ *
+ * Receives structured hook events from Claude Code's HTTP hooks system.
+ * Replaces fragile PTY output scraping for state detection with deterministic
+ * event-driven signals.
+ *
+ * @module api/hook-routes
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { RouteContext } from "./routes.js";
+/**
+ * Handle Claude Code HTTP hook routes.
+ * Returns true if the route was handled, false otherwise.
+ */
+export declare function handleHookRoutes(req: IncomingMessage, res: ServerResponse, pathname: string, ctx: RouteContext): Promise<boolean>;
+//# sourceMappingURL=hook-routes.d.ts.map

package/dist/api/hook-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-routes.d.ts","sourceRoot":"","sources":["../../src/api/hook-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAiBhD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,OAAO,CAAC,CAmHlB"}

package/dist/api/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/api/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAM/E,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEjC,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,gBAAgB,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAChD,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC;AAGD,eAAO,MAAM,aAAa,QAAc,CAAC;AAGzC,wBAAsB,SAAS,CAC7B,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAsBlC;AAGD,wBAAgB,QAAQ,CACtB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,SAAS,EACf,MAAM,SAAM,GACX,IAAI,CAGN;AAGD,wBAAgB,SAAS,CACvB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,MAAM,EACf,MAAM,SAAM,GACX,IAAI,CAEN;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,aAAa,EACtB,WAAW,CAAC,EAAE,gBAAgB,IAgBtB,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,UAAU,MAAM,sBAEpE"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/api/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAO/E,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEjC,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,gBAAgB,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAChD,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC;AAGD,eAAO,MAAM,aAAa,QAAc,CAAC;AAGzC,wBAAsB,SAAS,CAC7B,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAsBlC;AAGD,wBAAgB,QAAQ,CACtB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,SAAS,EACf,MAAM,SAAM,GACX,IAAI,CAGN;AAGD,wBAAgB,SAAS,CACvB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,MAAM,EACf,MAAM,SAAM,GACX,IAAI,CAEN;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,OAAO,CAAC,CA4BlB;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,aAAa,EACtB,WAAW,CAAC,EAAE,gBAAgB,IAgBtB,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,UAAU,MAAM,sBAEpE"}

package/dist/index.js

@@ -471,6 +471,18 @@ __export(exports_swarm_decision_loop, {
 });
 import * as path from "node:path";
 import { ModelType as ModelType3 } from "@elizaos/core";
+function withTimeout(promise, ms, label) {
+  return new Promise((resolve2, reject) => {
+    const timer = setTimeout(() => reject(new Error(`${label} timed out after ${ms}ms`)), ms);
+    promise.then((val) => {
+      clearTimeout(timer);
+      resolve2(val);
+    }, (err) => {
+      clearTimeout(timer);
+      reject(err);
+    });
+  });
+}
 function toContextSummary(taskCtx) {
   return {
     sessionId: taskCtx.sessionId,
@@ -679,7 +691,7 @@ async function handleBlocked(ctx, sessionId, taskCtx, data) {
     const count = taskCtx.autoResolvedCount;
     if (count <= 2 || count % 5 === 0) {
       const excerpt = promptText.length > 120 ? `${promptText.slice(0, 120)}...` : promptText;
-      ctx.sendChatMessage(`[${taskCtx.label}] Approved: ${excerpt}`, "coding-agent");
+      ctx.log(`[${taskCtx.label}] Approved: ${excerpt}`);
     }
     return;
   }
@@ -745,48 +757,16 @@ async function handleTurnComplete(ctx, sessionId, taskCtx, data) {
       const raw = await fetchRecentOutput(ctx, sessionId);
       turnOutput = cleanForChat(raw);
     }
-    const agentDecisionCb = ctx.getAgentDecisionCallback();
     let decision = null;
-    let decisionFromPipeline = false;
-    const triageCtx = {
-      eventType: "turn_complete",
-      promptText: "",
-      recentOutput: turnOutput,
-      originalTask: taskCtx.originalTask
-    };
-    const tier = agentDecisionCb ? await classifyEventTier(ctx.runtime, triageCtx, ctx.log) : "routine";
-    if (tier === "routine") {
-      const prompt = buildTurnCompletePrompt(toContextSummary(taskCtx), turnOutput, toDecisionHistory(taskCtx));
-      try {
-        const result = await ctx.runtime.useModel(ModelType3.TEXT_SMALL, {
-          prompt
-        });
-        decision = parseCoordinationResponse(result);
-      } catch (err) {
-        ctx.log(`Turn-complete LLM call failed: ${err}`);
-      }
-    } else {
-      if (agentDecisionCb) {
-        const eventMessage = buildTurnCompleteEventMessage(toContextSummary(taskCtx), turnOutput, toDecisionHistory(taskCtx));
-        try {
-          decision = await agentDecisionCb(eventMessage, sessionId, taskCtx);
-          if (decision)
-            decisionFromPipeline = true;
-        } catch (err) {
-          ctx.log(`Agent decision callback failed for turn-complete: ${err} — falling back to small LLM`);
-        }
-      }
-      if (!decision) {
-        const prompt = buildTurnCompletePrompt(toContextSummary(taskCtx), turnOutput, toDecisionHistory(taskCtx));
-        try {
-          const result = await ctx.runtime.useModel(ModelType3.TEXT_SMALL, {
-            prompt
-          });
-          decision = parseCoordinationResponse(result);
-        } catch (err) {
-          ctx.log(`Turn-complete LLM fallback call failed: ${err}`);
-        }
-      }
+    const decisionFromPipeline = false;
+    const prompt = buildTurnCompletePrompt(toContextSummary(taskCtx), turnOutput, toDecisionHistory(taskCtx));
+    try {
+      const result = await ctx.runtime.useModel(ModelType3.TEXT_SMALL, {
+        prompt
+      });
+      decision = parseCoordinationResponse(result);
+    } catch (err) {
+      ctx.log(`Turn-complete LLM call failed: ${err}`);
     }
     if (!decision) {
       ctx.log(`Turn-complete for "${taskCtx.label}": all decision paths failed — escalating`);
@@ -817,7 +797,7 @@ async function handleTurnComplete(ctx, sessionId, taskCtx, data) {
       if (decision.action === "respond") {
         const instruction = decision.response ?? "";
         const preview = instruction.length > 120 ? `${instruction.slice(0, 120)}...` : instruction;
-        ctx.sendChatMessage(`[${taskCtx.label}] Turn done, continuing: ${preview}`, "coding-agent");
+        ctx.log(`[${taskCtx.label}] Turn done, continuing: ${preview}`);
       } else if (decision.action === "escalate") {
         ctx.sendChatMessage(`[${taskCtx.label}] Turn finished — needs your attention: ${decision.reasoning}`, "coding-agent");
       }
@@ -856,7 +836,7 @@ async function handleAutonomousDecision(ctx, sessionId, taskCtx, promptText, rec
       if (agentDecisionCb) {
         const eventMessage = buildBlockedEventMessage(toContextSummary(taskCtx), promptText, output, toDecisionHistory(taskCtx));
         try {
-          decision = await agentDecisionCb(eventMessage, sessionId, taskCtx);
+          decision = await withTimeout(agentDecisionCb(eventMessage, sessionId, taskCtx), DECISION_CB_TIMEOUT_MS, "agentDecisionCb");
           if (decision)
             decisionFromPipeline = true;
         } catch (err) {
@@ -919,7 +899,7 @@ async function handleAutonomousDecision(ctx, sessionId, taskCtx, promptText, rec
       if (decision.action === "respond") {
         const actionDesc = decision.useKeys ? `Sent keys: ${decision.keys?.join(", ")}` : decision.response ? `Responded: ${decision.response.length > 100 ? `${decision.response.slice(0, 100)}...` : decision.response}` : "Responded";
         const reasonExcerpt = decision.reasoning.length > 150 ? `${decision.reasoning.slice(0, 150)}...` : decision.reasoning;
-        ctx.sendChatMessage(`[${taskCtx.label}] ${actionDesc} — ${reasonExcerpt}`, "coding-agent");
+        ctx.log(`[${taskCtx.label}] ${actionDesc} — ${reasonExcerpt}`);
       } else if (decision.action === "escalate") {
         ctx.sendChatMessage(`[${taskCtx.label}] Needs your attention: ${decision.reasoning}`, "coding-agent");
       }
@@ -956,7 +936,7 @@ async function handleConfirmDecision(ctx, sessionId, taskCtx, promptText, recent
       if (agentDecisionCb) {
         const eventMessage = buildBlockedEventMessage(toContextSummary(taskCtx), promptText, output, toDecisionHistory(taskCtx));
         try {
-          decision = await agentDecisionCb(eventMessage, sessionId, taskCtx);
+          decision = await withTimeout(agentDecisionCb(eventMessage, sessionId, taskCtx), DECISION_CB_TIMEOUT_MS, "agentDecisionCb");
           if (decision)
             decisionFromPipeline = true;
         } catch (err) {
@@ -1006,7 +986,7 @@ async function handleConfirmDecision(ctx, sessionId, taskCtx, promptText, recent
     await drainPendingTurnComplete(ctx, sessionId);
   }
 }
-var MAX_AUTO_RESPONSES = 10;
+var DECISION_CB_TIMEOUT_MS = 30000, MAX_AUTO_RESPONSES = 10;
 var init_swarm_decision_loop = __esm(() => {
   init_ansi_utils();
   init_swarm_event_triage();
@@ -2033,8 +2013,8 @@ import {
 } from "@elizaos/core";
 
 // src/services/pty-service.ts
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
+import { mkdir, readFile as readFile2, writeFile as writeFile2 } from "node:fs/promises";
+import { dirname, join as join2 } from "node:path";
 import { logger as logger2 } from "@elizaos/core";
 import {
   checkAdapters,
@@ -2234,6 +2214,7 @@ async function initializePTYManager(ctx) {
       ctx.log(`session_ready event received for ${session.id} (type: ${session.type}, status: ${session.status})`);
       ctx.emitEvent(session.id, "ready", { session });
       forwardReadyAsTaskComplete(ctx, session);
+      ctx.markTaskDelivered?.(session.id);
     });
     bunManager.on("session_exit", (id, code) => {
       ctx.emitEvent(id, "stopped", { reason: `exit code ${code}` });
@@ -2313,6 +2294,7 @@ async function initializePTYManager(ctx) {
   nodeManager.on("session_ready", (session) => {
     ctx.emitEvent(session.id, "ready", { session });
     forwardReadyAsTaskComplete(ctx, session);
+    ctx.markTaskDelivered?.(session.id);
   });
   nodeManager.on("blocking_prompt", (session, promptInfo, autoResponded) => {
     ctx.emitEvent(session.id, "blocked", { promptInfo, autoResponded });
@@ -2347,6 +2329,8 @@ async function initializePTYManager(ctx) {
 }
 
 // src/services/pty-session-io.ts
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
 async function sendToSession(ctx, sessionId, input) {
   const session = ctx.manager.get(sessionId);
   if (!session) {
@@ -2401,6 +2385,12 @@ async function stopSession(ctx, sessionId, sessionMetadata, sessionWorkdirs, log
       }
     } catch {}
     ctx.outputUnsubscribers.delete(sessionId);
+    const workdir = sessionWorkdirs.get(sessionId);
+    if (workdir) {
+      try {
+        await cleanupClaudeHooks(workdir, log);
+      } catch {}
+    }
     sessionMetadata.delete(sessionId);
     sessionWorkdirs.delete(sessionId);
     ctx.sessionOutputBuffers.delete(sessionId);
@@ -2408,6 +2398,18 @@ async function stopSession(ctx, sessionId, sessionMetadata, sessionWorkdirs, log
     log(`Stopped session ${sessionId}`);
   }
 }
+async function cleanupClaudeHooks(workdir, log) {
+  const settingsPath = join(workdir, ".claude", "settings.json");
+  try {
+    const raw = await readFile(settingsPath, "utf-8");
+    const settings = JSON.parse(raw);
+    if (!settings.hooks)
+      return;
+    delete settings.hooks;
+    await writeFile(settingsPath, JSON.stringify(settings, null, 2), "utf-8");
+    log(`Cleaned up hooks from ${settingsPath}`);
+  } catch {}
+}
 function subscribeToOutput(ctx, sessionId, callback) {
   if (ctx.usingBunWorker) {
     const unsubscribe2 = ctx.manager.onSessionData(sessionId, callback);
@@ -2519,6 +2521,7 @@ function setupDeferredTaskDelivery(ctx, session, task, agentType) {
     taskSent = true;
     if (readyTimeout)
       clearTimeout(readyTimeout);
+    ctx.markTaskDelivered(sid);
     setTimeout(() => sendTaskWithRetry(0), settleMs);
     if (ctx.usingBunWorker) {
       ctx.manager.removeListener("session_ready", onReady);
@@ -2567,7 +2570,12 @@ function buildSpawnConfig(sessionId, options, workdir) {
     type: options.agentType,
     workdir,
     inheritProcessEnv: false,
-    env: { ...buildSanitizedBaseEnv(), ...options.env, ...modelEnv },
+    env: {
+      ...buildSanitizedBaseEnv(),
+      ...options.env,
+      ...modelEnv,
+      PARALLAX_SESSION_ID: sessionId
+    },
     ...options.skipAdapterAutoResponse ? { skipAdapterAutoResponse: true } : {},
     adapterConfig: {
       ...options.credentials,
@@ -3059,7 +3067,7 @@ async function handleIdleCheck(ctx, taskCtx, idleMinutes) {
     });
     if (decision.action === "complete") {} else if (decision.action === "respond") {
       const actionDesc = decision.useKeys ? `Sent keys: ${decision.keys?.join(", ")}` : `Nudged: ${decision.response ?? ""}`;
-      ctx.sendChatMessage(`[${taskCtx.label}] Idle for ${idleMinutes}m — ${actionDesc}`, "coding-agent");
+      ctx.log(`[${taskCtx.label}] Idle for ${idleMinutes}m — ${actionDesc}`);
     } else if (decision.action === "escalate") {
       ctx.sendChatMessage(`[${taskCtx.label}] Idle for ${idleMinutes}m — needs your attention: ${decision.reasoning}`, "coding-agent");
     } else if (decision.action === "ignore") {
@@ -3214,7 +3222,8 @@ class SwarmCoordinator {
       autoResolvedCount: 0,
       registeredAt: Date.now(),
       lastActivityAt: Date.now(),
-      idleCheckCount: 0
+      idleCheckCount: 0,
+      taskDelivered: false
     });
     this.broadcast({
       type: "task_registered",
@@ -3397,6 +3406,9 @@ class SwarmCoordinator {
           data
         });
         const toolData = data;
+        if (toolData.source === "hook") {
+          break;
+        }
         const now = Date.now();
         const STARTUP_GRACE_MS = 1e4;
         if (now - taskCtx.registeredAt < STARTUP_GRACE_MS) {
@@ -3416,7 +3428,7 @@ class SwarmCoordinator {
               }
             } catch {}
           }
-          this.sendChatMessage(`[${taskCtx.label}] Running ${toolDesc}.${urlSuffix} The agent is working outside the terminal — I'll let it finish.`, "coding-agent");
+          this.log(`[${taskCtx.label}] Running ${toolDesc}.${urlSuffix} The agent is working outside the terminal.`);
         }
         break;
       }
@@ -3603,7 +3615,17 @@ class PTYService {
         if (!coordinator)
           return false;
         const taskCtx = coordinator.getTaskContext(sessionId);
-        return (taskCtx?.decisions.length ?? 0) > 0;
+        if (!taskCtx)
+          return false;
+        return taskCtx.taskDelivered || taskCtx.decisions.length > 0;
+      },
+      markTaskDelivered: (sessionId) => {
+        const coordinator = this.coordinator;
+        if (!coordinator)
+          return;
+        const taskCtx = coordinator.getTaskContext(sessionId);
+        if (taskCtx)
+          taskCtx.taskDelivered = true;
       }
     });
     this.manager = result.manager;
@@ -3691,19 +3713,29 @@ class PTYService {
     }
     if (resolvedAgentType === "claude") {
       try {
-        const settingsPath = join(workdir, ".claude", "settings.json");
+        const settingsPath = join2(workdir, ".claude", "settings.json");
         let settings = {};
         try {
-          settings = JSON.parse(await readFile(settingsPath, "utf-8"));
+          settings = JSON.parse(await readFile2(settingsPath, "utf-8"));
         } catch {}
         const permissions = settings.permissions ?? {};
         permissions.allowedDirectories = [workdir];
         settings.permissions = permissions;
+        const serverPort = this.runtime.getSetting("SERVER_PORT") ?? "2138";
+        const adapter = this.getAdapter("claude");
+        const hookProtocol = adapter.getHookTelemetryProtocol({
+          httpUrl: `http://localhost:${serverPort}/api/coding-agents/hooks`,
+          sessionId
+        });
+        if (hookProtocol) {
+          settings.hooks = hookProtocol.settingsHooks;
+          this.log(`Injecting HTTP hooks for session ${sessionId}`);
+        }
         await mkdir(dirname(settingsPath), { recursive: true });
-        await writeFile(settingsPath, JSON.stringify(settings, null, 2), "utf-8");
+        await writeFile2(settingsPath, JSON.stringify(settings, null, 2), "utf-8");
         this.log(`Wrote allowedDirectories [${workdir}] to ${settingsPath}`);
       } catch (err) {
-        this.log(`Failed to write allowedDirectories: ${err}`);
+        this.log(`Failed to write Claude settings: ${err}`);
       }
     }
     const spawnConfig = buildSpawnConfig(sessionId, {
@@ -3732,7 +3764,15 @@ class PTYService {
       sendKeysToSession: (id, keys) => this.sendKeysToSession(id, keys),
       pushDefaultRules: (id, type) => this.pushDefaultRules(id, type),
       toSessionInfo: (s, w) => this.toSessionInfo(s, w),
-      log: (msg) => this.log(msg)
+      log: (msg) => this.log(msg),
+      markTaskDelivered: (sessionId2) => {
+        const coordinator = this.coordinator;
+        if (!coordinator)
+          return;
+        const taskCtx = coordinator.getTaskContext(sessionId2);
+        if (taskCtx)
+          taskCtx.taskDelivered = true;
+      }
     };
     if (this.usingBunWorker) {
       setupOutputBuffer(ctx, session.id);
@@ -3839,6 +3879,36 @@ class PTYService {
     const session = this.getSession(sessionId);
     return session?.status === "authenticating";
   }
+  findSessionIdByCwd(cwd) {
+    for (const [sessionId, workdir] of this.sessionWorkdirs) {
+      if (workdir === cwd)
+        return sessionId;
+    }
+    return;
+  }
+  handleHookEvent(sessionId, event, data) {
+    const summary = event === "tool_running" ? `tool=${data.toolName ?? "?"}` : event === "permission_approved" ? `tool=${data.tool ?? "?"}` : JSON.stringify(data);
+    if (event === "tool_running" || event === "permission_approved") {
+      logger2.debug(`[PTYService] Hook event for ${sessionId}: ${event} ${summary}`);
+    } else {
+      this.log(`Hook event for ${sessionId}: ${event} ${summary}`);
+    }
+    switch (event) {
+      case "tool_running":
+        this.emitEvent(sessionId, "tool_running", data);
+        break;
+      case "task_complete":
+        this.emitEvent(sessionId, "task_complete", data);
+        break;
+      case "permission_approved":
+        break;
+      case "notification":
+        this.emitEvent(sessionId, "message", data);
+        break;
+      default:
+        break;
+    }
+  }
   async checkAvailableAgents(types) {
     const agentTypes = types ?? ["claude", "gemini", "codex", "aider"];
     return checkAdapters(agentTypes);
@@ -3966,9 +4036,7 @@ class PTYService {
     return this.metricsTracker.getAll();
   }
   log(message) {
-    if (this.serviceConfig.debug) {
-      logger2.debug(`[PTYService] ${message}`);
-    }
+    logger2.debug(`[PTYService] ${message}`);
   }
 }
 
@@ -6225,6 +6293,93 @@ async function handleCoordinatorRoutes(req, res, pathname, ctx) {
   return false;
 }
 
+// src/api/hook-routes.ts
+async function handleHookRoutes(req, res, pathname, ctx) {
+  if (pathname !== "/api/coding-agents/hooks")
+    return false;
+  const method = req.method?.toUpperCase();
+  if (method !== "POST") {
+    sendError(res, "Method not allowed", 405);
+    return true;
+  }
+  if (!ctx.ptyService) {
+    sendError(res, "PTY Service not available", 503);
+    return true;
+  }
+  let body;
+  try {
+    body = await parseBody(req);
+  } catch (err) {
+    sendError(res, err instanceof Error ? err.message : "Failed to parse request body", 400);
+    return true;
+  }
+  const payload = body;
+  const eventName = payload.hook_event_name;
+  if (!eventName) {
+    sendError(res, "Missing hook_event_name", 400);
+    return true;
+  }
+  const headerSessionId = req.headers["x-parallax-session-id"];
+  const sessionId = headerSessionId ? headerSessionId : payload.cwd ? ctx.ptyService.findSessionIdByCwd(payload.cwd) : undefined;
+  if (!sessionId) {
+    sendJson(res, { status: "ignored", reason: "session_not_found" });
+    return true;
+  }
+  switch (eventName) {
+    case "PermissionRequest": {
+      sendJson(res, {
+        hookSpecificOutput: {
+          hookEventName: "PermissionRequest",
+          decision: { behavior: "allow" }
+        }
+      });
+      ctx.ptyService.handleHookEvent(sessionId, "permission_approved", {
+        tool: payload.tool_name
+      });
+      return true;
+    }
+    case "PreToolUse": {
+      ctx.ptyService.handleHookEvent(sessionId, "tool_running", {
+        toolName: payload.tool_name,
+        source: "hook"
+      });
+      sendJson(res, {
+        hookSpecificOutput: {
+          hookEventName: "PreToolUse",
+          permissionDecision: "allow"
+        }
+      });
+      return true;
+    }
+    case "Stop": {
+      ctx.ptyService.handleHookEvent(sessionId, "task_complete", {
+        source: "hook"
+      });
+      sendJson(res, {});
+      return true;
+    }
+    case "Notification": {
+      ctx.ptyService.handleHookEvent(sessionId, "notification", {
+        type: payload.notification_type,
+        message: payload.message
+      });
+      sendJson(res, {});
+      return true;
+    }
+    case "TaskCompleted": {
+      ctx.ptyService.handleHookEvent(sessionId, "task_complete", {
+        source: "hook_task_completed"
+      });
+      sendJson(res, {});
+      return true;
+    }
+    default: {
+      sendJson(res, { status: "ignored", reason: "unknown_event" });
+      return true;
+    }
+  }
+}
+
 // src/api/issue-routes.ts
 async function handleIssueRoutes(req, res, pathname, ctx) {
   const method = req.method?.toUpperCase();
@@ -6487,6 +6642,9 @@ function sendError(res, message, status = 400) {
   sendJson(res, { error: message }, status);
 }
 async function handleCodingAgentRoutes(req, res, pathname, ctx) {
+  if (await handleHookRoutes(req, res, pathname, ctx)) {
+    return true;
+  }
   if (await handleCoordinatorRoutes(req, res, pathname, ctx)) {
     return true;
   }
@@ -6556,5 +6714,5 @@ export {
   CodingWorkspaceService
 };
 
-//# debugId=D5A4E2FBAF42C88664756E2164756E21
+//# debugId=54C728A058C6B9C264756E2164756E21
 //# sourceMappingURL=index.js.map